specweave 0.17.13 → 0.17.15

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}
 
 ---