Method indexFile

src/extraction/index.ts:2769–2813

* Index a single file

(relativePath: string)

   * Index a single file
   */
  async indexFile(relativePath: string): Promise<ExtractionResult> {
    // Indexing read: follow in-root symlinks (the `../` guard still applies), #935.
    const fullPath = validatePathWithinRoot(this.rootDir, relativePath, { allowSymlinkEscape: true });

    if (!fullPath) {
      return {
        nodes: [],
        edges: [],
        unresolvedReferences: [],
        errors: [{ message: `Path traversal blocked: ${relativePath}`, filePath: relativePath, severity: 'error', code: 'path_traversal' }],
        durationMs: 0,
      };
    }

    // Read file content and stats
    let content: string;
    let stats: fs.Stats;
    try {
      // An oversize file is stored as skipped; its bytes are never needed (#1910).
      const read = await readBoundedSource(fullPath);
      stats = read.stats;
      // An MPEG transport stream named `.ts` is not TypeScript (#1910).
      if (read.bytes !== null && isMpegTsBytes(relativePath, read.bytes)) {
        return { nodes: [], edges: [], unresolvedReferences: [], errors: [], durationMs: 0 };
      }
      content = read.bytes === null ? oversizeStamp(stats.size) : read.bytes.toString('utf8');
    } catch (error) {
      return {
        nodes: [],
        edges: [],
        unresolvedReferences: [],
        errors: [
          {
            message: `Failed to read file: ${error instanceof Error ? error.message : String(error)}`,
            filePath: relativePath,
            severity: 'error',
            code: 'read_error',
          },
        ],
        durationMs: 0,
      };
    }

    return this.indexFileWithContent(relativePath, content, stats);
  }

  /**
   * Index a single file with pre-read content and stats.