@polymorphism-tech/morph-spec 7.9.3 → 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 (213) 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/STANDARDS.json +7 -2
  58. package/framework/standards/ai-agents/agent-session.md +160 -160
  59. package/framework/standards/ai-agents/batching.md +193 -193
  60. package/framework/standards/ai-agents/context-providers.md +188 -188
  61. package/framework/standards/ai-agents/mcp-server.md +250 -250
  62. package/framework/standards/ai-agents/mcp-tools.md +197 -197
  63. package/framework/standards/ai-agents/middleware-patterns.md +207 -207
  64. package/framework/standards/ai-agents/modalities-image-gen.md +173 -173
  65. package/framework/standards/ai-agents/modalities-speech-to-text.md +171 -171
  66. package/framework/standards/ai-agents/modalities-text-to-speech.md +181 -181
  67. package/framework/standards/ai-agents/modalities-vision.md +201 -201
  68. package/framework/standards/ai-agents/multi-agent-patterns.md +155 -155
  69. package/framework/standards/ai-agents/production.md +275 -275
  70. package/framework/standards/ai-agents/prompts-in-db.md +214 -214
  71. package/framework/standards/ai-agents/providers/model-registry.md +158 -158
  72. package/framework/standards/ai-agents/service-tier-flex.md +135 -135
  73. package/framework/standards/ai-agents/structured-output.md +249 -249
  74. package/framework/standards/ai-agents/sweet-spot.md +109 -109
  75. package/framework/standards/backend/integrations/neon-auth/neon-auth.md +45 -3
  76. package/framework/templates/.idea/morph-templates.xml +92 -0
  77. package/framework/templates/.vscode/morph-templates.code-snippets +186 -0
  78. package/framework/templates/IDE-SNIPPETS.md +262 -262
  79. package/framework/templates/REGISTRY.json +0 -62
  80. package/framework/templates/code/dotnet/abstractions/api-endpoint.cs +7 -7
  81. package/framework/templates/code/dotnet/ai-agents/AgentBootstrap.cs.template +39 -39
  82. package/framework/templates/code/dotnet/ai-agents/EmbeddingService.cs.template +68 -68
  83. package/framework/templates/code/dotnet/ai-agents/ModelRegistry.cs.template +117 -117
  84. package/framework/templates/code/dotnet/ai-agents/PromptRepository.cs.template +95 -95
  85. package/framework/templates/code/dotnet/ai-agents/ResilientToolMiddleware.cs.template +61 -61
  86. package/framework/templates/code/dotnet/ai-agents/VectorSearchTool.cs.template +107 -107
  87. package/framework/templates/code/dotnet/ai-agents/model-registry.json.template +58 -58
  88. package/framework/templates/code/dotnet/contracts/contracts-vsa.cs +281 -281
  89. package/framework/templates/code/dotnet/database/migration.cs +83 -83
  90. package/framework/templates/code/dotnet/feature/endpoint.cs.hbs +21 -21
  91. package/framework/templates/code/dotnet/feature/request.cs.hbs +4 -4
  92. package/framework/templates/code/dotnet/feature/response.cs.hbs +4 -4
  93. package/framework/templates/code/dotnet/feature/validator.cs.hbs +15 -15
  94. package/framework/templates/code/sql/ai-agents/agent-prompts-migration.sql.template +58 -58
  95. package/framework/templates/code/sql/ai-agents/pgvector-embeddings-migration.sql.template +91 -91
  96. package/framework/templates/code/typescript/contracts.ts +167 -167
  97. package/framework/templates/docs/clarifications.md +253 -253
  98. package/framework/templates/docs/schema-analysis.md +119 -119
  99. package/framework/templates/docs/ui-components.md +52 -52
  100. package/framework/templates/docs/ui-design-system.md +76 -76
  101. package/framework/templates/docs/ui-flows.md +167 -167
  102. package/framework/templates/docs/ui-mockups.md +98 -98
  103. package/framework/templates/feature/decisions.md +122 -122
  104. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -43
  105. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -26
  106. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -32
  107. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -56
  108. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -22
  109. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -26
  110. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -54
  111. package/framework/templates/infrastructure/docker/Dockerfile.template +58 -58
  112. package/framework/templates/infrastructure/docker/docker-compose.template.yml +50 -50
  113. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  114. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  115. package/framework/templates/infrastructure/github/README.md +56 -56
  116. package/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -45
  117. package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -27
  118. package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -59
  119. package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -39
  120. package/framework/templates/integrations/asaas-client.cs +387 -387
  121. package/framework/templates/integrations/asaas-webhook.cs +351 -351
  122. package/framework/templates/meta-prompts/fusion/fusion-agent.md +76 -76
  123. package/framework/templates/meta-prompts/fusion/fusion-aggregator.md +100 -100
  124. package/framework/templates/meta-prompts/validators/pre-commit-validator.md +95 -95
  125. package/framework/templates/project/validate.js +120 -120
  126. package/framework/templates/state.template.json +17 -17
  127. package/framework/templates/ui/design-system.css +226 -226
  128. package/package.json +1 -1
  129. package/src/commands/dashboard/dashboard.js +53 -53
  130. package/src/commands/index.js +13 -13
  131. package/src/commands/mcp/mcp-setup.js +519 -519
  132. package/src/commands/project/checkpoint.js +209 -209
  133. package/src/commands/project/doctor.js +4 -2
  134. package/src/commands/project/init.js +46 -2
  135. package/src/commands/project/update.js +5 -3
  136. package/src/commands/project/worktree.js +1005 -46
  137. package/src/commands/state/advance.js +17 -2
  138. package/src/commands/state/approve.js +18 -1
  139. package/src/commands/state/create.js +158 -14
  140. package/src/commands/state/retype.js +126 -0
  141. package/src/commands/state/score.js +4 -0
  142. package/src/commands/tasks/dag.js +32 -0
  143. package/src/commands/validation/index.js +1 -0
  144. package/src/commands/validation/validate-feature.js +33 -5
  145. package/src/commands/validation/verify.js +190 -0
  146. package/src/core/state/phase-state-machine.js +197 -197
  147. package/src/core/state/state-manager.js +35 -10
  148. package/src/core/templates/template-renderer.js +477 -477
  149. package/src/core/work-types.js +79 -0
  150. package/src/dashboard/app/components/DetailPanel.jsx +11 -11
  151. package/src/dashboard/app/components/FlowGraph.jsx +17 -17
  152. package/src/dashboard/app/components/SearchFilter.jsx +22 -22
  153. package/src/dashboard/app/hooks/useDetailPanel.js +15 -15
  154. package/src/dashboard/app/main.jsx +13 -13
  155. package/src/dashboard/app/pages/AgentMap.jsx +370 -370
  156. package/src/dashboard/app/pages/HookInspector.jsx +418 -418
  157. package/src/dashboard/app/pages/LiveState.jsx +11 -1
  158. package/src/dashboard/app/pages/PhasePipeline.jsx +408 -408
  159. package/src/dashboard/app/pages/RulesMap.jsx +273 -273
  160. package/src/dashboard/app/pages/SkillsLibrary.jsx +366 -366
  161. package/src/dashboard/app/pages/Standards.jsx +332 -332
  162. package/src/dashboard/app/styles/index.css +47 -47
  163. package/src/dashboard/index.html +12 -12
  164. package/src/dashboard/package.json +24 -24
  165. package/src/dashboard/scanner/hooks-scanner.js +41 -41
  166. package/src/dashboard/scanner/phases-scanner.js +15 -15
  167. package/src/dashboard/scanner/rubrics-scanner.js +12 -12
  168. package/src/dashboard/scanner/rules-scanner.js +37 -37
  169. package/src/dashboard/scanner/skills-scanner.js +43 -43
  170. package/src/dashboard/scanner/squads-scanner.js +13 -13
  171. package/src/dashboard/scanner/standards-scanner.js +26 -26
  172. package/src/dashboard/scanner/state-scanner.js +42 -0
  173. package/src/dashboard/vite-plugin-morph-data.js +17 -17
  174. package/src/dashboard/vite.config.js +24 -24
  175. package/src/lib/agents/metrics-aggregator.js +56 -56
  176. package/src/lib/agents/metrics-calculator.js +125 -125
  177. package/src/lib/agents/output-collector.js +73 -73
  178. package/src/lib/detectors/claude-config-detector.js +152 -152
  179. package/src/lib/detectors/design-system-detector.js +231 -231
  180. package/src/lib/detectors/index.js +217 -217
  181. package/src/lib/generators/architecture-scanner.js +639 -639
  182. package/src/lib/generators/design-system-generator.js +508 -508
  183. package/src/lib/generators/index.js +13 -13
  184. package/src/lib/generators/settings-generator.js +209 -209
  185. package/src/lib/hooks/hook-executor.js +167 -167
  186. package/src/lib/installers/mcp-installer.js +719 -719
  187. package/src/lib/installers/memory-installer.js +1 -1
  188. package/src/lib/risk-detector.js +16 -0
  189. package/src/lib/tasks/dispatch-planner.js +122 -4
  190. package/src/lib/tasks/mermaid-renderer.js +132 -0
  191. package/src/lib/tasks/task-classifier.js +30 -30
  192. package/src/lib/tasks/task-parser.js +209 -209
  193. package/src/lib/tasks/test-runner.js +27 -6
  194. package/src/lib/validators/architecture/architecture-validator.js +259 -259
  195. package/src/lib/validators/checkpoint-persistence.js +39 -39
  196. package/src/lib/validators/contracts/contract-compliance-validator.js +274 -274
  197. package/src/lib/validators/css/css-validator.js +340 -340
  198. package/src/lib/validators/packages/package-validator.js +347 -347
  199. package/src/lib/validators/shared/emit-validator-dispatch.js +14 -14
  200. package/src/lib/validators/shared/issue-counter.js +14 -14
  201. package/src/lib/validators/validation-runner.js +349 -349
  202. package/src/lib/validators/verify-runner.js +322 -0
  203. package/src/lib/work-type-detector.js +143 -0
  204. package/src/scripts/setup-infra.js +32 -5
  205. package/src/utils/agent-id-mapper.js +11 -11
  206. package/src/utils/agents-installer.js +10 -6
  207. package/src/utils/claude-settings-manager.js +300 -300
  208. package/src/utils/file-copier.js +43 -0
  209. package/src/utils/hooks-installer.js +41 -11
  210. package/src/utils/skills-installer.js +174 -174
  211. package/framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md +0 -113
  212. package/framework/templates/meta-prompts/parallel-workers/parallel-worker.md +0 -80
  213. 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