@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,366 +1,366 @@
1
- import { useState, useMemo, useCallback } from 'react';
2
- import { Handle, Position } from '@xyflow/react';
3
- import dagre from '@dagrejs/dagre';
4
- import morphData from 'virtual:morph-data';
5
- import FlowGraph from '../components/FlowGraph.jsx';
6
- import DetailPanel from '../components/DetailPanel.jsx';
7
- import SearchFilter from '../components/SearchFilter.jsx';
8
- import { useDetailPanel } from '../hooks/useDetailPanel.js';
9
-
10
- // Colors for skill categories (v5 — all skills in skills/core/)
11
- const LEVEL_COLORS = {
12
- 'core': { bg: '#134e4a', border: '#14b8a6', label: 'Core' },
13
- };
14
- const FALLBACK_LEVEL = { bg: '#1a2e1a', border: '#4ade80', label: 'Skill' };
15
-
16
- // Phase color (indigo)
17
- const PHASE_COLOR = { bg: '#1e1b4b', border: '#818cf8', text: '#e0e7ff' };
18
-
19
- // SkillNode: teal/green border
20
- function SkillNode({ data }) {
21
- const c = LEVEL_COLORS[data.level] || FALLBACK_LEVEL;
22
- return (
23
- <div
24
- className="rounded-lg px-3 py-2 min-w-[140px] max-w-[170px] cursor-pointer select-none"
25
- style={{ background: c.bg, border: `1.5px solid ${c.border}`, boxShadow: `0 0 8px ${c.border}22` }}
26
- >
27
- <Handle type="target" position={Position.Top} style={{ background: c.border, width: 7, height: 7 }} />
28
- <div className="text-white text-xs font-semibold leading-tight truncate" title={data.label}>
29
- {data.label}
30
- </div>
31
- <div className="mt-0.5 text-[10px] font-medium" style={{ color: c.border }}>
32
- {(LEVEL_COLORS[data.level] || FALLBACK_LEVEL).label}
33
- </div>
34
- <Handle type="source" position={Position.Bottom} style={{ background: c.border, width: 7, height: 7 }} />
35
- </div>
36
- );
37
- }
38
-
39
- // PhaseRefNode: indigo border, shows phase name
40
- function PhaseRefNode({ data }) {
41
- return (
42
- <div
43
- className="rounded-lg px-4 py-2.5 min-w-[130px] select-none cursor-default"
44
- style={{ background: PHASE_COLOR.bg, border: `1.5px solid ${PHASE_COLOR.border}`, boxShadow: `0 0 8px ${PHASE_COLOR.border}33` }}
45
- >
46
- <Handle type="source" position={Position.Bottom} style={{ background: PHASE_COLOR.border, width: 7, height: 7 }} />
47
- <div className="text-white text-xs font-bold leading-tight truncate" title={data.label}>
48
- {data.label}
49
- </div>
50
- <div className="mt-0.5 text-[10px]" style={{ color: PHASE_COLOR.text }}>
51
- phase
52
- </div>
53
- </div>
54
- );
55
- }
56
-
57
- const nodeTypes = { skillNode: SkillNode, phaseRefNode: PhaseRefNode };
58
-
59
- // Shorten a trigger string for use as edge label
60
- function shortTrigger(trigger) {
61
- if (!trigger) return '';
62
- // "on:task:start" → "task:start", "/morph-proposal" → "morph-proposal"
63
- return trigger.replace(/^on:/, '').replace(/^\//, '');
64
- }
65
-
66
- // Build dagre layout for the skills graph
67
- function buildLayout(nodes, edges) {
68
- const g = new dagre.graphlib.Graph();
69
- g.setDefaultEdgeLabel(() => ({}));
70
- g.setGraph({ rankdir: 'TB', nodesep: 50, ranksep: 80, marginx: 20, marginy: 20 });
71
-
72
- for (const n of nodes) {
73
- const w = n.type === 'phaseRefNode' ? 150 : 170;
74
- const h = n.type === 'phaseRefNode' ? 52 : 58;
75
- g.setNode(n.id, { width: w, height: h });
76
- }
77
- for (const e of edges) {
78
- g.setEdge(e.source, e.target);
79
- }
80
-
81
- dagre.layout(g);
82
-
83
- return nodes.map((n) => {
84
- const pos = g.node(n.id);
85
- const halfW = n.type === 'phaseRefNode' ? 75 : 85;
86
- const halfH = n.type === 'phaseRefNode' ? 26 : 29;
87
- return { ...n, position: { x: pos.x - halfW, y: pos.y - halfH } };
88
- });
89
- }
90
-
91
- // Detail panel for a skill
92
- function SkillDetail({ skill }) {
93
- const c = LEVEL_COLORS[skill.level] || FALLBACK_LEVEL;
94
-
95
- return (
96
- <div className="text-sm text-gray-200 space-y-4">
97
- {/* Header badges */}
98
- <div className="flex flex-wrap gap-2">
99
- <span
100
- className="px-2 py-0.5 rounded text-xs font-bold"
101
- style={{ background: c.bg, color: c.border, border: `1px solid ${c.border}` }}
102
- >
103
- {c.label}
104
- </span>
105
- <span
106
- className={`px-2 py-0.5 rounded text-xs font-medium border ${
107
- skill.userInvocable
108
- ? 'bg-green-900/40 border-green-600 text-green-300'
109
- : 'bg-gray-800 border-gray-600 text-gray-400'
110
- }`}
111
- >
112
- {skill.userInvocable ? 'User-invocable' : 'Internal'}
113
- </span>
114
- </div>
115
-
116
- {/* ID */}
117
- <div>
118
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1">Skill ID</p>
119
- <p className="font-mono text-xs text-gray-300">{skill.id}</p>
120
- </div>
121
-
122
- {/* Description */}
123
- {skill.description && (
124
- <div>
125
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1">Description</p>
126
- <p className="text-gray-300 text-xs leading-relaxed">{skill.description}</p>
127
- </div>
128
- )}
129
-
130
- {/* Allowed tools */}
131
- {skill.allowedTools?.length > 0 && (
132
- <div>
133
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Allowed Tools</p>
134
- <div className="flex flex-wrap gap-1">
135
- {skill.allowedTools.map((t) => (
136
- <span key={t} className="px-1.5 py-0.5 bg-gray-800 border border-gray-600 rounded text-xs text-gray-300 font-mono">
137
- {t}
138
- </span>
139
- ))}
140
- </div>
141
- </div>
142
- )}
143
-
144
- {/* Full content */}
145
- {skill.content && (
146
- <div>
147
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Full Content</p>
148
- <pre className="p-3 bg-gray-950 border border-gray-800 rounded text-[10px] text-gray-400 overflow-x-auto whitespace-pre-wrap font-mono leading-relaxed max-h-72 overflow-y-auto">
149
- {skill.content}
150
- </pre>
151
- </div>
152
- )}
153
- </div>
154
- );
155
- }
156
-
157
- export default function SkillsLibrary() {
158
- const { skills, phases } = morphData;
159
- const [search, setSearch] = useState('');
160
- const [levelFilter, setLevelFilter] = useState('');
161
- const { panel, openPanel, closePanel } = useDetailPanel();
162
-
163
- // All unique levels for filter dropdown
164
- const allLevels = useMemo(
165
- () => [...new Set(skills.map((s) => s.level).filter(Boolean))].sort(),
166
- [skills]
167
- );
168
-
169
- // Matched skill IDs based on search + level filter
170
- const matchedIds = useMemo(() => {
171
- const q = search.toLowerCase();
172
- return new Set(
173
- skills
174
- .filter((s) => {
175
- const matchesSearch =
176
- !q ||
177
- s.name.toLowerCase().includes(q) ||
178
- s.id.toLowerCase().includes(q) ||
179
- s.description.toLowerCase().includes(q);
180
- const matchesLevel = !levelFilter || s.level === levelFilter;
181
- return matchesSearch && matchesLevel;
182
- })
183
- .map((s) => s.id)
184
- );
185
- }, [skills, search, levelFilter]);
186
-
187
- const hasFilter = search || levelFilter;
188
-
189
- // Build a map: skillId → [{ phaseId, trigger }] for all connected phases
190
- const skillToPhases = useMemo(() => {
191
- const map = new Map();
192
- for (const phase of phases.list) {
193
- for (const rs of phase.requiredSkills || []) {
194
- if (!rs.skill) continue;
195
- if (!map.has(rs.skill)) map.set(rs.skill, []);
196
- map.get(rs.skill).push({ phaseId: phase.id, trigger: rs.trigger });
197
- }
198
- }
199
- return map;
200
- }, [phases.list]);
201
-
202
- // Set of phase IDs that actually connect to at least one skill
203
- const connectedPhaseIds = useMemo(() => {
204
- const ids = new Set();
205
- for (const phase of phases.list) {
206
- if (phase.requiredSkills?.some((rs) => rs.skill)) {
207
- ids.add(phase.id);
208
- }
209
- }
210
- return ids;
211
- }, [phases.list]);
212
-
213
- // Build nodes + edges
214
- const { nodes: layoutNodes, edges } = useMemo(() => {
215
- const rawNodes = [];
216
- const rawEdges = [];
217
-
218
- // Phase nodes (top row) — only phases with required skills
219
- const connectedPhases = phases.list.filter((p) => connectedPhaseIds.has(p.id));
220
- for (const phase of connectedPhases) {
221
- rawNodes.push({
222
- id: `phase:${phase.id}`,
223
- type: 'phaseRefNode',
224
- data: {
225
- label: phase.displayName,
226
- phaseId: phase.id,
227
- color: PHASE_COLOR.border,
228
- },
229
- position: { x: 0, y: 0 },
230
- });
231
- }
232
-
233
- // Skill nodes
234
- for (const skill of skills) {
235
- const dimmed = hasFilter && !matchedIds.has(skill.id);
236
- const c = LEVEL_COLORS[skill.level] || FALLBACK_LEVEL;
237
- rawNodes.push({
238
- id: skill.id,
239
- type: 'skillNode',
240
- data: {
241
- label: skill.name,
242
- level: skill.level,
243
- skillRef: skill,
244
- color: c.border,
245
- },
246
- style: dimmed ? { opacity: 0.2 } : {},
247
- position: { x: 0, y: 0 },
248
- });
249
- }
250
-
251
- // Edges: phase → skill with trigger label
252
- const edgeIndex = new Map(); // track (phaseId,skillId) pairs to avoid duplicates
253
- for (const phase of phases.list) {
254
- for (const rs of phase.requiredSkills || []) {
255
- if (!rs.skill) continue;
256
- const key = `${phase.id}::${rs.skill}`;
257
- if (edgeIndex.has(key)) continue;
258
- edgeIndex.set(key, true);
259
-
260
- const label = shortTrigger(rs.trigger);
261
- rawEdges.push({
262
- id: `edge-${phase.id}-${rs.skill}`,
263
- source: `phase:${phase.id}`,
264
- target: rs.skill,
265
- type: 'smoothstep',
266
- label: label || undefined,
267
- labelStyle: { fontSize: 9, fill: '#94a3b8' },
268
- labelBgStyle: { fill: '#0f172a', fillOpacity: 0.85 },
269
- labelBgPadding: [3, 2],
270
- style: { stroke: PHASE_COLOR.border, strokeWidth: 1.5, opacity: 0.7 },
271
- });
272
- }
273
- }
274
-
275
- const layouted = buildLayout(rawNodes, rawEdges);
276
- return { nodes: layouted, edges: rawEdges };
277
- }, [skills, phases.list, matchedIds, hasFilter, connectedPhaseIds]);
278
-
279
- const handleNodeClick = useCallback(
280
- (_event, node) => {
281
- if (node.type === 'phaseRefNode') {
282
- // No detail panel for phase nodes per spec
283
- return;
284
- }
285
- const skill = node.data.skillRef;
286
- if (skill) {
287
- openPanel(skill.name, <SkillDetail skill={skill} />);
288
- }
289
- },
290
- [openPanel]
291
- );
292
-
293
- const filterConfig = [
294
- { name: 'level', label: 'Level', options: allLevels, value: levelFilter },
295
- ];
296
-
297
- // Unconnected skill count
298
- const unconnectedCount = useMemo(
299
- () => skills.filter((s) => !skillToPhases.has(s.id)).length,
300
- [skills, skillToPhases]
301
- );
302
-
303
- return (
304
- <div className="flex flex-col h-full">
305
- <SearchFilter
306
- placeholder="Search skills by name or description..."
307
- filters={filterConfig}
308
- onSearchChange={setSearch}
309
- onFilterChange={(name, value) => {
310
- if (name === 'level') setLevelFilter(value);
311
- }}
312
- />
313
-
314
- <div className="flex-1 relative">
315
- <FlowGraph
316
- nodes={layoutNodes}
317
- edges={edges}
318
- nodeTypes={nodeTypes}
319
- onNodeClick={handleNodeClick}
320
- fitView
321
- />
322
-
323
- {/* Legend */}
324
- <div className="absolute top-3 left-3 bg-gray-900/90 border border-gray-700 rounded-lg p-3 text-xs space-y-2 z-10">
325
- <p className="text-gray-400 font-semibold uppercase tracking-wide text-[10px] mb-2">Legend</p>
326
- <div className="flex items-center gap-2">
327
- <span
328
- className="inline-block w-10 h-4 rounded-sm flex-shrink-0"
329
- style={{ background: PHASE_COLOR.bg, border: `1.5px solid ${PHASE_COLOR.border}` }}
330
- />
331
- <span className="text-gray-300">Phase</span>
332
- </div>
333
- {Object.entries(LEVEL_COLORS).map(([level, c]) => (
334
- <div key={level} className="flex items-center gap-2">
335
- <span
336
- className="inline-block w-10 h-4 rounded-sm flex-shrink-0"
337
- style={{ background: c.bg, border: `1.5px solid ${c.border}` }}
338
- />
339
- <span className="text-gray-300">{c.label}</span>
340
- </div>
341
- ))}
342
- <div className="border-t border-gray-700 mt-2 pt-2">
343
- <div className="flex items-center gap-2">
344
- <span className="inline-block w-6 border-t-2 border-indigo-400" style={{ opacity: 0.7 }} />
345
- <span className="text-gray-400">phase → skill</span>
346
- </div>
347
- </div>
348
- </div>
349
-
350
- {/* Stats badge */}
351
- <div className="absolute top-3 right-3 bg-gray-900/90 border border-gray-700 rounded-lg px-3 py-1.5 text-xs text-gray-400 z-10 space-y-0.5">
352
- <div>
353
- {hasFilter ? `${matchedIds.size} / ${skills.length}` : skills.length} skills
354
- </div>
355
- {unconnectedCount > 0 && (
356
- <div className="text-gray-600">{unconnectedCount} unlinked</div>
357
- )}
358
- </div>
359
- </div>
360
-
361
- <DetailPanel open={panel.open} title={panel.title} onClose={closePanel}>
362
- {panel.content}
363
- </DetailPanel>
364
- </div>
365
- );
366
- }
1
+ import { useState, useMemo, useCallback } from 'react';
2
+ import { Handle, Position } from '@xyflow/react';
3
+ import dagre from '@dagrejs/dagre';
4
+ import morphData from 'virtual:morph-data';
5
+ import FlowGraph from '../components/FlowGraph.jsx';
6
+ import DetailPanel from '../components/DetailPanel.jsx';
7
+ import SearchFilter from '../components/SearchFilter.jsx';
8
+ import { useDetailPanel } from '../hooks/useDetailPanel.js';
9
+
10
+ // Colors for skill categories (v5 — all skills in skills/core/)
11
+ const LEVEL_COLORS = {
12
+ 'core': { bg: '#134e4a', border: '#14b8a6', label: 'Core' },
13
+ };
14
+ const FALLBACK_LEVEL = { bg: '#1a2e1a', border: '#4ade80', label: 'Skill' };
15
+
16
+ // Phase color (indigo)
17
+ const PHASE_COLOR = { bg: '#1e1b4b', border: '#818cf8', text: '#e0e7ff' };
18
+
19
+ // SkillNode: teal/green border
20
+ function SkillNode({ data }) {
21
+ const c = LEVEL_COLORS[data.level] || FALLBACK_LEVEL;
22
+ return (
23
+ <div
24
+ className="rounded-lg px-3 py-2 min-w-[140px] max-w-[170px] cursor-pointer select-none"
25
+ style={{ background: c.bg, border: `1.5px solid ${c.border}`, boxShadow: `0 0 8px ${c.border}22` }}
26
+ >
27
+ <Handle type="target" position={Position.Top} style={{ background: c.border, width: 7, height: 7 }} />
28
+ <div className="text-white text-xs font-semibold leading-tight truncate" title={data.label}>
29
+ {data.label}
30
+ </div>
31
+ <div className="mt-0.5 text-[10px] font-medium" style={{ color: c.border }}>
32
+ {(LEVEL_COLORS[data.level] || FALLBACK_LEVEL).label}
33
+ </div>
34
+ <Handle type="source" position={Position.Bottom} style={{ background: c.border, width: 7, height: 7 }} />
35
+ </div>
36
+ );
37
+ }
38
+
39
+ // PhaseRefNode: indigo border, shows phase name
40
+ function PhaseRefNode({ data }) {
41
+ return (
42
+ <div
43
+ className="rounded-lg px-4 py-2.5 min-w-[130px] select-none cursor-default"
44
+ style={{ background: PHASE_COLOR.bg, border: `1.5px solid ${PHASE_COLOR.border}`, boxShadow: `0 0 8px ${PHASE_COLOR.border}33` }}
45
+ >
46
+ <Handle type="source" position={Position.Bottom} style={{ background: PHASE_COLOR.border, width: 7, height: 7 }} />
47
+ <div className="text-white text-xs font-bold leading-tight truncate" title={data.label}>
48
+ {data.label}
49
+ </div>
50
+ <div className="mt-0.5 text-[10px]" style={{ color: PHASE_COLOR.text }}>
51
+ phase
52
+ </div>
53
+ </div>
54
+ );
55
+ }
56
+
57
+ const nodeTypes = { skillNode: SkillNode, phaseRefNode: PhaseRefNode };
58
+
59
+ // Shorten a trigger string for use as edge label
60
+ function shortTrigger(trigger) {
61
+ if (!trigger) return '';
62
+ // "on:task:start" → "task:start", "/morph-proposal" → "morph-proposal"
63
+ return trigger.replace(/^on:/, '').replace(/^\//, '');
64
+ }
65
+
66
+ // Build dagre layout for the skills graph
67
+ function buildLayout(nodes, edges) {
68
+ const g = new dagre.graphlib.Graph();
69
+ g.setDefaultEdgeLabel(() => ({}));
70
+ g.setGraph({ rankdir: 'TB', nodesep: 50, ranksep: 80, marginx: 20, marginy: 20 });
71
+
72
+ for (const n of nodes) {
73
+ const w = n.type === 'phaseRefNode' ? 150 : 170;
74
+ const h = n.type === 'phaseRefNode' ? 52 : 58;
75
+ g.setNode(n.id, { width: w, height: h });
76
+ }
77
+ for (const e of edges) {
78
+ g.setEdge(e.source, e.target);
79
+ }
80
+
81
+ dagre.layout(g);
82
+
83
+ return nodes.map((n) => {
84
+ const pos = g.node(n.id);
85
+ const halfW = n.type === 'phaseRefNode' ? 75 : 85;
86
+ const halfH = n.type === 'phaseRefNode' ? 26 : 29;
87
+ return { ...n, position: { x: pos.x - halfW, y: pos.y - halfH } };
88
+ });
89
+ }
90
+
91
+ // Detail panel for a skill
92
+ function SkillDetail({ skill }) {
93
+ const c = LEVEL_COLORS[skill.level] || FALLBACK_LEVEL;
94
+
95
+ return (
96
+ <div className="text-sm text-gray-200 space-y-4">
97
+ {/* Header badges */}
98
+ <div className="flex flex-wrap gap-2">
99
+ <span
100
+ className="px-2 py-0.5 rounded text-xs font-bold"
101
+ style={{ background: c.bg, color: c.border, border: `1px solid ${c.border}` }}
102
+ >
103
+ {c.label}
104
+ </span>
105
+ <span
106
+ className={`px-2 py-0.5 rounded text-xs font-medium border ${
107
+ skill.userInvocable
108
+ ? 'bg-green-900/40 border-green-600 text-green-300'
109
+ : 'bg-gray-800 border-gray-600 text-gray-400'
110
+ }`}
111
+ >
112
+ {skill.userInvocable ? 'User-invocable' : 'Internal'}
113
+ </span>
114
+ </div>
115
+
116
+ {/* ID */}
117
+ <div>
118
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1">Skill ID</p>
119
+ <p className="font-mono text-xs text-gray-300">{skill.id}</p>
120
+ </div>
121
+
122
+ {/* Description */}
123
+ {skill.description && (
124
+ <div>
125
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1">Description</p>
126
+ <p className="text-gray-300 text-xs leading-relaxed">{skill.description}</p>
127
+ </div>
128
+ )}
129
+
130
+ {/* Allowed tools */}
131
+ {skill.allowedTools?.length > 0 && (
132
+ <div>
133
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Allowed Tools</p>
134
+ <div className="flex flex-wrap gap-1">
135
+ {skill.allowedTools.map((t) => (
136
+ <span key={t} className="px-1.5 py-0.5 bg-gray-800 border border-gray-600 rounded text-xs text-gray-300 font-mono">
137
+ {t}
138
+ </span>
139
+ ))}
140
+ </div>
141
+ </div>
142
+ )}
143
+
144
+ {/* Full content */}
145
+ {skill.content && (
146
+ <div>
147
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-1.5">Full Content</p>
148
+ <pre className="p-3 bg-gray-950 border border-gray-800 rounded text-[10px] text-gray-400 overflow-x-auto whitespace-pre-wrap font-mono leading-relaxed max-h-72 overflow-y-auto">
149
+ {skill.content}
150
+ </pre>
151
+ </div>
152
+ )}
153
+ </div>
154
+ );
155
+ }
156
+
157
+ export default function SkillsLibrary() {
158
+ const { skills, phases } = morphData;
159
+ const [search, setSearch] = useState('');
160
+ const [levelFilter, setLevelFilter] = useState('');
161
+ const { panel, openPanel, closePanel } = useDetailPanel();
162
+
163
+ // All unique levels for filter dropdown
164
+ const allLevels = useMemo(
165
+ () => [...new Set(skills.map((s) => s.level).filter(Boolean))].sort(),
166
+ [skills]
167
+ );
168
+
169
+ // Matched skill IDs based on search + level filter
170
+ const matchedIds = useMemo(() => {
171
+ const q = search.toLowerCase();
172
+ return new Set(
173
+ skills
174
+ .filter((s) => {
175
+ const matchesSearch =
176
+ !q ||
177
+ s.name.toLowerCase().includes(q) ||
178
+ s.id.toLowerCase().includes(q) ||
179
+ s.description.toLowerCase().includes(q);
180
+ const matchesLevel = !levelFilter || s.level === levelFilter;
181
+ return matchesSearch && matchesLevel;
182
+ })
183
+ .map((s) => s.id)
184
+ );
185
+ }, [skills, search, levelFilter]);
186
+
187
+ const hasFilter = search || levelFilter;
188
+
189
+ // Build a map: skillId → [{ phaseId, trigger }] for all connected phases
190
+ const skillToPhases = useMemo(() => {
191
+ const map = new Map();
192
+ for (const phase of phases.list) {
193
+ for (const rs of phase.requiredSkills || []) {
194
+ if (!rs.skill) continue;
195
+ if (!map.has(rs.skill)) map.set(rs.skill, []);
196
+ map.get(rs.skill).push({ phaseId: phase.id, trigger: rs.trigger });
197
+ }
198
+ }
199
+ return map;
200
+ }, [phases.list]);
201
+
202
+ // Set of phase IDs that actually connect to at least one skill
203
+ const connectedPhaseIds = useMemo(() => {
204
+ const ids = new Set();
205
+ for (const phase of phases.list) {
206
+ if (phase.requiredSkills?.some((rs) => rs.skill)) {
207
+ ids.add(phase.id);
208
+ }
209
+ }
210
+ return ids;
211
+ }, [phases.list]);
212
+
213
+ // Build nodes + edges
214
+ const { nodes: layoutNodes, edges } = useMemo(() => {
215
+ const rawNodes = [];
216
+ const rawEdges = [];
217
+
218
+ // Phase nodes (top row) — only phases with required skills
219
+ const connectedPhases = phases.list.filter((p) => connectedPhaseIds.has(p.id));
220
+ for (const phase of connectedPhases) {
221
+ rawNodes.push({
222
+ id: `phase:${phase.id}`,
223
+ type: 'phaseRefNode',
224
+ data: {
225
+ label: phase.displayName,
226
+ phaseId: phase.id,
227
+ color: PHASE_COLOR.border,
228
+ },
229
+ position: { x: 0, y: 0 },
230
+ });
231
+ }
232
+
233
+ // Skill nodes
234
+ for (const skill of skills) {
235
+ const dimmed = hasFilter && !matchedIds.has(skill.id);
236
+ const c = LEVEL_COLORS[skill.level] || FALLBACK_LEVEL;
237
+ rawNodes.push({
238
+ id: skill.id,
239
+ type: 'skillNode',
240
+ data: {
241
+ label: skill.name,
242
+ level: skill.level,
243
+ skillRef: skill,
244
+ color: c.border,
245
+ },
246
+ style: dimmed ? { opacity: 0.2 } : {},
247
+ position: { x: 0, y: 0 },
248
+ });
249
+ }
250
+
251
+ // Edges: phase → skill with trigger label
252
+ const edgeIndex = new Map(); // track (phaseId,skillId) pairs to avoid duplicates
253
+ for (const phase of phases.list) {
254
+ for (const rs of phase.requiredSkills || []) {
255
+ if (!rs.skill) continue;
256
+ const key = `${phase.id}::${rs.skill}`;
257
+ if (edgeIndex.has(key)) continue;
258
+ edgeIndex.set(key, true);
259
+
260
+ const label = shortTrigger(rs.trigger);
261
+ rawEdges.push({
262
+ id: `edge-${phase.id}-${rs.skill}`,
263
+ source: `phase:${phase.id}`,
264
+ target: rs.skill,
265
+ type: 'smoothstep',
266
+ label: label || undefined,
267
+ labelStyle: { fontSize: 9, fill: '#94a3b8' },
268
+ labelBgStyle: { fill: '#0f172a', fillOpacity: 0.85 },
269
+ labelBgPadding: [3, 2],
270
+ style: { stroke: PHASE_COLOR.border, strokeWidth: 1.5, opacity: 0.7 },
271
+ });
272
+ }
273
+ }
274
+
275
+ const layouted = buildLayout(rawNodes, rawEdges);
276
+ return { nodes: layouted, edges: rawEdges };
277
+ }, [skills, phases.list, matchedIds, hasFilter, connectedPhaseIds]);
278
+
279
+ const handleNodeClick = useCallback(
280
+ (_event, node) => {
281
+ if (node.type === 'phaseRefNode') {
282
+ // No detail panel for phase nodes per spec
283
+ return;
284
+ }
285
+ const skill = node.data.skillRef;
286
+ if (skill) {
287
+ openPanel(skill.name, <SkillDetail skill={skill} />);
288
+ }
289
+ },
290
+ [openPanel]
291
+ );
292
+
293
+ const filterConfig = [
294
+ { name: 'level', label: 'Level', options: allLevels, value: levelFilter },
295
+ ];
296
+
297
+ // Unconnected skill count
298
+ const unconnectedCount = useMemo(
299
+ () => skills.filter((s) => !skillToPhases.has(s.id)).length,
300
+ [skills, skillToPhases]
301
+ );
302
+
303
+ return (
304
+ <div className="flex flex-col h-full">
305
+ <SearchFilter
306
+ placeholder="Search skills by name or description..."
307
+ filters={filterConfig}
308
+ onSearchChange={setSearch}
309
+ onFilterChange={(name, value) => {
310
+ if (name === 'level') setLevelFilter(value);
311
+ }}
312
+ />
313
+
314
+ <div className="flex-1 relative">
315
+ <FlowGraph
316
+ nodes={layoutNodes}
317
+ edges={edges}
318
+ nodeTypes={nodeTypes}
319
+ onNodeClick={handleNodeClick}
320
+ fitView
321
+ />
322
+
323
+ {/* Legend */}
324
+ <div className="absolute top-3 left-3 bg-gray-900/90 border border-gray-700 rounded-lg p-3 text-xs space-y-2 z-10">
325
+ <p className="text-gray-400 font-semibold uppercase tracking-wide text-[10px] mb-2">Legend</p>
326
+ <div className="flex items-center gap-2">
327
+ <span
328
+ className="inline-block w-10 h-4 rounded-sm flex-shrink-0"
329
+ style={{ background: PHASE_COLOR.bg, border: `1.5px solid ${PHASE_COLOR.border}` }}
330
+ />
331
+ <span className="text-gray-300">Phase</span>
332
+ </div>
333
+ {Object.entries(LEVEL_COLORS).map(([level, c]) => (
334
+ <div key={level} className="flex items-center gap-2">
335
+ <span
336
+ className="inline-block w-10 h-4 rounded-sm flex-shrink-0"
337
+ style={{ background: c.bg, border: `1.5px solid ${c.border}` }}
338
+ />
339
+ <span className="text-gray-300">{c.label}</span>
340
+ </div>
341
+ ))}
342
+ <div className="border-t border-gray-700 mt-2 pt-2">
343
+ <div className="flex items-center gap-2">
344
+ <span className="inline-block w-6 border-t-2 border-indigo-400" style={{ opacity: 0.7 }} />
345
+ <span className="text-gray-400">phase → skill</span>
346
+ </div>
347
+ </div>
348
+ </div>
349
+
350
+ {/* Stats badge */}
351
+ <div className="absolute top-3 right-3 bg-gray-900/90 border border-gray-700 rounded-lg px-3 py-1.5 text-xs text-gray-400 z-10 space-y-0.5">
352
+ <div>
353
+ {hasFilter ? `${matchedIds.size} / ${skills.length}` : skills.length} skills
354
+ </div>
355
+ {unconnectedCount > 0 && (
356
+ <div className="text-gray-600">{unconnectedCount} unlinked</div>
357
+ )}
358
+ </div>
359
+ </div>
360
+
361
+ <DetailPanel open={panel.open} title={panel.title} onClose={closePanel}>
362
+ {panel.content}
363
+ </DetailPanel>
364
+ </div>
365
+ );
366
+ }