specpulse 1.3.3__py3-none-any.whl → 1.4.0__py3-none-any.whl

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

@@ -0,0 +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 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"

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

@@ -0,0 +1,126 @@
+# Generate or update specification - PowerShell Version
+
+param(
+    [Parameter(Mandatory=$true, Position=0)]
+    [string]$FeatureDir,
+
+    [Parameter(Mandatory=$false, Position=1)]
+    [string]$SpecContent
+)
+
+# 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 from directory name
+$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'"
+}
+
+$SpecDir = Join-Path $ProjectRoot "specs\$FeatureDir"
+$TemplateFile = Join-Path $ProjectRoot "templates\spec.md"
+
+# Ensure specs directory exists
+if (-not (Test-Path $SpecDir)) {
+    New-Item -ItemType Directory -Path $SpecDir -Force | Out-Null
+}
+
+# Find latest spec file or create new one
+if ($SpecContent) {
+    # Find next available spec number
+    $existingSpecs = Get-ChildItem -Path $SpecDir -Filter "spec-*.md" -ErrorAction SilentlyContinue
+    $specNumber = if ($existingSpecs) { $existingSpecs.Count + 1 } else { 1 }
+    $SpecFile = Join-Path $SpecDir ("spec-{0:D3}.md" -f $specNumber)
+
+    # Update specification with provided content
+    Log-Message "Creating specification: $SpecFile"
+    try {
+        Set-Content -Path $SpecFile -Value $SpecContent
+    } catch {
+        Exit-WithError "Failed to write specification content: $_"
+    }
+} else {
+    # Find latest spec file
+    $latestSpec = Get-ChildItem -Path $SpecDir -Filter "spec-*.md" -ErrorAction SilentlyContinue |
+                  Sort-Object LastWriteTime -Descending |
+                  Select-Object -First 1
+
+    if ($latestSpec) {
+        $SpecFile = $latestSpec.FullName
+        Log-Message "Using latest specification: $SpecFile"
+    } else {
+        # No spec files found, create first one
+        $SpecFile = Join-Path $SpecDir "spec-001.md"
+        if (-not (Test-Path $TemplateFile)) {
+            Exit-WithError "Template not found: $TemplateFile"
+        }
+        Log-Message "Creating specification from template: $SpecFile"
+        try {
+            Copy-Item -Path $TemplateFile -Destination $SpecFile -Force
+        } catch {
+            Exit-WithError "Failed to copy specification template: $_"
+        }
+    }
+}
+
+# Validate specification
+Log-Message "Validating specification..."
+if (-not (Test-Path $SpecFile)) {
+    Exit-WithError "Specification file does not exist: $SpecFile"
+}
+
+# Check for required sections
+$RequiredSections = @(
+    "## Specification:",
+    "## Metadata",
+    "## Functional Requirements",
+    "## Acceptance Scenarios"
+)
+
+$content = Get-Content -Path $SpecFile -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 for clarifications needed
+$ClarificationCount = 0
+if ($content -match "NEEDS CLARIFICATION") {
+    $ClarificationCount = ([regex]::Matches($content, "NEEDS CLARIFICATION")).Count
+    Log-Message "WARNING: Specification has $ClarificationCount clarifications needed"
+}
+
+Log-Message "Specification processing completed successfully"
+
+# Output results
+Write-Output "SPEC_FILE=$SpecFile"
+Write-Output "CLARIFICATIONS_NEEDED=$ClarificationCount"
+Write-Output "MISSING_SECTIONS=$($MissingSections.Count)"
+Write-Output "STATUS=updated"