# LargeFileIndex

**Kind:** Interface

**Source:** [`atloria-monorepo/packages/doc-automation/src/v2/types/stage-02.types.ts`](https://github.com/sherkety/atloria/blob/main/atloria-monorepo/packages/doc-automation/src/v2/types/stage-02.types.ts#L63)

LargeFileIndex - Detailed index for lazy loading from large files (>500KB)

Instead of loading full content of large files (which would overflow context),
we create an index that enables on-demand loading of specific sections.
This supports the iterative deep loading mechanism.

## Properties

| Property | Type |
|---|---|
| `filePath` | `string` |
| `fileSize` | `number` |
| `lineCount` | `number` |
| `tokenEstimate` | `number` |
| `overview` | `{
    purpose: string; // What this file is for
    primaryExports: string[]; // Main exports
    imports: string[]; // Key imports
    isAutoGenerated: boolean; // Detected auto-generated file
  }` |
| `entities` | `Array<{
    name: string;
    type: string; // FUNCTION, CLASS, etc.
    startLine: number;
    endLine: number;
    signature: string; // Quick reference
    summary: string; // Brief description
    hasNeverTruncatePatterns: boolean; // Contains critical patterns
  }>` |
| `sections` | `Array<{
    startLine: number;
    endLine: number;
    summary: string; // What this section does
    entities: string[]; // Entity names in this section
  }>` |
| `criticalExtracts` | `Array<{
    entityName: string;
    reason: 'validation' | 'error_messages' | 'permissions' | 'state_machine';
    content: string; // Full source code
  }>` |