@polymorphism-tech/morph-spec 8.33.0 → 8.34.2
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.
- package/CLAUDE.md +3 -0
- package/README.md +2 -2
- package/bin/morph-spec.js +25 -1
- package/bin/validate.js +379 -379
- package/claude-plugin.json +1 -1
- package/docs/CHEATSHEET.md +1 -1
- package/docs/QUICKSTART.md +1 -1
- package/framework/CLAUDE.md +2 -2
- package/framework/MORPH.md +4 -5
- package/framework/agents.json +1 -0
- package/framework/docs/CLI.md +5 -2
- package/framework/hooks/README.md +11 -1
- package/framework/hooks/claude-code/core/block-destructive-worktree-removal.js +5 -8
- package/framework/hooks/claude-code/core/block-raw-worktree-add.js +79 -0
- package/framework/hooks/claude-code/core/chain.js +27 -7
- package/framework/hooks/claude-code/core/worktree-context.js +83 -14
- package/framework/hooks/claude-code/core/worktree-create.js +206 -0
- package/framework/hooks/claude-code/core/worktree-env-inject.js +87 -0
- package/framework/hooks/claude-code/core/worktree-remove.js +81 -0
- package/framework/hooks/claude-code/statusline.sh +11 -11
- package/framework/hooks/git/commit-msg/conventional-commits.sh +33 -33
- package/framework/hooks/git/pre-commit/agents.sh +25 -25
- package/framework/hooks/git/pre-commit/orchestrator.sh +64 -64
- package/framework/hooks/git/pre-commit/specs.sh +50 -50
- package/framework/hooks/git/pre-push/run-tests.sh +44 -44
- package/framework/hooks/shared/command-tokens.js +23 -0
- package/framework/hooks/shared/e2e-check.js +0 -0
- package/framework/hooks/shared/git-paths.js +25 -0
- package/framework/hooks/shared/hook-response.js +17 -0
- package/framework/hooks/shared/morph-cli.js +134 -0
- package/framework/hooks/shared/stdin-reader.js +26 -26
- package/framework/rules/infrastructure-standards.md +3 -1
- package/framework/skills/core/create-umbraco-lp/SKILL.md +1 -1
- package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md +1 -1
- package/framework/skills/core/morph-apply/SKILL.md +3 -3
- package/framework/skills/core/morph-brainstorming/SKILL.md +1 -1
- package/framework/skills/core/morph-eval/SKILL.md +1 -1
- package/framework/skills/core/morph-hotfix/SKILL.md +1 -1
- package/framework/skills/core/morph-implement/SKILL.md +3 -1
- package/framework/skills/core/morph-plan/SKILL.md +6 -3
- package/framework/skills/core/morph-proposal/SKILL.md +1 -1
- package/framework/skills/core/morph-review/SKILL.md +1 -1
- package/framework/skills/core/morph-stack-scan/SKILL.md +1 -1
- package/framework/skills/core/morph-standards/SKILL.md +1 -1
- package/framework/skills/core/morph-uiux/SKILL.md +1 -1
- package/framework/standards/STANDARDS.json +30 -0
- package/framework/standards/ai-agents/agent-session.md +160 -160
- package/framework/standards/ai-agents/batching.md +193 -193
- package/framework/standards/ai-agents/context-providers.md +188 -188
- package/framework/standards/ai-agents/mcp-server.md +250 -250
- package/framework/standards/ai-agents/mcp-tools.md +197 -197
- package/framework/standards/ai-agents/middleware-patterns.md +207 -207
- package/framework/standards/ai-agents/modalities-image-gen.md +173 -173
- package/framework/standards/ai-agents/modalities-speech-to-text.md +171 -171
- package/framework/standards/ai-agents/modalities-text-to-speech.md +181 -181
- package/framework/standards/ai-agents/modalities-vision.md +201 -201
- package/framework/standards/ai-agents/multi-agent-patterns.md +155 -155
- package/framework/standards/ai-agents/production.md +231 -231
- package/framework/standards/ai-agents/prompts-in-db.md +214 -214
- package/framework/standards/ai-agents/providers/model-registry.md +158 -158
- package/framework/standards/ai-agents/service-tier-flex.md +135 -135
- package/framework/standards/ai-agents/structured-output.md +249 -249
- package/framework/standards/ai-agents/sweet-spot.md +109 -109
- package/framework/standards/infrastructure/docker/local-compose-isolation.md +88 -0
- package/framework/templates/IDE-SNIPPETS.md +262 -262
- package/framework/templates/REGISTRY.json +1 -1
- package/framework/templates/code/dotnet/abstractions/api-endpoint.cs +7 -7
- package/framework/templates/code/dotnet/ai-agents/AgentBootstrap.cs.template +39 -39
- package/framework/templates/code/dotnet/ai-agents/EmbeddingService.cs.template +68 -68
- package/framework/templates/code/dotnet/ai-agents/ModelRegistry.cs.template +117 -117
- package/framework/templates/code/dotnet/ai-agents/PromptRepository.cs.template +95 -95
- package/framework/templates/code/dotnet/ai-agents/ResilientToolMiddleware.cs.template +61 -61
- package/framework/templates/code/dotnet/ai-agents/VectorSearchTool.cs.template +107 -107
- package/framework/templates/code/dotnet/ai-agents/model-registry.json.template +58 -58
- package/framework/templates/code/dotnet/contracts/contracts-vsa.cs +281 -281
- package/framework/templates/code/dotnet/database/migration.cs +83 -83
- package/framework/templates/code/dotnet/feature/endpoint.cs.hbs +21 -21
- package/framework/templates/code/dotnet/feature/request.cs.hbs +4 -4
- package/framework/templates/code/dotnet/feature/response.cs.hbs +4 -4
- package/framework/templates/code/dotnet/feature/validator.cs.hbs +15 -15
- package/framework/templates/code/sql/ai-agents/agent-prompts-migration.sql.template +58 -58
- package/framework/templates/code/sql/ai-agents/pgvector-embeddings-migration.sql.template +91 -91
- package/framework/templates/code/typescript/contracts.ts +167 -167
- package/framework/templates/docs/clarifications.md +253 -253
- package/framework/templates/docs/schema-analysis.md +119 -119
- package/framework/templates/docs/ui-components.md +52 -52
- package/framework/templates/docs/ui-design-system.md +76 -76
- package/framework/templates/docs/ui-flows.md +167 -167
- package/framework/templates/docs/ui-mockups.md +98 -98
- package/framework/templates/feature/decisions.md +122 -122
- package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -43
- package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -26
- package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -32
- package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -56
- package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -22
- package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -26
- package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -54
- package/framework/templates/infrastructure/docker/Dockerfile.template +58 -58
- package/framework/templates/infrastructure/docker/docker-compose.template.yml +24 -14
- package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
- package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
- package/framework/templates/infrastructure/github/README.md +56 -56
- package/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -45
- package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -27
- package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -59
- package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -39
- package/framework/templates/integrations/asaas-client.cs +387 -387
- package/framework/templates/integrations/asaas-webhook.cs +351 -351
- package/framework/templates/meta-prompts/fusion/fusion-agent.md +76 -76
- package/framework/templates/meta-prompts/fusion/fusion-aggregator.md +100 -100
- package/framework/templates/meta-prompts/validators/pre-commit-validator.md +95 -95
- package/framework/templates/project/validate.js +120 -120
- package/framework/templates/state.template.json +17 -17
- package/framework/templates/ui/design-system.css +226 -226
- package/package.json +1 -1
- package/src/commands/dashboard/dashboard.js +53 -53
- package/src/commands/e2e/e2e.js +77 -39
- package/src/commands/index.js +13 -13
- package/src/commands/project/checkpoint.js +209 -209
- package/src/commands/project/doctor.js +8 -6
- package/src/commands/project/env.js +95 -0
- package/src/commands/project/worktree.js +266 -52
- package/src/commands/state/delete.js +8 -0
- package/src/commands/state/finish.js +29 -34
- package/src/core/state/phase-state-machine.js +197 -197
- package/src/core/templates/template-renderer.js +477 -477
- package/src/dashboard/app/components/DetailPanel.jsx +11 -11
- package/src/dashboard/app/components/FlowGraph.jsx +17 -17
- package/src/dashboard/app/components/SearchFilter.jsx +22 -22
- package/src/dashboard/app/hooks/useDetailPanel.js +15 -15
- package/src/dashboard/app/main.jsx +13 -13
- package/src/dashboard/app/pages/AgentMap.jsx +370 -370
- package/src/dashboard/app/pages/HookInspector.jsx +430 -418
- package/src/dashboard/app/pages/PhasePipeline.jsx +408 -408
- package/src/dashboard/app/pages/RulesMap.jsx +273 -273
- package/src/dashboard/app/pages/SkillsLibrary.jsx +366 -366
- package/src/dashboard/app/pages/Standards.jsx +332 -332
- package/src/dashboard/app/styles/index.css +47 -47
- package/src/dashboard/index.html +12 -12
- package/src/dashboard/package.json +24 -24
- package/src/dashboard/scanner/hooks-scanner.js +5 -1
- package/src/dashboard/scanner/phases-scanner.js +15 -15
- package/src/dashboard/scanner/rubrics-scanner.js +12 -12
- package/src/dashboard/scanner/rules-scanner.js +37 -37
- package/src/dashboard/scanner/skills-scanner.js +43 -43
- package/src/dashboard/scanner/squads-scanner.js +13 -13
- package/src/dashboard/vite-plugin-morph-data.js +17 -17
- package/src/dashboard/vite.config.js +24 -24
- package/src/lib/detectors/design-system-detector.js +188 -188
- package/src/lib/detectors/index.js +217 -217
- package/src/lib/e2e/compose-env.js +6 -11
- package/src/lib/e2e/stack-teardown.js +115 -0
- package/src/lib/generators/architecture-scanner.js +2 -1
- package/src/lib/generators/design-system-generator.js +508 -508
- package/src/lib/generators/settings-generator.js +209 -209
- package/src/lib/graph/graphifyignore.js +2 -1
- package/src/lib/hooks/hook-executor.js +167 -167
- package/src/lib/installers/mcp-installer.js +719 -719
- package/src/lib/tasks/task-classifier.js +30 -30
- package/src/lib/tasks/task-parser.js +209 -209
- package/src/lib/tasks/test-runner.js +21 -4
- package/src/lib/validators/checkpoint-persistence.js +39 -39
- package/src/lib/validators/css/css-validator.js +340 -340
- package/src/lib/validators/shared/emit-validator-dispatch.js +14 -14
- package/src/lib/validators/shared/issue-counter.js +14 -14
- package/src/lib/validators/verify-runner.js +7 -0
- package/src/lib/worktree/dirs.js +32 -0
- package/src/lib/worktree/env-allocator.js +45 -11
- package/src/lib/worktree/worktree-audit.js +40 -2
- package/src/utils/agent-id-mapper.js +11 -11
- package/src/utils/claude-settings-manager.js +300 -300
- package/src/utils/file-copier.js +18 -13
- package/src/utils/hooks-installer.js +46 -3
- package/src/utils/skills-installer.js +187 -187
- package/framework/templates/.idea/morph-templates.xml +0 -92
- package/framework/templates/.vscode/morph-templates.code-snippets +0 -186
|
@@ -27,8 +27,15 @@ import { execSync } from 'child_process';
|
|
|
27
27
|
* (`copyDirectory` defaults to `overwrite: true`), so the bump does not gate
|
|
28
28
|
* delivery — it makes `morph-spec update` report the change honestly instead
|
|
29
29
|
* of "already current".
|
|
30
|
+
*
|
|
31
|
+
* 3.8.0 (worktree governance) registers Claude Code's WorktreeCreate /
|
|
32
|
+
* WorktreeRemove events — the native `claude -w` / EnterWorktree / Agent
|
|
33
|
+
* isolation worktree is replaced by `morph-spec worktree setup|provision`
|
|
34
|
+
* (junctions, port block, primary-root landing) and its removal routed
|
|
35
|
+
* through the safe `worktree remove --if-clean` — and appends
|
|
36
|
+
* block-raw-worktree-add to the PreToolUse:Bash chain.
|
|
30
37
|
*/
|
|
31
|
-
const HOOKS_VERSION = '3.
|
|
38
|
+
const HOOKS_VERSION = '3.8.0';
|
|
32
39
|
|
|
33
40
|
/** Marker for old dispatch.js (v1) */
|
|
34
41
|
const OLD_DISPATCH_COMMAND = 'node framework/hooks/agent-teams/dispatch.js';
|
|
@@ -137,14 +144,50 @@ const MORPH_HOOKS = [
|
|
|
137
144
|
// block-destructive-worktree-removal (dynamic: scans the target for reparse
|
|
138
145
|
// points), so the cheap check short-circuits the filesystem walk. The second
|
|
139
146
|
// one is the only defense against the raw-removal vector that does not depend
|
|
140
|
-
// on someone having read MORPH.md.
|
|
147
|
+
// on someone having read MORPH.md. block-raw-worktree-add is its way-IN
|
|
148
|
+
// counterpart (a raw `git worktree add` builds a tree with no junctions, no
|
|
149
|
+
// ports, no identity) — static, so it costs nothing after the first two.
|
|
150
|
+
// worktree-env-inject is LAST: it rewrites launcher commands (updatedInput)
|
|
151
|
+
// with the worktree's port block, and a command a previous link blocked must
|
|
152
|
+
// never be rewritten. Block-first-wins guarantees it never sees one.
|
|
141
153
|
{
|
|
142
154
|
event: 'PreToolUse',
|
|
143
155
|
matcher: 'Bash',
|
|
144
156
|
hooks: [{
|
|
145
157
|
type: 'command',
|
|
146
158
|
command: 'node framework/hooks/claude-code/core/chain.js',
|
|
147
|
-
args: ['pre-bash-denylist', 'block-destructive-worktree-removal']
|
|
159
|
+
args: ['pre-bash-denylist', 'block-destructive-worktree-removal', 'block-raw-worktree-add', 'worktree-env-inject']
|
|
160
|
+
}]
|
|
161
|
+
},
|
|
162
|
+
|
|
163
|
+
// === WorktreeCreate — REPLACES Claude Code's native `git worktree add` for
|
|
164
|
+
// `claude -w`, the EnterWorktree tool and `Agent isolation:"worktree"`
|
|
165
|
+
// (measured: all three fire it). The hook prints the created path as its
|
|
166
|
+
// last stdout line; a non-zero exit fails the creation. No matcher exists
|
|
167
|
+
// for this event. 120s: it spawns the morph-spec CLI (setup or provision),
|
|
168
|
+
// which runs git, links infra, allocates ports and materializes state. ===
|
|
169
|
+
{
|
|
170
|
+
event: 'WorktreeCreate',
|
|
171
|
+
matcher: null,
|
|
172
|
+
hooks: [{
|
|
173
|
+
type: 'command',
|
|
174
|
+
command: 'node framework/hooks/claude-code/core/worktree-create.js',
|
|
175
|
+
timeout: 120000
|
|
176
|
+
}]
|
|
177
|
+
},
|
|
178
|
+
|
|
179
|
+
// === WorktreeRemove — routes Claude Code's own cleanup through
|
|
180
|
+
// `morph-spec worktree remove --target --if-clean` (junctions dropped BEFORE
|
|
181
|
+
// git touches the tree; a dirty tree is left alone). Output ignored, always
|
|
182
|
+
// exit 0. Secondary net: in headless runs the event was observed not to
|
|
183
|
+
// fire — block-destructive-worktree-removal remains the primary defense. ===
|
|
184
|
+
{
|
|
185
|
+
event: 'WorktreeRemove',
|
|
186
|
+
matcher: null,
|
|
187
|
+
hooks: [{
|
|
188
|
+
type: 'command',
|
|
189
|
+
command: 'node framework/hooks/claude-code/core/worktree-remove.js',
|
|
190
|
+
timeout: 60000
|
|
148
191
|
}]
|
|
149
192
|
},
|
|
150
193
|
|
|
@@ -1,187 +1,187 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Skills Installer
|
|
3
|
-
*
|
|
4
|
-
* Copies framework skills to .claude/skills/ during morph-spec init.
|
|
5
|
-
* Installs only the `core/` skill set — the canonical NLH skills referenced by
|
|
6
|
-
* MORPH.md (morph-brainstorming, morph-stack-scan, morph-plan, morph-implement,
|
|
7
|
-
* morph-eval, morph-review, morph-standards). The 3-tier system was collapsed
|
|
8
|
-
* into a single source of truth in framework/skills/core/.
|
|
9
|
-
*
|
|
10
|
-
* Source skills are directory-based: framework/skills/core/{skill-name}/SKILL.md
|
|
11
|
-
* (plus optional scripts/, references/, assets/ subdirectories).
|
|
12
|
-
*
|
|
13
|
-
* Directory-based skills have their entire directory copied so Claude Code can
|
|
14
|
-
* execute scripts and load references on demand.
|
|
15
|
-
*/
|
|
16
|
-
|
|
17
|
-
import { mkdirSync, copyFileSync, existsSync, readdirSync, statSync, readFileSync, rmSync } from 'fs';
|
|
18
|
-
import { join } from 'path';
|
|
19
|
-
import { fileURLToPath } from 'url';
|
|
20
|
-
import { parseStacks, shouldInstall } from '../lib/stack-filter.js';
|
|
21
|
-
|
|
22
|
-
const __dirname = fileURLToPath(new URL('.', import.meta.url));
|
|
23
|
-
const FRAMEWORK_SKILLS_DIR = join(__dirname, '..', '..', 'framework', 'skills');
|
|
24
|
-
|
|
25
|
-
/**
|
|
26
|
-
* Skill levels to install in .claude/skills/.
|
|
27
|
-
* Only `core/` survives — single source of truth aligned with MORPH.md.
|
|
28
|
-
*/
|
|
29
|
-
const SKILL_LEVELS_TO_INSTALL = ['core'];
|
|
30
|
-
|
|
31
|
-
/**
|
|
32
|
-
* Check if a skill should be installed based on its stacks: frontmatter.
|
|
33
|
-
* @param {string} skillContent - Raw SKILL.md content
|
|
34
|
-
* @param {string[]} projectTags - Stack tags from config
|
|
35
|
-
* @returns {boolean}
|
|
36
|
-
*/
|
|
37
|
-
export function shouldInstallSkill(skillContent, projectTags) {
|
|
38
|
-
return shouldInstall(parseStacks(skillContent), projectTags);
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
/**
|
|
42
|
-
* Recursively copy a directory tree from src to dest.
|
|
43
|
-
* Creates dest if it doesn't exist. Skips README.md files.
|
|
44
|
-
*
|
|
45
|
-
* @param {string} src - Source directory path
|
|
46
|
-
* @param {string} dest - Destination directory path
|
|
47
|
-
*/
|
|
48
|
-
function copyDirectory(src, dest) {
|
|
49
|
-
mkdirSync(dest, { recursive: true });
|
|
50
|
-
for (const entry of readdirSync(src)) {
|
|
51
|
-
if (entry === 'README.md') continue;
|
|
52
|
-
const srcPath = join(src, entry);
|
|
53
|
-
const destPath = join(dest, entry);
|
|
54
|
-
if (statSync(srcPath).isDirectory()) {
|
|
55
|
-
copyDirectory(srcPath, destPath);
|
|
56
|
-
} else {
|
|
57
|
-
copyFileSync(srcPath, destPath);
|
|
58
|
-
}
|
|
59
|
-
}
|
|
60
|
-
}
|
|
61
|
-
|
|
62
|
-
/**
|
|
63
|
-
* Walk srcDir and install skills into destDir.
|
|
64
|
-
*
|
|
65
|
-
* Handles two source formats:
|
|
66
|
-
* 1. Directory-based skill: srcDir/{skill-name}/SKILL.md
|
|
67
|
-
* → copies entire directory (SKILL.md + scripts/ + references/ + assets/)
|
|
68
|
-
* → destDir/{skill-name}/
|
|
69
|
-
*
|
|
70
|
-
* 2. Flat .md skill (legacy): srcDir/{skill-name}.md
|
|
71
|
-
* → destDir/{skill-name}/SKILL.md
|
|
72
|
-
*
|
|
73
|
-
* The `core/` level directory is traversed recursively. A directory is
|
|
74
|
-
* recognized as a skill directory when it contains a SKILL.md file.
|
|
75
|
-
*
|
|
76
|
-
* @param {string} srcDir - Source directory to walk
|
|
77
|
-
* @param {string} destDir - Destination base directory (.claude/skills/)
|
|
78
|
-
* @param {string[]} projectTags - Stack tags from config
|
|
79
|
-
* @param {Set<string>} installedNow - Accumulator: skill names this call
|
|
80
|
-
* actually (re)installed. NOT derived by re-scanning destDir afterwards —
|
|
81
|
-
* a disk scan can't distinguish "installed this run" from "leftover from a
|
|
82
|
-
* previous run with different projectTags", which is exactly the stale
|
|
83
|
-
* entry a stack change needs cleaned up.
|
|
84
|
-
*/
|
|
85
|
-
function installSkillsFromDir(srcDir, destDir, projectTags, installedNow) {
|
|
86
|
-
const entries = readdirSync(srcDir);
|
|
87
|
-
for (const entry of entries) {
|
|
88
|
-
const srcPath = join(srcDir, entry);
|
|
89
|
-
const stat = statSync(srcPath);
|
|
90
|
-
|
|
91
|
-
if (stat.isDirectory()) {
|
|
92
|
-
const skillMdPath = join(srcPath, 'SKILL.md');
|
|
93
|
-
if (existsSync(skillMdPath)) {
|
|
94
|
-
// Directory-based skill — check stack filter before copying
|
|
95
|
-
const content = readFileSync(skillMdPath, 'utf-8');
|
|
96
|
-
if (!shouldInstallSkill(content, projectTags)) continue;
|
|
97
|
-
const skillDestDir = join(destDir, entry);
|
|
98
|
-
copyDirectory(srcPath, skillDestDir);
|
|
99
|
-
installedNow.add(entry);
|
|
100
|
-
} else {
|
|
101
|
-
// Level/category directory — recurse
|
|
102
|
-
installSkillsFromDir(srcPath, destDir, projectTags, installedNow);
|
|
103
|
-
}
|
|
104
|
-
} else if (entry.endsWith('.md') && entry !== 'README.md') {
|
|
105
|
-
// Legacy flat .md skill — check stack filter before copying
|
|
106
|
-
const content = readFileSync(srcPath, 'utf-8');
|
|
107
|
-
if (!shouldInstallSkill(content, projectTags)) continue;
|
|
108
|
-
const skillName = entry.slice(0, -3);
|
|
109
|
-
const skillDir = join(destDir, skillName);
|
|
110
|
-
mkdirSync(skillDir, { recursive: true });
|
|
111
|
-
copyFileSync(srcPath, join(skillDir, 'SKILL.md'));
|
|
112
|
-
installedNow.add(skillName);
|
|
113
|
-
}
|
|
114
|
-
}
|
|
115
|
-
}
|
|
116
|
-
|
|
117
|
-
function collectSourceSkillNames() {
|
|
118
|
-
const names = new Set();
|
|
119
|
-
for (const level of SKILL_LEVELS_TO_INSTALL) {
|
|
120
|
-
const levelDir = join(FRAMEWORK_SKILLS_DIR, level);
|
|
121
|
-
if (!existsSync(levelDir)) continue;
|
|
122
|
-
collectNamesFromDir(levelDir, names);
|
|
123
|
-
}
|
|
124
|
-
return names;
|
|
125
|
-
}
|
|
126
|
-
|
|
127
|
-
function collectNamesFromDir(dir, names) {
|
|
128
|
-
for (const entry of readdirSync(dir)) {
|
|
129
|
-
const fullPath = join(dir, entry);
|
|
130
|
-
if (!statSync(fullPath).isDirectory()) continue;
|
|
131
|
-
if (existsSync(join(fullPath, 'SKILL.md'))) {
|
|
132
|
-
names.add(entry);
|
|
133
|
-
} else {
|
|
134
|
-
collectNamesFromDir(fullPath, names);
|
|
135
|
-
}
|
|
136
|
-
}
|
|
137
|
-
}
|
|
138
|
-
|
|
139
|
-
/**
|
|
140
|
-
* Install morph framework skills to .claude/skills/ in the target project.
|
|
141
|
-
* Skills are copied into subdirectories as SKILL.md files so Claude Code can
|
|
142
|
-
* discover them natively via /<skill-name> syntax (e.g., /phase-design,
|
|
143
|
-
* /nextjs-expert). Directory-based skills also get their scripts/,
|
|
144
|
-
* references/, and assets/ subdirectories copied for on-demand loading.
|
|
145
|
-
*
|
|
146
|
-
* Stack filtering: if projectTags is provided, only skills whose `stacks:`
|
|
147
|
-
* frontmatter matches the project tags are installed. Skills without a
|
|
148
|
-
* `stacks:` field are always installed (universal).
|
|
149
|
-
*
|
|
150
|
-
* @param {string} projectDir - Target project root directory
|
|
151
|
-
* @param {Object} [options]
|
|
152
|
-
* @param {string[]} [options.projectTags=[]] - Stack tags from config
|
|
153
|
-
*/
|
|
154
|
-
export async function installSkills(projectDir, { projectTags = [] } = {}) {
|
|
155
|
-
const claudeSkillsDir = join(projectDir, '.claude', 'skills');
|
|
156
|
-
mkdirSync(claudeSkillsDir, { recursive: true });
|
|
157
|
-
|
|
158
|
-
// Skill names this call actually (re)installs, given projectTags. Tracked
|
|
159
|
-
// as we go (NOT by re-scanning claudeSkillsDir afterwards) — a disk scan
|
|
160
|
-
// can't tell "installed this run" apart from "leftover from a previous
|
|
161
|
-
// run with different projectTags", which is exactly the stale entry a
|
|
162
|
-
// stack change (or a re-run that narrows the stack) needs cleaned up.
|
|
163
|
-
const installedNow = new Set();
|
|
164
|
-
for (const level of SKILL_LEVELS_TO_INSTALL) {
|
|
165
|
-
const levelDir = join(FRAMEWORK_SKILLS_DIR, level);
|
|
166
|
-
if (!existsSync(levelDir)) continue;
|
|
167
|
-
installSkillsFromDir(levelDir, claudeSkillsDir, projectTags, installedNow);
|
|
168
|
-
}
|
|
169
|
-
|
|
170
|
-
// Clean-slate: remove any skill dir that is a KNOWN framework skill (still
|
|
171
|
-
// present in framework/skills/core/) but did NOT get (re)installed this
|
|
172
|
-
// run — i.e. it was filtered out by a `stacks:` mismatch (project.stack
|
|
173
|
-
// changed, or a re-run narrowed the tags). Previously scoped to `morph-`
|
|
174
|
-
// prefixed names only, which silently exempted every non-`morph-` skill
|
|
175
|
-
// (the Umbraco pair) from ever being cleaned up: install once with
|
|
176
|
-
// `umbraco` in the stack, drop the stack later, and they'd survive every
|
|
177
|
-
// reinstall/update forever. Names outside allSourceSkills (user-added,
|
|
178
|
-
// non-framework skills) are never touched.
|
|
179
|
-
const allSourceSkills = collectSourceSkillNames();
|
|
180
|
-
for (const entry of readdirSync(claudeSkillsDir)) {
|
|
181
|
-
if (!installedNow.has(entry) && allSourceSkills.has(entry)) {
|
|
182
|
-
rmSync(join(claudeSkillsDir, entry), { recursive: true, force: true });
|
|
183
|
-
}
|
|
184
|
-
}
|
|
185
|
-
|
|
186
|
-
return { installed: installedNow.size };
|
|
187
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* Skills Installer
|
|
3
|
+
*
|
|
4
|
+
* Copies framework skills to .claude/skills/ during morph-spec init.
|
|
5
|
+
* Installs only the `core/` skill set — the canonical NLH skills referenced by
|
|
6
|
+
* MORPH.md (morph-brainstorming, morph-stack-scan, morph-plan, morph-implement,
|
|
7
|
+
* morph-eval, morph-review, morph-standards). The 3-tier system was collapsed
|
|
8
|
+
* into a single source of truth in framework/skills/core/.
|
|
9
|
+
*
|
|
10
|
+
* Source skills are directory-based: framework/skills/core/{skill-name}/SKILL.md
|
|
11
|
+
* (plus optional scripts/, references/, assets/ subdirectories).
|
|
12
|
+
*
|
|
13
|
+
* Directory-based skills have their entire directory copied so Claude Code can
|
|
14
|
+
* execute scripts and load references on demand.
|
|
15
|
+
*/
|
|
16
|
+
|
|
17
|
+
import { mkdirSync, copyFileSync, existsSync, readdirSync, statSync, readFileSync, rmSync } from 'fs';
|
|
18
|
+
import { join } from 'path';
|
|
19
|
+
import { fileURLToPath } from 'url';
|
|
20
|
+
import { parseStacks, shouldInstall } from '../lib/stack-filter.js';
|
|
21
|
+
|
|
22
|
+
const __dirname = fileURLToPath(new URL('.', import.meta.url));
|
|
23
|
+
const FRAMEWORK_SKILLS_DIR = join(__dirname, '..', '..', 'framework', 'skills');
|
|
24
|
+
|
|
25
|
+
/**
|
|
26
|
+
* Skill levels to install in .claude/skills/.
|
|
27
|
+
* Only `core/` survives — single source of truth aligned with MORPH.md.
|
|
28
|
+
*/
|
|
29
|
+
const SKILL_LEVELS_TO_INSTALL = ['core'];
|
|
30
|
+
|
|
31
|
+
/**
|
|
32
|
+
* Check if a skill should be installed based on its stacks: frontmatter.
|
|
33
|
+
* @param {string} skillContent - Raw SKILL.md content
|
|
34
|
+
* @param {string[]} projectTags - Stack tags from config
|
|
35
|
+
* @returns {boolean}
|
|
36
|
+
*/
|
|
37
|
+
export function shouldInstallSkill(skillContent, projectTags) {
|
|
38
|
+
return shouldInstall(parseStacks(skillContent), projectTags);
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Recursively copy a directory tree from src to dest.
|
|
43
|
+
* Creates dest if it doesn't exist. Skips README.md files.
|
|
44
|
+
*
|
|
45
|
+
* @param {string} src - Source directory path
|
|
46
|
+
* @param {string} dest - Destination directory path
|
|
47
|
+
*/
|
|
48
|
+
function copyDirectory(src, dest) {
|
|
49
|
+
mkdirSync(dest, { recursive: true });
|
|
50
|
+
for (const entry of readdirSync(src)) {
|
|
51
|
+
if (entry === 'README.md') continue;
|
|
52
|
+
const srcPath = join(src, entry);
|
|
53
|
+
const destPath = join(dest, entry);
|
|
54
|
+
if (statSync(srcPath).isDirectory()) {
|
|
55
|
+
copyDirectory(srcPath, destPath);
|
|
56
|
+
} else {
|
|
57
|
+
copyFileSync(srcPath, destPath);
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* Walk srcDir and install skills into destDir.
|
|
64
|
+
*
|
|
65
|
+
* Handles two source formats:
|
|
66
|
+
* 1. Directory-based skill: srcDir/{skill-name}/SKILL.md
|
|
67
|
+
* → copies entire directory (SKILL.md + scripts/ + references/ + assets/)
|
|
68
|
+
* → destDir/{skill-name}/
|
|
69
|
+
*
|
|
70
|
+
* 2. Flat .md skill (legacy): srcDir/{skill-name}.md
|
|
71
|
+
* → destDir/{skill-name}/SKILL.md
|
|
72
|
+
*
|
|
73
|
+
* The `core/` level directory is traversed recursively. A directory is
|
|
74
|
+
* recognized as a skill directory when it contains a SKILL.md file.
|
|
75
|
+
*
|
|
76
|
+
* @param {string} srcDir - Source directory to walk
|
|
77
|
+
* @param {string} destDir - Destination base directory (.claude/skills/)
|
|
78
|
+
* @param {string[]} projectTags - Stack tags from config
|
|
79
|
+
* @param {Set<string>} installedNow - Accumulator: skill names this call
|
|
80
|
+
* actually (re)installed. NOT derived by re-scanning destDir afterwards —
|
|
81
|
+
* a disk scan can't distinguish "installed this run" from "leftover from a
|
|
82
|
+
* previous run with different projectTags", which is exactly the stale
|
|
83
|
+
* entry a stack change needs cleaned up.
|
|
84
|
+
*/
|
|
85
|
+
function installSkillsFromDir(srcDir, destDir, projectTags, installedNow) {
|
|
86
|
+
const entries = readdirSync(srcDir);
|
|
87
|
+
for (const entry of entries) {
|
|
88
|
+
const srcPath = join(srcDir, entry);
|
|
89
|
+
const stat = statSync(srcPath);
|
|
90
|
+
|
|
91
|
+
if (stat.isDirectory()) {
|
|
92
|
+
const skillMdPath = join(srcPath, 'SKILL.md');
|
|
93
|
+
if (existsSync(skillMdPath)) {
|
|
94
|
+
// Directory-based skill — check stack filter before copying
|
|
95
|
+
const content = readFileSync(skillMdPath, 'utf-8');
|
|
96
|
+
if (!shouldInstallSkill(content, projectTags)) continue;
|
|
97
|
+
const skillDestDir = join(destDir, entry);
|
|
98
|
+
copyDirectory(srcPath, skillDestDir);
|
|
99
|
+
installedNow.add(entry);
|
|
100
|
+
} else {
|
|
101
|
+
// Level/category directory — recurse
|
|
102
|
+
installSkillsFromDir(srcPath, destDir, projectTags, installedNow);
|
|
103
|
+
}
|
|
104
|
+
} else if (entry.endsWith('.md') && entry !== 'README.md') {
|
|
105
|
+
// Legacy flat .md skill — check stack filter before copying
|
|
106
|
+
const content = readFileSync(srcPath, 'utf-8');
|
|
107
|
+
if (!shouldInstallSkill(content, projectTags)) continue;
|
|
108
|
+
const skillName = entry.slice(0, -3);
|
|
109
|
+
const skillDir = join(destDir, skillName);
|
|
110
|
+
mkdirSync(skillDir, { recursive: true });
|
|
111
|
+
copyFileSync(srcPath, join(skillDir, 'SKILL.md'));
|
|
112
|
+
installedNow.add(skillName);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
function collectSourceSkillNames() {
|
|
118
|
+
const names = new Set();
|
|
119
|
+
for (const level of SKILL_LEVELS_TO_INSTALL) {
|
|
120
|
+
const levelDir = join(FRAMEWORK_SKILLS_DIR, level);
|
|
121
|
+
if (!existsSync(levelDir)) continue;
|
|
122
|
+
collectNamesFromDir(levelDir, names);
|
|
123
|
+
}
|
|
124
|
+
return names;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
function collectNamesFromDir(dir, names) {
|
|
128
|
+
for (const entry of readdirSync(dir)) {
|
|
129
|
+
const fullPath = join(dir, entry);
|
|
130
|
+
if (!statSync(fullPath).isDirectory()) continue;
|
|
131
|
+
if (existsSync(join(fullPath, 'SKILL.md'))) {
|
|
132
|
+
names.add(entry);
|
|
133
|
+
} else {
|
|
134
|
+
collectNamesFromDir(fullPath, names);
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* Install morph framework skills to .claude/skills/ in the target project.
|
|
141
|
+
* Skills are copied into subdirectories as SKILL.md files so Claude Code can
|
|
142
|
+
* discover them natively via /<skill-name> syntax (e.g., /phase-design,
|
|
143
|
+
* /nextjs-expert). Directory-based skills also get their scripts/,
|
|
144
|
+
* references/, and assets/ subdirectories copied for on-demand loading.
|
|
145
|
+
*
|
|
146
|
+
* Stack filtering: if projectTags is provided, only skills whose `stacks:`
|
|
147
|
+
* frontmatter matches the project tags are installed. Skills without a
|
|
148
|
+
* `stacks:` field are always installed (universal).
|
|
149
|
+
*
|
|
150
|
+
* @param {string} projectDir - Target project root directory
|
|
151
|
+
* @param {Object} [options]
|
|
152
|
+
* @param {string[]} [options.projectTags=[]] - Stack tags from config
|
|
153
|
+
*/
|
|
154
|
+
export async function installSkills(projectDir, { projectTags = [] } = {}) {
|
|
155
|
+
const claudeSkillsDir = join(projectDir, '.claude', 'skills');
|
|
156
|
+
mkdirSync(claudeSkillsDir, { recursive: true });
|
|
157
|
+
|
|
158
|
+
// Skill names this call actually (re)installs, given projectTags. Tracked
|
|
159
|
+
// as we go (NOT by re-scanning claudeSkillsDir afterwards) — a disk scan
|
|
160
|
+
// can't tell "installed this run" apart from "leftover from a previous
|
|
161
|
+
// run with different projectTags", which is exactly the stale entry a
|
|
162
|
+
// stack change (or a re-run that narrows the stack) needs cleaned up.
|
|
163
|
+
const installedNow = new Set();
|
|
164
|
+
for (const level of SKILL_LEVELS_TO_INSTALL) {
|
|
165
|
+
const levelDir = join(FRAMEWORK_SKILLS_DIR, level);
|
|
166
|
+
if (!existsSync(levelDir)) continue;
|
|
167
|
+
installSkillsFromDir(levelDir, claudeSkillsDir, projectTags, installedNow);
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
// Clean-slate: remove any skill dir that is a KNOWN framework skill (still
|
|
171
|
+
// present in framework/skills/core/) but did NOT get (re)installed this
|
|
172
|
+
// run — i.e. it was filtered out by a `stacks:` mismatch (project.stack
|
|
173
|
+
// changed, or a re-run narrowed the tags). Previously scoped to `morph-`
|
|
174
|
+
// prefixed names only, which silently exempted every non-`morph-` skill
|
|
175
|
+
// (the Umbraco pair) from ever being cleaned up: install once with
|
|
176
|
+
// `umbraco` in the stack, drop the stack later, and they'd survive every
|
|
177
|
+
// reinstall/update forever. Names outside allSourceSkills (user-added,
|
|
178
|
+
// non-framework skills) are never touched.
|
|
179
|
+
const allSourceSkills = collectSourceSkillNames();
|
|
180
|
+
for (const entry of readdirSync(claudeSkillsDir)) {
|
|
181
|
+
if (!installedNow.has(entry) && allSourceSkills.has(entry)) {
|
|
182
|
+
rmSync(join(claudeSkillsDir, entry), { recursive: true, force: true });
|
|
183
|
+
}
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
return { installed: installedNow.size };
|
|
187
|
+
}
|
|
@@ -1,92 +0,0 @@
|
|
|
1
|
-
<templateSet group="MORPH Templates">
|
|
2
|
-
<template name="morph-pascal" value="{{pascalCase $FEATURE_NAME$}}" description="Convert to PascalCase (UserAuth)" toReformat="false" toShortenFQNames="true">
|
|
3
|
-
<variable name="FEATURE_NAME" expression="" defaultValue=""FEATURE_NAME"" alwaysStopAt="true" />
|
|
4
|
-
<context>
|
|
5
|
-
<option name="OTHER" value="true" />
|
|
6
|
-
</context>
|
|
7
|
-
</template>
|
|
8
|
-
|
|
9
|
-
<template name="morph-camel" value="{{camelCase $FEATURE_NAME$}}" description="Convert to camelCase (userAuth)" toReformat="false" toShortenFQNames="true">
|
|
10
|
-
<variable name="FEATURE_NAME" expression="" defaultValue=""FEATURE_NAME"" alwaysStopAt="true" />
|
|
11
|
-
<context>
|
|
12
|
-
<option name="OTHER" value="true" />
|
|
13
|
-
</context>
|
|
14
|
-
</template>
|
|
15
|
-
|
|
16
|
-
<template name="morph-snake" value="{{snakeCase $FEATURE_NAME$}}" description="Convert to snake_case (user_auth)" toReformat="false" toShortenFQNames="true">
|
|
17
|
-
<variable name="FEATURE_NAME" expression="" defaultValue=""FEATURE_NAME"" alwaysStopAt="true" />
|
|
18
|
-
<context>
|
|
19
|
-
<option name="OTHER" value="true" />
|
|
20
|
-
</context>
|
|
21
|
-
</template>
|
|
22
|
-
|
|
23
|
-
<template name="morph-title" value="{{titleCase $FEATURE_NAME$}}" description="Convert to Title Case (User Auth)" toReformat="false" toShortenFQNames="true">
|
|
24
|
-
<variable name="FEATURE_NAME" expression="" defaultValue=""FEATURE_NAME"" alwaysStopAt="true" />
|
|
25
|
-
<context>
|
|
26
|
-
<option name="OTHER" value="true" />
|
|
27
|
-
</context>
|
|
28
|
-
</template>
|
|
29
|
-
|
|
30
|
-
<template name="morph-kebab" value="{{kebabCase $FEATURE_NAME$}}" description="Convert to kebab-case (user-auth)" toReformat="false" toShortenFQNames="true">
|
|
31
|
-
<variable name="FEATURE_NAME" expression="" defaultValue=""FEATURE_NAME"" alwaysStopAt="true" />
|
|
32
|
-
<context>
|
|
33
|
-
<option name="OTHER" value="true" />
|
|
34
|
-
</context>
|
|
35
|
-
</template>
|
|
36
|
-
|
|
37
|
-
<template name="morph-if" value="{{#if $CONDITION$}} $END$ {{/if}}" description="Handlebars if block" toReformat="false" toShortenFQNames="true">
|
|
38
|
-
<variable name="CONDITION" expression="" defaultValue=""condition"" alwaysStopAt="true" />
|
|
39
|
-
<context>
|
|
40
|
-
<option name="OTHER" value="true" />
|
|
41
|
-
</context>
|
|
42
|
-
</template>
|
|
43
|
-
|
|
44
|
-
<template name="morph-if-else" value="{{#if $CONDITION$}} $TRUE_BRANCH$ {{else}} $FALSE_BRANCH$ {{/if}}" description="Handlebars if-else block" toReformat="false" toShortenFQNames="true">
|
|
45
|
-
<variable name="CONDITION" expression="" defaultValue=""condition"" alwaysStopAt="true" />
|
|
46
|
-
<variable name="TRUE_BRANCH" expression="" defaultValue="""" alwaysStopAt="true" />
|
|
47
|
-
<variable name="FALSE_BRANCH" expression="" defaultValue="""" alwaysStopAt="true" />
|
|
48
|
-
<context>
|
|
49
|
-
<option name="OTHER" value="true" />
|
|
50
|
-
</context>
|
|
51
|
-
</template>
|
|
52
|
-
|
|
53
|
-
<template name="morph-each" value="{{#each $ITEMS$}} {{this.$PROPERTY$}} {{/each}}" description="Handlebars each loop" toReformat="false" toShortenFQNames="true">
|
|
54
|
-
<variable name="ITEMS" expression="" defaultValue=""items"" alwaysStopAt="true" />
|
|
55
|
-
<variable name="PROPERTY" expression="" defaultValue=""name"" alwaysStopAt="true" />
|
|
56
|
-
<context>
|
|
57
|
-
<option name="OTHER" value="true" />
|
|
58
|
-
</context>
|
|
59
|
-
</template>
|
|
60
|
-
|
|
61
|
-
<template name="morph-service" value="namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Services; public class {{pascalCase FEATURE_NAME}}Service( I{{pascalCase FEATURE_NAME}}Repository repository, ILogger<{{pascalCase FEATURE_NAME}}Service> logger) : I{{pascalCase FEATURE_NAME}}Service { public async Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default) { $END$ } }" description="MORPH .NET Service class template" toReformat="false" toShortenFQNames="true">
|
|
62
|
-
<context>
|
|
63
|
-
<option name="C_SHARP" value="true" />
|
|
64
|
-
</context>
|
|
65
|
-
</template>
|
|
66
|
-
|
|
67
|
-
<template name="morph-repository" value="public class {{pascalCase FEATURE_NAME}}Repository(AppDbContext context) : I{{pascalCase FEATURE_NAME}}Repository { private readonly DbSet<{{pascalCase FEATURE_NAME}}> _dbSet = context.Set<{{pascalCase FEATURE_NAME}}>(); public async Task<{{pascalCase FEATURE_NAME}}?> GetByIdAsync(int id, CancellationToken cancellationToken = default) { $END$ } }" description="MORPH .NET Repository class template" toReformat="false" toShortenFQNames="true">
|
|
68
|
-
<context>
|
|
69
|
-
<option name="C_SHARP" value="true" />
|
|
70
|
-
</context>
|
|
71
|
-
</template>
|
|
72
|
-
|
|
73
|
-
<template name="morph-component" value="@page "/{{kebabCase FEATURE_NAME}}" @inject I{{pascalCase FEATURE_NAME}}Service {{pascalCase FEATURE_NAME}}Service @inject ILogger<{{pascalCase FEATURE_NAME}}Page> Logger <PageTitle>{{pascalCase FEATURE_NAME}}</PageTitle> <div class="container-fluid"> $END$ </div> @code { }" description="MORPH Blazor component template" toReformat="false" toShortenFQNames="true">
|
|
74
|
-
<context>
|
|
75
|
-
<option name="HTML" value="true" />
|
|
76
|
-
</context>
|
|
77
|
-
</template>
|
|
78
|
-
|
|
79
|
-
<template name="morph-migration" value="public partial class Add{{pascalCase FEATURE_NAME}} : Migration { protected override void Up(MigrationBuilder migrationBuilder) { migrationBuilder.CreateTable( name: "{{pascalCase FEATURE_NAME}}s", columns: table => new { Id = table.Column<int>(type: "int", nullable: false) .Annotation("SqlServer:Identity", "1, 1"), $END$ }, constraints: table => { table.PrimaryKey("PK_{{pascalCase FEATURE_NAME}}s", x => x.Id); }); } protected override void Down(MigrationBuilder migrationBuilder) { migrationBuilder.DropTable(name: "{{pascalCase FEATURE_NAME}}s"); } }" description="MORPH EF Core migration template" toReformat="false" toShortenFQNames="true">
|
|
80
|
-
<context>
|
|
81
|
-
<option name="C_SHARP" value="true" />
|
|
82
|
-
</context>
|
|
83
|
-
</template>
|
|
84
|
-
|
|
85
|
-
<template name="morph-ts-contract" value="export interface {{pascalCase FEATURE_NAME}} { id: number; $FIELD1$ } export interface Create{{pascalCase FEATURE_NAME}}Request { $FIELD2$ } export interface Update{{pascalCase FEATURE_NAME}}Request { $END$ }" description="MORPH TypeScript contract template" toReformat="false" toShortenFQNames="true">
|
|
86
|
-
<variable name="FIELD1" expression="" defaultValue="""" alwaysStopAt="true" />
|
|
87
|
-
<variable name="FIELD2" expression="" defaultValue="""" alwaysStopAt="true" />
|
|
88
|
-
<context>
|
|
89
|
-
<option name="TypeScript" value="true" />
|
|
90
|
-
</context>
|
|
91
|
-
</template>
|
|
92
|
-
</templateSet>
|