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

specpulse/resources/scripts/{pulse-task.sh → sp-pulse-task.sh}

@@ -46,35 +46,51 @@ if [ -z "$FEATURE_DIR" ]; then
     fi
 fi
 
-TASK_FILE="$PROJECT_ROOT/tasks/${FEATURE_DIR}/tasks.md"
+TASK_DIR="$PROJECT_ROOT/tasks/${FEATURE_DIR}"
+PLAN_DIR="$PROJECT_ROOT/plans/${FEATURE_DIR}"
+SPEC_DIR="$PROJECT_ROOT/specs/${FEATURE_DIR}"
 TEMPLATE_FILE="$PROJECT_ROOT/templates/task.md"
-PLAN_FILE="$PROJECT_ROOT/plans/${FEATURE_DIR}/plan.md"
-SPEC_FILE="$PROJECT_ROOT/specs/${FEATURE_DIR}/spec.md"
 
 # Ensure tasks directory exists
-mkdir -p "$(dirname "$TASK_FILE")"
+mkdir -p "$TASK_DIR"
 
-# Check if specification and plan exist first
-if [ ! -f "$SPEC_FILE" ]; then
-    error_exit "Specification file not found: $SPEC_FILE. Please create specification first."
+# Find latest spec file
+if [ -d "$SPEC_DIR" ]; then
+    SPEC_FILE=$(find "$SPEC_DIR" -name "spec-*.md" -printf "%T@ %p\n" | sort -n | tail -1 | cut -d' ' -f2-)
+    if [ -z "$SPEC_FILE" ]; then
+        error_exit "No specification files found in $SPEC_DIR. Please create specification first."
+    fi
+else
+    error_exit "Specifications directory not found: $SPEC_DIR. Please create specification first."
 fi
 
-if [ ! -f "$PLAN_FILE" ]; then
-    error_exit "Implementation plan not found: $PLAN_FILE. Please create plan first."
+# Find latest plan file
+if [ -d "$PLAN_DIR" ]; then
+    PLAN_FILE=$(find "$PLAN_DIR" -name "plan-*.md" -printf "%T@ %p\n" | sort -n | tail -1 | cut -d' ' -f2-)
+    if [ -z "$PLAN_FILE" ]; then
+        error_exit "No plan files found in $PLAN_DIR. Please create plan first."
+    fi
+else
+    error_exit "Plans directory not found: $PLAN_DIR. Please create plan first."
 fi
 
+# Find next available task number or create new one
+if [ -d "$TASK_DIR" ]; then
+    existing_tasks=$(find "$TASK_DIR" -name "task-*.md" | wc -l)
+    task_number=$((existing_tasks + 1))
+else
+    task_number=1
+fi
+TASK_FILE="$TASK_DIR/task-$(printf "%03d" $task_number).md"
+
 # Ensure task template exists
 if [ ! -f "$TEMPLATE_FILE" ]; then
     error_exit "Template not found: $TEMPLATE_FILE"
 fi
 
-# Create task file if it doesn't exist
-if [ ! -f "$TASK_FILE" ]; then
-    log "Creating task breakdown from template: $TASK_FILE"
-    cp "$TEMPLATE_FILE" "$TASK_FILE" || error_exit "Failed to copy task template"
-else
-    log "Task breakdown already exists: $TASK_FILE"
-fi
+# Create task file
+log "Creating task breakdown from template: $TASK_FILE"
+cp "$TEMPLATE_FILE" "$TASK_FILE" || error_exit "Failed to copy task template"
 
 # Validate task structure
 log "Validating task breakdown..."

specpulse/resources/templates/decomposition/api-contract.yaml

@@ -0,0 +1,22 @@
+openapi: 3.0.0
+info:
+  title: {{ service_name }} API
+  version: {{ version }}
+  description: {{ service_description }}
+  
+servers:
+  - url: {{ base_url }}
+    description: {{ environment }}
+
+paths:
+  {{ paths }}
+
+components:
+  schemas:
+    {{ schemas }}
+  
+  securitySchemes:
+    {{ security_schemes }}
+
+tags:
+  {{ tags }}

specpulse/resources/templates/decomposition/integration-plan.md

@@ -0,0 +1,134 @@
+# Integration Plan: {{ feature_name }}
+
+## Metadata
+- **Spec ID**: {{ spec_id }}
+- **Decomposition Date**: {{ decomposition_date }}
+- **Services Count**: {{ service_count }}
+- **Generated**: {{ date }}
+- **Version**: {{ version }}
+
+## Service Overview
+
+{{ service_list }}
+
+## Integration Architecture
+
+```mermaid
+{{ architecture_diagram }}
+```
+
+## Communication Strategy
+
+### Synchronous Communication
+{{ sync_communication }}
+
+### Asynchronous Communication
+{{ async_communication }}
+
+## Data Consistency Strategy
+
+### Transaction Boundaries
+{{ transaction_strategy }}
+
+### Event Sourcing
+{{ event_sourcing }}
+
+### Saga Patterns
+{{ saga_patterns }}
+
+## Integration Phases
+
+### Phase 1: Service Infrastructure
+**Duration**: {{ phase1_duration }}
+**Deliverables**:
+- Service discovery setup
+- API Gateway configuration
+- Load balancer setup
+- Service mesh deployment
+
+### Phase 2: Inter-Service Communication
+**Duration**: {{ phase2_duration }}
+**Deliverables**:
+- REST API endpoints
+- Message queue setup
+- Event bus configuration
+- Circuit breakers
+
+### Phase 3: Data Synchronization
+**Duration**: {{ phase3_duration }}
+**Deliverables**:
+- Data replication strategy
+- Cache synchronization
+- Event replay mechanisms
+- Consistency validation
+
+### Phase 4: Integration Testing
+**Duration**: {{ phase4_duration }}
+**Deliverables**:
+- Contract tests
+- End-to-end scenarios
+- Performance benchmarks
+- Chaos engineering tests
+
+## Service Dependencies
+
+```yaml
+dependencies:
+  {{ service_dependencies }}
+```
+
+## API Gateway Configuration
+
+### Routing Rules
+{{ routing_rules }}
+
+### Rate Limiting
+{{ rate_limiting }}
+
+### Authentication Flow
+{{ auth_flow }}
+
+## Monitoring & Observability
+
+### Distributed Tracing
+- Correlation ID propagation
+- Span collection strategy
+- Trace sampling rate
+
+### Health Checks
+{{ health_checks }}
+
+### SLA Targets
+{{ sla_targets }}
+
+## Rollout Strategy
+
+### Service Deployment Order
+1. {{ deployment_order }}
+
+### Feature Flags
+{{ feature_flags }}
+
+### Rollback Plan
+{{ rollback_plan }}
+
+## Constitutional Compliance
+- [ ] Each integration point ≤ 3 dependencies (Article I: Simplicity)
+- [ ] Contract tests defined (Article III: Test-First)
+- [ ] Real services over mocks (Article VIII: Framework Selection)
+- [ ] Security at integration points (Article V: Security by Design)
+
+## Risk Assessment
+
+### Integration Risks
+{{ integration_risks }}
+
+### Mitigation Strategies
+{{ mitigation_strategies }}
+
+## Success Criteria
+- [ ] All services communicating successfully
+- [ ] Data consistency maintained
+- [ ] Performance targets met
+- [ ] Zero message loss
+- [ ] Graceful degradation working

specpulse/resources/templates/decomposition/interface.ts

@@ -0,0 +1,20 @@
+/**
+ * {{ interface_name }}
+ * {{ interface_description }}
+ * 
+ * Bounded Context: {{ bounded_context }}
+ * Service: {{ service_name }}
+ */
+
+export interface {{ interface_name }} {
+  {{ methods }}
+}
+
+// Data Transfer Objects
+{{ dto_definitions }}
+
+// Event Contracts
+{{ event_contracts }}
+
+// Domain Types
+{{ domain_types }}

specpulse/resources/templates/decomposition/microservices.md

@@ -0,0 +1,34 @@
+# Microservice Decomposition: {{ feature_name }}
+
+## Metadata
+- **Spec ID**: {{ spec_id }}
+- **Decomposed**: {{ date }}
+- **Version**: {{ version }}
+
+## Service Boundaries
+
+{{ services }}
+
+## Communication Matrix
+
+{{ communication_patterns }}
+
+## Data Ownership
+
+{{ data_boundaries }}
+
+## Integration Points
+
+{{ integration_points }}
+
+## Constitutional Compliance
+- [ ] Each service ≤ 3 core modules (Article I: Simplicity)
+- [ ] Single responsibility per service (Article V)
+- [ ] Clear test boundaries defined (Article III)
+- [ ] Framework selection documented (Article VIII)
+
+## Next Steps
+1. Review service boundaries with team
+2. Run `/sp-plan generate` with decomposition context
+3. Create tasks per service with `/sp-task breakdown`
+4. Validate with `/sp-validate decomposition`

specpulse/resources/templates/decomposition/service-plan.md

@@ -0,0 +1,168 @@
+# Service Plan: {{ service_name }}
+
+## Metadata
+- **Service**: {{ service_name }}
+- **Bounded Context**: {{ bounded_context }}
+- **Spec Reference**: {{ spec_id }}
+- **Generated**: {{ date }}
+- **Version**: {{ version }}
+
+## Service Overview
+
+### Responsibility
+{{ service_responsibility }}
+
+### Capabilities
+{{ service_capabilities }}
+
+### Data Ownership
+{{ data_ownership }}
+
+## Architecture
+
+### Internal Structure
+```
+{{ service_name }}/
+├── domain/          # Business logic
+├── application/     # Use cases
+├── infrastructure/  # External interfaces
+└── presentation/    # API layer
+```
+
+### Technology Stack
+- **Language**: {{ language }}
+- **Framework**: {{ framework }}
+- **Database**: {{ database }}
+- **Cache**: {{ cache }}
+- **Message Queue**: {{ queue }}
+
+## API Design
+
+### REST Endpoints
+{{ rest_endpoints }}
+
+### Event Publications
+{{ event_publications }}
+
+### Event Subscriptions
+{{ event_subscriptions }}
+
+## Data Model
+
+### Entities
+{{ entities }}
+
+### Value Objects
+{{ value_objects }}
+
+### Aggregates
+{{ aggregates }}
+
+## Implementation Phases
+
+### Phase 1: Domain Layer
+**Duration**: {{ phase1_duration }}
+- Domain entities
+- Business rules
+- Domain events
+- Value objects
+
+### Phase 2: Application Layer
+**Duration**: {{ phase2_duration }}
+- Use cases
+- Application services
+- DTOs
+- Mappers
+
+### Phase 3: Infrastructure Layer
+**Duration**: {{ phase3_duration }}
+- Database repositories
+- External service clients
+- Message handlers
+- Cache implementation
+
+### Phase 4: API Layer
+**Duration**: {{ phase4_duration }}
+- REST controllers
+- Request/Response models
+- Validation
+- Error handling
+
+## Testing Strategy
+
+### Unit Tests
+- Domain logic: {{ domain_coverage }}%
+- Use cases: {{ usecase_coverage }}%
+- Infrastructure: {{ infra_coverage }}%
+
+### Integration Tests
+{{ integration_tests }}
+
+### Contract Tests
+{{ contract_tests }}
+
+## Service Configuration
+
+### Environment Variables
+```yaml
+{{ env_variables }}
+```
+
+### Feature Flags
+{{ feature_flags }}
+
+### Secrets Management
+{{ secrets }}
+
+## Deployment
+
+### Container Configuration
+```dockerfile
+{{ dockerfile_snippet }}
+```
+
+### Resource Requirements
+- CPU: {{ cpu_requirements }}
+- Memory: {{ memory_requirements }}
+- Storage: {{ storage_requirements }}
+
+### Scaling Strategy
+{{ scaling_strategy }}
+
+## Monitoring
+
+### Metrics
+{{ metrics }}
+
+### Logs
+{{ logging_strategy }}
+
+### Alerts
+{{ alert_rules }}
+
+## Dependencies
+
+### Internal Services
+{{ internal_dependencies }}
+
+### External Services
+{{ external_dependencies }}
+
+### Libraries
+{{ libraries }}
+
+## Constitutional Compliance
+- [ ] Service has single responsibility (Article V)
+- [ ] ≤ 3 core modules (Article I: Simplicity)
+- [ ] Tests before implementation (Article III)
+- [ ] Direct framework usage (Article VIII)
+
+## Risk Assessment
+{{ risks }}
+
+## Success Criteria
+- [ ] All endpoints functional
+- [ ] Test coverage > {{ test_target }}%
+- [ ] Performance targets met
+- [ ] Zero security vulnerabilities
+- [ ] Documentation complete