@polymorphism-tech/morph-spec 8.34.2 → 8.35.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (328) hide show
  1. package/CLAUDE.md +22 -5
  2. package/README.md +2 -2
  3. package/bin/morph-spec.js +18 -4
  4. package/bin/validate.js +379 -379
  5. package/claude-plugin.json +1 -1
  6. package/docs/CHEATSHEET.md +5 -4
  7. package/docs/QUICKSTART.md +1 -1
  8. package/framework/MORPH.md +16 -17
  9. package/framework/agents.json +197 -44
  10. package/framework/ai-pin.json +22 -0
  11. package/framework/commands/morph-media.md +45 -0
  12. package/framework/docs/CLI.md +236 -11
  13. package/framework/evals/proof-rubrics/README.md +76 -0
  14. package/framework/evals/proof-rubrics/eval-de-modelo.md +64 -0
  15. package/framework/evals/proof-rubrics/fiacao.md +54 -0
  16. package/framework/evals/proof-rubrics/guard-cego.md +52 -0
  17. package/framework/evals/proof-rubrics/media-claims.md +109 -0
  18. package/framework/evals/proof-rubrics/mutation-proof.md +77 -0
  19. package/framework/evals/proof-rubrics/observabilidade-genai.md +119 -0
  20. package/framework/evals/proof-rubrics/verde-nao-e-coberto.md +48 -0
  21. package/framework/evals/rubrics/architecture.md +30 -0
  22. package/framework/evals/rubrics/code-quality.md +26 -0
  23. package/framework/evals/rubrics/test-coverage.md +20 -0
  24. package/framework/hooks/claude-code/core/protect-spec-files.js +41 -4
  25. package/framework/hooks/claude-code/core/worktree-env-inject.js +43 -0
  26. package/framework/hooks/claude-code/statusline.sh +11 -11
  27. package/framework/hooks/git/commit-msg/conventional-commits.sh +33 -33
  28. package/framework/hooks/git/pre-commit/agents.sh +25 -25
  29. package/framework/hooks/git/pre-commit/orchestrator.sh +64 -64
  30. package/framework/hooks/git/pre-commit/specs.sh +50 -50
  31. package/framework/hooks/git/pre-push/run-tests.sh +44 -44
  32. package/framework/hooks/shared/e2e-check.js +135 -22
  33. package/framework/hooks/shared/payload-utils.js +15 -2
  34. package/framework/hooks/shared/stdin-reader.js +26 -26
  35. package/framework/rules/ai-agents-standards.md +14 -2
  36. package/framework/schemas/ai-pin.schema.json +97 -0
  37. package/framework/schemas/config.schema.json +107 -0
  38. package/framework/schemas/feature.schema.json +23 -4
  39. package/framework/skills/core/create-umbraco-lp/SKILL.md +1 -1
  40. package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md +1 -1
  41. package/framework/skills/core/morph-apply/SKILL.md +26 -5
  42. package/framework/skills/core/morph-brainstorming/SKILL.md +1 -1
  43. package/framework/skills/core/morph-eval/SKILL.md +1 -1
  44. package/framework/skills/core/morph-hotfix/SKILL.md +2 -2
  45. package/framework/skills/core/morph-implement/SKILL.md +18 -2
  46. package/framework/skills/core/morph-media/SKILL.md +215 -0
  47. package/framework/skills/core/morph-plan/SKILL.md +33 -2
  48. package/framework/skills/core/morph-proposal/SKILL.md +1 -1
  49. package/framework/skills/core/morph-review/SKILL.md +166 -9
  50. package/framework/skills/core/morph-stack-scan/SKILL.md +1 -1
  51. package/framework/skills/core/morph-standards/SKILL.md +1 -1
  52. package/framework/skills/core/morph-uiux/SKILL.md +1 -1
  53. package/framework/standards/PROVENANCE.json +81 -3
  54. package/framework/standards/STANDARDS.json +1483 -839
  55. package/framework/standards/ai-agents/agent-archetypes.md +160 -0
  56. package/framework/standards/ai-agents/agent-session.md +164 -68
  57. package/framework/standards/ai-agents/agent-spec.md +196 -0
  58. package/framework/standards/ai-agents/batching.md +61 -37
  59. package/framework/standards/ai-agents/context-providers.md +97 -24
  60. package/framework/standards/ai-agents/conversational-agent-with-phases.md +239 -0
  61. package/framework/standards/ai-agents/cost-and-budget.md +256 -0
  62. package/framework/standards/ai-agents/durable-workflows-hitl.md +98 -5
  63. package/framework/standards/ai-agents/evals-with-cache.md +289 -0
  64. package/framework/standards/ai-agents/guardrails.md +222 -0
  65. package/framework/standards/ai-agents/llm-runtime-defaults.md +226 -0
  66. package/framework/standards/ai-agents/mcp-server.md +119 -18
  67. package/framework/standards/ai-agents/mcp-tools.md +85 -32
  68. package/framework/standards/ai-agents/media-pipeline.md +352 -0
  69. package/framework/standards/ai-agents/media-video.md +267 -0
  70. package/framework/standards/ai-agents/middleware-patterns.md +39 -5
  71. package/framework/standards/ai-agents/modalities-image-gen.md +354 -105
  72. package/framework/standards/ai-agents/modalities-speech-to-text.md +8 -2
  73. package/framework/standards/ai-agents/modalities-text-to-speech.md +10 -2
  74. package/framework/standards/ai-agents/modalities-vision.md +6 -2
  75. package/framework/standards/ai-agents/multi-agent-patterns.md +61 -5
  76. package/framework/standards/ai-agents/observability-patterns.md +227 -17
  77. package/framework/standards/ai-agents/production.md +38 -9
  78. package/framework/standards/ai-agents/prompt-sources.md +389 -0
  79. package/framework/standards/ai-agents/providers/model-registry.md +174 -39
  80. package/framework/standards/ai-agents/rag-custom-pgvector.md +69 -4
  81. package/framework/standards/ai-agents/service-tier-flex.md +27 -19
  82. package/framework/standards/ai-agents/setup.md +166 -50
  83. package/framework/standards/ai-agents/structured-output.md +34 -3
  84. package/framework/standards/ai-agents/sweet-spot.md +23 -3
  85. package/framework/standards/ai-agents/testing-ai.md +236 -0
  86. package/framework/standards/ai-agents/vector-data-extensions.md +50 -20
  87. package/framework/standards/ai-agents/workflows.md +27 -7
  88. package/framework/standards/frontend/design-system/ai-image-generation.md +12 -0
  89. package/framework/standards/frontend/design-system/ai-video-generation.md +13 -0
  90. package/framework/standards/infrastructure/docker/local-compose-isolation.md +3 -1
  91. package/framework/templates/.idea/morph-templates.xml +92 -0
  92. package/framework/templates/.vscode/morph-templates.code-snippets +186 -0
  93. package/framework/templates/IDE-SNIPPETS.md +262 -262
  94. package/framework/templates/REGISTRY.json +13 -0
  95. package/framework/templates/code/dotnet/abstractions/api-endpoint.cs +7 -7
  96. package/framework/templates/code/dotnet/ai-agents/AgentBootstrap.cs.template +39 -39
  97. package/framework/templates/code/dotnet/ai-agents/EmbeddingService.cs.template +68 -68
  98. package/framework/templates/code/dotnet/ai-agents/ModelRegistry.cs.template +117 -117
  99. package/framework/templates/code/dotnet/ai-agents/PromptRepository.cs.template +1 -1
  100. package/framework/templates/code/dotnet/ai-agents/ResilientToolMiddleware.cs.template +61 -61
  101. package/framework/templates/code/dotnet/ai-agents/VectorSearchTool.cs.template +107 -107
  102. package/framework/templates/code/dotnet/ai-agents/model-registry.json.template +58 -58
  103. package/framework/templates/code/dotnet/contracts/contracts-vsa.cs +281 -281
  104. package/framework/templates/code/dotnet/database/migration.cs +83 -83
  105. package/framework/templates/code/dotnet/feature/endpoint.cs.hbs +21 -21
  106. package/framework/templates/code/dotnet/feature/request.cs.hbs +4 -4
  107. package/framework/templates/code/dotnet/feature/response.cs.hbs +4 -4
  108. package/framework/templates/code/dotnet/feature/validator.cs.hbs +15 -15
  109. package/framework/templates/code/sql/ai-agents/agent-prompts-migration.sql.template +1 -1
  110. package/framework/templates/code/sql/ai-agents/pgvector-embeddings-migration.sql.template +91 -91
  111. package/framework/templates/code/typescript/contracts.ts +167 -167
  112. package/framework/templates/docs/clarifications.md +253 -253
  113. package/framework/templates/docs/schema-analysis.md +119 -119
  114. package/framework/templates/docs/ui-components.md +52 -52
  115. package/framework/templates/docs/ui-design-system.md +76 -76
  116. package/framework/templates/docs/ui-flows.md +167 -167
  117. package/framework/templates/docs/ui-mockups.md +98 -98
  118. package/framework/templates/dotnet/ai-kit/Directory.Build.props +25 -0
  119. package/framework/templates/dotnet/ai-kit/Directory.Packages.props +26 -0
  120. package/framework/templates/dotnet/ai-kit/Morph.AiKit.sln +56 -0
  121. package/framework/templates/dotnet/ai-kit/NuGet.config +12 -0
  122. package/framework/templates/dotnet/ai-kit/README.md +128 -0
  123. package/framework/templates/dotnet/ai-kit/global.json +9 -0
  124. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentApi.cs +65 -0
  125. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactory.cs +289 -0
  126. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactoryOptions.cs +91 -0
  127. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentSpec.cs +91 -0
  128. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentSpecOptions.cs +181 -0
  129. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/AiKitAssemblyMarker.cs +14 -0
  130. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Conversation/ConversationStore.cs +174 -0
  131. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Conversation/IConversationStore.cs +54 -0
  132. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Conversation/InMemoryConversationStore.cs +75 -0
  133. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/CountingChatClient.cs +71 -0
  134. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalAssertion.cs +246 -0
  135. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalCacheMissException.cs +57 -0
  136. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalCacheOptions.cs +78 -0
  137. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalCacheStamp.cs +225 -0
  138. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalFixture.cs +463 -0
  139. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalMode.cs +32 -0
  140. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalQualityEvaluators.cs +49 -0
  141. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalScenario.cs +214 -0
  142. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalSummary.cs +168 -0
  143. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/OfflineChatClient.cs +142 -0
  144. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/ShortPathResponseCache.cs +349 -0
  145. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/IMediaGenerator.cs +42 -0
  146. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/IMediaProvider.cs +77 -0
  147. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaArtifact.cs +28 -0
  148. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaDisclosure.cs +107 -0
  149. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaGenerator.cs +253 -0
  150. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaIdempotencyKey.cs +103 -0
  151. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaJob.cs +259 -0
  152. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaJobId.cs +21 -0
  153. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaJobState.cs +47 -0
  154. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaPricing.cs +102 -0
  155. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaProvenance.cs +44 -0
  156. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaRequest.cs +192 -0
  157. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaResult.cs +94 -0
  158. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaReview.cs +99 -0
  159. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaSeams.cs +97 -0
  160. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaStore.cs +133 -0
  161. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MorphMedia.cs +93 -0
  162. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/Providers/GoogleImageProvider.cs +112 -0
  163. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/Providers/OpenAIImageProvider.cs +288 -0
  164. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/Providers/VeoVideoProvider.cs +158 -0
  165. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Middleware/IUsageCostSink.cs +29 -0
  166. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Middleware/UsageCostMiddleware.cs +208 -0
  167. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Middleware/UsageCostRecord.cs +95 -0
  168. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Morph.AiKit.csproj +38 -0
  169. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Observability/MorphOpenTelemetryExtensions.cs +119 -0
  170. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Observability/MorphTelemetryOptions.cs +82 -0
  171. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Providers/IProviderClientFactory.cs +33 -0
  172. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Providers/ModelAlias.cs +267 -0
  173. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Providers/ModelRegistry.cs +474 -0
  174. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Providers/model-registry.v2.json +87 -0
  175. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Rag/DeltaIngest.cs +169 -0
  176. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Rag/DeltaPlan.cs +49 -0
  177. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/AgentFactoryTests.cs +495 -0
  178. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/AgentSpecTests.cs +260 -0
  179. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/ConversationStoreTests.cs +405 -0
  180. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/DeltaIngestTests.cs +379 -0
  181. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalAssertionTests.cs +197 -0
  182. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalCacheMissTests.cs +139 -0
  183. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalCacheStampTests.cs +157 -0
  184. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalFailuresTests.cs +178 -0
  185. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalFixtureTests.cs +153 -0
  186. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalRefreshTests.cs +194 -0
  187. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalWorkspace.cs +86 -0
  188. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/KitEvals.cs +213 -0
  189. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/OfflineChatClientTests.cs +95 -0
  190. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeChatClient.cs +225 -0
  191. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeChatClientTests.cs +215 -0
  192. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeClock.cs +33 -0
  193. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeMediaProvider.cs +89 -0
  194. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeProviderClientFactory.cs +55 -0
  195. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeUsageCostSink.cs +60 -0
  196. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/InMemoryMediaStore.cs +131 -0
  197. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaAccessibilityTests.cs +133 -0
  198. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaAliasIsNotAnAgentTests.cs +127 -0
  199. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaDisclosureTests.cs +216 -0
  200. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaGeneratorTests.cs +264 -0
  201. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaIdempotencyKeyTests.cs +148 -0
  202. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaJobStateTests.cs +184 -0
  203. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaReviewTests.cs +89 -0
  204. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaStoreTests.cs +98 -0
  205. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/ModelRegistryTests.cs +451 -0
  206. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Morph.AiKit.Tests.csproj +76 -0
  207. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/SkeletonSmokeTests.cs +33 -0
  208. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/TelemetryTests.cs +261 -0
  209. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/UsageCostMiddlewareTests.cs +374 -0
  210. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/.morph-eval-cache.json +12 -0
  211. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/orcamento.acme.a-resposta-estruturada/1/CF70A7CE27BBD66A/contents.data +13 -0
  212. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/orcamento.acme.a-resposta-estruturada/1/CF70A7CE27BBD66A/entry.json +7 -0
  213. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/triagem.acme.a-saudacao/1/19F631228C6E00BA/contents.data +13 -0
  214. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/triagem.acme.a-saudacao/1/19F631228C6E00BA/entry.json +7 -0
  215. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/triagem.acme.b-escalonamento/1/A24A7C9BDD8239D8/contents.data +13 -0
  216. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/triagem.acme.b-escalonamento/1/A24A7C9BDD8239D8/entry.json +7 -0
  217. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/triagem.globex.a-saudacao/1/E38CD37DF003EDB7/contents.data +13 -0
  218. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/triagem.globex.a-saudacao/1/E38CD37DF003EDB7/entry.json +7 -0
  219. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-datasets/orcamento/acme/a-resposta-estruturada.json +24 -0
  220. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-datasets/triagem/acme/a-saudacao.json +23 -0
  221. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-datasets/triagem/acme/b-escalonamento.json +24 -0
  222. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-datasets/triagem/globex/a-saudacao.json +23 -0
  223. package/framework/templates/feature/decisions.md +122 -122
  224. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -43
  225. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -26
  226. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -32
  227. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -56
  228. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -22
  229. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -26
  230. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -54
  231. package/framework/templates/infrastructure/docker/Dockerfile.template +58 -58
  232. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  233. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  234. package/framework/templates/infrastructure/github/README.md +56 -56
  235. package/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -45
  236. package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -27
  237. package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -59
  238. package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -39
  239. package/framework/templates/integrations/asaas-client.cs +387 -387
  240. package/framework/templates/integrations/asaas-webhook.cs +351 -351
  241. package/framework/templates/meta-prompts/fusion/fusion-agent.md +76 -76
  242. package/framework/templates/meta-prompts/fusion/fusion-aggregator.md +100 -100
  243. package/framework/templates/meta-prompts/validators/pre-commit-validator.md +95 -95
  244. package/framework/templates/project/validate.js +120 -120
  245. package/framework/templates/state.template.json +17 -17
  246. package/framework/templates/ui/design-system.css +226 -226
  247. package/package.json +3 -3
  248. package/src/commands/dashboard/dashboard.js +53 -53
  249. package/src/commands/e2e/e2e.js +15 -2
  250. package/src/commands/index.js +13 -13
  251. package/src/commands/project/checkpoint.js +209 -209
  252. package/src/commands/project/doctor.js +148 -6
  253. package/src/commands/project/update.js +469 -153
  254. package/src/commands/project/worktree.js +76 -4
  255. package/src/commands/state/advance.js +24 -2
  256. package/src/commands/state/approve.js +33 -1
  257. package/src/commands/state/create.js +72 -11
  258. package/src/commands/state/finish.js +379 -24
  259. package/src/commands/state/gate-check.js +190 -6
  260. package/src/commands/state/score.js +36 -1
  261. package/src/commands/validation/verify.js +134 -25
  262. package/src/core/state/phase-state-machine.js +197 -197
  263. package/src/core/state/state-manager.js +9 -1
  264. package/src/core/templates/template-renderer.js +477 -477
  265. package/src/dashboard/app/components/DetailPanel.jsx +11 -11
  266. package/src/dashboard/app/components/FlowGraph.jsx +17 -17
  267. package/src/dashboard/app/components/SearchFilter.jsx +22 -22
  268. package/src/dashboard/app/hooks/useDetailPanel.js +15 -15
  269. package/src/dashboard/app/main.jsx +13 -13
  270. package/src/dashboard/app/pages/AgentMap.jsx +370 -370
  271. package/src/dashboard/app/pages/PhasePipeline.jsx +408 -408
  272. package/src/dashboard/app/pages/RulesMap.jsx +273 -273
  273. package/src/dashboard/app/pages/SkillsLibrary.jsx +366 -366
  274. package/src/dashboard/app/pages/Standards.jsx +332 -332
  275. package/src/dashboard/app/styles/index.css +47 -47
  276. package/src/dashboard/index.html +12 -12
  277. package/src/dashboard/package.json +24 -24
  278. package/src/dashboard/scanner/phases-scanner.js +15 -15
  279. package/src/dashboard/scanner/rubrics-scanner.js +12 -12
  280. package/src/dashboard/scanner/rules-scanner.js +37 -37
  281. package/src/dashboard/scanner/skills-scanner.js +43 -43
  282. package/src/dashboard/scanner/squads-scanner.js +13 -13
  283. package/src/dashboard/vite-plugin-morph-data.js +17 -17
  284. package/src/dashboard/vite.config.js +24 -24
  285. package/src/lib/ai/ai-checks.js +182 -0
  286. package/src/lib/ai/ai-project-scan.js +347 -0
  287. package/src/lib/ai/code-audit.js +181 -0
  288. package/src/lib/ai/comment-stripper.js +184 -0
  289. package/src/lib/ai/pin-drift.js +138 -0
  290. package/src/lib/ai/registry-audit.js +285 -0
  291. package/src/lib/detectors/design-system-detector.js +188 -188
  292. package/src/lib/detectors/index.js +217 -217
  293. package/src/lib/e2e/compose-env.js +50 -4
  294. package/src/lib/evaluator-report.js +269 -15
  295. package/src/lib/generators/design-system-generator.js +508 -508
  296. package/src/lib/generators/settings-generator.js +209 -209
  297. package/src/lib/git/default-branch.js +92 -4
  298. package/src/lib/git/pr-files.js +56 -0
  299. package/src/lib/hooks/hook-executor.js +167 -167
  300. package/src/lib/installers/effects.js +193 -0
  301. package/src/lib/installers/mcp-installer.js +719 -719
  302. package/src/lib/installers/templates-reconcile.js +3 -3
  303. package/src/lib/risk-detector.js +284 -0
  304. package/src/lib/standards/verified-against.js +276 -0
  305. package/src/lib/tasks/eval-node.js +485 -0
  306. package/src/lib/tasks/linux-runner.js +297 -0
  307. package/src/lib/tasks/task-classifier.js +30 -30
  308. package/src/lib/tasks/task-parser.js +209 -209
  309. package/src/lib/tasks/test-nodes.js +486 -0
  310. package/src/lib/tasks/test-runner.js +410 -33
  311. package/src/lib/validators/checkpoint-persistence.js +39 -39
  312. package/src/lib/validators/css/css-validator.js +340 -340
  313. package/src/lib/validators/shared/emit-validator-dispatch.js +14 -14
  314. package/src/lib/validators/shared/issue-counter.js +14 -14
  315. package/src/lib/validators/verify-runner.js +583 -28
  316. package/src/lib/worktree/docker-audit.js +287 -0
  317. package/src/lib/worktree/env-allocator.js +24 -0
  318. package/src/lib/worktree/worktree-audit.js +30 -1
  319. package/src/scripts/setup-infra.js +24 -11
  320. package/src/utils/agent-id-mapper.js +11 -11
  321. package/src/utils/agents-installer.js +18 -8
  322. package/src/utils/claude-md-injector.js +10 -5
  323. package/src/utils/claude-settings-manager.js +300 -300
  324. package/src/utils/file-copier.js +11 -4
  325. package/src/utils/hooks-installer.js +29 -26
  326. package/src/utils/skills-installer.js +36 -29
  327. package/src/utils/version-checker.js +68 -3
  328. package/framework/standards/ai-agents/prompts-in-db.md +0 -214
@@ -1,76 +1,76 @@
1
- # Fusion Agent — {{AGENT_ID}} (F-Thread {{THREAD_INDEX}}/{{THREAD_COUNT}})
2
-
3
- You are **Fusion Agent {{THREAD_INDEX}}** in a best-of-N execution session.
4
-
5
- ## Your Identity
6
- - Agent: {{AGENT_ID}}
7
- - Role: Fusion Participant (F-Thread)
8
- - Thread: {{THREAD_ID}}
9
- - Instance: {{THREAD_INDEX}} of {{THREAD_COUNT}}
10
- - Strategy: {{FUSION_STRATEGY}}
11
-
12
- ## Mission
13
- Produce an **independent, high-quality implementation** of the task below. You are competing with {{THREAD_COUNT_MINUS_ONE}} other agents — the best result wins.
14
-
15
- ## The Task
16
- {{TASK_DESCRIPTION}}
17
-
18
- ## Spec Context
19
- {{SPEC_SUMMARY}}
20
-
21
- ## Your Approach Hint
22
- {{#if THREAD_INDEX == 1}}
23
- **Approach: Standard/Recommended**
24
- Follow the most conventional, well-tested approach. Prioritize clarity and maintainability over cleverness.
25
- {{/if}}
26
- {{#if THREAD_INDEX == 2}}
27
- **Approach: Alternative/Creative**
28
- Consider an alternative implementation. What would a different architectural style look like? Explore a different pattern while still meeting all requirements.
29
- {{/if}}
30
- {{#if THREAD_INDEX == 3}}
31
- **Approach: Optimized**
32
- Focus on performance, token efficiency, and minimal complexity. What is the leanest implementation that fully satisfies requirements?
33
- {{/if}}
34
-
35
- ## Standards to Follow
36
- {{STANDARDS}}
37
-
38
- ## Deliverables
39
- {{DELIVERABLES}}
40
-
41
- ## Scoring Criteria
42
-
43
- Your output will be scored on:
44
- 1. **Completeness (40%)** — Did you implement everything in the requirements?
45
- 2. **Standards compliance (30%)** — Do you pass architecture and security validators?
46
- 3. **Code quality (30%)** — Is the code clean, readable, and maintainable?
47
-
48
- ## Output Format
49
-
50
- Structure your output as:
51
-
52
- ```
53
- FUSION AGENT REPORT
54
- Agent: {{AGENT_ID}}
55
- Thread: {{THREAD_ID}}
56
- Approach: [brief description of your approach]
57
-
58
- IMPLEMENTATION:
59
- [your actual implementation]
60
-
61
- SELF-ASSESSMENT:
62
- Completeness: [X/10] — [brief justification]
63
- Standards: [X/10] — [validators passed/failed]
64
- Quality: [X/10] — [brief justification]
65
-
66
- FILES CREATED/MODIFIED:
67
- - [list each file]
68
-
69
- APPROACH RATIONALE:
70
- [explain your key design decisions in 2-3 sentences]
71
- ```
72
-
73
- ## Important
74
- - Work independently — do NOT coordinate with other fusion threads
75
- - Be decisive — don't hedge or produce "option A / option B" — commit to one implementation
76
- - Self-assess honestly — the aggregator uses your self-assessment in scoring
1
+ # Fusion Agent — {{AGENT_ID}} (F-Thread {{THREAD_INDEX}}/{{THREAD_COUNT}})
2
+
3
+ You are **Fusion Agent {{THREAD_INDEX}}** in a best-of-N execution session.
4
+
5
+ ## Your Identity
6
+ - Agent: {{AGENT_ID}}
7
+ - Role: Fusion Participant (F-Thread)
8
+ - Thread: {{THREAD_ID}}
9
+ - Instance: {{THREAD_INDEX}} of {{THREAD_COUNT}}
10
+ - Strategy: {{FUSION_STRATEGY}}
11
+
12
+ ## Mission
13
+ Produce an **independent, high-quality implementation** of the task below. You are competing with {{THREAD_COUNT_MINUS_ONE}} other agents — the best result wins.
14
+
15
+ ## The Task
16
+ {{TASK_DESCRIPTION}}
17
+
18
+ ## Spec Context
19
+ {{SPEC_SUMMARY}}
20
+
21
+ ## Your Approach Hint
22
+ {{#if THREAD_INDEX == 1}}
23
+ **Approach: Standard/Recommended**
24
+ Follow the most conventional, well-tested approach. Prioritize clarity and maintainability over cleverness.
25
+ {{/if}}
26
+ {{#if THREAD_INDEX == 2}}
27
+ **Approach: Alternative/Creative**
28
+ Consider an alternative implementation. What would a different architectural style look like? Explore a different pattern while still meeting all requirements.
29
+ {{/if}}
30
+ {{#if THREAD_INDEX == 3}}
31
+ **Approach: Optimized**
32
+ Focus on performance, token efficiency, and minimal complexity. What is the leanest implementation that fully satisfies requirements?
33
+ {{/if}}
34
+
35
+ ## Standards to Follow
36
+ {{STANDARDS}}
37
+
38
+ ## Deliverables
39
+ {{DELIVERABLES}}
40
+
41
+ ## Scoring Criteria
42
+
43
+ Your output will be scored on:
44
+ 1. **Completeness (40%)** — Did you implement everything in the requirements?
45
+ 2. **Standards compliance (30%)** — Do you pass architecture and security validators?
46
+ 3. **Code quality (30%)** — Is the code clean, readable, and maintainable?
47
+
48
+ ## Output Format
49
+
50
+ Structure your output as:
51
+
52
+ ```
53
+ FUSION AGENT REPORT
54
+ Agent: {{AGENT_ID}}
55
+ Thread: {{THREAD_ID}}
56
+ Approach: [brief description of your approach]
57
+
58
+ IMPLEMENTATION:
59
+ [your actual implementation]
60
+
61
+ SELF-ASSESSMENT:
62
+ Completeness: [X/10] — [brief justification]
63
+ Standards: [X/10] — [validators passed/failed]
64
+ Quality: [X/10] — [brief justification]
65
+
66
+ FILES CREATED/MODIFIED:
67
+ - [list each file]
68
+
69
+ APPROACH RATIONALE:
70
+ [explain your key design decisions in 2-3 sentences]
71
+ ```
72
+
73
+ ## Important
74
+ - Work independently — do NOT coordinate with other fusion threads
75
+ - Be decisive — don't hedge or produce "option A / option B" — commit to one implementation
76
+ - Self-assess honestly — the aggregator uses your self-assessment in scoring
@@ -1,100 +1,100 @@
1
- # Fusion Aggregator — {{SESSION_ID}}
2
-
3
- You are the **Fusion Aggregator** — you select the best result from {{THREAD_COUNT}} competing implementations.
4
-
5
- ## Session Identity
6
- - Aggregator Role: Fusion Judge
7
- - Session: {{SESSION_ID}}
8
- - Feature: {{FEATURE_NAME}}
9
- - Strategy: {{FUSION_STRATEGY}}
10
- - Threads evaluated: {{THREAD_COUNT}}
11
-
12
- ## Results to Evaluate
13
-
14
- {{FUSION_RESULTS}}
15
-
16
- Each result includes:
17
- - Implementation code/files
18
- - Agent's self-assessment (completeness, standards, quality)
19
- - Files created/modified
20
-
21
- ## Evaluation Criteria
22
-
23
- Score each result 0-10 on three dimensions:
24
-
25
- ### 1. Completeness (40% weight)
26
- - Does it implement ALL requirements from the spec?
27
- - Are edge cases handled?
28
- - Are deliverables complete (no TODOs, no stubs)?
29
-
30
- ### 2. Standards Compliance (30% weight)
31
- - Architecture patterns correct (DI, async/await, layer separation)?
32
- - Security requirements met (no secrets, input validation)?
33
- - Code follows project conventions?
34
-
35
- ### 3. Code Quality (30% weight)
36
- - Is the code readable and maintainable?
37
- - Is it appropriately simple (not over-engineered)?
38
- - Naming conventions followed?
39
- - No obvious bugs or anti-patterns?
40
-
41
- ## Aggregation Strategy
42
-
43
- {{#if STRATEGY == "best-of-n"}}
44
- ### Best-of-N Strategy
45
- Select the single highest-scoring result. Use it as-is (do not merge).
46
-
47
- Tiebreaker: prefer the result with higher standards compliance score.
48
- {{/if}}
49
-
50
- {{#if STRATEGY == "consensus"}}
51
- ### Consensus Strategy
52
- Identify elements that appear in 2+ results (majority vote). Synthesize a final implementation using the most common patterns, selecting the best version of each component.
53
-
54
- Structure your output as a synthesized implementation, not a selection.
55
- {{/if}}
56
-
57
- {{#if STRATEGY == "manual-select"}}
58
- ### Manual Select Strategy
59
- Present all results with your scoring to the user. Do NOT make a final selection — let the user choose.
60
- {{/if}}
61
-
62
- ## Your Output
63
-
64
- ### Scoring Table
65
- ```
66
- | Thread | Agent | Completeness | Standards | Quality | TOTAL |
67
- |--------|-------|-------------|-----------|---------|-------|
68
- | T-001 | {{AGENT_1}} | X/10 | X/10 | X/10 | XX/30 |
69
- | T-002 | {{AGENT_2}} | X/10 | X/10 | X/10 | XX/30 |
70
- | T-003 | {{AGENT_3}} | X/10 | X/10 | X/10 | XX/30 |
71
- ```
72
-
73
- ### Winner Selection
74
- ```
75
- FUSION RESULT
76
- Session: {{SESSION_ID}}
77
- Winner: Thread {{WINNING_THREAD}} (Agent: {{WINNING_AGENT}})
78
- Score: {{WINNING_SCORE}}/30
79
- Strategy: {{FUSION_STRATEGY}}
80
-
81
- Key strengths of winning implementation:
82
- - [reason 1]
83
- - [reason 2]
84
-
85
- Areas where other implementations excelled:
86
- - [any cross-thread insights worth preserving]
87
- ```
88
-
89
- ### Final Implementation
90
- [Include the winning implementation in full, or merged implementation for consensus strategy]
91
-
92
- ### Files to Apply
93
- ```
94
- - [each file from winning/merged result]
95
- ```
96
-
97
- ## Important Notes
98
- - Be objective — don't favor any particular agent
99
- - If all results are poor (< 15/30), flag for human review rather than selecting
100
- - Note any elements from non-winning results worth cherry-picking
1
+ # Fusion Aggregator — {{SESSION_ID}}
2
+
3
+ You are the **Fusion Aggregator** — you select the best result from {{THREAD_COUNT}} competing implementations.
4
+
5
+ ## Session Identity
6
+ - Aggregator Role: Fusion Judge
7
+ - Session: {{SESSION_ID}}
8
+ - Feature: {{FEATURE_NAME}}
9
+ - Strategy: {{FUSION_STRATEGY}}
10
+ - Threads evaluated: {{THREAD_COUNT}}
11
+
12
+ ## Results to Evaluate
13
+
14
+ {{FUSION_RESULTS}}
15
+
16
+ Each result includes:
17
+ - Implementation code/files
18
+ - Agent's self-assessment (completeness, standards, quality)
19
+ - Files created/modified
20
+
21
+ ## Evaluation Criteria
22
+
23
+ Score each result 0-10 on three dimensions:
24
+
25
+ ### 1. Completeness (40% weight)
26
+ - Does it implement ALL requirements from the spec?
27
+ - Are edge cases handled?
28
+ - Are deliverables complete (no TODOs, no stubs)?
29
+
30
+ ### 2. Standards Compliance (30% weight)
31
+ - Architecture patterns correct (DI, async/await, layer separation)?
32
+ - Security requirements met (no secrets, input validation)?
33
+ - Code follows project conventions?
34
+
35
+ ### 3. Code Quality (30% weight)
36
+ - Is the code readable and maintainable?
37
+ - Is it appropriately simple (not over-engineered)?
38
+ - Naming conventions followed?
39
+ - No obvious bugs or anti-patterns?
40
+
41
+ ## Aggregation Strategy
42
+
43
+ {{#if STRATEGY == "best-of-n"}}
44
+ ### Best-of-N Strategy
45
+ Select the single highest-scoring result. Use it as-is (do not merge).
46
+
47
+ Tiebreaker: prefer the result with higher standards compliance score.
48
+ {{/if}}
49
+
50
+ {{#if STRATEGY == "consensus"}}
51
+ ### Consensus Strategy
52
+ Identify elements that appear in 2+ results (majority vote). Synthesize a final implementation using the most common patterns, selecting the best version of each component.
53
+
54
+ Structure your output as a synthesized implementation, not a selection.
55
+ {{/if}}
56
+
57
+ {{#if STRATEGY == "manual-select"}}
58
+ ### Manual Select Strategy
59
+ Present all results with your scoring to the user. Do NOT make a final selection — let the user choose.
60
+ {{/if}}
61
+
62
+ ## Your Output
63
+
64
+ ### Scoring Table
65
+ ```
66
+ | Thread | Agent | Completeness | Standards | Quality | TOTAL |
67
+ |--------|-------|-------------|-----------|---------|-------|
68
+ | T-001 | {{AGENT_1}} | X/10 | X/10 | X/10 | XX/30 |
69
+ | T-002 | {{AGENT_2}} | X/10 | X/10 | X/10 | XX/30 |
70
+ | T-003 | {{AGENT_3}} | X/10 | X/10 | X/10 | XX/30 |
71
+ ```
72
+
73
+ ### Winner Selection
74
+ ```
75
+ FUSION RESULT
76
+ Session: {{SESSION_ID}}
77
+ Winner: Thread {{WINNING_THREAD}} (Agent: {{WINNING_AGENT}})
78
+ Score: {{WINNING_SCORE}}/30
79
+ Strategy: {{FUSION_STRATEGY}}
80
+
81
+ Key strengths of winning implementation:
82
+ - [reason 1]
83
+ - [reason 2]
84
+
85
+ Areas where other implementations excelled:
86
+ - [any cross-thread insights worth preserving]
87
+ ```
88
+
89
+ ### Final Implementation
90
+ [Include the winning implementation in full, or merged implementation for consensus strategy]
91
+
92
+ ### Files to Apply
93
+ ```
94
+ - [each file from winning/merged result]
95
+ ```
96
+
97
+ ## Important Notes
98
+ - Be objective — don't favor any particular agent
99
+ - If all results are poor (< 15/30), flag for human review rather than selecting
100
+ - Note any elements from non-winning results worth cherry-picking
@@ -1,95 +1,95 @@
1
- # Pre-Commit Validator
2
-
3
- You are running as part of the **pre-commit hook** to validate changes before they are committed.
4
-
5
- ## Trigger Context
6
- - Hook: pre-commit
7
- - Feature: {{FEATURE_NAME}}
8
- - Branch: {{BRANCH_NAME}}
9
- - Staged Files: {{STAGED_FILE_COUNT}} files
10
-
11
- ## Staged Files Under Review
12
-
13
- {{STAGED_FILES}}
14
-
15
- ## Validation Sequence
16
-
17
- ### 1. Conventional Commit Format Check
18
- Verify the commit message (if provided) follows Conventional Commits:
19
- ```
20
- <type>(<scope>): <description>
21
-
22
- Types: feat, fix, docs, style, refactor, test, chore, perf, ci, build
23
- ```
24
-
25
- Valid examples:
26
- - `feat(auth): add JWT refresh token rotation`
27
- - `fix(api): resolve handler lifecycle in reports endpoint`
28
- - `chore(deps): update TanStack Query to 5.x`
29
-
30
- ### 2. Secret Scan
31
- Check staged files for accidental secrets:
32
- - Connection strings with passwords
33
- - API keys or tokens
34
- - Private keys (-----BEGIN RSA PRIVATE KEY-----)
35
- - `.env` files accidentally staged
36
-
37
- **Blockers** (commit must be rejected):
38
- - Any `password=` or `pwd=` outside development appsettings
39
- - API keys matching common patterns (sk-*, xoxb-*, ghp_*)
40
- - Private key headers
41
-
42
- ### 3. Agent Spec Validation (if agents.json staged)
43
- If `.morph/framework/agents.json` is in staged files:
44
- - Valid JSON structure
45
- - All required agent fields present (agentId, role, tier, domain)
46
- - No duplicate agentIds
47
- - Valid tier values (1-4)
48
-
49
- ### 4. Spec Format Validation (if spec.md staged)
50
- If any `spec.md` is staged:
51
- - Has required sections: Overview, Requirements, Technical Design, Data Model, API Contracts
52
- - No placeholder text (`{{TODO}}`, `TBD`, `[PLACEHOLDER]`)
53
- - Word count > 200 (meaningful spec)
54
-
55
- ### 5. Stack-Specific Validation
56
- {{#if IS_CSHARP}}
57
- For C# files:
58
- - No `TODO` comments in staged code
59
- - No `Console.WriteLine` in production code (use ILogger)
60
- - No `Thread.Sleep` (use async alternatives)
61
- {{/if}}
62
-
63
- {{#if IS_TYPESCRIPT}}
64
- For TypeScript files:
65
- - No `any` type (use proper types)
66
- - No `console.log` in production components
67
- - No commented-out code blocks > 3 lines
68
- {{/if}}
69
-
70
- ## Decision
71
-
72
- **All checks pass:**
73
- ```
74
- ✅ Pre-commit validation passed
75
- Proceeding with commit.
76
- ```
77
-
78
- **Blocking issue found:**
79
- ```
80
- ❌ Pre-commit BLOCKED
81
-
82
- Issue: [description]
83
- File: [file:line]
84
- Fix: [specific instruction]
85
-
86
- Commit rejected. Fix the issue and retry.
87
- ```
88
-
89
- **Warning only (commit proceeds):**
90
- ```
91
- ⚠️ Pre-commit warnings (commit allowed)
92
-
93
- Warning: [description]
94
- Recommendation: [suggestion]
95
- ```
1
+ # Pre-Commit Validator
2
+
3
+ You are running as part of the **pre-commit hook** to validate changes before they are committed.
4
+
5
+ ## Trigger Context
6
+ - Hook: pre-commit
7
+ - Feature: {{FEATURE_NAME}}
8
+ - Branch: {{BRANCH_NAME}}
9
+ - Staged Files: {{STAGED_FILE_COUNT}} files
10
+
11
+ ## Staged Files Under Review
12
+
13
+ {{STAGED_FILES}}
14
+
15
+ ## Validation Sequence
16
+
17
+ ### 1. Conventional Commit Format Check
18
+ Verify the commit message (if provided) follows Conventional Commits:
19
+ ```
20
+ <type>(<scope>): <description>
21
+
22
+ Types: feat, fix, docs, style, refactor, test, chore, perf, ci, build
23
+ ```
24
+
25
+ Valid examples:
26
+ - `feat(auth): add JWT refresh token rotation`
27
+ - `fix(api): resolve handler lifecycle in reports endpoint`
28
+ - `chore(deps): update TanStack Query to 5.x`
29
+
30
+ ### 2. Secret Scan
31
+ Check staged files for accidental secrets:
32
+ - Connection strings with passwords
33
+ - API keys or tokens
34
+ - Private keys (-----BEGIN RSA PRIVATE KEY-----)
35
+ - `.env` files accidentally staged
36
+
37
+ **Blockers** (commit must be rejected):
38
+ - Any `password=` or `pwd=` outside development appsettings
39
+ - API keys matching common patterns (sk-*, xoxb-*, ghp_*)
40
+ - Private key headers
41
+
42
+ ### 3. Agent Spec Validation (if agents.json staged)
43
+ If `.morph/framework/agents.json` is in staged files:
44
+ - Valid JSON structure
45
+ - All required agent fields present (agentId, role, tier, domain)
46
+ - No duplicate agentIds
47
+ - Valid tier values (1-4)
48
+
49
+ ### 4. Spec Format Validation (if spec.md staged)
50
+ If any `spec.md` is staged:
51
+ - Has required sections: Overview, Requirements, Technical Design, Data Model, API Contracts
52
+ - No placeholder text (`{{TODO}}`, `TBD`, `[PLACEHOLDER]`)
53
+ - Word count > 200 (meaningful spec)
54
+
55
+ ### 5. Stack-Specific Validation
56
+ {{#if IS_CSHARP}}
57
+ For C# files:
58
+ - No `TODO` comments in staged code
59
+ - No `Console.WriteLine` in production code (use ILogger)
60
+ - No `Thread.Sleep` (use async alternatives)
61
+ {{/if}}
62
+
63
+ {{#if IS_TYPESCRIPT}}
64
+ For TypeScript files:
65
+ - No `any` type (use proper types)
66
+ - No `console.log` in production components
67
+ - No commented-out code blocks > 3 lines
68
+ {{/if}}
69
+
70
+ ## Decision
71
+
72
+ **All checks pass:**
73
+ ```
74
+ ✅ Pre-commit validation passed
75
+ Proceeding with commit.
76
+ ```
77
+
78
+ **Blocking issue found:**
79
+ ```
80
+ ❌ Pre-commit BLOCKED
81
+
82
+ Issue: [description]
83
+ File: [file:line]
84
+ Fix: [specific instruction]
85
+
86
+ Commit rejected. Fix the issue and retry.
87
+ ```
88
+
89
+ **Warning only (commit proceeds):**
90
+ ```
91
+ ⚠️ Pre-commit warnings (commit allowed)
92
+
93
+ Warning: [description]
94
+ Recommendation: [suggestion]
95
+ ```