sdd-pipeline 1.3.2 → 1.3.3

package/README.md

@@ -80,6 +80,7 @@ Raw Idea
 |-------|---------|--------|------|
 | 0 | `sdd bmad "idea"` | `sdd/brief.md` | None |
 | 0 | `claude "/sdd-bmad"` | `sdd/brief.md` (interactive) | None |
+| 0 | `claude "/sdd-bmad --batch answers.json"` | `sdd/brief.md` | None (CI/CD mode) |
 | 2 | `claude "/sdd-spec"` | `sdd/SPEC.md` | Requires `sdd/brief.md` + confidence ≥20 |
 | 3 | `claude "/sdd-tasks"` | `sdd/tasks/task-*/` | Requires `sdd/SPEC.md` |
 | 4 | `claude "/sdd-cook"` | Code | Requires task files |
@@ -96,6 +97,7 @@ Raw Idea
 | `sdd init` | — | `.sdd/`, `templates/`, `sdd/`, `skills/` | Initialize SDD pipeline. Run once per project. |
 | `sdd bmad <desc>` | 0 | `sdd/brief.md` | Fast mode brief (low confidence). |
 | `claude "/sdd-bmad <desc>"` | 0 | `sdd/brief.md` | Interactive 9-question brainstorm. Generates confidence-scored brief. |
+| `claude "/sdd-bmad --batch answers.json <desc>"` | 0 | `sdd/brief.md` | Batch mode for CI/CD. Pre-defined answers file. |
 | `claude "/sdd-spec"` | 2 | `sdd/SPEC.md` | Generate SPEC.md from brief. Validates confidence ≥20/100. |
 | `claude "/sdd-tasks"` | 3 | `sdd/tasks/task-*/` | Break SPEC.md into tasks (≤2 hours each). |
 | `claude "/sdd-cook [--all\|--task T-XXX]"` | 4 | Code | Unified: execution plan + implementation guidance + status tracking. |

package/lib/bundle/.claude/commands/sdd-cook.md

@@ -5,7 +5,10 @@
 tool: Bash
 when: always
 args: optional
-description: Phase 4 — Implement tasks from MASTER-TASKS.md. Args: [--all | --task T-XXX] [--dry-run]. Reads task file, shows requirements, guides implementation, marks complete.
+description: Phase 4 — Implement tasks from MASTER-TASKS.md. Args: [--all | --task T-XXX] [--dry-run]. Reads task file, shows requirements, guides implementation.
+
+Note: After implementation, manually update status with:
+  pwsh commands/sdd-task-status.ps1 -TaskId T-001 -Status completed
 ---
 $ErrorActionPreference = 'Continue'
 

package/lib/bundle/commands/sdd-check.ps1

@@ -0,0 +1,156 @@
+param(
+    [Parameter(Mandatory=$true, ValueFromPipeline=$true, Position=0)]
+    [string]$FilePath,
+
+    [string]$Section = "",
+
+    [string]$SpecFile = "sdd/SPEC.md"
+)
+
+$ErrorActionPreference = "Continue"
+
+function Get-ClauseContext {
+    param([string]$SpecFile, [string]$ClauseId)
+
+    $content = Get-Content $SpecFile -Raw -ErrorAction SilentlyContinue
+    if (-not $content) {
+        # Try legacy path
+        $content = Get-Content "SPEC.md" -Raw -ErrorAction SilentlyContinue
+    }
+    if (-not $content) {
+        return ""
+    }
+
+    # Find the clause and get surrounding text
+    $pattern = "\[${ClauseId}\](?:[:\s]+([^\n]+))?"
+    if ($content -match $pattern) {
+        return $Matches[1].Trim()
+    }
+
+    # Try to find clause in multi-line format
+    $pattern2 = "\[${ClauseId}\][\s\n]+([^-]+?)(?=\n\s*\[|\n\s*---|\z)"
+    if ($content -match $pattern2) {
+        return $Matches[1].Trim() -replace '\s+', ' '
+    }
+
+    return ""
+}
+
+function Test-ClauseMatch {
+    param([string]$Text, [string]$ImplContent)
+
+    if ([string]::IsNullOrWhiteSpace($Text)) { return $false }
+
+    # Extract key terms (remove brackets, parens, common words)
+    $cleanText = $Text -replace '\[.*?\]', '' -replace '\(.*?\)', '' -replace '[?!.,]', ''
+
+    # Try exact match first
+    if ($ImplContent -match [regex]::Escape($Text)) {
+        return @{ Match = $true; Method = "exact" }
+    }
+
+    # Try case-insensitive
+    if ($ImplContent -match [regex]::Escape($Text) -ignorecase) {
+        return @{ Match = $true; Method = "case-insensitive" }
+    }
+
+    # Try key terms matching
+    $words = $cleanText -split '\s+' | Where-Object { $_.Length -gt 3 }
+    $foundWords = 0
+    foreach ($word in $words) {
+        if ($ImplContent -match [regex]::Escape($word)) {
+            $foundWords++
+        }
+    }
+
+    if ($foundWords -ge ($words.Count * 0.5) -and $words.Count -gt 0) {
+        return @{ Match = $true; Method = "partial"; Coverage = "$foundWords/$($words.Count)" }
+    }
+
+    return @{ Match = $false; Method = "none" }
+}
+
+# Main execution
+Write-Host ""
+Write-Host "╔══════════════════════════════════════════════════════════╗" -ForegroundColor Cyan
+Write-Host "║  SDD Check: $FilePath" -ForegroundColor Cyan
+Write-Host "╚══════════════════════════════════════════════════════════╝" -ForegroundColor Cyan
+Write-Host ""
+
+# Check if spec exists
+$specExists = (Test-Path $SpecFile) -or (Test-Path "SPEC.md")
+if (-not $specExists) {
+    Write-Host "No SPEC.md found. Run /sdd-spec first." -ForegroundColor Yellow
+    exit 1
+}
+
+# Use correct spec path
+$actualSpecFile = if (Test-Path $SpecFile) { $SpecFile } else { "SPEC.md" }
+
+# Read spec content
+$specContent = Get-Content $actualSpecFile -Raw
+if (-not $specContent) {
+    Write-Host "Failed to read SPEC.md" -ForegroundColor Red
+    exit 1
+}
+
+# Extract all clause IDs
+$clausePattern = '\[(SC-[A-Z0-9]+|SC-\d+)\]'
+$clauseIds = [regex]::Matches($specContent, $clausePattern) | ForEach-Object { $_.Groups[1].Value } | Sort-Object -Unique
+
+# Filter by section if specified
+if ($Section) {
+    # Parse section to find relevant clauses
+    $sectionPattern = "##\s+.*?$Section[\s\S]+?(?=##|\z)"
+    $sectionContent = if ($specContent -match $sectionPattern) { $Matches[0] } else { $specContent }
+    $clauseIds = [regex]::Matches($sectionContent, $clausePattern) | ForEach-Object { $_.Groups[1].Value } | Sort-Object -Unique
+}
+
+# Read implementation file
+if (-not (Test-Path $FilePath)) {
+    Write-Host "File not found: $FilePath" -ForegroundColor Red
+    exit 1
+}
+
+$implContent = Get-Content $FilePath -Raw -ErrorAction Stop
+
+# Check each clause
+$passCount = 0
+$failCount = 0
+$results = @()
+
+foreach ($clauseId in $clauseIds) {
+    $clauseText = Get-ClauseContext -SpecFile $actualSpecFile -ClauseId $clauseId
+    $result = Test-ClauseMatch -Text $clauseText -ImplContent $implContent
+
+    $results += @{
+        Id = $clauseId
+        Text = $clauseText
+        Result = $result
+    }
+
+    if ($result.Match) {
+        $methodNote = if ($result.Method -eq "partial") { " [$($result.Coverage)]" } else { "" }
+        Write-Host "  [OK] $clauseId$methodNote" -ForegroundColor Green
+        $passCount++
+    } else {
+        $preview = if ($clauseText.Length -gt 60) { $clauseText.Substring(0, 60) + "..." } else { $clauseText }
+        Write-Host "  [--] $clauseId" -ForegroundColor Yellow
+        if ($preview) {
+            Write-Host "      Expected: $preview" -ForegroundColor Gray
+        }
+        $failCount++
+    }
+}
+
+# Summary
+Write-Host ""
+Write-Host "═══════════════════════════════════════════════════════════" -ForegroundColor Cyan
+$total = $passCount + $failCount
+if ($failCount -eq 0) {
+    Write-Host "  Result: $passCount/$total clauses verified" -ForegroundColor Green
+} else {
+    Write-Host "  Result: $passCount/$total verified | $failCount unclear" -ForegroundColor Yellow
+}
+Write-Host "═══════════════════════════════════════════════════════════" -ForegroundColor Cyan
+Write-Host ""

package/lib/bundle/commands/sdd-tasks.ps1

@@ -1,4 +1,4 @@
-# SDD Tasks Generator - Phase 3
+# SDD Tasks Generator - Phase 3
 # Standalone script for non-Claude Code usage
 # Usage: powershell -File commands/sdd-tasks.ps1
 
@@ -27,26 +27,22 @@ $specPath = "$SDD_OUTPUT_BASE/SPEC.md"
 $legacySpecPath = "SPEC.md"
 
 if (-not (Test-Path $specPath) -and -not (Test-Path $legacySpecPath)) {
-    Write-Host "[ERROR] SPEC.md not found at $specPath" -ForegroundColor Red
-    Write-Host "Run: sdd bmad [feature]" -ForegroundColor Yellow
-    Write-Host "Then: claude `/sdd-spec`" -ForegroundColor Yellow
+    Write-Host "[ERROR] SPEC.md not found" -ForegroundColor Red
     exit 1
 }
 
-# Use new path if exists, else use legacy
 if (Test-Path $specPath) {
     Write-Host "[OK] Found: $specPath" -ForegroundColor Green
     $activeSpec = $specPath
 } else {
-    Write-Host "[OK] Found: $legacySpecPath (legacy location)" -ForegroundColor Green
+    Write-Host "[OK] Found: $legacySpecPath" -ForegroundColor Green
     $activeSpec = $legacySpecPath
 }
 
 # Read template
 $templatePath = "templates/task-detail.template.md"
 if (-not (Test-Path $templatePath)) {
-    Write-Host "[ERROR] Template not found: $templatePath" -ForegroundColor Red
-    Write-Host "Run: /sdd-init first" -ForegroundColor Yellow
+    Write-Host "[ERROR] Template not found" -ForegroundColor Red
     exit 1
 }
 $templateContent = Get-Content $templatePath -Raw -Encoding UTF8
@@ -57,7 +53,7 @@ $specContent = Get-Content $activeSpec -Raw -Encoding UTF8
 
 # Extract project name
 $projectName = "Project"
-if ($specContent -match "^#\s+SPEC\.md\s*[-—]\s*(.+)$") {
+if ($specContent -match "^#\s+SPEC\.md\s*[-]\s*(.+)$") {
     $projectName = $Matches[1].Trim()
 }
 
@@ -90,13 +86,12 @@ $timestamp = Get-Date -Format "yyyyMMdd-HHmmss"
 $safeName = $projectName -replace '[^a-zA-Z0-9]', '-' -replace '-+', '-'
 $taskDir = "$SDD_TASKS_DIR/task-$timestamp-$safeName"
 
-# Check for existing task directories for this project
+# Check for existing task directories
 $existingDirs = Get-ChildItem -Path $SDD_TASKS_DIR -Filter "task-*-${safeName}" -Directory -ErrorAction SilentlyContinue
 if ($existingDirs) {
     $existingDir = $existingDirs[0].FullName
     Write-Host ""
-    Write-Host "[WARN] Task directory already exists: $existingDir" -ForegroundColor Yellow
-    Write-Host "[INFO] Using existing directory" -ForegroundColor Cyan
+    Write-Host "[WARN] Task directory already exists" -ForegroundColor Yellow
     $taskDir = $existingDir
 } else {
     New-Item -ItemType Directory -Path $taskDir -Force | Out-Null
@@ -130,7 +125,7 @@ foreach ($category in $testCategories) {
 $tasks += @{ Id = "T-00$phase"; Name = "Final Polish"; Phase = $phase; DependsOn = $prevId }
 
 # Generate MASTER-TASKS.md
-$masterContent = "# MASTER-TASKS — $projectName`n`n"
+$masterContent = "# MASTER-TASKS - $projectName`n`n"
 $masterContent += "| ID | Name | Estimate | Status |`n|----|------|----------|--------|`n"
 foreach ($t in $tasks) {
     $masterContent += "| $($t.Id) | $($t.Name) | 1h | [ ] |`n"
@@ -146,7 +141,7 @@ Write-Host "  [CREATED] MASTER-TASKS.md" -ForegroundColor Gray
 foreach ($t in $tasks) {
     $safeName = $t.Name -replace '[^a-zA-Z0-9]', '-' -replace '-+', '-'
     $filename = "$($t.Id)-$safeName.md"
-    $dependsOn = if ($t.DependsOn) { "`"$($t.DependsOn)`"" } else { "" }
+    $dependsOn = if ($t.DependsOn) { "`"" + ($t.DependsOn) + "`"" } else { "" }
 
     # Apply template substitutions
     $taskContent = $templateContent
@@ -179,4 +174,4 @@ Write-Host "[OK] Tasks generated: $($tasks.Count) tasks" -ForegroundColor Green
 Write-Host ""
 Write-Host "Directory: $taskDir" -ForegroundColor White
 Write-Host ""
-Write-Host "Next: /sdd-cook --all" -ForegroundColor Cyan
+Write-Host "Next: /sdd-cook --all" -ForegroundColor Cyan

package/lib/bundle/scripts/sdd-check.ps1

@@ -0,0 +1,232 @@
+param(
+    [Parameter(Mandatory=$true)]
+    [string]$FilePath,
+
+    [string]$Section = "",
+
+    [string]$SpecFile = "sdd/SPEC.md"
+)
+
+$ErrorActionPreference = "Continue"
+
+# ============================================================
+# SDD Path Resolution
+# ============================================================
+$SDD_SPEC_FILE = "sdd/SPEC.md"
+
+# Legacy fallback
+if (-not $SpecFile) {
+    if (Test-Path "SPEC.md") { $SpecFile = "SPEC.md" }
+    elseif (Test-Path "$SDD_SPEC_FILE") { $SpecFile = $SDD_SPEC_FILE }
+}
+
+# ============================================================
+# Helper Functions
+# ============================================================
+
+# Get-ClauseContext - Extract clause text from SPEC.md
+function Get-ClauseContext {
+    param(
+        [string]$SpecFile,
+        [string]$ClauseId
+    )
+    if (-not (Test-Path $SpecFile)) { return "" }
+
+    $content = Get-Content $SpecFile -Raw
+    # Match clause pattern like [SC-001] or [AC-001]
+    $pattern = "\[$ClauseId\]\s*(.+?)(?=\n\n|\n\[|$)"
+    if ($content -match $pattern) {
+        $text = $matches[1] -replace '\s+', ' ' -replace '^\s+|\s+$', ''
+        return $text
+    }
+    return ""
+}
+
+# Get-SpecClauses - Extract all clause IDs from SPEC.md
+function Get-SpecClauses {
+    param([string]$File)
+    $clauses = @()
+    if (Test-Path $File) {
+        $content = Get-Content $File -Raw
+        # Match [SC-xxx], [AC-xxx], [FE-xxx] patterns
+        $pattern = '\[([A-Z]{2,3}-[A-Z0-9]+-[0-9]+|[A-Z]{2,3}-[0-9]+)\]'
+        $matches = [regex]::Matches($content, $pattern)
+        foreach ($m in $matches) {
+            $id = $m.Groups[1].Value
+            if ($clauses.Id -notcontains $id) {
+                $text = Get-ClauseContext -SpecFile $File -ClauseId $id
+                $clauses += @{
+                    Id = $id
+                    Text = $text
+                }
+            }
+        }
+    }
+    return $clauses
+}
+
+# Search-Implementation - Find clause text in file
+function Search-Implementation {
+    param(
+        [string]$File,
+        [string]$SearchText
+    )
+    if (-not (Test-Path $File)) { return @{ Found = $false; Line = 0 } }
+
+    $lines = Get-Content $File
+    for ($i = 0; $i -lt $lines.Count; $i++) {
+        if ($lines[$i] -match [regex]::Escape($SearchText)) {
+            return @{
+                Found = $true
+                Line = $i + 1
+                Match = $matches[0]
+            }
+        }
+    }
+    return @{ Found = $false; Line = 0 }
+}
+
+# Search-Color - Find hex color in file
+function Search-Color {
+    param(
+        [string]$File,
+        [string]$Color
+    )
+    if (-not (Test-Path $File)) { return @{ Found = $false; Line = 0 } }
+
+    $content = Get-Content $File -Raw
+    if ($content -match $Color) {
+        $lines = Get-Content $File
+        for ($i = 0; $i -lt $lines.Count; $i++) {
+            if ($lines[$i] -match [regex]::Escape($Color)) {
+                return @{
+                    Found = $true
+                    Line = $i + 1
+                }
+            }
+        }
+    }
+    return @{ Found = $false; Line = 0 }
+}
+
+# ============================================================
+# Main Execution
+# ============================================================
+
+# Validate inputs
+if (-not (Test-Path $FilePath)) {
+    Write-Host "[ERROR] File not found: $FilePath" -ForegroundColor Red
+    exit 1
+}
+
+if (-not (Test-Path $SpecFile)) {
+    Write-Host "[WARN] SPEC file not found: $SpecFile" -ForegroundColor Yellow
+    Write-Host "       Searching for SPEC.md in common locations..." -ForegroundColor Gray
+
+    $foundSpec = $null
+    $searchPaths = @("SPEC.md", "sdd/SPEC.md", "../sdd/SPEC.md", "../../sdd/SPEC.md")
+    foreach ($p in $searchPaths) {
+        if (Test-Path $p) {
+            $foundSpec = $p
+            break
+        }
+    }
+
+    if ($foundSpec) {
+        $SpecFile = $foundSpec
+        Write-Host "       Found: $SpecFile" -ForegroundColor Green
+    } else {
+        Write-Host "[ERROR] No SPEC file found" -ForegroundColor Red
+        exit 1
+    }
+}
+
+# Resolve relative path
+$absFilePath = $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath($FilePath)
+
+Write-Host ""
+Write-Host "========================================" -ForegroundColor Cyan
+Write-Host "  SDD Check: $FilePath" -ForegroundColor Cyan
+Write-Host "========================================" -ForegroundColor Cyan
+Write-Host "  Spec:     $SpecFile" -ForegroundColor Gray
+Write-Host ""
+
+# Extract clauses from SPEC
+$clauses = Get-SpecClauses -File $SpecFile
+
+if ($clauses.Count -eq 0) {
+    Write-Host "[INFO] No clause IDs found in SPEC.md" -ForegroundColor Yellow
+    Write-Host "       Expected patterns: [SC-xxx], [AC-xxx], [FE-xxx]" -ForegroundColor Gray
+    exit 0
+}
+
+Write-Host "[INFO] Found $($clauses.Count) clause IDs in SPEC" -ForegroundColor Cyan
+Write-Host ""
+
+$passCount = 0
+$failCount = 0
+$results = @()
+
+foreach ($clause in $clauses) {
+    $searchText = $clause.Text -replace '\[.*?\]', '' -replace '\(.*?\)', '' -replace '^\s+|\s+$', ''
+
+    if ([string]::IsNullOrWhiteSpace($searchText)) {
+        Write-Host "⚠ $($clause.Id): No text content found" -ForegroundColor Yellow
+        continue
+    }
+
+    # Check if it's a color value (hex pattern)
+    $isColor = $searchText -match '^#[0-9A-Fa-f]{3,8}$'
+
+    if ($isColor) {
+        $result = Search-Color -File $absFilePath -Color $searchText
+    } else {
+        $result = Search-Implementation -File $absFilePath -SearchText $searchText
+    }
+
+    if ($result.Found) {
+        $passCount++
+        $icon = if ($isColor) { "🎨" } else { "✅" }
+        Write-Host "$icon $($clause.Id): FOUND at line $($result.Line)" -ForegroundColor Green
+        $results += @{
+            Id = $clause.Id
+            Status = "PASS"
+            Line = $result.Line
+            Text = $searchText.Substring(0, [Math]::Min(60, $searchText.Length))
+        }
+    } else {
+        $failCount++
+        Write-Host "❌ $($clause.Id): NOT FOUND" -ForegroundColor Red
+        Write-Host "   Expected: $($searchText.Substring(0, [Math]::Min(80, $searchText.Length)))" -ForegroundColor Yellow
+        if ($searchText.Length -gt 80) {
+            Write-Host "            ..." -ForegroundColor Yellow
+        }
+        $results += @{
+            Id = $clause.Id
+            Status = "FAIL"
+            Line = 0
+            Text = $searchText.Substring(0, [Math]::Min(60, $searchText.Length))
+        }
+    }
+}
+
+# Summary
+Write-Host ""
+Write-Host "========================================" -ForegroundColor Cyan
+$total = $passCount + $failCount
+$status = if ($failCount -eq 0) { "PASS" } else { "ISSUES FOUND" }
+$color = if ($failCount -eq 0) { "Green" } else { "Yellow" }
+
+Write-Host "Result: $passCount/$total clauses verified | $status" -ForegroundColor $color
+
+if ($failCount -gt 0) {
+    Write-Host ""
+    Write-Host "Next steps:" -ForegroundColor Cyan
+    Write-Host "  1. Add missing clauses to $FilePath" -ForegroundColor Gray
+    Write-Host "  2. Run: sdd check $FilePath" -ForegroundColor Gray
+    Write-Host "  3. Run: sdd converge --task <T-xxx>" -ForegroundColor Gray
+    exit 1
+} else {
+    Write-Host "  All clauses verified!" -ForegroundColor Green
+    exit 0
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-pipeline",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "Spec-Driven Development pipeline for Claude Code CLI — transforms raw feature requests into validated, shipped code through a self-correcting converge loop",
   "type": "commonjs",
   "bin": {