@polymorphism-tech/morph-spec 10.6.0 → 10.7.1

package/README.md

@@ -3,7 +3,7 @@
 > Spec-driven development framework for multi-stack projects. Turns feature requests into implementation-ready code through structured, AI-orchestrated phases.
 
 **Package:** `@polymorphism-tech/morph-spec`
-**Version:** 10.6.0  
+**Version:** 10.7.1  
 **Requires:** Node.js 22+, Claude Code
 
 ---
@@ -376,4 +376,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v10.6.0 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v10.7.1 by [Polymorphism Tech](https://polymorphism.tech)*

package/bin/morph-spec.js

@@ -580,4 +580,15 @@ program
   .option('--json', 'Output the aggregate as JSON')
   .action((feature, options) => costCommand(feature, options));
 
+// The page follows every command that moves the feature; 'exit' also covers their process.exit().
+const VIEW_COMMANDS = new Set(['plan-check', 'gate-check', 'gate-decision', 'approve', 'unapprove', 'advance', 'verify', 'report-check']);
+program.hook('preAction', async (_, action) => {
+  const [feature] = action.args;
+  if (!VIEW_COMMANDS.has(action.name()) || !/^[a-z0-9][\w-]*$/i.test(feature ?? '')) return;
+  const { refreshesFeatureView } = await import('../src/lib/verify/detached.js');
+  if (!refreshesFeatureView()) return;
+  const { refreshFeatureView } = await import('../src/lib/view/feature-view.js');
+  process.on('exit', () => refreshFeatureView(process.cwd(), feature));
+});
+
 await program.parseAsync();

package/claude-plugin.json

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

package/docs/CHEATSHEET.md

@@ -174,4 +174,4 @@ Never edited directly — go through CLI commands or `morph-spec update` instead
 
 ---
 
-*morph-spec v10.6.0 by Polymorphism Tech*
+*morph-spec v10.7.1 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -89,4 +89,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v10.6.0 by Polymorphism Tech*
+*morph-spec v10.7.1 by Polymorphism Tech*

package/framework/docs/CLI.md

@@ -149,7 +149,7 @@ Flags: `--push` publica a default logo depois do merge (sai com `publish.pushed:
 
 ### archive
 
-**`morph-spec archive <feature>`** — arquiva-**sem-integrar** (atômico, git-aware, commita o move escopado por pathspec): reservado a features legadas (sem branch `morph/{f}`) e faxina. O fechamento normal (arquiva **e** integra num passo) é `morph-spec finish`. É o que `/morph-archive` chama. O arquivo guarda só `feature.json`, `2-plan/plan.md` e o recap (`recap.html` + `recap.json`, gerados antes da poda, enquanto os relatórios do Gate 3 ainda existem): o plano sobrevive até a um squash merge, e `feature.json.archivedFrom.sha` é o topo da branch antes da poda (`git show <sha>:.morph/features/<f>/3-implement/report.md`; num squash, o `(#N)` do commit leva ao PR e a `git fetch origin pull/N/head`).
+**`morph-spec archive <feature>`** — arquiva-**sem-integrar** (atômico, git-aware, commita o move escopado por pathspec): reservado a features legadas (sem branch `morph/{f}`) e faxina. O fechamento normal (arquiva **e** integra num passo) é `morph-spec finish`. É o que `/morph-archive` chama. O arquivo guarda só `feature.json`, `2-plan/plan.md` e a página da feature com o recap dentro (`feature.html` + `recap.json`, gerados antes da poda, enquanto os relatórios do Gate 3 ainda existem): o plano sobrevive até a um squash merge, e `feature.json.archivedFrom.sha` é o topo da branch antes da poda (`git show <sha>:.morph/features/<f>/3-implement/report.md`; num squash, o `(#N)` do commit leva ao PR e a `git fetch origin pull/N/head`).
 
 ### recap
 
@@ -530,7 +530,7 @@ A auditoria devolve **nada** sem tentar coisa alguma em três situações: nenhu
 
 ### plan-check
 
-**`morph-spec plan-check <feature> [--json]`** — lê `2-plan/plan.md` com o parser único (o `morph-spec create` já escreve o esqueleto; a gramática completa sai em `morph-spec plan-check --help`) e, sem erro, grava `2-plan/checks.json` — o único escritor dele (o `protect-spec-files` recusa Write/Edit à mão) — e `2-plan/plan.html`, a visão só leitura que o gate do plano abre no navegador: cenários com prova/risco/degrau, padrões assumidos numerados e, com `## Estados` (opcional, `- origem → destino: gatilho` por linha), a máquina de estados desenhada. **Erros** (exit 1, nada gravado): seção obrigatória ausente (`Problema`, `Cenários`, `Decisões` com `### Conflitos com o acervo` não vazio — "nenhum" vale); `## Errata` fora do fim; `## Cenários` sem cenário; cenário sem `prova:` ou fora de `teste|e2e|eval|manual|leitura`; `prova: teste` sem `risco:` conhecido; `risco:` com `prova: leitura`; cenário com vocabulário de artefato sem `> Por que artefato:` logo abaixo; id `C`/`ADR` duplicado; `bug`/`hotfix` sem cenário de regressão provado por `teste` ou `e2e`; plano que fala em mídia gerada por IA sem citar `ai-agents-modalities-image-gen`, `ai-agents-media-video` ou `ai-agents-media-pipeline` nem declarar a linha `Mídia gerada: não` (sem a citação, as provas de mídia do Gate 3 ficariam desligadas em silêncio); veredito de reuso fora de `REUSAR|ESTENDER|CRIAR`; `## Estados` vazia ou com linha que não é transição. **Avisos:** `CRIAR` sem `why`, ADR sem `**Alcance:** feature|projeto`, `## Fatias` que sobrou da 9.x (não é lida). Com o gate `plan` aprovado e o corpo mudado fora da `## Errata`, recusa (`frozen`, exit 1) — o `planHash` ignora a errata; mudança de escopo é `unapprove <f> plan`, `plan-check` e o gate de novo. Plano extraído antes das regras de `risco:` e de mídia não passa a falhar por elas. Exit 2: `plan.md` ausente. Fora da árvore dona da feature, recusa nomeando-a. Com o plano válido, acrescenta ao `config.json` a stack que os arquivos mostram e instala em `.claude/rules/` a regra de stack que falta (uma linha por regra, em stderr; `rulesAdded` no `--json`).
+**`morph-spec plan-check <feature> [--json]`** — lê `2-plan/plan.md` com o parser único (o `morph-spec create` já escreve o esqueleto; a gramática completa sai em `morph-spec plan-check --help`) e, sem erro, grava `2-plan/checks.json` — o único escritor dele (o `protect-spec-files` recusa Write/Edit à mão) — e abre a vida de `feature.html`, a página única da feature (um arquivo só, na raiz dela): o que precisa de decisão, cenários, decisões ligadas aos cenários que citam, gráficos de prova, risco e reuso e, com `## Fluxo` e `## Estados` (opcionais, `- origem → destino: gatilho` por linha), os diagramas. Todo `plan-check`, `gate-check`, `gate-decision`, `approve`, `unapprove`, `advance`, `verify` e `report-check` reescreve o mesmo arquivo a partir do disco ao sair, sem custo de token; o `archive` a congela com o recap dentro. **Erros** (exit 1, nada gravado): seção obrigatória ausente (`Problema`, `Cenários`, `Decisões` com `### Conflitos com o acervo` não vazio — "nenhum" vale); `## Errata` fora do fim; `## Cenários` sem cenário; cenário sem `prova:` ou fora de `teste|e2e|eval|manual|leitura`; `prova: teste` sem `risco:` conhecido; `risco:` com `prova: leitura`; cenário com vocabulário de artefato sem `> Por que artefato:` logo abaixo; id `C`/`ADR` duplicado; `bug`/`hotfix` sem cenário de regressão provado por `teste` ou `e2e`; plano que fala em mídia gerada por IA sem citar `ai-agents-modalities-image-gen`, `ai-agents-media-video` ou `ai-agents-media-pipeline` nem declarar a linha `Mídia gerada: não` (sem a citação, as provas de mídia do Gate 3 ficariam desligadas em silêncio); veredito de reuso fora de `REUSAR|ESTENDER|CRIAR`; `## Estados` vazia ou com linha que não é transição. **Avisos:** `CRIAR` sem `why`, ADR sem `**Alcance:** feature|projeto`, `## Fatias` que sobrou da 9.x (não é lida). Com o gate `plan` aprovado e o corpo mudado fora da `## Errata`, recusa (`frozen`, exit 1) — o `planHash` ignora a errata; mudança de escopo é `unapprove <f> plan`, `plan-check` e o gate de novo. Plano extraído antes das regras de `risco:` e de mídia não passa a falhar por elas. Exit 2: `plan.md` ausente. Fora da árvore dona da feature, recusa nomeando-a. Com o plano válido, acrescenta ao `config.json` a stack que os arquivos mostram e instala em `.claude/rules/` a regra de stack que falta (uma linha por regra, em stderr; `rulesAdded` no `--json`).
 
 ### stack-set
 

package/framework/hooks/shared/phase-utils.js

@@ -13,7 +13,6 @@ export const OUTPUT_PHASE_MAP = {
   plan: 'plan',
   checks: 'plan',
   planCritique: 'plan',
-  planView: 'plan',
   uiMockups: 'uiux',
   implementReport: 'implement',
   evidencias: 'implement',
@@ -26,7 +25,6 @@ export const FILENAME_TO_OUTPUT = {
   'plan.md': 'plan',
   'checks.json': 'checks',
   'critica.md': 'planCritique',
-  'plan.html': 'planView',
   'mockups.md': 'uiMockups',
   'report.md': 'implementReport',
   'verifier.md': 'verifierReport',

package/framework/hooks/statusline.js

@@ -110,7 +110,9 @@ function readUserSettings(env = process.env) {
 }
 
 function git(args, cwd) {
-  return execFileSync('git', args, { cwd, stdio: ['ignore', 'pipe', 'ignore'], timeout: 3000, windowsHide: true }).toString('utf8').trim();
+  // --no-optional-locks: status/diff don't write the index, so they never take .git/index.lock
+  // nor leave it stale when the 3s timeout kills git on a large repo
+  return execFileSync('git', ['--no-optional-locks', ...args], { cwd, stdio: ['ignore', 'pipe', 'ignore'], timeout: 3000, windowsHide: true }).toString('utf8').trim();
 }
 
 // `-uno`: porcelain v2 lists untracked entries by default, which would change what the file count means.

package/framework/rules/plan-grammar.md

@@ -41,7 +41,11 @@ Todo valor de baixo risco que você decidiu sem perguntar (limite, intervalo, re
 
 ## Estados (opcional)
 
-Só quando a feature tem algo que muda de estado (pedido, aprovação, assinatura): uma transição por linha, `- origem → destino: gatilho` (`->` também vale). O `plan-check` desenha a máquina no `2-plan/plan.html`; linha que não é transição, ou seção vazia, é erro. Sem estado, não escreva a seção.
+Só quando a feature tem algo que muda de estado (pedido, aprovação, assinatura): uma transição por linha, `- origem → destino: gatilho` (`->` também vale). A página da feature desenha a máquina; linha que não é transição, ou seção vazia, é erro. Sem estado, não escreva a seção.
+
+## Fluxo (opcional)
+
+O caminho de um pedido ou dado pelo sistema, na mesma forma e com as mesmas recusas de `## Estados`: `- origem → destino: o que passa`. A página desenha o diagrama.
 
 ## Reuso
 
@@ -49,7 +53,7 @@ Só quando a feature tem algo que muda de estado (pedido, aprovação, assinatur
 
 ## Decisões
 
-`### ADR-001 — título` por decisão não trivial (alternativa descartada, motivo, quem decidiu) com `**Alcance:** feature` ou `projeto`. Greenfield: decisão que fixa stack, layout, infraestrutura ou test runner é `projeto`. `### Conflitos com o acervo` sempre (`nenhum` vale). Proibição além das do standard `architecture-stack-baseline` é ADR.
+`### ADR-001 — título` por decisão não trivial (alternativa descartada, motivo, quem decidiu) com `**Alcance:** feature` ou `projeto`, citando os `Cn` que sustenta: a citação vira link na página da feature. Greenfield: decisão que fixa stack, layout, infraestrutura ou test runner é `projeto`. `### Conflitos com o acervo` sempre (`nenhum` vale). Proibição além das do standard `architecture-stack-baseline` é ADR.
 
 ## O que o plan-check recusa
 

package/framework/skills/core/create-umbraco-lp/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a criação de uma landing page nova ponta-a-ponta a partir do
 version: core
 when_to_use: Use quando for iniciar um novo projeto de LP com o template Umbraco genérico
 user-invocable: true
-cliVersion: "10.6.0"
+cliVersion: "10.7.1"
 stacks:
   - umbraco
 ---

package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md

@@ -4,7 +4,7 @@ description: Migra uma landing page existente (React/Vite, Next.js estático ou
 version: core
 when_to_use: Use quando o usuário pedir "use /migrate-lp-to-umbraco {projeto}" ou descrever a necessidade de migrar uma LP para Umbraco
 user-invocable: true
-cliVersion: "10.6.0"
+cliVersion: "10.7.1"
 stacks:
   - umbraco
 ---

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

@@ -4,7 +4,7 @@ description: Implementa o plano aprovado de uma feature morph-spec inteiro nesta
 version: core
 when_to_use: Use com o gate do plano aprovado ("/morph-apply {feature}", "implementar feature"), em "/morph-review {feature}" (entra no §5), em "/morph-hotfix {feature}" ou incidente de produção (references/hotfix.md), ou quando `morph-spec next` mandar implement, verify, fix, review ou finish
 user-invocable: true
-cliVersion: "10.6.0"
+cliVersion: "10.7.1"
 ---
 
 # morph-apply
@@ -58,7 +58,7 @@ Verify verde: siga `references/review.md` — foto `--before-eval`, verificador
 
 ## 6. Fechar
 
-`morph-spec context refresh` (regera o inventário em `.morph/context/README.md`; `design-system.md` você atualiza só se mudou token) e commite o que faltar (relatórios do review): o `finish` exige árvore limpa. Modo: `finish.mode` do config do projeto, padrão `pr`, sem perguntar: `morph-spec finish {feature} --pr|--merge`. `--pr` não integra: a feature fica `aguardando-merge` até o merge. Stamp com `pendingPr`: `--pr` em `run_in_background`, porque ele espera os checks da PR; `pr-checks-fail` ou `pr-checks-no-verdict` desfaz o archive e reabre o Gate 3: siga o `hint`. O `finish` arquiva o `feature.json`, o `plan.md` e o recap; o report e a review ficam no histórico do git. Encerrado, aponte o recap ao usuário (`.morph/archive/{feature}/recap.html`, abra no navegador; `morph-spec recap {feature} --piper` narra com o Piper local).
+`morph-spec context refresh` (regera o inventário em `.morph/context/README.md`; `design-system.md` você atualiza só se mudou token) e commite o que faltar (relatórios do review): o `finish` exige árvore limpa. Modo: `finish.mode` do config do projeto, padrão `pr`, sem perguntar: `morph-spec finish {feature} --pr|--merge`. `--pr` não integra: a feature fica `aguardando-merge` até o merge. Stamp com `pendingPr`: `--pr` em `run_in_background`, porque ele espera os checks da PR; `pr-checks-fail` ou `pr-checks-no-verdict` desfaz o archive e reabre o Gate 3: siga o `hint`. O `finish` arquiva o `feature.json`, o `plan.md` e o recap; o report e a review ficam no histórico do git. Encerrado, aponte o recap ao usuário (`.morph/archive/{feature}/feature.html#recap`, abra no navegador; `morph-spec recap {feature} --piper` narra com o Piper local).
 
 ## Arquivo de teste
 

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

@@ -4,7 +4,7 @@ description: Leva um pedido ou o link de uma issue ao plano aprovado — roteia
 version: core
 when_to_use: Use quando uma feature, bug ou chore começar ("/morph-plan {feature}", "/morph-plan <link da issue>", "vamos planejar X"), ou ao retomar uma feature cujo gate plan ainda não foi aprovado
 user-invocable: true
-cliVersion: "10.6.0"
+cliVersion: "10.7.1"
 ---
 
 # morph-plan
@@ -54,9 +54,10 @@ O `create` escreveu o esqueleto; a gramática completa chega pela rule `plan-gra
 - **`## Cenários` é a definição de pronto.** Cada `Cn` é um comportamento observável que o verificador do Gate 3 vai **executar** contra a app — escreva-o como um fluxo de usuário ou uma regra que dá para disparar. `prova:` `teste` (com `risco:`) | `e2e` | `eval` | `manual` | `leitura`. Sem risco, `leitura`.
 - **`degrau:`** quando o `Cn` não se desfaz com revert: `migrar` (toda migration, aditiva ou não: drop, rename, backfill, coluna nova) ou `irreversível` (apaga dado que alguém lê, quebra contrato externo). Sem a linha, `refazer`. Esses dois degraus pausam o gate do plano para o usuário, e o Gate 3 pausa em migration sem degrau, em arquivo de contrato (`openapi`, `.proto`) sem `irreversível`, e no bloqueador `irreversivel` do revisor.
 - **`## Padrões assumidos`**: todo valor de baixo risco que você decidiu sem perguntar, numerado `1.`…`N.`, com o valor. É o que tira a pergunta trivial da entrevista: o usuário veta por número. Auth, credencial, permissão, pagamento e apagar dado nunca entram: são pergunta.
-- **`## Estados`** (opcional): algo muda de estado (pedido, aprovação) → `- origem → destino: gatilho`, uma por linha; o `plan-check` desenha a máquina no `2-plan/plan.html`.
+- **`## Estados`** (opcional): algo muda de estado (pedido, aprovação) → `- origem → destino: gatilho`, uma por linha; a página da feature desenha a máquina.
+- **`## Fluxo`** (opcional): o caminho de um pedido ou dado pelo sistema, na mesma forma; vira o desenho que o usuário olha em vez de ler `## Arquitetura`. Escreva-o sempre que houver mais de duas peças conversando.
 - **`## Reuso`**: `REUSAR` | `ESTENDER` | `CRIAR`; `CRIAR` exige `why` (a consulta que respondeu "não existe").
-- **`## Decisões`**: ADR por decisão não trivial, `**Alcance:** feature|projeto`; `### Conflitos com o acervo` sempre. Serviço novo de dados ou plataforma (cache, fila, vetor, busca, grafo, banco de documento, arquivo, gateway de LLM): o ADR diz por que o Postgres e o Neon do projeto não cobrem (`morph-spec standards --show architecture-stack-baseline#postgres-primeiro`).
+- **`## Decisões`**: ADR por decisão não trivial, `**Alcance:** feature|projeto`, citando os `Cn` que sustenta ("Sustenta C1, C4"): a citação vira o link e a matriz decisão × cenário da página; `### Conflitos com o acervo` sempre. Serviço novo de dados ou plataforma (cache, fila, vetor, busca, grafo, banco de documento, arquivo, gateway de LLM): o ADR diz por que o Postgres e o Neon do projeto não cobrem (`morph-spec standards --show architecture-stack-baseline#postgres-primeiro`).
 - **`## Arquitetura`**: onde entra, o que conversa com o quê, edge cases técnicos. Gera imagem ou vídeo por IA → cite aqui o standard (`ai-agents-modalities-image-gen`, `ai-agents-media-video`, `ai-agents-media-pipeline`): é a citação que arma as provas de mídia do Gate 3, e o `plan-check` recusa o plano que fala em mídia gerada sem ela (falso positivo: a linha `Mídia gerada: não`).
 
 **Contrato de implementação**: o que quem implementa precisa e o código não diz.
@@ -77,7 +78,7 @@ Antes do gate, em `feature` e `bug`: a crítica em contexto fresco de `reference
 `morph-spec gate-check {feature} plan [--json]`. Entrevista que zerou a árvore já é a aprovação do usuário: não repause, salvo a pausa de `signal: "rung"`, que vence e pergunta nomeando cada `Cn` e o seu degrau. Encerrada antes, com nós em `## Fora de escopo`: `morph-spec gate-decision {feature} plan --pause true --reason "entrevista encerrada com nós abertos" --signals '{"discoveryMode":"interview"}'`, e a pergunta do gate lista esses nós.
 
 - `resolver === "session"` (`plan-check` com erro, crítica ausente ou de outra versão) → corrija o plano ou despache a crítica, e rode `plan-check` e `gate-check` de novo, sem perguntar.
-- `resolver === "human"` → abra `2-plan/plan.html` no navegador do usuário (`start`/`open`/`xdg-open`; o `plan-check` o gera), o entendimento (problema, fora de escopo, cenários, riscos) e `AskUserQuestion`, header "Gate plano": `"Gate do plano — Plano de {feature} aprovado?"` com `"aprovado, prosseguir" | "preciso ajustar" | "cancelar feature"`; a pergunta lista `## Padrões assumidos` para veto por número; só a decisão sensível que você tomou sozinho vira pergunta antes, na forma de `references/interview.md` (`## Forma da pergunta`). Headless: `morph-spec approve {feature} plan --approver <quem>`.
+- `resolver === "human"` → abra `feature.html`, na raiz da feature, no navegador do usuário (`start`/`open`/`xdg-open`; a CLI a mantém, nunca escreva HTML de plano à mão; o usuário pode colar a resposta que ela monta), o entendimento (problema, fora de escopo, cenários, riscos) e `AskUserQuestion`, header "Gate plano": `"Gate do plano — Plano de {feature} aprovado?"` com `"aprovado, prosseguir" | "preciso ajustar" | "cancelar feature"`; a pergunta lista `## Padrões assumidos` para veto por número; só a decisão sensível que você tomou sozinho vira pergunta antes, na forma de `references/interview.md` (`## Forma da pergunta`). Headless: `morph-spec approve {feature} plan --approver <quem>`.
 - `pause === false` → uma linha e `morph-spec advance {feature}` (ou `--design`).
 
 Aprovado: "Plano aprovado.", com `## Padrões assumidos` numerado, e siga direto com `Skill(morph-apply)`, sem esperar resposta. Veto, a qualquer momento: `## Errata` com "Padrão N vetado: <valor novo>"; a implementação segue a errata. Rodou `stack-set` nesta sessão: pare em "Plano aprovado. Rode `/morph-apply {feature}` numa sessão nova", porque as rules de domínio só carregam no início de uma sessão.

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

@@ -4,14 +4,14 @@ description: Conduz a fase de UI/UX de uma feature com plano aprovado — render
 version: core
 when_to_use: Use quando o ramo de design for tomado (morph-spec advance {feature} --design), antes de /morph-apply
 user-invocable: true
-cliVersion: "10.6.0"
+cliVersion: "10.7.1"
 ---
 
 # morph-uiux
 
 Entra depois do gate do plano, quando a feature cria ou altera UI. Sai com `1-design/` aprovado; próximo passo `/morph-apply {feature}`. Você desenha nesta sessão — o que decidir aqui é o que vai implementar depois.
 
-A régua de sistema e de estética chega sozinha: a rule `ui-design` carrega quando você abre um arquivo de `1-design/` ou de UI. Carregue `frontend-design:frontend-design` se a sessão a tiver.
+A régua de sistema e de estética chega sozinha: a rule `ui-design` carrega quando você abre um arquivo de `1-design/` ou de UI. Antes do primeiro HTML, carregue `frontend-design:frontend-design` e, para gráfico ou indicador, `dataviz`, se a sessão os tiver. As telas aparecem sozinhas na página da feature (`feature.html`), com link e print.
 
 ## 1. Insumos
 

package/framework/templates/docs/plan.md

@@ -24,8 +24,8 @@ Resultado buscado: <o estado depois: o que muda, para quem, como se percebe.>
 
 1. <padrão e o valor escolhido>
 
-<!-- Opcional, só se algo muda de estado: uma seção "Estados" (h2) com uma transição por linha,
-     "- origem → destino: gatilho". O plan-check desenha a máquina em 2-plan/plan.html. -->
+<!-- Opcionais, viram desenho em feature.html: "Fluxo" (h2), o caminho pelo sistema, e "Estados" (h2), se algo muda de
+     estado. Uma transição por linha: "- origem → destino: gatilho". -->
 
 ## Cenários
 
@@ -43,7 +43,7 @@ Resultado buscado: <o estado depois: o que muda, para quem, como se percebe.>
 ### ADR-001 — <título>
 **Alcance:** feature
 
-<Contexto, decisão e consequência. `projeto` quando a decisão vale além desta feature.>
+<Contexto, decisão e consequência, citando os Cn que ela sustenta. `projeto` quando a decisão vale além desta feature.>
 
 ### Conflitos com o acervo
 

package/package.json

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

package/src/commands/state/recap.js

@@ -3,17 +3,18 @@ import { existsSync, readFileSync, writeFileSync } from 'fs';
 import { tmpdir } from 'os';
 import { join } from 'path';
 import { buildRecap, changeSummary, recapScenes, renderRecapHtml } from '../../lib/recap/recap.js';
+import { writeFeatureView } from '../../lib/view/feature-view.js';
+import { FEATURE_VIEW_FILE } from '../../core/paths/output-schema.js';
 import { narrateWithPiper, resolvePiper } from '../../lib/recap/piper.js';
 
-export const RECAP_FILES = { html: 'recap.html', data: 'recap.json' };
+export const RECAP_FILES = { html: FEATURE_VIEW_FILE, data: 'recap.json' };
 
-/** Writes `recap.html` + `recap.json` into `targetDir` from the live feature folder. Never throws. */
+/** Writes `recap.json` and the page with the recap inside into `targetDir`, from the live feature folder. Never throws. */
 export function writeRecap(featureDir, targetDir, feature, { cwd }) {
   try {
     const data = buildRecap(featureDir, feature, { changes: changeSummary(cwd) });
     writeFileSync(join(targetDir, RECAP_FILES.data), JSON.stringify(data, null, 2));
-    writeFileSync(join(targetDir, RECAP_FILES.html), renderRecapHtml(data));
-    return { ok: true, path: join(targetDir, RECAP_FILES.html) };
+    return writeFeatureView(targetDir, feature, { changes: data.changes, archived: true });
   } catch (err) {
     return { ok: false, reason: err.message };
   }
@@ -56,7 +57,7 @@ export function recapCommand(feature, options = {}) {
       note = piper.ok ? 'o piper falhou numa cena — ficou a voz do sistema' : piper.reason;
     }
   }
-  if (narration === 'sistema') writeFileSync(path, renderRecapHtml(data));
+  if (narration === 'sistema') writeFeatureView(dir, feature, { changes: data.changes ?? null, archived: dir === archived });
 
   if (options.json) {
     console.log(JSON.stringify({ ok: true, path, narration, note }));

package/src/commands/validation/plan-check.js

@@ -1,11 +1,10 @@
 import chalk from 'chalk';
-import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 import { atomicWriteJson } from '../../core/state/state-manager.js';
 import { isGateApproved } from '../../../framework/hooks/shared/state-reader.js';
-import { getAbsoluteOutputPath } from '../../core/paths/output-schema.js';
+import { FEATURE_VIEW_FILE, getAbsoluteOutputPath } from '../../core/paths/output-schema.js';
 import { parsePlan } from '../../lib/plan/plan-parser.js';
-import { renderPlanHtml } from '../../lib/plan/plan-html.js';
 import { buildChecks, planHash, planRuleOptions, validatePlan } from '../../lib/plan/checks.js';
 import { revocationWarnings } from '../../lib/specs/adr-index.js';
 import { assertOwnerTree, ownerTreeRefusalLines } from '../../lib/worktree/feature-truth.js';
@@ -39,9 +38,7 @@ export function runPlanCheck(featureName, cwd = process.cwd()) {
   }
 
   atomicWriteJson(checksPath, buildChecks(featureName, text, plan));
-  const viewPath = getAbsoluteOutputPath(cwd, featureName, 'planView');
-  writeFileSync(viewPath, renderPlanHtml(featureName, plan, { planHash: hash }));
-  return { ...result, ok: true, exit: 0, written: true, viewPath };
+  return { ...result, ok: true, exit: 0, written: true, viewPath: join(cwd, '.morph', 'features', featureName, FEATURE_VIEW_FILE) };
 }
 
 export function planCheckCommand(featureName, options = {}) {
@@ -82,7 +79,7 @@ export function planCheckCommand(featureName, options = {}) {
     console.log(chalk.red(`✗ plan-check: ${result.errors.length} erro(s) em ${result.plan} — checks.json não foi gravado`));
   } else {
     console.log(chalk.green(`✓ plan-check: ${join('2-plan', 'checks.json')} gravado (${result.planHash.slice(0, 12)})`));
-    console.log(chalk.gray(`  visão do plano: ${result.viewPath}`));
+    console.log(chalk.gray(`  página da feature: ${result.viewPath}`));
     reportDotnetIgnores(gitignoreAdded);
   }
   process.exit(result.exit);

package/src/core/paths/output-schema.js

@@ -1,10 +1,12 @@
 import { join } from 'path';
 
+/** The one page of a feature, at its root: it belongs to no phase, and only the CLI writes it. */
+export const FEATURE_VIEW_FILE = 'feature.html';
+
 export const OUTPUT_SCHEMA = {
   plan:           { filename: 'plan.md',               phaseDir: '2-plan',      phase: 'plan',      protected: true,  approvalGate: 'plan' },
   checks:         { filename: 'checks.json',           phaseDir: '2-plan',      phase: 'plan',      protected: true,  approvalGate: 'plan' },
   planCritique:   { filename: 'critica.md',            phaseDir: '2-plan',      phase: 'plan',      protected: false },
-  planView:       { filename: 'plan.html',             phaseDir: '2-plan',      phase: 'plan',      protected: false },
 
   uiMockups:      { filename: 'mockups.md',            phaseDir: '1-design',    phase: 'uiux',      protected: true,  approvalGate: 'uiux' },
 

package/src/lib/plan/checks.js

@@ -40,11 +40,11 @@ function defaultsWarnings(plan, at) {
 }
 
 // Optional: absent is fine; present, every line is a transition the plan view can draw.
-function statesErrors(plan, at) {
-  if (!plan.present.states) return [];
-  const { transitions, invalid } = plan.states;
-  const errors = invalid.map((l) => `## ${SECTIONS.states}: "${l.raw}" não é transição — use "- origem → destino: gatilho"${at(l.line)}`);
-  if (transitions.length === 0 && invalid.length === 0) errors.push(`## ${SECTIONS.states} vazia — liste as transições ou apague a seção`);
+function transitionErrors(plan, key, at) {
+  if (!plan.present[key]) return [];
+  const { transitions, invalid } = plan[key === 'flow' ? 'flow' : 'states'];
+  const errors = invalid.map((l) => `## ${SECTIONS[key]}: "${l.raw}" não é transição — use "- origem → destino: gatilho"${at(l.line)}`);
+  if (transitions.length === 0 && invalid.length === 0) errors.push(`## ${SECTIONS[key]} vazia — liste as transições ou apague a seção`);
   return errors;
 }
 
@@ -120,7 +120,7 @@ export function validatePlan(plan, { workType = null, riskRules = true, text = n
   }
 
   errors.push(...defaultsErrors(plan, { workType, riskRules }, at));
-  errors.push(...statesErrors(plan, at));
+  errors.push(...transitionErrors(plan, 'states', at), ...transitionErrors(plan, 'flow', at));
   warnings.push(...defaultsWarnings(plan, at));
 
   const isSlices = (s) => /^fatias$/i.test(s.name.trim());

package/src/lib/plan/plan-parser.js

@@ -14,6 +14,7 @@ export const SECTIONS = {
   assumptions: 'Suposições não confirmadas',
   defaults: 'Padrões assumidos',
   states: 'Estados',
+  flow: 'Fluxo',
   scenarios: 'Cenários',
   decisions: 'Decisões',
   architecture: 'Arquitetura',
@@ -191,6 +192,8 @@ export function parsePlan(text) {
     reuseHeader: reuse.header,
     defaults: parseDefaults(body('defaults')),
     states: parseStates(body('states')),
+    flow: parseStates(body('flow')),
+    text: Object.fromEntries(Object.keys(SECTIONS).map((k) => [k, body(k).map((l) => l.raw).join('\n').trim()])),
     errata: errata ? errata.lines.map((l) => l.raw).join('\n').trim() : null,
     sectionsAfterErrata: errata ? sections.filter((s) => s.line > errata.line).map((s) => s.name) : [],
   };

package/src/lib/recap/recap.js

@@ -2,7 +2,7 @@ import { execFileSync } from 'child_process';
 import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 import { parsePlan } from '../plan/plan-parser.js';
-import { stateMachineSvg } from '../plan/plan-html.js';
+import { stateMachineSvg } from '../view/flow-svg.js';
 import { reviewReportsFromDir } from '../review-reports.js';
 import { loadGraph, getFreshness } from '../graph/graph-loader.js';
 import { parseDiff, buildDiffTree, declarationDrift } from '../graph/diff-tree.js';
@@ -19,7 +19,7 @@ const git = (cwd, ...args) => execFileSync('git', args, { cwd, stdio: 'pipe', ma
  * What changed on the branch: the call tree when the graph is of HEAD and its lines hold, else the
  * plain file and line counts. Never throws; outside git it is null.
  */
-export function changeSummary(cwd, { base = null } = {}) {
+export function changeSummary(cwd, { base = null, statOnly = false } = {}) {
   let from = base;
   try {
     from ??= git(cwd, 'merge-base', detectDefaultBranch(cwd) || 'main', 'HEAD').trim();
@@ -33,6 +33,7 @@ export function changeSummary(cwd, { base = null } = {}) {
   } catch {
     return null;
   }
+  if (statOnly) return { stat, tree: null };
   const loaded = loadGraph(cwd);
   if (!loaded.ok || getFreshness(cwd, loaded.graph).state !== 'fresh') return { stat, tree: null };
   try {
@@ -88,7 +89,7 @@ export function recapScenes(r) {
     id: 'abertura',
     title: r.feature,
     narration: `${r.feature}. ${r.description ?? ''} ${r.days !== null ? `Do início ao fim, ${r.days === 0 ? 'menos de um dia' : `${r.days} dia${r.days > 1 ? 's' : ''}`}.` : ''}`.replace(/\s+/g, ' ').trim(),
-    body: `<p class="lead">${esc(r.description ?? '')}</p>${r.days !== null ? `<p class="big">${r.days === 0 ? '< 1' : r.days} <span>dia${r.days === 1 ? '' : 's'}</span></p>` : ''}`,
+    body: `<p class="lead">${esc(r.description ?? '')}</p>${r.days !== null ? `<p class="big">${r.days === 0 ? '< 1' : r.days} <span>dia${r.days <= 1 ? '' : 's'}</span></p>` : ''}`,
   });
   if (r.scenarios.length) {
     const ok = r.scenarios.filter((c) => c.status === 'PROVADO').length;
@@ -135,6 +136,7 @@ export function recapScenes(r) {
 }
 
 const SCENE_MS = 9000;
+const TOKENS = readFileSync(new URL('../view/tokens.css', import.meta.url), 'utf8');
 
 /** `audio`: optional `{ [sceneId]: dataUri }`; without it the page narrates with the system voice. */
 export function renderRecapHtml(r, { audio = null } = {}) {
@@ -147,8 +149,7 @@ export function renderRecapHtml(r, { audio = null } = {}) {
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>Recap — ${esc(r.feature)}</title>
 <style>
-:root { --bg:#0f1115; --card:#171a21; --fg:#e8ebf0; --dim:#b3bac6; --faint:#7f8796; --hair:#2a2f3a; --ok:#5cc28a; --warn:#e2a54b; --bad:#f07178; --accent:#8fb0ff; }
-@media (prefers-color-scheme: light) { :root { --bg:#f6f7f9; --card:#fff; --fg:#14171c; --dim:#4b5260; --faint:#7a8291; --hair:#dfe3ea; --ok:#2f7d4f; --warn:#a35f00; --bad:#b4232f; --accent:#2d5bd7; } }
+${TOKENS}:root { --bg:var(--paper); --card:var(--panel); --fg:var(--ink); --hair:var(--rule); --accent:var(--route); }
 * { box-sizing:border-box; }
 body { margin:0; min-height:100vh; background:var(--bg); color:var(--fg); font:16px/1.5 system-ui, -apple-system, "Segoe UI", sans-serif; display:flex; flex-direction:column; }
 .stage { flex:1; position:relative; max-width:960px; width:100%; margin:0 auto; padding:40px 16px 16px; }

package/src/lib/verify/detached.js

@@ -51,6 +51,9 @@ const removeRun = (paths) => {
   for (const file of Object.values(paths)) rmSync(file, { force: true });
 };
 
+// launch and watchdog run without a console on win32: every git the view spawns there opens a window.
+export const refreshesFeatureView = (env = process.env) => !['launch', 'watchdog'].includes(env[DETACH_STAGE_ENV]);
+
 export function matchesRun(record, { key, args }) {
   return record?.key === key && JSON.stringify(record.args) === JSON.stringify(args);
 }