specweave 1.0.464 → 1.0.466

package/dist/plugins/specweave/lib/vendor/core/increment/active-increment-manager.js

@@ -0,0 +1,273 @@
+/**
+ * Active Increment Manager
+ *
+ * Manages the `.specweave/state/active-increment.json` file which tracks
+ * the currently active increment for status line display.
+ *
+ * **Critical**: This file MUST be updated whenever increment status changes:
+ * - When new increment is created → Set as active
+ * - When increment is completed → Clear or set to next active
+ * - When increment is paused → Set to next active (or clear if none)
+ * - When increment is resumed → Set as active
+ *
+ * Part of increment 0021: Fix Active Increment Tracking
+ */
+import * as fs from '../../utils/fs-native.js';
+import path from 'path';
+import { IncrementStatus } from '../types/increment-metadata.js';
+import { MetadataManager } from './metadata-manager.js';
+/**
+ * Active Increment Manager
+ *
+ * Central authority for managing which increment is currently active.
+ */
+export class ActiveIncrementManager {
+    constructor(rootDir = process.cwd()) {
+        this.rootDir = rootDir;
+        this.stateFile = path.join(rootDir, '.specweave/state/active-increment.json');
+    }
+    /**
+     * Get all currently active increment IDs
+     * Returns empty array if no increments are active
+     *
+     * **NEW**: Returns array of ALL active increments (max 2)
+     */
+    getActive() {
+        try {
+            if (!fs.existsSync(this.stateFile)) {
+                return [];
+            }
+            const content = fs.readFileSync(this.stateFile, 'utf-8');
+            const state = JSON.parse(content);
+            // Backwards compatibility: Support old format
+            if (state.id && !state.ids) {
+                return [state.id];
+            }
+            return state.ids || [];
+        }
+        catch (error) {
+            // File read/parse error = no active increments
+            return [];
+        }
+    }
+    /**
+     * Get the primary active increment (first in list)
+     * Returns null if no increments are active
+     *
+     * This maintains backwards compatibility with code expecting a single ID
+     */
+    getPrimary() {
+        const active = this.getActive();
+        return active.length > 0 ? active[0] : null;
+    }
+    /**
+     * Add an increment to the active list
+     * Validates that the increment exists and is actually active
+     *
+     * **NEW**: Adds to list instead of replacing (max 2)
+     * @param skipValidation - Skip validation (used during lazy initialization to prevent circular dependency)
+     */
+    addActive(incrementId, skipValidation = false) {
+        // Validate increment exists and is active (unless skipValidation is true)
+        if (!skipValidation) {
+            const metadata = MetadataManager.read(incrementId, this.rootDir);
+            // Validate increment is actually active
+            if (metadata.status !== IncrementStatus.ACTIVE) {
+                throw new Error(`Cannot add ${incrementId} as active: status is ${metadata.status}, not active`);
+            }
+        }
+        // Get current active list
+        const currentActive = this.getActive();
+        // Don't add if already in list
+        if (currentActive.includes(incrementId)) {
+            return;
+        }
+        // Add to list (max 2)
+        const newActive = [...currentActive, incrementId].slice(0, 2);
+        // Write state
+        const state = {
+            ids: newActive,
+            lastUpdated: new Date().toISOString()
+        };
+        this.writeState(state);
+    }
+    /**
+     * Remove an increment from the active list
+     */
+    removeActive(incrementId) {
+        const currentActive = this.getActive();
+        const newActive = currentActive.filter(id => id !== incrementId);
+        const state = {
+            ids: newActive,
+            lastUpdated: new Date().toISOString()
+        };
+        this.writeState(state);
+    }
+    /**
+     * Set the active increment (legacy method for backwards compatibility)
+     * Now delegates to addActive()
+     * @param skipValidation - Skip validation (used during lazy initialization to prevent circular dependency)
+     */
+    setActive(incrementId, skipValidation = false) {
+        this.addActive(incrementId, skipValidation);
+    }
+    /**
+     * Clear all active increments
+     */
+    clearActive() {
+        const state = {
+            ids: [],
+            lastUpdated: new Date().toISOString()
+        };
+        this.writeState(state);
+    }
+    /**
+     * Smart update: Rebuild active list from metadata
+     *
+     * This is called when:
+     * - An increment is completed
+     * - An increment is paused
+     * - An increment is abandoned
+     *
+     * Logic:
+     * 1. Scan all increments for status=active
+     * 2. Update cache to match reality
+     * 3. Max 2 increments (sorted by lastActivity)
+     */
+    smartUpdate() {
+        // Use getByStatus directly to avoid caching circular dependency
+        // MetadataManager.getActive() uses this cache, so we can't call it here
+        const activeIncrements = MetadataManager.getByStatus(IncrementStatus.ACTIVE);
+        if (activeIncrements.length > 0) {
+            // Sort by lastActivity (most recent first)
+            const sorted = activeIncrements.sort((a, b) => {
+                const aTime = new Date(a.lastActivity).getTime();
+                const bTime = new Date(b.lastActivity).getTime();
+                return bTime - aTime; // Descending
+            });
+            // Take max 2
+            const activeIds = sorted.slice(0, 2).map(m => m.id);
+            const state = {
+                ids: activeIds,
+                lastUpdated: new Date().toISOString()
+            };
+            this.writeState(state);
+        }
+        else {
+            // No active increments
+            this.clearActive();
+        }
+    }
+    /**
+     * Validate that all active increment pointers are correct
+     * Does NOT fix stale pointers - caller should call smartUpdate() if needed
+     *
+     * Returns true if all valid, false if any invalid
+     */
+    validate() {
+        const currentActive = this.getActive();
+        // No active increments = valid (nothing to validate)
+        if (currentActive.length === 0) {
+            return true;
+        }
+        let hasStale = false;
+        for (const incrementId of currentActive) {
+            try {
+                // Check if increment still exists
+                const metadata = MetadataManager.read(incrementId);
+                // Check if increment is actually active
+                if (metadata.status !== IncrementStatus.ACTIVE) {
+                    // Stale pointer! Mark for fix
+                    console.warn(`⚠️  Active increment pointer is stale: ${incrementId} is ${metadata.status}`);
+                    hasStale = true;
+                }
+            }
+            catch (error) {
+                // Increment doesn't exist = stale pointer
+                console.warn(`⚠️  Active increment pointer is invalid: ${incrementId} not found`);
+                hasStale = true;
+            }
+        }
+        // Return false if stale found, but DON'T auto-fix (prevents circular dependency)
+        // Caller should call smartUpdate() if needed
+        return !hasStale;
+    }
+    /**
+     * Validate and auto-repair the active increment state
+     *
+     * This is the recommended method to call on startup to ensure
+     * the active-increment.json is in sync with metadata.json files.
+     *
+     * Part of 0168: Status Single Source of Truth
+     *
+     * @returns Object with validation result and any repairs made
+     */
+    validateAndRepair() {
+        const details = [];
+        const currentActive = this.getActive();
+        // Track what needs repair
+        const staleIds = [];
+        const missingIds = [];
+        // Check each currently "active" increment
+        for (const incrementId of currentActive) {
+            try {
+                const metadata = MetadataManager.read(incrementId, this.rootDir);
+                if (metadata.status !== IncrementStatus.ACTIVE) {
+                    staleIds.push(incrementId);
+                    details.push(`Stale: ${incrementId} is ${metadata.status}, not active`);
+                }
+            }
+            catch {
+                missingIds.push(incrementId);
+                details.push(`Missing: ${incrementId} not found`);
+            }
+        }
+        // Check for active increments NOT in our list (missed additions)
+        // Note: We use getByStatus directly to scan all metadata files
+        // This avoids potential caching issues with getActive()
+        const actuallyActive = MetadataManager.getByStatus(IncrementStatus.ACTIVE);
+        const actuallyActiveIds = actuallyActive.map(m => m.id);
+        const missingFromList = actuallyActiveIds.filter(id => !currentActive.includes(id));
+        for (const id of missingFromList) {
+            details.push(`Missing from list: ${id} is active but not tracked`);
+        }
+        // If anything is wrong, repair by calling smartUpdate
+        const needsRepair = staleIds.length > 0 || missingIds.length > 0 || missingFromList.length > 0;
+        if (needsRepair) {
+            this.smartUpdate();
+            details.push('Auto-repaired: Rebuilt active increment list from metadata');
+        }
+        return {
+            valid: !needsRepair,
+            repaired: needsRepair,
+            details
+        };
+    }
+    /**
+     * Write state file atomically (temp file → rename)
+     */
+    writeState(state) {
+        // Ensure state directory exists
+        const stateDir = path.dirname(this.stateFile);
+        if (!fs.existsSync(stateDir)) {
+            fs.mkdirSync(stateDir, { recursive: true });
+        }
+        // Atomic write: temp file → rename
+        const tempFile = `${this.stateFile}.tmp`;
+        fs.writeFileSync(tempFile, JSON.stringify(state, null, 2), 'utf-8');
+        fs.renameSync(tempFile, this.stateFile);
+    }
+    /**
+     * Get state file path (for testing)
+     */
+    getStateFilePath() {
+        return this.stateFile;
+    }
+    /**
+     * Check if state file exists (for testing)
+     */
+    exists() {
+        return fs.existsSync(this.stateFile);
+    }
+}
+//# sourceMappingURL=active-increment-manager.js.map

package/dist/plugins/specweave/lib/vendor/core/increment/active-increment-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-increment-manager.js","sourceRoot":"","sources":["../../../../src/core/increment/active-increment-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAC/C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAoBxD;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAGjC,YAAoB,UAAkB,OAAO,CAAC,GAAG,EAAE;QAA/B,YAAO,GAAP,OAAO,CAAwB;QACjD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,wCAAwC,CAAC,CAAC;IAChF,CAAC;IAED;;;;;OAKG;IACH,SAAS;QACP,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBACnC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,KAAK,GAAyB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAExD,8CAA8C;YAC9C,IAAI,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpB,CAAC;YAED,OAAO,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,+CAA+C;YAC/C,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,UAAU;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,WAAmB,EAAE,iBAA0B,KAAK;QAC5D,0EAA0E;QAC1E,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAEjE,wCAAwC;YACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CACb,cAAc,WAAW,yBAAyB,QAAQ,CAAC,MAAM,cAAc,CAChF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAEvC,+BAA+B;QAC/B,IAAI,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QAED,sBAAsB;QACtB,MAAM,SAAS,GAAG,CAAC,GAAG,aAAa,EAAE,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAE9D,cAAc;QACd,MAAM,KAAK,GAAyB;YAClC,GAAG,EAAE,SAAS;YACd,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,WAAmB;QAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;QAEjE,MAAM,KAAK,GAAyB;YAClC,GAAG,EAAE,SAAS;YACd,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,WAAmB,EAAE,iBAA0B,KAAK;QAC5D,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,WAAW;QACT,MAAM,KAAK,GAAyB;YAClC,GAAG,EAAE,EAAE;YACP,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,WAAW;QACT,gEAAgE;QAChE,wEAAwE;QACxE,MAAM,gBAAgB,GAAG,eAAe,CAAC,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAE7E,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,2CAA2C;YAC3C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;gBAC5C,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;gBACjD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;gBACjD,OAAO,KAAK,GAAG,KAAK,CAAC,CAAC,aAAa;YACrC,CAAC,CAAC,CAAC;YAEH,aAAa;YACb,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAEpD,MAAM,KAAK,GAAyB;gBAClC,GAAG,EAAE,SAAS;gBACd,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACtC,CAAC;YACF,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;aAAM,CAAC;YACN,uBAAuB;YACvB,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,QAAQ;QACN,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAEvC,qDAAqD;QACrD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,KAAK,MAAM,WAAW,IAAI,aAAa,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,kCAAkC;gBAClC,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAEnD,wCAAwC;gBACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;oBAC/C,8BAA8B;oBAC9B,OAAO,CAAC,IAAI,CACV,0CAA0C,WAAW,OAAO,QAAQ,CAAC,MAAM,EAAE,CAC9E,CAAC;oBACF,QAAQ,GAAG,IAAI,CAAC;gBAClB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,0CAA0C;gBAC1C,OAAO,CAAC,IAAI,CAAC,4CAA4C,WAAW,YAAY,CAAC,CAAC;gBAClF,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QAED,iFAAiF;QACjF,6CAA6C;QAC7C,OAAO,CAAC,QAAQ,CAAC;IACnB,CAAC;IAED;;;;;;;;;OASG;IACH,iBAAiB;QACf,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAEvC,0BAA0B;QAC1B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,0CAA0C;QAC1C,KAAK,MAAM,WAAW,IAAI,aAAa,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBACjE,IAAI,QAAQ,CAAC,MAAM,KAAK,eAAe,CAAC,MAAM,EAAE,CAAC;oBAC/C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBAC3B,OAAO,CAAC,IAAI,CAAC,UAAU,WAAW,OAAO,QAAQ,CAAC,MAAM,cAAc,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,YAAY,WAAW,YAAY,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,iEAAiE;QACjE,+DAA+D;QAC/D,wDAAwD;QACxD,MAAM,cAAc,GAAG,eAAe,CAAC,WAAW,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAC3E,MAAM,iBAAiB,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxD,MAAM,eAAe,GAAG,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAEpF,KAAK,MAAM,EAAE,IAAI,eAAe,EAAE,CAAC;YACjC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,4BAA4B,CAAC,CAAC;QACrE,CAAC;QAED,sDAAsD;QACtD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;QAE/F,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC7E,CAAC;QAED,OAAO;YACL,KAAK,EAAE,CAAC,WAAW;YACnB,QAAQ,EAAE,WAAW;YACrB,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,KAA2B;QAC5C,gCAAgC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,mCAAmC;QACnC,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,SAAS,MAAM,CAAC;QACzC,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACpE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/plugins/specweave/lib/vendor/core/increment/auto-transition-manager.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Auto-Transition Manager
+ *
+ * Automatically transitions increment status based on lifecycle events:
+ * - spec.md created → BACKLOG → PLANNING
+ * - tasks.md created → PLANNING/BACKLOG → ACTIVE
+ * - first task started → PLANNING → ACTIVE
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ */
+import { IncrementStatus } from '../types/increment-metadata.js';
+export interface TransitionEvent {
+    incrementId: string;
+    from: IncrementStatus;
+    to: IncrementStatus;
+    trigger: 'spec-created' | 'tasks-created' | 'task-started' | 'auto-correct';
+    timestamp: string;
+}
+export interface AutoTransitionResult {
+    transitioned: boolean;
+    from?: IncrementStatus;
+    to?: IncrementStatus;
+    reason: string;
+}
+/**
+ * Manages automatic status transitions based on increment artifacts
+ */
+export declare class AutoTransitionManager {
+    private projectRoot;
+    constructor(projectRoot: string);
+    /**
+     * Handle spec.md creation event
+     * BACKLOG → PLANNING
+     */
+    handleSpecCreated(incrementId: string): Promise<AutoTransitionResult>;
+    /**
+     * Handle tasks.md creation event
+     * PLANNING/BACKLOG → ACTIVE
+     *
+     * CRITICAL FIX (2025-11-24): Also trigger living docs sync if feature_id is null
+     * In single-prompt scenarios, increment may be created with "active" status
+     * directly, bypassing the normal transition flow. When tasks.md is created,
+     * we know spec.md exists and can safely sync living docs.
+     */
+    handleTasksCreated(incrementId: string): Promise<AutoTransitionResult>;
+    /**
+     * Trigger living docs sync if feature_id is missing
+     *
+     * Called when tasks.md is created but increment is already ACTIVE.
+     * At this point spec.md exists, so sync will succeed.
+     */
+    private triggerLivingDocsSyncIfNeeded;
+    /**
+     * Handle first task started event
+     * PLANNING → ACTIVE
+     */
+    handleTaskStarted(incrementId: string): Promise<AutoTransitionResult>;
+    /**
+     * Detect increment phase based on artifacts (spec.md, plan.md, tasks.md)
+     */
+    detectPhase(incrementId: string): Promise<IncrementStatus>;
+    /**
+     * Auto-correct status based on artifacts
+     * Useful for fixing increments with invalid "planned"/"planning" statuses
+     */
+    autoCorrect(incrementId: string, force?: boolean): Promise<AutoTransitionResult>;
+    /**
+     * Get transition event for logging
+     */
+    createTransitionEvent(incrementId: string, from: IncrementStatus, to: IncrementStatus, trigger: TransitionEvent['trigger']): TransitionEvent;
+}
+//# sourceMappingURL=auto-transition-manager.d.ts.map

package/dist/plugins/specweave/lib/vendor/core/increment/auto-transition-manager.js

@@ -0,0 +1,237 @@
+/**
+ * Auto-Transition Manager
+ *
+ * Automatically transitions increment status based on lifecycle events:
+ * - spec.md created → BACKLOG → PLANNING
+ * - tasks.md created → PLANNING/BACKLOG → ACTIVE
+ * - first task started → PLANNING → ACTIVE
+ *
+ * Part of increment 0039: Ultra-Smart Next Command
+ */
+import { IncrementStatus, validateTransition } from '../types/increment-metadata.js';
+import { MetadataManager } from './metadata-manager.js';
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Manages automatic status transitions based on increment artifacts
+ */
+export class AutoTransitionManager {
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        // Note: MetadataManager uses process.cwd() internally
+        // In production, this manager should be instantiated from the project root
+        // In tests, we use integration tests with real file system
+    }
+    /**
+     * Handle spec.md creation event
+     * BACKLOG → PLANNING
+     */
+    async handleSpecCreated(incrementId) {
+        try {
+            const metadata = MetadataManager.read(incrementId);
+            // Only transition from BACKLOG to PLANNING
+            if (metadata.status === IncrementStatus.BACKLOG) {
+                validateTransition(metadata.status, IncrementStatus.PLANNING);
+                MetadataManager.updateStatus(incrementId, IncrementStatus.PLANNING);
+                return {
+                    transitioned: true,
+                    from: IncrementStatus.BACKLOG,
+                    to: IncrementStatus.PLANNING,
+                    reason: 'spec.md created - planning phase started'
+                };
+            }
+            return {
+                transitioned: false,
+                reason: `Already in ${metadata.status} - no transition needed`
+            };
+        }
+        catch (error) {
+            return {
+                transitioned: false,
+                reason: `Error: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Handle tasks.md creation event
+     * PLANNING/BACKLOG → ACTIVE
+     *
+     * CRITICAL FIX (2025-11-24): Also trigger living docs sync if feature_id is null
+     * In single-prompt scenarios, increment may be created with "active" status
+     * directly, bypassing the normal transition flow. When tasks.md is created,
+     * we know spec.md exists and can safely sync living docs.
+     */
+    async handleTasksCreated(incrementId) {
+        try {
+            const metadata = MetadataManager.read(incrementId);
+            // Transition to ACTIVE from PLANNING or BACKLOG
+            if (metadata.status === IncrementStatus.PLANNING || metadata.status === IncrementStatus.BACKLOG) {
+                const from = metadata.status;
+                validateTransition(from, IncrementStatus.ACTIVE);
+                MetadataManager.updateStatus(incrementId, IncrementStatus.ACTIVE);
+                // Note: updateStatus() triggers StatusChangeSyncTrigger which handles living docs sync
+                return {
+                    transitioned: true,
+                    from,
+                    to: IncrementStatus.ACTIVE,
+                    reason: 'tasks.md created - execution phase started'
+                };
+            }
+            // CRITICAL FIX: Even if already ACTIVE, check if living docs need sync
+            // This handles single-prompt scenarios where increment was created with "active" status
+            if (metadata.status === IncrementStatus.ACTIVE) {
+                await this.triggerLivingDocsSyncIfNeeded(incrementId);
+            }
+            return {
+                transitioned: false,
+                reason: `Already in ${metadata.status} - no transition needed`
+            };
+        }
+        catch (error) {
+            return {
+                transitioned: false,
+                reason: `Error: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Trigger living docs sync if feature_id is missing
+     *
+     * Called when tasks.md is created but increment is already ACTIVE.
+     * At this point spec.md exists, so sync will succeed.
+     */
+    async triggerLivingDocsSyncIfNeeded(incrementId) {
+        try {
+            const metadataPath = path.join(this.projectRoot, '.specweave/increments', incrementId, 'metadata.json');
+            if (!fs.existsSync(metadataPath)) {
+                return;
+            }
+            const content = fs.readFileSync(metadataPath, 'utf-8');
+            const metadata = JSON.parse(content);
+            // Only sync if feature_id is missing
+            if (!metadata.feature_id) {
+                console.log(`📚 Increment ${incrementId} missing feature_id - triggering living docs sync...`);
+                // Dynamic import to avoid circular dependency
+                const { LivingDocsSync } = await import('../living-docs/living-docs-sync.js');
+                const sync = new LivingDocsSync(this.projectRoot);
+                const result = await sync.syncIncrement(incrementId);
+                if (result.success) {
+                    console.log(`✅ Living docs synced for ${incrementId} → ${result.featureId}`);
+                }
+                else {
+                    console.warn(`⚠️  Living docs sync completed with errors for ${incrementId}`);
+                }
+            }
+        }
+        catch (error) {
+            // Non-fatal - log warning but don't fail the transition
+            console.warn(`⚠️  Failed to check/trigger living docs sync: ${error}`);
+        }
+    }
+    /**
+     * Handle first task started event
+     * PLANNING → ACTIVE
+     */
+    async handleTaskStarted(incrementId) {
+        try {
+            const metadata = MetadataManager.read(incrementId);
+            // Force transition to ACTIVE if still in PLANNING
+            if (metadata.status === IncrementStatus.PLANNING) {
+                validateTransition(metadata.status, IncrementStatus.ACTIVE);
+                MetadataManager.updateStatus(incrementId, IncrementStatus.ACTIVE);
+                return {
+                    transitioned: true,
+                    from: IncrementStatus.PLANNING,
+                    to: IncrementStatus.ACTIVE,
+                    reason: 'task execution started - moved to active'
+                };
+            }
+            return {
+                transitioned: false,
+                reason: `Already in ${metadata.status} - no transition needed`
+            };
+        }
+        catch (error) {
+            return {
+                transitioned: false,
+                reason: `Error: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Detect increment phase based on artifacts (spec.md, plan.md, tasks.md)
+     */
+    async detectPhase(incrementId) {
+        const incrementPath = path.join(this.projectRoot, '.specweave/increments', incrementId);
+        const hasSpec = fs.existsSync(path.join(incrementPath, 'spec.md'));
+        const hasPlan = fs.existsSync(path.join(incrementPath, 'plan.md'));
+        const hasTasks = fs.existsSync(path.join(incrementPath, 'tasks.md'));
+        // Artifact-based phase detection
+        if (hasTasks) {
+            return IncrementStatus.ACTIVE; // Tasks exist → execution phase
+        }
+        else if (hasSpec || hasPlan) {
+            return IncrementStatus.PLANNING; // Spec/plan exist → planning phase
+        }
+        else {
+            return IncrementStatus.BACKLOG; // Nothing exists → backlog
+        }
+    }
+    /**
+     * Auto-correct status based on artifacts
+     * Useful for fixing increments with invalid "planned"/"planning" statuses
+     */
+    async autoCorrect(incrementId, force = false) {
+        try {
+            const metadata = MetadataManager.read(incrementId);
+            const detectedPhase = await this.detectPhase(incrementId);
+            // Check for status mismatch
+            if (metadata.status !== detectedPhase) {
+                // Validate transition is allowed
+                try {
+                    validateTransition(metadata.status, detectedPhase);
+                }
+                catch (error) {
+                    if (!force) {
+                        return {
+                            transitioned: false,
+                            reason: `Cannot auto-correct: ${error instanceof Error ? error.message : String(error)}`
+                        };
+                    }
+                    // Force mode: skip validation
+                }
+                const from = metadata.status;
+                MetadataManager.updateStatus(incrementId, detectedPhase);
+                return {
+                    transitioned: true,
+                    from,
+                    to: detectedPhase,
+                    reason: `Auto-corrected based on artifacts (${force ? 'forced' : 'validated'})`
+                };
+            }
+            return {
+                transitioned: false,
+                reason: `Status already correct (${metadata.status})`
+            };
+        }
+        catch (error) {
+            return {
+                transitioned: false,
+                reason: `Error: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Get transition event for logging
+     */
+    createTransitionEvent(incrementId, from, to, trigger) {
+        return {
+            incrementId,
+            from,
+            to,
+            trigger,
+            timestamp: new Date().toISOString()
+        };
+    }
+}
+//# sourceMappingURL=auto-transition-manager.js.map

package/dist/plugins/specweave/lib/vendor/core/increment/auto-transition-manager.js.map

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

package/dist/plugins/specweave/lib/vendor/core/increment/duplicate-detector.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Duplicate Detector - Scan filesystem and detect duplicate increments
+ *
+ * Detects increments that exist in multiple locations (active, archive, abandoned)
+ * or have the same increment number with different names.
+ *
+ * Part of increment 0033: Duplicate Increment Prevention System
+ */
+import { IncrementStatus } from '../types/increment-metadata.js';
+/**
+ * Report of all duplicates found
+ */
+export interface DuplicateReport {
+    duplicates: Duplicate[];
+    totalChecked: number;
+    duplicateCount: number;
+}
+/**
+ * A duplicate increment (same number in multiple locations or with different names)
+ */
+export interface Duplicate {
+    incrementNumber: string;
+    locations: IncrementLocation[];
+    recommendedWinner: IncrementLocation;
+    losingVersions: IncrementLocation[];
+    resolutionReason: string;
+}
+/**
+ * Information about an increment location
+ */
+export interface IncrementLocation {
+    path: string;
+    name: string;
+    status: IncrementStatus;
+    lastActivity: string;
+    fileCount: number;
+    totalSize: number;
+    hasReports: boolean;
+    hasGitHubLink: boolean;
+}
+/**
+ * Scan all increment folders and detect duplicates
+ */
+export declare function detectAllDuplicates(rootDir: string): Promise<DuplicateReport>;
+/**
+ * Detect duplicates for a specific increment number
+ *
+ * Returns ALL increments that have the given number, even if there's only one.
+ * This is used for validation before creating a new increment.
+ */
+export declare function detectDuplicatesByNumber(incrementNumber: string, rootDir: string): Promise<IncrementLocation[]>;
+//# sourceMappingURL=duplicate-detector.d.ts.map