Clean up comments and naming

Author: savannahostrowski

src/appDiscovery.ts

@@ -80,23 +80,23 @@ async function findAllFastAPIFiles(
 async function parsePyprojectForEntryPoint(
   folderUri: vscode.Uri,
 ): Promise<EntryPoint | null> {
-  const pyprojecttomlFiles = await vscode.workspace.findFiles(
+  const pyprojectTomlFiles = await vscode.workspace.findFiles(
     new vscode.RelativePattern(folderUri, "**/pyproject.toml"),
     new vscode.RelativePattern(
       folderUri,
       "**/{.venv,venv,__pycache__,node_modules,.git,tests,test}/**",
     ),
   )
 
-  if (pyprojecttomlFiles.length === 0) {
+  if (pyprojectTomlFiles.length === 0) {
     return null
   }
 
-  pyprojecttomlFiles.sort(
+  pyprojectTomlFiles.sort(
     (a, b) => a.path.split("/").length - b.path.split("/").length,
   )
 
-  for (const fileUri of pyprojecttomlFiles) {
+  for (const fileUri of pyprojectTomlFiles) {
     try {
       const document = await vscode.workspace.openTextDocument(fileUri)
       const contents = toml.parse(document.getText()) as Record<string, unknown>
@@ -111,7 +111,8 @@ async function parsePyprojectForEntryPoint(
 
       const { relativePath, variableName } =
         parseEntrypointString(entrypointValue)
-      const fullUri = vscode.Uri.joinPath(fileUri, "..", relativePath)
+      const dirUri = vscode.Uri.joinPath(fileUri, "..")
+      const fullUri = vscode.Uri.joinPath(dirUri, relativePath)
 
       return (await vscodeFileSystem.exists(fullUri.toString()))
         ? { filePath: fullUri.toString(), variableName }

src/core/pathUtils.ts

@@ -168,7 +168,9 @@ export async function findProjectRoot(
     return dirUri
   }
 
-  // Walk up until we find a directory whose parent doesn't have __init__.py
+  // __init__.py is present, so this is a traditional package. Walk up until
+  // we find a directory whose parent doesn't have __init__.py — that parent
+  // is the project root (the directory Python adds to sys.path).
   while (
     isWithinDirectory(dirUri, workspaceRootUri) &&
     uriPath(dirUri) !== uriPath(workspaceRootUri)