specweave 0.17.1 → 0.17.3

package/dist/core/spec-task-mapper.js

@@ -1,208 +0,0 @@
-/**
- * Spec-Task Mapper for SpecWeave
- *
- * Maps tasks to spec user stories based on AC-IDs (Acceptance Criteria IDs).
- * Enables traceability from increment tasks back to living docs specs.
- */
-import path from 'path';
-import fs from 'fs/promises';
-/**
- * Parse spec.md to extract user stories and acceptance criteria
- */
-export async function parseSpec(specPath) {
-    const content = await fs.readFile(specPath, 'utf-8');
-    const userStories = [];
-    // Match user story patterns:
-    // **US-001**: As a developer, I want...
-    const userStoryRegex = /\*\*US-(\d+)\*\*:\s*(.+)/g;
-    const matches = [...content.matchAll(userStoryRegex)];
-    for (const match of matches) {
-        const usNumber = match[1];
-        const usId = `US-${usNumber}`;
-        const title = match[2].trim();
-        // Find acceptance criteria for this user story
-        // Pattern: - [x] **AC-US1-01**: Description (P1, testable)
-        const acRegex = new RegExp(`- \\[([ x])\\] \\*\\*AC-US${usNumber}-(\\d+)\\*\\*:\\s*([^(]+)(?:\\(([^)]+)\\))?`, 'g');
-        const acceptanceCriteria = [];
-        const acMatches = [...content.matchAll(acRegex)];
-        for (const acMatch of acMatches) {
-            const completed = acMatch[1] === 'x';
-            const acNumber = acMatch[2];
-            const description = acMatch[3].trim();
-            const metadata = acMatch[4] || '';
-            acceptanceCriteria.push({
-                id: `AC-US${usNumber}-${acNumber}`,
-                description,
-                priority: metadata.includes('P1') ? 'P1' : metadata.includes('P2') ? 'P2' : undefined,
-                testable: metadata.includes('testable'),
-                completed,
-            });
-        }
-        userStories.push({
-            id: usId,
-            title,
-            acceptanceCriteria,
-        });
-    }
-    return userStories;
-}
-/**
- * Parse tasks.md to extract tasks with AC-IDs
- */
-export async function parseTasks(tasksPath) {
-    const content = await fs.readFile(tasksPath, 'utf-8');
-    const tasks = [];
-    // Match task patterns:
-    // ## T-001: Task Title
-    const taskRegex = /##\s+T-(\d+):\s*(.+)/g;
-    const taskMatches = [...content.matchAll(taskRegex)];
-    for (const match of taskMatches) {
-        const taskNumber = match[1];
-        const taskId = `T-${taskNumber}`;
-        const title = match[2].trim();
-        // Extract AC-IDs for this task
-        // Pattern: **AC**: AC-US1-01, AC-US1-02, AC-US2-01
-        const taskSection = extractTaskSection(content, taskId);
-        const acLine = taskSection.match(/\*\*AC\*\*:\s*(.+)/);
-        const acIds = [];
-        if (acLine) {
-            const acText = acLine[1];
-            const acMatches = acText.matchAll(/AC-US\d+-\d+/g);
-            for (const acMatch of acMatches) {
-                acIds.push(acMatch[0]);
-            }
-        }
-        // Derive user story IDs from AC-IDs
-        const userStories = [...new Set(acIds.map(acId => {
-                const match = acId.match(/AC-US(\d+)-/);
-                return match ? `US-${match[1]}` : null;
-            }).filter(Boolean))];
-        // Check if task is completed
-        // Pattern: [x] T-001 or - [x] T-001
-        const completedRegex = new RegExp(`\\[(x)\\]\\s+T-${taskNumber}\\b`, 'i');
-        const completed = completedRegex.test(content);
-        tasks.push({
-            id: taskId,
-            title,
-            acIds,
-            userStories,
-            completed,
-        });
-    }
-    return tasks;
-}
-/**
- * Extract task section from tasks.md content
- */
-function extractTaskSection(content, taskId) {
-    const taskRegex = new RegExp(`##\\s+${taskId}:(.+?)(?=##\\s+T-\\d+:|---|\$)`, 's');
-    const match = content.match(taskRegex);
-    return match ? match[1] : '';
-}
-/**
- * Create mapping between tasks and user stories
- */
-export function createTaskToUserStoryMapping(tasks, userStories) {
-    const mappings = [];
-    for (const task of tasks) {
-        mappings.push({
-            taskId: task.id,
-            userStoryIds: task.userStories,
-            acIds: task.acIds,
-            completed: task.completed,
-        });
-    }
-    return mappings;
-}
-/**
- * Get full mapping for an increment
- */
-export async function getSpecTaskMapping(incrementPath, specPath) {
-    try {
-        // Read increment spec.md
-        const incrementSpecPath = path.join(incrementPath, 'spec.md');
-        const incrementSpec = await fs.readFile(incrementSpecPath, 'utf-8');
-        // Extract spec ID from increment spec
-        // Pattern: **Implements**: SPEC-001-core-framework-architecture
-        const specIdMatch = incrementSpec.match(/\*\*Implements\*\*:\s*SPEC-(\d+)-/);
-        const specId = specIdMatch ? `spec-${specIdMatch[1]}` : null;
-        if (!specId && !specPath) {
-            // No spec linked to this increment
-            return null;
-        }
-        // Determine spec path
-        let actualSpecPath = specPath;
-        if (!actualSpecPath && specId) {
-            // Try to find spec in living docs
-            const projectRoot = incrementPath.split('.specweave')[0];
-            const possiblePaths = [
-                path.join(projectRoot, '.specweave', 'docs', 'internal', 'specs', `${specId}-*.md`),
-                path.join(projectRoot, '.specweave', 'docs', 'internal', 'projects', 'default', 'specs', `${specId}-*.md`),
-            ];
-            for (const possiblePath of possiblePaths) {
-                const glob = await import('glob');
-                const matches = glob.sync(possiblePath);
-                if (matches.length > 0) {
-                    actualSpecPath = matches[0];
-                    break;
-                }
-            }
-        }
-        if (!actualSpecPath) {
-            return null;
-        }
-        // Parse spec and tasks
-        const userStories = await parseSpec(actualSpecPath);
-        const tasksPath = path.join(incrementPath, 'tasks.md');
-        const tasks = await parseTasks(tasksPath);
-        // Create mappings
-        const mappings = createTaskToUserStoryMapping(tasks, userStories);
-        return {
-            specId: specId || 'unknown',
-            specPath: actualSpecPath,
-            incrementId: path.basename(incrementPath),
-            incrementPath,
-            userStories,
-            tasks,
-            mappings,
-        };
-    }
-    catch (error) {
-        console.error(`Failed to get spec-task mapping: ${error.message}`);
-        return null;
-    }
-}
-/**
- * Get completed user stories from mappings
- */
-export function getCompletedUserStories(mapping) {
-    const completedUSIds = new Set();
-    // Find user stories where ALL tasks are complete
-    for (const us of mapping.userStories) {
-        const relatedTasks = mapping.tasks.filter(t => t.userStories.includes(us.id));
-        if (relatedTasks.length > 0 && relatedTasks.every(t => t.completed)) {
-            completedUSIds.add(us.id);
-        }
-    }
-    return mapping.userStories.filter(us => completedUSIds.has(us.id));
-}
-/**
- * Get recently completed tasks (completed since last sync)
- */
-export function getRecentlyCompletedTasks(mapping, lastSyncDate) {
-    // If no last sync date, return all completed tasks
-    if (!lastSyncDate) {
-        return mapping.tasks.filter(t => t.completed);
-    }
-    // For now, return all completed tasks
-    // In the future, we could track completion timestamps in metadata
-    return mapping.tasks.filter(t => t.completed);
-}
-/**
- * Find spec path for an increment
- */
-export async function findSpecForIncrement(incrementPath) {
-    const mapping = await getSpecTaskMapping(incrementPath);
-    return mapping?.specPath || null;
-}
-//# sourceMappingURL=spec-task-mapper.js.map

package/dist/core/spec-task-mapper.js.map

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

package/dist/core/specs/spec-metadata-manager.d.ts

@@ -1,70 +0,0 @@
-/**
- * Spec Metadata Manager
- *
- * Manages spec.md files in .specweave/docs/internal/specs/
- *
- * 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
- *
- * @module spec-metadata-manager
- */
-import { SpecMetadata, SpecContent, SpecValidationResult } from '../types/spec-metadata.js';
-export declare class SpecMetadataManager {
-    private specsDir;
-    constructor(projectRoot?: string);
-    /**
-     * Get all spec files
-     */
-    getAllSpecs(): Promise<string[]>;
-    /**
-     * Load spec metadata and content
-     */
-    loadSpec(specId: string): Promise<SpecContent | null>;
-    /**
-     * Save spec metadata (update frontmatter)
-     */
-    saveMetadata(specId: string, metadata: Partial<SpecMetadata>): Promise<void>;
-    /**
-     * Link spec to external tool
-     */
-    linkToExternal(specId: string, provider: 'github' | 'jira' | 'ado', externalData: {
-        id: string | number;
-        url: string;
-        [key: string]: any;
-    }): Promise<void>;
-    /**
-     * Unlink spec from external tool
-     */
-    unlinkFromExternal(specId: string, provider: 'github' | 'jira' | 'ado'): Promise<void>;
-    /**
-     * Update sync status
-     */
-    updateSyncStatus(specId: string, provider: 'github' | 'jira' | 'ado', status: 'synced' | 'out-of-sync' | 'error', error?: string): Promise<void>;
-    /**
-     * Validate spec structure
-     */
-    validateSpec(specId: string): Promise<SpecValidationResult>;
-    /**
-     * Get spec file path
-     */
-    private getSpecPath;
-    /**
-     * Parse user stories from markdown content
-     */
-    private parseUserStories;
-    /**
-     * Parse increment references from markdown content
-     */
-    private parseIncrements;
-    /**
-     * Calculate progress from user stories
-     */
-    private calculateProgress;
-    /**
-     * Create a new spec (template)
-     */
-    createSpec(specId: string, title: string, priority?: 'P0' | 'P1' | 'P2' | 'P3'): Promise<string>;
-}
-//# sourceMappingURL=spec-metadata-manager.d.ts.map

package/dist/core/specs/spec-metadata-manager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec-metadata-manager.d.ts","sourceRoot":"","sources":["../../../src/core/specs/spec-metadata-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,EACL,YAAY,EACZ,WAAW,EAIX,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAEnC,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAS;gBAEb,WAAW,GAAE,MAAsB;IAgB/C;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAStC;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAoC3D;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BlF;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,EACnC,YAAY,EAAE;QACZ,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,GAAG,EAAE,MAAM,CAAC;QACZ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,GACA,OAAO,CAAC,IAAI,CAAC;IAqChB;;OAEG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAClC,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACG,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,EACnC,MAAM,EAAE,QAAQ,GAAG,aAAa,GAAG,OAAO,EAC1C,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IA4CjE;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgDxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoCvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CA2D7G"}

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

@@ -1,371 +0,0 @@
-/**
- * Spec Metadata Manager
- *
- * Manages spec.md files in .specweave/docs/internal/specs/
- *
- * 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
- *
- * @module spec-metadata-manager
- */
-import fs from 'fs-extra';
-import path from 'path';
-import matter from 'gray-matter';
-export class SpecMetadataManager {
-    constructor(projectRoot = process.cwd()) {
-        // Support both old and new multi-project structure
-        const newPath = path.join(projectRoot, '.specweave/docs/internal/projects/default/specs');
-        const oldPath = path.join(projectRoot, '.specweave/docs/internal/specs');
-        if (fs.existsSync(newPath)) {
-            this.specsDir = newPath;
-        }
-        else if (fs.existsSync(oldPath)) {
-            this.specsDir = oldPath;
-        }
-        else {
-            // Create default structure
-            this.specsDir = newPath;
-            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