specweave 0.17.7 → 0.17.8

package/dist/src/core/living-docs/cross-linker.js

@@ -0,0 +1,374 @@
+/**
+ * Cross-Linker for Intelligent Living Docs Sync
+ *
+ * Generates cross-references between related documents for traceability.
+ *
+ * @module living-docs/cross-linker
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { ContentCategory } from './content-classifier.js';
+/**
+ * Link types
+ */
+export var LinkType;
+(function (LinkType) {
+    LinkType["Implements"] = "implements";
+    LinkType["DependsOn"] = "depends-on";
+    LinkType["References"] = "references";
+    LinkType["RelatedTo"] = "related-to";
+    LinkType["DefinedIn"] = "defined-in";
+    LinkType["TestsFor"] = "tests-for";
+})(LinkType || (LinkType = {}));
+/**
+ * Cross-Linker class
+ */
+export class CrossLinker {
+    constructor(options = {}) {
+        this.options = {
+            basePath: options.basePath || path.join(process.cwd(), '.specweave', 'docs', 'internal'),
+            generateBacklinks: options.generateBacklinks ?? true,
+            updateExisting: options.updateExisting ?? true,
+            dryRun: options.dryRun ?? false,
+        };
+        this.links = [];
+    }
+    /**
+     * Generate cross-links for distributed files
+     */
+    async generateLinks(result) {
+        this.links = [];
+        // Group files by category
+        const byCategory = this.groupByCategory(result);
+        // Generate links between categories
+        await this.generateArchitectureLinks(byCategory);
+        await this.generateOperationsLinks(byCategory);
+        await this.generateDeliveryLinks(byCategory);
+        await this.generateStrategyLinks(byCategory);
+        // Generate backlinks if enabled
+        if (this.options.generateBacklinks) {
+            await this.generateBacklinks();
+        }
+        // Update documents with links
+        if (this.options.updateExisting && !this.options.dryRun) {
+            await this.updateDocuments();
+        }
+        return this.links;
+    }
+    /**
+     * Group files by category
+     */
+    groupByCategory(result) {
+        const groups = new Map();
+        const allFiles = [...result.created, ...result.updated];
+        for (const file of allFiles) {
+            if (!groups.has(file.category)) {
+                groups.set(file.category, []);
+            }
+            groups.get(file.category).push(file);
+        }
+        return groups;
+    }
+    /**
+     * Generate links from specs to architecture
+     */
+    async generateArchitectureLinks(groups) {
+        const specs = groups.get(ContentCategory.UserStory) || [];
+        const architecture = groups.get(ContentCategory.Architecture) || [];
+        const adrs = groups.get(ContentCategory.ADR) || [];
+        // Link specs to architecture docs
+        for (const spec of specs) {
+            for (const arch of architecture) {
+                if (await this.documentsRelated(spec.path, arch.path)) {
+                    this.links.push({
+                        source: spec.path,
+                        target: arch.path,
+                        type: LinkType.Implements,
+                        description: 'User story implements architecture design',
+                    });
+                }
+            }
+            // Link specs to ADRs
+            for (const adr of adrs) {
+                if (await this.documentsRelated(spec.path, adr.path)) {
+                    this.links.push({
+                        source: spec.path,
+                        target: adr.path,
+                        type: LinkType.References,
+                        description: 'User story references architecture decision',
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Generate links from operations to architecture
+     */
+    async generateOperationsLinks(groups) {
+        const operations = groups.get(ContentCategory.Operations) || [];
+        const architecture = groups.get(ContentCategory.Architecture) || [];
+        for (const ops of operations) {
+            for (const arch of architecture) {
+                if (await this.documentsRelated(ops.path, arch.path)) {
+                    this.links.push({
+                        source: ops.path,
+                        target: arch.path,
+                        type: LinkType.DependsOn,
+                        description: 'Operational procedure depends on architecture',
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Generate links from delivery to specs
+     */
+    async generateDeliveryLinks(groups) {
+        const delivery = groups.get(ContentCategory.Delivery) || [];
+        const specs = groups.get(ContentCategory.UserStory) || [];
+        for (const del of delivery) {
+            for (const spec of specs) {
+                if (await this.documentsRelated(del.path, spec.path)) {
+                    this.links.push({
+                        source: del.path,
+                        target: spec.path,
+                        type: LinkType.TestsFor,
+                        description: 'Test strategy covers user story',
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Generate links from strategy to specs
+     */
+    async generateStrategyLinks(groups) {
+        const strategy = groups.get(ContentCategory.Strategy) || [];
+        const specs = groups.get(ContentCategory.UserStory) || [];
+        for (const strat of strategy) {
+            for (const spec of specs) {
+                if (await this.documentsRelated(strat.path, spec.path)) {
+                    this.links.push({
+                        source: strat.path,
+                        target: spec.path,
+                        type: LinkType.DefinedIn,
+                        description: 'Business requirement defined in strategy',
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Check if two documents are related (heuristic)
+     */
+    async documentsRelated(path1, path2) {
+        try {
+            // Extract key terms from filenames
+            const name1 = path.basename(path1, '.md').toLowerCase();
+            const name2 = path.basename(path2, '.md').toLowerCase();
+            // Simple heuristic: if they share significant words
+            const words1 = name1.split(/[-_]/).filter((w) => w.length > 3);
+            const words2 = name2.split(/[-_]/).filter((w) => w.length > 3);
+            const sharedWords = words1.filter((w) => words2.includes(w));
+            // If 2+ shared words, consider related
+            if (sharedWords.length >= 2) {
+                return true;
+            }
+            // Check content for cross-references (more expensive)
+            if (fs.existsSync(path1) && fs.existsSync(path2)) {
+                const content1 = await fs.readFile(path1, 'utf-8');
+                const content2 = await fs.readFile(path2, 'utf-8');
+                // Check if path1 mentions path2's filename
+                const name2Clean = path.basename(path2, '.md');
+                if (content1.toLowerCase().includes(name2Clean.toLowerCase())) {
+                    return true;
+                }
+                // Check if path2 mentions path1's filename
+                const name1Clean = path.basename(path1, '.md');
+                if (content2.toLowerCase().includes(name1Clean.toLowerCase())) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Generate backlinks (bidirectional)
+     */
+    async generateBacklinks() {
+        const backlinks = [];
+        for (const link of this.links) {
+            // Create reverse link
+            backlinks.push({
+                source: link.target,
+                target: link.source,
+                type: this.getReverseType(link.type),
+                description: this.getReverseDescription(link),
+            });
+        }
+        this.links.push(...backlinks);
+    }
+    /**
+     * Get reverse link type
+     */
+    getReverseType(type) {
+        const reverseMap = {
+            [LinkType.Implements]: LinkType.DefinedIn,
+            [LinkType.DependsOn]: LinkType.DefinedIn,
+            [LinkType.References]: LinkType.References,
+            [LinkType.RelatedTo]: LinkType.RelatedTo,
+            [LinkType.DefinedIn]: LinkType.Implements,
+            [LinkType.TestsFor]: LinkType.DefinedIn,
+        };
+        return reverseMap[type] || LinkType.RelatedTo;
+    }
+    /**
+     * Get reverse description
+     */
+    getReverseDescription(link) {
+        const name = path.basename(link.source, '.md').replace(/-/g, ' ');
+        return `Referenced by ${name}`;
+    }
+    /**
+     * Update documents with generated links
+     */
+    async updateDocuments() {
+        // Group links by source file
+        const linksBySource = new Map();
+        for (const link of this.links) {
+            if (!linksBySource.has(link.source)) {
+                linksBySource.set(link.source, []);
+            }
+            linksBySource.get(link.source).push(link);
+        }
+        // Update each source file
+        for (const [sourcePath, links] of linksBySource.entries()) {
+            await this.updateDocument(sourcePath, links);
+        }
+    }
+    /**
+     * Update a single document with links
+     */
+    async updateDocument(filePath, links) {
+        if (!fs.existsSync(filePath)) {
+            return;
+        }
+        try {
+            let content = await fs.readFile(filePath, 'utf-8');
+            // Check if links section already exists
+            const linksSection = '\n\n## Related Documents\n\n';
+            const hasLinksSection = content.includes('## Related Documents');
+            if (hasLinksSection) {
+                // Update existing section
+                const regex = /## Related Documents\n\n[\s\S]*?(?=\n## |\n---|\n\*\*Source\*\*|$)/;
+                content = content.replace(regex, linksSection + this.generateLinksMarkdown(links));
+            }
+            else {
+                // Add new section before footer
+                const footerIndex = content.lastIndexOf('\n---\n');
+                if (footerIndex !== -1) {
+                    const before = content.substring(0, footerIndex);
+                    const after = content.substring(footerIndex);
+                    content = before + linksSection + this.generateLinksMarkdown(links) + '\n' + after;
+                }
+                else {
+                    // No footer - append to end
+                    content += linksSection + this.generateLinksMarkdown(links);
+                }
+            }
+            // Write updated content
+            await fs.writeFile(filePath, content, 'utf-8');
+        }
+        catch (error) {
+            console.warn(`Failed to update links in ${filePath}:`, error);
+        }
+    }
+    /**
+     * Generate markdown for links section
+     */
+    generateLinksMarkdown(links) {
+        let markdown = '';
+        // Group by type
+        const byType = new Map();
+        for (const link of links) {
+            if (!byType.has(link.type)) {
+                byType.set(link.type, []);
+            }
+            byType.get(link.type).push(link);
+        }
+        // Generate sections for each type
+        for (const [type, typeLinks] of byType.entries()) {
+            markdown += `### ${this.getLinkTypeTitle(type)}\n\n`;
+            for (const link of typeLinks) {
+                const relativePath = this.getRelativePath(link.source, link.target);
+                const title = path.basename(link.target, '.md').replace(/-/g, ' ');
+                markdown += `- [${title}](${relativePath})`;
+                if (link.description) {
+                    markdown += ` - ${link.description}`;
+                }
+                markdown += '\n';
+            }
+            markdown += '\n';
+        }
+        return markdown;
+    }
+    /**
+     * Get link type display title
+     */
+    getLinkTypeTitle(type) {
+        const titles = {
+            [LinkType.Implements]: 'Implements',
+            [LinkType.DependsOn]: 'Depends On',
+            [LinkType.References]: 'References',
+            [LinkType.RelatedTo]: 'Related To',
+            [LinkType.DefinedIn]: 'Defined In',
+            [LinkType.TestsFor]: 'Tests For',
+        };
+        return titles[type] || type;
+    }
+    /**
+     * Get relative path from source to target
+     */
+    getRelativePath(source, target) {
+        const sourceDir = path.dirname(source);
+        return path.relative(sourceDir, target);
+    }
+    /**
+     * Get all links
+     */
+    getLinks() {
+        return this.links;
+    }
+    /**
+     * Get links for a specific file
+     */
+    getLinksFor(filePath) {
+        return this.links.filter((link) => link.source === filePath);
+    }
+    /**
+     * Get statistics
+     */
+    getStatistics() {
+        const stats = {
+            total: this.links.length,
+            byType: {},
+            bidirectional: 0,
+        };
+        for (const link of this.links) {
+            stats.byType[link.type] = (stats.byType[link.type] || 0) + 1;
+        }
+        // Count bidirectional (simplified)
+        stats.bidirectional = this.links.filter((link) => this.links.some((l) => l.source === link.target && l.target === link.source)).length / 2;
+        return stats;
+    }
+}
+/**
+ * Factory function to create linker
+ */
+export function createCrossLinker(options) {
+    return new CrossLinker(options);
+}
+//# sourceMappingURL=cross-linker.js.map

package/dist/src/core/living-docs/cross-linker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-linker.js","sourceRoot":"","sources":["../../../../src/core/living-docs/cross-linker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAY1D;;GAEG;AACH,MAAM,CAAN,IAAY,QAOX;AAPD,WAAY,QAAQ;IAClB,qCAAyB,CAAA;IACzB,oCAAwB,CAAA;IACxB,qCAAyB,CAAA;IACzB,oCAAwB,CAAA;IACxB,oCAAwB,CAAA;IACxB,kCAAsB,CAAA;AACxB,CAAC,EAPW,QAAQ,KAAR,QAAQ,QAOnB;AAYD;;GAEG;AACH,MAAM,OAAO,WAAW;IAItB,YAAY,UAAyB,EAAE;QACrC,IAAI,CAAC,OAAO,GAAG;YACb,QAAQ,EACN,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,CAAC;YAChF,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,IAAI;YACpD,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;YAC9C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;SAChC,CAAC;QAEF,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,MAA0B;QAC5C,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAEhB,0BAA0B;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAEhD,oCAAoC;QACpC,MAAM,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;QAC/C,MAAM,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAE7C,gCAAgC;QAChC,IAAI,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACnC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACjC,CAAC;QAED,8BAA8B;QAC9B,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACxD,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC/B,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACK,eAAe,CACrB,MAA0B;QAE1B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsC,CAAC;QAC7D,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAExD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAChC,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,yBAAyB,CACrC,MAA+C;QAE/C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAEnD,kCAAkC;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;gBAChC,IAAI,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACtD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;wBACd,MAAM,EAAE,IAAI,CAAC,IAAI;wBACjB,MAAM,EAAE,IAAI,CAAC,IAAI;wBACjB,IAAI,EAAE,QAAQ,CAAC,UAAU;wBACzB,WAAW,EAAE,2CAA2C;qBACzD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAED,qBAAqB;YACrB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;wBACd,MAAM,EAAE,IAAI,CAAC,IAAI;wBACjB,MAAM,EAAE,GAAG,CAAC,IAAI;wBAChB,IAAI,EAAE,QAAQ,CAAC,UAAU;wBACzB,WAAW,EAAE,6CAA6C;qBAC3D,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,uBAAuB,CACnC,MAA+C;QAE/C,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QAChE,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAEpE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;gBAChC,IAAI,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;wBACd,MAAM,EAAE,GAAG,CAAC,IAAI;wBAChB,MAAM,EAAE,IAAI,CAAC,IAAI;wBACjB,IAAI,EAAE,QAAQ,CAAC,SAAS;wBACxB,WAAW,EAAE,+CAA+C;qBAC7D,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CACjC,MAA+C;QAE/C,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAE1D,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACrD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;wBACd,MAAM,EAAE,GAAG,CAAC,IAAI;wBAChB,MAAM,EAAE,IAAI,CAAC,IAAI;wBACjB,IAAI,EAAE,QAAQ,CAAC,QAAQ;wBACvB,WAAW,EAAE,iCAAiC;qBAC/C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CACjC,MAA+C;QAE/C,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAE1D,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;wBACd,MAAM,EAAE,KAAK,CAAC,IAAI;wBAClB,MAAM,EAAE,IAAI,CAAC,IAAI;wBACjB,IAAI,EAAE,QAAQ,CAAC,SAAS;wBACxB,WAAW,EAAE,0CAA0C;qBACxD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAAC,KAAa,EAAE,KAAa;QACzD,IAAI,CAAC;YACH,mCAAmC;YACnC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YACxD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YAExD,oDAAoD;YACpD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAE/D,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YAE7D,uCAAuC;YACvC,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBAC5B,OAAO,IAAI,CAAC;YACd,CAAC;YAED,sDAAsD;YACtD,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACnD,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAEnD,2CAA2C;gBAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC/C,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBAC9D,OAAO,IAAI,CAAC;gBACd,CAAC;gBAED,2CAA2C;gBAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC/C,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;oBAC9D,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB;QAC7B,MAAM,SAAS,GAAgB,EAAE,CAAC;QAElC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,sBAAsB;YACtB,SAAS,CAAC,IAAI,CAAC;gBACb,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,IAAI,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;gBACpC,WAAW,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC;aAC9C,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,IAAc;QACnC,MAAM,UAAU,GAA+B;YAC7C,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,SAAS;YACzC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,SAAS;YACxC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,UAAU;YAC1C,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,SAAS;YACxC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,UAAU;YACzC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,SAAS;SACxC,CAAC;QAEF,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC;IAChD,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,IAAe;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClE,OAAO,iBAAiB,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe;QAC3B,6BAA6B;QAC7B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;QAErD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACrC,CAAC;YACD,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;QAED,0BAA0B;QAC1B,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1D,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,KAAkB;QAC/D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,IAAI,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAEnD,wCAAwC;YACxC,MAAM,YAAY,GAAG,8BAA8B,CAAC;YACpD,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;YAEjE,IAAI,eAAe,EAAE,CAAC;gBACpB,0BAA0B;gBAC1B,MAAM,KAAK,GAAG,oEAAoE,CAAC;gBACnF,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;YACrF,CAAC;iBAAM,CAAC;gBACN,gCAAgC;gBAChC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;gBACnD,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;oBACvB,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;oBACjD,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;oBAC7C,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;gBACrF,CAAC;qBAAM,CAAC;oBACN,4BAA4B;oBAC5B,OAAO,IAAI,YAAY,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;YAED,wBAAwB;YACxB,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,6BAA6B,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,KAAkB;QAC9C,IAAI,QAAQ,GAAG,EAAE,CAAC;QAElB,gBAAgB;QAChB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyB,CAAC;QAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC5B,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,kCAAkC;QAClC,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACjD,QAAQ,IAAI,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC;YAErD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;gBAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBACpE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;gBACnE,QAAQ,IAAI,MAAM,KAAK,KAAK,YAAY,GAAG,CAAC;gBAC5C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;oBACrB,QAAQ,IAAI,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;gBACvC,CAAC;gBACD,QAAQ,IAAI,IAAI,CAAC;YACnB,CAAC;YAED,QAAQ,IAAI,IAAI,CAAC;QACnB,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,IAAc;QACrC,MAAM,MAAM,GAA6B;YACvC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY;YACnC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY;YAClC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY;YACnC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY;YAClC,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY;YAClC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW;SACjC,CAAC;QAEF,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAC9B,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,MAAc,EAAE,MAAc;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAgB;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,aAAa;QAKX,MAAM,KAAK,GAAG;YACZ,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACxB,MAAM,EAAE,EAA8B;YACtC,aAAa,EAAE,CAAC;SACjB,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/D,CAAC;QAED,mCAAmC;QACnC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAC7E,CAAC,MAAM,GAAG,CAAC,CAAC;QAEb,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAuB;IACvD,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,89 @@
+/**
+ * Intelligent Living Docs Sync - Main Orchestrator
+ *
+ * Coordinates all components for intelligent spec distribution.
+ *
+ * @module living-docs
+ */
+import { ContentParser, ParsedSpec, ParserOptions } from './content-parser.js';
+import { ContentClassifier, ClassificationResult } from './content-classifier.js';
+import { ProjectDetector, ProjectContext, DetectorOptions } from './project-detector.js';
+import { ContentDistributor, DistributionResult, DistributorOptions } from './content-distributor.js';
+import { CrossLinker, CrossLink, LinkerOptions } from './cross-linker.js';
+/**
+ * Intelligent Sync options
+ */
+export interface IntelligentSyncOptions {
+    parser?: ParserOptions;
+    detector?: DetectorOptions;
+    distributor?: DistributorOptions;
+    linker?: LinkerOptions;
+    dryRun?: boolean;
+    verbose?: boolean;
+}
+/**
+ * Complete sync result
+ */
+export interface IntelligentSyncResult {
+    incrementId: string;
+    project: ProjectContext;
+    spec: ParsedSpec;
+    classifications: ClassificationResult[];
+    distribution: DistributionResult;
+    links: CrossLink[];
+    duration: number;
+    success: boolean;
+    errors: string[];
+}
+/**
+ * Intelligent Living Docs Sync Orchestrator
+ */
+export declare class IntelligentLivingDocsSync {
+    private parser;
+    private classifier;
+    private detector;
+    private distributor;
+    private linker;
+    private options;
+    constructor(options?: IntelligentSyncOptions);
+    /**
+     * Sync increment spec to living docs
+     */
+    syncIncrement(incrementId: string): Promise<IntelligentSyncResult>;
+    /**
+     * Load and parse increment spec
+     */
+    private loadAndParseSpec;
+    /**
+     * Generate index files for categories
+     */
+    private generateIndexFiles;
+    /**
+     * Logging helper
+     */
+    private log;
+    /**
+     * Get component instances (for testing/advanced usage)
+     */
+    getComponents(): {
+        parser: ContentParser;
+        classifier: ContentClassifier;
+        detector: ProjectDetector;
+        distributor: ContentDistributor;
+        linker: CrossLinker;
+    };
+}
+/**
+ * Factory function to create sync orchestrator
+ */
+export declare function createIntelligentSync(options?: IntelligentSyncOptions): IntelligentLivingDocsSync;
+/**
+ * Convenience function to sync an increment
+ */
+export declare function syncIncrement(incrementId: string, options?: IntelligentSyncOptions): Promise<IntelligentSyncResult>;
+export * from './content-parser.js';
+export * from './content-classifier.js';
+export * from './project-detector.js';
+export * from './content-distributor.js';
+export * from './cross-linker.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,aAAa,EACb,UAAU,EAEV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EAErB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,eAAe,EACf,cAAc,EAEd,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAElB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,WAAW,EACX,SAAS,EAET,aAAa,EACd,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACxC,YAAY,EAAE,kBAAkB,CAAC;IACjC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,GAAE,sBAA2B;IAWhD;;OAEG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAyFxE;;OAEG;YACW,gBAAgB;IAiB9B;;OAEG;YACW,kBAAkB;IAmBhC;;OAEG;IACH,OAAO,CAAC,GAAG;IAMX;;OAEG;IACH,aAAa;;;;;;;CASd;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,yBAAyB,CAE3B;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CAGhC;AAGD,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,169 @@
+/**
+ * Intelligent Living Docs Sync - Main Orchestrator
+ *
+ * Coordinates all components for intelligent spec distribution.
+ *
+ * @module living-docs
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { createContentParser, } from './content-parser.js';
+import { createContentClassifier, } from './content-classifier.js';
+import { createProjectDetector, } from './project-detector.js';
+import { createContentDistributor, } from './content-distributor.js';
+import { createCrossLinker, } from './cross-linker.js';
+/**
+ * Intelligent Living Docs Sync Orchestrator
+ */
+export class IntelligentLivingDocsSync {
+    constructor(options = {}) {
+        this.options = options;
+        // Initialize components
+        this.parser = createContentParser(options.parser);
+        this.classifier = createContentClassifier();
+        this.detector = createProjectDetector(options.detector);
+        this.distributor = createContentDistributor(options.distributor);
+        this.linker = createCrossLinker(options.linker);
+    }
+    /**
+     * Sync increment spec to living docs
+     */
+    async syncIncrement(incrementId) {
+        const startTime = Date.now();
+        const errors = [];
+        try {
+            this.log(`🚀 Starting intelligent sync for increment: ${incrementId}`);
+            // 1. Load and parse spec
+            this.log('📖 Step 1: Parsing spec.md...');
+            const spec = await this.loadAndParseSpec(incrementId);
+            this.log(`   ✅ Parsed ${spec.sections.length} top-level sections`);
+            // 2. Classify sections
+            this.log('🔍 Step 2: Classifying sections...');
+            const flatSections = this.parser.flattenSections(spec.sections);
+            const classifications = this.classifier.classifyAll(flatSections);
+            const stats = this.classifier.getStatistics(classifications);
+            this.log(`   ✅ Classified ${classifications.length} sections`);
+            this.log(`      Average confidence: ${(stats.averageConfidence * 100).toFixed(1)}%`);
+            this.log(`      Low confidence (<60%): ${stats.lowConfidence}`);
+            // 3. Detect project
+            this.log('🎯 Step 3: Detecting project...');
+            const project = this.detector.detectProject(incrementId, spec);
+            this.log(`   ✅ Project: ${project.name} (${(project.confidence * 100).toFixed(1)}% confidence)`);
+            if (project.reasoning.length > 0) {
+                this.log(`      Reasoning: ${project.reasoning.join(', ')}`);
+            }
+            // 4. Ensure project structure exists
+            await this.detector.createProjectStructure(project.id);
+            // 5. Distribute content
+            this.log('📦 Step 4: Distributing content...');
+            const distribution = await this.distributor.distribute(incrementId, spec, classifications, project);
+            const distStats = this.distributor.getStatistics(distribution);
+            this.log(`   ✅ Distribution complete:`);
+            this.log(`      Created: ${distribution.summary.filesCreated} files`);
+            this.log(`      Updated: ${distribution.summary.filesUpdated} files`);
+            this.log(`      Skipped: ${distribution.summary.filesSkipped} files (unchanged)`);
+            this.log(`      Errors: ${distribution.summary.errors}`);
+            this.log(`      Total size: ${(distStats.totalSize / 1024).toFixed(1)} KB`);
+            if (distribution.errors.length > 0) {
+                errors.push(...distribution.errors.map((e) => e.error));
+            }
+            // 6. Generate cross-links
+            this.log('🔗 Step 5: Generating cross-links...');
+            const links = await this.linker.generateLinks(distribution);
+            const linkStats = this.linker.getStatistics();
+            this.log(`   ✅ Generated ${links.length} cross-links`);
+            this.log(`      Bidirectional: ${linkStats.bidirectional}`);
+            this.log(`      By type: ${JSON.stringify(linkStats.byType)}`);
+            // 7. Generate index files
+            this.log('📑 Step 6: Generating index files...');
+            await this.generateIndexFiles(distribution, project.id);
+            this.log(`   ✅ Index files generated`);
+            const duration = Date.now() - startTime;
+            this.log(`✅ Intelligent sync complete in ${duration}ms`);
+            return {
+                incrementId,
+                project,
+                spec,
+                classifications,
+                distribution,
+                links,
+                duration,
+                success: distribution.errors.length === 0,
+                errors,
+            };
+        }
+        catch (error) {
+            errors.push(String(error));
+            const duration = Date.now() - startTime;
+            this.log(`❌ Intelligent sync failed: ${error}`);
+            throw new Error(`Intelligent sync failed: ${error}`);
+        }
+    }
+    /**
+     * Load and parse increment spec
+     */
+    async loadAndParseSpec(incrementId) {
+        const specPath = path.join(process.cwd(), '.specweave', 'increments', incrementId, 'spec.md');
+        if (!fs.existsSync(specPath)) {
+            throw new Error(`Spec not found: ${specPath}`);
+        }
+        const markdown = await fs.readFile(specPath, 'utf-8');
+        return this.parser.parse(markdown, specPath);
+    }
+    /**
+     * Generate index files for categories
+     */
+    async generateIndexFiles(distribution, projectId) {
+        const allFiles = [...distribution.created, ...distribution.updated];
+        const byCategory = new Map();
+        for (const file of allFiles) {
+            if (!byCategory.has(file.category)) {
+                byCategory.set(file.category, []);
+            }
+            byCategory.get(file.category).push(file);
+        }
+        for (const [category, files] of byCategory.entries()) {
+            await this.distributor.generateIndex(category, projectId, files);
+        }
+    }
+    /**
+     * Logging helper
+     */
+    log(message) {
+        if (this.options.verbose) {
+            console.log(message);
+        }
+    }
+    /**
+     * Get component instances (for testing/advanced usage)
+     */
+    getComponents() {
+        return {
+            parser: this.parser,
+            classifier: this.classifier,
+            detector: this.detector,
+            distributor: this.distributor,
+            linker: this.linker,
+        };
+    }
+}
+/**
+ * Factory function to create sync orchestrator
+ */
+export function createIntelligentSync(options) {
+    return new IntelligentLivingDocsSync(options);
+}
+/**
+ * Convenience function to sync an increment
+ */
+export async function syncIncrement(incrementId, options) {
+    const sync = createIntelligentSync(options);
+    return sync.syncIncrement(incrementId);
+}
+// Re-export all types and classes
+export * from './content-parser.js';
+export * from './content-classifier.js';
+export * from './project-detector.js';
+export * from './content-distributor.js';
+export * from './cross-linker.js';
+//# sourceMappingURL=index.js.map

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

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