specweave 0.17.6 → 0.17.8

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

@@ -0,0 +1,393 @@
+/**
+ * Content Classifier for Intelligent Living Docs Sync
+ *
+ * Classifies spec sections into content categories using heuristic rules.
+ *
+ * @module living-docs/content-classifier
+ */
+/**
+ * Content categories for classification
+ */
+export var ContentCategory;
+(function (ContentCategory) {
+    ContentCategory["UserStory"] = "user-story";
+    ContentCategory["NFR"] = "nfr";
+    ContentCategory["Architecture"] = "architecture";
+    ContentCategory["ADR"] = "adr";
+    ContentCategory["Operations"] = "operations";
+    ContentCategory["Delivery"] = "delivery";
+    ContentCategory["Strategy"] = "strategy";
+    ContentCategory["Governance"] = "governance";
+    ContentCategory["Overview"] = "overview";
+    ContentCategory["Unknown"] = "unknown";
+})(ContentCategory || (ContentCategory = {}));
+/**
+ * Content Classifier class
+ */
+export class ContentClassifier {
+    constructor() {
+        this.rules = this.initializeRules();
+    }
+    /**
+     * Initialize classification rules
+     */
+    initializeRules() {
+        return [
+            // User Story Rules (High confidence patterns)
+            {
+                category: ContentCategory.UserStory,
+                weight: 0.9,
+                matcher: (section) => /^(US|User Story|Story)[-\s]*\d+/i.test(section.heading),
+                description: 'Heading starts with US-XXX or User Story XXX',
+            },
+            {
+                category: ContentCategory.UserStory,
+                weight: 0.8,
+                matcher: (section) => /as a|I want|so that/i.test(section.content),
+                description: 'Contains user story format (As a... I want... So that...)',
+            },
+            {
+                category: ContentCategory.UserStory,
+                weight: 0.7,
+                matcher: (section) => /acceptance criteria|ac-|given.*when.*then/i.test(section.content),
+                description: 'Contains acceptance criteria or Given/When/Then',
+            },
+            // NFR Rules
+            {
+                category: ContentCategory.NFR,
+                weight: 0.9,
+                matcher: (section) => /^(NFR|Non-Functional Requirement)[-\s]*\d+/i.test(section.heading),
+                description: 'Heading starts with NFR-XXX',
+            },
+            {
+                category: ContentCategory.NFR,
+                weight: 0.8,
+                matcher: (section) => /performance|latency|throughput|scalability|availability|reliability/i.test(section.content),
+                description: 'Contains NFR keywords (performance, scalability, etc.)',
+            },
+            {
+                category: ContentCategory.NFR,
+                weight: 0.7,
+                matcher: (section) => /<\d+\s*(ms|sec|min)|>\d+\s*(req\/s|users|concurrent)/i.test(section.content),
+                description: 'Contains quantitative metrics (<30s, >1000 req/s)',
+            },
+            // Architecture Rules
+            {
+                category: ContentCategory.Architecture,
+                weight: 0.9,
+                matcher: (section) => /^(Architecture|System Design|Component Design|Data Model|HLD|LLD)/i.test(section.heading),
+                description: 'Heading indicates architecture',
+            },
+            {
+                category: ContentCategory.Architecture,
+                weight: 0.8,
+                matcher: (section) => /component|service|module|class diagram|sequence diagram|entity relationship/i.test(section.content),
+                description: 'Contains architecture terms',
+            },
+            {
+                category: ContentCategory.Architecture,
+                weight: 0.7,
+                matcher: (section) => section.codeBlocks.some((block) => block.language === 'mermaid' || block.language === 'plantuml'),
+                description: 'Contains diagram code blocks',
+            },
+            // ADR Rules
+            {
+                category: ContentCategory.ADR,
+                weight: 0.95,
+                matcher: (section) => /^ADR[-\s]*\d+/i.test(section.heading),
+                description: 'Heading starts with ADR-XXX',
+            },
+            {
+                category: ContentCategory.ADR,
+                weight: 0.9,
+                matcher: (section) => /^(Decision|Technical Decision|Architecture Decision)/i.test(section.heading) &&
+                    /context|decision|consequences|alternatives|status/i.test(section.content),
+                description: 'Contains ADR structure (context, decision, consequences)',
+            },
+            {
+                category: ContentCategory.ADR,
+                weight: 0.7,
+                matcher: (section) => /why we chose|alternatives considered|trade-?offs/i.test(section.content),
+                description: 'Contains decision rationale keywords',
+            },
+            // Operations Rules
+            {
+                category: ContentCategory.Operations,
+                weight: 0.9,
+                matcher: (section) => /^(Runbook|SLO|SLI|Monitoring|Alerting|Incident|Operations)/i.test(section.heading),
+                description: 'Heading indicates operations',
+            },
+            {
+                category: ContentCategory.Operations,
+                weight: 0.8,
+                matcher: (section) => /incident response|on-?call|escalation|monitoring|alerting|slo|sli/i.test(section.content),
+                description: 'Contains operations keywords',
+            },
+            {
+                category: ContentCategory.Operations,
+                weight: 0.7,
+                matcher: (section) => /step \d+|procedure|troubleshooting|diagnostic/i.test(section.content),
+                description: 'Contains runbook-style content',
+            },
+            // Delivery Rules
+            {
+                category: ContentCategory.Delivery,
+                weight: 0.9,
+                matcher: (section) => /^(Delivery|Release|Test Strategy|CI\/CD|Roadmap|Branch Strategy)/i.test(section.heading),
+                description: 'Heading indicates delivery process',
+            },
+            {
+                category: ContentCategory.Delivery,
+                weight: 0.8,
+                matcher: (section) => /test plan|test strategy|release plan|deployment|pipeline|continuous/i.test(section.content),
+                description: 'Contains delivery keywords',
+            },
+            {
+                category: ContentCategory.Delivery,
+                weight: 0.7,
+                matcher: (section) => /git flow|pull request|code review|merge strategy/i.test(section.content),
+                description: 'Contains development workflow terms',
+            },
+            // Strategy Rules
+            {
+                category: ContentCategory.Strategy,
+                weight: 0.9,
+                matcher: (section) => /^(Strategy|Vision|Business Case|PRD|Product Requirements|OKR)/i.test(section.heading),
+                description: 'Heading indicates strategy',
+            },
+            {
+                category: ContentCategory.Strategy,
+                weight: 0.8,
+                matcher: (section) => /business case|roi|market analysis|stakeholder|product vision/i.test(section.content),
+                description: 'Contains strategy keywords',
+            },
+            {
+                category: ContentCategory.Strategy,
+                weight: 0.7,
+                matcher: (section) => /objective|key result|okr|metric|success criteria/i.test(section.content),
+                description: 'Contains business metrics and objectives',
+            },
+            // Governance Rules
+            {
+                category: ContentCategory.Governance,
+                weight: 0.9,
+                matcher: (section) => /^(Security|Compliance|Coding Standards|Policy|Governance)/i.test(section.heading),
+                description: 'Heading indicates governance',
+            },
+            {
+                category: ContentCategory.Governance,
+                weight: 0.8,
+                matcher: (section) => /security policy|compliance|gdpr|hipaa|pci-?dss|soc 2/i.test(section.content),
+                description: 'Contains compliance keywords',
+            },
+            {
+                category: ContentCategory.Governance,
+                weight: 0.7,
+                matcher: (section) => /coding standard|style guide|convention|best practice/i.test(section.content),
+                description: 'Contains coding standards keywords',
+            },
+            // Overview Rules (Catch common overview sections)
+            {
+                category: ContentCategory.Overview,
+                weight: 0.8,
+                matcher: (section) => /^(Overview|Introduction|Summary|Executive Summary|Quick Overview)/i.test(section.heading),
+                description: 'Heading indicates overview/introduction',
+            },
+            {
+                category: ContentCategory.Overview,
+                weight: 0.6,
+                matcher: (section) => section.level === 2 && section.heading.toLowerCase().includes('overview'),
+                description: 'Top-level overview section',
+            },
+        ];
+    }
+    /**
+     * Classify a single section
+     */
+    classify(section) {
+        const scores = new Map();
+        const reasoning = [];
+        // Apply all rules and accumulate scores
+        for (const rule of this.rules) {
+            if (rule.matcher(section)) {
+                const currentScore = scores.get(rule.category) || 0;
+                scores.set(rule.category, currentScore + rule.weight);
+                reasoning.push(`[${rule.category}] ${rule.description}`);
+            }
+        }
+        // Find category with highest score
+        let maxScore = 0;
+        let bestCategory = ContentCategory.Unknown;
+        for (const [category, score] of scores.entries()) {
+            if (score > maxScore) {
+                maxScore = score;
+                bestCategory = category;
+            }
+        }
+        // Normalize confidence (cap at 1.0)
+        const confidence = Math.min(maxScore, 1.0);
+        // Generate suggested filename and path
+        const { filename, path } = this.suggestFileLocation(section, bestCategory);
+        return {
+            category: bestCategory,
+            confidence,
+            reasoning,
+            suggestedFilename: filename,
+            suggestedPath: path,
+            metadata: {
+                heading: section.heading,
+                level: section.level,
+                contentLength: section.content.length,
+                hasCodeBlocks: section.codeBlocks.length > 0,
+                hasLinks: section.links.length > 0,
+            },
+        };
+    }
+    /**
+     * Classify multiple sections
+     */
+    classifyAll(sections) {
+        return sections.map((section) => this.classify(section));
+    }
+    /**
+     * Suggest file location based on category
+     */
+    suggestFileLocation(section, category) {
+        const slug = this.slugify(section.heading);
+        switch (category) {
+            case ContentCategory.UserStory: {
+                // Extract US ID if present (e.g., "US-016-001" → "us-016-001")
+                const usMatch = section.heading.match(/US[-\s]*(\d+[-\s]*\d+)/i);
+                const filename = usMatch
+                    ? `us-${usMatch[1].replace(/\s+/g, '-')}.md`
+                    : `us-${slug}.md`;
+                return { filename, path: 'specs/{project}' };
+            }
+            case ContentCategory.NFR: {
+                const nfrMatch = section.heading.match(/NFR[-\s]*(\d+[-\s]*\d+)/i);
+                const filename = nfrMatch
+                    ? `nfr-${nfrMatch[1].replace(/\s+/g, '-')}.md`
+                    : `nfr-${slug}.md`;
+                return { filename, path: 'specs/{project}' };
+            }
+            case ContentCategory.Architecture: {
+                const isHLD = /high-?level|hld|system/i.test(section.heading);
+                const isLLD = /low-?level|lld|component/i.test(section.heading);
+                const prefix = isHLD ? 'hld' : isLLD ? 'lld' : 'design';
+                return {
+                    filename: `${prefix}-${slug}.md`,
+                    path: 'architecture',
+                };
+            }
+            case ContentCategory.ADR: {
+                const adrMatch = section.heading.match(/ADR[-\s]*(\d+)/i);
+                const filename = adrMatch
+                    ? `${adrMatch[1].padStart(4, '0')}-${slug}.md`
+                    : `adr-${slug}.md`;
+                return { filename, path: 'architecture/adr' };
+            }
+            case ContentCategory.Operations: {
+                const isRunbook = /runbook/i.test(section.heading);
+                const isSLO = /slo|sli/i.test(section.heading);
+                const prefix = isRunbook ? 'runbook' : isSLO ? 'slo' : 'ops';
+                return {
+                    filename: `${prefix}-${slug}.md`,
+                    path: 'operations',
+                };
+            }
+            case ContentCategory.Delivery: {
+                const isRoadmap = /roadmap/i.test(section.heading);
+                const isTestStrategy = /test.*strategy/i.test(section.heading);
+                const prefix = isRoadmap ? 'roadmap' : isTestStrategy ? 'test-strategy' : 'delivery';
+                return {
+                    filename: `${prefix}-${slug}.md`,
+                    path: 'delivery',
+                };
+            }
+            case ContentCategory.Strategy: {
+                const isPRD = /prd|product.*requirements/i.test(section.heading);
+                const prefix = isPRD ? 'prd' : 'strategy';
+                return {
+                    filename: `${prefix}-${slug}.md`,
+                    path: 'strategy',
+                };
+            }
+            case ContentCategory.Governance: {
+                const isSecurity = /security/i.test(section.heading);
+                const isCompliance = /compliance/i.test(section.heading);
+                const prefix = isSecurity
+                    ? 'security'
+                    : isCompliance
+                        ? 'compliance'
+                        : 'governance';
+                return {
+                    filename: `${prefix}-${slug}.md`,
+                    path: 'governance',
+                };
+            }
+            case ContentCategory.Overview: {
+                return {
+                    filename: `overview-${slug}.md`,
+                    path: 'specs/{project}',
+                };
+            }
+            default: {
+                return {
+                    filename: `${slug}.md`,
+                    path: 'specs/{project}',
+                };
+            }
+        }
+    }
+    /**
+     * Convert text to URL-safe slug
+     */
+    slugify(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^\w\s-]/g, '')
+            .replace(/\s+/g, '-')
+            .replace(/--+/g, '-')
+            .trim();
+    }
+    /**
+     * Get sections by category
+     */
+    filterByCategory(results, category) {
+        return results.filter((r) => r.category === category);
+    }
+    /**
+     * Get sections by minimum confidence
+     */
+    filterByConfidence(results, minConfidence) {
+        return results.filter((r) => r.confidence >= minConfidence);
+    }
+    /**
+     * Get statistics about classifications
+     */
+    getStatistics(results) {
+        const stats = {
+            total: results.length,
+            byCategory: {},
+            averageConfidence: 0,
+            lowConfidence: 0,
+        };
+        // Count by category
+        for (const result of results) {
+            stats.byCategory[result.category] = (stats.byCategory[result.category] || 0) + 1;
+        }
+        // Calculate average confidence
+        const totalConfidence = results.reduce((sum, r) => sum + r.confidence, 0);
+        stats.averageConfidence = totalConfidence / results.length;
+        // Count low confidence (<0.6)
+        stats.lowConfidence = results.filter((r) => r.confidence < 0.6).length;
+        return stats;
+    }
+}
+/**
+ * Factory function to create classifier
+ */
+export function createContentClassifier() {
+    return new ContentClassifier();
+}
+//# sourceMappingURL=content-classifier.js.map

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

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

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

@@ -0,0 +1,126 @@
+/**
+ * Content Distributor for Intelligent Living Docs Sync
+ *
+ * Distributes classified spec sections to appropriate folders with proper formatting.
+ *
+ * @module living-docs/content-distributor
+ */
+import { ParsedSpec } from './content-parser.js';
+import { ClassificationResult, ContentCategory } from './content-classifier.js';
+import { ProjectContext } from './project-detector.js';
+/**
+ * Distribution result
+ */
+export interface DistributionResult {
+    created: DistributedFile[];
+    updated: DistributedFile[];
+    skipped: DistributedFile[];
+    errors: DistributionError[];
+    summary: DistributionSummary;
+}
+/**
+ * Distributed file information
+ */
+export interface DistributedFile {
+    path: string;
+    category: ContentCategory;
+    size: number;
+    sections: number;
+}
+/**
+ * Distribution error
+ */
+export interface DistributionError {
+    section: string;
+    category: ContentCategory;
+    error: string;
+    path?: string;
+}
+/**
+ * Distribution summary statistics
+ */
+export interface DistributionSummary {
+    totalSections: number;
+    filesCreated: number;
+    filesUpdated: number;
+    filesSkipped: number;
+    errors: number;
+    byCategory: Record<ContentCategory, number>;
+}
+/**
+ * Distributor options
+ */
+export interface DistributorOptions {
+    basePath?: string;
+    generateFrontmatter?: boolean;
+    preserveOriginal?: boolean;
+    dryRun?: boolean;
+}
+/**
+ * Content Distributor class
+ */
+export declare class ContentDistributor {
+    private options;
+    constructor(options?: DistributorOptions);
+    /**
+     * Distribute parsed spec to appropriate locations
+     */
+    distribute(incrementId: string, spec: ParsedSpec, classifications: ClassificationResult[], project: ProjectContext): Promise<DistributionResult>;
+    /**
+     * Flatten nested sections
+     */
+    private flattenSections;
+    /**
+     * Group sections by destination file
+     */
+    private groupByFile;
+    /**
+     * Resolve file path with project
+     */
+    private resolvePath;
+    /**
+     * Write a file with grouped sections
+     */
+    private writeFile;
+    /**
+     * Generate file content with frontmatter and sections
+     */
+    private generateFileContent;
+    /**
+     * Generate Docusaurus frontmatter
+     */
+    private generateFrontmatter;
+    /**
+     * Generate description from sections
+     */
+    private generateDescription;
+    /**
+     * Archive original spec for reference
+     */
+    private archiveOriginalSpec;
+    /**
+     * Generate index file for a category
+     */
+    generateIndex(category: ContentCategory, projectId: string, files: DistributedFile[]): Promise<void>;
+    /**
+     * Get category display title
+     */
+    private getCategoryTitle;
+    /**
+     * Get distribution statistics
+     */
+    getStatistics(result: DistributionResult): {
+        totalFiles: number;
+        totalSize: number;
+        averageSize: number;
+        byCategory: Record<ContentCategory, {
+            files: number;
+            size: number;
+        }>;
+    };
+}
+/**
+ * Factory function to create distributor
+ */
+export declare function createContentDistributor(options?: DistributorOptions): ContentDistributor;
+//# sourceMappingURL=content-distributor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-distributor.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/content-distributor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAiB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAUD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAA+B;gBAElC,OAAO,GAAE,kBAAuB;IAU5C;;OAEG;IACG,UAAU,CACd,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,UAAU,EAChB,eAAe,EAAE,oBAAoB,EAAE,EACvC,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,kBAAkB,CAAC;IAoE9B;;OAEG;IACH,OAAO,CAAC,eAAe;IAavB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiCnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;YACW,SAAS;IA8DvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqC3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+C3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;YACW,mBAAmB;IAqBjC;;OAEG;IACG,aAAa,CACjB,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,eAAe,EAAE,GACvB,OAAO,CAAC,IAAI,CAAC;IA4BhB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,kBAAkB,GAAG;QACzC,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,eAAe,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACtE;CAqBF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,CAEzF"}