Function pathIsProjectFile

src/mcp/tools.ts:198–205

* Does this query-named span point at a real FILE inside the project? * * The `existsOnDisk` predicate `extractQueryPaths` takes (that module is pure — * no DB, no fs — so the fs access lives here, where the project root is known). * Only a REGULAR FILE counts: a directory span (`src/search`) is

(projectRoot: string, relPath: string)

 * probe outside the project, and every fs error answers `false`.
 */
function pathIsProjectFile(projectRoot: string, relPath: string): boolean {
  try {
    const abs = validatePathWithinRoot(projectRoot, relPath);
    return abs !== null && statSync(abs).isFile();
  } catch {
    return false;
  }
}

/** Kinds that name a thing without defining it in the file that holds them. */
const NOT_A_DEFINITION = new Set(['file', 'import', 'export', 'parameter']);