@polymorphism-tech/morph-spec 9.7.0 → 10.0.0

package/framework/hooks/claude-code/statusline.sh

@@ -1,11 +0,0 @@
-#!/usr/bin/env bash
-# morph-spec statusline — installed globally to ~/.claude/statusline.sh
-# Claude Code invokes this with JSON via stdin after each response.
-# Requires: Python 3 available as `python3` or `python` on PATH.
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-if command -v python3 &>/dev/null; then
-  python3 "${SCRIPT_DIR}/statusline.py" 2>/dev/null || true
-elif command -v python &>/dev/null; then
-  python "${SCRIPT_DIR}/statusline.py" 2>/dev/null || true
-fi

package/framework/hooks/shared/agent-reap.js

@@ -1,74 +0,0 @@
-// O SessionStart tem 5 s: o disparo só olha o disco e solta um worker DESTACADO
-// com `cwd` no git common dir, que nunca segura o diretório de uma worktree.
-
-import { spawn } from 'child_process';
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'fs';
-import { join, resolve } from 'path';
-import { fileURLToPath } from 'url';
-import { isSecondaryWorktree, resolveGitCommonDir } from './git-paths.js';
-import { primaryTree } from './graph-freshness.js';
-import { runMorphSpec } from './morph-cli.js';
-
-const WORKER = fileURLToPath(import.meta.url);
-const THROTTLE_MS = 10 * 60_000;
-const WORKER_TIMEOUT_MS = 15 * 60_000;
-const ADMIN_DIR = /^agent-[0-9a-f]+\d*$/;
-const AGENT_BRANCH_FILE = /^agent-[0-9a-f]+$/;
-
-function anyEntry(dir, pattern) {
-  try { return readdirSync(dir).some((name) => pattern.test(name)); } catch { return false; }
-}
-
-export function hasAgentLeftovers(common) {
-  if (anyEntry(join(common, 'worktrees'), ADMIN_DIR)) return true;
-  if (anyEntry(join(common, 'refs', 'heads', 'morph-task'), AGENT_BRANCH_FILE)) return true;
-  try {
-    return /refs\/heads\/morph-task\/agent-[0-9a-f]+/.test(readFileSync(join(common, 'packed-refs'), 'utf8'));
-  } catch {
-    return false;
-  }
-}
-
-function recentlyKicked(marker, now) {
-  try {
-    const age = now - Number(readFileSync(marker, 'utf8'));
-    return age >= 0 && age < THROTTLE_MS;
-  } catch {
-    return false;
-  }
-}
-
-export function kickAgentReap(dir, { spawnFn = spawn, env = process.env, now = Date.now } = {}) {
-  if (env.MORPH_WORKTREE_REAP === '0') return { kicked: false, reason: 'disabled' };
-  const common = resolveGitCommonDir(dir);
-  const root = common && primaryTree(dir);
-  if (!root) return { kicked: false, reason: 'not-a-repo' };
-  if (isSecondaryWorktree(dir)) return { kicked: false, reason: 'secondary-worktree' };
-  if (!hasAgentLeftovers(common)) return { kicked: false, reason: 'nothing-to-reap' };
-
-  const marker = join(common, 'morph-spec', 'agent-reap.kick');
-  if (recentlyKicked(marker, now())) return { kicked: false, reason: 'throttled' };
-  try {
-    mkdirSync(join(common, 'morph-spec'), { recursive: true });
-    writeFileSync(marker, String(now()));
-    const child = spawnFn(process.execPath, [WORKER, '--run', root], {
-      cwd: common, env, detached: true, stdio: 'ignore', windowsHide: true,
-    });
-    child.on?.('error', () => {});
-    child.unref?.();
-    return { kicked: true, pid: child.pid };
-  } catch {
-    return { kicked: false, reason: 'spawn-failed' };
-  }
-}
-
-const isMain = (() => {
-  const argv1 = process.argv[1];
-  if (!argv1) return false;
-  const norm = (p) => (process.platform === 'win32' ? resolve(p).toLowerCase() : resolve(p));
-  return norm(argv1) === norm(WORKER);
-})();
-
-if (isMain && process.argv[2] === '--run' && process.argv[3] && existsSync(process.argv[3])) {
-  try { runMorphSpec(['worktree', 'reap', '--json'], { cwd: process.argv[3], timeoutMs: WORKER_TIMEOUT_MS }); } catch { /* fail-open */ }
-}

package/framework/hooks/shared/slice-progress.js

@@ -1,110 +0,0 @@
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
-
-/** `PARCIAL` on the report's first non-blank line, tolerating heading/bold/quote typography. */
-export const PARTIAL_MARKER = /^[\s#>*_]*PARCIAL\b/;
-
-/** `BLOQUEADO`: the slice waits on a decision only the human can make; re-dispatching it repeats the question. */
-export const BLOCKED_MARKER = /^[\s#>*_]*BLOQUEADO\b/;
-
-export function checksPath(featureDir) {
-  return join(featureDir, '2-plan', 'checks.json');
-}
-
-export function sliceReportPath(featureDir, sliceId) {
-  return join(featureDir, '3-implement', 'reports', `${sliceId}.md`);
-}
-
-export function sliceStatusFromReport(text) {
-  if (text == null) return 'pendente';
-  const first = String(text).split(/\r?\n/).find((l) => l.trim() !== '') ?? '';
-  if (BLOCKED_MARKER.test(first)) return 'bloqueado';
-  return PARTIAL_MARKER.test(first) ? 'parcial' : 'feito';
-}
-
-/** @returns {{ total, done, partial, blocked, pending, slices } | null} null when the checks text is unreadable */
-export function sliceProgressFrom(checksText, readReport) {
-  let slices;
-  try {
-    slices = JSON.parse(checksText ?? '').slices;
-  } catch {
-    return null;
-  }
-  if (!Array.isArray(slices)) return null;
-  const out = slices
-    .filter((s) => s && typeof s.id === 'string')
-    .map((s) => ({
-      id: s.id,
-      title: s.title ?? '',
-      depends: Array.isArray(s.depends) ? s.depends : [],
-      covers: Array.isArray(s.covers) ? s.covers : [],
-      status: sliceStatusFromReport(readReport(s.id)),
-    }));
-  const count = (status) => out.filter((s) => s.status === status).length;
-  return {
-    total: out.length,
-    done: count('feito'),
-    partial: count('parcial'),
-    blocked: count('bloqueado'),
-    pending: count('pendente'),
-    slices: out,
-  };
-}
-
-function readOrNull(path) {
-  try {
-    return existsSync(path) ? readFileSync(path, 'utf8') : null;
-  } catch {
-    return null;
-  }
-}
-
-export function sliceProgress(featureDir) {
-  return sliceProgressFrom(readOrNull(checksPath(featureDir)), (id) => readOrNull(sliceReportPath(featureDir, id)));
-}
-
-export function readySlices(progress) {
-  if (!progress) return [];
-  const done = new Set(progress.slices.filter((s) => s.status === 'feito').map((s) => s.id));
-  return progress.slices.filter((s) => s.status !== 'feito' && s.status !== 'bloqueado' && s.depends.every((d) => done.has(d)));
-}
-
-// Loose on purpose: a false "complete" costs a read, a false "incomplete"
-// re-dispatches finished work.
-export const REPORT_MARKERS = [
-  { id: 'files', re: /^\s*(?:[-*]\s*)?(?:\*\*|#+\s*)?arquivos\s*:?\**\s*:?/mi },
-];
-
-const MIN_PROSE_CHARS = 80;
-
-const scenarioRe = (id) => new RegExp(`(?<![\\w-])${id}(?![\\w-])`);
-
-/** Every scenario in `covers` must be named in the report. */
-export function inspectReport(path, { covers = [] } = {}) {
-  const missingAll = ['what', 'files', ...covers];
-  if (!existsSync(path)) return { exists: false, complete: false, missing: missingAll };
-  let body = '';
-  try {
-    body = readFileSync(path, 'utf8');
-  } catch {
-    return { exists: true, complete: false, missing: missingAll, unreadable: true };
-  }
-
-  const missing = REPORT_MARKERS.filter((m) => !m.re.test(body)).map((m) => m.id);
-  missing.push(...covers.filter((id) => !scenarioRe(id).test(body)));
-  const prose = body
-    .split('\n')
-    .filter((l) => !/^\s*(#|[-*]\s|\*\*)/.test(l))
-    .join(' ')
-    .replace(/\s+/g, ' ')
-    .trim();
-  if (prose.length < MIN_PROSE_CHARS) missing.unshift('what');
-
-  const firstLine = body.split('\n').find((l) => l.trim() !== '') ?? '';
-  const partial = PARTIAL_MARKER.test(firstLine);
-  if (partial) missing.push('partial');
-  const blocked = BLOCKED_MARKER.test(firstLine);
-  if (blocked) missing.push('blocked');
-
-  return { exists: true, complete: missing.length === 0, missing, partial, blocked };
-}

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

@@ -1,133 +0,0 @@
----
-name: morph-hotfix
-description: ADW cirúrgico de hotfix — resolve uma queda/bug crítico de produção com prioridade máxima em velocidade, com aprovação humana obrigatória antes do ship.
-version: core
-when_to_use: Use quando chegar "/morph-hotfix {feature}", quando a morph-plan rotear o pedido como workType hotfix, ou quando o usuário disser "produção caiu / hotfix / urgente" a respeito de um incidente
-user-invocable: true
-cliVersion: "9.7.0"
----
-
-# morph-hotfix
-
-## Objetivo
-
-Resolver uma queda ou bug crítico de produção o mais rápido possível — prioridade é velocidade, não elegância — mantendo aprovação humana obrigatória antes do ship. É o pipeline dimensionado por `workType: hotfix` (MORPH.md §2.1): scout → fix cirúrgico → aprovação humana → test loop → ship.
-
-## Quando invocar
-
-- Usuário roda `/morph-hotfix {feature}` diretamente.
-- `Skill(morph-plan)` roteia o pedido como `hotfix` e invoca esta skill.
-- Usuário diz "produção caiu", "hotfix", "urgente", "incident", "P0" — sinais que o detector determinístico de `morph-spec create --request` já reconhece.
-
-## Argumentos
-
-- `{feature-name}` — nome em kebab-case da feature. Se ausente, perguntar via `AskUserQuestion`.
-
-## Fluxo
-
-### 1. Nascimento da feature
-
-```
-morph-spec create {feature} --type hotfix --description "<o incidente: o que quebrou / sintoma>"
-```
-
-Carimba `name` (o slug) + `description` (obrigatória no nascimento — descreva o incidente) e o gate `plan` como `approvedBy: "policy:hotfix"`, e cria as pastas `2-plan/` e `3-implement/` num passo só — a feature já nasce em `implement` (fase derivada é gate-aware). Se a feature já existe, siga adiante sem recriar.
-
-### 2. Scout — mapa do território (obrigatório)
-
-Despache o scout com o sintoma reportado, antes de qualquer fix:
-
-```
-subagent_type: "morph-scout"
-```
-
-**Fallback** (se `morph-scout` não estiver registrado nos subagent types deste projeto): `general-purpose` com o campo `persona` do agente `scout` colado no prompt, **registrando o fallback no `reports/F1.md`**.
-
-Peça ao scout: localizar o root cause provável, os arquivos afetados e o blast radius (o que mais pode quebrar). Ele é read-only (Read/Glob/Grep/Bash somente-leitura) e o corpo da persona dele já carrega o contrato read-only: o contrato de dispatch dos implementadores — commit `wip`, orçamento de teste, escopo da fatia — não se aplica a quem não escreve. O prompt dele diz só o sintoma: ele não escreve nem reverte nada, e o mapa é a mensagem final (Observado/Inferido, no contrato de citação que a persona já carrega). Você grava o mapa.
-
-**Audite o mapa antes do brief.** Grave a resposta do scout em `.morph/features/{feature}/2-plan/scout-map.md` e rode `morph-spec scout-check .morph/features/{feature}/2-plan/scout-map.md --json`. Exit ≠ 0 → descarte o mapa e re-despache o scout **uma** vez com as `failures` no prompt (o mapa novo abre com o motivo); na segunda reprovação, faça você o grep do root cause e siga. Root cause e blast radius que entram no brief se conferem com grep próprio mesmo com o mapa aprovado: sob pressão de hotfix, citação inventada vira um segundo incidente.
-
-### 3. Plano curto (`2-plan/plan.md` → `checks.json`)
-
-Escreva o `plan.md` mínimo (~25 linhas) numa única escrita: o hotfix nasce com o gate `plan` carimbado, o `create` não escreve esqueleto e o arquivo congela assim que existe. Gramática completa: `morph-spec plan-check --help`.
-
-- `## Problema` — o sintoma em produção, o root cause que o scout localizou e o blast radius.
-- `## Cenários` — dois, sempre:
-  - **C1** — o sintoma ausente: dado o estado que quebrava, quando a ação que falhava, então o resultado certo. `prova: teste` (ou `e2e`) e `risco: regressão` — o teste do bug real, o único que o hotfix escreve; o `plan-check` recusa o plano sem ele.
-  - **C2** — o blast radius: o que o fix poderia quebrar continua funcionando. `prova: leitura` (o caminho tocado, citado por `arquivo:linha`) ou um teste existente que já o cobre — nunca um teste novo.
-- `## Decisões` com `### Conflitos com o acervo` (`nenhum` vale).
-- `## Fatias` — uma, `### F1 — fix`, com `persona:`, `arquivos:` e `cobre: C1, C2`.
-
-Rode `morph-spec plan-check {feature}` até zero erro: ele grava `2-plan/checks.json`, que o
-`report-check` e o Gate 3 leem. Não pule esta escrita mesmo sob pressão de tempo.
-
-### 4. Fix cirúrgico
-
-Implemente a mudança mínima — inline se estiver no domínio já carregado, ou despachando a persona de domínio via `subagent_type: "morph-{id}"` (a `morph-apply` §3 mostra o prompt: só os campos da fatia). Inline ou despachada, a fatia termina em `3-implement/reports/F1.md` com `**Arquivos:**` e `**Checks:**` (C1 e C2 com a evidência). Prioridade: tirar a falha do ar, não refatorar — melhorias de forma (não de correção) vão para o roadmap-fora-hotfix, não para este diff.
-
-### 5. Prova
-
-```
-morph-spec verify {feature} --json
-```
-
-Sem filtro: é a prova que o Gate 3 lê. Para iterar rápido antes, `--skip-tests`/`--skip-build` servem, mas não gravam o stamp `verification` (`reason: 'skip-tests'`/`'skip-build'`): o Gate 3 só lê uma execução completa. C1 se prova com o sintoma reproduzido antes e ausente depois; capture a saída real no `3-implement/reports/F1.md` — não descreva "testes passaram" sem colar a evidência.
-
-### 6. Gate 3 — SEMPRE humano
-
-O hotfix nasce com o Gate 3 em `forcedPauseGates` — o Gate 3 pausa **sempre**, mesmo em `trust: auto`. `gate-check` já sabe disso: lê `workType` do disco e `shouldPauseGate` força a pausa antes de checar qualquer outro sinal — rode direto, sem `--signals`:
-
-```
-morph-spec gate-check {feature} review [--json]
-```
-
-Escreva você mesmo `4-review/verifier.md` — o hotfix não despacha verificador nem revisor: `**Verdict:** SHIP|FIX`, `**Reviewed-SHA:** {git rev-parse HEAD}`, `## Checks` com C1 e C2 (`| Cn | PROVADO|NÃO PROVADO|FALHA | evidência |`, a evidência é a saída real do `verify` do passo 5), o diff do fix e `## Bloqueadores` (`Nenhum.` quando não há). Depois, **`AskUserQuestion` SEMPRE**:
-
-```
-question: "Gate 3 — Hotfix de {feature} pronto para ship?"
-header: "Gate 3"
-options:
-  - { label: "aprovado, ship", description: "Aceitar o fix e liberar para produção" }
-  - { label: "preciso ajustar", description: "Apontar correções antes de fechar" }
-  - { label: "rollback", description: "Desfazer o fix — voltar ao estado anterior" }
-```
-
-**NUNCA `morph-spec approve {feature} review --mode auto`** — o CLI recusa explicitamente essa combinação (gate `review` + `workType: hotfix` + aprovador `auto`) porque `forcedPauseGates` sobrepõe qualquer trust mode. Em contexto headless (sem `AskUserQuestion` disponível), **o `state-sync` NÃO cobre este caso**: ele é um hook `PostToolUse` com matcher `Write|Edit|AskUserQuestion`, e uma resposta em texto puro do usuário não é tool call — não gera evento e não grava gate nenhum. Esperar por ele deixa o Gate 3 por aprovar em silêncio. O caminho é registrar a aprovação humana explicitamente:
-
-```
-morph-spec approve {feature} review --approver "<nome de quem aprovou>"
-```
-
-`--approver` é a única assinatura que passa pelo backstop em headless — as outras rotas de `resolveApprovedBy` (`--mode auto`, e "sem TTY") resolvem para `"auto"` e são recusadas. Ela é **auto-declarada**: o CLI não consegue verificar que houve um humano, só recusa as assinaturas definitivamente não-humanas. Por isso: **nunca invente o nome** — use `--approver` só quando o humano de fato aprovou, senão o backstop do hotfix vira teatro.
-
-### 7. Pós-gate (o "test loop → ship" de `MORPH.md` §2.1)
-
-- Se o código mudou depois do verify do passo 5 (ajuste pedido no Gate 3), rode `morph-spec verify {feature}` de novo.
-- Feche com `morph-spec finish {feature} --pr|--merge` — o mesmo encerramento único das demais features (arquiva commitando dentro de `morph/{f}`, desmonta). Num hotfix urgente o `--merge` (local, direto na default, integra na hora) costuma ser o caminho; use `--pr` quando o fix precisa passar por CI/review antes do merge — mas `--pr` **não integra**: sai com `finished: true` e `integrated: false`, `awaiting: "merge"`. Um hotfix "fechado" por `--pr` ainda não chegou na produção — não relate o incidente como resolvido até o merge. Ver `MORPH.md` §2.2.
-- Não integre automaticamente — o usuário decide quando e por qual modo (`finish` toca a default ou o remoto). Feature legada sem `morph/{f}`: `finish` roteia para `morph-spec archive {feature}`.
-
-## Anti-padrões
-
-- Não pular o scout — mesmo sob pressão, o mapa de blast radius evita um segundo incidente causado pelo próprio fix.
-- Não auto-aprovar o Gate 3 — nunca tente `morph-spec approve {feature} review --mode auto` num hotfix; o backstop server-side existe exatamente para isso.
-- Não "fazer do jeito certo" às custas da velocidade — refatoração, cobertura extra, ou hardening que não bloqueia o sintoma atual vira item no roadmap-fora-hotfix, não neste diff.
-- Não rodar suíte ad-hoc fora do `morph-spec verify` — a cadeia determinística é a única fonte de evidência aceita no `verifier.md`.
-
-## Output esperado
-
-- `.morph/features/{feature}/2-plan/plan.md` + `checks.json` — C1 sintoma ausente, C2 regressão, F1 fix
-- `.morph/features/{feature}/3-implement/reports/F1.md` — o relatório da fatia, com a evidência real de teste
-- `.morph/features/{feature}/4-review/verifier.md` — escrito pelo orquestrador: C1/C2 com evidência + diff, Gate 3 sempre humano
-- Gate `plan` carimbado `approvedBy: "policy:hotfix"`; Gate 3 registrado em `feature.json` (autoritativo) com uma **assinatura humana** — `"manual"` pelo `state-sync` (resposta ao `AskUserQuestion`), o nome passado em `--approver`, ou `$USER` num terminal interativo. **Nunca `"auto"`** — é o que o backstop recusa.
-
-## Referências
-
-- `.morph/framework/MORPH.md` §2.1 — roteamento por tipo de trabalho
-- `.morph/framework/MORPH.md` §5 — Gates de aprovação, gate humano forçado no hotfix
-- `.morph/framework/MORPH.md` §6 — Sub-agents, persona de estágio scout, protocolo obrigatório
-- `.claude/skills/morph-plan/SKILL.md` — roteamento que invoca esta skill
-- `.claude/skills/morph-apply/SKILL.md` §3/§5 — prompt de dispatch e retomada por `report-check`
-- `morph-spec create {feature} --type hotfix --json` — mostra a política do tipo (`scaffold`, `skippedGates`, `forcedPauseGates`) como o CLI a aplicou
-- `morph-spec create {feature} --type hotfix` — nascimento com política de gates
-- `morph-spec verify {feature} --json` — cadeia determinística build+testes+validadores
-- `morph-spec gate-check {feature} review [--json]` — persiste a decisão de pausa (forçada por `workType: hotfix`) antes do Gate 3

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

@@ -1,46 +0,0 @@
----
-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_use: Use quando a máquina estiver 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-invocable: false
-cliVersion: "9.7.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 que a fila já esperou o prazo dela (`heavy.waitTimeoutSec`). Não entra no loop de correção, não conta como tentativa e não é vermelho no `verify`. No máximo uma chamada nova; persistiu, siga sem aquela rodada e avise o usuário — nunca `sleep`/`until` nem retentativa agendada.
-- **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). Vaga presa por sessão viva: diga ao usuário quem a segura. 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` — `### heavy`, `### worktree reap`, `### doctor --procs` e `### worktree.root`.
-- `MORPH.md` §2.2 (worktrees) e a cláusula PROCESSOS do contrato de dispatch.

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

@@ -1,129 +0,0 @@
----
-name: morph-review
-description: Conduz o Gate 3 — despacha verificador ∥ revisor (∥ segurança, quando exigida) em contexto fresco sobre um SHA fixo e decide pelo gate-check
-version: core
-when_to_use: Use quando a fase review começar, com todas as fatias com relatório final e o verify da feature verde
-user-invocable: true
-cliVersion: "9.7.0"
----
-
-# morph-review
-
-## Objetivo
-Responder, com evidência: **cada cenário do plano está provado, sem quebrar o que já funcionava?**
-Três agentes independentes, cada um com o seu relatório em `4-review/`: `verifier.md` (prova cada
-`Cn`), `reviewer.md` (escopo, arquitetura, regressão) e `security.md` (só com caminho sensível). O
-Gate 3 decide por `**Verdict:** SHIP|FIX`, bloqueadores tipados e a cobertura dos `Cn` — não por
-nota. Você não escreve relatório de review: os três arquivos são o retorno.
-
-## Ritmo
-- Comando em **primeiro plano**, com timeout. Só o `verify {feature}` de projeto grande passa do teto
-  de 10 min do Bash: aí `run_in_background` e espere a notificação. Nunca `sleep`/`until`.
-- **Bloqueio de ambiente não é laço.** Slot pesado ocupado (exit 3 / `busy`), Docker fora: tente
-  **uma** vez mais; persistiu, siga — o `gate-check` pausa com a razão. Nunca agende retentativas.
-
-## 1. Relatórios já íntegros?
-`morph-spec report-check {feature} --json` (sem fatia) — também em sessão retomada: retomar não
-reseta este passo. Leia `reviews.verifier|reviewer|security`: `complete` → **não re-despache** esse
-papel; `partial: true` → passo 4 (PARCIAL); ausente → despache no passo 3.
-
-## 2. Prova da suíte — uma rodada
-Commite o trabalho da feature (`git add <paths>` + `git commit`) e rode
-`morph-spec verify {feature} --ci --json` com `run_in_background`. Ele empurra a branch, espera o run
-e grava o stamp do artefato que o run publicou; sem CI, roda local e diz por quê.
-**Sem `--filter`, sempre**: o Gate 3 roda a suíte inteira. Esta é a única execução de testes do Gate 3 — nenhum agente
-roda a suíte de novo. `repeatOf` no JSON = nada mudou, use aquela rodada; `reason: "stamp-reused"` = nada
-fora de `.morph/` andou desde o último verify verde (local ou CI): ele vale e o CI não roda de novo.
-- **Quando a saída mostrar `CI rodando`, despache (passo 3) sem esperar o fim**: o push e o
-  workflow já estão commitados e a foto da árvore não os acusa. Saiu `verify local`: espere o fim
-  antes do passo 3 — suíte local e `mutate` disputam a máquina. Exit 2 = trabalho fora de commit.
-- Nó `e2e`: `pass` local → `morph-spec e2e status {feature} --json` → `baseUrl` vai ao verificador.
-  `fail` → correção (CI: `gh run view <id> --log-failed`). `skip` → quem classifica é o `gate-check`
-  (`classifyE2eSkip`): dispensa de projeto e `not applicable` (feature sem UI/spec/container no diff e sem
-  `prova: e2e`) passam; ambiente, `--skip-e2e` ou razão desconhecida pausam.
-- `traceability.warnings` do verify vão ao revisor como sinal.
-
-## 3. Dispatch — verificador ∥ revisor (∥ segurança)
-`morph-spec report-check {feature} --before-eval --json` tira a foto da árvore e diz quem despachar:
-`reviewModels.verifier.model` (opus com prompt/modelo ou mídia), `reviewModels.security.required`.
-Anote `base` (merge-base com a default) e `sha` (`git rev-parse HEAD`). Blast radius: para cada
-símbolo público do diff, `morph-spec graph affected <símbolo> --prod --json`; sem grafo
-(`no-graph`/`not-found`/`ambiguous`), siga sem o blast radius — o revisor cai para `git grep` — e
-registre a ausência no recado a ele. Cada agente nasce com contexto fresco e **nunca recebe relatório anterior** (ancoragem).
-`chore` tem review leve: só o revisor (∥ segurança, quando exigida) — sem verificador, sem cobertura de
-`Cn`, sem mutação. Despache todos na mesma resposta, **sem nome no dispatch**: com nome, o `agent_type` que o hook
-`test-budget` lê vira o nome, e o guard de review não reconhece o papel.
-```
-dispatch Agent (subagent_type: "morph-verifier", model: {reviewModels.verifier.model}) with prompt:
-  feature, base, sha, JSON do verify (nós, e2e, URL) se já terminou, 1-design/mockups.md e
-  3-implement/evidencias/*.md se existirem. Grave .morph/features/{feature}/4-review/verifier.md.
-  Não rode `morph-spec mutate` até eu avisar que revisor e segurança terminaram.
-  NUNCA `git checkout --`: descarta trabalho não commitado.
-dispatch Agent (subagent_type: "morph-reviewer") with prompt:
-  feature, base, sha, blast radius (ou a ausência dele), traceability.warnings.
-  Grave .morph/features/{feature}/4-review/reviewer.md.
-dispatch Agent (subagent_type: "morph-security") with prompt:      ← só com security.required
-  feature, base, sha, reviewModels.security.reasons. Grave .morph/features/{feature}/4-review/security.md.
-```
-O prompt leva só os campos acima. O que você notou no loop chega ao revisor como
-`traceability.warnings` ou como item da `## Errata` do plano, nunca como lista solta de "fatos do
-loop": é histórico da conversa (MORPH §6) e ancora quem nasceu para olhar sem ele.
-O contrato fixo (o que provar, `**Reviewed-SHA:**` obrigatório, formato, PARCIAL, read-only) mora no
-corpo de cada persona e em `.morph/framework/evals/review-checklist.md`. Tipo não registrado:
-`general-purpose` com o campo `persona` de `.morph/framework/agents.json` no topo do prompt.
-
-Revisor e segurança voltaram: diga ao verificador, por `SendMessage`, que a mutação está liberada —
-opcional, no máximo 3 mutantes com `expect`, só para guarda sem teste que a morda (review-checklist).
-Achou o teste por leitura: não rode.
-
-## 4. Ao retomar — higiene antes de ler o veredito
-Não rode build nem teste enquanto um agente está `running`. Com todos de volta,
-`morph-spec report-check {feature} --json`:
-- `tree.sinceBeforeEval.changed` vazio e `tree.markers` vazio = árvore como antes do dispatch.
-  Arquivo listado = mutação que ficou no disco: `morph-spec mutate --restore` devolve os bytes do
-  snapshot; fora de uma rodada de mutação, desfaça linha a linha pelo diff.
-  **NUNCA `git checkout -- src/` aqui**: o checkout apaga junto tudo o que não foi commitado depois
-  da prova (correção de bloqueador, trabalho de outra sessão).
-- `tree.sinceBeforeEval` `null` = sem foto; `tree` `null` = git não respondeu.
-
-Depois leia os relatórios e rode `morph-spec worktree reap --json`.
-
-**PARCIAL** (`reviews.<papel>.partial: true`): não leia veredito dele e não re-despache frio —
-retome o MESMO agente por `SendMessage`, colando `tree.dirty` e `tree.commits`. Só se o id não
-retomar, despache um novo.
-
-## 5. Bloqueadores
-O avaliador também erra: **antes de editar, reverifique cada bloqueador no código** — evidência que
-não se reproduz vira pergunta ao mesmo agente, não correção. Confirmado: corrija (loop da
-`morph-apply`), commite, rode `verify {feature}` local (o stamp verde dele é a prova: um `--ci` depois
-reusa, não roda de novo) e uma foto `--before-eval` nova.
-Retome por `SendMessage` TODO agente exigido, com o `sha` novo e `tree.dirty`/`tree.commits`: quem
-abriu bloqueadores **confirme só os bloqueadores** (retomando o MESMO agente que os abriu); os outros
-julgam só o delta `{sha anterior}..{sha novo}` — o que a correção abriu. `reviewModels.security.required`
-virou `true` agora: despache a segurança. Ninguém reavalia a feature inteira, e **nota nunca motiva
-nova rodada**. Agente encerrado: despache um novo dizendo que é uma confirmação — o relatório é
-append-only e vale o último `**Verdict:**`. Cada relatório carrega o `**Reviewed-SHA:**` —
-obrigatório: o `approve` recusa quando o código andou depois de QUALQUER um deles.
-
-## 6. Gate 3
-`morph-spec gate-check {feature} review [--json]` lê os relatórios exigidos, a cobertura dos `Cn` e
-os demais sinais do disco. Violação das verificações mecânicas entra por
-`--signals '{"standardsViolations":[...]}'`. Forçar a passagem apesar de uma pausa:
-`morph-spec gate-decision {feature} review --pause false --reason "..."`. Nunca edite `feature.json`.
-
-**`pause === true`** → `AskUserQuestion`:
-```
-question: "Gate 3 — Review de {feature} aprovado?{ reason ? ' Sinal: ' + reason : '' }"
-header: "Gate 3"
-options:
-  - { label: "aprovado, fechar feature", description: "Próximo passo: morph-spec finish --pr|--merge (morph-apply §8)" }
-  - { label: "preciso ajustar", description: "Apontar correções antes de fechar" }
-  - { label: "rollback", description: "Voltar para implement" }
-```
-**`pause === false`** → resumo de 3 linhas (vereditos, cenários provados, bloqueadores: 0) e
-`morph-spec approve {feature} review --mode auto`. A pergunta nomeia a feature: é por ela que o hook
-`state-sync` grava a aprovação. Fechar é da `morph-apply` §8.
-
-## Referências
-- `.morph/framework/evals/review-checklist.md` — o que cada papel procura e o formato dos relatórios
-- `morph-spec verify|mutate|report-check|gate-check` — `.morph/framework/CLI.md`

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

@@ -1,52 +0,0 @@
----
-name: morph-standards
-description: Localiza um standard específico via busca server-side (morph-spec standards --find) e carrega só a seção necessária (--show id#âncora)
-version: core
-when_to_use: Use quando precisar consultar um standard específico durante a implementação
-user-invocable: true
-cliVersion: "9.7.0"
----
-
-# morph-standards
-
-## Objetivo
-Achar o standard certo para a fatia e pôr no contexto só o trecho que ela precisa. Nunca abra o
-`STANDARDS.json` inteiro.
-
-## Quando invocar
-Durante a implementação, quando surgir dúvida de padrão (arquitetura, contrato, qualidade, teste)
-que o `plan.md` e os standards da fatia não resolvem.
-
-## O que fazer
-
-1. **Digest.** Busque no servidor:
-   ```
-   morph-spec standards --find "<domínio/tecnologia da fatia>" [--category <cat>] [--tags <a,b>] [--json]
-   ```
-   Devolve o top 3 com `id`, `path`, `digest` e as chaves de âncora. O digest é um resumo, não o
-   texto do standard: serve para decidir se o standard se aplica e muitas vezes basta para aplicá-lo.
-
-2. **Seção.** O digest não bastou → leia só a seção que importa:
-   ```
-   morph-spec standards --show <id>#<âncora>
-   ```
-   A âncora é uma das chaves que o `--find` listou, ou o slug de qualquer heading do `.md`.
-   `morph-spec standards --show <id>` mostra o digest e a tabela de âncoras.
-
-3. **Arquivo inteiro** (campo `path`, sob `.morph/framework/standards/`) só quando a fatia toca o
-   standard todo ou precisa de um exemplo que nenhuma seção isolada traz.
-
-4. Dois standards em conflito → adote o mais específico ao stack do projeto.
-
-5. Registre no `**Standards:**` do relatório da fatia (`3-implement/reports/F{n}.md`) qual standard (e qual âncora) aplicou e, havendo, o conflito.
-
-## Sem query clara
-`morph-spec standards` sem flag lista categorias e contagens; use para escolher o `--category` de
-um `--find` em seguida.
-
-## Quando nenhum standard cobre o caso
-Registre no relatório da fatia o critério adotado. Não invente standard: padrão não documentado é dívida.
-
-## Referências
-- `.morph/framework/CLI.md` — seção `standards` (flags, `--json`, falhas)
-- `.morph/framework/MORPH.md` — §4 (Como consultar Standards)