specweave 0.17.7 → 0.17.9

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

@@ -0,0 +1,339 @@
+/**
+ * Content Distributor for Intelligent Living Docs Sync
+ *
+ * Distributes classified spec sections to appropriate folders with proper formatting.
+ *
+ * @module living-docs/content-distributor
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { ContentCategory } from './content-classifier.js';
+/**
+ * Content Distributor class
+ */
+export class ContentDistributor {
+    constructor(options = {}) {
+        this.options = {
+            basePath: options.basePath || path.join(process.cwd(), '.specweave', 'docs', 'internal'),
+            generateFrontmatter: options.generateFrontmatter ?? true,
+            preserveOriginal: options.preserveOriginal ?? true,
+            dryRun: options.dryRun ?? false,
+        };
+    }
+    /**
+     * Distribute parsed spec to appropriate locations
+     */
+    async distribute(incrementId, spec, classifications, project) {
+        const result = {
+            created: [],
+            updated: [],
+            skipped: [],
+            errors: [],
+            summary: {
+                totalSections: classifications.length,
+                filesCreated: 0,
+                filesUpdated: 0,
+                filesSkipped: 0,
+                errors: 0,
+                byCategory: {},
+            },
+        };
+        // Pair sections with classifications
+        const classifiedSections = [];
+        const flatSections = this.flattenSections(spec.sections);
+        for (let i = 0; i < Math.min(flatSections.length, classifications.length); i++) {
+            classifiedSections.push({
+                section: flatSections[i],
+                classification: classifications[i],
+            });
+            // Count by category
+            const category = classifications[i].category;
+            result.summary.byCategory[category] = (result.summary.byCategory[category] || 0) + 1;
+        }
+        // Group sections by category and file
+        const fileGroups = this.groupByFile(classifiedSections, project);
+        // Write each file group
+        for (const [filePath, group] of fileGroups.entries()) {
+            try {
+                const fileResult = await this.writeFile(incrementId, filePath, group, spec, project);
+                if (fileResult.status === 'created') {
+                    result.created.push(fileResult.file);
+                    result.summary.filesCreated++;
+                }
+                else if (fileResult.status === 'updated') {
+                    result.updated.push(fileResult.file);
+                    result.summary.filesUpdated++;
+                }
+                else if (fileResult.status === 'skipped') {
+                    result.skipped.push(fileResult.file);
+                    result.summary.filesSkipped++;
+                }
+            }
+            catch (error) {
+                result.errors.push({
+                    section: group.sections.map((s) => s.section.heading).join(', '),
+                    category: group.category,
+                    error: String(error),
+                    path: filePath,
+                });
+                result.summary.errors++;
+            }
+        }
+        // Preserve original spec if requested
+        if (this.options.preserveOriginal) {
+            await this.archiveOriginalSpec(incrementId, spec, project);
+        }
+        return result;
+    }
+    /**
+     * Flatten nested sections
+     */
+    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;
+    }
+    /**
+     * Group sections by destination file
+     */
+    groupByFile(classifiedSections, project) {
+        const groups = new Map();
+        for (const item of classifiedSections) {
+            const { classification } = item;
+            // Skip unknown categories
+            if (classification.category === ContentCategory.Unknown) {
+                continue;
+            }
+            // Resolve path with project
+            const filePath = this.resolvePath(classification.suggestedPath, classification.suggestedFilename, project);
+            if (!groups.has(filePath)) {
+                groups.set(filePath, {
+                    category: classification.category,
+                    sections: [],
+                });
+            }
+            groups.get(filePath).sections.push(item);
+        }
+        return groups;
+    }
+    /**
+     * Resolve file path with project
+     */
+    resolvePath(suggestedPath, filename, project) {
+        // Replace {project} placeholder
+        const pathWithProject = suggestedPath.replace('{project}', project.id);
+        return path.join(this.options.basePath, pathWithProject, filename);
+    }
+    /**
+     * Write a file with grouped sections
+     */
+    async writeFile(incrementId, filePath, group, spec, project) {
+        // Generate content
+        const content = this.generateFileContent(incrementId, group, spec, project);
+        // Check if file exists
+        const exists = fs.existsSync(filePath);
+        // In dry run mode, just return what would happen
+        if (this.options.dryRun) {
+            return {
+                status: exists ? 'updated' : 'created',
+                file: {
+                    path: filePath,
+                    category: group.category,
+                    size: content.length,
+                    sections: group.sections.length,
+                },
+            };
+        }
+        // Check if content changed
+        if (exists) {
+            const existingContent = await fs.readFile(filePath, 'utf-8');
+            if (existingContent === content) {
+                return {
+                    status: 'skipped',
+                    file: {
+                        path: filePath,
+                        category: group.category,
+                        size: content.length,
+                        sections: group.sections.length,
+                    },
+                };
+            }
+        }
+        // Ensure directory exists
+        await fs.ensureDir(path.dirname(filePath));
+        // Write file
+        await fs.writeFile(filePath, content, 'utf-8');
+        return {
+            status: exists ? 'updated' : 'created',
+            file: {
+                path: filePath,
+                category: group.category,
+                size: content.length,
+                sections: group.sections.length,
+            },
+        };
+    }
+    /**
+     * Generate file content with frontmatter and sections
+     */
+    generateFileContent(incrementId, group, spec, project) {
+        let content = '';
+        // Generate frontmatter
+        if (this.options.generateFrontmatter) {
+            content += this.generateFrontmatter(incrementId, group, spec, project);
+            content += '\n\n';
+        }
+        // Add sections
+        for (const item of group.sections) {
+            const { section } = item;
+            // Add heading
+            content += `${'#'.repeat(section.level)} ${section.heading}\n\n`;
+            // Add content
+            content += section.content;
+            // Add spacing between sections
+            content += '\n\n';
+        }
+        // Add footer
+        content += `---\n\n`;
+        content += `**Source**: [Increment ${incrementId}](../../../increments/${incrementId}/spec.md)\n`;
+        content += `**Project**: ${project.name}\n`;
+        content += `**Last Updated**: ${new Date().toISOString().split('T')[0]}\n`;
+        return content.trim() + '\n';
+    }
+    /**
+     * Generate Docusaurus frontmatter
+     */
+    generateFrontmatter(incrementId, group, spec, project) {
+        const firstSection = group.sections[0].section;
+        const title = firstSection.heading;
+        const category = group.category;
+        const frontmatter = {
+            id: firstSection.id,
+            title,
+            sidebar_label: title,
+            description: this.generateDescription(group.sections),
+            tags: [category, project.id, incrementId],
+            increment: incrementId,
+            project: project.id,
+            category,
+            last_updated: new Date().toISOString().split('T')[0],
+        };
+        // Add spec-specific fields
+        if (spec.frontmatter.priority) {
+            frontmatter.priority = spec.frontmatter.priority;
+        }
+        if (spec.frontmatter.status) {
+            frontmatter.status = spec.frontmatter.status;
+        }
+        // Convert to YAML
+        const yaml = Object.entries(frontmatter)
+            .map(([key, value]) => {
+            if (Array.isArray(value)) {
+                return `${key}: [${value.map((v) => `"${v}"`).join(', ')}]`;
+            }
+            else if (typeof value === 'string') {
+                return `${key}: "${value}"`;
+            }
+            else {
+                return `${key}: ${value}`;
+            }
+        })
+            .join('\n');
+        return `---\n${yaml}\n---`;
+    }
+    /**
+     * Generate description from sections
+     */
+    generateDescription(sections) {
+        const firstSection = sections[0].section;
+        const contentWithoutCode = firstSection.content.replace(/```[\s\S]*?```/g, '');
+        const firstParagraph = contentWithoutCode.split('\n\n')[0];
+        return firstParagraph.substring(0, 160).trim();
+    }
+    /**
+     * Archive original spec for reference
+     */
+    async archiveOriginalSpec(incrementId, spec, project) {
+        if (this.options.dryRun) {
+            return;
+        }
+        const archivePath = path.join(this.options.basePath, 'specs', project.id, '_archive', `spec-${incrementId}.md`);
+        await fs.ensureDir(path.dirname(archivePath));
+        await fs.writeFile(archivePath, spec.raw, 'utf-8');
+    }
+    /**
+     * Generate index file for a category
+     */
+    async generateIndex(category, projectId, files) {
+        if (this.options.dryRun) {
+            return;
+        }
+        const categoryPath = path.join(this.options.basePath, category === ContentCategory.UserStory || category === ContentCategory.NFR ? 'specs' : category, projectId);
+        const indexPath = path.join(categoryPath, 'README.md');
+        let content = `# ${this.getCategoryTitle(category)}\n\n`;
+        content += `**Project**: ${projectId}\n`;
+        content += `**Category**: ${category}\n`;
+        content += `**Files**: ${files.length}\n\n`;
+        content += `## Files\n\n`;
+        for (const file of files.sort((a, b) => a.path.localeCompare(b.path))) {
+            const filename = path.basename(file.path);
+            const title = filename.replace(/\.md$/, '').replace(/-/g, ' ');
+            content += `- [${title}](./${filename})\n`;
+        }
+        content += `\n---\n\n`;
+        content += `Generated by SpecWeave Intelligent Living Docs Sync\n`;
+        await fs.ensureDir(path.dirname(indexPath));
+        await fs.writeFile(indexPath, content, 'utf-8');
+    }
+    /**
+     * Get category display title
+     */
+    getCategoryTitle(category) {
+        const titles = {
+            [ContentCategory.UserStory]: 'User Stories',
+            [ContentCategory.NFR]: 'Non-Functional Requirements',
+            [ContentCategory.Architecture]: 'Architecture',
+            [ContentCategory.ADR]: 'Architecture Decision Records',
+            [ContentCategory.Operations]: 'Operations',
+            [ContentCategory.Delivery]: 'Delivery',
+            [ContentCategory.Strategy]: 'Strategy',
+            [ContentCategory.Governance]: 'Governance',
+            [ContentCategory.Overview]: 'Overview',
+            [ContentCategory.Unknown]: 'Uncategorized',
+        };
+        return titles[category] || category;
+    }
+    /**
+     * Get distribution statistics
+     */
+    getStatistics(result) {
+        const allFiles = [...result.created, ...result.updated, ...result.skipped];
+        const totalSize = allFiles.reduce((sum, f) => sum + f.size, 0);
+        const byCategory = {};
+        for (const file of allFiles) {
+            if (!byCategory[file.category]) {
+                byCategory[file.category] = { files: 0, size: 0 };
+            }
+            byCategory[file.category].files++;
+            byCategory[file.category].size += file.size;
+        }
+        return {
+            totalFiles: allFiles.length,
+            totalSize,
+            averageSize: totalSize / allFiles.length || 0,
+            byCategory,
+        };
+    }
+}
+/**
+ * Factory function to create distributor
+ */
+export function createContentDistributor(options) {
+    return new ContentDistributor(options);
+}
+//# sourceMappingURL=content-distributor.js.map

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

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

package/dist/src/core/living-docs/content-parser.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Content Parser for Intelligent Living Docs Sync
+ *
+ * Parses increment spec.md into structured sections for classification and distribution.
+ *
+ * @module living-docs/content-parser
+ */
+/**
+ * Represents a code block in the markdown
+ */
+export interface CodeBlock {
+    language: string;
+    content: string;
+    startLine: number;
+    endLine: number;
+}
+/**
+ * Represents a link in the markdown
+ */
+export interface Link {
+    text: string;
+    url: string;
+    type: 'internal' | 'external' | 'anchor';
+}
+/**
+ * Represents an image reference
+ */
+export interface Image {
+    alt: string;
+    url: string;
+    title?: string;
+}
+/**
+ * Represents a parsed section of the spec
+ */
+export interface ParsedSection {
+    id: string;
+    heading: string;
+    level: number;
+    content: string;
+    rawContent: string;
+    codeBlocks: CodeBlock[];
+    links: Link[];
+    images: Image[];
+    metadata?: Record<string, any>;
+    startLine: number;
+    endLine: number;
+    children: ParsedSection[];
+}
+/**
+ * Represents the complete parsed specification
+ */
+export interface ParsedSpec {
+    frontmatter: Record<string, any>;
+    sections: ParsedSection[];
+    raw: string;
+    filePath?: string;
+}
+/**
+ * Parser options
+ */
+export interface ParserOptions {
+    preserveCodeBlocks?: boolean;
+    preserveLinks?: boolean;
+    preserveImages?: boolean;
+    maxDepth?: number;
+    includeRawContent?: boolean;
+}
+/**
+ * Content Parser class
+ */
+export declare class ContentParser {
+    private options;
+    constructor(options?: ParserOptions);
+    /**
+     * Parse markdown content into structured sections
+     */
+    parse(markdown: string, filePath?: string): ParsedSpec;
+    /**
+     * Parse sections from lines array (recursive for nested sections)
+     */
+    private parseSections;
+    /**
+     * Build section hierarchy (nest sub-sections under parent sections)
+     */
+    private buildHierarchy;
+    /**
+     * Set raw content for sections (including nested children)
+     */
+    private setRawContent;
+    /**
+     * Generate raw content for a section (including nested children)
+     */
+    private generateRawContent;
+    /**
+     * Extract code blocks from content
+     */
+    private extractCodeBlocks;
+    /**
+     * Extract links from content
+     */
+    private extractLinks;
+    /**
+     * Extract images from content
+     */
+    private extractImages;
+    /**
+     * Determine link type (internal/external/anchor)
+     */
+    private determineLinkType;
+    /**
+     * Convert heading to URL-safe slug
+     */
+    private slugify;
+    /**
+     * Find section by ID (recursive search)
+     */
+    findSection(sections: ParsedSection[], id: string): ParsedSection | null;
+    /**
+     * Get all sections flattened (no hierarchy)
+     */
+    flattenSections(sections: ParsedSection[]): ParsedSection[];
+    /**
+     * Get sections by level
+     */
+    getSectionsByLevel(sections: ParsedSection[], level: number): ParsedSection[];
+    /**
+     * Get section content without code blocks
+     */
+    getContentWithoutCode(section: ParsedSection): string;
+}
+/**
+ * Factory function to create parser
+ */
+export declare function createContentParser(options?: ParserOptions): ContentParser;
+/**
+ * Convenience function to parse markdown
+ */
+export declare function parseMarkdown(markdown: string, options?: ParserOptions): ParsedSpec;
+//# sourceMappingURL=content-parser.d.ts.map

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

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