sedd 0.1.0

package/hooks/check-roadmap.ps1

@@ -0,0 +1,343 @@
+#!/usr/bin/env pwsh
+<#
+.SYNOPSIS
+    SEDD Assertive Hook - UserPromptSubmit
+.DESCRIPTION
+    Forces skill activation and tracks migration tasks
+#>
+
+$ErrorActionPreference = 'SilentlyContinue'
+
+#region Constants
+
+$DEFAULT_CONFIG = @{
+    specsDir = '.sedd'
+    hooks = @{
+        assertive = $true
+        skills = @('langchain-expert', 'architecture-mapper', 'defect-analyzer')
+    }
+}
+
+$IGNORE_PATTERNS = @(
+    '^\/\w+',
+    '^\s*(oi|hi|hello|hey)\s*$',
+    '^\s*(obrigado|thanks?|thx)\s*$',
+    '^(sim|yes|no|não|ok|okay)\s*$',
+    '^\s*\?\s*$',
+    '^q\d+:',
+    '^(a|b|c|d|e)\s*$',
+    '^continue\s*$',
+    '^prossiga\s*$'
+)
+
+$SKILLS = @{
+    'langchain-expert' = @{
+        triggers = @(
+            'langchain', 'langgraph', 'agent', 'tool', 'graph', 'checkpoint',
+            'omniagent', 'subagent', '@langchain', 'stategraph',
+            'toolnode', 'basemessage', 'dynamicstructuredtool'
+        )
+        instruction = @"
+[SKILL ACTIVATED: langchain-expert]
+You MUST use the langchain-expert skill for this request.
+Follow LangGraph 1.0+ patterns, check Context7 MCP for latest docs.
+Key patterns: StateGraph, Annotation, ToolNode, DynamicStructuredTool, streamEvents.
+"@
+    }
+    'architecture-mapper' = @{
+        triggers = @(
+            'arquitetura', 'architecture', 'estrutura', 'structure', 'mapear',
+            'flow', 'fluxo', 'diagram', 'onde fica', 'where is', 'como funciona', 'how does'
+        )
+        instruction = @"
+[SKILL ACTIVATED: architecture-mapper]
+You MUST map the architecture before answering.
+Use Mermaid diagrams, identify related files, trace data flow.
+"@
+    }
+    'defect-analyzer' = @{
+        triggers = @(
+            'bug', 'erro', 'error', 'não funciona', 'broken', 'fail',
+            'problema', 'issue', 'debug', 'crash', 'exception', 'fix'
+        )
+        instruction = @"
+[SKILL ACTIVATED: defect-analyzer]
+You MUST analyze the root cause systematically.
+Check logs, trace execution path, identify failure point.
+"@
+    }
+}
+
+$SEDD_COMMAND_PATTERNS = @(
+    @{ pattern = '(nova|new|criar|create).*(feature|funcionalidade)'; command = '/sedd.specify' }
+    @{ pattern = '(clarif|duvid|question|pergunt|requisit)'; command = '/sedd.clarify' }
+    @{ pattern = '(implement|execut|task|tarefa)'; command = '/sedd.implement' }
+    @{ pattern = '(migra|convert|antiga|legacy)'; command = '/sedd.migrate' }
+)
+
+#endregion
+
+#region Functions
+
+function Get-SeddConfig {
+    param([string]$Cwd)
+
+    $configPath = Join-Path $Cwd 'sedd.config.json'
+    if (-not (Test-Path $configPath)) { return $DEFAULT_CONFIG }
+
+    try {
+        $userConfig = Get-Content $configPath -Raw | ConvertFrom-Json -AsHashtable
+        $merged = $DEFAULT_CONFIG.Clone()
+        foreach ($key in $userConfig.Keys) {
+            $merged[$key] = $userConfig[$key]
+        }
+        return $merged
+    }
+    catch {
+        return $DEFAULT_CONFIG
+    }
+}
+
+function Get-CurrentBranch {
+    param([string]$Cwd)
+
+    try {
+        Push-Location $Cwd
+        $branch = (git rev-parse --abbrev-ref HEAD 2>$null)
+        Pop-Location
+        return if ($branch) { $branch.Trim() } else { '' }
+    }
+    catch {
+        return ''
+    }
+}
+
+function Test-FeatureBranch {
+    param([string]$Branch)
+    return $Branch -match '^\d{3}-'
+}
+
+function Test-ShouldIgnorePrompt {
+    param([string]$Prompt)
+
+    foreach ($pattern in $IGNORE_PATTERNS) {
+        if ($Prompt -match $pattern) { return $true }
+    }
+    return $false
+}
+
+function Get-ActiveSkills {
+    param([string]$PromptLower)
+
+    $active = @()
+    foreach ($skillName in $SKILLS.Keys) {
+        $skill = $SKILLS[$skillName]
+        foreach ($trigger in $skill.triggers) {
+            if ($PromptLower.Contains($trigger)) {
+                $active += @{ name = $skillName; instruction = $skill.instruction }
+                break
+            }
+        }
+    }
+    return $active
+}
+
+function Get-SeddCommandSuggestions {
+    param([string]$PromptLower)
+
+    $suggestions = @()
+    foreach ($item in $SEDD_COMMAND_PATTERNS) {
+        if ($PromptLower -match $item.pattern) {
+            $suggestions += $item.command
+        }
+    }
+    return $suggestions
+}
+
+function Get-TasksFromContent {
+    param(
+        [string]$Content,
+        [string]$MigrationId
+    )
+
+    $pending = @()
+    $completed = 0
+
+    foreach ($line in ($Content -split "`n")) {
+        if ($line -match '^\s*-\s*\[\s*\]\s*(T\d{3}-\d{3})\s+(.+)') {
+            $pending += @{
+                id = $Matches[1]
+                migration = $MigrationId
+                text = ($Matches[2] -replace '`[^`]+`', '').Trim()
+            }
+            continue
+        }
+        if ($line -match '^\s*-\s*\[x\]\s*T\d{3}-\d{3}') {
+            $completed++
+        }
+    }
+
+    return @{ pending = $pending; completed = $completed }
+}
+
+function Get-TasksFromMigrations {
+    param(
+        [string]$FeatureDir,
+        [object]$MetaData
+    )
+
+    $allPending = @()
+    $totalCompleted = 0
+
+    foreach ($migId in $MetaData.migrations.PSObject.Properties.Name) {
+        $migInfo = $MetaData.migrations.$migId
+        $tasksFile = Join-Path $FeatureDir "$($migInfo.folder)/tasks.md"
+
+        if (-not (Test-Path $tasksFile)) { continue }
+
+        $content = Get-Content $tasksFile -Raw
+        $result = Get-TasksFromContent -Content $content -MigrationId $migId
+        $allPending += $result.pending
+        $totalCompleted += $result.completed
+    }
+
+    return @{ pending = $allPending; completed = $totalCompleted }
+}
+
+function Get-TasksFromLegacy {
+    param([string]$FeatureDir)
+
+    $tasksFile = Join-Path $FeatureDir 'tasks.md'
+    if (-not (Test-Path $tasksFile)) {
+        return @{ pending = @(); completed = 0 }
+    }
+
+    $content = Get-Content $tasksFile -Raw
+    return Get-TasksFromContent -Content $content -MigrationId $null
+}
+
+function Find-FeatureDir {
+    param(
+        [string]$Cwd,
+        [string]$SpecsDir,
+        [string]$Branch
+    )
+
+    $primaryDir = Join-Path $Cwd "$SpecsDir/$Branch"
+    if (Test-Path $primaryDir) { return $primaryDir }
+
+    $legacyDir = Join-Path $Cwd "specs/$Branch"
+    if (Test-Path $legacyDir) { return $legacyDir }
+
+    return $null
+}
+
+function Build-SeddContext {
+    param(
+        [string]$Branch,
+        [string]$CurrentMigration,
+        [int]$Completed,
+        [array]$Pending
+    )
+
+    if ($Pending.Count -eq 0) { return $null }
+
+    $total = $Completed + $Pending.Count
+    $migrationInfo = if ($CurrentMigration) { " | Migration: $CurrentMigration" } else { '' }
+
+    $tasksList = ($Pending | Select-Object -First 5 | ForEach-Object {
+        $text = if ($_.text.Length -gt 60) { $_.text.Substring(0, 60) + '...' } else { $_.text }
+        "- $($_.id): $text"
+    }) -join "`n"
+
+    $moreText = if ($Pending.Count -gt 5) { "`n... and $($Pending.Count - 5) more" } else { '' }
+
+    return @"
+<sedd-context>
+**Branch: $Branch**$migrationInfo | Progress: $Completed/$total tasks
+
+Pending tasks:
+$tasksList$moreText
+
+Use ``/sedd.implement`` to execute tasks.
+</sedd-context>
+"@
+}
+
+#endregion
+
+#region Main
+
+function Main {
+    try {
+        $inputJson = [Console]::In.ReadToEnd()
+        if (-not $inputJson) { return }
+
+        $inputData = $inputJson | ConvertFrom-Json
+        $prompt = $inputData.prompt
+        $cwd = if ($inputData.cwd) { $inputData.cwd } else { Get-Location }
+
+        if (-not $prompt) { return }
+        if (Test-ShouldIgnorePrompt -Prompt $prompt) { return }
+
+        $config = Get-SeddConfig -Cwd $cwd
+        $specsDir = if ($config.specsDir) { $config.specsDir } else { '.sedd' }
+        $promptLower = $prompt.ToLower()
+        $parts = @()
+
+        # Detect and force skills
+        $activeSkills = Get-ActiveSkills -PromptLower $promptLower
+        if ($activeSkills.Count -gt 0) {
+            $instructions = ($activeSkills | ForEach-Object { $_.instruction }) -join "`n`n"
+            $parts += "<forced-skills>`n$instructions`n</forced-skills>"
+        }
+
+        # Check feature branch and tasks
+        $branch = Get-CurrentBranch -Cwd $cwd
+        if (Test-FeatureBranch -Branch $branch) {
+            $featureDir = Find-FeatureDir -Cwd $cwd -SpecsDir $specsDir -Branch $branch
+
+            if ($featureDir) {
+                $metaFile = Join-Path $featureDir '_meta.json'
+                $pending = @()
+                $completed = 0
+                $currentMigration = $null
+
+                if (Test-Path $metaFile) {
+                    $metaData = Get-Content $metaFile -Raw | ConvertFrom-Json
+                    $currentMigration = $metaData.currentMigration
+                    $result = Get-TasksFromMigrations -FeatureDir $featureDir -MetaData $metaData
+                    $pending = $result.pending
+                    $completed = $result.completed
+                }
+                else {
+                    $result = Get-TasksFromLegacy -FeatureDir $featureDir
+                    $pending = $result.pending
+                    $completed = $result.completed
+                }
+
+                $context = Build-SeddContext -Branch $branch -CurrentMigration $currentMigration -Completed $completed -Pending $pending
+                if ($context) { $parts += $context }
+            }
+        }
+
+        # Suggest SEDD commands
+        $suggestions = Get-SeddCommandSuggestions -PromptLower $promptLower
+        if ($suggestions.Count -gt 0 -and -not $prompt.StartsWith('/sedd')) {
+            $parts += "<sedd-hint>Consider using: $($suggestions -join ', ')</sedd-hint>"
+        }
+
+        # Output
+        if ($parts.Count -gt 0) {
+            $output = @{ systemMessage = "`n" + ($parts -join "`n`n") + "`n" }
+            Write-Output ($output | ConvertTo-Json -Compress)
+        }
+    }
+    catch {
+        # Silent exit on errors
+    }
+}
+
+Main
+
+#endregion

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "sedd",
+  "version": "0.1.0",
+  "description": "SEDD - Spec & Expectation Driven Development. A phase-based specification workflow for AI-assisted development.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "sedd": "bin/sedd.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "templates",
+    "commands",
+    "scripts",
+    "hooks"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "specification",
+    "driven-development",
+    "ai-coding",
+    "claude",
+    "cursor",
+    "copilot",
+    "llm",
+    "workflow",
+    "cli"
+  ],
+  "author": "Kelvin R.C",
+  "license": "MIT",
+  "homepage": "https://github.com/goldensrazer/sedd#readme",
+  "bugs": {
+    "url": "https://github.com/goldensrazer/sedd/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/goldensrazer/sedd.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "glob": "^10.3.10",
+    "inquirer": "^9.2.12"
+  },
+  "devDependencies": {
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.10.0",
+    "typescript": "^5.5.0"
+  }
+}

package/scripts/bash/sedd-clarify.sh

@@ -0,0 +1,142 @@
+#!/usr/bin/env bash
+# SEDD Clarify - Creates a new migration with clarify/tasks/decisions files
+# Usage: ./sedd-clarify.sh [branch]
+
+set -e
+
+BRANCH="${1:-$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo '')}"
+
+if [[ ! "$BRANCH" =~ ^[0-9]{3}- ]]; then
+    echo "Error: Not on a feature branch (current: $BRANCH)"
+    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
+
+# Find feature directory
+FEATURE_DIR="${SPECS_DIR}/${BRANCH}"
+[ ! -d "$FEATURE_DIR" ] && FEATURE_DIR="specs/${BRANCH}"
+
+if [ ! -d "$FEATURE_DIR" ]; then
+    echo "Error: Feature directory not found for branch: $BRANCH"
+    exit 1
+fi
+
+# Check meta
+META_PATH="$FEATURE_DIR/_meta.json"
+if [ ! -f "$META_PATH" ]; then
+    echo "Error: _meta.json not found. Run /sedd.specify first."
+    exit 1
+fi
+
+# Get next migration ID
+get_next_migration_id() {
+    local max_id=0
+    if command -v jq &> /dev/null; then
+        max_id=$(jq -r '.migrations | keys | map(tonumber) | max // 0' "$META_PATH")
+    else
+        # Fallback without jq
+        max_id=$(grep -oP '"id":\s*"\K[0-9]+' "$META_PATH" | sort -n | tail -1)
+        [ -z "$max_id" ] && max_id=0
+    fi
+    printf "%03d" $((max_id + 1))
+}
+
+MIGRATION_ID=$(get_next_migration_id)
+TIMESTAMP=$(date +"%Y-%m-%d_%H-%M-%S")
+MIGRATION_FOLDER="${MIGRATION_ID}_${TIMESTAMP}"
+MIGRATION_DIR="$FEATURE_DIR/$MIGRATION_FOLDER"
+
+# Create migration directory
+mkdir -p "$MIGRATION_DIR"
+echo "Created migration: $MIGRATION_FOLDER"
+
+# Get current migration for parent reference
+CURRENT_MIGRATION=$(grep -oP '"currentMigration":\s*"\K[^"]+' "$META_PATH" 2>/dev/null || echo "")
+
+# Create clarify.md
+cat > "$MIGRATION_DIR/clarify.md" << EOF
+# Clarification Session - Migration $MIGRATION_ID
+
+**Timestamp:** $(date +"%Y-%m-%d %H:%M:%S")
+**Branch:** $BRANCH
+
+## Questions & Answers
+
+<!-- Questions discussed during this clarification session -->
+
+EOF
+echo "Created: clarify.md"
+
+# Create decisions.md
+cat > "$MIGRATION_DIR/decisions.md" << EOF
+# Decisions - Migration $MIGRATION_ID
+
+**Timestamp:** $(date +"%Y-%m-%d %H:%M:%S")
+
+## Decisions Made
+
+| # | Decision | Rationale |
+|---|----------|-----------|
+
+EOF
+echo "Created: decisions.md"
+
+# Create tasks.md
+cat > "$MIGRATION_DIR/tasks.md" << EOF
+# Tasks - Migration $MIGRATION_ID
+
+**Migration:** $MIGRATION_ID
+**Timestamp:** $TIMESTAMP
+**Parent:** ${CURRENT_MIGRATION:-none}
+
+## Tasks
+
+<!-- Tasks will be added here by /sedd.tasks -->
+<!-- Format: - [ ] T${MIGRATION_ID}-001 [US1] Task description -->
+
+EOF
+echo "Created: tasks.md"
+
+# Update _meta.json (simplified without jq)
+NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+if command -v jq &> /dev/null; then
+    # With jq
+    jq --arg id "$MIGRATION_ID" \
+       --arg ts "$TIMESTAMP" \
+       --arg folder "$MIGRATION_FOLDER" \
+       --arg parent "$CURRENT_MIGRATION" \
+       --arg now "$NOW" \
+       '.currentMigration = $id |
+        .migrations[$id] = {
+          "id": $id,
+          "timestamp": $ts,
+          "folder": $folder,
+          "parent": (if $parent == "" then null else $parent end),
+          "status": "pending",
+          "tasksTotal": 0,
+          "tasksCompleted": 0,
+          "createdAt": $now
+        }' "$META_PATH" > "$META_PATH.tmp" && mv "$META_PATH.tmp" "$META_PATH"
+else
+    echo "Warning: jq not found. Please update _meta.json manually."
+fi
+
+echo "Updated: _meta.json"
+
+echo ""
+echo "Migration $MIGRATION_ID created successfully!"
+echo "Next steps:"
+echo "  1. Add questions/answers to clarify.md"
+echo "  2. Document decisions in decisions.md"
+echo "  3. Run /sedd.tasks to generate tasks"
+
+# Output JSON
+echo "---SEDD-OUTPUT---"
+echo "{\"success\":true,\"migrationId\":\"$MIGRATION_ID\",\"migrationFolder\":\"$MIGRATION_FOLDER\",\"migrationDir\":\"$MIGRATION_DIR\",\"files\":[\"clarify.md\",\"decisions.md\",\"tasks.md\"]}"

package/scripts/bash/sedd-complete-task.sh

@@ -0,0 +1,108 @@
+#!/usr/bin/env bash
+# SEDD Complete Task - Marks a task as completed
+# Usage: ./sedd-complete-task.sh <task_id>
+
+set -e
+
+TASK_ID="$1"
+
+if [ -z "$TASK_ID" ]; then
+    echo "Usage: ./sedd-complete-task.sh <task_id>"
+    echo "Example: ./sedd-complete-task.sh T001-001"
+    exit 1
+fi
+
+# Validate task ID format
+if [[ ! "$TASK_ID" =~ ^T([0-9]{3})-([0-9]{3})$ ]]; then
+    echo "Error: Invalid task ID format. Expected: T001-001"
+    exit 1
+fi
+
+MIG_ID="${BASH_REMATCH[1]}"
+
+# Get current branch
+BRANCH=$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo '')
+
+if [[ ! "$BRANCH" =~ ^[0-9]{3}- ]]; then
+    echo "Error: Not on a feature branch"
+    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
+
+# Find feature directory
+FEATURE_DIR="${SPECS_DIR}/${BRANCH}"
+[ ! -d "$FEATURE_DIR" ] && FEATURE_DIR="specs/${BRANCH}"
+
+if [ ! -d "$FEATURE_DIR" ]; then
+    echo "Error: Feature not found: $BRANCH"
+    exit 1
+fi
+
+# Load meta
+META_PATH="$FEATURE_DIR/_meta.json"
+if [ ! -f "$META_PATH" ]; then
+    echo "Error: _meta.json not found"
+    exit 1
+fi
+
+# Find migration folder
+MIG_FOLDER=$(grep -oP "\"folder\":\s*\"${MIG_ID}_[^\"]+\"" "$META_PATH" | cut -d'"' -f4)
+
+if [ -z "$MIG_FOLDER" ]; then
+    echo "Error: Migration $MIG_ID not found"
+    exit 1
+fi
+
+TASKS_FILE="$FEATURE_DIR/$MIG_FOLDER/tasks.md"
+
+if [ ! -f "$TASKS_FILE" ]; then
+    echo "Error: tasks.md not found"
+    exit 1
+fi
+
+# Check if already completed
+if grep -q "\[x\] $TASK_ID" "$TASKS_FILE"; then
+    echo "Task $TASK_ID is already completed"
+    exit 0
+fi
+
+# Check if task exists
+if ! grep -q "\[ \] $TASK_ID" "$TASKS_FILE"; then
+    echo "Error: Task $TASK_ID not found"
+    exit 1
+fi
+
+# Mark as complete
+sed -i "s/\[ \] $TASK_ID/[x] $TASK_ID/g" "$TASKS_FILE"
+echo "Completed: $TASK_ID"
+
+# Update meta (requires jq)
+if command -v jq &> /dev/null; then
+    COMPLETED=$(jq -r ".migrations[\"$MIG_ID\"].tasksCompleted" "$META_PATH")
+    TOTAL=$(jq -r ".migrations[\"$MIG_ID\"].tasksTotal" "$META_PATH")
+    NEW_COMPLETED=$((COMPLETED + 1))
+
+    if [ "$NEW_COMPLETED" -ge "$TOTAL" ]; then
+        NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+        jq --arg id "$MIG_ID" --arg now "$NOW" \
+           '.migrations[$id].tasksCompleted += 1 |
+            .migrations[$id].status = "completed" |
+            .migrations[$id].completedAt = $now' "$META_PATH" > "$META_PATH.tmp" && mv "$META_PATH.tmp" "$META_PATH"
+        echo "Migration $MIG_ID completed!"
+    else
+        jq --arg id "$MIG_ID" \
+           '.migrations[$id].tasksCompleted += 1' "$META_PATH" > "$META_PATH.tmp" && mv "$META_PATH.tmp" "$META_PATH"
+    fi
+
+    echo "Progress: $NEW_COMPLETED/$TOTAL tasks"
+fi
+
+# Output JSON
+echo "---SEDD-OUTPUT---"
+echo "{\"success\":true,\"taskId\":\"$TASK_ID\",\"migrationId\":\"$MIG_ID\"}"