specweave 0.17.15 → 0.18.0

package/dist/src/core/sync/spec-increment-mapper.js

@@ -0,0 +1,424 @@
+/**
+ * Spec-to-Increment Mapper
+ *
+ * Maps permanent living docs specs to specific increment tasks.
+ * Enables traceability: "Which increment implemented US-001?"
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import matter from 'gray-matter';
+export class SpecIncrementMapper {
+    constructor(rootDir = process.cwd()) {
+        this.rootDir = rootDir;
+    }
+    /**
+     * Map a spec to all increments that implement it
+     */
+    async mapSpecToIncrements(specId) {
+        const increments = await this.findIncrementsForSpec(specId);
+        const userStoryMappings = {};
+        // Build user story to task mappings
+        for (const increment of increments) {
+            for (const task of increment.tasks) {
+                for (const userStoryId of task.userStories) {
+                    if (!userStoryMappings[userStoryId]) {
+                        userStoryMappings[userStoryId] = [];
+                    }
+                    userStoryMappings[userStoryId].push(task);
+                }
+            }
+        }
+        return {
+            specId,
+            increments,
+            userStoryMappings
+        };
+    }
+    /**
+     * Find all increments that implement a specific user story
+     */
+    async findIncrementsByUserStory(userStoryId) {
+        const incrementsDir = path.join(this.rootDir, '.specweave/increments');
+        try {
+            const entries = await fs.readdir(incrementsDir, { withFileTypes: true });
+            const incrementDirs = entries
+                .filter(e => e.isDirectory() && /^\d{4}-/.test(e.name))
+                .map(e => e.name);
+            const results = [];
+            for (const incrementId of incrementDirs) {
+                const tasks = await this.getTasksFromIncrement(incrementId);
+                const relevantTasks = tasks.filter(t => t.userStories.includes(userStoryId));
+                if (relevantTasks.length > 0) {
+                    results.push({
+                        id: incrementId,
+                        tasks: relevantTasks
+                    });
+                }
+            }
+            return results;
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * Get all tasks that implement a specific user story
+     */
+    async getTasksForUserStory(userStoryId) {
+        const increments = await this.findIncrementsByUserStory(userStoryId);
+        const tasks = [];
+        for (const increment of increments) {
+            tasks.push(...increment.tasks);
+        }
+        return tasks;
+    }
+    /**
+     * Update spec with increment links in frontmatter (Forward link)
+     */
+    async updateSpecWithIncrementLinks(specId, incrementId) {
+        const specPath = await this.findSpecPath(specId);
+        if (!specPath) {
+            return false;
+        }
+        try {
+            const content = await fs.readFile(specPath, 'utf-8');
+            const { data: frontmatter, content: markdownContent } = matter(content);
+            // Initialize linked_increments if not exists
+            if (!frontmatter.linked_increments) {
+                frontmatter.linked_increments = [];
+            }
+            // Check if already linked
+            if (frontmatter.linked_increments.includes(incrementId)) {
+                return false; // Already linked
+            }
+            // Add new increment link
+            frontmatter.linked_increments.push(incrementId);
+            // Write back
+            const updated = matter.stringify(markdownContent, frontmatter);
+            await fs.writeFile(specPath, updated);
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Update increment with spec link in frontmatter (Backward link)
+     */
+    async updateIncrementWithSpecLink(incrementId, specId) {
+        const incrementSpecPath = path.join(this.rootDir, '.specweave/increments', incrementId, 'spec.md');
+        try {
+            await fs.access(incrementSpecPath);
+        }
+        catch {
+            return false; // Increment spec.md doesn't exist
+        }
+        try {
+            const content = await fs.readFile(incrementSpecPath, 'utf-8');
+            const { data: frontmatter, content: markdownContent } = matter(content);
+            // Check if already linked
+            if (frontmatter.spec_id === specId || frontmatter.source_spec === specId) {
+                return false; // Already linked
+            }
+            // Add spec link
+            frontmatter.source_spec = specId;
+            // Write back
+            const updated = matter.stringify(markdownContent, frontmatter);
+            await fs.writeFile(incrementSpecPath, updated);
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Create bidirectional link between spec and increment (atomic operation)
+     */
+    async createBidirectionalLink(specId, incrementId) {
+        const forwardLink = await this.updateSpecWithIncrementLinks(specId, incrementId);
+        const backwardLink = await this.updateIncrementWithSpecLink(incrementId, specId);
+        return {
+            success: forwardLink || backwardLink,
+            forwardLink,
+            backwardLink
+        };
+    }
+    /**
+     * Get spec for a given increment (reverse lookup)
+     */
+    async getSpecForIncrement(incrementId) {
+        const incrementSpecPath = path.join(this.rootDir, '.specweave/increments', incrementId, 'spec.md');
+        try {
+            const content = await fs.readFile(incrementSpecPath, 'utf-8');
+            const { data: frontmatter } = matter(content);
+            // Check both field names for compatibility
+            return frontmatter.source_spec || frontmatter.spec_id || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Validate bidirectional links and detect broken references
+     */
+    async validateLinks() {
+        const brokenForwardLinks = [];
+        const brokenBackwardLinks = [];
+        const orphanedIncrements = [];
+        const incrementsDir = path.join(this.rootDir, '.specweave/increments');
+        try {
+            const entries = await fs.readdir(incrementsDir, { withFileTypes: true });
+            const incrementDirs = entries
+                .filter(e => e.isDirectory() && /^\d{4}-/.test(e.name))
+                .map(e => e.name);
+            for (const incrementId of incrementDirs) {
+                // Check backward link
+                const specId = await this.getSpecForIncrement(incrementId);
+                if (!specId) {
+                    orphanedIncrements.push(incrementId);
+                    continue;
+                }
+                // Validate forward link exists
+                const specPath = await this.findSpecPath(specId);
+                if (specPath) {
+                    const content = await fs.readFile(specPath, 'utf-8');
+                    const { data: frontmatter } = matter(content);
+                    if (!frontmatter.linked_increments?.includes(incrementId)) {
+                        brokenBackwardLinks.push({ incrementId, specId });
+                    }
+                }
+                else {
+                    brokenBackwardLinks.push({ incrementId, specId });
+                }
+            }
+            // Check specs for broken forward links
+            const specsDir = path.join(this.rootDir, '.specweave/docs/internal/specs');
+            const projects = await fs.readdir(specsDir, { withFileTypes: true });
+            for (const project of projects.filter(e => e.isDirectory())) {
+                const specs = await fs.readdir(path.join(specsDir, project.name));
+                for (const specFile of specs.filter(f => f.endsWith('.md'))) {
+                    const specPath = path.join(specsDir, project.name, specFile);
+                    const content = await fs.readFile(specPath, 'utf-8');
+                    const { data: frontmatter } = matter(content);
+                    if (frontmatter.linked_increments) {
+                        for (const incrementId of frontmatter.linked_increments) {
+                            const incrementPath = path.join(incrementsDir, incrementId, 'spec.md');
+                            try {
+                                await fs.access(incrementPath);
+                            }
+                            catch {
+                                brokenForwardLinks.push({
+                                    specId: specFile.replace('.md', ''),
+                                    incrementId
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // Directory doesn't exist or other error
+        }
+        return {
+            valid: brokenForwardLinks.length === 0 &&
+                brokenBackwardLinks.length === 0 &&
+                orphanedIncrements.length === 0,
+            brokenForwardLinks,
+            brokenBackwardLinks,
+            orphanedIncrements
+        };
+    }
+    /**
+     * Build complete traceability report for a spec
+     */
+    async buildTraceabilityReport(specId) {
+        const mapping = await this.mapSpecToIncrements(specId);
+        const userStories = await this.getUserStoriesFromSpec(specId);
+        const totalUserStories = userStories.length;
+        const totalIncrements = mapping.increments.length;
+        const totalTasks = mapping.increments.reduce((sum, inc) => sum + inc.tasks.length, 0);
+        const mappedUserStories = Object.keys(mapping.userStoryMappings).filter(us => userStories.includes(us));
+        const unmappedUserStories = userStories.filter(us => !mappedUserStories.includes(us));
+        const coverage = totalUserStories > 0
+            ? Math.min(100, (mappedUserStories.length / totalUserStories) * 100)
+            : 0;
+        // Build detailed mapping
+        const mappingDetails = {};
+        for (const [userStoryId, tasks] of Object.entries(mapping.userStoryMappings)) {
+            const incrementGroups = {};
+            for (const task of tasks) {
+                if (!incrementGroups[task.incrementId]) {
+                    incrementGroups[task.incrementId] = [];
+                }
+                incrementGroups[task.incrementId].push(task.id);
+            }
+            mappingDetails[userStoryId] = Object.entries(incrementGroups).map(([incrementId, taskIds]) => ({
+                incrementId,
+                taskIds
+            }));
+        }
+        return {
+            specId,
+            totalUserStories,
+            totalIncrements,
+            totalTasks,
+            coverage,
+            unmappedUserStories,
+            mappingDetails
+        };
+    }
+    // Private helper methods
+    async findIncrementsForSpec(specId) {
+        const incrementsDir = path.join(this.rootDir, '.specweave/increments');
+        try {
+            const entries = await fs.readdir(incrementsDir, { withFileTypes: true });
+            const incrementDirs = entries
+                .filter(e => e.isDirectory() && /^\d{4}-/.test(e.name))
+                .map(e => e.name);
+            const results = [];
+            for (const incrementId of incrementDirs) {
+                const specPath = path.join(incrementsDir, incrementId, 'spec.md');
+                try {
+                    const content = await fs.readFile(specPath, 'utf-8');
+                    const { data: frontmatter } = matter(content);
+                    // Check if this increment references our spec
+                    if (frontmatter.spec_id === specId || content.includes(`spec-${specId}`)) {
+                        const tasks = await this.getTasksFromIncrement(incrementId);
+                        results.push({
+                            id: incrementId,
+                            tasks,
+                            specId
+                        });
+                    }
+                }
+                catch {
+                    // Skip if spec.md doesn't exist
+                }
+            }
+            return results;
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    async getTasksFromIncrement(incrementId) {
+        const tasksPath = path.join(this.rootDir, '.specweave/increments', incrementId, 'tasks.md');
+        try {
+            const content = await fs.readFile(tasksPath, 'utf-8');
+            const { data: frontmatter } = matter(content);
+            const tasks = [];
+            // Parse tasks from markdown (tasks use ### heading level)
+            const taskRegex = /^###\s+(T-\d+):\s+(.+)$/gm;
+            let match;
+            while ((match = taskRegex.exec(content)) !== null) {
+                const taskId = match[1];
+                const title = match[2];
+                // Extract user stories for this task
+                const taskSection = this.extractTaskSection(content, taskId);
+                const userStories = this.extractUserStoriesFromTask(taskSection);
+                const githubIssue = this.extractGithubIssue(taskSection);
+                const status = this.extractTaskStatus(taskSection);
+                tasks.push({
+                    id: taskId,
+                    title,
+                    incrementId,
+                    userStories,
+                    githubIssue,
+                    status
+                });
+            }
+            return tasks;
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    extractTaskSection(content, taskId) {
+        const startRegex = new RegExp(`^###\\s+${taskId}:`, 'm');
+        const startMatch = content.match(startRegex);
+        if (!startMatch)
+            return '';
+        const startIndex = startMatch.index;
+        const nextTaskMatch = content.slice(startIndex + 1).match(/^###\s+T-\d+:/m);
+        const endIndex = nextTaskMatch
+            ? startIndex + 1 + nextTaskMatch.index
+            : content.length;
+        return content.slice(startIndex, endIndex);
+    }
+    extractUserStoriesFromTask(taskSection) {
+        // Look for AC references: AC-US1-01, AC-US2-01, etc.
+        const acRegex = /AC-US(\d+)-\d+/g;
+        const matches = [...taskSection.matchAll(acRegex)];
+        const userStoryNumbers = new Set(matches.map(m => m[1]));
+        // Also look for explicit "Implements: US-001, US-002"
+        const implementsMatch = taskSection.match(/Implements:\s*([^\n]+)/);
+        if (implementsMatch) {
+            const usMatches = implementsMatch[1].matchAll(/US-(\d+)/g);
+            for (const match of usMatches) {
+                userStoryNumbers.add(match[1]);
+            }
+        }
+        return Array.from(userStoryNumbers).map(num => `US-${num}`);
+    }
+    extractGithubIssue(taskSection) {
+        const match = taskSection.match(/github.*#(\d+)/i);
+        return match ? parseInt(match[1], 10) : undefined;
+    }
+    extractTaskStatus(taskSection) {
+        if (taskSection.includes('[x] Completed') || taskSection.includes('✅')) {
+            return 'completed';
+        }
+        if (taskSection.includes('[ ] In Progress') || taskSection.includes('🔄')) {
+            return 'in-progress';
+        }
+        return 'pending';
+    }
+    async findSpecPath(specId) {
+        const specsDir = path.join(this.rootDir, '.specweave/docs/internal/specs');
+        try {
+            // Try default project first
+            const defaultPath = path.join(specsDir, 'default', `${specId}.md`);
+            try {
+                await fs.access(defaultPath);
+                return defaultPath;
+            }
+            catch {
+                // Not in default, search all projects
+            }
+            // Search all project folders
+            const entries = await fs.readdir(specsDir, { withFileTypes: true });
+            const projectDirs = entries.filter(e => e.isDirectory()).map(e => e.name);
+            for (const project of projectDirs) {
+                const specPath = path.join(specsDir, project, `${specId}.md`);
+                try {
+                    await fs.access(specPath);
+                    return specPath;
+                }
+                catch {
+                    continue;
+                }
+            }
+            return null;
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    async getUserStoriesFromSpec(specId) {
+        const specPath = await this.findSpecPath(specId);
+        if (!specPath) {
+            return [];
+        }
+        try {
+            const content = await fs.readFile(specPath, 'utf-8');
+            const userStoryRegex = /\*\*(US-\d+)\*\*:/g;
+            const matches = [...content.matchAll(userStoryRegex)];
+            return matches.map(m => m[1]);
+        }
+        catch (error) {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=spec-increment-mapper.js.map

package/dist/src/core/sync/spec-increment-mapper.js.map

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

package/dist/src/core/sync/status-cache.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Status Cache
+ *
+ * Caches external tool statuses to reduce API calls.
+ * Uses in-memory cache with TTL (default: 5 minutes).
+ *
+ * Performance Optimization:
+ * - Reduces redundant API calls
+ * - Improves sync speed
+ * - Respects rate limits
+ *
+ * @module status-cache
+ */
+export interface CacheEntry<T> {
+    value: T;
+    timestamp: number;
+    ttl: number;
+}
+export interface CacheOptions {
+    ttl?: number;
+}
+/**
+ * Status Cache
+ *
+ * Generic cache for external tool statuses.
+ */
+export declare class StatusCache<T = any> {
+    private cache;
+    private defaultTtl;
+    constructor(options?: CacheOptions);
+    /**
+     * Get value from cache
+     *
+     * @param key - Cache key
+     * @returns Cached value or undefined if not found/expired
+     */
+    get(key: string): T | undefined;
+    /**
+     * Set value in cache
+     *
+     * @param key - Cache key
+     * @param value - Value to cache
+     * @param ttl - Optional TTL override (ms)
+     */
+    set(key: string, value: T, ttl?: number): void;
+    /**
+     * Check if key exists and is not expired
+     *
+     * @param key - Cache key
+     * @returns True if key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Delete key from cache
+     *
+     * @param key - Cache key
+     */
+    delete(key: string): void;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Get cache size
+     *
+     * @returns Number of entries in cache
+     */
+    size(): number;
+    /**
+     * Clean up expired entries
+     *
+     * Removes all expired entries from cache.
+     */
+    cleanup(): void;
+    /**
+     * Get cache statistics
+     *
+     * @returns Cache statistics (size, oldest entry age)
+     */
+    getStats(): {
+        size: number;
+        oldestEntryAge: number | null;
+    };
+}
+/**
+ * Global status cache instance
+ *
+ * Used across all sync operations for maximum efficiency.
+ */
+export declare const globalStatusCache: StatusCache<any>;
+//# sourceMappingURL=status-cache.d.ts.map

package/dist/src/core/sync/status-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-cache.d.ts","sourceRoot":"","sources":["../../../../src/core/sync/status-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,GAAG;IAC9B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,CAAC,EAAE,YAAY;IAKlC;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAoB/B;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAU9C;;;;;OAKG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACH,IAAI,IAAI,MAAM;IAMd;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAgBf;;;;OAIG;IACH,QAAQ,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;CAqB5D;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,kBAAoB,CAAC"}

package/dist/src/core/sync/status-cache.js

@@ -0,0 +1,140 @@
+/**
+ * Status Cache
+ *
+ * Caches external tool statuses to reduce API calls.
+ * Uses in-memory cache with TTL (default: 5 minutes).
+ *
+ * Performance Optimization:
+ * - Reduces redundant API calls
+ * - Improves sync speed
+ * - Respects rate limits
+ *
+ * @module status-cache
+ */
+/**
+ * Status Cache
+ *
+ * Generic cache for external tool statuses.
+ */
+export class StatusCache {
+    constructor(options) {
+        this.cache = new Map();
+        this.defaultTtl = options?.ttl || 5 * 60 * 1000; // 5 minutes default
+    }
+    /**
+     * Get value from cache
+     *
+     * @param key - Cache key
+     * @returns Cached value or undefined if not found/expired
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        // Check if expired
+        const now = Date.now();
+        const age = now - entry.timestamp;
+        if (age > entry.ttl) {
+            // Expired - remove and return undefined
+            this.cache.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    /**
+     * Set value in cache
+     *
+     * @param key - Cache key
+     * @param value - Value to cache
+     * @param ttl - Optional TTL override (ms)
+     */
+    set(key, value, ttl) {
+        const entry = {
+            value,
+            timestamp: Date.now(),
+            ttl: ttl || this.defaultTtl
+        };
+        this.cache.set(key, entry);
+    }
+    /**
+     * Check if key exists and is not expired
+     *
+     * @param key - Cache key
+     * @returns True if key exists and is not expired
+     */
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    /**
+     * Delete key from cache
+     *
+     * @param key - Cache key
+     */
+    delete(key) {
+        this.cache.delete(key);
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache size
+     *
+     * @returns Number of entries in cache
+     */
+    size() {
+        // Clean up expired entries first
+        this.cleanup();
+        return this.cache.size;
+    }
+    /**
+     * Clean up expired entries
+     *
+     * Removes all expired entries from cache.
+     */
+    cleanup() {
+        const now = Date.now();
+        const keysToDelete = [];
+        for (const [key, entry] of this.cache.entries()) {
+            const age = now - entry.timestamp;
+            if (age > entry.ttl) {
+                keysToDelete.push(key);
+            }
+        }
+        for (const key of keysToDelete) {
+            this.cache.delete(key);
+        }
+    }
+    /**
+     * Get cache statistics
+     *
+     * @returns Cache statistics (size, oldest entry age)
+     */
+    getStats() {
+        this.cleanup();
+        if (this.cache.size === 0) {
+            return { size: 0, oldestEntryAge: null };
+        }
+        const now = Date.now();
+        let oldestTimestamp = now;
+        for (const entry of this.cache.values()) {
+            if (entry.timestamp < oldestTimestamp) {
+                oldestTimestamp = entry.timestamp;
+            }
+        }
+        return {
+            size: this.cache.size,
+            oldestEntryAge: now - oldestTimestamp
+        };
+    }
+}
+/**
+ * Global status cache instance
+ *
+ * Used across all sync operations for maximum efficiency.
+ */
+export const globalStatusCache = new StatusCache();
+//# sourceMappingURL=status-cache.js.map