specpulse 1.0.3__tar.gz → 1.0.5__tar.gz

{specpulse-1.0.3/specpulse.egg-info → specpulse-1.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specpulse
-Version: 1.0.3
+Version: 1.0.5
 Summary: Specification-Driven Development Framework
 Home-page: https://github.com/specpulse
 Author: SpecPulse
@@ -66,7 +66,12 @@ 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.0.1)**: Fixed command documentation and improved AI integration clarity.
+> **Latest Update (v1.0.5)**: 
+> - ✅ **Complete Cross-Platform Support**: Works seamlessly on Windows, Linux, and macOS
+> - ✅ **100% Test Success Rate**: Comprehensive test suite with 37+ tests across all platforms
+> - ✅ **Python & PowerShell Scripts**: Full script compatibility beyond bash
+> - ✅ **Automatic Platform Detection**: AI commands choose the right script automatically
+> - ✅ **Unicode Support**: Full international character support (≤, ≥, →, ←)
 
 ### Why SpecPulse?
 
@@ -87,6 +92,13 @@ pip install specpulse --upgrade
 - Git (optional, for version control features)
 - 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
+- **Source Installation**: Works perfectly from source code (not just PyPI)
+- **Automatic Detection**: AI commands automatically detect OS and choose appropriate script
+
 ## 🚀 Quick Start
 
 ### Step 1: Initialize Your Project
@@ -114,25 +126,21 @@ specpulse init --ai gemini
 
 ```bash
 # Initialize a new feature
-/pulse init user-authentication
-
-# Create the specification
-/spec create "User login with OAuth2 and email/password"
+/pulse user-authentication
+# Creates structure for 001-user-authentication feature
 
-# Validate the specification
-/spec validate
+# Create the specification  
+/spec create user login with OAuth2 and email/password
+# Or just: /spec (for interactive mode)
 
 # Generate implementation plan
 /plan generate
-
-# Validate plan against constitution
-/plan validate
+# Or: /plan validate (to check existing plan)
 
 # Break down into tasks
 /task breakdown
-
-# Check task progress
-/task status
+# Or: /task update (to update task status)
+# Or: /task status (to see progress)
 ```
 
 ### Step 4: Validate & Ship
@@ -244,28 +252,52 @@ Stop guessing what users want:
 
 ### 🤖 Deep AI Integration
 
-**Claude Commands:**
+**How AI Commands Work:**
+
+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
+- **Universal Compatibility**: Works whether installed via PyPI or source code
+- **Unicode Support**: Full international character support (≤, ≥, →, ←)
+
 ```bash
-# Feature initialization
-/pulse init <feature-name>        # Initialize new feature with structure
-
-# Specification management
-/spec create <description>        # Generate specification from requirements
-/spec update                      # Update existing specification
-/spec validate                    # Check specification completeness
-
-# Planning commands
-/plan generate                    # Create implementation plan from spec
-/plan validate                    # Validate plan against constitution
-
-# Task management
-/task breakdown                   # Generate tasks from plan
-/task update                      # Update task status
-/task status                      # Show task progress
+/pulse user-authentication     # Start new feature with name
+/spec create OAuth2 login      # Create specification with description
+/spec update                   # Update existing specification
+/spec validate                 # Validate specification completeness
+/plan generate                 # Generate plan from specification
+/plan validate                 # Validate plan against constitution
+/task breakdown                # Create task list from plan
+/task update                   # Update task statuses
+/task status                   # Show current progress
 ```
 
-**Gemini Commands:**
-Same commands with TOML-based configuration for enhanced parsing.
+**Behind the Scenes:**
+- Commands capture arguments using `$ARGUMENTS` variable
+- **Multi-platform scripts** in `resources/scripts/` folder process the arguments:
+  - `pulse-*.py` - Python scripts (universal)
+  - `pulse-*.ps1` - PowerShell scripts (Windows)
+  - `pulse-*.sh` - Bash scripts (Linux/macOS)
+- 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
+  - Arguments passed via `$ARGUMENTS` variable to shell scripts
+- **Gemini**: Uses TOML command files (`.gemini/commands/*.toml`) with simple format
+  - Arguments handled via `{{args}}` placeholder in prompts
+- Both support arguments and work the same way from user perspective
+
+**Command Arguments:**
+- Commands can accept arguments: `/command arg1 arg2`
+- Claude: Arguments passed to scripts via `$ARGUMENTS`
+- Gemini: Arguments injected via `{{args}}` placeholder
+- Commands can be used without arguments for interactive mode
 
 ## 📊 Real-World Impact
 
@@ -425,7 +457,8 @@ Built with inspiration from:
 ## 🚦 Project Status
 
 [![Build Status](https://img.shields.io/badge/build-passing-brightgreen)](https://github.com/specpulse/specpulse)
-[![Coverage](https://img.shields.io/badge/coverage-94%25-brightgreen)](https://github.com/specpulse/specpulse)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)](https://github.com/specpulse/specpulse)
+[![Tests](https://img.shields.io/badge/tests-37%2B%20passed-brightgreen)](https://github.com/specpulse/specpulse)
 [![Maintainability](https://img.shields.io/badge/maintainability-A-brightgreen)](https://github.com/specpulse/specpulse)
 
 ---

{specpulse-1.0.3 → specpulse-1.0.5}/README.md

@@ -21,7 +21,12 @@
 
 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.0.1)**: Fixed command documentation and improved AI integration clarity.
+> **Latest Update (v1.0.5)**: 
+> - ✅ **Complete Cross-Platform Support**: Works seamlessly on Windows, Linux, and macOS
+> - ✅ **100% Test Success Rate**: Comprehensive test suite with 37+ tests across all platforms
+> - ✅ **Python & PowerShell Scripts**: Full script compatibility beyond bash
+> - ✅ **Automatic Platform Detection**: AI commands choose the right script automatically
+> - ✅ **Unicode Support**: Full international character support (≤, ≥, →, ←)
 
 ### Why SpecPulse?
 
@@ -42,6 +47,13 @@ pip install specpulse --upgrade
 - Git (optional, for version control features)
 - 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
+- **Source Installation**: Works perfectly from source code (not just PyPI)
+- **Automatic Detection**: AI commands automatically detect OS and choose appropriate script
+
 ## 🚀 Quick Start
 
 ### Step 1: Initialize Your Project
@@ -69,25 +81,21 @@ specpulse init --ai gemini
 
 ```bash
 # Initialize a new feature
-/pulse init user-authentication
-
-# Create the specification
-/spec create "User login with OAuth2 and email/password"
+/pulse user-authentication
+# Creates structure for 001-user-authentication feature
 
-# Validate the specification
-/spec validate
+# Create the specification  
+/spec create user login with OAuth2 and email/password
+# Or just: /spec (for interactive mode)
 
 # Generate implementation plan
 /plan generate
-
-# Validate plan against constitution
-/plan validate
+# Or: /plan validate (to check existing plan)
 
 # Break down into tasks
 /task breakdown
-
-# Check task progress
-/task status
+# Or: /task update (to update task status)
+# Or: /task status (to see progress)
 ```
 
 ### Step 4: Validate & Ship
@@ -199,28 +207,52 @@ Stop guessing what users want:
 
 ### 🤖 Deep AI Integration
 
-**Claude Commands:**
+**How AI Commands Work:**
+
+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
+- **Universal Compatibility**: Works whether installed via PyPI or source code
+- **Unicode Support**: Full international character support (≤, ≥, →, ←)
+
 ```bash
-# Feature initialization
-/pulse init <feature-name>        # Initialize new feature with structure
-
-# Specification management
-/spec create <description>        # Generate specification from requirements
-/spec update                      # Update existing specification
-/spec validate                    # Check specification completeness
-
-# Planning commands
-/plan generate                    # Create implementation plan from spec
-/plan validate                    # Validate plan against constitution
-
-# Task management
-/task breakdown                   # Generate tasks from plan
-/task update                      # Update task status
-/task status                      # Show task progress
+/pulse user-authentication     # Start new feature with name
+/spec create OAuth2 login      # Create specification with description
+/spec update                   # Update existing specification
+/spec validate                 # Validate specification completeness
+/plan generate                 # Generate plan from specification
+/plan validate                 # Validate plan against constitution
+/task breakdown                # Create task list from plan
+/task update                   # Update task statuses
+/task status                   # Show current progress
 ```
 
-**Gemini Commands:**
-Same commands with TOML-based configuration for enhanced parsing.
+**Behind the Scenes:**
+- Commands capture arguments using `$ARGUMENTS` variable
+- **Multi-platform scripts** in `resources/scripts/` folder process the arguments:
+  - `pulse-*.py` - Python scripts (universal)
+  - `pulse-*.ps1` - PowerShell scripts (Windows)
+  - `pulse-*.sh` - Bash scripts (Linux/macOS)
+- 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
+  - Arguments passed via `$ARGUMENTS` variable to shell scripts
+- **Gemini**: Uses TOML command files (`.gemini/commands/*.toml`) with simple format
+  - Arguments handled via `{{args}}` placeholder in prompts
+- Both support arguments and work the same way from user perspective
+
+**Command Arguments:**
+- Commands can accept arguments: `/command arg1 arg2`
+- Claude: Arguments passed to scripts via `$ARGUMENTS`
+- Gemini: Arguments injected via `{{args}}` placeholder
+- Commands can be used without arguments for interactive mode
 
 ## 📊 Real-World Impact
 
@@ -380,7 +412,8 @@ Built with inspiration from:
 ## 🚦 Project Status
 
 [![Build Status](https://img.shields.io/badge/build-passing-brightgreen)](https://github.com/specpulse/specpulse)
-[![Coverage](https://img.shields.io/badge/coverage-94%25-brightgreen)](https://github.com/specpulse/specpulse)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen)](https://github.com/specpulse/specpulse)
+[![Tests](https://img.shields.io/badge/tests-37%2B%20passed-brightgreen)](https://github.com/specpulse/specpulse)
 [![Maintainability](https://img.shields.io/badge/maintainability-A-brightgreen)](https://github.com/specpulse/specpulse)
 
 ---

{specpulse-1.0.3 → specpulse-1.0.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specpulse"
-version = "1.0.3"
+version = "1.0.5"
 description = "Specification-Driven Development Framework"
 readme = "README.md"
 requires-python = ">=3.11"

{specpulse-1.0.3 → specpulse-1.0.5}/setup.py

@@ -11,7 +11,7 @@ long_description = (this_directory / "README.md").read_text(encoding="utf-8")
 
 setup(
     name="specpulse",
-    version="1.0.0",
+    version="1.0.5",
     author="SpecPulse",
     author_email="",
     description="Next-Generation Specification-Driven Development Framework",

{specpulse-1.0.3 → specpulse-1.0.5}/specpulse/__init__.py

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

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

@@ -0,0 +1,184 @@
+---
+name: plan
+description: Generate or validate implementation plans using AI-optimized templates
+allowed_tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - TodoWrite
+---
+
+# /plan Command
+
+Generate implementation plans from specifications following SpecPulse methodology with constitutional compliance and AI-optimized templates.
+
+## Usage
+```
+/plan [action] [feature-directory]
+```
+
+Actions: `generate`, `validate`, `optimize` (defaults to `generate`)
+
+## Implementation
+
+When called with `/plan $ARGUMENTS`, I will:
+
+1. **Parse arguments** and determine action:
+   - If `validate`: Check plan against constitutional gates
+   - If `optimize`: Improve existing plan complexity
+   - Otherwise: Generate new plan
+
+2. **For `/plan generate` or `/plan`:**
+   a. **Find and validate specification** from current context or provided directory
+   
+   b. **Enhanced validation** using cross-platform script:
+      ```bash
+      # Cross-platform detection
+      if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
+          powershell scripts/pulse-plan.ps1 "$FEATURE_DIR"
+      else
+          bash scripts/pulse-plan.sh "$FEATURE_DIR" || python scripts/pulse-plan.py "$FEATURE_DIR"
+      fi
+      ```
+
+   c. **Run Constitutional Phase Gates** (Article VII):
+      - Simplicity Gate: ≤3 modules justification
+      - Anti-Abstraction Gate: Direct framework usage
+      - Test-First Gate: Tests before implementation
+      - Integration-First Gate: Real services over mocks
+      - Research Gate: Technology choices documented
+
+   d. **Generate AI-optimized plan** using template variables:
+      ```markdown
+      # Implementation Plan: {{ feature_name }}
+      ## Specification Reference
+      - **Spec ID**: SPEC-{{ feature_id }}
+      - **Generated**: {{ date }}
+      ```
+
+   e. **Generate comprehensive sections**:
+      - Technology stack with performance implications
+      - Architecture overview with component relationships
+      - Implementation phases with timeline estimates
+      - API contracts with authentication requirements
+      - Data models with validation rules
+      - Testing strategy with coverage targets
+      - Security considerations with compliance requirements
+      - Deployment strategy with rollback plans
+
+   f. **Complexity tracking** (Article VII):
+      - Document all complexity exceptions with justifications
+      - Create mitigation strategies for each exception
+      - Track optimization opportunities
+
+   g. **Write optimized plan** to `plans/XXX-feature/plan.md`
+
+3. **For `/plan validate`:**
+   - **Enhanced validation** using cross-platform script:
+     ```bash
+     # Cross-platform detection
+     if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
+         powershell scripts/pulse-plan.ps1 "$FEATURE_DIR"
+     else
+         bash scripts/pulse-plan.sh "$FEATURE_DIR" || python scripts/pulse-plan.py "$FEATURE_DIR"
+     fi
+     ```
+   - Verify all constitutional gates are addressed
+   - Check complexity exceptions have proper justifications
+   - Validate test-first approach is documented
+   - Ensure integration strategy uses real services
+   - Report detailed validation results
+
+4. **For `/plan optimize`:**
+   - **Read existing plan** and analyze complexity
+   - **Identify optimization opportunities**:
+     - Module consolidation opportunities
+     - Abstraction layer removal candidates
+     - Simplification strategies
+   - **Generate optimization recommendations**
+   - **Update plan** with reduced complexity
+
+## Constitutional Phase Gates (Phase -1)
+
+**Must pass before implementation:**
+
+### Article VII: Simplicity Gate
+- [ ] Using ≤3 projects/modules for initial implementation
+- [ ] No future-proofing without documented need
+- [ ] Direct framework usage (no unnecessary wrappers)
+- [ ] Single model representation per concept
+
+### Article VII: Anti-Abstraction Gate  
+- [ ] Using framework features directly
+- [ ] No unnecessary abstraction layers
+- [ ] Clear, simple interfaces
+- [ ] Avoiding premature optimization
+
+### Article III: Test-First Gate
+- [ ] Test specifications written
+- [ ] Tests reviewed and approved
+- [ ] Tests confirmed to FAIL before implementation
+- [ ] TDD cycle planned (Red-Green-Refactor)
+
+### Article VIII: Integration-First Gate
+- [ ] Contract tests defined
+- [ ] Using real services over mocks
+- [ ] Production-like test environment planned
+- [ ] End-to-end test scenarios identified
+
+### Article VI: Research Gate
+- [ ] Library options researched
+- [ ] Performance implications documented
+- [ ] Security considerations analyzed
+- [ ] Trade-offs documented
+
+## Examples
+
+### Generate plan with validation
+```
+User: /plan generate
+```
+I will:
+- Run: `bash scripts/pulse-plan.sh "$FEATURE_DIR"`
+- Validate: Constitutional gates compliance
+- Create: AI-optimized plan with template variables
+- Output: `CONSTITUTIONAL_GATES_STATUS=PENDING`
+
+### Validate existing plan
+```
+User: /plan validate
+```
+I will run comprehensive validation:
+```
+PLAN_FILE=plans/001-user-authentication/plan.md
+CONSTITUTIONAL_GATES_STATUS=COMPLETED
+MISSING_SECTIONS=0
+STATUS=validation_complete
+```
+
+### Optimize plan complexity
+```
+User: /plan optimize
+```
+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, PowerShell, and Python
+- **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
+
+## Error Handling
+
+- Specification existence validation
+- Constitutional gate compliance checking
+- Template structure validation
+- Directory structure verification
+- Feature context auto-discovery

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

@@ -0,0 +1,91 @@
+---
+name: pulse
+description: Initialize a new feature with SpecPulse framework
+allowed_tools:
+  - Bash
+  - Read
+  - Write
+  - Edit
+  - TodoWrite
+---
+
+# /pulse Command
+
+Initialize a new feature following SpecPulse methodology with constitutional compliance.
+
+## Usage
+```
+/pulse <feature-name> [feature-id]
+```
+
+## Implementation
+
+When called with `/pulse $ARGUMENTS`, I will:
+
+1. **Validate arguments** and extract feature name + optional ID
+2. **Run initialization script** with cross-platform detection:
+   - **Windows**: `powershell scripts/pulse-init.ps1 "$FEATURE_NAME" "$OPTIONAL_ID"`
+   - **Linux/macOS**: `bash scripts/pulse-init.sh "$FEATURE_NAME" "$OPTIONAL_ID"`
+   - **Python Fallback**: `python scripts/pulse-init.py "$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`
+   - Create directories: `specs/ID-feature-name/`, `plans/ID-feature-name/`, `tasks/ID-feature-name/`
+   - Copy AI-optimized templates to feature directories
+   - Update `memory/context.md` with current feature metadata
+   - Create and switch to git branch if in git repository
+
+4. **Validate structure** and report comprehensive status
+5. **Create todo list** for tracking feature development progress
+
+## Constitutional Compliance
+
+**Article I: Simplicity**
+- [ ] Feature name is clear and specific
+- [ ] No unnecessary abstractions in initial structure
+- [ ] Single responsibility per feature
+
+**Article II: Anti-Abstraction**  
+- [ ] Direct template usage (no wrapper layers)
+- [ ] Minimal initial structure
+- [ ] Framework-ready files
+
+## Example
+```
+User: /pulse user-authentication-oauth2
+```
+
+I will:
+- Run: `bash scripts/pulse-init.sh "user-authentication-oauth2"`
+- Create: `specs/001-user-authentication-oauth2/spec.md`
+- Create: `plans/001-user-authentication-oauth2/plan.md`  
+- Create: `tasks/001-user-authentication-oauth2/tasks.md`
+- Branch: `001-user-authentication-oauth2`
+- Status: `STATUS=initialized, BRANCH_NAME=001-user-authentication-oauth2`
+
+## Error Handling
+
+Enhanced validation includes:
+- Feature name sanitization (alphanumeric, hyphens only)
+- Directory creation validation
+- Template existence verification
+- Git repository validation
+- Context file management
+
+## Next Steps (Constitutional Order)
+
+1. **Phase -1**: Use `/spec` to create specification with constitutional gates
+2. **Phase 0**: Use `/plan` to generate implementation plan with complexity tracking
+3. **Phase 1**: Use `/task` to break down into executable tasks
+4. **Implementation**: Begin development following constitutional principles
+
+## Integration Features
+
+- **Automatic context tracking** in `memory/context.md`
+- **Enhanced error reporting** with specific failure reasons
+- **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
+- **Platform-agnostic operation** for any development environment