sdd-pipeline 1.2.1 → 1.2.3

package/lib/bundle/generate-tasks.ps1

@@ -0,0 +1,450 @@
+# SDD Task Generation - Shared Logic
+# Used by: .claude/commands/sdd-tasks.md, commands/sdd-tasks.ps1, skills/sdd-tasks/
+# Version: 1.0.0
+
+param(
+    [string]$SpecPath = "sdd/SPEC.md",
+    [string]$OutputDir = "sdd/tasks"
+)
+
+$ErrorActionPreference = 'Stop'
+
+# ============================================================
+# Utility Functions
+# ============================================================
+
+function Write-SddHeader {
+    param([string]$Text)
+    Write-Host "" -ForegroundColor Cyan
+    Write-Host "=== $Text ===" -ForegroundColor Cyan
+    Write-Host ""
+}
+
+function Write-SddSuccess {
+    param([string]$Text)
+    Write-Host "[OK] $Text" -ForegroundColor Green
+}
+
+function Write-SddError {
+    param([string]$Text)
+    Write-Host "[ERROR] $Text" -ForegroundColor Red
+}
+
+function Write-SddWarn {
+    param([string]$Text)
+    Write-Host "[WARN] $Text" -ForegroundColor Yellow
+}
+
+function Write-SddInfo {
+    param([string]$Text)
+    Write-Host "  $Text" -ForegroundColor Gray
+}
+
+# ============================================================
+# Parse SPEC.md
+# ============================================================
+
+function Get-SpecInfo {
+    param([string]$Path)
+
+    $content = Get-Content $Path -Raw -Encoding UTF8
+    $spec = @{
+        Name = "Project"
+        Features = @()
+        TestCategories = @()
+        UserStories = @()
+        Sections = @{}
+    }
+
+    # Extract project name
+    if ($content -match "^#\s+SPEC\.md\s*[-—]\s*(.+)$", $multiline) {
+        $spec.Name = $Matches[1].Trim()
+    }
+
+    # Extract features from Section 4.1
+    if ($content -match "(?s)### 4\.1\s+Core Features(.+?)(?=###|\Z)") {
+        $featuresSection = $Matches[1]
+
+        # Match feature blocks
+        $featureBlocks = [regex]::Matches($featuresSection, '(?s)####\s+\[([^\]]+)\](.+?)(?=####|\Z)')
+        foreach ($block in $featureBlocks) {
+            $featureName = $block.Groups[1].Value.Trim()
+            $featureContent = $block.Groups[2].Value
+
+            # Extract acceptance criteria
+            $criteria = @()
+            $criteriaMatches = [regex]::Matches($featureContent, '\[\[AC-(\w+)\]\]\s*(.+)')
+            foreach ($c in $criteriaMatches) {
+                $criteria += @{
+                    Id = $c.Groups[1].Value
+                    Text = $c.Groups[2].Value.Trim()
+                }
+            }
+
+            $spec.Features += @{
+                Name = $featureName
+                Content = $featureContent
+                Criteria = $criteria
+            }
+        }
+    }
+
+    # Extract test categories from Section 9.1
+    if ($content -match "(?s)### 9\.1\s+Test Categories(.+?)(?=###|\Z)") {
+        $testSection = $Matches[1]
+
+        if ($testSection -match 'Unit\s+Tests') { $spec.TestCategories += 'Unit' }
+        if ($testSection -match 'Integration\s+Tests') { $spec.TestCategories += 'Integration' }
+        if ($testSection -match 'E2E\s+Tests') { $spec.TestCategories += 'E2E' }
+        if ($testSection -match 'Accessibility\s+Tests') { $spec.TestCategories += 'Accessibility' }
+    }
+
+    # Extract user stories from Section 2
+    if ($content -match "(?s)### 2\.1\s+Must Have(.+?)(?=###|\Z)") {
+        $storiesSection = $Matches[1]
+        $storyMatches = [regex]::Matches($storiesSection, '\*\*As a\*\*.+?(?=\n-|\n\n|\Z)', [System.Text.RegularExpressions.RegexOptions]::Singleline)
+        foreach ($story in $storyMatches) {
+            $storyText = $story.Value.Trim()
+            if ($storyText) {
+                $spec.UserStories += $storyText
+            }
+        }
+    }
+
+    return $spec
+}
+
+# ============================================================
+# Generate Tasks
+# ============================================================
+
+function New-TaskFile {
+    param(
+        [string]$Id,
+        [string]$Name,
+        [string]$Phase,
+        [string]$Estimate,
+        [string[]]$DependsOn,
+        [string[]]$SpecSections,
+        [string]$Description,
+        [string]$Content
+    )
+
+    $safeName = $Name -replace '[^a-zA-Z0-9]', '-' -replace '-+', '-'
+    $filename = "$Id-$safeName.md"
+
+    $frontmatter = @"
+---
+name: $Id-$safeName
+description: "$Description"
+phase: $Phase
+estimate: $Estimate
+spec_sections: [$($SpecSections -join ', ')]
+depends_on: [$($DependsOn -join ', ')]
+---
+
+"@
+
+    $fullContent = $frontmatter + "# $Id`: $Name`n`n" + $Content
+    return @{
+        Filename = $filename
+        Content = $fullContent
+    }
+}
+
+function Get-TaskFiles {
+    param(
+        [object]$Spec,
+        [int]$StartPhase = 2
+    )
+
+    $tasks = @()
+    $phase = $StartPhase
+    $prevTask = $null
+
+    # Feature tasks
+    foreach ($feature in $Spec.Features) {
+        $dependsOn = if ($prevTask) { @($prevTask.Id) } else { @() }
+
+        $task = New-TaskFile `
+            -Id "T-00$phase" `
+            -Name $feature.Name `
+            -Phase $phase `
+            -Estimate "1h" `
+            -DependsOn $dependsOn `
+            -SpecSections @('"4.1"') `
+            -Description "Implement: $($feature.Name)" `
+            -Content @"
+
+## Files to Modify/Create
+
+- [List files based on feature requirements]
+
+## Implementation Steps
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+## Verification
+
+$($feature.Criteria | ForEach-Object { "- [ ] [[AC-$($_.Id)]] $($_.Text)" } -join "`n")
+
+"@
+
+        $tasks += $task
+        $prevTask = $tasks[-1]
+        $phase++
+    }
+
+    # Test tasks
+    foreach ($category in $Spec.TestCategories) {
+        $dependsOn = if ($prevTask) { @($prevTask.Id) } else { @() }
+
+        switch ($category) {
+            'Unit' {
+                $testContent = @"
+
+## Test Files to Create
+
+- `tests/unit/*.test.js`
+
+## Unit Tests
+
+- Test happy path
+- Test error path
+- Test edge cases
+
+## Verification
+
+- [ ] All unit tests pass
+- [ ] Code coverage > 80%
+"@
+            }
+            'Integration' {
+                $testContent = @"
+
+## Test Files to Create
+
+- `tests/integration/*.test.js`
+
+## Integration Tests
+
+$($Spec.UserStories | ForEach-Object { "- $_" } -join "`n")
+
+## Verification
+
+- [ ] All integration tests pass
+- [ ] Components interact correctly
+"@
+            }
+            'E2E' {
+                $testContent = @"
+
+## Test Files to Create
+
+- `tests/e2e/*.test.js`
+
+## E2E Scenarios
+
+- Complete user journey test
+- Error recovery test
+
+## Verification
+
+- [ ] All E2E tests pass
+- [ ] Full flows work end-to-end
+"@
+            }
+            'Accessibility' {
+                $testContent = @"
+
+## Accessibility Verification
+
+- Keyboard navigation
+- Screen reader support
+- Color contrast
+
+## Tools
+
+- axe-core
+- Lighthouse
+
+## Verification
+
+- [ ] axe-core: 0 violations
+- [ ] Keyboard navigation works
+- [ ] Color contrast meets WCAG AA
+"@
+            }
+        }
+
+        $task = New-TaskFile `
+            -Id "T-00$phase" `
+            -Name "$category Tests" `
+            -Phase $phase `
+            -Estimate "1h" `
+            -DependsOn $dependsOn `
+            -SpecSections @('"9.1"') `
+            -Description "Write and run $category tests" `
+            -Content $testContent
+
+        $tasks += $task
+        $prevTask = $tasks[-1]
+        $phase++
+    }
+
+    # Polish task
+    $dependsOn = if ($prevTask) { @($prevTask.Id) } else { @() }
+    $tasks += New-TaskFile `
+        -Id "T-00$phase" `
+        -Name "Final Polish" `
+        -Phase $phase `
+        -Estimate "1h" `
+        -DependsOn $dependsOn `
+        -SpecSections @('"4.1"') `
+        -Description "Final polish, styling, edge cases" `
+        -Content @"
+
+## Final Checks
+
+- [ ] All features work correctly
+- [ ] No console errors
+- [ ] Responsive design
+- [ ] Edge cases handled
+
+## Verification
+
+- [ ] Manual testing complete
+- [ ] Code review passed
+"@
+
+    $phase++
+
+    # Converge task
+    $dependsOn = @($tasks[-1].Id)
+    $tasks += New-TaskFile `
+        -Id "T-00$phase" `
+        -Name "Converge Validation" `
+        -Phase $phase `
+        -Estimate "1h" `
+        -DependsOn $dependsOn `
+        -SpecSections @('"9"') `
+        -Description "Run converge validation" `
+        -Content @"
+
+## Converge Steps
+
+1. Run: `pwsh run-converge.ps1 -Strict`
+2. Fix any issues
+3. Verify all checks pass
+
+## Verification
+
+- [ ] Converge passes
+- [ ] Ready for deployment
+"@
+
+    return $tasks
+}
+
+function New-MasterTasks {
+    param(
+        [string]$ProjectName,
+        [object[]]$Tasks,
+        [string[]]$TestCategories
+    )
+
+    $content = @"
+# MASTER-TASKS — $ProjectName
+
+## Task Index
+
+| ID | Name | Estimate | Status |
+|----|------|----------|--------|
+"@
+
+    foreach ($task in $Tasks) {
+        $content += "| $($task.Id) | $($task.Name) | 1h | [ ] |`n"
+    }
+
+    $total = $Tasks.Count
+    $content += @"
+
+## Progress
+
+- Completed: 0 / $total
+- In Progress: 0
+- Pending: $total
+
+## Test Categories
+
+$($TestCategories -join ', ')
+
+## Notes
+
+Generated from: SPEC.md
+"@
+
+    return $content
+}
+
+# ============================================================
+# Main Execution
+# ============================================================
+
+Write-SddHeader "SDD Tasks Generator - Phase 3"
+
+# Check SPEC exists
+if (-not (Test-Path $SpecPath)) {
+    Write-SddError "SPEC.md not found at $SpecPath"
+    Write-SddWarn "Run /sdd-spec first to generate SPEC.md"
+    exit 1
+}
+Write-SddSuccess "Found: $SpecPath"
+
+# Parse SPEC
+Write-Host "Parsing SPEC.md..." -ForegroundColor Gray
+$spec = Get-SpecInfo -Path $SpecPath
+Write-SddSuccess "Project: $($spec.Name)"
+Write-SddSuccess "Features: $($spec.Features.Count)"
+Write-SddSuccess "Test categories: $($spec.TestCategories -join ', ')"
+
+# Create output directory
+$timestamp = Get-Date -Format "yyyyMMdd-HHmmss"
+$safeName = $spec.Name -replace '[^a-zA-Z0-9]', '-' -replace '-+', '-'
+$taskDir = "$OutputDir/task-$timestamp-$safeName"
+
+if (-not (Test-Path $taskDir)) {
+    New-Item -ItemType Directory -Path $taskDir -Force | Out-Null
+}
+Write-SddSuccess "Created: $taskDir"
+
+# Generate tasks
+Write-Host ""
+Write-Host "Generating tasks..." -ForegroundColor Gray
+$tasks = Get-TaskFiles -Spec $spec
+
+# Write task files
+foreach ($task in $tasks) {
+    $filepath = Join-Path $taskDir $task.Filename
+    Set-Content -Path $filepath -Value $task.Content -Encoding UTF8
+    Write-SddInfo "[CREATED] $($task.Filename)"
+}
+
+# Write MASTER-TASKS.md
+$masterContent = New-MasterTasks -ProjectName $spec.Name -Tasks $tasks -TestCategories $spec.TestCategories
+$masterPath = Join-Path $taskDir "MASTER-TASKS.md"
+Set-Content -Path $masterPath -Value $masterContent -Encoding UTF8
+Write-SddInfo "[CREATED] MASTER-TASKS.md"
+
+# Summary
+Write-Host ""
+Write-SddSuccess "Tasks generated successfully!"
+Write-Host ""
+Write-Host "Summary:" -ForegroundColor Cyan
+Write-Host "  Project: $($spec.Name)"
+Write-Host "  Tasks: $($tasks.Count)"
+Write-Host "  Directory: $taskDir"
+Write-Host ""
+Write-Host "Next: claude `/sdd-cook --all` or implement tasks manually" -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] |