specpulse 1.4.2__py3-none-any.whl → 1.4.3__py3-none-any.whl

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/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/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/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/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/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/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.dist-info → specpulse-1.4.3.dist-info}/METADATA

@@ -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.dist-info → specpulse-1.4.3.dist-info}/RECORD

@@ -1,4 +1,4 @@
-specpulse/__init__.py,sha256=S9i8eeS7i75zkwKFr3D80BgRXO3QW1rXi_B8dNQaGeE,270
+specpulse/__init__.py,sha256=rf4i60l4TpV_Jt7hMWfRsHnM6K19dzCC8HAvYP9AbNw,270
 specpulse/cli/__init__.py,sha256=DpX6FoRJtSNjudsmZ3mTih_RIaWyiIgxew4-f8mOmFY,70
 specpulse/cli/main.py,sha256=p32z6MovqiWI94CsojLKIP65Kmq0C3sX_xpQlqXYsZM,35251
 specpulse/core/__init__.py,sha256=VKHGdPDM38QM9yDIq05jxol4q8WFlFAeltOzYLsPuto,132
@@ -7,9 +7,9 @@ specpulse/core/validator.py,sha256=xSWqR_-ZDV-vPNEqkmK7r-YRyKvJON5wXelXz-sXGN0,2
 specpulse/resources/commands/claude/sp-continue.md,sha256=3_vikDSNRN0slNtKQGWl9dWEgkT-Q7nFpUxHKnzBCKs,5175
 specpulse/resources/commands/claude/sp-decompose.md,sha256=VBWthGczLdI6onXKdfcN5JTiRTY43Xe6OQ7JTbk3Fao,8054
 specpulse/resources/commands/claude/sp-execute.md,sha256=zkWcp_u8Dz9BgFp36ikssOQZ2eM2uPOCiWtY1DsyTUk,4850
-specpulse/resources/commands/claude/sp-plan.md,sha256=GCq9FCs5nxIfKGgAr0P9fVHmnJ6uuizrW49N4Qt2Yuo,7359
+specpulse/resources/commands/claude/sp-plan.md,sha256=oPr-Vz-WleQVtp_qMrxtfe6bipYIWoftmouyAPTMelY,7586
 specpulse/resources/commands/claude/sp-pulse.md,sha256=VImzooetLsF65Nr082OW6JTRp5v8m7CdDhqAPBJi4vg,5267
-specpulse/resources/commands/claude/sp-spec.md,sha256=Jh6j81pNUCZG2sRLuDbLFb6r15uLYUU6d0IBouAJo24,6319
+specpulse/resources/commands/claude/sp-spec.md,sha256=d8Veu2WDtmRnxl9fZl5_dzgjuxJOo_3Vu92OZYfXNQc,6551
 specpulse/resources/commands/claude/sp-status.md,sha256=pUcFsYdmvAPTA1BdRjiN-AWi9I8IN4GiEErjfK4wNOU,4633
 specpulse/resources/commands/claude/sp-task.md,sha256=8dy1eOBTZ9aTpiVn-R9i0jtxNUrkufD8jwyMgMxjrhQ,10121
 specpulse/resources/commands/gemini/sp-continue.toml,sha256=_iyo_g9IV0-FtIpiVknKNaegmhyc3DHb41lvfpf7anU,1784
@@ -30,11 +30,11 @@ specpulse/resources/scripts/sp-pulse-execute.sh,sha256=696vgsj0NpV-Mr0KMyoJ63NkT
 specpulse/resources/scripts/sp-pulse-init.ps1,sha256=NaQvpjEEfegvr2QQtYw6K_MYzh4EkfUPF7zjf_ffHUg,4799
 specpulse/resources/scripts/sp-pulse-init.sh,sha256=WDSRmf-qgcSs2sGpBLe44ObL3dAvJOdnbxsmpspcglI,4368
 specpulse/resources/scripts/sp-pulse-plan.ps1,sha256=Aw-XKJfLTkavYSqVD3lVs5JQ9h3K4ZcHzprqDYS8MWo,4369
-specpulse/resources/scripts/sp-pulse-plan.sh,sha256=zh-mfuqWWG20R513KtyhhAmA2llmhLy6l_TrbYHMtHs,5048
-specpulse/resources/scripts/sp-pulse-spec.ps1,sha256=u71r-wfGB8f7RJCuENufCJLlSuXlWcnUHYiSpjrPEQ4,4075
-specpulse/resources/scripts/sp-pulse-spec.sh,sha256=Tr4DBie3DuCKBJWEisPNYcJ4cLFWyygnI1HIw63bABI,5336
+specpulse/resources/scripts/sp-pulse-plan.sh,sha256=bsrnLNNGnWVRCwhqdnjCaa14VX_owJriCvnGBA6M1L8,4850
+specpulse/resources/scripts/sp-pulse-spec.ps1,sha256=uCuSSJ360UW70BxyLgvcaMdNsbyJFsEWkIviTwojRKc,4222
+specpulse/resources/scripts/sp-pulse-spec.sh,sha256=g7EAmbg7WaRUiT6O1Qus-2XlveuSnZWV14NFtL1YYs8,5141
 specpulse/resources/scripts/sp-pulse-task.ps1,sha256=Uqp6lobaQb4mW5OiQ9LjEtyuYSewcRMjUj1GqHVoh6g,5664
-specpulse/resources/scripts/sp-pulse-task.sh,sha256=f6biPNGG7V9merxHw5W_i_avQCheSAAEdqJ-UOey5wk,6125
+specpulse/resources/scripts/sp-pulse-task.sh,sha256=38KxXIwNpBEokyFwcCbjtZ2cDVOrYPe1SNxYPx45GuQ,5860
 specpulse/resources/templates/plan.md,sha256=ieouqeIhLEfzP-_vytCmKHqxNGh8ITNZ5sub3nufvZ0,3349
 specpulse/resources/templates/spec.md,sha256=wGXSyD7AWRofeeW5a2rVrSIxeYK5zolQulN1xJRni44,2234
 specpulse/resources/templates/task.md,sha256=X3_BOYIZ40qMGRxDs-stGh0pAVyZHYkvSNuvXJO981o,4658
@@ -47,9 +47,9 @@ specpulse/utils/__init__.py,sha256=VTGRDsVLl2JIXYyHB9Sidxj5acY_W-LJI2MMtY1pwb0,1
 specpulse/utils/console.py,sha256=1Dn6m81dZa3XZkeKvGFgQywE9FyQnhlOorNtE0f86VM,14793
 specpulse/utils/git_utils.py,sha256=jH5RWbC-lx2iPKVm2dWP7Iqqh1_CdmbNi7q4S_c4W8s,7393
 specpulse/utils/version_check.py,sha256=9Ug0Td1SesRskx2JFy7QS59ikomKRxuSM9OUHrZtEO4,3877
-specpulse-1.4.2.dist-info/licenses/LICENSE,sha256=ImSFezK-Phy0oTBqZipcajsJfPZT8mmg8m3jkgNdNhA,1066
-specpulse-1.4.2.dist-info/METADATA,sha256=MDzhFVbNNaUScmAhhm02ZevL6mWodAah8gXOiwhQPPg,24325
-specpulse-1.4.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-specpulse-1.4.2.dist-info/entry_points.txt,sha256=GwMaCKWSCFZlJMrTNavEYrnREynIS6dM3B0ILxnaouA,83
-specpulse-1.4.2.dist-info/top_level.txt,sha256=pEfkFil5xe38J00OHrBrJ07xpbm6bRnGhI8B07O9KeI,10
-specpulse-1.4.2.dist-info/RECORD,,
+specpulse-1.4.3.dist-info/licenses/LICENSE,sha256=ImSFezK-Phy0oTBqZipcajsJfPZT8mmg8m3jkgNdNhA,1066
+specpulse-1.4.3.dist-info/METADATA,sha256=0sxARDERGUL3YHBXjCIdxJbZs-_fux70IWx77SUMuX4,24654
+specpulse-1.4.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+specpulse-1.4.3.dist-info/entry_points.txt,sha256=GwMaCKWSCFZlJMrTNavEYrnREynIS6dM3B0ILxnaouA,83
+specpulse-1.4.3.dist-info/top_level.txt,sha256=pEfkFil5xe38J00OHrBrJ07xpbm6bRnGhI8B07O9KeI,10
+specpulse-1.4.3.dist-info/RECORD,,