specweave 0.22.2 → 0.22.3

package/dist/src/core/status-line/status-line-updater.js

@@ -0,0 +1,203 @@
+/**
+ * Status Line Updater
+ *
+ * Synchronously updates status line cache by scanning spec.md files.
+ * Equivalent to update-status-line.sh but runs SYNCHRONOUSLY.
+ *
+ * Purpose: Force-refresh status line when it appears stale
+ *
+ * Architecture:
+ * 1. Scan all spec.md files for open increments (status = active/planning/in-progress)
+ * 2. Sort by creation date (oldest first)
+ * 3. Select first as current increment
+ * 4. Parse tasks.md for progress (use TaskCounter for accuracy)
+ * 5. Write cache atomically (.specweave/state/status-line.json)
+ *
+ * Performance: ~50-100ms (acceptable for user-facing commands)
+ */
+import fs from 'fs-extra';
+import * as path from 'path';
+import { TaskCounter } from './task-counter.js';
+/**
+ * Maximum number of active increments to display in status line
+ * Aligned with ActiveIncrementManager maximum
+ */
+const MAX_ACTIVE_INCREMENTS_DISPLAY = 2;
+/**
+ * Status Line Updater
+ *
+ * Provides synchronous status line cache updates.
+ */
+export class StatusLineUpdater {
+    constructor(rootDir = process.cwd()) {
+        this.rootDir = rootDir;
+    }
+    /**
+     * Update status line cache synchronously
+     *
+     * This is the main entry point for force-refreshing the status line.
+     * NOW supports up to 2 active increments (aligned with ActiveIncrementManager).
+     */
+    async update() {
+        // Step 1: Find all open increments (scan spec.md)
+        const openIncrements = await this.findOpenIncrements();
+        // Step 2: Sort by creation date (oldest first)
+        const sorted = openIncrements.sort((a, b) => {
+            const aTime = new Date(a.created).getTime();
+            const bTime = new Date(b.created).getTime();
+            return aTime - bTime; // Ascending (oldest first)
+        });
+        // Step 3: Take up to MAX_ACTIVE_INCREMENTS_DISPLAY active increments
+        const activeIds = sorted.slice(0, MAX_ACTIVE_INCREMENTS_DISPLAY);
+        // Step 4: Parse tasks.md for EACH active increment
+        const activeIncrements = await Promise.all(activeIds.map(async (inc) => {
+            const progress = await this.parseTaskProgress(inc.id);
+            return {
+                id: inc.id,
+                name: inc.id, // Format: "0043-spec-md-desync-fix"
+                completed: progress.completed,
+                total: progress.total,
+                percentage: progress.percentage
+            };
+        }));
+        // Step 5: Build cache object
+        const cache = {
+            activeIncrements,
+            openCount: openIncrements.length,
+            lastUpdate: new Date().toISOString(),
+            // BACKWARD COMPATIBILITY: Set 'current' to first active increment
+            current: activeIncrements[0] || null,
+            // Add default state message when no active increments
+            message: openIncrements.length === 0
+                ? 'No active increments. Start with /specweave:increment "feature name"'
+                : undefined
+        };
+        // Step 6: Write cache atomically
+        await this.writeCache(cache);
+    }
+    /**
+     * Find all open increments by scanning spec.md files
+     *
+     * Logic:
+     * - Scan .specweave/increments/[id]/spec.md
+     * - Parse YAML frontmatter for status field
+     * - Filter: status === 'active' || 'planning' || 'in-progress'
+     * - Extract: {id, created, status}
+     */
+    async findOpenIncrements() {
+        const incrementsDir = path.join(this.rootDir, '.specweave/increments');
+        if (!await fs.pathExists(incrementsDir)) {
+            return [];
+        }
+        const entries = await fs.readdir(incrementsDir);
+        const openIncrements = [];
+        for (const entry of entries) {
+            // Skip special directories (_archive, etc.)
+            if (entry.startsWith('_')) {
+                continue;
+            }
+            const specPath = path.join(incrementsDir, entry, 'spec.md');
+            if (await fs.pathExists(specPath)) {
+                const specContent = await fs.readFile(specPath, 'utf-8');
+                const metadata = this.parseSpecMetadata(specContent);
+                // Check if increment is open (active, planning, or in-progress)
+                // ONLY accepts official IncrementStatus enum values
+                if (metadata.status === 'active' ||
+                    metadata.status === 'planning' ||
+                    metadata.status === 'in-progress') {
+                    openIncrements.push({
+                        id: entry,
+                        created: metadata.created || '1970-01-01',
+                        status: metadata.status
+                    });
+                }
+            }
+        }
+        return openIncrements;
+    }
+    /**
+     * Parse spec.md YAML frontmatter
+     *
+     * Extracts: status, created
+     */
+    parseSpecMetadata(content) {
+        const metadata = {
+            status: '',
+            created: '1970-01-01'
+        };
+        // Extract YAML frontmatter (between --- markers)
+        const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch) {
+            return metadata;
+        }
+        const frontmatter = frontmatterMatch[1];
+        // Parse status field
+        const statusMatch = frontmatter.match(/^status:\s*(.+)$/m);
+        if (statusMatch) {
+            metadata.status = statusMatch[1].trim();
+        }
+        // Parse created field
+        const createdMatch = frontmatter.match(/^created:\s*(.+)$/m);
+        if (createdMatch) {
+            metadata.created = createdMatch[1].trim();
+        }
+        return metadata;
+    }
+    /**
+     * Parse tasks.md for progress
+     *
+     * Uses TaskCounter for accurate counting (fixes overcounting bug)
+     */
+    async parseTaskProgress(incrementId) {
+        const tasksPath = path.join(this.rootDir, '.specweave/increments', incrementId, 'tasks.md');
+        if (!await fs.pathExists(tasksPath)) {
+            return { completed: 0, total: 0, percentage: 0 };
+        }
+        try {
+            const tasksContent = await fs.readFile(tasksPath, 'utf-8');
+            const counts = TaskCounter.countTasks(tasksContent);
+            return {
+                completed: counts.completed,
+                total: counts.total,
+                percentage: counts.percentage
+            };
+        }
+        catch (error) {
+            // Graceful degradation: If TaskCounter fails, return zeros
+            console.warn(`⚠️  Failed to parse tasks.md for ${incrementId}:`, error);
+            return { completed: 0, total: 0, percentage: 0 };
+        }
+    }
+    /**
+     * Write cache atomically
+     *
+     * Uses temp file → rename pattern to prevent corruption
+     */
+    async writeCache(cache) {
+        const cacheFile = path.join(this.rootDir, '.specweave/state/status-line.json');
+        const cacheDir = path.dirname(cacheFile);
+        // Ensure state directory exists
+        await fs.ensureDir(cacheDir);
+        // Atomic write: temp file → rename
+        const tempFile = `${cacheFile}.tmp`;
+        await fs.writeFile(tempFile, JSON.stringify(cache, null, 2), 'utf-8');
+        await fs.rename(tempFile, cacheFile);
+    }
+    /**
+     * Get current cache (for testing)
+     */
+    async getCurrentCache() {
+        const cacheFile = path.join(this.rootDir, '.specweave/state/status-line.json');
+        if (!await fs.pathExists(cacheFile)) {
+            return null;
+        }
+        try {
+            const content = await fs.readFile(cacheFile, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=status-line-updater.js.map

package/dist/src/core/status-line/status-line-updater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-line-updater.js","sourceRoot":"","sources":["../../../../src/core/status-line/status-line-updater.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAoBhD;;;GAGG;AACH,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAC5B,YAAoB,UAAkB,OAAO,CAAC,GAAG,EAAE;QAA/B,YAAO,GAAP,OAAO,CAAwB;IAAG,CAAC;IAEvD;;;;;OAKG;IACH,KAAK,CAAC,MAAM;QACV,kDAAkD;QAClD,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAEvD,+CAA+C;QAC/C,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAC1C,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;YAC5C,OAAO,KAAK,GAAG,KAAK,CAAC,CAAC,2BAA2B;QACnD,CAAC,CAAC,CAAC;QAEH,qEAAqE;QACrE,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,6BAA6B,CAAC,CAAC;QAEjE,mDAAmD;QACnD,MAAM,gBAAgB,GAAuB,MAAM,OAAO,CAAC,GAAG,CAC5D,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACtD,OAAO;gBACL,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,oCAAoC;gBAClD,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,UAAU,EAAE,QAAQ,CAAC,UAAU;aAChC,CAAC;QACJ,CAAC,CAAC,CACH,CAAC;QAEF,6BAA6B;QAC7B,MAAM,KAAK,GAAoB;YAC7B,gBAAgB;YAChB,SAAS,EAAE,cAAc,CAAC,MAAM;YAChC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAEpC,kEAAkE;YAClE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,IAAI,IAAI;YAEpC,sDAAsD;YACtD,OAAO,EAAE,cAAc,CAAC,MAAM,KAAK,CAAC;gBAClC,CAAC,CAAC,sEAAsE;gBACxE,CAAC,CAAC,SAAS;SACd,CAAC;QAEF,iCAAiC;QACjC,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,kBAAkB;QAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;QAEvE,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACxC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAChD,MAAM,cAAc,GAAoB,EAAE,CAAC;QAE3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,4CAA4C;YAC5C,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC1B,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;YAE5D,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClC,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;gBAErD,gEAAgE;gBAChE,oDAAoD;gBACpD,IACE,QAAQ,CAAC,MAAM,KAAK,QAAQ;oBAC5B,QAAQ,CAAC,MAAM,KAAK,UAAU;oBAC9B,QAAQ,CAAC,MAAM,KAAK,aAAa,EACjC,CAAC;oBACD,cAAc,CAAC,IAAI,CAAC;wBAClB,EAAE,EAAE,KAAK;wBACT,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,YAAY;wBACzC,MAAM,EAAE,QAAQ,CAAC,MAAM;qBACxB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACK,iBAAiB,CAAC,OAAe;QACvC,MAAM,QAAQ,GAAwC;YACpD,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,YAAY;SACtB,CAAC;QAEF,iDAAiD;QACjD,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;QACnE,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,WAAW,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAExC,qBAAqB;QACrB,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC3D,IAAI,WAAW,EAAE,CAAC;YAChB,QAAQ,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,CAAC;QAED,sBAAsB;QACtB,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC7D,IAAI,YAAY,EAAE,CAAC;YACjB,QAAQ,CAAC,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,iBAAiB,CAAC,WAAmB;QACjD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAE5F,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACnD,CAAC;QAED,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;YAEpD,OAAO;gBACL,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,2DAA2D;YAC3D,OAAO,CAAC,IAAI,CAAC,oCAAoC,WAAW,GAAG,EAAE,KAAK,CAAC,CAAC;YACxE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QACnD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,UAAU,CAAC,KAAsB;QAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,mCAAmC,CAAC,CAAC;QAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAEzC,gCAAgC;QAChC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAE7B,mCAAmC;QACnC,MAAM,QAAQ,GAAG,GAAG,SAAS,MAAM,CAAC;QACpC,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACtE,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,mCAAmC,CAAC,CAAC;QAE/E,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/src/core/status-line/types.d.ts

@@ -1,16 +1,26 @@
 /**
- * Status Line Types (Simplified)
+ * Status Line Types
  *
- * Ultra-simple status line with cached progress.
- * Shows: [increment-name] ████░░░░ X/Y tasks (Z open)
+ * Supports displaying multiple active increments (up to 2).
+ * Shows: [inc-1] ████░░░░ X/Y | [inc-2] ██████░░ A/B (Z open)
  */
 export interface StatusLineCache {
-    /** Current active/in-progress increment (null if none) */
-    current: CurrentIncrement | null;
+    /** NEW: Array of active increments (up to 2) */
+    activeIncrements: CurrentIncrement[];
     /** Total number of open increments (active/in-progress/planning) */
     openCount: number;
     /** ISO timestamp of last cache update */
     lastUpdate: string;
+    /**
+     * DEPRECATED: Use activeIncrements[0] instead
+     * Kept for backward compatibility with old code
+     */
+    current?: CurrentIncrement | null;
+    /**
+     * Optional message to display when no active increments
+     * Used for user guidance when openCount === 0
+     */
+    message?: string;
 }
 export interface CurrentIncrement {
     /** Increment ID (e.g., "0031-external-tool-status-sync") */
@@ -23,6 +33,10 @@ export interface CurrentIncrement {
     total: number;
     /** Completion percentage (0-100) */
     percentage: number;
+    /** Number of completed acceptance criteria (NEW) */
+    acsCompleted?: number;
+    /** Total number of acceptance criteria (NEW) */
+    acsTotal?: number;
 }
 export interface StatusLineConfig {
     /** Enable status line rendering */

package/dist/src/core/status-line/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/status-line/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEjC,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IAEX,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IAEb,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IAEjB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,0BAA0B,EAAE,gBAKxC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/status-line/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IAErC,oEAAoE;IACpE,SAAS,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAElC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IAEX,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IAEb,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IAEnB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IAEjB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,0BAA0B,EAAE,gBAKxC,CAAC"}

package/dist/src/core/status-line/types.js

@@ -1,8 +1,8 @@
 /**
- * Status Line Types (Simplified)
+ * Status Line Types
  *
- * Ultra-simple status line with cached progress.
- * Shows: [increment-name] ████░░░░ X/Y tasks (Z open)
+ * Supports displaying multiple active increments (up to 2).
+ * Shows: [inc-1] ████░░░░ X/Y | [inc-2] ██████░░ A/B (Z open)
  */
 export const DEFAULT_STATUS_LINE_CONFIG = {
     enabled: true,

package/dist/src/core/status-line/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/status-line/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4CH,MAAM,CAAC,MAAM,0BAA0B,GAAqB;IAC1D,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,KAAK,EAAE,oCAAoC;IACxD,gBAAgB,EAAE,CAAC;IACnB,aAAa,EAAE,EAAE;CAClB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/status-line/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8DH,MAAM,CAAC,MAAM,0BAA0B,GAAqB;IAC1D,OAAO,EAAE,IAAI;IACb,WAAW,EAAE,KAAK,EAAE,oCAAoC;IACxD,gBAAgB,EAAE,CAAC;IACnB,aAAa,EAAE,EAAE;CAClB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.22.2",
+  "version": "0.22.3",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/commands/specweave-done.md

@@ -51,7 +51,63 @@ You are acting as the Product Manager to validate increment completion before cl
 🎯 Validating readiness for closure...
 ```
 
-### Step 2: PM Validation (3 Gates)
+### Step 2: Automated Completion Validation (Gate 0)
+
+**🔥 CRITICAL: Automated validation runs BEFORE PM validation to catch obvious issues!**
+
+**BEFORE** invoking the PM agent, run automated validation using `IncrementCompletionValidator`:
+
+```typescript
+import { IncrementCompletionValidator } from '../../../src/core/increment/completion-validator.js';
+
+// Validate increment is ready for completion
+const validation = await IncrementCompletionValidator.validateCompletion(incrementId);
+
+if (!validation.isValid) {
+  // BLOCK completion and show errors
+  console.error('❌ CANNOT CLOSE INCREMENT - Automated validation failed');
+  console.error('');
+  validation.errors.forEach(err => console.error(`  • ${err}`));
+  console.error('');
+  console.error('Fix these issues before running /specweave:done again');
+  process.exit(1);
+}
+```
+
+**Example validation output** (FAIL):
+```
+❌ CANNOT CLOSE INCREMENT - Automated validation failed
+
+  • 17 acceptance criteria still open
+  • 13 tasks still pending
+
+Fix these issues before running /specweave:done again
+```
+
+**Example validation output** (PASS):
+```
+✅ Automated validation passed
+  • All acceptance criteria completed
+  • All tasks completed
+
+Proceeding to PM validation...
+```
+
+**What Gate 0 validates**:
+- [ ] All acceptance criteria are checked (`- [x] **AC-...`)
+- [ ] All tasks are completed (`**Status**: [x] completed`)
+- [ ] Required files exist (`spec.md`, `tasks.md`)
+
+**Why Gate 0 matters**:
+- **Prevents false completion**: Can't mark increment "completed" with open work
+- **Fast feedback**: Fails immediately (< 1s) vs waiting for PM agent (30s+)
+- **Data integrity**: Ensures status matches reality (no spec.md desync)
+
+**CRITICAL**: Gate 0 is MANDATORY and CANNOT be bypassed. If validation fails, increment stays "in-progress" and command exits.
+
+---
+
+### Step 3: PM Validation (3 Gates)
 
 **🔥 CRITICAL: PM agent MUST validate all 3 gates before allowing closure!**
 
@@ -288,7 +344,7 @@ Recommendation: ❌ CANNOT close increment
   • Estimated effort: 1-2 hours
 ```
 
-### Step 3: PM Decision
+### Step 4: PM Decision
 
 **Based on 3-gate validation**:
 
@@ -326,7 +382,7 @@ Closing increment 0001-user-authentication...
 🎉 Increment 0001 closed successfully!
 ```
 
-### Step 4: Post-Closure Sync (AUTOMATIC)
+### Step 5: Post-Closure Sync (AUTOMATIC)
 
 **CRITICAL**: After increment closes, automatically perform these syncs:
 
@@ -651,7 +707,7 @@ Increment remains: in-progress
 Try again after fixing blockers: /specweave:done 0001
 ```
 
-### Step 4: Handle Incomplete Work
+### Step 6: Handle Incomplete Work
 
 **If increment cannot close due to scope creep**:
 

package/plugins/specweave/commands/specweave-reopen.md

@@ -13,7 +13,10 @@ Reopen completed work when issues are discovered after completion.
 ## Quick Start
 
 ```bash
-# Reopen entire increment
+# Reopen entire increment (natural language - RECOMMENDED)
+/specweave:reopen 0043 Bug found in AC sync implementation
+
+# OR with explicit --reason flag
 /specweave:reopen 0031 --reason "GitHub sync failing"
 
 # Reopen specific task
@@ -23,6 +26,23 @@ Reopen completed work when issues are discovered after completion.
 /specweave:reopen 0031 --user-story US-001 --reason "Acceptance criteria not met"
 ```
 
+### Natural Language Syntax (NEW!)
+
+You can now use natural language without the `--reason` flag:
+
+```bash
+# ✅ WORKS: Natural language (everything after increment ID is the reason)
+/specweave:reopen 0043 Bug found in implementation, need to fix
+
+# ✅ WORKS: Traditional syntax with flag
+/specweave:reopen 0043 --reason "Bug found in implementation"
+
+# ✅ WORKS: With task ID
+/specweave:reopen 0043 --task T-005 Found edge case not covered
+```
+
+**How it works**: All text after the increment ID (and any flags) is treated as the reason. No quotes needed!
+
 ## Smart Detection First!
 
 **Before using this command manually**, try reporting your issue naturally:
@@ -119,11 +139,18 @@ Use `--force` to bypass WIP limit checks (use sparingly!).
 | Parameter | Required | Description |
 |-----------|----------|-------------|
 | `<increment-id>` | Yes | Increment to reopen (e.g., `0031` or `0031-external-tool-status-sync`) |
-| `--reason <text>` | Yes | Why reopening (for audit trail) |
+| `--reason <text>` | Optional* | Why reopening (for audit trail). *Can use natural language instead! |
 | `--task <id>` | No | Reopen specific task (e.g., `T-003`) |
 | `--user-story <id>` | No | Reopen user story + related tasks (e.g., `US-001`) |
 | `--force` | No | Bypass WIP limit checks |
 
+**Natural Language**: If `--reason` is not provided, all remaining text is used as the reason.
+
+Examples:
+- `/specweave:reopen 0043 Bug found` → reason = "Bug found"
+- `/specweave:reopen 0043 --task T-005 Edge case` → reason = "Edge case"
+- `/specweave:reopen 0043 --reason "Formal reason"` → reason = "Formal reason" (explicit)
+
 ## WIP Limit Validation
 
 The command automatically checks WIP limits before reopening increments.

package/plugins/specweave/commands/specweave-sync-docs.md

@@ -243,6 +243,57 @@ Synchronize living documentation in `.specweave/docs/` with learnings and decisi
 
 ### Execution Steps:
 
+#### 0. 🔄 SYNC LIVING SPECS (User Stories, ACs, Tasks) - CRITICAL FIRST STEP
+
+**🚨 MANDATORY: This MUST run FIRST before syncing strategic docs!**
+
+Execute the living specs sync using the TypeScript CLI:
+
+```typescript
+import { syncSpecs } from './dist/src/cli/commands/sync-specs.js';
+
+console.log('═══════════════════════════════════════════════════════');
+console.log('📋 STEP 0: SYNCING LIVING SPECS');
+console.log('═══════════════════════════════════════════════════════\n');
+console.log('🔄 Syncing user stories, acceptance criteria, and tasks...\n');
+
+// Call sync-specs to sync living docs structure
+await syncSpecs(['{increment_id}']);
+
+console.log('\n✅ Living specs synced successfully!');
+console.log('   - User stories created/updated in .specweave/docs/internal/specs/');
+console.log('   - Acceptance criteria synchronized with completion status');
+console.log('   - Tasks linked to user stories\n');
+```
+
+**What this step does**:
+- ✅ Parses increment spec.md and extracts user stories with ACs
+- ✅ Syncs AC completion status from spec.md to user story files
+- ✅ Updates task mappings in user story files
+- ✅ Creates/updates feature files and README
+- ✅ Ensures living specs are in sync BEFORE strategic docs
+
+**Output**:
+```
+🎯 Target increment: {increment_id}
+📁 Increment path: .specweave/increments/{increment_id}
+🔄 Mode: Specs-only sync (Universal Hierarchy)
+
+Processing...
+📚 Syncing {increment_id} → {FS-XXX}...
+   ✅ Synced 3 tasks to US-001
+   ✅ Synced 2 tasks to US-002
+
+✅ Synced {increment_id} → {FS-XXX}
+   Created: 5 files
+
+═══════════════════════════════════════════════════════
+```
+
+**CRITICAL**: If this step fails, STOP and report error. Do not proceed to strategic docs sync.
+
+---
+
 #### 1. Analyze Increment Artifacts
 
 ```bash
@@ -510,7 +561,16 @@ Increment: {increment_id} ({title})
 Status: {status} → Documentation Updated
 
 ───────────────────────────────────────────────────────
-📊 CHANGES SUMMARY
+📋 LIVING SPECS SYNCED (Step 0)
+───────────────────────────────────────────────────────
+
+✅ User Stories: {count} created/updated in .specweave/docs/internal/specs/
+✅ Acceptance Criteria: Synchronized with completion status from spec.md
+✅ Tasks: Linked to user stories with completion tracking
+✅ Feature Files: Created/updated in .specweave/docs/internal/specs/_features/
+
+───────────────────────────────────────────────────────
+📊 STRATEGIC DOCS CHANGES (Steps 1-5)
 ───────────────────────────────────────────────────────
 
 Created:
@@ -544,20 +604,27 @@ To restore: cp {file}.backup {file}
 ───────────────────────────────────────────────────────
 
 1. Review updated documentation:
+   - Living specs: .specweave/docs/internal/specs/
    - Public docs: .specweave/docs/public/
    - Internal docs: .specweave/docs/internal/
    - New ADRs: .specweave/docs/internal/architecture/adr/
 
-2. (Optional) Generate Docusaurus site:
+2. Verify living specs sync:
+   - Check user story files for updated AC checkboxes
+   - Verify tasks are linked correctly
+   - Confirm feature files are up to date
+
+3. (Optional) Generate Docusaurus site:
    - Use 'docusaurus' skill to publish updated docs
 
-3. Commit changes:
+4. Commit changes:
    git add .specweave/docs/
    git commit -m "docs: sync from increment {increment_id}"
 
 ═══════════════════════════════════════════════════════
 
-Documentation is now in sync with increment {increment_id}! 🎉
+ALL documentation is now in sync with increment {increment_id}! 🎉
+(Living specs + Strategic docs)
 ```
 
 ---