@polymorphism-tech/morph-spec 8.47.0 → 9.0.0

package/framework/standards/STANDARDS.meta.json

@@ -0,0 +1,1305 @@
+{
+  "version": "1.0.0",
+  "standards": {
+    "ai-agents-agent-archetypes": {
+      "aliases": [
+        "agent archetype",
+        "arquetipo de agente",
+        "qual forma de agente",
+        "conversational agent",
+        "one-shot agent",
+        "batch agent",
+        "vision agent",
+        "chat with history"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactory.cs` e `.../Conversation/ConversationStore.cs` (arquétipos **one-shot em batch** e **chat com histórico** — o conversacional com fases NÃO tem lastro no kit, e `ai-agents-conversational-agent-with-phases` declara isso no próprio cabeçalho). O arquétipo visão + structured output é **verificação documental** — o ai-kit não exercita multimodalidade.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactory.cs",
+        ".../Conversation/ConversationStore.cs"
+      ]
+    },
+    "ai-agents-agent-session": {
+      "aliases": [
+        "agent session",
+        "chat history",
+        "conversation state",
+        "chat reducer",
+        "history truncation",
+        "multi-turn",
+        "persistent session",
+        "ChatHistoryProvider",
+        "own conversation table",
+        "conversa propria",
+        "ProviderSessionState"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/src/Morph.AiKit/Conversation/ConversationStore.cs` (a subclasse de `ChatHistoryProvider`, a invariante de instância única e o teste de duas sessões concorrentes). Nomes de tipo e membros medidos por reflexão sobre `Microsoft.Agents.AI.Abstractions` 1.20.0 em 2026-09-08.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Conversation/ConversationStore.cs"
+      ]
+    },
+    "ai-agents-agent-spec": {
+      "aliases": [
+        "agent spec",
+        "AgentSpec",
+        "agent catalog",
+        "AgentCatalog",
+        "um agente por spec",
+        "defaults do agente",
+        "quantos agentes"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentSpec.cs`, `.../Agents/AgentSpecOptions.cs` e `.../Agents/AgentFactory.cs` — o record, o bag de opções e a materialização são exatamente o que o kit compila.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentSpec.cs",
+        ".../Agents/AgentSpecOptions.cs",
+        ".../Agents/AgentFactory.cs"
+      ]
+    },
+    "ai-agents-batching": {
+      "aliases": [
+        "batching",
+        "batch api",
+        "bulk prompts",
+        "batch processing",
+        "async batch",
+        "bulk inference",
+        "offline batch",
+        "CreateBatchOperation",
+        "BatchClient"
+      ],
+      "verifiedAgainst": "OpenAI 2.13.0 (ai-pin 2026-09-08) + Microsoft.Extensions.AI 10.9.0. **Verificação documental** do fluxo da Batch API (platform.openai.com/docs/guides/batch, lido 2026-09-08), sem cláusula `provado por`: o ai-kit **referencia** o pacote `OpenAI` no `.csproj` — contrato de versão, régua = restore (`NU1102`) — mas **não o exercita**; não existe um único `using OpenAI` em `src/` (medido 2026-09-08), logo um rename de API não reprova a PR. Ver a tabela \"Dois níveis de garantia\" no README do kit. **Todos os nomes de tipo e assinaturas .NET foram medidos por reflexão sobre a assembly `OpenAI` 2.13.0 em 2026-09-08**, e os 9 marcadores `// VERIFY` desta página foram RESOLVIDOS por essa medição.",
+      "provedBy": []
+    },
+    "ai-agents-context-providers": {
+      "aliases": [
+        "context provider",
+        "dynamic context",
+        "context injection",
+        "AIContextProvider",
+        "memory provider",
+        "inject context",
+        "system prompt injection",
+        "compaction",
+        "MAAI001",
+        "tool before provider",
+        "ordem de escolha"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08) + doc oficial de context providers e de compaction (learn.microsoft.com, `ms.date` 2026-07-30). **Verificação documental** para o desenho — o ai-kit não registra `AIContextProvider`; os nomes de tipo, o pacote de cada extensão e o atributo `[Experimental]` da compaction foram **medidos por reflexão sobre `Microsoft.Agents.AI` 1.20.0** em 2026-09-08.",
+      "provedBy": []
+    },
+    "ai-agents-conversational-agent-with-phases": {
+      "aliases": [
+        "agente conversacional",
+        "fases do agente",
+        "allow-list de tools",
+        "RequireAny",
+        "ChatToolMode",
+        "compositor de turno",
+        "teto de tool calls",
+        "turno de conversa"
+      ],
+      "verifiedAgainst": "Microsoft.Extensions.AI 10.9.0 + Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08). `ChatToolMode.RequireAny` foi **medido por reflexão sobre `Microsoft.Extensions.AI.Abstractions` 10.9.0** em 2026-09-08. O restante é **verificação documental**, sem cláusula `provado por` — o ai-kit ainda não traz um compositor de turno, e o padrão é destilado de um único repositório de campo (ver a nota de fonte única abaixo).",
+      "provedBy": []
+    },
+    "ai-agents-cost-and-budget": {
+      "aliases": [
+        "custo de llm",
+        "cost middleware",
+        "UsageCostMiddleware",
+        "teto de custo",
+        "budget middleware",
+        "tarifa por token",
+        "cost_usd",
+        "orçamento do agente"
+      ],
+      "verifiedAgainst": "Microsoft.Extensions.AI 10.9.0 + Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/src/Morph.AiKit/Middleware/UsageCostMiddleware.cs`, `.../Middleware/UsageCostRecord.cs` e `.../Providers/ModelAlias.cs` — o middleware, o record de custo não-nulo e a conta de tarifa são o que o kit compila. A ausência de qualquer propriedade de preço em `UsageDetails` foi **medida por reflexão sobre `Microsoft.Extensions.AI.Abstractions` 10.9.0** em 2026-09-08. O teto de orçamento é **verificação documental** — o ai-kit não traz um middleware de orçamento.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Middleware/UsageCostMiddleware.cs",
+        ".../Middleware/UsageCostRecord.cs",
+        ".../Providers/ModelAlias.cs"
+      ]
+    },
+    "ai-agents-durable-workflows-hitl": {
+      "aliases": [
+        "durable workflow",
+        "checkpoint",
+        "checkpointing",
+        "human in the loop",
+        "hitl",
+        "requestport",
+        "requestinfoevent",
+        "resume workflow",
+        "long running workflow",
+        "approval workflow",
+        "icheckpointstore",
+        "tool approval",
+        "ApprovalRequiredAIFunction",
+        "ToolApprovalAgent"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08); `Microsoft.Agents.AI.Workflows` 1.20.0 e `Microsoft.Agents.AI.DurableTask` `1.16.0-preview.260730.1` **não estão no pin** — versões apuradas no nuget.org em 2026-09-08. **Verificação documental**, sem cláusula `provado por`: o ai-kit não exercita workflows nem aprovação de tool. Os nomes de tipo e membros de aprovação foram **medidos por reflexão sobre as assemblies do pin** em 2026-09-08.",
+      "provedBy": []
+    },
+    "ai-agents-evals-with-cache": {
+      "aliases": [
+        "eval",
+        "evals",
+        "eval de modelo",
+        "regressao de prompt",
+        "prompt regression",
+        "model swap",
+        "troca de modelo",
+        "cache de respostas",
+        "response cache",
+        "dataset de eval",
+        "EvalFixture",
+        "OfflineChatClient",
+        "DiskBasedResponseCacheProvider",
+        "no evals",
+        "runner evals",
+        "--refresh-cache",
+        "evals.watch"
+      ],
+      "verifiedAgainst": "Microsoft.Extensions.AI.Evaluation 10.9.0 + `.Quality` + `.Reporting` (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalFixture.cs`, que compila e roda no CI contra exatamente essas versões. A superfície de `DiskBasedReportingConfiguration`, `DiskBasedResponseCacheProvider`, `ReportingConfiguration` e dos avaliadores de `.Quality` foi **medida por reflexão sobre as assemblies `Microsoft.Extensions.AI.Evaluation*` 10.9.0** em 2026-09-08.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Evals/EvalFixture.cs"
+      ]
+    },
+    "ai-agents-guardrails": {
+      "aliases": [
+        "guardrail",
+        "guard de tool",
+        "regra proibida",
+        "validacao de pertinencia",
+        "fail-open guard",
+        "argumento nao confiavel",
+        "choke-point"
+      ],
+      "verifiedAgainst": "Microsoft.Extensions.AI 10.9.0 + Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08). **Verificação documental**, sem cláusula `provado por` — o ai-kit não traz um guard de exemplo; o padrão é destilado de dois repositórios em produção, com o local de cada evidência citado na seção correspondente.",
+      "provedBy": []
+    },
+    "ai-agents-llm-runtime-defaults": {
+      "aliases": [
+        "llm defaults",
+        "runtime defaults",
+        "timeout llm",
+        "retry llm",
+        "strict json schema",
+        "temperature reasoning",
+        "capability por alias",
+        "network timeout"
+      ],
+      "verifiedAgainst": "Microsoft.Extensions.AI 10.9.0 + Microsoft.Agents.AI 1.20.0 + OpenAI 2.13.0 (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/src/Morph.AiKit/Providers/ModelAlias.cs` e `.../Providers/ModelRegistry.cs` (alias, `api:`, e limite por alias com procedência obrigatória). A superfície do SDK citada aqui — `ChatOptions`, `ChatResponseFormatJson`, `ReasoningEffort`, `OpenAIClientOptions` — foi **medida por reflexão sobre as assemblies do pin** em 2026-09-08. O timeout é **provado por** `.../Agents/AgentSpecOptions.cs` e `.../Agents/AgentFactory.cs`, que o kit compila **por spec** (`TimeoutSeconds` vira um cliente de timeout no pipeline) — e **não** por alias: a allowlist de alias do registry não tem chave de timeout (medido). Os valores default do retry do `System.ClientModel` 1.15.0 são **verificação documental** — essa assembly está fora do conjunto que o probe carrega.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Providers/ModelAlias.cs",
+        ".../Providers/ModelRegistry.cs",
+        ".../Agents/AgentSpecOptions.cs",
+        ".../Agents/AgentFactory.cs"
+      ]
+    },
+    "ai-agents-mcp-server": {
+      "aliases": [
+        "mcp server",
+        "expose mcp",
+        "build mcp server",
+        "mcp host",
+        "publish tools",
+        "create mcp server",
+        "ModelContextProtocol server",
+        "request filters",
+        "AddCallToolFilter",
+        "stateless",
+        "spec 2026-07-28"
+      ],
+      "verifiedAgainst": "ModelContextProtocol 2.2.0 + ModelContextProtocol.AspNetCore 2.2.0 (ai-pin 2026-09-08; o `.AspNetCore` não está no pin — versão apurada no nuget.org em 2026-09-08) + revisão de spec MCP **2026-07-28** (modelcontextprotocol.io/specification/versioning, lido 2026-09-08). **Verificação documental — o ai-kit não exercita MCP**, e por isso este standard NÃO carimba `provado por`. Os nomes de tipo, os defaults e os avisos de obsolescência abaixo foram **medidos por reflexão sobre as assemblies 2.2.0** em 2026-09-08.",
+      "provedBy": []
+    },
+    "ai-agents-mcp-tools": {
+      "aliases": [
+        "mcp",
+        "model context protocol",
+        "mcp client",
+        "consume mcp server",
+        "mcp tools",
+        "external tools",
+        "agent mcp client",
+        "McpClient.CreateAsync",
+        "HttpClientTransport",
+        "MRTR"
+      ],
+      "verifiedAgainst": "ModelContextProtocol 2.2.0 + Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08) + revisão de spec MCP **2026-07-28**. **Verificação documental — o ai-kit não exercita MCP**, e por isso este standard NÃO carimba `provado por`. Todos os nomes de tipo abaixo foram **medidos por reflexão sobre `ModelContextProtocol.Core` 2.2.0** em 2026-09-08.",
+      "provedBy": []
+    },
+    "ai-agents-media-pipeline": {
+      "aliases": [
+        "media pipeline",
+        "media job",
+        "media review",
+        "C2PA",
+        "SynthID",
+        "AI Act",
+        "content provenance",
+        "marcação de IA",
+        "idempotência de mídia"
+      ],
+      "verifiedAgainst": "Microsoft.Extensions.AI 10.9.0 + OpenAI 2.13.0 + Google.GenAI 1.21.0 (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/src/Morph.AiKit/Media/` — a máquina de estados (`MediaJob`), a revisão humana (`MediaReview`), a marcação exigida na publicação (`MediaDisclosure` + `MediaJob.Publish`), as duas chaves (`MediaIdempotencyKey` × `MediaHash`), o storage por conteúdo (`MediaStore`) e a acessibilidade `internal` de `IMediaProvider` compilam e são exercitados por teste. Preço, data de desligamento, C2PA/SynthID e o texto legal do AI Act são **verificação documental** contra as páginas de §Como re-verificar este standard.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Media/"
+      ]
+    },
+    "ai-agents-media-video": {
+      "aliases": [
+        "media video",
+        "video generation",
+        "text to video",
+        "image to video",
+        "veo",
+        "seedance",
+        "kling",
+        "runway",
+        "GenerateVideosAsync"
+      ],
+      "verifiedAgainst": "Google.GenAI 1.21.0 + OpenAI 2.13.0 (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/src/Morph.AiKit/Media/Providers/VeoVideoProvider.cs` — `Models.GenerateVideosAsync(model, GenerateVideosSource, GenerateVideosConfig, ct)`, o polling por `Operations.GetAsync` + `operation.Done` e o sinal de bloqueio `RaiMediaFilteredCount` COMPILAM ali. Preço, duração, retenção e data de desligamento são **verificação documental** contra as páginas listadas em §Como re-verificar este standard.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Media/Providers/VeoVideoProvider.cs"
+      ]
+    },
+    "ai-agents-middleware-patterns": {
+      "aliases": [
+        "middleware",
+        "agent middleware",
+        "function calling middleware",
+        "retry",
+        "anti-hallucination",
+        "resilience",
+        "telemetry middleware",
+        "agent run middleware",
+        "pipeline order",
+        "streaming downgrade"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08); `provado por templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactory.cs` para a **ordem do pipeline** — a fábrica do kit é o único lugar que conhece essa ordem, e ela é medida por teste, não herdada de folclore. As assinaturas de `Use(...)` foram **medidas por reflexão sobre `AIAgentBuilder` e `ChatClientBuilder`** em 2026-09-08.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactory.cs"
+      ]
+    },
+    "ai-agents-modalities-image-gen": {
+      "aliases": [
+        "image generation",
+        "text to image",
+        "dall-e",
+        "gpt-image",
+        "mockup",
+        "image synthesis",
+        "generate image",
+        "image from text",
+        "MEAI001",
+        "IImageGenerator"
+      ],
+      "verifiedAgainst": "OpenAI 2.13.0 + Microsoft.Extensions.AI 10.9.0 + Google.GenAI 1.21.0 (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/src/Morph.AiKit/Media/Providers/OpenAIImageProvider.cs` — `IImageGenerator`, `MEAI001`, `ImageGenerationRequest.OriginalImages` e a ausência de propriedade tipada para `quality` COMPILAM ali, e `OPENAI001` em `GeneratedImageQuality` foi medido pelo compilador. `HostedImageGenerationTool` foi medido por reflexão sobre a assembly do pin (existe, não é experimental); preço, data de desligamento e limites de referência são **verificação documental** contra as páginas de §Como re-verificar este standard.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Media/Providers/OpenAIImageProvider.cs"
+      ]
+    },
+    "ai-agents-modalities-speech-to-text": {
+      "aliases": [
+        "speech to text",
+        "transcription",
+        "whisper",
+        "audio to text",
+        "voice transcription",
+        "STT",
+        "audio transcription"
+      ],
+      "verifiedAgainst": "OpenAI 2.13.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08). **Verificação documental**, sem cláusula `provado por` — o ai-kit não transcreve áudio. `AudioClient.TranscribeAudioAsync` e a ponte `AsISpeechToTextClient` foram **medidas por reflexão sobre as assemblies do pin** em 2026-09-08. Em 2026-10-03 os blocos da API, do `TranscriptionService`, do agente downstream (dentro de um método-invólucro) e do registro DI compilaram com `TreatWarningsAsErrors` contra `OpenAI` 2.13.0 + `Microsoft.Agents.AI` 1.20.0 (o pin de 2026-09-08, que é a data que este campo carrega).",
+      "provedBy": []
+    },
+    "ai-agents-modalities-text-to-speech": {
+      "aliases": [
+        "text to speech",
+        "TTS",
+        "voice synthesis",
+        "audio generation",
+        "speech synthesis",
+        "voice output",
+        "speak text"
+      ],
+      "verifiedAgainst": "OpenAI 2.13.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08). **Verificação documental**, sem cláusula `provado por` — o ai-kit não gera áudio. `AudioClient.GenerateSpeechAsync`, a sobrecarga de streaming e a ponte `AsITextToSpeechClient` foram **medidas por reflexão sobre as assemblies do pin** em 2026-09-08.",
+      "provedBy": []
+    },
+    "ai-agents-modalities-vision": {
+      "aliases": [
+        "vision",
+        "image to text",
+        "OCR",
+        "image analysis",
+        "multimodal input",
+        "image agent",
+        "PDF analysis",
+        "visual understanding"
+      ],
+      "verifiedAgainst": "Microsoft.Extensions.AI 10.9.0 + Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08). **Verificação documental**, sem cláusula `provado por` — o ai-kit não exercita conteúdo multimodal. Os três tipos de conteúdo citados (`TextContent`, `UriContent`, `DataContent`) foram **conferidos por reflexão sobre `Microsoft.Extensions.AI.Abstractions` 10.9.0** em 2026-09-08 e continuam existindo com esses nomes.",
+      "provedBy": []
+    },
+    "ai-agents-multi-agent-patterns": {
+      "aliases": [
+        "multi-agent",
+        "agent as tool",
+        "agent composition",
+        "sequential agents",
+        "handoff",
+        "sub-agent",
+        "agent orchestration",
+        "nested agent",
+        "agente auxiliar",
+        "AsAIFunction"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08) + Microsoft.Agents.AI.Workflows 1.20.0 (**fora do pin**; versão apurada no nuget.org em 2026-09-08). **Verificação documental**, sem cláusula `provado por` — o ai-kit não compõe agentes. As assinaturas de `AgentWorkflowBuilder`/`HandoffWorkflowBuilder` e a **ausência** do atributo `[Experimental]` no Handoff foram **medidas por reflexão sobre a assembly 1.20.0** em 2026-09-08.",
+      "provedBy": []
+    },
+    "ai-agents-observability-patterns": {
+      "aliases": [
+        "observability",
+        "opentelemetry",
+        "telemetry",
+        "logging",
+        "tracing",
+        "log investigation",
+        "troubleshooting",
+        "aspire dashboard",
+        "correlation id",
+        "agent observability",
+        "agent telemetry",
+        "EnableSensitiveData",
+        "span duplication",
+        "invoke_agent"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08); `provado por templates/dotnet/ai-kit/src/Morph.AiKit/Observability/MorphOpenTelemetryExtensions.cs` — o guard de span duplicado, a regra de \"um nível, uma instrumentação\" e o default `EnableSensitiveData = false` são exatamente o que o kit compila, com os spans contados em `tests/Morph.AiKit.Tests/TelemetryTests.cs`. Nomes de símbolo, de span, de métrica e das duas `ActivitySource` foram **medidos por reflexão e por leitura dos literais das assemblies do pin** em 2026-09-08, e em 2026-09-09 **todos os treze nomes `gen_ai.*` desta página** foram remedidos, um a um, por **teste de exclusividade**: os quatro `SetTag` da seção *Enrichment* e os nove das seções de span, métrica e atributo de agente. **Os treze existem** — depois de uma correção: `gen_ai.response.finish_reason`, no **singular**, não existia, só aparecia como cabeça de `finish_reason`**s**, e sobreviveu a duas varreduras porque as duas usaram `includes` — e **`includes` de um prefixo não prova o literal autônomo**. Os treze estão tabelados, em **duas** tabelas com propósitos diferentes: a de *Enrichment* registra os **4** `SetTag` daquele bloco (mais os **cinco** nomes rejeitados: o `finish_reason` singular, `PromptTokens`, `CompletionTokens`, `prompt_tokens` e `completion_tokens`), e a de distribuição, na seção *Nomes de span, métricas e atributos — medidos*, registra os **13** por assembly. A conferência é reproduzível por `node scripts/api-probe/probe.mjs tags` sobre este arquivo. A **instabilidade da convenção** — o split do semconv **v1.42.0 (2026-06-12)**, que depreciou e moveu todo `gen_ai.*` para `open-telemetry/semantic-conventions-genai`, onde nada GenAI está `Stable`, contra a v1.37 que o `OpenTelemetryChatClient` declara implementar — é **verificação documental**, apurada em 2026-09-08.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Observability/MorphOpenTelemetryExtensions.cs"
+      ]
+    },
+    "ai-agents-production": {
+      "aliases": [
+        "agent middleware",
+        "production agent",
+        "a2a protocol",
+        "mcp integration",
+        "agent observability",
+        "agent telemetry",
+        "anti-hallucination",
+        "semantic caching",
+        "multi-tenant isolation",
+        "AgentIsolationKeyProvider",
+        "concurrent tool invocation"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08) + Microsoft.Agents.AI.Hosting `1.20.0-preview.260831.1` e Microsoft.Agents.AI.A2A `1.20.0-preview.260831.1` (**fora do pin**; versões apuradas no nuget.org em 2026-09-08). **Verificação documental**, sem cláusula `provado por` — este standard é panorama, e cada tema tem dono canônico noutro standard. Os nomes de isolamento multi-tenant foram **medidos por reflexão sobre `Microsoft.Agents.AI.Hosting`** em 2026-09-08.",
+      "provedBy": []
+    },
+    "ai-agents-prompt-sources": {
+      "aliases": [
+        "prompts in db",
+        "agent prompts",
+        "prompt versioning",
+        "prompt hot-reload",
+        "editable instructions",
+        "prompt management",
+        "prompt sources",
+        "prompt por tenant",
+        "spec publicado",
+        "reconciliação de prompt"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08). **Verificação documental**, sem cláusula `provado por` — o ai-kit não traz loader de prompt, e os dois mecanismos descritos aqui são destilados de três produtos em produção. As **quatro** superfícies de API que este standard cita foram medidas por reflexão, e vivem em **três assemblies diferentes** — o carimbo diz onde remedir, então o nome importa: `IChatClient.AsAIAgent(instructions:, name:)` é `Microsoft.Extensions.AI.ChatClientExtensions`, em **`Microsoft.Agents.AI` 1.20.0** (medida em 2026-09-08); `AIAgent.RunAsync` (as oito sobrecargas) e `AIAgent.CreateSessionAsync` são de `Microsoft.Agents.AI.AIAgent`, na assembly **`Microsoft.Agents.AI.Abstractions` 1.20.0** — **remedidas** em 2026-09-09, porque a leitura de 2026-09-08 estava errada no *quê*, e a de 2026-09-09 estava errada no *onde* (as duas retificações estão no callout abaixo); e `builder.AddAIAgent` (§Keyed singleton) é `Microsoft.Agents.AI.Hosting.HostApplicationBuilderAgentExtensions` — cinco sobrecargas, na assembly **`Microsoft.Agents.AI.Hosting` 1.20.0.0**, que vem do pacote **`Microsoft.Agents.AI.Hosting` `1.20.0-preview.260831.1`**: ele é **prerelease** e está **FORA do `ai-pin.json`** (apurado em `scripts/api-probe/companions.json`, 2026-09-08) — quem adotar esta seção registra a dependência prerelease em `decisions.md`, como manda `ai-agents-production`. **Duas ressalvas de escopo**, porque um carimbo que não as diz promete mais do que mediu: `Microsoft.Agents.AI.Abstractions` e `Microsoft.Extensions.AI.Abstractions` são nomes de **assembly** (elas viajam dentro dos pacotes `Microsoft.Agents.AI` e `Microsoft.Extensions.AI`), não ids de pacote; e `IMemoryCache`/`DbContext`, usados no padrão de cache e na §Keyed singleton, são superfícies de ASP.NET Core e EF Core — **fora do pin, não medidas aqui, verificação documental**.",
+      "provedBy": []
+    },
+    "ai-agents-providers-model-registry": {
+      "aliases": [
+        "model registry",
+        "provider agnostic",
+        "model alias",
+        "IChatClient factory",
+        "multi-model",
+        "model selection",
+        "model config",
+        "switch provider",
+        "openai google anthropic ollama",
+        "direct model",
+        "api per alias",
+        "responses vs chat",
+        "reasoning effort",
+        "temperature vs reasoning",
+        "model pricing"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 + OpenAI 2.13.0 (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/src/Morph.AiKit/Providers/ModelRegistry.cs` e `.../Providers/ModelAlias.cs` e `.../Agents/AgentApi.cs`. Nomes de tipo do `Microsoft.Extensions.AI` e do `OpenAI` medidos por reflexão sobre as assemblies do pin em 2026-09-08.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Providers/ModelRegistry.cs",
+        ".../Providers/ModelAlias.cs",
+        ".../Agents/AgentApi.cs"
+      ]
+    },
+    "ai-agents-rag-custom-pgvector": {
+      "aliases": [
+        "rag",
+        "vector search",
+        "pgvector",
+        "embeddings",
+        "custom rag",
+        "retrieval",
+        "semantic search",
+        "knowledge base",
+        "RAG tool",
+        "delta ingestion",
+        "incremental ingestion",
+        "lookup key",
+        "content hash"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08); `provado por templates/dotnet/ai-kit/src/Morph.AiKit/Rag/DeltaIngest.cs` **restrito à seção \"Ingestão delta por lookup-key\"** — é a única parte deste standard que o ai-kit compila. Todo o resto (pgvector, SQL, HNSW, embeddings, multi-tenant) é **verificação documental**; a versão e o status de `Microsoft.Extensions.DataIngestion` foram apurados no nuget.org em 2026-09-08. Em 2026-10-03, contra o mesmo pin, compilaram com `TreatWarningsAsErrors` os blocos de registro do `IEmbeddingGenerator`, do `VectorSearchTool` (EF Core + Pgvector.EntityFrameworkCore 0.3.0) e do *Exemplo de uso* (a ponte `Microsoft.Extensions.AI.OpenAI` 10.9.0 resolveu `OpenAI` 2.12.0); a forma anterior `RunAsync(question, ct)` não compilava (CS1503).",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Rag/DeltaIngest.cs"
+      ]
+    },
+    "ai-agents-service-tier-flex": {
+      "aliases": [
+        "service tier",
+        "flex tier",
+        "cost optimization",
+        "async tier",
+        "priority tier",
+        "tier flex",
+        "background inference",
+        "ChatServiceTier"
+      ],
+      "verifiedAgainst": "OpenAI 2.13.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08). **Verificação documental** da política de tiers (platform.openai.com/docs/guides/service-tiers, lido 2026-09-08), sem cláusula `provado por`: o ai-kit **referencia** o pacote `OpenAI` no `.csproj` — contrato de versão, régua = restore (`NU1102`) — mas **não o exercita**; não existe um único `using OpenAI` em `src/` (medido 2026-09-08), logo um rename de API não reprova a PR. Ver a tabela \"Dois níveis de garantia\" no README do kit. **O nome e o tipo da propriedade C# foram medidos por reflexão sobre a assembly `OpenAI` 2.13.0 em 2026-09-08**, e o marcador `// VERIFY` desta página foi RESOLVIDO por essa medição.",
+      "provedBy": []
+    },
+    "ai-agents-setup": {
+      "aliases": [
+        "MAF setup",
+        "Microsoft Agents AI",
+        "ChatClient",
+        "AsAIAgent",
+        "AIAgent dotnet",
+        "agent framework setup",
+        "MAF packages",
+        "MAF nuget",
+        "responses api",
+        "GetResponsesClient",
+        "store false",
+        "chat completions"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 + OpenAI 2.13.0 (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactory.cs` (pipeline e escolha de protocolo). A superfície do SDK `OpenAI` e das pontes `Microsoft.Agents.AI.OpenAI` / `Microsoft.Extensions.AI.OpenAI` foi **medida por reflexão sobre as assemblies do pin** em 2026-09-08 — o ai-kit **não exercita** o cliente concreto da OpenAI — referencia o pacote no `.csproj`, mas não há `using OpenAI` em `src/` (medido 2026-09-08); ver a tabela \"Dois níveis de garantia\" no README do kit.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactory.cs"
+      ]
+    },
+    "ai-agents-structured-output": {
+      "aliases": [
+        "structured output",
+        "typed response",
+        "response format",
+        "schema validated output",
+        "record output",
+        "JSON schema agent",
+        "RunAsync generic",
+        "typed agent output",
+        "ToAgentResponseAsync",
+        "response format limits"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08); `provado por templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactory.cs` **apenas** para o mapeamento de `AgentSpec.OutputSchema` → `ChatOptions.ResponseFormat = ChatResponseFormat.ForJsonSchema(...)`, que é o que o kit compila. `RunAsync<T>`, `Deserialize<T>` e os limites do `ResponseFormat` são **verificação documental**, com os nomes de tipo medidos por reflexão sobre `Microsoft.Extensions.AI.Abstractions` 10.9.0 em 2026-09-08.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/src/Morph.AiKit/Agents/AgentFactory.cs"
+      ]
+    },
+    "ai-agents-sweet-spot": {
+      "aliases": [
+        "sweet spot",
+        "when to use agent",
+        "agent vs workflow",
+        "when not to use workflow",
+        "MAF decision",
+        "simple agent default",
+        "4 feature rule",
+        "single agent default",
+        "tool budget",
+        "how many tools"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 + Microsoft.Agents.AI.Workflows 1.20.0 (ai-pin 2026-09-08 para o primeiro; o segundo está **fora do pin**, versão apurada no nuget.org em 2026-09-08). **Verificação documental**, sem cláusula `provado por` — este standard é decisão de arquitetura, não API. A escada de complexidade foi reconferida e **continua correta**; o que entrou de novo é o custo de definição de tool por turno e o status do Handoff.",
+      "provedBy": []
+    },
+    "ai-agents-testing-ai": {
+      "aliases": [
+        "testar agente",
+        "fake IChatClient",
+        "ScriptedChatClient",
+        "harness de turno",
+        "eval de agente",
+        "teste sem rede",
+        "golden de prompt"
+      ],
+      "verifiedAgainst": "Microsoft.Extensions.AI 10.9.0 + Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08); provado por `templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeChatClient.cs` e `.../src/Morph.AiKit/Providers/IProviderClientFactory.cs` — o fake roteirizado e a costura que dispensa rede são o que o kit compila e exercita. Harness de turno completo e evals com cache de resposta são **verificação documental** — o ai-kit não os traz.",
+      "provedBy": [
+        "templates/dotnet/ai-kit/tests/Morph.AiKit.Tests/Fakes/FakeChatClient.cs",
+        ".../src/Morph.AiKit/Providers/IProviderClientFactory.cs"
+      ]
+    },
+    "ai-agents-vector-data-extensions": {
+      "aliases": [
+        "microsoft extensions vectordata",
+        "vectorstorecollection",
+        "vector store abstraction",
+        "data ingestion",
+        "ingestion pipeline",
+        "semantic kernel connectors exception",
+        "pgvector connector",
+        "vectorstorewriter",
+        "CommunityToolkit VectorData",
+        "connector rename"
+      ],
+      "verifiedAgainst": "Microsoft.Extensions.VectorData.Abstractions **10.9.0** + CommunityToolkit.VectorData.PgVector **1.0.1** + Microsoft.Extensions.DataIngestion **10.9.0-preview.1.26411.16** — nenhum deles está no `framework/ai-pin.json` (que cobre os 5 pacotes de agente), portanto **todas as versões acima foram apuradas na API do nuget.org em 2026-09-08** e são citadas com essa data, não como pin. **Verificação documental**, sem cláusula `provado por`: o ai-kit **não referencia nem exercita** VectorData — o pacote não está no `Morph.AiKit.csproj`, cujos cinco `PackageReference` são exatamente os do pin (medido 2026-09-08). Aqui nem a régua fraca do restore existe.",
+      "provedBy": []
+    },
+    "ai-agents-workflows": {
+      "aliases": [
+        "workflow",
+        "agent workflow",
+        "fan-in",
+        "fan-out",
+        "when not to use workflow",
+        "orchestration",
+        "AgentWorkflowBuilder",
+        "concurrent workflow",
+        "Microsoft.Agents.AI.Workflows",
+        "declarative workflow"
+      ],
+      "verifiedAgainst": "Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08) + Microsoft.Agents.AI.Workflows 1.20.0, Microsoft.Agents.AI.Workflows.Declarative 1.20.0 e Microsoft.Agents.AI.Declarative `1.20.0-rc1` (**os três fora do pin**; versões apuradas no nuget.org em 2026-09-08). **Verificação documental**, sem cláusula `provado por` — o ai-kit não monta workflows. **A localização dos tipos de workflow foi medida por reflexão em 2026-09-08 e CORRIGE este standard**: eles não estão no pacote base.",
+      "provedBy": []
+    },
+    "architecture-vertical-slice-vertical-slice": {
+      "aliases": [
+        "vertical slice",
+        "VSA",
+        "slice architecture",
+        "feature slice",
+        "CQRS slice"
+      ],
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + EF Core 10.0.12 + FluentValidation 12.1.1 + Scrutor 7. Os blocos da slice (Handler, Validator, Endpoint) compilam com `TreatWarningsAsErrors` sobre o `Result`/`Error`/`ErrorHttpMapping` de `result-pattern.md` nos namespaces da árvore acima (`{ProjectName}` substituído; o Handler com `global using` de Abstractions/Database/Entities, o Endpoint só com os próprios `using`); Abstractions, Pipelines e DI são verificação documental.",
+      "provedBy": []
+    },
+    "backend-api-validation": {
+      "aliases": [
+        "FluentValidation",
+        "input validation",
+        "request validation",
+        "API validation",
+        "model validation"
+      ],
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + FluentValidation 12.1.1 + EF Core 10.0.12. The validator, `OrderStatus`, `OrderErrors` and state-check handler blocks compile with `TreatWarningsAsErrors` over the `Result`/`Error`/`ValidationError` of `result-pattern.md`.",
+      "provedBy": []
+    },
+    "backend-database-postgresql-database": {
+      "aliases": [
+        "PostgreSQL",
+        "postgres",
+        "pg",
+        "database design",
+        "SQL schema"
+      ],
+      "verifiedAgainst": "PostgreSQL 16/17 + EF Core 10.0.12 (Npgsql provider 10.0.3) + @neondatabase/serverless. The EF Core query blocks compile with `TreatWarningsAsErrors` inside a wrapper method over stand-in entities; the SQL is documentary.",
+      "provedBy": []
+    },
+    "backend-database-vector-search-rag": {
+      "aliases": [
+        "vector search",
+        "RAG",
+        "embeddings",
+        "pgvector",
+        "semantic search"
+      ],
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Npgsql.EntityFrameworkCore.PostgreSQL 10.0.3 + Pgvector.EntityFrameworkCore 0.3.0 + Microsoft.Extensions.AI 10.9.0 + Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08). Os blocos de indexação, indexação em lote, busca+geração (RAG), endpoint e job compilam com `TreatWarningsAsErrors` sobre o `Result`/`IHandler`/`ErrorHttpMapping` de `result-pattern.md`/`vertical-slice.md` e o `Document`/`ApplicationDbContext` de `neon-pgvector.md`; o registro do `IEmbeddingGenerator` por provedor, os custos e o SQL são verificação documental.",
+      "provedBy": []
+    },
+    "backend-dotnet-fluent-validation-vsa": {
+      "aliases": [
+        "FluentValidation VSA",
+        "validation decorator",
+        "validation pipeline",
+        "AbstractValidator",
+        "ValidationDecorator"
+      ],
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + FluentValidation 12.1.1. The validator block and the decorator (its three blocks assembled into one class) compile with `TreatWarningsAsErrors` over the `Result`/`ValidationError` of `result-pattern.md`, and the validator was run with `FakeTimeProvider` across a year change to show the year is read per validation.",
+      "provedBy": []
+    },
+    "backend-dotnet-result-pattern": {
+      "aliases": [
+        "Result<T>",
+        "railway oriented",
+        "error handling",
+        "Match pattern",
+        "Result monad"
+      ],
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + the shared framework `Microsoft.AspNetCore.App` 10 — the HTTP mapping uses `Results`/`IResult`/`StatusCodes`; the `Error`, `ValidationError`, `ResultExtensions`, `ErrorHttpMapping`, endpoint usage and `BookErrors` blocks compile with `TreatWarningsAsErrors` (the Anatomy blocks carry `{ ... }` placeholders and were compiled through a concrete stand-in).",
+      "provedBy": []
+    },
+    "backend-dotnet-scalar-ui": {
+      "aliases": [
+        "Scalar",
+        "API documentation",
+        "OpenAPI UI",
+        "Swagger replacement",
+        "Scalar.AspNetCore"
+      ],
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Scalar.AspNetCore 2.x + Microsoft.AspNetCore.OpenApi 10. The `ApiTags` and tagged-endpoint blocks compile with `TreatWarningsAsErrors` over the `Result`/`ErrorHttpMapping` of `result-pattern.md` (ApiTags placed in `ProjectName.Constants`); the startup and metadata snippets (`async (...) => { ... }`) are fragments, checked against the docs only.",
+      "provedBy": []
+    },
+    "backend-dotnet-scrutor": {
+      "aliases": [
+        "Scrutor",
+        "auto-discovery",
+        "assembly scanning",
+        "decorator registration",
+        "handler registration"
+      ],
+      "verifiedAgainst": ".NET 10 + Scrutor 7 (`Scan`/`Decorate` API).",
+      "provedBy": []
+    },
+    "backend-dotnet-testing": {
+      "aliases": [
+        "xunit",
+        "TimeProvider",
+        "FakeTimeProvider",
+        "fake clock",
+        "integration test",
+        "ProblemDetails",
+        "error body assertion",
+        "test budget",
+        "orçamento de teste",
+        "[Theory] table"
+      ],
+      "verifiedAgainst": ".NET 10 + xUnit 2 + `Microsoft.Extensions.TimeProvider.Testing`.",
+      "provedBy": []
+    },
+    "backend-dotnet-vsa-handler-patterns": {
+      "aliases": [
+        "VSA handler",
+        "vertical slice handler",
+        "feature slice",
+        "IHandler pattern",
+        "handler endpoint"
+      ],
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview; minimal APIs, primary constructors, `Guid.CreateVersion7()`). The \"Complete Endpoint Example\" block compiles with `TreatWarningsAsErrors` over the `Result`/`ErrorHttpMapping` of `result-pattern.md` (in `ProjectName.Abstractions`/`ProjectName.Extensions`, reached only through the block's own `using`s); the other blocks are documentary.",
+      "provedBy": []
+    },
+    "backend-integrations-asaas-asaas-api": {
+      "aliases": [
+        "asaas",
+        "payment",
+        "PIX",
+        "boleto",
+        "Brazilian payment"
+      ],
+      "verifiedAgainst": "Asaas REST API v3 (docs read via context7 on 2026-10-03: headers, `POST /payments`, `GET /payments?externalReference=`, `pixQrCode`, webhook payload, delivery and error rules) + .NET 10 (SDK 10.0.400-preview, `IHttpClientFactory` from the ASP.NET Core shared framework) + EF Core 10.0.12. The options, client, registration, PIX slice, webhook slice/endpoint and CPF/CNPJ blocks compile with `TreatWarningsAsErrors` over the `Result`/`ErrorHttpMapping` of `result-pattern.md`; the CPF/CNPJ validator was run against valid and invalid documents (numeric and the alphanumeric `12.ABC.345/01DE-35`), and the `BaseUrl` trailing-slash rule and the `dueDate` JSON shape were checked by running them; the SQL is documentary.",
+      "provedBy": []
+    },
+    "backend-integrations-hangfire-hangfire-jobs": {
+      "aliases": [
+        "hangfire",
+        "background jobs",
+        "scheduled jobs",
+        "recurring",
+        "cron",
+        "fire and forget"
+      ],
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Hangfire.Core/Hangfire.AspNetCore 1.8.25 + Hangfire.PostgreSql 1.21.1 + Newtonsoft.Json 13.0.4. The startup, job/handler, dashboard-filter and idempotency blocks compile with `TreatWarningsAsErrors`; the Job Types calls compile inside a wrapper method; the per-job DI scope (`AspNetCoreJobActivator` → `IServiceScopeFactory`) and the `PostgreSqlStorageOptions` defaults were read by reflection on those assemblies; the pooled-endpoint limits (LISTEN/NOTIFY, migrations on the direct string) come from the Neon connection-pooling docs. Cron strings are documentary.",
+      "provedBy": []
+    },
+    "backend-integrations-neon-auth-neon-auth": {
+      "aliases": [
+        "neon auth",
+        "better auth",
+        "authentication",
+        "OAuth",
+        "JWT",
+        "session management",
+        "trusted origins",
+        "EdDSA",
+        "Ed25519",
+        "BouncyCastle",
+        "signature validator",
+        "jwks",
+        "middleware runtime",
+        "api prefix",
+        "data api",
+        "postgrest",
+        "bypass backend",
+        "direct database access"
+      ],
+      "verifiedAgainst": "Neon Auth — @neondatabase/auth + @neondatabase/auth-ui (Better Auth).",
+      "provedBy": []
+    },
+    "backend-integrations-resend-resend-email": {
+      "aliases": [
+        "resend",
+        "email",
+        "transactional email",
+        "SMTP",
+        "email notification"
+      ],
+      "verifiedAgainst": "Resend Node SDK 4 + Resend .NET SDK + React Email.",
+      "provedBy": []
+    },
+    "data-nosql-cache-redis": {
+      "aliases": [
+        "redis",
+        "cache",
+        "distributed cache",
+        "IDistributedCache",
+        "cache-aside",
+        "StackExchange.Redis"
+      ],
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Microsoft.Extensions.Caching.StackExchangeRedis 10.0.12 + StackExchange.Redis 2.13.17 + EF Core 10.0.12. The registration, cache-aside handler, invalidation and rate-limit blocks compile with `TreatWarningsAsErrors` over the `Result` of `result-pattern.md`; package dependencies read from the nuget.org nuspec on 2026-10-03.",
+      "provedBy": []
+    },
+    "data-nosql-cosmos-db": {
+      "aliases": [
+        "cosmos",
+        "CosmosDB",
+        "document database",
+        "partition key",
+        "RUs"
+      ],
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Microsoft.Azure.Cosmos 3.63.2 + Newtonsoft.Json 13.0.4 — every `csharp` block below compiles with `TreatWarningsAsErrors` against the `Result`/`Error` types of `backend-dotnet-result-pattern`.",
+      "provedBy": []
+    },
+    "data-vector-search-rag-chunking": {
+      "aliases": [
+        "RAG chunking",
+        "document chunking",
+        "text splitting",
+        "chunk overlap",
+        "embedding chunks"
+      ],
+      "verifiedAgainst": ".NET 10 (chunking algorithms — language-level, no external package).",
+      "provedBy": []
+    },
+    "frontend-design-system-ai-image-generation": {
+      "aliases": [
+        "Image Generation",
+        "AI Assets",
+        "Gemini Images",
+        "brand fidelity",
+        "reference images",
+        "favicon",
+        "og image",
+        "asset generation"
+      ],
+      "verifiedAgainst": "morph-assets MCP (OpenRouter; default model `openai/gpt-image-2.5-flare`) + Next.js 15 `next/image`.",
+      "provedBy": []
+    },
+    "frontend-design-system-ai-video-generation": {
+      "aliases": [
+        "video generation",
+        "seedance",
+        "img2vid",
+        "endImage",
+        "directional footage",
+        "loop video",
+        "E005",
+        "animate render",
+        "scroll scrub footage"
+      ],
+      "verifiedAgainst": "morph-assets MCP (generate_video, generate_loop_video, get_video, library, media_tool) over OpenRouter; models `bytedance/seedance-1-5-pro` and `bytedance/seedance-2.0`.",
+      "provedBy": []
+    },
+    "frontend-design-system-animations": {
+      "aliases": [
+        "animations",
+        "transitions",
+        "motion",
+        "CSS animations",
+        "keyframes",
+        "prefers-reduced-motion"
+      ],
+      "verifiedAgainst": "CSS animations/transitions (language-level, no framework).",
+      "provedBy": []
+    },
+    "frontend-design-system-naming": {
+      "aliases": [
+        "BEM",
+        "CSS naming",
+        "class naming",
+        "design token naming",
+        "component naming"
+      ],
+      "verifiedAgainst": "CSS (BEM + custom properties — language-level, no framework).",
+      "provedBy": []
+    },
+    "frontend-design-system-premium-finish": {
+      "aliases": [
+        "premium finish",
+        "polish layer",
+        "film grain",
+        "atmosphere",
+        "load-in stagger",
+        "scrim",
+        "text over video",
+        "metallic accent",
+        "looks like a template"
+      ],
+      "verifiedAgainst": "Production landing pages, CSS-only techniques, no runtime dependency.",
+      "provedBy": []
+    },
+    "frontend-gsap-core": {
+      "aliases": [
+        "GSAP",
+        "GreenSock",
+        "gsap.to",
+        "gsap.from",
+        "useGSAP",
+        "gsap timeline",
+        "gsap utils",
+        "gsap performance"
+      ],
+      "verifiedAgainst": "GSAP 3.13 + @gsap/react.",
+      "provedBy": []
+    },
+    "frontend-gsap-plugins": {
+      "aliases": [
+        "Flip",
+        "SplitText",
+        "MorphSVG",
+        "DrawSVG",
+        "MotionPath",
+        "Draggable",
+        "Observer",
+        "ScrollToPlugin"
+      ],
+      "verifiedAgainst": "GSAP 3.13 + @gsap/react.",
+      "provedBy": []
+    },
+    "frontend-gsap-scrolltrigger": {
+      "aliases": [
+        "ScrollTrigger",
+        "scroll animation",
+        "pinning",
+        "scrubbing",
+        "parallax",
+        "scroll-driven"
+      ],
+      "verifiedAgainst": "GSAP 3.13 ScrollTrigger + @gsap/react.",
+      "provedBy": []
+    },
+    "frontend-nextjs-app-router": {
+      "aliases": [
+        "app router",
+        "Next.js 14",
+        "server components",
+        "app directory",
+        "RSC"
+      ],
+      "verifiedAgainst": "Next.js 15.",
+      "provedBy": []
+    },
+    "frontend-nextjs-components": {
+      "aliases": [
+        "react components",
+        "server component",
+        "client component",
+        "shadcn/ui",
+        "UI components"
+      ],
+      "verifiedAgainst": "Next.js 16 + shadcn 4 CLI (the code blocks typecheck under `tsc --strict`).",
+      "provedBy": []
+    },
+    "frontend-nextjs-data-fetching": {
+      "aliases": [
+        "TanStack Query",
+        "react-query",
+        "server actions",
+        "data fetching",
+        "useQuery"
+      ],
+      "verifiedAgainst": "Next.js 15 + TanStack Query 5 + Zod 4.",
+      "provedBy": []
+    },
+    "frontend-nextjs-forms": {
+      "aliases": [
+        "react-hook-form",
+        "Zod",
+        "form validation",
+        "shadcn Field",
+        "Controller"
+      ],
+      "verifiedAgainst": "Next.js 16 + react-hook-form 7 + Zod 4 + @hookform/resolvers 5 + shadcn 4 `Field` (the code blocks typecheck under `tsc --strict`).",
+      "provedBy": []
+    },
+    "frontend-nextjs-motion-patterns": {
+      "aliases": [
+        "framer-motion",
+        "animation variants",
+        "motion design",
+        "page transition",
+        "AnimatePresence"
+      ],
+      "verifiedAgainst": "Motion for React 12+ (`motion`, imports from `motion/react`); the npm registry and the `motion`/`framer-motion`/`motion-dom` 14.0.0 typings were read on 2026-10-03 (`motion/react` re-exports `framer-motion`, which re-exports `motion-dom`: `Variants`, `useInView`, `AnimatePresence`, `useReducedMotion`, `staggerChildren`/`delayChildren` all present). The TSX snippets are documentary.",
+      "provedBy": []
+    },
+    "frontend-nextjs-naming-conventions": {
+      "aliases": [
+        "naming conventions",
+        "file naming",
+        "component naming",
+        "Next.js naming",
+        "TypeScript naming"
+      ],
+      "verifiedAgainst": "Next.js 15 + Zod 4.",
+      "provedBy": []
+    },
+    "frontend-nextjs-nextjs-patterns": {
+      "aliases": [
+        "Next.js patterns",
+        "middleware",
+        "auth patterns",
+        "caching patterns",
+        "image optimization"
+      ],
+      "verifiedAgainst": "Next.js 15 + TanStack Query 5 + Zod 4 + react-hook-form 7.",
+      "provedBy": []
+    },
+    "frontend-nextjs-project-structure": {
+      "aliases": [
+        "project structure",
+        "folder structure",
+        "src directory",
+        "app directory organization"
+      ],
+      "verifiedAgainst": "Next.js 15 (App Router, `src/` layout).",
+      "provedBy": []
+    },
+    "frontend-nextjs-state-management": {
+      "aliases": [
+        "zustand",
+        "React context",
+        "global state",
+        "state management",
+        "client state"
+      ],
+      "verifiedAgainst": "Next.js 15 + TanStack Query 5 + Zustand 5.",
+      "provedBy": []
+    },
+    "frontend-nextjs-testing": {
+      "aliases": [
+        "vitest",
+        "jest",
+        "testing-library",
+        "Playwright",
+        "Next.js testing",
+        "component tests",
+        "test budget",
+        "orçamento de teste",
+        "it.each table"
+      ],
+      "verifiedAgainst": "Vitest 3 + React Testing Library 16 + MSW 2.",
+      "provedBy": []
+    },
+    "frontend-scroll-driven-frame-scrub": {
+      "aliases": [
+        "frame scrub",
+        "canvas scrub",
+        "scroll-driven video",
+        "scrollytelling video",
+        "apple scroll video",
+        "ffmpeg frames",
+        "poster fallback"
+      ],
+      "verifiedAgainst": "GSAP 3.13 ScrollTrigger + Lenis 1.x + ffmpeg 6.x, shipped to production.",
+      "provedBy": []
+    },
+    "frontend-scroll-driven-scroll-components": {
+      "aliases": [
+        "pinned gallery",
+        "horizontal scroll",
+        "scroll reveal",
+        "parallax drift",
+        "count-up",
+        "lightbox",
+        "scroll progress",
+        "expanding modal"
+      ],
+      "verifiedAgainst": "GSAP 3.13 (ScrollTrigger, matchMedia, context) + React 18 + Lenis 1.x, shipped to production.",
+      "provedBy": []
+    },
+    "frontend-scroll-driven-smooth-scroll": {
+      "aliases": [
+        "lenis",
+        "smooth scroll",
+        "scroll wiring",
+        "gsap ticker",
+        "window.__lenis",
+        "scrolltrigger refresh",
+        "HMR stale triggers"
+      ],
+      "verifiedAgainst": "Lenis 1.x + GSAP 3.13 ScrollTrigger + Vite 5, shipped to production.",
+      "provedBy": []
+    },
+    "frontend-seo-meta-schema-audit": {
+      "aliases": [
+        "seo",
+        "meta tags",
+        "open graph",
+        "og:image",
+        "schema.org",
+        "json-ld",
+        "rich results",
+        "lighthouse",
+        "go-live audit",
+        "canonical"
+      ],
+      "verifiedAgainst": "Schema.org vocabulary + Lighthouse via Chrome DevTools MCP, shipped to production.",
+      "provedBy": []
+    },
+    "infrastructure-docker-coolify-deploy": {
+      "aliases": [
+        "coolify",
+        "docker deploy",
+        "self-hosted",
+        "VPS deployment",
+        "docker compose",
+        "coolify api",
+        "ssh deploy"
+      ],
+      "verifiedAgainst": ".NET 10 + Next.js 15 + Node 22 (Docker base images) + Coolify 4.x API. The `POST /api/v1/deploy` contract was checked against the Coolify docs/OpenAPI on 2026-10-03, and Coolify 4.3.23 was observed answering `GET /deploy` with \"This endpoint has changed to a POST request\"; Dockerfiles and snippets are documentary.",
+      "provedBy": []
+    },
+    "infrastructure-docker-local-compose-isolation": {
+      "aliases": [
+        "compose isolation",
+        "worktree ports",
+        "container_name",
+        "POSTGRES_PORT",
+        "COMPOSE_PROJECT_NAME",
+        "port block",
+        "PG_PORT",
+        "portEnvNames",
+        "local docker compose"
+      ],
+      "verifiedAgainst": "Docker Compose v2 + morph-spec 8.34 (dedicated stack per worktree).",
+      "provedBy": []
+    },
+    "infrastructure-neon-pgrag": {
+      "aliases": [
+        "pgrag",
+        "RAG in SQL",
+        "embedding pipeline",
+        "Neon RAG",
+        "in-database RAG"
+      ],
+      "verifiedAgainst": "Neon pgrag (`rag` extension family — experimental, see Core Rules).",
+      "provedBy": []
+    },
+    "infrastructure-neon-pgvector": {
+      "aliases": [
+        "pgvector",
+        "vector embeddings",
+        "similarity search",
+        "Neon vectors",
+        "HNSW index"
+      ],
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Npgsql.EntityFrameworkCore.PostgreSQL 10.0.3 + Pgvector.EntityFrameworkCore 0.3.0 + Microsoft.Extensions.AI 10.9.0 (ai-pin 2026-09-08). The entity, configuration, DbContext, search-handler and raw-Npgsql blocks compile with `TreatWarningsAsErrors` (handler over the `Result`/`IHandler` of `result-pattern.md`/`vertical-slice.md`), and the handler's query shape was translated with `ToQueryString()` to `ORDER BY d.embedding <=> @query`; the SQL (index DDL, `ef_search`, the two SQL functions) is documentary, checked against the pgvector README.",
+      "provedBy": []
+    },
+    "infrastructure-neon-setup": {
+      "aliases": [
+        "Neon",
+        "neonctl",
+        "serverless postgres",
+        "Neon CLI",
+        "Neon setup"
+      ],
+      "verifiedAgainst": ".NET 10 (SDK 10.0.400-preview) + Npgsql.EntityFrameworkCore.PostgreSQL 10.0.3 + neonctl. The DbContext registration, design-time factory and cold-start blocks compile with `TreatWarningsAsErrors`; that Npgsql 10 rejects `postgresql://` URIs and marks `Trust Server Certificate` as \"no longer needed and does nothing\" was measured on 10.0.3; the suspend-timeout API and `--cu` ranges were checked against the Neon docs (context7). neonctl commands are documentary.",
+      "provedBy": []
+    },
+    "integration-mcp-mcp-tools": {
+      "aliases": [
+        "MCP",
+        "Model Context Protocol",
+        "Claude tools",
+        "MCP server",
+        "MCP client"
+      ],
+      "verifiedAgainst": "Claude Code 2.1.282 MCP tooling — context7, Playwright (as plugin and as a project MCP server); GitHub via `gh` CLI; Neon via its MCP or `neonctl`.",
+      "provedBy": []
+    },
+    "frontend-admin-app-data-table": {
+      "aliases": [
+        "data table",
+        "admin list",
+        "server-side pagination",
+        "paginação",
+        "tabela de dados",
+        "ordenação no servidor",
+        "empty state",
+        "row selection",
+        "bulk actions",
+        "manualPagination"
+      ],
+      "verifiedAgainst": "Next.js 16 App Router + @tanstack/react-table 9 + Zod 4 + shadcn 4 (the code blocks typecheck under `tsc --strict`).",
+      "provedBy": []
+    },
+    "frontend-admin-app-feedback": {
+      "aliases": [
+        "confirmation dialog",
+        "confirm dialog",
+        "delete confirmation",
+        "toast",
+        "sonner",
+        "toast messages",
+        "undo toast",
+        "diálogo de confirmação"
+      ],
+      "verifiedAgainst": "shadcn 4 `AlertDialog` (Radix) + sonner 2 + TanStack Query 5 (the code blocks typecheck under `tsc --strict`).",
+      "provedBy": []
+    },
+    "frontend-admin-app-forms": {
+      "aliases": [
+        "admin form",
+        "crud form",
+        "server validation errors",
+        "ValidationProblemDetails",
+        "unsaved changes",
+        "formulário"
+      ],
+      "verifiedAgainst": "react-hook-form 7 + @hookform/resolvers 5 + Zod 4 + TanStack Query 5 + shadcn 4 `Field` (the code blocks typecheck under `tsc --strict`).",
+      "provedBy": []
+    },
+    "frontend-admin-app-page-structure": {
+      "aliases": [
+        "tabs",
+        "abas",
+        "long page",
+        "página longa",
+        "wizard",
+        "multi-step form",
+        "stepper",
+        "detail page"
+      ],
+      "verifiedAgainst": "Next.js 16 App Router + shadcn 4 `Tabs` (Radix) + react-hook-form 7 + Zod 4 (the code blocks typecheck under `tsc --strict`).",
+      "provedBy": []
+    },
+    "architecture-code-comments": {
+      "aliases": [
+        "code comments",
+        "comentário de código",
+        "comment policy",
+        "política de comentário",
+        "comentário de processo",
+        "self-documenting code"
+      ],
+      "verifiedAgainst": "C#, TypeScript e JavaScript (convenção de linguagem, sem pacote externo).",
+      "provedBy": []
+    },
+    "ai-agents-tool-adapters": {
+      "aliases": [
+        "tool fina",
+        "adaptador de tool",
+        "Ops",
+        "Desfecho",
+        "Render",
+        "regra de negocio em tool",
+        "descricao da tool",
+        "golden de tool",
+        "refactor neutro",
+        "migracao de teste"
+      ],
+      "verifiedAgainst": "Microsoft.Extensions.AI 10.9.0 + Microsoft.Agents.AI 1.20.0 (ai-pin 2026-09-08); os dois blocos C# abaixo foram extraídos com `scripts/extract-doc-csharp.mjs` e compilados contra o pin com `TreatWarningsAsErrors`, e os três testes do segundo bloco foram executados e passam. **A separação em si e a migração de teste são verificação documental:** vêm da feature `tools-finas` do MORPH_GHLBrain e o ai-kit não as traz.",
+      "provedBy": []
+    }
+  },
+  "sharedAliases": {
+    "agent middleware": [
+      "ai-agents-production",
+      "ai-agents-middleware-patterns"
+    ],
+    "anti-hallucination": [
+      "ai-agents-production",
+      "ai-agents-middleware-patterns"
+    ],
+    "agent observability": [
+      "ai-agents-production",
+      "ai-agents-observability-patterns"
+    ],
+    "agent telemetry": [
+      "ai-agents-production",
+      "ai-agents-observability-patterns"
+    ],
+    "when not to use workflow": [
+      "ai-agents-workflows",
+      "ai-agents-sweet-spot"
+    ],
+    "rag": [
+      "ai-agents-rag-custom-pgvector",
+      "backend-database-vector-search-rag"
+    ],
+    "vector search": [
+      "ai-agents-rag-custom-pgvector",
+      "backend-database-vector-search-rag"
+    ],
+    "pgvector": [
+      "ai-agents-rag-custom-pgvector",
+      "backend-database-vector-search-rag",
+      "infrastructure-neon-pgvector"
+    ],
+    "embeddings": [
+      "ai-agents-rag-custom-pgvector",
+      "backend-database-vector-search-rag"
+    ],
+    "semantic search": [
+      "ai-agents-rag-custom-pgvector",
+      "backend-database-vector-search-rag"
+    ],
+    "middleware": [
+      "ai-agents-middleware-patterns",
+      "frontend-nextjs-nextjs-patterns"
+    ],
+    "image generation": [
+      "ai-agents-modalities-image-gen",
+      "frontend-design-system-ai-image-generation"
+    ],
+    "mcp": [
+      "ai-agents-mcp-tools",
+      "integration-mcp-mcp-tools"
+    ],
+    "model context protocol": [
+      "ai-agents-mcp-tools",
+      "integration-mcp-mcp-tools"
+    ],
+    "mcp client": [
+      "ai-agents-mcp-tools",
+      "integration-mcp-mcp-tools"
+    ],
+    "mcp server": [
+      "ai-agents-mcp-server",
+      "integration-mcp-mcp-tools"
+    ],
+    "feature slice": [
+      "architecture-vertical-slice-vertical-slice",
+      "backend-dotnet-vsa-handler-patterns"
+    ],
+    "component naming": [
+      "frontend-design-system-naming",
+      "frontend-nextjs-naming-conventions"
+    ],
+    "video generation": [
+      "ai-agents-media-video",
+      "frontend-design-system-ai-video-generation"
+    ],
+    "seedance": [
+      "ai-agents-media-video",
+      "frontend-design-system-ai-video-generation"
+    ],
+    "test budget": [
+      "backend-dotnet-testing",
+      "frontend-nextjs-testing"
+    ],
+    "orçamento de teste": [
+      "backend-dotnet-testing",
+      "frontend-nextjs-testing"
+    ]
+  }
+}