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.
- specpulse/__init__.py +1 -1
- specpulse/cli/main.py +32 -6
- specpulse/core/specpulse.py +24 -90
- specpulse/core/validator.py +38 -34
- specpulse/resources/commands/claude/sp-decompose.md +17 -17
- specpulse/resources/commands/claude/sp-plan.md +47 -47
- specpulse/resources/commands/claude/sp-pulse.md +10 -10
- specpulse/resources/commands/claude/sp-spec.md +15 -10
- specpulse/resources/commands/claude/sp-task.md +15 -15
- specpulse/resources/commands/gemini/sp-plan.toml +17 -17
- specpulse/resources/memory/constitution.md +237 -128
- specpulse/resources/scripts/sp-pulse-init.ps1 +131 -0
- specpulse/resources/scripts/sp-pulse-plan.ps1 +147 -0
- specpulse/resources/scripts/sp-pulse-plan.sh +131 -127
- specpulse/resources/scripts/sp-pulse-spec.ps1 +126 -0
- specpulse/resources/scripts/sp-pulse-task.ps1 +166 -0
- specpulse/resources/scripts/sp-pulse-task.sh +6 -6
- specpulse/resources/templates/decomposition/integration-plan.md +6 -5
- specpulse/resources/templates/decomposition/microservices.md +6 -5
- specpulse/resources/templates/decomposition/service-plan.md +6 -5
- specpulse/resources/templates/plan.md +229 -205
- specpulse/resources/templates/task.md +165 -165
- specpulse/utils/version_check.py +128 -0
- {specpulse-1.3.3.dist-info → specpulse-1.4.0.dist-info}/METADATA +70 -29
- {specpulse-1.3.3.dist-info → specpulse-1.4.0.dist-info}/RECORD +29 -24
- {specpulse-1.3.3.dist-info → specpulse-1.4.0.dist-info}/WHEEL +0 -0
- {specpulse-1.3.3.dist-info → specpulse-1.4.0.dist-info}/entry_points.txt +0 -0
- {specpulse-1.3.3.dist-info → specpulse-1.4.0.dist-info}/licenses/LICENSE +0 -0
- {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
|
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
|
-
##
|
56
|
+
## SDD Compliance
|
57
57
|
|
58
|
-
**
|
58
|
+
**Principle 1: Specification First**
|
59
59
|
- [ ] Feature name is clear and specific
|
60
|
-
- [ ]
|
61
|
-
- [ ]
|
60
|
+
- [ ] Ready for requirements documentation
|
61
|
+
- [ ] Structure supports specifications
|
62
62
|
|
63
|
-
**
|
64
|
-
- [ ]
|
65
|
-
- [ ]
|
66
|
-
- [ ]
|
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
|
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
|
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
|
-
-
|
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
|
-
- **
|
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
|
-
##
|
146
|
+
## SDD Compliance
|
147
147
|
|
148
|
-
**
|
149
|
-
- [ ]
|
150
|
-
- [ ]
|
151
|
-
- [ ]
|
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
|
-
**
|
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
|
-
*
|
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
|
-
-
|
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
|
-
|
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
|
-
-
|
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
|
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
|
-
##
|
218
|
+
## SDD Gates Integration
|
219
219
|
|
220
|
-
Each task breakdown includes
|
221
|
-
- **
|
222
|
-
- **
|
223
|
-
- **
|
224
|
-
- **
|
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
|
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:
|
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
|
-
- **
|
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
|
-
-
|
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
|
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
|
-
-
|
22
|
-
-
|
23
|
-
-
|
24
|
-
-
|
25
|
-
-
|
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
|
36
|
-
-
|
37
|
-
-
|
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
|
52
|
-
7. Ensure
|
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
|
-
|
57
|
-
- ✅
|
58
|
-
- ✅
|
59
|
-
- ✅
|
60
|
-
- ✅
|
61
|
-
- ✅
|
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
|