sedd 0.1.0

package/scripts/powershell/sedd-status.ps1

@@ -0,0 +1,153 @@
+#!/usr/bin/env pwsh
+<#
+.SYNOPSIS
+    Shows current SEDD feature status
+.PARAMETER Branch
+    Feature branch name (optional, auto-detected)
+.PARAMETER Json
+    Output as JSON
+.EXAMPLE
+    ./sedd-status.ps1
+    ./sedd-status.ps1 -Json
+#>
+
+param(
+    [Parameter(Mandatory = $false)]
+    [string]$Branch = "",
+
+    [switch]$Json
+)
+
+$ErrorActionPreference = 'SilentlyContinue'
+
+#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}-')) {
+    if ($Json) {
+        Write-Output (@{ error = "Not on a feature branch"; branch = $Branch } | ConvertTo-Json -Compress)
+    }
+    else {
+        Write-Host "Not on a feature branch (current: $Branch)" -ForegroundColor Yellow
+    }
+    exit 0
+}
+
+# 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)) {
+    if ($Json) {
+        Write-Output (@{ error = "Feature not found"; branch = $Branch } | ConvertTo-Json -Compress)
+    }
+    else {
+        Write-Host "Feature not found: $Branch" -ForegroundColor Red
+    }
+    exit 0
+}
+
+# Load meta
+$metaPath = Join-Path $featureDir '_meta.json'
+if (-not (Test-Path $metaPath)) {
+    if ($Json) {
+        Write-Output (@{ error = "No _meta.json"; branch = $Branch; legacy = $true } | ConvertTo-Json -Compress)
+    }
+    else {
+        Write-Host "Legacy structure (no _meta.json). Run /sedd.migrate" -ForegroundColor Yellow
+    }
+    exit 0
+}
+
+$meta = Get-Content $metaPath -Raw | ConvertFrom-Json
+
+# Collect pending tasks
+$allPending = @()
+$totalCompleted = 0
+$totalTasks = 0
+
+foreach ($migId in $meta.migrations.PSObject.Properties.Name) {
+    $migInfo = $meta.migrations.$migId
+    $totalTasks += $migInfo.tasksTotal
+    $totalCompleted += $migInfo.tasksCompleted
+
+    $tasksFile = Join-Path $featureDir "$($migInfo.folder)/tasks.md"
+    if (Test-Path $tasksFile) {
+        $content = Get-Content $tasksFile -Raw
+        foreach ($line in ($content -split "`n")) {
+            if ($line -match '^\s*-\s*\[\s*\]\s*(T\d{3}-\d{3})\s+(.+)') {
+                $allPending += @{
+                    id = $Matches[1]
+                    migration = $migId
+                    text = ($Matches[2] -replace '`[^`]+`', '').Trim()
+                }
+            }
+        }
+    }
+}
+
+if ($Json) {
+    $output = @{
+        branch = $Branch
+        featureId = $meta.featureId
+        featureName = $meta.featureName
+        currentMigration = $meta.currentMigration
+        totalMigrations = $meta.migrations.PSObject.Properties.Name.Count
+        totalTasks = $totalTasks
+        completedTasks = $totalCompleted
+        pendingTasks = $allPending
+    }
+    Write-Output ($output | ConvertTo-Json -Depth 10 -Compress)
+}
+else {
+    Write-Host "`n=== SEDD Status ===" -ForegroundColor Cyan
+    Write-Host "Branch: $Branch" -ForegroundColor White
+    Write-Host "Feature: $($meta.featureName) ($($meta.featureId))" -ForegroundColor White
+    Write-Host "Current Migration: $($meta.currentMigration)" -ForegroundColor White
+    Write-Host "Progress: $totalCompleted/$totalTasks tasks" -ForegroundColor White
+
+    if ($allPending.Count -gt 0) {
+        Write-Host "`nPending Tasks:" -ForegroundColor Yellow
+        foreach ($task in ($allPending | Select-Object -First 10)) {
+            $truncated = if ($task.text.Length -gt 60) { $task.text.Substring(0, 60) + '...' } else { $task.text }
+            Write-Host "  - $($task.id): $truncated" -ForegroundColor White
+        }
+        if ($allPending.Count -gt 10) {
+            Write-Host "  ... and $($allPending.Count - 10) more" -ForegroundColor Gray
+        }
+    }
+    else {
+        Write-Host "`nAll tasks completed!" -ForegroundColor Green
+    }
+
+    Write-Host ""
+}
+
+#endregion

package/scripts/powershell/sedd-tasks.ps1

@@ -0,0 +1,176 @@
+#!/usr/bin/env pwsh
+<#
+.SYNOPSIS
+    Adds tasks to the current SEDD migration
+.PARAMETER Branch
+    Feature branch name (optional, auto-detected)
+.PARAMETER Tasks
+    JSON array of tasks to add
+.PARAMETER MigrationId
+    Specific migration ID (optional, uses current)
+.EXAMPLE
+    ./sedd-tasks.ps1 -Tasks '[{"story":"US1","description":"Implement feature"}]'
+#>
+
+param(
+    [Parameter(Mandatory = $false)]
+    [string]$Branch = "",
+
+    [Parameter(Mandatory = $false)]
+    [string]$Tasks = "[]",
+
+    [Parameter(Mandatory = $false)]
+    [string]$MigrationId = ""
+)
+
+$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 '' }
+}
+
+function Get-NextTaskNumber {
+    param([string]$Content, [string]$MigId)
+
+    $pattern = "T$MigId-(\d{3})"
+    $matches = [regex]::Matches($Content, $pattern)
+
+    if ($matches.Count -eq 0) { return 1 }
+
+    $maxNum = 0
+    foreach ($m in $matches) {
+        $num = [int]$m.Groups[1].Value
+        if ($num -gt $maxNum) { $maxNum = $num }
+    }
+
+    return $maxNum + 1
+}
+
+#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
+}
+
+# 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
+
+# Get migration
+$migId = if ($MigrationId) { $MigrationId } else { $meta.currentMigration }
+
+if (-not $migId) {
+    Write-Host "Error: No current migration. Run /sedd.clarify first." -ForegroundColor Red
+    exit 1
+}
+
+$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 for migration $migId" -ForegroundColor Red
+    exit 1
+}
+
+# Parse tasks
+$taskList = @()
+try {
+    $taskList = $Tasks | ConvertFrom-Json
+}
+catch {
+    Write-Host "Error: Invalid tasks JSON" -ForegroundColor Red
+    exit 1
+}
+
+if ($taskList.Count -eq 0) {
+    Write-Host "No tasks provided" -ForegroundColor Yellow
+    exit 0
+}
+
+# Read current content
+$content = Get-Content $tasksFile -Raw
+$nextNum = Get-NextTaskNumber -Content $content -MigId $migId
+
+# Build new tasks
+$newTasks = @()
+foreach ($task in $taskList) {
+    $taskId = "T$migId-" + $nextNum.ToString().PadLeft(3, '0')
+    $story = if ($task.story) { "[$($task.story)] " } else { "" }
+    $line = "- [ ] $taskId ${story}$($task.description)"
+    $newTasks += $line
+    $nextNum++
+}
+
+# Append to file
+$separator = "`n"
+if (-not $content.EndsWith("`n")) { $separator = "`n`n" }
+
+$newContent = $content + $separator + ($newTasks -join "`n") + "`n"
+Set-Content -Path $tasksFile -Value $newContent -Encoding UTF8
+
+Write-Host "Added $($taskList.Count) task(s) to migration $migId" -ForegroundColor Green
+
+foreach ($t in $newTasks) {
+    Write-Host "  $t" -ForegroundColor White
+}
+
+# Update meta
+$meta.migrations[$migId].tasksTotal = $meta.migrations[$migId].tasksTotal + $taskList.Count
+$meta.migrations[$migId].status = 'in-progress'
+Set-Content -Path $metaPath -Value ($meta | ConvertTo-Json -Depth 10) -Encoding UTF8
+
+# Output JSON
+$output = @{
+    success = $true
+    migrationId = $migId
+    tasksAdded = $taskList.Count
+    totalTasks = $meta.migrations[$migId].tasksTotal
+}
+
+Write-Output "---SEDD-OUTPUT---"
+Write-Output ($output | ConvertTo-Json -Compress)
+
+#endregion

package/templates/changelog-template.md

@@ -0,0 +1,6 @@
+# Changelog - {{FEATURE_ID}}: {{FEATURE_NAME}}
+
+All notable changes to this feature will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+

package/templates/clarify-template.md

@@ -0,0 +1,66 @@
+# Clarification - Migration {{MIGRATION_ID}}
+
+> Timestamp: {{TIMESTAMP}}
+> Parent: {{PARENT_MIGRATION}}
+
+## Context
+
+Brief description of what was clarified in this migration.
+
+---
+
+## Expected Outcome
+
+> What do you expect to achieve with this clarification?
+
+[User's expected outcome]
+
+---
+
+## Questions
+
+### Q1: [Question Title]
+
+**Impact:** High | Medium | Low
+**Area:** Functional Scope | Domain Model | UX Flow | Non-Functional | Integration | Edge Cases
+
+[Question description]
+
+**Options:**
+A) Option A description
+B) Option B description
+C) Option C description
+
+**Answer:** [Selected option or custom answer]
+
+---
+
+### Q2: [Question Title]
+
+**Impact:** High | Medium | Low
+**Area:** [Area]
+
+[Question description]
+
+**Options:**
+A) Option A
+B) Option B
+
+**Answer:** [Answer]
+
+---
+
+## Summary
+
+| Question | Area | Answer |
+|----------|------|--------|
+| Q1 | [Area] | [Brief answer] |
+| Q2 | [Area] | [Brief answer] |
+
+---
+
+## Related
+
+- **Decisions:** See `decisions.md` in this migration
+- **Tasks:** See `tasks.md` in this migration
+- **Parent Migration:** {{PARENT_MIGRATION}}

package/templates/config-template.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "./sedd.schema.json",
+  "specsDir": ".sedd",
+  "branchPattern": "{{id}}-{{name}}",
+  "autoSplit": {
+    "enabled": true,
+    "maxLines": 400
+  },
+  "hooks": {
+    "assertive": true,
+    "skills": ["langchain-expert", "architecture-mapper", "defect-analyzer"],
+    "checkOnlyCurrentMigration": true,
+    "showSyncWarnings": true,
+    "blockOnSyncError": false
+  },
+  "commit": {
+    "askBeforeCommit": true,
+    "messagePattern": "{{type}}({{id}}): {{message}}"
+  }
+}

package/templates/decisions-template.md

@@ -0,0 +1,56 @@
+# Decisions - Migration {{MIGRATION_ID}}
+
+> Timestamp: {{TIMESTAMP}}
+> Parent: {{PARENT_MIGRATION}}
+
+## Summary
+
+Decisions made based on clarification questions in this migration.
+
+---
+
+## Decision Records
+
+### D{{MIGRATION_ID}}-001: [Decision Title]
+
+**Question:** Q1
+**Answer:** [Selected option]
+
+**Decision:**
+[What was decided and why]
+
+**Impact:**
+- Impact item 1
+- Impact item 2
+- Impact item 3
+
+---
+
+### D{{MIGRATION_ID}}-002: [Decision Title]
+
+**Question:** Q2
+**Answer:** [Selected option]
+
+**Decision:**
+[What was decided and why]
+
+**Impact:**
+- Impact item 1
+- Impact item 2
+
+---
+
+## Decision Matrix
+
+| ID | Question | Decision | Impact |
+|----|----------|----------|--------|
+| D{{MIGRATION_ID}}-001 | Q1 | [Brief] | High |
+| D{{MIGRATION_ID}}-002 | Q2 | [Brief] | Medium |
+
+---
+
+## Related
+
+- **Clarifications:** See `clarify.md` in this migration
+- **Tasks:** See `tasks.md` in this migration
+- **Spec:** See `spec.md` in feature root

package/templates/interfaces-template.ts

@@ -0,0 +1,131 @@
+/**
+ * TypeScript Interfaces for {{FEATURE_NAME}}
+ *
+ * Feature ID: {{FEATURE_ID}}
+ * Generated: {{TIMESTAMP}}
+ *
+ * These interfaces will be converted to Zod schemas during implementation.
+ */
+
+// ============================================================================
+// Enums
+// ============================================================================
+
+export enum Status {
+  DRAFT = 'draft',
+  ACTIVE = 'active',
+  COMPLETED = 'completed',
+  ARCHIVED = 'archived',
+}
+
+// ============================================================================
+// Value Objects (Immutable)
+// ============================================================================
+
+export interface Address {
+  readonly street: string;
+  readonly city: string;
+  readonly country: string;
+  readonly postalCode: string;
+}
+
+// ============================================================================
+// Entities
+// ============================================================================
+
+export interface Entity1 {
+  id: string;
+  name: string;
+  status: Status;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface Entity2 {
+  id: string;
+  entity1Id: string;
+  value: string;
+  metadata?: Record<string, unknown>;
+}
+
+// ============================================================================
+// Aggregates
+// ============================================================================
+
+export interface Aggregate1 {
+  root: Entity1;
+  children: Entity2[];
+}
+
+// ============================================================================
+// DTOs (Data Transfer Objects)
+// ============================================================================
+
+export interface CreateEntity1Input {
+  name: string;
+  status?: Status;
+}
+
+export interface UpdateEntity1Input {
+  name?: string;
+  status?: Status;
+}
+
+export interface Entity1Output {
+  id: string;
+  name: string;
+  status: Status;
+  createdAt: string;
+  updatedAt: string;
+}
+
+// ============================================================================
+// API Types
+// ============================================================================
+
+export interface PaginationParams {
+  page?: number;
+  limit?: number;
+  sortBy?: string;
+  sortOrder?: 'asc' | 'desc';
+}
+
+export interface PaginatedResponse<T> {
+  data: T[];
+  total: number;
+  page: number;
+  limit: number;
+  hasMore: boolean;
+}
+
+export interface ApiError {
+  code: string;
+  message: string;
+  details?: Record<string, unknown>;
+}
+
+// ============================================================================
+// Event Types
+// ============================================================================
+
+export interface DomainEvent {
+  type: string;
+  aggregateId: string;
+  timestamp: Date;
+  payload: Record<string, unknown>;
+}
+
+export interface Entity1CreatedEvent extends DomainEvent {
+  type: 'entity1.created';
+  payload: {
+    entity: Entity1;
+  };
+}
+
+export interface Entity1UpdatedEvent extends DomainEvent {
+  type: 'entity1.updated';
+  payload: {
+    before: Partial<Entity1>;
+    after: Partial<Entity1>;
+  };
+}

package/templates/meta-template.json

@@ -0,0 +1,12 @@
+{
+  "featureId": "{{FEATURE_ID}}",
+  "featureName": "{{FEATURE_NAME}}",
+  "branch": "{{BRANCH_NAME}}",
+  "createdAt": "{{TIMESTAMP}}",
+  "specCreatedAt": "{{TIMESTAMP}}",
+  "currentMigration": null,
+  "migrations": {},
+  "splits": [],
+  "commits": [],
+  "expectation": null
+}

package/templates/progress-template.md

@@ -0,0 +1,61 @@
+# Implementation Progress
+
+> Feature: {{FEATURE_NAME}}
+> Last Updated: {{TIMESTAMP}}
+
+## Summary
+
+| Migration | Total | Done | Progress |
+|-----------|-------|------|----------|
+| **Total** | **0** | **0** | **0%** |
+
+---
+
+## Current Task
+
+**None** - Ready to start implementation.
+
+---
+
+## Task Log
+
+### Migration {{MIGRATION_ID}}
+
+- [ ] T{{MIGRATION_ID}}-001 [Started: --:--] [Foundation] Task description
+- [ ] T{{MIGRATION_ID}}-002 [Foundation] Task description
+
+---
+
+## Completed Migrations
+
+| Migration | Tasks | Completed At | Commit |
+|-----------|-------|--------------|--------|
+| - | - | - | - |
+
+---
+
+## Session History
+
+### {{DATE}}
+
+**Migration:** {{MIGRATION_ID}}
+**Tasks Completed:** 0
+
+**Notes:**
+- Session notes here
+
+---
+
+## Blocked Tasks
+
+| Task | Migration | Blocked By | Notes |
+|------|-----------|------------|-------|
+| - | - | - | - |
+
+---
+
+## Test Results
+
+| Migration | Unit | Integration | E2E |
+|-----------|------|-------------|-----|
+| {{MIGRATION_ID}} | 0/0 | 0/0 | 0/0 |