specpulse 1.3.4__py3-none-any.whl → 1.4.1__py3-none-any.whl

specpulse/resources/scripts/sp-pulse-plan.ps1

@@ -1,143 +1,147 @@
-# Generate implementation plan - PowerShell Version
-
-param(
-    [Parameter(Mandatory=$true, Position=0)]
-    [string]$FeatureDir
-)
-
-# Configuration
-$ScriptName = Split-Path -Leaf $PSCommandPath
-$ScriptDir = Split-Path -Parent $PSCommandPath
-$ProjectRoot = Split-Path -Parent $ScriptDir
-
-# Logging function
-function Log-Message {
-    param([string]$Message)
-    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
-    Write-Host "[$timestamp] ${ScriptName}: $Message" -ForegroundColor Cyan
-}
-
-# Error handling function
-function Exit-WithError {
-    param([string]$Message)
-    Write-Host "ERROR: $Message" -ForegroundColor Red
-    exit 1
-}
-
-# Extract feature ID
-$FeatureId = if ($FeatureDir -match '^(\d{3})') { $Matches[1] } else { "001" }
-
-# Sanitize feature directory
-$SanitizedDir = $FeatureDir -replace '[^a-zA-Z0-9_-]', ''
-
-if ([string]::IsNullOrEmpty($SanitizedDir)) {
-    Exit-WithError "Invalid feature directory: '$FeatureDir'"
-}
-
-$PlanDir = Join-Path $ProjectRoot "plans\$FeatureDir"
-$SpecDir = Join-Path $ProjectRoot "specs\$FeatureDir"
-$TemplateFile = Join-Path $ProjectRoot "templates\plan.md"
-
-# Ensure plans directory exists
-if (-not (Test-Path $PlanDir)) {
-    New-Item -ItemType Directory -Path $PlanDir -Force | Out-Null
-}
-
-# Find latest spec file
-if (Test-Path $SpecDir) {
-    $SpecFile = Get-ChildItem -Path $SpecDir -Filter "spec-*.md" -ErrorAction SilentlyContinue |
-                Sort-Object LastWriteTime -Descending |
-                Select-Object -First 1
-
-    if (-not $SpecFile) {
-        Exit-WithError "No specification files found in $SpecDir. Please create specification first."
-    }
-    $SpecFile = $SpecFile.FullName
-} else {
-    Exit-WithError "Specifications directory not found: $SpecDir. Please create specification first."
-}
-
-# Find next available plan number or create new one
-$existingPlans = Get-ChildItem -Path $PlanDir -Filter "plan-*.md" -ErrorAction SilentlyContinue
-$planNumber = if ($existingPlans) { $existingPlans.Count + 1 } else { 1 }
-$PlanFile = Join-Path $PlanDir ("plan-{0:D3}.md" -f $planNumber)
-
-# Ensure plan template exists
-if (-not (Test-Path $TemplateFile)) {
-    Exit-WithError "Template not found: $TemplateFile"
-}
-
-# Create plan
-Log-Message "Creating implementation plan from template: $PlanFile"
-try {
-    Copy-Item -Path $TemplateFile -Destination $PlanFile -Force
-} catch {
-    Exit-WithError "Failed to copy plan template: $_"
-}
-
-# Validate plan structure
-Log-Message "Validating implementation plan..."
-
-# Check for required sections
-$RequiredSections = @(
-    "## Implementation Plan:",
-    "## Specification Reference",
-    "## Phase -1: Pre-Implementation Gates",
-    "## Implementation Phases"
-)
-
-$content = Get-Content -Path $PlanFile -Raw
-$MissingSections = @()
-
-foreach ($section in $RequiredSections) {
-    if ($content -notmatch [regex]::Escape($section)) {
-        $MissingSections += $section
-    }
-}
-
-if ($MissingSections.Count -gt 0) {
-    Log-Message "WARNING: Missing required sections: $($MissingSections -join ', ')"
-}
-
-# Check Constitutional Gates
-Log-Message "Checking Constitutional Gates..."
-
-$ConstitutionalGates = @(
-    "Simplicity Gate",
-    "Anti-Abstraction Gate",
-    "Test-First Gate",
-    "Integration-First Gate",
-    "Research Gate"
-)
-
-foreach ($gate in $ConstitutionalGates) {
-    if ($content -notmatch [regex]::Escape($gate)) {
-        Log-Message "WARNING: Missing constitutional gate: $gate"
-    }
-}
-
-# Check if specification has clarifications needed
-$specContent = Get-Content -Path $SpecFile -Raw
-if ($specContent -match "NEEDS CLARIFICATION") {
-    $ClarificationCount = ([regex]::Matches($specContent, "NEEDS CLARIFICATION")).Count
-    Log-Message "WARNING: Specification has $ClarificationCount clarifications needed - resolve before proceeding"
-}
-
-# Validate gate compliance
-$GateStatus = "PENDING"
-if ($content -match "Gate Status:.*\[(.*?)\]") {
-    $GateStatus = $Matches[1]
-}
-
-if ($GateStatus -ne "COMPLETED") {
-    Log-Message "WARNING: Constitutional gates not completed. Status: $GateStatus"
-}
-
-Log-Message "Implementation plan processing completed successfully"
-
-# Output results
-Write-Output "PLAN_FILE=$PlanFile"
-Write-Output "SPEC_FILE=$SpecFile"
-Write-Output "MISSING_SECTIONS=$($MissingSections.Count)"
-Write-Output "CONSTITUTIONAL_GATES_STATUS=$GateStatus"
+# Generate implementation plan - PowerShell Version
+
+param(
+    [Parameter(Mandatory=$true, Position=0)]
+    [string]$FeatureDir
+)
+
+# Configuration
+$ScriptName = Split-Path -Leaf $PSCommandPath
+$ScriptDir = Split-Path -Parent $PSCommandPath
+$ProjectRoot = Split-Path -Parent $ScriptDir
+
+# Logging function
+function Log-Message {
+    param([string]$Message)
+    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
+    Write-Host "[$timestamp] ${ScriptName}: $Message" -ForegroundColor Cyan
+}
+
+# Error handling function
+function Exit-WithError {
+    param([string]$Message)
+    Write-Host "ERROR: $Message" -ForegroundColor Red
+    exit 1
+}
+
+# Extract feature ID
+$FeatureId = if ($FeatureDir -match '^(\d{3})') { $Matches[1] } else { "001" }
+
+# Sanitize feature directory
+$SanitizedDir = $FeatureDir -replace '[^a-zA-Z0-9_-]', ''
+
+if ([string]::IsNullOrEmpty($SanitizedDir)) {
+    Exit-WithError "Invalid feature directory: '$FeatureDir'"
+}
+
+$PlanDir = Join-Path $ProjectRoot "plans\$FeatureDir"
+$SpecDir = Join-Path $ProjectRoot "specs\$FeatureDir"
+$TemplateFile = Join-Path $ProjectRoot "templates\plan.md"
+
+# Ensure plans directory exists
+if (-not (Test-Path $PlanDir)) {
+    New-Item -ItemType Directory -Path $PlanDir -Force | Out-Null
+}
+
+# Find latest spec file
+if (Test-Path $SpecDir) {
+    $SpecFile = Get-ChildItem -Path $SpecDir -Filter "spec-*.md" -ErrorAction SilentlyContinue |
+                Sort-Object LastWriteTime -Descending |
+                Select-Object -First 1
+
+    if (-not $SpecFile) {
+        Exit-WithError "No specification files found in $SpecDir. Please create specification first."
+    }
+    $SpecFile = $SpecFile.FullName
+} else {
+    Exit-WithError "Specifications directory not found: $SpecDir. Please create specification first."
+}
+
+# Find next available plan number or create new one
+$existingPlans = Get-ChildItem -Path $PlanDir -Filter "plan-*.md" -ErrorAction SilentlyContinue
+$planNumber = if ($existingPlans) { $existingPlans.Count + 1 } else { 1 }
+$PlanFile = Join-Path $PlanDir ("plan-{0:D3}.md" -f $planNumber)
+
+# Ensure plan template exists
+if (-not (Test-Path $TemplateFile)) {
+    Exit-WithError "Template not found: $TemplateFile"
+}
+
+# Create plan
+Log-Message "Creating implementation plan from template: $PlanFile"
+try {
+    Copy-Item -Path $TemplateFile -Destination $PlanFile -Force
+} catch {
+    Exit-WithError "Failed to copy plan template: $_"
+}
+
+# Validate plan structure
+Log-Message "Validating implementation plan..."
+
+# Check for required sections
+$RequiredSections = @(
+    "## Implementation Plan:",
+    "## Specification Reference",
+    "## Phase -1: Pre-Implementation Gates",
+    "## Implementation Phases"
+)
+
+$content = Get-Content -Path $PlanFile -Raw
+$MissingSections = @()
+
+foreach ($section in $RequiredSections) {
+    if ($content -notmatch [regex]::Escape($section)) {
+        $MissingSections += $section
+    }
+}
+
+if ($MissingSections.Count -gt 0) {
+    Log-Message "WARNING: Missing required sections: $($MissingSections -join ', ')"
+}
+
+# Check SDD Gates
+Log-Message "Checking SDD Gates..."
+
+$SDDGates = @(
+    "Specification First",
+    "Incremental Planning",
+    "Task Decomposition",
+    "Traceable Implementation",
+    "Continuous Validation",
+    "Quality Assurance",
+    "Architecture Documentation",
+    "Iterative Refinement",
+    "Stakeholder Alignment"
+)
+
+foreach ($gate in $SDDGates) {
+    if ($content -notmatch [regex]::Escape($gate)) {
+        Log-Message "WARNING: Missing SDD gate: $gate"
+    }
+}
+
+# Check if specification has clarifications needed
+$specContent = Get-Content -Path $SpecFile -Raw
+if ($specContent -match "NEEDS CLARIFICATION") {
+    $ClarificationCount = ([regex]::Matches($specContent, "NEEDS CLARIFICATION")).Count
+    Log-Message "WARNING: Specification has $ClarificationCount clarifications needed - resolve before proceeding"
+}
+
+# Validate gate compliance
+$GateStatus = "PENDING"
+if ($content -match "Gate Status:.*\[(.*?)\]") {
+    $GateStatus = $Matches[1]
+}
+
+if ($GateStatus -ne "COMPLETED") {
+    Log-Message "WARNING: SDD gates not completed. Status: $GateStatus"
+}
+
+Log-Message "Implementation plan processing completed successfully"
+
+# Output results
+Write-Output "PLAN_FILE=$PlanFile"
+Write-Output "SPEC_FILE=$SpecFile"
+Write-Output "MISSING_SECTIONS=$($MissingSections.Count)"
+Write-Output "SDD_GATES_STATUS=$GateStatus"
 Write-Output "STATUS=ready"

specpulse/resources/scripts/sp-pulse-plan.sh

@@ -1,128 +1,132 @@
-#!/bin/bash
-# Generate implementation plan
-
-set -euo pipefail  # Exit on error, unset vars, pipe failures
-
-# Configuration
-SCRIPT_NAME="$(basename "$0")"
-# Script is in project-root/scripts/, so parent dir is project root
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-# Function to log messages
-log() {
-    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $SCRIPT_NAME: $1" >&2
-}
-
-# Function to handle errors
-error_exit() {
-    log "ERROR: $1"
-    exit 1
-}
-
-# Validate arguments
-if [ $# -eq 0 ]; then
-    error_exit "Usage: $SCRIPT_NAME <feature-dir>"
-fi
-
-FEATURE_DIR="$1"
-
-# Extract feature ID from directory name (e.g., "001-feature-name" -> "001")
-FEATURE_ID=$(echo "$FEATURE_DIR" | grep -o '^[0-9]\{3\}' || echo "001")
-
-# Sanitize feature directory
-SANITIZED_DIR=$(echo "$FEATURE_DIR" | sed 's/[^a-zA-Z0-9_-]//g')
-
-if [ -z "$SANITIZED_DIR" ]; then
-    error_exit "Invalid feature directory: '$FEATURE_DIR'"
-fi
-
-PLAN_DIR="$PROJECT_ROOT/plans/${FEATURE_DIR}"
-SPEC_DIR="$PROJECT_ROOT/specs/${FEATURE_DIR}"
-TEMPLATE_FILE="$PROJECT_ROOT/templates/plan.md"
-
-# Ensure plans directory exists
-mkdir -p "$PLAN_DIR"
-
-# Find latest spec file
-if [ -d "$SPEC_DIR" ]; then
-    SPEC_FILE=$(find "$SPEC_DIR" -name "spec-*.md" -printf "%T@ %p\n" | sort -n | tail -1 | cut -d' ' -f2-)
-    if [ -z "$SPEC_FILE" ]; then
-        error_exit "No specification files found in $SPEC_DIR. Please create specification first."
-    fi
-else
-    error_exit "Specifications directory not found: $SPEC_DIR. Please create specification first."
-fi
-
-# Find next available plan number or create new one
-if [ -d "$PLAN_DIR" ]; then
-    existing_plans=$(find "$PLAN_DIR" -name "plan-*.md" | wc -l)
-    plan_number=$((existing_plans + 1))
-else
-    plan_number=1
-fi
-PLAN_FILE="$PLAN_DIR/plan-$(printf "%03d" $plan_number).md"
-
-# Ensure plan template exists
-if [ ! -f "$TEMPLATE_FILE" ]; then
-    error_exit "Template not found: $TEMPLATE_FILE"
-fi
-
-# Create plan
-log "Creating implementation plan from template: $PLAN_FILE"
-cp "$TEMPLATE_FILE" "$PLAN_FILE" || error_exit "Failed to copy plan template"
-
-# Validate plan structure
-log "Validating implementation plan..."
-
-# Check for required sections
-REQUIRED_SECTIONS=("## Implementation Plan:" "## Specification Reference" "## Phase -1: Pre-Implementation Gates" "## Implementation Phases")
-MISSING_SECTIONS=()
-
-for section in "${REQUIRED_SECTIONS[@]}"; do
-    if ! grep -q "$section" "$PLAN_FILE"; then
-        MISSING_SECTIONS+=("$section")
-    fi
-done
-
-if [ ${#MISSING_SECTIONS[@]} -gt 0 ]; then
-    log "WARNING: Missing required sections: ${MISSING_SECTIONS[*]}"
-fi
-
-# Check Constitutional Gates
-log "Checking Constitutional Gates..."
-
-CONSTITUTIONAL_GATES=(
-    "Simplicity Gate"
-    "Anti-Abstraction Gate"
-    "Test-First Gate"
-    "Integration-First Gate"
-    "Research Gate"
-)
-
-for gate in "${CONSTITUTIONAL_GATES[@]}"; do
-    if ! grep -q "$gate" "$PLAN_FILE"; then
-        log "WARNING: Missing constitutional gate: $gate"
-    fi
-done
-
-# Check if specification has clarifications needed
-if grep -q "NEEDS CLARIFICATION" "$SPEC_FILE"; then
-    CLARIFICATION_COUNT=$(grep -c "NEEDS CLARIFICATION" "$SPEC_FILE")
-    log "WARNING: Specification has $CLARIFICATION_COUNT clarifications needed - resolve before proceeding"
-fi
-
-# Validate gate compliance
-GATE_STATUS=$(grep -A5 "Gate Status:" "$PLAN_FILE" | tail -1 | sed 's/.*\[\(.*\)\].*/\1/' || echo "PENDING")
-
-if [ "$GATE_STATUS" != "COMPLETED" ]; then
-    log "WARNING: Constitutional gates not completed. Status: $GATE_STATUS"
-fi
-
-log "Implementation plan processing completed successfully"
-
-echo "PLAN_FILE=$PLAN_FILE"
-echo "SPEC_FILE=$SPEC_FILE"
-echo "MISSING_SECTIONS=${#MISSING_SECTIONS[@]}"
-echo "CONSTITUTIONAL_GATES_STATUS=$GATE_STATUS"
+#!/bin/bash
+# Generate implementation plan
+
+set -euo pipefail  # Exit on error, unset vars, pipe failures
+
+# Configuration
+SCRIPT_NAME="$(basename "$0")"
+# Script is in project-root/scripts/, so parent dir is project root
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+# Function to log messages
+log() {
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $SCRIPT_NAME: $1" >&2
+}
+
+# Function to handle errors
+error_exit() {
+    log "ERROR: $1"
+    exit 1
+}
+
+# Validate arguments
+if [ $# -eq 0 ]; then
+    error_exit "Usage: $SCRIPT_NAME <feature-dir>"
+fi
+
+FEATURE_DIR="$1"
+
+# Extract feature ID from directory name (e.g., "001-feature-name" -> "001")
+FEATURE_ID=$(echo "$FEATURE_DIR" | grep -o '^[0-9]\{3\}' || echo "001")
+
+# Sanitize feature directory
+SANITIZED_DIR=$(echo "$FEATURE_DIR" | sed 's/[^a-zA-Z0-9_-]//g')
+
+if [ -z "$SANITIZED_DIR" ]; then
+    error_exit "Invalid feature directory: '$FEATURE_DIR'"
+fi
+
+PLAN_DIR="$PROJECT_ROOT/plans/${FEATURE_DIR}"
+SPEC_DIR="$PROJECT_ROOT/specs/${FEATURE_DIR}"
+TEMPLATE_FILE="$PROJECT_ROOT/templates/plan.md"
+
+# Ensure plans directory exists
+mkdir -p "$PLAN_DIR"
+
+# Find latest spec file
+if [ -d "$SPEC_DIR" ]; then
+    SPEC_FILE=$(find "$SPEC_DIR" -name "spec-*.md" -printf "%T@ %p\n" | sort -n | tail -1 | cut -d' ' -f2-)
+    if [ -z "$SPEC_FILE" ]; then
+        error_exit "No specification files found in $SPEC_DIR. Please create specification first."
+    fi
+else
+    error_exit "Specifications directory not found: $SPEC_DIR. Please create specification first."
+fi
+
+# Find next available plan number or create new one
+if [ -d "$PLAN_DIR" ]; then
+    existing_plans=$(find "$PLAN_DIR" -name "plan-*.md" | wc -l)
+    plan_number=$((existing_plans + 1))
+else
+    plan_number=1
+fi
+PLAN_FILE="$PLAN_DIR/plan-$(printf "%03d" $plan_number).md"
+
+# Ensure plan template exists
+if [ ! -f "$TEMPLATE_FILE" ]; then
+    error_exit "Template not found: $TEMPLATE_FILE"
+fi
+
+# Create plan
+log "Creating implementation plan from template: $PLAN_FILE"
+cp "$TEMPLATE_FILE" "$PLAN_FILE" || error_exit "Failed to copy plan template"
+
+# Validate plan structure
+log "Validating implementation plan..."
+
+# Check for required sections
+REQUIRED_SECTIONS=("## Implementation Plan:" "## Specification Reference" "## Phase -1: Pre-Implementation Gates" "## Implementation Phases")
+MISSING_SECTIONS=()
+
+for section in "${REQUIRED_SECTIONS[@]}"; do
+    if ! grep -q "$section" "$PLAN_FILE"; then
+        MISSING_SECTIONS+=("$section")
+    fi
+done
+
+if [ ${#MISSING_SECTIONS[@]} -gt 0 ]; then
+    log "WARNING: Missing required sections: ${MISSING_SECTIONS[*]}"
+fi
+
+# Check SDD Gates
+log "Checking SDD Gates..."
+
+SDD_GATES=(
+    "Specification First"
+    "Incremental Planning"
+    "Task Decomposition"
+    "Traceable Implementation"
+    "Continuous Validation"
+    "Quality Assurance"
+    "Architecture Documentation"
+    "Iterative Refinement"
+    "Stakeholder Alignment"
+)
+
+for gate in "${SDD_GATES[@]}"; do
+    if ! grep -q "$gate" "$PLAN_FILE"; then
+        log "WARNING: Missing SDD gate: $gate"
+    fi
+done
+
+# Check if specification has clarifications needed
+if grep -q "NEEDS CLARIFICATION" "$SPEC_FILE"; then
+    CLARIFICATION_COUNT=$(grep -c "NEEDS CLARIFICATION" "$SPEC_FILE")
+    log "WARNING: Specification has $CLARIFICATION_COUNT clarifications needed - resolve before proceeding"
+fi
+
+# Validate gate compliance
+GATE_STATUS=$(grep -A5 "Gate Status:" "$PLAN_FILE" | tail -1 | sed 's/.*\[\(.*\)\].*/\1/' || echo "PENDING")
+
+if [ "$GATE_STATUS" != "COMPLETED" ]; then
+    log "WARNING: SDD gates not completed. Status: $GATE_STATUS"
+fi
+
+log "Implementation plan processing completed successfully"
+
+echo "PLAN_FILE=$PLAN_FILE"
+echo "SPEC_FILE=$SPEC_FILE"
+echo "MISSING_SECTIONS=${#MISSING_SECTIONS[@]}"
+echo "SDD_GATES_STATUS=$GATE_STATUS"
 echo "STATUS=ready"