sdd-pipeline 1.2.2 → 1.2.3

package/lib/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-pipeline",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "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"