sdd-pipeline 1.2.4 → 1.2.7

package/lib/bundle/.claude/commands/sdd-task-status.md

@@ -4,54 +4,114 @@ tool: Bash
 when: always
 description: Update task status in MASTER-TASKS.md + .sdd/config.json. Args: <T-XXX> <pending|in-progress|completed>. Recalculates progress counters, suggests next task.
 ---
+$ErrorActionPreference = "Stop"
+
+# --- SDD Path Resolution ---
+$SDD_TASKS_DIR = "sdd/tasks"
+
+if (Test-Path ".sdd/config.json") {
+    try {
+        $config = Get-Content ".sdd/config.json" -Raw | ConvertFrom-Json
+        if ($config.output -and $config.output.tasksDir) {
+            $SDD_TASKS_DIR = $config.output.tasksDir
+        }
+    } catch {}
+}
+
+# --- Parse arguments ---
 $taskId = $args[0]
 $newStatus = $args[1]
 
 if (-not $taskId -or -not $newStatus) {
-    Write-Host "Usage: /sdd-task-status T-001 done"
-    Write-Host "Usage: /sdd-task-status T-001 in-progress"
-    Write-Host "Usage: /sdd-task-status T-001 pending"
+    Write-Host ""
+    Write-Host "Usage: /sdd-task-status T-001 done" -ForegroundColor White
+    Write-Host "       /sdd-task-status T-001 in-progress" -ForegroundColor White
+    Write-Host "       /sdd-task-status T-001 pending" -ForegroundColor White
     exit 1
 }
 
+# Map status to display format
+$statusMap = @{
+    "pending"      = "[ ]"
+    "in-progress" = "[>]"
+    "completed"   = "[x]"
+    "done"        = "[x]"
+    "x"           = "[x]"
+}
+
+$displayStatus = $statusMap[$newStatus]
+if (-not $displayStatus) {
+    $displayStatus = "[ ]"
+}
+
 # Validate status
-$validStatuses = @("pending", "in-progress", "completed")
+$validStatuses = @("pending", "in-progress", "completed", "done", "x")
 if ($validStatuses -notcontains $newStatus) {
+    Write-Host ""
     Write-Host "ERROR: Invalid status '$newStatus'. Use: pending, in-progress, completed" -ForegroundColor Red
     exit 1
 }
 
-# Find task directory
-$taskDirs = Get-ChildItem -Filter "task-*-*" -Directory -ErrorAction SilentlyContinue
-if (-not $taskDirs) {
-    Write-Host "ERROR: No task directory found. Run /sdd-tasks first." -ForegroundColor Red
+# --- Find task directory (check new path first, then legacy) ---
+$taskDir = $null
+
+# Check new location
+if (Test-Path $SDD_TASKS_DIR) {
+    $taskDirs = Get-ChildItem -Path $SDD_TASKS_DIR -Filter "task-*-*" -Directory -ErrorAction SilentlyContinue
+    if ($taskDirs) {
+        $taskDir = Join-Path $SDD_TASKS_DIR ($taskDirs | Select-Object -First 1).Name
+    }
+}
+
+# Fallback to legacy location
+if (-not $taskDir) {
+    $legacyTaskDirs = Get-ChildItem -Filter "task-*-*" -Directory -ErrorAction SilentlyContinue
+    if ($legacyTaskDirs) {
+        $taskDir = ($legacyTaskDirs | Select-Object -First 1).FullName
+        Write-Host "[LEGACY] Task directory found at legacy location: $taskDir" -ForegroundColor Yellow
+    }
+}
+
+if (-not $taskDir) {
+    Write-Host ""
+    Write-Host "ERROR: No task directory found." -ForegroundColor Red
+    Write-Host "Run /sdd-tasks first." -ForegroundColor Yellow
     exit 1
 }
-$taskDir = ($taskDirs | Select-Object -First 1).Name
-$taskFile = Join-Path $taskDir "${taskId}-*.md"
 
-# Find task file
+# --- Find task file ---
 $taskFiles = Get-ChildItem -Path $taskDir -Filter "${taskId}-*.md" -ErrorAction SilentlyContinue
+$taskFiles = $taskFiles | Where-Object { $_.Name -ne "MASTER-TASKS.md" }
 $taskFilePath = ($taskFiles | Select-Object -First 1).FullName
 
 if (-not $taskFilePath) {
+    Write-Host ""
     Write-Host "ERROR: $taskId not found in $taskDir" -ForegroundColor Red
     exit 1
 }
 
-# Update task file status in frontmatter
+# --- Update task file status in frontmatter ---
+$frontmatterStatus = $newStatus
+if ($newStatus -in @("done", "x")) {
+    $frontmatterStatus = "completed"
+}
+
 $content = Get-Content $taskFilePath -Raw
-$content = $content -replace '(?m)^(status:\s*)\S+', "`$1$newStatus"
+$content = $content -replace '(?m)^(status:\s*)\S+', "`$1$frontmatterStatus"
 Set-Content $taskFilePath $content -Encoding UTF8
 
-# Update MASTER-TASKS.md
+# --- Update MASTER-TASKS.md ---
 $masterPath = Join-Path $taskDir "MASTER-TASKS.md"
 $masterContent = Get-Content $masterPath -Raw
 
-# Update task table row status
-$pattern = "(\|\s*T-\d+\s*\|\s*[^\|]+\|\s*)\S+(\s*\|\s*[^\|]+\s*\|)"
-$replacement = '${1}' + $newStatus + '${2}'
-$masterContent = $masterContent -replace $pattern, $replacement
+# Update task table row status - handle both [ ] and [x] patterns
+# Pattern matches the status column and replaces it
+$pattern = "(\|\s*$taskId\s*\|\s*[^\|]+\|\s*[^\|]+\|\s*)\[[^\]]\](\s*\|)"
+$masterContent = $masterContent -replace $pattern, "`$1$displayStatus`$2"
+
+# Also handle T-XXX format with status in brackets
+$pattern2 = "(\|\s*T-\d+\s*\|\s*[^\|]+\|\s*[^\|]+\|\s*)\[[^\]]\](\s*\|)"
+$masterContent = $masterContent -replace $pattern2, "`$1$displayStatus`$2"
 
 # Update progress counters
 $allTaskFiles = Get-ChildItem -Path $taskDir -Filter "T-*.md" | Where-Object { $_.Name -ne "MASTER-TASKS.md" }
@@ -65,31 +125,41 @@ foreach ($f in $allTaskFiles) {
     elseif ($c -match '(?m)^status:\s*in-progress') { $inProgress++ }
 }
 
+# Update "Completed: X / N" pattern
 $masterContent = $masterContent -replace 'Completed: \d+ / \d+', "Completed: $completed / $total"
+# Update "In Progress: X" pattern
 $masterContent = $masterContent -replace 'In Progress: \d+', "In Progress: $inProgress"
+# Update "Pending: X" pattern
 $masterContent = $masterContent -replace 'Pending: \d+', "Pending: $($total - $completed - $inProgress)"
 
 Set-Content $masterPath $masterContent -Encoding UTF8
 
-# Update .sdd/config.json
+# --- Update .sdd/config.json ---
 if (Test-Path ".sdd/config.json") {
-    $config = Get-Content ".sdd/config.json" | ConvertFrom-Json
-    if (-not $config.tasks) { $config | Add-Member -NotePropertyName "tasks" -NotePropertyValue ([ordered]@{}) }
-    $config.tasks.$taskId = $newStatus
-    $config | ConvertTo-Json | Set-Content ".sdd/config.json"
+    try {
+        $config = Get-Content ".sdd/config.json" -Raw | ConvertFrom-Json
+        if (-not $config.tasks) { $config | Add-Member -NotePropertyName "tasks" -NotePropertyValue ([ordered]@{}) }
+        $config.tasks.$taskId = $frontmatterStatus
+        $config | ConvertTo-Json -Depth 10 | Set-Content ".sdd/config.json"
+    } catch {}
 }
 
-Write-Host "[OK] $taskId -> $newStatus" -ForegroundColor Green
-Write-Host "  Progress: $completed/$total completed, $inProgress in-progress"
+# --- Summary ---
+$statusColor = if ($frontmatterStatus -eq "completed") { "Green" } elseif ($frontmatterStatus -eq "in-progress") { "Yellow" } else { "Gray" }
+Write-Host ""
+Write-Host "[OK] $taskId -> $displayStatus" -ForegroundColor Green
+Write-Host "      Progress: $completed/$total completed, $inProgress in-progress" -ForegroundColor Gray
+Write-Host "      Task file: $taskFilePath" -ForegroundColor Gray
 
 # Suggest next task
-if ($newStatus -eq "completed") {
+if ($frontmatterStatus -eq "completed") {
     $pending = Get-ChildItem -Path $taskDir -Filter "T-*.md" | Where-Object {
         $_.Name -ne "MASTER-TASKS.md" -and
         ((Get-Content $_.FullName -Raw) -notmatch '(?m)^status:\s*completed')
     }
     if ($pending) {
         $next = ($pending | Select-Object -First 1).Name -replace '\.md$', ''
-        Write-Host "  Next: /sdd-task-status $next in-progress" -ForegroundColor Cyan
+        Write-Host ""
+        Write-Host "Next: /sdd-task-status $next in-progress" -ForegroundColor Cyan
     }
 }

package/lib/bundle/bin/sdd.cjs

@@ -0,0 +1,201 @@
+#!/usr/bin/env node
+// sdd — Spec-Driven Development CLI
+// Unified entry point for both npm package and local development
+
+const path = require('path')
+const fs = require('fs')
+
+// Determine if we're in npm package or local development
+const isNpmPackage = fs.existsSync(path.join(__dirname, 'lib/bmad.js'))
+const libDir = isNpmPackage ? path.join(__dirname, 'lib') : path.join(__dirname, '..', 'lib')
+
+// Dynamic requires
+const init = require(path.join(libDir, 'init'))
+const bmad = require(path.join(libDir, 'bmad/index'))
+const config = require(path.join(libDir, 'config'))
+
+const args = process.argv.slice(2)
+const cmd = args[0]
+
+// PowerShell detection - use correct command for platform
+function getPowerShellCommand() {
+  if (process.platform === 'win32') {
+    // Windows: try powershell.exe first (always available), then pwsh
+    const system32 = 'C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe'
+    if (fs.existsSync(system32)) {
+      return 'powershell'
+    }
+    return 'powershell' // Fallback to whatever is in PATH
+  }
+  return 'pwsh' // macOS/Linux: PowerShell Core
+}
+
+function runPowerShellScript(scriptPath, scriptArgs, callback) {
+  const psCmd = getPowerShellCommand()
+  const psArgs = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', scriptPath, ...scriptArgs]
+
+  const { spawn } = require('child_process')
+  const ps = spawn(psCmd, psArgs, {
+    stdio: 'inherit',
+    shell: false,
+    windowsHide: true
+  })
+
+  ps.on('error', (err) => {
+    callback(err, null)
+  })
+
+  ps.on('close', (code) => {
+    callback(null, code)
+  })
+}
+
+switch (cmd) {
+  case 'init':
+    init.run()
+    break
+
+  case 'bmad': {
+    const input = args.slice(1).join(' ')
+    if (!input) {
+      console.error('Usage: sdd bmad <feature description>')
+      console.error('Example: sdd bmad "landing page for my SaaS product"')
+      console.error('')
+      console.error('For interactive mode (9-question interview), use Claude Code:')
+      console.error('  claude "/sdd-bmad landing page for my SaaS"')
+      process.exit(1)
+    }
+
+    // Try to run PowerShell script if available
+    const commandsDir = isNpmPackage
+      ? path.join(libDir, 'bundle', '.claude', 'commands')
+      : path.join(__dirname, '..', '.claude', 'commands')
+    const bmadScript = path.join(commandsDir, 'sdd-bmad.md')
+
+    // Note: Claude Code commands are .md files designed for Claude Code CLI
+    // PowerShell cannot run .md files directly
+    // So we always use the Node.js module for fast mode
+
+    // Generate brief using Node.js module
+    const session = bmad.init(input)
+    const result = bmad.generateBrief()
+
+    console.log('[OK] sdd/brief.md created.')
+    console.log(`Confidence: ${result.confidence.score}/100 — ${result.confidence.level}`)
+    console.log('')
+    console.log('Output: sdd/brief.md')
+    console.log('')
+    if (result.confidence.score < 70) {
+      console.log('Tip: For higher confidence, use Claude Code with interactive mode:')
+      console.log('  claude "/sdd-bmad ' + input.substring(0, 30) + '..."')
+    }
+    console.log('')
+    console.log('Next: claude "/sdd-spec" to generate SPEC.md')
+    console.log('      (or use Claude Code for full interactive experience)')
+    break
+  }
+
+  case 'spec':
+    console.log('=== SDD SPEC Generation ===')
+    console.log('')
+    console.log('This command requires Claude Code for best results.')
+    console.log('')
+    console.log('Run: claude "/sdd-spec"')
+    console.log('')
+    console.log('Claude Code will:')
+    console.log('  1. Read sdd/brief.md')
+    console.log('  2. Validate confidence score (requires >= 20)')
+    console.log('  3. Generate sdd/SPEC.md from template')
+    break
+
+  case 'tasks':
+    console.log('=== SDD Task Generation ===')
+    console.log('')
+    console.log('This command requires Claude Code.')
+    console.log('')
+    console.log('Run: claude "/sdd-tasks"')
+    console.log('')
+    console.log('Claude Code will:')
+    console.log('  1. Read sdd/SPEC.md')
+    console.log('  2. Extract features from Section 4.1')
+    console.log('  3. Generate sdd/tasks/task-*/ directory')
+    console.log('  4. Create MASTER-TASKS.md and T-XXX-*.md files')
+    break
+
+  case 'cook':
+    console.log('=== SDD Implementation ===')
+    console.log('')
+    console.log('This command requires Claude Code.')
+    console.log('')
+    console.log('Run: claude "/sdd-cook"')
+    console.log('')
+    console.log('Claude Code will:')
+    console.log('  1. Read sdd/tasks/task-*/MASTER-TASKS.md')
+    console.log('  2. Execute tasks sequentially')
+    console.log('  3. Scout, implement, test, review each task')
+    console.log('')
+    console.log('Flags:')
+    console.log('  --all      Execute all pending tasks')
+    console.log('  --task T-001  Execute specific task')
+    break
+
+  case 'converge':
+    console.log('=== SDD Converge Validation ===')
+    console.log('')
+    console.log('Full validation (requires dev server):')
+    console.log('  pwsh run-converge.ps1 -Url http://localhost:3000 -Strict')
+    console.log('')
+    console.log('Per-task validation:')
+    console.log('  pwsh run-converge.ps1 -TaskId T-001')
+    console.log('')
+    console.log('Claude Code:')
+    console.log('  claude "/sdd-converge"')
+    break
+
+  case 'status': {
+    config.printStatus()
+    break
+  }
+
+  case 'help':
+  default:
+    if (cmd && cmd !== 'help') {
+      console.error(`Unknown command: ${cmd}\n`)
+    }
+    console.log(`
+sdd — Spec-Driven Development CLI
+
+Output Structure (v1.1.0+):
+  sdd/                    All generated artifacts
+    brief.md             Phase 0: BMAD brief
+    SPEC.md              Phase 2: Specification
+    tasks/              Phase 3: Task directories
+    converge/           Phase 5: Validation reports
+
+Usage:
+  sdd init               Initialize SDD pipeline
+  sdd bmad <desc>       Phase 0: Generate brief (fast mode)
+  sdd status             Show pipeline status
+  sdd help               Show this help
+
+Full Pipeline (requires Claude Code):
+  claude "/sdd-bmad"    Interactive 9-question interview (high confidence)
+  claude "/sdd-spec"    Generate SPEC.md
+  claude "/sdd-tasks"   Generate task directory
+  claude "/sdd-cook"    Execute implementation
+  claude "/sdd-converge"  Validate implementation
+
+Quick Start:
+  1. sdd init
+  2. sdd bmad "my feature idea"
+  3. claude "/sdd-spec"
+  4. claude "/sdd-tasks"
+  5. claude "/sdd-cook"
+  6. claude "/sdd-converge"
+
+Notes:
+- Claude Code CLI provides the best experience with interactive commands
+- Install Claude Code: npm install -g @anthropic-ai/claude-code
+- Without Claude Code, use "sdd bmad" for fast mode (lower confidence)
+`)
+}

package/lib/bundle/bin/sdd.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+// sdd — Spec-Driven Development CLI
+// Unified entry point for both npm package and local development
+
+const path = require('path')
+const fs = require('fs')
+const { spawn } = require('child_process')
+
+// Determine if we're in npm package or local development
+const isNpmPackage = fs.existsSync(path.join(__dirname, 'lib/bmad.js'))
+const libDir = isNpmPackage ? path.join(__dirname, 'lib') : path.join(__dirname, '..', 'lib')
+
+// Dynamic requires
+const init = require(path.join(libDir, 'init'))
+const bmad = require(path.join(libDir, 'bmad/index'))
+const config = require(path.join(libDir, 'config'))
+
+const args = process.argv.slice(2)
+const cmd = args[0]
+
+// PowerShell detection - use correct command for platform
+function getPowerShellCommand() {
+  if (process.platform === 'win32') {
+    // Windows: try powershell.exe first (always available), then pwsh
+    const system32 = 'C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe'
+    if (fs.existsSync(system32)) {
+      return 'powershell'
+    }
+    return 'powershell' // Fallback to whatever is in PATH
+  }
+  return 'pwsh' // macOS/Linux: PowerShell Core
+}
+
+async function runPowerShellCommand(scriptPath, args = []) {
+  return new Promise((resolve, reject) => {
+    const psCmd = getPowerShellCommand()
+    const psArgs = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', scriptPath, ...args]
+
+    const ps = spawn(psCmd, psArgs, {
+      stdio: 'inherit',
+      shell: false,
+      windowsHide: true
+    })
+
+    ps.on('error', (err) => {
+      reject(err)
+    })
+
+    ps.on('close', (code) => {
+      resolve(code)
+    })
+  })
+}
+
+switch (cmd) {
+  case 'init':
+    init.run()
+    break
+
+  case 'bmad': {
+    const input = args.slice(1).join(' ')
+    if (!input) {
+      console.error('Usage: sdd bmad <feature description>')
+      console.error('Example: sdd bmad "landing page for my SaaS product"')
+      console.error('')
+      console.error('For interactive mode (9-question interview), use Claude Code:')
+      console.error('  claude "/sdd-bmad landing page for my SaaS"')
+      process.exit(1)
+    }
+
+    // Try interactive mode via PowerShell
+    const commandsDir = isNpmPackage
+      ? path.join(libDir, 'bundle', '.claude', 'commands')
+      : path.join(__dirname, '..', '.claude', 'commands')
+    const bmadScript = path.join(commandsDir, 'sdd-bmad.md')
+
+    if (fs.existsSync(bmadScript)) {
+      try {
+        await runPowerShellCommand(bmadScript, [input])
+        process.exit(0)
+      } catch (err) {
+        // PowerShell not available - fall back to non-interactive
+        console.warn('[sdd] PowerShell not available, using fast mode.')
+      }
+    }
+
+    // Non-interactive mode: generate brief directly
+    const session = bmad.init(input)
+    const result = bmad.generateBrief()
+    console.log('[OK] sdd/brief.md created.')
+    console.log(`Confidence: ${result.confidence.score}/100 — ${result.confidence.level}`)
+    console.log('')
+    if (result.confidence.score < 70) {
+      console.log('Tip: Use Claude Code "/sdd-bmad" for interactive mode with 9 questions.')
+    }
+    console.log('Next: claude "/sdd-spec" to generate SPEC.md')
+    break
+  }
+
+  case 'spec':
+    console.log('Run: claude "/sdd-spec" to generate SPEC.md')
+    console.log('(SPEC generation requires Claude Code for best results)')
+    break
+
+  case 'tasks':
+    console.log('Run: claude "/sdd-tasks" to generate TASKS.md')
+    console.log('(Task generation requires Claude Code)')
+    break
+
+  case 'cook':
+    console.log('Run: claude "/sdd-cook" to execute tasks')
+    console.log('(Implementation requires Claude Code)')
+    break
+
+  case 'converge':
+    console.log('Run: pwsh run-converge.ps1 -Strict to run converge')
+    console.log('')
+    console.log('For full validation:')
+    console.log('  pwsh run-converge.ps1 -Url http://localhost:3000 -Strict')
+    break
+
+  case 'status':
+    config.printStatus()
+    break
+
+  case 'help':
+  default:
+    if (cmd && cmd !== 'help') {
+      console.error(`Unknown command: ${cmd}\n`)
+    }
+    console.log(`
+sdd — Spec-Driven Development CLI
+
+Output Structure (v1.1.0+):
+  sdd/                    All generated artifacts
+    brief.md             Phase 0: BMAD brief
+    SPEC.md              Phase 2: Specification
+    tasks/              Phase 3: Task directories
+    converge/           Phase 5: Validation reports
+
+Usage:
+  sdd init               Initialize SDD pipeline
+  sdd bmad <desc>       Phase 0: Generate brief (fast mode)
+  sdd status             Show pipeline status
+  sdd help               Show this help
+
+Full Pipeline (requires Claude Code):
+  claude "/sdd-bmad"    Interactive 9-question interview (high confidence)
+  claude "/sdd-spec"    Generate SPEC.md
+  claude "/sdd-tasks"   Generate task directory
+  claude "/sdd-cook"    Execute implementation
+  pwsh run-converge.ps1 Phase 5: Validate
+
+Notes:
+- Interactive commands require Claude Code CLI
+- Run "npm install -g @anthropic-ai/claude-code" to enable Claude Code
+- Without Claude Code, use fast mode for quick briefs (lower confidence)
+`)
+}