specpulse 1.1.0__tar.gz → 1.2.1__tar.gz

{specpulse-1.1.0/specpulse.egg-info → specpulse-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specpulse
-Version: 1.1.0
+Version: 1.2.1
 Summary: Specification-Driven Development Framework
 Home-page: https://github.com/specpulse
 Author: SpecPulse
@@ -66,13 +66,13 @@ 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.1.0)**: 
-> - 🔧 **Command Prefix System**: All commands now use `sp-` prefix to avoid conflicts
-> - 📋 **Multi-Spec Workflow**: Support for multiple specs/plans/tasks per feature
-> - 🗂️ **Versioned File System**: Automatic spec-001.md, plan-001.md, task-001.md naming
-> - 🎯 **Context Detection**: Automatic feature detection using git branches
-> - 🤖 **Enhanced AI Integration**: Improved manual workflow control
-> - ✅ **Improved Error Handling**: Better resource path resolution and script copying operations
+> **Latest Update (v1.2.0)**: 
+> - 🔀 **Microservice Decomposition**: New `/sp-decompose` command to break large specs into services
+> - 🏗️ **Service-Based Planning**: Automatic service-specific plans and integration plans
+> - 📊 **Service Task Management**: Task prefixes per service (AUTH-T001, USER-T001, INT-T001)
+> - 🎯 **Smart Workflow Detection**: Automatic monolithic vs decomposed architecture handling
+> - 📝 **Rich Templates**: New templates for services, APIs, interfaces, and integration
+> - 🔧 **Previous (v1.1.0)**: Command prefix system, multi-spec workflow, versioned files
 
 ### Why SpecPulse?
 
@@ -134,14 +134,19 @@ specpulse init --ai gemini
 /sp-spec create user login with OAuth2 and email/password
 # Or just: /sp-spec (for interactive mode)
 
+# [NEW] Decompose large specs into microservices (optional)
+/sp-decompose 001
+# Creates service boundaries, API contracts, and interfaces
+
 # Generate implementation plan
 /sp-plan generate
-# Or: /sp-plan validate (to check existing plan)
+# For decomposed: Creates service-specific plans + integration plan
+# For monolithic: Creates single comprehensive plan
 
 # Break down into tasks
 /sp-task breakdown
-# Or: /sp-task update (to update task status)
-# Or: /sp-task status (to see progress)
+# For decomposed: Creates AUTH-T001, USER-T001, INT-T001 tasks
+# For monolithic: Creates T001, T002, T003 tasks
 ```
 
 ### Step 4: Validate & Ship
@@ -150,6 +155,13 @@ specpulse init --ai gemini
 # Validate everything
 specpulse validate
 
+# [NEW] Decompose specifications
+specpulse decompose 001
+# Or with options:
+specpulse decompose --microservices
+specpulse decompose --apis
+specpulse decompose --interfaces
+
 # Run diagnostics
 specpulse doctor
 
@@ -269,11 +281,13 @@ Claude and Gemini use slash commands that accept arguments via `$ARGUMENTS`:
 /sp-spec create OAuth2 login      # Create specification with description
 /sp-spec update                   # Update existing specification
 /sp-spec validate                 # Validate specification completeness
-/sp-plan generate                 # Generate plan from specification
+/sp-decompose 001                 # [NEW] Decompose spec into microservices
+/sp-plan generate                 # Generate plan(s) - detects decomposition
 /sp-plan validate                 # Validate plan against constitution
-/sp-task breakdown                # Create task list from plan
+/sp-task breakdown                # Create task list(s) - per service if decomposed
 /sp-task update                   # Update task statuses
 /sp-task status                   # Show current progress
+/sp-task execute AUTH-T001        # [NEW] Execute service-specific task
 ```
 
 **Behind the Scenes:**
@@ -309,6 +323,39 @@ Claude and Gemini use slash commands that accept arguments via `$ARGUMENTS`:
 | **Technical Debt** | Accumulates | **Tracked & Managed** |
 | **Documentation** | Often outdated | **Always current** |
 
+## 🎯 Microservice Decomposition (NEW)
+
+For large, complex specifications, SpecPulse can automatically decompose them into microservices:
+
+```bash
+# Decompose a specification
+/sp-decompose 001
+```
+
+This creates:
+- **Service Boundaries**: Using Domain-Driven Design principles
+- **API Contracts**: OpenAPI 3.0 specifications for each service
+- **Interface Definitions**: TypeScript/Java/Go interfaces
+- **Integration Map**: Service communication architecture
+- **Migration Plan**: Strategy for breaking down monoliths
+
+### Workflow Adaptation
+
+SpecPulse automatically adapts based on architecture:
+
+**Monolithic Flow:**
+```
+spec-001.md → plan-001.md → task-001.md (T001, T002...)
+```
+
+**Decomposed Flow:**
+```
+spec-001.md → decomposition/ → service plans → service tasks
+                ├── microservices.md      ├── auth-service-plan.md    ├── AUTH-T001
+                ├── api-contracts/        ├── user-service-plan.md    ├── USER-T001
+                └── interfaces/           └── integration-plan.md     └── INT-T001
+```
+
 ## 🏗️ Project Structure
 
 ```
@@ -325,13 +372,25 @@ my-project/
 │   └── decisions.md    # Architecture Decision Records
 ├── specs/               # Feature specifications
 │   └── 001-feature/
-│       └── spec-001.md
+│       ├── spec-001.md
+│       └── decomposition/    # [NEW] Microservice decomposition
+│           ├── microservices.md
+│           ├── api-contracts/
+│           └── interfaces/
 ├── plans/               # Implementation plans
 │   └── 001-feature/
-│       └── plan-001.md
+│       ├── plan-001.md      # Monolithic plan
+│       # OR for decomposed:
+│       ├── auth-service-plan.md
+│       ├── user-service-plan.md
+│       └── integration-plan.md
 ├── tasks/               # Task breakdowns
 │   └── 001-feature/
-│       └── task-001.md
+│       ├── task-001.md      # Monolithic tasks
+│       # OR for decomposed:
+│       ├── auth-service-tasks.md
+│       ├── user-service-tasks.md
+│       └── integration-tasks.md
 ├── templates/           # Customizable templates
 ├── scripts/             # Shell scripts for AI execution
 │   ├── sp-pulse-init.sh    # Feature initialization

{specpulse-1.1.0 → specpulse-1.2.1}/README.md

@@ -21,13 +21,13 @@
 
 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.1.0)**: 
-> - 🔧 **Command Prefix System**: All commands now use `sp-` prefix to avoid conflicts
-> - 📋 **Multi-Spec Workflow**: Support for multiple specs/plans/tasks per feature
-> - 🗂️ **Versioned File System**: Automatic spec-001.md, plan-001.md, task-001.md naming
-> - 🎯 **Context Detection**: Automatic feature detection using git branches
-> - 🤖 **Enhanced AI Integration**: Improved manual workflow control
-> - ✅ **Improved Error Handling**: Better resource path resolution and script copying operations
+> **Latest Update (v1.2.0)**: 
+> - 🔀 **Microservice Decomposition**: New `/sp-decompose` command to break large specs into services
+> - 🏗️ **Service-Based Planning**: Automatic service-specific plans and integration plans
+> - 📊 **Service Task Management**: Task prefixes per service (AUTH-T001, USER-T001, INT-T001)
+> - 🎯 **Smart Workflow Detection**: Automatic monolithic vs decomposed architecture handling
+> - 📝 **Rich Templates**: New templates for services, APIs, interfaces, and integration
+> - 🔧 **Previous (v1.1.0)**: Command prefix system, multi-spec workflow, versioned files
 
 ### Why SpecPulse?
 
@@ -89,14 +89,19 @@ specpulse init --ai gemini
 /sp-spec create user login with OAuth2 and email/password
 # Or just: /sp-spec (for interactive mode)
 
+# [NEW] Decompose large specs into microservices (optional)
+/sp-decompose 001
+# Creates service boundaries, API contracts, and interfaces
+
 # Generate implementation plan
 /sp-plan generate
-# Or: /sp-plan validate (to check existing plan)
+# For decomposed: Creates service-specific plans + integration plan
+# For monolithic: Creates single comprehensive plan
 
 # Break down into tasks
 /sp-task breakdown
-# Or: /sp-task update (to update task status)
-# Or: /sp-task status (to see progress)
+# For decomposed: Creates AUTH-T001, USER-T001, INT-T001 tasks
+# For monolithic: Creates T001, T002, T003 tasks
 ```
 
 ### Step 4: Validate & Ship
@@ -105,6 +110,13 @@ specpulse init --ai gemini
 # Validate everything
 specpulse validate
 
+# [NEW] Decompose specifications
+specpulse decompose 001
+# Or with options:
+specpulse decompose --microservices
+specpulse decompose --apis
+specpulse decompose --interfaces
+
 # Run diagnostics
 specpulse doctor
 
@@ -224,11 +236,13 @@ Claude and Gemini use slash commands that accept arguments via `$ARGUMENTS`:
 /sp-spec create OAuth2 login      # Create specification with description
 /sp-spec update                   # Update existing specification
 /sp-spec validate                 # Validate specification completeness
-/sp-plan generate                 # Generate plan from specification
+/sp-decompose 001                 # [NEW] Decompose spec into microservices
+/sp-plan generate                 # Generate plan(s) - detects decomposition
 /sp-plan validate                 # Validate plan against constitution
-/sp-task breakdown                # Create task list from plan
+/sp-task breakdown                # Create task list(s) - per service if decomposed
 /sp-task update                   # Update task statuses
 /sp-task status                   # Show current progress
+/sp-task execute AUTH-T001        # [NEW] Execute service-specific task
 ```
 
 **Behind the Scenes:**
@@ -264,6 +278,39 @@ Claude and Gemini use slash commands that accept arguments via `$ARGUMENTS`:
 | **Technical Debt** | Accumulates | **Tracked & Managed** |
 | **Documentation** | Often outdated | **Always current** |
 
+## 🎯 Microservice Decomposition (NEW)
+
+For large, complex specifications, SpecPulse can automatically decompose them into microservices:
+
+```bash
+# Decompose a specification
+/sp-decompose 001
+```
+
+This creates:
+- **Service Boundaries**: Using Domain-Driven Design principles
+- **API Contracts**: OpenAPI 3.0 specifications for each service
+- **Interface Definitions**: TypeScript/Java/Go interfaces
+- **Integration Map**: Service communication architecture
+- **Migration Plan**: Strategy for breaking down monoliths
+
+### Workflow Adaptation
+
+SpecPulse automatically adapts based on architecture:
+
+**Monolithic Flow:**
+```
+spec-001.md → plan-001.md → task-001.md (T001, T002...)
+```
+
+**Decomposed Flow:**
+```
+spec-001.md → decomposition/ → service plans → service tasks
+                ├── microservices.md      ├── auth-service-plan.md    ├── AUTH-T001
+                ├── api-contracts/        ├── user-service-plan.md    ├── USER-T001
+                └── interfaces/           └── integration-plan.md     └── INT-T001
+```
+
 ## 🏗️ Project Structure
 
 ```
@@ -280,13 +327,25 @@ my-project/
 │   └── decisions.md    # Architecture Decision Records
 ├── specs/               # Feature specifications
 │   └── 001-feature/
-│       └── spec-001.md
+│       ├── spec-001.md
+│       └── decomposition/    # [NEW] Microservice decomposition
+│           ├── microservices.md
+│           ├── api-contracts/
+│           └── interfaces/
 ├── plans/               # Implementation plans
 │   └── 001-feature/
-│       └── plan-001.md
+│       ├── plan-001.md      # Monolithic plan
+│       # OR for decomposed:
+│       ├── auth-service-plan.md
+│       ├── user-service-plan.md
+│       └── integration-plan.md
 ├── tasks/               # Task breakdowns
 │   └── 001-feature/
-│       └── task-001.md
+│       ├── task-001.md      # Monolithic tasks
+│       # OR for decomposed:
+│       ├── auth-service-tasks.md
+│       ├── user-service-tasks.md
+│       └── integration-tasks.md
 ├── templates/           # Customizable templates
 ├── scripts/             # Shell scripts for AI execution
 │   ├── sp-pulse-init.sh    # Feature initialization

{specpulse-1.1.0 → specpulse-1.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "specpulse"
-version = "1.1.0"
+version = "1.2.1"
 description = "Specification-Driven Development Framework"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -81,11 +81,15 @@ packages = [
     "specpulse.resources.memory",
     "specpulse.resources.scripts",
     "specpulse.resources.templates",
+    "specpulse.resources.templates.decomposition",
 ]
 
 [tool.setuptools.package-data]
 specpulse = [
     "resources/templates/*.md",
+    "resources/templates/decomposition/*.md",
+    "resources/templates/decomposition/*.yaml",
+    "resources/templates/decomposition/*.ts",
     "resources/memory/*.md",
     "resources/scripts/*.sh",
     "resources/scripts/*.py",

{specpulse-1.1.0 → specpulse-1.2.1}/setup.py

@@ -11,7 +11,7 @@ long_description = (this_directory / "README.md").read_text(encoding="utf-8")
 
 setup(
     name="specpulse",
-    version="1.1.0",
+    version="1.2.1",
     author="SpecPulse",
     author_email="",
     description="Next-Generation Specification-Driven Development Framework",
@@ -59,8 +59,12 @@ setup(
     package_data={
         "specpulse": [
             "resources/templates/*.md",
+            "resources/templates/decomposition/*.md",
+            "resources/templates/decomposition/*.yaml",
+            "resources/templates/decomposition/*.ts",
             "resources/memory/*.md",
             "resources/scripts/*.sh",
+            "resources/scripts/*.py",
             "resources/commands/claude/*.md",
             "resources/commands/gemini/*.toml",
         ],

{specpulse-1.1.0 → specpulse-1.2.1}/specpulse/cli/main.py

@@ -291,9 +291,10 @@ This project uses SpecPulse for specification-driven development.
 1. Open in your AI assistant (Claude or Gemini)
 2. Use `/sp-pulse <feature>` to start a new feature
 3. Use `/sp-spec create` to generate specifications
-4. Use `/sp-plan generate` to create implementation plans
-5. Use `/sp-task breakdown` to create task lists
-6. Use `/validate all` before implementation
+4. Use `/sp-decompose <spec-id>` to break down large specs
+5. Use `/sp-plan generate` to create implementation plans
+6. Use `/sp-task breakdown` to create task lists
+7. Use `/validate all` before implementation
 
 ## Project Structure
 - `specs/` - Feature specifications
@@ -306,6 +307,7 @@ This project uses SpecPulse for specification-driven development.
 ## Commands
 - `/sp-pulse <feature>` - Initialize new feature
 - `/sp-spec create <description>` - Create specification
+- `/sp-decompose <spec-id>` - Decompose specs into microservices/APIs
 - `/sp-plan generate` - Generate implementation plan
 - `/sp-task breakdown` - Create task list
 - `/validate [component]` - Validate project
@@ -410,6 +412,206 @@ Generated with SpecPulse v1.0.0
         
         return all(r["status"] != "error" for r in results)
     
+    def decompose(self, spec_id: Optional[str] = None, 
+                  microservices: bool = False,
+                  apis: bool = False, 
+                  interfaces: bool = False):
+        """Decompose large specifications into smaller components"""
+        self.console.show_banner(mini=True)
+        self.console.header("Specification Decomposition", style="bright_yellow")
+        
+        project_path = Path.cwd()
+        specs_dir = project_path / "specs"
+        
+        # Find target specification
+        if spec_id:
+            # Handle both "001" and "001-feature" formats
+            spec_id_num = spec_id.split('-')[0] if '-' in spec_id else spec_id
+            spec_dirs = list(specs_dir.glob(f"{spec_id_num}*"))
+        else:
+            # Try to detect from context or most recent
+            spec_dirs = sorted(specs_dir.glob("*"), reverse=True)
+        
+        if not spec_dirs:
+            self.console.error("No specifications found. Run /sp-spec create first.")
+            return False
+        
+        target_dir = spec_dirs[0]
+        spec_files = list(target_dir.glob("spec-*.md"))
+        
+        if not spec_files:
+            self.console.error(f"No specification files found in {target_dir}")
+            return False
+        
+        # Use most recent spec file
+        spec_file = sorted(spec_files)[-1]
+        
+        self.console.info(f"Decomposing: {spec_file.name}")
+        self.console.spinner("Analyzing specification complexity")
+        
+        # Create decomposition directory
+        decomp_dir = target_dir / "decomposition"
+        decomp_dir.mkdir(exist_ok=True)
+        
+        # Determine what to generate
+        if not any([microservices, apis, interfaces]):
+            # Default to all
+            microservices = apis = interfaces = True
+        
+        decomp_items = []
+        
+        if microservices:
+            # Use template from SpecPulse core
+            ms_template = self.specpulse.get_decomposition_template("microservices")
+            ms_content = ms_template.replace("{{ feature_name }}", target_dir.name)
+            ms_content = ms_content.replace("{{ spec_id }}", target_dir.name.split('-')[0])
+            ms_content = ms_content.replace("{{ date }}", datetime.now().isoformat())
+            ms_content = ms_content.replace("{{ version }}", "1.0.0")
+            
+            # Placeholder content for services (AI will fill this)
+            ms_content = ms_content.replace("{{ services }}", """### Authentication Service
+- **Responsibility**: User identity and access control
+- **Bounded Context**: Identity Management
+
+### User Management Service  
+- **Responsibility**: User profiles and preferences
+- **Bounded Context**: User Domain""")
+            
+            ms_content = ms_content.replace("{{ communication_patterns }}", """- REST APIs for synchronous
+- Event Bus for asynchronous""")
+            ms_content = ms_content.replace("{{ data_boundaries }}", """- Each service owns its data
+- No shared databases""")
+            ms_content = ms_content.replace("{{ integration_points }}", """- API Gateway
+- Message Queue""")
+            
+            # Simplified microservices content
+            ms_content = """# Microservice Decomposition
+
+## Services Identified
+
+### Authentication Service
+- **Responsibility**: User identity and access control
+- **Bounded Context**: Identity Management
+- **Data Ownership**: users, sessions, tokens
+
+### User Management Service  
+- **Responsibility**: User profile and preferences
+- **Bounded Context**: User Domain
+- **Data Ownership**: profiles, preferences, settings
+
+## Communication Patterns
+- Synchronous: REST APIs
+- Asynchronous: Event Bus
+- Hybrid: CQRS for read/write separation
+"""
+            with open(decomp_dir / "microservices.md", 'w', encoding='utf-8') as f:
+                f.write(ms_content)
+            decomp_items.append(("Microservices", "Generated"))
+        
+        if apis:
+            # Generate API contracts using template
+            api_dir = decomp_dir / "api-contracts"
+            api_dir.mkdir(exist_ok=True)
+            
+            # Use template from SpecPulse core
+            api_template = self.specpulse.get_decomposition_template("api")
+            
+            # Basic API content (AI will expand this)
+            api_content = """openapi: 3.0.0
+info:
+  title: Authentication Service API
+  version: 1.0.0
+paths:
+  /api/v1/auth/login:
+    post:
+      summary: Authenticate user
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                username:
+                  type: string
+                password:
+                  type: string
+      responses:
+        200:
+          description: Successful authentication
+"""
+            with open(api_dir / "auth-service.yaml", 'w', encoding='utf-8') as f:
+                f.write(api_content)
+            decomp_items.append(("API Contracts", "Generated"))
+        
+        if interfaces:
+            # Generate interface specifications using template
+            iface_dir = decomp_dir / "interfaces"
+            iface_dir.mkdir(exist_ok=True)
+            
+            # Use template from SpecPulse core
+            iface_template = self.specpulse.get_decomposition_template("interface")
+            
+            # Basic interface content (AI will expand this)
+            iface_content = """// Authentication Service Interface
+export interface IAuthenticationService {
+  authenticate(credentials: Credentials): Promise<AuthToken>;
+  validateToken(token: string): Promise<TokenValidation>;
+  refreshToken(refreshToken: string): Promise<AuthToken>;
+  revokeToken(token: string): Promise<void>;
+}
+
+export interface Credentials {
+  username: string;
+  password: string;
+}
+
+export interface AuthToken {
+  accessToken: string;
+  refreshToken: string;
+  expiresIn: number;
+}
+"""
+            with open(iface_dir / "IAuthService.ts", 'w', encoding='utf-8') as f:
+                f.write(iface_content)
+            decomp_items.append(("Interfaces", "Generated"))
+        
+        # Generate integration map
+        map_content = """# Integration Map
+
+## Service Communication
+
+```mermaid
+graph LR
+    A[API Gateway] --> B[Auth Service]
+    A --> C[User Service]
+    B --> D[Session Store]
+    C --> E[Profile DB]
+    B -.->|Events| F[Event Bus]
+    C -.->|Events| F
+```
+
+## Data Flow
+1. Client → API Gateway
+2. Gateway → Authentication
+3. Auth → Session Store
+4. Success → User Service
+5. User → Profile Data
+"""
+        with open(decomp_dir / "integration-map.md", 'w', encoding='utf-8') as f:
+            f.write(map_content)
+        decomp_items.append(("Integration Map", "Created"))
+        
+        import time
+        time.sleep(1)  # Visual effect
+        
+        # Display results
+        self.console.status_panel("Decomposition Complete", decomp_items)
+        self.console.animated_success(f"Specification decomposed into {len(decomp_items)} components")
+        self.console.info(f"Output: {decomp_dir}")
+        
+        return True
+    
     def sync(self):
         """Synchronize project state"""
         self.console.show_banner(mini=True)
@@ -560,6 +762,13 @@ def main():
     validate_parser.add_argument("--fix", action="store_true", help="Attempt to fix issues")
     validate_parser.add_argument("--verbose", action="store_true", help="Verbose output")
     
+    # Decompose command
+    decompose_parser = subparsers.add_parser("decompose", help="Decompose specifications into smaller components")
+    decompose_parser.add_argument("spec_id", nargs="?", help="Specification ID (e.g., 001 or 001-feature)")
+    decompose_parser.add_argument("--microservices", action="store_true", help="Generate microservice boundaries")
+    decompose_parser.add_argument("--apis", action="store_true", help="Generate API contracts")
+    decompose_parser.add_argument("--interfaces", action="store_true", help="Generate interface specifications")
+    
     # Sync command
     sync_parser = subparsers.add_parser("sync", help="Synchronize project state")
     
@@ -582,6 +791,8 @@ def main():
         cli.update()
     elif args.command == "validate":
         cli.validate(args.component, args.fix, args.verbose)
+    elif args.command == "decompose":
+        cli.decompose(args.spec_id, args.microservices, args.apis, args.interfaces)
     elif args.command == "sync":
         cli.sync()
     elif args.command == "doctor":

{specpulse-1.1.0 → specpulse-1.2.1}/specpulse/core/specpulse.py

@@ -537,6 +537,36 @@ Last Updated: [AI updates this automatically]
 - **[Term]**: [Definition]
 """
     
+    def get_decomposition_template(self, template_type: str = "microservices") -> str:
+        """Get decomposition template"""
+        template_map = {
+            "microservices": "microservices.md",
+            "api": "api-contract.yaml",
+            "interface": "interface.ts"
+        }
+        
+        template_file = template_map.get(template_type, "microservices.md")
+        template_path = self.resources_dir / "templates" / "decomposition" / template_file
+        
+        if template_path.exists():
+            with open(template_path, 'r', encoding='utf-8') as f:
+                return f.read()
+        
+        # Fallback for microservices template
+        if template_type == "microservices":
+            return """# Microservice Decomposition: {{ feature_name }}
+
+## Service Boundaries
+{{ services }}
+
+## Communication Patterns
+{{ communication }}
+
+## Data Ownership
+{{ data_boundaries }}
+"""
+        return ""
+    
     def get_decisions_template(self) -> str:
         """Get architectural decisions template from file"""
         template_path = self.resources_dir / "memory" / "decisions.md"