Function analyzeWorkspace

frontend/src/analysis/workspace.ts:61–1065

(
    ctx: WorkspaceContext,
    bypassCache: boolean = false
)

 * @param bypassCache - If true, skip cache and force fresh analysis
 */
export async function analyzeWorkspace(
    ctx: WorkspaceContext,
    bypassCache: boolean = false
): Promise<void> {
    const { api, cache, webview, metadataBuilder, extensionContext, log } = ctx;

    // Pre-flight: check backend is reachable and API key is valid
    const health = await api.checkHealth();
    if (!health.healthy) {
        log('Backend not reachable — showing error overlay');
        webview.showLoading('Connecting to backend...');
        webview.notifyBackendError();
        return;
    }
    if (health.apiKeyStatus !== 'valid') {
        log(`API key ${health.apiKeyStatus} — showing error overlay`);
        webview.notifyApiKeyError(health.apiKeyStatus === 'missing' ? 'missing' : 'invalid');
        return;
    }

    // Dismiss any lingering error overlay from a previous failed check
    webview.dismissErrorOverlays();

    // Track analysis start time
    const startTime = Date.now();
    const sessionAtStart = getAnalysisSession();  // Capture session to detect invalidation

    // Pipeline stats tracking - shows what gets filtered at each stage
    const pipelineStats = {
        detected: { llmFiles: 0, httpFiles: 0, httpClientFilesAdded: 0 },
        cached: { filesFromCache: 0, filesNeedAnalysis: 0 },
        analyzed: { filesSentToLLM: 0, httpConnections: 0 },
        results: { filesWithNodes: 0, filesWithNoWorkflow: 0, totalNodes: 0 },
        edges: { llmGenerated: 0, resolved: 0, orphaned: 0 }
    };

    log('Starting workspace scan...');
    log(`Workspace root: ${vscode.workspace.workspaceFolders?.[0]?.uri.fsPath}`);
    if (bypassCache) {
        log('⚠️  BYPASS MODE: Cache reading/writing disabled for this analysis');
    }

    // Check if workspace is open
    const workspaceFolders = vscode.workspace.workspaceFolders;
    if (!workspaceFolders || workspaceFolders.length === 0) {
        webview.notifyWarning('No folder open. Use File > Open Folder to open a project.');
        return;
    }
    const workspaceRoot = workspaceFolders[0].uri.fsPath;

    try {
        // Show panel immediately (don't block on file detection)
        webview.showLoading('Scanning workspace...');

        // Check if workspace has any source files
        const sourceFileCount = (await WorkflowDetector.getAllSourceFiles()).length;
        if (sourceFileCount === 0) {
            webview.notifyWarning('No source files found (.py, .ts, .js). Open a folder containing code.');