specweave 0.22.14 → 0.23.1

package/plugins/specweave/lib/vendor/core/increment/ac-status-manager.js

@@ -0,0 +1,345 @@
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * ACStatusManager: Automatically sync spec.md AC checkboxes with tasks.md completion status
+ */
+export class ACStatusManager {
+    constructor(rootPath) {
+        this.rootPath = rootPath;
+    }
+    /**
+     * Parse tasks.md and extract AC completion status
+     *
+     * @param tasksContent - Content of tasks.md file
+     * @returns Map of AC-ID to ACCompletionStatus
+     */
+    parseTasksForACStatus(tasksContent) {
+        const acMap = new Map();
+        // Regex to match task headers: ### T-###: Task name
+        const taskHeaderRegex = /###\s+(T-\d+):/g;
+        // Split content by task headers
+        const lines = tasksContent.split('\n');
+        let currentTaskId = null;
+        let currentTaskACs = [];
+        let hasCheckedBoxes = false;
+        let hasUncheckedBoxes = false;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Check if this is a task header
+            const taskMatch = line.match(/###\s+(T-\d+):/);
+            if (taskMatch) {
+                // Process previous task if exists
+                if (currentTaskId && currentTaskACs.length > 0) {
+                    // Task is complete if it has at least one [x] and no [ ]
+                    const currentTaskComplete = hasCheckedBoxes && !hasUncheckedBoxes;
+                    this.addTaskToACMap(acMap, currentTaskId, currentTaskACs, currentTaskComplete);
+                }
+                // Start new task
+                currentTaskId = taskMatch[1];
+                currentTaskACs = [];
+                hasCheckedBoxes = false;
+                hasUncheckedBoxes = false;
+                continue;
+            }
+            // Check if this line contains AC tags (supports both old and new formats)
+            // Old format: **AC**: AC-US1-01
+            // New format: **Satisfies ACs**: AC-US1-01, AC-US1-02
+            const acMatch = line.match(/\*\*(?:AC|Satisfies ACs)\*\*:\s*(.+)/);
+            if (acMatch && currentTaskId) {
+                // Extract AC-IDs (can be comma or space separated)
+                const acText = acMatch[1].trim();
+                const acIds = acText
+                    .split(/[,\s]+/)
+                    .map(id => id.trim())
+                    .filter(id => id.startsWith('AC-'));
+                currentTaskACs.push(...acIds);
+                continue;
+            }
+            // Check task completion status
+            if (currentTaskId && line.includes('- [')) {
+                if (line.includes('- [ ]')) {
+                    hasUncheckedBoxes = true;
+                }
+                else if (line.includes('- [x]')) {
+                    hasCheckedBoxes = true;
+                }
+            }
+        }
+        // Process last task
+        if (currentTaskId && currentTaskACs.length > 0) {
+            const currentTaskComplete = hasCheckedBoxes && !hasUncheckedBoxes;
+            this.addTaskToACMap(acMap, currentTaskId, currentTaskACs, currentTaskComplete);
+        }
+        return acMap;
+    }
+    /**
+     * Helper method to add a task to the AC map
+     */
+    addTaskToACMap(acMap, taskId, acIds, isComplete) {
+        for (const acId of acIds) {
+            if (!acMap.has(acId)) {
+                acMap.set(acId, {
+                    acId,
+                    totalTasks: 0,
+                    completedTasks: 0,
+                    percentage: 0,
+                    isComplete: false,
+                    tasks: []
+                });
+            }
+            const status = acMap.get(acId);
+            status.totalTasks++;
+            if (isComplete) {
+                status.completedTasks++;
+            }
+            status.tasks.push(taskId);
+            // Calculate percentage
+            status.percentage = status.totalTasks > 0
+                ? Math.round((status.completedTasks / status.totalTasks) * 100 * 100) / 100
+                : 0;
+            // Update isComplete flag
+            status.isComplete = status.percentage === 100;
+        }
+    }
+    /**
+     * Parse spec.md and extract AC checkboxes
+     *
+     * @param specContent - Content of spec.md file
+     * @returns Map of AC-ID to ACDefinition
+     */
+    parseSpecForACs(specContent) {
+        const acMap = new Map();
+        const lines = specContent.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Match AC checkbox pattern: - [ ] AC-ID: Description
+            // or: - [x] AC-ID: Description
+            // Also handles bold format: - [ ] **AC-ID**: Description
+            const acMatch = line.match(/^-\s+\[([ x])\]\s+\*{0,2}(AC-[A-Z0-9-]+)\*{0,2}:\s*(.+)/);
+            if (acMatch) {
+                const checked = acMatch[1] === 'x';
+                const acId = acMatch[2];
+                const description = acMatch[3].trim();
+                acMap.set(acId, {
+                    acId,
+                    description,
+                    checked,
+                    lineNumber: i + 1, // 1-indexed
+                    fullLine: line
+                });
+            }
+        }
+        return acMap;
+    }
+    /**
+     * Sync AC status from tasks.md to spec.md
+     *
+     * @param incrementId - Increment ID (e.g., "0039")
+     * @returns Result of sync operation
+     */
+    async syncACStatus(incrementId) {
+        const result = {
+            synced: false,
+            updated: [],
+            conflicts: [],
+            warnings: [],
+            changes: []
+        };
+        // Paths
+        const incrementPath = path.join(this.rootPath, '.specweave', 'increments', incrementId);
+        const specPath = path.join(incrementPath, 'spec.md');
+        const tasksPath = path.join(incrementPath, 'tasks.md');
+        // Check files exist
+        if (!fs.existsSync(specPath)) {
+            result.warnings.push('spec.md does not exist');
+            return result;
+        }
+        if (!fs.existsSync(tasksPath)) {
+            result.warnings.push('tasks.md does not exist');
+            return result;
+        }
+        // Read files
+        const specContent = fs.readFileSync(specPath, 'utf-8');
+        const tasksContent = fs.readFileSync(tasksPath, 'utf-8');
+        // Parse both files
+        const taskACStatuses = this.parseTasksForACStatus(tasksContent);
+        const specACs = this.parseSpecForACs(specContent);
+        // Sync logic
+        const specLines = specContent.split('\n');
+        let updated = false;
+        for (const [acId, taskStatus] of taskACStatuses.entries()) {
+            const specAC = specACs.get(acId);
+            if (!specAC) {
+                result.warnings.push(`${acId} referenced in tasks.md but not found in spec.md`);
+                continue;
+            }
+            // Check if status should change
+            const shouldBeChecked = taskStatus.isComplete;
+            const currentlyChecked = specAC.checked;
+            if (shouldBeChecked && !currentlyChecked) {
+                // Update from [ ] to [x]
+                const oldLine = specLines[specAC.lineNumber - 1];
+                const newLine = oldLine.replace('- [ ]', '- [x]');
+                specLines[specAC.lineNumber - 1] = newLine;
+                result.updated.push(acId);
+                result.changes.push(`${acId}: [ ] → [x] (${taskStatus.completedTasks}/${taskStatus.totalTasks} tasks complete)`);
+                updated = true;
+            }
+            else if (!shouldBeChecked && currentlyChecked) {
+                // Conflict: AC is [x] but tasks incomplete
+                result.conflicts.push(`${acId}: [x] but only ${taskStatus.completedTasks}/${taskStatus.totalTasks} tasks complete (${taskStatus.percentage}%)`);
+            }
+        }
+        // Check for ACs with no tasks
+        for (const [acId, specAC] of specACs.entries()) {
+            if (!taskACStatuses.has(acId)) {
+                if (specAC.checked) {
+                    result.warnings.push(`${acId}: [x] but no tasks found (manual verification?)`);
+                }
+                else {
+                    result.warnings.push(`${acId}: has no tasks mapped`);
+                }
+            }
+        }
+        // Write updated spec.md
+        if (updated) {
+            const newSpecContent = specLines.join('\n');
+            fs.writeFileSync(specPath, newSpecContent, 'utf-8');
+            result.synced = true;
+        }
+        // Log sync event to metadata.json
+        if (result.synced || result.conflicts.length > 0 || result.warnings.length > 0) {
+            this.logSyncEvent(incrementId, result);
+        }
+        return result;
+    }
+    /**
+     * Log AC sync event to metadata.json
+     * Keeps last 20 events for audit trail
+     *
+     * @param incrementId - Increment ID
+     * @param result - Sync result to log
+     */
+    logSyncEvent(incrementId, result) {
+        const metadataPath = path.join(this.rootPath, '.specweave', 'increments', incrementId, 'metadata.json');
+        try {
+            // Read existing metadata
+            let metadata = {};
+            if (fs.existsSync(metadataPath)) {
+                const metadataContent = fs.readFileSync(metadataPath, 'utf-8');
+                metadata = JSON.parse(metadataContent);
+            }
+            // Initialize acSyncEvents array if doesn't exist
+            if (!metadata.acSyncEvents) {
+                metadata.acSyncEvents = [];
+            }
+            // Create new event
+            const event = {
+                timestamp: new Date().toISOString(),
+                updated: result.updated,
+                conflicts: result.conflicts,
+                warnings: result.warnings,
+                changesCount: result.updated.length
+            };
+            // Add event to beginning (newest first)
+            metadata.acSyncEvents.unshift(event);
+            // Keep only last 20 events (rolling history)
+            if (metadata.acSyncEvents.length > 20) {
+                metadata.acSyncEvents = metadata.acSyncEvents.slice(0, 20);
+            }
+            // Update lastActivity timestamp
+            metadata.lastActivity = new Date().toISOString();
+            // Write updated metadata
+            fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2), 'utf-8');
+        }
+        catch (error) {
+            // Non-blocking: Log error but don't fail sync
+            console.error('Warning: Failed to log AC sync event to metadata.json', error);
+        }
+    }
+    /**
+     * Validate AC-task mapping
+     *
+     * @param incrementId - Increment ID
+     * @returns Validation result
+     */
+    validateACMapping(incrementId) {
+        const result = {
+            valid: true,
+            orphanedACs: [],
+            invalidReferences: [],
+            errors: []
+        };
+        const incrementPath = path.join(this.rootPath, '.specweave', 'increments', incrementId);
+        const specPath = path.join(incrementPath, 'spec.md');
+        const tasksPath = path.join(incrementPath, 'tasks.md');
+        // Check files exist
+        if (!fs.existsSync(specPath)) {
+            result.errors.push('spec.md does not exist');
+            result.valid = false;
+            return result;
+        }
+        if (!fs.existsSync(tasksPath)) {
+            result.errors.push('tasks.md does not exist');
+            result.valid = false;
+            return result;
+        }
+        // Read and parse
+        const specContent = fs.readFileSync(specPath, 'utf-8');
+        const tasksContent = fs.readFileSync(tasksPath, 'utf-8');
+        const taskACStatuses = this.parseTasksForACStatus(tasksContent);
+        const specACs = this.parseSpecForACs(specContent);
+        // Find orphaned ACs (in spec but no tasks)
+        for (const acId of specACs.keys()) {
+            if (!taskACStatuses.has(acId)) {
+                result.orphanedACs.push(acId);
+                result.valid = false;
+            }
+        }
+        // Find invalid references (in tasks but not in spec)
+        for (const acId of taskACStatuses.keys()) {
+            if (!specACs.has(acId)) {
+                result.invalidReferences.push(acId);
+                result.valid = false;
+            }
+        }
+        return result;
+    }
+    /**
+     * Get AC completion summary
+     *
+     * @param incrementId - Increment ID
+     * @returns Summary of AC completion status
+     */
+    getACCompletionSummary(incrementId) {
+        const incrementPath = path.join(this.rootPath, '.specweave', 'increments', incrementId);
+        const tasksPath = path.join(incrementPath, 'tasks.md');
+        const summary = {
+            totalACs: 0,
+            completeACs: 0,
+            incompleteACs: 0,
+            percentage: 0,
+            acStatuses: new Map()
+        };
+        if (!fs.existsSync(tasksPath)) {
+            return summary;
+        }
+        const tasksContent = fs.readFileSync(tasksPath, 'utf-8');
+        const acStatuses = this.parseTasksForACStatus(tasksContent);
+        summary.acStatuses = acStatuses;
+        summary.totalACs = acStatuses.size;
+        for (const status of acStatuses.values()) {
+            if (status.isComplete) {
+                summary.completeACs++;
+            }
+            else {
+                summary.incompleteACs++;
+            }
+        }
+        summary.percentage = summary.totalACs > 0
+            ? Math.round((summary.completeACs / summary.totalACs) * 100)
+            : 0;
+        return summary;
+    }
+}
+//# sourceMappingURL=ac-status-manager.js.map

package/plugins/specweave/lib/vendor/core/increment/ac-status-manager.js.map

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

package/plugins/specweave/lib/vendor/core/increment/active-increment-manager.d.ts

@@ -0,0 +1,106 @@
+/**
+ * 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
+ */
+/**
+ * Active increment state stored in .specweave/state/active-increment.json
+ *
+ * **UPGRADED**: Now supports MULTIPLE active increments (up to 2)
+ * - One regular feature increment
+ * - One hotfix/bug increment (optional)
+ */
+export interface ActiveIncrementState {
+    ids: string[];
+    id?: string | null;
+    lastUpdated: string;
+}
+/**
+ * Active Increment Manager
+ *
+ * Central authority for managing which increment is currently active.
+ */
+export declare class ActiveIncrementManager {
+    private rootDir;
+    private stateFile;
+    constructor(rootDir?: string);
+    /**
+     * Get all currently active increment IDs
+     * Returns empty array if no increments are active
+     *
+     * **NEW**: Returns array of ALL active increments (max 2)
+     */
+    getActive(): string[];
+    /**
+     * 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(): string | 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: string, skipValidation?: boolean): void;
+    /**
+     * Remove an increment from the active list
+     */
+    removeActive(incrementId: string): void;
+    /**
+     * 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: string, skipValidation?: boolean): void;
+    /**
+     * Clear all active increments
+     */
+    clearActive(): void;
+    /**
+     * 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(): void;
+    /**
+     * 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(): boolean;
+    /**
+     * Write state file atomically (temp file → rename)
+     */
+    private writeState;
+    /**
+     * Get state file path (for testing)
+     */
+    getStateFilePath(): string;
+    /**
+     * Check if state file exists (for testing)
+     */
+    exists(): boolean;
+}
+//# sourceMappingURL=active-increment-manager.d.ts.map

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

@@ -0,0 +1,220 @@
+/**
+ * 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 fs from 'fs-extra';
+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);
+            // 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() {
+        const activeIncrements = MetadataManager.getActive();
+        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;
+    }
+    /**
+     * 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