specweave 0.29.1 → 0.30.0

package/dist/src/cli/workers/living-docs-worker.js

@@ -0,0 +1,395 @@
+#!/usr/bin/env node
+/**
+ * Living Docs Builder Worker
+ *
+ * Background worker that generates living documentation from codebase analysis.
+ * Handles long-running operations (hours/days for large codebases) with:
+ * - Checkpoint/resume support
+ * - Dependency waiting (clone/import jobs)
+ * - Phase-based progress tracking
+ * - Structured logging
+ *
+ * Usage:
+ *   node living-docs-worker.js <jobId> <projectPath>
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Dynamically loaded modules
+let checkDependencies;
+let waitForDependencies;
+let getJobManager;
+let runDiscovery;
+let buildFoundation;
+let saveFoundationDocs;
+let loadImportedWorkItems;
+let matchWorkItemsToModules;
+let saveMatchingResults;
+let analyzeModule;
+let saveModuleAnalysis;
+let generateSuggestions;
+let saveSuggestionsReport;
+let initializeCheckpoint;
+let loadCheckpoint;
+let saveCheckpoint;
+let saveDiscoveryCheckpoint;
+let loadDiscoveryCheckpoint;
+let saveFoundationCheckpoint;
+let saveMatchingCheckpoint;
+let startModuleAnalysis;
+let updateModuleProgress;
+let recordError;
+let completeJob;
+let isPhaseCompleted;
+let getResumePoint;
+/**
+ * Main worker entry point
+ */
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length < 2) {
+        console.error('Usage: living-docs-worker.js <jobId> <projectPath>');
+        process.exit(1);
+    }
+    const jobId = args[0];
+    const projectPath = args[1];
+    // Write PID file with exclusive lock
+    const pidFile = path.join(projectPath, '.specweave', 'jobs', jobId, 'worker.pid');
+    fs.mkdirSync(path.dirname(pidFile), { recursive: true });
+    try {
+        const fd = fs.openSync(pidFile, 'wx');
+        fs.writeSync(fd, process.pid.toString());
+        fs.closeSync(fd);
+    }
+    catch (err) {
+        if (err.code === 'EEXIST') {
+            try {
+                const existingPid = parseInt(fs.readFileSync(pidFile, 'utf-8').trim(), 10);
+                process.kill(existingPid, 0);
+                console.error(`Worker already running for job ${jobId} (PID: ${existingPid})`);
+                process.exit(1);
+            }
+            catch {
+                fs.unlinkSync(pidFile);
+                fs.writeFileSync(pidFile, process.pid.toString());
+            }
+        }
+        else {
+            throw err;
+        }
+    }
+    // Cleanup on exit
+    const cleanup = () => {
+        try {
+            if (fs.existsSync(pidFile)) {
+                fs.unlinkSync(pidFile);
+            }
+        }
+        catch {
+            // Ignore
+        }
+    };
+    process.on('exit', cleanup);
+    process.on('SIGTERM', () => { cleanup(); process.exit(0); });
+    process.on('SIGINT', () => { cleanup(); process.exit(0); });
+    // Setup logging
+    const logDir = path.join(projectPath, '.specweave', 'jobs', jobId);
+    fs.mkdirSync(logDir, { recursive: true });
+    const logPath = path.join(logDir, 'worker.log');
+    const progressPath = path.join(logDir, 'progress.json');
+    const log = (msg) => {
+        const timestamp = new Date().toISOString();
+        fs.appendFileSync(logPath, `[${timestamp}] ${msg}\n`);
+    };
+    const updateProgress = (phase, progress, message) => {
+        fs.writeFileSync(progressPath, JSON.stringify({
+            phase,
+            progress,
+            message,
+            updatedAt: new Date().toISOString()
+        }, null, 2));
+    };
+    try {
+        log('════════════════════════════════════════════════════════════');
+        log('LIVING DOCS BUILDER STARTED');
+        log('════════════════════════════════════════════════════════════');
+        log(`Job ID: ${jobId}`);
+        log(`Project path: ${projectPath}`);
+        log(`PID: ${process.pid}`);
+        log(`Started at: ${new Date().toISOString()}`);
+        log('');
+        // Load job configuration
+        const configPath = path.join(logDir, 'config.json');
+        if (!fs.existsSync(configPath)) {
+            throw new Error(`Job config not found: ${configPath}`);
+        }
+        const jobConfig = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        log(`User inputs: ${JSON.stringify(jobConfig.userInputs)}`);
+        log(`Dependencies: ${jobConfig.dependsOn?.join(', ') || 'none'}`);
+        log('');
+        // Load modules dynamically
+        log('Loading dependencies...');
+        const depModule = await import('../../core/background/job-dependency.js');
+        checkDependencies = depModule.checkDependencies;
+        waitForDependencies = depModule.waitForDependencies;
+        const jobManagerModule = await import('../../core/background/job-manager.js');
+        getJobManager = jobManagerModule.getJobManager;
+        const discoveryModule = await import('../../core/living-docs/discovery.js');
+        runDiscovery = discoveryModule.runDiscovery;
+        const foundationModule = await import('../../core/living-docs/foundation-builder.js');
+        buildFoundation = foundationModule.buildFoundation;
+        saveFoundationDocs = foundationModule.saveFoundationDocs;
+        const matcherModule = await import('../../core/living-docs/workitem-matcher.js');
+        loadImportedWorkItems = matcherModule.loadImportedWorkItems;
+        matchWorkItemsToModules = matcherModule.matchWorkItemsToModules;
+        saveMatchingResults = matcherModule.saveMatchingResults;
+        const analyzerModule = await import('../../core/living-docs/module-analyzer.js');
+        analyzeModule = analyzerModule.analyzeModule;
+        saveModuleAnalysis = analyzerModule.saveModuleAnalysis;
+        const suggestionsModule = await import('../../core/living-docs/suggestions-generator.js');
+        generateSuggestions = suggestionsModule.generateSuggestions;
+        saveSuggestionsReport = suggestionsModule.saveSuggestionsReport;
+        const checkpointModule = await import('../../core/living-docs/checkpoint-manager.js');
+        initializeCheckpoint = checkpointModule.initializeCheckpoint;
+        loadCheckpoint = checkpointModule.loadCheckpoint;
+        saveCheckpoint = checkpointModule.saveCheckpoint;
+        saveDiscoveryCheckpoint = checkpointModule.saveDiscoveryCheckpoint;
+        loadDiscoveryCheckpoint = checkpointModule.loadDiscoveryCheckpoint;
+        saveFoundationCheckpoint = checkpointModule.saveFoundationCheckpoint;
+        saveMatchingCheckpoint = checkpointModule.saveMatchingCheckpoint;
+        startModuleAnalysis = checkpointModule.startModuleAnalysis;
+        updateModuleProgress = checkpointModule.updateModuleProgress;
+        recordError = checkpointModule.recordError;
+        completeJob = checkpointModule.completeJob;
+        isPhaseCompleted = checkpointModule.isPhaseCompleted;
+        getResumePoint = checkpointModule.getResumePoint;
+        log('Dependencies loaded successfully');
+        log('');
+        // Get job manager and mark as running
+        const jobManager = getJobManager(projectPath);
+        jobManager.startJob(jobId);
+        // Check for existing checkpoint (resume support)
+        let checkpoint = loadCheckpoint(projectPath, jobId);
+        if (checkpoint) {
+            log(`Resuming from checkpoint: phase=${checkpoint.phase}, progress=${checkpoint.phaseProgress}%`);
+        }
+        else {
+            checkpoint = initializeCheckpoint(projectPath, jobId);
+            log('Initialized new checkpoint');
+        }
+        // ═══════════════════════════════════════════════════════════════
+        // PHASE 1: Wait for dependencies
+        // ═══════════════════════════════════════════════════════════════
+        if (jobConfig.dependsOn && jobConfig.dependsOn.length > 0 && !isPhaseCompleted(checkpoint, 'waiting')) {
+            log('PHASE: Waiting for dependencies...');
+            updateProgress('waiting', 0, 'Waiting for clone/import jobs to complete');
+            const depStatus = await waitForDependencies(projectPath, jobConfig.dependsOn, (status) => {
+                if (status.waitingFor.length > 0) {
+                    log(`  Still waiting for: ${status.waitingFor.join(', ')}`);
+                    updateProgress('waiting', 0, `Waiting for ${status.waitingFor.length} jobs`);
+                }
+            }, 30000 // Check every 30 seconds
+            );
+            if (depStatus.failedDeps.length > 0) {
+                log(`  WARNING: Some dependencies failed: ${depStatus.failedDeps.join(', ')}`);
+                log('  Proceeding with available data...');
+            }
+            log('  Dependencies complete');
+            checkpoint.phase = 'discovery';
+            saveCheckpoint(projectPath, jobId, checkpoint);
+        }
+        // ═══════════════════════════════════════════════════════════════
+        // PHASE 2: Discovery
+        // ═══════════════════════════════════════════════════════════════
+        let discovery = loadDiscoveryCheckpoint(projectPath, jobId);
+        if (!discovery) {
+            log('PHASE: Discovery - Scanning codebase...');
+            updateProgress('discovery', 0, 'Scanning codebase structure');
+            try {
+                discovery = await runDiscovery(projectPath, jobConfig.userInputs.additionalSources, (phase, current, total) => {
+                    const progress = Math.round((current / total) * 100);
+                    updateProgress('discovery', progress, `${phase}: ${current}/${total}`);
+                });
+                saveDiscoveryCheckpoint(projectPath, jobId, discovery);
+                log(`  Discovered ${discovery.codebaseStats.totalFiles} files in ${discovery.modules.length} modules`);
+                log(`  Tier: ${discovery.tier}`);
+                log(`  Languages: ${discovery.techStack.languages.join(', ')}`);
+            }
+            catch (err) {
+                recordError(projectPath, jobId, 'discovery', err.message);
+                throw err;
+            }
+        }
+        else {
+            log('  Discovery loaded from checkpoint');
+        }
+        // ═══════════════════════════════════════════════════════════════
+        // PHASE 3: Foundation docs
+        // ═══════════════════════════════════════════════════════════════
+        if (!isPhaseCompleted(checkpoint, 'foundation')) {
+            log('PHASE: Foundation - Building high-level docs...');
+            updateProgress('foundation', 0, 'Generating overview documentation');
+            try {
+                const foundationDocs = await buildFoundation(projectPath, discovery, (docName, status) => {
+                    log(`  ${docName}: ${status}`);
+                    if (status === 'generating') {
+                        updateProgress('foundation', 50, `Generating ${docName}`);
+                    }
+                });
+                const savedPaths = await saveFoundationDocs(projectPath, foundationDocs);
+                saveFoundationCheckpoint(projectPath, jobId, savedPaths);
+                log(`  Created ${savedPaths.length} foundation docs`);
+            }
+            catch (err) {
+                recordError(projectPath, jobId, 'foundation', err.message);
+                throw err;
+            }
+        }
+        else {
+            log('  Foundation phase already complete');
+        }
+        // ═══════════════════════════════════════════════════════════════
+        // PHASE 4: Integration (Work Item Matching)
+        // ═══════════════════════════════════════════════════════════════
+        let matchResult;
+        if (!isPhaseCompleted(checkpoint, 'integration')) {
+            log('PHASE: Integration - Matching work items...');
+            updateProgress('integration', 0, 'Loading imported work items');
+            try {
+                const workItems = await loadImportedWorkItems(projectPath, (phase, current, total) => {
+                    updateProgress('integration', Math.round((current / total) * 50), `Loading work items: ${current}/${total}`);
+                });
+                log(`  Loaded ${workItems.length} work items`);
+                matchResult = await matchWorkItemsToModules(projectPath, discovery, workItems, (phase, current, total) => {
+                    updateProgress('integration', 50 + Math.round((current / total) * 50), `Matching: ${current}/${total}`);
+                });
+                await saveMatchingResults(projectPath, matchResult);
+                saveMatchingCheckpoint(projectPath, jobId, matchResult);
+                log(`  Matched ${matchResult.stats.matchedWorkItems}/${matchResult.stats.totalWorkItems} items`);
+                log(`  Modules with work items: ${matchResult.stats.modulesWithWorkItems}`);
+            }
+            catch (err) {
+                recordError(projectPath, jobId, 'integration', err.message);
+                throw err;
+            }
+        }
+        else {
+            log('  Integration phase already complete');
+            // Load from checkpoint if needed
+            matchResult = checkpoint.matchingStats ? {
+                stats: checkpoint.matchingStats,
+                moduleMap: new Map(),
+                priorityQueue: [],
+                unmatchedItems: []
+            } : null;
+        }
+        // ═══════════════════════════════════════════════════════════════
+        // PHASE 5: Deep Dive (Module Analysis)
+        // ═══════════════════════════════════════════════════════════════
+        const moduleAnalyses = new Map();
+        if (!isPhaseCompleted(checkpoint, 'deep-dive')) {
+            log('PHASE: Deep Dive - Analyzing modules...');
+            // Determine which modules to analyze based on depth setting
+            let modulesToAnalyze = [...discovery.modules];
+            if (jobConfig.userInputs.analysisDepth === 'quick') {
+                // Only top 5 priority modules
+                modulesToAnalyze = modulesToAnalyze.slice(0, 5);
+            }
+            else if (jobConfig.userInputs.analysisDepth === 'standard') {
+                // Top 10
+                modulesToAnalyze = modulesToAnalyze.slice(0, 10);
+            }
+            // 'deep' = all modules
+            // Check for resume point
+            const resumePoint = getResumePoint(projectPath, jobId);
+            let startIndex = 0;
+            if (resumePoint?.module) {
+                startIndex = modulesToAnalyze.findIndex(m => m.name === resumePoint.module);
+                if (startIndex === -1)
+                    startIndex = 0;
+                log(`  Resuming from module: ${resumePoint.module}`);
+            }
+            else {
+                startModuleAnalysis(projectPath, jobId, modulesToAnalyze.map(m => m.name));
+            }
+            for (let i = startIndex; i < modulesToAnalyze.length; i++) {
+                const module = modulesToAnalyze[i];
+                const remaining = modulesToAnalyze.slice(i + 1).map(m => m.name);
+                log(`  Analyzing module: ${module.name} (${i + 1}/${modulesToAnalyze.length})`);
+                updateProgress('deep-dive', Math.round(((i + 1) / modulesToAnalyze.length) * 100), `Analyzing ${module.name}`);
+                try {
+                    const workItemMatches = matchResult?.moduleMap?.get(module.name)?.matches || [];
+                    const analysis = await analyzeModule(projectPath, module, discovery.samplingConfig, workItemMatches, (_moduleName, _fileIdx, _totalFiles) => {
+                        // File-level progress
+                    });
+                    moduleAnalyses.set(module.name, analysis);
+                    await saveModuleAnalysis(projectPath, analysis);
+                    updateModuleProgress(projectPath, jobId, module.name, remaining);
+                    log(`    Files analyzed: ${analysis.filesAnalyzed.length}`);
+                    log(`    Exports found: ${analysis.totalExports}`);
+                }
+                catch (err) {
+                    recordError(projectPath, jobId, 'deep-dive', `${module.name}: ${err.message}`);
+                    log(`    ERROR: ${err.message}`);
+                    // Continue with next module
+                }
+            }
+        }
+        else {
+            log('  Deep dive phase already complete');
+        }
+        // ═══════════════════════════════════════════════════════════════
+        // PHASE 6: Suggestions
+        // ═══════════════════════════════════════════════════════════════
+        log('PHASE: Suggestions - Generating recommendations...');
+        updateProgress('suggestions', 0, 'Generating SUGGESTIONS.md');
+        try {
+            const report = await generateSuggestions(projectPath, discovery, moduleAnalyses, matchResult || { stats: { totalWorkItems: 0, matchedWorkItems: 0, modulesWithWorkItems: 0 }, moduleMap: new Map(), priorityQueue: [], unmatchedItems: [] }, jobConfig.userInputs);
+            const suggestionsPath = await saveSuggestionsReport(projectPath, report);
+            log(`  Created: ${suggestionsPath}`);
+            log(`  Summary:`);
+            log(`    - Total modules: ${report.summary.totalModules}`);
+            log(`    - Documented: ${report.summary.modulesDocumented}`);
+            log(`    - Partial: ${report.summary.modulesPartial}`);
+            log(`    - Undocumented: ${report.summary.modulesUndocumented}`);
+            log(`    - Coverage: ${report.summary.coveragePercent}%`);
+        }
+        catch (err) {
+            recordError(projectPath, jobId, 'suggestions', err.message);
+            throw err;
+        }
+        // ═══════════════════════════════════════════════════════════════
+        // Complete
+        // ═══════════════════════════════════════════════════════════════
+        completeJob(projectPath, jobId);
+        jobManager.completeJob(jobId, {
+            completedAt: new Date().toISOString(),
+            modulesAnalyzed: moduleAnalyses.size,
+            suggestionsGenerated: true
+        });
+        updateProgress('complete', 100, 'Living docs generation complete');
+        log('');
+        log('════════════════════════════════════════════════════════════');
+        log('LIVING DOCS BUILDER COMPLETED');
+        log('════════════════════════════════════════════════════════════');
+        log(`Completed at: ${new Date().toISOString()}`);
+        log(`Output: .specweave/docs/SUGGESTIONS.md`);
+    }
+    catch (err) {
+        log(`FATAL ERROR: ${err.message}`);
+        log(err.stack || '');
+        try {
+            const jobManager = getJobManager(projectPath);
+            jobManager.failJob(jobId, err.message);
+        }
+        catch {
+            // Ignore
+        }
+        updateProgress('error', 0, err.message);
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=living-docs-worker.js.map

package/dist/src/cli/workers/living-docs-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"living-docs-worker.js","sourceRoot":"","sources":["../../../../src/cli/workers/living-docs-worker.ts"],"names":[],"mappings":"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"}

package/dist/src/core/background/job-dependency.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Job Dependency System
+ *
+ * Enables jobs to wait for other jobs to complete before starting.
+ * Used by living-docs-builder to wait for clone and import jobs.
+ */
+import { BackgroundJobManager } from './job-manager.js';
+export interface DependencyStatus {
+    /** Whether all dependencies are satisfied */
+    ready: boolean;
+    /** Job IDs still running/pending */
+    waitingFor: string[];
+    /** Job IDs that failed */
+    failedDeps: string[];
+    /** Job IDs that completed successfully */
+    completedDeps: string[];
+}
+/**
+ * Check the status of job dependencies
+ */
+export declare function checkDependencies(jobManager: BackgroundJobManager, dependsOn: string[] | undefined): DependencyStatus;
+/**
+ * Wait for all dependencies to complete (or fail)
+ *
+ * @param projectPath - Project root path
+ * @param dependsOn - Array of job IDs to wait for
+ * @param onProgress - Callback for progress updates
+ * @param pollIntervalMs - How often to check (default 10 seconds)
+ * @returns Final dependency status
+ */
+export declare function waitForDependencies(projectPath: string, dependsOn: string[] | undefined, onProgress: (status: DependencyStatus) => void, pollIntervalMs?: number): Promise<DependencyStatus>;
+/**
+ * Check for circular dependencies
+ *
+ * @param jobManager - Job manager instance
+ * @param jobId - The job being checked
+ * @param dependsOn - Its dependencies
+ * @returns Array of circular dependency chains found, or empty if none
+ */
+export declare function detectCircularDependencies(jobManager: BackgroundJobManager, jobId: string, dependsOn: string[] | undefined): string[][];
+/**
+ * Format dependency status for display
+ */
+export declare function formatDependencyStatus(status: DependencyStatus): string;
+//# sourceMappingURL=job-dependency.d.ts.map

package/dist/src/core/background/job-dependency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-dependency.d.ts","sourceRoot":"","sources":["../../../../src/core/background/job-dependency.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiB,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGvE,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,oBAAoB,EAChC,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,GAC9B,gBAAgB,CAuClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,EAC/B,UAAU,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,EAC9C,cAAc,GAAE,MAAc,GAC7B,OAAO,CAAC,gBAAgB,CAAC,CAa3B;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EAAE,GAAG,SAAS,GAC9B,MAAM,EAAE,EAAE,CAoDZ;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAoBvE"}

package/dist/src/core/background/job-dependency.js

@@ -0,0 +1,144 @@
+/**
+ * Job Dependency System
+ *
+ * Enables jobs to wait for other jobs to complete before starting.
+ * Used by living-docs-builder to wait for clone and import jobs.
+ */
+import { getJobManager } from './job-manager.js';
+/**
+ * Check the status of job dependencies
+ */
+export function checkDependencies(jobManager, dependsOn) {
+    if (!dependsOn || dependsOn.length === 0) {
+        return { ready: true, waitingFor: [], failedDeps: [], completedDeps: [] };
+    }
+    const waitingFor = [];
+    const failedDeps = [];
+    const completedDeps = [];
+    for (const depId of dependsOn) {
+        const job = jobManager.getJob(depId);
+        if (!job) {
+            // Job doesn't exist (deleted or never created), treat as completed
+            completedDeps.push(depId);
+            continue;
+        }
+        switch (job.status) {
+            case 'completed':
+                completedDeps.push(depId);
+                break;
+            case 'failed':
+                failedDeps.push(depId);
+                break;
+            case 'pending':
+            case 'running':
+            case 'paused':
+            default:
+                waitingFor.push(depId);
+        }
+    }
+    return {
+        ready: waitingFor.length === 0,
+        waitingFor,
+        failedDeps,
+        completedDeps
+    };
+}
+/**
+ * Wait for all dependencies to complete (or fail)
+ *
+ * @param projectPath - Project root path
+ * @param dependsOn - Array of job IDs to wait for
+ * @param onProgress - Callback for progress updates
+ * @param pollIntervalMs - How often to check (default 10 seconds)
+ * @returns Final dependency status
+ */
+export async function waitForDependencies(projectPath, dependsOn, onProgress, pollIntervalMs = 10000) {
+    const jobManager = getJobManager(projectPath);
+    let status = checkDependencies(jobManager, dependsOn);
+    while (!status.ready) {
+        onProgress(status);
+        await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
+        status = checkDependencies(jobManager, dependsOn);
+    }
+    // Final callback with ready status
+    onProgress(status);
+    return status;
+}
+/**
+ * Check for circular dependencies
+ *
+ * @param jobManager - Job manager instance
+ * @param jobId - The job being checked
+ * @param dependsOn - Its dependencies
+ * @returns Array of circular dependency chains found, or empty if none
+ */
+export function detectCircularDependencies(jobManager, jobId, dependsOn) {
+    if (!dependsOn || dependsOn.length === 0) {
+        return [];
+    }
+    const circularChains = [];
+    const visited = new Set();
+    const path = [jobId];
+    function dfs(currentId) {
+        if (visited.has(currentId)) {
+            return;
+        }
+        const job = jobManager.getJob(currentId);
+        if (!job) {
+            return;
+        }
+        // Get dependencies from job config if it has them
+        const deps = job.config.dependsOn;
+        if (!deps || deps.length === 0) {
+            return;
+        }
+        for (const depId of deps) {
+            if (depId === jobId) {
+                // Found circular dependency back to original job
+                circularChains.push([...path, depId]);
+            }
+            else if (!visited.has(depId)) {
+                path.push(depId);
+                dfs(depId);
+                path.pop();
+            }
+        }
+        visited.add(currentId);
+    }
+    // Check each direct dependency
+    for (const depId of dependsOn) {
+        if (depId === jobId) {
+            // Direct self-reference
+            circularChains.push([jobId, depId]);
+        }
+        else {
+            path.push(depId);
+            dfs(depId);
+            path.pop();
+        }
+    }
+    return circularChains;
+}
+/**
+ * Format dependency status for display
+ */
+export function formatDependencyStatus(status) {
+    if (status.ready) {
+        if (status.failedDeps.length > 0) {
+            return `Dependencies ready (${status.failedDeps.length} failed, proceeding with partial data)`;
+        }
+        return 'All dependencies completed';
+    }
+    const parts = [];
+    if (status.waitingFor.length > 0) {
+        parts.push(`Waiting for: ${status.waitingFor.join(', ')}`);
+    }
+    if (status.completedDeps.length > 0) {
+        parts.push(`Completed: ${status.completedDeps.length}`);
+    }
+    if (status.failedDeps.length > 0) {
+        parts.push(`Failed: ${status.failedDeps.length}`);
+    }
+    return parts.join(' | ');
+}
+//# sourceMappingURL=job-dependency.js.map

package/dist/src/core/background/job-dependency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-dependency.js","sourceRoot":"","sources":["../../../../src/core/background/job-dependency.ts"],"names":[],"mappings":"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"}

package/dist/src/core/background/job-launcher.d.ts

@@ -4,7 +4,7 @@
  * Spawns import workers as detached processes that survive terminal close.
  * Progress tracked via file system - check with /specweave:jobs
  */
-import type { BackgroundJob, JobType } from './types.js';
+import type { BackgroundJob, JobType, LivingDocsUserInputs } from './types.js';
 export interface LaunchOptions {
     /** Job type */
     type: JobType;
@@ -56,6 +56,26 @@ export interface CloneLaunchOptions {
  * @returns Job info and process details
  */
 export declare function launchCloneJob(options: CloneLaunchOptions): Promise<LaunchResult>;
+export interface LivingDocsLaunchOptions {
+    /** Project path */
+    projectPath: string;
+    /** User inputs collected before launch */
+    userInputs: LivingDocsUserInputs;
+    /** Job IDs to wait for before starting */
+    dependsOn?: string[];
+    /** Run in foreground (blocking) instead of background */
+    foreground?: boolean;
+}
+/**
+ * Launch a living-docs-builder job
+ *
+ * This job waits for dependencies (clone/import jobs) to complete before
+ * analyzing the codebase and generating living documentation.
+ *
+ * @param options Launch configuration
+ * @returns Job info and process details
+ */
+export declare function launchLivingDocsJob(options: LivingDocsLaunchOptions): Promise<LaunchResult>;
 /**
  * Check if a background job is still running
  */