specweave 0.21.1 → 0.21.3

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

@@ -0,0 +1,84 @@
+/**
+ * Completion Propagator - Bottom-up completion propagation
+ *
+ * Propagates completion status from Tasks → ACs → User Stories → Increments
+ *
+ * Rules:
+ * - When all Tasks for AC complete → Mark AC complete
+ * - When all ACs for User Story complete → Mark User Story complete
+ * - When all User Stories for Increment complete → Mark Increment complete
+ */
+/**
+ * Completion statistics
+ */
+export interface CompletionStats {
+    /** Total items */
+    total: number;
+    /** Completed items */
+    completed: number;
+    /** Completion percentage */
+    percentage: number;
+    /** Is 100% complete */
+    isComplete: boolean;
+}
+/**
+ * Propagation result
+ */
+export interface PropagationResult {
+    /** ACs marked complete */
+    acsCompleted: number;
+    /** User Stories marked complete */
+    userStoriesCompleted: number;
+    /** Increment marked complete */
+    incrementCompleted: boolean;
+    /** Errors encountered */
+    errors: string[];
+}
+/**
+ * CompletionPropagator - Handles bottom-up completion
+ */
+export declare class CompletionPropagator {
+    /**
+     * Propagate completion from Tasks → ACs → User Stories → Increment
+     *
+     * @param incrementPath - Path to increment
+     */
+    propagateCompletion(incrementPath: string): Promise<PropagationResult>;
+    /**
+     * Get completion statistics for an AC
+     *
+     * @param acId - AC ID (e.g., "AC-US1-01")
+     * @param incrementPath - Path to increment
+     */
+    getAcCompletionStats(acId: string, incrementPath: string): Promise<CompletionStats>;
+    /**
+     * Get completion statistics for a User Story
+     *
+     * @param userStoryId - User Story ID (e.g., "US1")
+     * @param incrementPath - Path to increment
+     */
+    getUserStoryCompletionStats(userStoryId: string, incrementPath: string): Promise<CompletionStats>;
+    /**
+     * Get completion statistics for entire increment
+     *
+     * @param incrementPath - Path to increment
+     */
+    getIncrementCompletionStats(incrementPath: string): Promise<CompletionStats>;
+    /**
+     * Parse ACs from spec.md content
+     */
+    private parseAcs;
+    /**
+     * Parse Tasks from tasks.md content
+     */
+    private parseTasks;
+    /**
+     * Group ACs by User Story ID
+     */
+    private groupAcsByUserStory;
+    /**
+     * Update AC checkbox in content
+     */
+    private updateAcCheckbox;
+}
+//# sourceMappingURL=CompletionPropagator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CompletionPropagator.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/CompletionPropagator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IAEd,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,uBAAuB;IACvB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IAErB,mCAAmC;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAE7B,gCAAgC;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAE5B,yBAAyB;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B;;;;OAIG;IACG,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2E5E;;;;;OAKG;IACG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBzF;;;;;OAKG;IACG,2BAA2B,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBvG;;;;OAIG;IACG,2BAA2B,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAelF;;OAEG;IACH,OAAO,CAAC,QAAQ;IAkBhB;;OAEG;IACH,OAAO,CAAC,UAAU;IA6BlB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAe3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAKzB"}

package/dist/src/core/living-docs/CompletionPropagator.js

@@ -0,0 +1,205 @@
+/**
+ * Completion Propagator - Bottom-up completion propagation
+ *
+ * Propagates completion status from Tasks → ACs → User Stories → Increments
+ *
+ * Rules:
+ * - When all Tasks for AC complete → Mark AC complete
+ * - When all ACs for User Story complete → Mark User Story complete
+ * - When all User Stories for Increment complete → Mark Increment complete
+ */
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * CompletionPropagator - Handles bottom-up completion
+ */
+export class CompletionPropagator {
+    /**
+     * Propagate completion from Tasks → ACs → User Stories → Increment
+     *
+     * @param incrementPath - Path to increment
+     */
+    async propagateCompletion(incrementPath) {
+        const result = {
+            acsCompleted: 0,
+            userStoriesCompleted: 0,
+            incrementCompleted: false,
+            errors: []
+        };
+        try {
+            // 1. Read increment spec.md and tasks.md
+            const specPath = path.join(incrementPath, 'spec.md');
+            const tasksPath = path.join(incrementPath, 'tasks.md');
+            let specContent = await fs.readFile(specPath, 'utf-8');
+            const tasksContent = await fs.readFile(tasksPath, 'utf-8');
+            // 2. Parse ACs and Tasks
+            const acs = this.parseAcs(specContent);
+            const tasks = this.parseTasks(tasksContent);
+            // 3. For each AC, check if all its tasks are complete
+            let specModified = false;
+            for (const ac of acs) {
+                // Find tasks for this AC
+                const acTasks = tasks.filter(t => t.acIds.includes(ac.id));
+                if (acTasks.length > 0) {
+                    // Check if all tasks complete
+                    const allTasksComplete = acTasks.every(t => t.completed);
+                    if (allTasksComplete && !ac.completed) {
+                        // Mark AC as complete
+                        specContent = this.updateAcCheckbox(specContent, ac.id, true);
+                        result.acsCompleted++;
+                        specModified = true;
+                    }
+                    else if (!allTasksComplete && ac.completed) {
+                        // Mark AC as incomplete (some task was reopened)
+                        specContent = this.updateAcCheckbox(specContent, ac.id, false);
+                        specModified = true;
+                    }
+                }
+            }
+            // 4. Save updated spec.md if modified
+            if (specModified) {
+                await fs.writeFile(specPath, specContent, 'utf-8');
+            }
+            // 5. Check User Story completion
+            // Parse updated ACs to check if any User Stories are now complete
+            const updatedAcs = this.parseAcs(specContent);
+            const userStories = this.groupAcsByUserStory(updatedAcs);
+            for (const [userStoryId, userStoryAcs] of Object.entries(userStories)) {
+                const allAcsComplete = userStoryAcs.every(ac => ac.completed);
+                if (allAcsComplete) {
+                    result.userStoriesCompleted++;
+                }
+            }
+            // 6. Check Increment completion
+            const allAcsComplete = updatedAcs.every(ac => ac.completed);
+            if (allAcsComplete && updatedAcs.length > 0) {
+                result.incrementCompleted = true;
+                // TODO: Update increment metadata status to 'completed'
+            }
+        }
+        catch (error) {
+            result.errors.push(error.message);
+        }
+        return result;
+    }
+    /**
+     * Get completion statistics for an AC
+     *
+     * @param acId - AC ID (e.g., "AC-US1-01")
+     * @param incrementPath - Path to increment
+     */
+    async getAcCompletionStats(acId, incrementPath) {
+        const tasksPath = path.join(incrementPath, 'tasks.md');
+        const tasksContent = await fs.readFile(tasksPath, 'utf-8');
+        const tasks = this.parseTasks(tasksContent);
+        const acTasks = tasks.filter(t => t.acIds.includes(acId));
+        const completedTasks = acTasks.filter(t => t.completed);
+        return {
+            total: acTasks.length,
+            completed: completedTasks.length,
+            percentage: acTasks.length > 0 ? Math.round((completedTasks.length / acTasks.length) * 100) : 0,
+            isComplete: acTasks.length > 0 && completedTasks.length === acTasks.length
+        };
+    }
+    /**
+     * Get completion statistics for a User Story
+     *
+     * @param userStoryId - User Story ID (e.g., "US1")
+     * @param incrementPath - Path to increment
+     */
+    async getUserStoryCompletionStats(userStoryId, incrementPath) {
+        const specPath = path.join(incrementPath, 'spec.md');
+        const specContent = await fs.readFile(specPath, 'utf-8');
+        const acs = this.parseAcs(specContent);
+        const userStoryAcs = acs.filter(ac => ac.userStoryId === userStoryId);
+        const completedAcs = userStoryAcs.filter(ac => ac.completed);
+        return {
+            total: userStoryAcs.length,
+            completed: completedAcs.length,
+            percentage: userStoryAcs.length > 0 ? Math.round((completedAcs.length / userStoryAcs.length) * 100) : 0,
+            isComplete: userStoryAcs.length > 0 && completedAcs.length === userStoryAcs.length
+        };
+    }
+    /**
+     * Get completion statistics for entire increment
+     *
+     * @param incrementPath - Path to increment
+     */
+    async getIncrementCompletionStats(incrementPath) {
+        const specPath = path.join(incrementPath, 'spec.md');
+        const specContent = await fs.readFile(specPath, 'utf-8');
+        const acs = this.parseAcs(specContent);
+        const completedAcs = acs.filter(ac => ac.completed);
+        return {
+            total: acs.length,
+            completed: completedAcs.length,
+            percentage: acs.length > 0 ? Math.round((completedAcs.length / acs.length) * 100) : 0,
+            isComplete: acs.length > 0 && completedAcs.length === acs.length
+        };
+    }
+    /**
+     * Parse ACs from spec.md content
+     */
+    parseAcs(content) {
+        const acs = [];
+        const lines = content.split('\n');
+        for (const line of lines) {
+            const match = line.match(/^- \[([ x])\] (AC-([A-Z0-9]+)-\d+):/);
+            if (match) {
+                acs.push({
+                    id: match[2],
+                    userStoryId: match[3],
+                    completed: match[1] === 'x'
+                });
+            }
+        }
+        return acs;
+    }
+    /**
+     * Parse Tasks from tasks.md content
+     */
+    parseTasks(content) {
+        const tasks = [];
+        // Split by task headers
+        const taskPattern = /### (T-\d+):.*?(?=###|$)/gs;
+        const matches = content.matchAll(taskPattern);
+        for (const match of matches) {
+            const taskId = match[1];
+            const taskContent = match[0];
+            // Extract AC-IDs from task content
+            const acIdMatches = taskContent.matchAll(/AC-([\w]+-\d+)/g);
+            const acIds = Array.from(acIdMatches, m => `AC-${m[1]}`);
+            // Check if task is completed
+            const completedMatch = taskContent.match(/\*\*Completed\*\*:\s*(\d{4}-\d{2}-\d{2})/);
+            const completed = !!completedMatch;
+            tasks.push({
+                id: taskId,
+                acIds,
+                completed
+            });
+        }
+        return tasks;
+    }
+    /**
+     * Group ACs by User Story ID
+     */
+    groupAcsByUserStory(acs) {
+        const grouped = {};
+        for (const ac of acs) {
+            if (!grouped[ac.userStoryId]) {
+                grouped[ac.userStoryId] = [];
+            }
+            grouped[ac.userStoryId].push(ac);
+        }
+        return grouped;
+    }
+    /**
+     * Update AC checkbox in content
+     */
+    updateAcCheckbox(content, acId, completed) {
+        const checkbox = completed ? 'x' : ' ';
+        const pattern = new RegExp(`^- \\[([ x])\\] ${acId}:`, 'gm');
+        return content.replace(pattern, `- [${checkbox}] ${acId}:`);
+    }
+}
+//# sourceMappingURL=CompletionPropagator.js.map

package/dist/src/core/living-docs/CompletionPropagator.js.map

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

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

@@ -0,0 +1,29 @@
+/**
+ * Project Detector
+ *
+ * Detects project type (backend/frontend/mobile) from AC descriptions.
+ */
+import type { ProjectType, ProjectDetectionResult } from './types.js';
+/**
+ * Detect project type from text
+ *
+ * @param text - Text to analyze (AC description, task title, etc.)
+ * @returns ProjectDetectionResult with detected projects and confidence
+ *
+ * @example
+ * ```typescript
+ * const result = detectProject('Create backend API endpoint for user authentication');
+ * // result.projects = ['backend']
+ * // result.confidence = 0.8
+ * ```
+ */
+export declare function detectProject(text: string): ProjectDetectionResult;
+/**
+ * Filter text by project keywords
+ *
+ * @param text - Text to check
+ * @param projectFilter - Projects to filter by
+ * @returns True if text contains keywords for any of the specified projects
+ */
+export declare function matchesProject(text: string, projectFilter: ProjectType[]): boolean;
+//# sourceMappingURL=ProjectDetector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectDetector.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/ProjectDetector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AA0BtE;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CA6ClE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,OAAO,CAKlF"}

package/dist/src/core/living-docs/ProjectDetector.js

@@ -0,0 +1,94 @@
+/**
+ * Project Detector
+ *
+ * Detects project type (backend/frontend/mobile) from AC descriptions.
+ */
+/**
+ * Project detection keywords
+ */
+const PROJECT_KEYWORDS = {
+    backend: [
+        'backend', 'api', 'server', 'database', 'db', 'endpoint', 'service',
+        'rest', 'graphql', 'microservice', 'lambda', 'function', 'worker',
+        'queue', 'cache', 'redis', 'postgres', 'mongodb', 'sql'
+    ],
+    frontend: [
+        'frontend', 'ui', 'component', 'form', 'page', 'view', 'button',
+        'modal', 'dialog', 'menu', 'nav', 'layout', 'react', 'vue', 'angular',
+        'css', 'style', 'responsive', 'ux', 'user interface'
+    ],
+    mobile: [
+        'mobile', 'ios', 'android', 'app', 'native', 'react native', 'flutter',
+        'swift', 'kotlin', 'push notification', 'mobile app', 'tablet'
+    ],
+    shared: [
+        'shared', 'common', 'utility', 'helper', 'type', 'interface', 'constant',
+        'config', 'environment', 'validation'
+    ]
+};
+/**
+ * Detect project type from text
+ *
+ * @param text - Text to analyze (AC description, task title, etc.)
+ * @returns ProjectDetectionResult with detected projects and confidence
+ *
+ * @example
+ * ```typescript
+ * const result = detectProject('Create backend API endpoint for user authentication');
+ * // result.projects = ['backend']
+ * // result.confidence = 0.8
+ * ```
+ */
+export function detectProject(text) {
+    const lowerText = text.toLowerCase();
+    const detectedProjects = [];
+    const matches = {
+        backend: 0,
+        frontend: 0,
+        mobile: 0,
+        shared: 0
+    };
+    // Count keyword matches for each project type
+    for (const [project, keywords] of Object.entries(PROJECT_KEYWORDS)) {
+        for (const keyword of keywords) {
+            if (lowerText.includes(keyword)) {
+                matches[project]++;
+            }
+        }
+    }
+    // Determine detected projects (any with matches)
+    const entries = Object.entries(matches);
+    const sorted = entries.sort((a, b) => b[1] - a[1]);
+    // Add projects with at least one match
+    for (const [project, count] of sorted) {
+        if (count > 0) {
+            detectedProjects.push(project);
+        }
+    }
+    // Default to 'shared' if no specific project detected
+    if (detectedProjects.length === 0) {
+        detectedProjects.push('shared');
+    }
+    // Calculate confidence based on keyword density
+    const totalMatches = Object.values(matches).reduce((sum, count) => sum + count, 0);
+    const confidence = totalMatches > 0
+        ? Math.min(totalMatches / 5, 1) // Cap at 1.0
+        : 0.3; // Low confidence for shared
+    return {
+        projects: detectedProjects,
+        confidence
+    };
+}
+/**
+ * Filter text by project keywords
+ *
+ * @param text - Text to check
+ * @param projectFilter - Projects to filter by
+ * @returns True if text contains keywords for any of the specified projects
+ */
+export function matchesProject(text, projectFilter) {
+    const result = detectProject(text);
+    // Check if any detected project matches the filter
+    return result.projects.some(p => projectFilter.includes(p));
+}
+//# sourceMappingURL=ProjectDetector.js.map

package/dist/src/core/living-docs/ProjectDetector.js.map

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

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

@@ -0,0 +1,55 @@
+/**
+ * SpecDistributor - Copy-Based Sync Implementation
+ *
+ * Distributes (copies) ACs and Tasks from increment spec.md/tasks.md
+ * to User Story files in living docs.
+ *
+ * This is the core of the copy-based sync paradigm where:
+ * - Increment files = source of truth
+ * - Living docs = copy for stakeholder visibility
+ */
+/**
+ * SpecDistributor - Handles copying ACs and Tasks to User Story files
+ */
+export declare class SpecDistributor {
+    /**
+     * Copy ACs and Tasks from increment to User Story files
+     *
+     * @param incrementPath - Path to increment folder (e.g., .specweave/increments/0037-feature)
+     * @param livingDocsPath - Path to living docs folder (e.g., .specweave/docs/public/user-stories)
+     */
+    copyAcsAndTasksToUserStories(incrementPath: string, livingDocsPath: string): Promise<void>;
+    /**
+     * Parse acceptance criteria from spec.md
+     */
+    private parseAcceptanceCriteria;
+    /**
+     * Parse tasks from tasks.md
+     */
+    private parseTasks;
+    /**
+     * Group ACs by User Story ID
+     */
+    private groupAcsByUserStory;
+    /**
+     * Detect projects from ACs
+     */
+    private detectProjectsFromAcs;
+    /**
+     * Filter tasks by AC IDs
+     */
+    private filterTasksByAcIds;
+    /**
+     * Find User Story file by ID
+     */
+    private findUserStoryFile;
+    /**
+     * Update User Story file with ACs and Tasks
+     */
+    private updateUserStoryFile;
+    /**
+     * Update a section in markdown content
+     */
+    private updateSection;
+}
+//# sourceMappingURL=SpecDistributor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SpecDistributor.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/SpecDistributor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;;OAKG;IACG,4BAA4B,CAChC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC;IAmChB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmC/B;;OAEG;IACH,OAAO,CAAC,UAAU;IAgDlB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;YACW,iBAAiB;IAkB/B;;OAEG;YACW,mBAAmB;IA2BjC;;OAEG;IACH,OAAO,CAAC,aAAa;CAatB"}