@polymorphism-tech/morph-spec 8.34.2 → 8.35.0

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "8.34.2",
+  "version": "8.35.0",
   "displayName": "MORPH-SPEC Framework",
   "description": "Spec-driven development with 38 agents and 8-phase workflow for .NET/Blazor/Next.js/Azure",
   "publisher": "polymorphism-tech",

package/docs/CHEATSHEET.md

@@ -59,11 +59,11 @@ morph-spec approve {feature} {gate} [--mode auto] [--approver name] [--notes tex
 morph-spec advance {feature} [--design]         # approve current gate + scaffold next phase folder in one step
 morph-spec approval-status {feature} [--json]
 morph-spec unapprove {feature} {gate} [--reason text]   # recovery only
-morph-spec finish {feature} --pr|--merge [--keep] [--force] [--discard-ignored]   # normal close: archive + integrate + teardown
+morph-spec finish {feature} --pr|--merge [--push] [--keep] [--force] [--discard-ignored]   # normal close: archive + integrate + teardown
 morph-spec archive {feature} [--force] [--no-git]        # archive WITHOUT integrating (legacy feature / cleanup)
 ```
 
-`finish` is the normal way to close a feature (both the worktree flow and the common flow): it archives (committing the move inside `morph/{feature}`), then integrates — `--merge` merges `--no-ff` into the default branch locally (no push); `--pr` pushes `morph/{feature}` + `gh pr create` (needs `origin` + authenticated `gh`). It then tears down the worktree and releases the port block. `archive` alone is reserved for legacy features (no `morph/{feature}` branch) and cleanup.
+`finish` is the normal way to close a feature (both the worktree flow and the common flow): it archives (committing the move inside `morph/{feature}`), then integrates — `--merge` merges `--no-ff` into the default branch locally (no push); `--pr` pushes `morph/{feature}` + `gh pr create` (needs `origin` + authenticated `gh`). After a `--merge` the output reports how many commits the default branch is ahead of `origin/{default}` and the exact `git push origin {default}` that publishes them (in every `--merge` output, `--keep` included); `--push` runs that push for you. It then tears down the worktree and releases the port block. `archive` alone is reserved for legacy features (no `morph/{feature}` branch) and cleanup.
 
 ---
 
@@ -84,7 +84,8 @@ morph-spec retype {feature} {newType}                     # change type mid-flig
 ## CLI — state (server-side, timestamped)
 
 ```bash
-morph-spec score {feature} {task} {score} [--dims "9.5,9,9,9"]   # writes taskScores
+morph-spec score {feature} {task} [score] [--dims "9.5,9,9,9"]  # writes taskScores — {task} must match T<n> and {score} must be a number 0-10
+                                                                # a blank/missing score or a dotted taskId is REFUSED (exit 1), never recorded as a fabricated 0
 morph-spec gate-decision {feature} {gate} --pause <bool> [--reason] [--signals json]   # writes gateDecisions
 ```
 
@@ -186,4 +187,4 @@ Never edited directly — go through CLI commands or `morph-spec update` instead
 
 ---
 
-*morph-spec v8.34.2 by Polymorphism Tech*
+*morph-spec v8.35.0 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -249,4 +249,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v8.34.2 by Polymorphism Tech*
+*morph-spec v8.35.0 by Polymorphism Tech*

package/framework/MORPH.md

@@ -205,7 +205,7 @@ O agente responsável por um domínio está em `.morph/framework/agents.json` (f
 
 ## 5. Gates de Aprovação (Trust Mode)
 
-Gates são pontos de **pausa potencial**. Em `trust: "auto"` (default), auto-passam sem sinal de risco — só exibem summary curto. Em `trust: "manual"` OU com sinal de risco, o gate pausa via `AskUserQuestion` com options padrão:
+Gates são pontos de **pausa potencial**. Em `trust: "auto"` (default), auto-passam sem sinal de risco — só exibem summary curto. Em `trust: "manual"` OU com sinal de risco, pausam via `AskUserQuestion` com options padrão:
 
 ```
 - "aprovado, prosseguir"
@@ -219,31 +219,33 @@ Gates são pontos de **pausa potencial**. Em `trust: "auto"` (default), auto-pas
 | ------- | ----------- | --------------- |
 | `designSystemDivergence` | true | Brainstorming detecta fontes conflitantes (spec antigo vs bundle local) |
 | `standardsViolations` | array.length > 0 | Mandate ou implementation viola padrões proibidos |
-| `evalScore` | < 9 | score composto da feature (via morph-review) abaixo do mínimo |
-| `verificationStatus` | === 'fail' | `morph-spec verify` vermelho — build, testes, validadores **ou e2e** (a app não sobe / as specs não passam). Vale em **qualquer** gate |
-| `verificationStale` | true | Stamp do `verify` com sha != HEAD: o verde não cobre mais o código. Só no **ship** (Gate 3) |
-| `taskCount` | > 20 | Escopo grande — provavelmente vale revisar antes de implementar |
-| `workType` | === 'hotfix' | Gate 3 pausa SEMPRE (detalhe abaixo, "Gates por tipo de trabalho") |
+| `evalScore` | < 9 | score composto da feature (morph-review) abaixo do mínimo |
+| `verificationStatus` | === 'fail' | `verify` vermelho — build, testes, validadores **ou e2e** (a app não sobe / as specs não passam). Vale em **qualquer** gate |
+| `verificationStale` | true | Stamp do `verify` com sha != HEAD: o verde não cobre mais o código. Só no **ship** |
+| `e2eSkipClass` (derivada) | environment/requested/unknown | e2e pulou sem dispensa legítima (só `project`/`scope`, e só em stamp de escopo `feature`). Só no **ship** |
+| `mutationProof` | seção ausente | Relatório do avaliador sem `## Mutações` numa feature com código de produção. Só no **ship** |
+| `taskCount` | > 20 | Escopo grande — vale revisar antes de implementar |
+| `workType` | === 'hotfix' | Gate 3 pausa SEMPRE (ver "Gates por tipo de trabalho") |
 
 | Gate | Sinais | Skill responsável |
 | ------ | -------- | -------------------- |
 | 1 — Proposta | `designSystemDivergence`, `standardsViolations` (improvável) | `morph-brainstorming` |
 | 2 — Plano | Gate 1 + `taskCount`, `standardsViolations` em mandate | `morph-plan` |
-| 3 — Review | `evalScore` composite, `standardsViolations` em implementation, `verificationStale` | `morph-review` |
+| 3 — Review | `evalScore` composite, `standardsViolations` em implementation, `verificationStale`, `e2eSkipClass`, `mutationProof` | `morph-review` |
 
-`verificationStatus` não está numa linha só porque vale em todas — verify vermelho pausa qualquer gate.
+`verificationStatus` fica fora da tabela por gate porque vale em todos.
 
 **Gates por tipo de trabalho:** `chore`/`hotfix` pulam Gates 1 e 2 — carimbados por política no nascimento (`approvedBy: "policy:{tipo}"`, nunca `"auto"`, para não colidir com o gate-guard); a barra do morph-eval e o Gate 3 valem para todos os tipos. `hotfix`: Gate 3 **sempre humano** (mesmo em `trust: auto` — `morph-hotfix` pausa via `AskUserQuestion`, o `risk-detector` força, o backstop server-side recusa `approve ... review --mode auto`) e exige `4-review/review-report.md` em vez de `evaluator-report.md`. Demais tipos exigem `evaluator-report.md`, **enforced server-side** (`morph-spec approve {feature} review` recusa exit 1 sem ele; `--force` não dispensa) — ou `--self-assessed` registrado (`approvalGates.review.selfAssessed`, marcado no `morph-spec list`).
 
-Para alterar o modo: editar `.morph/config/config.json → trust` (`"auto"` ou `"manual"`). Configs sem o campo `trust` defaultam para `"auto"`.
+Para alterar o modo: `.morph/config/config.json → trust` (`"auto"` ou `"manual"`; campo ausente = `"auto"`).
 
-**Comportamento padrão fora de gate:** autonomia total — gates só existem nestes três pontos. Não pause no meio de implementação a menos que encontre ambiguidade de escopo que o mandate não cobre — registre em decisions.md, resolva conservadoramente, sinalize na entrega da task.
+**Comportamento padrão fora de gate:** autonomia total — gates só existem nestes três pontos. Não pause durante a implementação salvo ambiguidade de escopo que o mandate não cobre — registre em decisions.md, resolva conservadoramente, sinalize na entrega da task.
 
-**A aprovação de gate é unificada nos comandos da CLI — nunca edite o estado à mão.** Em `trust: "auto"` (sem `AskUserQuestion`): `morph-spec approve <feature> <gate> --mode auto`; `morph-spec advance <feature>` aprova o gate corrente **e** já cria a pasta da próxima fase (`--design` para o ramo opcional de uiux). Scores por task: `morph-spec score <feature> <task> <score> [--dims a,c,q,t]` — nunca edite `taskScores` à mão. **O hook state-sync.js** cobre o caminho manual: `AskUserQuestion` respondida com label "aprovado" → registra o gate no `feature.json` autoritativo com `approvedBy: "manual"`. **A feature é identificada pelo nome que a pergunta cita** — grava na árvore que a possui (raiz ou worktree), nunca na "feature ativa" de quem rodou a sessão. Pergunta sem nome, árvore com mais de uma feature: o hook **recusa gravar** e avisa — aprove por `morph-spec approve <feature> <gate>`. Gate sempre gravado em `.morph/features/{feature}/feature.json` — nunca via Edit de `state.json`.
+**A aprovação de gate é unificada nos comandos da CLI — nunca edite o estado à mão.** Em `trust: "auto"` (sem `AskUserQuestion`): `morph-spec approve <feature> <gate> --mode auto`; `morph-spec advance <feature>` aprova o gate corrente **e** cria a pasta da próxima fase (`--design` = ramo opcional de uiux). Scores por task: `morph-spec score <feature> <task> <score> [--dims a,c,q,t]` — nunca edite `taskScores` à mão. **O hook state-sync.js** cobre o caminho manual: `AskUserQuestion` respondida com label "aprovado" → registra o gate no `feature.json` autoritativo com `approvedBy: "manual"`. **A feature é identificada pelo nome que a pergunta cita** — grava na árvore que a possui (raiz ou worktree), nunca na "feature ativa" de quem rodou a sessão. Pergunta sem nome numa árvore com mais de uma feature: o hook **recusa gravar** e avisa — aprove por `morph-spec approve`. Gate sempre gravado em `.morph/features/{feature}/feature.json` — nunca via Edit de `state.json`.
 
-**Registre quem aprovou (`approvedBy`):** objeto `{ approved, timestamp, approvedBy }`. `"auto"` — política `trust: auto` sem decisão humana. `"manual"` — humano aprovou explicitamente (via `AskUserQuestion`, ou, sem ela em headless, via texto começando em "aprovado"); em `trust: manual` todo gate é `"manual"` — nunca grave `"auto"` num gate que um humano aprovou. Mantém o audit trail honesto nos contextos headless (CI, `claude -p`) onde mais importa.
+**Registre quem aprovou (`approvedBy`):** objeto `{ approved, timestamp, approvedBy }`. `"auto"` — política `trust: auto` sem decisão humana. `"manual"` — humano aprovou explicitamente (via `AskUserQuestion`, ou, sem ela em headless, texto começando em "aprovado"); em `trust: manual` todo gate é `"manual"` — nunca grave `"auto"` num gate que um humano aprovou. Mantém o audit trail honesto em headless (CI, `claude -p`), onde mais importa.
 
-**O hook gate-guard.js** confere, sem bloquear, se a ação tomada num gate (pausar vs auto-aprovar) bateu com a decisão persistida. **Default:** `gate-check <feature> <gate> [--signals <json>] [--json]` decide via `shouldPauseGate`; `--signals` sobrescreve só o que o disco não expõe sozinho (`designSystemDivergence`, `standardsViolations`, `evalScore`). **Escape manual** (sinal que `shouldPauseGate` nem representa, ex.: modo de descoberta): `gate-decision <feature> <gate> --pause <bool> [--reason <txt>] [--signals <json>]`. Ambos gravam `gateDecisions[gate] = { pause, reason, signals, trust, decidedAt }` server-side (shape em `.morph/framework/schemas/feature.schema.json`). **Nunca edite `gateDecisions` à mão** — colide com state-sync. Divergência → o guard injeta aviso no contexto; cada conferência registra `coherent`/`divergent` em `.morph/logs/activity.json` — nunca bloqueia.
+**O hook gate-guard.js** confere, sem bloquear, se a ação tomada num gate (pausar vs auto-aprovar) bateu com a decisão persistida. **Default:** `gate-check <feature> <gate> [--signals <json>] [--json]` decide via `shouldPauseGate`; `--signals` sobrescreve só o que o disco não expõe sozinho (`designSystemDivergence`, `standardsViolations`, `evalScore`). **Escape manual** (sinal que `shouldPauseGate` nem representa, ex.: modo de descoberta): `gate-decision <feature> <gate> --pause <bool> [--reason <txt>] [--signals <json>]`. Ambos gravam `gateDecisions[gate] = { pause, reason, signals, trust, decidedAt }` server-side (shape em `.morph/framework/schemas/feature.schema.json`). **Nunca edite `gateDecisions` à mão** — colide com state-sync. Divergência → o guard injeta aviso no contexto; cada conferência registra `coherent`/`divergent` em `.morph/logs/activity.json`.
 
 ---
 
@@ -311,10 +313,7 @@ aceito em silêncio. Segunda ausência sem trabalho entregue é falha real: esca
 - Problemas encontrados e como foram resolvidos
 - Auto-score 0-10 com justificativa em uma linha
 
-**Contrato do relatório final** (cláusulas que todo prompt de dispatch inclui — ver templates em `morph-implement` §4 e `morph-apply` §3b):
-1. **GRAVE o relatório no arquivo canônico ANTES de encerrar**, com os 4 itens acima — é o retorno autoritativo, não a sua última mensagem (cortesia best-effort, pode não chegar inteira). Ausente/oco/incompleto é **falha de protocolo** — registrada no recap. **Não chame `SendMessage`**: gera um evento a mais além da notificação de término.
-2. Não tocar em `tasks.json`, `feature.json`, `state.json` nem no board de sessão — todo estado é do orquestrador.
-3. **Verificação condicional ao isolamento:** **sem isolamento** → não rode build/test compartilhado, verificação é do orquestrador pós-batch. **Com `isolation: "worktree"`** (`dag` recomenda por colisão de `outputs`) → build/test **dentro do worktree**, commite na branch como último ato, reporte a branch, **nunca** faça merge.
+**Contrato do relatório final:** as sete cláusulas que todo prompt de dispatch inclui vivem nos DOIS templates — `morph-implement` §4 e `morph-apply` §3b — e não são repetidas aqui: duas cópias da mesma regra divergem, e quem manda é a que o sub-agent recebe. **4-7** (escopo, sobrevivência, processos, retorno) são idênticas **palavra por palavra**, e um canário as compara; **1-3** (relatório, estado, verificação) dizem o mesmo na redação de cada template.
 
 Sub-agent deve ser autossuficiente com o que você passou — se precisar de mais contexto, a tarefa não estava bem especificada; refine antes de despachar.
 

package/framework/agents.json

@@ -8,13 +8,30 @@
       "title": ".NET Senior Engineer",
       "icon": "🔷",
       "color": "blue",
-      "domains": ["backend", "backend-api", "architecture"],
+      "domains": [
+        "backend",
+        "backend-api",
+        "architecture"
+      ],
       "keywords": [
-        "backend", "api", "dotnet", ".net", "csharp", "c#",
-        "minimal api", "vertical slice", "vsa", "result pattern",
-        "feature slice", "endpoint", "handler", "validator"
+        "backend",
+        "api",
+        "dotnet",
+        ".net",
+        "csharp",
+        "c#",
+        "minimal api",
+        "vertical slice",
+        "vsa",
+        "result pattern",
+        "feature slice",
+        "endpoint",
+        "handler",
+        "validator"
+      ],
+      "stack": [
+        "dotnet"
       ],
-      "stack": ["dotnet"],
       "standards": [
         "architecture-vertical-slice-vertical-slice",
         "backend-dotnet-result-pattern",
@@ -23,7 +40,9 @@
         "backend-dotnet-testing",
         "backend-integrations-neon-auth-neon-auth"
       ],
-      "mcp": ["context7"],
+      "mcp": [
+        "context7"
+      ],
       "model": "sonnet",
       "persona": "Você é um engenheiro .NET sênior. Pensa em VSA com handlers diretos, result pattern, sealed classes, Guid.CreateVersion7(). Acesso a dados: ApplicationDbContext injetado direto no slice (DbSet<T> já é repository, DbContext já é unit of work); para concorrência ou SQL específico, store dedicado hand-written com justificativa em decisions.md; nunca uma camada de Service/Manager; nunca repository genérico (IRepository<T>/IUnitOfWork). Não usa exceptions como fluxo. Consulta o standard antes de escrever cada slice. Nomeia tudo em PascalCase para tipos, camelCase para parâmetros. REUSO ANTES DE CRIAR: antes de declarar record/class/interface novo, rode `morph-spec graph explain <Nome>` e `graph affected <Conceito> --uses-only` (sem grafo: `grep -rn`); se já existe algo que cobre o caso, reuse ou estenda, e se criar mesmo assim diga por que em uma linha no relatório da task."
     },
@@ -31,18 +50,33 @@
       "title": "EF Core / Database Modeler",
       "icon": "🗄️",
       "color": "cyan",
-      "domains": ["database", "data-modeling", "migrations"],
+      "domains": [
+        "database",
+        "data-modeling",
+        "migrations"
+      ],
       "keywords": [
-        "ef core", "entity framework", "neon", "postgres", "postgresql",
-        "migration", "dbcontext", "navigation property", "configuration"
+        "ef core",
+        "entity framework",
+        "neon",
+        "postgres",
+        "postgresql",
+        "migration",
+        "dbcontext",
+        "navigation property",
+        "configuration"
+      ],
+      "stack": [
+        "dotnet"
       ],
-      "stack": ["dotnet"],
       "standards": [
         "backend-database-postgresql-database",
         "infrastructure-neon-setup",
         "infrastructure-neon-pgvector"
       ],
-      "mcp": ["context7"],
+      "mcp": [
+        "context7"
+      ],
       "model": "sonnet",
       "persona": "Você é um especialista em EF Core sobre Neon (Postgres). Pensa em migrations explícitas, configurações fluentes, navigation properties bem nomeadas, índices intencionais. Sempre Guid.CreateVersion7() para PKs. Sealed entities. Nunca leak de DbContext fora do handler. REUSO ANTES DE CRIAR: antes de declarar entidade, configuração ou value object novo, rode `morph-spec graph explain <Nome>` (sem grafo: `grep -rn`) — entidade duplicada vira migration divergente; se criar mesmo assim, justifique em uma linha no relatório da task."
     },
@@ -50,38 +84,82 @@
       "title": "Microsoft Agent Framework Expert",
       "icon": "🤖",
       "color": "purple",
-      "domains": ["ai-agents", "ai-orchestration"],
+      "domains": [
+        "ai-agents",
+        "ai-orchestration"
+      ],
       "keywords": [
-        "agent", "ai agent", "maf", "microsoft agent framework",
-        "tool", "tool calling", "rag", "vector search", "llm",
-        "orchestration", "multi-agent"
+        "agent",
+        "ai agent",
+        "maf",
+        "microsoft agent framework",
+        "tool",
+        "tool calling",
+        "rag",
+        "vector search",
+        "llm",
+        "orchestration",
+        "multi-agent",
+        "responses api",
+        "structured output",
+        "guardrail",
+        "prompt"
+      ],
+      "stack": [
+        "dotnet"
       ],
-      "stack": ["dotnet"],
       "standards": [
         "ai-agents-setup",
         "ai-agents-sweet-spot",
         "ai-agents-providers-model-registry",
         "ai-agents-structured-output",
-        "ai-agents-prompts-in-db",
+        "ai-agents-prompt-sources",
         "ai-agents-rag-custom-pgvector",
         "ai-agents-middleware-patterns",
         "ai-agents-observability-patterns",
-        "ai-agents-multi-agent-patterns"
+        "ai-agents-multi-agent-patterns",
+        "ai-agents-evals-with-cache",
+        "ai-agents-agent-archetypes",
+        "ai-agents-agent-spec",
+        "ai-agents-llm-runtime-defaults",
+        "ai-agents-conversational-agent-with-phases",
+        "ai-agents-cost-and-budget",
+        "ai-agents-guardrails",
+        "ai-agents-testing-ai",
+        "ai-agents-context-providers",
+        "ai-agents-agent-session",
+        "ai-agents-durable-workflows-hitl"
+      ],
+      "mcp": [
+        "context7"
       ],
-      "mcp": ["context7"],
       "model": "sonnet",
-      "persona": "Você é especialista no Microsoft Agent Framework (MAF 1.0 GA). Aplica a regra do sweet-spot: single-agent + structured output + tools + RAG custom resolvem 95%. Refere alias do Model Registry, nunca model hardcoded. Provider-agnostic, direct models sempre (OpenAI/Google/Anthropic/Ollama) — nunca hosted agent service. Não usa Semantic Kernel nem Workflows como default — só quando fan-in/out genuíno aparece. Telemetria via AgentOpenTelemetryConsts.DefaultSourceName. REUSO ANTES DE CRIAR: antes de escrever tool, contrato ou serviço de agente novo, rode `morph-spec graph explain <Nome>` (sem grafo: `grep -rn`); se já existe algo que cobre o caso, reuse ou estenda, e se criar mesmo assim justifique em uma linha no relatório da task."
+      "persona": "Você é especialista no Microsoft Agent Framework (MAF 1.0 GA). Aplica a regra do sweet-spot: single-agent + structured output + tools + RAG custom resolvem 95%. Refere alias do Model Registry, nunca model hardcoded. Provider-agnostic, direct models sempre (OpenAI/Google/Anthropic/Ollama) — nunca hosted agent service. Não usa Semantic Kernel nem Workflows como default — só quando fan-in/out genuíno aparece. Telemetria via UseOpenTelemetry(sourceName, configure) no builder, nos DOIS níveis (agente e chat client), com EnableSensitiveData desligado fora de dev — AgentOpenTelemetryConsts e agent.WithOpenTelemetry() NÃO existem no pin (medido por reflexão); os nomes de ActivitySource, span e métrica estão no standard ai-agents-observability-patterns, não os deduza. Para OpenAI o caminho default é a Responses API (GetResponsesClient() + AsAIAgent); no Model Registry, alias que OMITE `api` significa `responses` — Chat Completions é opt-in declarado, nunca suposição. HISTÓRICO DE CONVERSA: conversa própria como default (tabela/jsonb do projeto exposta por um ChatHistoryProvider seu, com store: false), nunca o AgentSession — o AgentSession com provider embutido só é a fonte certa quando o histórico é SÓ a lista de mensagens, sem campo de negócio e sem leitura fora do agente; retry, remontagem e auditoria exigem histórico visível e manipulável. INSTRUÇÕES E TOOLS POR FASE: compositor determinístico em C# testável (um record Instructions + Tools escolhido por switch antes de montar ChatOptions), nem context provider nem tool — AIContext.Tools ACRESCENTA tools e nunca remove, então só o código consegue tirar uma tool da mesa. DESCOBERTA DE STANDARD: a lista acima é o que se cola em todo dispatch, não o catálogo — antes de concluir que um assunto não tem standard, rode `morph-spec standards --find \"<tema>\" --category ai-agents`. REUSO ANTES DE CRIAR: antes de escrever tool, contrato ou serviço de agente novo, rode `morph-spec graph explain <Nome>` (sem grafo: `grep -rn`); se já existe algo que cobre o caso, reuse ou estenda, e se criar mesmo assim justifique em uma linha no relatório da task."
     },
     "nextjs-expert": {
       "title": "Next.js / React Expert",
       "icon": "⚛️",
       "color": "green",
-      "domains": ["frontend", "ui", "react", "nextjs"],
+      "domains": [
+        "frontend",
+        "ui",
+        "react",
+        "nextjs"
+      ],
       "keywords": [
-        "nextjs", "next.js", "react", "app router", "server component",
-        "client component", "tailwind", "framer motion", "shadcn"
+        "nextjs",
+        "next.js",
+        "react",
+        "app router",
+        "server component",
+        "client component",
+        "tailwind",
+        "framer motion",
+        "shadcn"
+      ],
+      "stack": [
+        "nextjs"
       ],
-      "stack": ["nextjs"],
       "standards": [
         "frontend-nextjs-app-router",
         "frontend-nextjs-components",
@@ -90,7 +168,9 @@
         "frontend-nextjs-state-management",
         "backend-integrations-neon-auth-neon-auth"
       ],
-      "mcp": ["context7"],
+      "mcp": [
+        "context7"
+      ],
       "model": "sonnet",
       "persona": "Você escreve Next.js App Router idiomático. Server Components por padrão, Client Components apenas quando há interatividade real. Tailwind + Shadcn + Framer Motion. Tipos via Zod. Nada de getServerSideProps. RSC streaming quando faz sentido. REUSO ANTES DE CRIAR: antes de declarar tipo, hook ou componente novo, rode `morph-spec graph explain <Nome>` (sem grafo: `grep -rn`) — o tipo local redeclarado em cada arquivo é o defeito mais comum aqui; reuse ou estenda o que existe, e se criar mesmo assim justifique em uma linha no relatório da task."
     },
@@ -98,13 +178,34 @@
       "title": "UI/UX Designer",
       "icon": "🎨",
       "color": "magenta",
-      "domains": ["ui", "ux", "design-system", "accessibility"],
+      "domains": [
+        "ui",
+        "ux",
+        "design-system",
+        "accessibility"
+      ],
       "keywords": [
-        "design", "ui", "ux", "design system", "tokens", "wcag",
-        "accessibility", "mockup", "flow", "shadcn", "tailwind",
-        "motion", "scroll", "scrub", "gsap", "lenis", "seo"
+        "design",
+        "ui",
+        "ux",
+        "design system",
+        "tokens",
+        "wcag",
+        "accessibility",
+        "mockup",
+        "flow",
+        "shadcn",
+        "tailwind",
+        "motion",
+        "scroll",
+        "scrub",
+        "gsap",
+        "lenis",
+        "seo"
+      ],
+      "stack": [
+        "*"
       ],
-      "stack": ["*"],
       "standards": [
         "frontend-design-system-naming",
         "frontend-design-system-animations",
@@ -121,7 +222,13 @@
         "frontend-gsap-plugins"
       ],
       "tools": "Read, Write, Edit, Glob, Grep",
-      "mcp": ["context7", "stitch", "gemini-image", "playwright", "seedance"],
+      "mcp": [
+        "context7",
+        "stitch",
+        "gemini-image",
+        "playwright",
+        "seedance"
+      ],
       "model": "sonnet",
       "persona": "Você desenha sistemas, não telas isoladas. Pensa em tokens (cor, espaço, tipografia), componentes reutilizáveis, estados (default/hover/focus/disabled/loading/error), acessibilidade WCAG AA. Mockups em Tailwind direto, sem Figma intermediário. REUSO ANTES DE CRIAR: componente reutilizável se BUSCA antes de se escrever — rode `morph-spec graph explain <Nome>` e confira `.morph/context/design-system.md` (sem grafo: `grep -rn`); criar um novo exige justificativa em uma linha no relatório da task, a mesma regra que já vale para token de design."
     },
@@ -129,20 +236,37 @@
       "title": "Infrastructure / Jobs Engineer",
       "icon": "⚙️",
       "color": "yellow",
-      "domains": ["infrastructure", "jobs", "deployment", "observability"],
+      "domains": [
+        "infrastructure",
+        "jobs",
+        "deployment",
+        "observability"
+      ],
       "keywords": [
-        "hangfire", "background job", "queue", "deployment",
-        "docker", "ci/cd", "telemetry", "logging", "monitoring"
+        "hangfire",
+        "background job",
+        "queue",
+        "deployment",
+        "docker",
+        "ci/cd",
+        "telemetry",
+        "logging",
+        "monitoring"
+      ],
+      "stack": [
+        "dotnet"
       ],
-      "stack": ["dotnet"],
       "standards": [
         "backend-integrations-hangfire-hangfire-jobs",
         "infrastructure-docker-coolify-deploy",
         "infrastructure-docker-local-compose-isolation",
         "backend-dotnet-scrutor",
-        "ai-agents-observability-patterns"
+        "ai-agents-observability-patterns",
+        "ai-agents-cost-and-budget"
+      ],
+      "mcp": [
+        "context7"
       ],
-      "mcp": ["context7"],
       "model": "sonnet",
       "persona": "Você cuida de infra: jobs assíncronos com Hangfire (apenas quando há razão real), deployment, observabilidade. Pensa em retry, idempotência, dead-letter, métricas. Não inventa infra — usa o que o stack já oferece. Operações no GitHub (issues, PRs, releases, Actions) sempre via `gh` CLI no Bash — o morph-spec não usa MCP do GitHub. Coolify sempre via SSH + curl na API local — não há MCP nem CLI."
     },
@@ -150,14 +274,27 @@
       "title": "Code & Architecture Evaluator",
       "icon": "🔍",
       "color": "red",
-      "domains": ["evaluation", "review", "quality"],
+      "domains": [
+        "evaluation",
+        "review",
+        "quality"
+      ],
       "keywords": [
-        "review", "eval", "score", "rubric", "audit", "quality"
+        "review",
+        "eval",
+        "score",
+        "rubric",
+        "audit",
+        "quality"
+      ],
+      "stack": [
+        "*"
       ],
-      "stack": ["*"],
       "standards": [],
       "tools": "Read, Glob, Grep, Bash",
-      "mcp": ["playwright"],
+      "mcp": [
+        "playwright"
+      ],
       "model": "opus",
       "persona": "Você aplica as rubricas em .morph/framework/evals/rubrics/. Você não participou da implementação — avalia o mandate, o diff e a saída real dos testes, com contexto fresco. O orquestrador anexa o resultado do `morph-spec verify`, mas você tem Bash para conferir por conta própria: rode `morph-spec verify {feature} [task]`, testes/build do stack, `git log/diff/show` — nunca confie cegamente no que foi reportado. Bash é só para verificação: NUNCA para modificar código-fonte, tasks.json, feature.json ou o board de sessão — quem faz isso é o loop de correção, não você. Você também tem Playwright: quando o nó `e2e` do verify subiu o stack, NAVEGUE a aplicação como um usuário faria e percorra os fluxos da feature — ler o diff prova que o código existe, usar a aplicação prova que ela funciona. Confira console e network atrás de erro que nenhum teste cobre. Quem sobe e derruba o stack é o `morph-spec verify`/`morph-spec e2e`, não você: se ele não subiu, isso é um achado de infra a reportar, não um defeito de implementação a pontuar. Se um fluxo que você exercitou merece virar regressão, recomende a spec Playwright no relatório — recomendar é seu papel, escrever não. Quando o que você avalia é uma CORREÇÃO (rodada do loop, fix de achado seu ou de outrem), pergunte sempre O QUE ESSA CORREÇÃO ABRIU: que comportamento antes correto pode ter regredido, e se há teste que pegaria isso. Um fix que fecha um defeito e abre outro pontua alto em toda dimensão e mesmo assim piorou o produto — e re-execute os seus próprios probes da rodada anterior em vez de aceitar 'agora tem teste' como fechamento. Não reescreve código — produz scores 0-10 por dimensão (architecture, contracts, code-quality, test-coverage), feedback priorizado acionável, e ação clara (aprovado em >=9 / feedback para o loop de correção em <9). Silêncio em scores ≥ 9 é o sinal correto."
     },
@@ -165,9 +302,25 @@
       "title": "Codebase Scout",
       "icon": "🔦",
       "color": "gray",
-      "domains": ["scouting", "diagnosis", "code-search"],
-      "keywords": ["scout", "diagnose", "root cause", "blast radius", "search", "map", "investigate", "locate", "trace"],
-      "stack": ["*"],
+      "domains": [
+        "scouting",
+        "diagnosis",
+        "code-search"
+      ],
+      "keywords": [
+        "scout",
+        "diagnose",
+        "root cause",
+        "blast radius",
+        "search",
+        "map",
+        "investigate",
+        "locate",
+        "trace"
+      ],
+      "stack": [
+        "*"
+      ],
       "standards": [],
       "tools": "Read, Glob, Grep, Bash",
       "model": "haiku",

package/framework/ai-pin.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "./schemas/ai-pin.schema.json",
+  "pinnedAt": "2026-09-08",
+  "source": "https://api.nuget.org/v3/registration5-semver1/{id}/index.json",
+  "targetFramework": "net10.0",
+  "sdk": "10.0.100",
+  "packages": {
+    "Microsoft.Agents.AI": { "version": "1.20.0", "published": "2026-08-31", "role": "maf-core" },
+    "Microsoft.Extensions.AI": { "version": "10.9.0", "published": "2026-08-11", "role": "chat-abstractions" },
+    "OpenAI": { "version": "2.13.0", "published": "2026-08-10", "role": "provider" },
+    "Google.GenAI": { "version": "1.21.0", "published": "2026-08-31", "role": "provider" },
+    "ModelContextProtocol": { "version": "2.2.0", "published": "2026-08-13", "role": "mcp" },
+    "Microsoft.Extensions.AI.Evaluation": { "version": "10.9.0", "published": "2026-08-11", "role": "evals" },
+    "Microsoft.Extensions.AI.Evaluation.Quality": { "version": "10.9.0", "published": "2026-08-11", "role": "evals" },
+    "Microsoft.Extensions.AI.Evaluation.Reporting": { "version": "10.9.0", "published": "2026-08-11", "role": "evals" }
+  },
+  "toolchain": {
+    "Microsoft.NET.Test.Sdk": { "version": "18.9.0" },
+    "xunit.v3": { "version": "4.0.0" },
+    "xunit.runner.visualstudio": { "version": "4.0.0" }
+  }
+}

package/framework/commands/morph-media.md

@@ -0,0 +1,45 @@
+---
+description: Conduz a autoria de mídia gerada por IA — escolher o modelo pelo trabalho, montar o prompt como spec versionada, encadear a partir de um herói aprovado, subir a escada de custo e conduzir o gate humano de escolha entre N candidatas.
+argument-hint: [o que gerar]
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion, Skill
+---
+
+# /morph-media — Autoria de mídia gerada
+
+Conduz a produção de uma imagem ou vídeo por IA, do "precisamos de uma foto do sofá em verde" até um
+arquivo aprovado, com o menor gasto possível e sem claim visual falso.
+
+**Implementação:** este slash command é um atalho. O agente deve invocar `Skill(morph-media)` com o
+pedido (se fornecido). A skill escolhe o modelo pelo trabalho, monta o prompt pela estrutura fixa,
+sobe a escada de custo (N candidatas em qualidade baixa → gate humano → a vencedora em alta) e fecha
+com nome, marcação e proveniência.
+
+## Argumentos
+
+`[o que gerar]` — descrição do pedido (opcional; sem ela, a skill pergunta).
+
+## Quando NÃO usar
+
+Quando o pedido é **implementar** o subsistema de mídia num projeto .NET. Isso é uma feature normal,
+e o insumo são os três standards de `ai-agents/` abaixo — não esta skill.
+
+## Anti-padrões
+
+- Gerar tudo em alta qualidade "para já sair pronto" — multiplica a conta e ainda exige escolha.
+- Gerar as derivadas antes de aprovar o herói — elas herdam o erro que ninguém viu ainda.
+- Aprovar vídeo por um frame parado: um still não prova movimento.
+- Pinar um alias sem abrir a tabela de deprecações do standard da modalidade.
+- Recriar por IA o render ou a foto real do cliente — inventa o que já existe e vira claim falso.
+- **Gerar mídia dentro de um turno de conversa.** O turno enfileira e confirma; a mídia volta depois,
+  revisada.
+
+## Referências
+
+- `.claude/skills/morph-media/SKILL.md`
+- `.morph/framework/standards/ai-agents/modalities-image-gen.md`
+- `.morph/framework/standards/ai-agents/media-video.md`
+- `.morph/framework/standards/ai-agents/media-pipeline.md`
+- `.morph/framework/standards/frontend/design-system/ai-image-generation.md`
+- `.morph/framework/standards/frontend/design-system/ai-video-generation.md`
+
+**Pedido:** $ARGUMENTS