specpulse 1.2.1__py3-none-any.whl → 1.2.3__py3-none-any.whl

specpulse/__init__.py

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

specpulse/cli/main.py

@@ -31,6 +31,13 @@ class SpecPulseCLI:
              template: str = "web"):
         """Initialize SpecPulse in an existing or new project"""
         
+        # Validate project name for invalid characters
+        import re
+        if project_name and not here:
+            if not re.match(r'^[a-zA-Z0-9_-]+$', project_name):
+                self.console.error(f"Project name contains invalid characters: {project_name}")
+                return False
+        
         if here:
             project_path = Path.cwd()
             project_name = project_path.name
@@ -620,6 +627,13 @@ graph LR
         project_path = Path.cwd()
         sync_items = []
         
+        # Create missing directories if they don't exist
+        for dir_name in ["specs", "plans", "tasks", "memory", "templates", "scripts"]:
+            dir_path = project_path / dir_name
+            if not dir_path.exists():
+                dir_path.mkdir(parents=True, exist_ok=True)
+                sync_items.append((dir_name, "Created"))
+        
         self.console.spinner("Synchronizing project state")
         import time
         
@@ -657,6 +671,29 @@ graph LR
         
         return True
     
+    def list_specs(self):
+        """List all specifications in the project"""
+        specs_dir = Path("specs")
+        if not specs_dir.exists():
+            self.console.warning("No specs directory found")
+            return []
+        
+        spec_files = []
+        for feature_dir in specs_dir.iterdir():
+            if feature_dir.is_dir():
+                for spec_file in feature_dir.glob("spec-*.md"):
+                    spec_files.append(spec_file)
+        
+        if not spec_files:
+            self.console.warning("No specifications found")
+            return []
+        
+        self.console.info(f"Found {len(spec_files)} specifications")
+        for spec_file in spec_files:
+            self.console.info(f"  - {spec_file.relative_to(specs_dir)}")
+        
+        return spec_files
+    
     def doctor(self):
         """System check and diagnostics"""
         self.console.show_banner(mini=True)

specpulse/core/validator.py

@@ -11,8 +11,13 @@ import re
 class Validator:
     """Validates SpecPulse project components"""
     
-    def __init__(self):
+    def __init__(self, project_root: Optional[Path] = None):
         self.results = []
+        self.constitution = None
+        self.phase_gates = []
+        
+        if project_root:
+            self._load_constitution(project_root)
     
     def validate_all(self, project_path: Path, fix: bool = False, verbose: bool = False) -> List[Dict]:
         """Validate entire project"""
@@ -329,4 +334,172 @@ class Validator:
                 self.results.append({
                     "status": "warning",
                     "message": "Constitution enforcement disabled"
-                })
+                })
+    
+    def _load_constitution(self, project_root: Path):
+        """Load constitution from project"""
+        constitution_path = project_root / "memory" / "constitution.md"
+        if constitution_path.exists():
+            self.constitution = constitution_path.read_text()
+            # Extract phase gates from constitution
+            self._extract_phase_gates()
+    
+    def _extract_phase_gates(self):
+        """Extract phase gates from constitution"""
+        if not self.constitution:
+            return
+        
+        # Simple extraction of phase gates from constitution text
+        gates = []
+        lines = self.constitution.split('\n')
+        for line in lines:
+            if 'Phase Gate' in line or 'phase gate' in line:
+                gates.append(line.strip())
+        self.phase_gates = gates
+    
+    def load_constitution(self, project_root: Path) -> bool:
+        """Load constitution from a project"""
+        self._load_constitution(project_root)
+        return self.constitution is not None
+    
+    def validate_spec(self, spec_path: Path, verbose: bool = False) -> Dict:
+        """Validate a single specification file"""
+        if not spec_path.exists():
+            return {"status": "error", "message": f"Spec file not found: {spec_path}"}
+        
+        content = spec_path.read_text()
+        result = {"status": "valid", "issues": []}
+        
+        # Check required sections
+        required_sections = ["## Requirements", "## User Stories", "## Acceptance Criteria"]
+        for section in required_sections:
+            if section not in content:
+                result["issues"].append(f"Missing section: {section}")
+        
+        if result["issues"]:
+            result["status"] = "invalid"
+        
+        return result
+    
+    def validate_plan(self, plan_path: Path, verbose: bool = False) -> Dict:
+        """Validate a single plan file"""
+        if not plan_path.exists():
+            return {"status": "error", "message": f"Plan file not found: {plan_path}"}
+        
+        content = plan_path.read_text()
+        result = {"status": "valid", "issues": []}
+        
+        # Check required sections
+        required_sections = ["## Architecture", "## Phases", "## Technology Stack"]
+        for section in required_sections:
+            if section not in content:
+                result["issues"].append(f"Missing section: {section}")
+        
+        if result["issues"]:
+            result["status"] = "invalid"
+        
+        return result
+    
+    def validate_task(self, task_path: Path, verbose: bool = False) -> Dict:
+        """Validate a single task file"""
+        if not task_path.exists():
+            return {"status": "error", "message": f"Task file not found: {task_path}"}
+        
+        content = task_path.read_text()
+        result = {"status": "valid", "issues": []}
+        
+        # Check for task format
+        if not re.search(r'T\d{3}', content):
+            result["issues"].append("No task IDs found (T001 format)")
+        
+        if result["issues"]:
+            result["status"] = "invalid"
+        
+        return result
+    
+    def validate_constitution_compliance(self, spec_content: str, verbose: bool = False) -> Dict:
+        """Validate that content complies with constitution"""
+        result = {"status": "compliant", "violations": []}
+        
+        if not self.constitution:
+            return result
+        
+        # Check for simplicity principle
+        if 'complexity' in spec_content.lower() and 'simple' not in spec_content.lower():
+            result["violations"].append("Simplicity principle: Complex solution without justification")
+        
+        if result["violations"]:
+            result["status"] = "non-compliant"
+        
+        return result
+    
+    def check_phase_gate(self, gate_name: str, context: Dict) -> bool:
+        """Check if a phase gate passes"""
+        # Simple gate checking logic
+        if gate_name == "simplicity":
+            return context.get("module_count", 0) <= 3
+        elif gate_name == "test-first":
+            return context.get("tests_written", False)
+        return True
+    
+    def validate_all_project(self, project_root: Path, verbose: bool = False) -> Dict:
+        """Validate entire project"""
+        results = {
+            "specs": [],
+            "plans": [],
+            "tasks": [],
+            "constitution_compliance": True
+        }
+        
+        # Validate specs
+        specs_dir = project_root / "specs"
+        if specs_dir.exists():
+            for spec_file in specs_dir.glob("*/spec*.md"):
+                results["specs"].append(self.validate_spec(spec_file, verbose))
+        
+        # Validate plans
+        plans_dir = project_root / "plans"
+        if plans_dir.exists():
+            for plan_file in plans_dir.glob("*/plan*.md"):
+                results["plans"].append(self.validate_plan(plan_file, verbose))
+        
+        # Validate tasks
+        tasks_dir = project_root / "tasks"
+        if tasks_dir.exists():
+            for task_file in tasks_dir.glob("*/task*.md"):
+                results["tasks"].append(self.validate_task(task_file, verbose))
+        
+        return results
+    
+    def format_validation_report(self, results: Dict) -> str:
+        """Format validation results as a report"""
+        report = "# Validation Report\n\n"
+        
+        # Specs section
+        report += "## Specifications\n"
+        for spec in results.get("specs", []):
+            status = spec.get("status", "unknown")
+            report += f"- Status: {status}\n"
+            if spec.get("issues"):
+                for issue in spec["issues"]:
+                    report += f"  - Issue: {issue}\n"
+        
+        # Plans section
+        report += "\n## Plans\n"
+        for plan in results.get("plans", []):
+            status = plan.get("status", "unknown")
+            report += f"- Status: {status}\n"
+            if plan.get("issues"):
+                for issue in plan["issues"]:
+                    report += f"  - Issue: {issue}\n"
+        
+        # Tasks section
+        report += "\n## Tasks\n"
+        for task in results.get("tasks", []):
+            status = task.get("status", "unknown")
+            report += f"- Status: {status}\n"
+            if task.get("issues"):
+                for issue in task["issues"]:
+                    report += f"  - Issue: {issue}\n"
+        
+        return report

specpulse/resources/commands/claude/sp-decompose.md

@@ -112,7 +112,7 @@ When called with `/sp-decompose $ARGUMENTS`, I will:
    - Create feature-specific plan template with services
    - Prepare for `/sp-plan generate` with service context
    - Enable `/sp-task breakdown` per service
-   - Run validation: `python scripts/sp-pulse-decompose.py validate`
+   - Run validation: `bash scripts/sp-pulse-decompose.sh validate`
 
 ## Examples
 

specpulse/resources/commands/claude/sp-plan.md

@@ -47,14 +47,9 @@ When called with `/sp-plan $ARGUMENTS`, I will:
       - Generate single monolithic plan
    d. **Find and validate specification** from selected spec file
    
-   d. **Enhanced validation** using cross-platform script:
+   d. **Validation** using script:
       ```bash
-      # Cross-platform detection
-      if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
-          python scripts/sp-pulse-plan.py "$FEATURE_DIR"
-      else
-          bash scripts/sp-pulse-plan.sh "$FEATURE_DIR" || python scripts/sp-pulse-plan.py "$FEATURE_DIR"
-      fi
+      bash scripts/sp-pulse-plan.sh "$FEATURE_DIR"
       ```
 
    e. **Run Constitutional Phase Gates** (Article VII):
@@ -102,14 +97,9 @@ When called with `/sp-plan $ARGUMENTS`, I will:
 4. **For `/sp-plan validate`:**
    a. **Show existing plan files**: List all plan-XXX.md files in current feature directory
    b. **Ask user to select**: Which plan file to validate
-   c. **Enhanced validation** using cross-platform script:
+   c. **Validation** using script:
      ```bash
-     # Cross-platform detection
-     if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
-         python scripts/sp-pulse-plan.py "$FEATURE_DIR"
-     else
-         bash scripts/sp-pulse-plan.sh "$FEATURE_DIR" || python scripts/sp-pulse-plan.py "$FEATURE_DIR"
-     fi
+     bash scripts/sp-pulse-plan.sh "$FEATURE_DIR"
      ```
    d. Verify all constitutional gates are addressed
    e. Check complexity exceptions have proper justifications
@@ -202,14 +192,13 @@ I will analyze and recommend complexity reductions.
 ## Enhanced Features
 
 - **AI-optimized templates** with Jinja2-style variables
-- **Cross-platform script execution** with automatic detection
-- **Enhanced script integration** for Bash and Python
+- **Script execution** with Bash
 - **Constitutional compliance tracking** with gate status
 - **Complexity exception management** with justifications
 - **Performance and security considerations** integrated
 - **Integration-first approach** with real service usage
 - **Detailed validation reporting** with specific recommendations
-- **Platform-agnostic operation** for any development environment
+- **Cross-platform operation** with Bash
 
 ## Error Handling
 

specpulse/resources/commands/claude/sp-pulse.md

@@ -23,9 +23,8 @@ Initialize a new feature following SpecPulse methodology with constitutional com
 When called with `/sp-pulse $ARGUMENTS`, I will:
 
 1. **Validate arguments** and extract feature name + optional ID
-2. **Run initialization script** with cross-platform detection:
-   - **Linux/macOS**: `bash scripts/sp-pulse-init.sh "$FEATURE_NAME" "$OPTIONAL_ID"`
-   - **Python Fallback**: `python scripts/sp-pulse-init.py "$FEATURE_NAME" "$OPTIONAL_ID"`
+2. **Run initialization script**:
+   - `bash scripts/sp-pulse-init.sh "$FEATURE_NAME" "$OPTIONAL_ID"`
 3. **Create complete feature structure**:
    - Generate feature ID (001, 002, etc.) or use provided ID
    - Create sanitized branch name: `ID-feature-name`
@@ -105,8 +104,7 @@ The system automatically detects which feature you're working on:
 - **Git integration** with branch management
 - **Template validation** before copying
 - **Todo list creation** for progress tracking
-- **Cross-platform script execution** with automatic detection
-- **Multiple language support**: Bash, PowerShell, Python
+- **Cross-platform script execution** with Bash
 - **Platform-agnostic operation** for any development environment
 
 ## Feature Progress Tracking

specpulse/resources/commands/claude/sp-spec.md

@@ -56,9 +56,8 @@ When called with `/sp-spec $ARGUMENTS`, I will:
    - 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 specification to `specs/ID-feature-name/spec-XXX.md`
-   - Run enhanced validation with cross-platform detection:
-     - **Linux/macOS**: `bash scripts/sp-pulse-spec.sh "$FEATURE_DIR"`
-     - **Python Fallback**: `python scripts/sp-pulse-spec.py "$FEATURE_DIR"`
+   - Run validation:
+     - `bash scripts/sp-pulse-spec.sh "$FEATURE_DIR"`
 
 4. **For `/sp-spec update`:**
    - **Show existing spec files**: List all spec-XXX.md files in current feature directory
@@ -75,12 +74,7 @@ When called with `/sp-spec $ARGUMENTS`, I will:
    - Read selected specification file from detected context
    - Check all required sections using enhanced validation:
      ```bash
-     # Cross-platform detection
-     if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
-         python scripts/sp-pulse-spec.py "$FEATURE_DIR"
-     else
-         bash scripts/sp-pulse-spec.sh "$FEATURE_DIR" || python scripts/sp-pulse-spec.py "$FEATURE_DIR"
-     fi
+     bash scripts/sp-pulse-spec.sh "$FEATURE_DIR"
      ```
    - Count `[NEEDS CLARIFICATION]` markers
    - Verify acceptance criteria follow Given-When-Then format
@@ -164,10 +158,9 @@ The AI-optimized specification template includes:
 
 ## Integration Features
 
-- **Cross-platform script execution** with automatic detection
-- **Enhanced script integration** with Bash and Python support
+- **Script execution** with Bash support
 - **Template variable processing** for AI optimization
 - **Automated validation** with detailed reporting
 - **Context-aware operation** using memory/context.md
 - **Progress tracking** with todo list integration
-- **Platform-agnostic operation** for Windows, Linux, and macOS
+- **Cross-platform operation** with Bash

specpulse/resources/commands/claude/sp-task.md

@@ -48,14 +48,9 @@ When called with `/sp-task $ARGUMENTS`, I will:
    c. **If not decomposed**:
       - Show existing plan files and ask user to select
       - Generate single task file with standard IDs (T001, T002)
-   c. **Enhanced validation** using cross-platform script:
+   c. **Validation** using script:
       ```bash
-      # Cross-platform detection
-      if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
-          python scripts/sp-pulse-task.py "$FEATURE_DIR"
-      else
-          bash scripts/sp-pulse-task.sh "$FEATURE_DIR" || python scripts/sp-pulse-task.py "$FEATURE_DIR"
-      fi
+      bash scripts/sp-pulse-task.sh "$FEATURE_DIR"
       ```
    
    d. **Read implementation plan** from selected plan file
@@ -112,14 +107,9 @@ When called with `/sp-task $ARGUMENTS`, I will:
 4. **For `/sp-task update`:**
    a. **Show existing task files**: List all task-XXX.md files in current feature directory
    b. **Ask user to select**: Which task file to update
-   c. **Enhanced analysis** using cross-platform script:
+   c. **Analysis** using script:
      ```bash
-     # Cross-platform detection
-     if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
-         python scripts/sp-pulse-task.py "$FEATURE_DIR"
-     else
-         bash scripts/sp-pulse-task.sh "$FEATURE_DIR" || python scripts/sp-pulse-task.py "$FEATURE_DIR"
-     fi
+     bash scripts/sp-pulse-task.sh "$FEATURE_DIR"
      ```
    d. **Parse current tasks** from selected file with comprehensive status:
      - Total tasks, completed, pending, blocked
@@ -253,12 +243,7 @@ User: /sp-task execute AUTH-T001
 I will:
 - Run: Cross-platform detection and execution
   ```bash
-  # Cross-platform detection
-  if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
-      python scripts/sp-pulse-task.py "$FEATURE_DIR"
-  else
-      bash scripts/sp-pulse-task.sh "$FEATURE_DIR" || python scripts/sp-pulse-task.py "$FEATURE_DIR"
-  fi
+  bash scripts/sp-pulse-task.sh "$FEATURE_DIR"
   ```
 - Create: AI-optimized task structure with template variables
 - Output: `TOTAL_TASKS=25, PARALLEL_TASKS=8, STATUS=generated`
@@ -283,27 +268,22 @@ I will:
 - Validate: Constitutional gates compliance and task readiness
 - Execute: Cross-platform task execution
   ```bash
-  # Cross-platform task execution
-  if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
-      python scripts/sp-pulse-task.py "$FEATURE_DIR" "execute:$TASK_ID"
-  else
-      bash scripts/sp-pulse-task.sh "$FEATURE_DIR" "execute:$TASK_ID" || python scripts/sp-pulse-task.py "$FEATURE_DIR" "execute:$TASK_ID"
-  fi
+  bash scripts/sp-pulse-task.sh "$FEATURE_DIR" "execute:$TASK_ID"
   ```
 - Track: Results and update progress automatically
 
 ## Enhanced Features
 
-- **Cross-platform script execution** with automatic detection (Bash/Python)
+- **Script execution** with Bash
 - **AI-optimized templates** with Jinja2-style variables
-- **Enhanced script integration** for validation and execution
+- **Script integration** for validation and execution
 - **Constitutional gates compliance** tracking
 - **Parallel task identification** and execution
 - **Comprehensive progress tracking** with YAML configuration
 - **Automatic percentage calculation** and velocity metrics
 - **Task dependency management** with conflict detection
 - **Execution command generation** with script integration
-- **Platform-agnostic operation** for Windows, Linux, and macOS
+- **Cross-platform operation** with Bash
 
 ## Error Handling
 

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

@@ -38,17 +38,15 @@ Parse arguments to determine action:
 
 7. Check existing plan files and create next version (plan-001.md, plan-002.md, etc.)
 8. Write plan to plans/XXX-feature/plan-XXX.md
-9. Run cross-platform validation:
-   - Linux/macOS: !{bash scripts/sp-pulse-plan.sh "XXX-feature"}
-   - Fallback: !{python scripts/sp-pulse-plan.py "XXX-feature"}
+9. Run validation:
+   - !{bash scripts/sp-pulse-plan.sh "XXX-feature"}
 
 ## For /sp-plan validate:
 1. Show list of existing plan files in current feature directory
 2. Ask user which plan file to validate
 3. Read selected plan from @{plans/*/plan-XXX.md}
-4. Run cross-platform validation:
-   - Linux/macOS: !{bash scripts/sp-pulse-plan.sh "XXX-feature"}
-   - Fallback: !{python scripts/sp-pulse-plan.py "XXX-feature"}
+4. Run validation:
+   - !{bash scripts/sp-pulse-plan.sh "XXX-feature"}
 5. Verify Phase Gates compliance
 6. Check complexity tracking
 7. Ensure test-first approach

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

@@ -5,9 +5,8 @@ Initialize a new SpecPulse feature with the name: {{args}}
 Please follow these steps:
 
 1. Extract the feature name from the provided arguments
-2. Run the initialization script with cross-platform detection:
-   - Linux/macOS: !{bash scripts/sp-pulse-init.sh "{{args}}"}  
-   - Fallback: !{python scripts/sp-pulse-init.py "{{args}}"}
+2. Run the initialization script:
+   - !{bash scripts/sp-pulse-init.sh "{{args}}"}
 3. Create the feature structure:
    - Generate feature ID (001, 002, etc.)
    - Create directories: specs/XXX-feature/, plans/XXX-feature/, tasks/XXX-feature/

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

@@ -24,9 +24,8 @@ Parse the arguments to determine the action:
 4. Find current feature directory from detected context
 5. Check existing spec files and create next version (spec-001.md, spec-002.md, etc.)
 6. Write specification to specs/XXX-feature/spec-XXX.md
-7. Run cross-platform validation:
-   - Linux/macOS: !{bash scripts/sp-pulse-spec.sh "XXX-feature"}
-   - Fallback: !{python scripts/sp-pulse-spec.py "XXX-feature"}
+7. Run validation:
+   - !{bash scripts/sp-pulse-spec.sh "XXX-feature"}
 
 ## For /sp-spec update:
 1. Show list of existing spec files in current feature directory
@@ -39,9 +38,8 @@ Parse the arguments to determine the action:
 ## For /sp-spec validate:
 1. Show list of existing spec files in current feature directory
 2. Ask user which spec file to validate
-3. Run cross-platform validation:
-   - Linux/macOS: !{bash scripts/sp-pulse-spec.sh "XXX-feature"}
-   - Fallback: !{python scripts/sp-pulse-spec.py "XXX-feature"}
+3. Run validation:
+   - !{bash scripts/sp-pulse-spec.sh "XXX-feature"}
 4. Check all required sections are filled
 5. Count [NEEDS CLARIFICATION] markers
 6. Verify acceptance criteria are testable

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

@@ -35,9 +35,8 @@ Parse arguments to determine action:
 
 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"}
+7. Run validation:
+   - !{bash scripts/sp-pulse-task.sh "XXX-feature"}
 
 ## For /sp-task update:
 1. Show list of existing task files in current feature directory
@@ -48,17 +47,15 @@ Parse arguments to determine action:
 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"}
+9. Run validation:
+   - !{bash scripts/sp-pulse-task.sh "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"}
+4. Run analysis:
+   - !{bash scripts/sp-pulse-task.sh "XXX-feature"}
 5. Count completed vs total
 6. Show current phase progress
 7. List any blockers

{specpulse-1.2.1.dist-info → specpulse-1.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specpulse
-Version: 1.2.1
+Version: 1.2.3
 Summary: Specification-Driven Development Framework
 Home-page: https://github.com/specpulse
 Author: SpecPulse
@@ -94,11 +94,10 @@ pip install specpulse --upgrade
 - Claude or Gemini CLI (for AI integration)
 
 **Cross-Platform Support:**
-- **Windows**: Python scripts + PowerShell fallback + Bash compatibility
-- **Linux**: Python scripts + Bash fallback  
-- **macOS**: Python scripts + Bash fallback
+- **Windows**: Requires Git Bash or WSL
+- **Linux**: Native Bash support  
+- **macOS**: Native Bash support
 - **Source Installation**: Works perfectly from source code (not just PyPI)
-- **Automatic Detection**: AI commands automatically detect OS and choose appropriate script
 
 ## 🚀 Quick Start
 
@@ -269,10 +268,9 @@ Stop guessing what users want:
 
 Claude and Gemini use slash commands that accept arguments via `$ARGUMENTS`:
 
-**Cross-Platform Script Execution:**
-- **Windows**: PowerShell (.ps1) → Python (.py) → Bash (.sh) fallback
-- **Linux/macOS**: Python (.py) → Bash (.sh) fallback  
-- **Automatic Detection**: AI commands detect OS and choose appropriate script
+**Script Execution:**
+- **All Platforms**: Bash (.sh) scripts only
+- **Requirements**: Bash shell required (Git Bash on Windows, native on Linux/macOS)
 - **Universal Compatibility**: Works whether installed via PyPI or source code
 - **Unicode Support**: Full international character support (≤, ≥, →, ←)
 
@@ -292,13 +290,11 @@ Claude and Gemini use slash commands that accept arguments via `$ARGUMENTS`:
 
 **Behind the Scenes:**
 - Commands capture arguments using `$ARGUMENTS` variable
-- **Multi-platform scripts** in `resources/scripts/` folder process the arguments:
-  - `sp-pulse-*.py` - Python scripts (universal)
-  - `sp-pulse-*.sh` - Bash scripts (Linux/macOS)
+- **Shell scripts** in `resources/scripts/` folder process the arguments:
+  - `sp-pulse-*.sh` - Bash scripts (all platforms)
 - AI reads templates from `resources/templates/` folder
 - Results are saved in `specs/`, `plans/`, `tasks/` folders
 - Memory system tracks progress in `memory/` folder
-- **Automatic platform detection** ensures the right script runs on each OS
 
 **Claude vs Gemini:**
 - **Claude**: Uses Markdown command files (`.claude/commands/*.md`) with YAML frontmatter