Class CacheManager

frontend/src/cache.ts:80–1554

}

export class CacheManager {
    private cachePath: vscode.Uri | null = null;
    private graphPath: vscode.Uri | null = null;
    private files: Record<string, FileCache> = {};
    private crossFileEdges: CrossFileEdge[] = [];
    private workflows: Record<string, WorkflowInfo> = {};
    private initPromise: Promise<void>;
    private staticAnalyzer: StaticAnalyzer;

    // Debounced save
    private saveTimer: NodeJS.Timeout | null = null;
    private saveDebounceMs = 500;
    private maxSaveWaitMs = 5000;
    private lastSaveTime = 0;

    // Cached merged graph for sync access (instant feedback)
    private lastMergedGraph: WorkflowGraph | null = null;

    // Multi-batch analysis state tracking
    // Prevents premature workflow filtering during first analysis
    private analysisInProgress: boolean = false;
    private pendingBatchCount: number = 0;

    constructor(private context: vscode.ExtensionContext) {
        this.initPromise = this.initializeCache();
        this.staticAnalyzer = new StaticAnalyzer();
    }

    /**
     * Convert full path to relative path using workspace root.
     * Ensures consistent cache keys using relative paths for security and portability.
     */
    private toRelativePath(filePath: string): string {
        // Already relative (doesn't start with / or drive letter)
        if (!filePath.startsWith('/') && !filePath.match(/^[A-Z]:\\/i)) {
            return filePath;
        }
        // Convert absolute to relative
        const workspaceRoot = vscode.workspace.workspaceFolders?.[0]?.uri.fsPath;
        if (workspaceRoot && filePath.startsWith(workspaceRoot)) {
            return filePath.slice(workspaceRoot.length).replace(/^[/\\]/, '');
        }
        return filePath;
    }

    private async initializeCache() {
        const workspaceFolders = vscode.workspace.workspaceFolders;
        if (!workspaceFolders || workspaceFolders.length === 0) {
            return;
        }

        const workspaceFolder = workspaceFolders[0];
        const vscodeFolderPath = path.join(workspaceFolder.uri.fsPath, '.vscode');
        this.cachePath = vscode.Uri.file(path.join(vscodeFolderPath, 'codag-cache.json'));
        this.graphPath = vscode.Uri.file(path.join(vscodeFolderPath, 'codag-graph.json'));

        try {
            await vscode.workspace.fs.createDirectory(vscode.Uri.file(vscodeFolderPath));