sdd-pipeline 1.2.3 → 1.2.4

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}
-}

package/lib/sdd-check.ps1

@@ -1,130 +0,0 @@
-param(
-    [Parameter(Mandatory=$true, Position=0)]
-    [string]$FilePath,
-
-    [string]$Section = "",
-
-    [string]$SpecFile = "SPEC.md",
-
-    [ValidateSet("table", "json", "minimal")]
-    [string]$OutputFormat = "table"
-)
-
-# Import shared functions
-$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-. "$scriptDir/shared-converge.ps1"
-
-$ErrorActionPreference = "Continue"
-
-# Resolve Files
-$files = @()
-if ($FilePath -match '\*|\?') {
-    $files = Get-ChildItem -Path $FilePath -File -ErrorAction SilentlyContinue | ForEach-Object { $_.FullName }
-} else {
-    if (Test-Path $FilePath) {
-        $files = @((Resolve-Path $FilePath).Path)
-    }
-}
-
-if ($files.Count -eq 0) {
-    Write-Error "No files found matching: $FilePath"
-    exit 1
-}
-
-# Load SPEC
-if (-not (Test-Path $SpecFile)) {
-    Write-Error "SPEC file not found: $SpecFile"
-    exit 1
-}
-
-Write-Host ""
-Write-Host "========================================" -ForegroundColor Cyan
-Write-Host "  SDD Check" -ForegroundColor Cyan
-Write-Host "========================================" -ForegroundColor Cyan
-Write-Host ""
-Write-Host "  Files: $($files.Count)" -ForegroundColor Gray
-Write-Host "  Spec:  $SpecFile" -ForegroundColor Gray
-Write-Host ""
-
-# Get clauses from SPEC
-$clauses = Get-SpecClauses -File $SpecFile
-Write-Host "  Clauses found: $($clauses.Count)" -ForegroundColor Gray
-Write-Host ""
-
-if ($clauses.Count -eq 0) {
-    Write-Host "[WARN] No clause IDs found in SPEC.md" -ForegroundColor Yellow
-    Write-Host "   Add clause IDs like [SC-001], [SC-COLOR-001] to SPEC.md" -ForegroundColor Yellow
-    exit 0
-}
-
-# Filter by section if specified
-if ($Section) {
-    $specContent = Get-Content $SpecFile -Raw
-    if ($specContent -match "(?s)##\s+$Section.*?(?=\n##\s+|\Z)") {
-        $sectionText = $Matches[0]
-        $filtered = @()
-        foreach ($clause in $clauses) {
-            if ($sectionText -match "\[$($clause.Id)\]") {
-                $filtered += $clause
-            }
-        }
-        $clauses = $filtered
-        Write-Host "  Section: $Section -> $($clauses.Count) clauses" -ForegroundColor Gray
-    }
-}
-
-# Check each clause
-$results = @()
-$passCount = 0
-$failCount = 0
-
-foreach ($clause in $clauses) {
-    $result = Test-ClauseMatch -ClauseId $clause.Id -ClauseText $clause.Text -ClauseType $clause.Type -Files $files
-    $results += $result
-
-    if ($result.Found) {
-        $passCount++
-    } else {
-        $failCount++
-    }
-}
-
-# Output
-if ($OutputFormat -eq "json") {
-    $results | ConvertTo-Json -Depth 10
-} elseif ($OutputFormat -eq "minimal") {
-    foreach ($r in $results) {
-        $status = if ($r.Found) { "[PASS]" } else { "[FAIL]" }
-        Write-Host "$status $($r.ClauseId)"
-    }
-} else {
-    # Table format
-    $maxIdLen = [Math]::Max(10, ($results | ForEach-Object { $_.ClauseId.Length } | Measure-Object -Maximum).Maximum)
-    $maxTypeLen = [Math]::Max(10, ($results | ForEach-Object { $_.Type.Length } | Measure-Object -Maximum).Maximum)
-
-    foreach ($r in $results) {
-        $status = if ($r.Found) { "[PASS]" } else { "[FAIL]" }
-        $color = if ($r.Found) { "Green" } else { "Red" }
-        Write-Host "$status $($r.ClauseId)" -ForegroundColor $color
-        Write-Host "       Type: $($r.Type) | Location: $($r.Location)" -ForegroundColor Gray
-    }
-}
-
-# Summary
-Write-Host ""
-Write-Host "========================================" -ForegroundColor Cyan
-Write-Host "  Result: $passCount passed, $failCount failed" -ForegroundColor $(if ($failCount -eq 0) { "Green" } else { "Yellow" })
-Write-Host "========================================" -ForegroundColor Cyan
-Write-Host ""
-
-if ($failCount -gt 0) {
-    Write-Host "Missing clauses:" -ForegroundColor Yellow
-    $results | Where-Object { -not $_.Found } | ForEach-Object {
-        $shortText = if ($_.Text) { $_.Text.Substring(0, [Math]::Min(50, $_.Text.Length)) } else { "(no text)" }
-        Write-Host "  [FAIL] $($_.ClauseId): $shortText" -ForegroundColor Red
-    }
-    Write-Host ""
-}
-
-# Exit code
-exit $(if ($failCount -eq 0) { 0 } else { 1 })