@polymorphism-tech/morph-spec 7.9.4 → 8.0.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 (211) hide show
  1. package/CLAUDE.md +2 -2
  2. package/README.md +31 -2
  3. package/bin/morph-spec.js +50 -2
  4. package/bin/validate.js +379 -379
  5. package/claude-plugin.json +1 -1
  6. package/docs/CHEATSHEET.md +38 -1
  7. package/docs/QUICKSTART.md +60 -1
  8. package/framework/CLAUDE.md +13 -2
  9. package/framework/MORPH.md +38 -2
  10. package/framework/agents.json +22 -3
  11. package/framework/commands/commit.md +166 -166
  12. package/framework/commands/morph-hotfix.md +39 -0
  13. package/framework/commands/morph-infra.md +215 -215
  14. package/framework/commands/morph-preflight.md +205 -205
  15. package/framework/commands/morph-troubleshoot.md +124 -124
  16. package/framework/hooks/README.md +25 -10
  17. package/framework/hooks/claude-code/core/gate-guard.js +4 -2
  18. package/framework/hooks/claude-code/core/loop-detect.js +2 -1
  19. package/framework/hooks/claude-code/core/post-edit-typecheck.js +14 -5
  20. package/framework/hooks/claude-code/core/tasks-json-guard.js +4 -2
  21. package/framework/hooks/claude-code/core/validate-completion.js +1 -1
  22. package/framework/hooks/claude-code/core/worktree-context.js +160 -0
  23. package/framework/hooks/claude-code/statusline.py +679 -679
  24. package/framework/hooks/claude-code/statusline.sh +11 -11
  25. package/framework/hooks/git/commit-msg/conventional-commits.sh +33 -33
  26. package/framework/hooks/git/pre-commit/agents.sh +25 -25
  27. package/framework/hooks/git/pre-commit/orchestrator.sh +64 -64
  28. package/framework/hooks/git/pre-commit/specs.sh +50 -50
  29. package/framework/hooks/git/pre-push/run-tests.sh +44 -44
  30. package/framework/hooks/shared/activity-logger.js +160 -160
  31. package/framework/hooks/shared/build-check.js +2 -2
  32. package/framework/hooks/shared/hook-response.js +17 -5
  33. package/framework/hooks/shared/payload-utils.js +42 -0
  34. package/framework/hooks/shared/state-reader.js +22 -2
  35. package/framework/hooks/shared/stdin-reader.js +26 -26
  36. package/framework/rubrics/backend.json +41 -41
  37. package/framework/rules/ai-agents-standards.md +45 -45
  38. package/framework/rules/dotnet-templates.md +86 -86
  39. package/framework/rules/frontend-standards.md +13 -13
  40. package/framework/rules/infrastructure-standards.md +27 -27
  41. package/framework/rules/neon-standards.md +25 -25
  42. package/framework/rules/nextjs-standards.md +20 -20
  43. package/framework/rules/nextjs-templates.md +40 -40
  44. package/framework/schemas/feature.schema.json +95 -1
  45. package/framework/skills/core/create-umbraco-lp/SKILL.md +1 -1
  46. package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md +1 -1
  47. package/framework/skills/core/morph-apply/SKILL.md +39 -8
  48. package/framework/skills/core/morph-brainstorming/SKILL.md +9 -1
  49. package/framework/skills/core/morph-eval/SKILL.md +6 -1
  50. package/framework/skills/core/morph-hotfix/SKILL.md +136 -0
  51. package/framework/skills/core/morph-implement/SKILL.md +8 -4
  52. package/framework/skills/core/morph-plan/SKILL.md +5 -1
  53. package/framework/skills/core/morph-proposal/SKILL.md +24 -1
  54. package/framework/skills/core/morph-review/SKILL.md +3 -2
  55. package/framework/skills/core/morph-stack-scan/SKILL.md +1 -1
  56. package/framework/skills/core/morph-standards/SKILL.md +1 -1
  57. package/framework/standards/ai-agents/agent-session.md +160 -160
  58. package/framework/standards/ai-agents/batching.md +193 -193
  59. package/framework/standards/ai-agents/context-providers.md +188 -188
  60. package/framework/standards/ai-agents/mcp-server.md +250 -250
  61. package/framework/standards/ai-agents/mcp-tools.md +197 -197
  62. package/framework/standards/ai-agents/middleware-patterns.md +207 -207
  63. package/framework/standards/ai-agents/modalities-image-gen.md +173 -173
  64. package/framework/standards/ai-agents/modalities-speech-to-text.md +171 -171
  65. package/framework/standards/ai-agents/modalities-text-to-speech.md +181 -181
  66. package/framework/standards/ai-agents/modalities-vision.md +201 -201
  67. package/framework/standards/ai-agents/multi-agent-patterns.md +155 -155
  68. package/framework/standards/ai-agents/production.md +275 -275
  69. package/framework/standards/ai-agents/prompts-in-db.md +214 -214
  70. package/framework/standards/ai-agents/providers/model-registry.md +158 -158
  71. package/framework/standards/ai-agents/service-tier-flex.md +135 -135
  72. package/framework/standards/ai-agents/structured-output.md +249 -249
  73. package/framework/standards/ai-agents/sweet-spot.md +109 -109
  74. package/framework/templates/.idea/morph-templates.xml +92 -0
  75. package/framework/templates/.vscode/morph-templates.code-snippets +186 -0
  76. package/framework/templates/IDE-SNIPPETS.md +262 -262
  77. package/framework/templates/REGISTRY.json +0 -62
  78. package/framework/templates/code/dotnet/abstractions/api-endpoint.cs +7 -7
  79. package/framework/templates/code/dotnet/ai-agents/AgentBootstrap.cs.template +39 -39
  80. package/framework/templates/code/dotnet/ai-agents/EmbeddingService.cs.template +68 -68
  81. package/framework/templates/code/dotnet/ai-agents/ModelRegistry.cs.template +117 -117
  82. package/framework/templates/code/dotnet/ai-agents/PromptRepository.cs.template +95 -95
  83. package/framework/templates/code/dotnet/ai-agents/ResilientToolMiddleware.cs.template +61 -61
  84. package/framework/templates/code/dotnet/ai-agents/VectorSearchTool.cs.template +107 -107
  85. package/framework/templates/code/dotnet/ai-agents/model-registry.json.template +58 -58
  86. package/framework/templates/code/dotnet/contracts/contracts-vsa.cs +281 -281
  87. package/framework/templates/code/dotnet/database/migration.cs +83 -83
  88. package/framework/templates/code/dotnet/feature/endpoint.cs.hbs +21 -21
  89. package/framework/templates/code/dotnet/feature/request.cs.hbs +4 -4
  90. package/framework/templates/code/dotnet/feature/response.cs.hbs +4 -4
  91. package/framework/templates/code/dotnet/feature/validator.cs.hbs +15 -15
  92. package/framework/templates/code/sql/ai-agents/agent-prompts-migration.sql.template +58 -58
  93. package/framework/templates/code/sql/ai-agents/pgvector-embeddings-migration.sql.template +91 -91
  94. package/framework/templates/code/typescript/contracts.ts +167 -167
  95. package/framework/templates/docs/clarifications.md +253 -253
  96. package/framework/templates/docs/schema-analysis.md +119 -119
  97. package/framework/templates/docs/ui-components.md +52 -52
  98. package/framework/templates/docs/ui-design-system.md +76 -76
  99. package/framework/templates/docs/ui-flows.md +167 -167
  100. package/framework/templates/docs/ui-mockups.md +98 -98
  101. package/framework/templates/feature/decisions.md +122 -122
  102. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -43
  103. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -26
  104. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -32
  105. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -56
  106. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -22
  107. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -26
  108. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -54
  109. package/framework/templates/infrastructure/docker/Dockerfile.template +58 -58
  110. package/framework/templates/infrastructure/docker/docker-compose.template.yml +50 -50
  111. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  112. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  113. package/framework/templates/infrastructure/github/README.md +56 -56
  114. package/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -45
  115. package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -27
  116. package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -59
  117. package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -39
  118. package/framework/templates/integrations/asaas-client.cs +387 -387
  119. package/framework/templates/integrations/asaas-webhook.cs +351 -351
  120. package/framework/templates/meta-prompts/fusion/fusion-agent.md +76 -76
  121. package/framework/templates/meta-prompts/fusion/fusion-aggregator.md +100 -100
  122. package/framework/templates/meta-prompts/validators/pre-commit-validator.md +95 -95
  123. package/framework/templates/project/validate.js +120 -120
  124. package/framework/templates/state.template.json +17 -17
  125. package/framework/templates/ui/design-system.css +226 -226
  126. package/package.json +1 -1
  127. package/src/commands/dashboard/dashboard.js +53 -53
  128. package/src/commands/index.js +13 -13
  129. package/src/commands/mcp/mcp-setup.js +519 -519
  130. package/src/commands/project/checkpoint.js +209 -209
  131. package/src/commands/project/doctor.js +4 -2
  132. package/src/commands/project/init.js +46 -2
  133. package/src/commands/project/update.js +5 -3
  134. package/src/commands/project/worktree.js +1005 -46
  135. package/src/commands/state/advance.js +17 -2
  136. package/src/commands/state/approve.js +18 -1
  137. package/src/commands/state/create.js +158 -14
  138. package/src/commands/state/retype.js +126 -0
  139. package/src/commands/state/score.js +4 -0
  140. package/src/commands/tasks/dag.js +32 -0
  141. package/src/commands/validation/index.js +1 -0
  142. package/src/commands/validation/validate-feature.js +33 -5
  143. package/src/commands/validation/verify.js +190 -0
  144. package/src/core/state/phase-state-machine.js +197 -197
  145. package/src/core/state/state-manager.js +35 -10
  146. package/src/core/templates/template-renderer.js +477 -477
  147. package/src/core/work-types.js +79 -0
  148. package/src/dashboard/app/components/DetailPanel.jsx +11 -11
  149. package/src/dashboard/app/components/FlowGraph.jsx +17 -17
  150. package/src/dashboard/app/components/SearchFilter.jsx +22 -22
  151. package/src/dashboard/app/hooks/useDetailPanel.js +15 -15
  152. package/src/dashboard/app/main.jsx +13 -13
  153. package/src/dashboard/app/pages/AgentMap.jsx +370 -370
  154. package/src/dashboard/app/pages/HookInspector.jsx +418 -418
  155. package/src/dashboard/app/pages/LiveState.jsx +11 -1
  156. package/src/dashboard/app/pages/PhasePipeline.jsx +408 -408
  157. package/src/dashboard/app/pages/RulesMap.jsx +273 -273
  158. package/src/dashboard/app/pages/SkillsLibrary.jsx +366 -366
  159. package/src/dashboard/app/pages/Standards.jsx +332 -332
  160. package/src/dashboard/app/styles/index.css +47 -47
  161. package/src/dashboard/index.html +12 -12
  162. package/src/dashboard/package.json +24 -24
  163. package/src/dashboard/scanner/hooks-scanner.js +41 -41
  164. package/src/dashboard/scanner/phases-scanner.js +15 -15
  165. package/src/dashboard/scanner/rubrics-scanner.js +12 -12
  166. package/src/dashboard/scanner/rules-scanner.js +37 -37
  167. package/src/dashboard/scanner/skills-scanner.js +43 -43
  168. package/src/dashboard/scanner/squads-scanner.js +13 -13
  169. package/src/dashboard/scanner/standards-scanner.js +26 -26
  170. package/src/dashboard/scanner/state-scanner.js +42 -0
  171. package/src/dashboard/vite-plugin-morph-data.js +17 -17
  172. package/src/dashboard/vite.config.js +24 -24
  173. package/src/lib/agents/metrics-aggregator.js +56 -56
  174. package/src/lib/agents/metrics-calculator.js +125 -125
  175. package/src/lib/agents/output-collector.js +73 -73
  176. package/src/lib/detectors/claude-config-detector.js +152 -152
  177. package/src/lib/detectors/design-system-detector.js +231 -231
  178. package/src/lib/detectors/index.js +217 -217
  179. package/src/lib/generators/architecture-scanner.js +639 -639
  180. package/src/lib/generators/design-system-generator.js +508 -508
  181. package/src/lib/generators/index.js +13 -13
  182. package/src/lib/generators/settings-generator.js +209 -209
  183. package/src/lib/hooks/hook-executor.js +167 -167
  184. package/src/lib/installers/mcp-installer.js +719 -719
  185. package/src/lib/installers/memory-installer.js +1 -1
  186. package/src/lib/risk-detector.js +16 -0
  187. package/src/lib/tasks/dispatch-planner.js +122 -4
  188. package/src/lib/tasks/mermaid-renderer.js +132 -0
  189. package/src/lib/tasks/task-classifier.js +30 -30
  190. package/src/lib/tasks/task-parser.js +209 -209
  191. package/src/lib/tasks/test-runner.js +27 -6
  192. package/src/lib/validators/architecture/architecture-validator.js +259 -259
  193. package/src/lib/validators/checkpoint-persistence.js +39 -39
  194. package/src/lib/validators/contracts/contract-compliance-validator.js +274 -274
  195. package/src/lib/validators/css/css-validator.js +340 -340
  196. package/src/lib/validators/packages/package-validator.js +347 -347
  197. package/src/lib/validators/shared/emit-validator-dispatch.js +14 -14
  198. package/src/lib/validators/shared/issue-counter.js +14 -14
  199. package/src/lib/validators/validation-runner.js +349 -349
  200. package/src/lib/validators/verify-runner.js +322 -0
  201. package/src/lib/work-type-detector.js +143 -0
  202. package/src/scripts/setup-infra.js +32 -5
  203. package/src/utils/agent-id-mapper.js +11 -11
  204. package/src/utils/agents-installer.js +10 -6
  205. package/src/utils/claude-settings-manager.js +300 -300
  206. package/src/utils/file-copier.js +43 -0
  207. package/src/utils/hooks-installer.js +41 -11
  208. package/src/utils/skills-installer.js +174 -174
  209. package/framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md +0 -113
  210. package/framework/templates/meta-prompts/parallel-workers/parallel-worker.md +0 -80
  211. package/src/lib/tasks/wave-resolver.js +0 -353
@@ -1,209 +1,209 @@
1
- /**
2
- * Task Parser — Shared utilities for reading, parsing, and grouping tasks.
3
- *
4
- * Extracted from bin/task-manager.cjs and dispatch-agents.js so all
5
- * consumers share the same parsing logic without duplication.
6
- */
7
-
8
- import { readFile } from 'fs/promises';
9
- import { readFileSync, existsSync } from 'fs';
10
- import { join } from 'path';
11
-
12
- // ============================================================================
13
- // TASK_CATEGORY_TO_GROUP — maps task categories to parallel groups
14
- // ============================================================================
15
-
16
- const TASK_CATEGORY_TO_GROUP = {
17
- 'domain': 'backend',
18
- 'domain-bc': 'backend',
19
- 'infrastructure': 'backend',
20
- 'application': 'backend',
21
- 'presentation': 'frontend',
22
- 'tests': 'tests',
23
- 'infra': 'infra',
24
- 'docs': 'docs',
25
- };
26
-
27
- // ============================================================================
28
- // parseTaskList — structured task parsing with error reporting
29
- // ============================================================================
30
-
31
- /**
32
- * Parse tasks.md content into structured task objects with error reporting.
33
- *
34
- * @param {string} content - Raw tasks.md content
35
- * @returns {{ tasks: ParsedTask[], errors: TaskParseError[], groups: Object<string, string[]> }}
36
- */
37
- export function parseTaskList(content) {
38
- const tasks = [];
39
- const errors = [];
40
- const groups = {};
41
-
42
- const taskHeadingRe = /^###\s+(T\d{3,})\s*[—–:\-]\s*(.+)$/gm;
43
- const groupRe = /(?:\*\*Group\*\*\s*:\s*`?([a-z-]+)`?|- \*\*Group:\*\*\s*`?([a-z-]+)`?)/i;
44
- const categoryRe = /(?:\*\*category\*\*\s*:\s*`?([a-z-]+)`?|category:\s*([a-z-]+))/i;
45
-
46
- let headingMatch;
47
- const taskPositions = [];
48
-
49
- while ((headingMatch = taskHeadingRe.exec(content)) !== null) {
50
- taskPositions.push({ id: headingMatch[1], title: headingMatch[2].trim(), pos: headingMatch.index });
51
- }
52
-
53
- for (let i = 0; i < taskPositions.length; i++) {
54
- const { id, title, pos } = taskPositions[i];
55
- const end = i + 1 < taskPositions.length ? taskPositions[i + 1].pos : content.length;
56
- const block = content.slice(pos, end);
57
-
58
- // Try group field first (v4), fall back to category field (v3)
59
- const grpMatch = groupRe.exec(block);
60
- const catMatch = categoryRe.exec(block);
61
- let group;
62
- if (grpMatch) {
63
- group = (grpMatch[1] || grpMatch[2]).toLowerCase();
64
- } else if (catMatch) {
65
- const category = (catMatch[1] || catMatch[2]).toLowerCase();
66
- group = TASK_CATEGORY_TO_GROUP[category] || 'backend';
67
- } else {
68
- group = 'backend';
69
- }
70
-
71
- tasks.push({ id, title, group });
72
-
73
- if (!groups[group]) groups[group] = [];
74
- groups[group].push(id);
75
- }
76
-
77
- return { tasks, errors, groups };
78
- }
79
-
80
- // ============================================================================
81
- // parseAndGroupTasks — drop-in replacement for dispatch-agents.js
82
- // ============================================================================
83
-
84
- /**
85
- * Parse tasks.md and return a map of { group -> taskId[] }.
86
- * Gracefully returns {} if the file doesn't exist or is unparseable.
87
- *
88
- * @param {string} tasksPath - Absolute path to tasks.md
89
- * @returns {Object<string, string[]>}
90
- */
91
- export function parseAndGroupTasks(tasksPath) {
92
- if (!existsSync(tasksPath)) return {};
93
-
94
- try {
95
- const content = readFileSync(tasksPath, 'utf8');
96
- return parseTaskList(content).groups;
97
- } catch {
98
- return {};
99
- }
100
- }
101
-
102
- // ============================================================================
103
- // parseTasksMd
104
- // ============================================================================
105
-
106
- /**
107
- * Parse tasks.md to extract task stubs for the v3 state format.
108
- * Accepts headings in either format:
109
- * ### T001 — Task title (em-dash / en-dash / hyphen)
110
- * ### T001: Task title (colon)
111
- *
112
- * @param {string} featureName
113
- * @param {string} [cwd] - Project root (defaults to process.cwd())
114
- * @returns {Promise<Array<{id, title, status, dependencies, files, checkpoint}>>}
115
- */
116
- export async function parseTasksMd(featureName, cwd = process.cwd()) {
117
- const tasksPath = join(cwd, `.morph/features/${featureName}/2-plan/tasks.md`);
118
- let content = '';
119
- try {
120
- content = await readFile(tasksPath, 'utf-8');
121
- } catch {
122
- return [];
123
- }
124
-
125
- // Phase 1: collect heading positions
126
- const headingRe = /^###\s+(T\d+)\s*[—–:\-]\s*(.+)$/gm;
127
- const depRe = /\*\*Dependenc(?:y|ies):\*\*\s*(.+)/i;
128
- const positions = [];
129
- let match;
130
- while ((match = headingRe.exec(content)) !== null) {
131
- positions.push({ id: match[1], title: match[2].trim(), pos: match.index });
132
- }
133
-
134
- // Phase 2: extract body and parse dependencies
135
- const tasks = [];
136
- for (let i = 0; i < positions.length; i++) {
137
- const { id, title, pos } = positions[i];
138
- const end = i + 1 < positions.length ? positions[i + 1].pos : content.length;
139
- const block = content.slice(pos, end);
140
-
141
- let dependencies = [];
142
- const depMatch = depRe.exec(block);
143
- if (depMatch) {
144
- const val = depMatch[1].trim();
145
- if (val.toLowerCase() !== 'none') {
146
- dependencies = val.split(/[,\s]+/).filter(s => /^T\d+$/.test(s));
147
- }
148
- }
149
-
150
- tasks.push({ id, title, status: 'pending', dependencies, files: [], checkpoint: null });
151
- }
152
- return tasks;
153
- }
154
-
155
- // ============================================================================
156
- // ensureTaskList
157
- // ============================================================================
158
-
159
- /**
160
- * Ensure feature.taskList exists (array of individual task objects).
161
- *
162
- * In v3 state, feature.tasks is a counter object {total, completed, …}.
163
- * Individual task objects live in feature.taskList.
164
- *
165
- * @param {Object} feature - Feature state object (mutated in place)
166
- * @param {string} featureName
167
- * @param {string} [cwd]
168
- * @returns {Promise<Array>} The task list
169
- */
170
- export async function ensureTaskList(feature, featureName, cwd = process.cwd()) {
171
- if (Array.isArray(feature.tasks)) {
172
- // v2 format: tasks IS the array
173
- return feature.tasks;
174
- }
175
- // v3 format: use taskList or build from tasks.md
176
- if (!feature.taskList || feature.taskList.length === 0) {
177
- feature.taskList = await parseTasksMd(featureName, cwd);
178
- }
179
- return feature.taskList;
180
- }
181
-
182
- // ============================================================================
183
- // syncCounters
184
- // ============================================================================
185
-
186
- /**
187
- * After modifying taskList, sync the counter fields back to feature.tasks.
188
- * tasks.total is derived from the actual taskList length (not trusted from state).
189
- *
190
- * @deprecated Prefer reading directly from feature.taskList. Counter fields
191
- * (feature.tasks) duplicate native Claude Code task tracking. This function
192
- * is kept for backward compatibility but will be removed in a future version.
193
- *
194
- * @param {Object} feature - Feature state object (mutated in place)
195
- */
196
- export function syncCounters(feature) {
197
- if (Array.isArray(feature.tasks)) return; // v2 format — nothing to sync
198
- // Safety: ensure feature.tasks is an object (may be undefined after migration or corruption)
199
- if (!feature.tasks || typeof feature.tasks !== 'object') {
200
- feature.tasks = { total: 0, completed: 0, inProgress: 0, pending: 0 };
201
- }
202
- const list = feature.taskList || [];
203
- // Exclude expanded tasks — they are replaced by their sub-tasks
204
- const active = list.filter(t => t.status !== 'expanded');
205
- feature.tasks.total = active.length;
206
- feature.tasks.completed = active.filter(t => t.status === 'completed').length;
207
- feature.tasks.inProgress = active.filter(t => t.status === 'in_progress').length;
208
- feature.tasks.pending = active.filter(t => t.status === 'pending').length;
209
- }
1
+ /**
2
+ * Task Parser — Shared utilities for reading, parsing, and grouping tasks.
3
+ *
4
+ * Extracted from bin/task-manager.cjs and dispatch-agents.js so all
5
+ * consumers share the same parsing logic without duplication.
6
+ */
7
+
8
+ import { readFile } from 'fs/promises';
9
+ import { readFileSync, existsSync } from 'fs';
10
+ import { join } from 'path';
11
+
12
+ // ============================================================================
13
+ // TASK_CATEGORY_TO_GROUP — maps task categories to parallel groups
14
+ // ============================================================================
15
+
16
+ const TASK_CATEGORY_TO_GROUP = {
17
+ 'domain': 'backend',
18
+ 'domain-bc': 'backend',
19
+ 'infrastructure': 'backend',
20
+ 'application': 'backend',
21
+ 'presentation': 'frontend',
22
+ 'tests': 'tests',
23
+ 'infra': 'infra',
24
+ 'docs': 'docs',
25
+ };
26
+
27
+ // ============================================================================
28
+ // parseTaskList — structured task parsing with error reporting
29
+ // ============================================================================
30
+
31
+ /**
32
+ * Parse tasks.md content into structured task objects with error reporting.
33
+ *
34
+ * @param {string} content - Raw tasks.md content
35
+ * @returns {{ tasks: ParsedTask[], errors: TaskParseError[], groups: Object<string, string[]> }}
36
+ */
37
+ export function parseTaskList(content) {
38
+ const tasks = [];
39
+ const errors = [];
40
+ const groups = {};
41
+
42
+ const taskHeadingRe = /^###\s+(T\d{3,})\s*[—–:\-]\s*(.+)$/gm;
43
+ const groupRe = /(?:\*\*Group\*\*\s*:\s*`?([a-z-]+)`?|- \*\*Group:\*\*\s*`?([a-z-]+)`?)/i;
44
+ const categoryRe = /(?:\*\*category\*\*\s*:\s*`?([a-z-]+)`?|category:\s*([a-z-]+))/i;
45
+
46
+ let headingMatch;
47
+ const taskPositions = [];
48
+
49
+ while ((headingMatch = taskHeadingRe.exec(content)) !== null) {
50
+ taskPositions.push({ id: headingMatch[1], title: headingMatch[2].trim(), pos: headingMatch.index });
51
+ }
52
+
53
+ for (let i = 0; i < taskPositions.length; i++) {
54
+ const { id, title, pos } = taskPositions[i];
55
+ const end = i + 1 < taskPositions.length ? taskPositions[i + 1].pos : content.length;
56
+ const block = content.slice(pos, end);
57
+
58
+ // Try group field first (v4), fall back to category field (v3)
59
+ const grpMatch = groupRe.exec(block);
60
+ const catMatch = categoryRe.exec(block);
61
+ let group;
62
+ if (grpMatch) {
63
+ group = (grpMatch[1] || grpMatch[2]).toLowerCase();
64
+ } else if (catMatch) {
65
+ const category = (catMatch[1] || catMatch[2]).toLowerCase();
66
+ group = TASK_CATEGORY_TO_GROUP[category] || 'backend';
67
+ } else {
68
+ group = 'backend';
69
+ }
70
+
71
+ tasks.push({ id, title, group });
72
+
73
+ if (!groups[group]) groups[group] = [];
74
+ groups[group].push(id);
75
+ }
76
+
77
+ return { tasks, errors, groups };
78
+ }
79
+
80
+ // ============================================================================
81
+ // parseAndGroupTasks — drop-in replacement for dispatch-agents.js
82
+ // ============================================================================
83
+
84
+ /**
85
+ * Parse tasks.md and return a map of { group -> taskId[] }.
86
+ * Gracefully returns {} if the file doesn't exist or is unparseable.
87
+ *
88
+ * @param {string} tasksPath - Absolute path to tasks.md
89
+ * @returns {Object<string, string[]>}
90
+ */
91
+ export function parseAndGroupTasks(tasksPath) {
92
+ if (!existsSync(tasksPath)) return {};
93
+
94
+ try {
95
+ const content = readFileSync(tasksPath, 'utf8');
96
+ return parseTaskList(content).groups;
97
+ } catch {
98
+ return {};
99
+ }
100
+ }
101
+
102
+ // ============================================================================
103
+ // parseTasksMd
104
+ // ============================================================================
105
+
106
+ /**
107
+ * Parse tasks.md to extract task stubs for the v3 state format.
108
+ * Accepts headings in either format:
109
+ * ### T001 — Task title (em-dash / en-dash / hyphen)
110
+ * ### T001: Task title (colon)
111
+ *
112
+ * @param {string} featureName
113
+ * @param {string} [cwd] - Project root (defaults to process.cwd())
114
+ * @returns {Promise<Array<{id, title, status, dependencies, files, checkpoint}>>}
115
+ */
116
+ export async function parseTasksMd(featureName, cwd = process.cwd()) {
117
+ const tasksPath = join(cwd, `.morph/features/${featureName}/2-plan/tasks.md`);
118
+ let content = '';
119
+ try {
120
+ content = await readFile(tasksPath, 'utf-8');
121
+ } catch {
122
+ return [];
123
+ }
124
+
125
+ // Phase 1: collect heading positions
126
+ const headingRe = /^###\s+(T\d+)\s*[—–:\-]\s*(.+)$/gm;
127
+ const depRe = /\*\*Dependenc(?:y|ies):\*\*\s*(.+)/i;
128
+ const positions = [];
129
+ let match;
130
+ while ((match = headingRe.exec(content)) !== null) {
131
+ positions.push({ id: match[1], title: match[2].trim(), pos: match.index });
132
+ }
133
+
134
+ // Phase 2: extract body and parse dependencies
135
+ const tasks = [];
136
+ for (let i = 0; i < positions.length; i++) {
137
+ const { id, title, pos } = positions[i];
138
+ const end = i + 1 < positions.length ? positions[i + 1].pos : content.length;
139
+ const block = content.slice(pos, end);
140
+
141
+ let dependencies = [];
142
+ const depMatch = depRe.exec(block);
143
+ if (depMatch) {
144
+ const val = depMatch[1].trim();
145
+ if (val.toLowerCase() !== 'none') {
146
+ dependencies = val.split(/[,\s]+/).filter(s => /^T\d+$/.test(s));
147
+ }
148
+ }
149
+
150
+ tasks.push({ id, title, status: 'pending', dependencies, files: [], checkpoint: null });
151
+ }
152
+ return tasks;
153
+ }
154
+
155
+ // ============================================================================
156
+ // ensureTaskList
157
+ // ============================================================================
158
+
159
+ /**
160
+ * Ensure feature.taskList exists (array of individual task objects).
161
+ *
162
+ * In v3 state, feature.tasks is a counter object {total, completed, …}.
163
+ * Individual task objects live in feature.taskList.
164
+ *
165
+ * @param {Object} feature - Feature state object (mutated in place)
166
+ * @param {string} featureName
167
+ * @param {string} [cwd]
168
+ * @returns {Promise<Array>} The task list
169
+ */
170
+ export async function ensureTaskList(feature, featureName, cwd = process.cwd()) {
171
+ if (Array.isArray(feature.tasks)) {
172
+ // v2 format: tasks IS the array
173
+ return feature.tasks;
174
+ }
175
+ // v3 format: use taskList or build from tasks.md
176
+ if (!feature.taskList || feature.taskList.length === 0) {
177
+ feature.taskList = await parseTasksMd(featureName, cwd);
178
+ }
179
+ return feature.taskList;
180
+ }
181
+
182
+ // ============================================================================
183
+ // syncCounters
184
+ // ============================================================================
185
+
186
+ /**
187
+ * After modifying taskList, sync the counter fields back to feature.tasks.
188
+ * tasks.total is derived from the actual taskList length (not trusted from state).
189
+ *
190
+ * @deprecated Prefer reading directly from feature.taskList. Counter fields
191
+ * (feature.tasks) duplicate native Claude Code task tracking. This function
192
+ * is kept for backward compatibility but will be removed in a future version.
193
+ *
194
+ * @param {Object} feature - Feature state object (mutated in place)
195
+ */
196
+ export function syncCounters(feature) {
197
+ if (Array.isArray(feature.tasks)) return; // v2 format — nothing to sync
198
+ // Safety: ensure feature.tasks is an object (may be undefined after migration or corruption)
199
+ if (!feature.tasks || typeof feature.tasks !== 'object') {
200
+ feature.tasks = { total: 0, completed: 0, inProgress: 0, pending: 0 };
201
+ }
202
+ const list = feature.taskList || [];
203
+ // Exclude expanded tasks — they are replaced by their sub-tasks
204
+ const active = list.filter(t => t.status !== 'expanded');
205
+ feature.tasks.total = active.length;
206
+ feature.tasks.completed = active.filter(t => t.status === 'completed').length;
207
+ feature.tasks.inProgress = active.filter(t => t.status === 'in_progress').length;
208
+ feature.tasks.pending = active.filter(t => t.status === 'pending').length;
209
+ }
@@ -3,12 +3,13 @@
3
3
  *
4
4
  * Resolution order for test command:
5
5
  * 1. .morph/config/config.json → project.testCommand
6
- * 2. package.json present → "npm test"
7
- * 3. null (no test suite detected)
6
+ * 2. .sln or .csproj present at project root → "dotnet test"
7
+ * 3. package.json present AND has scripts.test → "npm test"
8
+ * 4. null (no test suite detected)
8
9
  */
9
10
 
10
11
  import { execSync } from 'child_process';
11
- import { existsSync, readFileSync } from 'fs';
12
+ import { existsSync, readFileSync, readdirSync } from 'fs';
12
13
  import { join } from 'path';
13
14
 
14
15
  /**
@@ -32,13 +33,33 @@ export function resolveTestCommand(projectPath = '.') {
32
33
  }
33
34
  }
34
35
 
35
- // 2. Detect package.json → npm test
36
+ // 2. Detect .NET project (sln/csproj at root) → dotnet test
37
+ try {
38
+ const entries = readdirSync(projectPath);
39
+ const hasDotnetProject = entries.some(
40
+ (entry) => entry.endsWith('.sln') || entry.endsWith('.csproj')
41
+ );
42
+ if (hasDotnetProject) {
43
+ return 'dotnet test';
44
+ }
45
+ } catch {
46
+ // Unreadable project directory — fall through to next detection
47
+ }
48
+
49
+ // 3. package.json present AND has scripts.test → npm test
36
50
  const packageJsonPath = join(projectPath, 'package.json');
37
51
  if (existsSync(packageJsonPath)) {
38
- return 'npm test';
52
+ try {
53
+ const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
54
+ if (pkg?.scripts?.test) {
55
+ return 'npm test';
56
+ }
57
+ } catch {
58
+ // Malformed package.json — fall through to null
59
+ }
39
60
  }
40
61
 
41
- // 3. Nothing found
62
+ // 4. Nothing found
42
63
  return null;
43
64
  }
44
65