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

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

@@ -0,0 +1,61 @@
+description = "Track progress across all features or specific feature details"
+prompt = """
+Handle the /sp-status 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, work with all features
+
+Parse arguments to determine scope:
+- If feature name provided: Show detailed status for that feature
+- Otherwise: Show overview of all features
+
+## For /sp-status (all features overview):
+1. Scan all feature directories (specs/*, plans/*, tasks/*)
+2. Count features by status: active, completed, in_progress, paused
+3. Calculate overall project progress
+4. Show summary statistics:
+   ```
+   TOTAL_FEATURES=5
+   ACTIVE_FEATURES=2
+   COMPLETED_FEATURES=1
+   IN_PROGRESS_FEATURES=1
+   PAUSED_FEATURES=1
+   OVERALL_PROGRESS=42%
+   ```
+5. List all features with their status and progress percentage
+6. Highlight current active feature from context
+
+## For /sp-status [feature-name] (detailed feature status):
+1. Detect feature directory using context detection logic
+2. Read all task files in the feature's tasks directory
+3. Calculate completion percentage based on task status
+4. Show detailed breakdown:
+   ```
+   FEATURE: 001-user-authentication
+   STATUS: active
+   PROGRESS: 65%
+   SPECS: 2 files
+   PLANS: 1 file
+   TASKS: 1 file (25 total tasks)
+   COMPLETED_TASKS: 16
+   IN_PROGRESS_TASKS: 5
+   BLOCKED_TASKS: 1
+   LAST_UPDATED: 2025-01-09
+   ```
+5. Show phase-by-phase progress
+6. List any blockers or issues
+7. Provide recommendations for next steps
+
+Progress calculation:
+- Scan task files for completion status: [x] completed, [ ] pending, [-] in progress, [!] blocked
+- Calculate percentages: completed / total * 100
+- Track status: active, completed, in_progress, paused, blocked
+
+Examples:
+- /sp-status
+- /sp-status user-authentication
+- /sp-status 001
+"""

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

@@ -24,4 +24,15 @@
 <!-- Key performance indicators -->
 
 ## Team Notes
-<!-- Important reminders or observations -->
+<!-- Important reminders or observations -->
+
+## 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/{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: