@polymorphism-tech/morph-spec 8.29.0 → 8.31.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 (170) hide show
  1. package/CLAUDE.md +6 -1
  2. package/README.md +13 -2
  3. package/bin/morph-spec.js +48 -0
  4. package/bin/validate.js +379 -379
  5. package/claude-plugin.json +1 -1
  6. package/docs/CHEATSHEET.md +1 -1
  7. package/docs/QUICKSTART.md +1 -1
  8. package/framework/CLAUDE.md +2 -0
  9. package/framework/MORPH.md +2 -1
  10. package/framework/agents.json +6 -6
  11. package/framework/commands/morph-status.md +1 -1
  12. package/framework/docs/CLI.md +18 -0
  13. package/framework/evals/rubrics/code-quality.md +17 -0
  14. package/framework/evals/rubrics/condensed.md +3 -1
  15. package/framework/hooks/claude-code/statusline.sh +11 -11
  16. package/framework/hooks/git/commit-msg/conventional-commits.sh +33 -33
  17. package/framework/hooks/git/pre-commit/agents.sh +25 -25
  18. package/framework/hooks/git/pre-commit/orchestrator.sh +64 -64
  19. package/framework/hooks/git/pre-commit/specs.sh +50 -50
  20. package/framework/hooks/git/pre-push/run-tests.sh +44 -44
  21. package/framework/hooks/shared/phase-utils.js +2 -0
  22. package/framework/hooks/shared/stdin-reader.js +26 -26
  23. package/framework/mcp/registry.json +39 -4
  24. package/framework/rubrics/backend.json +2 -2
  25. package/framework/rubrics/default.json +2 -2
  26. package/framework/rubrics/frontend.json +2 -2
  27. package/framework/schemas/tasks.schema.json +25 -0
  28. package/framework/skills/core/create-umbraco-lp/SKILL.md +1 -1
  29. package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md +1 -1
  30. package/framework/skills/core/morph-apply/SKILL.md +12 -3
  31. package/framework/skills/core/morph-brainstorming/SKILL.md +1 -1
  32. package/framework/skills/core/morph-eval/SKILL.md +1 -1
  33. package/framework/skills/core/morph-hotfix/SKILL.md +1 -1
  34. package/framework/skills/core/morph-implement/SKILL.md +12 -2
  35. package/framework/skills/core/morph-plan/SKILL.md +45 -3
  36. package/framework/skills/core/morph-proposal/SKILL.md +1 -1
  37. package/framework/skills/core/morph-review/SKILL.md +11 -3
  38. package/framework/skills/core/morph-stack-scan/SKILL.md +13 -1
  39. package/framework/skills/core/morph-standards/SKILL.md +1 -1
  40. package/framework/skills/core/morph-uiux/SKILL.md +1 -1
  41. package/framework/standards/ai-agents/agent-session.md +160 -160
  42. package/framework/standards/ai-agents/batching.md +193 -193
  43. package/framework/standards/ai-agents/context-providers.md +188 -188
  44. package/framework/standards/ai-agents/mcp-server.md +250 -250
  45. package/framework/standards/ai-agents/mcp-tools.md +197 -197
  46. package/framework/standards/ai-agents/middleware-patterns.md +207 -207
  47. package/framework/standards/ai-agents/modalities-image-gen.md +173 -173
  48. package/framework/standards/ai-agents/modalities-speech-to-text.md +171 -171
  49. package/framework/standards/ai-agents/modalities-text-to-speech.md +181 -181
  50. package/framework/standards/ai-agents/modalities-vision.md +201 -201
  51. package/framework/standards/ai-agents/multi-agent-patterns.md +155 -155
  52. package/framework/standards/ai-agents/production.md +231 -231
  53. package/framework/standards/ai-agents/prompts-in-db.md +214 -214
  54. package/framework/standards/ai-agents/providers/model-registry.md +158 -158
  55. package/framework/standards/ai-agents/service-tier-flex.md +135 -135
  56. package/framework/standards/ai-agents/structured-output.md +249 -249
  57. package/framework/standards/ai-agents/sweet-spot.md +109 -109
  58. package/framework/templates/.idea/morph-templates.xml +92 -0
  59. package/framework/templates/.vscode/morph-templates.code-snippets +186 -0
  60. package/framework/templates/IDE-SNIPPETS.md +262 -262
  61. package/framework/templates/code/dotnet/abstractions/api-endpoint.cs +7 -7
  62. package/framework/templates/code/dotnet/ai-agents/AgentBootstrap.cs.template +39 -39
  63. package/framework/templates/code/dotnet/ai-agents/EmbeddingService.cs.template +68 -68
  64. package/framework/templates/code/dotnet/ai-agents/ModelRegistry.cs.template +117 -117
  65. package/framework/templates/code/dotnet/ai-agents/PromptRepository.cs.template +95 -95
  66. package/framework/templates/code/dotnet/ai-agents/ResilientToolMiddleware.cs.template +61 -61
  67. package/framework/templates/code/dotnet/ai-agents/VectorSearchTool.cs.template +107 -107
  68. package/framework/templates/code/dotnet/ai-agents/model-registry.json.template +58 -58
  69. package/framework/templates/code/dotnet/contracts/contracts-vsa.cs +281 -281
  70. package/framework/templates/code/dotnet/database/migration.cs +83 -83
  71. package/framework/templates/code/dotnet/feature/endpoint.cs.hbs +21 -21
  72. package/framework/templates/code/dotnet/feature/request.cs.hbs +4 -4
  73. package/framework/templates/code/dotnet/feature/response.cs.hbs +4 -4
  74. package/framework/templates/code/dotnet/feature/validator.cs.hbs +15 -15
  75. package/framework/templates/code/sql/ai-agents/agent-prompts-migration.sql.template +58 -58
  76. package/framework/templates/code/sql/ai-agents/pgvector-embeddings-migration.sql.template +91 -91
  77. package/framework/templates/code/typescript/contracts.ts +167 -167
  78. package/framework/templates/context/ARCHITECTURE.md +20 -0
  79. package/framework/templates/docs/clarifications.md +253 -253
  80. package/framework/templates/docs/schema-analysis.md +119 -119
  81. package/framework/templates/docs/ui-components.md +52 -52
  82. package/framework/templates/docs/ui-design-system.md +76 -76
  83. package/framework/templates/docs/ui-flows.md +167 -167
  84. package/framework/templates/docs/ui-mockups.md +98 -98
  85. package/framework/templates/feature/decisions.md +122 -122
  86. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -43
  87. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -26
  88. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -32
  89. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -56
  90. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -22
  91. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -26
  92. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -54
  93. package/framework/templates/infrastructure/docker/Dockerfile.template +58 -58
  94. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  95. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  96. package/framework/templates/infrastructure/github/README.md +56 -56
  97. package/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -45
  98. package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -27
  99. package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -59
  100. package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -39
  101. package/framework/templates/integrations/asaas-client.cs +387 -387
  102. package/framework/templates/integrations/asaas-webhook.cs +351 -351
  103. package/framework/templates/meta-prompts/fusion/fusion-agent.md +76 -76
  104. package/framework/templates/meta-prompts/fusion/fusion-aggregator.md +100 -100
  105. package/framework/templates/meta-prompts/validators/pre-commit-validator.md +95 -95
  106. package/framework/templates/project/validate.js +120 -120
  107. package/framework/templates/state.template.json +17 -17
  108. package/framework/templates/ui/design-system.css +226 -226
  109. package/package.json +1 -1
  110. package/src/commands/dashboard/dashboard.js +53 -53
  111. package/src/commands/graph/affected.js +89 -0
  112. package/src/commands/graph/build.js +94 -0
  113. package/src/commands/graph/explain.js +96 -0
  114. package/src/commands/graph/status.js +93 -0
  115. package/src/commands/index.js +13 -13
  116. package/src/commands/project/checkpoint.js +209 -209
  117. package/src/commands/project/doctor.js +11 -0
  118. package/src/core/paths/output-schema.js +7 -0
  119. package/src/core/state/phase-state-machine.js +197 -197
  120. package/src/core/templates/template-renderer.js +477 -477
  121. package/src/dashboard/app/components/DetailPanel.jsx +11 -11
  122. package/src/dashboard/app/components/FlowGraph.jsx +17 -17
  123. package/src/dashboard/app/components/SearchFilter.jsx +22 -22
  124. package/src/dashboard/app/hooks/useDetailPanel.js +15 -15
  125. package/src/dashboard/app/main.jsx +13 -13
  126. package/src/dashboard/app/pages/AgentMap.jsx +370 -370
  127. package/src/dashboard/app/pages/HookInspector.jsx +418 -418
  128. package/src/dashboard/app/pages/PhasePipeline.jsx +408 -408
  129. package/src/dashboard/app/pages/RulesMap.jsx +273 -273
  130. package/src/dashboard/app/pages/SkillsLibrary.jsx +366 -366
  131. package/src/dashboard/app/pages/Standards.jsx +332 -332
  132. package/src/dashboard/app/styles/index.css +47 -47
  133. package/src/dashboard/index.html +12 -12
  134. package/src/dashboard/package.json +24 -24
  135. package/src/dashboard/scanner/phases-scanner.js +15 -15
  136. package/src/dashboard/scanner/rubrics-scanner.js +12 -12
  137. package/src/dashboard/scanner/rules-scanner.js +37 -37
  138. package/src/dashboard/scanner/skills-scanner.js +43 -43
  139. package/src/dashboard/scanner/squads-scanner.js +13 -13
  140. package/src/dashboard/vite-plugin-morph-data.js +17 -17
  141. package/src/dashboard/vite.config.js +24 -24
  142. package/src/lib/detectors/design-system-detector.js +188 -188
  143. package/src/lib/detectors/index.js +217 -217
  144. package/src/lib/generators/architecture-scanner.js +45 -4
  145. package/src/lib/generators/design-system-generator.js +508 -508
  146. package/src/lib/generators/settings-generator.js +209 -209
  147. package/src/lib/graph/god-nodes.js +75 -0
  148. package/src/lib/graph/graph-health.js +61 -0
  149. package/src/lib/graph/graph-loader.js +86 -0
  150. package/src/lib/graph/graphify-runtime.js +100 -0
  151. package/src/lib/graph/graphifyignore.js +86 -0
  152. package/src/lib/graph/sanitize.js +280 -0
  153. package/src/lib/hooks/hook-executor.js +167 -167
  154. package/src/lib/installers/mcp-installer.js +719 -719
  155. package/src/lib/tasks/task-classifier.js +30 -30
  156. package/src/lib/tasks/task-parser.js +209 -209
  157. package/src/lib/tasks/tasks-json-parser.js +26 -0
  158. package/src/lib/validators/checkpoint-persistence.js +39 -39
  159. package/src/lib/validators/css/css-validator.js +340 -340
  160. package/src/lib/validators/reuse/index.js +10 -0
  161. package/src/lib/validators/reuse/reuse-validator.js +324 -0
  162. package/src/lib/validators/reuse/symbol-scanner.js +144 -0
  163. package/src/lib/validators/shared/emit-validator-dispatch.js +14 -14
  164. package/src/lib/validators/shared/issue-counter.js +14 -14
  165. package/src/lib/validators/validation-runner.js +40 -1
  166. package/src/scripts/setup-infra.js +60 -1
  167. package/src/utils/agent-id-mapper.js +11 -11
  168. package/src/utils/claude-settings-manager.js +300 -300
  169. package/src/utils/file-copier.js +40 -0
  170. package/src/utils/skills-installer.js +187 -187
@@ -388,7 +388,7 @@ export async function setupInfra(targetPath, { _exec = execSync, reinstall = fal
388
388
 
389
389
  // --- 10-13. Install stack-aware assets (rules, skills, agents) ---
390
390
  log('Steps 10-13: Installing stack-aware assets...');
391
- const { agentCounts, domainCounts } = await installStackAwareAssets(targetPath, log);
391
+ const { agentCounts, domainCounts, projectTags } = await installStackAwareAssets(targetPath, log);
392
392
 
393
393
  // --- 14. Copy framework/CLAUDE.md → .claude/CLAUDE.md (morph-owned, gitignored) ---
394
394
  log('Step 14: Installing .claude/CLAUDE.md...');
@@ -422,6 +422,65 @@ export async function setupInfra(targetPath, { _exec = execSync, reinstall = fal
422
422
  await updateGitignore(targetPath);
423
423
  await ensureGitattributes(targetPath);
424
424
 
425
+ // --- 18b. Codebase graph (graphify) ---
426
+ // Fail-open por inteiro (ADR-002): sem Python, sem uv e sem pipx, o step
427
+ // registra e segue. O wrapper de CLI mata o processo em qualquer throw
428
+ // (setup-infra-cmd.js), então nada aqui pode escapar do try.
429
+ log('Step 18b: Codebase graph (graphify)...');
430
+ try {
431
+ const { writeGraphifyignore } = await import('../lib/graph/graphifyignore.js');
432
+ const {
433
+ detectInstaller, installArgs, detectGraphifyVersion,
434
+ GRAPHIFY_VERSION, GRAPHIFY_BIN, GRAPHIFY_PACKAGE,
435
+ } = await import('../lib/graph/graphify-runtime.js');
436
+ const { ensureClaudeignore } = await import('../utils/file-copier.js');
437
+ const { scanDatabaseSchema } = await import('../lib/generators/architecture-scanner.js');
438
+
439
+ const ignore = writeGraphifyignore(targetPath, projectTags ?? []);
440
+ log(ignore.written
441
+ ? ' ✓ .graphifyignore (stack-aware)'
442
+ : ' ✓ .graphifyignore já existia — preservado');
443
+
444
+ // Um graph.json de 12 MB reescrito a cada commit invalida o prompt cache.
445
+ await ensureClaudeignore(targetPath, ['graphify-out/']);
446
+ log(' ✓ graphify-out/ no .claudeignore');
447
+
448
+ const installed = detectGraphifyVersion();
449
+ if (installed === GRAPHIFY_VERSION) {
450
+ log(` ✓ graphify ${installed} já instalado`);
451
+ } else {
452
+ const { kind } = detectInstaller();
453
+ if (!kind) {
454
+ // Registra e segue: o framework funciona sem grafo, por grep.
455
+ log(` ⚠ Sem uv/pipx/python — grafo indisponível. Depois: uv tool install ${GRAPHIFY_PACKAGE}==${GRAPHIFY_VERSION}`);
456
+ } else {
457
+ // Sem o extra [sql] os arquivos .sql são ignorados em silêncio.
458
+ const withSql = (await scanDatabaseSchema(targetPath)).length > 0;
459
+ const { cmd, args } = installArgs(kind, { withSql });
460
+ try {
461
+ _exec(`${cmd} ${args.join(' ')}`, { stdio: 'ignore' });
462
+ log(` ✓ graphify ${GRAPHIFY_VERSION}${withSql ? ' [sql]' : ''} via ${kind}`);
463
+ } catch {
464
+ log(` ⚠ Falha ao instalar o graphify via ${kind} — manualmente: ${cmd} ${args.join(' ')}`);
465
+ }
466
+ }
467
+ }
468
+
469
+ if (detectGraphifyVersion()) {
470
+ try {
471
+ // Só os git hooks (post-commit/post-checkout/merge driver). NUNCA
472
+ // `graphify claude install`: ele escreveria uma seção no CLAUDE.md e um
473
+ // PreToolUse hook próprio, colidindo com os hooks do morph-spec.
474
+ _exec(`${GRAPHIFY_BIN} hook install`, { cwd: targetPath, stdio: 'ignore' });
475
+ log(' ✓ git hooks do graphify (rebuild assíncrono no post-commit)');
476
+ } catch {
477
+ log(' ⚠ graphify hook install falhou — rode manualmente se quiser rebuild automático');
478
+ }
479
+ }
480
+ } catch (err) {
481
+ log(` ⚠ Step do grafo pulado: ${err.message}`);
482
+ }
483
+
425
484
  // --- 19. Initialize state.json (only if not exists) ---
426
485
  log('Step 19: Initializing state.json...');
427
486
  const statePath = join(morphPath, 'state.json');
@@ -1,11 +1,11 @@
1
- /**
2
- * Map an agents.json ID to the Claude Code subagent_type.
3
- *
4
- * @param {string} id - Agent ID from agents.json (e.g., "nextjs-expert")
5
- * @param {number} [tier] - Agent tier (1-4). Defaults to non-validator.
6
- * @returns {string} subagent_type matching .claude/agents/ filename stem
7
- */
8
- export function agentIdToSubagentType(id, tier) {
9
- const prefix = tier === 4 ? 'morph-validator-' : 'morph-';
10
- return `${prefix}${id}`;
11
- }
1
+ /**
2
+ * Map an agents.json ID to the Claude Code subagent_type.
3
+ *
4
+ * @param {string} id - Agent ID from agents.json (e.g., "nextjs-expert")
5
+ * @param {number} [tier] - Agent tier (1-4). Defaults to non-validator.
6
+ * @returns {string} subagent_type matching .claude/agents/ filename stem
7
+ */
8
+ export function agentIdToSubagentType(id, tier) {
9
+ const prefix = tier === 4 ? 'morph-validator-' : 'morph-';
10
+ return `${prefix}${id}`;
11
+ }