@polymorphism-tech/morph-spec 4.8.19 → 4.10.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 (214) hide show
  1. package/CLAUDE.md +21 -0
  2. package/README.md +2 -2
  3. package/bin/morph-spec.js +44 -55
  4. package/bin/task-manager.js +133 -20
  5. package/bin/validate.js +67 -33
  6. package/claude-plugin.json +1 -1
  7. package/docs/CHEATSHEET.md +201 -203
  8. package/docs/QUICKSTART.md +2 -2
  9. package/framework/CLAUDE.md +99 -77
  10. package/framework/agents.json +734 -182
  11. package/framework/commands/commit.md +166 -0
  12. package/framework/commands/morph-apply.md +13 -2
  13. package/framework/commands/morph-archive.md +8 -2
  14. package/framework/commands/morph-infra.md +6 -0
  15. package/framework/commands/morph-preflight.md +6 -0
  16. package/framework/commands/morph-proposal.md +56 -7
  17. package/framework/commands/morph-status.md +6 -0
  18. package/framework/commands/morph-troubleshoot.md +6 -0
  19. package/framework/hooks/claude-code/notification/approval-reminder.js +3 -2
  20. package/framework/hooks/claude-code/post-tool-use/context-refresh.js +1 -1
  21. package/framework/hooks/claude-code/post-tool-use/dispatch.js +155 -32
  22. package/framework/hooks/claude-code/post-tool-use/skill-reminder.js +78 -0
  23. package/framework/hooks/claude-code/post-tool-use/validator-feedback.js +8 -17
  24. package/framework/hooks/claude-code/pre-compact/save-morph-context.js +16 -3
  25. package/framework/hooks/claude-code/pre-tool-use/enforce-phase-writes.js +4 -3
  26. package/framework/hooks/claude-code/pre-tool-use/protect-spec-files.js +4 -3
  27. package/framework/hooks/claude-code/pre-tool-use/task-tracking-guard.js +60 -0
  28. package/framework/hooks/claude-code/session-start/inject-morph-context.js +124 -2
  29. package/framework/hooks/claude-code/session-start/post-compact-restore.js +41 -0
  30. package/framework/hooks/claude-code/statusline.py +76 -30
  31. package/framework/hooks/claude-code/stop/validate-completion.js +2 -15
  32. package/framework/hooks/claude-code/user-prompt/enrich-prompt.js +23 -5
  33. package/framework/hooks/claude-code/user-prompt/set-terminal-title.js +14 -6
  34. package/framework/hooks/shared/activity-logger.js +0 -24
  35. package/framework/hooks/shared/compact-restore.js +100 -0
  36. package/framework/hooks/shared/dispatch-helpers.js +116 -0
  37. package/framework/hooks/shared/phase-utils.js +12 -5
  38. package/framework/hooks/shared/skill-reminder-helpers.js +79 -0
  39. package/framework/hooks/shared/stale-task-reset.js +57 -0
  40. package/framework/hooks/shared/state-reader.js +29 -5
  41. package/framework/hooks/shared/worktree-helpers.js +53 -0
  42. package/framework/phases.json +69 -14
  43. package/framework/rules/morph-workflow.md +88 -86
  44. package/framework/skills/level-0-meta/mcp-registry.json +86 -51
  45. package/framework/skills/level-0-meta/{brainstorming → morph-brainstorming}/SKILL.md +14 -17
  46. package/framework/skills/level-0-meta/morph-checklist/SKILL.md +2 -2
  47. package/framework/skills/level-0-meta/{code-review → morph-code-review}/SKILL.md +2 -2
  48. package/framework/skills/level-0-meta/{code-review-nextjs → morph-code-review-nextjs}/SKILL.md +163 -163
  49. package/framework/skills/level-0-meta/{frontend-review → morph-frontend-review}/SKILL.md +9 -9
  50. package/framework/skills/level-0-meta/morph-init/SKILL.md +77 -12
  51. package/framework/skills/level-0-meta/{post-implementation → morph-post-implementation}/SKILL.md +62 -15
  52. package/framework/skills/level-0-meta/morph-replicate/SKILL.md +5 -5
  53. package/framework/skills/level-0-meta/morph-replicate/references/blazor-html-mapping.md +1 -1
  54. package/framework/skills/level-0-meta/{simulation-checklist → morph-simulation-checklist}/SKILL.md +1 -1
  55. package/framework/skills/level-0-meta/{terminal-title → morph-terminal-title}/SKILL.md +2 -2
  56. package/framework/skills/level-0-meta/{tool-usage-guide → morph-tool-usage-guide}/SKILL.md +3 -4
  57. package/framework/skills/level-0-meta/{tool-usage-guide → morph-tool-usage-guide}/references/tools-per-phase.md +7 -7
  58. package/framework/skills/level-0-meta/{verification-before-completion → morph-verification-before-completion}/SKILL.md +2 -2
  59. package/framework/skills/level-0-meta/{verification-before-completion → morph-verification-before-completion}/scripts/check-phase-outputs.mjs +2 -2
  60. package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md +238 -0
  61. package/framework/skills/level-1-workflows/{phase-codebase-analysis → morph-phase-codebase-analysis}/SKILL.md +3 -3
  62. package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +507 -0
  63. package/framework/skills/level-1-workflows/{phase-implement → morph-phase-implement}/SKILL.md +168 -27
  64. package/framework/skills/level-1-workflows/morph-phase-implement/prompts/code-quality-reviewer-prompt.md +50 -0
  65. package/framework/skills/level-1-workflows/morph-phase-implement/prompts/implementer-prompt.md +45 -0
  66. package/framework/skills/level-1-workflows/morph-phase-implement/prompts/spec-reviewer-prompt.md +47 -0
  67. package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +254 -0
  68. package/framework/skills/level-1-workflows/{phase-setup → morph-phase-setup}/SKILL.md +50 -3
  69. package/framework/skills/level-1-workflows/{phase-tasks → morph-phase-tasks}/SKILL.md +48 -11
  70. package/framework/skills/level-1-workflows/{phase-tasks → morph-phase-tasks}/scripts/validate-tasks.mjs +3 -3
  71. package/framework/skills/level-1-workflows/{phase-uiux → morph-phase-uiux}/SKILL.md +46 -11
  72. package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +97 -0
  73. package/framework/standards/STANDARDS.json +640 -88
  74. package/framework/standards/infrastructure/vercel/vercel-database.md +106 -0
  75. package/framework/standards/integration/mcp/mcp-tools.md +25 -7
  76. package/framework/templates/REGISTRY.json +1825 -1909
  77. package/framework/templates/context/CONTEXT-FEATURE.md +276 -276
  78. package/framework/templates/docs/onboarding.md +3 -7
  79. package/package.json +2 -7
  80. package/src/commands/agents/dispatch-agents.js +104 -6
  81. package/src/commands/mcp/mcp-setup.js +39 -2
  82. package/src/commands/phase/phase-reset.js +74 -0
  83. package/src/commands/project/doctor.js +34 -51
  84. package/src/commands/project/init.js +1 -1
  85. package/src/commands/project/status.js +2 -2
  86. package/src/commands/project/update.js +381 -365
  87. package/src/commands/project/worktree.js +154 -0
  88. package/src/commands/scope/escalate.js +215 -0
  89. package/src/commands/state/advance-phase.js +132 -68
  90. package/src/commands/state/approve.js +2 -2
  91. package/src/commands/state/index.js +7 -8
  92. package/src/commands/state/phase-runner.js +1 -1
  93. package/src/commands/state/state.js +61 -6
  94. package/src/commands/task/expand.js +100 -0
  95. package/src/commands/tasks/task.js +78 -99
  96. package/src/commands/templates/template-render.js +93 -173
  97. package/src/commands/trust/trust.js +26 -21
  98. package/src/core/paths/output-schema.js +19 -3
  99. package/src/core/state/phase-state-machine.js +7 -4
  100. package/src/core/state/state-manager.js +32 -57
  101. package/src/core/workflows/workflow-detector.js +9 -87
  102. package/src/lib/detectors/claude-config-detector.js +93 -347
  103. package/src/lib/detectors/design-system-detector.js +189 -189
  104. package/src/lib/detectors/index.js +155 -57
  105. package/src/lib/generators/context-generator.js +2 -2
  106. package/src/lib/installers/mcp-installer.js +37 -5
  107. package/src/lib/phase-chain/phase-validator.js +336 -0
  108. package/src/lib/scope/impact-analyzer.js +106 -0
  109. package/src/lib/stack/stack-profile.js +88 -0
  110. package/src/lib/tasks/task-classifier.js +16 -0
  111. package/src/lib/tasks/task-parser.js +1 -1
  112. package/src/lib/tasks/test-runner.js +77 -0
  113. package/src/lib/trust/trust-manager.js +32 -144
  114. package/src/lib/validators/shared/emit-validator-dispatch.js +64 -0
  115. package/src/lib/validators/spec-validator.js +58 -4
  116. package/src/lib/validators/validation-runner.js +23 -11
  117. package/src/scripts/setup-infra.js +255 -224
  118. package/src/utils/agents-installer.js +34 -14
  119. package/src/utils/banner.js +1 -1
  120. package/src/utils/claude-settings-manager.js +1 -1
  121. package/src/utils/file-copier.js +1 -1
  122. package/src/utils/hooks-installer.js +272 -8
  123. package/framework/hooks/dev/check-sync-health.js +0 -117
  124. package/framework/hooks/dev/guard-version-numbers.js +0 -57
  125. package/framework/hooks/dev/sync-standards-registry.js +0 -60
  126. package/framework/hooks/dev/sync-template-registry.js +0 -60
  127. package/framework/hooks/dev/validate-skill-format.js +0 -70
  128. package/framework/hooks/dev/validate-standard-format.js +0 -73
  129. package/framework/skills/level-1-workflows/phase-clarify/SKILL.md +0 -190
  130. package/framework/skills/level-1-workflows/phase-design/SKILL.md +0 -366
  131. package/framework/templates/meta-prompts/hops/hop-retry.md +0 -78
  132. package/framework/templates/meta-prompts/hops/hop-validation.md +0 -97
  133. package/framework/templates/meta-prompts/hops/hop-wrapper.md +0 -36
  134. package/framework/workflows/configs/design-impl.json +0 -49
  135. package/framework/workflows/configs/express.json +0 -45
  136. package/framework/workflows/configs/fast-track.json +0 -42
  137. package/framework/workflows/configs/full-morph.json +0 -79
  138. package/framework/workflows/configs/fusion.json +0 -39
  139. package/framework/workflows/configs/long-running.json +0 -33
  140. package/framework/workflows/configs/spec-only.json +0 -43
  141. package/framework/workflows/configs/ui-refresh.json +0 -49
  142. package/framework/workflows/configs/zero-touch.json +0 -82
  143. package/src/commands/project/index.js +0 -8
  144. package/src/commands/project/monitor.js +0 -295
  145. package/src/commands/project/tutorial.js +0 -115
  146. package/src/commands/state/validate-phase.js +0 -238
  147. package/src/commands/templates/generate-contracts.js +0 -445
  148. package/src/core/index.js +0 -10
  149. package/src/core/orchestrator.js +0 -171
  150. package/src/core/registry/command-registry.js +0 -28
  151. package/src/core/registry/index.js +0 -8
  152. package/src/core/registry/validator-registry.js +0 -204
  153. package/src/core/state/index.js +0 -8
  154. package/src/core/templates/index.js +0 -9
  155. package/src/core/templates/template-data-sources.js +0 -325
  156. package/src/core/templates/template-validator.js +0 -296
  157. package/src/core/workflows/index.js +0 -7
  158. package/src/generator/config-generator.js +0 -206
  159. package/src/generator/templates/config.json.template +0 -40
  160. package/src/generator/templates/project.md.template +0 -67
  161. package/src/lib/agents/micro-agent-factory.js +0 -161
  162. package/src/lib/analysis/complexity-analyzer.js +0 -441
  163. package/src/lib/analysis/index.js +0 -7
  164. package/src/lib/analytics/analytics-engine.js +0 -345
  165. package/src/lib/checkpoints/checkpoint-hooks.js +0 -298
  166. package/src/lib/checkpoints/index.js +0 -7
  167. package/src/lib/context/context-bundler.js +0 -241
  168. package/src/lib/context/context-optimizer.js +0 -212
  169. package/src/lib/context/context-tracker.js +0 -273
  170. package/src/lib/context/core-four-tracker.js +0 -201
  171. package/src/lib/context/mcp-optimizer.js +0 -200
  172. package/src/lib/detectors/config-detector.js +0 -223
  173. package/src/lib/detectors/standards-generator.js +0 -335
  174. package/src/lib/detectors/structure-detector.js +0 -275
  175. package/src/lib/execution/fusion-executor.js +0 -304
  176. package/src/lib/execution/parallel-executor.js +0 -270
  177. package/src/lib/hooks/stop-hook-executor.js +0 -286
  178. package/src/lib/hops/hop-composer.js +0 -221
  179. package/src/lib/monitor/agent-resolver.js +0 -144
  180. package/src/lib/monitor/renderer.js +0 -230
  181. package/src/lib/orchestration/index.js +0 -7
  182. package/src/lib/orchestration/team-orchestrator.js +0 -404
  183. package/src/lib/phase-chain/eligibility-checker.js +0 -243
  184. package/src/lib/threads/thread-coordinator.js +0 -238
  185. package/src/lib/threads/thread-manager.js +0 -317
  186. package/src/lib/tracking/artifact-trail.js +0 -202
  187. package/src/sanitizer/context-sanitizer.js +0 -221
  188. package/src/sanitizer/patterns.js +0 -163
  189. package/src/scanner/project-scanner.js +0 -242
  190. package/src/ui/diff-display.js +0 -91
  191. package/src/ui/interactive-wizard.js +0 -96
  192. package/src/ui/user-review.js +0 -211
  193. package/src/ui/wizard-questions.js +0 -188
  194. package/src/utils/color-utils.js +0 -70
  195. package/src/utils/process-handler.js +0 -97
  196. package/src/writer/file-writer.js +0 -86
  197. /package/framework/skills/level-0-meta/{brainstorming → morph-brainstorming}/references/proposal-example.md +0 -0
  198. /package/framework/skills/level-0-meta/{code-review → morph-code-review}/references/review-example.md +0 -0
  199. /package/framework/skills/level-0-meta/{code-review → morph-code-review}/references/review-guidelines.md +0 -0
  200. /package/framework/skills/level-0-meta/{code-review → morph-code-review}/scripts/scan-csharp.mjs +0 -0
  201. /package/framework/skills/level-0-meta/{code-review-nextjs → morph-code-review-nextjs}/references/review-example-nextjs.md +0 -0
  202. /package/framework/skills/level-0-meta/{code-review-nextjs → morph-code-review-nextjs}/scripts/scan-nextjs.mjs +0 -0
  203. /package/framework/skills/level-0-meta/{frontend-review → morph-frontend-review}/scripts/scan-accessibility.mjs +0 -0
  204. /package/framework/skills/level-0-meta/{post-implementation → morph-post-implementation}/scripts/detect-dev-server.mjs +0 -0
  205. /package/framework/skills/level-0-meta/{post-implementation → morph-post-implementation}/scripts/detect-stack.mjs +0 -0
  206. /package/framework/skills/level-0-meta/{terminal-title → morph-terminal-title}/scripts/set_title.sh +0 -0
  207. /package/framework/skills/level-1-workflows/{phase-clarify → morph-phase-clarify}/references/clarifications-example.md +0 -0
  208. /package/framework/skills/level-1-workflows/{phase-design → morph-phase-design}/references/architecture-analysis-guide.md +0 -0
  209. /package/framework/skills/level-1-workflows/{phase-design → morph-phase-design}/references/spec-authoring-guide.md +0 -0
  210. /package/framework/skills/level-1-workflows/{phase-design → morph-phase-design}/references/spec-example.md +0 -0
  211. /package/framework/skills/level-1-workflows/{phase-implement → morph-phase-implement}/references/recap-example.md +0 -0
  212. /package/framework/skills/level-1-workflows/{phase-implement → morph-phase-implement}/references/vsa-implementation-guide.md +0 -0
  213. /package/framework/skills/level-1-workflows/{phase-tasks → morph-phase-tasks}/references/task-planning-patterns.md +0 -0
  214. /package/framework/skills/level-1-workflows/{phase-tasks → morph-phase-tasks}/references/tasks-example.md +0 -0
@@ -1,276 +1,276 @@
1
- # {{FEATURE_NAME}} - Feature Context
2
-
3
- > Auto-generated by MORPH-SPEC Framework
4
- > Last updated: {{TIMESTAMP}}
5
-
6
- ## Feature Overview
7
-
8
- **Name:** {{FEATURE_NAME}}
9
- **Phase:** {{PHASE}} ({{WORKFLOW_TYPE}})
10
- **Status:** {{STATUS}}
11
- **Complexity:** {{COMPLEXITY}}
12
-
13
- {{#if DESCRIPTION}}
14
- {{DESCRIPTION}}
15
- {{/if}}
16
-
17
- ---
18
-
19
- ## Progress Tracking
20
-
21
- ### Current Phase: {{PHASE}}
22
-
23
- {{PHASE_DESCRIPTION}}
24
-
25
- **Completed Phases:**
26
- {{#each COMPLETED_PHASES}}
27
- - ✅ {{name}} - {{completedAt}}
28
- {{/each}}
29
-
30
- **Next Phases:**
31
- {{#each UPCOMING_PHASES}}
32
- - ⏭️ {{name}}
33
- {{/each}}
34
-
35
- ### Task Progress
36
-
37
- **Total Tasks:** {{TASKS_TOTAL}}
38
- **Completed:** {{TASKS_COMPLETED}} ({{TASKS_PROGRESS}}%)
39
- **In Progress:** {{TASKS_IN_PROGRESS}}
40
- **Blocked:** {{TASKS_BLOCKED}}
41
-
42
- {{#if CURRENT_TASK}}
43
- **Current Task:** {{CURRENT_TASK.id}} - {{CURRENT_TASK.title}}
44
- {{/if}}
45
-
46
- ---
47
-
48
- ## Active Agents ({{ACTIVE_AGENTS_COUNT}})
49
-
50
- ### Team Structure
51
-
52
- {{#if TEAM_LEAD}}
53
- **Team Lead:** {{TEAM_LEAD.title}} (`{{TEAM_LEAD.id}}`)
54
- {{/if}}
55
-
56
- {{#each SQUADS}}
57
- ### {{leader.title}} Squad
58
- **Leader:** `{{leader.id}}`
59
- **Members ({{members.length}}):**
60
- {{#each members}}
61
- - {{title}} (`{{id}}`) {{#if status}}[{{status}}]{{/if}}
62
- {{/each}}
63
- {{/each}}
64
-
65
- ### Validators (Run in Hooks)
66
- {{#each VALIDATORS}}
67
- - {{title}} (`{{id}}`)
68
- {{/each}}
69
-
70
- ---
71
-
72
- ## Agent Teams
73
-
74
- {{#if AGENT_TEAMS_DECISION}}
75
- {{#if AGENT_TEAMS_DECISION.useAgentTeams}}
76
- ✅ **Agent Teams Recommended**
77
-
78
- **Reason:** {{AGENT_TEAMS_DECISION.reason}}
79
- **Display Mode:** {{AGENT_TEAMS_DECISION.displayMode}}
80
- **Total Teammates:** {{AGENT_TEAMS_DECISION.totalTeammates}}
81
-
82
- **Team Composition:**
83
- - Team Lead: {{AGENT_TEAMS_DECISION.teamLead}}
84
- - Domain Leaders: {{AGENT_TEAMS_DECISION.squads}}
85
- - Validators (hooks): {{AGENT_TEAMS_DECISION.validators}}
86
-
87
- {{else}}
88
- ❌ **Single Session Recommended**
89
-
90
- **Reason:** {{AGENT_TEAMS_DECISION.reason}}
91
- **Recommendation:** {{AGENT_TEAMS_DECISION.recommendation}}
92
- {{/if}}
93
- {{/if}}
94
-
95
- ---
96
-
97
- ## Outputs Generated
98
-
99
- {{#each OUTPUTS}}
100
- ### {{type}}
101
- **Status:** {{#if generated}}✅ Generated{{else}}⏳ Pending{{/if}}
102
- {{#if path}}**Path:** `{{path}}`{{/if}}
103
- {{#if generatedAt}}**Generated:** {{generatedAt}}{{/if}}
104
- {{/each}}
105
-
106
- ---
107
-
108
- ## Decisions Log
109
-
110
- {{#each DECISIONS}}
111
- ### ADR-{{id}}: {{title}}
112
-
113
- **Status:** {{status}}
114
- **Date:** {{date}}
115
- **Decided By:** {{decidedBy}}
116
-
117
- **Context:** {{context}}
118
-
119
- **Decision:** {{decision}}
120
-
121
- {{#if constraints}}
122
- **Constraints for Validators:**
123
- ```json
124
- {{constraints}}
125
- ```
126
- {{/if}}
127
-
128
- {{#if alternatives}}
129
- **Alternatives Considered:**
130
- {{#each alternatives}}
131
- - {{name}}: {{rationale}}
132
- {{/each}}
133
- {{/if}}
134
-
135
- ---
136
- {{/each}}
137
-
138
- {{#unless DECISIONS}}
139
- No decisions documented yet. Decisions will be logged in `decisions.md` during Design phase.
140
- {{/unless}}
141
-
142
- ---
143
-
144
- ## Validation Status
145
-
146
- {{#if VALIDATION_RESULTS}}
147
- ### Latest Validation ({{VALIDATION_TIMESTAMP}})
148
-
149
- **Overall:** {{#if VALIDATION_PASSED}}✅ PASSED{{else}}❌ FAILED{{/if}}
150
-
151
- {{#each VALIDATION_RESULTS}}
152
- #### {{validator}}
153
- **Status:** {{#if passed}}✅ PASSED{{else}}❌ FAILED{{/if}}
154
- {{#if issues}}
155
- **Issues ({{issues.length}}):**
156
- {{#each issues}}
157
- - [{{severity}}] {{message}} ({{file}}:{{line}})
158
- {{/each}}
159
- {{/if}}
160
- {{/each}}
161
-
162
- {{else}}
163
- No validation runs yet. Validators run automatically via checkpoints.
164
- {{/if}}
165
-
166
- ---
167
-
168
- ## Tasks Breakdown
169
-
170
- {{#each TASKS}}
171
- ### {{id}}: {{title}}
172
-
173
- **Status:** {{status}}
174
- {{#if priority}}**Priority:** {{priority}}{{/if}}
175
- {{#if estimatedFiles}}**Estimated Files:** {{estimatedFiles}}{{/if}}
176
- {{#if dependencies}}**Dependencies:** {{dependencies}}{{/if}}
177
-
178
- {{#if description}}
179
- {{description}}
180
- {{/if}}
181
-
182
- {{#if agent}}**Assigned Agent:** `{{agent}}`{{/if}}
183
-
184
- {{#if checkpointAfter}}🔖 **Checkpoint after this task**{{/if}}
185
-
186
- {{#if completedAt}}✅ Completed: {{completedAt}}{{/if}}
187
- {{#if blockedReason}}❌ Blocked: {{blockedReason}}{{/if}}
188
-
189
- ---
190
- {{/each}}
191
-
192
- ---
193
-
194
- ## Checkpoints
195
-
196
- {{#each CHECKPOINTS}}
197
- ### {{timestamp}}
198
- **Phase:** {{phase}}
199
- **Tasks Completed:** {{tasksCompleted}}/{{tasksTotal}}
200
-
201
- {{#if note}}
202
- **Note:** {{note}}
203
- {{/if}}
204
-
205
- {{#if validation}}
206
- **Validation:** {{validation.passed}}/{{validation.total}} checks passed
207
- {{#if validation.issues}}
208
- - Issues: {{validation.issues}}
209
- {{/if}}
210
- {{/if}}
211
-
212
- ---
213
- {{/each}}
214
-
215
- ---
216
-
217
- ## Related Standards
218
-
219
- {{#each RELATED_STANDARDS}}
220
- ### {{name}}
221
- **Path:** `{{path}}`
222
- {{#if relevantSections}}
223
- **Relevant Sections:** {{relevantSections}}
224
- {{/if}}
225
- {{/each}}
226
-
227
- ---
228
-
229
- ## Quick Actions
230
-
231
- ### Continue Implementation
232
- ```bash
233
- # Start next task
234
- morph-spec task next {{FEATURE_NAME}}
235
-
236
- # Complete current task (runs validators)
237
- morph-spec task done {{FEATURE_NAME}} {{CURRENT_TASK_ID}}
238
-
239
- # Generate recap after task completion
240
- morph-spec generate recap {{FEATURE_NAME}}
241
- ```
242
-
243
- ### Advance Phase
244
- ```bash
245
- # Check prerequisites and advance
246
- morph-spec phase advance {{FEATURE_NAME}}
247
-
248
- # Validate current phase before advancing
249
- morph-spec validate-phase {{FEATURE_NAME}} {{PHASE}}
250
- ```
251
-
252
- ### Validation
253
- ```bash
254
- # Run all validators for active agents
255
- morph-spec validate {{FEATURE_NAME}}
256
-
257
- # Run specific validator
258
- morph-spec validate-{{VALIDATOR}} {{FEATURE_NAME}}
259
- ```
260
-
261
- ---
262
-
263
- ## File Paths
264
-
265
- - **Outputs Directory:** `.morph/features/{{FEATURE_NAME}}/`
266
- - **Proposal:** `{{PROPOSAL_PATH}}`
267
- - **Spec:** `{{SPEC_PATH}}`
268
- - **Contracts:** `{{CONTRACTS_PATH}}`
269
- - **Tasks:** `{{TASKS_PATH}}`
270
- - **Decisions:** `{{DECISIONS_PATH}}`
271
- - **Recap:** `{{RECAP_PATH}}`
272
-
273
- ---
274
-
275
- *Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*
276
- *Feature ID: {{FEATURE_ID}}*
1
+ # {{FEATURE_NAME}} - Feature Context
2
+
3
+ > Auto-generated by MORPH-SPEC Framework
4
+ > Last updated: {{TIMESTAMP}}
5
+
6
+ ## Feature Overview
7
+
8
+ **Name:** {{FEATURE_NAME}}
9
+ **Phase:** {{PHASE}} ({{WORKFLOW_TYPE}})
10
+ **Status:** {{STATUS}}
11
+ **Complexity:** {{COMPLEXITY}}
12
+
13
+ {{#if DESCRIPTION}}
14
+ {{DESCRIPTION}}
15
+ {{/if}}
16
+
17
+ ---
18
+
19
+ ## Progress Tracking
20
+
21
+ ### Current Phase: {{PHASE}}
22
+
23
+ {{PHASE_DESCRIPTION}}
24
+
25
+ **Completed Phases:**
26
+ {{#each COMPLETED_PHASES}}
27
+ - ✅ {{name}} - {{completedAt}}
28
+ {{/each}}
29
+
30
+ **Next Phases:**
31
+ {{#each UPCOMING_PHASES}}
32
+ - ⏭️ {{name}}
33
+ {{/each}}
34
+
35
+ ### Task Progress
36
+
37
+ **Total Tasks:** {{TASKS_TOTAL}}
38
+ **Completed:** {{TASKS_COMPLETED}} ({{TASKS_PROGRESS}}%)
39
+ **In Progress:** {{TASKS_IN_PROGRESS}}
40
+ **Blocked:** {{TASKS_BLOCKED}}
41
+
42
+ {{#if CURRENT_TASK}}
43
+ **Current Task:** {{CURRENT_TASK.id}} - {{CURRENT_TASK.title}}
44
+ {{/if}}
45
+
46
+ ---
47
+
48
+ ## Active Agents ({{ACTIVE_AGENTS_COUNT}})
49
+
50
+ ### Team Structure
51
+
52
+ {{#if TEAM_LEAD}}
53
+ **Team Lead:** {{TEAM_LEAD.title}} (`{{TEAM_LEAD.id}}`)
54
+ {{/if}}
55
+
56
+ {{#each SQUADS}}
57
+ ### {{leader.title}} Squad
58
+ **Leader:** `{{leader.id}}`
59
+ **Members ({{members.length}}):**
60
+ {{#each members}}
61
+ - {{title}} (`{{id}}`) {{#if status}}[{{status}}]{{/if}}
62
+ {{/each}}
63
+ {{/each}}
64
+
65
+ ### Validators (Run in Hooks)
66
+ {{#each VALIDATORS}}
67
+ - {{title}} (`{{id}}`)
68
+ {{/each}}
69
+
70
+ ---
71
+
72
+ ## Agent Teams
73
+
74
+ {{#if AGENT_TEAMS_DECISION}}
75
+ {{#if AGENT_TEAMS_DECISION.useAgentTeams}}
76
+ ✅ **Agent Teams Recommended**
77
+
78
+ **Reason:** {{AGENT_TEAMS_DECISION.reason}}
79
+ **Display Mode:** {{AGENT_TEAMS_DECISION.displayMode}}
80
+ **Total Teammates:** {{AGENT_TEAMS_DECISION.totalTeammates}}
81
+
82
+ **Team Composition:**
83
+ - Team Lead: {{AGENT_TEAMS_DECISION.teamLead}}
84
+ - Domain Leaders: {{AGENT_TEAMS_DECISION.squads}}
85
+ - Validators (hooks): {{AGENT_TEAMS_DECISION.validators}}
86
+
87
+ {{else}}
88
+ ❌ **Single Session Recommended**
89
+
90
+ **Reason:** {{AGENT_TEAMS_DECISION.reason}}
91
+ **Recommendation:** {{AGENT_TEAMS_DECISION.recommendation}}
92
+ {{/if}}
93
+ {{/if}}
94
+
95
+ ---
96
+
97
+ ## Outputs Generated
98
+
99
+ {{#each OUTPUTS}}
100
+ ### {{type}}
101
+ **Status:** {{#if generated}}✅ Generated{{else}}⏳ Pending{{/if}}
102
+ {{#if path}}**Path:** `{{path}}`{{/if}}
103
+ {{#if generatedAt}}**Generated:** {{generatedAt}}{{/if}}
104
+ {{/each}}
105
+
106
+ ---
107
+
108
+ ## Decisions Log
109
+
110
+ {{#each DECISIONS}}
111
+ ### ADR-{{id}}: {{title}}
112
+
113
+ **Status:** {{status}}
114
+ **Date:** {{date}}
115
+ **Decided By:** {{decidedBy}}
116
+
117
+ **Context:** {{context}}
118
+
119
+ **Decision:** {{decision}}
120
+
121
+ {{#if constraints}}
122
+ **Constraints for Validators:**
123
+ ```json
124
+ {{constraints}}
125
+ ```
126
+ {{/if}}
127
+
128
+ {{#if alternatives}}
129
+ **Alternatives Considered:**
130
+ {{#each alternatives}}
131
+ - {{name}}: {{rationale}}
132
+ {{/each}}
133
+ {{/if}}
134
+
135
+ ---
136
+ {{/each}}
137
+
138
+ {{#unless DECISIONS}}
139
+ No decisions documented yet. Decisions will be logged in `decisions.md` during Design phase.
140
+ {{/unless}}
141
+
142
+ ---
143
+
144
+ ## Validation Status
145
+
146
+ {{#if VALIDATION_RESULTS}}
147
+ ### Latest Validation ({{VALIDATION_TIMESTAMP}})
148
+
149
+ **Overall:** {{#if VALIDATION_PASSED}}✅ PASSED{{else}}❌ FAILED{{/if}}
150
+
151
+ {{#each VALIDATION_RESULTS}}
152
+ #### {{validator}}
153
+ **Status:** {{#if passed}}✅ PASSED{{else}}❌ FAILED{{/if}}
154
+ {{#if issues}}
155
+ **Issues ({{issues.length}}):**
156
+ {{#each issues}}
157
+ - [{{severity}}] {{message}} ({{file}}:{{line}})
158
+ {{/each}}
159
+ {{/if}}
160
+ {{/each}}
161
+
162
+ {{else}}
163
+ No validation runs yet. Validators run automatically via checkpoints.
164
+ {{/if}}
165
+
166
+ ---
167
+
168
+ ## Tasks Breakdown
169
+
170
+ {{#each TASKS}}
171
+ ### {{id}}: {{title}}
172
+
173
+ **Status:** {{status}}
174
+ {{#if priority}}**Priority:** {{priority}}{{/if}}
175
+ {{#if estimatedFiles}}**Estimated Files:** {{estimatedFiles}}{{/if}}
176
+ {{#if dependencies}}**Dependencies:** {{dependencies}}{{/if}}
177
+
178
+ {{#if description}}
179
+ {{description}}
180
+ {{/if}}
181
+
182
+ {{#if agent}}**Assigned Agent:** `{{agent}}`{{/if}}
183
+
184
+ {{#if checkpointAfter}}🔖 **Checkpoint after this task**{{/if}}
185
+
186
+ {{#if completedAt}}✅ Completed: {{completedAt}}{{/if}}
187
+ {{#if blockedReason}}❌ Blocked: {{blockedReason}}{{/if}}
188
+
189
+ ---
190
+ {{/each}}
191
+
192
+ ---
193
+
194
+ ## Checkpoints
195
+
196
+ {{#each CHECKPOINTS}}
197
+ ### {{timestamp}}
198
+ **Phase:** {{phase}}
199
+ **Tasks Completed:** {{tasksCompleted}}/{{tasksTotal}}
200
+
201
+ {{#if note}}
202
+ **Note:** {{note}}
203
+ {{/if}}
204
+
205
+ {{#if validation}}
206
+ **Validation:** {{validation.passed}}/{{validation.total}} checks passed
207
+ {{#if validation.issues}}
208
+ - Issues: {{validation.issues}}
209
+ {{/if}}
210
+ {{/if}}
211
+
212
+ ---
213
+ {{/each}}
214
+
215
+ ---
216
+
217
+ ## Related Standards
218
+
219
+ {{#each RELATED_STANDARDS}}
220
+ ### {{name}}
221
+ **Path:** `{{path}}`
222
+ {{#if relevantSections}}
223
+ **Relevant Sections:** {{relevantSections}}
224
+ {{/if}}
225
+ {{/each}}
226
+
227
+ ---
228
+
229
+ ## Quick Actions
230
+
231
+ ### Continue Implementation
232
+ ```bash
233
+ # Start next task
234
+ morph-spec task next {{FEATURE_NAME}}
235
+
236
+ # Complete current task (runs validators)
237
+ morph-spec task done {{FEATURE_NAME}} {{CURRENT_TASK_ID}}
238
+
239
+ # Generate recap after task completion
240
+ morph-spec generate recap {{FEATURE_NAME}}
241
+ ```
242
+
243
+ ### Advance Phase
244
+ ```bash
245
+ # Check prerequisites and advance
246
+ morph-spec phase advance {{FEATURE_NAME}}
247
+
248
+ # Validate feature outputs
249
+ morph-spec validate-feature {{FEATURE_NAME}}
250
+ ```
251
+
252
+ ### Validation
253
+ ```bash
254
+ # Run all validators for active agents
255
+ morph-spec validate {{FEATURE_NAME}}
256
+
257
+ # Run specific validator
258
+ morph-spec validate-{{VALIDATOR}} {{FEATURE_NAME}}
259
+ ```
260
+
261
+ ---
262
+
263
+ ## File Paths
264
+
265
+ - **Outputs Directory:** `.morph/features/{{FEATURE_NAME}}/`
266
+ - **Proposal:** `{{PROPOSAL_PATH}}`
267
+ - **Spec:** `{{SPEC_PATH}}`
268
+ - **Contracts:** `{{CONTRACTS_PATH}}`
269
+ - **Tasks:** `{{TASKS_PATH}}`
270
+ - **Decisions:** `{{DECISIONS_PATH}}`
271
+ - **Recap:** `{{RECAP_PATH}}`
272
+
273
+ ---
274
+
275
+ *Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*
276
+ *Feature ID: {{FEATURE_ID}}*
@@ -71,12 +71,8 @@ morph-spec task next <feature>
71
71
  morph-spec task start <feature> <task-id>
72
72
  morph-spec task done <feature> <task-id>
73
73
 
74
- # Save/restore checkpoints
74
+ # Save a checkpoint
75
75
  morph-spec checkpoint-save <feature>
76
- morph-spec checkpoint-list <feature>
77
-
78
- # View changes since last snapshot
79
- morph-spec diff <feature>
80
76
 
81
77
  # Health check
82
78
  morph-spec doctor
@@ -101,8 +97,8 @@ morph-spec doctor
101
97
  │ ├── 0-proposal/
102
98
  │ ├── 1-design/
103
99
  │ ├── 2-ui/
104
- │ ├── 3-tasks/
105
- │ └── 4-implement/
100
+ │ ├── 4-tasks/
101
+ │ └── 5-implement/
106
102
  └── .claude/
107
103
  ├── commands/ # Slash commands
108
104
  ├── skills/ # Workflow skills
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@polymorphism-tech/morph-spec",
3
- "version": "4.8.19",
3
+ "version": "4.10.0",
4
4
  "description": "MORPH-SPEC: AI-First development framework with validation pipeline and multi-stack support",
5
5
  "keywords": [
6
6
  "claude-code",
@@ -47,23 +47,18 @@
47
47
  "docs": "jsdoc -c jsdoc.json",
48
48
  "docs:watch": "jsdoc -c jsdoc.json --watch",
49
49
  "docs:serve": "npx http-server docs/api -p 8080 -o",
50
- "version:bump": "node scripts/bump-version.js",
51
50
  "release": "node scripts/release.js",
52
51
  "postinstall": "node src/scripts/global-install.js"
53
52
  },
54
53
  "dependencies": {
55
- "ajv": "^8.12.0",
56
- "ajv-formats": "^3.0.1",
57
54
  "chalk": "^5.3.0",
58
55
  "commander": "^12.0.0",
59
- "diff": "^5.2.0",
60
56
  "fs-extra": "^11.2.0",
61
57
  "glob": "^10.3.0",
62
58
  "handlebars": "^4.7.8",
63
59
  "inquirer": "^9.2.0",
64
60
  "minimatch": "^9.0.5",
65
- "ora": "^8.0.0",
66
- "yaml": "^2.3.4"
61
+ "ora": "^8.0.0"
67
62
  },
68
63
  "repository": {
69
64
  "type": "git",