specpulse 1.3.3__py3-none-any.whl → 1.4.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. specpulse/__init__.py +1 -1
  2. specpulse/cli/main.py +32 -6
  3. specpulse/core/specpulse.py +24 -90
  4. specpulse/core/validator.py +38 -34
  5. specpulse/resources/commands/claude/sp-decompose.md +17 -17
  6. specpulse/resources/commands/claude/sp-plan.md +47 -47
  7. specpulse/resources/commands/claude/sp-pulse.md +10 -10
  8. specpulse/resources/commands/claude/sp-spec.md +15 -10
  9. specpulse/resources/commands/claude/sp-task.md +15 -15
  10. specpulse/resources/commands/gemini/sp-plan.toml +17 -17
  11. specpulse/resources/memory/constitution.md +237 -128
  12. specpulse/resources/scripts/sp-pulse-init.ps1 +131 -0
  13. specpulse/resources/scripts/sp-pulse-plan.ps1 +147 -0
  14. specpulse/resources/scripts/sp-pulse-plan.sh +131 -127
  15. specpulse/resources/scripts/sp-pulse-spec.ps1 +126 -0
  16. specpulse/resources/scripts/sp-pulse-task.ps1 +166 -0
  17. specpulse/resources/scripts/sp-pulse-task.sh +6 -6
  18. specpulse/resources/templates/decomposition/integration-plan.md +6 -5
  19. specpulse/resources/templates/decomposition/microservices.md +6 -5
  20. specpulse/resources/templates/decomposition/service-plan.md +6 -5
  21. specpulse/resources/templates/plan.md +229 -205
  22. specpulse/resources/templates/task.md +165 -165
  23. specpulse/utils/version_check.py +128 -0
  24. {specpulse-1.3.3.dist-info → specpulse-1.4.0.dist-info}/METADATA +70 -29
  25. {specpulse-1.3.3.dist-info → specpulse-1.4.0.dist-info}/RECORD +29 -24
  26. {specpulse-1.3.3.dist-info → specpulse-1.4.0.dist-info}/WHEEL +0 -0
  27. {specpulse-1.3.3.dist-info → specpulse-1.4.0.dist-info}/entry_points.txt +0 -0
  28. {specpulse-1.3.3.dist-info → specpulse-1.4.0.dist-info}/licenses/LICENSE +0 -0
  29. {specpulse-1.3.3.dist-info → specpulse-1.4.0.dist-info}/top_level.txt +0 -0
@@ -11,7 +11,7 @@ allowed_tools:
11
11
 
12
12
  # /sp-pulse Command
13
13
 
14
- Initialize a new feature following SpecPulse methodology with constitutional compliance.
14
+ Initialize a new feature following SpecPulse methodology with SDD compliance.
15
15
 
16
16
  ## CRITICAL SECURITY NOTE
17
17
  **NEVER edit files in these protected directories:**
@@ -53,17 +53,17 @@ When called with `/sp-pulse $ARGUMENTS`, I will:
53
53
 
54
54
  5. **Validate structure** and report comprehensive status
55
55
 
56
- ## Constitutional Compliance
56
+ ## SDD Compliance
57
57
 
58
- **Article I: Simplicity**
58
+ **Principle 1: Specification First**
59
59
  - [ ] Feature name is clear and specific
60
- - [ ] No unnecessary abstractions in initial structure
61
- - [ ] Single responsibility per feature
60
+ - [ ] Ready for requirements documentation
61
+ - [ ] Structure supports specifications
62
62
 
63
- **Article II: Anti-Abstraction**
64
- - [ ] Direct template usage (no wrapper layers)
65
- - [ ] Minimal initial structure
66
- - [ ] Framework-ready files
63
+ **Principle 2: Incremental Planning**
64
+ - [ ] Initial structure supports phased development
65
+ - [ ] Templates ready for iterative work
66
+ - [ ] Supports any project type
67
67
 
68
68
  ## Example
69
69
  ```
@@ -100,7 +100,7 @@ The `/sp-pulse` command creates the feature structure and then guides you throug
100
100
  1. **Phase -1**: **MANUAL** - Use `/sp-spec` to create specification with AI assistance
101
101
  2. **Phase 0**: **MANUAL** - Use `/sp-plan` to generate implementation plan
102
102
  3. **Phase 1**: **MANUAL** - Use `/sp-task` to create task breakdown
103
- 4. **Implementation**: Begin development following constitutional principles
103
+ 4. **Implementation**: Begin development following SDD principles
104
104
 
105
105
  ## Context Detection
106
106
 
@@ -85,7 +85,7 @@ When called with `/sp-spec $ARGUMENTS`, I will:
85
85
  ```
86
86
  - Count `[NEEDS CLARIFICATION]` markers
87
87
  - Verify acceptance criteria follow Given-When-Then format
88
- - Check constitutional compliance indicators
88
+ - Check SDD compliance indicators
89
89
  - Report detailed validation results
90
90
 
91
91
  6. **For `/sp-spec clarify`:**
@@ -105,7 +105,7 @@ User: /sp-spec create user authentication system with OAuth2 and JWT tokens
105
105
  ```
106
106
  I will create a comprehensive specification using AI-optimized templates with:
107
107
  - Jinja2-style variables for AI processing
108
- - Constitutional compliance sections
108
+ - SDD compliance sections
109
109
  - Testable acceptance criteria
110
110
  - Automated validation
111
111
 
@@ -137,23 +137,28 @@ I will systematically address all [NEEDS CLARIFICATION] markers.
137
137
 
138
138
  The AI-optimized specification template includes:
139
139
  - **Metadata**: Template variables for AI processing
140
- - **Constitutional Gates**: Pre-implementation validation
140
+ - **SDD Gates**: Pre-implementation validation
141
141
  - **Functional Requirements**: Structured Must/Should/Could/Won't
142
142
  - **User Stories**: Given-When-Then acceptance criteria
143
143
  - **Validation Checklist**: Automated completeness checks
144
144
  - **Integration Points**: AI command workflow guidance
145
145
 
146
- ## Constitutional Compliance
146
+ ## SDD Compliance
147
147
 
148
- **Article III: Test-First**
149
- - [ ] Acceptance criteria written before implementation
150
- - [ ] Test scenarios clearly defined
151
- - [ ] Integration points identified
148
+ **Principle 1: Specification First**
149
+ - [ ] Requirements clearly documented
150
+ - [ ] Acceptance criteria defined
151
+ - [ ] User stories included
152
+
153
+ **Principle 6: Quality Assurance**
154
+ - [ ] Test scenarios defined
155
+ - [ ] Acceptance criteria testable
156
+ - [ ] Quality metrics specified
152
157
 
153
- **Article VI: Research**
158
+ **Principle 7: Architecture Documentation**
154
159
  - [ ] Technology choices documented
160
+ - [ ] Integration points identified
155
161
  - [ ] Security considerations addressed
156
- - [ ] Performance requirements specified
157
162
 
158
163
  ## Enhanced Error Handling
159
164
 
@@ -81,7 +81,7 @@ When called with `/sp-task $ARGUMENTS`, I will:
81
81
  * Layer-based tasks (data, business, API)
82
82
  * Module-specific tasks
83
83
  - **Common categories**:
84
- * Constitutional Gates Compliance
84
+ * SDD Gates Compliance
85
85
  * Critical Path identification
86
86
  * Parallel vs Sequential grouping
87
87
  * Progress Tracking configuration
@@ -120,7 +120,7 @@ When called with `/sp-task $ARGUMENTS`, I will:
120
120
  d. **Parse current tasks** from selected file with comprehensive status:
121
121
  - Total tasks, completed, pending, blocked
122
122
  - Parallel tasks identification
123
- - Constitutional gates status
123
+ - SDD gates status
124
124
  - Completion percentage calculation
125
125
  e. **Interactive task updates**:
126
126
  - Mark tasks as completed/in-progress/blocked
@@ -137,20 +137,20 @@ When called with `/sp-task $ARGUMENTS`, I will:
137
137
  TOTAL_TASKS=25
138
138
  COMPLETED_TASKS=10
139
139
  COMPLETION_PERCENTAGE=40%
140
- CONSTITUTIONAL_GATES_PENDING=2
140
+ SDD_GATES_PENDING=2
141
141
  ```
142
142
  d. **Display comprehensive progress**:
143
143
  - Overall completion percentage
144
144
  - Phase-by-phase progress
145
145
  - Blocker identification and resolution
146
146
  - Velocity metrics and estimates
147
- - Constitutional gates compliance status
147
+ - SDD gates compliance status
148
148
 
149
149
  6. **For `/sp-task execute`:**
150
150
  a. **Show existing task files**: List all task-XXX.md files in current feature directory
151
151
  b. **Ask user to select**: Which task file to execute from
152
152
  c. **Ask user to specify**: Which specific task ID to execute
153
- d. **Validate task readiness** using constitutional gates
153
+ d. **Validate task readiness** using SDD gates
154
154
  e. **Execute task** using AI assistant capabilities:
155
155
  ```markdown
156
156
  ## Task Execution: {{ TASK_ID }}
@@ -215,13 +215,13 @@ metrics:
215
215
  completion_percentage: 40%
216
216
  ```
217
217
 
218
- ## Constitutional Gates Integration
218
+ ## SDD Gates Integration
219
219
 
220
- Each task breakdown includes constitutional compliance validation:
221
- - **Simplicity Gate**: Tasks avoid unnecessary complexity
222
- - **Test-First Gate**: Test tasks before implementation tasks
223
- - **Integration-First Gate**: Real service integration preferred
224
- - **Research Gate**: Technology research tasks included
220
+ Each task breakdown includes SDD compliance validation:
221
+ - **Specification First**: Tasks trace to specifications
222
+ - **Task Decomposition**: Concrete, actionable tasks
223
+ - **Quality Assurance**: Appropriate testing tasks included
224
+ - **Traceable Implementation**: Clear linkage to requirements
225
225
 
226
226
  ## Examples
227
227
 
@@ -264,14 +264,14 @@ I will update task status and recalculate progress metrics.
264
264
  ```
265
265
  User: /sp-task status
266
266
  ```
267
- I will display detailed progress with constitutional gates compliance.
267
+ I will display detailed progress with SDD gates compliance.
268
268
 
269
269
  ### Execute specific task
270
270
  ```
271
271
  User: /sp-task execute T001
272
272
  ```
273
273
  I will:
274
- - Validate: Constitutional gates compliance and task readiness
274
+ - Validate: SDD gates compliance and task readiness
275
275
  - Execute: Cross-platform task execution
276
276
  ```bash
277
277
  bash scripts/sp-pulse-task.sh "$FEATURE_DIR" "execute:$TASK_ID"
@@ -283,7 +283,7 @@ I will:
283
283
  - **Script execution** with Bash
284
284
  - **AI-optimized templates** with Jinja2-style variables
285
285
  - **Script integration** for validation and execution
286
- - **Constitutional gates compliance** tracking
286
+ - **SDD gates compliance** tracking
287
287
  - **Parallel task identification** and execution
288
288
  - **Comprehensive progress tracking** with YAML configuration
289
289
  - **Automatic percentage calculation** and velocity metrics
@@ -294,7 +294,7 @@ I will:
294
294
  ## Error Handling
295
295
 
296
296
  - Plan existence validation before task generation
297
- - Constitutional gates compliance checking
297
+ - SDD gates compliance checking
298
298
  - Template structure validation
299
299
  - Dependency conflict detection
300
300
  - Task execution error handling with rollback
@@ -9,7 +9,7 @@ First, detect current feature context:
9
9
  - If no context found, ask user to specify feature or run /sp-pulse first
10
10
 
11
11
  Parse arguments to determine action:
12
- - If "validate": Check plan against constitution
12
+ - If "validate": Check plan against SDD principles
13
13
  - Otherwise: Generate new plan
14
14
 
15
15
  ## For /sp-plan generate or /sp-plan:
@@ -18,11 +18,11 @@ Parse arguments to determine action:
18
18
  3. Read selected specification from @{specs/*/spec-XXX.md}
19
19
 
20
20
  4. Run Phase Gates checks:
21
- - Constitutional compliance
22
- - Simplicity check (≤3 modules)
23
- - Test-first strategy defined
24
- - Framework selection complete
25
- - Research completed
21
+ - SDD compliance verification
22
+ - Architecture documentation check
23
+ - Quality assurance strategy defined
24
+ - Stakeholder alignment confirmed
25
+ - Incremental planning validated
26
26
 
27
27
  5. Generate plan sections:
28
28
  - Technology stack
@@ -32,9 +32,9 @@ Parse arguments to determine action:
32
32
  - Data models
33
33
  - Testing strategy
34
34
 
35
- 6. Track complexity:
36
- - If >3 modules, document justification
37
- - Create simplification roadmap
35
+ 6. Track architectural decisions:
36
+ - Document all technology choices
37
+ - Record trade-offs and rationale
38
38
 
39
39
  7. Check existing plan files and create next version (plan-001.md, plan-002.md, etc.)
40
40
  8. Write plan to plans/XXX-feature/plan-XXX.md
@@ -48,17 +48,17 @@ Parse arguments to determine action:
48
48
  4. Run validation:
49
49
  - !{bash scripts/sp-pulse-plan.sh "XXX-feature"}
50
50
  5. Verify Phase Gates compliance
51
- 6. Check complexity tracking
52
- 7. Ensure test-first approach
51
+ 6. Check architecture documentation
52
+ 7. Ensure quality assurance strategy
53
53
  8. Validate framework choices
54
54
  9. Report validation results
55
55
 
56
- Phase Gates (Phase -1) must pass before implementation:
57
- - ✅ Using ≤3 projects/modules
58
- - ✅ Tests defined before code
59
- - ✅ Using framework features directly
60
- - ✅ No premature abstractions
61
- - ✅ Research completed
56
+ SDD Compliance Gates must pass before implementation:
57
+ - ✅ Specification clearly defined
58
+ - ✅ Incremental phases planned
59
+ - ✅ Tasks properly decomposed
60
+ - ✅ Quality strategy appropriate
61
+ - ✅ Architecture documented
62
62
 
63
63
  Examples:
64
64
  - /sp-plan generate