specweave 0.16.1 → 0.16.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "0.16.1",
+  "version": "0.16.2",
   "description": "Spec-driven development framework for Claude Code. AI-native workflow with living documentation, intelligent agents, and multilingual support (9 languages). Enterprise-grade traceability with permanent specs and temporary increments.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/hooks/post-increment-planning.sh

@@ -347,16 +347,52 @@ create_github_issue() {
     }
   ' "$tasks_file")
 
-  # Detect repository from git remote
-  local repo=$(git remote get-url origin 2>/dev/null | sed 's/.*github\.com[:/]\(.*\)\.git/\1/' | sed 's/.*github\.com[:/]\(.*\)/\1/')
+  # Detect repository from profile-based config
+  local repo=""
+  local owner=""
+  local repo_name=""
 
+  # First, check if increment has a specific githubProfile in metadata
+  local metadata_file="$2/metadata.json"
+  local profile_id=""
+
+  if [ -f "$metadata_file" ]; then
+    profile_id=$(cat "$metadata_file" 2>/dev/null | grep -o '"githubProfile"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*"\([^"]*\)".*/\1/')
+    log_debug "Found githubProfile in metadata: $profile_id"
+  fi
+
+  # If no profile in metadata, use activeProfile from config
+  if [ -z "$profile_id" ]; then
+    profile_id=$(cat "$CONFIG_FILE" 2>/dev/null | grep -o '"activeProfile"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*"\([^"]*\)".*/\1/')
+    log_debug "Using activeProfile from config: $profile_id"
+  fi
+
+  if [ -n "$profile_id" ]; then
+    # Extract owner and repo from the profile
+    local profile_section=$(cat "$CONFIG_FILE" 2>/dev/null | awk "/$profile_id/,/^[[:space:]]*\}/{print}")
+    owner=$(echo "$profile_section" | grep -o '"owner"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*"\([^"]*\)".*/\1/')
+    repo_name=$(echo "$profile_section" | grep -o '"repo"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*"\([^"]*\)".*/\1/')
+
+    if [ -n "$owner" ] && [ -n "$repo_name" ]; then
+      repo="$owner/$repo_name"
+      log_debug "Using repo from profile: $repo"
+    fi
+  fi
+
+  # Fallback to git remote detection if no profile config found
+  if [ -z "$repo" ]; then
+    repo=$(git remote get-url origin 2>/dev/null | sed 's/.*github\.com[:/]\(.*\)\.git/\1/' | sed 's/.*github\.com[:/]\(.*\)/\1/')
+    log_debug "Fallback to git remote: $repo"
+  fi
+
+  # Legacy fallback to old config format
   if [ -z "$repo" ]; then
-    # Fallback to config
     repo=$(cat "$CONFIG_FILE" 2>/dev/null | grep -A 5 '"sync"' | grep -o '"repo"[[:space:]]*:[[:space:]]*"[^"]*"' | sed 's/.*"\([^"]*\)".*/\1/')
+    log_debug "Legacy fallback to old config: $repo"
   fi
 
   if [ -z "$repo" ]; then
-    log_error "Could not detect GitHub repository"
+    log_error "Could not detect GitHub repository from profile or git remote"
     return 1
   fi
 
@@ -444,7 +480,15 @@ EOF
     # Update existing metadata.json with github section
     if command -v jq >/dev/null 2>&1; then
       local temp_metadata=$(mktemp)
-      jq ". + {\"github\": {\"issue\": $issue_number, \"url\": \"$issue_url\", \"synced\": \"$current_timestamp\"}}" "$metadata_file" > "$temp_metadata"
+      local jq_update=". + {\"github\": {\"issue\": $issue_number, \"url\": \"$issue_url\", \"synced\": \"$current_timestamp\"}"
+
+      # Add profile ID if we have it
+      if [ -n "$profile_id" ]; then
+        jq_update="$jq_update, \"githubProfile\": \"$profile_id\""
+        jq_update=". + {\"github\": {\"issue\": $issue_number, \"url\": \"$issue_url\", \"synced\": \"$current_timestamp\"}, \"githubProfile\": \"$profile_id\"}"
+      fi
+
+      jq "$jq_update" "$metadata_file" > "$temp_metadata"
       mv "$temp_metadata" "$metadata_file"
     else
       # Fallback: manual JSON construction (less reliable)
@@ -455,6 +499,7 @@ EOF
   "status": "active",
   "type": "feature",
   "created": "$current_timestamp",
+  "githubProfile": "$profile_id",
   "github": {
     "issue": $issue_number,
     "url": "$issue_url",

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

@@ -149,12 +149,19 @@ User: "I want to build real-time price tracking"
     ↓
 increment-planner skill
     ↓
-STEP 1: Scan existing docs
+STEP 1: Determine increment number and check for duplicates
+├─ Use the Bash tool to run: node plugins/specweave/skills/increment-planner/scripts/feature-utils.js next
+├─ Get next available increment number (e.g., "0021")
+├─ Get short name from user description
+├─ Check if increment already exists using: node plugins/specweave/skills/increment-planner/scripts/feature-utils.js check-increment {number}
+└─ If duplicate found, STOP and tell user: "Increment {number} already exists! Please use the existing increment."
+    ↓
+STEP 2: Scan existing docs
 ├─ Read .specweave/docs/internal/strategy/ (existing requirements)
 ├─ Read .specweave/docs/internal/architecture/adr/ (existing decisions)
 └─ Pass existing context to agents
     ↓
-STEP 2: Invoke PM Agent (🚨 MANDATORY - USE TASK TOOL)
+STEP 3: Invoke PM Agent (🚨 MANDATORY - USE TASK TOOL)
 
 YOU MUST USE THE TASK TOOL - DO NOT SKIP:
 
@@ -206,7 +213,7 @@ Task(
 
 Wait for PM agent to complete!
     ↓
-STEP 3: Invoke Architect Agent (🚨 MANDATORY - USE TASK TOOL)
+STEP 4: Invoke Architect Agent (🚨 MANDATORY - USE TASK TOOL)
 
 YOU MUST USE THE TASK TOOL - DO NOT SKIP:
 
@@ -239,7 +246,7 @@ Task(
 
 Wait for Architect agent to complete!
     ↓
-STEP 4: Invoke Test-Aware Planner Agent (🚨 MANDATORY - USE TASK TOOL)
+STEP 5: Invoke Test-Aware Planner Agent (🚨 MANDATORY - USE TASK TOOL)
 
 YOU MUST USE THE TASK TOOL - DO NOT SKIP:
 
@@ -275,7 +282,7 @@ Task(
 
 Wait for test-aware-planner agent to complete!
     ↓
-STEP 5: Validate Living Docs and Increment Files
+STEP 6: Validate Living Docs and Increment Files
 ├─ Check .specweave/docs/internal/specs/spec-{number}-{name}/spec.md exists (SOURCE OF TRUTH)
 ├─ Check living spec.md contains ALL user stories, requirements, AC-IDs (with AC-IDs)
 ├─ Check .specweave/docs/internal/architecture/adr/ has ≥3 ADRs

package/plugins/specweave/skills/increment-planner/scripts/feature-utils.js

@@ -3,8 +3,12 @@
  * Supports increment-planner skill with auto-numbering and name generation
  */
 
-const fs = require('fs');
-const path = require('path');
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
 
 /**
  * Stop words to filter from feature descriptions
@@ -198,7 +202,7 @@ function parseFeatureDescription(description) {
   };
 }
 
-module.exports = {
+export {
   generateShortName,
   getNextFeatureNumber,
   featureExists,
@@ -210,8 +214,8 @@ module.exports = {
   STOP_WORDS
 };
 
-// CLI usage
-if (require.main === module) {
+// CLI usage - check if this file is being run directly
+if (import.meta.url === `file://${process.argv[1]}`) {
   const args = process.argv.slice(2);
 
   if (args.length === 0) {
@@ -219,6 +223,7 @@ if (require.main === module) {
     console.log('  node feature-utils.js shortname "feature description"');
     console.log('  node feature-utils.js next [features-dir]');
     console.log('  node feature-utils.js parse "feature description"');
+    console.log('  node feature-utils.js check-increment <number> [features-dir]');
     process.exit(0);
   }
 
@@ -243,6 +248,22 @@ if (require.main === module) {
       }
       break;
 
+    case 'check-increment':
+      if (args[1]) {
+        const incrementNumber = args[1];
+        const checkDir = args[2] || '.specweave/increments';
+        if (incrementNumberExists(incrementNumber, checkDir)) {
+          console.error(`ERROR: Increment ${incrementNumber} already exists!`);
+          process.exit(1);
+        } else {
+          console.log(`OK: Increment ${incrementNumber} is available`);
+        }
+      } else {
+        console.error('Error: Increment number required');
+        process.exit(1);
+      }
+      break;
+
     default:
       console.error(`Unknown command: ${command}`);
       process.exit(1);

package/src/templates/CLAUDE.md.template

@@ -208,11 +208,10 @@ Both approaches work perfectly - use whichever feels more natural!
 ### Increment Structure
 
 ```
-.specweave/increments/0001-user-auth/
+.specweave/increments/0001-user-auth/   # ⚠️ ID must be unique!
 ├── spec.md                      # WHAT & WHY
 ├── plan.md                      # HOW
-├── tasks.md                     # Implementation steps
-├── tests.md                     # Test strategy
+├── tasks.md                     # Implementation steps with embedded tests
 ├── context-manifest.yaml        # Selective context loading
 ├── logs/                        # ✅ Execution logs, errors, AI sessions
 ├── scripts/                     # ✅ Helper scripts, migrations, setup
@@ -278,12 +277,11 @@ Config: Auto-detected from project files
 │   │   │   ├── operations/      # Runbooks, monitoring
 │   │   │   └── governance/      # Security, compliance
 │   │   └── public/              # Published docs
-│   ├── increments/              # Features (auto-numbered)
-│   │   └── 0001-feature-name/
-│   │       ├── spec.md
-│   │       ├── plan.md
-│   │       ├── tasks.md
-│   │       ├── tests.md
+│   ├── increments/              # Features (auto-numbered, UNIQUE IDs)
+│   │   └── 0001-feature-name/   # ⚠️ Each ID must be unique (0001-9999)
+│   │       ├── spec.md          # What we're building
+│   │       ├── plan.md          # How we'll build it
+│   │       ├── tasks.md         # Tasks with embedded tests
 │   │       ├── logs/            # ✅ Put logs here
 │   │       ├── scripts/         # ✅ Put scripts here
 │   │       └── reports/         # ✅ Put reports here
@@ -436,6 +434,7 @@ Plugins are detected and suggested during `specweave init` based on:
 4. **Validated**: Every increment validated before closure
 5. **Traceable**: All work traces back to specs and requirements
 6. **Clean Organization**: All supporting files in increment folders, never root
+7. **No Duplicate Increments**: Each increment must have a unique 4-digit ID (0001-9999)
 
 ---