sdd-pipeline 1.2.2 → 1.2.4

package/lib/converge-task.ps1

@@ -1,260 +0,0 @@
-param(
-    [Parameter(Mandatory=$true)]
-    [string]$TaskId,
-
-    [string]$SpecFile = "",
-
-    [string]$TaskDir = "",
-
-    [string]$ConvergeDir = "",
-
-    [switch]$Strict
-)
-
-$ErrorActionPreference = "Continue"
-$script:issuesFound = @()
-
-# ============================================================
-# SDD Path Resolution
-# ============================================================
-$SDD_OUTPUT_BASE = "sdd"
-$SDD_SPEC_FILE = "sdd/SPEC.md"
-$SDD_TASKS_DIR = "sdd/tasks"
-$SDD_CONVERGE_DIR = "sdd/converge"
-
-if (Test-Path ".sdd/config.json") {
-    try {
-        $config = Get-Content ".sdd/config.json" -Raw | ConvertFrom-Json
-        if ($config.output) {
-            if ($config.output.baseDir) { $SDD_OUTPUT_BASE = $config.output.baseDir }
-            if ($config.output.spec) { $SDD_SPEC_FILE = $config.output.spec }
-            if ($config.output.tasksDir) { $SDD_TASKS_DIR = $config.output.tasksDir }
-            if ($config.output.convergeDir) { $SDD_CONVERGE_DIR = $config.output.convergeDir }
-        }
-    } catch {}
-}
-
-# Legacy fallback
-if (-not $SpecFile) {
-    if (Test-Path "SPEC.md") { $SpecFile = "SPEC.md" }
-    elseif (Test-Path $SDD_SPEC_FILE) { $SpecFile = $SDD_SPEC_FILE }
-    else { $SpecFile = $SDD_SPEC_FILE }
-}
-
-if (-not $ConvergeDir) {
-    if (Test-Path "converge") { $ConvergeDir = "converge" }
-    else { $ConvergeDir = $SDD_CONVERGE_DIR }
-}
-
-# Ensure converge directory exists
-if (-not (Test-Path $ConvergeDir)) {
-    New-Item -ItemType Directory -Path $ConvergeDir -Force | Out-Null
-}
-
-# Import shared functions
-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-. "$scriptDir/shared-converge.ps1"
-
-# Find Task File
-function Get-TaskFile {
-    param([string]$TaskId, [string]$Dir)
-
-    if (-not $Dir) {
-        # Check new location first
-        if (Test-Path $SDD_TASKS_DIR) {
-            $dirs = Get-ChildItem -Path $SDD_TASKS_DIR -Filter "task-*-*" -Directory -ErrorAction SilentlyContinue
-            if ($dirs) {
-                $Dir = Join-Path $SDD_TASKS_DIR ($dirs | Select-Object -First 1).Name
-            }
-        }
-        # Fallback to legacy
-        if (-not $Dir) {
-            $dirs = Get-ChildItem -Filter "task-*-*" -Directory -ErrorAction SilentlyContinue
-            if ($dirs) { $Dir = ($dirs | Select-Object -First 1).Name }
-        }
-    }
-    if (-not $Dir) { return $null, $null }
-
-    $pattern = "$TaskId-*.md"
-    $files = Get-ChildItem -Path $Dir -Filter $pattern -ErrorAction SilentlyContinue
-    $files = $files | Where-Object { $_.Name -ne "MASTER-TASKS.md" }
-    return $Dir, ($files | Select-Object -First 1)
-}
-
-# Generate Report
-function New-ConvergeReport {
-    param(
-        [string]$TaskId,
-        [string[]]$Clauses,
-        [object[]]$Issues,
-        [int]$PassCount,
-        [int]$FailCount,
-        [string]$SpecFile,
-        [string]$OutputDir
-    )
-
-    $reportDir = Join-Path $OutputDir "task-$TaskId"
-    if (-not (Test-Path $reportDir)) {
-        New-Item -ItemType Directory -Path $reportDir -Force | Out-Null
-    }
-
-    $reportFile = Join-Path $reportDir "report.md"
-    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
-
-    $report = @"
-# Converge Report: $TaskId
-
-Generated: $timestamp by SDD Converge
-
-## Summary
-
-| Metric | Value |
-|--------|-------|
-| Clauses Found | $($Clauses.Count) |
-| Clauses Passed | $PassCount |
-| Clauses Failed | $FailCount |
-| Status | $(if ($FailCount -eq 0) { 'PASS' } else { 'FAIL' }) |
-
-## Clause Results
-
-| Clause ID | Type | Status | Notes |
-|-----------|------|--------|-------|
-"@
-
-    foreach ($clauseId in $Clauses) {
-        $clauseType = Get-ClauseType -ClauseId $clauseId
-        $isFail = $clauseId -in $Issues.Clause
-        $status = if ($isFail) { "FAIL" } else { "PASS" }
-        $report += "`n| $clauseId | $clauseType | $status | [Text spec] |"
-    }
-
-    $report += @"
-
-## Issues Found
-
-| Clause | Issue | Location |
-|--------|-------|----------|
-"@
-
-    if ($Issues.Count -eq 0) {
-        $report += "`n| - | No issues found | - |"
-    } else {
-        foreach ($issue in $Issues) {
-            $report += "`n| $($issue.Clause) | $($issue.Issue) | $($issue.Location) |"
-        }
-    }
-
-    $report += @"
-
-## Next Steps
-
-$(if ($FailCount -eq 0) {
-    "- [ ] **PROCEED:** All checks pass -> Move to next task"
-} else {
-    "- [ ] **FIX:** Address issues above -> Re-run converge
-    - [ ] **IF SPEC ISSUE:** Update SPEC.md clause -> Re-generate task"
-})
-
----
-Generated by SDD Per-Task Converge v1.1.0
-"@
-
-    $report | Out-File -FilePath $reportFile -Encoding UTF8
-    return $reportFile
-}
-
-# Main Execution
-Write-Host ""
-Write-Host "========================================" -ForegroundColor Cyan
-Write-Host "  SDD Per-Task Converge: $TaskId" -ForegroundColor Cyan
-Write-Host "========================================" -ForegroundColor Cyan
-Write-Host ""
-Write-Host "Output: $SDD_OUTPUT_BASE/" -ForegroundColor Gray
-Write-Host ""
-
-# Step 1: Find task file
-$taskDir, $taskFile = Get-TaskFile -TaskId $TaskId -Dir $TaskDir
-if (-not $taskFile) {
-    Write-Host "[FAIL] Task file for $TaskId not found" -ForegroundColor Red
-    exit 1
-}
-Write-Host "[PASS] Task file: $([System.IO.Path]::GetFileName($taskDir))/$($taskFile.Name)" -ForegroundColor Green
-
-# Step 2: Find SPEC.md
-if (-not (Test-Path $SpecFile)) {
-    Write-Host "[FAIL] SPEC file not found: $SpecFile" -ForegroundColor Red
-    exit 1
-}
-Write-Host "[PASS] SPEC file: $SpecFile" -ForegroundColor Green
-
-# Step 3: Extract clauses from SPEC.md
-$clauses = Get-SpecClauses -File $SpecFile
-Write-Host "[INFO] Found $($clauses.Count) clause IDs in SPEC.md" -ForegroundColor Cyan
-
-# Step 4: Get implementation files
-$implFiles = Get-TaskFiles -TaskId $TaskId -TaskDir $taskDir
-Write-Host "[INFO] Implementation files: $($implFiles.Count)" -ForegroundColor Cyan
-foreach ($f in $implFiles) {
-    Write-Host "       -> $f" -ForegroundColor Gray
-}
-
-# Step 5: Validate each clause
-Write-Host ""
-Write-Host "--- Clause Validation ---" -ForegroundColor Magenta
-
-$passCount = 0
-$failCount = 0
-
-foreach ($clause in $clauses) {
-    $result = Test-ClauseMatch -ClauseId $clause.Id -ClauseText $clause.Text -ClauseType $clause.Type -Files $implFiles
-
-    if ($result.Found) {
-        $passCount++
-        Write-Host "[PASS] $($clause.Id)" -ForegroundColor Green
-    } else {
-        $failCount++
-        Write-Host "[FAIL] $($clause.Id)" -ForegroundColor Red
-        $script:issuesFound += @{
-            Clause = $clause.Id
-            Issue = "Not found in implementation"
-            Location = $result.Location
-        }
-    }
-}
-
-# Summary
-Write-Host ""
-Write-Host "========================================" -ForegroundColor Cyan
-Write-Host "  Summary" -ForegroundColor Cyan
-Write-Host "========================================" -ForegroundColor Cyan
-Write-Host ""
-Write-Host "  Clauses Passed: $passCount" -ForegroundColor Green
-Write-Host "  Clauses Failed: $failCount" -ForegroundColor $(if ($failCount -gt 0) { "Red" } else { "Green" })
-
-if ($failCount -gt 0) {
-    Write-Host ""
-    Write-Host "  Issues Found:" -ForegroundColor Yellow
-    foreach ($issue in $script:issuesFound) {
-        Write-Host "    - $($issue.Clause): $($issue.Issue)" -ForegroundColor Yellow
-        Write-Host "      Location: $($issue.Location)" -ForegroundColor DarkGray
-    }
-}
-
-# Step 6: Generate report
-$reportFile = New-ConvergeReport -TaskId $TaskId -Clauses $clauses.Id -Issues $script:issuesFound -PassCount $passCount -FailCount $failCount -SpecFile $SpecFile -OutputDir $ConvergeDir
-Write-Host ""
-Write-Host "[PASS] Report saved: $reportFile" -ForegroundColor Green
-
-# Exit code
-if ($failCount -gt 0) {
-    if ($Strict) {
-        Write-Host "[FAIL] Converge FAILED (strict mode)" -ForegroundColor Red
-        exit 1
-    } else {
-        Write-Host "[WARN] Converge completed with issues (non-strict)" -ForegroundColor Yellow
-        exit 0
-    }
-} else {
-    Write-Host "[PASS] Converge PASSED" -ForegroundColor Green
-    exit 0
-}

package/lib/output-dirs.ps1

@@ -1,461 +0,0 @@
-# SDD Output Directory Management
-# Centralized helpers for managing output file locations
-# Version: 1.0.0 - 2026-08-29
-
-$ErrorActionPreference = "Stop"
-
-# ============================================================
-# Configuration
-# ============================================================
-
-# Default output base directory
-$script:SDD_OUTPUT_BASE = "sdd"
-
-# Subdirectories per phase
-$script:SDD_DIRS = @{
-    Brief     = ""          # sdd/brief.md (root of sdd/)
-    Spec      = ""          # sdd/SPEC.md (root of sdd/)
-    Tasks     = "tasks"    # sdd/tasks/
-    Converge  = "converge" # sdd/converge/
-    Plans     = "plans"    # sdd/plans/
-}
-
-# Legacy locations (for migration detection)
-$script:LEGACY_FILES = @{
-    Brief   = "BMAD-brief.md"
-    Spec    = "SPEC.md"
-}
-
-# ============================================================
-# Core Functions
-# ============================================================
-
-function Get-SddOutputBase {
-    <#
-    .SYNOPSIS
-    Get the SDD output base directory, defaulting to 'sdd/'
-    #>
-    param(
-        [string]$BaseDir = ""
-    )
-
-    if ($BaseDir -and $BaseDir -ne "") {
-        return $BaseDir
-    }
-
-    # Check config for custom output directory
-    if (Test-Path ".sdd/config.json") {
-        try {
-            $config = Get-Content ".sdd/config.json" -Raw | ConvertFrom-Json
-            if ($config.output -and $config.output.baseDir) {
-                return $config.output.baseDir
-            }
-        } catch {
-            # Ignore config errors
-        }
-    }
-
-    return $script:SDD_OUTPUT_BASE
-}
-
-function Get-SddOutputPath {
-    <#
-    .SYNOPSIS
-    Get full path to an SDD output file
-
-    .PARAMETER Type
-    Output type: Brief, Spec, Tasks, Converge, Plans
-
-    .PARAMETER SubPath
-    Optional subpath within the output directory
-    #>
-    param(
-        [Parameter(Mandatory=$true)]
-        [ValidateSet("Brief", "Spec", "Tasks", "Converge", "Plans")]
-        [string]$Type,
-
-        [string]$SubPath = ""
-    )
-
-    $base = Get-SddOutputBase
-    $subDir = $script:SDD_DIRS[$Type]
-
-    $path = $base
-    if ($subDir) {
-        $path = Join-Path $path $subDir
-    }
-    if ($SubPath) {
-        $path = Join-Path $path $SubPath
-    }
-
-    return $path
-}
-
-function Initialize-SddOutputDirs {
-    <#
-    .SYNOPSIS
-    Create all SDD output directories if they don't exist
-    #>
-    param(
-        [string]$BaseDir = ""
-    )
-
-    $base = Get-SddOutputBase -BaseDir $BaseDir
-    $created = @()
-
-    # Create base directory
-    if (-not (Test-Path $base)) {
-        New-Item -ItemType Directory -Path $base -Force | Out-Null
-        $created += $base
-    }
-
-    # Create subdirectories
-    foreach ($dir in $script:SDD_DIRS.Values) {
-        if ($dir) {
-            $fullPath = Join-Path $base $dir
-            if (-not (Test-Path $fullPath)) {
-                New-Item -ItemType Directory -Path $fullPath -Force | Out-Null
-                $created += $fullPath
-            }
-        }
-    }
-
-    return $created
-}
-
-function Test-SddOutputInitialized {
-    <#
-    .SYNOPSIS
-    Check if SDD output directories exist
-    #>
-    param(
-        [string]$BaseDir = ""
-    )
-
-    $base = Get-SddOutputBase -BaseDir $BaseDir
-    return Test-Path $base
-}
-
-function Get-LegacyFiles {
-    <#
-    .SYNOPSIS
-    Find legacy files in project root that should be migrated
-    #>
-    param([switch]$Detailed)
-
-    $found = @{}
-
-    foreach ($name in $script:LEGACY_FILES.Keys) {
-        $path = $script:LEGACY_FILES[$name]
-        if (Test-Path $path) {
-            if ($Detailed) {
-                $found[$name] = @{
-                    LegacyPath = $path
-                    NewPath = Get-SddOutputPath -Type $name
-                    Exists = $true
-                }
-            } else {
-                $found[$name] = $path
-            }
-        }
-    }
-
-    return $found
-}
-
-function Move-LegacyFile {
-    <#
-    .SYNOPSIS
-    Move a legacy file to new output directory
-    #>
-    param(
-        [Parameter(Mandatory=$true)]
-        [ValidateSet("Brief", "Spec")]
-        [string]$Type,
-
-        [switch]$Force
-    )
-
-    $legacyPath = $script:LEGACY_FILES[$Type]
-    if (-not (Test-Path $legacyPath)) {
-        Write-Verbose "No legacy file found for $Type"
-        return $false
-    }
-
-    $newPath = Get-SddOutputPath -Type $Type
-
-    # Check if new path already exists
-    if ((Test-Path $newPath) -and -not $Force) {
-        Write-Warning "New file already exists: $newPath"
-        Write-Host "Use -Force to overwrite" -ForegroundColor Yellow
-        return $false
-    }
-
-    # Initialize directories
-    $base = Get-SddOutputBase
-    $subDir = $script:SDD_DIRS[$Type]
-    if ($subDir) {
-        $targetDir = Join-Path $base $subDir
-    } else {
-        $targetDir = $base
-    }
-    if (-not (Test-Path $targetDir)) {
-        New-Item -ItemType Directory -Path $targetDir -Force | Out-Null
-    }
-
-    # Move file
-    Move-Item -Path $legacyPath -Destination $newPath -Force
-    Write-Host "[MIGRATED] $legacyPath -> $newPath" -ForegroundColor Green
-
-    return $true
-}
-
-function Migrate-AllLegacyFiles {
-    <#
-    .SYNOPSIS
-    Migrate all legacy files to new output directory structure
-    #>
-    param(
-        [switch]$DryRun,
-        [switch]$Force
-    )
-
-    $legacy = Get-LegacyFiles -Detailed
-
-    if ($legacy.Count -eq 0) {
-        Write-Host "No legacy files to migrate" -ForegroundColor Green
-        return
-    }
-
-    Write-Host ""
-    Write-Host "=== Legacy File Migration ===" -ForegroundColor Cyan
-    Write-Host ""
-    Write-Host "Found $($legacy.Count) legacy file(s):" -ForegroundColor Yellow
-    Write-Host ""
-
-    foreach ($name in $legacy.Keys) {
-        $info = $legacy[$name]
-        Write-Host "  $name :" -ForegroundColor Gray
-        Write-Host "    Legacy:  $($info.LegacyPath)" -ForegroundColor White
-        Write-Host "    New:     $($info.NewPath)" -ForegroundColor White
-        Write-Host ""
-    }
-
-    if ($DryRun) {
-        Write-Host "[DRY RUN] No files were moved" -ForegroundColor Yellow
-        return
-    }
-
-    $confirm = Read-Host "Proceed with migration? (y/N)"
-    if ($confirm -ne "y" -and $confirm -ne "Y") {
-        Write-Host "Migration cancelled" -ForegroundColor Yellow
-        return
-    }
-
-    Write-Host ""
-    Write-Host "Migrating files..." -ForegroundColor Cyan
-
-    foreach ($name in $legacy.Keys) {
-        Move-LegacyFile -Type $name -Force:$Force
-    }
-
-    Write-Host ""
-    Write-Host "[OK] Migration complete" -ForegroundColor Green
-}
-
-function Get-SddStructure {
-    <#
-    .SYNOPSIS
-    Get the current SDD output structure as a tree
-    #>
-    param(
-        [string]$BaseDir = "",
-        [switch]$IncludeEmpty
-    )
-
-    $base = Get-SddOutputBase -BaseDir $BaseDir
-    $structure = @{
-        Base = $base
-        Exists = Test-Path $base
-        Brief = $null
-        Spec = $null
-        Tasks = @()
-        Converge = @()
-        Plans = @()
-    }
-
-    if (-not $structure.Exists) {
-        return $structure
-    }
-
-    # Check brief
-    $briefPath = Get-SddOutputPath -Type Brief
-    if (Test-Path $briefPath) {
-        $structure.Brief = @{
-            Path = $briefPath
-            Modified = (Get-Item $briefPath).LastWriteTime
-        }
-    }
-
-    # Check spec
-    $specPath = Get-SddOutputPath -Type Spec
-    if (Test-Path $specPath) {
-        $structure.Spec = @{
-            Path = $specPath
-            Modified = (Get-Item $specPath).LastWriteTime
-        }
-    }
-
-    # Check tasks directory
-    $tasksPath = Get-SddOutputPath -Type Tasks
-    if (Test-Path $tasksPath) {
-        $taskDirs = Get-ChildItem -Path $tasksPath -Directory -ErrorAction SilentlyContinue
-        foreach ($dir in $taskDirs) {
-            $masterPath = Join-Path $dir.FullName "MASTER-TASKS.md"
-            $taskFiles = Get-ChildItem -Path $dir.FullName -Filter "T-*.md" -File -ErrorAction SilentlyContinue
-            $taskFiles = $taskFiles | Where-Object { $_.Name -ne "MASTER-TASKS.md" }
-
-            $structure.Tasks += @{
-                Name = $dir.Name
-                Path = $dir.FullName
-                Modified = $dir.LastWriteTime
-                HasMaster = Test-Path $masterPath
-                TaskCount = $taskFiles.Count
-            }
-        }
-    }
-
-    # Check converge directory
-    $convergePath = Get-SddOutputPath -Type Converge
-    if (Test-Path $convergePath) {
-        $files = Get-ChildItem -Path $convergePath -File -ErrorAction SilentlyContinue
-        $structure.Converge = $files | ForEach-Object {
-            @{
-                Name = $_.Name
-                Path = $_.FullName
-                Modified = $_.LastWriteTime
-            }
-        }
-    }
-
-    return $structure
-}
-
-function Show-SddStructure {
-    <#
-    .SYNOPSIS
-    Display SDD output structure as a tree
-    #>
-    param([string]$BaseDir = "")
-
-    $structure = Get-SddStructure -BaseDir $BaseDir
-
-    Write-Host ""
-    Write-Host "=== SDD Output Structure ===" -ForegroundColor Cyan
-    Write-Host ""
-
-    if (-not $structure.Exists) {
-        Write-Host "  $($structure.Base)/ (not initialized)" -ForegroundColor Gray
-        Write-Host ""
-        Write-Host "  Run /sdd init to create the structure" -ForegroundColor Yellow
-        return
-    }
-
-    # Brief
-    $briefIcon = if ($structure.Brief) { "[V]" } else { "[ ]" }
-    $briefColor = if ($structure.Brief) { "Green" } else { "Gray" }
-    Write-Host "  $($briefIcon) $($structure.Base)/brief.md" -ForegroundColor $briefColor
-
-    # Spec
-    $specIcon = if ($structure.Spec) { "[V]" } else { "[ ]" }
-    $specColor = if ($structure.Spec) { "Green" } else { "Gray" }
-    Write-Host "  $($specIcon) $($structure.Base)/SPEC.md" -ForegroundColor $specColor
-
-    # Tasks
-    Write-Host "  [ ] $($structure.Base)/tasks/" -ForegroundColor Gray
-    if ($structure.Tasks.Count -gt 0) {
-        foreach ($task in $structure.Tasks) {
-            $status = if ($task.HasMaster) { "[V]" } else { "[ ]" }
-            Write-Host "      $($status) $($task.Name)/" -ForegroundColor Gray
-            Write-Host "          MASTER-TASKS.md ($($task.TaskCount) tasks)" -ForegroundColor DarkGray
-        }
-    } else {
-        Write-Host "      (no task directories)" -ForegroundColor DarkGray
-    }
-
-    # Converge
-    Write-Host "  [ ] $($structure.Base)/converge/" -ForegroundColor Gray
-    if ($structure.Converge.Count -gt 0) {
-        foreach ($file in $structure.Converge) {
-            Write-Host "      [V] $($file.Name)" -ForegroundColor Green
-        }
-    } else {
-        Write-Host "      (no converge reports)" -ForegroundColor DarkGray
-    }
-
-    Write-Host ""
-}
-
-# ============================================================
-# Config Helpers
-# ============================================================
-
-function Set-SddOutputConfig {
-    <#
-    .SYNOPSIS
-    Update .sdd/config.json with output directory paths
-    #>
-    param(
-        [string]$BaseDir = ""
-    )
-
-    $base = Get-SddOutputBase -BaseDir $BaseDir
-
-    if (Test-Path ".sdd/config.json") {
-        $config = Get-Content ".sdd/config.json" -Raw | ConvertFrom-Json
-
-        # Add output section
-        $config | Add-Member -NotePropertyName "output" -NotePropertyValue ([ordered]@{
-            baseDir = $base
-            brief = Get-SddOutputPath -Type Brief
-            spec = Get-SddOutputPath -Type Spec
-            tasks = Get-SddOutputPath -Type Tasks
-            converge = Get-SddOutputPath -Type Converge
-        }) -Force
-
-        $config | ConvertTo-Json | Set-Content ".sdd/config.json"
-    }
-}
-
-function Get-SddOutputConfig {
-    <#
-    .SYNOPSIS
-    Get output paths from config
-    #>
-    if (Test-Path ".sdd/config.json") {
-        $config = Get-Content ".sdd/config.json" -Raw | ConvertFrom-Json
-        if ($config.output) {
-            return $config.output
-        }
-    }
-    return $null
-}
-
-# ============================================================
-# Export for use in other scripts
-# ============================================================
-
-# When dot-sourced, return functions
-return @{
-    GetBase = ${function:Get-SddOutputBase}
-    GetPath = ${function:Get-SddOutputPath}
-    Init = ${function:Initialize-SddOutputDirs}
-    TestInit = ${function:Test-SddOutputInitialized}
-    GetLegacy = ${function:Get-LegacyFiles}
-    MoveLegacy = ${function:Move-LegacyFile}
-    MigrateAll = ${function:Migrate-AllLegacyFiles}
-    GetStructure = ${function:Get-SddStructure}
-    ShowStructure = ${function:Show-SddStructure}
-    SetConfig = ${function:Set-SddOutputConfig}
-    GetConfig = ${function:Get-SddOutputConfig}
-}