sedd 0.1.0

package/scripts/bash/sedd-specify.sh

@@ -0,0 +1,147 @@
+#!/usr/bin/env bash
+# SEDD Specify - Creates initial feature structure
+# Usage: ./sedd-specify.sh <feature_id> <feature_name> [description]
+
+set -e
+
+FEATURE_ID="$1"
+FEATURE_NAME="$2"
+DESCRIPTION="${3:-}"
+
+if [ -z "$FEATURE_ID" ] || [ -z "$FEATURE_NAME" ]; then
+    echo "Usage: ./sedd-specify.sh <feature_id> <feature_name> [description]"
+    exit 1
+fi
+
+# Load config
+SPECS_DIR=".sedd"
+if [ -f "sedd.config.json" ]; then
+    SPECS_DIR=$(grep -o '"specsDir"[[:space:]]*:[[:space:]]*"[^"]*"' sedd.config.json | cut -d'"' -f4)
+    [ -z "$SPECS_DIR" ] && SPECS_DIR=".sedd"
+fi
+
+BRANCH_NAME="${FEATURE_ID}-${FEATURE_NAME}"
+FEATURE_DIR="${SPECS_DIR}/${BRANCH_NAME}"
+
+# Check if exists
+if [ -d "$FEATURE_DIR" ]; then
+    echo "Feature already exists: $FEATURE_DIR"
+    exit 1
+fi
+
+# Create directory
+mkdir -p "$FEATURE_DIR"
+echo "Created: $FEATURE_DIR"
+
+# Create _meta.json
+NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+cat > "$FEATURE_DIR/_meta.json" << EOF
+{
+  "featureId": "$FEATURE_ID",
+  "featureName": "$FEATURE_NAME",
+  "branch": "$BRANCH_NAME",
+  "createdAt": "$NOW",
+  "specCreatedAt": "$NOW",
+  "currentMigration": null,
+  "migrations": {},
+  "splits": [],
+  "commits": []
+}
+EOF
+echo "Created: _meta.json"
+
+# Create spec.md
+cat > "$FEATURE_DIR/spec.md" << EOF
+# $FEATURE_NAME
+
+## Overview
+
+$DESCRIPTION
+
+## Goals
+
+- [ ] Goal 1
+- [ ] Goal 2
+
+## Non-Goals
+
+- Out of scope item 1
+
+## User Stories
+
+### US1: [Story Title]
+
+**As a** [user type]
+**I want** [action]
+**So that** [benefit]
+
+#### Acceptance Criteria
+
+- [ ] Criterion 1
+- [ ] Criterion 2
+
+## Technical Requirements
+
+### Architecture
+
+[Describe the technical approach]
+
+### Dependencies
+
+- Dependency 1
+- Dependency 2
+
+## UI/UX (if applicable)
+
+[ASCII mockups or description]
+
+## Open Questions
+
+- [ ] Question 1?
+- [ ] Question 2?
+EOF
+echo "Created: spec.md"
+
+# Create interfaces.ts
+cat > "$FEATURE_DIR/interfaces.ts" << EOF
+/**
+ * TypeScript interfaces for $FEATURE_NAME
+ * Feature ID: $FEATURE_ID
+ *
+ * Define types here FIRST, then implement with Zod schemas later.
+ */
+
+// Example interface - replace with actual types
+export interface Example {
+  id: string;
+  name: string;
+  createdAt: Date;
+}
+
+// Add your interfaces below
+EOF
+echo "Created: interfaces.ts"
+
+# Create CHANGELOG.md
+cat > "$FEATURE_DIR/CHANGELOG.md" << EOF
+# Changelog - $FEATURE_NAME
+
+All notable changes to this feature will be documented in this file.
+
+## [Unreleased]
+
+### Added
+- Initial feature specification created
+EOF
+echo "Created: CHANGELOG.md"
+
+echo ""
+echo "Feature structure created successfully!"
+echo "Next steps:"
+echo "  1. Edit spec.md with detailed requirements"
+echo "  2. Define interfaces in interfaces.ts"
+echo "  3. Run /sedd.clarify to start first migration"
+
+# Output JSON
+echo "---SEDD-OUTPUT---"
+echo "{\"success\":true,\"featureDir\":\"$FEATURE_DIR\",\"branch\":\"$BRANCH_NAME\",\"files\":[\"_meta.json\",\"spec.md\",\"interfaces.ts\",\"CHANGELOG.md\"]}"

package/scripts/powershell/sedd-clarify.ps1

@@ -0,0 +1,222 @@
+#!/usr/bin/env pwsh
+<#
+.SYNOPSIS
+    Creates a new SEDD migration with clarify/tasks/decisions files
+.PARAMETER Branch
+    Feature branch name (e.g., "023-agent-executor")
+.PARAMETER Questions
+    JSON array of clarification questions
+.PARAMETER Decisions
+    JSON array of decisions made
+.EXAMPLE
+    ./sedd-clarify.ps1 -Branch "023-agent-executor"
+#>
+
+param(
+    [Parameter(Mandatory = $false)]
+    [string]$Branch = "",
+
+    [Parameter(Mandatory = $false)]
+    [string]$Questions = "[]",
+
+    [Parameter(Mandatory = $false)]
+    [string]$Decisions = "[]"
+)
+
+$ErrorActionPreference = 'Stop'
+
+#region Config
+
+$DEFAULT_CONFIG = @{ specsDir = '.sedd' }
+
+function Get-SeddConfig {
+    $configPath = Join-Path (Get-Location) 'sedd.config.json'
+    if (Test-Path $configPath) {
+        try {
+            $config = Get-Content $configPath -Raw | ConvertFrom-Json -AsHashtable
+            return @{ specsDir = if ($config.specsDir) { $config.specsDir } else { '.sedd' } }
+        }
+        catch { }
+    }
+    return $DEFAULT_CONFIG
+}
+
+function Get-CurrentBranch {
+    try {
+        return (git rev-parse --abbrev-ref HEAD 2>$null).Trim()
+    }
+    catch { return '' }
+}
+
+function Get-NextMigrationId {
+    param([hashtable]$Meta)
+
+    $ids = @($Meta.migrations.PSObject.Properties.Name | ForEach-Object { [int]$_ })
+    $max = if ($ids.Count -gt 0) { ($ids | Measure-Object -Maximum).Maximum } else { 0 }
+    return ($max + 1).ToString().PadLeft(3, '0')
+}
+
+#endregion
+
+#region Main
+
+$config = Get-SeddConfig
+$specsDir = $config.specsDir
+
+# Get branch
+if (-not $Branch) {
+    $Branch = Get-CurrentBranch
+}
+
+if (-not ($Branch -match '^\d{3}-')) {
+    Write-Host "Error: Not on a feature branch (current: $Branch)" -ForegroundColor Red
+    exit 1
+}
+
+# Find feature directory
+$featureDir = Join-Path (Get-Location) "$specsDir/$Branch"
+if (-not (Test-Path $featureDir)) {
+    $featureDir = Join-Path (Get-Location) "specs/$Branch"
+}
+
+if (-not (Test-Path $featureDir)) {
+    Write-Host "Error: Feature directory not found for branch: $Branch" -ForegroundColor Red
+    exit 1
+}
+
+# Load meta
+$metaPath = Join-Path $featureDir '_meta.json'
+if (-not (Test-Path $metaPath)) {
+    Write-Host "Error: _meta.json not found. Run /sedd.specify first." -ForegroundColor Red
+    exit 1
+}
+
+$meta = Get-Content $metaPath -Raw | ConvertFrom-Json -AsHashtable
+
+# Generate migration info
+$migrationId = Get-NextMigrationId -Meta $meta
+$timestamp = Get-Date -Format "yyyy-MM-dd_HH-mm-ss"
+$migrationFolder = "${migrationId}_${timestamp}"
+$migrationDir = Join-Path $featureDir $migrationFolder
+
+# Create migration directory
+New-Item -ItemType Directory -Path $migrationDir -Force | Out-Null
+Write-Host "Created migration: $migrationFolder" -ForegroundColor Green
+
+# Create clarify.md
+$clarifyContent = @"
+# Clarification Session - Migration $migrationId
+
+**Timestamp:** $(Get-Date -Format "yyyy-MM-dd HH:mm:ss")
+**Branch:** $Branch
+
+## Questions & Answers
+
+<!-- Questions discussed during this clarification session -->
+
+"@
+
+# Parse and add questions if provided
+try {
+    $questionList = $Questions | ConvertFrom-Json
+    if ($questionList.Count -gt 0) {
+        $qNum = 1
+        foreach ($q in $questionList) {
+            $clarifyContent += "`n### Q$qNum`: $($q.question)`n"
+            if ($q.answer) {
+                $clarifyContent += "`n**Answer:** $($q.answer)`n"
+            }
+            $qNum++
+        }
+    }
+}
+catch { }
+
+Set-Content -Path (Join-Path $migrationDir 'clarify.md') -Value $clarifyContent -Encoding UTF8
+Write-Host "Created: clarify.md" -ForegroundColor Green
+
+# Create decisions.md
+$decisionsContent = @"
+# Decisions - Migration $migrationId
+
+**Timestamp:** $(Get-Date -Format "yyyy-MM-dd HH:mm:ss")
+
+## Decisions Made
+
+| # | Decision | Rationale |
+|---|----------|-----------|
+"@
+
+try {
+    $decisionList = $Decisions | ConvertFrom-Json
+    $dNum = 1
+    foreach ($d in $decisionList) {
+        $decisionsContent += "| $dNum | $($d.decision) | $($d.rationale) |`n"
+        $dNum++
+    }
+}
+catch { }
+
+Set-Content -Path (Join-Path $migrationDir 'decisions.md') -Value $decisionsContent -Encoding UTF8
+Write-Host "Created: decisions.md" -ForegroundColor Green
+
+# Create tasks.md
+$tasksContent = @"
+# Tasks - Migration $migrationId
+
+**Migration:** $migrationId
+**Timestamp:** $timestamp
+**Parent:** $(if ($meta.currentMigration) { $meta.currentMigration } else { 'none' })
+
+## Tasks
+
+<!-- Tasks will be added here by /sedd.tasks -->
+<!-- Format: - [ ] T$migrationId-001 [US1] Task description -->
+
+"@
+
+Set-Content -Path (Join-Path $migrationDir 'tasks.md') -Value $tasksContent -Encoding UTF8
+Write-Host "Created: tasks.md" -ForegroundColor Green
+
+# Update _meta.json
+$now = Get-Date -Format "yyyy-MM-ddTHH:mm:ssZ"
+$previousMigration = $meta.currentMigration
+
+if (-not $meta.migrations) {
+    $meta.migrations = @{}
+}
+
+$meta.migrations[$migrationId] = @{
+    id = $migrationId
+    timestamp = $timestamp
+    folder = $migrationFolder
+    parent = $previousMigration
+    status = 'pending'
+    tasksTotal = 0
+    tasksCompleted = 0
+    createdAt = $now
+}
+$meta.currentMigration = $migrationId
+
+Set-Content -Path $metaPath -Value ($meta | ConvertTo-Json -Depth 10) -Encoding UTF8
+Write-Host "Updated: _meta.json" -ForegroundColor Green
+
+Write-Host "`nMigration $migrationId created successfully!" -ForegroundColor Cyan
+Write-Host "Next steps:" -ForegroundColor Cyan
+Write-Host "  1. Add questions/answers to clarify.md" -ForegroundColor White
+Write-Host "  2. Document decisions in decisions.md" -ForegroundColor White
+Write-Host "  3. Run /sedd.tasks to generate tasks" -ForegroundColor White
+
+# Output JSON for Claude
+$output = @{
+    success = $true
+    migrationId = $migrationId
+    migrationFolder = $migrationFolder
+    migrationDir = $migrationDir
+    files = @('clarify.md', 'decisions.md', 'tasks.md')
+}
+
+Write-Output "---SEDD-OUTPUT---"
+Write-Output ($output | ConvertTo-Json -Compress)
+
+#endregion

package/scripts/powershell/sedd-complete-task.ps1

@@ -0,0 +1,143 @@
+#!/usr/bin/env pwsh
+<#
+.SYNOPSIS
+    Marks a SEDD task as completed
+.PARAMETER TaskId
+    Task ID to complete (e.g., "T001-001")
+.PARAMETER Branch
+    Feature branch name (optional, auto-detected)
+.EXAMPLE
+    ./sedd-complete-task.ps1 -TaskId "T001-001"
+#>
+
+param(
+    [Parameter(Mandatory = $true)]
+    [string]$TaskId,
+
+    [Parameter(Mandatory = $false)]
+    [string]$Branch = ""
+)
+
+$ErrorActionPreference = 'Stop'
+
+#region Config
+
+function Get-SeddConfig {
+    $configPath = Join-Path (Get-Location) 'sedd.config.json'
+    if (Test-Path $configPath) {
+        try {
+            $config = Get-Content $configPath -Raw | ConvertFrom-Json -AsHashtable
+            return @{ specsDir = if ($config.specsDir) { $config.specsDir } else { '.sedd' } }
+        }
+        catch { }
+    }
+    return @{ specsDir = '.sedd' }
+}
+
+function Get-CurrentBranch {
+    try { return (git rev-parse --abbrev-ref HEAD 2>$null).Trim() }
+    catch { return '' }
+}
+
+#endregion
+
+#region Main
+
+$config = Get-SeddConfig
+$specsDir = $config.specsDir
+
+if (-not $Branch) { $Branch = Get-CurrentBranch }
+
+if (-not ($Branch -match '^\d{3}-')) {
+    Write-Host "Error: Not on a feature branch" -ForegroundColor Red
+    exit 1
+}
+
+# Parse task ID
+if (-not ($TaskId -match '^T(\d{3})-(\d{3})$')) {
+    Write-Host "Error: Invalid task ID format. Expected: T001-001" -ForegroundColor Red
+    exit 1
+}
+
+$migId = $Matches[1]
+
+# Find feature directory
+$featureDir = Join-Path (Get-Location) "$specsDir/$Branch"
+if (-not (Test-Path $featureDir)) {
+    $featureDir = Join-Path (Get-Location) "specs/$Branch"
+}
+
+if (-not (Test-Path $featureDir)) {
+    Write-Host "Error: Feature not found: $Branch" -ForegroundColor Red
+    exit 1
+}
+
+# Load meta
+$metaPath = Join-Path $featureDir '_meta.json'
+if (-not (Test-Path $metaPath)) {
+    Write-Host "Error: _meta.json not found" -ForegroundColor Red
+    exit 1
+}
+
+$meta = Get-Content $metaPath -Raw | ConvertFrom-Json -AsHashtable
+
+$migInfo = $meta.migrations[$migId]
+if (-not $migInfo) {
+    Write-Host "Error: Migration $migId not found" -ForegroundColor Red
+    exit 1
+}
+
+$tasksFile = Join-Path $featureDir "$($migInfo.folder)/tasks.md"
+if (-not (Test-Path $tasksFile)) {
+    Write-Host "Error: tasks.md not found" -ForegroundColor Red
+    exit 1
+}
+
+# Read and update task
+$content = Get-Content $tasksFile -Raw
+$pattern = "- \[ \] $TaskId"
+
+if ($content -notmatch [regex]::Escape($pattern)) {
+    if ($content -match "- \[x\] $TaskId") {
+        Write-Host "Task $TaskId is already completed" -ForegroundColor Yellow
+        exit 0
+    }
+    Write-Host "Error: Task $TaskId not found" -ForegroundColor Red
+    exit 1
+}
+
+$newContent = $content -replace [regex]::Escape("- [ ] $TaskId"), "- [x] $TaskId"
+Set-Content -Path $tasksFile -Value $newContent -Encoding UTF8
+
+Write-Host "Completed: $TaskId" -ForegroundColor Green
+
+# Update meta
+$meta.migrations[$migId].tasksCompleted = $meta.migrations[$migId].tasksCompleted + 1
+
+$completed = $meta.migrations[$migId].tasksCompleted
+$total = $meta.migrations[$migId].tasksTotal
+
+if ($completed -ge $total) {
+    $meta.migrations[$migId].status = 'completed'
+    $meta.migrations[$migId].completedAt = Get-Date -Format "yyyy-MM-ddTHH:mm:ssZ"
+    Write-Host "Migration $migId completed!" -ForegroundColor Cyan
+}
+
+Set-Content -Path $metaPath -Value ($meta | ConvertTo-Json -Depth 10) -Encoding UTF8
+
+Write-Host "Progress: $completed/$total tasks" -ForegroundColor White
+
+# Output JSON
+$output = @{
+    success = $true
+    taskId = $TaskId
+    migrationId = $migId
+    completed = $completed
+    total = $total
+    migrationStatus = $meta.migrations[$migId].status
+}
+
+Write-Output "---SEDD-OUTPUT---"
+Write-Output ($output | ConvertTo-Json -Compress)
+
+#endregion

package/scripts/powershell/sedd-specify.ps1

@@ -0,0 +1,192 @@
+#!/usr/bin/env pwsh
+<#
+.SYNOPSIS
+    Creates initial SEDD feature structure
+.PARAMETER FeatureId
+    Feature ID (e.g., "023")
+.PARAMETER FeatureName
+    Feature name (e.g., "agent-executor")
+.PARAMETER Description
+    Brief description of the feature
+.EXAMPLE
+    ./sedd-specify.ps1 -FeatureId "024" -FeatureName "new-feature" -Description "My new feature"
+#>
+
+param(
+    [Parameter(Mandatory = $true)]
+    [string]$FeatureId,
+
+    [Parameter(Mandatory = $true)]
+    [string]$FeatureName,
+
+    [Parameter(Mandatory = $false)]
+    [string]$Description = ""
+)
+
+$ErrorActionPreference = 'Stop'
+
+#region Config
+
+$DEFAULT_CONFIG = @{
+    specsDir = '.sedd'
+}
+
+function Get-SeddConfig {
+    $configPath = Join-Path (Get-Location) 'sedd.config.json'
+    if (Test-Path $configPath) {
+        try {
+            $config = Get-Content $configPath -Raw | ConvertFrom-Json -AsHashtable
+            return @{
+                specsDir = if ($config.specsDir) { $config.specsDir } else { $DEFAULT_CONFIG.specsDir }
+            }
+        }
+        catch { }
+    }
+    return $DEFAULT_CONFIG
+}
+
+#endregion
+
+#region Main
+
+$config = Get-SeddConfig
+$specsDir = $config.specsDir
+$branchName = "$FeatureId-$FeatureName"
+$featureDir = Join-Path (Get-Location) "$specsDir/$branchName"
+
+# Check if already exists
+if (Test-Path $featureDir) {
+    Write-Host "Feature already exists: $featureDir" -ForegroundColor Yellow
+    exit 1
+}
+
+# Create directory
+New-Item -ItemType Directory -Path $featureDir -Force | Out-Null
+Write-Host "Created: $featureDir" -ForegroundColor Green
+
+# Create _meta.json
+$now = Get-Date -Format "yyyy-MM-ddTHH:mm:ssZ"
+$meta = @{
+    featureId = $FeatureId
+    featureName = $FeatureName
+    branch = $branchName
+    createdAt = $now
+    specCreatedAt = $now
+    currentMigration = $null
+    migrations = @{}
+    splits = @()
+    commits = @()
+} | ConvertTo-Json -Depth 10
+
+Set-Content -Path (Join-Path $featureDir '_meta.json') -Value $meta -Encoding UTF8
+Write-Host "Created: _meta.json" -ForegroundColor Green
+
+# Create spec.md
+$specContent = @"
+# $FeatureName
+
+## Overview
+
+$Description
+
+## Goals
+
+- [ ] Goal 1
+- [ ] Goal 2
+
+## Non-Goals
+
+- Out of scope item 1
+
+## User Stories
+
+### US1: [Story Title]
+
+**As a** [user type]
+**I want** [action]
+**So that** [benefit]
+
+#### Acceptance Criteria
+
+- [ ] Criterion 1
+- [ ] Criterion 2
+
+## Technical Requirements
+
+### Architecture
+
+[Describe the technical approach]
+
+### Dependencies
+
+- Dependency 1
+- Dependency 2
+
+## UI/UX (if applicable)
+
+[ASCII mockups or description]
+
+## Open Questions
+
+- [ ] Question 1?
+- [ ] Question 2?
+"@
+
+Set-Content -Path (Join-Path $featureDir 'spec.md') -Value $specContent -Encoding UTF8
+Write-Host "Created: spec.md" -ForegroundColor Green
+
+# Create interfaces.ts
+$interfacesContent = @"
+/**
+ * TypeScript interfaces for $FeatureName
+ * Feature ID: $FeatureId
+ *
+ * Define types here FIRST, then implement with Zod schemas later.
+ */
+
+// Example interface - replace with actual types
+export interface Example {
+  id: string;
+  name: string;
+  createdAt: Date;
+}
+
+// Add your interfaces below
+"@
+
+Set-Content -Path (Join-Path $featureDir 'interfaces.ts') -Value $interfacesContent -Encoding UTF8
+Write-Host "Created: interfaces.ts" -ForegroundColor Green
+
+# Create CHANGELOG.md
+$changelogContent = @"
+# Changelog - $FeatureName
+
+All notable changes to this feature will be documented in this file.
+
+## [Unreleased]
+
+### Added
+- Initial feature specification created
+"@
+
+Set-Content -Path (Join-Path $featureDir 'CHANGELOG.md') -Value $changelogContent -Encoding UTF8
+Write-Host "Created: CHANGELOG.md" -ForegroundColor Green
+
+Write-Host "`nFeature structure created successfully!" -ForegroundColor Cyan
+Write-Host "Next steps:" -ForegroundColor Cyan
+Write-Host "  1. Edit spec.md with detailed requirements" -ForegroundColor White
+Write-Host "  2. Define interfaces in interfaces.ts" -ForegroundColor White
+Write-Host "  3. Run /sedd.clarify to start first migration" -ForegroundColor White
+
+# Output JSON for Claude to parse
+$output = @{
+    success = $true
+    featureDir = $featureDir
+    branch = $branchName
+    files = @('_meta.json', 'spec.md', 'interfaces.ts', 'CHANGELOG.md')
+}
+
+Write-Output "---SEDD-OUTPUT---"
+Write-Output ($output | ConvertTo-Json -Compress)
+
+#endregion