@polymorphism-tech/morph-spec 4.10.9 → 4.10.10

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 (114) hide show
  1. package/CLAUDE.md +3 -3
  2. package/LICENSE +71 -71
  3. package/README.md +2 -2
  4. package/bin/morph-spec.js +22 -0
  5. package/claude-plugin.json +1 -1
  6. package/docs/CHEATSHEET.md +1 -1
  7. package/docs/QUICKSTART.md +1 -1
  8. package/framework/agents/README.md +14 -14
  9. package/framework/agents/architecture/standards-architect.md +159 -159
  10. package/framework/agents/infrastructure/azure-architect.md +149 -149
  11. package/framework/agents/infrastructure/infra-architect.md +48 -48
  12. package/framework/hooks/README.md +204 -204
  13. package/framework/hooks/shared/phase-utils.js +139 -139
  14. package/framework/rules/csharp-standards.md +13 -13
  15. package/framework/rules/frontend-standards.md +13 -13
  16. package/framework/rules/infrastructure-standards.md +16 -16
  17. package/framework/rules/testing-standards.md +14 -14
  18. package/framework/skills/level-0-meta/morph-code-review-nextjs/references/review-example-nextjs.md +254 -254
  19. package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md +1 -1
  20. package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md +1 -1
  21. package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md +1 -1
  22. package/framework/skills/level-1-workflows/morph-phase-implement/.morph/logs/activity.json +38 -0
  23. package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md +1 -1
  24. package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md +1 -1
  25. package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md +1 -1
  26. package/framework/skills/level-1-workflows/morph-phase-tasks/.morph/logs/activity.json +14 -0
  27. package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md +1 -1
  28. package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md +1 -1
  29. package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md +1 -1
  30. package/framework/standards/STANDARDS.json +2338 -2041
  31. package/framework/standards/frontend/nextjs/nextjs-patterns.md +17 -17
  32. package/framework/standards/infrastructure/supabase/supabase-custom-jwt.md +206 -0
  33. package/framework/templates/.idea/morph-templates.xml +92 -0
  34. package/framework/templates/.vscode/morph-templates.code-snippets +186 -0
  35. package/framework/templates/README.md +814 -814
  36. package/framework/templates/code/dotnet/contracts/Commands.cs +74 -74
  37. package/framework/templates/code/dotnet/contracts/Entities.cs +25 -25
  38. package/framework/templates/code/dotnet/contracts/Queries.cs +74 -74
  39. package/framework/templates/code/dotnet/contracts/README.md +74 -74
  40. package/framework/templates/code/dotnet/contracts/api-contracts.cs +173 -173
  41. package/framework/templates/code/dotnet/frontend/component.razor +239 -239
  42. package/framework/templates/code/dotnet/jobs/agent.cs +163 -163
  43. package/framework/templates/code/dotnet/jobs/job.cs +171 -171
  44. package/framework/templates/code/dotnet/test.cs +239 -239
  45. package/framework/templates/code/sql/rls-policy.sql +57 -57
  46. package/framework/templates/code/sql/supabase-migration.sql +100 -100
  47. package/framework/templates/code/sql/supabase-migration.template.sql +113 -113
  48. package/framework/templates/code/typescript/contracts.ts +168 -168
  49. package/framework/templates/context/CONTEXT.md +181 -181
  50. package/framework/templates/docs/proposal.md +182 -182
  51. package/framework/templates/docs/user-stories.md +34 -34
  52. package/framework/templates/examples/design-system-examples.md +357 -357
  53. package/framework/templates/examples/spec-examples.md +90 -90
  54. package/framework/templates/feature/decisions.md +187 -187
  55. package/framework/templates/feature/recap.md +146 -146
  56. package/framework/templates/feature/tasks.md +199 -199
  57. package/framework/templates/infrastructure/azure/README.md +286 -286
  58. package/framework/templates/infrastructure/azure/deploy-checklist.md +426 -426
  59. package/framework/templates/infrastructure/azure/parameters.dev.json +29 -29
  60. package/framework/templates/infrastructure/azure/parameters.prod.json +29 -29
  61. package/framework/templates/infrastructure/azure/parameters.staging.json +29 -29
  62. package/framework/templates/infrastructure/docker/docker-compose.template.yml +67 -67
  63. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  64. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  65. package/framework/templates/infrastructure/docker/easypanel.template.json +54 -54
  66. package/package.json +1 -1
  67. package/src/commands/agents/dispatch-agents.js +17 -0
  68. package/src/commands/agents/index.js +13 -13
  69. package/src/commands/agents/project-metrics.js +74 -0
  70. package/src/commands/project/install-plugin-cmd.js +28 -28
  71. package/src/commands/project/setup-infra-cmd.js +12 -12
  72. package/src/commands/standards/context-budget.js +89 -0
  73. package/src/commands/tasks/index.js +4 -4
  74. package/src/commands/templates/index.js +5 -5
  75. package/src/commands/utils/index.js +3 -3
  76. package/src/commands/validation/index.js +4 -4
  77. package/src/core/state/phase-state-machine.js +217 -217
  78. package/src/lib/agents/metrics-aggregator.js +56 -0
  79. package/src/lib/generators/design-system-generator.js +298 -298
  80. package/src/lib/generators/index.js +10 -10
  81. package/src/lib/generators/metadata-extractor.js +387 -387
  82. package/src/lib/stack-filter.js +65 -65
  83. package/src/lib/standards/digest-builder.js +57 -3
  84. package/src/lib/standards/index.js +7 -7
  85. package/src/lib/standards/standards-context-injector.js +302 -302
  86. package/src/lib/validators/architecture/architecture-validator.js +387 -387
  87. package/src/lib/validators/architecture/index.js +7 -7
  88. package/src/lib/validators/blazor/blazor-concurrency-analyzer.js +316 -316
  89. package/src/lib/validators/blazor/blazor-state-validator.js +279 -279
  90. package/src/lib/validators/blazor/blazor-validator.js +369 -369
  91. package/src/lib/validators/blazor/index.js +9 -9
  92. package/src/lib/validators/content/content-validator.js +287 -287
  93. package/src/lib/validators/content/index.js +7 -7
  94. package/src/lib/validators/contracts/index.js +7 -7
  95. package/src/lib/validators/css/css-validator.js +352 -352
  96. package/src/lib/validators/css/index.js +7 -7
  97. package/src/lib/validators/design-system/design-system-validator.js +231 -231
  98. package/src/lib/validators/design-system/index.js +7 -7
  99. package/src/lib/validators/nextjs/index.js +6 -6
  100. package/src/lib/validators/nextjs/next-component-validator.js +183 -183
  101. package/src/lib/validators/packages/index.js +7 -7
  102. package/src/lib/validators/packages/package-validator.js +360 -360
  103. package/src/lib/validators/shared/index.js +12 -12
  104. package/src/lib/validators/shared/issue-counter.js +18 -18
  105. package/src/lib/validators/shared/result-formatter.js +124 -124
  106. package/src/lib/validators/ui/index.js +7 -7
  107. package/src/lib/validators/ui/ui-contrast-validator.js +422 -422
  108. package/src/scripts/global-install.js +58 -58
  109. package/src/scripts/install-plugin.js +126 -126
  110. package/src/utils/claude-md-injector.js +90 -90
  111. package/src/utils/file-copier.js +200 -200
  112. package/src/utils/logger.js +32 -32
  113. package/src/utils/skills-installer.js +178 -178
  114. package/src/utils/version-checker.js +175 -175
@@ -1,200 +1,200 @@
1
- import fs from 'fs-extra';
2
- import { join, dirname, resolve } from 'path';
3
- import { fileURLToPath } from 'url';
4
-
5
- const __dirname = dirname(fileURLToPath(import.meta.url));
6
- const frameworkRoot = join(__dirname, '..', '..');
7
-
8
- function isSamePath(a, b) {
9
- return resolve(a) === resolve(b);
10
- }
11
-
12
- export function getContentDir() {
13
- return frameworkRoot;
14
- }
15
-
16
- export async function copyDirectory(src, dest, options = {}) {
17
- if (isSamePath(src, dest)) return;
18
-
19
- const { filter, overwrite = true } = options;
20
-
21
- await fs.copy(src, dest, {
22
- overwrite,
23
- filter: filter || (() => true),
24
- errorOnExist: false
25
- });
26
- }
27
-
28
- export async function copyFile(src, dest) {
29
- if (isSamePath(src, dest)) return;
30
-
31
- await fs.ensureDir(dirname(dest));
32
- await fs.copy(src, dest, { overwrite: true });
33
- }
34
-
35
- export async function pathExists(path) {
36
- return fs.pathExists(path);
37
- }
38
-
39
- export async function readJson(path) {
40
- return fs.readJson(path);
41
- }
42
-
43
- export async function writeJson(path, data) {
44
- await fs.ensureDir(dirname(path));
45
- await fs.writeJson(path, data, { spaces: 2 });
46
- }
47
-
48
- export async function ensureDir(path) {
49
- await fs.ensureDir(path);
50
- }
51
-
52
- export async function writeFile(path, content) {
53
- await fs.ensureDir(dirname(path));
54
- await fs.writeFile(path, content, 'utf8');
55
- }
56
-
57
- export async function removeDir(path) {
58
- await fs.remove(path);
59
- }
60
-
61
- export async function readFile(path) {
62
- return fs.readFile(path, 'utf8');
63
- }
64
-
65
- /**
66
- * Create a link to a file or directory with platform-aware fallbacks.
67
- *
68
- * For files: hard link → symlink → copy
69
- * Hard links work on Windows without admin (same NTFS volume).
70
- * For dirs: delegates to createDirectoryLink (junction on Windows).
71
- *
72
- * @param {string} target - Path to the original file/folder
73
- * @param {string} link - Path where the link should be created
74
- * @param {string} type - 'file' or 'dir'
75
- * @returns {Promise<'hardlink' | 'symlink' | 'junction' | 'copy'>}
76
- */
77
- export async function createSymlink(target, link, type = 'file') {
78
- await fs.ensureDir(dirname(link));
79
-
80
- if (type === 'dir') {
81
- return createDirectoryLink(target, link);
82
- }
83
-
84
- // File linking: hard link first (no admin on Windows), then symlink, then copy
85
- try {
86
- await fs.link(target, link);
87
- return 'hardlink';
88
- } catch {
89
- try {
90
- await fs.ensureSymlink(target, link, 'file');
91
- return 'symlink';
92
- } catch {
93
- await copyFile(target, link);
94
- return 'copy';
95
- }
96
- }
97
- }
98
-
99
- /**
100
- * Create a directory link (junction on Windows, symlink on other platforms)
101
- * with fallback to directory copy if linking fails.
102
- * @param {string} target - Path to the original directory
103
- * @param {string} link - Path where the link should be created
104
- * @returns {Promise<'junction' | 'symlink' | 'copy'>} - How the link was created
105
- */
106
- export async function createDirectoryLink(target, link) {
107
- await fs.ensureDir(dirname(link));
108
-
109
- // Remove existing link/directory before recreating
110
- if (await pathExists(link)) {
111
- await fs.remove(link);
112
- }
113
-
114
- if (process.platform === 'win32') {
115
- // Junction on Windows — does NOT require admin privileges.
116
- // Skip ensureSymlink('dir') fallback: it also needs admin on Windows.
117
- try {
118
- await fs.symlink(target, link, 'junction');
119
- return 'junction';
120
- } catch {
121
- await copyDirectory(target, link);
122
- return 'copy';
123
- }
124
- } else {
125
- try {
126
- await fs.ensureSymlink(target, link, 'dir');
127
- return 'symlink';
128
- } catch {
129
- await copyDirectory(target, link);
130
- return 'copy';
131
- }
132
- }
133
- }
134
-
135
- export async function updateGitignore(projectPath) {
136
- const gitignorePath = join(projectPath, '.gitignore');
137
-
138
- const morphRules = [
139
- '',
140
- '# MORPH-SPEC',
141
- '.morph/framework/',
142
- '.morph/memory/',
143
- '.morph/plans/',
144
- '.morph/analytics/',
145
- '.claude/commands/',
146
- '.claude/rules/',
147
- '.claude/skills/',
148
- '.claude/agents/',
149
- '.claude/CLAUDE.md',
150
- '.claude/settings.local.json',
151
- '.worktrees/',
152
- ''
153
- ];
154
-
155
- let content = '';
156
- let hasMorphSection = false;
157
-
158
- // Read existing .gitignore if it exists
159
- if (await pathExists(gitignorePath)) {
160
- content = await readFile(gitignorePath);
161
- hasMorphSection = content.includes('# MORPH-SPEC');
162
- }
163
-
164
- // If MORPH section already exists, check if rules are up to date
165
- if (hasMorphSection) {
166
- const lines = content.split('\n');
167
- const morphStartIndex = lines.findIndex(line => line.trim() === '# MORPH-SPEC');
168
-
169
- // Find the end of MORPH section (next empty line or section header)
170
- let morphEndIndex = morphStartIndex + 1;
171
- while (morphEndIndex < lines.length &&
172
- lines[morphEndIndex].trim() !== '' &&
173
- !lines[morphEndIndex].startsWith('#')) {
174
- morphEndIndex++;
175
- }
176
-
177
- // Extract current MORPH rules
178
- const currentMorphRules = lines.slice(morphStartIndex, morphEndIndex + 1);
179
- const expectedMorphRules = morphRules.slice(1, -1); // Remove empty lines from comparison
180
-
181
- // Check if all expected rules are present
182
- const missingRules = expectedMorphRules.filter(rule =>
183
- rule.startsWith('#') || !currentMorphRules.some(line => line.trim() === rule)
184
- );
185
-
186
- if (missingRules.length > 0) {
187
- // Update the section with all rules
188
- lines.splice(morphStartIndex, morphEndIndex - morphStartIndex, ...morphRules.slice(1, -1));
189
- content = lines.join('\n');
190
- }
191
- } else {
192
- // Add MORPH section
193
- if (content && !content.endsWith('\n')) {
194
- content += '\n';
195
- }
196
- content += morphRules.join('\n');
197
- }
198
-
199
- await writeFile(gitignorePath, content);
200
- }
1
+ import fs from 'fs-extra';
2
+ import { join, dirname, resolve } from 'path';
3
+ import { fileURLToPath } from 'url';
4
+
5
+ const __dirname = dirname(fileURLToPath(import.meta.url));
6
+ const frameworkRoot = join(__dirname, '..', '..');
7
+
8
+ function isSamePath(a, b) {
9
+ return resolve(a) === resolve(b);
10
+ }
11
+
12
+ export function getContentDir() {
13
+ return frameworkRoot;
14
+ }
15
+
16
+ export async function copyDirectory(src, dest, options = {}) {
17
+ if (isSamePath(src, dest)) return;
18
+
19
+ const { filter, overwrite = true } = options;
20
+
21
+ await fs.copy(src, dest, {
22
+ overwrite,
23
+ filter: filter || (() => true),
24
+ errorOnExist: false
25
+ });
26
+ }
27
+
28
+ export async function copyFile(src, dest) {
29
+ if (isSamePath(src, dest)) return;
30
+
31
+ await fs.ensureDir(dirname(dest));
32
+ await fs.copy(src, dest, { overwrite: true });
33
+ }
34
+
35
+ export async function pathExists(path) {
36
+ return fs.pathExists(path);
37
+ }
38
+
39
+ export async function readJson(path) {
40
+ return fs.readJson(path);
41
+ }
42
+
43
+ export async function writeJson(path, data) {
44
+ await fs.ensureDir(dirname(path));
45
+ await fs.writeJson(path, data, { spaces: 2 });
46
+ }
47
+
48
+ export async function ensureDir(path) {
49
+ await fs.ensureDir(path);
50
+ }
51
+
52
+ export async function writeFile(path, content) {
53
+ await fs.ensureDir(dirname(path));
54
+ await fs.writeFile(path, content, 'utf8');
55
+ }
56
+
57
+ export async function removeDir(path) {
58
+ await fs.remove(path);
59
+ }
60
+
61
+ export async function readFile(path) {
62
+ return fs.readFile(path, 'utf8');
63
+ }
64
+
65
+ /**
66
+ * Create a link to a file or directory with platform-aware fallbacks.
67
+ *
68
+ * For files: hard link → symlink → copy
69
+ * Hard links work on Windows without admin (same NTFS volume).
70
+ * For dirs: delegates to createDirectoryLink (junction on Windows).
71
+ *
72
+ * @param {string} target - Path to the original file/folder
73
+ * @param {string} link - Path where the link should be created
74
+ * @param {string} type - 'file' or 'dir'
75
+ * @returns {Promise<'hardlink' | 'symlink' | 'junction' | 'copy'>}
76
+ */
77
+ export async function createSymlink(target, link, type = 'file') {
78
+ await fs.ensureDir(dirname(link));
79
+
80
+ if (type === 'dir') {
81
+ return createDirectoryLink(target, link);
82
+ }
83
+
84
+ // File linking: hard link first (no admin on Windows), then symlink, then copy
85
+ try {
86
+ await fs.link(target, link);
87
+ return 'hardlink';
88
+ } catch {
89
+ try {
90
+ await fs.ensureSymlink(target, link, 'file');
91
+ return 'symlink';
92
+ } catch {
93
+ await copyFile(target, link);
94
+ return 'copy';
95
+ }
96
+ }
97
+ }
98
+
99
+ /**
100
+ * Create a directory link (junction on Windows, symlink on other platforms)
101
+ * with fallback to directory copy if linking fails.
102
+ * @param {string} target - Path to the original directory
103
+ * @param {string} link - Path where the link should be created
104
+ * @returns {Promise<'junction' | 'symlink' | 'copy'>} - How the link was created
105
+ */
106
+ export async function createDirectoryLink(target, link) {
107
+ await fs.ensureDir(dirname(link));
108
+
109
+ // Remove existing link/directory before recreating
110
+ if (await pathExists(link)) {
111
+ await fs.remove(link);
112
+ }
113
+
114
+ if (process.platform === 'win32') {
115
+ // Junction on Windows — does NOT require admin privileges.
116
+ // Skip ensureSymlink('dir') fallback: it also needs admin on Windows.
117
+ try {
118
+ await fs.symlink(target, link, 'junction');
119
+ return 'junction';
120
+ } catch {
121
+ await copyDirectory(target, link);
122
+ return 'copy';
123
+ }
124
+ } else {
125
+ try {
126
+ await fs.ensureSymlink(target, link, 'dir');
127
+ return 'symlink';
128
+ } catch {
129
+ await copyDirectory(target, link);
130
+ return 'copy';
131
+ }
132
+ }
133
+ }
134
+
135
+ export async function updateGitignore(projectPath) {
136
+ const gitignorePath = join(projectPath, '.gitignore');
137
+
138
+ const morphRules = [
139
+ '',
140
+ '# MORPH-SPEC',
141
+ '.morph/framework/',
142
+ '.morph/memory/',
143
+ '.morph/plans/',
144
+ '.morph/analytics/',
145
+ '.claude/commands/',
146
+ '.claude/rules/',
147
+ '.claude/skills/',
148
+ '.claude/agents/',
149
+ '.claude/CLAUDE.md',
150
+ '.claude/settings.local.json',
151
+ '.worktrees/',
152
+ ''
153
+ ];
154
+
155
+ let content = '';
156
+ let hasMorphSection = false;
157
+
158
+ // Read existing .gitignore if it exists
159
+ if (await pathExists(gitignorePath)) {
160
+ content = await readFile(gitignorePath);
161
+ hasMorphSection = content.includes('# MORPH-SPEC');
162
+ }
163
+
164
+ // If MORPH section already exists, check if rules are up to date
165
+ if (hasMorphSection) {
166
+ const lines = content.split('\n');
167
+ const morphStartIndex = lines.findIndex(line => line.trim() === '# MORPH-SPEC');
168
+
169
+ // Find the end of MORPH section (next empty line or section header)
170
+ let morphEndIndex = morphStartIndex + 1;
171
+ while (morphEndIndex < lines.length &&
172
+ lines[morphEndIndex].trim() !== '' &&
173
+ !lines[morphEndIndex].startsWith('#')) {
174
+ morphEndIndex++;
175
+ }
176
+
177
+ // Extract current MORPH rules
178
+ const currentMorphRules = lines.slice(morphStartIndex, morphEndIndex + 1);
179
+ const expectedMorphRules = morphRules.slice(1, -1); // Remove empty lines from comparison
180
+
181
+ // Check if all expected rules are present
182
+ const missingRules = expectedMorphRules.filter(rule =>
183
+ rule.startsWith('#') || !currentMorphRules.some(line => line.trim() === rule)
184
+ );
185
+
186
+ if (missingRules.length > 0) {
187
+ // Update the section with all rules
188
+ lines.splice(morphStartIndex, morphEndIndex - morphStartIndex, ...morphRules.slice(1, -1));
189
+ content = lines.join('\n');
190
+ }
191
+ } else {
192
+ // Add MORPH section
193
+ if (content && !content.endsWith('\n')) {
194
+ content += '\n';
195
+ }
196
+ content += morphRules.join('\n');
197
+ }
198
+
199
+ await writeFile(gitignorePath, content);
200
+ }
@@ -1,32 +1,32 @@
1
- import chalk from 'chalk';
2
-
3
- export const logger = {
4
- info: (msg) => console.log(chalk.cyan(` ${msg}`)),
5
- success: (msg) => console.log(chalk.green(` ✓ ${msg}`)),
6
- warn: (msg) => console.log(chalk.yellow(` ⚠ ${msg}`)),
7
- error: (msg) => console.log(chalk.red(` ✗ ${msg}`)),
8
- dim: (msg) => console.log(chalk.gray(` ${msg}`)),
9
-
10
- header: (msg) => {
11
- console.log('');
12
- console.log(chalk.cyan.bold(` ${msg}`));
13
- console.log(chalk.cyan(' ' + '─'.repeat(msg.length)));
14
- console.log('');
15
- },
16
-
17
- step: (num, msg) => console.log(chalk.white(` ${num}. ${msg}`)),
18
-
19
- blank: () => console.log(''),
20
-
21
- box: (lines) => {
22
- const maxLen = Math.max(...lines.map(l => l.length));
23
- const border = '─'.repeat(maxLen + 2);
24
-
25
- console.log(chalk.cyan(` ┌${border}┐`));
26
- lines.forEach(line => {
27
- const padded = line.padEnd(maxLen);
28
- console.log(chalk.cyan(` │ ${padded} │`));
29
- });
30
- console.log(chalk.cyan(` └${border}┘`));
31
- }
32
- };
1
+ import chalk from 'chalk';
2
+
3
+ export const logger = {
4
+ info: (msg) => console.log(chalk.cyan(` ${msg}`)),
5
+ success: (msg) => console.log(chalk.green(` ✓ ${msg}`)),
6
+ warn: (msg) => console.log(chalk.yellow(` ⚠ ${msg}`)),
7
+ error: (msg) => console.log(chalk.red(` ✗ ${msg}`)),
8
+ dim: (msg) => console.log(chalk.gray(` ${msg}`)),
9
+
10
+ header: (msg) => {
11
+ console.log('');
12
+ console.log(chalk.cyan.bold(` ${msg}`));
13
+ console.log(chalk.cyan(' ' + '─'.repeat(msg.length)));
14
+ console.log('');
15
+ },
16
+
17
+ step: (num, msg) => console.log(chalk.white(` ${num}. ${msg}`)),
18
+
19
+ blank: () => console.log(''),
20
+
21
+ box: (lines) => {
22
+ const maxLen = Math.max(...lines.map(l => l.length));
23
+ const border = '─'.repeat(maxLen + 2);
24
+
25
+ console.log(chalk.cyan(` ┌${border}┐`));
26
+ lines.forEach(line => {
27
+ const padded = line.padEnd(maxLen);
28
+ console.log(chalk.cyan(` │ ${padded} │`));
29
+ });
30
+ console.log(chalk.cyan(` └${border}┘`));
31
+ }
32
+ };