specweave 0.28.3 → 0.28.6

package/plugins/specweave/commands/specweave-sync-specs.md

@@ -103,11 +103,15 @@ await syncSpecs(args);
 
 **This will**:
 1. Auto-generate feature ID for greenfield increments (FS-040, FS-041, etc.)
-2. Parse spec.md for user stories and acceptance criteria
-3. Create living docs structure:
+2. **Auto-detect project folder** from:
+   - Git remote (GitHub repo name)
+   - Sync configuration (JIRA/ADO project)
+   - Falls back to "default" if not detected
+3. Parse spec.md for user stories and acceptance criteria
+4. Create living docs structure:
    - `.specweave/docs/internal/specs/_features/FS-XXX/FEATURE.md`
-   - `.specweave/docs/internal/specs/specweave/FS-XXX/README.md`
-   - `.specweave/docs/internal/specs/specweave/FS-XXX/us-*.md`
+   - `.specweave/docs/internal/specs/{project}/FS-XXX/README.md`
+   - `.specweave/docs/internal/specs/{project}/FS-XXX/us-*.md`
 
 ---
 
@@ -168,6 +172,11 @@ Title: {title from spec.md}
 📂 FILE STRUCTURE
 ───────────────────────────────────────────────────────
 
+**Project folder is auto-detected** from:
+- Git remote (e.g., `sw-qr-menu` for `github.com/user/sw-qr-menu.git`)
+- Sync config (JIRA project key or ADO project name)
+- Falls back to "default" if not detected
+
 .specweave/docs/internal/specs/
 ├── _epics/                     {if epic created}
 │   └── {EPIC-ID}/
@@ -175,7 +184,7 @@ Title: {title from spec.md}
 ├── _features/
 │   └── {FS-ID}/
 │       └── FEATURE.md          ← Cross-project feature
-└── {project}/                  ← Per-project stories
+└── {project}/                  ← Per-project stories (auto-detected!)
     └── {FS-ID}/
         ├── README.md            ← Project context
         ├── us-001-{title}.md    ← User story 1

package/plugins/specweave/commands/specweave-validate-features.md

@@ -0,0 +1,203 @@
+---
+name: specweave:validate-features
+description: Validate feature folder consistency between _features/ and project folders. Detects orphaned features and auto-repairs discrepancies. Use when features appear in _features but not in project folders.
+---
+
+# Validate Feature Folder Consistency
+
+Validates that features in `_features/` have corresponding project folders (e.g., `specweave/FS-XXX/`).
+
+---
+
+## STEP 1: Parse Arguments
+
+```
+Arguments: [user's arguments]
+```
+
+**Options**:
+- `--repair`: Auto-repair discrepancies (create missing project folders)
+- `--dry-run`: Show what would be repaired without making changes
+
+---
+
+## STEP 2: Run Consistency Validation
+
+**Execute**:
+
+```typescript
+import { FeatureConsistencyValidator } from './dist/src/core/living-docs/feature-consistency-validator.js';
+
+const validator = new FeatureConsistencyValidator(process.cwd(), {
+  defaultProject: 'specweave'
+});
+
+// Parse repair flag
+const autoRepair = process.argv.includes('--repair');
+const dryRun = process.argv.includes('--dry-run');
+
+if (dryRun) {
+  console.log('🔍 DRY RUN MODE - No files will be modified\n');
+}
+
+// Run validation
+const result = await validator.validate(autoRepair && !dryRun);
+```
+
+---
+
+## STEP 3: Report Results
+
+**Output format**:
+
+```
+═══════════════════════════════════════════════════════
+📊 FEATURE CONSISTENCY VALIDATION REPORT
+═══════════════════════════════════════════════════════
+
+Total features scanned: {total}
+Consistent: {consistent}
+Discrepancies found: {discrepancies}
+
+───────────────────────────────────────────────────────
+{if discrepancies > 0}
+⚠️  DISCREPANCIES FOUND
+
+{for each discrepancy}
+Feature: {featureId}
+Type: {type}
+Description: {description}
+Auto-repairable: {yes/no}
+{if linkedIncrement}
+Linked increment: {incrementId} ({exists/not found})
+{/if}
+
+{/for}
+───────────────────────────────────────────────────────
+{/if}
+
+{if repairs}
+🔧 REPAIR RESULTS
+
+{for each repair}
+{✅/❌} {featureId}: {action}
+{if error}   Error: {error}{/if}
+{/for}
+{/if}
+
+═══════════════════════════════════════════════════════
+```
+
+---
+
+## STEP 4: Provide Next Steps
+
+```
+🎯 NEXT STEPS
+───────────────────────────────────────────────────────
+
+{if discrepancies > 0 && !repair}
+To auto-repair these discrepancies:
+  /specweave:validate-features --repair
+
+This will:
+  • Create missing project folders
+  • Generate README.md files
+  • Link to existing FEATURE.md
+{/if}
+
+{if all repaired}
+✅ All discrepancies have been repaired!
+
+Verify the repairs:
+  ls -la .specweave/docs/internal/specs/specweave/
+{/if}
+
+{if orphaned features}
+⚠️  Some features could not be auto-repaired.
+
+Manual intervention required for:
+{list orphaned features}
+
+Options:
+  1. Delete orphaned _features folder if no longer needed
+  2. Re-sync from increment if increment still exists
+  3. Create project folder manually
+{/if}
+```
+
+---
+
+## EXAMPLES
+
+### Example 1: Check for discrepancies
+```
+User: /specweave:validate-features
+
+Output:
+═══════════════════════════════════════════════════════
+📊 FEATURE CONSISTENCY VALIDATION REPORT
+═══════════════════════════════════════════════════════
+
+Total features scanned: 7
+Consistent: 6
+Discrepancies found: 1
+
+───────────────────────────────────────────────────────
+⚠️  DISCREPANCIES FOUND
+
+Feature: FS-062
+Type: missing_project_folder
+Description: Feature FS-062 exists in _features/ but not in any project folder
+Auto-repairable: Yes
+Linked increment: 0062-test-living-docs-auto-sync (not found)
+
+───────────────────────────────────────────────────────
+
+🎯 To repair: /specweave:validate-features --repair
+═══════════════════════════════════════════════════════
+```
+
+### Example 2: Auto-repair discrepancies
+```
+User: /specweave:validate-features --repair
+
+Output:
+═══════════════════════════════════════════════════════
+📊 FEATURE CONSISTENCY VALIDATION REPORT
+═══════════════════════════════════════════════════════
+
+Total features scanned: 7
+Consistent: 7
+Discrepancies found: 1
+
+───────────────────────────────────────────────────────
+🔧 REPAIR RESULTS
+
+✅ FS-062: Created .specweave/docs/internal/specs/specweave/FS-062/README.md
+
+═══════════════════════════════════════════════════════
+```
+
+---
+
+## WHEN TO USE
+
+**Use this command when**:
+- Features appear in `_features/` but not in project folders
+- After interrupted/failed sync operations
+- After manual cleanup of increments
+- Periodic health check of living docs structure
+
+**Root cause of discrepancies**:
+1. Sync interrupted between creating _features and project folders
+2. Increment deleted without cleaning up living docs
+3. Manual editing of living docs structure
+
+---
+
+## RELATED COMMANDS
+
+- `/specweave:sync-specs` - Sync increment to living docs (includes consistency check)
+- `/specweave:validate` - Validate increment structure
+- `/specweave:archive` - Archive completed increments