specpulse 1.3.2__py3-none-any.whl → 1.3.4__py3-none-any.whl

specpulse/__init__.py

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

specpulse/cli/main.py

@@ -17,6 +17,7 @@ from ..core.specpulse import SpecPulse
 from ..core.validator import Validator
 from ..utils.console import Console
 from ..utils.git_utils import GitUtils
+from ..utils.version_check import check_pypi_version, compare_versions, get_update_message, should_check_version
 
 
 class SpecPulseCLI:
@@ -24,7 +25,32 @@ class SpecPulseCLI:
         self.console = Console(no_color=no_color, verbose=verbose)
         self.specpulse = SpecPulse()
         self.validator = Validator()
-        
+
+        # Check for updates (non-blocking)
+        self._check_for_updates()
+
+    def _check_for_updates(self):
+        """Check for available updates on PyPI"""
+        try:
+            if not should_check_version():
+                return
+
+            latest = check_pypi_version(timeout=1)
+            if latest:
+                current = __version__
+                is_outdated, is_major = compare_versions(current, latest)
+
+                if is_outdated:
+                    message, color = get_update_message(current, latest, is_major)
+                    # Only show for init command or when verbose
+                    # Don't spam on every command
+                    import sys
+                    if len(sys.argv) > 1 and sys.argv[1] in ['init', '--version']:
+                        self.console.info(message, style=color)
+        except:
+            # Never fail due to version check
+            pass
+
     def init(self, project_name: Optional[str] = None, 
              here: bool = False, 
              ai: str = "claude",
@@ -67,10 +93,11 @@ class SpecPulseCLI:
             ".gemini/commands",
             "memory",
             "specs",
-            "plans", 
+            "plans",
             "tasks",
             "scripts",
-            "templates"
+            "templates",
+            "templates/decomposition"
         ]
         
         # Create directories with progress bar
@@ -198,7 +225,17 @@ class SpecPulseCLI:
         task_template = self.specpulse.get_task_template()
         with open(templates_dir / "task.md", 'w', encoding='utf-8') as f:
             f.write(task_template)
-        
+
+        # Copy decomposition templates
+        decomp_dir = templates_dir / "decomposition"
+        decomp_dir.mkdir(parents=True, exist_ok=True)
+
+        resources_decomp_dir = self.specpulse.resources_dir / "templates" / "decomposition"
+        if resources_decomp_dir.exists():
+            for template_file in resources_decomp_dir.iterdir():
+                if template_file.is_file():
+                    shutil.copy2(template_file, decomp_dir / template_file.name)
+
         self.console.success("Created templates")
     
     def _create_memory_files(self, project_path: Path):
@@ -228,20 +265,20 @@ class SpecPulseCLI:
         resources_scripts_dir = self.specpulse.resources_dir / "scripts"
         
         # Copy all script files from resources
-        script_extensions = [".sh", ".py"]
+        script_extensions = [".sh", ".ps1", ".py"]
         scripts_copied = 0
-        
+
         for script_file in resources_scripts_dir.iterdir():
             if script_file.suffix in script_extensions:
                 dest_path = scripts_dir / script_file.name
                 shutil.copy2(script_file, dest_path)
-                
+
                 # Make shell scripts executable
-                if script_file.suffix == ".sh":
+                if script_file.suffix in [".sh", ".ps1"]:
                     try:
                         os.chmod(dest_path, 0o755)
                     except:
-                        pass  # Windows may not support chmod
+                        pass  # Windows may not support chmod for .sh files
                 
                 scripts_copied += 1
         

specpulse/core/specpulse.py

@@ -41,7 +41,7 @@ class SpecPulse:
     
     def get_spec_template(self) -> str:
         """Get specification template from file"""
-        template_path = self.resources_dir / "templates" / "spec-001.md"
+        template_path = self.resources_dir / "templates" / "spec.md"
         if template_path.exists():
             with open(template_path, 'r', encoding='utf-8') as f:
                 return f.read()
@@ -125,7 +125,7 @@ FR-001: [Requirement]
     
     def get_plan_template(self) -> str:
         """Get implementation plan template from file"""
-        template_path = self.resources_dir / "templates" / "plan-001.md"
+        template_path = self.resources_dir / "templates" / "plan.md"
         if template_path.exists():
             with open(template_path, 'r', encoding='utf-8') as f:
                 return f.read()

specpulse/resources/scripts/sp-pulse-init.ps1

@@ -0,0 +1,131 @@
+# SpecPulse Feature Initialization - PowerShell Version
+# Initialize a new feature with SpecPulse
+
+param(
+    [Parameter(Mandatory=$true, Position=0)]
+    [string]$FeatureName,
+
+    [Parameter(Mandatory=$false, Position=1)]
+    [string]$CustomId
+)
+
+# Configuration
+$ScriptName = Split-Path -Leaf $PSCommandPath
+$ScriptDir = Split-Path -Parent $PSCommandPath
+$ProjectRoot = Split-Path -Parent $ScriptDir
+
+# Logging function
+function Log-Message {
+    param([string]$Message)
+    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
+    Write-Host "[$timestamp] ${ScriptName}: $Message" -ForegroundColor Cyan
+}
+
+# Error handling function
+function Exit-WithError {
+    param([string]$Message)
+    Write-Host "ERROR: $Message" -ForegroundColor Red
+    exit 1
+}
+
+# Sanitize feature name
+$BranchSafeName = $FeatureName.ToLower() -replace '[^a-z0-9-]', '-' -replace '--+', '-' -replace '^-|-$', ''
+
+if ([string]::IsNullOrEmpty($BranchSafeName)) {
+    Exit-WithError "Invalid feature name: '$FeatureName'"
+}
+
+# Get feature ID
+if ($CustomId) {
+    $FeatureId = "{0:D3}" -f [int]$CustomId
+} else {
+    $existingDirs = Get-ChildItem -Path "$ProjectRoot\specs" -Directory -Filter "[0-9]*" -ErrorAction SilentlyContinue
+    $nextId = if ($existingDirs) { $existingDirs.Count + 1 } else { 1 }
+    $FeatureId = "{0:D3}" -f $nextId
+}
+
+$BranchName = "$FeatureId-$BranchSafeName"
+
+# Create directories
+$SpecsDir = Join-Path $ProjectRoot "specs\$BranchName"
+$PlansDir = Join-Path $ProjectRoot "plans\$BranchName"
+$TasksDir = Join-Path $ProjectRoot "tasks\$BranchName"
+
+Log-Message "Creating feature directories for '$FeatureName'"
+
+try {
+    New-Item -ItemType Directory -Path $SpecsDir -Force | Out-Null
+    New-Item -ItemType Directory -Path $PlansDir -Force | Out-Null
+    New-Item -ItemType Directory -Path $TasksDir -Force | Out-Null
+} catch {
+    Exit-WithError "Failed to create directories: $_"
+}
+
+# Create initial files from templates
+$TemplateDir = Join-Path $ProjectRoot "templates"
+
+$specTemplate = Join-Path $TemplateDir "spec.md"
+$planTemplate = Join-Path $TemplateDir "plan.md"
+$taskTemplate = Join-Path $TemplateDir "task.md"
+
+if (-not (Test-Path $specTemplate)) {
+    Exit-WithError "Template not found: $specTemplate"
+}
+
+try {
+    Copy-Item -Path $specTemplate -Destination "$SpecsDir\spec-$FeatureId.md" -Force
+    Copy-Item -Path $planTemplate -Destination "$PlansDir\plan-$FeatureId.md" -Force
+    Copy-Item -Path $taskTemplate -Destination "$TasksDir\task-$FeatureId.md" -Force
+} catch {
+    Exit-WithError "Failed to copy templates: $_"
+}
+
+# Update context
+$ContextFile = Join-Path $ProjectRoot "memory\context.md"
+$memoryDir = Split-Path -Parent $ContextFile
+
+if (-not (Test-Path $memoryDir)) {
+    New-Item -ItemType Directory -Path $memoryDir -Force | Out-Null
+}
+
+$contextEntry = @"
+
+## Active Feature: $FeatureName
+- Feature ID: $FeatureId
+- Branch: $BranchName
+- Started: $(Get-Date -Format "yyyy-MM-ddTHH:mm:ss")
+"@
+
+try {
+    Add-Content -Path $ContextFile -Value $contextEntry
+} catch {
+    Exit-WithError "Failed to update context file: $_"
+}
+
+# Create git branch if in git repo
+$gitDir = Join-Path $ProjectRoot ".git"
+if (Test-Path $gitDir) {
+    Push-Location $ProjectRoot
+    try {
+        $branchExists = git rev-parse --verify $BranchName 2>$null
+        if ($LASTEXITCODE -eq 0) {
+            Log-Message "Git branch '$BranchName' already exists, checking out"
+            git checkout $BranchName | Out-Null
+        } else {
+            Log-Message "Creating new git branch '$BranchName'"
+            git checkout -b $BranchName | Out-Null
+        }
+    } catch {
+        Log-Message "Warning: Git operations failed: $_"
+    } finally {
+        Pop-Location
+    }
+}
+
+Log-Message "Successfully initialized feature '$FeatureName' with ID $FeatureId"
+
+# Output results
+Write-Output "BRANCH_NAME=$BranchName"
+Write-Output "SPEC_DIR=$SpecsDir"
+Write-Output "FEATURE_ID=$FeatureId"
+Write-Output "STATUS=initialized"

specpulse/resources/scripts/sp-pulse-plan.ps1

@@ -0,0 +1,143 @@
+# Generate implementation plan - PowerShell Version
+
+param(
+    [Parameter(Mandatory=$true, Position=0)]
+    [string]$FeatureDir
+)
+
+# Configuration
+$ScriptName = Split-Path -Leaf $PSCommandPath
+$ScriptDir = Split-Path -Parent $PSCommandPath
+$ProjectRoot = Split-Path -Parent $ScriptDir
+
+# Logging function
+function Log-Message {
+    param([string]$Message)
+    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
+    Write-Host "[$timestamp] ${ScriptName}: $Message" -ForegroundColor Cyan
+}
+
+# Error handling function
+function Exit-WithError {
+    param([string]$Message)
+    Write-Host "ERROR: $Message" -ForegroundColor Red
+    exit 1
+}
+
+# Extract feature ID
+$FeatureId = if ($FeatureDir -match '^(\d{3})') { $Matches[1] } else { "001" }
+
+# Sanitize feature directory
+$SanitizedDir = $FeatureDir -replace '[^a-zA-Z0-9_-]', ''
+
+if ([string]::IsNullOrEmpty($SanitizedDir)) {
+    Exit-WithError "Invalid feature directory: '$FeatureDir'"
+}
+
+$PlanDir = Join-Path $ProjectRoot "plans\$FeatureDir"
+$SpecDir = Join-Path $ProjectRoot "specs\$FeatureDir"
+$TemplateFile = Join-Path $ProjectRoot "templates\plan.md"
+
+# Ensure plans directory exists
+if (-not (Test-Path $PlanDir)) {
+    New-Item -ItemType Directory -Path $PlanDir -Force | Out-Null
+}
+
+# Find latest spec file
+if (Test-Path $SpecDir) {
+    $SpecFile = Get-ChildItem -Path $SpecDir -Filter "spec-*.md" -ErrorAction SilentlyContinue |
+                Sort-Object LastWriteTime -Descending |
+                Select-Object -First 1
+
+    if (-not $SpecFile) {
+        Exit-WithError "No specification files found in $SpecDir. Please create specification first."
+    }
+    $SpecFile = $SpecFile.FullName
+} else {
+    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 }
+$PlanFile = Join-Path $PlanDir ("plan-{0:D3}.md" -f $planNumber)
+
+# Ensure plan template exists
+if (-not (Test-Path $TemplateFile)) {
+    Exit-WithError "Template not found: $TemplateFile"
+}
+
+# Create plan
+Log-Message "Creating implementation plan from template: $PlanFile"
+try {
+    Copy-Item -Path $TemplateFile -Destination $PlanFile -Force
+} catch {
+    Exit-WithError "Failed to copy plan template: $_"
+}
+
+# Validate plan structure
+Log-Message "Validating implementation plan..."
+
+# Check for required sections
+$RequiredSections = @(
+    "## Implementation Plan:",
+    "## Specification Reference",
+    "## Phase -1: Pre-Implementation Gates",
+    "## Implementation Phases"
+)
+
+$content = Get-Content -Path $PlanFile -Raw
+$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 ', ')"
+}
+
+# Check Constitutional Gates
+Log-Message "Checking Constitutional Gates..."
+
+$ConstitutionalGates = @(
+    "Simplicity Gate",
+    "Anti-Abstraction Gate",
+    "Test-First Gate",
+    "Integration-First Gate",
+    "Research Gate"
+)
+
+foreach ($gate in $ConstitutionalGates) {
+    if ($content -notmatch [regex]::Escape($gate)) {
+        Log-Message "WARNING: Missing constitutional gate: $gate"
+    }
+}
+
+# Check if specification has clarifications needed
+$specContent = Get-Content -Path $SpecFile -Raw
+if ($specContent -match "NEEDS CLARIFICATION") {
+    $ClarificationCount = ([regex]::Matches($specContent, "NEEDS CLARIFICATION")).Count
+    Log-Message "WARNING: Specification has $ClarificationCount clarifications needed - resolve before proceeding"
+}
+
+# Validate gate compliance
+$GateStatus = "PENDING"
+if ($content -match "Gate Status:.*\[(.*?)\]") {
+    $GateStatus = $Matches[1]
+}
+
+if ($GateStatus -ne "COMPLETED") {
+    Log-Message "WARNING: Constitutional gates not completed. Status: $GateStatus"
+}
+
+Log-Message "Implementation plan processing completed successfully"
+
+# Output results
+Write-Output "PLAN_FILE=$PlanFile"
+Write-Output "SPEC_FILE=$SpecFile"
+Write-Output "MISSING_SECTIONS=$($MissingSections.Count)"
+Write-Output "CONSTITUTIONAL_GATES_STATUS=$GateStatus"
+Write-Output "STATUS=ready"

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

@@ -27,6 +27,9 @@ fi
 
 FEATURE_DIR="$1"
 
+# Extract feature ID from directory name (e.g., "001-feature-name" -> "001")
+FEATURE_ID=$(echo "$FEATURE_DIR" | grep -o '^[0-9]\{3\}' || echo "001")
+
 # Sanitize feature directory
 SANITIZED_DIR=$(echo "$FEATURE_DIR" | sed 's/[^a-zA-Z0-9_-]//g')
 
@@ -34,20 +37,6 @@ if [ -z "$SANITIZED_DIR" ]; then
     error_exit "Invalid feature directory: '$FEATURE_DIR'"
 fi
 
-# Find feature directory if not provided
-if [ -z "$FEATURE_DIR" ]; then
-    CONTEXT_FILE="$PROJECT_ROOT/memory/context.md"
-    if [ -f "$CONTEXT_FILE" ]; then
-        FEATURE_DIR=$(grep -A1 "Active Feature" "$CONTEXT_FILE" | tail -1 | cut -d: -f2 | xargs)
-        if [ -z "$FEATURE_DIR" ]; then
-            error_exit "No active feature found in context file"
-        fi
-        log "Using active feature from context: $FEATURE_DIR"
-    else
-        error_exit "No feature directory provided and no context file found"
-    fi
-fi
-
 PLAN_DIR="$PROJECT_ROOT/plans/${FEATURE_DIR}"
 SPEC_DIR="$PROJECT_ROOT/specs/${FEATURE_DIR}"
 TEMPLATE_FILE="$PROJECT_ROOT/templates/plan.md"

specpulse/resources/scripts/sp-pulse-spec.ps1

@@ -0,0 +1,126 @@
+# Generate or update specification - PowerShell Version
+
+param(
+    [Parameter(Mandatory=$true, Position=0)]
+    [string]$FeatureDir,
+
+    [Parameter(Mandatory=$false, Position=1)]
+    [string]$SpecContent
+)
+
+# Configuration
+$ScriptName = Split-Path -Leaf $PSCommandPath
+$ScriptDir = Split-Path -Parent $PSCommandPath
+$ProjectRoot = Split-Path -Parent $ScriptDir
+
+# Logging function
+function Log-Message {
+    param([string]$Message)
+    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
+    Write-Host "[$timestamp] ${ScriptName}: $Message" -ForegroundColor Cyan
+}
+
+# Error handling function
+function Exit-WithError {
+    param([string]$Message)
+    Write-Host "ERROR: $Message" -ForegroundColor Red
+    exit 1
+}
+
+# Extract feature ID from directory name
+$FeatureId = if ($FeatureDir -match '^(\d{3})') { $Matches[1] } else { "001" }
+
+# Sanitize feature directory
+$SanitizedDir = $FeatureDir -replace '[^a-zA-Z0-9_-]', ''
+
+if ([string]::IsNullOrEmpty($SanitizedDir)) {
+    Exit-WithError "Invalid feature directory: '$FeatureDir'"
+}
+
+$SpecDir = Join-Path $ProjectRoot "specs\$FeatureDir"
+$TemplateFile = Join-Path $ProjectRoot "templates\spec.md"
+
+# Ensure specs directory exists
+if (-not (Test-Path $SpecDir)) {
+    New-Item -ItemType Directory -Path $SpecDir -Force | Out-Null
+}
+
+# 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 }
+    $SpecFile = Join-Path $SpecDir ("spec-{0:D3}.md" -f $specNumber)
+
+    # Update specification with provided content
+    Log-Message "Creating specification: $SpecFile"
+    try {
+        Set-Content -Path $SpecFile -Value $SpecContent
+    } catch {
+        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: $_"
+        }
+    }
+}
+
+# Validate specification
+Log-Message "Validating specification..."
+if (-not (Test-Path $SpecFile)) {
+    Exit-WithError "Specification file does not exist: $SpecFile"
+}
+
+# Check for required sections
+$RequiredSections = @(
+    "## Specification:",
+    "## Metadata",
+    "## Functional Requirements",
+    "## Acceptance Scenarios"
+)
+
+$content = Get-Content -Path $SpecFile -Raw
+$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 ', ')"
+}
+
+# Check for clarifications needed
+$ClarificationCount = 0
+if ($content -match "NEEDS CLARIFICATION") {
+    $ClarificationCount = ([regex]::Matches($content, "NEEDS CLARIFICATION")).Count
+    Log-Message "WARNING: Specification has $ClarificationCount clarifications needed"
+}
+
+Log-Message "Specification processing completed successfully"
+
+# Output results
+Write-Output "SPEC_FILE=$SpecFile"
+Write-Output "CLARIFICATIONS_NEEDED=$ClarificationCount"
+Write-Output "MISSING_SECTIONS=$($MissingSections.Count)"
+Write-Output "STATUS=updated"

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

@@ -28,6 +28,9 @@ fi
 FEATURE_DIR="$1"
 SPEC_CONTENT="${2:-}"
 
+# Extract feature ID from directory name (e.g., "001-feature-name" -> "001")
+FEATURE_ID=$(echo "$FEATURE_DIR" | grep -o '^[0-9]\{3\}' || echo "001")
+
 # Sanitize feature directory
 SANITIZED_DIR=$(echo "$FEATURE_DIR" | sed 's/[^a-zA-Z0-9_-]//g')
 
@@ -35,20 +38,6 @@ if [ -z "$SANITIZED_DIR" ]; then
     error_exit "Invalid feature directory: '$FEATURE_DIR'"
 fi
 
-# Find feature directory if not provided
-if [ -z "$FEATURE_DIR" ]; then
-    CONTEXT_FILE="$PROJECT_ROOT/memory/context.md"
-    if [ -f "$CONTEXT_FILE" ]; then
-        FEATURE_DIR=$(grep -A1 "Active Feature" "$CONTEXT_FILE" | tail -1 | cut -d: -f2 | xargs)
-        if [ -z "$FEATURE_DIR" ]; then
-            error_exit "No active feature found in context file"
-        fi
-        log "Using active feature from context: $FEATURE_DIR"
-    else
-        error_exit "No feature directory provided and no context file found"
-    fi
-fi
-
 SPEC_DIR="$PROJECT_ROOT/specs/${FEATURE_DIR}"
 TEMPLATE_FILE="$PROJECT_ROOT/templates/spec.md"
 

specpulse/resources/scripts/sp-pulse-task.ps1

@@ -0,0 +1,166 @@
+# Generate task breakdown - PowerShell Version
+
+param(
+    [Parameter(Mandatory=$true, Position=0)]
+    [string]$FeatureDir
+)
+
+# Configuration
+$ScriptName = Split-Path -Leaf $PSCommandPath
+$ScriptDir = Split-Path -Parent $PSCommandPath
+$ProjectRoot = Split-Path -Parent $ScriptDir
+
+# Logging function
+function Log-Message {
+    param([string]$Message)
+    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
+    Write-Host "[$timestamp] ${ScriptName}: $Message" -ForegroundColor Cyan
+}
+
+# Error handling function
+function Exit-WithError {
+    param([string]$Message)
+    Write-Host "ERROR: $Message" -ForegroundColor Red
+    exit 1
+}
+
+# Extract feature ID
+$FeatureId = if ($FeatureDir -match '^(\d{3})') { $Matches[1] } else { "001" }
+
+# Sanitize feature directory
+$SanitizedDir = $FeatureDir -replace '[^a-zA-Z0-9_-]', ''
+
+if ([string]::IsNullOrEmpty($SanitizedDir)) {
+    Exit-WithError "Invalid feature directory: '$FeatureDir'"
+}
+
+$TaskDir = Join-Path $ProjectRoot "tasks\$FeatureDir"
+$PlanDir = Join-Path $ProjectRoot "plans\$FeatureDir"
+$SpecDir = Join-Path $ProjectRoot "specs\$FeatureDir"
+$TemplateFile = Join-Path $ProjectRoot "templates\task.md"
+
+# Ensure tasks directory exists
+if (-not (Test-Path $TaskDir)) {
+    New-Item -ItemType Directory -Path $TaskDir -Force | Out-Null
+}
+
+# Find latest spec file
+if (Test-Path $SpecDir) {
+    $SpecFile = Get-ChildItem -Path $SpecDir -Filter "spec-*.md" -ErrorAction SilentlyContinue |
+                Sort-Object LastWriteTime -Descending |
+                Select-Object -First 1
+
+    if (-not $SpecFile) {
+        Exit-WithError "No specification files found in $SpecDir. Please create specification first."
+    }
+    $SpecFile = $SpecFile.FullName
+} else {
+    Exit-WithError "Specifications directory not found: $SpecDir. Please create specification first."
+}
+
+# Find latest plan file
+if (Test-Path $PlanDir) {
+    $PlanFile = Get-ChildItem -Path $PlanDir -Filter "plan-*.md" -ErrorAction SilentlyContinue |
+                Sort-Object LastWriteTime -Descending |
+                Select-Object -First 1
+
+    if (-not $PlanFile) {
+        Exit-WithError "No plan files found in $PlanDir. Please create plan first."
+    }
+    $PlanFile = $PlanFile.FullName
+} else {
+    Exit-WithError "Plans directory not found: $PlanDir. Please create plan first."
+}
+
+# Find next available task number or create new one
+$existingTasks = Get-ChildItem -Path $TaskDir -Filter "task-*.md" -ErrorAction SilentlyContinue
+$taskNumber = if ($existingTasks) { $existingTasks.Count + 1 } else { 1 }
+$TaskFile = Join-Path $TaskDir ("task-{0:D3}.md" -f $taskNumber)
+
+# Ensure task template exists
+if (-not (Test-Path $TemplateFile)) {
+    Exit-WithError "Template not found: $TemplateFile"
+}
+
+# Create task file
+Log-Message "Creating task breakdown from template: $TaskFile"
+try {
+    Copy-Item -Path $TemplateFile -Destination $TaskFile -Force
+} catch {
+    Exit-WithError "Failed to copy task template: $_"
+}
+
+# Validate task structure
+Log-Message "Validating task breakdown..."
+
+# Check for required sections
+$RequiredSections = @(
+    "## Task List:",
+    "## Task Organization",
+    "## Critical Path",
+    "## Execution Schedule"
+)
+
+$content = Get-Content -Path $TaskFile -Raw
+$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 ', ')"
+}
+
+# Count tasks and analyze structure
+$TotalTasks = ([regex]::Matches($content, "^- \[.\]", [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+$CompletedTasks = ([regex]::Matches($content, "^- \[x\]", [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+$PendingTasks = ([regex]::Matches($content, "^- \[ \]", [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+$BlockedTasks = ([regex]::Matches($content, "^- \[!\]", [System.Text.RegularExpressions.RegexOptions]::Multiline)).Count
+
+# Check for parallel tasks
+$ParallelTasks = ([regex]::Matches($content, "\[P\]")).Count
+
+# Check constitutional gates compliance
+$GatesCount = 0
+if ($content -match "Constitutional Gates Compliance") {
+    $gatesSection = $content.Substring($content.IndexOf("Constitutional Gates Compliance"))
+    if ($gatesSection.Length -gt 0) {
+        $GatesCount = ([regex]::Matches($gatesSection.Substring(0, [Math]::Min(1000, $gatesSection.Length)), "\[ \]")).Count
+    }
+}
+
+# Check if plan has constitutional gates completed
+$planContent = Get-Content -Path $PlanFile -Raw
+$PlanGateStatus = "PENDING"
+if ($planContent -match "Gate Status:.*\[(.*?)\]") {
+    $PlanGateStatus = $Matches[1]
+}
+
+if ($PlanGateStatus -ne "COMPLETED") {
+    Log-Message "WARNING: Implementation plan constitutional gates not completed. Task generation may be premature."
+}
+
+# Calculate completion percentage
+$CompletionPercentage = 0
+if ($TotalTasks -gt 0) {
+    $CompletionPercentage = [math]::Round(($CompletedTasks * 100) / $TotalTasks)
+}
+
+Log-Message "Task analysis completed - Total: $TotalTasks, Completed: $CompletedTasks ($CompletionPercentage%), Parallel: $ParallelTasks"
+
+# Output comprehensive status
+Write-Output "TASK_FILE=$TaskFile"
+Write-Output "SPEC_FILE=$SpecFile"
+Write-Output "PLAN_FILE=$PlanFile"
+Write-Output "TOTAL_TASKS=$TotalTasks"
+Write-Output "COMPLETED_TASKS=$CompletedTasks"
+Write-Output "PENDING_TASKS=$PendingTasks"
+Write-Output "BLOCKED_TASKS=$BlockedTasks"
+Write-Output "PARALLEL_TASKS=$ParallelTasks"
+Write-Output "CONSTITUTIONAL_GATES_PENDING=$GatesCount"
+Write-Output "COMPLETION_PERCENTAGE=$CompletionPercentage"
+Write-Output "MISSING_SECTIONS=$($MissingSections.Count)"
+Write-Output "STATUS=generated"

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

@@ -27,6 +27,9 @@ fi
 
 FEATURE_DIR="$1"
 
+# Extract feature ID from directory name (e.g., "001-feature-name" -> "001")
+FEATURE_ID=$(echo "$FEATURE_DIR" | grep -o '^[0-9]\{3\}' || echo "001")
+
 # Sanitize feature directory
 SANITIZED_DIR=$(echo "$FEATURE_DIR" | sed 's/[^a-zA-Z0-9_-]//g')
 
@@ -34,20 +37,6 @@ if [ -z "$SANITIZED_DIR" ]; then
     error_exit "Invalid feature directory: '$FEATURE_DIR'"
 fi
 
-# Find feature directory if not provided
-if [ -z "$FEATURE_DIR" ]; then
-    CONTEXT_FILE="$PROJECT_ROOT/memory/context.md"
-    if [ -f "$CONTEXT_FILE" ]; then
-        FEATURE_DIR=$(grep -A1 "Active Feature" "$CONTEXT_FILE" | tail -1 | cut -d: -f2 | xargs)
-        if [ -z "$FEATURE_DIR" ]; then
-            error_exit "No active feature found in context file"
-        fi
-        log "Using active feature from context: $FEATURE_DIR"
-    else
-        error_exit "No feature directory provided and no context file found"
-    fi
-fi
-
 TASK_DIR="$PROJECT_ROOT/tasks/${FEATURE_DIR}"
 PLAN_DIR="$PROJECT_ROOT/plans/${FEATURE_DIR}"
 SPEC_DIR="$PROJECT_ROOT/specs/${FEATURE_DIR}"
@@ -132,10 +121,9 @@ if [ "$PLAN_GATE_STATUS" != "COMPLETED" ]; then
 fi
 
 # Calculate completion percentage
-if [ "$TOTAL_TASKS" -gt 0 ]; then
-    COMPLETION_PERCENTAGE=$((COMPLETED_TASKS * 100 / TOTAL_TASKS))
-else
-    COMPLETION_PERCENTAGE=0
+COMPLETION_PERCENTAGE=0
+if [ "${TOTAL_TASKS:-0}" -gt 0 ] && [ "${COMPLETED_TASKS:-0}" -ge 0 ]; then
+    COMPLETION_PERCENTAGE=$(( (COMPLETED_TASKS * 100) / TOTAL_TASKS ))
 fi
 
 log "Task analysis completed - Total: $TOTAL_TASKS, Completed: $COMPLETED_TASKS ($COMPLETION_PERCENTAGE%), Parallel: $PARALLEL_TASKS"

specpulse/utils/version_check.py

@@ -0,0 +1,128 @@
+"""
+Version checking utility for SpecPulse
+"""
+
+import json
+import urllib.request
+import urllib.error
+from typing import Optional, Tuple
+from packaging import version
+import socket
+
+
+def check_pypi_version(package_name: str = "specpulse", timeout: int = 2) -> Optional[str]:
+    """
+    Check the latest version of a package on PyPI
+
+    Args:
+        package_name: Name of the package to check
+        timeout: Timeout in seconds for the request
+
+    Returns:
+        Latest version string or None if check fails
+    """
+    try:
+        # Set a short timeout to avoid blocking
+        socket.setdefaulttimeout(timeout)
+
+        url = f"https://pypi.org/pypi/{package_name}/json"
+        with urllib.request.urlopen(url) as response:
+            data = json.loads(response.read())
+            return data["info"]["version"]
+    except (urllib.error.URLError, urllib.error.HTTPError, json.JSONDecodeError, KeyError, socket.timeout):
+        # Silently fail - don't interrupt user workflow
+        return None
+    finally:
+        # Reset default timeout
+        socket.setdefaulttimeout(None)
+
+
+def compare_versions(current: str, latest: str) -> Tuple[bool, bool]:
+    """
+    Compare current version with latest version
+
+    Args:
+        current: Current installed version
+        latest: Latest available version
+
+    Returns:
+        Tuple of (is_outdated, is_major_update)
+    """
+    try:
+        current_v = version.parse(current)
+        latest_v = version.parse(latest)
+
+        is_outdated = current_v < latest_v
+
+        # Check if it's a major version update
+        is_major = False
+        if is_outdated:
+            # Major version changed
+            if latest_v.major > current_v.major:
+                is_major = True
+
+        return is_outdated, is_major
+    except:
+        return False, False
+
+
+def get_update_message(current: str, latest: str, is_major: bool) -> str:
+    """
+    Generate update notification message
+
+    Args:
+        current: Current version
+        latest: Latest version
+        is_major: Whether this is a major update
+
+    Returns:
+        Formatted update message
+    """
+    if is_major:
+        urgency = "[!] MAJOR"
+        color = "bright_red"
+    else:
+        urgency = "[i]"
+        color = "yellow"
+
+    message = f"""
+{urgency} Update Available!
+Current: v{current}
+Latest:  v{latest}
+
+Update with: pip install --upgrade specpulse
+"""
+
+    return message, color
+
+
+def should_check_version() -> bool:
+    """
+    Determine if we should check for updates
+
+    Returns:
+        True if we should check, False otherwise
+    """
+    import os
+    from pathlib import Path
+    from datetime import datetime, timedelta
+
+    try:
+        # Check once per day maximum
+        cache_file = Path.home() / ".specpulse" / "last_version_check"
+
+        if cache_file.exists():
+            # Check if last check was within 24 hours
+            last_check = datetime.fromtimestamp(cache_file.stat().st_mtime)
+            if datetime.now() - last_check < timedelta(hours=24):
+                return False
+
+        # Create cache directory if needed
+        cache_file.parent.mkdir(parents=True, exist_ok=True)
+
+        # Update timestamp
+        cache_file.touch()
+        return True
+    except:
+        # If anything fails, don't check
+        return False

{specpulse-1.3.2.dist-info → specpulse-1.3.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specpulse
-Version: 1.3.2
+Version: 1.3.4
 Summary: Specification-Driven Development Framework
 Home-page: https://github.com/specpulse
 Author: SpecPulse
@@ -32,6 +32,7 @@ Requires-Dist: rich>=13.0
 Requires-Dist: jinja2>=3.0
 Requires-Dist: gitpython>=3.1
 Requires-Dist: toml>=0.10
+Requires-Dist: packaging>=21.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0; extra == "dev"
@@ -66,13 +67,14 @@ Dynamic: requires-python
 
 SpecPulse revolutionizes AI-assisted development by enforcing a **specification-first approach**. Instead of jumping straight into code, SpecPulse ensures every feature starts with clear specifications, validated plans, and tracked tasks - guaranteeing quality from day one.
 
-> **Latest Update (v1.3.0)**:
-> - 🚀 **Continuous Task Execution**: New `/sp-execute` command for non-stop task completion
-> - ⚡ **Flow State Development**: Execute all tasks without interruptions
-> - 🔄 **Smart Task Progression**: Automatic advancement through task lists
-> - 🎯 **Batch Processing**: Complete entire features in one command
-> - **Previous (v1.2.0)**: Microservice decomposition, service-based planning, smart workflow detection
-> - **Previous (v1.1.0)**: Command prefix system, multi-spec workflow, versioned files
+> **Latest Update (v1.3.4)**:
+> - 🧪 **89% Test Coverage**: Comprehensive test suite with 450+ tests
+> - 🔍 **Version Update Checking**: Automatic PyPI version checking with 24-hour caching
+> - 💪 **PowerShell Support**: Full Windows PowerShell script support alongside Bash
+> - 🛠️ **Enhanced Stability**: Critical path fixes and improved error handling
+> - **Previous (v1.3.0)**: Continuous task execution with `/sp-execute` command
+> - **Previous (v1.2.0)**: Microservice decomposition, service-based planning
+> - **Previous (v1.1.0)**: Command prefix system, multi-spec workflow
 
 ### Why SpecPulse?
 

{specpulse-1.3.2.dist-info → specpulse-1.3.4.dist-info}/RECORD

@@ -1,8 +1,8 @@
-specpulse/__init__.py,sha256=g_B-PLlQJTQfZFEW4aHlWd_Bvt3ZTqvzjNnFFDR2xOI,270
+specpulse/__init__.py,sha256=kYgVcf5KKzNWm3EZCK0jY8hX5ygDK6-KJBe3GTPWraI,270
 specpulse/cli/__init__.py,sha256=DpX6FoRJtSNjudsmZ3mTih_RIaWyiIgxew4-f8mOmFY,70
-specpulse/cli/main.py,sha256=K1kQ5KotsU54kvXYen2fOWGmIM--feQa3bmnEzmRT3k,32831
+specpulse/cli/main.py,sha256=8kiDlmVLe42AjUAaBKfzxSFJqZsk0gddYGGD-gUzs2s,34363
 specpulse/core/__init__.py,sha256=VKHGdPDM38QM9yDIq05jxol4q8WFlFAeltOzYLsPuto,132
-specpulse/core/specpulse.py,sha256=glEYB-AiXN6wTKgVc3Yu0BHjUMByNBzcjMds7CA-FBo,32717
+specpulse/core/specpulse.py,sha256=uj6ESZdoEC6ngPg1bCGtoOSnX6pjn6de3VeGrJBX65M,32709
 specpulse/core/validator.py,sha256=VsXU0qD8uUbZS3a8umqKpUx__sNlVRqTA7YTek9lezQ,18669
 specpulse/resources/commands/claude/sp-continue.md,sha256=3_vikDSNRN0slNtKQGWl9dWEgkT-Q7nFpUxHKnzBCKs,5175
 specpulse/resources/commands/claude/sp-decompose.md,sha256=REVLx6Nua4N0xPju6ArNswzK7ZD1N776XUhVzo31K0Y,8088
@@ -25,10 +25,14 @@ specpulse/resources/memory/context.md,sha256=B-6m5f4WP8x_VXp0S9fbqm8tHH-2PZ7d9VW
 specpulse/resources/memory/decisions.md,sha256=ZwzVyOPB2mIzwveWpGmedej7ncI81GALg8WVy6AeZA4,686
 specpulse/resources/scripts/sp-pulse-decompose.sh,sha256=EN8iF02pij4yse3of3fgO8ZI6YKFUV7Z7f4epEmaKXI,1431
 specpulse/resources/scripts/sp-pulse-execute.sh,sha256=696vgsj0NpV-Mr0KMyoJ63NkTqmS1tmQ1X4BzK0kQGA,5493
+specpulse/resources/scripts/sp-pulse-init.ps1,sha256=VXmLRg4d9xwy2Lbhrv3h7L_RJ0c-eido8zRyvNaeqx0,4058
 specpulse/resources/scripts/sp-pulse-init.sh,sha256=ECqLvgt6H-Wtp1hpKhkCKv_k70ZVfkmb13YyxT8Ni2M,3285
-specpulse/resources/scripts/sp-pulse-plan.sh,sha256=yJhAKa8Ay_76nvFOrGnAzqPhZWvCWuFCI04b5B1k2LI,4302
-specpulse/resources/scripts/sp-pulse-spec.sh,sha256=F8UFjx94h38WGCfMPhRV4vtJxMhU3VEllQmbP6Jk9Zk,4297
-specpulse/resources/scripts/sp-pulse-task.sh,sha256=SzimpHA4iIX0FrUZXavUl-b9AmXnTvXl6jreq0mCb4A,5144
+specpulse/resources/scripts/sp-pulse-plan.ps1,sha256=aEpZeYDSBeb8D86gv2U2V22wPzX54CBw8id_hFPf1GU,4456
+specpulse/resources/scripts/sp-pulse-plan.sh,sha256=KHSpm3K1qyryBaiz693ytHZU61YDRLN85Ew063KFOYQ,3911
+specpulse/resources/scripts/sp-pulse-spec.ps1,sha256=u71r-wfGB8f7RJCuENufCJLlSuXlWcnUHYiSpjrPEQ4,4075
+specpulse/resources/scripts/sp-pulse-spec.sh,sha256=1QBHkJKpopH2Vn8fIGYSMuuiqMrtu3F1WZCyk5liN-Y,3906
+specpulse/resources/scripts/sp-pulse-task.ps1,sha256=F7D6j896Cq1SlED5L2AOB_P0zu1Qda7MwUenhXWffeg,5895
+specpulse/resources/scripts/sp-pulse-task.sh,sha256=E-2ld9TX4ipybtCEDH6rmcpcK_VOw3qoymBiVB51BiM,4801
 specpulse/resources/templates/plan.md,sha256=KSCB5HvYRjqrM-VTe7nwJgR1MjGI748YE2BJtn41g4Q,6689
 specpulse/resources/templates/spec.md,sha256=yVWn2LhZn0IMLJ9XuBjPWSWNS4GYJFowRrqRMT2wJf4,3748
 specpulse/resources/templates/task.md,sha256=mGRlE4WD2E1Lh5gGr7kyOEmoXDbjLhUVMG9D7ZGCpmw,5357
@@ -40,9 +44,10 @@ specpulse/resources/templates/decomposition/service-plan.md,sha256=YCAu0-jRKNQ-G
 specpulse/utils/__init__.py,sha256=VTGRDsVLl2JIXYyHB9Sidxj5acY_W-LJI2MMtY1pwb0,122
 specpulse/utils/console.py,sha256=xn4Koc1_ph61bvBTlvPOwAbqZ5ac7TZ51xTWJbwG0sc,12973
 specpulse/utils/git_utils.py,sha256=RzJBZoyWp5on1_wq2lY1bs__UJsGKSDpAUeDKFdRYlQ,6095
-specpulse-1.3.2.dist-info/licenses/LICENSE,sha256=ImSFezK-Phy0oTBqZipcajsJfPZT8mmg8m3jkgNdNhA,1066
-specpulse-1.3.2.dist-info/METADATA,sha256=nNoy4_h7HMxM2IWzmPsELyiYS2Jl9KVGxGta85DKV5I,21109
-specpulse-1.3.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-specpulse-1.3.2.dist-info/entry_points.txt,sha256=GwMaCKWSCFZlJMrTNavEYrnREynIS6dM3B0ILxnaouA,83
-specpulse-1.3.2.dist-info/top_level.txt,sha256=pEfkFil5xe38J00OHrBrJ07xpbm6bRnGhI8B07O9KeI,10
-specpulse-1.3.2.dist-info/RECORD,,
+specpulse/utils/version_check.py,sha256=Cg30K0BRq_y8B9v62aJbtIuBDmPnHcwHTim7HZnoGZc,3424
+specpulse-1.3.4.dist-info/licenses/LICENSE,sha256=ImSFezK-Phy0oTBqZipcajsJfPZT8mmg8m3jkgNdNhA,1066
+specpulse-1.3.4.dist-info/METADATA,sha256=FDdf5raQvOXwA9xWRK3QYLK8bGQtvhZStx91EnDvceY,21194
+specpulse-1.3.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+specpulse-1.3.4.dist-info/entry_points.txt,sha256=GwMaCKWSCFZlJMrTNavEYrnREynIS6dM3B0ILxnaouA,83
+specpulse-1.3.4.dist-info/top_level.txt,sha256=pEfkFil5xe38J00OHrBrJ07xpbm6bRnGhI8B07O9KeI,10
+specpulse-1.3.4.dist-info/RECORD,,