@polymorphism-tech/morph-spec 8.41.0 → 8.43.0

package/framework/skills/core/morph-implement/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a execução de cada tarefa de implementação com standard e
 version: core
 when-to-invoke: ao iniciar cada task de implementação listada em tasks.json
 user-invokable: false
-cliVersion: "8.41.0"
+cliVersion: "8.43.0"
 ---
 
 # morph-implement
@@ -94,7 +94,9 @@ Ao iniciar cada task de `tasks.json` — antes de escrever qualquer código. Nor
    Comentário: o padrão é nenhum. Nome, tipo e teste explicam o código; sem
    `///`/JSDoc em membro de aplicação, cabeçalho, banner de seção ou história
    da task. Só o porquê que o código não mostra, em uma linha
-   (`architecture-code-comments`).
+   (`architecture-code-comments`). O elo com a pós-condição vai no nome do
+   teste; a densidade do arquivo vizinho não é modelo. O hook `comment-guard`
+   bloqueia a edição que adiciona história, banner ou bloco longo.
 
    Contrato do relatório final:
    1. GRAVE `.morph/features/{feature}/3-implement/reports/[ID].md` ANTES de
@@ -130,7 +132,10 @@ Ao iniciar cada task de `tasks.json` — antes de escrever qualquer código. Nor
       por decisão sua; ao concluir, o relatório final substitui o parcial, sem o
       `PARCIAL`. Sem limite declarado, bastam os commits por marco.
    6. PROCESSOS: NUNCA `taskkill /IM node.exe` (derruba os MCPs de todas as
-      sessões). Encerre dev server pelo PID que você mesmo subiu.
+      sessões). Encerre dev server pelo PID que você mesmo subiu. Build e
+      suíte pesados (`dotnet build`, `dotnet test`, `docker compose up`) rodam
+      por `morph-spec heavy run -- <comando>`: exit 3 é fila cheia, não erro do
+      código — espere e repita.
    7. RETORNO: o relatório no arquivo canônico é o retorno. `SendMessage` não é
       substituto do relatório e não deve ser chamado.
    8. MUTAÇÃO: nunca altere, reverta, mova ou apague código de produção para ver
@@ -151,7 +156,9 @@ Ao iniciar cada task de `tasks.json` — antes de escrever qualquer código. Nor
    deixa o disco a meio caminho — e um relatório lido sobre uma árvore que ninguém conferiu avalia
    um estado que ninguém quis. Árvore inesperadamente suja ou `markers` não vazio é falha de
    protocolo: registre no recap antes de pontuar. Essa saída serve ao passo 7 enquanto a árvore
-   não mudar; depois de uma correção sua, rode de novo.
+   não mudar; depois de uma correção sua, rode de novo. Dispatch com `isolation: "worktree"`:
+   depois de ler o relatório, `morph-spec worktree reap --json` remove o worktree do agent que parou
+   limpo e sem commit exclusivo; o que fica vem listado com a razão.
 
    Após o retorno do dispatch: **leia primeiro** `.morph/features/{feature}/3-implement/reports/[ID].md`
    — é o valor de retorno autoritativo. Trate a mensagem de texto do sub-agent, se chegou inteira,
@@ -265,7 +272,7 @@ Ao iniciar cada task de `tasks.json` — antes de escrever qualquer código. Nor
    > tasks.json + recap.md + `taskScores` do feature.json. **NÃO escreva o trace
    > manualmente** — a escrita manual foi removida da cerimônia por task.
 
-9. Quando invocada por `morph-apply`, retornar o controle à skill orquestradora — ela decide qual task vem em seguida via `getReadyTasks(data)`. Não rode a suíte de testes inteira do projeto por conta própria ao fim da task quando invocada pela `morph-apply` — a verificação determinística (`morph-spec verify {feature} {task}`) é do orquestrador, logo após seu retorno (ver morph-apply §3a). **Única exceção:** a execução de evidência do passo 5 — só o nó `evals`, filtrado, com `--skip-e2e`, nunca persistida (`--no-persist`); ela não é a verificação da task e não substitui a do orquestrador. **A divisão:** no loop por task o recorte é **automático** — o `group` da task escolhe as suítes e os arquivos de teste dos `outputs` (passo 8) estreitam o comando dentro de cada uma (o relógio de uma task não paga a suíte inteira); `--filter {ids}` só força a escolha de suítes (um nó não casado aparece como `skip` nomeando o filtro, e um filtro que não casa nada é erro de uso, exit 2) e `--full` desliga o recorte. O sub-agent despachado roda só o filtro dos próprios testes, uma vez (cláusula 3), e nunca o `verify`. A suíte **inteira** roda no Gate 3 e no CI, sem filtro — `verify {feature}` nunca recorta. A suíte completa de um projeto grande não cabe numa invocação de Bash do harness — rode em background ou por partes, nunca "suba o limite" (não há constante de timeout global no CLI). Detalhe e forma de `project.tests[]`: `.morph/framework/CLI.md`, seção "Suítes de teste". Quando invocada manualmente, verificar se há próxima task ready e iniciá-la imediatamente aplicando esta skill desde o passo 1 (auto-advance). Pause apenas se encontrar ambiguidade bloqueante não coberta pelo mandate.
+9. Quando invocada por `morph-apply`, retornar o controle à skill orquestradora — ela decide qual task vem em seguida via `getReadyTasks(data)`. Não rode a suíte de testes inteira do projeto por conta própria ao fim da task quando invocada pela `morph-apply` — a verificação determinística (`morph-spec verify {feature} {task}`) é do orquestrador, logo após seu retorno (ver morph-apply §3a). **`verify` com exit 3** (`status: "busy"`) é fila de slot pesado cheia, não vermelho: nada foi verificado e nada foi gravado — repita a mesma chamada em vez de abrir uma tentativa de correção. **Única exceção:** a execução de evidência do passo 5 — só o nó `evals`, filtrado, com `--skip-e2e`, nunca persistida (`--no-persist`); ela não é a verificação da task e não substitui a do orquestrador. **A divisão:** no loop por task o recorte é **automático** — o `group` da task escolhe as suítes e os arquivos de teste dos `outputs` (passo 8) estreitam o comando dentro de cada uma (o relógio de uma task não paga a suíte inteira); `--filter {ids}` só força a escolha de suítes (um nó não casado aparece como `skip` nomeando o filtro, e um filtro que não casa nada é erro de uso, exit 2) e `--full` desliga o recorte. O sub-agent despachado roda só o filtro dos próprios testes, uma vez (cláusula 3), e nunca o `verify`. A suíte **inteira** roda no Gate 3 e no CI, sem filtro — `verify {feature}` nunca recorta. A suíte completa de um projeto grande não cabe numa invocação de Bash do harness — rode em background ou por partes, nunca "suba o limite" (não há constante de timeout global no CLI). Detalhe e forma de `project.tests[]`: `.morph/framework/CLI.md`, seção "Suítes de teste". Quando invocada manualmente, verificar se há próxima task ready e iniciá-la imediatamente aplicando esta skill desde o passo 1 (auto-advance). Pause apenas se encontrar ambiguidade bloqueante não coberta pelo mandate.
 
 ## Output esperado
 - Código implementado conforme o standard consultado (direto ou via sub-agent)

package/framework/skills/core/morph-machine/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: morph-machine
+description: Cuida da RAM e da CPU da máquina enquanto o morph-spec trabalha — fila de builds e testes pesados (heavy), processos órfãos, worktrees de sub-agent que sobram. Invoque quando a máquina ou o editor estiver lento ou sem RAM, quando um comando voltar "⏳ não rodou" ou sair com exit 3 (fila cheia), quando sobrar agent-* em worktrees/, ou antes de despachar vários sub-agents que compilam ou testam em paralelo.
+version: core
+when-to-invoke: quando a máquina está lenta ou sem RAM, um comando pesado esperou ou foi recusado pela fila, sobrou worktree de sub-agent, ou vários sub-agents pesados vão rodar em paralelo
+user-invokable: false
+cliVersion: "8.43.0"
+---
+
+# morph-machine
+
+## Objetivo
+
+Manter a máquina do dev utilizável enquanto o trabalho paralelo do morph-spec roda. Você aplica isto sozinho quando o sintoma aparece; o usuário não precisa pedir.
+
+## Regras que não se negociam
+
+- **Nunca** `taskkill /IM`, `pkill`, `killall` nem `Stop-Process -Name`: derrubam os MCPs de todas as sessões abertas. O único que encerra processo é `doctor --procs --prune`, e por PID.
+- **Fila cheia não é erro de código.** `⏳ … não rodou`, `slots pesados ocupados` e exit 3 querem dizer "espere e repita o MESMO comando". Não entra no loop de correção, não conta como tentativa e não é vermelho no `verify`.
+- **Nunca remova worktree** por `git worktree remove`, `rm -rf` ou `Remove-Item -Recurse`: atravessa a junction e apaga o conteúdo real da raiz. Só `finish`, `worktree remove` ou `worktree reap`.
+- **Destrutivo pergunta antes.** `doctor --procs --prune` e `worktree reap` (sem `--dry-run`): mostre a lista e use `AskUserQuestion`.
+
+## Sintoma → comando
+
+| Sintoma | Comando | Como ler e o que fazer |
+|---|---|---|
+| Máquina ou editor lento, pouca RAM | `morph-spec doctor --procs` (só lê) | Cada linha diz órfão ou protegido, com a razão. Sem órfão, a pressão vem de fora (vmmem do WSL, IDE): diga isso e passe a sugestão de `.wslconfig` que o relatório traz. Com órfão, mostre a lista e ofereça `--prune`. |
+| Comando voltou `⏳ … não rodou` ou exit 3 | `morph-spec heavy status` | Mostra quem segura cada vaga, há quanto tempo, e a RAM livre. A vaga solta sozinha (processo morto ou timeout). Espere e repita. Se a causa for RAM e nenhuma vaga estiver presa, rode `doctor --procs`. |
+| Vão rodar vários sub-agents pesados em paralelo | `morph-spec heavy status` antes | São 2 vagas por padrão. O que não couber espera na fila sem falhar, mas cada espera custa turnos: despache só o que cabe. |
+| Build ou teste pesado avulso, fora do `verify` | `morph-spec heavy run -- <comando>` | Ou ligue o `heavy.gateBash` (abaixo) e o hook cuida disso. |
+| Sobrou `agent-*` em `worktrees/` ou branch `morph-task/agent-*` | `morph-spec worktree reap --dry-run`, depois `worktree reap` | Só remove o que parou, está limpo e não tem commit exclusivo; o resto volta com a razão (`dirty`, `locked`…). `doctor --worktrees` lista tudo, inclusive árvore fora do contêiner. |
+| A worktree precisa de arquivo fora do git (`.env`, segredos) | `.worktreeinclude` na raiz do repo | Um padrão por linha, sintaxe do gitignore. Copia só o que casa **e** é ignorado; nunca `node_modules`, build ou `.git`. O `setup` e o `provision` aplicam. |
+| Editor pesado por causa das worktrees | `worktree.root` em `.morph/config/config.json` | Põe as worktrees fora da árvore aberta (caminho absoluto fora do projeto). `init` e `update` já gravam as exclusões no `.vscode/settings.json`. |
+
+## Ligar o `heavy.gateBash`
+
+Por padrão só o `verify`, o `e2e up` e o `heavy run` passam pela fila. O `dotnet build`, `dotnet test` ou `npm test` cru de um sub-agent não passa. Com `"heavy": { "gateBash": true }` em `.morph/config/config.json` (depois `morph-spec update`), um hook toma a vaga antes desses comandos e a devolve depois; sem vaga no prazo, a chamada é recusada com a causa.
+
+Recomende (`AskUserQuestion`, com a opção recomendada primeiro) quando sub-agents rodam build ou teste cru em paralelo, quando há mais de uma sessão na máquina, ou quando já houve queda por RAM. **Nunca ligue sem perguntar:** o efeito é uma chamada recusada quando a fila enche.
+
+Limites: não cobre `run_in_background`, PowerShell nem comando fora da lista; uma chamada negada por regra ou interrompida segura a vaga até o timeout dela.
+
+## Referências
+
+- `.morph/framework/CLI.md` — seções `heavy`, `worktree reap`, `doctor --procs` e `worktree.root`.
+- `MORPH.md` §2.2 (worktrees) e a cláusula 6 dos templates de dispatch (PROCESSOS).

package/framework/skills/core/morph-media/SKILL.md

@@ -4,7 +4,7 @@ description: Conduz a AUTORIA de mídia gerada por IA — escolher o modelo pelo
 version: core
 when-to-invoke: quando a tarefa é PRODUZIR imagem ou vídeo por IA (catálogo, marketing, asset de LP) e alguém precisa decidir modelo, prompt e aprovação
 user-invokable: true
-cliVersion: "8.41.0"
+cliVersion: "8.43.0"
 stacks:
   - dotnet
   - nextjs

package/framework/skills/core/morph-plan/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a produção dos artefatos de planejamento de uma feature (use
 version: core
 when-to-invoke: ao iniciar a fase plan de uma feature, após o Gate 1 (proposal aprovado)
 user-invokable: true
-cliVersion: "8.41.0"
+cliVersion: "8.43.0"
 ---
 
 # morph-plan

package/framework/skills/core/morph-proposal/SKILL.md

@@ -4,7 +4,7 @@ description: Orquestra a fase de proposta+plano de uma feature morph-spec. Encad
 version: core
 when-to-invoke: ao receber instrução "use /morph-proposal" do usuário, ou ao iniciar uma nova feature
 user-invokable: true
-cliVersion: "8.41.0"
+cliVersion: "8.43.0"
 ---
 
 # morph-proposal

package/framework/skills/core/morph-review/SKILL.md

@@ -4,7 +4,7 @@ description: Conduz a fase de revisão e produz o review-report.md para o Gate 3
 version: core
 when-to-invoke: ao iniciar a fase review, após todas as tasks de tasks.json estarem com status `done`
 user-invokable: true
-cliVersion: "8.41.0"
+cliVersion: "8.43.0"
 ---
 
 # morph-review
@@ -63,7 +63,7 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
      rodada.
 
    **Despache o avaliador independente** — o score do Gate 3 nunca é auto-atribuído por quem implementou:
-   - Rode `morph-spec verify {feature} --json` (escopo feature) e capture o JSON — é a saída real de build+testes+validadores+e2e que você anexa ao prompt do avaliador independente (`morph-evaluator`). **Sem `--filter`, sempre:** o `--filter` é do loop por task, onde o relógio de uma task não paga a suíte inteira; a prova que o avaliador lê tem de cobrir **todos** os nós de `nodes.tests.runs[]` (uma suíte filtrada aparece como `skip` nomeando o filtro — Gate 3 aberto sobre isso é verde sobre código não testado). Se a suíte inteira não couber numa chamada, rode-a em background; não a encolha com `--filter`. `verify {feature}` (sem task) **nunca recorta** — o recorte automático é só do escopo de task —, e um `verify {feature} --filter …` nem persiste o stamp (`persisted: false`, `reason: 'filtered'`) — o mesmo vale para `--skip-tests`/`--skip-build` no escopo de feature. Rode-o **depois** da última task: o `gate-check {feature} review` pausa quando o último stamp `verification` é de escopo `task:{id}`, porque aquela rodada cobriu só a task. Uma rodada por árvore: se o JSON vier com `repeatOf`, nada mudou fora de `.morph/` desde o verify de feature anterior — use aquele resultado em vez de rodar de novo; depois de uma correção a árvore mudou, e a nova rodada é a prova.
+   - Rode `morph-spec verify {feature} --json` (escopo feature; exit 3 / `status: "busy"` é fila de slot pesado cheia, não vermelho: repita a chamada) e capture o JSON — é a saída real de build+testes+validadores+e2e que você anexa ao prompt do avaliador independente (`morph-evaluator`). **Sem `--filter`, sempre:** o `--filter` é do loop por task, onde o relógio de uma task não paga a suíte inteira; a prova que o avaliador lê tem de cobrir **todos** os nós de `nodes.tests.runs[]` (uma suíte filtrada aparece como `skip` nomeando o filtro — Gate 3 aberto sobre isso é verde sobre código não testado). Se a suíte inteira não couber numa chamada, rode-a em background; não a encolha com `--filter`. `verify {feature}` (sem task) **nunca recorta** — o recorte automático é só do escopo de task —, e um `verify {feature} --filter …` nem persiste o stamp (`persisted: false`, `reason: 'filtered'`) — o mesmo vale para `--skip-tests`/`--skip-build` no escopo de feature. Rode-o **depois** da última task: o `gate-check {feature} review` pausa quando o último stamp `verification` é de escopo `task:{id}`, porque aquela rodada cobriu só a task. Uma rodada por árvore: se o JSON vier com `repeatOf`, nada mudou fora de `.morph/` desde o verify de feature anterior — use aquele resultado em vez de rodar de novo; depois de uma correção a árvore mudou, e a nova rodada é a prova.
    - **Confira o nó `e2e` do verify antes de despachar.** Ele carrega o estado do stack:
      - `pass` → a aplicação subiu e está saudável; o avaliador pode navegá-la. **Passe a URL no prompt**
        — cada feature roda no seu bloco de portas, não em `localhost:3000`; pegue de
@@ -174,21 +174,48 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
          MUTAÇÃO — o método, e a ordem dele importa:
            - COMMITE O FIX ANTES DE MUTAR. Se a sessão morrer no meio, o
              que sobrevive é a mutação, não a correção.
-           - Ancore no CALL SITE que carrega a decisão, não no `if`
-             refatorado. Uma rodada POR CLÁUSULA de um predicado composto.
-           - Rode a suíte INTEIRA (sem filtro): só ela autoriza a frase
-             "derruba N de M". Filtro estreito é prova vácua.
+           - VOCÊ ESCOLHE os mutantes: ancore no CALL SITE que carrega a
+             decisão, não no `if` refatorado. Uma rodada POR CLÁUSULA de um
+             predicado composto — cada cláusula é um mutante próprio.
+           - ESCREVA `.morph/features/{feature}/4-review/mutants.json`:
+             {"mutants":[{"id":"M1","file":"src/x.cs","line":42,
+             "find":"a && b","replace":"a"}]}. `find` começa na `line` e é
+             único nela; arquivo:linha, diff e md5 saem da ferramenta.
+             Com a ferramenta Write, se você a tem; só com Bash, heredoc
+             de delimitador entre aspas simples. O transporte do Bash
+             reduz `\\` a `\` e decodifica escapes unicode, então escreva
+             cada barra invertida do código como `{{BS}}` (a ferramenta a
+             expande): atravessa qualquer transporte. `find` que deixa de
+             bater com o arquivo é recusado com o erro, nunca aplicado.
+           - RODE `morph-spec mutate {feature}` UMA vez, com o Bash. Ela
+             faz o lote inteiro: um build só (chaves por variável de
+             ambiente; o que a chave não compila cai para rebuild real),
+             subconjunto de testes primeiro — escolhido por ela, não por
+             você — e, para CADA sobrevivente, o mutante compilado de
+             verdade contra a suíte INTEIRA. Só esse caminho produz
+             "sobreviveu"; "derruba K de M" sempre diz o escopo do K
+             (≥K no subconjunto, K na suíte inteira); na suíte inteira a
+             falha tem de se repetir, senão é instabilidade e o mutante
+             sobrevive. Sem a ferramenta,
+             mute e rode a suíte INTEIRA à mão, um mutante por vez.
            - LEIA O MOTIVO da falha, não só o md5: md5 prova que ALGO
-             mudou, jamais O QUÊ.
-           - REVERTA por snapshot/restore de BYTES (cópia feita ANTES) +
-             `os.utime` para devolver o mtime, e confirme por md5. NUNCA
+             mudou, jamais O QUÊ. Falha de build não é morte, e
+             `inconclusive` não conta como nada.
+           - A REVERSÃO é da ferramenta: bytes do snapshot com md5
+             conferido, por escrita NOVA, rebuild forçado e a DLL final
+             igual (md5) à construída antes do 1º mutante. NUNCA `os.utime`
+             para devolver o mtime: o MSBuild acha o binário do último
+             mutante em dia e a rodada-base roda sobre ele. NUNCA
              `git checkout --`: ele descarta trabalho não commitado de
              outra pessoa — aconteceu de verdade num Gate 3 desta epic.
-           - TERMINE com `git status --porcelain src/` VAZIO. Mutação
-             esquecida em produção é o pior desfecho deste método.
-         Grave no relatório a seção `## Mutações`, uma linha por mutação,
-         com os CINCO campos: arquivo:linha | diff | md5 antes/depois |
-         quantos testes derrubou (sobre o total da suíte) | o MOTIVO
+             Rodada que morreu no meio: `morph-spec mutate --restore`.
+           - TERMINE com `git status --porcelain src/` VAZIO e exit 0. Exit
+             4 é inseguro (arquivo não restaurado, árvore ou binário
+             diferentes): resolva antes de pontuar.
+         Cole no relatório a seção `## Mutações` que a ferramenta imprime
+         (ela também a grava em `4-review/mutation-section.md`), uma linha
+         por mutação, com os CINCO campos: arquivo:linha | diff | md5
+         antes/depois | quantos testes derrubou (com o escopo) | o MOTIVO
          literal da falha. Feature sem código de produção declara a seção
          com a linha `não aplicável — feature sem código de produção`. A
          seção é OBRIGATÓRIA: sem ela o `morph-spec gate-check` PAUSA o
@@ -294,6 +321,7 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
      > diff antes). É a mesma proibição que o prompt do passo 4 já dá ao avaliador: aqui ela vale
      > para VOCÊ.
    - **Leia primeiro** `.morph/features/{feature}/4-review/evaluator-report.md` — é o valor de retorno autoritativo, não a mensagem de texto do dispatch (que é cortesia, útil só quando chega inteira). Os scores por dimensão e o composto do review-report vêm **desse arquivo**, não da sua auto-avaliação. Se o arquivo vier ausente, oco, ou sem os scores por dimensão, registre a falha de protocolo na seção de método do review-report e re-despache.
+   - Com o relatório lido, rode `morph-spec worktree reap --json`: a árvore do avaliador que parou limpa sai sozinha; a que ficou com trabalho vem listada com a razão.
    - **`PARCIAL` na 1ª linha = o avaliador parou antes do fim** (limite de turnos; o `report-check` devolve `evaluator.partial: true`). Não leia score dele — o parcial não tem `**Composite-Score:**`, e o `gate-check` pausaria de qualquer jeito — e não re-despache frio: um avaliador novo refaz a rodada inteira (probes, mutações, navegação). Retome o MESMO avaliador por `SendMessage`, como no passo 6, colando `tree.dirty` e `tree.commits` do `report-check` no recado; ele completa o relatório, e o final substitui o parcial. Só se o id não retomar, despache um novo pelo caminho normal — o parcial no disco é resíduo, não insumo, como o prompt já diz. Antes de qualquer das duas, a higiene da árvore acima continua valendo: um avaliador cortado no meio pode ter deixado mutação no disco.
 
 5. Produza `review-report.md` em `.morph/features/{feature}/4-review/` com:
@@ -318,9 +346,10 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
 
      | # | Arquivo:linha | Mutação (diff) | md5 antes | md5 depois | Testes derrubados | Motivo da falha |
      |---|---|---|---|---|---|---|
-     | M1 | src/lib/x.js:42 | `- if (a && b)` / `+ if (a)` | abc… | def… | 3 de 2684 | `expected 3 got 0` em x.test.js:88 |
+     | M1 | src/lib/x.js:42 | `- if (a && b)` / `+ if (a)` | abc… | def… | ≥3 de 212 (subconjunto) | `expected 3 got 0` em x.test.js:88 |
+     | M2 | src/lib/y.js:7 | `- return ok` / `+ return true` | 123… | 456… | 0 de 2684 (SOBREVIVEU, suíte inteira) | nenhum teste falhou na suíte inteira |
 
-     **Reversão:** snapshot/restore de bytes + `os.utime`; `git status --porcelain src/` vazio.
+     **Reversão:** snapshot/restore de bytes por escrita nova; DLL final igual (md5); `git status --porcelain src/` vazio.
      **Proof-Scores:** mutation=9 verde=8 fiacao=9 guard=7
      ```
 

package/framework/skills/core/morph-stack-scan/SKILL.md

@@ -4,7 +4,7 @@ description: Varre o codebase existente, detecta stack atual, compara com o stac
 version: core
 when-to-invoke: ao iniciar uma feature em projeto brownfield (codebase já existente)
 user-invokable: true
-cliVersion: "8.41.0"
+cliVersion: "8.43.0"
 ---
 
 # morph-stack-scan

package/framework/skills/core/morph-standards/SKILL.md

@@ -4,7 +4,7 @@ description: Localiza um standard específico via busca server-side (morph-spec
 version: core
 when-to-invoke: quando precisar consultar um standard específico durante a implementação
 user-invokable: true
-cliVersion: "8.41.0"
+cliVersion: "8.43.0"
 ---
 
 # morph-standards

package/framework/skills/core/morph-uiux/SKILL.md

@@ -4,7 +4,7 @@ description: Conduz a fase opcional de UI/UX — design system, mockups, compone
 version: core
 when-to-invoke: ao tomar o ramo uiux (morph-spec advance --design), depois do Gate 1 e antes do morph-plan
 user-invokable: true
-cliVersion: "8.41.0"
+cliVersion: "8.43.0"
 ---
 
 # morph-uiux

package/framework/standards/PROVENANCE.json

@@ -8,15 +8,15 @@
       "path": "skills/morph-lp-cinematic",
       "envVar": "MORPH_HUB",
       "defaultCheckout": "R:/Polymorphism Tech/repos/morph-HUB",
-      "sourceTree": "e43114d4b28ff55680a5355cce27d31ffa74f22f",
-      "sourceCommit": "465c9b0",
+      "sourceTree": "2987b44241cae479b1aedc63f689cdcd6ef6fb94",
+      "sourceCommit": "c4c9164",
       "distilledOn": "2026-08-21",
       "distilledFrom": [
         "references/build-stack.md",
         "references/component-recipes.md",
         "references/premium-finish.md",
         "references/seo-and-qa.md",
-        "references/gemini-image-prompt.md",
+        "references/image-prompt.md",
         "references/seedance-scrub-prompt.md",
         "references/seedance-loop-prompt.md"
       ],
@@ -25,7 +25,7 @@
         "references/copy-and-messaging.md",
         "references/section-blueprint.md"
       ],
-      "notDistilledReason": "Deliberate split: a standard carries knowledge, a skill carries process. Deploy and copy strategy stay with the skill. `references/gates.md` LEFT this list on 2026-09-09: the reason that kept it out was \"a skill carries process\", and the destination is now a skill — see the \"cinematic-lp\" source below, which distils it into morph-media.",
+      "notDistilledReason": "Deliberate split: a standard carries knowledge, a skill carries process. Deploy and copy strategy stay with the skill. `references/gates.md` LEFT this list on 2026-09-09: the reason that kept it out was \"a skill carries process\", and the destination is now a skill — see the \"cinematic-lp\" source below, which distils it into morph-media. Review of 2026-09-29 (source c4c9164): only tool-independent facts were ported (the scrub_frames manifest contract for frame-scrub, chained clips for ai-video-generation); the rest was already in the standards or stays with the skill (ffmpeg-to-media_tool swaps, model prices, SKILL.md, gates.md, assets/).",
       "standards": [
         "frontend-scroll-driven-frame-scrub",
         "frontend-scroll-driven-smooth-scroll",
@@ -65,8 +65,8 @@
       "path": "skills/cinematic-lp/references",
       "envVar": "MORPH_HUB",
       "defaultCheckout": "R:/Polymorphism Tech/repos/morph-HUB",
-      "sourceTree": "57a1734bc17651a6fed381a6e817c8b0c0a89edd",
-      "sourceCommit": "b6bbfff",
+      "sourceTree": "3c557425d649ed477bf6645b9297b6d1d72ae4a3",
+      "sourceCommit": "c4c9164",
       "distilledOn": "2026-09-09",
       "distilledFrom": [
         "gates.md"
@@ -85,7 +85,7 @@
         "video-loop-prompt.md",
         "video-scrub-prompt.md"
       ],
-      "notDistilledReason": "Only the HITL gate mechanics were distilled: the N-option picker, \"rejection goes back to the same step\", and \"show MOVEMENT, never a still\". The rest is either already a standard (the frame-scrub / smooth-scroll / premium-finish family, from the morph-lp-cinematic source above) or build/deploy strategy that belongs to the calling workflow.",
+      "notDistilledReason": "Only the HITL gate mechanics were distilled: the N-option picker, \"rejection goes back to the same step\", and \"show MOVEMENT, never a still\". The rest is either already a standard (the frame-scrub / smooth-scroll / premium-finish family, from the morph-lp-cinematic source above) or build/deploy strategy that belongs to the calling workflow. Review of 2026-09-29 (source c4c9164): gates.md did not change; the changes were in image-prompt.md and mcp-setup.md, both not distilled. Re-pinned only.",
       "standards": [],
       "skills": [
         "morph-media"
@@ -97,8 +97,8 @@
       "path": "skills/brand-design/references",
       "envVar": "MORPH_HUB",
       "defaultCheckout": "R:/Polymorphism Tech/repos/morph-HUB",
-      "sourceTree": "d8801b8c277f63b06e1a22f57563ec468e7d4d9a",
-      "sourceCommit": "b6bbfff",
+      "sourceTree": "7b637a08e931d8b7ba5be7fc75b851d89cd6e6f4",
+      "sourceCommit": "c4c9164",
       "distilledOn": "2026-09-09",
       "distilledFrom": [
         "image-generation.md"
@@ -109,7 +109,7 @@
         "example-identidade-visual.md",
         "phases.md"
       ],
-      "notDistilledReason": "Only the image-per-phase map and the \"concept, never the final vector\" rule were distilled. The narrative prompt recipes were NOT copied verbatim: they are bound to one brand pipeline, and morph-media carries the prompt STRUCTURE instead, which survives the model changing. Brand book, checklist and phases are the process of another skill.",
+      "notDistilledReason": "Only the image-per-phase map and the \"concept, never the final vector\" rule were distilled. The narrative prompt recipes were NOT copied verbatim: they are bound to one brand pipeline, and morph-media carries the prompt STRUCTURE instead, which survives the model changing. Brand book, checklist and phases are the process of another skill. Review of 2026-09-29 (source c4c9164): the image-per-phase table and the \"concept, never the final vector\" rule are unchanged (the text now says \"image model\" instead of Gemini); what was added is morph-assets call mechanics (project_set, @brand, outputPath, models, variants, dryRun), tool-bound and kept out on purpose. Re-pinned only.",
       "standards": [],
       "skills": [
         "morph-media"

package/framework/standards/STANDARDS.json

@@ -2848,7 +2848,7 @@
         "not-worth": "#o-que-não-merece",
         "size": "#tamanho"
       },
-      "digest": "Default is NO comment: code explains itself through names, types and tests. Before commenting, rename, extract a function or named constant, encode the state in the type, or write a test; comment only what none of these can express: an invariant the type does not express, an order that matters, an external quirk (third-party API, library bug with its link), or the contract of a package published for consumers outside the repo. Never process history (task, UC, ADR, FR, Gate, evaluator, spec.md, mockup: commit message and decisions.md), never restate the code, no XML doc/JSDoc on application members that repeats the signature, no file headers, section banners, #region, commented-out code or loose TODOs, no claims about behavior (make them test assertions). One line is normal, ~3 is the ceiling; more than one comment line per ten code lines means the names are not doing the work. The verify validators node (code-budget) warns on added comments that cite process and on added comment density.",
+      "digest": "Default is NO comment: code explains itself through names, types and tests. Before commenting, rename, extract a function or named constant, encode the state in the type, or write a test; comment only what none of these can express: an invariant the type does not express, an order that matters, an external quirk (third-party API, library bug with its link), or the contract of a package published for consumers outside the repo. Never process history (task, UC, ADR, FR, Gate, evaluator, spec.md, mockup: commit message and decisions.md; in a test the link to the postcondition goes in the test NAME), never restate the code, no XML doc/JSDoc on application members that repeats the signature, no file headers, section banners, #region, commented-out code or loose TODOs, no claims about behavior (make them test assertions). One line is normal, ~3 is the ceiling; more than one comment line per ten code lines means the names are not doing the work. A heavily commented neighbour file is not a model. The comment-guard hook blocks an edit that ADDS process history, a banner/#region, a block over 3 lines or a doc-comment outside a published package; the verify validators node (code-budget) warns on added comments that cite process and on added comment density.",
       "verifiedAgainst": "C#, TypeScript e JavaScript (convenção de linguagem, sem pacote externo).",
       "provedBy": []
     }

package/framework/standards/architecture/code-comments.md

@@ -43,7 +43,8 @@ Só o **porquê que o código não mostra**:
 
 - **História de processo.** Task, UC, ADR, FR, Gate, avaliador, `spec.md`, mockup, "confirmado ao
   implementar a T11", "o Gate 3 pediu". Isso vai na mensagem de commit e no `decisions.md`, onde tem
-  data e autor e não envelhece dentro do arquivo.
+  data e autor e não envelhece dentro do arquivo. Em teste, o elo com a pós-condição vai no **nome**
+  do teste (`P5_estado_do_lead_espelha_o_crm`, `DisplayName`), nunca em `// UC-672 P5`.
 - **Repetição do código.** `// incrementa o contador` sobre `count++`, `// valida o request` sobre
   `validator.Validate(request)`. Nome bom substitui comentário.
 - **Doc-comment que repete a assinatura.** `/// <summary>Obtém o pedido.</summary>` sobre
@@ -63,7 +64,8 @@ Só o **porquê que o código não mostra**:
 Uma linha é o normal; teto de ~3. Acima disso o comentário justifica o volume (algoritmo não
 óbvio, armadilha de terceiro com a reprodução). Bloco longo narrando decisões é `decisions.md` com
 outro nome. Em volume, código de aplicação fica perto de zero: mais de uma linha de comentário a
-cada dez de código é sinal de que os nomes não estão fazendo o trabalho.
+cada dez de código é sinal de que os nomes não estão fazendo o trabalho. Arquivo vizinho muito
+comentado não é modelo: código novo segue este padrão, não a densidade do legado.
 
 ## Exemplo
 
@@ -90,6 +92,11 @@ await upsert({ key: doc.sourceId, hash: sha256(doc.body) });
 
 ## Na revisão
 
+Na hora da edição, o hook `comment-guard` bloqueia o comentário **adicionado** que é história de
+processo, banner/`#region`, bloco de mais de 3 linhas ou `///`/JSDoc em projeto que não é pacote
+publicado. Comentário que o arquivo já tinha nunca é acusado. Repetir o código em uma linha não é
+detectável por forma: fica com a revisão abaixo.
+
 Comentário que o código dispensava é achado da rubrica `code-quality` no Gate 3. O nó `validators`
 do `morph-spec verify` mede, nas linhas que a feature adicionou (validador `code-budget`), quantas
 linhas de comentário citam processo e a densidade de comentário sobre o código adicionado, e avisa

package/framework/standards/frontend/design-system/ai-video-generation.md

@@ -55,6 +55,8 @@ Give a start image and an end image, and let the model interpolate a camera trav
 
 **Avoid for scrub:** full orbits and any movement that returns to its origin. They become loops and kill the sense of progress.
 
+**Long continuous sequence (hero → reveal → product).** Generate each next clip with `chainFrom: "<id of the previous clip>"` and its own `endImage`: the previous clip's real last frame becomes the start, so the seam matches (SSIM about 0.94 in the upstream skill's test). Join the clips with `media_tool { op: "concat" }` before `scrub_frames`. Source: the upstream `morph-lp-cinematic` skill; not re-measured here.
+
 ---
 
 ## Section 3: Faces Trip Moderation

package/framework/standards/frontend/scroll-driven/frame-scrub.md

@@ -41,6 +41,16 @@ ffmpeg -i source.mp4 -vf "fps=30,scale=1280:-1" -q:v 5 frames/frame_%03d.jpg
 | Numbering | `%03d` (frame_001) matches the 1-based `framePath` contract in Section 4. |
 | Format | JPG is the safe default (fast decode, universal). If the sequence gets heavy (tens of MB), also try WebP via `-c:v libwebp -q:v 70`, which usually cuts total weight at similar quality. |
 
+**Frames from `media_tool scrub_frames` (morph-assets) do not follow the table above.** The tool writes `v{N}/frame_0001.webp …` (4-digit, 1-based, WebP by default) and a `frames.json` manifest (`version`, `count`, `format`, `width`, `height`, `fps`, `pattern`, `totalBytes`). Build `frameCount` and `framePath` from the manifest; a `%03d`/`.jpg` path from this section will not resolve against them. A new `v{N}` folder per extraction changes the URL by construction, so it is the cache-bust of Section 3:
+
+```js
+import manifest from './hero-frames/frames.json'
+const frameCount = manifest.count
+const framePath = (i) => `/hero-frames/v${manifest.version}/frame_${String(i).padStart(4, '0')}.${manifest.format}`
+```
+
+Source: the upstream `morph-lp-cinematic` skill (build-stack reference); not re-measured here.
+
 **Treat total sequence weight as a performance budget.** It shows up directly in Lighthouse. If it is too heavy, cut frame count (120 instead of 145) or resolution before cutting quality.
 
 **Mirror the footage when the subject collides with the copy.** If the subject sits on the side where text goes, flip it during extraction:
@@ -57,7 +67,7 @@ ffmpeg -i source.mp4 -vf "hflip,fps=30,scale=1664:-1" -q:v 5 frames/frame_%03d.j
 
 Re-extracting frames (for example going from 480p to 1080p) while keeping the same filenames means the browser serves the stale ones and nothing appears to change.
 
-Always version the frame URL and bump `N` on every re-extraction:
+Always version the frame URL and bump `N` on every re-extraction (a `v{N}` folder per extraction, as `scrub_frames` writes, does it by construction):
 
 ```js
 const framePath = (i) => `/hero-frames/frame_${String(i).padStart(3, '0')}.jpg?v=2`

package/package.json

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

package/src/commands/e2e/e2e.js

@@ -42,9 +42,13 @@ import {
 import { isSecondaryWorktree } from '../../../framework/hooks/shared/git-paths.js';
 import { buildComposeEnv } from '../../lib/e2e/compose-env.js';
 import { findWorktreeForFeature, resolvePrimaryRoot } from '../project/worktree.js';
+import { createHeavyGate, HeavyBusyError } from '../../lib/heavy/gate.js';
+import { afterHeavyRun } from '../../lib/heavy/cleanup.js';
+import { readHeavyConfig } from '../../../framework/hooks/shared/heavy-config.js';
 
 /** Exit code for a usage error, matching `verify`'s convention. */
 const EXIT_USAGE = 2;
+const EXIT_BUSY = 3;
 
 // ============================================================================
 // Shared context
@@ -158,13 +162,27 @@ export async function e2eUpCommand(featureName, options = {}) {
     process.exit(EXIT_USAGE);
   }
 
-  const result = bringUpStack(ctx.cwd, {
-    composeFile: ctx.composeFile,
-    projectName: ctx.projectName,
-    gitCommonDir: ctx.gitCommonDir,
-    env: ctx.env,
-    forceFresh: Boolean(options.fresh),
-  });
+  const gate = createHeavyGate({ projectPath: ctx.cwd, label: 'e2e up', feature: featureName });
+  let result;
+  try {
+    gate.enter('e2e');
+    result = bringUpStack(ctx.cwd, {
+      composeFile: ctx.composeFile,
+      projectName: ctx.projectName,
+      gitCommonDir: ctx.gitCommonDir,
+      env: ctx.env,
+      forceFresh: Boolean(options.fresh),
+    });
+  } catch (err) {
+    if (!(err instanceof HeavyBusyError)) throw err;
+    if (options.json) {
+      console.log(JSON.stringify({ status: 'busy', feature: featureName, busy: { reason: err.reason, waitedMs: err.waitedMs } }, null, 2));
+    }
+    console.error(chalk.yellow(`\n⏳ e2e up não rodou: ${err.message}. Tente de novo quando liberar (\`morph-spec heavy status\`).\n`));
+    process.exit(EXIT_BUSY);
+  } finally {
+    gate.release();
+  }
 
   const auth =
     result.status === 'pass'
@@ -313,10 +331,11 @@ export async function e2eDownCommand(featureName, options = {}) {
     volumes: Boolean(options.volumes),
   });
   const stampDeleted = deleteStamp(ctx.gitCommonDir, ctx.projectName);
+  const cleanup = afterHeavyRun({ projectPath: ctx.cwd, config: readHeavyConfig(ctx.cwd), scope: 'e2e-down' });
 
   if (options.json) {
     console.log(JSON.stringify(
-      { feature: featureName, project: ctx.projectName, tree: ctx.tree, status: result.status, stampDeleted },
+      { feature: featureName, project: ctx.projectName, tree: ctx.tree, status: result.status, stampDeleted, cleanup },
       null, 2,
     ));
   } else if (result.status === 'pass') {

package/src/commands/mcp/mcp-setup.js

@@ -100,13 +100,14 @@ export async function mcpSetupCommand(name, options) {
     const integrations = await detectIntegrations(targetPath);
     const claudeConfig = await detectClaudeConfig(targetPath);
     const existingMcps = claudeConfig.mcpServers || [];
+    const enabledPlugins = claudeConfig.enabledPlugins || [];
 
     if (options.list) {
-      return showStatusList(targetPath, stack, existingMcps, integrations);
+      return showStatusList(targetPath, stack, existingMcps, integrations, enabledPlugins);
     }
 
     if (options.auto) {
-      return autoInstall(targetPath, stack, existingMcps, integrations);
+      return autoInstall(targetPath, stack, existingMcps, integrations, enabledPlugins);
     }
 
     if (name) {
@@ -114,7 +115,7 @@ export async function mcpSetupCommand(name, options) {
     }
 
     // Interactive wizard
-    return interactiveWizard(targetPath, stack, existingMcps, integrations);
+    return interactiveWizard(targetPath, stack, existingMcps, integrations, enabledPlugins);
   } catch (err) {
     console.error(chalk.red(`Error: ${err.message}`));
     process.exit(1);
@@ -124,8 +125,8 @@ export async function mcpSetupCommand(name, options) {
 /**
  * Show MCP status list (--list)
  */
-async function showStatusList(targetPath, stack, existingMcps, integrations) {
-  const orchestration = orchestrateMcpSetup(targetPath, stack, existingMcps, { integrations });
+async function showStatusList(targetPath, stack, existingMcps, integrations, enabledPlugins) {
+  const orchestration = orchestrateMcpSetup(targetPath, stack, existingMcps, { integrations, enabledPlugins });
   const statusRows = formatMcpStatusTable(orchestration, {});
 
   console.log(chalk.cyan('\n  MCP Server Status\n'));
@@ -158,8 +159,8 @@ async function showStatusList(targetPath, stack, existingMcps, integrations) {
 /**
  * Auto-install credential-free MCPs (--auto)
  */
-async function autoInstall(targetPath, stack, existingMcps, integrations) {
-  const orchestration = orchestrateMcpSetup(targetPath, stack, existingMcps, { autoOnly: true, integrations });
+async function autoInstall(targetPath, stack, existingMcps, integrations, enabledPlugins) {
+  const orchestration = orchestrateMcpSetup(targetPath, stack, existingMcps, { autoOnly: true, integrations, enabledPlugins });
   const autoNames = Object.keys(orchestration.autoInstallable);
 
   if (autoNames.length === 0) {
@@ -419,8 +420,8 @@ async function setupSpecificMcp(targetPath, name, stack, existingMcps) {
 /**
  * Interactive wizard showing all MCPs
  */
-async function interactiveWizard(targetPath, stack, existingMcps, integrations) {
-  const orchestration = orchestrateMcpSetup(targetPath, stack, existingMcps, { integrations });
+async function interactiveWizard(targetPath, stack, existingMcps, integrations, enabledPlugins) {
+  const orchestration = orchestrateMcpSetup(targetPath, stack, existingMcps, { integrations, enabledPlugins });
 
   console.log(chalk.cyan('\n  MCP Setup Wizard'));
   console.log(chalk.gray(`  Stack: ${stack}`));