specpulse 1.0.6__py3-none-any.whl → 1.2.0__py3-none-any.whl

specpulse/resources/commands/gemini/sp-task.toml

@@ -0,0 +1,79 @@
+description = "Generate and manage task breakdowns with versioning"
+prompt = """
+Handle the /sp-task command with arguments: {{args}}
+
+First, detect current feature context:
+- Read memory/context.md for current feature metadata
+- Use git branch name if available (e.g., 001-user-authentication)
+- Fall back to most recently created feature directory
+- If no context found, ask user to specify feature or run /sp-pulse first
+
+Parse arguments to determine action:
+- If "update": Update task status
+- If "status": Show progress
+- Otherwise: Generate task breakdown
+
+## For /sp-task breakdown or /sp-task:
+1. Show list of existing plan files in current feature directory
+2. Ask user which plan file to base tasks on
+3. Read selected implementation plan from @{plans/*/plan-XXX.md}
+
+4. Generate tasks from plan:
+   - Create task categories:
+     • Critical Path (Phase 0)
+     • Phase 1: Foundation
+     • Phase 2: Core Features
+     • Phase 3: Polish
+     • Phase 4: Testing
+
+   - For each task:
+     • Use T[XXX] format (T001, T002)
+     • Include clear description
+     • Mark dependencies
+     • Estimate complexity (S/M/L/XL)
+     • Assign priority
+
+5. Check existing task files and create next version (task-001.md, task-002.md, etc.)
+6. Write tasks to tasks/XXX-feature/task-XXX.md
+7. Run cross-platform validation:
+   - Linux/macOS: !{bash scripts/sp-pulse-task.sh "XXX-feature"}
+   - Fallback: !{python scripts/sp-pulse-task.py "XXX-feature"}
+
+## For /sp-task update:
+1. Show list of existing task files in current feature directory
+2. Ask user which task file to update
+3. Read selected current tasks from @{tasks/*/task-XXX.md}
+4. Ask which tasks to update
+5. Mark tasks as completed/in-progress
+6. Add newly discovered tasks
+7. Update dependencies and blockers
+8. Save updated task list
+9. Run cross-platform validation:
+   - Linux/macOS: !{bash scripts/sp-pulse-task.sh "XXX-feature"}
+   - Fallback: !{python scripts/sp-pulse-task.py "XXX-feature"}
+
+## For /sp-task status:
+1. Show list of existing task files in current feature directory
+2. Ask user which task file to show status for
+3. Read selected current tasks
+4. Run cross-platform analysis:
+   - Linux/macOS: !{bash scripts/sp-pulse-task.sh "XXX-feature"}
+   - Fallback: !{python scripts/sp-pulse-task.py "XXX-feature"}
+5. Count completed vs total
+6. Show current phase progress
+7. List any blockers
+8. Estimate remaining work
+9. Display progress summary
+
+Task Format:
+```markdown
+- [ ] T001: [S] Set up project structure
+- [ ] T002: [M] Create database schema
+- [x] T003: [L] Implement authentication
+```
+
+Examples:
+- /sp-task breakdown
+- /sp-task update
+- /sp-task status
+"""

specpulse/resources/memory/constitution.md

@@ -110,7 +110,7 @@ This includes:
 Every implementation plan MUST pass through constitutional gates:
 
 #### Phase -1: Pre-Implementation Gates
-- [ ] Simplicity Gate (Article VII): Using ≤3 projects? No future-proofing?
+- [ ] Simplicity Gate (Article VII): Using <=3 projects? No future-proofing?
 - [ ] Anti-Abstraction Gate (Article VII): Using framework directly? Single model?
 - [ ] Test-First Gate (Article III): Tests written? Tests reviewed? Tests failing?
 - [ ] Integration-First Gate (Article VIII): Contracts defined? Contract tests written?
@@ -188,11 +188,11 @@ While principles are immutable, their application can evolve:
 
 ### SpecPulse Development Process
 1. `specpulse init` - Initialize feature with proper structure
-2. Create specification following template guidelines
-3. Generate implementation plan with Phase Gates
-4. Break down into executable tasks
+2. `/sp-spec` - Create specification following template guidelines
+3. `/sp-plan` - Generate implementation plan with Phase Gates
+4. `/sp-task` - Break down into executable tasks
 5. Execute with Test-First Development
-6. Validate against constitution and specification
+6. `/sp-validate` - Validate against constitution and specification
 7. Update specifications based on learnings
 
 ### Version Control

specpulse/resources/memory/context.md

@@ -4,6 +4,27 @@
 - **Active Feature**: None
 - **Last Updated**: [AUTO-GENERATED]
 - **Phase**: Initialization
+- **Architecture**: [Monolithic|Decomposed]
+
+## Active Features
+<!-- Format:
+1. **[feature-name]** (SPEC-XXX)
+   - Status: [Specification|Planning|Implementation|Testing|Deployed]
+   - Branch: [branch-name]
+   - Architecture: [Monolithic|Decomposed]
+   - Services: [None|Service list]
+   - Blockers: [None|List]
+-->
+
+## Decomposition Status
+<!-- Updated when /sp-decompose is run -->
+- **Feature**: [feature-name]
+- **Decomposed**: [Yes|No]
+- **Services Identified**: 
+  - [Service Name]: [Responsibility]
+- **Integration Points**: [Count]
+- **Data Boundaries**: [Defined|Pending]
+- **Decomposition Date**: [Date]
 
 ## Recent Decisions
 <!-- Updated by AI during development -->
@@ -11,11 +32,29 @@
 ## Active Specifications
 <!-- List of in-progress specifications -->
 
+## Implementation Plans
+<!-- Track plan generation -->
+- **Monolithic Plans**: [List]
+- **Service Plans**: [List]
+- **Integration Plans**: [List]
+
+## Task Breakdown
+<!-- Track task creation -->
+- **Total Tasks**: [Count]
+- **Service Tasks**: [Count per service]
+- **Integration Tasks**: [Count]
+- **Completed**: [Percentage]
+
 ## Completed Features
 <!-- List of completed features with links -->
 
 ## Technical Stack
 <!-- Current technology choices -->
+- **Primary Language**: [Language]
+- **Framework**: [Framework]
+- **Database**: [Database]
+- **Message Queue**: [If decomposed]
+- **Service Mesh**: [If decomposed]
 
 ## Known Issues
 <!-- Active bugs or technical debt -->
@@ -24,4 +63,17 @@
 <!-- Key performance indicators -->
 
 ## Team Notes
-<!-- Important reminders or observations -->
+<!-- Important reminders or observations -->
+
+## Workflow History
+<!-- Auto-generated history -->
+
+### Active Feature: test-feature
+- Feature ID: 001
+- Branch: 001-test-feature
+- Started: 2025-09-12T00:06:47.683447
+
+### Active Feature: test-feature-2
+- Feature ID: 001
+- Branch: 001-test-feature-2
+- Started: 2025-09-12T00:09:08.283919

specpulse/resources/scripts/sp-pulse-decompose.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+"""
+SpecPulse Decomposition Orchestrator
+Validates decomposition request and returns status for AI processing
+"""
+
+import sys
+import os
+from pathlib import Path
+
+def main():
+    spec_id = sys.argv[1] if len(sys.argv) > 1 else None
+    action = sys.argv[2] if len(sys.argv) > 2 else "validate"
+    
+    print(f"[SpecPulse Decompose] Processing spec: {spec_id or 'current'}")
+    
+    # Find specification
+    specs_dir = Path("specs")
+    if not specs_dir.exists():
+        print("ERROR: No specifications directory")
+        print("SUGGESTION: Run /sp-spec create first")
+        sys.exit(1)
+    
+    if spec_id:
+        spec_dirs = list(specs_dir.glob(f"{spec_id}*"))
+        spec_dir = spec_dirs[0] if spec_dirs else None
+    else:
+        spec_dirs = sorted(specs_dir.glob("*"), reverse=True)
+        spec_dir = spec_dirs[0] if spec_dirs else None
+    
+    if not spec_dir:
+        print("ERROR: No specification found")
+        print("SUGGESTION: Run /sp-spec create first")
+        sys.exit(1)
+    
+    # Check complexity
+    spec_files = list(spec_dir.glob("spec-*.md"))
+    if spec_files:
+        spec_file = sorted(spec_files)[-1]
+        line_count = len(spec_file.read_text(encoding='utf-8').splitlines())
+        
+        print(f"SPEC_FILE={spec_file}")
+        print(f"COMPLEXITY={line_count} lines")
+        
+        if line_count > 100:
+            print("RECOMMENDATION=Decomposition advised (complex spec)")
+        else:
+            print("RECOMMENDATION=Single service may suffice")
+    
+    # Check for existing decomposition
+    decomp_dir = spec_dir / "decomposition"
+    if decomp_dir.exists():
+        print("STATUS=Decomposition exists")
+        print(f"PATH={decomp_dir}")
+    else:
+        print("STATUS=Ready for decomposition")
+        print(f"PATH={spec_dir}")
+    
+    # Return template paths for AI
+    print("TEMPLATES_DIR=templates/decomposition")
+    print("MEMORY_FILE=memory/context.md")
+    
+    return 0
+
+if __name__ == "__main__":
+    sys.exit(main())

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

@@ -0,0 +1,56 @@
+#!/bin/bash
+
+# SpecPulse Decomposition Orchestrator
+# Validates decomposition request and returns status for AI processing
+
+SPEC_ID="$1"
+ACTION="${2:-validate}"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+echo -e "${GREEN}[SpecPulse Decompose]${NC} Processing spec: ${SPEC_ID:-current}"
+
+# Find specification
+if [ -z "$SPEC_ID" ]; then
+    SPEC_DIR=$(ls -d specs/* 2>/dev/null | sort -r | head -1)
+else
+    SPEC_DIR=$(ls -d specs/${SPEC_ID}* 2>/dev/null | head -1)
+fi
+
+if [ -z "$SPEC_DIR" ] || [ ! -d "$SPEC_DIR" ]; then
+    echo "ERROR: No specification found"
+    echo "SUGGESTION: Run /sp-spec create first"
+    exit 1
+fi
+
+# Check complexity (simple heuristic)
+SPEC_FILE=$(ls "$SPEC_DIR"/spec-*.md 2>/dev/null | sort | tail -1)
+if [ -f "$SPEC_FILE" ]; then
+    LINE_COUNT=$(wc -l < "$SPEC_FILE")
+    echo "SPEC_FILE=$SPEC_FILE"
+    echo "COMPLEXITY=$LINE_COUNT lines"
+    
+    if [ "$LINE_COUNT" -gt 100 ]; then
+        echo "RECOMMENDATION=Decomposition advised (complex spec)"
+    else
+        echo "RECOMMENDATION=Single service may suffice"
+    fi
+fi
+
+# Check for existing decomposition
+if [ -d "$SPEC_DIR/decomposition" ]; then
+    echo "STATUS=Decomposition exists"
+    echo "PATH=$SPEC_DIR/decomposition"
+else
+    echo "STATUS=Ready for decomposition"
+    echo "PATH=$SPEC_DIR"
+fi
+
+# Return template paths for AI
+echo "TEMPLATES_DIR=templates/decomposition"
+echo "MEMORY_FILE=memory/context.md"
+
+exit 0

specpulse/resources/scripts/{pulse-init.py → sp-pulse-init.py}

@@ -14,10 +14,10 @@ from pathlib import Path
 class SpecPulseInit:
     def __init__(self):
         self.script_name = Path(__file__).name
-        self.project_root = Path(__file__).parent.parent.parent
+        self.project_root = Path(__file__).parent.parent
         self.memory_dir = self.project_root / "memory"
         self.context_file = self.memory_dir / "context.md"
-        self.templates_dir = self.project_root / "resources" / "templates"
+        self.templates_dir = self.project_root / "templates"
         
     def log(self, message):
         """Log messages with timestamp"""
@@ -77,9 +77,9 @@ class SpecPulseInit:
     def copy_templates(self, branch_name):
         """Copy templates to feature directories"""
         templates = {
-            "spec.md": self.project_root / "specs" / branch_name / "spec.md",
-            "plan.md": self.project_root / "plans" / branch_name / "plan.md",
-            "task.md": self.project_root / "tasks" / branch_name / "tasks.md"
+            "spec.md": self.project_root / "specs" / branch_name / "spec-001.md",
+            "plan.md": self.project_root / "plans" / branch_name / "plan-001.md",
+            "task.md": self.project_root / "tasks" / branch_name / "task-001.md"
         }
         
         for template_name, target_path in templates.items():
@@ -140,7 +140,7 @@ class SpecPulseInit:
     def main(self, args):
         """Main execution function"""
         if len(args) < 1:
-            self.error_exit("Usage: python pulse-init.py <feature-name> [feature-id]")
+            self.error_exit("Usage: python sp-pulse-init.py <feature-name> [feature-id]")
             
         feature_name = args[0]
         custom_id = args[1] if len(args) > 1 else None

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

@@ -1,96 +1,96 @@
-#!/bin/bash
-# Initialize a new feature with SpecPulse
-
-set -euo pipefail  # Exit on error, unset vars, pipe failures
-
-# Configuration
-SCRIPT_NAME="$(basename "$0")"
-PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && 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-name> [feature-id]"
-fi
-
-FEATURE_NAME="$1"
-CUSTOM_ID="${2:-}"
-
-# Sanitize feature name
-BRANCH_SAFE_NAME=$(echo "$FEATURE_NAME" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9-]/-/g' | sed 's/--*/-/g' | sed 's/^-//;s/-$//')
-
-if [ -z "$BRANCH_SAFE_NAME" ]; then
-    error_exit "Invalid feature name: '$FEATURE_NAME'"
-fi
-
-# Get feature ID
-if [ -n "$CUSTOM_ID" ]; then
-    FEATURE_ID=$(printf "%03d" "$CUSTOM_ID")
-else
-    FEATURE_ID=$(printf "%03d" $(find "$PROJECT_ROOT/specs" -maxdepth 1 -type d -name '[0-9]*' 2>/dev/null | wc -l | awk '{print $1 + 1}'))
-fi
-
-BRANCH_NAME="${FEATURE_ID}-${BRANCH_SAFE_NAME}"
-
-# Create directories
-SPECS_DIR="$PROJECT_ROOT/specs/${BRANCH_NAME}"
-PLANS_DIR="$PROJECT_ROOT/plans/${BRANCH_NAME}"
-TASKS_DIR="$PROJECT_ROOT/tasks/${BRANCH_NAME}"
-
-log "Creating feature directories for '$FEATURE_NAME'"
-
-mkdir -p "$SPECS_DIR" || error_exit "Failed to create specs directory: $SPECS_DIR"
-mkdir -p "$PLANS_DIR" || error_exit "Failed to create plans directory: $PLANS_DIR"
-mkdir -p "$TASKS_DIR" || error_exit "Failed to create tasks directory: $TASKS_DIR"
-
-# Create initial files from templates
-TEMPLATE_DIR="$PROJECT_ROOT/templates"
-
-if [ ! -f "$TEMPLATE_DIR/spec.md" ]; then
-    error_exit "Template not found: $TEMPLATE_DIR/spec.md"
-fi
-
-cp "$TEMPLATE_DIR/spec.md" "$SPECS_DIR/spec.md" || error_exit "Failed to copy spec template"
-cp "$TEMPLATE_DIR/plan.md" "$PLANS_DIR/plan.md" || error_exit "Failed to copy plan template"
-cp "$TEMPLATE_DIR/task.md" "$TASKS_DIR/tasks.md" || error_exit "Failed to copy task template"
-
-# Update context
-CONTEXT_FILE="$PROJECT_ROOT/memory/context.md"
-mkdir -p "$(dirname "$CONTEXT_FILE")"
-
-{
-    echo ""
-    echo "## Active Feature: $FEATURE_NAME"
-    echo "- Feature ID: $FEATURE_ID"
-    echo "- Branch: $BRANCH_NAME"
-    echo "- Started: $(date -Iseconds)"
-} >> "$CONTEXT_FILE" || error_exit "Failed to update context file"
-
-# Create git branch if in git repo
-if [ -d "$PROJECT_ROOT/.git" ]; then
-    cd "$PROJECT_ROOT"
-    if git rev-parse --verify "$BRANCH_NAME" >/dev/null 2>&1; then
-        log "Git branch '$BRANCH_NAME' already exists, checking out"
-        git checkout "$BRANCH_NAME" || error_exit "Failed to checkout existing branch"
-    else
-        log "Creating new git branch '$BRANCH_NAME'"
-        git checkout -b "$BRANCH_NAME" || error_exit "Failed to create new branch"
-    fi
-fi
-
-log "Successfully initialized feature '$FEATURE_NAME' with ID $FEATURE_ID"
-
-echo "BRANCH_NAME=$BRANCH_NAME"
-echo "SPEC_DIR=$SPECS_DIR"
-echo "FEATURE_ID=$FEATURE_ID"
+#!/bin/bash
+# Initialize a new feature with SpecPulse
+
+set -euo pipefail  # Exit on error, unset vars, pipe failures
+
+# Configuration
+SCRIPT_NAME="$(basename "$0")"
+PROJECT_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && 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-name> [feature-id]"
+fi
+
+FEATURE_NAME="$1"
+CUSTOM_ID="${2:-}"
+
+# Sanitize feature name
+BRANCH_SAFE_NAME=$(echo "$FEATURE_NAME" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9-]/-/g' | sed 's/--*/-/g' | sed 's/^-//;s/-$//')
+
+if [ -z "$BRANCH_SAFE_NAME" ]; then
+    error_exit "Invalid feature name: '$FEATURE_NAME'"
+fi
+
+# Get feature ID
+if [ -n "$CUSTOM_ID" ]; then
+    FEATURE_ID=$(printf "%03d" "$CUSTOM_ID")
+else
+    FEATURE_ID=$(printf "%03d" $(find "$PROJECT_ROOT/specs" -maxdepth 1 -type d -name '[0-9]*' 2>/dev/null | wc -l | awk '{print $1 + 1}'))
+fi
+
+BRANCH_NAME="${FEATURE_ID}-${BRANCH_SAFE_NAME}"
+
+# Create directories
+SPECS_DIR="$PROJECT_ROOT/specs/${BRANCH_NAME}"
+PLANS_DIR="$PROJECT_ROOT/plans/${BRANCH_NAME}"
+TASKS_DIR="$PROJECT_ROOT/tasks/${BRANCH_NAME}"
+
+log "Creating feature directories for '$FEATURE_NAME'"
+
+mkdir -p "$SPECS_DIR" || error_exit "Failed to create specs directory: $SPECS_DIR"
+mkdir -p "$PLANS_DIR" || error_exit "Failed to create plans directory: $PLANS_DIR"
+mkdir -p "$TASKS_DIR" || error_exit "Failed to create tasks directory: $TASKS_DIR"
+
+# Create initial files from templates
+TEMPLATE_DIR="$PROJECT_ROOT/templates"
+
+if [ ! -f "$TEMPLATE_DIR/spec-001.md" ]; then
+    error_exit "Template not found: $TEMPLATE_DIR/spec-001.md"
+fi
+
+cp "$TEMPLATE_DIR/spec-001.md" "$SPECS_DIR/spec-001.md" || error_exit "Failed to copy spec template"
+cp "$TEMPLATE_DIR/plan-001.md" "$PLANS_DIR/plan-001.md" || error_exit "Failed to copy plan template"
+cp "$TEMPLATE_DIR/task.md" "$TASKS_DIR/task-001.md" || error_exit "Failed to copy task template"
+
+# Update context
+CONTEXT_FILE="$PROJECT_ROOT/memory/context.md"
+mkdir -p "$(dirname "$CONTEXT_FILE")"
+
+{
+    echo ""
+    echo "## Active Feature: $FEATURE_NAME"
+    echo "- Feature ID: $FEATURE_ID"
+    echo "- Branch: $BRANCH_NAME"
+    echo "- Started: $(date -Iseconds)"
+} >> "$CONTEXT_FILE" || error_exit "Failed to update context file"
+
+# Create git branch if in git repo
+if [ -d "$PROJECT_ROOT/.git" ]; then
+    cd "$PROJECT_ROOT"
+    if git rev-parse --verify "$BRANCH_NAME" >/dev/null 2>&1; then
+        log "Git branch '$BRANCH_NAME' already exists, checking out"
+        git checkout "$BRANCH_NAME" || error_exit "Failed to checkout existing branch"
+    else
+        log "Creating new git branch '$BRANCH_NAME'"
+        git checkout -b "$BRANCH_NAME" || error_exit "Failed to create new branch"
+    fi
+fi
+
+log "Successfully initialized feature '$FEATURE_NAME' with ID $FEATURE_ID"
+
+echo "BRANCH_NAME=$BRANCH_NAME"
+echo "SPEC_DIR=$SPECS_DIR"
+echo "FEATURE_ID=$FEATURE_ID"
 echo "STATUS=initialized"

specpulse/resources/scripts/{pulse-plan.py → sp-pulse-plan.py}

@@ -13,10 +13,10 @@ import datetime
 class SpecPulsePlan:
     def __init__(self):
         self.script_name = Path(__file__).name
-        self.project_root = Path(__file__).parent.parent.parent
+        self.project_root = Path(__file__).parent.parent
         self.memory_dir = self.project_root / "memory"
         self.context_file = self.memory_dir / "context.md"
-        self.templates_dir = self.project_root / "resources" / "templates"
+        self.templates_dir = self.project_root / "templates"
         
     def log(self, message):
         """Log messages with timestamp"""
@@ -126,7 +126,7 @@ class SpecPulsePlan:
     def main(self, args):
         """Main execution function"""
         if len(args) < 1:
-            self.error_exit("Usage: python pulse-plan.py <feature-dir>")
+            self.error_exit("Usage: python sp-pulse-plan.py <feature-dir>")
             
         feature_dir = args[0]
         
@@ -136,9 +136,34 @@ class SpecPulsePlan:
         sanitized_dir = self.get_current_feature_dir(feature_dir)
         
         # Set file paths
-        plan_file = self.project_root / "plans" / sanitized_dir / "plan.md"
-        template_file = self.templates_dir / "plan.md"
-        spec_file = self.project_root / "specs" / sanitized_dir / "spec.md"
+        specs_dir = self.project_root / "specs" / sanitized_dir
+        plans_dir = self.project_root / "plans" / sanitized_dir
+        
+        # Find latest spec file
+        if specs_dir.exists():
+            spec_files = list(specs_dir.glob("spec-*.md"))
+            if spec_files:
+                latest_spec = max(spec_files, key=lambda f: f.stat().st_mtime)
+            else:
+                self.error_exit(f"No specification files found in {specs_dir}")
+        else:
+            self.error_exit(f"Specifications directory not found: {specs_dir}")
+        
+        # Find next available plan number
+        if plans_dir.exists():
+            existing_plans = list(plans_dir.glob("plan-*.md"))
+            if existing_plans:
+                plan_numbers = [int(f.stem.split('-')[1]) for f in existing_plans if f.stem.split('-')[1].isdigit()]
+                next_number = max(plan_numbers) + 1 if plan_numbers else 1
+            else:
+                next_number = 1
+        else:
+            next_number = 1
+            plans_dir.mkdir(parents=True, exist_ok=True)
+        
+        plan_file = plans_dir / f"plan-{next_number:03d}.md"
+        template_file = self.templates_dir / "plan-001.md"
+        spec_file = latest_spec
         
         # Ensure plans directory exists
         plan_file.parent.mkdir(parents=True, exist_ok=True)
@@ -155,7 +180,7 @@ class SpecPulsePlan:
         if not plan_file.exists():
             self.log(f"Creating implementation plan from template: {plan_file}")
             try:
-                plan_file.write_text(template_file.read_text(encoding='utf-8'))
+                plan_file.write_text(template_file.read_text(encoding='utf-8'), encoding='utf-8')
             except Exception as e:
                 self.error_exit(f"Failed to copy plan template: {e}")
         else: