@polymorphism-tech/morph-spec 8.34.2 → 8.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (325) hide show
  1. package/CLAUDE.md +20 -3
  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 +234 -9
  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/statusline.sh +11 -11
  26. package/framework/hooks/git/commit-msg/conventional-commits.sh +33 -33
  27. package/framework/hooks/git/pre-commit/agents.sh +25 -25
  28. package/framework/hooks/git/pre-commit/orchestrator.sh +64 -64
  29. package/framework/hooks/git/pre-commit/specs.sh +50 -50
  30. package/framework/hooks/git/pre-push/run-tests.sh +44 -44
  31. package/framework/hooks/shared/e2e-check.js +135 -22
  32. package/framework/hooks/shared/stdin-reader.js +26 -26
  33. package/framework/rules/ai-agents-standards.md +14 -2
  34. package/framework/schemas/ai-pin.schema.json +97 -0
  35. package/framework/schemas/config.schema.json +107 -0
  36. package/framework/schemas/feature.schema.json +23 -4
  37. package/framework/skills/core/create-umbraco-lp/SKILL.md +1 -1
  38. package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md +1 -1
  39. package/framework/skills/core/morph-apply/SKILL.md +26 -5
  40. package/framework/skills/core/morph-brainstorming/SKILL.md +1 -1
  41. package/framework/skills/core/morph-eval/SKILL.md +1 -1
  42. package/framework/skills/core/morph-hotfix/SKILL.md +2 -2
  43. package/framework/skills/core/morph-implement/SKILL.md +18 -2
  44. package/framework/skills/core/morph-media/SKILL.md +215 -0
  45. package/framework/skills/core/morph-plan/SKILL.md +33 -2
  46. package/framework/skills/core/morph-proposal/SKILL.md +1 -1
  47. package/framework/skills/core/morph-review/SKILL.md +166 -9
  48. package/framework/skills/core/morph-stack-scan/SKILL.md +1 -1
  49. package/framework/skills/core/morph-standards/SKILL.md +1 -1
  50. package/framework/skills/core/morph-uiux/SKILL.md +1 -1
  51. package/framework/standards/PROVENANCE.json +81 -3
  52. package/framework/standards/STANDARDS.json +1483 -839
  53. package/framework/standards/ai-agents/agent-archetypes.md +160 -0
  54. package/framework/standards/ai-agents/agent-session.md +164 -68
  55. package/framework/standards/ai-agents/agent-spec.md +196 -0
  56. package/framework/standards/ai-agents/batching.md +61 -37
  57. package/framework/standards/ai-agents/context-providers.md +97 -24
  58. package/framework/standards/ai-agents/conversational-agent-with-phases.md +239 -0
  59. package/framework/standards/ai-agents/cost-and-budget.md +256 -0
  60. package/framework/standards/ai-agents/durable-workflows-hitl.md +98 -5
  61. package/framework/standards/ai-agents/evals-with-cache.md +289 -0
  62. package/framework/standards/ai-agents/guardrails.md +222 -0
  63. package/framework/standards/ai-agents/llm-runtime-defaults.md +226 -0
  64. package/framework/standards/ai-agents/mcp-server.md +119 -18
  65. package/framework/standards/ai-agents/mcp-tools.md +85 -32
  66. package/framework/standards/ai-agents/media-pipeline.md +352 -0
  67. package/framework/standards/ai-agents/media-video.md +267 -0
  68. package/framework/standards/ai-agents/middleware-patterns.md +39 -5
  69. package/framework/standards/ai-agents/modalities-image-gen.md +354 -105
  70. package/framework/standards/ai-agents/modalities-speech-to-text.md +8 -2
  71. package/framework/standards/ai-agents/modalities-text-to-speech.md +10 -2
  72. package/framework/standards/ai-agents/modalities-vision.md +6 -2
  73. package/framework/standards/ai-agents/multi-agent-patterns.md +61 -5
  74. package/framework/standards/ai-agents/observability-patterns.md +227 -17
  75. package/framework/standards/ai-agents/production.md +38 -9
  76. package/framework/standards/ai-agents/prompt-sources.md +389 -0
  77. package/framework/standards/ai-agents/providers/model-registry.md +174 -39
  78. package/framework/standards/ai-agents/rag-custom-pgvector.md +69 -4
  79. package/framework/standards/ai-agents/service-tier-flex.md +27 -19
  80. package/framework/standards/ai-agents/setup.md +166 -50
  81. package/framework/standards/ai-agents/structured-output.md +34 -3
  82. package/framework/standards/ai-agents/sweet-spot.md +23 -3
  83. package/framework/standards/ai-agents/testing-ai.md +236 -0
  84. package/framework/standards/ai-agents/vector-data-extensions.md +50 -20
  85. package/framework/standards/ai-agents/workflows.md +27 -7
  86. package/framework/standards/frontend/design-system/ai-image-generation.md +12 -0
  87. package/framework/standards/frontend/design-system/ai-video-generation.md +13 -0
  88. package/framework/standards/infrastructure/docker/local-compose-isolation.md +3 -1
  89. package/framework/templates/.idea/morph-templates.xml +92 -0
  90. package/framework/templates/.vscode/morph-templates.code-snippets +186 -0
  91. package/framework/templates/IDE-SNIPPETS.md +262 -262
  92. package/framework/templates/REGISTRY.json +13 -0
  93. package/framework/templates/code/dotnet/abstractions/api-endpoint.cs +7 -7
  94. package/framework/templates/code/dotnet/ai-agents/AgentBootstrap.cs.template +39 -39
  95. package/framework/templates/code/dotnet/ai-agents/EmbeddingService.cs.template +68 -68
  96. package/framework/templates/code/dotnet/ai-agents/ModelRegistry.cs.template +117 -117
  97. package/framework/templates/code/dotnet/ai-agents/PromptRepository.cs.template +1 -1
  98. package/framework/templates/code/dotnet/ai-agents/ResilientToolMiddleware.cs.template +61 -61
  99. package/framework/templates/code/dotnet/ai-agents/VectorSearchTool.cs.template +107 -107
  100. package/framework/templates/code/dotnet/ai-agents/model-registry.json.template +58 -58
  101. package/framework/templates/code/dotnet/contracts/contracts-vsa.cs +281 -281
  102. package/framework/templates/code/dotnet/database/migration.cs +83 -83
  103. package/framework/templates/code/dotnet/feature/endpoint.cs.hbs +21 -21
  104. package/framework/templates/code/dotnet/feature/request.cs.hbs +4 -4
  105. package/framework/templates/code/dotnet/feature/response.cs.hbs +4 -4
  106. package/framework/templates/code/dotnet/feature/validator.cs.hbs +15 -15
  107. package/framework/templates/code/sql/ai-agents/agent-prompts-migration.sql.template +1 -1
  108. package/framework/templates/code/sql/ai-agents/pgvector-embeddings-migration.sql.template +91 -91
  109. package/framework/templates/code/typescript/contracts.ts +167 -167
  110. package/framework/templates/docs/clarifications.md +253 -253
  111. package/framework/templates/docs/schema-analysis.md +119 -119
  112. package/framework/templates/docs/ui-components.md +52 -52
  113. package/framework/templates/docs/ui-design-system.md +76 -76
  114. package/framework/templates/docs/ui-flows.md +167 -167
  115. package/framework/templates/docs/ui-mockups.md +98 -98
  116. package/framework/templates/dotnet/ai-kit/Directory.Build.props +25 -0
  117. package/framework/templates/dotnet/ai-kit/Directory.Packages.props +26 -0
  118. package/framework/templates/dotnet/ai-kit/Morph.AiKit.sln +56 -0
  119. package/framework/templates/dotnet/ai-kit/NuGet.config +12 -0
  120. package/framework/templates/dotnet/ai-kit/README.md +128 -0
  121. package/framework/templates/dotnet/ai-kit/global.json +9 -0
  122. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentApi.cs +65 -0
  123. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactory.cs +289 -0
  124. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactoryOptions.cs +91 -0
  125. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentSpec.cs +91 -0
  126. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentSpecOptions.cs +181 -0
  127. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/AiKitAssemblyMarker.cs +14 -0
  128. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Conversation/ConversationStore.cs +174 -0
  129. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Conversation/IConversationStore.cs +54 -0
  130. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Conversation/InMemoryConversationStore.cs +75 -0
  131. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/CountingChatClient.cs +71 -0
  132. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalAssertion.cs +246 -0
  133. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalCacheMissException.cs +57 -0
  134. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalCacheOptions.cs +78 -0
  135. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalCacheStamp.cs +225 -0
  136. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalFixture.cs +463 -0
  137. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalMode.cs +32 -0
  138. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalQualityEvaluators.cs +49 -0
  139. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalScenario.cs +214 -0
  140. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalSummary.cs +168 -0
  141. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/OfflineChatClient.cs +142 -0
  142. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Evals/ShortPathResponseCache.cs +349 -0
  143. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/IMediaGenerator.cs +42 -0
  144. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/IMediaProvider.cs +77 -0
  145. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaArtifact.cs +28 -0
  146. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaDisclosure.cs +107 -0
  147. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaGenerator.cs +253 -0
  148. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaIdempotencyKey.cs +103 -0
  149. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaJob.cs +259 -0
  150. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaJobId.cs +21 -0
  151. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaJobState.cs +47 -0
  152. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaPricing.cs +102 -0
  153. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaProvenance.cs +44 -0
  154. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaRequest.cs +192 -0
  155. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaResult.cs +94 -0
  156. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaReview.cs +99 -0
  157. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaSeams.cs +97 -0
  158. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MediaStore.cs +133 -0
  159. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/MorphMedia.cs +93 -0
  160. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/Providers/GoogleImageProvider.cs +112 -0
  161. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/Providers/OpenAIImageProvider.cs +288 -0
  162. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Media/Providers/VeoVideoProvider.cs +158 -0
  163. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Middleware/IUsageCostSink.cs +29 -0
  164. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Middleware/UsageCostMiddleware.cs +208 -0
  165. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Middleware/UsageCostRecord.cs +95 -0
  166. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Morph.AiKit.csproj +38 -0
  167. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Observability/MorphOpenTelemetryExtensions.cs +119 -0
  168. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Observability/MorphTelemetryOptions.cs +82 -0
  169. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Providers/IProviderClientFactory.cs +33 -0
  170. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Providers/ModelAlias.cs +267 -0
  171. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Providers/ModelRegistry.cs +474 -0
  172. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Providers/model-registry.v2.json +87 -0
  173. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Rag/DeltaIngest.cs +169 -0
  174. package/framework/templates/dotnet/ai-kit/src/Morph.AiKit/Rag/DeltaPlan.cs +49 -0
  175. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/AgentFactoryTests.cs +495 -0
  176. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/AgentSpecTests.cs +260 -0
  177. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/ConversationStoreTests.cs +405 -0
  178. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/DeltaIngestTests.cs +379 -0
  179. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalAssertionTests.cs +197 -0
  180. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalCacheMissTests.cs +139 -0
  181. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalCacheStampTests.cs +157 -0
  182. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalFailuresTests.cs +178 -0
  183. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalFixtureTests.cs +153 -0
  184. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalRefreshTests.cs +194 -0
  185. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/EvalWorkspace.cs +86 -0
  186. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/KitEvals.cs +213 -0
  187. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Evals/OfflineChatClientTests.cs +95 -0
  188. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeChatClient.cs +225 -0
  189. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeChatClientTests.cs +215 -0
  190. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeClock.cs +33 -0
  191. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeMediaProvider.cs +89 -0
  192. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeProviderClientFactory.cs +55 -0
  193. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeUsageCostSink.cs +60 -0
  194. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/InMemoryMediaStore.cs +131 -0
  195. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaAccessibilityTests.cs +133 -0
  196. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaAliasIsNotAnAgentTests.cs +127 -0
  197. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaDisclosureTests.cs +216 -0
  198. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaGeneratorTests.cs +264 -0
  199. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaIdempotencyKeyTests.cs +148 -0
  200. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaJobStateTests.cs +184 -0
  201. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaReviewTests.cs +89 -0
  202. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/MediaStoreTests.cs +98 -0
  203. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/ModelRegistryTests.cs +451 -0
  204. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Morph.AiKit.Tests.csproj +76 -0
  205. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/SkeletonSmokeTests.cs +33 -0
  206. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/TelemetryTests.cs +261 -0
  207. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/UsageCostMiddlewareTests.cs +374 -0
  208. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/.morph-eval-cache.json +12 -0
  209. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/orcamento.acme.a-resposta-estruturada/1/CF70A7CE27BBD66A/contents.data +13 -0
  210. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/orcamento.acme.a-resposta-estruturada/1/CF70A7CE27BBD66A/entry.json +7 -0
  211. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/triagem.acme.a-saudacao/1/19F631228C6E00BA/contents.data +13 -0
  212. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/triagem.acme.a-saudacao/1/19F631228C6E00BA/entry.json +7 -0
  213. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/triagem.acme.b-escalonamento/1/A24A7C9BDD8239D8/contents.data +13 -0
  214. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/triagem.acme.b-escalonamento/1/A24A7C9BDD8239D8/entry.json +7 -0
  215. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/triagem.globex.a-saudacao/1/E38CD37DF003EDB7/contents.data +13 -0
  216. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-cache/cache/triagem.globex.a-saudacao/1/E38CD37DF003EDB7/entry.json +7 -0
  217. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-datasets/orcamento/acme/a-resposta-estruturada.json +24 -0
  218. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-datasets/triagem/acme/a-saudacao.json +23 -0
  219. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-datasets/triagem/acme/b-escalonamento.json +24 -0
  220. package/framework/templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/eval-datasets/triagem/globex/a-saudacao.json +23 -0
  221. package/framework/templates/feature/decisions.md +122 -122
  222. package/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs +43 -43
  223. package/framework/templates/frontend/nextjs/client-component.tsx.hbs +26 -26
  224. package/framework/templates/frontend/nextjs/env.mjs.hbs +32 -32
  225. package/framework/templates/frontend/nextjs/feature-form.tsx.hbs +56 -56
  226. package/framework/templates/frontend/nextjs/page.tsx.hbs +22 -22
  227. package/framework/templates/frontend/nextjs/tsconfig.json.hbs +26 -26
  228. package/framework/templates/frontend/nextjs/use-feature.ts.hbs +54 -54
  229. package/framework/templates/infrastructure/docker/Dockerfile.template +58 -58
  230. package/framework/templates/infrastructure/docker/dockerfile-api.dockerfile +38 -38
  231. package/framework/templates/infrastructure/docker/dockerfile-web.dockerfile +48 -48
  232. package/framework/templates/infrastructure/github/README.md +56 -56
  233. package/framework/templates/infrastructure/github/actions/docker-build-push/action.yml.hbs +45 -45
  234. package/framework/templates/infrastructure/github/actions/health-check/action.yml.hbs +27 -27
  235. package/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs +59 -59
  236. package/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs +39 -39
  237. package/framework/templates/integrations/asaas-client.cs +387 -387
  238. package/framework/templates/integrations/asaas-webhook.cs +351 -351
  239. package/framework/templates/meta-prompts/fusion/fusion-agent.md +76 -76
  240. package/framework/templates/meta-prompts/fusion/fusion-aggregator.md +100 -100
  241. package/framework/templates/meta-prompts/validators/pre-commit-validator.md +95 -95
  242. package/framework/templates/project/validate.js +120 -120
  243. package/framework/templates/state.template.json +17 -17
  244. package/framework/templates/ui/design-system.css +226 -226
  245. package/package.json +3 -3
  246. package/src/commands/dashboard/dashboard.js +53 -53
  247. package/src/commands/e2e/e2e.js +15 -2
  248. package/src/commands/index.js +13 -13
  249. package/src/commands/project/checkpoint.js +209 -209
  250. package/src/commands/project/doctor.js +140 -5
  251. package/src/commands/project/update.js +469 -153
  252. package/src/commands/project/worktree.js +8 -1
  253. package/src/commands/state/advance.js +24 -2
  254. package/src/commands/state/approve.js +33 -1
  255. package/src/commands/state/create.js +72 -11
  256. package/src/commands/state/finish.js +333 -21
  257. package/src/commands/state/gate-check.js +190 -6
  258. package/src/commands/state/score.js +36 -1
  259. package/src/commands/validation/verify.js +134 -25
  260. package/src/core/state/phase-state-machine.js +197 -197
  261. package/src/core/state/state-manager.js +9 -1
  262. package/src/core/templates/template-renderer.js +477 -477
  263. package/src/dashboard/app/components/DetailPanel.jsx +11 -11
  264. package/src/dashboard/app/components/FlowGraph.jsx +17 -17
  265. package/src/dashboard/app/components/SearchFilter.jsx +22 -22
  266. package/src/dashboard/app/hooks/useDetailPanel.js +15 -15
  267. package/src/dashboard/app/main.jsx +13 -13
  268. package/src/dashboard/app/pages/AgentMap.jsx +370 -370
  269. package/src/dashboard/app/pages/PhasePipeline.jsx +408 -408
  270. package/src/dashboard/app/pages/RulesMap.jsx +273 -273
  271. package/src/dashboard/app/pages/SkillsLibrary.jsx +366 -366
  272. package/src/dashboard/app/pages/Standards.jsx +332 -332
  273. package/src/dashboard/app/styles/index.css +47 -47
  274. package/src/dashboard/index.html +12 -12
  275. package/src/dashboard/package.json +24 -24
  276. package/src/dashboard/scanner/phases-scanner.js +15 -15
  277. package/src/dashboard/scanner/rubrics-scanner.js +12 -12
  278. package/src/dashboard/scanner/rules-scanner.js +37 -37
  279. package/src/dashboard/scanner/skills-scanner.js +43 -43
  280. package/src/dashboard/scanner/squads-scanner.js +13 -13
  281. package/src/dashboard/vite-plugin-morph-data.js +17 -17
  282. package/src/dashboard/vite.config.js +24 -24
  283. package/src/lib/ai/ai-checks.js +182 -0
  284. package/src/lib/ai/ai-project-scan.js +347 -0
  285. package/src/lib/ai/code-audit.js +181 -0
  286. package/src/lib/ai/comment-stripper.js +184 -0
  287. package/src/lib/ai/pin-drift.js +138 -0
  288. package/src/lib/ai/registry-audit.js +285 -0
  289. package/src/lib/detectors/design-system-detector.js +188 -188
  290. package/src/lib/detectors/index.js +217 -217
  291. package/src/lib/e2e/compose-env.js +50 -4
  292. package/src/lib/evaluator-report.js +269 -15
  293. package/src/lib/generators/design-system-generator.js +508 -508
  294. package/src/lib/generators/settings-generator.js +209 -209
  295. package/src/lib/git/default-branch.js +92 -4
  296. package/src/lib/hooks/hook-executor.js +167 -167
  297. package/src/lib/installers/effects.js +193 -0
  298. package/src/lib/installers/mcp-installer.js +719 -719
  299. package/src/lib/installers/templates-reconcile.js +3 -3
  300. package/src/lib/risk-detector.js +284 -0
  301. package/src/lib/standards/verified-against.js +276 -0
  302. package/src/lib/tasks/eval-node.js +485 -0
  303. package/src/lib/tasks/linux-runner.js +297 -0
  304. package/src/lib/tasks/task-classifier.js +30 -30
  305. package/src/lib/tasks/task-parser.js +209 -209
  306. package/src/lib/tasks/test-nodes.js +486 -0
  307. package/src/lib/tasks/test-runner.js +410 -33
  308. package/src/lib/validators/checkpoint-persistence.js +39 -39
  309. package/src/lib/validators/css/css-validator.js +340 -340
  310. package/src/lib/validators/shared/emit-validator-dispatch.js +14 -14
  311. package/src/lib/validators/shared/issue-counter.js +14 -14
  312. package/src/lib/validators/verify-runner.js +583 -28
  313. package/src/lib/worktree/docker-audit.js +287 -0
  314. package/src/lib/worktree/env-allocator.js +24 -0
  315. package/src/lib/worktree/worktree-audit.js +30 -1
  316. package/src/scripts/setup-infra.js +24 -11
  317. package/src/utils/agent-id-mapper.js +11 -11
  318. package/src/utils/agents-installer.js +18 -8
  319. package/src/utils/claude-md-injector.js +10 -5
  320. package/src/utils/claude-settings-manager.js +300 -300
  321. package/src/utils/file-copier.js +11 -4
  322. package/src/utils/hooks-installer.js +29 -26
  323. package/src/utils/skills-installer.js +36 -29
  324. package/src/utils/version-checker.js +68 -3
  325. package/framework/standards/ai-agents/prompts-in-db.md +0 -214
@@ -1,408 +1,408 @@
1
- import { useCallback, useMemo } from 'react';
2
- import { Handle, Position } from '@xyflow/react';
3
- import morphData from 'virtual:morph-data';
4
- import FlowGraph from '../components/FlowGraph.jsx';
5
- import DetailPanel from '../components/DetailPanel.jsx';
6
- import { useDetailPanel } from '../hooks/useDetailPanel.js';
7
-
8
- // Phase color palette by phase id
9
- const PHASE_COLORS = {
10
- proposal: { bg: '#166534', border: '#22c55e', text: '#bbf7d0' },
11
- uiux: { bg: '#854d0e', border: '#f59e0b', text: '#fef3c7' },
12
- plan: { bg: '#7c2d12', border: '#fb923c', text: '#fed7aa' },
13
- implement: { bg: '#0e7490', border: '#22d3ee', text: '#cffafe' },
14
- review: { bg: '#6d28d9', border: '#a78bfa', text: '#ede9fe' },
15
- };
16
-
17
- const GATED_PHASES = new Set(['uiux', 'plan', 'review']);
18
-
19
- // Gate node: small gold square with "G" label
20
- function GateNode({ data }) {
21
- return (
22
- <div
23
- title={data.label}
24
- className="flex items-center justify-center rounded-sm select-none cursor-default"
25
- style={{
26
- width: 32,
27
- height: 32,
28
- background: '#78350f',
29
- border: '2px solid #f59e0b',
30
- boxShadow: '0 0 8px #f59e0b44',
31
- color: '#fef3c7',
32
- fontWeight: 700,
33
- fontSize: 12,
34
- }}
35
- >
36
- <Handle type="target" position={Position.Left} style={{ background: '#f59e0b', width: 7, height: 7 }} />
37
- G
38
- <Handle type="source" position={Position.Right} style={{ background: '#f59e0b', width: 7, height: 7 }} />
39
- </div>
40
- );
41
- }
42
-
43
- // Phase node: colored block with name and optional/index badge
44
- function PhaseNode({ data }) {
45
- const c = PHASE_COLORS[data.phaseId] || PHASE_COLORS.sync;
46
- const isOptional = data.optional;
47
-
48
- return (
49
- <div
50
- className="rounded-lg px-4 py-3 min-w-[140px] select-none cursor-pointer"
51
- style={{
52
- background: c.bg,
53
- border: `2px ${isOptional ? 'dashed' : 'solid'} ${c.border}`,
54
- boxShadow: `0 0 10px ${c.border}33`,
55
- }}
56
- >
57
- <Handle type="target" position={Position.Left} style={{ background: c.border, width: 8, height: 8 }} />
58
-
59
- <div className="text-white text-sm font-bold leading-tight">{data.label}</div>
60
- <div className="mt-1 text-[10px] font-medium" style={{ color: c.text }}>
61
- {isOptional ? 'optional' : `index: ${data.index}`}
62
- </div>
63
-
64
- <Handle type="source" position={Position.Right} style={{ background: c.border, width: 8, height: 8 }} />
65
- </div>
66
- );
67
- }
68
-
69
- const nodeTypes = { phaseNode: PhaseNode, gateNode: GateNode };
70
-
71
- // Build nodes + edges with manual horizontal layout
72
- function buildPipelineGraph(phases) {
73
- const nodes = [];
74
- const edges = [];
75
-
76
- // Layout constants
77
- const PHASE_W = 150;
78
- const PHASE_H = 68;
79
- const GATE_W = 32;
80
- const GATE_H = 32;
81
- const GAP = 60; // gap between a phase and the next gate / phase
82
- const Y_CENTER = 0;
83
-
84
- // Pre-compute x positions for each phase and its preceding gate (if gated)
85
- // Walk phases left to right, tracking current x cursor
86
- let cursorX = 0;
87
- const phaseLayout = []; // { phase, x, gateX? }
88
-
89
- for (const phase of phases) {
90
- if (GATED_PHASES.has(phase.id)) {
91
- // Insert gate before this phase
92
- const gateX = cursorX;
93
- cursorX += GATE_W + GAP;
94
- phaseLayout.push({ phase, x: cursorX, gateX });
95
- } else {
96
- phaseLayout.push({ phase, x: cursorX, gateX: null });
97
- }
98
- cursorX += PHASE_W + GAP;
99
- }
100
-
101
- // Build nodes
102
- for (const { phase, x, gateX } of phaseLayout) {
103
- const c = PHASE_COLORS[phase.id] || PHASE_COLORS.sync;
104
-
105
- // Gate node (if any)
106
- if (gateX !== null) {
107
- nodes.push({
108
- id: `gate-${phase.id}`,
109
- type: 'gateNode',
110
- data: { label: `Gate: ${phase.displayName}` },
111
- position: { x: gateX, y: Y_CENTER + (PHASE_H - GATE_H) / 2 },
112
- });
113
- }
114
-
115
- // Phase node
116
- nodes.push({
117
- id: phase.id,
118
- type: 'phaseNode',
119
- data: {
120
- label: phase.displayName,
121
- phaseId: phase.id,
122
- optional: phase.optional,
123
- index: phase.index,
124
- color: c.border,
125
- phaseRef: phase,
126
- },
127
- position: { x, y: Y_CENTER },
128
- });
129
- }
130
-
131
- // Build edges: chain gates and phases in sequence
132
- // sequence: ph0 → gate-ph1 → ph1 → gate-ph2 → ph2 → ...
133
- for (let i = 0; i < phaseLayout.length; i++) {
134
- const curr = phaseLayout[i];
135
- const next = phaseLayout[i + 1];
136
-
137
- if (!next) continue;
138
-
139
- const sourceId = curr.phase.id;
140
-
141
- if (next.gateX !== null) {
142
- // phase → gate → next-phase (two edges)
143
- edges.push({
144
- id: `edge-${sourceId}-gate-${next.phase.id}`,
145
- source: sourceId,
146
- target: `gate-${next.phase.id}`,
147
- type: 'smoothstep',
148
- style: { stroke: '#475569', strokeWidth: 1.8 },
149
- });
150
- edges.push({
151
- id: `edge-gate-${next.phase.id}-${next.phase.id}`,
152
- source: `gate-${next.phase.id}`,
153
- target: next.phase.id,
154
- type: 'smoothstep',
155
- style: { stroke: '#475569', strokeWidth: 1.8 },
156
- });
157
- } else {
158
- // phase → phase (no gate)
159
- edges.push({
160
- id: `edge-${sourceId}-${next.phase.id}`,
161
- source: sourceId,
162
- target: next.phase.id,
163
- type: 'smoothstep',
164
- style: { stroke: '#475569', strokeWidth: 1.8 },
165
- });
166
- }
167
- }
168
-
169
- return { nodes, edges };
170
- }
171
-
172
- // Detail panel content for a phase
173
- function PhaseDetail({ phase, agents }) {
174
- const c = PHASE_COLORS[phase.id] || PHASE_COLORS.sync;
175
- const isGated = GATED_PHASES.has(phase.id);
176
-
177
- // Agents active in this phase
178
- const activeAgents = agents.filter(
179
- (a) => a.activePhases?.includes(phase.id) || a.activePhases?.includes('*')
180
- );
181
-
182
- return (
183
- <div className="text-sm text-gray-200 space-y-5">
184
- {/* Phase badge + optional/gated indicators */}
185
- <div className="flex flex-wrap items-center gap-2">
186
- <span
187
- className="px-2 py-0.5 rounded text-xs font-bold"
188
- style={{ background: c.bg, color: c.text, border: `1px solid ${c.border}` }}
189
- >
190
- Phase {phase.index}
191
- </span>
192
- {phase.optional && (
193
- <span className="px-2 py-0.5 rounded text-xs bg-gray-800 border border-dashed border-gray-600 text-gray-400">
194
- optional
195
- </span>
196
- )}
197
- {isGated && (
198
- <span className="px-2 py-0.5 rounded text-xs bg-yellow-900/50 border border-yellow-600 text-yellow-300">
199
- approval gate
200
- </span>
201
- )}
202
- {phase.folder && (
203
- <span className="px-2 py-0.5 rounded text-xs font-mono bg-gray-800 border border-gray-700 text-gray-400">
204
- {phase.folder}
205
- </span>
206
- )}
207
- </div>
208
-
209
- {/* Goals */}
210
- {phase.goals?.length > 0 && (
211
- <div>
212
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Goals</p>
213
- <ul className="space-y-1.5">
214
- {phase.goals.map((g, i) => (
215
- <li key={i} className="flex gap-2 text-xs text-gray-300">
216
- <span className="text-gray-600 flex-shrink-0">•</span>
217
- {g}
218
- </li>
219
- ))}
220
- </ul>
221
- </div>
222
- )}
223
-
224
- {/* Required outputs */}
225
- {phase.requiredOutputs?.length > 0 && (
226
- <div>
227
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Required Outputs</p>
228
- <div className="flex flex-wrap gap-1">
229
- {phase.requiredOutputs.map((o) => (
230
- <span key={o} className="px-2 py-0.5 rounded text-xs bg-green-900/50 border border-green-700 text-green-300 font-mono">
231
- {o}
232
- </span>
233
- ))}
234
- </div>
235
- </div>
236
- )}
237
-
238
- {/* Optional outputs */}
239
- {phase.optionalOutputs?.length > 0 && (
240
- <div>
241
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Optional Outputs</p>
242
- <div className="flex flex-wrap gap-1">
243
- {phase.optionalOutputs.map((o) => (
244
- <span key={o} className="px-2 py-0.5 rounded text-xs bg-gray-800 border border-gray-700 text-gray-400 font-mono">
245
- {o}
246
- </span>
247
- ))}
248
- </div>
249
- </div>
250
- )}
251
-
252
- {/* Active agents */}
253
- {activeAgents.length > 0 && (
254
- <div>
255
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Active Agents ({activeAgents.length})</p>
256
- <div className="space-y-1">
257
- {activeAgents.map((a) => (
258
- <div key={a.id} className="flex items-center justify-between text-xs px-2 py-1 bg-gray-800 rounded">
259
- <span className="text-gray-200 font-medium truncate">{a.title}</span>
260
- <span className="text-gray-500 ml-2 flex-shrink-0">T{a.tier}</span>
261
- </div>
262
- ))}
263
- </div>
264
- </div>
265
- )}
266
-
267
- {/* Required skills */}
268
- {phase.requiredSkills?.length > 0 && (
269
- <div>
270
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Required Skills</p>
271
- <div className="space-y-1">
272
- {phase.requiredSkills.map((s, i) => (
273
- <div key={i} className="flex items-start gap-2 text-xs">
274
- <span className="px-1.5 py-0.5 rounded bg-pink-900/50 border border-pink-700 text-pink-300 font-mono flex-shrink-0">
275
- {s.trigger}
276
- </span>
277
- <span className="text-gray-300 font-mono">{s.skill}</span>
278
- </div>
279
- ))}
280
- </div>
281
- </div>
282
- )}
283
-
284
- {/* Recommended MCPs */}
285
- {phase.recommendedMCPs?.length > 0 && (
286
- <div>
287
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Recommended MCPs</p>
288
- <div className="flex flex-wrap gap-1">
289
- {phase.recommendedMCPs.map((m) => (
290
- <span key={m} className="px-2 py-0.5 rounded text-xs bg-blue-900/50 border border-blue-700 text-blue-300 font-mono">
291
- {m}
292
- </span>
293
- ))}
294
- </div>
295
- </div>
296
- )}
297
-
298
- {/* Pause points */}
299
- {phase.pausePoints?.length > 0 && (
300
- <div>
301
- <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Pause Points</p>
302
- <div className="space-y-1">
303
- {phase.pausePoints.map((pp) => (
304
- <div key={pp.id} className="flex items-center gap-2 text-xs px-2 py-1.5 bg-yellow-900/20 border border-yellow-700/50 rounded">
305
- <span className="text-yellow-400 flex-shrink-0">&#x1F512;</span>
306
- <span className="text-yellow-200">{pp.label}</span>
307
- </div>
308
- ))}
309
- </div>
310
- </div>
311
- )}
312
- </div>
313
- );
314
- }
315
-
316
- export default function PhasePipeline() {
317
- const { phases, agents } = morphData;
318
- const { panel, openPanel, closePanel } = useDetailPanel();
319
-
320
- const { nodes, edges } = useMemo(() => buildPipelineGraph(phases.list), [phases.list]);
321
-
322
- const handleNodeClick = useCallback(
323
- (_event, node) => {
324
- if (node.type === 'gateNode') {
325
- // Extract phase id from gate id ("gate-design" → "design")
326
- const phaseId = node.id.replace('gate-', '');
327
- const phase = phases.list.find((p) => p.id === phaseId);
328
- if (phase) {
329
- openPanel(`Gate: ${phase.displayName}`, (
330
- <div className="text-sm text-gray-300 space-y-3">
331
- <p className="text-yellow-300 text-xs">This gate requires explicit approval before the phase can begin.</p>
332
- <p className="text-gray-400 text-xs">Gate ID: <span className="font-mono text-gray-300">{phaseId}</span></p>
333
- </div>
334
- ));
335
- }
336
- return;
337
- }
338
-
339
- if (node.type === 'phaseNode') {
340
- const phase = node.data.phaseRef;
341
- if (phase) {
342
- openPanel(phase.displayName, (
343
- <PhaseDetail phase={phase} agents={agents.list} />
344
- ));
345
- }
346
- }
347
- },
348
- [openPanel, phases.list, agents.list]
349
- );
350
-
351
- return (
352
- <div className="flex flex-col h-full">
353
- {/* Header */}
354
- <div className="px-6 py-4 border-b border-gray-800 flex-shrink-0">
355
- <h1 className="text-white text-xl font-bold">Phase Pipeline</h1>
356
- <p className="text-gray-400 text-sm mt-0.5">
357
- Horizontal workflow of the 7 morph-spec phases. Gold gates mark required approval points. Dashed borders indicate optional phases.
358
- </p>
359
- </div>
360
-
361
- {/* Flow graph */}
362
- <div className="flex-1 relative">
363
- <FlowGraph
364
- nodes={nodes}
365
- edges={edges}
366
- nodeTypes={nodeTypes}
367
- onNodeClick={handleNodeClick}
368
- fitView
369
- />
370
-
371
- {/* Legend */}
372
- <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">
373
- <p className="text-gray-400 font-semibold uppercase tracking-wide text-[10px] mb-2">Legend</p>
374
- <div className="flex items-center gap-2">
375
- <span className="inline-block w-10 h-4 rounded-sm" style={{ background: '#166534', border: '2px solid #22c55e' }} />
376
- <span className="text-gray-300">Phase (solid = required)</span>
377
- </div>
378
- <div className="flex items-center gap-2">
379
- <span className="inline-block w-10 h-4 rounded-sm" style={{ background: '#854d0e', border: '2px dashed #f59e0b' }} />
380
- <span className="text-gray-300">Phase (dashed = optional)</span>
381
- </div>
382
- <div className="flex items-center gap-2">
383
- <span
384
- className="inline-flex items-center justify-center rounded-sm text-[10px] font-bold flex-shrink-0"
385
- style={{ width: 20, height: 20, background: '#78350f', border: '2px solid #f59e0b', color: '#fef3c7' }}
386
- >
387
- G
388
- </span>
389
- <span className="text-gray-300">Approval Gate</span>
390
- </div>
391
- <div className="flex items-center gap-2">
392
- <span className="inline-block w-6 border-t-2 border-gray-500" />
393
- <span className="text-gray-400">Sequence</span>
394
- </div>
395
- </div>
396
-
397
- {/* Phase count badge */}
398
- <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">
399
- {phases.list.length} phases · {phases.list.filter((p) => GATED_PHASES.has(p.id)).length} gates
400
- </div>
401
- </div>
402
-
403
- <DetailPanel open={panel.open} title={panel.title} onClose={closePanel}>
404
- {panel.content}
405
- </DetailPanel>
406
- </div>
407
- );
408
- }
1
+ import { useCallback, useMemo } from 'react';
2
+ import { Handle, Position } from '@xyflow/react';
3
+ import morphData from 'virtual:morph-data';
4
+ import FlowGraph from '../components/FlowGraph.jsx';
5
+ import DetailPanel from '../components/DetailPanel.jsx';
6
+ import { useDetailPanel } from '../hooks/useDetailPanel.js';
7
+
8
+ // Phase color palette by phase id
9
+ const PHASE_COLORS = {
10
+ proposal: { bg: '#166534', border: '#22c55e', text: '#bbf7d0' },
11
+ uiux: { bg: '#854d0e', border: '#f59e0b', text: '#fef3c7' },
12
+ plan: { bg: '#7c2d12', border: '#fb923c', text: '#fed7aa' },
13
+ implement: { bg: '#0e7490', border: '#22d3ee', text: '#cffafe' },
14
+ review: { bg: '#6d28d9', border: '#a78bfa', text: '#ede9fe' },
15
+ };
16
+
17
+ const GATED_PHASES = new Set(['uiux', 'plan', 'review']);
18
+
19
+ // Gate node: small gold square with "G" label
20
+ function GateNode({ data }) {
21
+ return (
22
+ <div
23
+ title={data.label}
24
+ className="flex items-center justify-center rounded-sm select-none cursor-default"
25
+ style={{
26
+ width: 32,
27
+ height: 32,
28
+ background: '#78350f',
29
+ border: '2px solid #f59e0b',
30
+ boxShadow: '0 0 8px #f59e0b44',
31
+ color: '#fef3c7',
32
+ fontWeight: 700,
33
+ fontSize: 12,
34
+ }}
35
+ >
36
+ <Handle type="target" position={Position.Left} style={{ background: '#f59e0b', width: 7, height: 7 }} />
37
+ G
38
+ <Handle type="source" position={Position.Right} style={{ background: '#f59e0b', width: 7, height: 7 }} />
39
+ </div>
40
+ );
41
+ }
42
+
43
+ // Phase node: colored block with name and optional/index badge
44
+ function PhaseNode({ data }) {
45
+ const c = PHASE_COLORS[data.phaseId] || PHASE_COLORS.sync;
46
+ const isOptional = data.optional;
47
+
48
+ return (
49
+ <div
50
+ className="rounded-lg px-4 py-3 min-w-[140px] select-none cursor-pointer"
51
+ style={{
52
+ background: c.bg,
53
+ border: `2px ${isOptional ? 'dashed' : 'solid'} ${c.border}`,
54
+ boxShadow: `0 0 10px ${c.border}33`,
55
+ }}
56
+ >
57
+ <Handle type="target" position={Position.Left} style={{ background: c.border, width: 8, height: 8 }} />
58
+
59
+ <div className="text-white text-sm font-bold leading-tight">{data.label}</div>
60
+ <div className="mt-1 text-[10px] font-medium" style={{ color: c.text }}>
61
+ {isOptional ? 'optional' : `index: ${data.index}`}
62
+ </div>
63
+
64
+ <Handle type="source" position={Position.Right} style={{ background: c.border, width: 8, height: 8 }} />
65
+ </div>
66
+ );
67
+ }
68
+
69
+ const nodeTypes = { phaseNode: PhaseNode, gateNode: GateNode };
70
+
71
+ // Build nodes + edges with manual horizontal layout
72
+ function buildPipelineGraph(phases) {
73
+ const nodes = [];
74
+ const edges = [];
75
+
76
+ // Layout constants
77
+ const PHASE_W = 150;
78
+ const PHASE_H = 68;
79
+ const GATE_W = 32;
80
+ const GATE_H = 32;
81
+ const GAP = 60; // gap between a phase and the next gate / phase
82
+ const Y_CENTER = 0;
83
+
84
+ // Pre-compute x positions for each phase and its preceding gate (if gated)
85
+ // Walk phases left to right, tracking current x cursor
86
+ let cursorX = 0;
87
+ const phaseLayout = []; // { phase, x, gateX? }
88
+
89
+ for (const phase of phases) {
90
+ if (GATED_PHASES.has(phase.id)) {
91
+ // Insert gate before this phase
92
+ const gateX = cursorX;
93
+ cursorX += GATE_W + GAP;
94
+ phaseLayout.push({ phase, x: cursorX, gateX });
95
+ } else {
96
+ phaseLayout.push({ phase, x: cursorX, gateX: null });
97
+ }
98
+ cursorX += PHASE_W + GAP;
99
+ }
100
+
101
+ // Build nodes
102
+ for (const { phase, x, gateX } of phaseLayout) {
103
+ const c = PHASE_COLORS[phase.id] || PHASE_COLORS.sync;
104
+
105
+ // Gate node (if any)
106
+ if (gateX !== null) {
107
+ nodes.push({
108
+ id: `gate-${phase.id}`,
109
+ type: 'gateNode',
110
+ data: { label: `Gate: ${phase.displayName}` },
111
+ position: { x: gateX, y: Y_CENTER + (PHASE_H - GATE_H) / 2 },
112
+ });
113
+ }
114
+
115
+ // Phase node
116
+ nodes.push({
117
+ id: phase.id,
118
+ type: 'phaseNode',
119
+ data: {
120
+ label: phase.displayName,
121
+ phaseId: phase.id,
122
+ optional: phase.optional,
123
+ index: phase.index,
124
+ color: c.border,
125
+ phaseRef: phase,
126
+ },
127
+ position: { x, y: Y_CENTER },
128
+ });
129
+ }
130
+
131
+ // Build edges: chain gates and phases in sequence
132
+ // sequence: ph0 → gate-ph1 → ph1 → gate-ph2 → ph2 → ...
133
+ for (let i = 0; i < phaseLayout.length; i++) {
134
+ const curr = phaseLayout[i];
135
+ const next = phaseLayout[i + 1];
136
+
137
+ if (!next) continue;
138
+
139
+ const sourceId = curr.phase.id;
140
+
141
+ if (next.gateX !== null) {
142
+ // phase → gate → next-phase (two edges)
143
+ edges.push({
144
+ id: `edge-${sourceId}-gate-${next.phase.id}`,
145
+ source: sourceId,
146
+ target: `gate-${next.phase.id}`,
147
+ type: 'smoothstep',
148
+ style: { stroke: '#475569', strokeWidth: 1.8 },
149
+ });
150
+ edges.push({
151
+ id: `edge-gate-${next.phase.id}-${next.phase.id}`,
152
+ source: `gate-${next.phase.id}`,
153
+ target: next.phase.id,
154
+ type: 'smoothstep',
155
+ style: { stroke: '#475569', strokeWidth: 1.8 },
156
+ });
157
+ } else {
158
+ // phase → phase (no gate)
159
+ edges.push({
160
+ id: `edge-${sourceId}-${next.phase.id}`,
161
+ source: sourceId,
162
+ target: next.phase.id,
163
+ type: 'smoothstep',
164
+ style: { stroke: '#475569', strokeWidth: 1.8 },
165
+ });
166
+ }
167
+ }
168
+
169
+ return { nodes, edges };
170
+ }
171
+
172
+ // Detail panel content for a phase
173
+ function PhaseDetail({ phase, agents }) {
174
+ const c = PHASE_COLORS[phase.id] || PHASE_COLORS.sync;
175
+ const isGated = GATED_PHASES.has(phase.id);
176
+
177
+ // Agents active in this phase
178
+ const activeAgents = agents.filter(
179
+ (a) => a.activePhases?.includes(phase.id) || a.activePhases?.includes('*')
180
+ );
181
+
182
+ return (
183
+ <div className="text-sm text-gray-200 space-y-5">
184
+ {/* Phase badge + optional/gated indicators */}
185
+ <div className="flex flex-wrap items-center gap-2">
186
+ <span
187
+ className="px-2 py-0.5 rounded text-xs font-bold"
188
+ style={{ background: c.bg, color: c.text, border: `1px solid ${c.border}` }}
189
+ >
190
+ Phase {phase.index}
191
+ </span>
192
+ {phase.optional && (
193
+ <span className="px-2 py-0.5 rounded text-xs bg-gray-800 border border-dashed border-gray-600 text-gray-400">
194
+ optional
195
+ </span>
196
+ )}
197
+ {isGated && (
198
+ <span className="px-2 py-0.5 rounded text-xs bg-yellow-900/50 border border-yellow-600 text-yellow-300">
199
+ approval gate
200
+ </span>
201
+ )}
202
+ {phase.folder && (
203
+ <span className="px-2 py-0.5 rounded text-xs font-mono bg-gray-800 border border-gray-700 text-gray-400">
204
+ {phase.folder}
205
+ </span>
206
+ )}
207
+ </div>
208
+
209
+ {/* Goals */}
210
+ {phase.goals?.length > 0 && (
211
+ <div>
212
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Goals</p>
213
+ <ul className="space-y-1.5">
214
+ {phase.goals.map((g, i) => (
215
+ <li key={i} className="flex gap-2 text-xs text-gray-300">
216
+ <span className="text-gray-600 flex-shrink-0">•</span>
217
+ {g}
218
+ </li>
219
+ ))}
220
+ </ul>
221
+ </div>
222
+ )}
223
+
224
+ {/* Required outputs */}
225
+ {phase.requiredOutputs?.length > 0 && (
226
+ <div>
227
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Required Outputs</p>
228
+ <div className="flex flex-wrap gap-1">
229
+ {phase.requiredOutputs.map((o) => (
230
+ <span key={o} className="px-2 py-0.5 rounded text-xs bg-green-900/50 border border-green-700 text-green-300 font-mono">
231
+ {o}
232
+ </span>
233
+ ))}
234
+ </div>
235
+ </div>
236
+ )}
237
+
238
+ {/* Optional outputs */}
239
+ {phase.optionalOutputs?.length > 0 && (
240
+ <div>
241
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Optional Outputs</p>
242
+ <div className="flex flex-wrap gap-1">
243
+ {phase.optionalOutputs.map((o) => (
244
+ <span key={o} className="px-2 py-0.5 rounded text-xs bg-gray-800 border border-gray-700 text-gray-400 font-mono">
245
+ {o}
246
+ </span>
247
+ ))}
248
+ </div>
249
+ </div>
250
+ )}
251
+
252
+ {/* Active agents */}
253
+ {activeAgents.length > 0 && (
254
+ <div>
255
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Active Agents ({activeAgents.length})</p>
256
+ <div className="space-y-1">
257
+ {activeAgents.map((a) => (
258
+ <div key={a.id} className="flex items-center justify-between text-xs px-2 py-1 bg-gray-800 rounded">
259
+ <span className="text-gray-200 font-medium truncate">{a.title}</span>
260
+ <span className="text-gray-500 ml-2 flex-shrink-0">T{a.tier}</span>
261
+ </div>
262
+ ))}
263
+ </div>
264
+ </div>
265
+ )}
266
+
267
+ {/* Required skills */}
268
+ {phase.requiredSkills?.length > 0 && (
269
+ <div>
270
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Required Skills</p>
271
+ <div className="space-y-1">
272
+ {phase.requiredSkills.map((s, i) => (
273
+ <div key={i} className="flex items-start gap-2 text-xs">
274
+ <span className="px-1.5 py-0.5 rounded bg-pink-900/50 border border-pink-700 text-pink-300 font-mono flex-shrink-0">
275
+ {s.trigger}
276
+ </span>
277
+ <span className="text-gray-300 font-mono">{s.skill}</span>
278
+ </div>
279
+ ))}
280
+ </div>
281
+ </div>
282
+ )}
283
+
284
+ {/* Recommended MCPs */}
285
+ {phase.recommendedMCPs?.length > 0 && (
286
+ <div>
287
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Recommended MCPs</p>
288
+ <div className="flex flex-wrap gap-1">
289
+ {phase.recommendedMCPs.map((m) => (
290
+ <span key={m} className="px-2 py-0.5 rounded text-xs bg-blue-900/50 border border-blue-700 text-blue-300 font-mono">
291
+ {m}
292
+ </span>
293
+ ))}
294
+ </div>
295
+ </div>
296
+ )}
297
+
298
+ {/* Pause points */}
299
+ {phase.pausePoints?.length > 0 && (
300
+ <div>
301
+ <p className="text-gray-500 text-xs uppercase tracking-wide mb-2">Pause Points</p>
302
+ <div className="space-y-1">
303
+ {phase.pausePoints.map((pp) => (
304
+ <div key={pp.id} className="flex items-center gap-2 text-xs px-2 py-1.5 bg-yellow-900/20 border border-yellow-700/50 rounded">
305
+ <span className="text-yellow-400 flex-shrink-0">&#x1F512;</span>
306
+ <span className="text-yellow-200">{pp.label}</span>
307
+ </div>
308
+ ))}
309
+ </div>
310
+ </div>
311
+ )}
312
+ </div>
313
+ );
314
+ }
315
+
316
+ export default function PhasePipeline() {
317
+ const { phases, agents } = morphData;
318
+ const { panel, openPanel, closePanel } = useDetailPanel();
319
+
320
+ const { nodes, edges } = useMemo(() => buildPipelineGraph(phases.list), [phases.list]);
321
+
322
+ const handleNodeClick = useCallback(
323
+ (_event, node) => {
324
+ if (node.type === 'gateNode') {
325
+ // Extract phase id from gate id ("gate-design" → "design")
326
+ const phaseId = node.id.replace('gate-', '');
327
+ const phase = phases.list.find((p) => p.id === phaseId);
328
+ if (phase) {
329
+ openPanel(`Gate: ${phase.displayName}`, (
330
+ <div className="text-sm text-gray-300 space-y-3">
331
+ <p className="text-yellow-300 text-xs">This gate requires explicit approval before the phase can begin.</p>
332
+ <p className="text-gray-400 text-xs">Gate ID: <span className="font-mono text-gray-300">{phaseId}</span></p>
333
+ </div>
334
+ ));
335
+ }
336
+ return;
337
+ }
338
+
339
+ if (node.type === 'phaseNode') {
340
+ const phase = node.data.phaseRef;
341
+ if (phase) {
342
+ openPanel(phase.displayName, (
343
+ <PhaseDetail phase={phase} agents={agents.list} />
344
+ ));
345
+ }
346
+ }
347
+ },
348
+ [openPanel, phases.list, agents.list]
349
+ );
350
+
351
+ return (
352
+ <div className="flex flex-col h-full">
353
+ {/* Header */}
354
+ <div className="px-6 py-4 border-b border-gray-800 flex-shrink-0">
355
+ <h1 className="text-white text-xl font-bold">Phase Pipeline</h1>
356
+ <p className="text-gray-400 text-sm mt-0.5">
357
+ Horizontal workflow of the 7 morph-spec phases. Gold gates mark required approval points. Dashed borders indicate optional phases.
358
+ </p>
359
+ </div>
360
+
361
+ {/* Flow graph */}
362
+ <div className="flex-1 relative">
363
+ <FlowGraph
364
+ nodes={nodes}
365
+ edges={edges}
366
+ nodeTypes={nodeTypes}
367
+ onNodeClick={handleNodeClick}
368
+ fitView
369
+ />
370
+
371
+ {/* Legend */}
372
+ <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">
373
+ <p className="text-gray-400 font-semibold uppercase tracking-wide text-[10px] mb-2">Legend</p>
374
+ <div className="flex items-center gap-2">
375
+ <span className="inline-block w-10 h-4 rounded-sm" style={{ background: '#166534', border: '2px solid #22c55e' }} />
376
+ <span className="text-gray-300">Phase (solid = required)</span>
377
+ </div>
378
+ <div className="flex items-center gap-2">
379
+ <span className="inline-block w-10 h-4 rounded-sm" style={{ background: '#854d0e', border: '2px dashed #f59e0b' }} />
380
+ <span className="text-gray-300">Phase (dashed = optional)</span>
381
+ </div>
382
+ <div className="flex items-center gap-2">
383
+ <span
384
+ className="inline-flex items-center justify-center rounded-sm text-[10px] font-bold flex-shrink-0"
385
+ style={{ width: 20, height: 20, background: '#78350f', border: '2px solid #f59e0b', color: '#fef3c7' }}
386
+ >
387
+ G
388
+ </span>
389
+ <span className="text-gray-300">Approval Gate</span>
390
+ </div>
391
+ <div className="flex items-center gap-2">
392
+ <span className="inline-block w-6 border-t-2 border-gray-500" />
393
+ <span className="text-gray-400">Sequence</span>
394
+ </div>
395
+ </div>
396
+
397
+ {/* Phase count badge */}
398
+ <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">
399
+ {phases.list.length} phases · {phases.list.filter((p) => GATED_PHASES.has(p.id)).length} gates
400
+ </div>
401
+ </div>
402
+
403
+ <DetailPanel open={panel.open} title={panel.title} onClose={closePanel}>
404
+ {panel.content}
405
+ </DetailPanel>
406
+ </div>
407
+ );
408
+ }