specweave 0.18.1 → 0.20.0

package/dist/src/core/living-docs/feature-id-manager.js

@@ -0,0 +1,339 @@
+/**
+ * Feature ID Manager - Manages FS-XXX ID assignment based on creation date
+ * Ensures no duplicate IDs and maintains consistent ordering
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import yaml from 'yaml';
+export class FeatureIDManager {
+    constructor(projectRoot) {
+        this.specsBaseDir = path.join(projectRoot, '.specweave/docs/internal/specs');
+        this.incrementsDir = path.join(projectRoot, '.specweave/increments');
+        this.registry = {
+            features: new Map(),
+            nextId: 1
+        };
+    }
+    /**
+     * Build registry by scanning all increments and existing features
+     */
+    async buildRegistry() {
+        console.log('🔍 Building feature registry...');
+        // Step 1: Scan all increments to find features
+        const incrementFeatures = await this.scanIncrements();
+        // Step 2: Scan existing _features folder (if any)
+        const existingFeatures = await this.scanExistingFeatures();
+        // Step 3: Merge and sort by creation date
+        const allFeatures = this.mergeFeatures(incrementFeatures, existingFeatures);
+        // Step 4: Assign FS-XXX IDs based on creation date order
+        this.assignFeatureIds(allFeatures);
+        console.log(`✅ Registry built with ${this.registry.features.size} features`);
+    }
+    /**
+     * Scan all increments to extract feature information
+     */
+    async scanIncrements() {
+        const features = [];
+        if (!await fs.pathExists(this.incrementsDir)) {
+            return features;
+        }
+        const increments = await fs.readdir(this.incrementsDir);
+        for (const incrementId of increments) {
+            if (!incrementId.match(/^\d{4}-/))
+                continue;
+            const specPath = path.join(this.incrementsDir, incrementId, 'spec.md');
+            const metadataPath = path.join(this.incrementsDir, incrementId, 'metadata.json');
+            if (!await fs.pathExists(specPath))
+                continue;
+            try {
+                const specContent = await fs.readFile(specPath, 'utf-8');
+                const frontmatter = this.extractFrontmatter(specContent);
+                // Get creation date from metadata or frontmatter
+                let created = new Date();
+                if (await fs.pathExists(metadataPath)) {
+                    const metadata = await fs.readJson(metadataPath);
+                    created = new Date(metadata.created || created);
+                }
+                else if (frontmatter.created) {
+                    created = new Date(frontmatter.created);
+                }
+                else {
+                    // Fallback: use file modification time
+                    const stats = await fs.stat(specPath);
+                    created = stats.birthtime || stats.mtime;
+                }
+                // Extract feature ID - CRITICAL LOGIC for greenfield vs brownfield
+                const match = incrementId.match(/^(\d{4})-(.+)$/);
+                let featureId = '';
+                if (match) {
+                    const num = parseInt(match[1], 10);
+                    // Check if brownfield (imported from external tool)
+                    const isBrownfield = frontmatter.source === 'external' ||
+                        frontmatter.imported === true;
+                    if (isBrownfield) {
+                        // Brownfield: Honor explicit feature ID from frontmatter
+                        featureId = frontmatter.feature || frontmatter.epic || '';
+                        // If still no feature ID, generate date-based one
+                        if (!featureId) {
+                            const yy = String(created.getFullYear()).slice(-2);
+                            const mm = String(created.getMonth() + 1).padStart(2, '0');
+                            const dd = String(created.getDate()).padStart(2, '0');
+                            featureId = `FS-${yy}-${mm}-${dd}-${match[2]}`;
+                        }
+                    }
+                    else {
+                        // Greenfield: ALWAYS use increment number (ignore frontmatter)
+                        // This ensures 0031 → FS-031 even if frontmatter says FS-25-11-12
+                        featureId = `FS-${String(num).padStart(3, '0')}`;
+                    }
+                }
+                if (featureId && !featureId.startsWith('EPIC')) {
+                    // Normalize feature ID format
+                    const normalizedId = this.normalizeFeatureId(featureId);
+                    features.push({
+                        originalId: normalizedId,
+                        assignedId: '', // Will be assigned later
+                        title: frontmatter.title || incrementId,
+                        created,
+                        incrementId,
+                        projects: frontmatter.projects || ['default']
+                    });
+                }
+            }
+            catch (error) {
+                console.warn(`  ⚠️ Error processing ${incrementId}: ${error}`);
+            }
+        }
+        return features;
+    }
+    /**
+     * Scan existing _features folder
+     */
+    async scanExistingFeatures() {
+        const features = [];
+        const featuresDir = path.join(this.specsBaseDir, '_features');
+        if (!await fs.pathExists(featuresDir)) {
+            return features;
+        }
+        const folders = await fs.readdir(featuresDir);
+        for (const folder of folders) {
+            const featurePath = path.join(featuresDir, folder, 'FEATURE.md');
+            if (!await fs.pathExists(featurePath))
+                continue;
+            try {
+                const content = await fs.readFile(featurePath, 'utf-8');
+                const frontmatter = this.extractFrontmatter(content);
+                const created = frontmatter.created
+                    ? new Date(frontmatter.created)
+                    : new Date();
+                features.push({
+                    originalId: folder,
+                    assignedId: '', // Will be assigned later
+                    title: frontmatter.title || folder,
+                    created,
+                    projects: frontmatter.projects || ['default']
+                });
+            }
+            catch (error) {
+                console.warn(`  ⚠️ Error processing feature ${folder}: ${error}`);
+            }
+        }
+        return features;
+    }
+    /**
+     * Merge features and remove duplicates
+     */
+    mergeFeatures(incrementFeatures, existingFeatures) {
+        const merged = new Map();
+        // Add increment features first (they have more complete info)
+        for (const feature of incrementFeatures) {
+            const key = this.getFeatureKey(feature.originalId);
+            if (!merged.has(key)) {
+                merged.set(key, feature);
+            }
+        }
+        // Add existing features if not already present
+        for (const feature of existingFeatures) {
+            const key = this.getFeatureKey(feature.originalId);
+            if (!merged.has(key)) {
+                merged.set(key, feature);
+            }
+        }
+        // Sort by creation date
+        return Array.from(merged.values()).sort((a, b) => a.created.getTime() - b.created.getTime());
+    }
+    /**
+     * Assign FS-XXX IDs based on strategy
+     *
+     * CRITICAL: For greenfield (FS-XXX), assigned ID = original ID
+     * For brownfield (FS-YY-MM-DD-name), assigned ID = sequential
+     */
+    assignFeatureIds(features) {
+        let nextId = 1;
+        for (const feature of features) {
+            // Check if this is a greenfield feature (FS-XXX format)
+            const isGreenfield = /^FS-\d{3}$/.test(feature.originalId);
+            if (isGreenfield) {
+                // Greenfield: Use the increment number as-is
+                feature.assignedId = feature.originalId; // FS-030 stays FS-030
+            }
+            else {
+                // Brownfield: Assign sequential ID
+                feature.assignedId = `FS-${String(nextId).padStart(3, '0')}`;
+                nextId++;
+            }
+            this.registry.features.set(feature.originalId, feature);
+        }
+        this.registry.nextId = nextId;
+    }
+    /**
+     * Get assigned ID for a feature
+     */
+    getAssignedId(originalId) {
+        const normalized = this.normalizeFeatureId(originalId);
+        const feature = this.registry.features.get(normalized);
+        if (feature) {
+            return feature.assignedId;
+        }
+        // Feature not in registry - assign new ID
+        console.log(`  📝 Assigning new ID for feature: ${originalId}`);
+        const assignedId = `FS-${String(this.registry.nextId).padStart(3, '0')}`;
+        this.registry.features.set(normalized, {
+            originalId: normalized,
+            assignedId,
+            title: originalId,
+            created: new Date(),
+            projects: ['default']
+        });
+        this.registry.nextId++;
+        return assignedId;
+    }
+    /**
+     * Check if a feature ID already exists
+     */
+    hasFeature(originalId) {
+        const normalized = this.normalizeFeatureId(originalId);
+        return this.registry.features.has(normalized);
+    }
+    /**
+     * Get all registered features
+     */
+    getAllFeatures() {
+        return Array.from(this.registry.features.values());
+    }
+    /**
+     * Normalize feature ID to consistent format
+     *
+     * CRITICAL: For greenfield, we use FS-XXX (sequential numbers)
+     * For brownfield, we use FS-YY-MM-DD-name (date-based)
+     */
+    normalizeFeatureId(id) {
+        // Remove any leading/trailing whitespace
+        id = id.trim();
+        // KEEP numeric IDs as-is for greenfield (FS-001, FS-030, FS-031, etc.)
+        // These come directly from increment numbers and should NOT be converted
+        const simpleNumMatch = id.match(/^FS-(\d{3})$/);
+        if (simpleNumMatch) {
+            return id; // Return as-is: FS-030, FS-031, etc.
+        }
+        // If it's already in date format (FS-YY-MM-DD-*), keep as-is
+        const dateMatch = id.match(/^FS-\d{2}-\d{2}-\d{2}-.+$/);
+        if (dateMatch) {
+            return id;
+        }
+        // Legacy: If it has a suffix (FS-031-feature-name), it's date-based
+        // This handles old IDs that need migration
+        const numMatchWithSuffix = id.match(/^FS-(\d+)-.+$/);
+        if (numMatchWithSuffix) {
+            // This is likely a date-based ID, keep as-is
+            return id;
+        }
+        return id;
+    }
+    /**
+     * Get a consistent key for feature deduplication
+     */
+    getFeatureKey(id) {
+        // Extract the core part of the ID for comparison
+        // FS-25-11-12-external-tool-sync -> external-tool-sync
+        const parts = id.split('-');
+        if (parts[0] === 'FS' && parts.length > 4) {
+            return parts.slice(4).join('-');
+        }
+        return id;
+    }
+    /**
+     * Extract frontmatter from markdown content
+     */
+    extractFrontmatter(content) {
+        const lines = content.split('\n');
+        if (lines[0] !== '---')
+            return {};
+        let endIndex = -1;
+        for (let i = 1; i < lines.length; i++) {
+            if (lines[i] === '---') {
+                endIndex = i;
+                break;
+            }
+        }
+        if (endIndex === -1)
+            return {};
+        try {
+            const yamlContent = lines.slice(1, endIndex).join('\n');
+            return yaml.parse(yamlContent) || {};
+        }
+        catch {
+            return {};
+        }
+    }
+    /**
+     * Save registry to disk for persistence
+     */
+    async saveRegistry() {
+        const registryPath = path.join(this.specsBaseDir, '.feature-registry.json');
+        const data = {
+            version: '1.0',
+            lastUpdated: new Date().toISOString(),
+            nextId: this.registry.nextId,
+            features: Array.from(this.registry.features.entries()).map(([key, value]) => ({
+                key,
+                ...value,
+                created: value.created.toISOString()
+            }))
+        };
+        await fs.ensureDir(path.dirname(registryPath));
+        await fs.writeJson(registryPath, data, { spaces: 2 });
+        console.log(`   💾 Registry saved to ${registryPath}`);
+    }
+    /**
+     * Load registry from disk
+     */
+    async loadRegistry() {
+        const registryPath = path.join(this.specsBaseDir, '.feature-registry.json');
+        if (!await fs.pathExists(registryPath)) {
+            await this.buildRegistry();
+            return;
+        }
+        try {
+            const data = await fs.readJson(registryPath);
+            this.registry.nextId = data.nextId || 1;
+            this.registry.features.clear();
+            for (const feature of data.features || []) {
+                this.registry.features.set(feature.key || feature.originalId, {
+                    originalId: feature.originalId,
+                    assignedId: feature.assignedId,
+                    title: feature.title,
+                    created: new Date(feature.created),
+                    incrementId: feature.incrementId,
+                    projects: feature.projects
+                });
+            }
+            console.log(`   📂 Registry loaded with ${this.registry.features.size} features`);
+        }
+        catch (error) {
+            console.warn('   ⚠️ Failed to load registry, rebuilding...');
+            await this.buildRegistry();
+        }
+    }
+}
+//# sourceMappingURL=feature-id-manager.js.map

package/dist/src/core/living-docs/feature-id-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-id-manager.js","sourceRoot":"","sources":["../../../../src/core/living-docs/feature-id-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,IAAI,MAAM,MAAM,CAAC;AAgBxB,MAAM,OAAO,gBAAgB;IAK3B,YAAY,WAAmB;QAC7B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gCAAgC,CAAC,CAAC;QAC7E,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ,GAAG;YACd,QAAQ,EAAE,IAAI,GAAG,EAAE;YACnB,MAAM,EAAE,CAAC;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,aAAa;QACxB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAE/C,+CAA+C;QAC/C,MAAM,iBAAiB,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAEtD,kDAAkD;QAClD,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAE3D,0CAA0C;QAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;QAE5E,yDAAyD;QACzD,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAEnC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC;IAC/E,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc;QAC1B,MAAM,QAAQ,GAAkB,EAAE,CAAC;QAEnC,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YAC7C,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAExD,KAAK,MAAM,WAAW,IAAI,UAAU,EAAE,CAAC;YACrC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC;gBAAE,SAAS;YAE5C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;YACvE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;YAEjF,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAE7C,IAAI,CAAC;gBACH,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACzD,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;gBAEzD,iDAAiD;gBACjD,IAAI,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;gBACzB,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;oBACtC,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;oBACjD,OAAO,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,CAAC;gBAClD,CAAC;qBAAM,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;oBAC/B,OAAO,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBAC1C,CAAC;qBAAM,CAAC;oBACN,uCAAuC;oBACvC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACtC,OAAO,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC;gBAC3C,CAAC;gBAED,mEAAmE;gBACnE,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;gBAClD,IAAI,SAAS,GAAG,EAAE,CAAC;gBAEnB,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAEnC,oDAAoD;oBACpD,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,KAAK,UAAU;wBACjC,WAAW,CAAC,QAAQ,KAAK,IAAI,CAAC;oBAEnD,IAAI,YAAY,EAAE,CAAC;wBACjB,yDAAyD;wBACzD,SAAS,GAAG,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,IAAI,IAAI,EAAE,CAAC;wBAE1D,kDAAkD;wBAClD,IAAI,CAAC,SAAS,EAAE,CAAC;4BACf,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;4BACnD,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;4BAC3D,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;4BACtD,SAAS,GAAG,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;wBACjD,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,+DAA+D;wBAC/D,kEAAkE;wBAClE,SAAS,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;oBACnD,CAAC;gBACH,CAAC;gBAED,IAAI,SAAS,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC/C,8BAA8B;oBAC9B,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC;oBAExD,QAAQ,CAAC,IAAI,CAAC;wBACZ,UAAU,EAAE,YAAY;wBACxB,UAAU,EAAE,EAAE,EAAE,yBAAyB;wBACzC,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,WAAW;wBACvC,OAAO;wBACP,WAAW;wBACX,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC;qBAC9C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,yBAAyB,WAAW,KAAK,KAAK,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,oBAAoB;QAChC,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QAE9D,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACtC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAE9C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;YAEjE,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;gBAAE,SAAS;YAEhD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBACxD,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;gBAErD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO;oBACjC,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;oBAC/B,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;gBAEf,QAAQ,CAAC,IAAI,CAAC;oBACZ,UAAU,EAAE,MAAM;oBAClB,UAAU,EAAE,EAAE,EAAE,yBAAyB;oBACzC,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,MAAM;oBAClC,OAAO;oBACP,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC;iBAC9C,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,iCAAiC,MAAM,KAAK,KAAK,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,aAAa,CACnB,iBAAgC,EAChC,gBAA+B;QAE/B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;QAE9C,8DAA8D;QAC9D,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,+CAA+C;QAC/C,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CACrC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CACpD,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,QAAuB;QAC9C,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,wDAAwD;YACxD,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAE3D,IAAI,YAAY,EAAE,CAAC;gBACjB,6CAA6C;gBAC7C,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,sBAAsB;YACjE,CAAC;iBAAM,CAAC;gBACN,mCAAmC;gBACnC,OAAO,CAAC,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC7D,MAAM,EAAE,CAAC;YACX,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;IAChC,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,UAAkB;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAEvD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC,UAAU,CAAC;QAC5B,CAAC;QAED,0CAA0C;QAC1C,OAAO,CAAC,GAAG,CAAC,sCAAsC,UAAU,EAAE,CAAC,CAAC;QAChE,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAEzE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE;YACrC,UAAU,EAAE,UAAU;YACtB,UAAU;YACV,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,IAAI,IAAI,EAAE;YACnB,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,UAAkB;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACI,cAAc;QACnB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACK,kBAAkB,CAAC,EAAU;QACnC,yCAAyC;QACzC,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;QAEf,uEAAuE;QACvE,yEAAyE;QACzE,MAAM,cAAc,GAAG,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAChD,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC,CAAC,qCAAqC;QAClD,CAAC;QAED,6DAA6D;QAC7D,MAAM,SAAS,GAAG,EAAE,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACxD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,oEAAoE;QACpE,2CAA2C;QAC3C,MAAM,kBAAkB,GAAG,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACrD,IAAI,kBAAkB,EAAE,CAAC;YACvB,6CAA6C;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,EAAU;QAC9B,iDAAiD;QACjD,uDAAuD;QACvD,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,OAAe;QACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK;YAAE,OAAO,EAAE,CAAC;QAElC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;QAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;gBACvB,QAAQ,GAAG,CAAC,CAAC;gBACb,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,QAAQ,KAAK,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QAE/B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY;QACvB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;QAE5E,MAAM,IAAI,GAAG;YACX,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;YAC5B,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC5E,GAAG;gBACH,GAAG,KAAK;gBACR,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE;aACrC,CAAC,CAAC;SACJ,CAAC;QAEF,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;QAC/C,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QAEtD,OAAO,CAAC,GAAG,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,YAAY;QACvB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;QAE5E,IAAI,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAE7C,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAE/B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;gBAC1C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,UAAU,EAAE;oBAC5D,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,OAAO,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;oBAClC,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,QAAQ,EAAE,OAAO,CAAC,QAAQ;iBAC3B,CAAC,CAAC;YACL,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,8BAA8B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;YAC7D,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;CACF"}

package/dist/src/core/living-docs/hierarchy-mapper.d.ts

@@ -1,142 +1,203 @@
 /**
- * SpecWeave Hierarchy Mapper
+ * SpecWeave Hierarchy Mapper (v4.0.0 - Universal Hierarchy with FS-XXX)
  *
- * Maps increments to Feature Spec (FS-*) folders following Universal Hierarchy architecture.
+ * Maps increments to universal hierarchy following work item type matrix:
+ * - Epic (EPIC-{id}) -> Cross-project strategic themes (_epics/)
+ * - Feature (FS-XXX) -> Cross-project features (_features/ + project folders)
+ * - User Story (us-{id}) -> Project-specific requirements (project/FS-XXX/us-{id}.md)
+ * - Task (T-{id}) -> Increment-specific implementation (increments/{id}/tasks.md)
  *
- * Supports three complexity levels:
- * 1. Simple: Increment → Issue/Epic/Feature (flat)
- * 2. Standard: FS-* (Epic) → US-* (User Stories) → T-* (Tasks)
- * 3. Enterprise: Domain → FS-* (Epic) → US-* → T-*
+ * Key Principles:
+ * - NO HARDCODED PROJECT NAMES (backend, frontend are examples)
+ * - Projects are DYNAMIC from config.json -> multiProject.projects
+ * - Single-project mode: ['default'] (always)
+ * - Multi-project mode: User-configured project names
+ * - Feature IDs assigned by creation date (FS-001, FS-002, etc.)
+ * - NO DUPLICATE FEATURE IDS (enforced by FeatureIDManager)
  *
  * @author SpecWeave Team
- * @version 3.0.0
+ * @version 4.0.0 (Universal Hierarchy with FS-XXX)
+ */
+import { SpecweaveConfig } from '../types/config.js';
+import { EpicMapping, FeatureMapping, ProjectContext } from './types.js';
+/**
+ * Hierarchy Configuration
  */
 export interface HierarchyConfig {
     level: 'simple' | 'standard' | 'enterprise' | 'auto';
     specsBaseDir: string;
-    projectId: string;
-    featureFolderPattern: '{name}';
-    userStoriesSubdir: string;
+    detectEpicFrom: ('frontmatter' | 'config')[];
     detectFeatureFrom: ('frontmatter' | 'increment-name' | 'config')[];
-    fallbackFeature?: string;
-}
-export interface FeatureMapping {
-    featureId: string;
-    featureFolder: string;
-    featurePath: string;
-    userStoriesPath: string;
-    confidence: number;
-    detectionMethod: 'frontmatter' | 'increment-name' | 'config' | 'fallback';
+    detectProjectFrom: ('frontmatter' | 'increment-name' | 'config')[];
+    fallbackEpic?: string;
 }
-export type EpicMapping = FeatureMapping;
 /**
- * HierarchyMapper - Maps increments to feature folders (named by concept, not increment number)
+ * HierarchyMapper - Maps increments to universal hierarchy
  *
- * NEW ARCHITECTURE (v0.18.0+):
- * - Features are PERMANENT (named by concept: "release-management", "external-tool-sync")
- * - Increments are TEMPORARY (named by execution: "0023-release-management-enhancements")
- * - Multiple increments can contribute to same feature
- * - No FS-### prefix (features aren't numbered)
+ * Universal Hierarchy (v4.0.0):
+ * 1. Epic (EPIC-YYYY-QN-{name}) -> _epics/EPIC-{id}/EPIC.md
+ * 2. Feature (FS-XXX) -> _features/FS-XXX/FEATURE.md + {project}/FS-XXX/
+ * 3. User Story (us-NNN-{name}) -> {project}/FS-XXX/us-{id}.md
+ * 4. Task (T-NNN) -> increments/{id}/tasks.md
  */
 export declare class HierarchyMapper {
     private config;
     private projectRoot;
+    private featureIdManager;
+    private configManager;
+    private specweaveConfig;
     constructor(projectRoot: string, config?: Partial<HierarchyConfig>);
     /**
-     * Detect which feature folder this increment belongs to
+     * Load SpecWeave config (cached)
+     */
+    getSpecweaveConfig(): Promise<SpecweaveConfig>;
+    /**
+     * Get list of configured projects
      *
-     * NEW: Features are named by CONCEPT (release-management), not INCREMENT NUMBER (FS-023)
+     * Returns:
+     * - Single-project mode: ['default']
+     * - Multi-project mode: User-configured project names (dynamic, no hardcodes)
      */
-    detectFeatureMapping(incrementId: string): Promise<FeatureMapping>;
+    getConfiguredProjects(): Promise<string[]>;
     /**
-     * Legacy alias for backward compatibility
+     * Check if a feature is archived
      */
-    detectEpicMapping(incrementId: string): Promise<EpicMapping>;
+    isFeatureArchived(featureId: string): Promise<boolean>;
     /**
-     * Detect feature from frontmatter (epic: feature-name)
-     *
-     * FORMAT (v0.18.1+): Accepts simple feature names (external-tool-status-sync)
-     * LEGACY: Also accepts old FS-### format (FS-001) - extracts from increment name instead
+     * Check if an epic is archived
+     */
+    isEpicArchived(epicId: string): Promise<boolean>;
+    /**
+     * Filter out archived items from mappings
      */
-    private detectFromFrontmatter;
+    filterArchivedItems<T extends {
+        id: string;
+    }>(items: T[], type: 'feature' | 'epic'): Promise<T[]>;
     /**
-     * Detect feature from increment NAME
+     * Get project context for a specific project ID
+     */
+    getProjectContext(projectId: string): Promise<ProjectContext | null>;
+    /**
+     * Detect which epic this increment belongs to (OPTIONAL)
      *
-     * FORMAT (v0.18.1+): Simple descriptive names (no date prefixes)
+     * Epic Format: EPIC-YYYY-QN-{name}
+     * Example: EPIC-2025-Q4-platform
      *
-     * Extracts the descriptive part of increment ID and normalizes it to feature name
-     * Examples:
-     *   0023-release-management-enhancements → release-management (new or existing)
-     *   0031-external-tool-status-sync → external-tool-status-sync
+     * Detection Methods:
+     * 1. Frontmatter: epic: EPIC-2025-Q4-platform
+     * 2. Config: livingDocs.hierarchyMapping.incrementToEpic
+     * 3. Fallback: null (no epic required)
      */
-    private detectFromIncrementName;
+    detectEpicMapping(incrementId: string): Promise<EpicMapping | null>;
     /**
-     * Detect feature from config mapping (explicit increment → feature mapping)
+     * Detect which feature this increment belongs to (REQUIRED)
+     *
+     * Feature Format (Greenfield): FS-XXX (matches increment number)
+     * Feature Format (Brownfield): FS-YY-MM-DD-{feature-name} (date-based)
+     * Examples:
+     * - Greenfield: 0031-external-tool-sync → FS-031
+     * - Brownfield: Imported from JIRA → FS-25-11-14-external-tool-sync
+     *
+     * Detection Methods:
+     * 1. Frontmatter: feature: FS-031 (greenfield) or feature: FS-25-11-14-name (brownfield)
+     * 2. Increment Name: 0031-external-tool-status-sync → FS-031 (auto-extract number)
+     * 3. Config: livingDocs.hierarchyMapping.incrementToFeature
+     * 4. Fallback: Auto-create feature from increment number (FS-XXX format)
      */
-    private detectFromConfig;
+    detectFeatureMapping(incrementId: string): Promise<FeatureMapping>;
     /**
-     * Create fallback mapping (extract feature name from increment ID)
+     * Detect which projects this increment/feature affects (REQUIRED)
      *
-     * FORMAT (v0.18.1+): Simple descriptive names (no prefixes)
-     * - Uses core feature name extracted from increment ID
-     * - No date prefixes (removed to prevent duplicates)
-     * - No FS- prefixes (features are not numbered)
+     * Returns array of project IDs (dynamic, from config)
      *
-     * Example: 0023-release-management-enhancements → release-management
+     * Detection Methods:
+     * 1. Frontmatter: project: backend OR projects: [backend, frontend]
+     * 2. Increment Name: Contains project keyword (0031-backend-api-sync)
+     * 3. Config: livingDocs.hierarchyMapping.incrementToProjects
+     * 4. Fallback: ['default'] (single-project mode)
      */
-    private createFallbackMapping;
+    detectProjects(incrementId: string): Promise<string[]>;
     /**
-     * Get increment creation date in yy-mm-dd format
-     * Tries: metadata.json → spec.md frontmatter → current date
+     * Detect epic from frontmatter
      */
-    private getIncrementCreationDate;
+    private detectEpicFromFrontmatter;
     /**
-     * Format date as yy-mm-dd
-     * Input: "2025-11-14" or "2025-11-14T12:00:00Z"
-     * Output: "25-11-14"
+     * Detect epic from config
      */
-    private formatDateShort;
+    private detectEpicFromConfig;
+    /**
+     * Detect feature from frontmatter
+     *
+     * CRITICAL: For greenfield projects, ALWAYS use increment number (FS-XXX)
+     * even if frontmatter says FS-YY-MM-DD-name (date-based format)
+     */
+    private detectFeatureFromFrontmatter;
     /**
-     * NEW: Find feature folder by name (exact match or fuzzy match)
+     * Detect feature from increment name
      *
      * Examples:
-     *   release-management → release-management/
-     *   external-tool-sync → external-tool-status-sync/ (fuzzy match)
+     * - 0031-external-tool-status-sync → FS-031
+     * - 0032-user-authentication → FS-032
+     * - 0001-core-framework → FS-001
      */
-    private findFeatureFolder;
+    private detectFeatureFromIncrementName;
     /**
-     * LEGACY: Find FS-* epic folder (for backward compatibility)
+     * Detect feature from config
      */
-    private findEpicFolder;
+    private detectFeatureFromConfig;
     /**
-     * Get all feature folders (NEW: no FS- prefix filtering)
+     * Create fallback feature mapping
      */
-    getAllFeatureFolders(): Promise<string[]>;
+    private createFallbackFeatureMapping;
+    /**
+     * Build FeatureMapping object
+     *
+     * CRITICAL: For greenfield (FS-XXX format), use the feature ID directly.
+     * The feature ID manager is only used for brownfield (date-based) IDs.
+     */
+    private buildFeatureMapping;
     /**
-     * LEGACY: Get all epic folders (for backward compatibility)
+     * Detect projects from frontmatter
      */
-    getAllEpicFolders(): Promise<string[]>;
+    private detectProjectsFromFrontmatter;
     /**
-     * Validate feature folder structure (NEW: checks for FEATURE.md)
+     * Detect projects from increment name (keyword matching)
      */
-    validateFeatureFolder(featureFolder: string): Promise<{
-        valid: boolean;
-        missing: string[];
-    }>;
+    private detectProjectsFromIncrementName;
     /**
-     * LEGACY: Validate epic folder structure (for backward compatibility)
+     * Detect projects from config
      */
-    validateEpicFolder(epicFolder: string): Promise<{
-        valid: boolean;
-        missing: string[];
-    }>;
+    private detectProjectsFromConfig;
     /**
-     * Create feature folder structure if missing (NEW: creates FEATURE.md)
+     * Get increment creation date in YY-MM-DD format
+     *
+     * Tries: metadata.json → spec.md frontmatter → current date
      */
-    createFeatureFolderStructure(featureFolder: string, title: string): Promise<void>;
+    private getIncrementCreationDate;
+    /**
+     * Format date as YY-MM-DD
+     * Input: "2025-11-14" or "2025-11-14T12:00:00Z"
+     * Output: "25-11-14"
+     */
+    private formatDateShort;
+    /**
+     * Find existing feature folder (exact or fuzzy match)
+     *
+     * CRITICAL: For greenfield (FS-XXX), only exact match.
+     * For brownfield (FS-YY-MM-DD-name), fuzzy match allowed.
+     */
+    private findExistingFeatureFolder;
+    /**
+     * Get all feature folders
+     */
+    getAllFeatureFolders(): Promise<string[]>;
+    /**
+     * Get all epic folders
+     */
+    getAllEpicFolders(): Promise<string[]>;
     /**
-     * LEGACY: Create epic folder structure (for backward compatibility)
+     * LEGACY: Backward compatibility alias for detectFeatureMapping
      */
-    createEpicFolderStructure(epicFolder: string, title: string): Promise<void>;
+    detectEpicMapping_LEGACY(incrementId: string): Promise<FeatureMapping>;
 }
 //# sourceMappingURL=hierarchy-mapper.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hierarchy-mapper.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/hierarchy-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,QAAQ,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,CAAC,aAAa,GAAG,gBAAgB,GAAG,QAAQ,CAAC,EAAE,CAAC;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,aAAa,GAAG,gBAAgB,GAAG,QAAQ,GAAG,UAAU,CAAC;CAC3E;AAGD,MAAM,MAAM,WAAW,GAAG,cAAc,CAAC;AAEzC;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAelE;;;;OAIG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAkCxE;;OAEG;IACG,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAIlE;;;;;OAKG;YACW,qBAAqB;IAuCnC;;;;;;;;;OASG;YACW,uBAAuB;IA0CrC;;OAEG;YACW,gBAAgB;IA+B9B;;;;;;;;;OASG;YACW,qBAAqB;IAqCnC;;;OAGG;YACW,wBAAwB;IAoCtC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;;OAMG;YACW,iBAAiB;IA8B/B;;OAEG;YACW,cAAc;IAI5B;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA0B/C;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI5C;;OAEG;IACG,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAiBlG;;OAEG;IACG,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAI5F;;OAEG;IACG,4BAA4B,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqEvF;;OAEG;IACG,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlF"}
+{"version":3,"file":"hierarchy-mapper.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/hierarchy-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,EAAE,eAAe,EAAqC,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGzE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,CAAC,aAAa,GAAG,QAAQ,CAAC,EAAE,CAAC;IAC7C,iBAAiB,EAAE,CAAC,aAAa,GAAG,gBAAgB,GAAG,QAAQ,CAAC,EAAE,CAAC;IACnE,iBAAiB,EAAE,CAAC,aAAa,GAAG,gBAAgB,GAAG,QAAQ,CAAC,EAAE,CAAC;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,eAAe,CAAgC;gBAE3C,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAelE;;OAEG;IACU,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;IAO3D;;;;;;OAMG;IACG,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAgBhD;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB5D;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtD;;OAEG;IACG,mBAAmB,CAAC,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,EAChD,KAAK,EAAE,CAAC,EAAE,EACV,IAAI,EAAE,SAAS,GAAG,MAAM,GACvB,OAAO,CAAC,CAAC,EAAE,CAAC;IAgBf;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA6B1E;;;;;;;;;;OAUG;IACG,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA+BzE;;;;;;;;;;;;;;OAcG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAqCxE;;;;;;;;;;OAUG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsC5D;;OAEG;YACW,yBAAyB;IAwCvC;;OAEG;YACW,oBAAoB;IAsBlC;;;;;OAKG;YACW,4BAA4B;IAoC1C;;;;;;;OAOG;YACW,8BAA8B;IAsB5C;;OAEG;YACW,uBAAuB;IAcrC;;OAEG;YACW,4BAA4B;IAoB1C;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAsC3B;;OAEG;YACW,6BAA6B;IAwB3C;;OAEG;IACH,OAAO,CAAC,+BAA+B;IA0BvC;;OAEG;YACW,wBAAwB;IAgBtC;;;;OAIG;YACW,wBAAwB;IAoCtC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAQvB;;;;;OAKG;YACW,yBAAyB;IA6CvC;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAgC/C;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAgC5C;;OAEG;IACG,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAG7E"}