sdd-mcp-server 3.2.0 → 3.4.0

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 (64) hide show
  1. package/README.md +63 -27
  2. package/dist/adapters/cli/SDDToolAdapter.d.ts +5 -1
  3. package/dist/adapters/cli/SDDToolAdapter.js +108 -15
  4. package/dist/adapters/cli/SDDToolAdapter.js.map +1 -1
  5. package/dist/application/services/ContextCompactionService.d.ts +39 -0
  6. package/dist/application/services/ContextCompactionService.js +253 -0
  7. package/dist/application/services/ContextCompactionService.js.map +1 -0
  8. package/dist/application/services/ProjectService.d.ts +7 -1
  9. package/dist/application/services/ProjectService.js +56 -1
  10. package/dist/application/services/ProjectService.js.map +1 -1
  11. package/dist/application/services/TemplateService.js +27 -5
  12. package/dist/application/services/TemplateService.js.map +1 -1
  13. package/dist/application/services/WorkflowEngineService.d.ts +3 -1
  14. package/dist/application/services/WorkflowEngineService.js +20 -5
  15. package/dist/application/services/WorkflowEngineService.js.map +1 -1
  16. package/dist/application/services/WorkflowService.js +8 -0
  17. package/dist/application/services/WorkflowService.js.map +1 -1
  18. package/dist/application/services/staticSteering.js +10 -9
  19. package/dist/application/services/staticSteering.js.map +1 -1
  20. package/dist/cli/install-skills.d.ts +10 -0
  21. package/dist/cli/install-skills.js +79 -64
  22. package/dist/cli/install-skills.js.map +1 -1
  23. package/dist/cli/sdd-mcp-cli.js +7 -0
  24. package/dist/cli/sdd-mcp-cli.js.map +1 -1
  25. package/dist/cli/tool-support/antigravity.d.ts +18 -0
  26. package/dist/cli/tool-support/antigravity.js +79 -0
  27. package/dist/cli/tool-support/antigravity.js.map +1 -0
  28. package/dist/cli/tool-support/codex.d.ts +43 -0
  29. package/dist/cli/tool-support/codex.js +91 -0
  30. package/dist/cli/tool-support/codex.js.map +1 -0
  31. package/dist/cli/tool-support/index.d.ts +4 -0
  32. package/dist/cli/tool-support/index.js +3 -0
  33. package/dist/cli/tool-support/index.js.map +1 -0
  34. package/dist/cli/utils/find-package-root.d.ts +23 -0
  35. package/dist/cli/utils/find-package-root.js +87 -0
  36. package/dist/cli/utils/find-package-root.js.map +1 -0
  37. package/dist/domain/services/DomainService.d.ts +1 -0
  38. package/dist/domain/services/DomainService.js +12 -2
  39. package/dist/domain/services/DomainService.js.map +1 -1
  40. package/dist/domain/types.d.ts +13 -0
  41. package/dist/domain/types.js.map +1 -1
  42. package/dist/domain/workflow/WorkflowStateMachine.js +7 -2
  43. package/dist/domain/workflow/WorkflowStateMachine.js.map +1 -1
  44. package/dist/index.js +341 -20
  45. package/dist/index.js.map +1 -1
  46. package/dist/infrastructure/di/container.js +4 -0
  47. package/dist/infrastructure/di/container.js.map +1 -1
  48. package/dist/infrastructure/di/types.d.ts +1 -0
  49. package/dist/infrastructure/di/types.js +1 -0
  50. package/dist/infrastructure/di/types.js.map +1 -1
  51. package/dist/infrastructure/mcp/ResourceManager.js +21 -1
  52. package/dist/infrastructure/mcp/ResourceManager.js.map +1 -1
  53. package/dist/infrastructure/mcp/ToolRegistry.js +34 -2
  54. package/dist/infrastructure/mcp/ToolRegistry.js.map +1 -1
  55. package/dist/infrastructure/schemas/project.schema.d.ts +47 -4
  56. package/dist/infrastructure/schemas/project.schema.js +39 -2
  57. package/dist/infrastructure/schemas/project.schema.js.map +1 -1
  58. package/dist/utils/sddPaths.d.ts +69 -0
  59. package/dist/utils/sddPaths.js +138 -0
  60. package/dist/utils/sddPaths.js.map +1 -0
  61. package/package.json +2 -2
  62. package/skills/sdd-implement/SKILL.md +6 -4
  63. package/skills/sdd-tasks/SKILL.md +20 -7
  64. package/templates/codex-AGENTS.md +22 -0
@@ -52,7 +52,17 @@ For each task, follow the Red-Green-Refactor cycle:
52
52
  └─────────────────────────────────────────────────────────────┘
53
53
  ```
54
54
 
55
- ### Step 4: Apply Test Pyramid
55
+ ### Step 4: Choose Test Case Review Checkpoint
56
+
57
+ Ask the user whether they want to review TDD test cases before implementation:
58
+
59
+ - If yes, enable the checkpoint when generating tasks by setting `reviewTestCases: true` where the MCP tool supports it, or record the choice in `spec.json` under `workflow_options.review_test_cases`.
60
+ - Generate a concise **Test Case Review Checklist** in `tasks.md` listing the behavior, edge, and error scenarios that need approval.
61
+ - Before approving tasks, the user or agent should run `sdd-review-test-cases` after reviewing the test cases.
62
+
63
+ Keep this checkpoint optional. If the user declines, continue with normal task approval.
64
+
65
+ ### Step 5: Apply Test Pyramid
56
66
 
57
67
  Structure tests following the 70/20/10 ratio:
58
68
 
@@ -75,7 +85,7 @@ Structure tests following the 70/20/10 ratio:
75
85
  | **Integration** | 20% | Component interactions | Medium (s) |
76
86
  | **E2E** | 10% | Full user journeys | Slow (min) |
77
87
 
78
- ### Step 5: Generate Task Breakdown
88
+ ### Step 6: Generate Task Breakdown
79
89
 
80
90
  Structure tasks hierarchically:
81
91
 
@@ -131,11 +141,12 @@ Structure tasks hierarchically:
131
141
  - [ ] All tests pass
132
142
  - [ ] Code coverage >= 80%
133
143
  - [ ] No lint/type errors
144
+ - [ ] TDD test cases reviewed (if checkpoint enabled)
134
145
  - [ ] Code reviewed
135
146
  - [ ] Documentation updated
136
147
  ```
137
148
 
138
- ### Step 6: Task Sizing Guidelines
149
+ ### Step 7: Task Sizing Guidelines
139
150
 
140
151
  | Size | Description | Test Count | Time |
141
152
  |------|-------------|------------|------|
@@ -144,7 +155,7 @@ Structure tasks hierarchically:
144
155
  | **L** | Component with integration | 5-10 | 4-8 hours |
145
156
  | **XL** | Complex component, many edge cases | 10+ | 1-2 days |
146
157
 
147
- ### Step 7: Test-First Task Template
158
+ ### Step 8: Test-First Task Template
148
159
 
149
160
  For each implementation task:
150
161
 
@@ -196,17 +207,19 @@ describe('{Component}', () => {
196
207
  - Apply {specific pattern}
197
208
  ```
198
209
 
199
- ### Step 8: Save and Execute
210
+ ### Step 9: Save and Execute
200
211
 
201
212
  1. Save tasks to `.spec/specs/{feature}/tasks.md`
202
- 2. Use `sdd-approve tasks` MCP tool to mark phase complete
203
- 3. Use `sdd-spec-impl` MCP tool to execute tasks with TDD
213
+ 2. If test-case review is enabled, review the Test Case Review Checklist and run `sdd-review-test-cases`
214
+ 3. Use `sdd-approve tasks` MCP tool to mark phase complete
215
+ 4. Use `sdd-spec-impl` MCP tool to execute tasks with TDD
204
216
 
205
217
  ## MCP Tool Integration
206
218
 
207
219
  | Tool | When to Use |
208
220
  |------|-------------|
209
221
  | `sdd-status` | Verify design phase complete |
222
+ | `sdd-review-test-cases` | Mark optional TDD test-case review complete |
210
223
  | `sdd-approve` | Mark tasks phase as approved |
211
224
  | `sdd-spec-impl` | Execute tasks using TDD methodology |
212
225
  | `sdd-quality-check` | Validate code quality during implementation |
@@ -0,0 +1,22 @@
1
+ # AGENTS.md — Spec-Driven Development (SDD)
2
+
3
+ This project uses the SDD workflow powered by `sdd-mcp-server`.
4
+
5
+ ## Development Paths
6
+
7
+ ### Simple Tasks
8
+ For small features, bug fixes, and quick enhancements — just start coding with best practices.
9
+
10
+ ### Full SDD Workflow
11
+ For complex features requiring formal specification:
12
+
13
+ ```
14
+ Initialize → Requirements → Design → Tasks → Implement
15
+ ```
16
+
17
+ Each phase builds on the previous and requires review before proceeding.
18
+
19
+ ## Installed Components
20
+
21
+ The SDD components are stored in `.claude/` directories. Read the referenced files for full details.
22
+