@polymorphism-tech/morph-spec 4.10.9 → 4.11.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 (145) hide show
  1. package/CLAUDE.md +3 -3
  2. package/LICENSE +71 -71
  3. package/README.md +5 -11
  4. package/bin/morph-spec.js +23 -1
  5. package/bin/task-manager.js +5 -5
  6. package/claude-plugin.json +1 -1
  7. package/docs/CHEATSHEET.md +1 -1
  8. package/docs/QUICKSTART.md +2 -8
  9. package/framework/agents/README.md +14 -14
  10. package/framework/agents/architecture/standards-architect.md +159 -159
  11. package/framework/agents/frontend/css-specialist.md +1 -1
  12. package/framework/agents/infrastructure/azure-architect.md +149 -149
  13. package/framework/agents/infrastructure/azure-deploy-specialist.md +4 -4
  14. package/framework/agents/infrastructure/infra-architect.md +48 -48
  15. package/framework/commands/morph-apply.md +18 -18
  16. package/framework/commands/morph-preflight.md +3 -3
  17. package/framework/commands/morph-proposal.md +15 -15
  18. package/framework/commands/morph-status.md +3 -3
  19. package/framework/commands/morph-troubleshoot.md +1 -1
  20. package/framework/hooks/README.md +204 -204
  21. package/framework/hooks/claude-code/pre-tool-use/task-tracking-guard.js +2 -2
  22. package/framework/hooks/claude-code/session-start/inject-morph-context.js +1 -1
  23. package/framework/hooks/claude-code/teammate-idle/teammate-idle.js +3 -3
  24. package/framework/hooks/claude-code/user-prompt/enrich-prompt.js +2 -2
  25. package/framework/hooks/git/pre-commit/agents.sh +1 -1
  26. package/framework/hooks/shared/phase-utils.js +139 -139
  27. package/framework/rules/csharp-standards.md +13 -13
  28. package/framework/rules/frontend-standards.md +13 -13
  29. package/framework/rules/infrastructure-standards.md +16 -16
  30. package/framework/rules/testing-standards.md +14 -14
  31. package/framework/skills/level-0-meta/morph-brainstorming/SKILL.md +8 -8
  32. package/framework/skills/level-0-meta/morph-checklist/SKILL.md +3 -3
  33. package/framework/skills/level-0-meta/morph-code-review-nextjs/references/review-example-nextjs.md +254 -254
  34. package/framework/skills/level-0-meta/morph-frontend-review/SKILL.md +1 -1
  35. package/framework/skills/level-0-meta/morph-init/SKILL.md +11 -11
  36. package/framework/skills/level-0-meta/morph-post-implementation/SKILL.md +3 -3
  37. package/framework/skills/level-0-meta/morph-replicate/SKILL.md +1 -1
  38. package/framework/skills/level-0-meta/morph-simulation-checklist/SKILL.md +4 -4
  39. package/framework/skills/level-0-meta/morph-tool-usage-guide/references/tools-per-phase.md +25 -25
  40. package/framework/skills/level-0-meta/morph-verification-before-completion/SKILL.md +8 -8
  41. package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md +7 -7
  42. package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md +4 -4
  43. package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +23 -23
  44. package/framework/skills/level-1-workflows/morph-phase-design/references/architecture-analysis-guide.md +1 -1
  45. package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json +38 -0
  46. package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md +29 -29
  47. package/framework/skills/level-1-workflows/morph-phase-implement/prompts/implementer-prompt.md +4 -4
  48. package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +9 -9
  49. package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md +17 -17
  50. package/framework/skills/level-1-workflows/morph-phase-tasks/.morph/logs/activity.json +14 -0
  51. package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md +12 -12
  52. package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md +16 -16
  53. package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +5 -5
  54. package/framework/standards/STANDARDS.json +2338 -2041
  55. package/framework/standards/frontend/nextjs/nextjs-patterns.md +17 -17
  56. package/framework/standards/infrastructure/supabase/supabase-custom-jwt.md +206 -0
  57. package/framework/templates/.idea/morph-templates.xml +92 -0
  58. package/framework/templates/.vscode/morph-templates.code-snippets +186 -0
  59. package/framework/templates/README.md +814 -814
  60. package/framework/templates/code/dotnet/contracts/Commands.cs +74 -74
  61. package/framework/templates/code/dotnet/contracts/Entities.cs +25 -25
  62. package/framework/templates/code/dotnet/contracts/Queries.cs +74 -74
  63. package/framework/templates/code/dotnet/contracts/README.md +74 -74
  64. package/framework/templates/code/dotnet/contracts/api-contracts.cs +173 -173
  65. package/framework/templates/code/dotnet/frontend/component.razor +239 -239
  66. package/framework/templates/code/dotnet/jobs/agent.cs +163 -163
  67. package/framework/templates/code/dotnet/jobs/job.cs +171 -171
  68. package/framework/templates/code/dotnet/test.cs +239 -239
  69. package/framework/templates/code/sql/rls-policy.sql +57 -57
  70. package/framework/templates/code/sql/supabase-migration.sql +100 -100
  71. package/framework/templates/code/sql/supabase-migration.template.sql +113 -113
  72. package/framework/templates/code/typescript/contracts.ts +168 -168
  73. package/framework/templates/context/CONTEXT.md +181 -181
  74. package/framework/templates/docs/proposal.md +182 -182
  75. package/framework/templates/docs/user-stories.md +34 -34
  76. package/framework/templates/examples/design-system-examples.md +357 -357
  77. package/framework/templates/examples/spec-examples.md +90 -90
  78. package/framework/templates/feature/decisions.md +187 -187
  79. package/framework/templates/feature/recap.md +146 -146
  80. package/framework/templates/feature/tasks.md +199 -199
  81. package/framework/templates/infrastructure/azure/README.md +286 -286
  82. package/framework/templates/infrastructure/azure/deploy-checklist.md +426 -426
  83. package/framework/templates/infrastructure/azure/parameters.dev.json +29 -29
  84. package/framework/templates/infrastructure/azure/parameters.prod.json +29 -29
  85. package/framework/templates/infrastructure/azure/parameters.staging.json +29 -29
  86. package/framework/templates/infrastructure/docker/docker-compose.template.yml +67 -67
  87. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  88. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  89. package/framework/templates/infrastructure/docker/easypanel.template.json +54 -54
  90. package/framework/workflows/README.md +18 -18
  91. package/framework/workflows/docs/enforcement-pipeline.md +1 -1
  92. package/framework/workflows/docs/full-morph.md +2 -2
  93. package/package.json +1 -1
  94. package/src/commands/agents/dispatch-agents.js +17 -0
  95. package/src/commands/agents/index.js +13 -13
  96. package/src/commands/agents/project-metrics.js +74 -0
  97. package/src/commands/project/doctor.js +3 -4
  98. package/src/commands/project/install-plugin-cmd.js +28 -28
  99. package/src/commands/project/setup-infra-cmd.js +12 -12
  100. package/src/commands/project/status.js +8 -1
  101. package/src/commands/scope/escalate.js +5 -3
  102. package/src/commands/standards/context-budget.js +89 -0
  103. package/src/commands/tasks/index.js +4 -4
  104. package/src/commands/templates/index.js +5 -5
  105. package/src/commands/utils/index.js +3 -3
  106. package/src/commands/validation/index.js +4 -4
  107. package/src/commands/validation/validate-feature.js +32 -3
  108. package/src/core/state/phase-state-machine.js +217 -217
  109. package/src/lib/agents/metrics-aggregator.js +56 -0
  110. package/src/lib/generators/design-system-generator.js +298 -298
  111. package/src/lib/generators/index.js +10 -10
  112. package/src/lib/generators/metadata-extractor.js +387 -387
  113. package/src/lib/stack-filter.js +65 -65
  114. package/src/lib/standards/digest-builder.js +57 -3
  115. package/src/lib/standards/index.js +7 -7
  116. package/src/lib/standards/standards-context-injector.js +302 -302
  117. package/src/lib/validators/architecture/architecture-validator.js +387 -387
  118. package/src/lib/validators/architecture/index.js +7 -7
  119. package/src/lib/validators/blazor/blazor-concurrency-analyzer.js +316 -316
  120. package/src/lib/validators/blazor/blazor-state-validator.js +279 -279
  121. package/src/lib/validators/blazor/blazor-validator.js +369 -369
  122. package/src/lib/validators/blazor/index.js +9 -9
  123. package/src/lib/validators/content/content-validator.js +287 -287
  124. package/src/lib/validators/content/index.js +7 -7
  125. package/src/lib/validators/contracts/index.js +7 -7
  126. package/src/lib/validators/css/css-validator.js +352 -352
  127. package/src/lib/validators/css/index.js +7 -7
  128. package/src/lib/validators/design-system/design-system-validator.js +231 -231
  129. package/src/lib/validators/design-system/index.js +7 -7
  130. package/src/lib/validators/nextjs/index.js +6 -6
  131. package/src/lib/validators/nextjs/next-component-validator.js +183 -183
  132. package/src/lib/validators/packages/index.js +7 -7
  133. package/src/lib/validators/packages/package-validator.js +360 -360
  134. package/src/lib/validators/shared/index.js +12 -12
  135. package/src/lib/validators/shared/issue-counter.js +18 -18
  136. package/src/lib/validators/shared/result-formatter.js +124 -124
  137. package/src/lib/validators/ui/index.js +7 -7
  138. package/src/lib/validators/ui/ui-contrast-validator.js +422 -422
  139. package/src/scripts/global-install.js +112 -58
  140. package/src/scripts/install-plugin.js +126 -126
  141. package/src/utils/claude-md-injector.js +90 -90
  142. package/src/utils/file-copier.js +200 -200
  143. package/src/utils/logger.js +32 -32
  144. package/src/utils/skills-installer.js +178 -178
  145. package/src/utils/version-checker.js +169 -175
@@ -1,175 +1,169 @@
1
- import { readFileSync } from 'fs';
2
- import { join, dirname } from 'path';
3
- import { fileURLToPath } from 'url';
4
- import { pathExists, readJson, writeJson } from './file-copier.js';
5
-
6
- const __dirname = dirname(fileURLToPath(import.meta.url));
7
-
8
- /**
9
- * Get the current CLI version from package.json
10
- * @returns {string} Version string (e.g., "1.0.4")
11
- */
12
- export function getInstalledCLIVersion() {
13
- try {
14
- const pkgPath = join(__dirname, '..', '..', 'package.json');
15
- const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
16
- return pkg.version;
17
- } catch (error) {
18
- return 'unknown';
19
- }
20
- }
21
-
22
- /**
23
- * Get the latest version from npm registry
24
- * @param {string} packageName - The package name (default: @polymorphism-tech/morph-spec)
25
- * @returns {Promise<string|null>} Latest version or null if failed
26
- */
27
- export async function getLatestNPMVersion(packageName = '@polymorphism-tech/morph-spec') {
28
- try {
29
- const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`);
30
- if (!response.ok) return null;
31
- const data = await response.json();
32
- return data.version;
33
- } catch (error) {
34
- return null;
35
- }
36
- }
37
-
38
- /**
39
- * Get the MORPH version installed in the project
40
- * @param {string} projectPath - Path to the project
41
- * @returns {Promise<object|null>} Version info object or null if not found
42
- */
43
- export async function getProjectMorphVersion(projectPath) {
44
- try {
45
- const versionPath = join(projectPath, '.morph', '.morphversion');
46
- if (!(await pathExists(versionPath))) {
47
- return null;
48
- }
49
- return await readJson(versionPath);
50
- } catch (error) {
51
- return null;
52
- }
53
- }
54
-
55
- /**
56
- * Save the MORPH version to the project
57
- * @param {string} projectPath - Path to the project
58
- * @param {string} version - Version to save
59
- * @returns {Promise<void>}
60
- */
61
- export async function saveProjectMorphVersion(projectPath, version) {
62
- const versionPath = join(projectPath, '.morph', '.morphversion');
63
- const versionInfo = {
64
- morphVersion: version,
65
- installedAt: new Date().toISOString(),
66
- cliVersion: version
67
- };
68
- await writeJson(versionPath, versionInfo);
69
- }
70
-
71
- /**
72
- * Compare two semver versions
73
- * @param {string} v1 - First version
74
- * @param {string} v2 - Second version
75
- * @returns {number} -1 if v1 < v2, 0 if equal, 1 if v1 > v2
76
- */
77
- export function compareVersions(v1, v2) {
78
- if (!v1 || !v2) return 0;
79
-
80
- const parts1 = v1.split('.').map(Number);
81
- const parts2 = v2.split('.').map(Number);
82
-
83
- for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
84
- const num1 = parts1[i] || 0;
85
- const num2 = parts2[i] || 0;
86
-
87
- if (num1 < num2) return -1;
88
- if (num1 > num2) return 1;
89
- }
90
-
91
- return 0;
92
- }
93
-
94
- /**
95
- * Detect how the CLI was installed
96
- * @returns {'global'|'npx'|'unknown'}
97
- */
98
- export function detectInstallMethod() {
99
- // Check if running via npx
100
- if (process.env.npm_execpath && process.env.npm_execpath.includes('npx')) {
101
- return 'npx';
102
- }
103
-
104
- // Check if installed globally
105
- const isGlobal = process.env.npm_config_global === 'true' ||
106
- process.execPath.includes('node_modules');
107
-
108
- if (isGlobal) {
109
- return 'global';
110
- }
111
-
112
- return 'unknown';
113
- }
114
-
115
- /**
116
- * Get update instructions based on install method
117
- * @param {string} method - Install method ('global', 'npx', 'unknown')
118
- * @returns {string[]} Array of instruction strings
119
- */
120
- export function getUpdateInstructions(method) {
121
- switch (method) {
122
- case 'global':
123
- return [
124
- 'npm install -g @polymorphism-tech/morph-spec@latest',
125
- 'morph-spec update'
126
- ];
127
- case 'npx':
128
- return [
129
- 'npx @polymorphism-tech/morph-spec@latest update'
130
- ];
131
- default:
132
- return [
133
- 'npm install -g @polymorphism-tech/morph-spec@latest',
134
- 'morph-spec update',
135
- '',
136
- 'Or use npx:',
137
- 'npx @polymorphism-tech/morph-spec@latest update'
138
- ];
139
- }
140
- }
141
-
142
- /**
143
- * Check if CLI version is outdated
144
- * @returns {Promise<{isOutdated: boolean, current: string, latest: string|null}>}
145
- */
146
- export async function checkCLIOutdated() {
147
- const current = getInstalledCLIVersion();
148
- const latest = await getLatestNPMVersion();
149
-
150
- if (!latest) {
151
- return { isOutdated: false, current, latest: null };
152
- }
153
-
154
- const isOutdated = compareVersions(current, latest) < 0;
155
-
156
- return { isOutdated, current, latest };
157
- }
158
-
159
- /**
160
- * Check if project MORPH version is outdated
161
- * @param {string} projectPath - Path to the project
162
- * @returns {Promise<{isOutdated: boolean, current: string|null, cliVersion: string}>}
163
- */
164
- export async function checkProjectOutdated(projectPath) {
165
- const cliVersion = getInstalledCLIVersion();
166
- const projectVersion = await getProjectMorphVersion(projectPath);
167
-
168
- if (!projectVersion) {
169
- return { isOutdated: false, current: null, cliVersion };
170
- }
171
-
172
- const isOutdated = compareVersions(projectVersion.morphVersion, cliVersion) < 0;
173
-
174
- return { isOutdated, current: projectVersion.morphVersion, cliVersion };
175
- }
1
+ import { readFileSync } from 'fs';
2
+ import { join, dirname } from 'path';
3
+ import { fileURLToPath } from 'url';
4
+ import { pathExists, readJson, writeJson } from './file-copier.js';
5
+
6
+ const __dirname = dirname(fileURLToPath(import.meta.url));
7
+
8
+ /**
9
+ * Get the current CLI version from package.json
10
+ * @returns {string} Version string (e.g., "1.0.4")
11
+ */
12
+ export function getInstalledCLIVersion() {
13
+ try {
14
+ const pkgPath = join(__dirname, '..', '..', 'package.json');
15
+ const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
16
+ return pkg.version;
17
+ } catch (error) {
18
+ return 'unknown';
19
+ }
20
+ }
21
+
22
+ /**
23
+ * Get the latest version from npm registry
24
+ * @param {string} packageName - The package name (default: @polymorphism-tech/morph-spec)
25
+ * @returns {Promise<string|null>} Latest version or null if failed
26
+ */
27
+ export async function getLatestNPMVersion(packageName = '@polymorphism-tech/morph-spec') {
28
+ try {
29
+ const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`);
30
+ if (!response.ok) return null;
31
+ const data = await response.json();
32
+ return data.version;
33
+ } catch (error) {
34
+ return null;
35
+ }
36
+ }
37
+
38
+ /**
39
+ * Get the MORPH version installed in the project
40
+ * @param {string} projectPath - Path to the project
41
+ * @returns {Promise<object|null>} Version info object or null if not found
42
+ */
43
+ export async function getProjectMorphVersion(projectPath) {
44
+ try {
45
+ const versionPath = join(projectPath, '.morph', '.morphversion');
46
+ if (!(await pathExists(versionPath))) {
47
+ return null;
48
+ }
49
+ return await readJson(versionPath);
50
+ } catch (error) {
51
+ return null;
52
+ }
53
+ }
54
+
55
+ /**
56
+ * Save the MORPH version to the project
57
+ * @param {string} projectPath - Path to the project
58
+ * @param {string} version - Version to save
59
+ * @returns {Promise<void>}
60
+ */
61
+ export async function saveProjectMorphVersion(projectPath, version) {
62
+ const versionPath = join(projectPath, '.morph', '.morphversion');
63
+ const versionInfo = {
64
+ morphVersion: version,
65
+ installedAt: new Date().toISOString(),
66
+ cliVersion: version
67
+ };
68
+ await writeJson(versionPath, versionInfo);
69
+ }
70
+
71
+ /**
72
+ * Compare two semver versions
73
+ * @param {string} v1 - First version
74
+ * @param {string} v2 - Second version
75
+ * @returns {number} -1 if v1 < v2, 0 if equal, 1 if v1 > v2
76
+ */
77
+ export function compareVersions(v1, v2) {
78
+ if (!v1 || !v2) return 0;
79
+
80
+ const parts1 = v1.split('.').map(Number);
81
+ const parts2 = v2.split('.').map(Number);
82
+
83
+ for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
84
+ const num1 = parts1[i] || 0;
85
+ const num2 = parts2[i] || 0;
86
+
87
+ if (num1 < num2) return -1;
88
+ if (num1 > num2) return 1;
89
+ }
90
+
91
+ return 0;
92
+ }
93
+
94
+ /**
95
+ * Detect how the CLI was installed
96
+ * @returns {'global'|'npx'|'unknown'}
97
+ */
98
+ export function detectInstallMethod() {
99
+ // Check if running via npx
100
+ if (process.env.npm_execpath && process.env.npm_execpath.includes('npx')) {
101
+ return 'npx';
102
+ }
103
+
104
+ // Check if installed globally
105
+ const isGlobal = process.env.npm_config_global === 'true' ||
106
+ process.execPath.includes('node_modules');
107
+
108
+ if (isGlobal) {
109
+ return 'global';
110
+ }
111
+
112
+ return 'unknown';
113
+ }
114
+
115
+ /**
116
+ * Get update instructions based on install method
117
+ * @param {string} method - Install method ('global', 'npx', 'unknown')
118
+ * @returns {string[]} Array of instruction strings
119
+ */
120
+ export function getUpdateInstructions(method) {
121
+ switch (method) {
122
+ case 'global':
123
+ return [
124
+ 'npm install -g @polymorphism-tech/morph-spec@latest',
125
+ 'morph-spec update'
126
+ ];
127
+ case 'npx':
128
+ default:
129
+ return [
130
+ 'npm install -g @polymorphism-tech/morph-spec@latest',
131
+ 'morph-spec update'
132
+ ];
133
+ }
134
+ }
135
+
136
+ /**
137
+ * Check if CLI version is outdated
138
+ * @returns {Promise<{isOutdated: boolean, current: string, latest: string|null}>}
139
+ */
140
+ export async function checkCLIOutdated() {
141
+ const current = getInstalledCLIVersion();
142
+ const latest = await getLatestNPMVersion();
143
+
144
+ if (!latest) {
145
+ return { isOutdated: false, current, latest: null };
146
+ }
147
+
148
+ const isOutdated = compareVersions(current, latest) < 0;
149
+
150
+ return { isOutdated, current, latest };
151
+ }
152
+
153
+ /**
154
+ * Check if project MORPH version is outdated
155
+ * @param {string} projectPath - Path to the project
156
+ * @returns {Promise<{isOutdated: boolean, current: string|null, cliVersion: string}>}
157
+ */
158
+ export async function checkProjectOutdated(projectPath) {
159
+ const cliVersion = getInstalledCLIVersion();
160
+ const projectVersion = await getProjectMorphVersion(projectPath);
161
+
162
+ if (!projectVersion) {
163
+ return { isOutdated: false, current: null, cliVersion };
164
+ }
165
+
166
+ const isOutdated = compareVersions(projectVersion.morphVersion, cliVersion) < 0;
167
+
168
+ return { isOutdated, current: projectVersion.morphVersion, cliVersion };
169
+ }