sdd-pipeline 1.2.1 → 1.2.2

package/bin/sdd.js

@@ -4,7 +4,7 @@
 const path = require('path')
 const fs = require('fs')
 const init = require('../lib/init')
-const bmad = require('../lib/bmad')
+const bmad = require('../lib/bmad/index')
 const config = require('../lib/config')
 
 const args = process.argv.slice(2)

package/lib/bmad/problem-first.js

@@ -77,6 +77,12 @@ function inferProblem(input) {
   if (lower.includes('export') || lower.includes('report')) {
     return 'Users cannot act on their data — business decisions are slowed or made without full information.'
   }
+  if (lower.includes('todo') || lower.includes('task')) {
+    return 'Users forget tasks or lack a system to track progress — important items slip through the cracks.'
+  }
+  if (lower.includes('contact form') || lower.includes('form')) {
+    return 'Users cannot easily reach out or submit information — communication barriers reduce engagement.'
+  }
 
   // Generic fallback
   return 'Users face a friction point that prevents them from completing their goal — specific symptoms and impact are being confirmed in the interview.'

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

@@ -0,0 +1,385 @@
+# SDD TASKS Generator - Phase 3
+# Generates tasks including TEST tasks from SPEC.md testing requirements
+$ErrorActionPreference = 'Stop'
+
+$SDD_TASKS_DIR = "sdd/tasks"
+
+Write-Host ""
+Write-Host "=== SDD TASKS Generator - Phase 3 ===" -ForegroundColor Cyan
+Write-Host ""
+
+# Check for SPEC
+$specPath = "sdd/SPEC.md"
+if (-not (Test-Path $specPath)) {
+    Write-Host "[ERROR] Phase 2 not complete." -ForegroundColor Red
+    Write-Host "sdd/SPEC.md not found." -ForegroundColor Red
+    exit 1
+}
+Write-Host "[OK] SPEC.md verified" -ForegroundColor Green
+
+# Read SPEC
+$specContent = Get-Content $specPath -Raw -Encoding UTF8
+
+# Extract project name
+$projectName = "Project"
+if ($specContent -match "^# SPEC\.md.*?[-—]\s+(.+)$") {
+    $projectName = $Matches[1].Trim()
+}
+
+# Extract features for testing
+$features = @()
+if ($specContent -match "### 4\.1 Core Features(.+?)(?=###|\Z)" -CaseSensitive:$false) {
+    $featuresSection = $Matches[1]
+    $featureBlocks = [regex]::Matches($featuresSection, '(?:#### \[([^\]]+)\]|(?:^|\n)- \*\*As a\*\*[^$]+)')
+    foreach ($block in $featureBlocks) {
+        if ($block.Value -match '\*\*As a\*\*[^,]+,\s*\*\*I want\*\*\s*([^,]+)') {
+            $features += $Matches[1].Trim()
+        }
+    }
+}
+
+# Extract test requirements
+$testCategories = @()
+if ($specContent -match "### 9\.1 Test Categories(.+?)(?=###|\Z)" -CaseSensitive:$false) {
+    $testSection = $Matches[1]
+    if ($testSection -match 'Unit Tests') { $testCategories += 'Unit' }
+    if ($testSection -match 'Integration Tests') { $testCategories += 'Integration' }
+    if ($testSection -match 'E2E Tests') { $testCategories += 'E2E' }
+    if ($testSection -match 'Accessibility Tests') { $testCategories += 'Accessibility' }
+}
+
+# Extract user flows for testing
+$userFlows = @()
+if ($specContent -match "Flow:\s*(.+?)(?=\n\s*$|\n\s*\`\`\`)" -CaseSensitive:$false) {
+    $userFlows = [regex]::Matches($specContent, "Flow:\s*(.+?)[\n\r]", [System.Text.RegularExpressions.RegexOptions]::Singleline) | ForEach-Object { $_.Groups[1].Value.Trim() }
+}
+
+# Extract test specifications
+$unitTests = @()
+if ($specContent -match "(?:### 9\.2 Unit Test Specifications|Unit:\s*(.+?)(?=Unit:|Flow:|\Z))" -CaseSensitive:$false) {
+    $unitSection = $Matches[0]
+    $unitTests = [regex]::Matches($unitSection, "it\('([^']+)'") | ForEach-Object { $_.Groups[1].Value }
+}
+
+# Create task directory
+$TASK_ID = Get-Date -Format "yyyyMMdd-HHmmss"
+$TASK_DIR = "$SDD_TASKS_DIR/task-$TASK_ID-$($projectName.ToLower().Replace(' ', '-'))"
+New-Item -ItemType Directory -Path $TASK_DIR -Force | Out-Null
+
+# Build task list
+$taskList = @()
+
+# Phase 1: Project Setup
+$taskList += @{
+    id = "T-001"
+    name = "Project Setup"
+    phase = 1
+    estimate = "1h"
+    depends_on = @()
+    content = @"
+---
+name: T-001-project-setup
+description: "Initial project setup: create directory structure, configuration files, and base code"
+phase: 1
+estimate: 1h
+spec_sections: ["3.1", "4.1"]
+depends_on: []
+---
+
+# T-001: Project Setup
+
+## Files to Create
+- [List files based on tech stack from SPEC Section 6]
+
+## Implementation Steps
+1. Create project structure
+2. Set up configuration files
+3. Create base HTML/CSS/JS files
+4. Verify initial setup works
+
+## Verification
+- [ ] Project structure matches spec
+- [ ] Configuration files created
+- [ ] Base files load without errors
+"@
+}
+
+# Phase 2-4: Feature implementation tasks (placeholder)
+$featurePhase = 2
+$features | ForEach-Object {
+    $featureName = $_
+    $taskList += @{
+        id = "T-00$featurePhase"
+        name = "$featureName"
+        phase = $featurePhase
+        estimate = "1h"
+        depends_on = @("T-001")
+        content = @"
+---
+name: T-00$featurePhase-feature
+description: "Implement: $featureName"
+phase: $featurePhase
+estimate: 1h
+spec_sections: ["4.1"]
+depends_on: ["T-001"]
+---
+
+# T-00$featurePhase`: $featureName
+
+## Files to Modify/Create
+- [List files]
+
+## Implementation Steps
+1. Implement $featureName feature
+2. Connect to other components
+3. Test manually
+
+## Verification
+- [ ] Feature works as specified
+- [ ] No console errors
+"@
+    }
+    $featurePhase++
+}
+
+# Phase for testing
+$testPhase = $featurePhase
+
+# Add TEST tasks based on categories
+if ($testCategories -contains 'Unit' -or $unitTests.Count -gt 0) {
+    $taskList += @{
+        id = "T-00$testPhase"
+        name = "Unit Tests"
+        phase = $testPhase
+        estimate = "1h"
+        depends_on = @("T-00$($testPhase-1)")
+        content = @"
+---
+name: T-00$testPhase-unit-tests
+description: "Write and run unit tests for core functionality"
+phase: $testPhase
+estimate: 1h
+spec_sections: ["9.1", "9.2"]
+depends_on: ["T-00$($testPhase-1)"]
+---
+
+# T-00$testPhase`: Unit Tests
+
+## Test Files to Create
+- `tests/unit/*.test.js` (or equivalent)
+
+## Unit Tests to Implement
+
+### Core Functions
+` + ($unitTests -join "`n- `") + @"
+
+### Test Cases
+- Test happy path (valid input)
+- Test error path (invalid input)
+- Test edge cases (empty, null, boundary values)
+
+## Verification
+- [ ] All unit tests pass
+- [ ] Code coverage > 80%
+- [ ] No failing tests
+"@
+    }
+    $testPhase++
+}
+
+if ($testCategories -contains 'Integration') {
+    $taskList += @{
+        id = "T-00$testPhase"
+        name = "Integration Tests"
+        phase = $testPhase
+        estimate = "1h"
+        depends_on = @("T-00$($testPhase-1)")
+        content = @"
+---
+name: T-00$testPhase-integration-tests
+description: "Write integration tests for component interactions"
+phase: $testPhase
+estimate: 1h
+spec_sections: ["9.1", "9.3"]
+depends_on: ["T-00$($testPhase-1)"]
+---
+
+# T-00$testPhase`: Integration Tests
+
+## Test Files to Create
+- `tests/integration/*.test.js`
+
+## Integration Flows to Test
+` + ($userFlows | ForEach-Object { "- $_" } -join "`n") + @"
+
+## Test Scenarios
+- Verify components interact correctly
+- Test data flow between modules
+- Verify state changes propagate
+
+## Verification
+- [ ] All integration tests pass
+- [ ] Components communicate correctly
+- [ ] State management works
+"@
+    }
+    $testPhase++
+}
+
+if ($testCategories -contains 'E2E') {
+    $taskList += @{
+        id = "T-00$testPhase"
+        name = "End-to-End Tests"
+        phase = $testPhase
+        estimate = "1h"
+        depends_on = @("T-00$($testPhase-1)")
+        content = @"
+---
+name: T-00$testPhase-e2e-tests
+description: "Write E2E tests for complete user workflows"
+phase: $testPhase
+estimate: 1h
+spec_sections: ["9.1", "9.4"]
+depends_on: ["T-00$($testPhase-1)"]
+---
+
+# T-00$testPhase`: End-to-End Tests
+
+## Test Files to Create
+- `tests/e2e/*.test.js`
+
+## E2E Scenarios
+` + ($userFlows | ForEach-Object { "- $_" } -join "`n") + @"
+
+## Test Approach
+- Use Playwright/Cypress/Selenium
+- Test complete user journeys
+- Verify full application flow
+
+## Verification
+- [ ] All E2E tests pass
+- [ ] User flows complete successfully
+- [ ] No broken links or redirects
+"@
+    }
+    $testPhase++
+}
+
+if ($testCategories -contains 'Accessibility') {
+    $taskList += @{
+        id = "T-00$testPhase"
+        name = "Accessibility Tests"
+        phase = $testPhase
+        estimate = "1h"
+        depends_on = @("T-00$($testPhase-1)")
+        content = @"
+---
+name: T-00$testPhase-a11y-tests
+description: "Verify accessibility compliance (WCAG 2.1 AA)"
+phase: $testPhase
+estimate: 1h
+spec_sections: ["9.1"]
+depends_on: ["T-00$($testPhase-1)"]
+---
+
+# T-00$testPhase`: Accessibility Tests
+
+## Accessibility Requirements (from SPEC Section 3.1)
+- Keyboard navigable
+- Screen reader labels
+- Color contrast compliance
+
+## Test Tools
+- axe-core
+- Lighthouse
+- NVDA/VoiceOver
+
+## Verification
+- [ ] axe-core reports 0 violations
+- [ ] Keyboard navigation works
+- [ ] Screen reader announces content
+- [ ] Color contrast meets WCAG AA
+"@
+    }
+    $testPhase++
+}
+
+# Final phase: Polish and Converge
+$finalPhase = $testPhase
+$taskList += @{
+    id = "T-00$finalPhase"
+    name = "Final Polish and Converge"
+    phase = $finalPhase
+    estimate = "1h"
+    depends_on = @("T-00$($finalPhase-1)")
+    content = @"
+---
+name: T-00$finalPhase-final-polish
+description: "Final polish, code review, and converge validation"
+phase: $finalPhase
+estimate: 1h
+spec_sections: ["9", "10"]
+depends_on: ["T-00$($finalPhase-1)"]
+---
+
+# T-00$finalPhase`: Final Polish and Converge
+
+## Final Checks
+- [ ] All tests pass
+- [ ] Code follows style guide
+- [ ] No console errors
+- [ ] Responsive design works
+- [ ] Performance acceptable
+
+## Converge Validation
+- Run: `pwsh run-converge.ps1 -Strict`
+- Verify all checks pass
+- Fix any issues found
+
+## Verification
+- [ ] All converge checks pass
+- [ ] Ready for deployment
+"@
+}
+
+# Generate MASTER-TASKS.md
+$masterTasks = "# MASTER-TASKS — $projectName`n`n"
+$masterTasks += "## Task Index`n`n"
+$masterTasks += "| ID | Name | Estimate | Status |`n"
+$masterTasks += "|----|------|----------|--------|`n"
+
+$totalTasks = $taskList.Count
+$completed = 0
+
+$taskList | ForEach-Object {
+    $masterTasks += "| $($_.id) | $($_.name) | $($_.estimate) | [ ] |`n"
+}
+
+$masterTasks += "`n## Progress`n`n"
+$masterTasks += "- Completed: $completed / $totalTasks`n"
+$masterTasks += "- In Progress: 0`n"
+$masterTasks += "- Pending: $totalTasks`n`n"
+$masterTasks += "## Notes`n`n"
+$masterTasks += "Generated from SPEC.md testing requirements.`n"
+$masterTasks += "Test categories detected: $($testCategories -join ', ')`n"
+
+Set-Content -Path "$TASK_DIR/MASTER-TASKS.md" -Value $masterTasks -Encoding UTF8
+Write-Host "  [CREATED] MASTER-TASKS.md" -ForegroundColor Gray
+
+# Generate task files
+$taskList | ForEach-Object {
+    $task = $_
+    # Convert ID like T-001 to T-001-name.md
+    $safeName = $task.name -replace '[^a-zA-Z0-9]', '-' -replace '-+', '-'
+    $filename = "$($task.id)-$($safeName.ToLower()).md"
+    Set-Content -Path "$TASK_DIR/$filename" -Value $task.content -Encoding UTF8
+    Write-Host "  [CREATED] $filename" -ForegroundColor Gray
+}
+
+Write-Host ""
+Write-Host "[OK] Tasks created: $TASK_DIR" -ForegroundColor Green
+Write-Host "  MASTER-TASKS.md"
+Write-Host "  $($taskList.Count) task files"
+Write-Host "  Test tasks: $($testCategories -join ', ')"
+Write-Host ""
+Write-Host "Next: claude `/sdd-cook` or manually implement tasks" -ForegroundColor Cyan

package/lib/bundle/templates/SPEC.template.md

@@ -1,6 +1,7 @@
-<!-- Template: SPEC.md v3.0.0 -->
+<!-- Template: SPEC.md v3.1.0 -->
 <!-- Spec-Driven Development — Agent-Optimized SPEC -->
 <!-- Generated by: SDD Pipeline (2026-08-28) -->
+<!-- Updated: 2026-08-29 — Clause ID tracking added -->
 <!-- Key: MUST=required, SHOULD=recommended, MUST NOT=forbidden -->
 
 # SPEC.md — [Project Name]
@@ -37,26 +38,36 @@
 ## 3. Exact Content Contracts
 
 > **Critical:** These blocks contain EXACT text that MUST appear verbatim in the implementation.
+> **Clause Tracking:** Each contract item has a `[SC-xxx]` ID for automated validation.
 
 ### 3.1 Required Text (copy verbatim)
 
+> **Clause IDs for tracking:** `[SC-001]`, `[SC-002]`, etc.
+
 ```
-[Copy exact text here — headlines, button labels, error messages, etc.]
+[SC-001] [Copy exact text here — headlines]
+[SC-002] [Copy exact text here — button labels]
+[SC-003] [Copy exact text here — error messages]
 ```
 
 ### 3.2 Exact Colors
 
-| Element | Hex | Usage |
-|---------|-----|-------|
-| Primary | `#XXXXXX` | [Usage] |
-| Secondary | `#XXXXXX` | [Usage] |
-| Error | `#XXXXXX` | [Usage] |
+> **Clause IDs for tracking:** `[SC-COLOR-xxx]`
+
+| Clause ID | Element | Hex | Usage |
+|-----------|---------|-----|-------|
+| [SC-COLOR-001] | Primary | `#XXXXXX` | [Usage] |
+| [SC-COLOR-002] | Secondary | `#XXXXXX` | [Usage] |
+| [SC-COLOR-003] | Error | `#XXXXXX` | [Usage] |
 
 ### 3.3 Exact Dimensions
 
-| Element | Size | Context |
-|---------|------|---------|
-| [Element] | [W]x[H]px | [Where] |
+> **Clause IDs for tracking:** `[SC-DIM-xxx]`
+
+| Clause ID | Element | Size | Context |
+|-----------|---------|------|---------|
+| [SC-DIM-001] | [Element] | [W]x[H]px | [Where] |
+| [SC-DIM-002] | [Element] | [W]x[H]px | [Where] |
 
 ---
 
@@ -64,7 +75,7 @@
 
 ### 4.1 Core Features
 
-#### [Feature Name]
+#### [[SC-FEATURE-001] Feature Name]
 
 - **Description:** [What it does]
 - **BMAD Source:** Architect MVP (Q4) + UX first impression (Q7)
@@ -81,8 +92,8 @@
 ```
 
 **Acceptance criteria:**
-- [ ] [Specific, measurable condition]
-- [ ] [Specific, measurable condition]
+- [[AC-001]] [Specific, measurable condition]
+- [[AC-002]] [Specific, measurable condition]
 
 ### 4.2 User Flows
 
@@ -173,7 +184,130 @@ Flow: [Flow Name]
 
 ---
 
-## 9. Success Criteria
+## 9. Testing Requirements
+
+> **Critical:** This section defines WHAT to test. Task generator uses this to create test tasks.
+
+### 9.1 Test Categories
+
+| Category | Description | Priority |
+|----------|-------------|----------|
+| Unit Tests | Individual function/method testing | MUST |
+| Integration Tests | Component interaction testing | MUST |
+| E2E Tests | Full user flow testing | SHOULD |
+| Visual Tests | UI rendering verification | SHOULD |
+| Accessibility Tests | WCAG compliance | MUST |
+
+### 9.2 Unit Test Specifications
+
+> **Format:** `describe([unit]) → it([behavior]) → expect([assertion])`
+
+```
+Unit: [function/module name]
+  describe('[unit name]')
+    it('[should do X when Y]')
+      expect([actual]).to[matcher]([expected])
+```
+
+**Examples:**
+```
+Unit: addTask()
+  describe('addTask()')
+    it('should add task to list when input is valid')
+      expect(tasks.length).toBe(1)
+    it('should show error when input is empty')
+      expect(alert).toHaveBeenCalled()
+    it('should clear input after adding task')
+      expect(input.value).toBe('')
+
+Unit: toggleTask()
+  describe('toggleTask(id)')
+    it('should toggle completed state')
+      expect(task.completed).toBe(true)
+    it('should persist state to localStorage')
+      expect(localStorage.setItem).toHaveBeenCalled()
+```
+
+### 9.3 Integration Test Specifications
+
+```
+Flow: [user flow name]
+  Given: [initial state]
+  When: [action]
+  Then: [expected outcome]
+```
+
+**Examples:**
+```
+Flow: Add Task Flow
+  Given: empty task list
+  When: user types "Buy milk" and clicks Add
+  Then: task appears in list with "Buy milk" text
+
+Flow: Complete Task Flow
+  Given: task "Buy milk" exists
+  When: user clicks on task text
+  Then: task shows strikethrough, completed=true
+
+Flow: Delete Task Flow
+  Given: task "Buy milk" exists
+  When: user clicks Delete button
+  Then: task removed from list, localStorage updated
+```
+
+### 9.4 E2E Test Specifications
+
+```
+Scenario: [user scenario]
+  Given: [prerequisites]
+  When: [user actions]
+  Then: [system response]
+```
+
+**Examples:**
+```
+Scenario: Add and complete a task
+  Given: browser at app URL
+  When: I type "Test task" and submit form
+  And: I click on the task text
+  Then: I see task with strikethrough
+  And: I refresh the page
+  And: task is still marked complete
+
+Scenario: Empty input validation
+  Given: browser at app URL
+  When: I click Add button with empty input
+  Then: I see validation error message
+  And: no task is added
+```
+
+### 9.5 Test Data
+
+> **Known inputs for testing:**
+
+| Test Case | Input | Expected Output |
+|-----------|-------|-----------------|
+| Valid task | "Buy groceries" | Task added to list |
+| Empty task | "" | Validation error |
+| Long task | "[200+ chars]" | Task added (truncated display) |
+| Duplicate task | "Same task" (x2) | Both tasks added |
+| Special chars | "Task <script>" | Sanitized, displayed safely |
+
+### 9.6 Test Verification Checklist
+
+> **sdd-tasks generates test tasks from this checklist.**
+
+For each feature in Section 4.1:
+
+- [ ] Unit test: Happy path
+- [ ] Unit test: Error path
+- [ ] Unit test: Edge case
+- [ ] Integration test: Component interaction
+- [ ] E2E test: Full user flow
+
+---
+
+## 10. Success Criteria
 
 > **Agent instruction:** These criteria define "done". All MUST pass before marking complete.
 
@@ -184,7 +318,7 @@ Flow: [Flow Name]
 
 ---
 
-## 10. Decision Log
+## 11. Decision Log
 
 > **Agent instruction:** This log explains WHY. Read when uncertain about intent.
 
@@ -194,7 +328,7 @@ Flow: [Flow Name]
 
 ---
 
-## 11. Anti-Patterns (Do NOT do)
+## 12. Anti-Patterns (Do NOT do)
 
 > **Agent warning:** These patterns were explicitly rejected. Do not suggest or implement.
 
@@ -205,15 +339,33 @@ Flow: [Flow Name]
 
 ## Agent Verification Checklist
 
+> **Updated v3.1:** Use clause IDs `[SC-xxx]` for automated tracking.
+
 Before marking implementation complete, verify:
 
+- [ ] All clause IDs tracked: `[SC-001]`, `[SC-002]`, etc.
 - [ ] All "Required Text" (Section 3.1) appears verbatim
 - [ ] All colors match hex values in Section 3.2 exactly
 - [ ] All dimensions match Section 3.3 exactly
-- [ ] All acceptance criteria in Section 4.1 checked
+- [ ] All acceptance criteria `[AC-xxx]` in Section 4.1 checked
 - [ ] All user flows implemented as specified
 - [ ] All edge cases handled as specified
 - [ ] All data contracts match schemas exactly
 - [ ] No items from Out of Scope (Section 7) implemented
 - [ ] All Open Questions resolved or escalated
 - [ ] All Success Criteria met
+- [ ] Converge report generated in `converge/task-T-XXX.md`
+
+---
+
+## Clause Index
+
+> **Auto-generated index of all clause IDs for easy reference.**
+
+| Clause ID | Type | Location | Text |
+|-----------|------|----------|------|
+| [SC-001] | Text | §3.1 | [excerpt] |
+| [SC-002] | Text | §3.1 | [excerpt] |
+| [SC-COLOR-001] | Color | §3.2 | [excerpt] |
+| [SC-FEATURE-001] | Feature | §4.1 | [excerpt] |
+| [AC-001] | Criterion | §4.1 | [excerpt] |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-pipeline",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "Spec-Driven Development pipeline for Claude Code — organized output structure (sdd/brief.md, sdd/SPEC.md, sdd/tasks/, sdd/converge/)",
   "bin": {
     "sdd": "bin/sdd.js"