specweave 0.30.11 → 0.30.13

package/dist/src/living-docs/smart-doc-organizer.js

@@ -0,0 +1,535 @@
+/**
+ * Smart Documentation Organizer
+ *
+ * Intelligently organizes large documentation folders by:
+ * 1. Detecting themes from file content and titles
+ * 2. Generating themed category index files for navigation
+ * 3. Creating Docusaurus-compatible sidebar structures
+ * 4. Auto-organizing when folder exceeds threshold (default: 30 files)
+ *
+ * Philosophy: Generate indexes, don't move files (preserves URLs)
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { glob } from 'glob';
+import { consoleLogger } from '../utils/logger.js';
+// Theme definitions with keywords for detection
+const THEME_DEFINITIONS = [
+    {
+        id: 'sync',
+        name: 'Synchronization & Integration',
+        keywords: ['sync', 'integration', 'bidirectional', 'import', 'export', 'pull', 'push'],
+        icon: '🔄',
+    },
+    {
+        id: 'hooks',
+        name: 'Hooks & Events',
+        keywords: ['hook', 'event', 'trigger', 'callback', 'post-task', 'pre-tool', 'session'],
+        icon: '🪝',
+    },
+    {
+        id: 'github',
+        name: 'GitHub Integration',
+        keywords: ['github', 'gh-', 'issue', 'pull-request', 'pr-', 'actions', 'workflow'],
+        icon: '🐙',
+    },
+    {
+        id: 'external-tools',
+        name: 'External Tools (ADO, JIRA)',
+        keywords: ['jira', 'ado', 'azure-devops', 'external-tool', 'area-path', 'work-item', 'epic'],
+        icon: '🔌',
+    },
+    {
+        id: 'testing',
+        name: 'Testing & Quality',
+        keywords: ['test', 'fixture', 'mock', 'coverage', 'tdd', 'isolation', 'assertion', 'qa'],
+        icon: '🧪',
+    },
+    {
+        id: 'brownfield',
+        name: 'Brownfield & Migration',
+        keywords: ['brownfield', 'migration', 'legacy', 'onboard', 'existing', 'import'],
+        icon: '🏗️',
+    },
+    {
+        id: 'architecture',
+        name: 'Core Architecture',
+        keywords: ['pattern', 'factory', 'abstraction', 'layer', 'modular', 'structure', 'design'],
+        icon: '🏛️',
+    },
+    {
+        id: 'performance',
+        name: 'Performance & Optimization',
+        keywords: ['cache', 'performance', 'optimization', 'pagination', 'batch', 'lazy', 'ttl'],
+        icon: '⚡',
+    },
+    {
+        id: 'security',
+        name: 'Security & Permissions',
+        keywords: ['permission', 'security', 'gate', 'auth', 'token', 'secret', 'credential'],
+        icon: '🔒',
+    },
+    {
+        id: 'increments',
+        name: 'Increment Lifecycle',
+        keywords: ['increment', 'status', 'lifecycle', 'backlog', 'phase', 'workflow', 'completion'],
+        icon: '📦',
+    },
+    {
+        id: 'config',
+        name: 'Configuration & Setup',
+        keywords: ['config', 'env', 'setup', 'init', 'setting', 'option', 'parameter'],
+        icon: '⚙️',
+    },
+    {
+        id: 'docs',
+        name: 'Documentation & Living Docs',
+        keywords: ['doc', 'living', 'spec', 'readme', 'naming', 'convention', 'folder'],
+        icon: '📚',
+    },
+];
+/**
+ * Smart Documentation Organizer
+ */
+export class SmartDocOrganizer {
+    constructor(options) {
+        this.projectPath = options.projectPath;
+        this.logger = options.logger ?? consoleLogger;
+        this.threshold = options.thresholdForOrganization ?? 30;
+        this.generateIndexes = options.generateIndexes ?? true;
+        this.dryRun = options.dryRun ?? false;
+    }
+    /**
+     * Analyze a documentation folder and create organization plan
+     */
+    async analyzeFolder(folderPath) {
+        const absolutePath = path.isAbsolute(folderPath)
+            ? folderPath
+            : path.join(this.projectPath, folderPath);
+        if (!fs.existsSync(absolutePath)) {
+            throw new Error(`Folder not found: ${absolutePath}`);
+        }
+        // Get all markdown files (exclude index files we generate)
+        const files = await glob('*.md', {
+            cwd: absolutePath,
+            nodir: true,
+            ignore: ['README.md', '_index-*.md', 'category-*.md'],
+        });
+        this.logger.info(`Analyzing ${files.length} files in ${folderPath}`);
+        // Classify each file by theme
+        const themedFiles = [];
+        for (const file of files) {
+            const fullPath = path.join(absolutePath, file);
+            const themed = await this.classifyFile(fullPath);
+            themedFiles.push(themed);
+        }
+        // Group by theme
+        const themeCategories = this.groupByTheme(themedFiles);
+        // Identify uncategorized files
+        const uncategorized = themedFiles.filter(f => f.primaryTheme === 'uncategorized');
+        // Determine if organization is needed
+        const needsOrganization = files.length > this.threshold;
+        // Generate suggested indexes
+        const suggestedIndexes = themeCategories
+            .filter(tc => tc.count >= 3) // Only suggest for themes with 3+ files
+            .map(tc => `_index-${tc.theme.id}.md`);
+        return {
+            folder: folderPath,
+            totalFiles: files.length,
+            themeCategories,
+            uncategorized,
+            suggestedIndexes,
+            needsOrganization,
+        };
+    }
+    /**
+     * Classify a file by detecting themes from content and filename
+     */
+    async classifyFile(filePath) {
+        const fileName = path.basename(filePath, '.md');
+        const stats = fs.statSync(filePath);
+        let content = '';
+        let title = fileName;
+        try {
+            content = fs.readFileSync(filePath, 'utf-8');
+            // Extract title from first heading
+            const titleMatch = content.match(/^#\s+(.+)$/m);
+            if (titleMatch) {
+                title = titleMatch[1].replace(/^ADR-\d+:\s*/, ''); // Remove ADR prefix
+            }
+        }
+        catch {
+            // Skip files that can't be read
+        }
+        // Combine filename and content for theme detection
+        const searchText = `${fileName} ${title} ${content}`.toLowerCase();
+        // Score each theme
+        const themeScores = [];
+        for (const theme of THEME_DEFINITIONS) {
+            let score = 0;
+            for (const keyword of theme.keywords) {
+                // Count keyword occurrences
+                const regex = new RegExp(keyword, 'gi');
+                const matches = searchText.match(regex);
+                if (matches) {
+                    score += matches.length;
+                    // Boost score if keyword in filename
+                    if (fileName.toLowerCase().includes(keyword)) {
+                        score += 5;
+                    }
+                    // Boost score if keyword in title
+                    if (title.toLowerCase().includes(keyword)) {
+                        score += 3;
+                    }
+                }
+            }
+            if (score > 0) {
+                themeScores.push({ theme, score });
+            }
+        }
+        // Sort by score descending
+        themeScores.sort((a, b) => b.score - a.score);
+        // Get primary theme and all matching themes
+        const themes = themeScores.slice(0, 3).map(ts => ts.theme.id);
+        const primaryTheme = themes[0] ?? 'uncategorized';
+        return {
+            path: filePath,
+            name: fileName,
+            title,
+            themes,
+            primaryTheme,
+            lastModified: stats.mtime,
+        };
+    }
+    /**
+     * Group files by their primary theme
+     */
+    groupByTheme(files) {
+        const themeMap = new Map();
+        for (const file of files) {
+            const theme = file.primaryTheme;
+            if (!themeMap.has(theme)) {
+                themeMap.set(theme, []);
+            }
+            themeMap.get(theme).push(file);
+        }
+        const categories = [];
+        for (const [themeId, themeFiles] of themeMap) {
+            if (themeId === 'uncategorized')
+                continue;
+            const themeDef = THEME_DEFINITIONS.find(t => t.id === themeId);
+            if (themeDef) {
+                categories.push({
+                    theme: themeDef,
+                    files: themeFiles.sort((a, b) => a.name.localeCompare(b.name)),
+                    count: themeFiles.length,
+                });
+            }
+        }
+        // Sort by count descending
+        return categories.sort((a, b) => b.count - a.count);
+    }
+    /**
+     * Generate themed index files for Docusaurus navigation
+     */
+    async generateCategoryIndexes(plan) {
+        if (!plan.needsOrganization && !this.generateIndexes) {
+            return [];
+        }
+        const generatedFiles = [];
+        const folderPath = path.isAbsolute(plan.folder)
+            ? plan.folder
+            : path.join(this.projectPath, plan.folder);
+        // Generate main category index
+        const mainIndexPath = path.join(folderPath, '_categories.md');
+        const mainIndexContent = this.generateMainCategoryIndex(plan);
+        if (!this.dryRun) {
+            fs.writeFileSync(mainIndexPath, mainIndexContent);
+            this.logger.info(`Generated: ${mainIndexPath}`);
+        }
+        generatedFiles.push(mainIndexPath);
+        // Generate individual theme indexes
+        for (const category of plan.themeCategories) {
+            if (category.count < 3)
+                continue; // Skip themes with too few files
+            const indexPath = path.join(folderPath, `_index-${category.theme.id}.md`);
+            const indexContent = this.generateThemeIndex(category, plan.folder);
+            if (!this.dryRun) {
+                fs.writeFileSync(indexPath, indexContent);
+                this.logger.info(`Generated: ${indexPath}`);
+            }
+            generatedFiles.push(indexPath);
+        }
+        return generatedFiles;
+    }
+    /**
+     * Generate main category index with links to themed indexes
+     */
+    generateMainCategoryIndex(plan) {
+        const lines = [];
+        const folderName = path.basename(plan.folder);
+        lines.push('---');
+        lines.push('sidebar_position: 1');
+        lines.push(`title: "${this.formatTitle(folderName)} by Category"`);
+        lines.push('---');
+        lines.push('');
+        lines.push(`# ${this.formatTitle(folderName)} by Category`);
+        lines.push('');
+        lines.push(`This folder contains **${plan.totalFiles}** documents organized into the following categories:`);
+        lines.push('');
+        // Category table
+        lines.push('| Category | Count | Description |');
+        lines.push('|----------|-------|-------------|');
+        for (const category of plan.themeCategories) {
+            if (category.count < 3)
+                continue;
+            const link = `[${category.theme.icon} ${category.theme.name}](./_index-${category.theme.id}.md)`;
+            lines.push(`| ${link} | ${category.count} | View all ${category.theme.name.toLowerCase()} documents |`);
+        }
+        // Uncategorized section
+        if (plan.uncategorized.length > 0) {
+            lines.push(`| 📄 Other | ${plan.uncategorized.length} | Documents not matching specific themes |`);
+        }
+        lines.push('');
+        lines.push('## Quick Stats');
+        lines.push('');
+        lines.push(`- **Total Documents**: ${plan.totalFiles}`);
+        lines.push(`- **Categorized**: ${plan.totalFiles - plan.uncategorized.length}`);
+        lines.push(`- **Categories**: ${plan.themeCategories.filter(c => c.count >= 3).length}`);
+        lines.push('');
+        // Recent documents
+        const allFiles = plan.themeCategories.flatMap(c => c.files);
+        const recent = allFiles
+            .sort((a, b) => b.lastModified.getTime() - a.lastModified.getTime())
+            .slice(0, 5);
+        if (recent.length > 0) {
+            lines.push('## Recently Updated');
+            lines.push('');
+            for (const file of recent) {
+                const themeDef = THEME_DEFINITIONS.find(t => t.id === file.primaryTheme);
+                const icon = themeDef?.icon ?? '📄';
+                lines.push(`- ${icon} [${file.title}](./${file.name}.md) - ${file.lastModified.toLocaleDateString()}`);
+            }
+            lines.push('');
+        }
+        lines.push('---');
+        lines.push('*Auto-generated by SmartDocOrganizer*');
+        return lines.join('\n');
+    }
+    /**
+     * Generate themed index with all files in that category
+     */
+    generateThemeIndex(category, folderPath) {
+        const lines = [];
+        lines.push('---');
+        lines.push('sidebar_position: 2');
+        lines.push(`title: "${category.theme.icon} ${category.theme.name}"`);
+        lines.push('---');
+        lines.push('');
+        lines.push(`# ${category.theme.icon} ${category.theme.name}`);
+        lines.push('');
+        lines.push(`**${category.count}** documents in this category.`);
+        lines.push('');
+        // Group by sub-theme if many files
+        if (category.count > 15) {
+            // Further sub-group by first keyword match
+            const subGroups = this.subGroupByKeyword(category.files, category.theme);
+            for (const [subGroup, files] of subGroups) {
+                if (files.length > 0) {
+                    lines.push(`## ${subGroup}`);
+                    lines.push('');
+                    for (const file of files) {
+                        lines.push(`- [${file.title}](./${file.name}.md)`);
+                    }
+                    lines.push('');
+                }
+            }
+        }
+        else {
+            // Simple list
+            lines.push('## Documents');
+            lines.push('');
+            for (const file of category.files) {
+                const date = file.lastModified.toLocaleDateString();
+                lines.push(`- [${file.title}](./${file.name}.md) *(${date})*`);
+            }
+            lines.push('');
+        }
+        lines.push('---');
+        lines.push(`[← Back to Categories](./_categories.md)`);
+        return lines.join('\n');
+    }
+    /**
+     * Sub-group files by keyword for large categories
+     */
+    subGroupByKeyword(files, theme) {
+        const groups = new Map();
+        // Initialize groups for main keywords
+        const mainKeywords = theme.keywords.slice(0, 4);
+        for (const kw of mainKeywords) {
+            groups.set(this.formatTitle(kw), []);
+        }
+        groups.set('Other', []);
+        for (const file of files) {
+            const content = `${file.name} ${file.title}`.toLowerCase();
+            let assigned = false;
+            for (const kw of mainKeywords) {
+                if (content.includes(kw)) {
+                    groups.get(this.formatTitle(kw)).push(file);
+                    assigned = true;
+                    break;
+                }
+            }
+            if (!assigned) {
+                groups.get('Other').push(file);
+            }
+        }
+        // Remove empty groups
+        for (const [key, value] of groups) {
+            if (value.length === 0) {
+                groups.delete(key);
+            }
+        }
+        return groups;
+    }
+    /**
+     * Format string to title case, preserving known acronyms
+     */
+    formatTitle(str) {
+        const acronyms = ['adr', 'api', 'cli', 'hld', 'tdd', 'ado', 'pr', 'ci', 'cd', 'url', 'jwt', 'iac', 'sla', 'slo'];
+        return str
+            .replace(/[-_]/g, ' ')
+            .split(' ')
+            .map(word => {
+            const lower = word.toLowerCase();
+            if (acronyms.includes(lower)) {
+                return word.toUpperCase();
+            }
+            return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+        })
+            .join(' ');
+    }
+    /**
+     * Update Docusaurus sidebar configuration
+     */
+    async updateDocusaurusSidebar(plans) {
+        const sidebarConfig = [];
+        for (const plan of plans) {
+            if (!plan.needsOrganization)
+                continue;
+            const folderName = path.basename(plan.folder);
+            const categoryItems = [];
+            // Add main categories index first
+            categoryItems.push({
+                type: 'doc',
+                id: `${folderName}/_categories`,
+                label: '📚 Browse by Category',
+            });
+            // Add theme-specific indexes
+            for (const category of plan.themeCategories) {
+                if (category.count < 3)
+                    continue;
+                categoryItems.push({
+                    type: 'doc',
+                    id: `${folderName}/_index-${category.theme.id}`,
+                    label: `${category.theme.icon} ${category.theme.name}`,
+                });
+            }
+            // Add auto-generated items
+            categoryItems.push({
+                type: 'autogenerated',
+                dirName: folderName,
+            });
+            sidebarConfig.push({
+                type: 'category',
+                label: this.formatTitle(folderName),
+                items: categoryItems,
+            });
+        }
+        return JSON.stringify(sidebarConfig, null, 2);
+    }
+    /**
+     * Run full organization on internal docs
+     */
+    async organizeInternalDocs() {
+        const internalDocsPath = path.join(this.projectPath, '.specweave/docs/internal');
+        if (!fs.existsSync(internalDocsPath)) {
+            throw new Error('No .specweave/docs/internal directory found');
+        }
+        const plans = [];
+        const generatedFiles = [];
+        // Analyze key folders that might need organization
+        const foldersToAnalyze = [
+            'architecture/adr',
+            'architecture/hld',
+            'architecture/concepts',
+            'delivery/guides',
+            'operations',
+            'governance',
+        ];
+        for (const folder of foldersToAnalyze) {
+            const fullPath = path.join(internalDocsPath, folder);
+            if (!fs.existsSync(fullPath))
+                continue;
+            try {
+                const plan = await this.analyzeFolder(fullPath);
+                plans.push(plan);
+                if (plan.needsOrganization) {
+                    const files = await this.generateCategoryIndexes(plan);
+                    generatedFiles.push(...files);
+                }
+            }
+            catch (err) {
+                this.logger.warn(`Failed to analyze ${folder}: ${err}`);
+            }
+        }
+        // Generate summary
+        const summary = this.generateSummary(plans, generatedFiles);
+        return { plans, generatedFiles, summary };
+    }
+    /**
+     * Generate organization summary
+     */
+    generateSummary(plans, generatedFiles) {
+        const lines = [];
+        lines.push('# Documentation Organization Summary');
+        lines.push('');
+        const needsOrg = plans.filter(p => p.needsOrganization);
+        const totalFiles = plans.reduce((sum, p) => sum + p.totalFiles, 0);
+        lines.push(`- **Folders Analyzed**: ${plans.length}`);
+        lines.push(`- **Total Documents**: ${totalFiles}`);
+        lines.push(`- **Folders Needing Organization**: ${needsOrg.length}`);
+        lines.push(`- **Index Files Generated**: ${generatedFiles.length}`);
+        lines.push('');
+        if (needsOrg.length > 0) {
+            lines.push('## Organized Folders');
+            lines.push('');
+            for (const plan of needsOrg) {
+                lines.push(`### ${plan.folder}`);
+                lines.push(`- Files: ${plan.totalFiles}`);
+                lines.push(`- Categories: ${plan.themeCategories.filter(c => c.count >= 3).length}`);
+                lines.push('- Top themes:');
+                for (const cat of plan.themeCategories.slice(0, 5)) {
+                    lines.push(`  - ${cat.theme.icon} ${cat.theme.name}: ${cat.count} files`);
+                }
+                lines.push('');
+            }
+        }
+        lines.push('## Next Steps');
+        lines.push('');
+        lines.push('Run `/specweave-docs-preview:preview` to view the organized documentation.');
+        lines.push('');
+        return lines.join('\n');
+    }
+}
+/**
+ * Convenience function to organize docs
+ */
+export async function organizeDocumentation(projectPath, options) {
+    const organizer = new SmartDocOrganizer({
+        projectPath,
+        ...options,
+    });
+    return organizer.organizeInternalDocs();
+}
+//# sourceMappingURL=smart-doc-organizer.js.map

package/dist/src/living-docs/smart-doc-organizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-doc-organizer.js","sourceRoot":"","sources":["../../../src/living-docs/smart-doc-organizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAU,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE3D,gDAAgD;AAChD,MAAM,iBAAiB,GAAsB;IAC3C;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,+BAA+B;QACrC,QAAQ,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACtF,IAAI,EAAE,IAAI;KACX;IACD;QACE,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,gBAAgB;QACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC;QACtF,IAAI,EAAE,IAAI;KACX;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,CAAC;QAClF,IAAI,EAAE,IAAI;KACX;IACD;QACE,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,4BAA4B;QAClC,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,CAAC;QAC5F,IAAI,EAAE,IAAI;KACX;IACD;QACE,EAAE,EAAE,SAAS;QACb,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC;QACxF,IAAI,EAAE,IAAI;KACX;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,wBAAwB;QAC9B,QAAQ,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC;QAChF,IAAI,EAAE,KAAK;KACZ;IACD;QACE,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,mBAAmB;QACzB,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC;QAC1F,IAAI,EAAE,KAAK;KACZ;IACD;QACE,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,4BAA4B;QAClC,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC;QACxF,IAAI,EAAE,GAAG;KACV;IACD;QACE,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,wBAAwB;QAC9B,QAAQ,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAC;QACrF,IAAI,EAAE,IAAI;KACX;IACD;QACE,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC;QAC5F,IAAI,EAAE,IAAI;KACX;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,uBAAuB;QAC7B,QAAQ,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC;QAC9E,IAAI,EAAE,IAAI;KACX;IACD;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,6BAA6B;QACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,CAAC;QAC/E,IAAI,EAAE,IAAI;KACX;CACF,CAAC;AAyCF;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAO5B,YAAY,OAAiC;QAC3C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,wBAAwB,IAAI,EAAE,CAAC;QACxD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;QACvD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,UAAkB;QACpC,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAC9C,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAE5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,qBAAqB,YAAY,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,2DAA2D;QAC3D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE;YAC/B,GAAG,EAAE,YAAY;YACjB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,CAAC,WAAW,EAAE,aAAa,EAAE,eAAe,CAAC;SACtD,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,MAAM,aAAa,UAAU,EAAE,CAAC,CAAC;QAErE,8BAA8B;QAC9B,MAAM,WAAW,GAAiB,EAAE,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YACjD,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;QAED,iBAAiB;QACjB,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QAEvD,+BAA+B;QAC/B,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,eAAe,CAAC,CAAC;QAElF,sCAAsC;QACtC,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;QAExD,6BAA6B;QAC7B,MAAM,gBAAgB,GAAG,eAAe;aACrC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,wCAAwC;aACpE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QAEzC,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,eAAe;YACf,aAAa;YACb,gBAAgB;YAChB,iBAAiB;SAClB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CAAC,QAAgB;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEpC,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,KAAK,GAAG,QAAQ,CAAC;QAErB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC7C,mCAAmC;YACnC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;YAChD,IAAI,UAAU,EAAE,CAAC;gBACf,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB;YACzE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;QAED,mDAAmD;QACnD,MAAM,UAAU,GAAG,GAAG,QAAQ,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC;QAEnE,mBAAmB;QACnB,MAAM,WAAW,GAAgD,EAAE,CAAC;QAEpE,KAAK,MAAM,KAAK,IAAI,iBAAiB,EAAE,CAAC;YACtC,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACrC,4BAA4B;gBAC5B,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACxC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACxC,IAAI,OAAO,EAAE,CAAC;oBACZ,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;oBACxB,qCAAqC;oBACrC,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC7C,KAAK,IAAI,CAAC,CAAC;oBACb,CAAC;oBACD,kCAAkC;oBAClC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC1C,KAAK,IAAI,CAAC,CAAC;oBACb,CAAC;gBACH,CAAC;YACH,CAAC;YACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,WAAW,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAE9C,4CAA4C;QAC5C,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9D,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC;QAElD,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,QAAQ;YACd,KAAK;YACL,MAAM;YACN,YAAY;YACZ,YAAY,EAAE,KAAK,CAAC,KAAK;SAC1B,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,KAAmB;QACtC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;QAEjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC;YAChC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1B,CAAC;YACD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,UAAU,GAAoB,EAAE,CAAC;QAEvC,KAAK,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,QAAQ,EAAE,CAAC;YAC7C,IAAI,OAAO,KAAK,eAAe;gBAAE,SAAS;YAE1C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;YAC/D,IAAI,QAAQ,EAAE,CAAC;gBACb,UAAU,CAAC,IAAI,CAAC;oBACd,KAAK,EAAE,QAAQ;oBACf,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;oBAC9D,KAAK,EAAE,UAAU,CAAC,MAAM;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,uBAAuB,CAAC,IAAsB;QAClD,IAAI,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YACrD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,cAAc,GAAa,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;YAC7C,CAAC,CAAC,IAAI,CAAC,MAAM;YACb,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAE7C,+BAA+B;QAC/B,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAC9D,MAAM,gBAAgB,GAAG,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;QAE9D,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,aAAa,EAAE,CAAC,CAAC;QAClD,CAAC;QACD,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAEnC,oCAAoC;QACpC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,IAAI,QAAQ,CAAC,KAAK,GAAG,CAAC;gBAAE,SAAS,CAAC,iCAAiC;YAEnE,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;YAC1E,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAEpE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;gBAC1C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,SAAS,EAAE,CAAC,CAAC;YAC9C,CAAC;YACD,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,CAAC;QAED,OAAO,cAAc,CAAC;IACxB,CAAC;IAED;;OAEG;IACK,yBAAyB,CAAC,IAAsB;QACtD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE9C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,0BAA0B,IAAI,CAAC,UAAU,uDAAuD,CAAC,CAAC;QAC7G,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,iBAAiB;QACjB,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAEjD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC5C,IAAI,QAAQ,CAAC,KAAK,GAAG,CAAC;gBAAE,SAAS;YACjC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,cAAc,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YACjG,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,QAAQ,CAAC,KAAK,eAAe,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QAC1G,CAAC;QAED,wBAAwB;QACxB,IAAI,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,aAAa,CAAC,MAAM,6CAA6C,CAAC,CAAC;QACrG,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,0BAA0B,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACzF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,mBAAmB;QACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,QAAQ;aACpB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;aACnE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAEf,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,YAAY,CAAC,CAAC;gBACzE,MAAM,IAAI,GAAG,QAAQ,EAAE,IAAI,IAAI,IAAI,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;YACzG,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QAEpD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,QAAuB,EAAE,UAAkB;QACpE,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,KAAK,gCAAgC,CAAC,CAAC;QAChE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,mCAAmC;QACnC,IAAI,QAAQ,CAAC,KAAK,GAAG,EAAE,EAAE,CAAC;YACxB,2CAA2C;YAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEzE,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC;oBAC7B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;wBACzB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC;oBACrD,CAAC;oBACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,cAAc;YACd,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,kBAAkB,EAAE,CAAC;gBACpD,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,IAAI,UAAU,IAAI,IAAI,CAAC,CAAC;YACjE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;QAEvD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,iBAAiB,CACvB,KAAmB,EACnB,KAAsB;QAEtB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAwB,CAAC;QAE/C,sCAAsC;QACtC,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAExB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3D,IAAI,QAAQ,GAAG,KAAK,CAAC;YAErB,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;gBAC9B,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;oBACzB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC7C,QAAQ,GAAG,IAAI,CAAC;oBAChB,MAAM;gBACR,CAAC;YACH,CAAC;YAED,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,sBAAsB;QACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,GAAW;QAC7B,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAEjH,OAAO,GAAG;aACP,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;aACrB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,IAAI,CAAC,EAAE;YACV,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5B,CAAC;YACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACpE,CAAC,CAAC;aACD,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,uBAAuB,CAAC,KAAyB;QACrD,MAAM,aAAa,GAA8B,EAAE,CAAC;QAEpD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,iBAAiB;gBAAE,SAAS;YAEtC,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,aAAa,GAAc,EAAE,CAAC;YAEpC,kCAAkC;YAClC,aAAa,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,KAAK;gBACX,EAAE,EAAE,GAAG,UAAU,cAAc;gBAC/B,KAAK,EAAE,uBAAuB;aAC/B,CAAC,CAAC;YAEH,6BAA6B;YAC7B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC5C,IAAI,QAAQ,CAAC,KAAK,GAAG,CAAC;oBAAE,SAAS;gBAEjC,aAAa,CAAC,IAAI,CAAC;oBACjB,IAAI,EAAE,KAAK;oBACX,EAAE,EAAE,GAAG,UAAU,WAAW,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE;oBAC/C,KAAK,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE;iBACvD,CAAC,CAAC;YACL,CAAC;YAED,2BAA2B;YAC3B,aAAa,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,UAAU;aACpB,CAAC,CAAC;YAEH,aAAa,CAAC,IAAI,CAAC;gBACjB,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;gBACnC,KAAK,EAAE,aAAa;aACrB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB;QAKxB,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAC;QAEjF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,KAAK,GAAuB,EAAE,CAAC;QACrC,MAAM,cAAc,GAAa,EAAE,CAAC;QAEpC,mDAAmD;QACnD,MAAM,gBAAgB,GAAG;YACvB,kBAAkB;YAClB,kBAAkB;YAClB,uBAAuB;YACvB,iBAAiB;YACjB,YAAY;YACZ,YAAY;SACb,CAAC;QAEF,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;YACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAEvC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;gBAChD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEjB,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBAC3B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;oBACvD,cAAc,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAED,mBAAmB;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QAE5D,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,KAAyB,EAAE,cAAwB;QACzE,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAEnE,KAAK,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,uCAAuC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,gCAAgC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;QACpE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEf,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBACjC,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC1C,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;gBACrF,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;gBAE5B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBACnD,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,QAAQ,CAAC,CAAC;gBAC5E,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;QACzF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,WAAmB,EACnB,OAA2C;IAM3C,MAAM,SAAS,GAAG,IAAI,iBAAiB,CAAC;QACtC,WAAW;QACX,GAAG,OAAO;KACX,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC,oBAAoB,EAAE,CAAC;AAC1C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.30.11",
+  "version": "0.30.13",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/commands/specweave-archive.md

@@ -58,6 +58,36 @@ This command automatically synchronizes living docs by archiving features in:
 - `--archive-completed`: Archive all completed increments (use with caution!)
 - `--preserve-active`: Never archive active/paused increments (default: true)
 - `--dry-run`: Show what would be archived without moving files
+- `--external`: **Archive external living docs** (FS-XXXE folders imported from ADO/JIRA/GitHub)
+
+## NEW: External Living Docs Archiving (v0.30.12+)
+
+**CRITICAL POLICY**: External items (imported from ADO/JIRA/GitHub) are **NEVER auto-archived** during import. Archive is **USER-INITIATED ONLY** via the `--external` flag.
+
+External features are identified by the `E` suffix (e.g., `FS-001E`, `FS-042E`).
+
+### External Archive Usage
+
+```bash
+# Archive specific external features
+/specweave:archive --external FS-001E FS-002E
+
+# Archive external features older than 90 days
+/specweave:archive --external --older-than 90
+
+# Keep last 10 external features, archive the rest
+/specweave:archive --external --keep-last 10
+
+# Preview external archive (dry run)
+/specweave:archive --external --dry-run --keep-last 5
+```
+
+### Why Separate External Archiving?
+
+1. **Increments are source of truth** for new features you create
+2. **External imports are READ-ONLY references** - they track work in external tools
+3. **Different lifecycles** - increments close when work is done, external items may stay open indefinitely
+4. **Prevent accidental archiving** - external items should only be archived when YOU decide
 
 ## CRITICAL SAFETY FEATURE
 
@@ -298,11 +328,48 @@ import { Task } from '@claude/types';
 const task = new Task('archive-increments', 'Archive completed increments');
 
 task.run(async () => {
+  // Parse arguments
+  const args = process.argv.slice(2);
+  const isExternalMode = args.includes('--external');
+
+  // ================================================================
+  // EXTERNAL MODE: Archive external living docs (FS-XXXE folders)
+  // ================================================================
+  if (isExternalMode) {
+    const { FeatureArchiver } = await import('../../../dist/src/core/living-docs/feature-archiver.js');
+    const featureArchiver = new FeatureArchiver(process.cwd());
+
+    // Get feature IDs (non-flag arguments that match FS-*E pattern - external only)
+    // NOTE: Regex requires 'E' suffix to ensure only external features are targeted
+    const featureIds = args.filter(arg =>
+      !arg.startsWith('--') && /^FS-\d+E$/.test(arg)
+    );
+
+    const externalOptions = {
+      featureIds: featureIds.length > 0 ? featureIds : undefined,
+      olderThanDays: parseOption(args, '--older-than'),
+      keepLast: parseOption(args, '--keep-last'),
+      dryRun: args.includes('--dry-run'),
+      updateLinks: true
+    };
+
+    console.log('📦 External living docs archive mode');
+    const result = await featureArchiver.archiveExternalFeatures(externalOptions);
+
+    console.log(`\n✅ External archive complete:`);
+    console.log(`   Archived: ${result.archivedFeatures.length} features`);
+    if (result.errors.length > 0) {
+      console.log(`   Errors: ${result.errors.length}`);
+    }
+    return;
+  }
+
+  // ================================================================
+  // INCREMENT MODE: Archive completed increments (default)
+  // ================================================================
   const { IncrementArchiver } = await import('../../../dist/src/core/increment/increment-archiver.js');
   const archiver = new IncrementArchiver(process.cwd());
 
-  // Parse arguments
-  const args = process.argv.slice(2);
   const incrementIds = args.filter(arg => !arg.startsWith('--'));
 
   // Parse options