@polymorphism-tech/morph-spec 3.0.1 → 3.2.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 (316) hide show
  1. package/CLAUDE.md +561 -63
  2. package/LICENSE +72 -72
  3. package/README.md +275 -79
  4. package/bin/detect-agents.js +3 -1
  5. package/bin/morph-spec.js +60 -1
  6. package/bin/render-template.js +61 -14
  7. package/bin/semantic-detect-agents.js +2 -1
  8. package/bin/{task-manager.js → task-manager.cjs} +113 -8
  9. package/bin/validate-agents-skills.js +10 -4
  10. package/bin/validate-agents.js +4 -3
  11. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-light-webfont.svg +977 -977
  12. package/docs/api/fonts/Source-Sans-Pro/sourcesanspro-regular-webfont.svg +1048 -1048
  13. package/docs/api/scripts/collapse.js +38 -38
  14. package/docs/api/scripts/commonNav.js +28 -28
  15. package/docs/api/scripts/linenumber.js +25 -25
  16. package/docs/api/scripts/nav.js +12 -12
  17. package/docs/api/scripts/polyfill.js +3 -3
  18. package/docs/api/scripts/prettify/Apache-License-2.0.txt +202 -202
  19. package/docs/api/scripts/prettify/lang-css.js +2 -2
  20. package/docs/api/scripts/prettify/prettify.js +28 -28
  21. package/docs/api/scripts/search.js +98 -98
  22. package/docs/api/styles/jsdoc.css +776 -776
  23. package/docs/api/styles/prettify.css +80 -80
  24. package/docs/cli-auto-detection.md +219 -0
  25. package/docs/examples.md +328 -328
  26. package/docs/getting-started.md +3 -3
  27. package/docs/llm-interaction-config.md +735 -0
  28. package/docs/templates.md +418 -418
  29. package/docs/troubleshooting.md +269 -0
  30. package/package.json +7 -3
  31. package/scripts/postinstall.js +132 -132
  32. package/scripts/reorganize-skills.cjs +1 -1
  33. package/scripts/validate-agents-structure.cjs +1 -1
  34. package/scripts/validate-skills.cjs +2 -2
  35. package/src/commands/advance-phase.js +93 -2
  36. package/src/commands/analyze-blazor-concurrency.js +193 -193
  37. package/src/commands/approve.js +221 -0
  38. package/src/commands/capture-pattern.js +121 -0
  39. package/src/commands/create-story.js +5 -2
  40. package/src/commands/deploy.js +780 -780
  41. package/src/commands/detect-agents.js +4 -2
  42. package/src/commands/generate.js +276 -149
  43. package/src/commands/init.js +37 -0
  44. package/src/commands/lint-fluent.js +352 -352
  45. package/src/commands/migrate-state.js +158 -0
  46. package/src/commands/rollback-phase.js +185 -185
  47. package/src/commands/search-patterns.js +126 -0
  48. package/src/commands/session-summary.js +291 -291
  49. package/src/commands/shard-spec.js +224 -224
  50. package/src/commands/spawn-team.js +172 -0
  51. package/src/commands/sprint-status.js +250 -250
  52. package/src/commands/task.js +3 -3
  53. package/src/commands/troubleshoot.js +222 -222
  54. package/src/commands/update.js +36 -0
  55. package/src/commands/upgrade.js +346 -0
  56. package/src/commands/validate-blazor-state.js +210 -210
  57. package/src/commands/validate-blazor.js +156 -156
  58. package/src/commands/validate-css.js +84 -84
  59. package/src/commands/validate-phase.js +221 -221
  60. package/src/generator/.gitkeep +0 -0
  61. package/src/generator/config-generator.js +206 -0
  62. package/src/generator/templates/config.json.template +40 -0
  63. package/src/generator/templates/project.md.template +67 -0
  64. package/src/lib/blazor-concurrency-analyzer.js +288 -288
  65. package/src/lib/blazor-state-validator.js +291 -291
  66. package/src/lib/blazor-validator.js +374 -374
  67. package/src/lib/checkpoint-hooks.js +258 -0
  68. package/src/lib/context-generator.js +7 -4
  69. package/src/lib/css-validator.js +352 -352
  70. package/src/lib/design-system-generator.js +298 -298
  71. package/src/lib/hook-executor.js +2 -1
  72. package/src/lib/learning-system.js +520 -520
  73. package/src/lib/metadata-extractor.js +380 -0
  74. package/src/lib/mockup-generator.js +366 -366
  75. package/src/lib/phase-state-machine.js +214 -0
  76. package/src/lib/stack-resolver.js +148 -0
  77. package/src/lib/standards-context-injector.js +4 -3
  78. package/src/lib/state-manager.js +120 -0
  79. package/src/lib/team-orchestrator.js +2 -1
  80. package/src/lib/template-data-sources.js +325 -0
  81. package/src/lib/troubleshoot-grep.js +204 -194
  82. package/src/lib/troubleshoot-index.js +144 -144
  83. package/src/lib/ui-detector.js +350 -350
  84. package/src/lib/validation-runner.js +2 -1
  85. package/src/lib/validators/architecture-validator.js +387 -387
  86. package/src/lib/validators/content-validator.js +351 -0
  87. package/src/lib/validators/package-validator.js +360 -360
  88. package/src/lib/validators/ui-contrast-validator.js +422 -422
  89. package/src/llm/.gitkeep +0 -0
  90. package/src/llm/analyzer.js +215 -0
  91. package/src/llm/environment-detector.js +43 -0
  92. package/src/llm/few-shot-examples.js +216 -0
  93. package/src/llm/project-config-schema.json +188 -0
  94. package/src/llm/prompt-builder.js +96 -0
  95. package/src/llm/schema-validator.js +121 -0
  96. package/src/orchestrator.js +206 -0
  97. package/src/sanitizer/.gitkeep +0 -0
  98. package/src/sanitizer/context-sanitizer.js +221 -0
  99. package/src/sanitizer/patterns.js +163 -0
  100. package/src/scanner/.gitkeep +0 -0
  101. package/src/scanner/project-scanner.js +242 -0
  102. package/src/types/index.js +477 -0
  103. package/src/ui/.gitkeep +0 -0
  104. package/src/ui/diff-display.js +91 -0
  105. package/src/ui/interactive-wizard.js +96 -0
  106. package/src/ui/user-review.js +211 -0
  107. package/src/ui/wizard-questions.js +190 -0
  108. package/src/utils/file-copier.js +3 -1
  109. package/src/utils/logger.js +32 -32
  110. package/src/utils/version-checker.js +175 -175
  111. package/src/writer/.gitkeep +0 -0
  112. package/src/writer/file-writer.js +86 -0
  113. package/{content → stacks/blazor-azure}/.azure/README.md +2 -2
  114. package/{content → stacks/blazor-azure}/.azure/pipelines/pipeline-variables.yml +1 -1
  115. package/{content → stacks/blazor-azure}/.azure/pipelines/prod-pipeline.yml +1 -1
  116. package/{content → stacks/blazor-azure}/.azure/pipelines/staging-pipeline.yml +1 -1
  117. package/{content → stacks/blazor-azure}/.claude/commands/morph-preflight.md +227 -227
  118. package/{content → stacks/blazor-azure}/.claude/commands/morph-troubleshoot.md +122 -122
  119. package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/phase-setup.md +1 -1
  120. package/{content → stacks/blazor-azure}/.morph/docs/workflows/enforcement-pipeline.md +3 -3
  121. package/{content → stacks/blazor-azure}/.morph/hooks/README.md +12 -12
  122. package/{content → stacks/blazor-azure}/.morph/standards/agent-teams-workflow.md +2 -2
  123. package/{content → stacks/blazor-azure}/.morph/standards/migration-guide.md +2 -2
  124. package/{content → stacks/blazor-azure}/.morph/templates/infra/deploy-checklist.md +426 -426
  125. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/backend/dotnet-supabase.md +244 -0
  126. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/frontend/nextjs-supabase.md +335 -0
  127. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/infrastructure/easypanel-deployer.md +189 -0
  128. package/stacks/nextjs-supabase/.claude/skills/level-2-domains/integrations/supabase-expert.md +170 -0
  129. package/stacks/nextjs-supabase/.morph/config/agents.json +345 -0
  130. package/stacks/nextjs-supabase/.morph/config/config.template.json +92 -0
  131. package/stacks/nextjs-supabase/.morph/docs/easypanel-setup.md +169 -0
  132. package/stacks/nextjs-supabase/.morph/docs/supabase-mcp-setup.md +247 -0
  133. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/README.md +697 -0
  134. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/spec.md +85 -0
  135. package/stacks/nextjs-supabase/.morph/examples/crud-nextjs-supabase/tasks.md +86 -0
  136. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/README.md +498 -0
  137. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/decisions.md +121 -0
  138. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/spec.md +138 -0
  139. package/stacks/nextjs-supabase/.morph/examples/saas-nextjs-supabase/tasks.md +162 -0
  140. package/stacks/nextjs-supabase/.morph/project.md +168 -0
  141. package/stacks/nextjs-supabase/.morph/standards/easypanel-deploy.md +191 -0
  142. package/stacks/nextjs-supabase/.morph/standards/nextjs-patterns.md +193 -0
  143. package/stacks/nextjs-supabase/.morph/standards/supabase-auth.md +171 -0
  144. package/stacks/nextjs-supabase/.morph/standards/supabase-pgvector.md +164 -0
  145. package/stacks/nextjs-supabase/.morph/standards/supabase-rls.md +179 -0
  146. package/stacks/nextjs-supabase/.morph/standards/supabase-storage.md +148 -0
  147. package/stacks/nextjs-supabase/.morph/templates/contracts.cs +173 -0
  148. package/stacks/nextjs-supabase/.morph/templates/contracts.ts +168 -0
  149. package/stacks/nextjs-supabase/.morph/templates/decisions.md +115 -0
  150. package/stacks/nextjs-supabase/.morph/templates/dockerfile-api.dockerfile +38 -0
  151. package/stacks/nextjs-supabase/.morph/templates/dockerfile-web.dockerfile +48 -0
  152. package/stacks/nextjs-supabase/.morph/templates/proposal.md +145 -0
  153. package/stacks/nextjs-supabase/.morph/templates/recap.md +134 -0
  154. package/stacks/nextjs-supabase/.morph/templates/rls-policy.sql +57 -0
  155. package/stacks/nextjs-supabase/.morph/templates/spec.md +231 -0
  156. package/stacks/nextjs-supabase/.morph/templates/supabase-migration.sql +100 -0
  157. package/stacks/nextjs-supabase/.morph/templates/tasks.md +257 -0
  158. package/stacks/nextjs-supabase/CLAUDE.md +149 -0
  159. package/stacks/nextjs-supabase/README.md +112 -0
  160. /package/{content → stacks/blazor-azure}/.azure/docs/azure-devops-setup.md +0 -0
  161. /package/{content → stacks/blazor-azure}/.azure/docs/branch-strategy.md +0 -0
  162. /package/{content → stacks/blazor-azure}/.azure/docs/local-development.md +0 -0
  163. /package/{content → stacks/blazor-azure}/.azure/pipelines/templates/build-dotnet.yml +0 -0
  164. /package/{content → stacks/blazor-azure}/.azure/pipelines/templates/deploy-app-service.yml +0 -0
  165. /package/{content → stacks/blazor-azure}/.azure/pipelines/templates/deploy-container-app.yml +0 -0
  166. /package/{content → stacks/blazor-azure}/.azure/pipelines/templates/infra-deploy.yml +0 -0
  167. /package/{content → stacks/blazor-azure}/.claude/commands/morph-apply.md +0 -0
  168. /package/{content → stacks/blazor-azure}/.claude/commands/morph-archive.md +0 -0
  169. /package/{content → stacks/blazor-azure}/.claude/commands/morph-deploy.md +0 -0
  170. /package/{content → stacks/blazor-azure}/.claude/commands/morph-infra.md +0 -0
  171. /package/{content → stacks/blazor-azure}/.claude/commands/morph-proposal.md +0 -0
  172. /package/{content → stacks/blazor-azure}/.claude/commands/morph-status.md +0 -0
  173. /package/{content → stacks/blazor-azure}/.claude/settings.local.json +0 -0
  174. /package/{content → stacks/blazor-azure}/.claude/skills/level-0-meta/README.md +0 -0
  175. /package/{content → stacks/blazor-azure}/.claude/skills/level-0-meta/code-review.md +0 -0
  176. /package/{content → stacks/blazor-azure}/.claude/skills/level-0-meta/morph-checklist.md +0 -0
  177. /package/{content → stacks/blazor-azure}/.claude/skills/level-0-meta/simulation-checklist.md +0 -0
  178. /package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/README.md +0 -0
  179. /package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/morph-replicate.md +0 -0
  180. /package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/phase-clarify.md +0 -0
  181. /package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/phase-design.md +0 -0
  182. /package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/phase-tasks.md +0 -0
  183. /package/{content → stacks/blazor-azure}/.claude/skills/level-1-workflows/phase-uiux.md +0 -0
  184. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/README.md +0 -0
  185. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/ai-agents/ai-system-architect.md +0 -0
  186. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/architecture/po-pm-advisor.md +0 -0
  187. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/architecture/prompt-engineer.md +0 -0
  188. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/architecture/seo-growth-hacker.md +0 -0
  189. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/architecture/standards-architect.md +0 -0
  190. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/backend/dotnet-senior.md +0 -0
  191. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/backend/ef-modeler.md +0 -0
  192. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/backend/hangfire-orchestrator.md +0 -0
  193. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/backend/ms-agent-expert.md +0 -0
  194. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/frontend/blazor-builder.md +0 -0
  195. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/frontend/nextjs-expert.md +0 -0
  196. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/frontend/ui-ux-designer.md +0 -0
  197. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/infrastructure/azure-architect.md +0 -0
  198. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/infrastructure/azure-deploy-specialist.md +0 -0
  199. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/infrastructure/bicep-architect.md +0 -0
  200. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/infrastructure/container-specialist.md +0 -0
  201. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/infrastructure/devops-engineer.md +0 -0
  202. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/integrations/asaas-financial.md +0 -0
  203. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/integrations/azure-identity.md +0 -0
  204. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/integrations/clerk-auth.md +0 -0
  205. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/integrations/resend-email.md +0 -0
  206. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/quality/code-analyzer.md +0 -0
  207. /package/{content → stacks/blazor-azure}/.claude/skills/level-2-domains/quality/testing-specialist.md +0 -0
  208. /package/{content → stacks/blazor-azure}/.claude/skills/level-3-technologies/README.md +0 -0
  209. /package/{content → stacks/blazor-azure}/.claude/skills/level-4-patterns/README.md +0 -0
  210. /package/{content → stacks/blazor-azure}/.morph/.morphversion +0 -0
  211. /package/{content → stacks/blazor-azure}/.morph/archive/.gitkeep +0 -0
  212. /package/{content → stacks/blazor-azure}/.morph/config/agents.json +0 -0
  213. /package/{content → stacks/blazor-azure}/.morph/config/config.template.json +0 -0
  214. /package/{content → stacks/blazor-azure}/.morph/docs/STORY-DRIVEN-DEVELOPMENT.md +0 -0
  215. /package/{content → stacks/blazor-azure}/.morph/docs/workflows/design-impl.md +0 -0
  216. /package/{content → stacks/blazor-azure}/.morph/docs/workflows/fast-track.md +0 -0
  217. /package/{content → stacks/blazor-azure}/.morph/docs/workflows/full-morph.md +0 -0
  218. /package/{content → stacks/blazor-azure}/.morph/docs/workflows/standard.md +0 -0
  219. /package/{content → stacks/blazor-azure}/.morph/docs/workflows/ui-refresh.md +0 -0
  220. /package/{content → stacks/blazor-azure}/.morph/examples/api-nextjs/README.md +0 -0
  221. /package/{content → stacks/blazor-azure}/.morph/examples/api-nextjs/contracts.ts +0 -0
  222. /package/{content → stacks/blazor-azure}/.morph/examples/api-nextjs/spec.md +0 -0
  223. /package/{content → stacks/blazor-azure}/.morph/examples/api-nextjs/tasks.md +0 -0
  224. /package/{content → stacks/blazor-azure}/.morph/examples/micro-saas/README.md +0 -0
  225. /package/{content → stacks/blazor-azure}/.morph/examples/micro-saas/contracts.cs +0 -0
  226. /package/{content → stacks/blazor-azure}/.morph/examples/micro-saas/decisions.md +0 -0
  227. /package/{content → stacks/blazor-azure}/.morph/examples/micro-saas/spec.md +0 -0
  228. /package/{content → stacks/blazor-azure}/.morph/examples/micro-saas/tasks.md +0 -0
  229. /package/{content → stacks/blazor-azure}/.morph/examples/multi-agent/README.md +0 -0
  230. /package/{content → stacks/blazor-azure}/.morph/examples/multi-agent/contracts.cs +0 -0
  231. /package/{content → stacks/blazor-azure}/.morph/examples/multi-agent/spec.md +0 -0
  232. /package/{content → stacks/blazor-azure}/.morph/examples/multi-agent/tasks.md +0 -0
  233. /package/{content → stacks/blazor-azure}/.morph/examples/scheduled-reports/decisions.md +0 -0
  234. /package/{content → stacks/blazor-azure}/.morph/examples/scheduled-reports/proposal.md +0 -0
  235. /package/{content → stacks/blazor-azure}/.morph/examples/scheduled-reports/spec.md +0 -0
  236. /package/{content → stacks/blazor-azure}/.morph/examples/state-v3.json +0 -0
  237. /package/{content → stacks/blazor-azure}/.morph/features/.gitkeep +0 -0
  238. /package/{content → stacks/blazor-azure}/.morph/hooks/pre-commit-agents.sh +0 -0
  239. /package/{content → stacks/blazor-azure}/.morph/hooks/pre-commit-all.sh +0 -0
  240. /package/{content → stacks/blazor-azure}/.morph/hooks/pre-commit-specs.sh +0 -0
  241. /package/{content → stacks/blazor-azure}/.morph/hooks/pre-commit-tests.sh +0 -0
  242. /package/{content → stacks/blazor-azure}/.morph/hooks/task-completed.js +0 -0
  243. /package/{content → stacks/blazor-azure}/.morph/hooks/teammate-idle.js +0 -0
  244. /package/{content → stacks/blazor-azure}/.morph/project.md +0 -0
  245. /package/{content → stacks/blazor-azure}/.morph/schemas/agent.schema.json +0 -0
  246. /package/{content → stacks/blazor-azure}/.morph/schemas/tasks.schema.json +0 -0
  247. /package/{content → stacks/blazor-azure}/.morph/specs/.gitkeep +0 -0
  248. /package/{content → stacks/blazor-azure}/.morph/standards/agent-framework-blazor-ui.md +0 -0
  249. /package/{content → stacks/blazor-azure}/.morph/standards/agent-framework-production.md +0 -0
  250. /package/{content → stacks/blazor-azure}/.morph/standards/agent-framework-setup.md +0 -0
  251. /package/{content → stacks/blazor-azure}/.morph/standards/agent-framework-workflows.md +0 -0
  252. /package/{content → stacks/blazor-azure}/.morph/standards/architecture.md +0 -0
  253. /package/{content → stacks/blazor-azure}/.morph/standards/azure.md +0 -0
  254. /package/{content → stacks/blazor-azure}/.morph/standards/coding.md +0 -0
  255. /package/{content → stacks/blazor-azure}/.morph/standards/dotnet10-migration.md +0 -0
  256. /package/{content → stacks/blazor-azure}/.morph/standards/fluent-ui-setup.md +0 -0
  257. /package/{content → stacks/blazor-azure}/.morph/standards/passkeys-auth.md +0 -0
  258. /package/{content → stacks/blazor-azure}/.morph/standards/vector-search-rag.md +0 -0
  259. /package/{content → stacks/blazor-azure}/.morph/state.json +0 -0
  260. /package/{content → stacks/blazor-azure}/.morph/templates/CONTEXT-FEATURE.md +0 -0
  261. /package/{content → stacks/blazor-azure}/.morph/templates/CONTEXT.md +0 -0
  262. /package/{content → stacks/blazor-azure}/.morph/templates/FluentDesignTheme.cs +0 -0
  263. /package/{content → stacks/blazor-azure}/.morph/templates/MudTheme.cs +0 -0
  264. /package/{content → stacks/blazor-azure}/.morph/templates/agent.cs +0 -0
  265. /package/{content → stacks/blazor-azure}/.morph/templates/clarify-questions.md +0 -0
  266. /package/{content → stacks/blazor-azure}/.morph/templates/component.razor +0 -0
  267. /package/{content → stacks/blazor-azure}/.morph/templates/contracts/Commands.cs +0 -0
  268. /package/{content → stacks/blazor-azure}/.morph/templates/contracts/Entities.cs +0 -0
  269. /package/{content → stacks/blazor-azure}/.morph/templates/contracts/Queries.cs +0 -0
  270. /package/{content → stacks/blazor-azure}/.morph/templates/contracts/README.md +0 -0
  271. /package/{content → stacks/blazor-azure}/.morph/templates/contracts.cs +0 -0
  272. /package/{content → stacks/blazor-azure}/.morph/templates/decisions.md +0 -0
  273. /package/{content → stacks/blazor-azure}/.morph/templates/design-system.css +0 -0
  274. /package/{content → stacks/blazor-azure}/.morph/templates/infra/.dockerignore.example +0 -0
  275. /package/{content → stacks/blazor-azure}/.morph/templates/infra/Dockerfile.example +0 -0
  276. /package/{content → stacks/blazor-azure}/.morph/templates/infra/README.md +0 -0
  277. /package/{content → stacks/blazor-azure}/.morph/templates/infra/app-insights.bicep +0 -0
  278. /package/{content → stacks/blazor-azure}/.morph/templates/infra/app-service.bicep +0 -0
  279. /package/{content → stacks/blazor-azure}/.morph/templates/infra/azure-pipelines-deploy.yml +0 -0
  280. /package/{content → stacks/blazor-azure}/.morph/templates/infra/container-app-env.bicep +0 -0
  281. /package/{content → stacks/blazor-azure}/.morph/templates/infra/container-app.bicep +0 -0
  282. /package/{content → stacks/blazor-azure}/.morph/templates/infra/deploy.ps1 +0 -0
  283. /package/{content → stacks/blazor-azure}/.morph/templates/infra/deploy.sh +0 -0
  284. /package/{content → stacks/blazor-azure}/.morph/templates/infra/key-vault.bicep +0 -0
  285. /package/{content → stacks/blazor-azure}/.morph/templates/infra/main.bicep +0 -0
  286. /package/{content → stacks/blazor-azure}/.morph/templates/infra/parameters.dev.json +0 -0
  287. /package/{content → stacks/blazor-azure}/.morph/templates/infra/parameters.prod.json +0 -0
  288. /package/{content → stacks/blazor-azure}/.morph/templates/infra/parameters.staging.json +0 -0
  289. /package/{content → stacks/blazor-azure}/.morph/templates/infra/sql-database.bicep +0 -0
  290. /package/{content → stacks/blazor-azure}/.morph/templates/infra/storage.bicep +0 -0
  291. /package/{content → stacks/blazor-azure}/.morph/templates/integrations/asaas-client.cs +0 -0
  292. /package/{content → stacks/blazor-azure}/.morph/templates/integrations/asaas-webhook.cs +0 -0
  293. /package/{content → stacks/blazor-azure}/.morph/templates/integrations/azure-identity-config.cs +0 -0
  294. /package/{content → stacks/blazor-azure}/.morph/templates/integrations/clerk-config.cs +0 -0
  295. /package/{content → stacks/blazor-azure}/.morph/templates/job.cs +0 -0
  296. /package/{content → stacks/blazor-azure}/.morph/templates/migration.cs +0 -0
  297. /package/{content → stacks/blazor-azure}/.morph/templates/proposal.md +0 -0
  298. /package/{content → stacks/blazor-azure}/.morph/templates/recap.md +0 -0
  299. /package/{content → stacks/blazor-azure}/.morph/templates/repository.cs +0 -0
  300. /package/{content → stacks/blazor-azure}/.morph/templates/saas/subscription.cs +0 -0
  301. /package/{content → stacks/blazor-azure}/.morph/templates/saas/tenant.cs +0 -0
  302. /package/{content → stacks/blazor-azure}/.morph/templates/service.cs +0 -0
  303. /package/{content → stacks/blazor-azure}/.morph/templates/simulation.md +0 -0
  304. /package/{content → stacks/blazor-azure}/.morph/templates/spec.md +0 -0
  305. /package/{content → stacks/blazor-azure}/.morph/templates/sprint-status.yaml +0 -0
  306. /package/{content → stacks/blazor-azure}/.morph/templates/state.template.json +0 -0
  307. /package/{content → stacks/blazor-azure}/.morph/templates/story.md +0 -0
  308. /package/{content → stacks/blazor-azure}/.morph/templates/tasks.md +0 -0
  309. /package/{content → stacks/blazor-azure}/.morph/templates/test.cs +0 -0
  310. /package/{content → stacks/blazor-azure}/.morph/templates/ui-components.md +0 -0
  311. /package/{content → stacks/blazor-azure}/.morph/templates/ui-design-system.md +0 -0
  312. /package/{content → stacks/blazor-azure}/.morph/templates/ui-flows.md +0 -0
  313. /package/{content → stacks/blazor-azure}/.morph/templates/ui-mockups.md +0 -0
  314. /package/{content → stacks/blazor-azure}/.morph/test-infra/example.bicep +0 -0
  315. /package/{content → stacks/blazor-azure}/CLAUDE.md +0 -0
  316. /package/{content → stacks/blazor-azure}/README.md +0 -0
@@ -1,426 +1,426 @@
1
- # Deploy Checklist & Scripts
2
-
3
- > Guia completo para deploy seguro em Azure.
4
-
5
- ---
6
-
7
- ## Pre-Deploy Checklist
8
-
9
- ### 1. Código
10
-
11
- - [ ] Build passa sem erros: `dotnet build`
12
- - [ ] Testes passando: `dotnet test`
13
- - [ ] Sem warnings críticos de segurança
14
- - [ ] Code review aprovado (se aplicável)
15
-
16
- ### 2. Packages
17
-
18
- - [ ] Sem conflitos de versão (NU1605/NU1608)
19
- - [ ] `Azure.Identity` especificado explicitamente:
20
- ```xml
21
- <PackageReference Include="Azure.Identity" Version="1.14.2" />
22
- ```
23
- - [ ] Packages atualizados para versões estáveis
24
-
25
- ### 3. EF Core Migrations
26
-
27
- - [ ] Sem pending model changes:
28
- ```bash
29
- dotnet ef migrations has-pending-model-changes \
30
- --project src/Infrastructure \
31
- --startup-project src/Web
32
- ```
33
- - [ ] Migration criada se necessário:
34
- ```bash
35
- dotnet ef migrations add <Name> \
36
- --project src/Infrastructure \
37
- --startup-project src/Web
38
- ```
39
- - [ ] Script SQL gerado e revisado:
40
- ```bash
41
- dotnet ef migrations script --idempotent -o migration.sql
42
- ```
43
-
44
- ### 4. Blazor .NET 10 (se aplicável)
45
-
46
- - [ ] `.csproj` contém:
47
- ```xml
48
- <RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>
49
- ```
50
- - [ ] Static assets funcionam localmente
51
-
52
- ### 5. Docker/Container (se Container Apps)
53
-
54
- - [ ] Dockerfile válido
55
- - [ ] Build funciona:
56
- ```bash
57
- docker build --no-cache -t myapp:test .
58
- ```
59
- - [ ] Container roda localmente:
60
- ```bash
61
- docker run -p 8080:8080 myapp:test
62
- ```
63
-
64
- ### 6. Infraestrutura Azure
65
-
66
- - [ ] Bicep válido:
67
- ```bash
68
- az bicep build --file infra/main.bicep
69
- ```
70
- - [ ] Key Vault configurado
71
- - [ ] Managed Identity habilitada
72
- - [ ] Connection strings em Key Vault (não hardcoded)
73
-
74
- ### 7. Segurança
75
-
76
- - [ ] Sem secrets em `appsettings.json`:
77
- ```bash
78
- grep -rE "(Password=|Pwd=|Secret=)" appsettings*.json | grep -v Development
79
- ```
80
- - [ ] HTTPS enforçado
81
- - [ ] CORS configurado
82
-
83
- ---
84
-
85
- ## Scripts de Deploy
86
-
87
- ### Script Completo - Container Apps
88
-
89
- ```bash
90
- #!/bin/bash
91
- # deploy-container-app.sh
92
- # Usage: ./deploy-container-app.sh [dev|staging|prod]
93
-
94
- set -e
95
-
96
- ENV="${1:-staging}"
97
- PROJECT_NAME="myapp"
98
-
99
- # Configurações por ambiente
100
- case $ENV in
101
- dev)
102
- RG_NAME="rg-${PROJECT_NAME}-dev"
103
- APP_NAME="ca-${PROJECT_NAME}-dev"
104
- ACR_NAME="acr${PROJECT_NAME}dev"
105
- ;;
106
- staging)
107
- RG_NAME="rg-${PROJECT_NAME}-stg"
108
- APP_NAME="ca-${PROJECT_NAME}-stg"
109
- ACR_NAME="acr${PROJECT_NAME}stg"
110
- ;;
111
- prod)
112
- RG_NAME="rg-${PROJECT_NAME}-prod"
113
- APP_NAME="ca-${PROJECT_NAME}-prod"
114
- ACR_NAME="acr${PROJECT_NAME}prod"
115
- ;;
116
- *)
117
- echo "Ambiente inválido: $ENV"
118
- exit 1
119
- ;;
120
- esac
121
-
122
- IMAGE_TAG="${GITHUB_SHA:-$(git rev-parse --short HEAD)}"
123
-
124
- echo "🚀 Deploying to $ENV environment..."
125
- echo " Resource Group: $RG_NAME"
126
- echo " Container App: $APP_NAME"
127
- echo " Image Tag: $IMAGE_TAG"
128
-
129
- # 1. Pre-flight checks
130
- echo "📋 Running pre-flight checks..."
131
-
132
- # Check pending migrations
133
- if ! dotnet ef migrations has-pending-model-changes \
134
- --project src/Infrastructure \
135
- --startup-project src/Web 2>/dev/null; then
136
- echo "⚠️ Warning: Pending model changes detected"
137
- read -p "Continue anyway? (y/N) " -n 1 -r
138
- echo
139
- if [[ ! $REPLY =~ ^[Yy]$ ]]; then
140
- exit 1
141
- fi
142
- fi
143
-
144
- # 2. Build Docker image
145
- echo "🐳 Building Docker image..."
146
- docker build --no-cache -t ${ACR_NAME}.azurecr.io/${PROJECT_NAME}:${IMAGE_TAG} .
147
- docker tag ${ACR_NAME}.azurecr.io/${PROJECT_NAME}:${IMAGE_TAG} \
148
- ${ACR_NAME}.azurecr.io/${PROJECT_NAME}:latest
149
-
150
- # 3. Push to ACR
151
- echo "📤 Pushing to ACR..."
152
- az acr login --name $ACR_NAME
153
- docker push ${ACR_NAME}.azurecr.io/${PROJECT_NAME}:${IMAGE_TAG}
154
- docker push ${ACR_NAME}.azurecr.io/${PROJECT_NAME}:latest
155
-
156
- # 4. Update Container App (with timestamp to force new revision)
157
- echo "🔄 Updating Container App..."
158
- az containerapp update \
159
- --name $APP_NAME \
160
- --resource-group $RG_NAME \
161
- --image ${ACR_NAME}.azurecr.io/${PROJECT_NAME}:${IMAGE_TAG} \
162
- --set-env-vars "DEPLOY_TIMESTAMP=$(date +%s)"
163
-
164
- # 5. Wait for deployment
165
- echo "⏳ Waiting for deployment..."
166
- sleep 10
167
-
168
- # 6. Verify
169
- echo "✅ Verifying deployment..."
170
- STATUS=$(az containerapp show \
171
- --name $APP_NAME \
172
- --resource-group $RG_NAME \
173
- --query "properties.runningStatus" -o tsv)
174
-
175
- if [ "$STATUS" == "Running" ]; then
176
- echo "✅ Deployment successful!"
177
- FQDN=$(az containerapp show \
178
- --name $APP_NAME \
179
- --resource-group $RG_NAME \
180
- --query "properties.configuration.ingress.fqdn" -o tsv)
181
- echo "🌐 URL: https://$FQDN"
182
- else
183
- echo "❌ Deployment failed! Status: $STATUS"
184
- echo "📋 Checking logs..."
185
- az containerapp logs show \
186
- --name $APP_NAME \
187
- --resource-group $RG_NAME \
188
- --tail 50
189
- exit 1
190
- fi
191
-
192
- # 7. Health check
193
- echo "🏥 Running health check..."
194
- HEALTH_URL="https://$FQDN/health"
195
- HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" $HEALTH_URL || echo "000")
196
-
197
- if [ "$HTTP_CODE" == "200" ]; then
198
- echo "✅ Health check passed!"
199
- else
200
- echo "⚠️ Health check returned: $HTTP_CODE"
201
- fi
202
-
203
- echo ""
204
- echo "🎉 Deploy complete!"
205
- ```
206
-
207
- ### Script Verificação Pré-Deploy
208
-
209
- ```bash
210
- #!/bin/bash
211
- # preflight-check.sh
212
- # Valida projeto antes de deploy
213
-
214
- set -e
215
-
216
- echo "🔍 MORPH Pre-Flight Check"
217
- echo "━━━━━━━━━━━━━━━━━━━━━━━━━━"
218
-
219
- ERRORS=0
220
- WARNINGS=0
221
-
222
- # 1. Package conflicts
223
- echo -n "📦 Checking packages... "
224
- if dotnet restore 2>&1 | grep -qE "NU1605|NU1608"; then
225
- echo "❌ Version conflicts detected"
226
- ((ERRORS++))
227
- else
228
- echo "✅"
229
- fi
230
-
231
- # 2. Pending migrations
232
- echo -n "🗄️ Checking migrations... "
233
- if ! dotnet ef migrations has-pending-model-changes \
234
- --project src/Infrastructure \
235
- --startup-project src/Web 2>/dev/null; then
236
- echo "❌ Pending changes"
237
- ((ERRORS++))
238
- else
239
- echo "✅"
240
- fi
241
-
242
- # 3. Build
243
- echo -n "🔨 Checking build... "
244
- if ! dotnet build --nologo -v q 2>/dev/null; then
245
- echo "❌ Build failed"
246
- ((ERRORS++))
247
- else
248
- echo "✅"
249
- fi
250
-
251
- # 4. Blazor assets (.NET 10)
252
- echo -n "🎨 Checking Blazor assets... "
253
- if grep -q "net10.0" *.csproj 2>/dev/null; then
254
- if ! grep -q "RequiresAspNetWebAssets.*true" *.csproj 2>/dev/null; then
255
- echo "❌ Missing RequiresAspNetWebAssets"
256
- ((ERRORS++))
257
- else
258
- echo "✅"
259
- fi
260
- else
261
- echo "⏭️ Not .NET 10"
262
- fi
263
-
264
- # 5. Bicep
265
- echo -n "📐 Checking Bicep... "
266
- if [ -f "infra/main.bicep" ]; then
267
- if ! az bicep build --file infra/main.bicep --stdout >/dev/null 2>&1; then
268
- echo "❌ Syntax errors"
269
- ((ERRORS++))
270
- else
271
- echo "✅"
272
- fi
273
- else
274
- echo "⏭️ No Bicep files"
275
- fi
276
-
277
- # 6. Secrets scan
278
- echo -n "🔐 Checking secrets... "
279
- if grep -rE "(Password=|Pwd=|Secret=)" appsettings*.json 2>/dev/null | grep -v Development; then
280
- echo "⚠️ Secrets in config"
281
- ((WARNINGS++))
282
- else
283
- echo "✅"
284
- fi
285
-
286
- # Summary
287
- echo ""
288
- echo "━━━━━━━━━━━━━━━━━━━━━━━━━━"
289
- if [ $ERRORS -eq 0 ]; then
290
- if [ $WARNINGS -eq 0 ]; then
291
- echo "✅ All checks passed!"
292
- else
293
- echo "⚠️ $WARNINGS warning(s), but OK to deploy"
294
- fi
295
- exit 0
296
- else
297
- echo "❌ $ERRORS error(s) found. Fix before deploy!"
298
- exit 1
299
- fi
300
- ```
301
-
302
- ---
303
-
304
- ## Troubleshooting Deploy
305
-
306
- ### Container App não atualiza
307
-
308
- **Sintoma:** Após push, Container App continua com versão antiga.
309
-
310
- **Causa:** Mesmo digest de imagem não triggera nova revisão.
311
-
312
- **Solução:**
313
- ```bash
314
- az containerapp update \
315
- --name $APP_NAME \
316
- --resource-group $RG_NAME \
317
- --set-env-vars "DEPLOY_TIMESTAMP=$(date +%s)"
318
- ```
319
-
320
- ### blazor.web.js 404
321
-
322
- **Sintoma:** Página Blazor não carrega.
323
-
324
- **Solução:** Adicionar ao `.csproj`:
325
- ```xml
326
- <RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>
327
- ```
328
-
329
- ### Managed Identity não funciona
330
-
331
- **Sintoma:** Acesso negado a Key Vault ou outros recursos.
332
-
333
- **Verificar:**
334
- 1. Identity habilitada no Container App
335
- 2. RBAC atribuída (Key Vault Secrets User, etc.)
336
- 3. Aguardar 5-10 min após atribuição
337
-
338
- ```bash
339
- # Verificar identity
340
- az containerapp identity show \
341
- --name $APP_NAME \
342
- --resource-group $RG_NAME
343
-
344
- # Verificar RBAC
345
- az role assignment list \
346
- --assignee <IDENTITY_PRINCIPAL_ID> \
347
- --scope <KEY_VAULT_ID>
348
- ```
349
-
350
- ### DefaultAzureCredential lento
351
-
352
- **Sintoma:** Startup demora 30+ segundos.
353
-
354
- **Solução:** Desabilitar credenciais não usadas (ver azure.md).
355
-
356
- ### Migrations não aplicadas
357
-
358
- **Sintoma:** `Invalid object name 'TableName'`
359
-
360
- **Solução:**
361
- ```bash
362
- # Opção 1: Rodar migration no pipeline
363
- dotnet ef database update
364
-
365
- # Opção 2: Auto-migrate no startup (dev/staging only)
366
- app.Services.CreateScope().ServiceProvider
367
- .GetRequiredService<AppDbContext>()
368
- .Database.Migrate();
369
- ```
370
-
371
- ---
372
-
373
- ## Logs e Debugging
374
-
375
- ### Container Apps Logs
376
-
377
- ```bash
378
- # Logs em tempo real
379
- az containerapp logs show \
380
- --name $APP_NAME \
381
- --resource-group $RG_NAME \
382
- --follow
383
-
384
- # Últimas 100 linhas
385
- az containerapp logs show \
386
- --name $APP_NAME \
387
- --resource-group $RG_NAME \
388
- --tail 100
389
- ```
390
-
391
- ### Application Insights
392
-
393
- ```bash
394
- # Query de exceptions
395
- az monitor app-insights query \
396
- --app $APPINSIGHTS_NAME \
397
- --analytics-query "exceptions | take 10"
398
- ```
399
-
400
- ### Container App Status
401
-
402
- ```bash
403
- # Status geral
404
- az containerapp show \
405
- --name $APP_NAME \
406
- --resource-group $RG_NAME \
407
- --query "{status:properties.runningStatus,replicas:properties.template.scale}"
408
-
409
- # Revisões
410
- az containerapp revision list \
411
- --name $APP_NAME \
412
- --resource-group $RG_NAME \
413
- --query "[].{name:name,active:properties.active,traffic:properties.trafficWeight}"
414
- ```
415
-
416
- ---
417
-
418
- ## Referências
419
-
420
- - [azure.md](../../standards/azure.md) - Padrões Azure
421
- - [morph-preflight.md](../../../.claude/commands/morph-preflight.md) - Comando de validação
422
- - [blazor-efcore.md](../../../../framework/standards/blazor-efcore.md) - EF Core patterns
423
-
424
- ---
425
-
426
- *MORPH-SPEC by Polymorphism Tech*
1
+ # Deploy Checklist & Scripts
2
+
3
+ > Guia completo para deploy seguro em Azure.
4
+
5
+ ---
6
+
7
+ ## Pre-Deploy Checklist
8
+
9
+ ### 1. Código
10
+
11
+ - [ ] Build passa sem erros: `dotnet build`
12
+ - [ ] Testes passando: `dotnet test`
13
+ - [ ] Sem warnings críticos de segurança
14
+ - [ ] Code review aprovado (se aplicável)
15
+
16
+ ### 2. Packages
17
+
18
+ - [ ] Sem conflitos de versão (NU1605/NU1608)
19
+ - [ ] `Azure.Identity` especificado explicitamente:
20
+ ```xml
21
+ <PackageReference Include="Azure.Identity" Version="1.14.2" />
22
+ ```
23
+ - [ ] Packages atualizados para versões estáveis
24
+
25
+ ### 3. EF Core Migrations
26
+
27
+ - [ ] Sem pending model changes:
28
+ ```bash
29
+ dotnet ef migrations has-pending-model-changes \
30
+ --project src/Infrastructure \
31
+ --startup-project src/Web
32
+ ```
33
+ - [ ] Migration criada se necessário:
34
+ ```bash
35
+ dotnet ef migrations add <Name> \
36
+ --project src/Infrastructure \
37
+ --startup-project src/Web
38
+ ```
39
+ - [ ] Script SQL gerado e revisado:
40
+ ```bash
41
+ dotnet ef migrations script --idempotent -o migration.sql
42
+ ```
43
+
44
+ ### 4. Blazor .NET 10 (se aplicável)
45
+
46
+ - [ ] `.csproj` contém:
47
+ ```xml
48
+ <RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>
49
+ ```
50
+ - [ ] Static assets funcionam localmente
51
+
52
+ ### 5. Docker/Container (se Container Apps)
53
+
54
+ - [ ] Dockerfile válido
55
+ - [ ] Build funciona:
56
+ ```bash
57
+ docker build --no-cache -t myapp:test .
58
+ ```
59
+ - [ ] Container roda localmente:
60
+ ```bash
61
+ docker run -p 8080:8080 myapp:test
62
+ ```
63
+
64
+ ### 6. Infraestrutura Azure
65
+
66
+ - [ ] Bicep válido:
67
+ ```bash
68
+ az bicep build --file infra/main.bicep
69
+ ```
70
+ - [ ] Key Vault configurado
71
+ - [ ] Managed Identity habilitada
72
+ - [ ] Connection strings em Key Vault (não hardcoded)
73
+
74
+ ### 7. Segurança
75
+
76
+ - [ ] Sem secrets em `appsettings.json`:
77
+ ```bash
78
+ grep -rE "(Password=|Pwd=|Secret=)" appsettings*.json | grep -v Development
79
+ ```
80
+ - [ ] HTTPS enforçado
81
+ - [ ] CORS configurado
82
+
83
+ ---
84
+
85
+ ## Scripts de Deploy
86
+
87
+ ### Script Completo - Container Apps
88
+
89
+ ```bash
90
+ #!/bin/bash
91
+ # deploy-container-app.sh
92
+ # Usage: ./deploy-container-app.sh [dev|staging|prod]
93
+
94
+ set -e
95
+
96
+ ENV="${1:-staging}"
97
+ PROJECT_NAME="myapp"
98
+
99
+ # Configurações por ambiente
100
+ case $ENV in
101
+ dev)
102
+ RG_NAME="rg-${PROJECT_NAME}-dev"
103
+ APP_NAME="ca-${PROJECT_NAME}-dev"
104
+ ACR_NAME="acr${PROJECT_NAME}dev"
105
+ ;;
106
+ staging)
107
+ RG_NAME="rg-${PROJECT_NAME}-stg"
108
+ APP_NAME="ca-${PROJECT_NAME}-stg"
109
+ ACR_NAME="acr${PROJECT_NAME}stg"
110
+ ;;
111
+ prod)
112
+ RG_NAME="rg-${PROJECT_NAME}-prod"
113
+ APP_NAME="ca-${PROJECT_NAME}-prod"
114
+ ACR_NAME="acr${PROJECT_NAME}prod"
115
+ ;;
116
+ *)
117
+ echo "Ambiente inválido: $ENV"
118
+ exit 1
119
+ ;;
120
+ esac
121
+
122
+ IMAGE_TAG="${GITHUB_SHA:-$(git rev-parse --short HEAD)}"
123
+
124
+ echo "🚀 Deploying to $ENV environment..."
125
+ echo " Resource Group: $RG_NAME"
126
+ echo " Container App: $APP_NAME"
127
+ echo " Image Tag: $IMAGE_TAG"
128
+
129
+ # 1. Pre-flight checks
130
+ echo "📋 Running pre-flight checks..."
131
+
132
+ # Check pending migrations
133
+ if ! dotnet ef migrations has-pending-model-changes \
134
+ --project src/Infrastructure \
135
+ --startup-project src/Web 2>/dev/null; then
136
+ echo "⚠️ Warning: Pending model changes detected"
137
+ read -p "Continue anyway? (y/N) " -n 1 -r
138
+ echo
139
+ if [[ ! $REPLY =~ ^[Yy]$ ]]; then
140
+ exit 1
141
+ fi
142
+ fi
143
+
144
+ # 2. Build Docker image
145
+ echo "🐳 Building Docker image..."
146
+ docker build --no-cache -t ${ACR_NAME}.azurecr.io/${PROJECT_NAME}:${IMAGE_TAG} .
147
+ docker tag ${ACR_NAME}.azurecr.io/${PROJECT_NAME}:${IMAGE_TAG} \
148
+ ${ACR_NAME}.azurecr.io/${PROJECT_NAME}:latest
149
+
150
+ # 3. Push to ACR
151
+ echo "📤 Pushing to ACR..."
152
+ az acr login --name $ACR_NAME
153
+ docker push ${ACR_NAME}.azurecr.io/${PROJECT_NAME}:${IMAGE_TAG}
154
+ docker push ${ACR_NAME}.azurecr.io/${PROJECT_NAME}:latest
155
+
156
+ # 4. Update Container App (with timestamp to force new revision)
157
+ echo "🔄 Updating Container App..."
158
+ az containerapp update \
159
+ --name $APP_NAME \
160
+ --resource-group $RG_NAME \
161
+ --image ${ACR_NAME}.azurecr.io/${PROJECT_NAME}:${IMAGE_TAG} \
162
+ --set-env-vars "DEPLOY_TIMESTAMP=$(date +%s)"
163
+
164
+ # 5. Wait for deployment
165
+ echo "⏳ Waiting for deployment..."
166
+ sleep 10
167
+
168
+ # 6. Verify
169
+ echo "✅ Verifying deployment..."
170
+ STATUS=$(az containerapp show \
171
+ --name $APP_NAME \
172
+ --resource-group $RG_NAME \
173
+ --query "properties.runningStatus" -o tsv)
174
+
175
+ if [ "$STATUS" == "Running" ]; then
176
+ echo "✅ Deployment successful!"
177
+ FQDN=$(az containerapp show \
178
+ --name $APP_NAME \
179
+ --resource-group $RG_NAME \
180
+ --query "properties.configuration.ingress.fqdn" -o tsv)
181
+ echo "🌐 URL: https://$FQDN"
182
+ else
183
+ echo "❌ Deployment failed! Status: $STATUS"
184
+ echo "📋 Checking logs..."
185
+ az containerapp logs show \
186
+ --name $APP_NAME \
187
+ --resource-group $RG_NAME \
188
+ --tail 50
189
+ exit 1
190
+ fi
191
+
192
+ # 7. Health check
193
+ echo "🏥 Running health check..."
194
+ HEALTH_URL="https://$FQDN/health"
195
+ HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" $HEALTH_URL || echo "000")
196
+
197
+ if [ "$HTTP_CODE" == "200" ]; then
198
+ echo "✅ Health check passed!"
199
+ else
200
+ echo "⚠️ Health check returned: $HTTP_CODE"
201
+ fi
202
+
203
+ echo ""
204
+ echo "🎉 Deploy complete!"
205
+ ```
206
+
207
+ ### Script Verificação Pré-Deploy
208
+
209
+ ```bash
210
+ #!/bin/bash
211
+ # preflight-check.sh
212
+ # Valida projeto antes de deploy
213
+
214
+ set -e
215
+
216
+ echo "🔍 MORPH Pre-Flight Check"
217
+ echo "━━━━━━━━━━━━━━━━━━━━━━━━━━"
218
+
219
+ ERRORS=0
220
+ WARNINGS=0
221
+
222
+ # 1. Package conflicts
223
+ echo -n "📦 Checking packages... "
224
+ if dotnet restore 2>&1 | grep -qE "NU1605|NU1608"; then
225
+ echo "❌ Version conflicts detected"
226
+ ((ERRORS++))
227
+ else
228
+ echo "✅"
229
+ fi
230
+
231
+ # 2. Pending migrations
232
+ echo -n "🗄️ Checking migrations... "
233
+ if ! dotnet ef migrations has-pending-model-changes \
234
+ --project src/Infrastructure \
235
+ --startup-project src/Web 2>/dev/null; then
236
+ echo "❌ Pending changes"
237
+ ((ERRORS++))
238
+ else
239
+ echo "✅"
240
+ fi
241
+
242
+ # 3. Build
243
+ echo -n "🔨 Checking build... "
244
+ if ! dotnet build --nologo -v q 2>/dev/null; then
245
+ echo "❌ Build failed"
246
+ ((ERRORS++))
247
+ else
248
+ echo "✅"
249
+ fi
250
+
251
+ # 4. Blazor assets (.NET 10)
252
+ echo -n "🎨 Checking Blazor assets... "
253
+ if grep -q "net10.0" *.csproj 2>/dev/null; then
254
+ if ! grep -q "RequiresAspNetWebAssets.*true" *.csproj 2>/dev/null; then
255
+ echo "❌ Missing RequiresAspNetWebAssets"
256
+ ((ERRORS++))
257
+ else
258
+ echo "✅"
259
+ fi
260
+ else
261
+ echo "⏭️ Not .NET 10"
262
+ fi
263
+
264
+ # 5. Bicep
265
+ echo -n "📐 Checking Bicep... "
266
+ if [ -f "infra/main.bicep" ]; then
267
+ if ! az bicep build --file infra/main.bicep --stdout >/dev/null 2>&1; then
268
+ echo "❌ Syntax errors"
269
+ ((ERRORS++))
270
+ else
271
+ echo "✅"
272
+ fi
273
+ else
274
+ echo "⏭️ No Bicep files"
275
+ fi
276
+
277
+ # 6. Secrets scan
278
+ echo -n "🔐 Checking secrets... "
279
+ if grep -rE "(Password=|Pwd=|Secret=)" appsettings*.json 2>/dev/null | grep -v Development; then
280
+ echo "⚠️ Secrets in config"
281
+ ((WARNINGS++))
282
+ else
283
+ echo "✅"
284
+ fi
285
+
286
+ # Summary
287
+ echo ""
288
+ echo "━━━━━━━━━━━━━━━━━━━━━━━━━━"
289
+ if [ $ERRORS -eq 0 ]; then
290
+ if [ $WARNINGS -eq 0 ]; then
291
+ echo "✅ All checks passed!"
292
+ else
293
+ echo "⚠️ $WARNINGS warning(s), but OK to deploy"
294
+ fi
295
+ exit 0
296
+ else
297
+ echo "❌ $ERRORS error(s) found. Fix before deploy!"
298
+ exit 1
299
+ fi
300
+ ```
301
+
302
+ ---
303
+
304
+ ## Troubleshooting Deploy
305
+
306
+ ### Container App não atualiza
307
+
308
+ **Sintoma:** Após push, Container App continua com versão antiga.
309
+
310
+ **Causa:** Mesmo digest de imagem não triggera nova revisão.
311
+
312
+ **Solução:**
313
+ ```bash
314
+ az containerapp update \
315
+ --name $APP_NAME \
316
+ --resource-group $RG_NAME \
317
+ --set-env-vars "DEPLOY_TIMESTAMP=$(date +%s)"
318
+ ```
319
+
320
+ ### blazor.web.js 404
321
+
322
+ **Sintoma:** Página Blazor não carrega.
323
+
324
+ **Solução:** Adicionar ao `.csproj`:
325
+ ```xml
326
+ <RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>
327
+ ```
328
+
329
+ ### Managed Identity não funciona
330
+
331
+ **Sintoma:** Acesso negado a Key Vault ou outros recursos.
332
+
333
+ **Verificar:**
334
+ 1. Identity habilitada no Container App
335
+ 2. RBAC atribuída (Key Vault Secrets User, etc.)
336
+ 3. Aguardar 5-10 min após atribuição
337
+
338
+ ```bash
339
+ # Verificar identity
340
+ az containerapp identity show \
341
+ --name $APP_NAME \
342
+ --resource-group $RG_NAME
343
+
344
+ # Verificar RBAC
345
+ az role assignment list \
346
+ --assignee <IDENTITY_PRINCIPAL_ID> \
347
+ --scope <KEY_VAULT_ID>
348
+ ```
349
+
350
+ ### DefaultAzureCredential lento
351
+
352
+ **Sintoma:** Startup demora 30+ segundos.
353
+
354
+ **Solução:** Desabilitar credenciais não usadas (ver azure.md).
355
+
356
+ ### Migrations não aplicadas
357
+
358
+ **Sintoma:** `Invalid object name 'TableName'`
359
+
360
+ **Solução:**
361
+ ```bash
362
+ # Opção 1: Rodar migration no pipeline
363
+ dotnet ef database update
364
+
365
+ # Opção 2: Auto-migrate no startup (dev/staging only)
366
+ app.Services.CreateScope().ServiceProvider
367
+ .GetRequiredService<AppDbContext>()
368
+ .Database.Migrate();
369
+ ```
370
+
371
+ ---
372
+
373
+ ## Logs e Debugging
374
+
375
+ ### Container Apps Logs
376
+
377
+ ```bash
378
+ # Logs em tempo real
379
+ az containerapp logs show \
380
+ --name $APP_NAME \
381
+ --resource-group $RG_NAME \
382
+ --follow
383
+
384
+ # Últimas 100 linhas
385
+ az containerapp logs show \
386
+ --name $APP_NAME \
387
+ --resource-group $RG_NAME \
388
+ --tail 100
389
+ ```
390
+
391
+ ### Application Insights
392
+
393
+ ```bash
394
+ # Query de exceptions
395
+ az monitor app-insights query \
396
+ --app $APPINSIGHTS_NAME \
397
+ --analytics-query "exceptions | take 10"
398
+ ```
399
+
400
+ ### Container App Status
401
+
402
+ ```bash
403
+ # Status geral
404
+ az containerapp show \
405
+ --name $APP_NAME \
406
+ --resource-group $RG_NAME \
407
+ --query "{status:properties.runningStatus,replicas:properties.template.scale}"
408
+
409
+ # Revisões
410
+ az containerapp revision list \
411
+ --name $APP_NAME \
412
+ --resource-group $RG_NAME \
413
+ --query "[].{name:name,active:properties.active,traffic:properties.trafficWeight}"
414
+ ```
415
+
416
+ ---
417
+
418
+ ## Referências
419
+
420
+ - [azure.md](../../standards/azure.md) - Padrões Azure
421
+ - [morph-preflight.md](../../../.claude/commands/morph-preflight.md) - Comando de validação
422
+ - [blazor-efcore.md](../../../../framework/standards/blazor-efcore.md) - EF Core patterns
423
+
424
+ ---
425
+
426
+ *MORPH-SPEC by Polymorphism Tech*