specpulse 1.4.2__tar.gz → 1.4.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specpulse
-Version: 1.4.2
+Version: 1.4.3
 Summary: Specification-Driven Development Framework
 Home-page: https://github.com/specpulse
 Author: SpecPulse
@@ -67,7 +67,12 @@ 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.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.3}/README.md

@@ -21,7 +21,12 @@
 
 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.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.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specpulse"
-version = "1.4.2"
+version = "1.4.3"
 description = "Specification-Driven Development Framework"
 readme = "README.md"
 requires-python = ">=3.11"

{specpulse-1.4.2 → specpulse-1.4.3}/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.3",
     author="SpecPulse",
     author_email="",
     description="Next-Generation Specification-Driven Development Framework",

{specpulse-1.4.2 → specpulse-1.4.3}/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.3}/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.3}/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.3}/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,17 +78,14 @@ 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..."

{specpulse-1.4.2 → specpulse-1.4.3}/specpulse/resources/scripts/sp-pulse-spec.ps1

@@ -48,8 +48,13 @@ if (-not (Test-Path $SpecDir)) {
 # 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 }
+    $existingSpecs = Get-ChildItem -Path $SpecDir -Filter "spec-*.md" -ErrorAction SilentlyContinue | Sort-Object Name
+    if ($existingSpecs) {
+        $highestSpec = [int]($existingSpecs[-1].BaseName -replace 'spec-', '')
+        $specNumber = $highestSpec + 1
+    } else {
+        $specNumber = 1
+    }
     $SpecFile = Join-Path $SpecDir ("spec-{0:D3}.md" -f $specNumber)
 
     # Update specification with provided content
@@ -60,27 +65,24 @@ if ($SpecContent) {
         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: $_"
+    # Interactive mode - AI should generate spec content
+    # Check if spec-001.md exists
+    $FirstSpec = Join-Path $SpecDir "spec-001.md"
+    if (Test-Path $FirstSpec) {
+        # Find next available spec number
+        $existingSpecs = Get-ChildItem -Path $SpecDir -Filter "spec-*.md" -ErrorAction SilentlyContinue | Sort-Object Name
+        if ($existingSpecs) {
+            $highestSpec = [int]($existingSpecs[-1].BaseName -replace 'spec-', '')
+            $specNumber = $highestSpec + 1
+        } else {
+            $specNumber = 2
         }
+    } else {
+        $specNumber = 1
     }
+    $SpecFile = Join-Path $SpecDir ("spec-{0:D3}.md" -f $specNumber)
+    Log-Message "Creating specification file for AI generation: $SpecFile"
+    "INSTRUCTION: Generate specification content using template at $TemplateFile" | Set-Content -Path "$SpecFile.instruction"
 }
 
 # Validate specification

{specpulse-1.4.2 → specpulse-1.4.3}/specpulse/resources/scripts/sp-pulse-spec.sh

@@ -64,41 +64,39 @@ if [ -n "$SPEC_CONTENT" ]; then
         spec_number=1
     fi
     SPEC_FILE="$SPEC_DIR/spec-$(printf "%03d" $spec_number).md"
-    
+
     # Update specification with provided content
     log "Creating specification: $SPEC_FILE"
     echo "$SPEC_CONTENT" > "$SPEC_FILE" || error_exit "Failed to write specification content"
 else
-    # 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
-            # No spec files found, create first one with marker for AI
-            SPEC_FILE="$SPEC_DIR/spec-001.md"
-            log "Creating first specification marker: $SPEC_FILE"
-            echo "# Specification - $FEATURE_DIR" > "$SPEC_FILE"
-            echo "" >> "$SPEC_FILE"
-            echo "<!-- AI: Please generate specification using template: $TEMPLATE_FILE -->" >> "$SPEC_FILE"
-            echo "<!-- FEATURE_DIR: $FEATURE_DIR -->" >> "$SPEC_FILE"
-            echo "<!-- FEATURE_ID: $FEATURE_ID -->" >> "$SPEC_FILE"
-            echo "" >> "$SPEC_FILE"
-            echo "## Awaiting AI Generation" >> "$SPEC_FILE"
-            echo "This specification needs to be generated from the template." >> "$SPEC_FILE"
+    # Interactive mode - AI should generate spec content
+    # Check if spec-001.md exists
+    if [ -f "$SPEC_DIR/spec-001.md" ]; then
+        # Find next available spec number
+        highest_spec=$(find "$SPEC_DIR" -name "spec-*.md" -exec basename {} .md \; | sed 's/spec-//' | sort -n | tail -1)
+        if [ -n "$highest_spec" ]; then
+            spec_number=$((highest_spec + 1))
         else
-            log "Using latest specification: $SPEC_FILE"
+            spec_number=2
         fi
+        SPEC_FILE="$SPEC_DIR/spec-$(printf "%03d" $spec_number).md"
+        log "Creating specification file for AI generation: $SPEC_FILE"
+        # Create placeholder file for AI to fill
+        echo "# Specification - $FEATURE_DIR" > "$SPEC_FILE"
+        echo "" >> "$SPEC_FILE"
+        echo "<!-- INSTRUCTION: Generate specification content using template: $TEMPLATE_FILE -->" >> "$SPEC_FILE"
+        echo "<!-- FEATURE_DIR: $FEATURE_DIR -->" >> "$SPEC_FILE"
+        echo "<!-- FEATURE_ID: $FEATURE_ID -->" >> "$SPEC_FILE"
     else
-        # Create directory and first spec with marker for AI
+        # Create first spec
         SPEC_FILE="$SPEC_DIR/spec-001.md"
-        log "Creating first specification marker: $SPEC_FILE"
+        log "Creating first specification file for AI generation: $SPEC_FILE"
+        # Create placeholder file for AI to fill
         echo "# Specification - $FEATURE_DIR" > "$SPEC_FILE"
         echo "" >> "$SPEC_FILE"
-        echo "<!-- AI: Please generate specification using template: $TEMPLATE_FILE -->" >> "$SPEC_FILE"
+        echo "<!-- INSTRUCTION: Generate specification content using template: $TEMPLATE_FILE -->" >> "$SPEC_FILE"
         echo "<!-- FEATURE_DIR: $FEATURE_DIR -->" >> "$SPEC_FILE"
         echo "<!-- FEATURE_ID: $FEATURE_ID -->" >> "$SPEC_FILE"
-        echo "" >> "$SPEC_FILE"
-        echo "## Awaiting AI Generation" >> "$SPEC_FILE"
-        echo "This specification needs to be generated from the template." >> "$SPEC_FILE"
     fi
 fi
 

{specpulse-1.4.2 → specpulse-1.4.3}/specpulse/resources/scripts/sp-pulse-task.sh

@@ -70,14 +70,14 @@ else
     error_exit "Plans directory not found: $PLAN_DIR. Please create plan first."
 fi
 
-# Find next available task number or create new one
-if [ -d "$TASK_DIR" ]; then
-    # Get the highest task number and increment it
+# Check if task-001.md exists
+if [ -f "$TASK_DIR/task-001.md" ]; then
+    # Find next available task number
     highest_task=$(find "$TASK_DIR" -name "task-*.md" -exec basename {} .md \; | sed 's/task-//' | sort -n | tail -1)
     if [ -n "$highest_task" ]; then
         task_number=$((highest_task + 1))
     else
-        task_number=1
+        task_number=2
     fi
 else
     task_number=1
@@ -89,20 +89,15 @@ if [ ! -f "$TEMPLATE_FILE" ]; then
     error_exit "Template not found: $TEMPLATE_FILE"
 fi
 
-# Create task file marker for AI generation
-log "Creating task breakdown marker: $TASK_FILE"
+# Create placeholder file for AI to generate tasks
+log "Creating task breakdown: $TASK_FILE"
 echo "# Task Breakdown - $FEATURE_DIR" > "$TASK_FILE"
 echo "" >> "$TASK_FILE"
-echo "<!-- AI: Please generate tasks using template: $TEMPLATE_FILE -->" >> "$TASK_FILE"
+echo "<!-- INSTRUCTION: Generate tasks using template: $TEMPLATE_FILE -->" >> "$TASK_FILE"
 echo "<!-- SPEC_FILE: $SPEC_FILE -->" >> "$TASK_FILE"
 echo "<!-- PLAN_FILE: $PLAN_FILE -->" >> "$TASK_FILE"
 echo "<!-- FEATURE_DIR: $FEATURE_DIR -->" >> "$TASK_FILE"
 echo "<!-- FEATURE_ID: $FEATURE_ID -->" >> "$TASK_FILE"
-echo "" >> "$TASK_FILE"
-echo "## Awaiting AI Generation" >> "$TASK_FILE"
-echo "Tasks need to be generated from the template based on:" >> "$TASK_FILE"
-echo "- Specification: $SPEC_FILE" >> "$TASK_FILE"
-echo "- Plan: $PLAN_FILE" >> "$TASK_FILE"
 
 # Validate task structure
 log "Validating task breakdown..."

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specpulse
-Version: 1.4.2
+Version: 1.4.3
 Summary: Specification-Driven Development Framework
 Home-page: https://github.com/specpulse
 Author: SpecPulse
@@ -67,7 +67,12 @@ 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.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