specweave 0.29.1 → 0.30.0

package/dist/src/core/living-docs/checkpoint-manager.js

@@ -0,0 +1,231 @@
+/**
+ * Checkpoint Manager - Pause/Resume support for Living Docs Builder
+ *
+ * Enables long-running living docs jobs to:
+ * 1. Save progress at key points (after each phase/module)
+ * 2. Resume from last checkpoint on restart
+ * 3. Track phase and module completion
+ */
+import * as fs from '../../utils/fs-native.js';
+import * as path from 'path';
+/**
+ * Get checkpoint file paths for a job
+ */
+export function getCheckpointPaths(projectPath, jobId) {
+    const jobDir = path.join(projectPath, '.specweave', 'jobs', jobId);
+    const checkpointsDir = path.join(jobDir, 'checkpoints');
+    return {
+        checkpoint: path.join(checkpointsDir, 'checkpoint.json'),
+        phasesDir: checkpointsDir,
+        discovery: path.join(checkpointsDir, 'discovery.json'),
+        foundation: path.join(checkpointsDir, 'foundation.json'),
+        matching: path.join(checkpointsDir, 'matching.json')
+    };
+}
+/**
+ * Initialize checkpoint for a new job
+ */
+export function initializeCheckpoint(projectPath, jobId) {
+    const checkpoint = {
+        phase: 'waiting',
+        progressPercent: 0,
+        errors: []
+    };
+    // Ensure checkpoint directory exists
+    const paths = getCheckpointPaths(projectPath, jobId);
+    fs.ensureDirSync(paths.phasesDir);
+    // Save initial checkpoint
+    saveCheckpoint(projectPath, jobId, checkpoint);
+    return checkpoint;
+}
+/**
+ * Save checkpoint to disk
+ */
+export function saveCheckpoint(projectPath, jobId, checkpoint) {
+    const paths = getCheckpointPaths(projectPath, jobId);
+    fs.ensureDirSync(paths.phasesDir);
+    // Save main checkpoint
+    fs.writeFileSync(paths.checkpoint, JSON.stringify({
+        ...checkpoint,
+        lastUpdated: new Date().toISOString()
+    }, null, 2));
+}
+/**
+ * Load checkpoint from disk
+ */
+export function loadCheckpoint(projectPath, jobId) {
+    const paths = getCheckpointPaths(projectPath, jobId);
+    if (!fs.existsSync(paths.checkpoint)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(paths.checkpoint, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save discovery results to checkpoint
+ */
+export function saveDiscoveryCheckpoint(projectPath, jobId, discovery) {
+    const paths = getCheckpointPaths(projectPath, jobId);
+    // Save discovery data
+    fs.writeFileSync(paths.discovery, JSON.stringify(discovery, null, 2));
+    // Update main checkpoint
+    const checkpoint = loadCheckpoint(projectPath, jobId) || initializeCheckpoint(projectPath, jobId);
+    checkpoint.discovery = discovery;
+    checkpoint.phase = 'discovery';
+    checkpoint.progressPercent = 100;
+    saveCheckpoint(projectPath, jobId, checkpoint);
+}
+/**
+ * Load discovery results from checkpoint
+ */
+export function loadDiscoveryCheckpoint(projectPath, jobId) {
+    const paths = getCheckpointPaths(projectPath, jobId);
+    if (!fs.existsSync(paths.discovery)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(paths.discovery, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save foundation phase completion
+ */
+export function saveFoundationCheckpoint(projectPath, jobId, foundationPaths) {
+    const paths = getCheckpointPaths(projectPath, jobId);
+    // Save foundation record
+    fs.writeFileSync(paths.foundation, JSON.stringify({
+        completedAt: new Date().toISOString(),
+        files: foundationPaths
+    }, null, 2));
+    // Update main checkpoint
+    const checkpoint = loadCheckpoint(projectPath, jobId) || initializeCheckpoint(projectPath, jobId);
+    checkpoint.foundationPaths = foundationPaths;
+    checkpoint.phase = 'foundation';
+    checkpoint.progressPercent = 100;
+    saveCheckpoint(projectPath, jobId, checkpoint);
+}
+/**
+ * Save matching phase completion
+ */
+export function saveMatchingCheckpoint(projectPath, jobId, result) {
+    const paths = getCheckpointPaths(projectPath, jobId);
+    // Save matching summary (not full data - too large)
+    fs.writeFileSync(paths.matching, JSON.stringify({
+        completedAt: new Date().toISOString(),
+        stats: result.stats,
+        priorityQueue: result.priorityQueue.slice(0, 20)
+    }, null, 2));
+    // Update main checkpoint
+    const checkpoint = loadCheckpoint(projectPath, jobId) || initializeCheckpoint(projectPath, jobId);
+    checkpoint.matchingStats = result.stats;
+    checkpoint.phase = 'integration';
+    checkpoint.progressPercent = 100;
+    saveCheckpoint(projectPath, jobId, checkpoint);
+}
+/**
+ * Update module analysis progress
+ */
+export function updateModuleProgress(projectPath, jobId, completedModule, remainingModules) {
+    const checkpoint = loadCheckpoint(projectPath, jobId);
+    if (!checkpoint)
+        return;
+    if (!checkpoint.moduleAnalysis) {
+        checkpoint.moduleAnalysis = {
+            completed: [],
+            remaining: remainingModules
+        };
+    }
+    checkpoint.moduleAnalysis.completed.push(completedModule);
+    checkpoint.moduleAnalysis.remaining = remainingModules;
+    checkpoint.moduleAnalysis.current = remainingModules[0];
+    // Calculate progress
+    const total = checkpoint.moduleAnalysis.completed.length + remainingModules.length;
+    checkpoint.progressPercent = Math.round((checkpoint.moduleAnalysis.completed.length / total) * 100);
+    saveCheckpoint(projectPath, jobId, checkpoint);
+}
+/**
+ * Start module analysis phase
+ */
+export function startModuleAnalysis(projectPath, jobId, modules) {
+    const checkpoint = loadCheckpoint(projectPath, jobId);
+    if (!checkpoint)
+        return;
+    checkpoint.phase = 'deep-dive';
+    checkpoint.progressPercent = 0;
+    checkpoint.moduleAnalysis = {
+        completed: [],
+        current: modules[0],
+        remaining: modules
+    };
+    saveCheckpoint(projectPath, jobId, checkpoint);
+}
+/**
+ * Record an error in the checkpoint
+ */
+export function recordError(projectPath, jobId, phase, message) {
+    const checkpoint = loadCheckpoint(projectPath, jobId);
+    if (!checkpoint)
+        return;
+    checkpoint.errors.push({
+        phase,
+        message,
+        timestamp: new Date().toISOString()
+    });
+    saveCheckpoint(projectPath, jobId, checkpoint);
+}
+/**
+ * Complete job with final phase
+ */
+export function completeJob(projectPath, jobId) {
+    const checkpoint = loadCheckpoint(projectPath, jobId);
+    if (!checkpoint)
+        return;
+    checkpoint.phase = 'suggestions';
+    checkpoint.progressPercent = 100;
+    saveCheckpoint(projectPath, jobId, checkpoint);
+}
+/**
+ * Check if a phase is already completed
+ */
+export function isPhaseCompleted(checkpoint, phase) {
+    if (!checkpoint)
+        return false;
+    const phaseOrder = [
+        'waiting', 'discovery', 'foundation', 'integration', 'deep-dive', 'suggestions'
+    ];
+    const currentIndex = phaseOrder.indexOf(checkpoint.phase);
+    const targetIndex = phaseOrder.indexOf(phase);
+    // Phase is completed if we're past it AND progress is 100%
+    if (currentIndex > targetIndex)
+        return true;
+    if (currentIndex === targetIndex && checkpoint.progressPercent === 100)
+        return true;
+    return false;
+}
+/**
+ * Get resume point for a job
+ */
+export function getResumePoint(projectPath, jobId) {
+    const checkpoint = loadCheckpoint(projectPath, jobId);
+    if (!checkpoint)
+        return null;
+    // If in deep-dive phase, resume from current module
+    if (checkpoint.phase === 'deep-dive' && checkpoint.moduleAnalysis?.current) {
+        return {
+            phase: 'deep-dive',
+            module: checkpoint.moduleAnalysis.current
+        };
+    }
+    // Otherwise resume from current phase
+    return { phase: checkpoint.phase };
+}
+//# sourceMappingURL=checkpoint-manager.js.map

package/dist/src/core/living-docs/checkpoint-manager.js.map

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

package/dist/src/core/living-docs/discovery.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Living Docs Builder - Discovery Phase
+ *
+ * Scans the codebase structure without LLM calls to:
+ * - Count files by type and extension
+ * - Detect tech stack from config files
+ * - Find existing documentation
+ * - Identify entry points
+ * - Group files into modules
+ * - Calculate sampling tier
+ */
+/**
+ * Module information discovered from directory structure
+ */
+export interface ModuleInfo {
+    name: string;
+    path: string;
+    fileCount: number;
+    estimatedLOC: number;
+    hasTests: boolean;
+    hasReadme: boolean;
+    entryPoints: string[];
+    extensions: Record<string, number>;
+}
+/**
+ * Sampling configuration based on codebase size
+ */
+export interface SamplingConfig {
+    tier: 'small' | 'medium' | 'large' | 'massive';
+    filesPerDir: number | 'all';
+    priorityPatterns: string[];
+    skipPatterns: string[];
+}
+/**
+ * Complete discovery result
+ */
+export interface DiscoveryResult {
+    codebaseStats: {
+        totalFiles: number;
+        totalDirs: number;
+        byExtension: Record<string, number>;
+        byType: {
+            code: number;
+            tests: number;
+            docs: number;
+            config: number;
+            assets: number;
+        };
+        estimatedLOC: number;
+    };
+    techStack: {
+        languages: string[];
+        frameworks: string[];
+        buildTools: string[];
+        testFrameworks: string[];
+        detectedFrom: string[];
+    };
+    existingDocs: {
+        readme: string | null;
+        contributing: string | null;
+        docsFolder: string | null;
+        wikiFolder: string | null;
+        mdFiles: string[];
+    };
+    entryPoints: {
+        main: string[];
+        index: string[];
+        exports: string[];
+    };
+    modules: ModuleInfo[];
+    tier: SamplingConfig['tier'];
+    samplingConfig: SamplingConfig;
+    discoveredAt: string;
+}
+/**
+ * Progress callback type
+ */
+export type DiscoveryProgressCallback = (current: number, total: number, currentDir: string) => void;
+/**
+ * Run the discovery phase
+ */
+export declare function runDiscovery(projectPath: string, additionalSources: string[], onProgress?: DiscoveryProgressCallback): Promise<DiscoveryResult>;
+/**
+ * Calculate sampling tier based on file count
+ */
+export declare function calculateTier(totalFiles: number): SamplingConfig;
+/**
+ * Select representative files from a directory for analysis
+ */
+export declare function selectRepresentativeFiles(files: string[], maxFiles: number | 'all', moduleName?: string): string[];
+//# sourceMappingURL=discovery.d.ts.map

package/dist/src/core/living-docs/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/C,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;IAC5B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACpC,MAAM,EAAE;YACN,IAAI,EAAE,MAAM,CAAC;YACb,KAAK,EAAE,MAAM,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,SAAS,EAAE;QACT,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IAEF,YAAY,EAAE;QACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IAEF,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IAEF,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;CACtB;AA+FD;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,KACf,IAAI,CAAC;AAEV;;GAEG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,UAAU,CAAC,EAAE,yBAAyB,GACrC,OAAO,CAAC,eAAe,CAAC,CAuE1B;AAoaD;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CA8BhE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE,MAAM,GAAG,KAAK,EACxB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,EAAE,CA2CV"}