specweave 0.17.6 → 0.17.8

package/dist/src/core/living-docs/content-parser.js

@@ -0,0 +1,316 @@
+/**
+ * Content Parser for Intelligent Living Docs Sync
+ *
+ * Parses increment spec.md into structured sections for classification and distribution.
+ *
+ * @module living-docs/content-parser
+ */
+import matter from 'gray-matter';
+/**
+ * Content Parser class
+ */
+export class ContentParser {
+    constructor(options = {}) {
+        this.options = {
+            preserveCodeBlocks: options.preserveCodeBlocks ?? true,
+            preserveLinks: options.preserveLinks ?? true,
+            preserveImages: options.preserveImages ?? true,
+            maxDepth: options.maxDepth ?? 6,
+            includeRawContent: options.includeRawContent ?? true,
+        };
+    }
+    /**
+     * Parse markdown content into structured sections
+     */
+    parse(markdown, filePath) {
+        // 1. Extract frontmatter
+        const { data: frontmatter, content } = matter(markdown);
+        // 2. Split into lines for line number tracking
+        const lines = content.split('\n');
+        // 3. Parse sections
+        const sections = this.parseSections(lines, 0, lines.length);
+        return {
+            frontmatter,
+            sections,
+            raw: markdown,
+            filePath,
+        };
+    }
+    /**
+     * Parse sections from lines array (recursive for nested sections)
+     */
+    parseSections(lines, startIndex, endIndex, parentLevel = 0) {
+        const sections = [];
+        let currentSection = null;
+        let sectionContentLines = [];
+        let currentLine = startIndex;
+        while (currentLine < endIndex) {
+            const line = lines[currentLine];
+            const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+            if (headingMatch) {
+                const level = headingMatch[1].length;
+                // Only process headings at or below max depth
+                if (level <= this.options.maxDepth) {
+                    // Save previous section
+                    if (currentSection) {
+                        currentSection.content = sectionContentLines.join('\n').trim();
+                        currentSection.endLine = currentLine - 1;
+                        // Parse content elements
+                        if (this.options.preserveCodeBlocks) {
+                            currentSection.codeBlocks = this.extractCodeBlocks(currentSection.content);
+                        }
+                        if (this.options.preserveLinks) {
+                            currentSection.links = this.extractLinks(currentSection.content);
+                        }
+                        if (this.options.preserveImages) {
+                            currentSection.images = this.extractImages(currentSection.content);
+                        }
+                        sections.push(currentSection);
+                    }
+                    // Start new section
+                    const heading = headingMatch[2].trim();
+                    currentSection = {
+                        id: this.slugify(heading),
+                        heading,
+                        level,
+                        content: '',
+                        rawContent: '',
+                        codeBlocks: [],
+                        links: [],
+                        images: [],
+                        startLine: currentLine,
+                        endLine: currentLine,
+                        children: [],
+                    };
+                    sectionContentLines = [];
+                }
+            }
+            else if (currentSection) {
+                // Add line to current section content
+                sectionContentLines.push(line);
+            }
+            currentLine++;
+        }
+        // Save last section
+        if (currentSection) {
+            currentSection.content = sectionContentLines.join('\n').trim();
+            currentSection.endLine = endIndex - 1;
+            if (this.options.preserveCodeBlocks) {
+                currentSection.codeBlocks = this.extractCodeBlocks(currentSection.content);
+            }
+            if (this.options.preserveLinks) {
+                currentSection.links = this.extractLinks(currentSection.content);
+            }
+            if (this.options.preserveImages) {
+                currentSection.images = this.extractImages(currentSection.content);
+            }
+            sections.push(currentSection);
+        }
+        // Build hierarchy (nest sub-sections)
+        return this.buildHierarchy(sections);
+    }
+    /**
+     * Build section hierarchy (nest sub-sections under parent sections)
+     */
+    buildHierarchy(sections) {
+        const result = [];
+        const stack = [];
+        for (const section of sections) {
+            // Pop stack until we find a parent with lower level
+            while (stack.length > 0 && stack[stack.length - 1].level >= section.level) {
+                stack.pop();
+            }
+            if (stack.length === 0) {
+                // Top-level section
+                result.push(section);
+            }
+            else {
+                // Nested section - add to parent
+                const parent = stack[stack.length - 1];
+                parent.children.push(section);
+            }
+            stack.push(section);
+        }
+        // Set raw content for each section (including children)
+        this.setRawContent(result);
+        return result;
+    }
+    /**
+     * Set raw content for sections (including nested children)
+     */
+    setRawContent(sections) {
+        for (const section of sections) {
+            if (this.options.includeRawContent) {
+                section.rawContent = this.generateRawContent(section);
+            }
+            if (section.children.length > 0) {
+                this.setRawContent(section.children);
+            }
+        }
+    }
+    /**
+     * Generate raw content for a section (including nested children)
+     */
+    generateRawContent(section) {
+        let content = `${'#'.repeat(section.level)} ${section.heading}\n\n`;
+        content += section.content;
+        for (const child of section.children) {
+            content += '\n\n' + this.generateRawContent(child);
+        }
+        return content;
+    }
+    /**
+     * Extract code blocks from content
+     */
+    extractCodeBlocks(content) {
+        const codeBlocks = [];
+        const lines = content.split('\n');
+        let inCodeBlock = false;
+        let currentBlock = null;
+        lines.forEach((line, index) => {
+            const codeBlockStart = line.match(/^```(\w*)/);
+            const codeBlockEnd = line.match(/^```\s*$/);
+            if (codeBlockStart && !inCodeBlock) {
+                inCodeBlock = true;
+                currentBlock = {
+                    language: codeBlockStart[1] || 'text',
+                    lines: [],
+                    startLine: index,
+                };
+            }
+            else if (codeBlockEnd && inCodeBlock && currentBlock) {
+                inCodeBlock = false;
+                codeBlocks.push({
+                    language: currentBlock.language,
+                    content: currentBlock.lines.join('\n'),
+                    startLine: currentBlock.startLine,
+                    endLine: index,
+                });
+                currentBlock = null;
+            }
+            else if (inCodeBlock && currentBlock) {
+                currentBlock.lines.push(line);
+            }
+        });
+        return codeBlocks;
+    }
+    /**
+     * Extract links from content
+     */
+    extractLinks(content) {
+        const links = [];
+        // Markdown links: [text](url)
+        const markdownLinkRegex = /\[([^\]]+)\]\(([^)]+)\)/g;
+        let match;
+        while ((match = markdownLinkRegex.exec(content)) !== null) {
+            const [, text, url] = match;
+            links.push({
+                text,
+                url,
+                type: this.determineLinkType(url),
+            });
+        }
+        return links;
+    }
+    /**
+     * Extract images from content
+     */
+    extractImages(content) {
+        const images = [];
+        // Markdown images: ![alt](url "title")
+        const imageRegex = /!\[([^\]]*)\]\(([^)\s]+)(?:\s+"([^"]+)")?\)/g;
+        let match;
+        while ((match = imageRegex.exec(content)) !== null) {
+            const [, alt, url, title] = match;
+            images.push({
+                alt,
+                url,
+                title,
+            });
+        }
+        return images;
+    }
+    /**
+     * Determine link type (internal/external/anchor)
+     */
+    determineLinkType(url) {
+        if (url.startsWith('#')) {
+            return 'anchor';
+        }
+        else if (url.startsWith('http://') || url.startsWith('https://')) {
+            return 'external';
+        }
+        else {
+            return 'internal';
+        }
+    }
+    /**
+     * Convert heading to URL-safe slug
+     */
+    slugify(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^\w\s-]/g, '') // Remove special characters
+            .replace(/\s+/g, '-') // Replace spaces with hyphens
+            .replace(/--+/g, '-') // Replace multiple hyphens with single
+            .trim();
+    }
+    /**
+     * Find section by ID (recursive search)
+     */
+    findSection(sections, id) {
+        for (const section of sections) {
+            if (section.id === id) {
+                return section;
+            }
+            if (section.children.length > 0) {
+                const found = this.findSection(section.children, id);
+                if (found)
+                    return found;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get all sections flattened (no hierarchy)
+     */
+    flattenSections(sections) {
+        const result = [];
+        for (const section of sections) {
+            result.push(section);
+            if (section.children.length > 0) {
+                result.push(...this.flattenSections(section.children));
+            }
+        }
+        return result;
+    }
+    /**
+     * Get sections by level
+     */
+    getSectionsByLevel(sections, level) {
+        return this.flattenSections(sections).filter((s) => s.level === level);
+    }
+    /**
+     * Get section content without code blocks
+     */
+    getContentWithoutCode(section) {
+        let content = section.content;
+        // Remove code blocks
+        content = content.replace(/```[\s\S]*?```/g, '');
+        return content.trim();
+    }
+}
+/**
+ * Factory function to create parser
+ */
+export function createContentParser(options) {
+    return new ContentParser(options);
+}
+/**
+ * Convenience function to parse markdown
+ */
+export function parseMarkdown(markdown, options) {
+    const parser = new ContentParser(options);
+    return parser.parse(markdown);
+}
+//# sourceMappingURL=content-parser.js.map

package/dist/src/core/living-docs/content-parser.js.map

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

package/dist/src/core/living-docs/cross-linker.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Cross-Linker for Intelligent Living Docs Sync
+ *
+ * Generates cross-references between related documents for traceability.
+ *
+ * @module living-docs/cross-linker
+ */
+import { DistributionResult } from './content-distributor.js';
+/**
+ * Cross-link between documents
+ */
+export interface CrossLink {
+    source: string;
+    target: string;
+    type: LinkType;
+    description?: string;
+}
+/**
+ * Link types
+ */
+export declare enum LinkType {
+    Implements = "implements",// Spec implements architecture
+    DependsOn = "depends-on",// Operation depends on architecture
+    References = "references",// General reference
+    RelatedTo = "related-to",// Related content
+    DefinedIn = "defined-in",// Term/concept defined in another doc
+    TestsFor = "tests-for"
+}
+/**
+ * Linker options
+ */
+export interface LinkerOptions {
+    basePath?: string;
+    generateBacklinks?: boolean;
+    updateExisting?: boolean;
+    dryRun?: boolean;
+}
+/**
+ * Cross-Linker class
+ */
+export declare class CrossLinker {
+    private options;
+    private links;
+    constructor(options?: LinkerOptions);
+    /**
+     * Generate cross-links for distributed files
+     */
+    generateLinks(result: DistributionResult): Promise<CrossLink[]>;
+    /**
+     * Group files by category
+     */
+    private groupByCategory;
+    /**
+     * Generate links from specs to architecture
+     */
+    private generateArchitectureLinks;
+    /**
+     * Generate links from operations to architecture
+     */
+    private generateOperationsLinks;
+    /**
+     * Generate links from delivery to specs
+     */
+    private generateDeliveryLinks;
+    /**
+     * Generate links from strategy to specs
+     */
+    private generateStrategyLinks;
+    /**
+     * Check if two documents are related (heuristic)
+     */
+    private documentsRelated;
+    /**
+     * Generate backlinks (bidirectional)
+     */
+    private generateBacklinks;
+    /**
+     * Get reverse link type
+     */
+    private getReverseType;
+    /**
+     * Get reverse description
+     */
+    private getReverseDescription;
+    /**
+     * Update documents with generated links
+     */
+    private updateDocuments;
+    /**
+     * Update a single document with links
+     */
+    private updateDocument;
+    /**
+     * Generate markdown for links section
+     */
+    private generateLinksMarkdown;
+    /**
+     * Get link type display title
+     */
+    private getLinkTypeTitle;
+    /**
+     * Get relative path from source to target
+     */
+    private getRelativePath;
+    /**
+     * Get all links
+     */
+    getLinks(): CrossLink[];
+    /**
+     * Get links for a specific file
+     */
+    getLinksFor(filePath: string): CrossLink[];
+    /**
+     * Get statistics
+     */
+    getStatistics(): {
+        total: number;
+        byType: Record<LinkType, number>;
+        bidirectional: number;
+    };
+}
+/**
+ * Factory function to create linker
+ */
+export declare function createCrossLinker(options?: LinkerOptions): CrossLinker;
+//# sourceMappingURL=cross-linker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cross-linker.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/cross-linker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,kBAAkB,EAAmB,MAAM,0BAA0B,CAAC;AAG/E;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB,UAAU,eAAe,CAAO,+BAA+B;IAC/D,SAAS,eAAe,CAAQ,oCAAoC;IACpE,UAAU,eAAe,CAAO,oBAAoB;IACpD,SAAS,eAAe,CAAQ,kBAAkB;IAClD,SAAS,eAAe,CAAQ,sCAAsC;IACtE,QAAQ,cAAc;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,KAAK,CAAc;gBAEf,OAAO,GAAE,aAAkB;IAYvC;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAyBrE;;OAEG;IACH,OAAO,CAAC,eAAe;IAgBvB;;OAEG;YACW,yBAAyB;IAkCvC;;OAEG;YACW,uBAAuB;IAoBrC;;OAEG;YACW,qBAAqB;IAoBnC;;OAEG;YACW,qBAAqB;IAoBnC;;OAEG;YACW,gBAAgB;IAyC9B;;OAEG;YACW,iBAAiB;IAgB/B;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;YACW,eAAe;IAiB7B;;OAEG;YACW,cAAc;IAoC5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,QAAQ,IAAI,SAAS,EAAE;IAIvB;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;IAI1C;;OAEG;IACH,aAAa,IAAI;QACf,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACjC,aAAa,EAAE,MAAM,CAAC;KACvB;CAkBF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW,CAEtE"}