specpulse 1.4.2__tar.gz → 1.4.4__tar.gz

{specpulse-1.4.2/specpulse.egg-info → specpulse-1.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specpulse
-Version: 1.4.2
+Version: 1.4.4
 Summary: Specification-Driven Development Framework
 Home-page: https://github.com/specpulse
 Author: SpecPulse
@@ -67,7 +67,18 @@ Dynamic: requires-python
 
 SpecPulse is a universal **Specification-Driven Development (SDD)** framework that works with ANY software project - web apps, mobile apps, desktop software, games, APIs, ML projects, and more. It ensures every feature starts with clear specifications, validated plans, and tracked tasks.
 
-> **Latest Update (v1.4.2)** - Template System Enhancement:
+> **Latest Update (v1.4.4)** - Critical Workflow Fixes:
+> - 🐛 **Fixed Script Numbering**: Resolved `/sp-pulse` creating empty placeholders while subsequent commands created new files
+> - 🎯 **Fixed Task Detection**: Execute scripts now properly detect task format (`### T001:` with `**Status**:`)
+> - 📝 **Unified Placeholders**: All scripts use consistent `<!-- INSTRUCTION: Generate -->` markers
+> - 🔧 **PowerShell Parity**: PowerShell scripts now match Bash behavior exactly
+>
+> **v1.4.3** - Script Numbering Fix:
+> - 🔢 **Fixed Numbering Logic**: Spec, plan, and task files now number correctly (001, 002, 003...)
+> - 📝 **No Empty First Files**: spec-001.md, plan-001.md, task-001.md always contain content
+> - 🎯 **Proper Interactive Mode**: Scripts create placeholder files for AI to fill
+>
+> **v1.4.2** - Template System Enhancement:
 > - 📁 **Physical Template Files**: Templates now exist as physical files for AI tools to read
 > - 🔧 **Complete PowerShell Support**: Added PowerShell scripts matching all Bash functionality
 > - 📝 **Enhanced Decomposition Templates**: Full microservice decomposition template support

{specpulse-1.4.2 → specpulse-1.4.4}/README.md

@@ -21,7 +21,18 @@
 
 SpecPulse is a universal **Specification-Driven Development (SDD)** framework that works with ANY software project - web apps, mobile apps, desktop software, games, APIs, ML projects, and more. It ensures every feature starts with clear specifications, validated plans, and tracked tasks.
 
-> **Latest Update (v1.4.2)** - Template System Enhancement:
+> **Latest Update (v1.4.4)** - Critical Workflow Fixes:
+> - 🐛 **Fixed Script Numbering**: Resolved `/sp-pulse` creating empty placeholders while subsequent commands created new files
+> - 🎯 **Fixed Task Detection**: Execute scripts now properly detect task format (`### T001:` with `**Status**:`)
+> - 📝 **Unified Placeholders**: All scripts use consistent `<!-- INSTRUCTION: Generate -->` markers
+> - 🔧 **PowerShell Parity**: PowerShell scripts now match Bash behavior exactly
+>
+> **v1.4.3** - Script Numbering Fix:
+> - 🔢 **Fixed Numbering Logic**: Spec, plan, and task files now number correctly (001, 002, 003...)
+> - 📝 **No Empty First Files**: spec-001.md, plan-001.md, task-001.md always contain content
+> - 🎯 **Proper Interactive Mode**: Scripts create placeholder files for AI to fill
+>
+> **v1.4.2** - Template System Enhancement:
 > - 📁 **Physical Template Files**: Templates now exist as physical files for AI tools to read
 > - 🔧 **Complete PowerShell Support**: Added PowerShell scripts matching all Bash functionality
 > - 📝 **Enhanced Decomposition Templates**: Full microservice decomposition template support

{specpulse-1.4.2 → specpulse-1.4.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specpulse"
-version = "1.4.2"
+version = "1.4.4"
 description = "Specification-Driven Development Framework"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -93,6 +93,7 @@ specpulse = [
     "resources/templates/decomposition/*.ts",
     "resources/memory/*.md",
     "resources/scripts/*.sh",
+    "resources/scripts/*.ps1",
     "resources/commands/claude/*.md",
     "resources/commands/gemini/*.toml",
 ]

{specpulse-1.4.2 → specpulse-1.4.4}/setup.py

@@ -11,7 +11,7 @@ long_description = (this_directory / "README.md").read_text(encoding="utf-8")
 
 setup(
     name="specpulse",
-    version="1.4.2",
+    version="1.4.4",
     author="SpecPulse",
     author_email="",
     description="Next-Generation Specification-Driven Development Framework",
@@ -64,6 +64,7 @@ setup(
             "resources/templates/decomposition/*.ts",
             "resources/memory/*.md",
             "resources/scripts/*.sh",
+            "resources/scripts/*.ps1",
             "resources/commands/claude/*.md",
             "resources/commands/gemini/*.toml",
         ],

{specpulse-1.4.2 → specpulse-1.4.4}/specpulse/__init__.py

@@ -3,7 +3,7 @@ SpecPulse: Specification-Driven Development Framework
 Built for the AI era
 """
 
-__version__ = "1.4.2"
+__version__ = "1.4.3"
 __author__ = "SpecPulse"
 __url__ = "https://github.com/specpulse"
 

{specpulse-1.4.2 → specpulse-1.4.4}/specpulse/resources/commands/claude/sp-plan.md

@@ -96,8 +96,12 @@ When called with `/sp-plan $ARGUMENTS`, I will:
       - Create improvement strategies for technical debt
       - Track future enhancement opportunities
 
-   i. **Version management**: Check existing plan files and create next version (plan-001.md, plan-002.md, etc.)
-   j. **Write NEW plan file** to `plans/XXX-feature/plan-XXX.md`
+   i. **CRITICAL NUMBERING LOGIC**:
+      - Check if `plans/XXX-feature/plan-001.md` exists
+      - If plan-001.md does NOT exist: Create plan-001.md with full content from template
+      - If plan-001.md EXISTS: Create plan-002.md (or next number) with new content
+      - NEVER leave plan-001.md as placeholder if it's the first plan
+   j. **Write FULL plan content** to `plans/XXX-feature/plan-XXX.md`
    k. **IMPORTANT**: Can EDIT files in plans/ folder, but NEVER modify templates/, scripts/, or commands/ folders
 
 4. **For `/sp-plan validate`:**

{specpulse-1.4.2 → specpulse-1.4.4}/specpulse/resources/commands/claude/sp-spec.md

@@ -43,7 +43,12 @@ When called with `/sp-spec $ARGUMENTS`, I will:
    - If no action specified: Default to `create` with full arguments as description
 
 3. **For `/sp-spec create [description]` or `/sp-spec [description]`:**
-   - COPY template from `templates/spec.md` to create NEW file in `specs/XXX-feature/`
+   - **CRITICAL NUMBERING LOGIC**:
+     - Check if `specs/XXX-feature/spec-001.md` exists
+     - If spec-001.md does NOT exist: Create spec-001.md with full content from template
+     - If spec-001.md EXISTS: Create spec-002.md (or next number) with new content
+     - NEVER leave spec-001.md as placeholder if it's the first spec
+   - READ template from `templates/spec.md` and use it to generate content
    - IMPORTANT: Only edit files in specs/, plans/, tasks/ folders. NEVER edit templates/, scripts/, or commands/
    - Parse the description to identify:
      - Functional requirements (Must/Should/Could/Won't have)
@@ -60,11 +65,10 @@ When called with `/sp-spec $ARGUMENTS`, I will:
      ```
    - Mark any uncertainties with `[NEEDS CLARIFICATION: specific question]`
    - Use detected feature context to determine target directory
-   - **Version management**: Check existing spec files and create next version (spec-001.md, spec-002.md, etc.)
-   - Write NEW specification to `specs/ID-feature-name/spec-XXX.md`
+   - Write FULL specification content to `specs/ID-feature-name/spec-XXX.md`
    - Can EDIT files in specs/ folder, but NEVER modify templates/, scripts/, or commands/ folders
    - Run validation:
-     - `bash scripts/sp-pulse-spec.sh "$FEATURE_DIR"`
+     - `bash scripts/sp-pulse-spec.sh "$FEATURE_DIR" "$SPEC_CONTENT"`
 
 4. **For `/sp-spec update`:**
    - **Show existing spec files**: List all spec-XXX.md files in current feature directory

{specpulse-1.4.2 → specpulse-1.4.4}/specpulse/resources/scripts/sp-pulse-execute.ps1

@@ -82,15 +82,34 @@ if ($taskContent -match "AUTH-T[0-9]|USER-T[0-9]|INT-T[0-9]") {
     Log-Message "Detected decomposed architecture with service-specific tasks"
 }
 
-# Count task status using regex
-$taskPattern = '^- \[.\] (T[0-9]{3}|[A-Z]+-T[0-9]{3})'
-$allTasks = [regex]::Matches($taskContent, $taskPattern, [System.Text.RegularExpressions.RegexOptions]::Multiline)
-$TotalTasks = $allTasks.Count
-
-$CompletedTasks = ([regex]::Matches($taskContent, '^- \[x\] (T[0-9]{3}|[A-Z]+-T[0-9]{3})', [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
-$PendingTasks = ([regex]::Matches($taskContent, '^- \[ \] (T[0-9]{3}|[A-Z]+-T[0-9]{3})', [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
-$InProgressTasks = ([regex]::Matches($taskContent, '^- \[>\] (T[0-9]{3}|[A-Z]+-T[0-9]{3})', [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
-$BlockedTasks = ([regex]::Matches($taskContent, '^- \[!\] (T[0-9]{3}|[A-Z]+-T[0-9]{3})', [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+# Count task status using the actual format used in task files
+# Format is: ### T001: Task Name
+#           **Status**: [x] Completed
+$TotalTasks = ([regex]::Matches($taskContent, '^### T[0-9]{3}:', [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+
+# Count completed tasks by finding task headers followed by status within next few lines
+$CompletedTasks = 0
+$PendingTasks = 0
+$InProgressTasks = 0
+$BlockedTasks = 0
+
+$taskHeaders = [regex]::Matches($taskContent, '^### (T[0-9]{3}):', [System.Text.RegularExpressions.RegexOptions]::Multiline)
+foreach ($header in $taskHeaders) {
+    $taskId = $header.Groups[1].Value
+    $startIndex = $header.Index
+    $endIndex = if ($header.Index + 500 -lt $taskContent.Length) { $header.Index + 500 } else { $taskContent.Length }
+    $taskSection = $taskContent.Substring($startIndex, $endIndex - $startIndex)
+
+    if ($taskSection -match '\*\*Status\*\*:\s*\[x\]') {
+        $CompletedTasks++
+    } elseif ($taskSection -match '\*\*Status\*\*:\s*\[ \]') {
+        $PendingTasks++
+    } elseif ($taskSection -match '\*\*Status\*\*:\s*\[>\]') {
+        $InProgressTasks++
+    } elseif ($taskSection -match '\*\*Status\*\*:\s*\[!\]') {
+        $BlockedTasks++
+    }
+}
 
 # Find next task to execute
 $NextTask = ""
@@ -98,17 +117,34 @@ $TaskDetails = ""
 
 switch ($Command) {
     { $_ -in "next", "continue" } {
-        # Find first in-progress task
-        $inProgressMatch = [regex]::Match($taskContent, '^- \[>\] ((T[0-9]{3}|[A-Z]+-T[0-9]{3}): .+)$', [System.Text.RegularExpressions.RegexOptions]::Multiline)
-        if ($inProgressMatch.Success) {
-            $NextTask = $inProgressMatch.Groups[1].Value
-            $TaskDetails = "RESUMING IN-PROGRESS TASK"
-        } else {
-            # Find first pending task
-            $pendingMatch = [regex]::Match($taskContent, '^- \[ \] ((T[0-9]{3}|[A-Z]+-T[0-9]{3}): .+)$', [System.Text.RegularExpressions.RegexOptions]::Multiline)
-            if ($pendingMatch.Success) {
-                $NextTask = $pendingMatch.Groups[1].Value
-                $TaskDetails = "STARTING NEW TASK"
+        # Find first in-progress or pending task
+        foreach ($header in $taskHeaders) {
+            $taskId = $header.Groups[1].Value
+            $startIndex = $header.Index
+            $endIndex = if ($header.Index + 500 -lt $taskContent.Length) { $header.Index + 500 } else { $taskContent.Length }
+            $taskSection = $taskContent.Substring($startIndex, $endIndex - $startIndex)
+
+            # Check for in-progress task first
+            if ($taskSection -match '\*\*Status\*\*:\s*\[>\]') {
+                $NextTask = $taskId
+                $TaskDetails = "RESUMING IN-PROGRESS TASK"
+                break
+            }
+        }
+
+        # If no in-progress task found, find first pending
+        if (-not $NextTask) {
+            foreach ($header in $taskHeaders) {
+                $taskId = $header.Groups[1].Value
+                $startIndex = $header.Index
+                $endIndex = if ($header.Index + 500 -lt $taskContent.Length) { $header.Index + 500 } else { $taskContent.Length }
+                $taskSection = $taskContent.Substring($startIndex, $endIndex - $startIndex)
+
+                if ($taskSection -match '\*\*Status\*\*:\s*\[ \]') {
+                    $NextTask = $taskId
+                    $TaskDetails = "STARTING NEW TASK"
+                    break
+                }
             }
         }
     }
@@ -120,9 +156,8 @@ switch ($Command) {
     }
     default {
         # Specific task requested
-        $specificMatch = [regex]::Match($taskContent, "^- \[.\] (($Command): .+)$", [System.Text.RegularExpressions.RegexOptions]::Multiline)
-        if ($specificMatch.Success) {
-            $NextTask = $specificMatch.Groups[1].Value
+        if ($taskContent -match "^### ($Command):" ) {
+            $NextTask = $Command
             $TaskDetails = "EXECUTE SPECIFIC TASK"
         }
     }

{specpulse-1.4.2 → specpulse-1.4.4}/specpulse/resources/scripts/sp-pulse-execute.sh

@@ -67,23 +67,23 @@ if grep -qE "AUTH-T[0-9]|USER-T[0-9]|INT-T[0-9]" "$TASK_FILE" 2>/dev/null; then
     log "Detected decomposed architecture with service-specific tasks"
 fi
 
-# Count task status
-TOTAL_TASKS=$(grep -cE "^- \[.\] (T[0-9]{3}|[A-Z]+-T[0-9]{3})" "$TASK_FILE" 2>/dev/null || echo "0")
-COMPLETED_TASKS=$(grep -cE "^- \[x\] (T[0-9]{3}|[A-Z]+-T[0-9]{3})" "$TASK_FILE" 2>/dev/null || echo "0")
-PENDING_TASKS=$(grep -cE "^- \[ \] (T[0-9]{3}|[A-Z]+-T[0-9]{3})" "$TASK_FILE" 2>/dev/null || echo "0")
-IN_PROGRESS_TASKS=$(grep -cE "^- \[>\] (T[0-9]{3}|[A-Z]+-T[0-9]{3})" "$TASK_FILE" 2>/dev/null || echo "0")
-BLOCKED_TASKS=$(grep -cE "^- \[!\] (T[0-9]{3}|[A-Z]+-T[0-9]{3})" "$TASK_FILE" 2>/dev/null || echo "0")
+# Count task status - handle the actual format used in task files
+TOTAL_TASKS=$(grep -cE "^### T[0-9]{3}:" "$TASK_FILE" 2>/dev/null || echo "0")
+COMPLETED_TASKS=$(awk '/^### T[0-9]{3}:/{task=$0; found=0; for(i=0; i<5; i++) {getline; if(/^\*\*Status\*\*: \[x\]/) {found=1; break} if(/^###/) break} if(found) count++} END{print count+0}' "$TASK_FILE" 2>/dev/null || echo "0")
+PENDING_TASKS=$(awk '/^### T[0-9]{3}:/{task=$0; found=0; for(i=0; i<5; i++) {getline; if(/^\*\*Status\*\*: \[ \]/) {found=1; break} if(/^###/) break} if(found) count++} END{print count+0}' "$TASK_FILE" 2>/dev/null || echo "0")
+IN_PROGRESS_TASKS=$(awk '/^### T[0-9]{3}:/{task=$0; found=0; for(i=0; i<5; i++) {getline; if(/^\*\*Status\*\*: \[>\]/) {found=1; break} if(/^###/) break} if(found) count++} END{print count+0}' "$TASK_FILE" 2>/dev/null || echo "0")
+BLOCKED_TASKS=$(awk '/^### T[0-9]{3}:/{task=$0; found=0; for(i=0; i<5; i++) {getline; if(/^\*\*Status\*\*: \[!\]/) {found=1; break} if(/^###/) break} if(found) count++} END{print count+0}' "$TASK_FILE" 2>/dev/null || echo "0")
 
 # Find next task to execute
 case "$COMMAND" in
     "next"|"continue")
         # Find first in-progress task
         if [ "$IN_PROGRESS_TASKS" -gt 0 ]; then
-            NEXT_TASK=$(grep -E "^- \[>\] (T[0-9]{3}|[A-Z]+-T[0-9]{3})" "$TASK_FILE" | head -1 | sed -E 's/.*\[(T[0-9]{3}|[A-Z]+-T[0-9]{3})\].*/\1/')
+            NEXT_TASK=$(grep "^\*\*Status\*\*: \[>\]" "$TASK_FILE" -B1 | grep -E "^### T[0-9]{3}:" | head -1 | sed -E 's/^### (T[0-9]{3}):.*/\1/')
             log "Resuming in-progress task: $NEXT_TASK"
         # Otherwise find first pending task
         elif [ "$PENDING_TASKS" -gt 0 ]; then
-            NEXT_TASK=$(grep -E "^- \[ \] (T[0-9]{3}|[A-Z]+-T[0-9]{3})" "$TASK_FILE" | head -1 | sed -E 's/.*\[(T[0-9]{3}|[A-Z]+-T[0-9]{3})\].*/\1/')
+            NEXT_TASK=$(grep "^\*\*Status\*\*: \[ \]" "$TASK_FILE" -B1 | grep -E "^### T[0-9]{3}:" | head -1 | sed -E 's/^### (T[0-9]{3}):.*/\1/')
             log "Starting next pending task: $NEXT_TASK"
         else
             if [ "$BLOCKED_TASKS" -gt 0 ]; then
@@ -147,7 +147,7 @@ fi
 if [ "$PENDING_TASKS" -gt 0 ]; then
     echo ""
     echo "NEXT_TASKS_PREVIEW:"
-    grep -E "^- \[ \] (T[0-9]{3}|[A-Z]+-T[0-9]{3})" "$TASK_FILE" | head -5 | while read -r line; do
+    awk '/^### T[0-9]{3}:/{task=$0; found=0; for(i=0; i<5; i++) {getline; if(/^\*\*Status\*\*: \[ \]/) {found=1; break} if(/^###/) break} if(found) {print task; count++; if(count>=5) exit}}' "$TASK_FILE" | while read -r line; do
         echo "  $line"
     done
 fi

{specpulse-1.4.2 → specpulse-1.4.4}/specpulse/resources/scripts/sp-pulse-init.ps1

@@ -78,27 +78,30 @@ try {
     $specContent = @"
 # Specification for $FeatureName
 
-<!-- TO BE GENERATED FROM TEMPLATE: $TemplateDir\spec.md -->
-<!-- FEATURE: $FeatureName -->
-<!-- ID: $FeatureId -->
+<!-- INSTRUCTION: Generate specification content using template: $TemplateDir\spec.md -->
+<!-- FEATURE_DIR: $BranchName -->
+<!-- FEATURE_ID: $FeatureId -->
 "@
     Set-Content -Path "$SpecsDir\spec-001.md" -Value $specContent
 
     $planContent = @"
 # Implementation Plan for $FeatureName
 
-<!-- TO BE GENERATED FROM TEMPLATE: $TemplateDir\plan.md -->
-<!-- FEATURE: $FeatureName -->
-<!-- ID: $FeatureId -->
+<!-- INSTRUCTION: Generate plan using template: $TemplateDir\plan.md -->
+<!-- SPEC_FILE: $SpecsDir\spec-001.md -->
+<!-- FEATURE_DIR: $BranchName -->
+<!-- FEATURE_ID: $FeatureId -->
 "@
     Set-Content -Path "$PlansDir\plan-001.md" -Value $planContent
 
     $taskContent = @"
 # Task Breakdown for $FeatureName
 
-<!-- TO BE GENERATED FROM TEMPLATE: $TemplateDir\task.md -->
-<!-- FEATURE: $FeatureName -->
-<!-- ID: $FeatureId -->
+<!-- INSTRUCTION: Generate tasks using template: $TemplateDir\task.md -->
+<!-- SPEC_FILE: $SpecsDir\spec-001.md -->
+<!-- PLAN_FILE: $PlansDir\plan-001.md -->
+<!-- FEATURE_DIR: $BranchName -->
+<!-- FEATURE_ID: $FeatureId -->
 "@
     Set-Content -Path "$TasksDir\task-001.md" -Value $taskContent
 } catch {

{specpulse-1.4.2 → specpulse-1.4.4}/specpulse/resources/scripts/sp-pulse-init.sh

@@ -73,19 +73,22 @@ echo "# Task Breakdown for $FEATURE_NAME" > "$TASKS_DIR/task-001.md"
 
 # Add markers indicating these files need AI processing
 echo "" >> "$SPECS_DIR/spec-001.md"
-echo "<!-- TO BE GENERATED FROM TEMPLATE: $TEMPLATE_DIR/spec.md -->" >> "$SPECS_DIR/spec-001.md"
-echo "<!-- FEATURE: $FEATURE_NAME -->" >> "$SPECS_DIR/spec-001.md"
-echo "<!-- ID: $FEATURE_ID -->" >> "$SPECS_DIR/spec-001.md"
+echo "<!-- INSTRUCTION: Generate specification content using template: $TEMPLATE_DIR/spec.md -->" >> "$SPECS_DIR/spec-001.md"
+echo "<!-- FEATURE_DIR: $BRANCH_NAME -->" >> "$SPECS_DIR/spec-001.md"
+echo "<!-- FEATURE_ID: $FEATURE_ID -->" >> "$SPECS_DIR/spec-001.md"
 
 echo "" >> "$PLANS_DIR/plan-001.md"
-echo "<!-- TO BE GENERATED FROM TEMPLATE: $TEMPLATE_DIR/plan.md -->" >> "$PLANS_DIR/plan-001.md"
-echo "<!-- FEATURE: $FEATURE_NAME -->" >> "$PLANS_DIR/plan-001.md"
-echo "<!-- ID: $FEATURE_ID -->" >> "$PLANS_DIR/plan-001.md"
+echo "<!-- INSTRUCTION: Generate plan using template: $TEMPLATE_DIR/plan.md -->" >> "$PLANS_DIR/plan-001.md"
+echo "<!-- SPEC_FILE: $SPECS_DIR/spec-001.md -->" >> "$PLANS_DIR/plan-001.md"
+echo "<!-- FEATURE_DIR: $BRANCH_NAME -->" >> "$PLANS_DIR/plan-001.md"
+echo "<!-- FEATURE_ID: $FEATURE_ID -->" >> "$PLANS_DIR/plan-001.md"
 
 echo "" >> "$TASKS_DIR/task-001.md"
-echo "<!-- TO BE GENERATED FROM TEMPLATE: $TEMPLATE_DIR/task.md -->" >> "$TASKS_DIR/task-001.md"
-echo "<!-- FEATURE: $FEATURE_NAME -->" >> "$TASKS_DIR/task-001.md"
-echo "<!-- ID: $FEATURE_ID -->" >> "$TASKS_DIR/task-001.md"
+echo "<!-- INSTRUCTION: Generate tasks using template: $TEMPLATE_DIR/task.md -->" >> "$TASKS_DIR/task-001.md"
+echo "<!-- SPEC_FILE: $SPECS_DIR/spec-001.md -->" >> "$TASKS_DIR/task-001.md"
+echo "<!-- PLAN_FILE: $PLANS_DIR/plan-001.md -->" >> "$TASKS_DIR/task-001.md"
+echo "<!-- FEATURE_DIR: $BRANCH_NAME -->" >> "$TASKS_DIR/task-001.md"
+echo "<!-- FEATURE_ID: $FEATURE_ID -->" >> "$TASKS_DIR/task-001.md"
 
 # Update context
 CONTEXT_FILE="$PROJECT_ROOT/memory/context.md"

{specpulse-1.4.2 → specpulse-1.4.4}/specpulse/resources/scripts/sp-pulse-plan.ps1

@@ -57,9 +57,20 @@ if (Test-Path $SpecDir) {
     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 }
+# Check if plan-001.md exists
+$FirstPlan = Join-Path $PlanDir "plan-001.md"
+if (Test-Path $FirstPlan) {
+    # Find next available plan number
+    $existingPlans = Get-ChildItem -Path $PlanDir -Filter "plan-*.md" -ErrorAction SilentlyContinue | Sort-Object Name
+    if ($existingPlans) {
+        $highestPlan = [int]($existingPlans[-1].BaseName -replace 'plan-', '')
+        $planNumber = $highestPlan + 1
+    } else {
+        $planNumber = 2
+    }
+} else {
+    $planNumber = 1
+}
 $PlanFile = Join-Path $PlanDir ("plan-{0:D3}.md" -f $planNumber)
 
 # Ensure plan template exists
@@ -67,36 +78,50 @@ if (-not (Test-Path $TemplateFile)) {
     Exit-WithError "Template not found: $TemplateFile"
 }
 
-# Create plan
-Log-Message "Creating implementation plan from template: $PlanFile"
+# Create placeholder file for AI to generate plan
+Log-Message "Creating implementation plan: $PlanFile"
 try {
-    Copy-Item -Path $TemplateFile -Destination $PlanFile -Force
+    @"
+# Implementation Plan - $FeatureDir
+
+<!-- INSTRUCTION: Generate plan using template: $TemplateFile -->
+<!-- SPEC_FILE: $SpecFile -->
+<!-- FEATURE_DIR: $FeatureDir -->
+<!-- FEATURE_ID: $FeatureId -->
+"@ | Set-Content -Path $PlanFile
 } catch {
-    Exit-WithError "Failed to copy plan template: $_"
+    Exit-WithError "Failed to create plan file: $_"
 }
 
 # Validate plan structure
 Log-Message "Validating implementation plan..."
 
-# Check for required sections
-$RequiredSections = @(
-    "## Implementation Plan:",
-    "## Specification Reference",
-    "## Phase -1: Pre-Implementation Gates",
-    "## Implementation Phases"
-)
-
+# Check if file needs AI generation
 $content = Get-Content -Path $PlanFile -Raw
-$MissingSections = @()
-
-foreach ($section in $RequiredSections) {
-    if ($content -notmatch [regex]::Escape($section)) {
-        $MissingSections += $section
+if ($content -match "INSTRUCTION: Generate plan") {
+    Log-Message "WARNING: Plan needs to be generated by AI from template"
+    $MissingSections = @("ALL - Awaiting AI Generation")
+    $GateStatus = "PENDING"
+} else {
+    # Check for required sections only if file has been generated
+    $RequiredSections = @(
+        "## Implementation Plan:",
+        "## Specification Reference",
+        "## Phase -1: Pre-Implementation Gates",
+        "## Implementation Phases"
+    )
+
+    $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 ', ')"
+    if ($MissingSections.Count -gt 0) {
+        Log-Message "WARNING: Missing required sections: $($MissingSections -join ', ')"
+    }
 }
 
 # Check SDD Gates

{specpulse-1.4.2 → specpulse-1.4.4}/specpulse/resources/scripts/sp-pulse-plan.sh

@@ -59,14 +59,14 @@ 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
-    # Get the highest plan number and increment it
+# Check if plan-001.md exists
+if [ -f "$PLAN_DIR/plan-001.md" ]; then
+    # Find next available plan number
     highest_plan=$(find "$PLAN_DIR" -name "plan-*.md" -exec basename {} .md \; | sed 's/plan-//' | sort -n | tail -1)
     if [ -n "$highest_plan" ]; then
         plan_number=$((highest_plan + 1))
     else
-        plan_number=1
+        plan_number=2
     fi
 else
     plan_number=1
@@ -78,23 +78,20 @@ if [ ! -f "$TEMPLATE_FILE" ]; then
     error_exit "Template not found: $TEMPLATE_FILE"
 fi
 
-# Create plan marker for AI generation
-log "Creating implementation plan marker: $PLAN_FILE"
+# Create placeholder file for AI to generate plan
+log "Creating implementation plan: $PLAN_FILE"
 echo "# Implementation Plan - $FEATURE_DIR" > "$PLAN_FILE"
 echo "" >> "$PLAN_FILE"
-echo "<!-- AI: Please generate plan using template: $TEMPLATE_FILE -->" >> "$PLAN_FILE"
+echo "<!-- INSTRUCTION: Generate plan using template: $TEMPLATE_FILE -->" >> "$PLAN_FILE"
 echo "<!-- SPEC_FILE: $SPEC_FILE -->" >> "$PLAN_FILE"
 echo "<!-- FEATURE_DIR: $FEATURE_DIR -->" >> "$PLAN_FILE"
 echo "<!-- FEATURE_ID: $FEATURE_ID -->" >> "$PLAN_FILE"
-echo "" >> "$PLAN_FILE"
-echo "## Awaiting AI Generation" >> "$PLAN_FILE"
-echo "This plan needs to be generated from the template based on specification: $SPEC_FILE" >> "$PLAN_FILE"
 
 # Validate plan structure
 log "Validating implementation plan..."
 
 # Check if file needs AI generation
-if grep -q "Awaiting AI Generation" "$PLAN_FILE"; then
+if grep -q "INSTRUCTION: Generate plan" "$PLAN_FILE"; then
     log "WARNING: Plan needs to be generated by AI from template"
     MISSING_SECTIONS=("ALL - Awaiting AI Generation")
     GATE_STATUS="PENDING"