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

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

@@ -0,0 +1,166 @@
+# Generate task breakdown - 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'"
+}
+
+$TaskDir = Join-Path $ProjectRoot "tasks\$FeatureDir"
+$PlanDir = Join-Path $ProjectRoot "plans\$FeatureDir"
+$SpecDir = Join-Path $ProjectRoot "specs\$FeatureDir"
+$TemplateFile = Join-Path $ProjectRoot "templates\task.md"
+
+# Ensure tasks directory exists
+if (-not (Test-Path $TaskDir)) {
+    New-Item -ItemType Directory -Path $TaskDir -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 latest plan file
+if (Test-Path $PlanDir) {
+    $PlanFile = Get-ChildItem -Path $PlanDir -Filter "plan-*.md" -ErrorAction SilentlyContinue |
+                Sort-Object LastWriteTime -Descending |
+                Select-Object -First 1
+
+    if (-not $PlanFile) {
+        Exit-WithError "No plan files found in $PlanDir. Please create plan first."
+    }
+    $PlanFile = $PlanFile.FullName
+} else {
+    Exit-WithError "Plans directory not found: $PlanDir. Please create plan first."
+}
+
+# Find next available task number or create new one
+$existingTasks = Get-ChildItem -Path $TaskDir -Filter "task-*.md" -ErrorAction SilentlyContinue
+$taskNumber = if ($existingTasks) { $existingTasks.Count + 1 } else { 1 }
+$TaskFile = Join-Path $TaskDir ("task-{0:D3}.md" -f $taskNumber)
+
+# Ensure task template exists
+if (-not (Test-Path $TemplateFile)) {
+    Exit-WithError "Template not found: $TemplateFile"
+}
+
+# Create task file
+Log-Message "Creating task breakdown from template: $TaskFile"
+try {
+    Copy-Item -Path $TemplateFile -Destination $TaskFile -Force
+} catch {
+    Exit-WithError "Failed to copy task template: $_"
+}
+
+# Validate task structure
+Log-Message "Validating task breakdown..."
+
+# Check for required sections
+$RequiredSections = @(
+    "## Task List:",
+    "## Task Organization",
+    "## Critical Path",
+    "## Execution Schedule"
+)
+
+$content = Get-Content -Path $TaskFile -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 ', ')"
+}
+
+# Count tasks and analyze structure
+$TotalTasks = ([regex]::Matches($content, "^- \[.\]", [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+$CompletedTasks = ([regex]::Matches($content, "^- \[x\]", [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+$PendingTasks = ([regex]::Matches($content, "^- \[ \]", [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+$BlockedTasks = ([regex]::Matches($content, "^- \[!\]", [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+
+# Check for parallel tasks
+$ParallelTasks = ([regex]::Matches($content, "\[P\]")).Count
+
+# Check SDD gates compliance
+$GatesCount = 0
+if ($content -match "SDD Gates Compliance") {
+    $gatesSection = $content.Substring($content.IndexOf("SDD Gates Compliance"))
+    if ($gatesSection.Length -gt 0) {
+        $GatesCount = ([regex]::Matches($gatesSection.Substring(0, [Math]::Min(1000, $gatesSection.Length)), "\[ \]")).Count
+    }
+}
+
+# Check if plan has SDD gates completed
+$planContent = Get-Content -Path $PlanFile -Raw
+$PlanGateStatus = "PENDING"
+if ($planContent -match "Gate Status:.*\[(.*?)\]") {
+    $PlanGateStatus = $Matches[1]
+}
+
+if ($PlanGateStatus -ne "COMPLETED") {
+    Log-Message "WARNING: Implementation plan SDD gates not completed. Task generation may be premature."
+}
+
+# Calculate completion percentage
+$CompletionPercentage = 0
+if ($TotalTasks -gt 0) {
+    $CompletionPercentage = [math]::Round(($CompletedTasks * 100) / $TotalTasks)
+}
+
+Log-Message "Task analysis completed - Total: $TotalTasks, Completed: $CompletedTasks ($CompletionPercentage%), Parallel: $ParallelTasks"
+
+# Output comprehensive status
+Write-Output "TASK_FILE=$TaskFile"
+Write-Output "SPEC_FILE=$SpecFile"
+Write-Output "PLAN_FILE=$PlanFile"
+Write-Output "TOTAL_TASKS=$TotalTasks"
+Write-Output "COMPLETED_TASKS=$CompletedTasks"
+Write-Output "PENDING_TASKS=$PendingTasks"
+Write-Output "BLOCKED_TASKS=$BlockedTasks"
+Write-Output "PARALLEL_TASKS=$ParallelTasks"
+Write-Output "SDD_GATES_PENDING=$GatesCount"
+Write-Output "COMPLETION_PERCENTAGE=$CompletionPercentage"
+Write-Output "MISSING_SECTIONS=$($MissingSections.Count)"
+Write-Output "STATUS=generated"

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

@@ -109,15 +109,15 @@ BLOCKED_TASKS=$(grep -c "^- \[!\]" "$TASK_FILE" 2>/dev/null || echo "0")
 # Check for parallel tasks
 PARALLEL_TASKS=$(grep -c "\[P\]" "$TASK_FILE" 2>/dev/null || echo "0")
 
-# Check constitutional gates compliance
-CONSTITUTIONAL_SECTION=$(grep -A 20 "Constitutional Gates Compliance" "$TASK_FILE" 2>/dev/null || echo "")
-GATES_COUNT=$(echo "$CONSTITUTIONAL_SECTION" | grep -c "\[ \]" 2>/dev/null || echo "0")
+# Check SDD gates compliance
+SDD_SECTION=$(grep -A 20 "SDD Gates Compliance" "$TASK_FILE" 2>/dev/null || echo "")
+GATES_COUNT=$(echo "$SDD_SECTION" | grep -c "\[ \]" 2>/dev/null || echo "0")
 
-# Check if plan has constitutional gates completed
+# Check if plan has SDD gates completed
 PLAN_GATE_STATUS=$(grep -A5 "Gate Status:" "$PLAN_FILE" | tail -1 | sed 's/.*\[\(.*\)\].*/\1/' || echo "PENDING")
 
 if [ "$PLAN_GATE_STATUS" != "COMPLETED" ]; then
-    log "WARNING: Implementation plan constitutional gates not completed. Task generation may be premature."
+    log "WARNING: Implementation plan SDD gates not completed. Task generation may be premature."
 fi
 
 # Calculate completion percentage
@@ -137,7 +137,7 @@ echo "COMPLETED_TASKS=$COMPLETED_TASKS"
 echo "PENDING_TASKS=$PENDING_TASKS"
 echo "BLOCKED_TASKS=$BLOCKED_TASKS"
 echo "PARALLEL_TASKS=$PARALLEL_TASKS"
-echo "CONSTITUTIONAL_GATES_PENDING=$GATES_COUNT"
+echo "SDD_GATES_PENDING=$GATES_COUNT"
 echo "COMPLETION_PERCENTAGE=$COMPLETION_PERCENTAGE"
 echo "MISSING_SECTIONS=${#MISSING_SECTIONS[@]}"
 echo "STATUS=generated"

specpulse/resources/templates/decomposition/integration-plan.md

@@ -112,11 +112,12 @@ dependencies:
 ### Rollback Plan
 {{ rollback_plan }}
 
-## Constitutional Compliance
-- [ ] Each integration point ≤ 3 dependencies (Article I: Simplicity)
-- [ ] Contract tests defined (Article III: Test-First)
-- [ ] Real services over mocks (Article VIII: Framework Selection)
-- [ ] Security at integration points (Article V: Security by Design)
+## SDD Compliance
+- [ ] Specifications for each integration point (Principle 1: Specification First)
+- [ ] Phased integration approach (Principle 2: Incremental Planning)
+- [ ] Contract tests defined (Principle 6: Quality Assurance)
+- [ ] Architecture decisions documented (Principle 7: Architecture Documentation)
+- [ ] Stakeholder communication plan (Principle 9: Stakeholder Alignment)
 
 ## Risk Assessment
 

specpulse/resources/templates/decomposition/microservices.md

@@ -21,11 +21,12 @@
 
 {{ integration_points }}
 
-## Constitutional Compliance
-- [ ] Each service ≤ 3 core modules (Article I: Simplicity)
-- [ ] Single responsibility per service (Article V)
-- [ ] Clear test boundaries defined (Article III)
-- [ ] Framework selection documented (Article VIII)
+## SDD Compliance
+- [ ] Service specifications clear (Principle 1: Specification First)
+- [ ] Phased service rollout planned (Principle 2: Incremental Planning)
+- [ ] Service tasks decomposed (Principle 3: Task Decomposition)
+- [ ] Test strategy defined per service (Principle 6: Quality Assurance)
+- [ ] Architecture decisions documented (Principle 7: Architecture Documentation)
 
 ## Next Steps
 1. Review service boundaries with team

specpulse/resources/templates/decomposition/service-plan.md

@@ -151,11 +151,12 @@
 ### Libraries
 {{ libraries }}
 
-## Constitutional Compliance
-- [ ] Service has single responsibility (Article V)
-- [ ] ≤ 3 core modules (Article I: Simplicity)
-- [ ] Tests before implementation (Article III)
-- [ ] Direct framework usage (Article VIII)
+## SDD Compliance
+- [ ] Service specifications clear (Principle 1: Specification First)
+- [ ] Phased implementation plan (Principle 2: Incremental Planning)
+- [ ] Tasks properly decomposed (Principle 3: Task Decomposition)
+- [ ] Test strategy defined (Principle 6: Quality Assurance)
+- [ ] Architecture documented (Principle 7: Architecture Documentation)
 
 ## Risk Assessment
 {{ risks }}