specweave 0.17.12 → 0.17.15

package/plugins/specweave/hooks/user-prompt-submit.sh

@@ -30,7 +30,7 @@ if echo "$PROMPT" | grep -q "/specweave:increment"; then
       # Check active increments using MetadataManager
       ACTIVE_COUNT=$(node -e "
         try {
-          const { MetadataManager } = require('./dist/core/increment/metadata-manager.js');
+          const { MetadataManager } = require('./dist/src/core/increment/metadata-manager.js');
           const active = MetadataManager.getActive();
           console.log(active.length);
         } catch (e) {
@@ -44,7 +44,7 @@ if echo "$PROMPT" | grep -q "/specweave:increment"; then
         # Get list of active increments for error message
         ACTIVE_LIST=$(node -e "
           try {
-            const { MetadataManager } = require('./dist/core/increment/metadata-manager.js');
+            const { MetadataManager } = require('./dist/src/core/increment/metadata-manager.js');
             const active = MetadataManager.getActive();
             active.forEach(inc => console.log('  - ' + inc.id + ' [' + inc.type + ']'));
           } catch (e) {}
@@ -64,7 +64,7 @@ EOF
         # Get list of active increments for warning
         ACTIVE_LIST=$(node -e "
           try {
-            const { MetadataManager } = require('./dist/core/increment/metadata-manager.js');
+            const { MetadataManager } = require('./dist/src/core/increment/metadata-manager.js');
             const active = MetadataManager.getActive();
             active.forEach(inc => console.log('  - ' + inc.id + ' [' + inc.type + ']'));
           } catch (e) {}
@@ -231,7 +231,7 @@ if [[ -d ".specweave/increments" ]]; then
       # Get status line from cache (ultra-fast)
       STATUS_LINE=$(node -e "
         try {
-          const { StatusLineManager } = require('./dist/core/status-line/status-line-manager.js');
+          const { StatusLineManager } = require('./dist/src/core/status-line/status-line-manager.js');
           const manager = new StatusLineManager(process.cwd());
           const result = manager.render();
           console.log(result || '');

package/plugins/specweave/skills/increment-planner/SKILL.md

@@ -110,13 +110,15 @@ This skill activates automatically when users say:
 
 ---
 
-## 🆕 Multi-Project Support (v0.8.0+)
+## 🆕 Multi-Project Support (v0.8.0+ | Flattened v0.16.11+)
 
 **Key Changes**:
-- Specs are now organized by project: `.specweave/docs/internal/projects/{project-id}/specs/`
-- Use `ProjectManager` (from `src/core/project-manager.ts`) to get correct paths
-- Single project uses `projects/default/` automatically (transparent)
+- ✅ **CORRECT** (v0.16.11+): Specs organized with FLATTENED structure: `.specweave/docs/internal/specs/{project-id}/`
+- ❌ **OLD** (v0.8.0-v0.16.10): `.specweave/docs/internal/projects/{project-id}/specs/` (DEPRECATED nested structure)
+- Use `ProjectManager` (from `src/core/project-manager.ts`) to get correct paths (always returns flattened structure)
+- Single project uses `specs/default/` automatically (transparent)
 - Multi-project mode allows multiple teams/repos
+- Parent repo content goes to `specs/_parent/` (for multi-repo setups with parent repositories)
 
 **Path Resolution**:
 ```typescript
@@ -177,7 +179,7 @@ Task(
   1. Spec (living docs - SOURCE OF TRUTH, permanent):
      - IMPORTANT: Use ProjectManager to get correct path for active project
      - Create at: {projectManager.getSpecsPath()}/spec-{number}-{name}.md
-       (This resolves to projects/{activeProject}/specs/ automatically)
+       (This resolves to specs/{activeProject}/ with FLATTENED structure v0.16.11+)
      - This is the COMPLETE, PERMANENT source of truth
      - Include ALL of:
        * User stories (US-001, US-002, etc.) with full details
@@ -299,17 +301,20 @@ STEP 6: Validate Living Docs and Increment Files
 
 #### Living Spec (Living Docs - Source of Truth) ✅
 ```
-.specweave/docs/internal/projects/{project-id}/specs/  # ← Multi-project (v0.8.0+)
+.specweave/docs/internal/specs/{project-id}/  # ← FLATTENED structure (v0.16.11+)
 └── spec-{number}-{name}.md          # ← PM Agent (MANDATORY)
                                      # COMPLETE user stories, AC, requirements
                                      # This is the PERMANENT source of truth
                                      # Can be linked to Jira/ADO/GitHub Issues
                                      # Persists after increment completes
 
-# Examples:
-# Single project: projects/default/specs/spec-001-user-auth.md
-# Multi-project: projects/web-app/specs/spec-001-user-auth.md
-#                projects/mobile/specs/spec-001-push-notifications.md
+# Examples (v0.16.11+ Flattened):
+# Single project: specs/default/spec-001-user-auth.md
+# Multi-project: specs/web-app/spec-001-user-auth.md
+#                specs/mobile/spec-001-push-notifications.md
+# Parent repo:   specs/_parent/spec-002-system-architecture.md
+
+# OLD (v0.8.0-v0.16.10): projects/default/specs/... ← DEPRECATED
 ```
 
 #### Strategy Docs (Optional, High-Level) ⚠️

package/plugins/specweave-ado/lib/ado-project-detector.js

@@ -233,15 +233,15 @@ class AdoProjectDetector {
    */
   async detectFromContent(content) {
     const candidates = this.analyzeContent(content);
-    if (candidates[0]?.confidence > 0.7) {
+    if (candidates[0]?.confidence >= 0.7) {
       return {
         primary: candidates[0].project,
         confidence: candidates[0].confidence,
         strategy: this.strategy
       };
     }
-    if (candidates[0]?.confidence > 0.4) {
-      const secondary = candidates.slice(1).filter((c) => c.confidence > 0.3).map((c) => c.project);
+    if (candidates[0]?.confidence >= 0.4) {
+      const secondary = candidates.slice(1).filter((c) => c.confidence >= 0.3).map((c) => c.project);
       return {
         primary: candidates[0].project,
         secondary: secondary.length > 0 ? secondary : void 0,
@@ -306,7 +306,7 @@ class AdoProjectDetector {
    */
   async detectMultiProject(content) {
     const candidates = this.analyzeContent(content);
-    const significantProjects = candidates.filter((c) => c.confidence > 0.3);
+    const significantProjects = candidates.filter((c) => c.confidence >= 0.3);
     if (significantProjects.length === 0) {
       return {
         primary: this.availableProjects[0] || "Unknown",
@@ -328,11 +328,38 @@ class AdoProjectDetector {
    */
   mapToAreaPath(content, project) {
     const areaPaths = process.env.AZURE_DEVOPS_AREA_PATHS?.split(",").map((a) => a.trim()) || [];
+    const lowerContent = content.toLowerCase();
     for (const areaPath of areaPaths) {
-      if (content.toLowerCase().includes(areaPath.toLowerCase())) {
+      if (lowerContent.includes(areaPath.toLowerCase())) {
         return `${project}\\${areaPath}`;
       }
     }
+    const areaPathKeywordMap = {
+      "Frontend": ["WebApp", "frontend"],
+      "Backend": ["backend", "api", "server"],
+      "Mobile": ["MobileApp", "mobile", "ios", "android"],
+      "Infrastructure": ["Platform", "infrastructure"],
+      "Data": ["DataService", "data", "analytics"]
+    };
+    let bestMatch = { areaPath: "", confidence: 0 };
+    for (const areaPath of areaPaths) {
+      const relatedTypes = areaPathKeywordMap[areaPath] || [areaPath];
+      let matchCount = 0;
+      for (const projectType of relatedTypes) {
+        const keywords = this.projectKeywords[projectType] || [];
+        for (const keyword of keywords) {
+          if (lowerContent.includes(keyword.toLowerCase())) {
+            matchCount++;
+          }
+        }
+      }
+      if (matchCount > bestMatch.confidence) {
+        bestMatch = { areaPath, confidence: matchCount };
+      }
+    }
+    if (bestMatch.confidence >= 2) {
+      return `${project}\\${bestMatch.areaPath}`;
+    }
     return project;
   }
   /**

package/plugins/specweave-ado/lib/ado-project-detector.ts

@@ -202,7 +202,7 @@ export class AdoProjectDetector {
     const candidates = this.analyzeContent(content);
 
     // High confidence: Auto-select
-    if (candidates[0]?.confidence > 0.7) {
+    if (candidates[0]?.confidence >= 0.7) {
       return {
         primary: candidates[0].project,
         confidence: candidates[0].confidence,
@@ -211,10 +211,10 @@ export class AdoProjectDetector {
     }
 
     // Medium confidence: Primary with secondary projects
-    if (candidates[0]?.confidence > 0.4) {
+    if (candidates[0]?.confidence >= 0.4) {
       const secondary = candidates
         .slice(1)
-        .filter(c => c.confidence > 0.3)
+        .filter(c => c.confidence >= 0.3)
         .map(c => c.project);
 
       return {
@@ -299,7 +299,7 @@ export class AdoProjectDetector {
     const candidates = this.analyzeContent(content);
 
     // Get all projects with meaningful confidence
-    const significantProjects = candidates.filter(c => c.confidence > 0.3);
+    const significantProjects = candidates.filter(c => c.confidence >= 0.3);
 
     if (significantProjects.length === 0) {
       return {
@@ -330,13 +330,52 @@ export class AdoProjectDetector {
    */
   mapToAreaPath(content: string, project: string): string {
     const areaPaths = process.env.AZURE_DEVOPS_AREA_PATHS?.split(',').map(a => a.trim()) || [];
+    const lowerContent = content.toLowerCase();
 
+    // First try exact area path name match
     for (const areaPath of areaPaths) {
-      if (content.toLowerCase().includes(areaPath.toLowerCase())) {
+      if (lowerContent.includes(areaPath.toLowerCase())) {
         return `${project}\\${areaPath}`;
       }
     }
 
+    // Try keyword-based detection using PROJECT_KEYWORDS
+    // Map area paths to common project types
+    const areaPathKeywordMap: { [key: string]: string[] } = {
+      'Frontend': ['WebApp', 'frontend'],
+      'Backend': ['backend', 'api', 'server'],
+      'Mobile': ['MobileApp', 'mobile', 'ios', 'android'],
+      'Infrastructure': ['Platform', 'infrastructure'],
+      'Data': ['DataService', 'data', 'analytics']
+    };
+
+    let bestMatch = { areaPath: '', confidence: 0 };
+
+    for (const areaPath of areaPaths) {
+      // Get related project types for this area path
+      const relatedTypes = areaPathKeywordMap[areaPath] || [areaPath];
+      let matchCount = 0;
+
+      for (const projectType of relatedTypes) {
+        // Check if this project type has keywords defined
+        const keywords = this.projectKeywords[projectType] || [];
+        for (const keyword of keywords) {
+          if (lowerContent.includes(keyword.toLowerCase())) {
+            matchCount++;
+          }
+        }
+      }
+
+      if (matchCount > bestMatch.confidence) {
+        bestMatch = { areaPath, confidence: matchCount };
+      }
+    }
+
+    // Return best match if confidence is high enough
+    if (bestMatch.confidence >= 2) {
+      return `${project}\\${bestMatch.areaPath}`;
+    }
+
     // Default area path
     return project;
   }

package/src/templates/AGENTS.md.template

@@ -22,6 +22,11 @@ This is a **SpecWeave project** where specifications and documentation are the s
 
 ## Project Structure
 
+**IMPORTANT**: This project uses {MONOREPO_OR_SINGLE} mode.
+
+{#IF_SINGLE_PROJECT}
+### Single Project Structure
+
 ```
 .specweave/
 ├── increments/              # Feature increments (auto-numbered)
@@ -36,7 +41,8 @@ This is a **SpecWeave project** where specifications and documentation are the s
 │       └── reports/         # Analysis, completion reports
 ├── docs/internal/
 │   ├── strategy/            # Business specs (WHAT, WHY)
-│   ├── specs/               # Feature specifications (detailed requirements)
+│   ├── specs/               # Feature specifications (living docs)
+│   │   └── default/         # ✅ All specs in default project
 │   ├── architecture/        # Technical design (HOW)
 │   ├── delivery/            # Roadmap, CI/CD, guides
 │   ├── operations/          # Runbooks, SLOs
@@ -55,6 +61,54 @@ plugins/                     # Optional plugins (extended capabilities)
     ├── agents/              # Plugin-specific agents
     └── commands/            # Plugin-specific commands
 ```
+{#ENDIF}
+
+{#IF_MULTI_PROJECT}
+### Multi-Project Structure (v0.16.11+ Flattened)
+
+**CRITICAL**: Specs are organized by project with FLATTENED structure (v0.16.11+).
+
+```
+.specweave/
+├── docs/internal/
+│   ├── strategy/            # Cross-project strategy
+│   ├── specs/               # ✅ FLATTENED structure (v0.16.11+)
+│   │   ├── backend/         # Backend project specs
+│   │   │   ├── spec-001-api-auth.md
+│   │   │   └── spec-002-data-layer.md
+│   │   ├── frontend/        # Frontend project specs
+│   │   │   ├── spec-001-user-dashboard.md
+│   │   │   └── spec-002-dark-mode.md
+│   │   ├── mobile/          # Mobile project specs (if applicable)
+│   │   │   └── spec-001-push-notifications.md
+│   │   └── _parent/         # Parent repo specs (multi-repo only)
+│   │       └── spec-001-system-architecture.md
+│   ├── architecture/        # System-wide technical design
+│   ├── delivery/            # Cross-project delivery
+│   ├── operations/          # Cross-project operations
+│   └── governance/          # Cross-project governance
+├── increments/
+│   ├── 0001-backend-auth/   # Backend increment
+│   ├── 0002-frontend-ui/    # Frontend increment
+│   └── 0003-mobile-push/    # Mobile increment
+└── ...
+```
+
+**Living Docs Path Format**:
+- ✅ **CORRECT** (v0.16.11+): `.specweave/docs/internal/specs/{project-id}/spec-NNN-name.md`
+- ❌ **OLD** (v0.8.0-v0.16.10): `.specweave/docs/internal/projects/{project-id}/specs/...` (DEPRECATED)
+
+**Project Detection** (automatic):
+- **From increment name**: `0001-backend-auth` → project: `backend`
+- **From tech stack**: React/Next.js → `frontend`, ASP.NET/Node.js → `backend`
+- **From config**: `multiProject.activeProject` in `.specweave/config.json`
+- **Fallback**: Uses `default` project
+
+**When creating living docs specs**:
+1. Detect project from increment name or tech stack
+2. Use flattened path: `specs/{project-id}/spec-NNN-name.md`
+3. Never use old nested structure: `projects/{project-id}/specs/...`
+{#ENDIF}
 
 **CRITICAL**: Always read `context-manifest.yaml` first! Only load files listed there.
 

package/src/templates/CLAUDE.md.template

@@ -289,13 +289,19 @@ Config: Auto-detected from project files
 
 ## Project Structure
 
+**IMPORTANT**: This project uses {MONOREPO_OR_SINGLE} mode.
+
+{#IF_SINGLE_PROJECT}
+### Single Project Structure
+
 ```
 {PROJECT_NAME}/
 ├── .specweave/
 │   ├── docs/                    # Strategic documentation
 │   │   ├── internal/
 │   │   │   ├── strategy/        # Business specs (WHAT, WHY)
-│   │   │   ├── specs/           # Feature specifications (detailed requirements)
+│   │   │   ├── specs/           # Feature specifications (living docs)
+│   │   │   │   └── default/     # ✅ All specs in default project
 │   │   │   ├── architecture/    # Technical design (HOW)
 │   │   │   ├── delivery/        # Guides, roadmap, CI/CD
 │   │   │   ├── operations/      # Runbooks, monitoring
@@ -319,6 +325,50 @@ Config: Auto-detected from project files
 ├── CLAUDE.md                    # This file
 └── src/                         # Your source code
 ```
+{#ENDIF}
+
+{#IF_MULTI_PROJECT}
+### Multi-Project Structure (v0.16.11+ Flattened)
+
+**CRITICAL**: Specs are organized by project with FLATTENED structure (v0.16.11+).
+
+```
+{PROJECT_NAME}/
+├── .specweave/
+│   ├── docs/internal/
+│   │   ├── strategy/            # Cross-project strategy
+│   │   ├── specs/               # ✅ FLATTENED structure (v0.16.11+)
+│   │   │   ├── backend/         # Backend project specs
+│   │   │   │   ├── spec-001-api-auth.md
+│   │   │   │   └── spec-002-data-layer.md
+│   │   │   ├── frontend/        # Frontend project specs
+│   │   │   │   ├── spec-001-user-dashboard.md
+│   │   │   │   └── spec-002-dark-mode.md
+│   │   │   ├── mobile/          # Mobile project specs (if applicable)
+│   │   │   │   └── spec-001-push-notifications.md
+│   │   │   └── _parent/         # Parent repo specs (multi-repo only)
+│   │   │       └── spec-001-system-architecture.md
+│   │   ├── architecture/        # System-wide technical design
+│   │   ├── delivery/            # Cross-project delivery
+│   │   ├── operations/          # Cross-project operations
+│   │   └── governance/          # Cross-project governance
+│   ├── increments/
+│   │   ├── 0001-backend-auth/   # Backend increment
+│   │   ├── 0002-frontend-ui/    # Frontend increment
+│   │   └── 0003-mobile-push/    # Mobile increment
+│   └── ...
+```
+
+**Living Docs Path Format**:
+- ✅ **CORRECT** (v0.16.11+): `.specweave/docs/internal/specs/{project-id}/spec-NNN-name.md`
+- ❌ **OLD** (v0.8.0-v0.16.10): `.specweave/docs/internal/projects/{project-id}/specs/...` (DEPRECATED)
+
+**Project Detection** (automatic):
+- **From increment name**: `0001-backend-auth` → project: `backend`
+- **From tech stack**: React/Next.js → `frontend`, ASP.NET/Node.js → `backend`
+- **From config**: `multiProject.activeProject` in `.specweave/config.json`
+- **Fallback**: Uses `default` project
+{#ENDIF}
 
 ---
 

package/dist/locales/de/cli.json

@@ -1,108 +0,0 @@
-{
-  "init": {
-    "welcome": "🚀 SpecWeave Initialization",
-    "projectName": "Project name:",
-    "projectNamePrompt": "Project name (for templates):",
-    "projectNameDefault": "my-saas",
-    "detectingTool": "Detecting AI tool...",
-    "foundClaude": "✅ Found Claude Code",
-    "foundCursor": "✅ Found Cursor",
-    "foundCopilot": "✅ Found GitHub Copilot",
-    "noToolDetected": "No AI tool detected, using Generic adapter",
-    "complete": "✨ Initialization complete!",
-    "claudeNativeComplete": "✨ Claude Code native installation complete!",
-    "claudeNativeBenefits": "✅ Native skills, agents, hooks work out of the box",
-    "projectSuccess": "SpecWeave project created successfully!",
-    "readyToBuild": "🚀 Ready to build with SpecWeave!",
-    "errors": {
-      "invalidName": "Project name must contain only lowercase letters, numbers, and hyphens",
-      "alreadyExists": ".specweave directory already exists",
-      "cancelled": "❌ Initialization cancelled",
-      "invalidLanguage": "❌ Invalid language: {{language}}",
-      "supportedLanguages": "Supported languages: {{languages}}",
-      "nestedNotSupported": "❌ Nested .specweave/ folders are NOT supported!",
-      "parentFound": "Found parent .specweave/ at:",
-      "projectCreationFailed": "Failed to create project",
-      "commandsCopyFailed": "❌ Commands copy failed: {{error}}",
-      "agentsCopyFailed": "❌ Agents copy failed: {{error}}",
-      "skillsCopyFailed": "❌ Skills copy failed: {{error}}",
-      "hooksCopyFailed": "❌ Hooks copy failed: {{error}}"
-    },
-    "warnings": {
-      "invalidDirName": "⚠️  Current directory name '{{dirName}}' contains invalid characters.",
-      "directoryNotEmpty": "⚠️  Current directory contains {{count}} file{{plural}}.",
-      "skillsIndexWarning": "⚠️  Warning: Could not generate skills index: {{error}}",
-      "skillsIndexNote": "Skills will still work, but manual indexing may be needed."
-    },
-    "prompts": {
-      "confirmInitInCurrent": "Initialize SpecWeave in current directory?",
-      "overwriteSpecweave": ".specweave directory already exists. Overwrite?",
-      "overwriteDirectory": "Directory {{projectName}} already exists. Overwrite?",
-      "enablePlugins": "Enable suggested plugins now?"
-    },
-    "info": {
-      "nestedEnforcement": "SpecWeave enforces a single source of truth:",
-      "nestedBullet1": "• Use the parent folder for all increments",
-      "nestedBullet2": "• Increments can span multiple subdirectories",
-      "nestedBullet3": "• See CLAUDE.md section \"Root-Level .specweave/ Folder\"",
-      "nestedToFix": "To fix:",
-      "suggestedPlugins": "💡 Suggested Plugins:",
-      "copiedFiles": "✓ Copied {{count}} command files",
-      "copiedAgents": "✓ Copied {{count}} agent directories",
-      "copiedSkills": "✓ Copied {{count}} skill directories",
-      "copiedHooks": "✓ Copied {{count}} hook files"
-    },
-    "progress": {
-      "creatingProject": "Creating SpecWeave project...",
-      "detected": "Detected {{tool}}...",
-      "usingTool": "Using {{tool}}...",
-      "directoryCreated": "Directory structure created...",
-      "templatesCopied": "Base templates copied...",
-      "installingComponents": "Installing Claude Code components...",
-      "commandsInstalled": "Slash commands installed...",
-      "agentsInstalled": "Agents installed...",
-      "skillsInstalled": "Skills installed...",
-      "hooksInstalled": "Hooks installed...",
-      "generatingIndex": "Generating skills index...",
-      "indexGenerated": "Skills index generated...",
-      "installingAdapter": "Installing {{tool}} adapter...",
-      "projectSuccess": "SpecWeave project created successfully!",
-      "detectingPlugins": "Detecting plugins...",
-      "detectedPlugins": "Detected {{count}} suggested plugins",
-      "enablingPlugins": "Enabling plugins...",
-      "enabledPlugin": "Enabled {{plugin}}",
-      "pluginsEnabled": "Plugins enabled"
-    },
-    "nextSteps": {
-      "header": "🎯 Next steps:",
-      "cd": "cd {{projectName}}",
-      "footer": "🚀 Ready to build with SpecWeave!",
-      "docsLink": "Documentation: https://spec-weave.com",
-      "githubLink": "GitHub: https://github.com/anton-abyzov/specweave"
-    }
-  },
-  "increment": {
-    "creating": "📝 Creating increment: {name}",
-    "created": "✅ Increment {id} created successfully!",
-    "nextStepDo": "Next: Run /specweave.do to start implementation",
-    "errors": {
-      "incompleteFound": "Cannot create new increment! Previous increments incomplete"
-    }
-  },
-  "progress": {
-    "currentIncrement": "Current Increment: {id}",
-    "status": "Status: {status}",
-    "completion": "Completion: {percent}%"
-  },
-  "translate": {
-    "translating": "🌐 Translating content to {language}...",
-    "complete": "✅ Translation complete!"
-  },
-  "version": {
-    "current": "SpecWeave version: {version}"
-  },
-  "errors": {
-    "fileNotFound": "❌ File not found: {path}",
-    "invalidConfig": "❌ Invalid configuration: {error}"
-  }
-}