@polymorphism-tech/morph-spec 9.3.0 → 9.4.0

package/framework/standards/architecture/engineering-lens.md

@@ -0,0 +1,100 @@
+# Lente de engenharia — código para quem herda amanhã
+
+> **Scope:** universal
+> **Layer:** 0 (resumo injetado pelas rules `csharp-standards` (`**/*.cs`, `**/*.csproj`) e `nextjs-standards` (`**/*.ts`, `**/*.tsx`); texto completo sob demanda via `morph-spec standards --find`)
+> **Keywords:** clean code, código limpo, fragilidade, código morto, excesso, legibilidade, extensibilidade, flag booleana, efeito colateral, conventional commits
+> **Load When:** escrevendo, planejando ou revisando código em qualquer stack
+
+**Verified against:** C#, TypeScript e JavaScript (convenção de linguagem, sem pacote externo); Conventional Commits 1.0.0. Last-verified: 2026-10-18.
+
+---
+
+## Quem herda amanhã
+
+Escreva para quem abre o repo amanhã e precisa entregar uma feature na semana seguinte. A
+convenção que o projeto já usa vence o seu gosto. O mais simples que resolve vence o mais geral.
+Bug se corrige na causa raiz, nunca no sintoma.
+
+## Fragilidade
+
+Código que quebra fácil:
+
+- `catch` vazio, ou que só loga e segue como se nada tivesse acontecido.
+- Null ou ausência vindo de fronteira (HTTP, banco, arquivo, LLM) sem tratamento.
+- Dependência de ordem implícita: método que só funciona se outro rodou antes.
+- Parser estrito diante de dado real (campo opcional tratado como obrigatório, enum fechado para
+  valor externo).
+- Guard cego: a checagem e o dado saem do mesmo serializador, então ela nunca falha.
+- Teste que passa sem provar a regra (ver `backend-dotnet-testing` / `frontend-nextjs-testing`).
+
+## Código morto
+
+Símbolo, endpoint, flag, config ou tabela sem consumidor real sai. Feature começada e largada
+sai. Dois caminhos que fazem a mesma coisa viram um. Quando "X só é usado por Y", pergunte para
+quê Y existe: muitas vezes os dois saem. Código comentado sai, porque o git guarda o antigo.
+
+## Excesso
+
+- Abstração (interface, factory, base class, strategy) sem um segundo uso hoje.
+- Camada que só repassa a chamada.
+- Config ou parâmetro para um caso que ninguém pediu (o "e se um dia eu quiser voar com o carro":
+  construa as asas quando for voar).
+- Stdlib, plataforma ou dependência já instalada reinventada à mão.
+
+No plano, todo CRIAR de abstração diz no `why` o segundo uso ou a próxima adição que ela barateia.
+
+## Legibilidade
+
+- **Nomes:** descritivos, pronunciáveis, buscáveis, na linguagem do domínio. Distinção com
+  significado (`sourceAccount`/`targetAccount`, nunca `account1`/`account2`). Sem prefixo de tipo
+  nem caractere especial. Classe é substantivo, método é verbo, e um padrão aparece no nome
+  (`InvoiceFactory`). Um idioma por identificador.
+- **Funções:** pequenas, com um objetivo só. Poucos parâmetros (passou de 3, agrupe num tipo).
+  Sem efeito colateral fora do próprio objeto que o nome não anuncie.
+- **Sem flag booleana que bifurca o método** — são dois métodos:
+
+```ts
+// ruim
+sendInvoice(invoice, true);
+// bom
+sendInvoiceByEmail(invoice);
+sendInvoiceByWhatsApp(invoice);
+```
+
+- **Condicional positiva:** `if (order.isEmpty)` em vez de `if (!order.hasItems)`; o `!` some na leitura.
+- **Literal repetido vira constante** (detalhe em `architecture-code-comments`).
+- **Estrutura:** por feature/slice (`architecture-vertical-slice-vertical-slice`); variável declarada
+  perto do uso; funções de cima para baixo, a chamadora antes da chamada; funções afins juntas; sem
+  alinhamento horizontal; formatação pelo formatter do projeto.
+- **Comentários:** `architecture-code-comments` é a regra única.
+
+## Extensibilidade
+
+A próxima adição provável (uma skill nova, um campo novo de config refletido na tela, um provider
+novo) deve tocar poucos arquivos e nenhum `switch` espalhado. Se exige editar N lugares que precisam
+concordar, o atrito é o registro que falta, não a falta de uma camada genérica.
+
+## IA e código
+
+Regra que nunca pode ser quebrada fica em código, nunca vira prompt (`ai-agents-guardrails`). O
+inverso também vale: regex, heurística ou árvore de `if` que classifica linguagem natural é candidata
+a structured output, e a troca só entra medida por eval (`ai-agents-evals-with-cache`).
+
+## Git
+
+A branch é `morph/{f}`, criada pelo CLI. Commits seguem Conventional Commits:
+`<tipo>(<escopo>): <assunto>`, com o tipo em `feat`, `fix`, `refactor`, `test`, `chore`, `docs`,
+`perf`, `ci`, `build`, `style` ou `revert`. O hook `conventional-commit` recusa outra forma.
+
+## O que bloqueia no Gate 3
+
+Só o que o **diff introduziu**. O que já existia no arquivo vira nota.
+
+1. `catch` que engole a exceção.
+2. Flag booleana que bifurca o método.
+3. Efeito colateral escondido: o método muda estado alheio e o nome não diz.
+4. Símbolo, flag ou config sem consumidor, ou código comentado.
+5. Abstração ou camada sem segundo uso e sem `why` no plano.
+6. Literal mágico repetido em comparação.
+
+O resto (nome, tamanho, ordem, "eu faria diferente") é nota.

package/framework/standards/architecture/vertical-slice/vertical-slice.md

@@ -380,20 +380,18 @@ app.MapApiEndpoints();
 | Errors class | `{Entity}Errors` | `BookErrors` (static, shared por feature) |
 | DTO record (GetAll) | `{Entity}Dto` | `BookDto` |
 | API tag constant | `ApiTags.{Entities}` | `ApiTags.Books` |
-| Entity class | `{Entity}` (`sealed`) | `Book` |
+| Entity class | `{Entity}` | `Book` |
 
 ---
 
 ## Padrões Obrigatórios
 
 1. **Handler records no mesmo arquivo**: `Request` e `Response` são declarados no mesmo arquivo `.cs` que o `Handler`.
-2. **`sealed` em tudo**: handlers, endpoints, validators, request/response records usam `sealed`.
-3. **`Guid.CreateVersion7()`** para gerar IDs (não `Guid.NewGuid()`).
-4. **`result.Match()`** nos endpoints — o sucesso recebe o valor no lambda (nunca ler `result.Value`) e a falha vira `error.ToHttpResult()` (status pelo `ErrorType`, nunca `Results.BadRequest` para todo erro).
-5. **IApiEndpoint `internal sealed`** — endpoints não são públicos.
-6. **`{Entity}Errors` compartilhado** por todas as operações da feature (1 arquivo por feature, não por slice).
-7. **`ApplicationDbContext` direto no slice**: CRUD por chave via `DbSet<T>`; queries específicas (joins, projeção, paginação) via LINQ no handler. Nunca uma Application Service layer entre handler e dados; nunca repository genérico (`IRepository<T>`/`IUnitOfWork`).
-8. **`SaveChangesAsync()`** explícito em operações de escrita (Create, Update, Delete).
+2. **`result.Match()`** nos endpoints — o sucesso recebe o valor no lambda (nunca ler `result.Value`) e a falha vira `error.ToHttpResult()` (status pelo `ErrorType`, nunca `Results.BadRequest` para todo erro).
+3. **IApiEndpoint `internal`** — endpoints não são públicos.
+4. **`{Entity}Errors` compartilhado** por todas as operações da feature (1 arquivo por feature, não por slice).
+5. **`ApplicationDbContext` direto no slice**: CRUD por chave via `DbSet<T>`; queries específicas (joins, projeção, paginação) via LINQ no handler. Nunca uma Application Service layer entre handler e dados; nunca repository genérico (`IRepository<T>`/`IUnitOfWork`).
+6. **`SaveChangesAsync()`** explícito em operações de escrita (Create, Update, Delete).
 9. **Sem validator em GetAll** — GetAllBooksHandler não tem validator (sem parâmetros para validar).
 
 ---
@@ -402,7 +400,7 @@ app.MapApiEndpoints();
 
 | Anti-pattern | Por quê não |
 |--------------|-------------|
-| `AggregateRoot` | VSA não usa DDD — entidade simples com `sealed class` |
+| `AggregateRoot` | VSA não usa DDD — entidade simples |
 | `DomainEvent` | VSA não tem Domain Events — reações são handlers separados |
 | `MediatR` / `IRequest` / `IRequestHandler` | Substituído por `IHandler<TRequest, TResponse>` próprio |
 | DTOs compartilhados entre features | Cada slice define seus próprios records |

package/framework/standards/backend/dotnet/analyzers.md

@@ -0,0 +1,59 @@
+# Analyzers .NET — o build cobra, a prosa não repete
+
+> **Scope:** dotnet
+> **Layer:** 0 (resumo injetado pela rule `csharp-standards` (`**/*.cs`, `**/*.csproj`); o `stack-scan` acusa o projeto sem estes arquivos)
+> **Keywords:** analyzer, roslyn, BannedApiAnalyzers, BannedSymbols, globalconfig, Guid.NewGuid, CreateVersion7, CancellationToken, CA2016, RS0030
+> **Load When:** projeto .NET sem `BannedSymbols.txt`, ou o build acusou RS0030/CA2016
+
+**Verified against:** .NET SDK 10.0.402, Microsoft.CodeAnalysis.BannedApiAnalyzers 5.6.0 (sonda: `Guid.NewGuid()` → erro RS0030, token não repassado → erro CA2016, código conforme → 0 erros). Last-verified: 2026-10-18.
+
+---
+
+Regra de código que tem motivo e nunca pode ser quebrada vira **erro de build**, não frase que o
+agente relê a cada sessão. Estes três arquivos na raiz da solution bastam; nenhum `.csproj` muda.
+
+## Arquivos
+
+`Directory.Build.props` (se já existe, some o `ItemGroup` ao dele):
+
+```xml
+<Project>
+  <ItemGroup>
+    <PackageReference Include="Microsoft.CodeAnalysis.BannedApiAnalyzers" Version="5.6.0" PrivateAssets="all" />
+    <AdditionalFiles Include="$(MSBuildThisFileDirectory)BannedSymbols.txt" />
+    <GlobalAnalyzerConfigFiles Include="$(MSBuildThisFileDirectory)morph.globalconfig" />
+  </ItemGroup>
+</Project>
+```
+
+Com Central Package Management (`Directory.Packages.props`), a versão vai lá e o
+`PackageReference` fica sem `Version`.
+
+`BannedSymbols.txt`:
+
+```text
+M:System.Guid.NewGuid;Use Guid.CreateVersion7(): ordenado, nao fragmenta o indice da PK
+```
+
+`morph.globalconfig`:
+
+```ini
+is_global = true
+dotnet_diagnostic.RS0030.severity = error
+dotnet_diagnostic.CA2016.severity = error
+```
+
+## O que cada regra compra
+
+| Diagnóstico | Bloqueia | Por quê |
+|---|---|---|
+| RS0030 | `Guid.NewGuid()` | UUID v4 é aleatório: PK nele fragmenta o índice B-tree do Postgres a cada insert; `Guid.CreateVersion7()` é ordenado no tempo |
+| CA2016 | método que recebe `CancellationToken` e não o repassa | requisição cancelada continua segurando conexão do banco e chamada ao LLM |
+
+API nova para banir entra como linha no `BannedSymbols.txt` (formato `M:`/`T:`/`P:` com a
+mensagem depois do `;`), com o porquê na mensagem. Nunca uma regra nova em prosa.
+
+## O que não é regra
+
+`sealed`, primary constructor, `var`, expression-bodied member e ordem de `using` são gosto: nem
+prosa nem analyzer. Siga o arquivo vizinho, e o formatter do projeto decide a forma.

package/framework/standards/backend/dotnet/vsa-handler-patterns.md

@@ -11,7 +11,7 @@
 
 ## Overview
 
-Each feature in VSA is a self-contained slice with 5 files in a feature folder. Handlers implement `IHandler<TRequest, TResponse>` (not MediatR). Dependencies use primary constructors. The data path is `Handler -> ApplicationDbContext` — no service layer, no generic repository in between.
+Each feature in VSA is a self-contained slice with 5 files in a feature folder. Handlers implement `IHandler<TRequest, TResponse>` (not MediatR). The data path is `Handler -> ApplicationDbContext` — no service layer, no generic repository in between.
 
 ---
 
@@ -108,11 +108,8 @@ public sealed class CreateBookHandler(
 
 ### Key Patterns
 
-- **`sealed class`** — handlers are never inherited
-- **`sealed record`** — DTOs are immutable value types
-- **Primary constructors** — `(ApplicationDbContext db)` replaces field + constructor boilerplate
-- **`Guid.CreateVersion7()`** — time-sortable, index-friendly UUID (not `Guid.NewGuid()`)
-- **`CancellationToken`** — passed through every async call
+- **`record`** — DTOs are immutable value types
+- **`Guid.CreateVersion7()` and a forwarded `CancellationToken`** — enforced by the build (`backend-dotnet-analyzers`), not by review
 - **`Result<T>` return** — never throw for expected failures
 
 ---
@@ -149,7 +146,7 @@ internal sealed class CreateBookEndpoint : IApiEndpoint
 
 ### Endpoint Conventions
 
-- **`internal sealed`** — endpoints are not public API
+- **`internal`** — endpoints are not public API
 - **`IApiEndpoint`** — single interface for auto-discovery
 - **Handler injected via DI** — resolved as `IHandler<TReq, TRes>` parameter
 - **`Match()` for responses** — the success lambda receives the value (never read `.Value` directly); the failure lambda is `error.ToHttpResult()` from `Extensions/ErrorHttpMapping.cs` (`backend/dotnet/result-pattern.md`), which maps `ErrorType` to the status — never `Results.BadRequest` for every error
@@ -299,13 +296,9 @@ builder.Services.AddExceptionHandler<CustomExceptionHandler>()
 | Use MediatR `IRequest`/`Send()` | Use `IHandler<TReq, TRes>` resolved directly from DI |
 | Create a service/manager layer | Handler uses `ApplicationDbContext` directly |
 | Add a generic repository (`IRepository<T>`/`IUnitOfWork`) | `DbSet<T>` is the repository; `DbContext` is the unit of work |
-| Use `Guid.NewGuid()` | Use `Guid.CreateVersion7()` for time-sortable IDs |
-| Make handler classes non-sealed | Always `sealed class` |
-| Use mutable DTOs (class with setters) | Always `sealed record` with positional parameters |
-| Omit `CancellationToken` from async methods | Pass `CancellationToken` through every async call |
+| Use mutable DTOs (class with setters) | Always `record` with positional parameters |
 | Put business logic in endpoints | Endpoints only map HTTP and call `Match()` |
 | Share handlers across features | Each feature has its own handler, even if similar |
-| Use constructor + field for DI | Use primary constructors: `class Handler(IDep dep)` |
 | Group by technical concern (Controllers/, Services/) | Group by feature: `Features/BookFeature/CreateBook/` |
 | Route data access through any indirection layer | Inject `DbContext` and write LINQ in the slice; dedicated store only with `plan.md` (`## Decisões`) justification |
 | Use raw SQL (`FromSqlRaw` / `ExecuteQuery(string)`) by default | Use LINQ; raw SQL only with a `plan.md` (`## Decisões`) justification |

package/framework/templates/README.md

@@ -36,7 +36,6 @@ framework/templates/
 │
 ├── integrations/      # asaas-client, asaas-webhook, neon-auth-config
 ├── ui/                # design-system.css
-├── meta-prompts/      # fusion, squad-leaders, validators
 ├── examples/          # design-system-examples.md
 └── REGISTRY.json      # template metadata — the index every consumer reads
 ```

package/framework/templates/REGISTRY.json

@@ -642,213 +642,6 @@
       "isFragment": true,
       "validatePlaceholders": true
     },
-    {
-      "id": "hop-squad-leader",
-      "kind": "template",
-      "name": "Squad Leader HOP",
-      "path": "meta-prompts/squad-leaders/squad-leader.md",
-      "location": "framework",
-      "category": "meta-prompts",
-      "technology": "handlebars",
-      "phase": "implement",
-      "required": false,
-      "description": "Generic squad leader higher-order prompt with mission, domain-leaders, standards, tasks, deliverables, constraints",
-      "outputName": "squad-leader-prompt.md",
-      "placeholders": [
-        "AGENT_ID",
-        "CONSTRAINTS",
-        "DELIVERABLES",
-        "DOMAIN",
-        "DOMAIN_LEADERS",
-        "FEATURE_NAME",
-        "MISSION",
-        "SPEC_SUMMARY",
-        "STANDARDS",
-        "TASKS"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "hopType": "squad-leader",
-      "validatePlaceholders": true
-    },
-    {
-      "id": "hop-backend-squad",
-      "kind": "template",
-      "name": "Backend Squad Leader HOP",
-      "path": "meta-prompts/squad-leaders/backend-squad.md",
-      "location": "framework",
-      "category": "meta-prompts",
-      "technology": "handlebars",
-      "phase": "implement",
-      "required": false,
-      "description": "Backend squad leader HOP for dotnet-senior with backend domain leaders, .NET 10 standards, architecture and security guidelines",
-      "outputName": "backend-squad-prompt.md",
-      "placeholders": [
-        "ADDITIONAL_LEADERS",
-        "AGENT_ID",
-        "CONSTRAINTS",
-        "DELIVERABLES",
-        "FEATURE_NAME",
-        "MISSION",
-        "SPEC_SUMMARY",
-        "TASKS"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "hopType": "squad-leader",
-      "applicableStacks": [
-        "nextjs-neon"
-      ],
-      "validatePlaceholders": true
-    },
-    {
-      "id": "hop-frontend-squad",
-      "kind": "template",
-      "name": "Frontend Squad Leader HOP",
-      "path": "meta-prompts/squad-leaders/frontend-squad.md",
-      "location": "framework",
-      "category": "meta-prompts",
-      "technology": "handlebars",
-      "phase": "implement",
-      "required": false,
-      "description": "Frontend squad leader HOP for ui-designer with Next.js domain leaders and design system standards",
-      "outputName": "frontend-squad-prompt.md",
-      "placeholders": [
-        "ADDITIONAL_LEADERS",
-        "AGENT_ID",
-        "CONSTRAINTS",
-        "DELIVERABLES",
-        "DOMAIN",
-        "FEATURE_NAME",
-        "MISSION",
-        "SPEC_SUMMARY",
-        "TASKS"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "hopType": "squad-leader",
-      "applicableStacks": [
-        "nextjs-neon"
-      ],
-      "validatePlaceholders": true
-    },
-    {
-      "id": "hop-checkpoint-validator",
-      "kind": "template",
-      "name": "Checkpoint Validator HOP",
-      "path": "meta-prompts/validators/checkpoint-validator.md",
-      "location": "framework",
-      "category": "meta-prompts",
-      "technology": "handlebars",
-      "phase": "implement",
-      "required": false,
-      "description": "Checkpoint validator HOP running architecture, security, design-system, and packages validators with pass/fail decision logic",
-      "outputName": "checkpoint-validator-prompt.md",
-      "placeholders": [
-        "CHECKPOINT_FREQUENCY",
-        "CHECKPOINT_NUM",
-        "FEATURE_NAME",
-        "FILES_CHANGED",
-        "RECENT_TASKS",
-        "TASKS_COMPLETED",
-        "TASKS_SINCE_LAST",
-        "TASKS_TOTAL"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "hopType": "validator",
-      "validatePlaceholders": true
-    },
-    {
-      "id": "hop-pre-commit-validator",
-      "kind": "template",
-      "name": "Pre-Commit Validator HOP",
-      "path": "meta-prompts/validators/pre-commit-validator.md",
-      "location": "framework",
-      "category": "meta-prompts",
-      "technology": "handlebars",
-      "phase": "implement",
-      "required": false,
-      "description": "Pre-commit hook validator HOP checking conventional commits, secrets, agent spec validity, and stack-specific rules",
-      "outputName": "pre-commit-validator-prompt.md",
-      "placeholders": [
-        "BRANCH_NAME",
-        "FEATURE_NAME",
-        "STAGED_FILES",
-        "STAGED_FILE_COUNT",
-        "TODO"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "hopType": "validator",
-      "validatePlaceholders": false
-    },
-    {
-      "id": "hop-fusion-agent",
-      "kind": "template",
-      "name": "Fusion Agent HOP",
-      "path": "meta-prompts/fusion/fusion-agent.md",
-      "location": "framework",
-      "category": "meta-prompts",
-      "technology": "handlebars",
-      "phase": "implement",
-      "required": false,
-      "description": "F-Thread fusion participant HOP with approach hints per thread index (standard, alternative, optimized) and self-assessment scoring",
-      "outputName": "fusion-agent-prompt.md",
-      "placeholders": [
-        "AGENT_ID",
-        "DELIVERABLES",
-        "FUSION_STRATEGY",
-        "SPEC_SUMMARY",
-        "STANDARDS",
-        "TASK_DESCRIPTION",
-        "THREAD_COUNT",
-        "THREAD_COUNT_MINUS_ONE",
-        "THREAD_ID",
-        "THREAD_INDEX"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "hopType": "fusion",
-      "validatePlaceholders": true
-    },
-    {
-      "id": "hop-fusion-aggregator",
-      "kind": "template",
-      "name": "Fusion Aggregator HOP",
-      "path": "meta-prompts/fusion/fusion-aggregator.md",
-      "location": "framework",
-      "category": "meta-prompts",
-      "technology": "handlebars",
-      "phase": "implement",
-      "required": false,
-      "description": "F-Thread aggregator HOP that scores and selects the winning implementation using best-of-n, consensus, or manual-select strategies",
-      "outputName": "fusion-aggregator-prompt.md",
-      "placeholders": [
-        "AGENT_1",
-        "AGENT_2",
-        "AGENT_3",
-        "FEATURE_NAME",
-        "FUSION_RESULTS",
-        "FUSION_STRATEGY",
-        "SESSION_ID",
-        "THREAD_COUNT",
-        "WINNING_AGENT",
-        "WINNING_SCORE",
-        "WINNING_THREAD"
-      ],
-      "stackSpecific": false,
-      "engine": "handlebars",
-      "deprecated": false,
-      "hopType": "fusion",
-      "validatePlaceholders": true
-    },
     {
       "id": "dotnet-abstractions-handler",
       "kind": "fragment",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "9.3.0",
+  "version": "9.4.0",
   "description": "MORPH-SPEC: NLH (Natural Language Harness) for spec-driven development with Claude Code",
   "keywords": [
     "claude-code",

package/src/commands/project/worktree.js

@@ -743,7 +743,7 @@ export async function clearRootWorktreeRegistration(root, feature, { stamp } = {
     let unchanged = true;
     try { execFileSync('git', ['diff', '--quiet', 'HEAD', '--', featPathspec], gitOpts); } catch { unchanged = false; }
     if (!unchanged) {
-      execFileSync('git', ['commit', '-m', `morph-spec finish: clear ${feature} worktree registration`, '--', featPathspec], gitOpts);
+      execFileSync('git', ['commit', '-m', `chore(morph): clear ${feature} worktree registration`, '--', featPathspec], gitOpts);
     }
   } catch { /* fail-open — a dirty root is a nuisance, not a reason to fail */ }
   return { shedBackup: null };

package/src/commands/state/archive.js

@@ -123,7 +123,7 @@ export function runArchive(feature, opts = {}) {
       ...(adrIndex.changed ? [ADR_INDEX_PATHSPEC] : []),
     ];
     try {
-      execFileSync('git', ['commit', '-m', `morph-spec archive: ${feature}`, '--', ...pathspecs], { cwd, stdio: 'pipe' });
+      execFileSync('git', ['commit', '-m', `chore(morph): archive ${feature}`, '--', ...pathspecs], { cwd, stdio: 'pipe' });
       committed = true;
     } catch { /* nothing to commit / no identity — not fatal, the move + stage stand */ }
   }

package/src/commands/state/finish.js

@@ -494,7 +494,7 @@ export function finishPreflight({ feature, root, worktreePath, cwd, mode, branch
 }
 
 async function integrateMerge({ emit, root, feature, expectedBranch, defaultBranch, isWorktreeFlow, worktreePath, options, arch, backupStamp }) {
-  const mergeMsg = `morph-spec finish: merge ${expectedBranch}`;
+  const mergeMsg = `chore(morph): merge ${expectedBranch}`;
   const adrNote = adrIndexNote(arch);
 
   if (isWorktreeFlow) {

package/src/core/templates/template-registry.js

@@ -36,7 +36,7 @@ export function clearRegistryCache() {
   _registryCache.clear();
 }
 
-export function getAllTemplates(projectPath = null) {
+function getAllTemplates(projectPath = null) {
   const registry = loadTemplateRegistry(projectPath);
   return registry.templates || [];
 }
@@ -46,48 +46,6 @@ export function getTemplateById(templateId, projectPath = null) {
   return templates.find(t => t.id === templateId) || null;
 }
 
-export function getTemplatesByCategory(category, projectPath = null) {
-  const templates = getAllTemplates(projectPath);
-  return templates.filter(t => t.category === category);
-}
-
-export function getTemplatesByStack(stackId, projectPath = null) {
-  const templates = getAllTemplates(projectPath);
-  return templates.filter(t => {
-    if (!t.stackSpecific) return true;
-
-    return t.stacks && t.stacks.includes(stackId);
-  });
-}
-
-export function getRequiredTemplates(stackId = null, projectPath = null) {
-  let templates = getAllTemplates(projectPath);
-
-  templates = templates.filter(t => t.required === true);
-
-  if (stackId) {
-    templates = templates.filter(t => {
-      if (!t.stackSpecific) return true;
-      return t.stacks && t.stacks.includes(stackId);
-    });
-  }
-
-  return templates;
-}
-
-export function searchTemplates(keyword, projectPath = null) {
-  const templates = getAllTemplates(projectPath);
-  const lowerKeyword = keyword.toLowerCase();
-
-  return templates.filter(t => {
-    return (
-      t.id.toLowerCase().includes(lowerKeyword) ||
-      t.name.toLowerCase().includes(lowerKeyword) ||
-      (t.description && t.description.toLowerCase().includes(lowerKeyword))
-    );
-  });
-}
-
 const FRAMEWORK_TEMPLATES_DIR = join(__dirname, '../../../framework/templates');
 
 /** Path inside this package's `framework/templates/`, not a project's `.morph/`; throws when missing. */

package/src/lib/stack/stack-scan.js

@@ -135,12 +135,10 @@ function auditDotnet(files, read) {
   if (serviceLayer.length > 0) add('Alto', 'Camada de Service/Manager entre handler e dados', serviceLayer, 'o handler fala com o `ApplicationDbContext` direto');
   const rawSql = grepFiles(source, read, /\b(FromSqlRaw|ExecuteSqlRaw|SqlQueryRaw|ExecuteQuery)\s*\(/);
   if (rawSql.length > 0) add('Alto', 'SQL cru', rawSql, 'LINQ, ou store dedicado com justificativa em ADR');
-  const notSealed = source.filter((f) => {
-    const text = read(f) ?? '';
-    return [...text.matchAll(/^\s*(?:public|internal)\s+((?:\w+\s+)*)class\s+\w+/gm)]
-      .some((m) => !/\b(sealed|abstract|static|partial)\b/.test(m[1]));
-  });
-  if (notSealed.length > 0) add('Médio', 'Classes não-sealed', notSealed, '`sealed` por padrão');
+  if (projects.length > 0 && !packages.has('Microsoft.CodeAnalysis.BannedApiAnalyzers')) {
+    add('Médio', 'Analyzers do stack ausentes (o build não barra `Guid.NewGuid()` nem token não repassado)', [],
+      '`Directory.Build.props` + `BannedSymbols.txt` + `morph.globalconfig` na raiz: `morph-spec standards --show backend-dotnet-analyzers#files`');
+  }
   const controllers = grepFiles(source, read, /:\s*Controller(Base)?\b/);
   rows.push({ layer: 'Estrutura', detected: controllers.length > 0 ? `${controllers.length} controller(s) MVC` : 'sem controllers', expected: 'VSA (endpoint por slice)', ok: controllers.length === 0 });
   return { rows, deviations };

package/src/utils/agents-installer.js

@@ -289,7 +289,7 @@ export const DISPATCH_CONTRACT = [
     'Grave a saída em arquivo (`… > .morph/logs/test-last.log 2>&1`, sem nada depois) e leia o arquivo — um pipe troca o exit do teste pelo do último comando. ' +
     'Em batch paralelo SEM isolamento, só compile. Com `isolation: "worktree"`, o mesmo vale no seu worktree, e o último ato é o commit na branch dele.',
   '4. ESCOPO: uma fatia, ~4 arquivos (nunca mais de 8). Escopo maior falha e volta — fatie antes, não depois.',
-  '5. SOBREVIVÊNCIA: o limite de turnos corta sem aviso: commite `wip(F{n})` a cada marco (um arquivo ou uma fatia coerente escrita), não só ao fim — ' +
+  '5. SOBREVIVÊNCIA: o limite de turnos corta sem aviso: commite `chore(F{n}): wip …` a cada marco (um arquivo ou uma fatia escrita), não só ao fim — ' +
     'e só os seus arquivos (`git add <paths>`, nunca `-A` nem diretório). Sem commit, a retomada recomeça do zero.',
   '6. PROCESSOS: NUNCA `taskkill /IM node.exe` (derruba os MCPs de todas as sessões). Encerre dev server pelo PID que você mesmo subiu. ' +
     'Build e suíte pesados rodam por `morph-spec heavy run -- <comando>`, em primeiro plano. Exit 3 é fila cheia depois da espera da própria fila: ' +

package/src/utils/hooks-installer.js

@@ -64,7 +64,7 @@ const MORPH_HOOKS = [
     hooks: [{
       type: 'command',
       command: 'node framework/hooks/claude-code/core/chain.js',
-      args: ['pre-bash-denylist', 'block-destructive-worktree-removal', 'block-raw-worktree-add', 'warn-bash-source-write', 'heavy-gate', 'worktree-env-inject']
+      args: ['pre-bash-denylist', 'conventional-commit', 'block-destructive-worktree-removal', 'block-raw-worktree-add', 'warn-bash-source-write', 'heavy-gate', 'worktree-env-inject']
     }]
   },