specweave 0.16.7 → 0.16.11

package/dist/src/core/specs/spec-metadata-manager.js

@@ -0,0 +1,364 @@
+/**
+ * Spec Metadata Manager
+ *
+ * Manages spec.md files in .specweave/docs/internal/specs/{project-id}/
+ *
+ * CRITICAL ARCHITECTURE:
+ * - Specs are the SOURCE OF TRUTH for features
+ * - Specs are PERMANENT (never deleted)
+ * - External tools (GitHub/Jira/ADO) sync to specs, NOT increments
+ * - Uses FLATTENED structure (v0.16.11+): specs/{project-id}/ not projects/{project-id}/specs/
+ *
+ * @module spec-metadata-manager
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import matter from 'gray-matter';
+import { ProjectManager } from '../project-manager.js';
+export class SpecMetadataManager {
+    constructor(projectRoot = process.cwd(), projectId) {
+        this.projectManager = new ProjectManager(projectRoot);
+        // Use flattened structure via ProjectManager
+        this.specsDir = this.projectManager.getSpecsPath(projectId);
+        // Ensure directory exists
+        fs.ensureDirSync(this.specsDir);
+    }
+    /**
+     * Get all spec files
+     */
+    async getAllSpecs() {
+        if (!fs.existsSync(this.specsDir)) {
+            return [];
+        }
+        const files = await fs.readdir(this.specsDir);
+        return files.filter(f => f.startsWith('spec-') && f.endsWith('.md'));
+    }
+    /**
+     * Load spec metadata and content
+     */
+    async loadSpec(specId) {
+        const filePath = this.getSpecPath(specId);
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+        try {
+            const fileContent = await fs.readFile(filePath, 'utf-8');
+            const parsed = matter(fileContent);
+            const metadata = parsed.data;
+            metadata.id = specId;
+            // Parse user stories from markdown content
+            const userStories = this.parseUserStories(parsed.content);
+            // Parse increments from markdown content
+            const increments = this.parseIncrements(parsed.content);
+            return {
+                metadata: {
+                    ...metadata,
+                    userStories,
+                    increments,
+                    progress: this.calculateProgress(userStories)
+                },
+                markdown: parsed.content,
+                filePath
+            };
+        }
+        catch (error) {
+            console.error(`Error loading spec ${specId}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Save spec metadata (update frontmatter)
+     */
+    async saveMetadata(specId, metadata) {
+        const filePath = this.getSpecPath(specId);
+        if (!fs.existsSync(filePath)) {
+            throw new Error(`Spec ${specId} not found`);
+        }
+        const fileContent = await fs.readFile(filePath, 'utf-8');
+        const parsed = matter(fileContent);
+        // Merge metadata
+        const updatedMetadata = {
+            ...parsed.data,
+            ...metadata,
+            updated: new Date().toISOString().split('T')[0]
+        };
+        // Don't save calculated fields
+        delete updatedMetadata.userStories;
+        delete updatedMetadata.increments;
+        delete updatedMetadata.progress;
+        // Reconstruct file with updated frontmatter
+        const newContent = matter.stringify(parsed.content, updatedMetadata);
+        await fs.writeFile(filePath, newContent, 'utf-8');
+    }
+    /**
+     * Link spec to external tool
+     */
+    async linkToExternal(specId, provider, externalData) {
+        const spec = await this.loadSpec(specId);
+        if (!spec) {
+            throw new Error(`Spec ${specId} not found`);
+        }
+        const externalLinks = spec.metadata.externalLinks || {};
+        if (provider === 'github') {
+            externalLinks.github = {
+                projectId: externalData.id,
+                projectUrl: externalData.url,
+                syncedAt: new Date().toISOString(),
+                owner: externalData.owner,
+                repo: externalData.repo
+            };
+        }
+        else if (provider === 'jira') {
+            externalLinks.jira = {
+                epicKey: externalData.id,
+                epicUrl: externalData.url,
+                syncedAt: new Date().toISOString(),
+                projectKey: externalData.projectKey,
+                domain: externalData.domain
+            };
+        }
+        else if (provider === 'ado') {
+            externalLinks.ado = {
+                featureId: externalData.id,
+                featureUrl: externalData.url,
+                syncedAt: new Date().toISOString(),
+                organization: externalData.organization,
+                project: externalData.project
+            };
+        }
+        await this.saveMetadata(specId, { externalLinks });
+    }
+    /**
+     * Unlink spec from external tool
+     */
+    async unlinkFromExternal(specId, provider) {
+        const spec = await this.loadSpec(specId);
+        if (!spec) {
+            throw new Error(`Spec ${specId} not found`);
+        }
+        const externalLinks = spec.metadata.externalLinks || {};
+        delete externalLinks[provider];
+        await this.saveMetadata(specId, { externalLinks });
+    }
+    /**
+     * Update sync status
+     */
+    async updateSyncStatus(specId, provider, status, error) {
+        const spec = await this.loadSpec(specId);
+        if (!spec) {
+            throw new Error(`Spec ${specId} not found`);
+        }
+        const externalLinks = spec.metadata.externalLinks || {};
+        if (externalLinks[provider]) {
+            externalLinks[provider].syncedAt = new Date().toISOString();
+            // Note: syncStatus and lastError are not in the interface yet, would need to add
+        }
+        await this.saveMetadata(specId, { externalLinks });
+    }
+    /**
+     * Validate spec structure
+     */
+    async validateSpec(specId) {
+        const spec = await this.loadSpec(specId);
+        if (!spec) {
+            return {
+                valid: false,
+                errors: [`Spec ${specId} not found`],
+                warnings: [],
+                specId
+            };
+        }
+        const errors = [];
+        const warnings = [];
+        // Required metadata fields
+        if (!spec.metadata.title) {
+            errors.push('Missing required field: title');
+        }
+        if (!spec.metadata.status) {
+            errors.push('Missing required field: status');
+        }
+        if (!spec.metadata.priority) {
+            errors.push('Missing required field: priority');
+        }
+        // Validate user stories
+        if (!spec.metadata.userStories || spec.metadata.userStories.length === 0) {
+            warnings.push('No user stories found in spec');
+        }
+        // Validate frontmatter format
+        if (!spec.markdown.includes('## Overview') && !spec.markdown.includes('## User Stories')) {
+            warnings.push('Missing standard sections (Overview, User Stories)');
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+            specId
+        };
+    }
+    /**
+     * Get spec file path
+     */
+    getSpecPath(specId) {
+        // Handle both formats: "spec-001" and "001"
+        const normalizedId = specId.startsWith('spec-') ? specId : `spec-${specId}`;
+        return path.join(this.specsDir, `${normalizedId}.md`);
+    }
+    /**
+     * Parse user stories from markdown content
+     */
+    parseUserStories(markdown) {
+        const stories = [];
+        // Look for user story patterns
+        // Example: **US-001**: As a developer, I want to...
+        const usPattern = /\*\*US-(\d+)\*\*:\s*(.+?)(?=\n|$)/g;
+        const matches = markdown.matchAll(usPattern);
+        for (const match of matches) {
+            const id = `US-${match[1]}`;
+            const title = match[2].trim();
+            // Extract acceptance criteria for this user story
+            const acPattern = new RegExp(`\\*\\*US-${match[1]}\\*\\*:[\\s\\S]*?(?:- \\[([x ])\\] \\*\\*AC-${match[1]}-(\\d+)\\*\\*: (.+?)(?=\\n|$))`, 'g');
+            const acMatches = markdown.matchAll(acPattern);
+            const acceptanceCriteria = [];
+            for (const acMatch of acMatches) {
+                acceptanceCriteria.push({
+                    id: `AC-${match[1]}-${acMatch[2]}`,
+                    description: acMatch[3].trim(),
+                    status: acMatch[1] === 'x' ? 'done' : 'todo'
+                });
+            }
+            // Determine status based on AC completion
+            let status = 'todo';
+            if (acceptanceCriteria.length > 0) {
+                const completedAC = acceptanceCriteria.filter(ac => ac.status === 'done').length;
+                if (completedAC === acceptanceCriteria.length) {
+                    status = 'done';
+                }
+                else if (completedAC > 0) {
+                    status = 'in-progress';
+                }
+            }
+            stories.push({
+                id,
+                title,
+                status,
+                priority: 'P1', // Default, could parse from markdown
+                acceptanceCriteria
+            });
+        }
+        return stories;
+    }
+    /**
+     * Parse increment references from markdown content
+     */
+    parseIncrements(markdown) {
+        const increments = [];
+        // Look for increment table or list
+        // Example: | **0001-core-framework** | ✅ Complete | 2025-10-15 | ...
+        const incPattern = /\|\s*\*\*(\d{4}-[\w-]+)\*\*\s*\|\s*([✅❌⏳])?\s*(\w+)\s*\|\s*([0-9-]+)?\s*\|/g;
+        const matches = markdown.matchAll(incPattern);
+        for (const match of matches) {
+            const id = match[1];
+            const statusIcon = match[2];
+            const statusText = match[3].toLowerCase();
+            const completedAt = match[4];
+            let status;
+            if (statusText.includes('complete') || statusIcon === '✅') {
+                status = 'complete';
+            }
+            else if (statusText.includes('progress') || statusIcon === '⏳') {
+                status = 'in-progress';
+            }
+            else if (statusText.includes('abandon') || statusIcon === '❌') {
+                status = 'abandoned';
+            }
+            else {
+                status = 'planned';
+            }
+            increments.push({
+                id,
+                status,
+                completedAt: completedAt || undefined,
+                userStories: [] // Would need more parsing to determine which US each increment implemented
+            });
+        }
+        return increments;
+    }
+    /**
+     * Calculate progress from user stories
+     */
+    calculateProgress(userStories) {
+        if (!userStories || userStories.length === 0) {
+            return {
+                totalUserStories: 0,
+                completedUserStories: 0,
+                percentComplete: 0
+            };
+        }
+        const completedUserStories = userStories.filter(us => us.status === 'done').length;
+        return {
+            totalUserStories: userStories.length,
+            completedUserStories,
+            percentComplete: Math.round((completedUserStories / userStories.length) * 100)
+        };
+    }
+    /**
+     * Create a new spec (template)
+     */
+    async createSpec(specId, title, priority = 'P1') {
+        const filePath = this.getSpecPath(specId);
+        if (fs.existsSync(filePath)) {
+            throw new Error(`Spec ${specId} already exists`);
+        }
+        const template = `---
+id: ${specId}
+title: "${title}"
+status: draft
+priority: ${priority}
+created: ${new Date().toISOString().split('T')[0]}
+---
+
+# ${specId.toUpperCase()}: ${title}
+
+**Feature Area**: [Feature Category]
+**Status**: Draft
+**Priority**: ${priority}
+
+---
+
+## Overview
+
+[High-level description of the feature area]
+
+---
+
+## Increments (Implementation History)
+
+| Increment | Status | Completion | Notes |
+|-----------|--------|------------|-------|
+| **0001-example** | ⏳ Planned | - | Description |
+
+**Overall Progress**: 0/1 increments complete (0%)
+
+---
+
+## User Stories & Acceptance Criteria
+
+### Epic 1: [Epic Name]
+
+**US-001**: As a [user type], I want [goal] so that [benefit]
+- [ ] **AC-001-01**: [Acceptance criteria description]
+- [ ] **AC-001-02**: [Acceptance criteria description]
+
+---
+
+## External References
+
+- GitHub Project: TBD
+- Jira Epic: TBD
+- ADO Feature: TBD
+`;
+        await fs.writeFile(filePath, template, 'utf-8');
+        return filePath;
+    }
+}
+//# sourceMappingURL=spec-metadata-manager.js.map

package/dist/src/core/specs/spec-metadata-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-metadata-manager.js","sourceRoot":"","sources":["../../../../src/core/specs/spec-metadata-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,aAAa,CAAC;AAUjC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,OAAO,mBAAmB;IAI9B,YAAY,cAAsB,OAAO,CAAC,GAAG,EAAE,EAAE,SAAkB;QACjE,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QAEtD,6CAA6C;QAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QAE5D,0BAA0B;QAC1B,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,MAAc;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAE1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACzD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;YAEnC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAoB,CAAC;YAC7C,QAAQ,CAAC,EAAE,GAAG,MAAM,CAAC;YAErB,2CAA2C;YAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAE1D,yCAAyC;YACzC,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAExD,OAAO;gBACL,QAAQ,EAAE;oBACR,GAAG,QAAQ;oBACX,WAAW;oBACX,UAAU;oBACV,QAAQ,EAAE,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC;iBAC9C;gBACD,QAAQ,EAAE,MAAM,CAAC,OAAO;gBACxB,QAAQ;aACT,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,MAAM,GAAG,EAAE,KAAK,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc,EAAE,QAA+B;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAE1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QAEnC,iBAAiB;QACjB,MAAM,eAAe,GAAG;YACtB,GAAG,MAAM,CAAC,IAAI;YACd,GAAG,QAAQ;YACX,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SAChD,CAAC;QAEF,+BAA+B;QAC/B,OAAQ,eAAuB,CAAC,WAAW,CAAC;QAC5C,OAAQ,eAAuB,CAAC,UAAU,CAAC;QAC3C,OAAQ,eAAuB,CAAC,QAAQ,CAAC;QAEzC,4CAA4C;QAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;QAErE,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,MAAc,EACd,QAAmC,EACnC,YAIC;QAED,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,EAAE,CAAC;QAExD,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,aAAa,CAAC,MAAM,GAAG;gBACrB,SAAS,EAAE,YAAY,CAAC,EAAY;gBACpC,UAAU,EAAE,YAAY,CAAC,GAAG;gBAC5B,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAClC,KAAK,EAAE,YAAY,CAAC,KAAK;gBACzB,IAAI,EAAE,YAAY,CAAC,IAAI;aACxB,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC/B,aAAa,CAAC,IAAI,GAAG;gBACnB,OAAO,EAAE,YAAY,CAAC,EAAY;gBAClC,OAAO,EAAE,YAAY,CAAC,GAAG;gBACzB,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAClC,UAAU,EAAE,YAAY,CAAC,UAAU;gBACnC,MAAM,EAAE,YAAY,CAAC,MAAM;aAC5B,CAAC;QACJ,CAAC;aAAM,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC9B,aAAa,CAAC,GAAG,GAAG;gBAClB,SAAS,EAAE,YAAY,CAAC,EAAY;gBACpC,UAAU,EAAE,YAAY,CAAC,GAAG;gBAC5B,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAClC,YAAY,EAAE,YAAY,CAAC,YAAY;gBACvC,OAAO,EAAE,YAAY,CAAC,OAAO;aAC9B,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACtB,MAAc,EACd,QAAmC;QAEnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,EAAE,CAAC;QACxD,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;QAE/B,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,MAAc,EACd,QAAmC,EACnC,MAA0C,EAC1C,KAAc;QAEd,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,YAAY,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,EAAE,CAAC;QAExD,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,aAAa,CAAC,QAAQ,CAAE,CAAC,QAAQ,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC7D,iFAAiF;QACnF,CAAC;QAED,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,MAAc;QAC/B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAEzC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,CAAC,QAAQ,MAAM,YAAY,CAAC;gBACpC,QAAQ,EAAE,EAAE;gBACZ,MAAM;aACP,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,2BAA2B;QAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAClD,CAAC;QAED,wBAAwB;QACxB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzE,QAAQ,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QACjD,CAAC;QAED,8BAA8B;QAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACzF,QAAQ,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;QACtE,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;YACN,QAAQ;YACR,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,MAAc;QAChC,4CAA4C;QAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,QAAgB;QACvC,MAAM,OAAO,GAAgB,EAAE,CAAC;QAEhC,+BAA+B;QAC/B,oDAAoD;QACpD,MAAM,SAAS,GAAG,oCAAoC,CAAC;QACvD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAE7C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAE9B,kDAAkD;YAClD,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,+CAA+C,KAAK,CAAC,CAAC,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;YAC/I,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAE/C,MAAM,kBAAkB,GAAyB,EAAE,CAAC;YACpD,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;gBAChC,kBAAkB,CAAC,IAAI,CAAC;oBACtB,EAAE,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE;oBAClC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;oBAC9B,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;iBAC7C,CAAC,CAAC;YACL,CAAC;YAED,0CAA0C;YAC1C,IAAI,MAAM,GAAoC,MAAM,CAAC;YACrD,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;gBACjF,IAAI,WAAW,KAAK,kBAAkB,CAAC,MAAM,EAAE,CAAC;oBAC9C,MAAM,GAAG,MAAM,CAAC;gBAClB,CAAC;qBAAM,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;oBAC3B,MAAM,GAAG,aAAa,CAAC;gBACzB,CAAC;YACH,CAAC;YAED,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE;gBACF,KAAK;gBACL,MAAM;gBACN,QAAQ,EAAE,IAAI,EAAE,qCAAqC;gBACrD,kBAAkB;aACnB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,QAAgB;QACtC,MAAM,UAAU,GAAyB,EAAE,CAAC;QAE5C,mCAAmC;QACnC,qEAAqE;QACrE,MAAM,UAAU,GAAG,6EAA6E,CAAC;QACjG,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAE9C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACpB,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAE7B,IAAI,MAA4D,CAAC;YACjE,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC1D,MAAM,GAAG,UAAU,CAAC;YACtB,CAAC;iBAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBACjE,MAAM,GAAG,aAAa,CAAC;YACzB,CAAC;iBAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBAChE,MAAM,GAAG,WAAW,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;YAED,UAAU,CAAC,IAAI,CAAC;gBACd,EAAE;gBACF,MAAM;gBACN,WAAW,EAAE,WAAW,IAAI,SAAS;gBACrC,WAAW,EAAE,EAAE,CAAC,2EAA2E;aAC5F,CAAC,CAAC;QACL,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACK,iBAAiB,CAAC,WAAwB;QAChD,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO;gBACL,gBAAgB,EAAE,CAAC;gBACnB,oBAAoB,EAAE,CAAC;gBACvB,eAAe,EAAE,CAAC;aACnB,CAAC;QACJ,CAAC;QAED,MAAM,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,MAAM,CAAC;QAEnF,OAAO;YACL,gBAAgB,EAAE,WAAW,CAAC,MAAM;YACpC,oBAAoB;YACpB,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;SAC/E,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,KAAa,EAAE,WAAsC,IAAI;QACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAE1C,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,QAAQ,MAAM,iBAAiB,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,QAAQ,GAAG;MACf,MAAM;UACF,KAAK;;YAEH,QAAQ;WACT,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;;;IAG7C,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK;;;;gBAIlB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCvB,CAAC;QAEE,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/src/core/specs/spec-parser.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Spec Parser
+ *
+ * Advanced parsing utilities for spec.md files
+ * Extracts user stories, acceptance criteria, increments, etc.
+ *
+ * @module spec-parser
+ */
+import { UserStory, AcceptanceCriteria, IncrementReference, SpecMetadata } from '../types/spec-metadata.js';
+export declare class SpecParser {
+    /**
+     * Parse complete user story including acceptance criteria
+     */
+    static parseUserStory(markdown: string, usId: string): UserStory | null;
+    /**
+     * Parse all user stories from markdown
+     */
+    static parseAllUserStories(markdown: string): UserStory[];
+    /**
+     * Parse acceptance criteria for a user story
+     */
+    static parseAcceptanceCriteria(markdown: string, usId: string): AcceptanceCriteria[];
+    /**
+     * Parse increment references from markdown
+     */
+    static parseIncrementReferences(markdown: string): IncrementReference[];
+    /**
+     * Extract frontmatter from markdown
+     */
+    static extractFrontmatter(markdown: string): Partial<SpecMetadata>;
+    /**
+     * Extract overview section
+     */
+    static extractOverview(markdown: string): string;
+    /**
+     * Extract external references section
+     */
+    static extractExternalReferences(markdown: string): {
+        github?: string;
+        jira?: string;
+        ado?: string;
+    };
+    /**
+     * Calculate overall progress
+     */
+    static calculateProgress(userStories: UserStory[]): {
+        totalUserStories: number;
+        completedUserStories: number;
+        inProgressUserStories: number;
+        todoUserStories: number;
+        percentComplete: number;
+    };
+    /**
+     * Find user stories by status
+     */
+    static filterUserStories(userStories: UserStory[], status?: 'todo' | 'in-progress' | 'done', priority?: 'P1' | 'P2' | 'P3'): UserStory[];
+    /**
+     * Find user story by ID
+     */
+    static findUserStory(userStories: UserStory[], usId: string): UserStory | undefined;
+    /**
+     * Update user story status in markdown
+     */
+    static updateUserStoryStatus(markdown: string, usId: string, newStatus: 'todo' | 'in-progress' | 'done'): string;
+}
+//# sourceMappingURL=spec-parser.d.ts.map

package/dist/src/core/specs/spec-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-parser.d.ts","sourceRoot":"","sources":["../../../../src/core/specs/spec-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,qBAAa,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAuCvE;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;IA2BzD;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAkDpF;;OAEG;IACH,MAAM,CAAC,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAkDvE;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAUlE;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAKhD;;OAEG;IACH,MAAM,CAAC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAClD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd;IA+BD;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,WAAW,EAAE,SAAS,EAAE,GAAG;QAClD,gBAAgB,EAAE,MAAM,CAAC;QACzB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KACzB;IAwBD;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,WAAW,EAAE,SAAS,EAAE,EACxB,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,EACxC,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAC5B,SAAS,EAAE;IAcd;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAInF;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAC1B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,MAAM,GACzC,MAAM;CAoBV"}