specweave 0.16.5 → 0.16.11

package/dist/src/core/spec-content-sync.js

@@ -0,0 +1,222 @@
+/**
+ * Spec Content Synchronization
+ *
+ * Syncs spec CONTENT (title, description, user stories) to external tools.
+ * Does NOT sync STATUS - that's managed by external tool.
+ *
+ * Sync Direction:
+ * - Title/Description/User Stories: SpecWeave → External Tool (we update)
+ * - Status/State: External Tool → SpecWeave (we read)
+ */
+import fs from 'fs/promises';
+import path from 'path';
+/**
+ * Parse spec.md to extract content
+ */
+export async function parseSpecContent(specPath) {
+    try {
+        const content = await fs.readFile(specPath, 'utf-8');
+        // Extract spec ID from filename
+        // spec-001-feature-name.md → spec-001
+        const filename = path.basename(specPath);
+        const specIdMatch = filename.match(/^(spec-\d+)/);
+        const specId = specIdMatch ? specIdMatch[1] : 'unknown';
+        // Extract title (first heading)
+        const titleMatch = content.match(/^#\s+(.+)$/m);
+        const title = titleMatch ? titleMatch[1].replace(/^SPEC-\d+:\s*/, '') : 'Untitled';
+        // Extract description (text between title and first ## heading)
+        const descMatch = content.match(/^#\s+.+\n\n(.+?)(?=\n##|\n---|\n\*\*|$)/s);
+        const description = descMatch ? descMatch[1].trim() : '';
+        // Extract metadata from frontmatter or body
+        const metadata = {};
+        // GitHub Project
+        const githubMatch = content.match(/\*\*GitHub Project\*\*:\s*(.+)/);
+        if (githubMatch)
+            metadata.githubProject = githubMatch[1].trim();
+        // JIRA Epic
+        const jiraMatch = content.match(/\*\*JIRA Epic\*\*:\s*(.+)/);
+        if (jiraMatch)
+            metadata.jiraEpic = jiraMatch[1].trim();
+        // ADO Feature
+        const adoMatch = content.match(/\*\*ADO Feature\*\*:\s*(.+)/);
+        if (adoMatch)
+            metadata.adoFeature = adoMatch[1].trim();
+        // Priority
+        const priorityMatch = content.match(/\*\*Priority\*\*:\s*(P\d)/);
+        if (priorityMatch)
+            metadata.priority = priorityMatch[1];
+        // Parse user stories
+        const userStories = [];
+        // Match user story patterns: **US-001**: Title
+        const userStoryRegex = /\*\*US-(\d+)\*\*:\s*(.+)/g;
+        const usMatches = [...content.matchAll(userStoryRegex)];
+        for (const usMatch of usMatches) {
+            const usNumber = usMatch[1];
+            const usId = `US-${usNumber}`;
+            const usTitle = usMatch[2].trim();
+            // Find acceptance criteria for this user story
+            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 acDescription = acMatch[3].trim();
+                const acMetadata = acMatch[4] || '';
+                acceptanceCriteria.push({
+                    id: `AC-US${usNumber}-${acNumber}`,
+                    description: acDescription,
+                    completed,
+                    priority: acMetadata.includes('P1') ? 'P1' : acMetadata.includes('P2') ? 'P2' : undefined,
+                    testable: acMetadata.includes('testable'),
+                });
+            }
+            userStories.push({
+                id: usId,
+                title: usTitle,
+                acceptanceCriteria,
+            });
+        }
+        return {
+            id: specId,
+            title,
+            description,
+            userStories,
+            metadata,
+        };
+    }
+    catch (error) {
+        console.error(`Failed to parse spec: ${error.message}`);
+        return null;
+    }
+}
+/**
+ * Detect changes between local spec and external tool
+ */
+export function detectContentChanges(localSpec, externalContent) {
+    const changes = [];
+    // Title changed
+    if (localSpec.title !== externalContent.title) {
+        changes.push(`title: "${externalContent.title}" → "${localSpec.title}"`);
+    }
+    // Description changed (normalize whitespace for comparison)
+    const normalizeDesc = (str) => str.replace(/\s+/g, ' ').trim();
+    if (normalizeDesc(localSpec.description) !== normalizeDesc(externalContent.description)) {
+        changes.push('description updated');
+    }
+    // User stories changed
+    if (localSpec.userStories.length !== externalContent.userStoryCount) {
+        changes.push(`user stories: ${externalContent.userStoryCount} → ${localSpec.userStories.length}`);
+    }
+    return {
+        hasChanges: changes.length > 0,
+        changes,
+    };
+}
+/**
+ * Build external tool description from spec content
+ */
+export function buildExternalDescription(spec) {
+    let description = '';
+    // Add spec description
+    if (spec.description) {
+        description += spec.description + '\n\n';
+    }
+    // Add user stories as checklist
+    if (spec.userStories.length > 0) {
+        description += '## User Stories\n\n';
+        for (const us of spec.userStories) {
+            description += `### ${us.id}: ${us.title}\n\n`;
+            if (us.acceptanceCriteria.length > 0) {
+                description += '**Acceptance Criteria:**\n';
+                for (const ac of us.acceptanceCriteria) {
+                    const checkbox = ac.completed ? '[x]' : '[ ]';
+                    description += `- ${checkbox} ${ac.id}: ${ac.description}\n`;
+                }
+                description += '\n';
+            }
+        }
+    }
+    // Add metadata
+    if (spec.metadata.priority) {
+        description += `\n**Priority:** ${spec.metadata.priority}\n`;
+    }
+    return description;
+}
+/**
+ * Check if spec has external tool link
+ */
+export async function hasExternalLink(specPath, provider) {
+    try {
+        const content = await fs.readFile(specPath, 'utf-8');
+        switch (provider) {
+            case 'github':
+                const githubMatch = content.match(/\*\*GitHub Project\*\*:\s*(.+)/);
+                return githubMatch ? githubMatch[1].trim() : null;
+            case 'jira':
+                const jiraMatch = content.match(/\*\*JIRA Epic\*\*:\s*([A-Z]+-\d+)/);
+                return jiraMatch ? jiraMatch[1] : null;
+            case 'ado':
+                const adoMatch = content.match(/\*\*ADO Feature\*\*:\s*#?(\d+)/);
+                return adoMatch ? adoMatch[1] : null;
+            default:
+                return null;
+        }
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Update spec.md with external tool link
+ */
+export async function updateSpecWithExternalLink(specPath, provider, externalId, externalUrl) {
+    try {
+        let content = await fs.readFile(specPath, 'utf-8');
+        const linkText = {
+            github: `**GitHub Project**: ${externalUrl}`,
+            jira: `**JIRA Epic**: ${externalId}`,
+            ado: `**ADO Feature**: #${externalId}`,
+        }[provider];
+        // Add link after title if not present
+        if (!content.includes(linkText.split(':')[0])) {
+            // Find first heading
+            const titleMatch = content.match(/^(#\s+.+\n)/m);
+            if (titleMatch) {
+                const insertPos = titleMatch.index + titleMatch[0].length;
+                content =
+                    content.slice(0, insertPos) +
+                        '\n' +
+                        linkText +
+                        '\n' +
+                        content.slice(insertPos);
+            }
+            else {
+                // Add at top
+                content = linkText + '\n\n' + content;
+            }
+            await fs.writeFile(specPath, content);
+        }
+    }
+    catch (error) {
+        console.error(`Failed to update spec with external link: ${error.message}`);
+    }
+}
+/**
+ * Get spec modification time
+ */
+export async function getSpecModificationTime(specPath) {
+    const stats = await fs.stat(specPath);
+    return stats.mtime;
+}
+/**
+ * Check if spec was modified since last sync
+ */
+export async function wasSpecModifiedSinceSync(specPath, lastSyncTime) {
+    if (!lastSyncTime) {
+        return true; // No previous sync
+    }
+    const modTime = await getSpecModificationTime(specPath);
+    return modTime > lastSyncTime;
+}
+//# sourceMappingURL=spec-content-sync.js.map

package/dist/src/core/spec-content-sync.js.map

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

package/dist/src/core/spec-task-mapper.d.ts

@@ -0,0 +1,71 @@
+/**
+ * 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.
+ */
+export interface UserStory {
+    id: string;
+    title: string;
+    description?: string;
+    acceptanceCriteria: AcceptanceCriterion[];
+}
+export interface AcceptanceCriterion {
+    id: string;
+    description: string;
+    priority?: string;
+    testable: boolean;
+    completed: boolean;
+}
+export interface Task {
+    id: string;
+    title: string;
+    description?: string;
+    acIds: string[];
+    completed: boolean;
+    userStories: string[];
+}
+export interface SpecTaskMapping {
+    specId: string;
+    specPath: string;
+    incrementId: string;
+    incrementPath: string;
+    userStories: UserStory[];
+    tasks: Task[];
+    mappings: TaskToUserStoryMapping[];
+}
+export interface TaskToUserStoryMapping {
+    taskId: string;
+    userStoryIds: string[];
+    acIds: string[];
+    completed: boolean;
+}
+/**
+ * Parse spec.md to extract user stories and acceptance criteria
+ */
+export declare function parseSpec(specPath: string): Promise<UserStory[]>;
+/**
+ * Parse tasks.md to extract tasks with AC-IDs
+ */
+export declare function parseTasks(tasksPath: string): Promise<Task[]>;
+/**
+ * Create mapping between tasks and user stories
+ */
+export declare function createTaskToUserStoryMapping(tasks: Task[], userStories: UserStory[]): TaskToUserStoryMapping[];
+/**
+ * Get full mapping for an increment
+ */
+export declare function getSpecTaskMapping(incrementPath: string, specPath?: string): Promise<SpecTaskMapping | null>;
+/**
+ * Get completed user stories from mappings
+ */
+export declare function getCompletedUserStories(mapping: SpecTaskMapping): UserStory[];
+/**
+ * Get recently completed tasks (completed since last sync)
+ */
+export declare function getRecentlyCompletedTasks(mapping: SpecTaskMapping, lastSyncDate?: Date): Task[];
+/**
+ * Find spec path for an increment
+ */
+export declare function findSpecForIncrement(incrementPath: string): Promise<string | null>;
+//# sourceMappingURL=spec-task-mapper.d.ts.map

package/dist/src/core/spec-task-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-task-mapper.d.ts","sourceRoot":"","sources":["../../../src/core/spec-task-mapper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,mBAAmB,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,sBAAsB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA+CtE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAmDnE;AAWD;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,IAAI,EAAE,EACb,WAAW,EAAE,SAAS,EAAE,GACvB,sBAAsB,EAAE,CAa1B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,aAAa,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA6DjC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,SAAS,EAAE,CAeb;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,eAAe,EACxB,YAAY,CAAC,EAAE,IAAI,GAClB,IAAI,EAAE,CASR;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB"}

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

@@ -0,0 +1,208 @@
+/**
+ * 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/src/core/spec-task-mapper.js.map

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

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

@@ -0,0 +1,72 @@
+/**
+ * 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 { SpecMetadata, SpecContent, SpecValidationResult } from '../types/spec-metadata.js';
+export declare class SpecMetadataManager {
+    private specsDir;
+    private projectManager;
+    constructor(projectRoot?: string, projectId?: 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/src/core/specs/spec-metadata-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-metadata-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/specs/spec-metadata-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EACL,YAAY,EACZ,WAAW,EAIX,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAGnC,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,cAAc,CAAiB;gBAE3B,WAAW,GAAE,MAAsB,EAAE,SAAS,CAAC,EAAE,MAAM;IAUnE;;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"}