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

specpulse/resources/templates/spec.md

@@ -1,125 +1,125 @@
-<!-- SpecPulse Specification Template v4.0 - AI-Optimized -->
-<!-- AI Instructions:
-    1. Replace all {{variable}} placeholders with actual values
-    2. Fill sections based on user input and requirements analysis
-    3. Mark ALL uncertainties with [NEEDS CLARIFICATION: specific question]
-    4. Keep requirements testable and unambiguous
-    5. Focus on WHAT and WHY, not HOW
--->
-
-# Specification: {{ feature_name }}
-
-## Metadata
-- **ID**: SPEC-{{ feature_id }}
-- **Branch**: {{ branch_name }}
-- **Created**: {{ date }}
-- **Author**: {{ author }}
-- **AI Assistant**: {{ ai_assistant }}
-- **Version**: 1.0.0
-- **Status**: DRAFT
-
-## Executive Summary
-{{ executive_summary | default("Brief description of what this feature does and why it's needed") }}
-
-## User Request
-```
-{{ user_input }}
-```
-
-## Problem Statement
-
-### Current State
-{{ current_state | default("Describe the current situation and pain points") }}
-
-### Desired State  
-{{ desired_state | default("Describe what should be achieved after implementation") }}
-
-## Clarifications Needed
-<!-- List ALL ambiguities from user input -->
-{% if clarifications %}
-{% for clarification in clarifications %}
-- [NEEDS CLARIFICATION: {{ clarification }}]
-{% endfor %}
-{% else %}
-- [NEEDS CLARIFICATION: Add specific questions based on user input]
-{% endif %}
-
-## User Stories
-
-### Primary Stories
-{% for story in user_stories %}
-#### Story {{ loop.index }}: {{ story.title }}
-**As a** {{ story.user_type }}
-**I want to** {{ story.action }}
-**So that** {{ story.benefit }}
-
-**Acceptance Criteria:**
-{% for criteria in story.acceptance_criteria %}
-- Given {{ criteria.given }}, when {{ criteria.when }}, then {{ criteria.then }}
-{% endfor %}
-{% endfor %}
-
-## Functional Requirements
-
-### MUST Have Requirements
-{% for req in must_requirements %}
-**FR-{{ "%03d" | format(loop.index0 + 1) }}**: {{ req.statement }}
-- **Rationale**: {{ req.rationale }}
-- **Testable**: Yes
-{% endfor %}
-
-### SHOULD Have Requirements
-{% for req in should_requirements %}
-**FR-{{ "%03d" | format(loop.index0 + len(must_requirements) + 1) }}**: {{ req.statement }}
-- **Rationale**: {{ req.rationale }}
-- **Testable**: Yes
-{% endfor %}
-
-## Non-Functional Requirements
-
-### Performance
-- Response time < {{ performance.response_time | default("200ms") }}
-- Support {{ performance.concurrent_users | default("1000") }} concurrent users
-
-### Security
-- All data encrypted in transit
-- {{ security.authentication | default("Authentication required for sensitive actions") }}
-
-## Acceptance Scenarios
-
-### Critical Path
-1. **Scenario**: {{ primary_scenario.name }}
-   - **When**: {{ primary_scenario.action }}
-   - **Then**: {{ primary_scenario.result }}
-
-### Error Cases
-1. **Scenario**: {{ error_scenario.name }}
-   - **When**: {{ error_scenario.action }}
-   - **Then**: {{ error_scenario.result }}
-
-## Success Metrics
-- Adoption rate: {{ metrics.adoption_rate | default("80% within 30 days") }}
-- Success rate: {{ metrics.success_rate | default("95% of attempts") }}
-- User satisfaction: {{ metrics.satisfaction | default("8/10 NPS") }}
-
-## Out of Scope
-<!-- Explicitly state what this feature will NOT do -->
-{% for item in out_of_scope %}
-- This feature will NOT {{ item }}
-{% endfor %}
-
-## Dependencies
-{% for dep in dependencies %}
-- {{ dep }}
-{% endfor %}
-
-## Validation Checklist
-- [ ] All MUST requirements implemented
-- [ ] All acceptance criteria pass
-- [ ] No [NEEDS CLARIFICATION] markers remain
-- [ ] Performance targets met
-- [ ] Security requirements validated
-
----
-**Generated by**: {{ ai_assistant }} on {{ date }}
-**Next Steps**: Use `/plan` to create implementation plan
+<!-- SpecPulse Specification Template v4.0 - AI-Optimized -->
+<!-- AI Instructions:
+    1. Replace all {{variable}} placeholders with actual values
+    2. Fill sections based on user input and requirements analysis
+    3. Mark ALL uncertainties with [NEEDS CLARIFICATION: specific question]
+    4. Keep requirements testable and unambiguous
+    5. Focus on WHAT and WHY, not HOW
+-->
+
+# Specification: {{ feature_name }}
+
+## Metadata
+- **ID**: SPEC-{{ feature_id }}
+- **Branch**: {{ branch_name }}
+- **Created**: {{ date }}
+- **Author**: {{ author }}
+- **AI Assistant**: {{ ai_assistant }}
+- **Version**: 1.0.0
+- **Status**: DRAFT
+
+## Executive Summary
+{{ executive_summary | default("Brief description of what this feature does and why it's needed") }}
+
+## User Request
+```
+{{ user_input }}
+```
+
+## Problem Statement
+
+### Current State
+{{ current_state | default("Describe the current situation and pain points") }}
+
+### Desired State  
+{{ desired_state | default("Describe what should be achieved after implementation") }}
+
+## Clarifications Needed
+<!-- List ALL ambiguities from user input -->
+{% if clarifications %}
+{% for clarification in clarifications %}
+- [NEEDS CLARIFICATION: {{ clarification }}]
+{% endfor %}
+{% else %}
+- [NEEDS CLARIFICATION: Add specific questions based on user input]
+{% endif %}
+
+## User Stories
+
+### Primary Stories
+{% for story in user_stories %}
+#### Story {{ loop.index }}: {{ story.title }}
+**As a** {{ story.user_type }}
+**I want to** {{ story.action }}
+**So that** {{ story.benefit }}
+
+**Acceptance Criteria:**
+{% for criteria in story.acceptance_criteria %}
+- Given {{ criteria.given }}, when {{ criteria.when }}, then {{ criteria.then }}
+{% endfor %}
+{% endfor %}
+
+## Functional Requirements
+
+### MUST Have Requirements
+{% for req in must_requirements %}
+**FR-{{ "%03d" | format(loop.index0 + 1) }}**: {{ req.statement }}
+- **Rationale**: {{ req.rationale }}
+- **Testable**: Yes
+{% endfor %}
+
+### SHOULD Have Requirements
+{% for req in should_requirements %}
+**FR-{{ "%03d" | format(loop.index0 + len(must_requirements) + 1) }}**: {{ req.statement }}
+- **Rationale**: {{ req.rationale }}
+- **Testable**: Yes
+{% endfor %}
+
+## Non-Functional Requirements
+
+### Performance
+- Response time < {{ performance.response_time | default("200ms") }}
+- Support {{ performance.concurrent_users | default("1000") }} concurrent users
+
+### Security
+- All data encrypted in transit
+- {{ security.authentication | default("Authentication required for sensitive actions") }}
+
+## Acceptance Scenarios
+
+### Critical Path
+1. **Scenario**: {{ primary_scenario.name }}
+   - **When**: {{ primary_scenario.action }}
+   - **Then**: {{ primary_scenario.result }}
+
+### Error Cases
+1. **Scenario**: {{ error_scenario.name }}
+   - **When**: {{ error_scenario.action }}
+   - **Then**: {{ error_scenario.result }}
+
+## Success Metrics
+- Adoption rate: {{ metrics.adoption_rate | default("80% within 30 days") }}
+- Success rate: {{ metrics.success_rate | default("95% of attempts") }}
+- User satisfaction: {{ metrics.satisfaction | default("8/10 NPS") }}
+
+## Out of Scope
+<!-- Explicitly state what this feature will NOT do -->
+{% for item in out_of_scope %}
+- This feature will NOT {{ item }}
+{% endfor %}
+
+## Dependencies
+{% for dep in dependencies %}
+- {{ dep }}
+{% endfor %}
+
+## Validation Checklist
+- [ ] All MUST requirements implemented
+- [ ] All acceptance criteria pass
+- [ ] No [NEEDS CLARIFICATION] markers remain
+- [ ] Performance targets met
+- [ ] Security requirements validated
+
+---
+**Generated by**: {{ ai_assistant }} on {{ date }}
+**Next Steps**: Use `/sp-plan generate` to create implementation plan

specpulse/resources/templates/task.md

@@ -1,164 +1,165 @@
-<!-- SpecPulse Task List Template v3.0 - AI-Optimized -->
-<!-- AI Instructions: Generate from implementation plan using constitutional gates -->
-
-# Task List: {{ feature_name }}
-
-## Metadata
-- **Plan Reference**: SPEC-{{ feature_id }}
-- **Total Tasks**: {{ task_count }}
-- **Estimated Duration**: {{ total_duration }}
-- **Parallel Groups**: {{ parallel_groups }}
-
-## Task Organization
-
-{% for group in parallel_groups %}
-### Parallel Group {{ loop.index }}
-*These tasks can be executed simultaneously*
-
-{% for task in group.tasks %}
-#### {{ task.id }}: {{ task.name }}
-- **Type**: {{ task.type }}
-- **Priority**: {{ task.priority }}
-- **Estimate**: {{ task.estimate }}
-- **Dependencies**: {{ task.dependencies | join(", ") | default("None") }}
-- **Description**: {{ task.description }}
-- **Acceptance**: {{ task.acceptance }}
-- **Files**: {{ task.files | join(", ") }}
-- **Assignable**: {{ task.assignable }}
-{% endfor %}
-{% endfor %}
-
-### Sequential Tasks
-*These tasks must be completed in order*
-
-{% for task in sequential_tasks %}
-#### {{ task.id }}: {{ task.name }}
-- **Dependencies**: {{ task.dependencies | join(", ") }}
-- **Type**: {{ task.type }}
-- **Priority**: {{ task.priority }}
-- **Estimate**: {{ task.estimate }}
-- **Description**: {{ task.description }}
-- **Acceptance**: {{ task.acceptance }}
-{% endfor %}
-
-### Critical Path
-*Tasks that directly impact timeline*
-
-{% for path in critical_path %}
-{{ loop.index }}. {{ path.tasks | join(" → ") }}
-{% endfor %}
-- Estimated critical path duration: {{ critical_path_duration }}
-
-## Constitutional Gates Compliance
-
-### Pre-Implementation Validation
-{% for gate in constitutional_gates %}
-#### {{ gate.name }}
-- [ ] {{ gate.check_1 }}
-- [ ] {{ gate.check_2 }}
-- [ ] {{ gate.check_3 }}
-- [ ] {{ gate.check_4 }}
-**Status**: {{ gate.status | default("PENDING") }}
-{% endfor %}
-
-## Task Details by Category
-
-{% for category in task_categories %}
-### {{ category.name }} Tasks {% if category.parallel %}[P]{% endif %}
-{% for task in category.tasks %}
-- [ ] {{ task.id }}: {{ task.name }}
-{% endfor %}
-{% endfor %}
-
-## Execution Schedule
-
-{% for phase in execution_schedule %}
-### {{ phase.name }}
-{% for time_block in phase.time_blocks %}
-- {{ time_block.timing }}: {{ time_block.tasks | join(", ") }}{% if time_block.parallel %} (parallel){% endif %}
-{% endfor %}
-{% endfor %}
-
-## Progress Tracking
-```yaml
-status:
-  total: {{ task_count }}
-  completed: 0
-  in_progress: 0
-  blocked: 0
-  
-metrics:
-  velocity: {{ velocity | default("2-3 tasks/day") }}
-  estimated_completion: {{ estimated_completion }}
-  blockers: []
-  
-parallel_groups:
-{% for group in parallel_groups %}
-  - name: "{{ group.name }}"
-    tasks: [{{ group.tasks | map(attribute='id') | join(", ") }}]
-    can_start: {{ group.can_start }}
-{% endfor %}
-
-sequential_tasks:
-{% for task in sequential_tasks %}
-  - name: "{{ task.name }}"
-    id: {{ task.id }}
-    dependencies: [{{ task.dependencies | join(", ") }}]
-{% endfor %}
-```
-
-## Task Execution Commands
-
-### For parallel tasks:
-```bash
-# Execute parallel tasks using SpecPulse scripts
-{% for group in parallel_groups %}
-# {{ group.name }} tasks
-parallel_tasks="{{ group.tasks | map(attribute='id') | join(" ") }}"
-for task in $parallel_tasks; do
-    echo "Starting $task in parallel..."
-    ./scripts/execute-task.sh "$task" &
-done
-wait  # Wait for all parallel tasks to complete
-{% endfor %}
-```
-
-### For sequential tasks:
-```bash
-# Execute tasks in dependency order
-{% for task in sequential_tasks %}
-# {{ task.name }} ({{ task.id }})
-echo "Executing {{ task.id }}..."
-./scripts/execute-task.sh "{{ task.id }}"
-# Check success before proceeding
-if [ $? -eq 0 ]; then
-    echo "{{ task.id }} completed successfully"
-else
-    echo "{{ task.id }} failed - halting execution"
-    exit 1
-fi
-{% endfor %}
-```
-
-## AI Integration Notes
-
-### Constitutional Gates
-- All tasks MUST pass constitutional compliance before implementation
-- Use `/validate` command to check compliance status
-- Mark gates as completed only after actual validation
-
-### Progress Tracking
-- Update task status in real-time using `/status` command
-- Document blockers immediately when identified
-- Use velocity metrics to refine future estimates
-
-### Quality Assurance
-- Each task requires specific acceptance criteria
-- Test-first development mandated by Article III
-- Integration tests required before deployment
-
----
-**Generated by**: {{ ai_assistant }} on {{ date }}
-**Feature**: {{ feature_name }}
-**Constitutional Gates**: {{ constitutional_status | default("PENDING VALIDATION") }}
+<!-- SpecPulse Task List Template v3.0 - AI-Optimized -->
+<!-- AI Instructions: Generate from implementation plan using constitutional gates -->
+
+# Task List: {{ feature_name }}
+
+## Metadata
+- **Plan Reference**: SPEC-{{ feature_id }}
+- **Total Tasks**: {{ task_count }}
+- **Estimated Duration**: {{ total_duration }}
+- **Parallel Groups**: {{ parallel_groups }}
+
+## Task Organization
+
+{% for group in parallel_groups %}
+### Parallel Group {{ loop.index }}
+*These tasks can be executed simultaneously*
+
+{% for task in group.tasks %}
+#### {{ task.id }}: {{ task.name }}
+- **Type**: {{ task.type }}
+- **Priority**: {{ task.priority }}
+- **Estimate**: {{ task.estimate }}
+- **Dependencies**: {{ task.dependencies | join(", ") | default("None") }}
+- **Description**: {{ task.description }}
+- **Acceptance**: {{ task.acceptance }}
+- **Files**: {{ task.files | join(", ") }}
+- **Assignable**: {{ task.assignable }}
+{% endfor %}
+{% endfor %}
+
+### Sequential Tasks
+*These tasks must be completed in order*
+
+{% for task in sequential_tasks %}
+#### {{ task.id }}: {{ task.name }}
+- **Dependencies**: {{ task.dependencies | join(", ") }}
+- **Type**: {{ task.type }}
+- **Priority**: {{ task.priority }}
+- **Estimate**: {{ task.estimate }}
+- **Description**: {{ task.description }}
+- **Acceptance**: {{ task.acceptance }}
+{% endfor %}
+
+### Critical Path
+*Tasks that directly impact timeline*
+
+{% for path in critical_path %}
+{{ loop.index }}. {{ path.tasks | join(" -> ") }}
+{% endfor %}
+- Estimated critical path duration: {{ critical_path_duration }}
+
+## Constitutional Gates Compliance
+
+### Pre-Implementation Validation
+{% for gate in constitutional_gates %}
+#### {{ gate.name }}
+- [ ] {{ gate.check_1 }}
+- [ ] {{ gate.check_2 }}
+- [ ] {{ gate.check_3 }}
+- [ ] {{ gate.check_4 }}
+**Status**: {{ gate.status | default("PENDING") }}
+{% endfor %}
+
+## Task Details by Category
+
+{% for category in task_categories %}
+### {{ category.name }} Tasks {% if category.parallel %}[P]{% endif %}
+{% for task in category.tasks %}
+- [ ] {{ task.id }}: {{ task.name }}
+{% endfor %}
+{% endfor %}
+
+## Execution Schedule
+
+{% for phase in execution_schedule %}
+### {{ phase.name }}
+{% for time_block in phase.time_blocks %}
+- {{ time_block.timing }}: {{ time_block.tasks | join(", ") }}{% if time_block.parallel %} (parallel){% endif %}
+{% endfor %}
+{% endfor %}
+
+## Progress Tracking
+```yaml
+status:
+  total: {{ task_count }}
+  completed: 0
+  in_progress: 0
+  blocked: 0
+  
+metrics:
+  velocity: {{ velocity | default("2-3 tasks/day") }}
+  estimated_completion: {{ estimated_completion }}
+  blockers: []
+  
+parallel_groups:
+{% for group in parallel_groups %}
+  - name: "{{ group.name }}"
+    tasks: [{{ group.tasks | map(attribute='id') | join(", ") }}]
+    can_start: {{ group.can_start }}
+{% endfor %}
+
+sequential_tasks:
+{% for task in sequential_tasks %}
+  - name: "{{ task.name }}"
+    id: {{ task.id }}
+    dependencies: [{{ task.dependencies | join(", ") }}]
+{% endfor %}
+```
+
+## Task Execution Guidelines
+
+### AI-Assisted Development Process
+All task execution should be handled by AI assistants (Claude or Gemini) following the SpecPulse methodology:
+
+1. **Task Selection**: AI assistants should select tasks based on:
+   - Dependency order (sequential tasks first)
+   - Parallel execution opportunities
+   - Current context and feature priorities
+   - Resource availability
+
+2. **Implementation Process**: For each task:
+   ```markdown
+   ## Task: {{ task.id }} - {{ task.name }}
+   
+   **Status**: [ ] Pending / [x] Completed / [-] In Progress / [!] Blocked
+   **Dependencies**: {{ task.dependencies | join(", ") | default("None") }}
+   **Acceptance**: {{ task.acceptance }}
+   ```
+
+3. **Parallel Execution Strategy**: When tasks can be executed in parallel:
+   - AI assistants should work on multiple tasks simultaneously
+   - Coordinate task completion status
+   - Handle cross-task dependencies
+   - Maintain code consistency
+
+### Task Dependencies Management
+
+- **Sequential Dependencies**: Tasks must be completed in specific order
+- **Parallel Opportunities**: Independent tasks can be worked on simultaneously
+- **Dependency Resolution**: AI should resolve conflicts and blocking issues
+- **Progress Coordination**: Multiple AI assistants should coordinate task completion
+
+## AI Integration Notes
+
+### Constitutional Gates
+- All tasks MUST pass constitutional compliance before implementation
+- Use `/sp-validate` command to check compliance status
+- Mark gates as completed only after actual validation
+
+### Progress Tracking
+- Update task status in real-time using markdown checkboxes: `[ ]` → `[-]` → `[x]`
+- Document blockers immediately with `[!]` status and resolution notes
+- Use velocity metrics to refine future estimates
+- Coordinate with other AI assistants for parallel task execution
+
+### Quality Assurance
+- Each task requires specific acceptance criteria
+- Test-first development mandated by Article III
+- Integration tests required before deployment
+
+---
+**Generated by**: {{ ai_assistant }} on {{ date }}
+**Feature**: {{ feature_name }}
+**Constitutional Gates**: {{ constitutional_status | default("PENDING VALIDATION") }}
 **Next Steps**: Execute tasks following constitutional order