@polymorphism-tech/morph-spec 4.7.1 → 4.8.1

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 (138) hide show
  1. package/.morph/analytics/threads-log.jsonl +54 -0
  2. package/.morph/state.json +198 -0
  3. package/LICENSE +1 -2
  4. package/README.md +379 -414
  5. package/bin/morph-spec.js +57 -403
  6. package/bin/validate.js +2 -26
  7. package/claude-plugin.json +2 -2
  8. package/docs/ARCHITECTURE.md +43 -46
  9. package/docs/CHEATSHEET.md +203 -221
  10. package/docs/COMMAND-FLOWS.md +319 -289
  11. package/docs/QUICKSTART.md +2 -8
  12. package/docs/plans/2026-02-22-claude-docs-morph-alignment-analysis.md +2 -0
  13. package/docs/plans/2026-02-22-claude-settings.md +2 -0
  14. package/docs/plans/2026-02-22-morph-cc-alignment-impl.md +2 -0
  15. package/docs/plans/2026-02-22-morph-spec-next.md +2 -0
  16. package/docs/plans/2026-02-22-native-alignment-design.md +2 -0
  17. package/docs/plans/2026-02-22-native-alignment-impl.md +2 -0
  18. package/docs/plans/2026-02-22-native-enrichment-design.md +2 -0
  19. package/docs/plans/2026-02-22-native-enrichment.md +2 -0
  20. package/docs/plans/2026-02-23-ddd-architecture-refactor.md +2 -0
  21. package/docs/plans/2026-02-23-ddd-nextsteps.md +2 -0
  22. package/docs/plans/2026-02-23-infra-architect-refactor.md +2 -0
  23. package/docs/plans/2026-02-23-nextjs-code-review-design.md +2 -1
  24. package/docs/plans/2026-02-23-nextjs-code-review-impl.md +2 -0
  25. package/docs/plans/2026-02-23-nextjs-standards-design.md +2 -1
  26. package/docs/plans/2026-02-23-nextjs-standards-impl.md +2 -0
  27. package/docs/plans/2026-02-24-cli-radical-simplification.md +592 -0
  28. package/docs/plans/2026-02-24-framework-failure-points.md +125 -0
  29. package/docs/plans/2026-02-24-morph-init-design.md +337 -0
  30. package/docs/plans/2026-02-24-morph-init-impl.md +1269 -0
  31. package/docs/plans/2026-02-24-tutorial-command-design.md +71 -0
  32. package/docs/plans/2026-02-24-tutorial-command.md +298 -0
  33. package/framework/CLAUDE.md +2 -2
  34. package/framework/commands/morph-proposal.md +3 -3
  35. package/framework/hooks/README.md +11 -10
  36. package/framework/hooks/claude-code/notification/approval-reminder.js +2 -0
  37. package/framework/hooks/claude-code/post-tool-use/dispatch.js +1 -1
  38. package/framework/hooks/claude-code/pre-tool-use/protect-readonly-files.js +4 -55
  39. package/framework/hooks/claude-code/session-start/inject-morph-context.js +20 -5
  40. package/framework/hooks/claude-code/statusline.py +6 -1
  41. package/framework/hooks/claude-code/stop/validate-completion.js +1 -1
  42. package/framework/hooks/claude-code/user-prompt/enrich-prompt.js +1 -1
  43. package/framework/hooks/dev/check-sync-health.js +117 -0
  44. package/framework/hooks/dev/guard-version-numbers.js +57 -0
  45. package/framework/hooks/dev/sync-standards-registry.js +60 -0
  46. package/framework/hooks/dev/sync-template-registry.js +60 -0
  47. package/framework/hooks/dev/validate-skill-format.js +70 -0
  48. package/framework/hooks/dev/validate-standard-format.js +73 -0
  49. package/framework/hooks/shared/payload-utils.js +39 -0
  50. package/framework/hooks/shared/state-reader.js +25 -1
  51. package/framework/rules/morph-workflow.md +1 -1
  52. package/framework/skills/level-0-meta/morph-init/SKILL.md +216 -0
  53. package/framework/skills/level-0-meta/morph-replicate/SKILL.md +4 -4
  54. package/framework/skills/level-0-meta/tool-usage-guide/SKILL.md +4 -4
  55. package/framework/skills/level-0-meta/verification-before-completion/SKILL.md +1 -1
  56. package/framework/skills/level-1-workflows/phase-clarify/SKILL.md +192 -191
  57. package/framework/skills/level-1-workflows/phase-codebase-analysis/SKILL.md +181 -180
  58. package/framework/skills/level-1-workflows/phase-design/SKILL.md +339 -338
  59. package/framework/skills/level-1-workflows/phase-implement/SKILL.md +254 -253
  60. package/framework/skills/level-1-workflows/phase-setup/SKILL.md +168 -170
  61. package/framework/skills/level-1-workflows/phase-tasks/SKILL.md +284 -283
  62. package/framework/skills/level-1-workflows/phase-uiux/SKILL.md +246 -245
  63. package/framework/templates/examples/design-system-examples.md +1 -1
  64. package/framework/templates/ui/FluentDesignTheme.cs +1 -1
  65. package/framework/templates/ui/MudTheme.cs +1 -1
  66. package/framework/templates/ui/design-system.css +1 -1
  67. package/package.json +4 -2
  68. package/scripts/bump-version.js +248 -0
  69. package/scripts/install-dev-hooks.js +138 -0
  70. package/src/commands/agents/index.js +1 -2
  71. package/src/commands/index.js +13 -16
  72. package/src/commands/project/doctor.js +100 -14
  73. package/src/commands/project/index.js +7 -10
  74. package/src/commands/project/init.js +398 -555
  75. package/src/commands/project/install-plugin-cmd.js +28 -0
  76. package/src/commands/project/setup-infra-cmd.js +12 -0
  77. package/src/commands/project/tutorial.js +115 -0
  78. package/src/commands/project/update.js +22 -37
  79. package/src/commands/state/approve.js +213 -221
  80. package/src/commands/state/index.js +0 -1
  81. package/src/commands/state/state.js +337 -365
  82. package/src/commands/templates/index.js +0 -4
  83. package/src/commands/trust/trust.js +1 -93
  84. package/src/commands/utils/index.js +1 -5
  85. package/src/commands/validation/index.js +1 -5
  86. package/src/core/registry/command-registry.js +11 -285
  87. package/src/core/state/state-manager.js +5 -2
  88. package/src/lib/detectors/index.js +81 -87
  89. package/src/lib/detectors/structure-detector.js +275 -273
  90. package/src/lib/generators/recap-generator.js +232 -225
  91. package/src/lib/installers/mcp-installer.js +18 -3
  92. package/src/scripts/global-install.js +34 -0
  93. package/src/scripts/install-plugin.js +126 -0
  94. package/src/scripts/setup-infra.js +203 -0
  95. package/src/utils/agents-installer.js +10 -1
  96. package/src/utils/hooks-installer.js +70 -17
  97. package/CLAUDE.md +0 -77
  98. package/docs/claude-alignment-report.md +0 -137
  99. package/docs/examples/order-management/contracts.cs +0 -84
  100. package/docs/examples/order-management/proposal.md +0 -24
  101. package/docs/examples/order-management/spec.md +0 -162
  102. package/src/commands/feature/create-story.js +0 -362
  103. package/src/commands/feature/index.js +0 -6
  104. package/src/commands/feature/shard-spec.js +0 -225
  105. package/src/commands/feature/sprint-status.js +0 -250
  106. package/src/commands/generation/generate-onboarding.js +0 -169
  107. package/src/commands/generation/generate.js +0 -276
  108. package/src/commands/generation/index.js +0 -5
  109. package/src/commands/learning/capture-pattern.js +0 -121
  110. package/src/commands/learning/index.js +0 -5
  111. package/src/commands/learning/search-patterns.js +0 -126
  112. package/src/commands/mcp/mcp.js +0 -102
  113. package/src/commands/project/changes.js +0 -66
  114. package/src/commands/project/cost.js +0 -179
  115. package/src/commands/project/detect.js +0 -114
  116. package/src/commands/project/diff.js +0 -278
  117. package/src/commands/project/revert.js +0 -173
  118. package/src/commands/project/standards.js +0 -80
  119. package/src/commands/project/sync.js +0 -167
  120. package/src/commands/project/update-agents.js +0 -23
  121. package/src/commands/state/rollback-phase.js +0 -185
  122. package/src/commands/templates/template-customize.js +0 -87
  123. package/src/commands/templates/template-list.js +0 -114
  124. package/src/commands/templates/template-show.js +0 -129
  125. package/src/commands/templates/template-validate.js +0 -91
  126. package/src/commands/utils/troubleshoot.js +0 -222
  127. package/src/commands/validation/analyze-blazor-concurrency.js +0 -193
  128. package/src/commands/validation/lint-fluent.js +0 -352
  129. package/src/commands/validation/validate-blazor-state.js +0 -210
  130. package/src/commands/validation/validate-blazor.js +0 -156
  131. package/src/commands/validation/validate-css.js +0 -84
  132. package/src/lib/detectors/conversation-analyzer.js +0 -163
  133. package/src/lib/learning/index.js +0 -7
  134. package/src/lib/learning/learning-system.js +0 -520
  135. package/src/lib/troubleshooting/index.js +0 -8
  136. package/src/lib/troubleshooting/troubleshoot-grep.js +0 -198
  137. package/src/lib/troubleshooting/troubleshoot-index.js +0 -144
  138. package/src/llm/environment-detector.js +0 -43
@@ -1,250 +0,0 @@
1
- /**
2
- * MORPH-SPEC Sprint Status Manager
3
- * Updates sprint-status.yaml and shows next story
4
- */
5
-
6
- import fs from 'fs';
7
- import path from 'path';
8
- import yaml from 'yaml';
9
- import ora from 'ora';
10
- import chalk from 'chalk';
11
- import { logger } from '../../utils/logger.js';
12
-
13
- // ============================================================================
14
- // Helper Functions
15
- // ============================================================================
16
-
17
- function loadSprintStatus(featureName) {
18
- const statusPath = path.join(process.cwd(), `.morph/features/${featureName}/sprint-status.yaml`);
19
-
20
- if (!fs.existsSync(statusPath)) {
21
- throw new Error(`Sprint status not found: ${statusPath}\n\n💡 Create a sprint status file first:\n morph-spec story create ${featureName} STORY-001`);
22
- }
23
-
24
- const content = fs.readFileSync(statusPath, 'utf-8');
25
- return { path: statusPath, data: yaml.parse(content) };
26
- }
27
-
28
- function saveSprintStatus(statusPath, data) {
29
- const content = yaml.stringify(data);
30
- fs.writeFileSync(statusPath, content);
31
- }
32
-
33
- function updateMetrics(sprint) {
34
- const stories = sprint.stories || [];
35
- const metrics = {
36
- total_stories: stories.length,
37
- ready: stories.filter(s => s.status === 'ready').length,
38
- in_progress: stories.filter(s => s.status === 'in_progress').length,
39
- ready_for_qa: stories.filter(s => s.status === 'ready_for_qa').length,
40
- done: stories.filter(s => s.status === 'done').length,
41
- };
42
-
43
- metrics.completion_percent = stories.length > 0
44
- ? Math.round((metrics.done / stories.length) * 100)
45
- : 0;
46
-
47
- sprint.metrics = metrics;
48
- sprint.updated = new Date().toISOString().split('T')[0];
49
- }
50
-
51
- function findStory(sprint, storyId) {
52
- return sprint.stories.find(s => s.id === storyId);
53
- }
54
-
55
- function getNextStory(sprint) {
56
- // Find first story that is "ready" (not in_progress or done)
57
- return sprint.stories.find(s => s.status === 'ready' || s.status === 'pending');
58
- }
59
-
60
- function displayStatus(sprint) {
61
- logger.header(`Sprint Status: ${sprint.feature}`);
62
- logger.blank();
63
- logger.info(`Epic: ${chalk.cyan(sprint.epic)}`);
64
- logger.info(`Progress: ${chalk.green(`${sprint.metrics.completion_percent}%`)} (${sprint.metrics.done}/${sprint.metrics.total_stories} stories done)`);
65
- logger.blank();
66
-
67
- logger.header('Stories:');
68
- sprint.stories.forEach(story => {
69
- const statusEmoji = {
70
- pending: '⏸️ ',
71
- ready: '✅',
72
- in_progress: '🔄',
73
- ready_for_qa: '👀',
74
- done: '✔️ ',
75
- }[story.status] || '❓';
76
-
77
- const statusColor = {
78
- pending: chalk.dim,
79
- ready: chalk.cyan,
80
- in_progress: chalk.yellow,
81
- ready_for_qa: chalk.magenta,
82
- done: chalk.green,
83
- }[story.status] || chalk.white;
84
-
85
- logger.dim(` ${statusEmoji} ${story.id}: ${story.title} ${statusColor(`(${story.status})`)}`);
86
- });
87
- logger.blank();
88
-
89
- if (sprint.current && sprint.current.story_id) {
90
- logger.info(`🎯 Current Focus: ${chalk.cyan(sprint.current.story_id)} (${sprint.current.agent} agent)`);
91
- }
92
-
93
- if (sprint.next && sprint.next.story_id) {
94
- logger.info(`📋 Next Story: ${chalk.cyan(sprint.next.story_id)}`);
95
- logger.dim(` ${sprint.next.recommendation || 'Ready for development'}`);
96
- }
97
-
98
- logger.blank();
99
- }
100
-
101
- // ============================================================================
102
- // Command Function
103
- // ============================================================================
104
-
105
- export async function sprintStatusCommand(feature, action, storyId, options) {
106
- // Default action is 'show'
107
- const cmd = action || 'show';
108
-
109
- if (cmd === 'help' || options.help) {
110
- logger.header('MORPH-SPEC Sprint Status Manager');
111
- logger.blank();
112
- logger.info('Usage:');
113
- logger.dim(' morph-spec story status <feature> [command] [story-id]');
114
- logger.blank();
115
- logger.info('Commands:');
116
- logger.dim(' show Display current sprint status (default)');
117
- logger.dim(' start <story-id> Mark story as in_progress');
118
- logger.dim(' qa <story-id> Mark story as ready_for_qa');
119
- logger.dim(' done <story-id> Mark story as done');
120
- logger.dim(' next Show next story to work on');
121
- logger.blank();
122
- logger.info('Examples:');
123
- logger.dim(' morph-spec story status scheduled-reports show');
124
- logger.dim(' morph-spec story status scheduled-reports start SR-001');
125
- logger.dim(' morph-spec story status scheduled-reports qa SR-001');
126
- logger.dim(' morph-spec story status scheduled-reports done SR-001');
127
- logger.dim(' morph-spec story status scheduled-reports next');
128
- logger.blank();
129
- return;
130
- }
131
-
132
- try {
133
- // Load sprint status
134
- const { path: statusPath, data: sprint } = loadSprintStatus(feature);
135
-
136
- // Execute command
137
- switch (cmd) {
138
- case 'show':
139
- displayStatus(sprint);
140
- break;
141
-
142
- case 'start':
143
- if (!storyId) {
144
- throw new Error('Story ID required for "start" command');
145
- }
146
- const storyToStart = findStory(sprint, storyId);
147
- if (!storyToStart) {
148
- throw new Error(`Story not found: ${storyId}`);
149
- }
150
-
151
- const spinner = ora('Updating story status...').start();
152
- storyToStart.status = 'in_progress';
153
- storyToStart.started = new Date().toISOString().split('T')[0];
154
- storyToStart.assigned = 'dev';
155
- sprint.current = { story_id: storyId, agent: 'dev', phase: 'implementation' };
156
- updateMetrics(sprint);
157
- saveSprintStatus(statusPath, sprint);
158
- spinner.succeed(`Story ${chalk.cyan(storyId)} marked as IN PROGRESS`);
159
- logger.blank();
160
- logger.info('💡 Recommendation: Run this story in a FRESH Claude session');
161
- logger.dim(' /dev → Implement story → Add Dev Notes');
162
- logger.blank();
163
- break;
164
-
165
- case 'qa':
166
- if (!storyId) {
167
- throw new Error('Story ID required for "qa" command');
168
- }
169
- const storyForQA = findStory(sprint, storyId);
170
- if (!storyForQA) {
171
- throw new Error(`Story not found: ${storyId}`);
172
- }
173
-
174
- const qaSpinner = ora('Updating story status...').start();
175
- storyForQA.status = 'ready_for_qa';
176
- storyForQA.assigned = 'qa';
177
- sprint.current = { story_id: storyId, agent: 'qa', phase: 'review' };
178
- updateMetrics(sprint);
179
- saveSprintStatus(statusPath, sprint);
180
- qaSpinner.succeed(`Story ${chalk.cyan(storyId)} marked as READY FOR QA`);
181
- logger.blank();
182
- logger.info('💡 Recommendation: QA in a FRESH Claude session');
183
- logger.dim(' /qa → Review code → Add QA Notes');
184
- logger.blank();
185
- break;
186
-
187
- case 'done':
188
- if (!storyId) {
189
- throw new Error('Story ID required for "done" command');
190
- }
191
- const storyDone = findStory(sprint, storyId);
192
- if (!storyDone) {
193
- throw new Error(`Story not found: ${storyId}`);
194
- }
195
-
196
- const doneSpinner = ora('Updating story status...').start();
197
- storyDone.status = 'done';
198
- storyDone.completed = new Date().toISOString().split('T')[0];
199
- updateMetrics(sprint);
200
-
201
- // Update next story
202
- const nextStory = getNextStory(sprint);
203
- if (nextStory) {
204
- sprint.next = {
205
- story_id: nextStory.id,
206
- recommendation: `Story ${nextStory.id} is ready for development`,
207
- };
208
- } else {
209
- sprint.next = null;
210
- }
211
-
212
- saveSprintStatus(statusPath, sprint);
213
- doneSpinner.succeed(`Story ${chalk.cyan(storyId)} marked as DONE`);
214
- logger.blank();
215
-
216
- if (nextStory) {
217
- logger.info(`📋 Next Story: ${chalk.cyan(nextStory.id)}`);
218
- logger.dim(` ${nextStory.title}`);
219
- logger.blank();
220
- } else {
221
- logger.success('🎉 All stories completed! Feature ready for final review.');
222
- logger.blank();
223
- }
224
- break;
225
-
226
- case 'next':
227
- const next = getNextStory(sprint);
228
- if (next) {
229
- logger.header('Next Story:');
230
- logger.blank();
231
- logger.info(`📋 Story ID: ${chalk.cyan(next.id)}`);
232
- logger.info(` Title: ${next.title}`);
233
- logger.info(` File: ${chalk.dim(next.file)}`);
234
- logger.info(` Status: ${next.status}`);
235
- logger.blank();
236
- } else {
237
- logger.success('🎉 No pending stories! Sprint complete.');
238
- logger.blank();
239
- }
240
- break;
241
-
242
- default:
243
- throw new Error(`Unknown command: ${cmd}\n Use --help to see available commands`);
244
- }
245
-
246
- } catch (error) {
247
- logger.error(error.message);
248
- process.exit(1);
249
- }
250
- }
@@ -1,169 +0,0 @@
1
- /**
2
- * Generate Onboarding Command
3
- *
4
- * Reads project context and renders the onboarding template
5
- * with detected MCPs, agents, standards, and workflow info.
6
- */
7
-
8
- import { join } from 'path';
9
- import { existsSync, readFileSync, readdirSync } from 'fs';
10
- import chalk from 'chalk';
11
- import { logger } from '../../utils/logger.js';
12
- import { pathExists, readJson, writeFile, ensureDir } from '../../utils/file-copier.js';
13
- import { getInstalledCLIVersion } from '../../utils/version-checker.js';
14
-
15
- export async function generateOnboardingCommand(options = {}) {
16
- const targetPath = process.cwd();
17
- const configPath = join(targetPath, '.morph', 'config', 'config.json');
18
- const integrationsPath = join(targetPath, '.morph', 'config', 'integrations.json');
19
- const agentsPath = join(targetPath, '.morph', 'config', 'agents.json');
20
-
21
- logger.header('Generating Onboarding Guide');
22
-
23
- // Load config
24
- if (!(await pathExists(configPath))) {
25
- logger.error('Project not initialized. Run "morph-spec init" first.');
26
- process.exit(1);
27
- }
28
-
29
- const config = await readJson(configPath);
30
- const integrations = await pathExists(integrationsPath) ? await readJson(integrationsPath) : null;
31
-
32
- // Build template variables
33
- const projectName = config?.project?.name || 'Unknown Project';
34
- const stack = config?.project?.stack || config?.project?.architecture || 'not detected';
35
- const architecture = config?.project?.architecture || 'not detected';
36
- const version = getInstalledCLIVersion();
37
- const date = new Date().toISOString().split('T')[0];
38
-
39
- // Build agents list
40
- let agentsList = 'No agents configuration found. Run `morph-spec init` to set up.';
41
- if (await pathExists(agentsPath)) {
42
- try {
43
- const agentsConfig = await readJson(agentsPath);
44
- const agents = agentsConfig.agents || {};
45
- const lines = [];
46
- for (const [id, agent] of Object.entries(agents)) {
47
- const emoji = agent.emoji || '';
48
- const tier = agent.tier ? `Tier ${agent.tier}` : '';
49
- lines.push(`- ${emoji} **${agent.name || id}** (${tier}) — ${agent.role || agent.responsibilities?.[0] || ''}`);
50
- }
51
- if (lines.length > 0) {
52
- agentsList = lines.join('\n');
53
- }
54
- } catch {
55
- // Use default
56
- }
57
- }
58
-
59
- // Build MCPs summary
60
- let availableMcps = 'No MCPs detected. Install MCP servers and run `morph-spec init --force` to detect.';
61
- if (integrations) {
62
- const lines = [];
63
-
64
- if (integrations.plugins?.length > 0) {
65
- lines.push('**Plugins:**');
66
- for (const p of integrations.plugins) {
67
- const ver = p.version ? ` v${p.version}` : '';
68
- lines.push(`- ${p.name}${ver}`);
69
- }
70
- }
71
-
72
- if (integrations.mcpServers?.length > 0) {
73
- lines.push('');
74
- lines.push('**MCP Servers:**');
75
-
76
- const phaseMap = {
77
- context7: 'proposal, design, tasks, implement',
78
- supabase: 'design, implement',
79
- playwright: 'UI/UX, implement',
80
- github: 'setup, tasks, implement',
81
- figma: 'UI/UX'
82
- };
83
-
84
- for (const s of integrations.mcpServers) {
85
- const name = s.name.toLowerCase();
86
- const phases = Object.entries(phaseMap).find(([k]) => name.includes(k));
87
- const phaseStr = phases ? ` (phases: ${phases[1]})` : '';
88
- lines.push(`- **${s.name}** (${s.source})${phaseStr}`);
89
- }
90
- }
91
-
92
- if (integrations.superpowers?.installed) {
93
- lines.push('');
94
- lines.push(`**Superpowers:** installed (${integrations.superpowers.skills?.length || 0} skills)`);
95
- }
96
-
97
- if (lines.length > 0) {
98
- availableMcps = lines.join('\n');
99
- }
100
- }
101
-
102
- // Build standards summary
103
- let standardsSummary = 'Using morph-spec defaults.';
104
- const standardsDir = join(targetPath, '.morph', 'standards');
105
- if (existsSync(standardsDir)) {
106
- try {
107
- const standards = collectStandards(standardsDir);
108
- if (standards.length > 0) {
109
- standardsSummary = standards.map(s => `- ${s}`).join('\n');
110
- }
111
- } catch {
112
- // Use default
113
- }
114
- }
115
-
116
- // Build workflow summary
117
- const workflowSummary = 'Workflow is **auto-detected** from your feature request. The framework analyzes keywords and complexity to choose the best workflow.';
118
-
119
- // Read template
120
- const templatePath = join(import.meta.dirname, '..', '..', '..', 'framework', 'templates', 'docs', 'onboarding.md');
121
- let template;
122
- if (existsSync(templatePath)) {
123
- template = readFileSync(templatePath, 'utf-8');
124
- } else {
125
- logger.error('Onboarding template not found.');
126
- process.exit(1);
127
- }
128
-
129
- // Replace placeholders
130
- let content = template
131
- .replace(/\{\{PROJECT_NAME\}\}/g, projectName)
132
- .replace(/\{\{STACK\}\}/g, stack)
133
- .replace(/\{\{ARCHITECTURE\}\}/g, architecture)
134
- .replace(/\{\{DATE\}\}/g, date)
135
- .replace(/\{\{VERSION\}\}/g, version)
136
- .replace(/\{\{AGENTS_LIST\}\}/g, agentsList)
137
- .replace(/\{\{AVAILABLE_MCPS\}\}/g, availableMcps)
138
- .replace(/\{\{STANDARDS_SUMMARY\}\}/g, standardsSummary)
139
- .replace(/\{\{WORKFLOW_SUMMARY\}\}/g, workflowSummary);
140
-
141
- // Write output
142
- const outputDir = join(targetPath, '.morph', 'project', 'outputs');
143
- await ensureDir(outputDir);
144
- const outputPath = join(outputDir, 'onboarding.md');
145
- await writeFile(outputPath, content);
146
-
147
- logger.success(`Onboarding guide generated: ${outputPath}`);
148
- logger.dim('Share this file with new team members.');
149
- }
150
-
151
- /**
152
- * Collect standard file names from directory tree
153
- */
154
- function collectStandards(dir, prefix = '') {
155
- const results = [];
156
- try {
157
- const entries = readdirSync(dir, { withFileTypes: true });
158
- for (const entry of entries) {
159
- if (entry.isDirectory()) {
160
- results.push(...collectStandards(join(dir, entry.name), `${prefix}${entry.name}/`));
161
- } else if (entry.name.endsWith('.md') && entry.name !== 'README.md') {
162
- results.push(`${prefix}${entry.name.replace('.md', '')}`);
163
- }
164
- }
165
- } catch {
166
- // Permission errors
167
- }
168
- return results;
169
- }
@@ -1,276 +0,0 @@
1
- /**
2
- * MORPH-SPEC Generate Command
3
- * CLI wrapper for code generation operations
4
- */
5
-
6
- import { mkdirSync, writeFileSync } from 'fs';
7
- import { dirname, join } from 'path';
8
- import ora from 'ora';
9
- import chalk from 'chalk';
10
- import { logger } from '../../utils/logger.js';
11
- import * as DesignSystemGenerator from '../../lib/generators/design-system-generator.js';
12
- import { getFeature } from '../../core/state/state-manager.js';
13
- import { extractFeatureMetadata } from '../../lib/generators/metadata-extractor.js';
14
-
15
- // ============================================================================
16
- // Design System Subcommand
17
- // ============================================================================
18
-
19
- /**
20
- * Generate design system files (CSS + themes) from ui-design-system.md
21
- * @param {string} designSystemPath - Path to ui-design-system.md
22
- * @param {Object} options - CLI options
23
- */
24
- export async function generateDesignSystemCommand(designSystemPath, options) {
25
- if (!designSystemPath) {
26
- logger.error('Design system file path required');
27
- logger.dim(' Usage: morph-spec generate design-system <ui-design-system.md>');
28
- logger.blank();
29
- logger.dim(' Example:');
30
- logger.dim(' morph-spec generate design-system .morph/features/my-feature/2-ui/design-system.md');
31
- process.exit(1);
32
- }
33
-
34
- logger.header('MORPH-SPEC Design System Generator');
35
- logger.blank();
36
-
37
- const spinner = ora('Parsing design system...').start();
38
-
39
- try {
40
- // Determine mode
41
- let mode = 'both';
42
- if (options.fluent && !options.mud) mode = 'fluent';
43
- if (options.mud && !options.fluent) mode = 'mud';
44
-
45
- // Generate design system
46
- const generated = DesignSystemGenerator.generateDesignSystem(designSystemPath, {
47
- mode,
48
- namespace: options.namespace || 'YourProject.Themes'
49
- });
50
-
51
- spinner.succeed('Design system parsed!');
52
- logger.blank();
53
-
54
- // Display stats
55
- logger.header('Parsed Design System:');
56
- logger.info(`Primary Colors: ${chalk.cyan(generated.stats.primaryColors)}`);
57
- logger.info(`Neutral Colors: ${chalk.cyan(generated.stats.neutralColors)}`);
58
- logger.info(`Semantic Colors: ${chalk.cyan(generated.stats.semanticColors)}`);
59
- logger.info(`Font Sizes: ${chalk.cyan(generated.stats.fontSizes)}`);
60
- logger.info(`Spacing Values: ${chalk.cyan(generated.stats.spacingValues)}`);
61
- logger.blank();
62
-
63
- if (options.dryRun) {
64
- logger.warn('Dry run - files not written');
65
- logger.blank();
66
- logger.header('Would generate:');
67
- logger.dim(' - wwwroot/css/design-system.css');
68
- if (generated.fluentTheme) logger.dim(' - Themes/FluentDesignTheme.cs');
69
- if (generated.mudTheme) logger.dim(' - Themes/MudDesignTheme.cs');
70
- logger.blank();
71
- return;
72
- }
73
-
74
- // Write files
75
- const writeSpinner = ora('Writing files...').start();
76
-
77
- // Write CSS
78
- const cssPath = options.cssOutput || 'wwwroot/css/design-system.css';
79
- mkdirSync(dirname(cssPath), { recursive: true });
80
- writeFileSync(cssPath, generated.css);
81
- writeSpinner.text = `Created ${cssPath}`;
82
-
83
- // Write Fluent theme
84
- if (generated.fluentTheme) {
85
- const fluentPath = options.fluentOutput || 'Themes/FluentDesignTheme.cs';
86
- mkdirSync(dirname(fluentPath), { recursive: true });
87
- writeFileSync(fluentPath, generated.fluentTheme);
88
- writeSpinner.text = `Created ${fluentPath}`;
89
- }
90
-
91
- // Write MudBlazor theme
92
- if (generated.mudTheme) {
93
- const mudPath = options.mudOutput || 'Themes/MudDesignTheme.cs';
94
- mkdirSync(dirname(mudPath), { recursive: true });
95
- writeFileSync(mudPath, generated.mudTheme);
96
- writeSpinner.text = `Created ${mudPath}`;
97
- }
98
-
99
- writeSpinner.succeed('Files generated!');
100
- logger.blank();
101
-
102
- // List generated files
103
- logger.header('Generated Files:');
104
- logger.success(` ✓ ${cssPath}`);
105
- if (generated.fluentTheme) logger.success(` ✓ ${options.fluentOutput || 'Themes/FluentDesignTheme.cs'}`);
106
- if (generated.mudTheme) logger.success(` ✓ ${options.mudOutput || 'Themes/MudDesignTheme.cs'}`);
107
- logger.blank();
108
-
109
- // Next steps
110
- logger.header('Next Steps:');
111
- logger.dim(' 1. Reference design-system.css in your layout');
112
- logger.dim(' 2. Register theme in Program.cs');
113
- logger.dim(' 3. Apply theme to your components');
114
- logger.blank();
115
-
116
- } catch (error) {
117
- spinner.fail('Generation failed');
118
- logger.error(error.message);
119
- process.exit(1);
120
- }
121
- }
122
-
123
- // ============================================================================
124
- // Metadata Subcommand
125
- // ============================================================================
126
-
127
- /**
128
- * Generate metadata.json from feature outputs
129
- * @param {string} featureName - Feature name
130
- * @param {Object} options - CLI options
131
- */
132
- export async function generateMetadataCommand(featureName, options) {
133
- if (!featureName) {
134
- logger.error('Feature name required');
135
- logger.dim(' Usage: morph-spec generate metadata <feature>');
136
- logger.blank();
137
- logger.dim(' Example:');
138
- logger.dim(' morph-spec generate metadata my-feature');
139
- process.exit(1);
140
- }
141
-
142
- logger.header('MORPH-SPEC Metadata Generator');
143
- logger.blank();
144
-
145
- const spinner = ora('Extracting metadata...').start();
146
-
147
- try {
148
- // Get feature state
149
- const feature = getFeature(featureName);
150
- if (!feature) {
151
- spinner.fail('Feature not found');
152
- logger.error(`Feature not found: ${featureName}`);
153
- process.exit(1);
154
- }
155
-
156
- // Extract metadata
157
- const metadata = extractFeatureMetadata(feature);
158
-
159
- spinner.succeed('Metadata extracted!');
160
- logger.blank();
161
-
162
- // Display summary
163
- logger.header('Feature Summary:');
164
- logger.info(`Feature: ${chalk.cyan(metadata.feature)}`);
165
- logger.info(`Phase: ${chalk.cyan(metadata.phase)}`);
166
- logger.info(`Status: ${chalk.cyan(metadata.status)}`);
167
-
168
- if (metadata.progress) {
169
- const progressBar = '█'.repeat(Math.floor(metadata.progress.percentage / 5)) +
170
- '░'.repeat(20 - Math.floor(metadata.progress.percentage / 5));
171
- logger.info(`Progress: ${chalk.cyan(`${metadata.progress.completed}/${metadata.progress.total}`)} ${progressBar} ${chalk.cyan(metadata.progress.percentage + '%')}`);
172
- }
173
-
174
- logger.info(`Active Agents: ${chalk.cyan(metadata.agents.length)}`);
175
- logger.info(`Checkpoints: ${chalk.cyan(metadata.checkpoints.length)}`);
176
- logger.blank();
177
-
178
- // Show outputs
179
- logger.header('Outputs Extracted:');
180
- Object.entries(metadata.outputs).forEach(([type, data]) => {
181
- if (data.error) {
182
- logger.error(` ✗ ${type}: ${data.error}`);
183
- } else {
184
- logger.success(` ✓ ${type}`);
185
-
186
- // Show key stats
187
- if (type === 'spec' && data.summary) {
188
- logger.dim(` Tags: ${data.summary.tags.join(', ')}`);
189
- }
190
- if (type === 'decisions' && data.total) {
191
- logger.dim(` Decisions: ${data.total} ADRs`);
192
- }
193
- if (type === 'tasks' && data.total) {
194
- logger.dim(` Tasks: ${data.total} (${data.regularTasks} regular + ${data.checkpoints} checkpoints)`);
195
- }
196
- }
197
- });
198
- logger.blank();
199
-
200
- if (options.dryRun) {
201
- logger.warn('Dry run - file not written');
202
- logger.blank();
203
- return;
204
- }
205
-
206
- // Determine output path
207
- const outputPath = options.output ||
208
- join(process.cwd(), `.morph/features/${featureName}/metadata.json`);
209
-
210
- // Write metadata
211
- const writeSpinner = ora('Writing metadata.json...').start();
212
-
213
- mkdirSync(dirname(outputPath), { recursive: true });
214
-
215
- const jsonContent = options.pretty !== false
216
- ? JSON.stringify(metadata, null, 2)
217
- : JSON.stringify(metadata);
218
-
219
- writeFileSync(outputPath, jsonContent, 'utf8');
220
-
221
- writeSpinner.succeed('Metadata generated!');
222
- logger.blank();
223
-
224
- logger.success(` ✓ ${outputPath}`);
225
- logger.blank();
226
-
227
- // Usage tip
228
- logger.header('💡 Usage:');
229
- logger.dim(` cat ${outputPath}`);
230
- logger.dim(` # Quick status check - no need to read full markdown files`);
231
- logger.blank();
232
-
233
- } catch (error) {
234
- spinner.fail('Generation failed');
235
- logger.error(error.message);
236
- if (error.stack) {
237
- logger.dim(error.stack);
238
- }
239
- process.exit(1);
240
- }
241
- }
242
-
243
- // ============================================================================
244
- // Main Generate Command (router for future subcommands)
245
- // ============================================================================
246
-
247
- /**
248
- * Main generate command router
249
- * Future: Could add more generation commands here
250
- */
251
- export async function generateCommand(subcommand, args, options) {
252
- switch (subcommand) {
253
- case 'design-system':
254
- await generateDesignSystemCommand(args[0], options);
255
- break;
256
-
257
- case 'metadata':
258
- await generateMetadataCommand(args[0], options);
259
- break;
260
-
261
- // Future: Add more generation commands
262
- // case 'component':
263
- // await generateComponentCommand(args[0], options);
264
- // break;
265
-
266
- default:
267
- logger.error(`Unknown subcommand: ${subcommand}`);
268
- logger.blank();
269
- logger.info('Available subcommands:');
270
- logger.dim(' design-system Generate CSS + theme files from ui-design-system.md');
271
- logger.dim(' metadata Generate metadata.json from feature outputs');
272
- logger.blank();
273
- logger.dim('Run "morph-spec generate --help" for more information');
274
- process.exit(1);
275
- }
276
- }
@@ -1,5 +0,0 @@
1
- /**
2
- * Code/Documentation Generation Commands
3
- */
4
- export { generateCommand } from './generate.js';
5
- export { generateContextCommand } from './generate-context.js';