specweave 0.28.3 → 0.28.5

package/dist/src/core/living-docs/feature-consistency-validator.js

@@ -0,0 +1,445 @@
+/**
+ * Feature Consistency Validator
+ *
+ * Validates and repairs consistency between:
+ * - .specweave/docs/internal/specs/_features/FS-XXX/
+ * - .specweave/docs/internal/specs/{project}/FS-XXX/
+ *
+ * PROBLEM SOLVED:
+ * Living docs sync creates _features/ and {project}/ folders sequentially.
+ * If sync fails midway or increment is deleted, folders can get out of sync.
+ *
+ * SOLUTION:
+ * 1. Detect discrepancies (orphaned _features without project folders)
+ * 2. Auto-repair by creating missing project folders
+ * 3. Report issues for manual intervention when auto-repair not possible
+ *
+ * @see ADR-0142 (if created) for architectural decision
+ */
+import { existsSync, promises as fs } from 'fs';
+import path from 'path';
+import yaml from 'yaml';
+import { consoleLogger } from '../../utils/logger.js';
+export class FeatureConsistencyValidator {
+    constructor(projectRoot, options = {}) {
+        this.projectRoot = projectRoot;
+        this.specsPath = path.join(projectRoot, '.specweave/docs/internal/specs');
+        this.incrementsPath = path.join(projectRoot, '.specweave/increments');
+        this.logger = options.logger ?? consoleLogger;
+        this.defaultProject = options.defaultProject ?? 'specweave';
+        this.includeArchived = options.includeArchived ?? false;
+    }
+    /**
+     * Validate consistency between _features and project folders
+     *
+     * @param autoRepair - If true, attempt to auto-repair discrepancies
+     * @returns Validation result with discrepancies and repair results
+     */
+    async validate(autoRepair = false) {
+        const result = {
+            totalFeatures: 0,
+            consistentCount: 0,
+            discrepancies: [],
+            repairs: autoRepair ? [] : undefined
+        };
+        this.logger.log('🔍 Validating feature folder consistency...');
+        // Step 1: Get all features from _features folder
+        const featuresDir = path.join(this.specsPath, '_features');
+        if (!existsSync(featuresDir)) {
+            this.logger.log('   ℹ️  No _features folder found, nothing to validate');
+            return result;
+        }
+        const featureFolders = await this.getFeatureFolders(featuresDir);
+        result.totalFeatures = featureFolders.length;
+        // Step 2: Get all project folders
+        const projectFolders = await this.getProjectFolders();
+        // Step 3: Check each feature for consistency
+        for (const featureId of featureFolders) {
+            const discrepancy = await this.checkFeatureConsistency(featureId, projectFolders);
+            if (discrepancy) {
+                result.discrepancies.push(discrepancy);
+                // Attempt auto-repair if enabled
+                if (autoRepair && discrepancy.autoRepairable) {
+                    const repairResult = await this.repairDiscrepancy(discrepancy);
+                    result.repairs.push(repairResult);
+                    if (repairResult.success) {
+                        result.consistentCount++; // Count as consistent after repair
+                    }
+                }
+            }
+            else {
+                result.consistentCount++;
+            }
+        }
+        // Step 4: Log summary
+        this.logValidationSummary(result);
+        return result;
+    }
+    /**
+     * Get all feature folder IDs from _features directory
+     */
+    async getFeatureFolders(featuresDir) {
+        const entries = await fs.readdir(featuresDir, { withFileTypes: true });
+        const folders = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            // Skip _archive unless includeArchived is true
+            if (entry.name === '_archive' && !this.includeArchived)
+                continue;
+            // Only include FS-XXX pattern folders
+            if (entry.name.startsWith('FS-')) {
+                folders.push(entry.name);
+            }
+        }
+        return folders.sort();
+    }
+    /**
+     * Get all project folder names (excluding _features, _epics, _archive)
+     */
+    async getProjectFolders() {
+        if (!existsSync(this.specsPath)) {
+            return [];
+        }
+        const entries = await fs.readdir(this.specsPath, { withFileTypes: true });
+        const projects = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            // Skip special folders
+            if (entry.name.startsWith('_'))
+                continue;
+            projects.push(entry.name);
+        }
+        return projects;
+    }
+    /**
+     * Check if a feature has consistent folders across _features and projects
+     */
+    async checkFeatureConsistency(featureId, projectFolders) {
+        const featuresPath = path.join(this.specsPath, '_features', featureId);
+        const featureFilePath = path.join(featuresPath, 'FEATURE.md');
+        // Check if FEATURE.md exists
+        if (!existsSync(featureFilePath)) {
+            return {
+                featureId,
+                type: 'orphaned_feature',
+                description: `_features/${featureId}/ exists but has no FEATURE.md`,
+                autoRepairable: false,
+                featuresPath
+            };
+        }
+        // Parse FEATURE.md to find linked increment
+        const linkedIncrement = await this.extractLinkedIncrement(featureFilePath);
+        const incrementExists = linkedIncrement
+            ? this.checkIncrementExists(linkedIncrement)
+            : false;
+        // Check if feature exists in any project folder
+        let foundInProjects = [];
+        for (const project of projectFolders) {
+            const projectFeaturePath = path.join(this.specsPath, project, featureId);
+            if (existsSync(projectFeaturePath)) {
+                foundInProjects.push(project);
+            }
+        }
+        if (foundInProjects.length === 0) {
+            // Check if this is an orphaned feature (increment deleted, not external)
+            const isExternalFeature = await this.isExternalFeature(featureFilePath);
+            if (!incrementExists && !isExternalFeature && linkedIncrement) {
+                // ORPHANED: Increment was deleted, feature is not external - should be archived
+                // This prevents creating project folders for features whose increments no longer exist
+                return {
+                    featureId,
+                    type: 'orphaned_feature',
+                    description: `Feature ${featureId} references deleted increment ${linkedIncrement} - should be archived`,
+                    autoRepairable: true, // Can auto-repair via archiver
+                    featuresPath,
+                    linkedIncrementId: linkedIncrement,
+                    incrementExists: false
+                };
+            }
+            // Normal case: increment exists OR external feature OR no linked increment
+            // Create missing project folder
+            return {
+                featureId,
+                type: 'missing_project_folder',
+                description: `Feature ${featureId} exists in _features/ but not in any project folder`,
+                autoRepairable: true, // We can create the missing folder
+                featuresPath,
+                projectPath: path.join(this.specsPath, this.defaultProject, featureId),
+                linkedIncrementId: linkedIncrement,
+                incrementExists
+            };
+        }
+        // Feature is consistent
+        return null;
+    }
+    /**
+     * Check if a feature is from an external source (GitHub, JIRA, ADO)
+     * External features should NOT be considered orphaned even if local increment is missing
+     */
+    async isExternalFeature(featureFilePath) {
+        try {
+            const content = await fs.readFile(featureFilePath, 'utf-8');
+            // Check frontmatter for external indicators
+            const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+            if (frontmatterMatch) {
+                try {
+                    const frontmatter = yaml.parse(frontmatterMatch[1]);
+                    if (frontmatter.origin === 'external' ||
+                        frontmatter.external_source ||
+                        frontmatter.external_id) {
+                        return true;
+                    }
+                }
+                catch {
+                    // Ignore YAML parse errors
+                }
+            }
+            // Check for external badges/markers in content
+            // 🔗 = GitHub, 🎫 = JIRA, 📋 = ADO
+            if (content.includes('origin: external') ||
+                content.includes('external_source:') ||
+                content.includes('external_id:')) {
+                return true;
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Extract linked increment ID from FEATURE.md
+     */
+    async extractLinkedIncrement(featureFilePath) {
+        try {
+            const content = await fs.readFile(featureFilePath, 'utf-8');
+            // Look for increment link pattern: [0062-test-living-docs-auto-sync](...)
+            const incrementMatch = content.match(/\[(\d{4}-[^\]]+)\]\([^)]+\)/);
+            if (incrementMatch) {
+                return incrementMatch[1];
+            }
+            // Also check frontmatter
+            const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+            if (frontmatterMatch) {
+                try {
+                    const frontmatter = yaml.parse(frontmatterMatch[1]);
+                    if (frontmatter.increment) {
+                        return frontmatter.increment;
+                    }
+                }
+                catch {
+                    // Ignore YAML parse errors
+                }
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Check if an increment exists (in active or archive folder)
+     */
+    checkIncrementExists(incrementId) {
+        const activePath = path.join(this.incrementsPath, incrementId);
+        const archivePath = path.join(this.incrementsPath, '_archive', incrementId);
+        return existsSync(activePath) || existsSync(archivePath);
+    }
+    /**
+     * Attempt to repair a discrepancy
+     */
+    async repairDiscrepancy(discrepancy) {
+        const result = {
+            featureId: discrepancy.featureId,
+            success: false,
+            action: ''
+        };
+        try {
+            switch (discrepancy.type) {
+                case 'missing_project_folder':
+                    result.action = await this.repairMissingProjectFolder(discrepancy);
+                    result.success = true;
+                    break;
+                case 'orphaned_feature':
+                    // Auto-archive orphaned features (increment was deleted)
+                    if (discrepancy.autoRepairable) {
+                        result.action = await this.archiveOrphanedFeature(discrepancy);
+                        result.success = true;
+                    }
+                    else {
+                        // No FEATURE.md or other issue - needs manual intervention
+                        result.action = 'Skipped - requires manual intervention (no FEATURE.md)';
+                        result.success = false;
+                    }
+                    break;
+                default:
+                    result.action = 'Unknown discrepancy type';
+                    result.success = false;
+            }
+        }
+        catch (error) {
+            result.error = String(error);
+            result.action = `Failed: ${error}`;
+        }
+        return result;
+    }
+    /**
+     * Archive an orphaned feature (increment was deleted)
+     * Delegates to FeatureArchiver for consistent archiving behavior
+     */
+    async archiveOrphanedFeature(discrepancy) {
+        // Dynamic import to avoid circular dependency
+        const { FeatureArchiver } = await import('./feature-archiver.js');
+        const archiver = new FeatureArchiver(this.projectRoot);
+        this.logger.log(`   🗂️  Archiving orphaned feature ${discrepancy.featureId} (increment deleted)...`);
+        const archiveResult = await archiver.archiveFeatures({
+            archiveOrphanedFeatures: true,
+            archiveOrphanedEpics: false, // Be conservative - only archive features
+            dryRun: false,
+            updateLinks: true,
+            customReason: `Increment ${discrepancy.linkedIncrementId || 'unknown'} was deleted`
+        });
+        if (archiveResult.archivedFeatures.includes(discrepancy.featureId)) {
+            this.logger.log(`   ✅ Archived ${discrepancy.featureId} to _archive/`);
+            return `Archived orphaned feature ${discrepancy.featureId} (increment ${discrepancy.linkedIncrementId} deleted)`;
+        }
+        else if (archiveResult.errors.length > 0) {
+            throw new Error(archiveResult.errors.join(', '));
+        }
+        else {
+            // Feature might have been archived by another process or already in archive
+            return `Feature ${discrepancy.featureId} already archived or cleaned up`;
+        }
+    }
+    /**
+     * Create missing project folder for a feature
+     */
+    async repairMissingProjectFolder(discrepancy) {
+        const projectPath = discrepancy.projectPath;
+        const featuresPath = discrepancy.featuresPath;
+        // Create project folder
+        await fs.mkdir(projectPath, { recursive: true });
+        // Extract info from FEATURE.md to create README.md
+        const featureFilePath = path.join(featuresPath, 'FEATURE.md');
+        const featureContent = await fs.readFile(featureFilePath, 'utf-8');
+        // Extract title from FEATURE.md
+        let title = discrepancy.featureId;
+        const titleMatch = featureContent.match(/^#\s+(.+)$/m);
+        if (titleMatch) {
+            title = titleMatch[1];
+        }
+        // Extract frontmatter
+        let status = 'in-progress';
+        const frontmatterMatch = featureContent.match(/^---\n([\s\S]*?)\n---/);
+        if (frontmatterMatch) {
+            try {
+                const frontmatter = yaml.parse(frontmatterMatch[1]);
+                status = frontmatter.status || status;
+            }
+            catch {
+                // Ignore YAML parse errors
+            }
+        }
+        // Create README.md in project folder
+        const readmeContent = `---
+id: ${discrepancy.featureId}-${this.defaultProject}
+title: "${title} - ${this.defaultProject.charAt(0).toUpperCase() + this.defaultProject.slice(1)} Implementation"
+feature: ${discrepancy.featureId}
+project: ${this.defaultProject}
+type: feature-context
+status: ${status}
+auto_repaired: true
+repaired_at: ${new Date().toISOString()}
+---
+
+# ${title}
+
+**Feature**: [${discrepancy.featureId}](../../_features/${discrepancy.featureId}/FEATURE.md)
+
+## Overview
+
+This project context was auto-created by consistency validator.
+
+## User Stories
+
+See user story files in this directory.
+
+## Note
+
+This folder was auto-created because _features/${discrepancy.featureId}/ existed
+but ${this.defaultProject}/${discrepancy.featureId}/ was missing.
+
+${discrepancy.linkedIncrementId
+            ? `**Linked Increment**: ${discrepancy.linkedIncrementId} (${discrepancy.incrementExists ? 'exists' : 'not found'})`
+            : '**Linked Increment**: Not found in FEATURE.md'}
+`;
+        const readmePath = path.join(projectPath, 'README.md');
+        await fs.writeFile(readmePath, readmeContent, 'utf-8');
+        this.logger.log(`   ✅ Created ${this.defaultProject}/${discrepancy.featureId}/README.md`);
+        return `Created ${projectPath}/README.md`;
+    }
+    /**
+     * Log validation summary
+     */
+    logValidationSummary(result) {
+        this.logger.log('');
+        this.logger.log('═══════════════════════════════════════════════════════');
+        this.logger.log('📊 FEATURE CONSISTENCY VALIDATION REPORT');
+        this.logger.log('═══════════════════════════════════════════════════════');
+        this.logger.log('');
+        this.logger.log(`Total features scanned: ${result.totalFeatures}`);
+        this.logger.log(`Consistent: ${result.consistentCount}`);
+        this.logger.log(`Discrepancies found: ${result.discrepancies.length}`);
+        this.logger.log('');
+        if (result.discrepancies.length > 0) {
+            this.logger.log('───────────────────────────────────────────────────────');
+            this.logger.log('⚠️  DISCREPANCIES');
+            this.logger.log('───────────────────────────────────────────────────────');
+            for (const disc of result.discrepancies) {
+                this.logger.log('');
+                this.logger.log(`Feature: ${disc.featureId}`);
+                this.logger.log(`Type: ${disc.type}`);
+                this.logger.log(`Description: ${disc.description}`);
+                this.logger.log(`Auto-repairable: ${disc.autoRepairable ? 'Yes' : 'No'}`);
+                if (disc.linkedIncrementId) {
+                    this.logger.log(`Linked increment: ${disc.linkedIncrementId} (${disc.incrementExists ? '✅ exists' : '❌ not found'})`);
+                }
+            }
+        }
+        if (result.repairs && result.repairs.length > 0) {
+            this.logger.log('');
+            this.logger.log('───────────────────────────────────────────────────────');
+            this.logger.log('🔧 REPAIR RESULTS');
+            this.logger.log('───────────────────────────────────────────────────────');
+            for (const repair of result.repairs) {
+                const icon = repair.success ? '✅' : '❌';
+                this.logger.log(`${icon} ${repair.featureId}: ${repair.action}`);
+                if (repair.error) {
+                    this.logger.log(`   Error: ${repair.error}`);
+                }
+            }
+        }
+        this.logger.log('');
+        this.logger.log('═══════════════════════════════════════════════════════');
+    }
+    /**
+     * Quick check: Are there any discrepancies?
+     * Use this for fast validation without full report
+     */
+    async hasDiscrepancies() {
+        const result = await this.validate(false);
+        return result.discrepancies.length > 0;
+    }
+    /**
+     * Get list of orphaned features (features in _features without corresponding project folder)
+     */
+    async getOrphanedFeatures() {
+        const result = await this.validate(false);
+        return result.discrepancies
+            .filter(d => d.type === 'missing_project_folder')
+            .map(d => d.featureId);
+    }
+}
+//# sourceMappingURL=feature-consistency-validator.js.map

package/dist/src/core/living-docs/feature-consistency-validator.js.map

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

package/dist/src/core/living-docs/index.d.ts

@@ -17,5 +17,6 @@ export { ContentClassifier } from './content-classifier.js';
 export { ProjectDetector } from './project-detector.js';
 export { ContentDistributor } from './content-distributor.js';
 export { CrossLinker } from './cross-linker.js';
+export { FeatureConsistencyValidator } from './feature-consistency-validator.js';
 export * from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,cAAc,YAAY,CAAC"}

package/dist/src/core/living-docs/index.js

@@ -21,5 +21,6 @@ export { ContentClassifier } from './content-classifier.js';
 export { ProjectDetector } from './project-detector.js';
 export { ContentDistributor } from './content-distributor.js';
 export { CrossLinker } from './cross-linker.js';
+export { FeatureConsistencyValidator } from './feature-consistency-validator.js';
 export * from './types.js';
 //# sourceMappingURL=index.js.map

package/dist/src/core/living-docs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/living-docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,gEAAgE;AAChE,kDAAkD;AAClD,2DAA2D;AAE3D,0DAA0D;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/living-docs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,gEAAgE;AAChE,kDAAkD;AAClD,2DAA2D;AAE3D,0DAA0D;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACjF,cAAc,YAAY,CAAC"}

package/dist/src/core/living-docs/living-docs-sync.d.ts

@@ -221,5 +221,18 @@ export declare class LivingDocsSync {
      * - Any other temporary files
      */
     private cleanupTempFiles;
+    /**
+     * Validate and repair consistency between _features and project folders
+     *
+     * CRITICAL FIX (2025-11-25): Post-sync validation to prevent orphaned folders
+     *
+     * This method:
+     * 1. Checks if the just-synced feature exists in both _features/ and project folder
+     * 2. Auto-repairs if discrepancy found (creates missing project folder)
+     * 3. Logs warnings for manual intervention if auto-repair not possible
+     *
+     * @param featureId - Feature ID that was just synced (e.g., "FS-062")
+     */
+    private validateAndRepairConsistency;
 }
 //# sourceMappingURL=living-docs-sync.d.ts.map

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

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

package/dist/src/core/living-docs/living-docs-sync.js

@@ -13,6 +13,7 @@ import path from 'path';
 import yaml from 'yaml';
 import { FeatureIDManager } from './feature-id-manager.js';
 import { TaskProjectSpecificGenerator } from './task-project-specific-generator.js';
+import { FeatureConsistencyValidator } from './feature-consistency-validator.js';
 import { consoleLogger } from '../../utils/logger.js';
 // Helper functions for fs-extra compatibility
 async function pathExists(filePath) {
@@ -179,6 +180,12 @@ export class LivingDocsSync {
             if (!options.dryRun) {
                 await this.cleanupTempFiles(projectPath);
             }
+            // Step 9: Validate consistency (auto-repair if needed)
+            // CRITICAL FIX (2025-11-25): Ensure _features and project folders are in sync
+            // This prevents orphaned _features folders without corresponding project folders
+            if (!options.dryRun) {
+                await this.validateAndRepairConsistency(featureId);
+            }
             result.success = true;
             this.logger.log(`✅ Synced ${incrementId} → ${featureId}`);
             this.logger.log(`   Created: ${result.filesCreated.length} files`);
@@ -1046,5 +1053,48 @@ export class LivingDocsSync {
             }
         }
     }
+    /**
+     * Validate and repair consistency between _features and project folders
+     *
+     * CRITICAL FIX (2025-11-25): Post-sync validation to prevent orphaned folders
+     *
+     * This method:
+     * 1. Checks if the just-synced feature exists in both _features/ and project folder
+     * 2. Auto-repairs if discrepancy found (creates missing project folder)
+     * 3. Logs warnings for manual intervention if auto-repair not possible
+     *
+     * @param featureId - Feature ID that was just synced (e.g., "FS-062")
+     */
+    async validateAndRepairConsistency(featureId) {
+        try {
+            const validator = new FeatureConsistencyValidator(this.projectRoot, {
+                logger: this.logger,
+                defaultProject: 'specweave'
+            });
+            // Quick check for the specific feature we just synced
+            const featuresPath = path.join(this.projectRoot, '.specweave/docs/internal/specs/_features', featureId);
+            const projectPath = path.join(this.projectRoot, '.specweave/docs/internal/specs/specweave', featureId);
+            // Check if _features exists but project folder doesn't
+            if (existsSync(featuresPath) && !existsSync(projectPath)) {
+                this.logger.warn(`   ⚠️  Consistency issue detected: ${featureId} missing from specweave/`);
+                // Run full validation with auto-repair for this feature
+                const result = await validator.validate(true);
+                if (result.repairs && result.repairs.length > 0) {
+                    const repair = result.repairs.find(r => r.featureId === featureId);
+                    if (repair?.success) {
+                        this.logger.log(`   ✅ Auto-repaired: created specweave/${featureId}/`);
+                    }
+                    else {
+                        this.logger.warn(`   ⚠️  Auto-repair failed for ${featureId}: ${repair?.error}`);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // Non-fatal - log warning but continue
+            this.logger.warn(`   ⚠️  Consistency validation failed: ${error}`);
+            this.logger.warn(`      Sync completed but consistency not verified`);
+        }
+    }
 }
 //# sourceMappingURL=living-docs-sync.js.map