specweave 0.22.0 → 0.22.3

package/dist/src/cli/commands/repair-status-desync.js

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+import { validateStatusSync } from './validate-status-sync.js';
+import { SpecFrontmatterUpdater } from '../../core/increment/spec-frontmatter-updater.js';
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'path';
+/**
+ * Create backup of spec.md before repair
+ */
+export async function createBackup(incrementId) {
+    const specPath = path.join(process.cwd(), '.specweave', 'increments', incrementId, 'spec.md');
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = `${specPath}.backup-${timestamp}`;
+    await fs.copyFile(specPath, backupPath);
+    return backupPath;
+}
+/**
+ * Repair a single desync
+ */
+export async function repairDesync(desync, options = {}) {
+    const { dryRun = false, createBackup: shouldBackup = true } = options;
+    // Dry-run: preview only
+    if (dryRun) {
+        return {
+            incrementId: desync.incrementId,
+            oldStatus: desync.specStatus,
+            newStatus: desync.metadataStatus,
+            success: true,
+        };
+    }
+    try {
+        // Create backup if enabled
+        let backupPath;
+        if (shouldBackup) {
+            backupPath = await createBackup(desync.incrementId);
+        }
+        // Update spec.md to match metadata.json
+        await SpecFrontmatterUpdater.updateStatus(desync.incrementId, desync.metadataStatus);
+        return {
+            incrementId: desync.incrementId,
+            oldStatus: desync.specStatus,
+            newStatus: desync.metadataStatus,
+            success: true,
+            backupPath,
+        };
+    }
+    catch (error) {
+        return {
+            incrementId: desync.incrementId,
+            oldStatus: desync.specStatus,
+            newStatus: desync.metadataStatus,
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Repair all desyncs or a specific increment
+ */
+export async function repairStatusDesync(options = {}) {
+    const { all = false, incrementId, dryRun = false } = options;
+    // Get desyncs from validation
+    const validation = await validateStatusSync();
+    let desyncsToRepair = [];
+    if (incrementId) {
+        // Repair specific increment
+        const desync = validation.desyncs.find((d) => d.incrementId === incrementId);
+        if (!desync) {
+            throw new Error(`No desync found for increment ${incrementId}`);
+        }
+        desyncsToRepair = [desync];
+    }
+    else if (all) {
+        // Repair all desyncs
+        desyncsToRepair = validation.desyncs;
+    }
+    else {
+        throw new Error('Must specify either --all or <incrementId>');
+    }
+    const results = [];
+    for (const desync of desyncsToRepair) {
+        const result = await repairDesync(desync, options);
+        results.push(result);
+    }
+    const repaired = results.filter((r) => r.success).length;
+    const failed = results.filter((r) => !r.success).length;
+    return {
+        total: results.length,
+        repaired,
+        failed,
+        results,
+    };
+}
+/**
+ * Write audit log
+ */
+export async function writeAuditLog(results) {
+    const logsDir = path.join(process.cwd(), '.specweave', 'logs');
+    await fs.ensureDir(logsDir);
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const logPath = path.join(logsDir, `status-desync-repair-${timestamp}.json`);
+    const entries = results.map((result) => ({
+        timestamp: new Date().toISOString(),
+        incrementId: result.incrementId,
+        oldStatus: result.oldStatus,
+        newStatus: result.newStatus,
+        success: result.success,
+        error: result.error,
+        backupPath: result.backupPath,
+    }));
+    await fs.writeFile(logPath, JSON.stringify(entries, null, 2), 'utf-8');
+    return logPath;
+}
+/**
+ * Format repair report
+ */
+export function formatRepairReport(result, dryRun = false) {
+    const lines = [];
+    lines.push('');
+    lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    if (dryRun) {
+        lines.push(chalk.cyan('DRY RUN: Status Desync Repair Preview'));
+    }
+    else {
+        lines.push('Status Desync Repair Report');
+    }
+    lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    lines.push('');
+    lines.push(`Total desyncs: ${result.total}`);
+    if (dryRun) {
+        lines.push(chalk.cyan(`Would repair: ${result.repaired}`));
+        if (result.failed > 0) {
+            lines.push(chalk.yellow(`Would fail: ${result.failed}`));
+        }
+    }
+    else {
+        lines.push(chalk.green(`Repaired: ${result.repaired}`));
+        if (result.failed > 0) {
+            lines.push(chalk.red(`Failed: ${result.failed}`));
+        }
+    }
+    lines.push('');
+    for (const repair of result.results) {
+        if (dryRun) {
+            lines.push(chalk.cyan(`DRY RUN: Would update ${chalk.bold(repair.incrementId)} from "${repair.oldStatus}" to "${repair.newStatus}"`));
+        }
+        else if (repair.success) {
+            lines.push(chalk.green(`✅ Repaired ${chalk.bold(repair.incrementId)}: "${repair.oldStatus}" → "${repair.newStatus}"`));
+            if (repair.backupPath) {
+                lines.push(`   Backup: ${repair.backupPath}`);
+            }
+        }
+        else {
+            lines.push(chalk.red(`❌ Failed ${chalk.bold(repair.incrementId)}: "${repair.oldStatus}" → "${repair.newStatus}"`));
+            if (repair.error) {
+                lines.push(`   Error: ${repair.error}`);
+            }
+        }
+    }
+    lines.push('');
+    if (!dryRun && result.repaired > 0) {
+        lines.push(chalk.green(`✅ ${result.repaired} desync(s) repaired successfully!`));
+        lines.push('');
+        lines.push('To verify:');
+        lines.push(chalk.cyan('  npx specweave validate-status-sync'));
+    }
+    else if (dryRun) {
+        lines.push(chalk.cyan('To apply these changes:'));
+        lines.push(chalk.cyan('  npx specweave repair-status-desync --all'));
+    }
+    lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Main CLI entry point
+ */
+export async function main(argv = process.argv) {
+    try {
+        // Parse CLI arguments
+        const args = argv.slice(2);
+        const options = {
+            all: args.includes('--all'),
+            dryRun: args.includes('--dry-run'),
+            createBackup: !args.includes('--no-backup'),
+        };
+        // Check for increment ID (non-flag argument)
+        const incrementIdArg = args.find((arg) => !arg.startsWith('--'));
+        if (incrementIdArg) {
+            options.incrementId = incrementIdArg;
+        }
+        if (options.dryRun) {
+            console.log(chalk.cyan('🔍 DRY RUN MODE: No files will be modified\n'));
+        }
+        else {
+            console.log('🔧 Repairing status desyncs...\n');
+        }
+        const result = await repairStatusDesync(options);
+        const report = formatRepairReport(result, options.dryRun);
+        console.log(report);
+        // Write audit log (skip in dry-run mode)
+        if (!options.dryRun && result.total > 0) {
+            const logPath = await writeAuditLog(result.results);
+            console.log(chalk.gray(`Audit log: ${logPath}\n`));
+        }
+        // Exit with error code if any repairs failed
+        if (result.failed > 0 && !options.dryRun) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('Error during repair:'));
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}
+//# sourceMappingURL=repair-status-desync.js.map

package/dist/src/cli/commands/repair-status-desync.js.map

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

package/dist/src/cli/commands/sync-specs.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLI Command: sync-specs
+ *
+ * Syncs increment specifications to living docs structure
+ */
+export interface SyncSpecsArgs {
+    incrementId?: string;
+    all?: boolean;
+    force?: boolean;
+    dryRun?: boolean;
+}
+/**
+ * Sync specs command entry point
+ */
+export declare function syncSpecs(args: string[]): Promise<void>;
+//# sourceMappingURL=sync-specs.d.ts.map

package/dist/src/cli/commands/sync-specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-specs.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/sync-specs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiE7D"}

package/dist/src/cli/commands/sync-specs.js

@@ -0,0 +1,130 @@
+/**
+ * CLI Command: sync-specs
+ *
+ * Syncs increment specifications to living docs structure
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { LivingDocsSync } from '../../core/living-docs/living-docs-sync.js';
+/**
+ * Sync specs command entry point
+ */
+export async function syncSpecs(args) {
+    const parsedArgs = parseArgs(args);
+    const projectRoot = process.cwd();
+    const sync = new LivingDocsSync(projectRoot);
+    try {
+        if (parsedArgs.all) {
+            // Sync all completed increments
+            console.log('🔄 Syncing all completed increments...\n');
+            const increments = await findCompletedIncrements(projectRoot);
+            let successCount = 0;
+            let failCount = 0;
+            for (const incrementId of increments) {
+                try {
+                    const result = await sync.syncIncrement(incrementId, {
+                        dryRun: parsedArgs.dryRun,
+                        force: parsedArgs.force
+                    });
+                    if (result.success) {
+                        successCount++;
+                    }
+                    else {
+                        failCount++;
+                        console.error(`   ❌ Failed: ${result.errors.join(', ')}`);
+                    }
+                }
+                catch (error) {
+                    failCount++;
+                    console.error(`   ❌ Failed to sync ${incrementId}:`, error);
+                }
+            }
+            console.log(`\n✅ Sync complete: ${successCount} succeeded, ${failCount} failed`);
+        }
+        else {
+            // Sync single increment
+            const incrementId = parsedArgs.incrementId || await findLatestCompletedIncrement(projectRoot);
+            if (!incrementId) {
+                console.error('❌ No increment specified and no completed increments found');
+                process.exit(1);
+            }
+            const result = await sync.syncIncrement(incrementId, {
+                dryRun: parsedArgs.dryRun,
+                force: parsedArgs.force
+            });
+            if (!result.success) {
+                console.error('❌ Sync failed:', result.errors.join(', '));
+                process.exit(1);
+            }
+            console.log('\n✅ Sync complete!');
+            if (parsedArgs.dryRun) {
+                console.log('   (Dry run - no files were actually created)');
+            }
+        }
+    }
+    catch (error) {
+        console.error('❌ Sync failed:', error);
+        process.exit(1);
+    }
+}
+/**
+ * Parse command-line arguments
+ */
+function parseArgs(args) {
+    const parsed = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--all') {
+            parsed.all = true;
+        }
+        else if (arg === '--force') {
+            parsed.force = true;
+        }
+        else if (arg === '--dry-run') {
+            parsed.dryRun = true;
+        }
+        else if (!arg.startsWith('--')) {
+            // Assume it's the increment ID
+            parsed.incrementId = arg;
+        }
+    }
+    return parsed;
+}
+/**
+ * Find all completed increments
+ */
+async function findCompletedIncrements(projectRoot) {
+    const incrementsDir = path.join(projectRoot, '.specweave/increments');
+    if (!await fs.pathExists(incrementsDir)) {
+        return [];
+    }
+    const entries = await fs.readdir(incrementsDir);
+    const completed = [];
+    for (const entry of entries) {
+        if (!entry.match(/^\d{4}-/))
+            continue;
+        const metadataPath = path.join(incrementsDir, entry, 'metadata.json');
+        const specPath = path.join(incrementsDir, entry, 'spec.md');
+        // Skip if no spec.md
+        if (!await fs.pathExists(specPath)) {
+            console.log(`   ⚠️  Skipping ${entry} (no spec.md)`);
+            continue;
+        }
+        // Check if completed
+        if (await fs.pathExists(metadataPath)) {
+            const metadata = await fs.readJson(metadataPath);
+            if (metadata.status === 'completed') {
+                completed.push(entry);
+            }
+        }
+    }
+    return completed.sort();
+}
+/**
+ * Find latest completed increment
+ */
+async function findLatestCompletedIncrement(projectRoot) {
+    const completed = await findCompletedIncrements(projectRoot);
+    return completed.length > 0 ? completed[completed.length - 1] : null;
+}
+//# sourceMappingURL=sync-specs.js.map

package/dist/src/cli/commands/sync-specs.js.map

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

package/dist/src/cli/commands/validate-status-sync.d.ts

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { IncrementStatus } from '../../core/types/increment-metadata.js';
+/**
+ * Severity levels for status desyncs
+ */
+export declare enum DesyncSeverity {
+    CRITICAL = "CRITICAL",
+    HIGH = "HIGH",
+    MEDIUM = "MEDIUM",
+    LOW = "LOW"
+}
+/**
+ * Desync detection result
+ */
+export interface DesyncResult {
+    incrementId: string;
+    metadataStatus: IncrementStatus;
+    specStatus: IncrementStatus;
+    severity: DesyncSeverity;
+    impact: string;
+    fix: string;
+}
+/**
+ * Calculate severity of a status desync
+ */
+export declare function calculateSeverity(metadataStatus: IncrementStatus, specStatus: IncrementStatus): {
+    severity: DesyncSeverity;
+    impact: string;
+};
+/**
+ * Validate status sync across all increments
+ */
+export declare function validateStatusSync(): Promise<{
+    total: number;
+    synced: number;
+    desynced: number;
+    desyncs: DesyncResult[];
+}>;
+/**
+ * Format and print validation report
+ */
+export declare function formatReport(result: {
+    total: number;
+    synced: number;
+    desynced: number;
+    desyncs: DesyncResult[];
+}): string;
+/**
+ * Main CLI entry point
+ */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=validate-status-sync.d.ts.map

package/dist/src/cli/commands/validate-status-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-status-sync.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/validate-status-sync.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAGzE;;GAEG;AACH,oBAAY,cAAc;IACxB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,eAAe,CAAC;IAChC,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,cAAc,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,eAAe,EAC/B,UAAU,EAAE,eAAe,GAC1B;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA6C9C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,CAAC,CAqDD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,GAAG,MAAM,CAiDT;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAkB1C"}

package/dist/src/cli/commands/validate-status-sync.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import { MetadataManager } from '../../core/increment/metadata-manager.js';
+import { SpecFrontmatterUpdater } from '../../core/increment/spec-frontmatter-updater.js';
+import { IncrementStatus } from '../../core/types/increment-metadata.js';
+import chalk from 'chalk';
+/**
+ * Severity levels for status desyncs
+ */
+export var DesyncSeverity;
+(function (DesyncSeverity) {
+    DesyncSeverity["CRITICAL"] = "CRITICAL";
+    DesyncSeverity["HIGH"] = "HIGH";
+    DesyncSeverity["MEDIUM"] = "MEDIUM";
+    DesyncSeverity["LOW"] = "LOW";
+})(DesyncSeverity || (DesyncSeverity = {}));
+/**
+ * Calculate severity of a status desync
+ */
+export function calculateSeverity(metadataStatus, specStatus) {
+    // CRITICAL: Status line will show wrong increment (completed marked as active in spec.md)
+    if ((metadataStatus === IncrementStatus.COMPLETED ||
+        metadataStatus === IncrementStatus.PAUSED ||
+        metadataStatus === IncrementStatus.ABANDONED) &&
+        specStatus === IncrementStatus.ACTIVE) {
+        return {
+            severity: DesyncSeverity.CRITICAL,
+            impact: 'Status line shows completed/paused/abandoned increment as active. Developers see wrong current work.',
+        };
+    }
+    // HIGH: Inverse desync - metadata says active but spec says completed
+    if (metadataStatus === IncrementStatus.ACTIVE &&
+        (specStatus === IncrementStatus.COMPLETED ||
+            specStatus === IncrementStatus.PAUSED ||
+            specStatus === IncrementStatus.ABANDONED)) {
+        return {
+            severity: DesyncSeverity.HIGH,
+            impact: 'Active increment appears completed/paused in spec.md. External tools may close issue prematurely.',
+        };
+    }
+    // MEDIUM: Paused/completed confusion
+    if (metadataStatus === IncrementStatus.PAUSED &&
+        (specStatus === IncrementStatus.COMPLETED || specStatus === IncrementStatus.ACTIVE)) {
+        return {
+            severity: DesyncSeverity.MEDIUM,
+            impact: 'Workflow state confusion. Increment may appear in wrong status.',
+        };
+    }
+    // LOW: Other combinations (rare, minimal impact)
+    return {
+        severity: DesyncSeverity.LOW,
+        impact: 'Minor status inconsistency. Limited user impact.',
+    };
+}
+/**
+ * Validate status sync across all increments
+ */
+export async function validateStatusSync() {
+    const allIncrements = MetadataManager.getAll();
+    const desyncs = [];
+    let syncedCount = 0;
+    for (const metadata of allIncrements) {
+        try {
+            const specStatus = await SpecFrontmatterUpdater.readStatus(metadata.id);
+            // Skip if spec.md missing or status field missing (graceful degradation)
+            if (!specStatus) {
+                continue;
+            }
+            // Check for desync
+            if (specStatus !== metadata.status) {
+                const { severity, impact } = calculateSeverity(metadata.status, specStatus);
+                desyncs.push({
+                    incrementId: metadata.id,
+                    metadataStatus: metadata.status,
+                    specStatus: specStatus,
+                    severity,
+                    impact,
+                    fix: `Run: npx specweave repair-status-desync ${metadata.id}`,
+                });
+            }
+            else {
+                syncedCount++; // Only count as synced if we validated AND they match
+            }
+        }
+        catch (error) {
+            // Skip increments with read errors (e.g., corrupted spec.md)
+            console.warn(`Warning: Could not read spec.md for ${metadata.id}: ${error instanceof Error ? error.message : String(error)}`);
+            continue;
+        }
+    }
+    return {
+        total: allIncrements.length, // All increments scanned
+        synced: syncedCount, // Only increments where spec.md exists AND matches
+        desynced: desyncs.length,
+        desyncs: desyncs.sort((a, b) => {
+            // Sort by severity: CRITICAL > HIGH > MEDIUM > LOW
+            const severityOrder = {
+                [DesyncSeverity.CRITICAL]: 0,
+                [DesyncSeverity.HIGH]: 1,
+                [DesyncSeverity.MEDIUM]: 2,
+                [DesyncSeverity.LOW]: 3,
+            };
+            return severityOrder[a.severity] - severityOrder[b.severity];
+        }),
+    };
+}
+/**
+ * Format and print validation report
+ */
+export function formatReport(result) {
+    const lines = [];
+    lines.push('');
+    lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    lines.push('Status Sync Validation Report');
+    lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    lines.push('');
+    lines.push(`Total increments scanned: ${result.total}`);
+    lines.push(`Synced (✅): ${result.synced}`);
+    lines.push(`Desynced (❌): ${result.desynced}`);
+    lines.push('');
+    if (result.desynced === 0) {
+        lines.push(chalk.green('✅ All increments in sync! No desyncs detected.'));
+    }
+    else {
+        lines.push(chalk.red(`❌ ${result.desynced} desync(s) detected:`));
+        lines.push('');
+        for (const desync of result.desyncs) {
+            const severityColor = desync.severity === DesyncSeverity.CRITICAL
+                ? chalk.red
+                : desync.severity === DesyncSeverity.HIGH
+                    ? chalk.yellow
+                    : desync.severity === DesyncSeverity.MEDIUM
+                        ? chalk.blue
+                        : chalk.gray;
+            lines.push(`Increment: ${chalk.bold(desync.incrementId)}`);
+            lines.push(`  Severity: ${severityColor(desync.severity)}`);
+            lines.push(`  metadata.json: "${desync.metadataStatus}"`);
+            lines.push(`  spec.md: "${desync.specStatus}"`);
+            lines.push(`  Impact: ${desync.impact}`);
+            lines.push(`  Fix: ${chalk.cyan(desync.fix)}`);
+            lines.push('');
+        }
+        lines.push('To repair all desyncs:');
+        lines.push(chalk.cyan('  npx specweave repair-status-desync --all'));
+        lines.push('');
+        lines.push('To preview changes without modifying files:');
+        lines.push(chalk.cyan('  npx specweave repair-status-desync --all --dry-run'));
+    }
+    lines.push('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Main CLI entry point
+ */
+export async function main() {
+    try {
+        console.log('🔍 Validating status sync across all increments...\n');
+        const result = await validateStatusSync();
+        const report = formatReport(result);
+        console.log(report);
+        // Exit with error code if desyncs found
+        if (result.desynced > 0) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('Error during validation:'));
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+// Run if called directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}
+//# sourceMappingURL=validate-status-sync.js.map

package/dist/src/cli/commands/validate-status-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-status-sync.js","sourceRoot":"","sources":["../../../../src/cli/commands/validate-status-sync.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;GAEG;AACH,MAAM,CAAN,IAAY,cAKX;AALD,WAAY,cAAc;IACxB,uCAAqB,CAAA;IACrB,+BAAa,CAAA;IACb,mCAAiB,CAAA;IACjB,6BAAW,CAAA;AACb,CAAC,EALW,cAAc,KAAd,cAAc,QAKzB;AAcD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,cAA+B,EAC/B,UAA2B;IAE3B,0FAA0F;IAC1F,IACE,CAAC,cAAc,KAAK,eAAe,CAAC,SAAS;QAC3C,cAAc,KAAK,eAAe,CAAC,MAAM;QACzC,cAAc,KAAK,eAAe,CAAC,SAAS,CAAC;QAC/C,UAAU,KAAK,eAAe,CAAC,MAAM,EACrC,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,cAAc,CAAC,QAAQ;YACjC,MAAM,EACJ,sGAAsG;SACzG,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,IACE,cAAc,KAAK,eAAe,CAAC,MAAM;QACzC,CAAC,UAAU,KAAK,eAAe,CAAC,SAAS;YACvC,UAAU,KAAK,eAAe,CAAC,MAAM;YACrC,UAAU,KAAK,eAAe,CAAC,SAAS,CAAC,EAC3C,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,cAAc,CAAC,IAAI;YAC7B,MAAM,EACJ,mGAAmG;SACtG,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,IACE,cAAc,KAAK,eAAe,CAAC,MAAM;QACzC,CAAC,UAAU,KAAK,eAAe,CAAC,SAAS,IAAI,UAAU,KAAK,eAAe,CAAC,MAAM,CAAC,EACnF,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,cAAc,CAAC,MAAM;YAC/B,MAAM,EAAE,iEAAiE;SAC1E,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,OAAO;QACL,QAAQ,EAAE,cAAc,CAAC,GAAG;QAC5B,MAAM,EAAE,kDAAkD;KAC3D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IAMtC,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAExE,yEAAyE;YACzE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,SAAS;YACX,CAAC;YAED,mBAAmB;YACnB,IAAI,UAAU,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACnC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;gBAE5E,OAAO,CAAC,IAAI,CAAC;oBACX,WAAW,EAAE,QAAQ,CAAC,EAAE;oBACxB,cAAc,EAAE,QAAQ,CAAC,MAAM;oBAC/B,UAAU,EAAE,UAAU;oBACtB,QAAQ;oBACR,MAAM;oBACN,GAAG,EAAE,2CAA2C,QAAQ,CAAC,EAAE,EAAE;iBAC9D,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,WAAW,EAAE,CAAC,CAAC,sDAAsD;YACvE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,6DAA6D;YAC7D,OAAO,CAAC,IAAI,CACV,uCAAuC,QAAQ,CAAC,EAAE,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAChH,CAAC;YACF,SAAS;QACX,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,yBAAyB;QACtD,MAAM,EAAE,WAAW,EAAE,mDAAmD;QACxE,QAAQ,EAAE,OAAO,CAAC,MAAM;QACxB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC7B,mDAAmD;YACnD,MAAM,aAAa,GAAG;gBACpB,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;aACxB,CAAC;YACF,OAAO,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC/D,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAK5B;IACC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,6BAA6B,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC,CAAC;IAC5E,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,QAAQ,sBAAsB,CAAC,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,aAAa,GACjB,MAAM,CAAC,QAAQ,KAAK,cAAc,CAAC,QAAQ;gBACzC,CAAC,CAAC,KAAK,CAAC,GAAG;gBACX,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,cAAc,CAAC,IAAI;oBACvC,CAAC,CAAC,KAAK,CAAC,MAAM;oBACd,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,cAAc,CAAC,MAAM;wBACzC,CAAC,CAAC,KAAK,CAAC,IAAI;wBACZ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;YAErB,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,eAAe,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC;YAC1D,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACxE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,MAAM,kBAAkB,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAEpC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEpB,wCAAwC;QACxC,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,yBAAyB;AACzB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/src/cli/count-tasks.d.ts

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * Count Tasks CLI
+ *
+ * CLI utility for counting tasks in tasks.md files.
+ * Used by status line hook to get accurate task counts.
+ *
+ * Usage:
+ *   count-tasks <path-to-tasks.md>
+ *
+ * Output (JSON):
+ *   {"total": 23, "completed": 15, "percentage": 65}
+ *
+ * Exit codes:
+ *   0 - Success
+ *   1 - File not found or read error
+ *   2 - Invalid arguments
+ */
+export {};
+//# sourceMappingURL=count-tasks.d.ts.map

package/dist/src/cli/count-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"count-tasks.d.ts","sourceRoot":"","sources":["../../../src/cli/count-tasks.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG"}