@polymorphism-tech/morph-spec 9.8.0 → 10.0.0

package/framework/standards/frontend/scroll-driven/scroll-components.md

@@ -5,7 +5,7 @@
 > **Keywords:** pinned gallery, horizontal scroll, modal, lightbox, parallax, count-up, reveal, scroll progress, accordion
 > **Load When:** ui-designer active, or building a scroll-driven marketing page
 
-**Verified against:** GSAP 3.13 (ScrollTrigger, matchMedia, context) + React 18 + Lenis 1.x, shipped to production. Last-verified: 2026-08-21.
+**Verified against:** GSAP 3.13 (ScrollTrigger, matchMedia, context) + React 18 + Lenis 1.x, shipped to production. Last-verified: 2026-10-27.
 
 ---
 
@@ -114,6 +114,19 @@ useEffect(() => {
 
 **Render overlays outside any pinned section.** A pin applies a `transform` to its container, which becomes the containing block for `position: fixed` and breaks the overlay. Put the modal in a fragment as a sibling of the section.
 
+The markup: the backdrop closes on click, the panel stops propagation so a click inside does not close it, and the dialog carries its role.
+
+```jsx
+{active !== null && (
+  <div className={`lmodal${shown ? ' in' : ''}`} onClick={close} role="dialog" aria-modal="true">
+    <div className="lmodal__panel" data-lenis-prevent onClick={(e) => e.stopPropagation()}>
+      <button className="lmodal__close" onClick={close} aria-label="Close">×</button>
+      {/* content */}
+    </div>
+  </div>
+)}
+```
+
 **Mark the scrollable panel `data-lenis-prevent`.** Stopping the smooth scroller is not enough: while stopped it calls `preventDefault()` on any `touchmove` that reaches it, so a panel with `overflow-y: auto` scrolls with the wheel and is frozen under a finger. Whatever sits at the bottom of the panel, usually the CTA, becomes unreachable on a phone. See `frontend/scroll-driven/smooth-scroll.md`, Section 3.
 
 ```jsx
@@ -199,6 +212,8 @@ Format for the locale at write time (the decimal comma above is pt-BR). Never an
 
 ## Section 7: Persistent Elements
 
+These live at the app root, outside every section, and repeat on almost every marketing page.
+
 **Slim translucent nav** that gains a background once scrolled:
 
 ```jsx
@@ -208,6 +223,19 @@ useEffect(() => {
   window.addEventListener('scroll', onScroll, { passive: true })
   return () => window.removeEventListener('scroll', onScroll)
 }, [])
+return (
+  <nav className={`nav${solid ? ' nav--solid' : ''}`}>
+    <a className="nav__logo" href="#top"><span>{BRAND}</span></a>
+    <div className="nav__links">{/* anchors */}</div>
+    <a className="btn btn-accent" href="#contact">{CTA}</a>
+  </nav>
+)
+```
+
+```css
+.nav { position: fixed; top: 0; inset-inline: 0; z-index: 100; display: flex; align-items: center;
+  justify-content: space-between; padding: 16px clamp(16px,5vw,48px); transition: background .3s, backdrop-filter .3s; }
+.nav--solid { background: rgba(14,11,12,.7); backdrop-filter: blur(10px); border-bottom: 1px solid var(--hair); }
 ```
 
 **Scroll progress bar** that prefers the smooth scroller when present:
@@ -225,20 +253,64 @@ useEffect(() => {
 }, [])
 ```
 
+```jsx
+return <div className="scroll-progress" ref={ref} />
+```
+
+```css
+.scroll-progress { position: fixed; top: 0; left: 0; z-index: 101; height: 3px; width: 100%;
+  transform: scaleX(0); transform-origin: 0 50%; background: linear-gradient(90deg, var(--accent), var(--accent-soft)); }
+```
+
 Transform-based progress (`scaleX` with `transform-origin: 0 50%`) stays on the compositor. Animating `width` does not.
 
+**Floating chat button.** A fixed exit channel to the business's messaging app, always within reach. It is also the fallback when the lead form fails. For WhatsApp, a `wa.me` deep link with a prefilled message:
+
+```jsx
+<a className="chat-float" href={`https://wa.me/${PHONE}?text=${encodeURIComponent(MESSAGE)}`}
+   target="_blank" rel="noopener noreferrer" aria-label="Chat on WhatsApp">
+  <svg viewBox="0 0 24 24" width="26" height="26" aria-hidden="true">{/* icon path */}</svg>
+</a>
+```
+
+```css
+.chat-float { position: fixed; right: 20px; bottom: 20px; z-index: 90; width: 56px; height: 56px;
+  display: grid; place-items: center; border-radius: 50%; background: #25d366; color: #fff;
+  box-shadow: 0 8px 24px rgba(0,0,0,.35); transition: transform .25s; }
+.chat-float:hover { transform: translateY(-3px) scale(1.05); }
+```
+
+Keep its z-index below the nav and overlays, and check that it does not cover a CTA on mobile.
+
 ---
 
 ## Section 8: Accordion
 
-Use native `<details>`. It provides toggle, keyboard support and accessibility for free.
+Use native `<details>`. It provides toggle, keyboard support and accessibility for free. On a landing page the FAQ sits right before the form, to clear objections.
+
+```jsx
+const FAQ = [{ q: '...', a: '...' }]
+return (
+  <section className="section faq" id="faq">
+    <h2>{TITLE}</h2>
+    {FAQ.map((f) => (
+      <details className="faq__item" key={f.q}>
+        <summary>{f.q}<span className="faq__icon" aria-hidden="true">+</span></summary>
+        <p>{f.a}</p>
+      </details>
+    ))}
+  </section>
+)
+```
 
 ```css
+.faq__item { border-bottom: 1px solid var(--hair); padding: 18px 0; }
 .faq__item summary { cursor: pointer; list-style: none; display: flex;
-  justify-content: space-between; align-items: center; }
+  justify-content: space-between; align-items: center; font-family: var(--serif); font-size: 1.15rem; }
 .faq__item summary::-webkit-details-marker { display: none; }
-.faq__item .faq__icon { transition: transform .3s; }
+.faq__item .faq__icon { transition: transform .3s; color: var(--accent); }
 .faq__item[open] .faq__icon { transform: rotate(45deg); }
+.faq__item p { margin: 14px 0 0; color: var(--fg-dim); max-width: 70ch; }
 ```
 
 Native `<details>` cannot animate its own height. If height animation is required, drive the inner content with GSAP rather than replacing the element with a custom widget.

package/framework/templates/REGISTRY.json

@@ -332,10 +332,9 @@
       "path": "docs/ui-mockups.md",
       "category": "documentation",
       "phase": "uiux",
-      "description": "Wireframes and layout specifications with ASCII mockups and responsive breakpoints",
+      "description": "Por tela: protótipo HTML, direção escolhida, checklist de tela de 5 itens, componentes e fluxo",
       "outputName": "mockups.md",
       "placeholders": [
-        "DATE",
         "FEATURE_NAME"
       ],
       "deprecated": false,

package/framework/templates/context/ARCHITECTURE.md

@@ -88,7 +88,7 @@
 ## Centralidade (grafo de codebase)
 
 Símbolos com mais conexões depois do saneamento — o que quebra mais se mudar.
-Detalhe de um símbolo: `morph-spec graph explain <nome>`.
+Detalhe de um símbolo: `morph-spec graph explain <nome>` (sem grafo, símbolo ausente ou ambíguo: `grep -rn <nome>`).
 
 | Símbolo | Arquivo | Grau |
 |---------|---------|------|

package/framework/templates/docs/plan.md

@@ -15,10 +15,21 @@
 
 - <o que foi assumido sem prova; "nenhuma" vale>
 
+## Padrões assumidos
+
+<!-- Valor de baixo risco que você decidiu sem perguntar, numerado: o usuário veta por número ("veta 2").
+     Auth, credencial, permissão, pagamento e apagar dado nunca entram aqui: viram pergunta. "nenhum" vale. -->
+
+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. -->
+
 ## Cenários
 
 <!-- Um cenário por comportamento observável. `prova:` é teste | e2e | eval | manual | leitura.
      `prova: teste` exige `risco:` regra | dinheiro | contrato | concorrência | dado | regressão; sem risco, `leitura`.
+     `degrau:` migrar | irreversível quando um revert não desfaz (toda migration é migrar); sem a linha, refazer.
      Cenário que fala de arquivo, grep ou texto exige a linha "> Por que artefato:" logo abaixo. -->
 
 - **C1** — Dado <estado>, quando <ação>, então <resultado observável>.
@@ -56,19 +67,8 @@ nenhum
 |---|---|---|---|
 | <conceito> | REUSAR | <arquivo ou símbolo existente> | |
 
-## Fatias
-
-<!-- Uma fatia = uma unidade de entrega (com ou sem dispatch), relatório em 3-implement/reports/Fn.md.
-     arquivos ≤ 8; superfície e depende são opcionais; toda Cn é coberta por alguma fatia. -->
-
-### F1 — <título>
-- persona: dotnet-senior
-- standards: <id>
-- arquivos: <caminho/a.cs>, <caminho/b.cs>
-- cobre: C1
-
 ## Contrato de implementação
 
-<Assinaturas, records, enums e rotas que as fatias precisam honrar.>
+<Assinaturas, records, enums e rotas que a implementação honra; runtime do e2e; baseline de teste como comando.>
 
 ## Errata

package/framework/templates/docs/ui-mockups.md

@@ -1,119 +1,31 @@
-# UI Mockups & Wireframes: {{titleCase FEATURE_NAME}}
+# Mockups: {{titleCase FEATURE_NAME}}
 
-| Field | Value |
-|-------|-------|
-| **Feature** | {{FEATURE_NAME}} |
-| **Created** | {{DATE}} |
+<!-- Uma `## Tela:` por tela nova ou alterada. As opções navegáveis ficam em 1-design/opcoes/{tela}.html;
+     a escolhida vira 1-design/prototipos/{tela}.html, com os prints {tela}-1280.png e {tela}-390.png ao lado,
+     e um seletor de estado (data-estado="vazio|carregando|erro", ?estado=) com {tela}-{estado}-390.png de cada
+     estado que o checklist diz que se aplica. Faltando um, o Gate uiux pausa. -->
 
----
-
-## Screen Inventory
-
-| Screen ID | Name | Route | Priority |
-|-----------|------|-------|----------|
-| **S001** | {Screen Name} | /path | High |
-| **S002** | {Screen Name} | /path | Medium |
-
----
-
-## Tela: {Primary Screen}
+## Tela: {Nome da tela}
 
 **Protótipo:** 1-design/prototipos/{tela}.html
-
-O protótipo renderizado é a fonte visual da tela; os prints `{tela}-1280.png` e `{tela}-390.png` ficam ao lado dele, e sem os três arquivos o Gate uiux pausa. O layout em texto abaixo é opcional.
-
-### Desktop Layout
-
-```
-┌─────────────────────────────────────┐
-│  Header                    [User ▼] │
-├─────────────────────────────────────┤
-│                                     │
-│  [Title]                            │
-│                                     │
-│  ┌──────────────────────────────┐  │
-│  │ Main Content Area            │  │
-│  │                              │  │
-│  │  [Card 1]    [Card 2]        │  │
-│  │                              │  │
-│  │  ┌────────────────────────┐  │  │
-│  │  │ Data Table             │  │  │
-│  │  │ ...                    │  │  │
-│  │  └────────────────────────┘  │  │
-│  └──────────────────────────────┘  │
-│                                     │
-└─────────────────────────────────────┘
-```
-
-### Mobile Layout
-
-```
-┌──────────────────────┐
-│ ☰  Title    [User ▼]│
-├──────────────────────┤
-│                      │
-│ [Card 1]             │
-│                      │
-│ [Card 2]             │
-│                      │
-│ [View All Items]     │
-│                      │
-└──────────────────────┘
-```
+**Direção escolhida:** <qual opção de opcoes/{tela}.html e por quê, numa frase>
 
 ### Checklist de tela
 
-Troque cada `…` pela decisão — "não se aplica" vale se escrito; `…`, vazio ou "a definir" reprovam o Gate uiux.
+Troque cada `…` pela decisão. "Não se aplica" vale se escrito; `…`, vazio ou "a definir" reprovam o Gate uiux.
 
 | Item | Decisão |
 |---|---|
-| Superfície | … |
-| Volume esperado | … |
-| Paginação | … |
-| Ordenação | … |
-| Filtro | … |
-| Estado vazio | … |
-| Estado carregando | … |
-| Estado de erro | … |
-| Mobile | … |
-| Abas | … |
-
----
-
-## States
-
-### Loading
-- Show skeleton placeholders
-- Spinner for primary content
-
-### Empty
-- Icon + message
-- Clear call-to-action button
-
-### Error
-- Warning icon
-- User-friendly message
-- Retry button
-
-### Success (After Action)
-- Toast notification
-- Auto-dismiss after 3s
-
----
-
-## Interactions
-
-- **Hover**: Subtle elevation increase
-- **Click**: Scale down (0.98)
-- **Transitions**: Fade-in 200ms
+| Lista no servidor | … |
+| Estados vazio e carregando | … |
+| Erro com próxima ação | … |
+| Uma ação primária | … |
+| Celular | … |
 
----
+### Componentes
 
-## Accessibility
-- [ ] 44x44px minimum touch targets
-- [ ] Focus indicators visible
-- [ ] Proper heading hierarchy (H1 → H2 → H3)
+- <componente do design system reusado, ou novo e por quê>
 
----
+### Fluxo
 
-*Generated with MORPH Framework*
+1. <passo do usuário até o resultado>

package/package.json

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

package/src/commands/e2e/e2e.js

@@ -16,7 +16,9 @@ import {
   deleteStamp,
   getStackStatus,
   isDockerAvailable,
+  isHostOnlyStack,
   lintComposeIsolation,
+  resetE2eData,
   readStamp,
   resolveComposeFile,
   resolveSpecCommand,
@@ -34,8 +36,9 @@ import { readHeavyConfig } from '../../../framework/hooks/shared/heavy-config.js
 const EXIT_USAGE = 2;
 const EXIT_BUSY = 3;
 
-// No compose file is a usage error here, unlike in the verify node where it is a graded skip.
-function resolveContext(featureName, { json = false } = {}) {
+// No compose file and no e2e.hostServices is a usage error here, unlike in the verify node where
+// it is a graded skip. `composeFile` is null for a host-only stack.
+function resolveContext(featureName, { json = false, onMissing } = {}) {
   const root = resolvePrimaryRoot(process.cwd());
   const found = findWorktreeForFeature(featureName, root);
   const cwd = found?.path ?? root;
@@ -43,11 +46,13 @@ function resolveContext(featureName, { json = false } = {}) {
   const config = readConfig(cwd) ?? readConfig(root);
   const composeFile = resolveComposeFile(cwd, config);
 
-  if (!composeFile) {
+  if (!composeFile && !isHostOnlyStack(config, composeFile)) {
     const message =
-      `No compose file found in ${cwd} (compose.yaml, docker-compose.yml, …). ` +
-      'Set project.e2e.composeFile in .morph/config/config.json if it lives elsewhere.';
-    if (json) console.log(JSON.stringify({ error: message, tree: cwd }, null, 2));
+      `No compose file found in ${cwd} (compose.yaml, docker-compose.yml, …) and no e2e.hostServices. ` +
+      'Set e2e.composeFile in .morph/config/config.json if it lives elsewhere, ' +
+      'or declare the app in e2e.hostServices when it has no dependency to containerize.';
+    if (onMissing) onMissing(message, cwd);
+    else if (json) console.log(JSON.stringify({ error: message, tree: cwd }, null, 2));
     else console.error(chalk.red(`\n❌ ${message}\n`));
     return null;
   }
@@ -86,7 +91,7 @@ export async function e2eUpCommand(featureName, options = {}) {
 
   // Isolation BEFORE the docker check: a compose that hardcodes host ports or container names
   // collides with a sibling worktree whatever we inject.
-  const lint = lintComposeIsolation(readComposeText(ctx.cwd, ctx.composeFile));
+  const lint = ctx.composeFile ? lintComposeIsolation(readComposeText(ctx.cwd, ctx.composeFile)) : { findings: [] };
   const isolation = decideIsolation({ findings: lint.findings, insideWorktree: ctx.insideWorktree });
   if (isolation.status === 'fail') {
     if (options.json) {
@@ -106,7 +111,7 @@ export async function e2eUpCommand(featureName, options = {}) {
   }
 
   const exec = options._exec ?? defaultExec;
-  if (!isDockerAvailable(ctx.cwd, exec)) {
+  if (ctx.composeFile && !isDockerAvailable(ctx.cwd, exec)) {
     console.error(chalk.red('\n❌ Docker is not available in this environment.\n'));
     process.exit(EXIT_USAGE);
   }
@@ -149,7 +154,7 @@ export async function e2eUpCommand(featureName, options = {}) {
     tree: ctx.tree,
     composeFile: ctx.composeFile,
     status: failed ? 'fail' : 'pass',
-    reused: result.stack.reused,
+    reused: ctx.composeFile ? result.stack.reused : hostServices.reused,
     reason: result.reason,
     auth: { status: auth.status, reason: auth.reason },
     ...(hostServices.status === 'skip' ? {} : { hostServices: hostServices.services }),
@@ -164,7 +169,9 @@ export async function e2eUpCommand(featureName, options = {}) {
     if (result.output) console.error(result.output);
     for (const w of result.warnings) console.error(chalk.yellow(`⚠️  ${w}`));
   } else {
-    const how = result.stack.reused ? chalk.gray(`(${result.stack.reason})`) : chalk.gray('(built)');
+    const how = !ctx.composeFile
+      ? chalk.gray(`(${result.stack.reason})`)
+      : result.stack.reused ? chalk.gray(`(${result.stack.reason})`) : chalk.gray('(built)');
     console.log(chalk.green(`\n✓ Stack up — ${ctx.projectName} ${how}`));
     console.log(chalk.gray(`  tree: ${ctx.tree}`));
     for (const s of hostServices.services) {
@@ -190,18 +197,24 @@ export async function e2eStatusCommand(featureName, options = {}) {
   if (!ctx) process.exit(EXIT_USAGE);
 
   const exec = options._exec ?? defaultExec;
-  const status = getStackStatus(ctx.cwd, {
-    composeFile: ctx.composeFile,
-    projectName: ctx.projectName,
-    env: ctx.env,
-  }, exec);
+  const hostServices = ctx.gitCommonDir ? hostServicesStatus(ctx.gitCommonDir, ctx.projectName) : [];
+  const status = ctx.composeFile
+    ? getStackStatus(ctx.cwd, {
+      composeFile: ctx.composeFile,
+      projectName: ctx.projectName,
+      env: ctx.env,
+    }, exec)
+    : {
+      up: hostServices.length > 0 && hostServices.every((h) => h.alive),
+      healthy: hostServices.length > 0 && hostServices.every((h) => h.alive && h.health !== false),
+      services: [],
+    };
 
   const stamp = computeSourceStamp(ctx.cwd, exec);
   const previous = ctx.gitCommonDir ? readStamp(ctx.gitCommonDir, ctx.projectName) : null;
   const fresh = Boolean(stamp && previous?.stamp === stamp);
 
   const spec = resolveSpecCommand(ctx.cwd, ctx.config, ctx.config?.project?.frontendPath);
-  const hostServices = ctx.gitCommonDir ? hostServicesStatus(ctx.gitCommonDir, ctx.projectName) : [];
 
   const payload = {
     feature: featureName,
@@ -228,7 +241,7 @@ export async function e2eStatusCommand(featureName, options = {}) {
     console.log('');
     console.log(chalk.bold(`E2E stack — ${ctx.projectName}`));
     console.log(chalk.gray(`tree:    ${ctx.tree}`));
-    console.log(chalk.gray(`compose: ${ctx.composeFile}`));
+    console.log(chalk.gray(`compose: ${ctx.composeFile ?? 'none (host services only)'}`));
     console.log(chalk.gray(`url:     ${payload.baseUrl}`));
     console.log('');
     console.log(`  up       ${status.up ? chalk.green('yes') : chalk.gray('no')}`);
@@ -257,12 +270,14 @@ export async function e2eDownCommand(featureName, options = {}) {
   if (!ctx) process.exit(EXIT_USAGE);
 
   const hostServices = stopHostServices(ctx.gitCommonDir, ctx.projectName);
-  const result = tearDownStack(ctx.cwd, {
-    composeFile: ctx.composeFile,
-    projectName: ctx.projectName,
-    env: ctx.env,
-    volumes: Boolean(options.volumes),
-  }, options._exec ?? defaultExec);
+  const result = ctx.composeFile
+    ? tearDownStack(ctx.cwd, {
+      composeFile: ctx.composeFile,
+      projectName: ctx.projectName,
+      env: ctx.env,
+      volumes: Boolean(options.volumes),
+    }, options._exec ?? defaultExec)
+    : { status: 'pass', output: '' };
   const stampDeleted = deleteStamp(ctx.gitCommonDir, ctx.projectName);
   const cleanup = afterHeavyRun({ projectPath: ctx.cwd, config: readHeavyConfig(ctx.cwd) });
 
@@ -288,6 +303,56 @@ export async function e2eDownCommand(featureName, options = {}) {
   process.exit(0);
 }
 
+// Between the verifier's flows: the next flow starts from the seeded state, not from the rows the
+// previous one left. Exit 1 only on fail; skip (nothing configured to reset) is exit 0.
+export async function e2eResetCommand(featureName, options = {}) {
+  const emit = (payload) => {
+    if (options.json) {
+      console.log(JSON.stringify(payload, null, 2));
+    } else if (payload.status === 'fail') {
+      console.error(chalk.red(`\n✗ ${payload.reason}\n`));
+      if (payload.output) console.error(payload.output);
+    } else if (payload.status === 'skip') {
+      console.log(chalk.gray(`\n○ e2e reset: ${payload.reason}\n`));
+    } else {
+      const what = payload.reset.mode === 'command'
+        ? `e2e.resetCommand (${payload.reset.command})`
+        : payload.reset.mode === 'volumes'
+          ? `recreated ${payload.reset.services.join(', ')} (volumes ${payload.reset.volumes.join(', ')})`
+          : 'no data reset';
+      console.log(chalk.green(`\n✓ e2e reset — ${what}`));
+      if (payload.auth.reason) console.log(chalk.gray(`  auth: ${payload.auth.reason}`));
+      console.log('');
+    }
+    process.exit(payload.status === 'fail' ? 1 : 0);
+  };
+
+  const ctx = resolveContext(featureName, {
+    ...options,
+    onMissing: (message, tree) => emit({ feature: featureName, tree, status: 'fail', reason: message }),
+  });
+  if (!ctx) return;
+
+  const result = resetE2eData(ctx.cwd, {
+    config: ctx.config,
+    composeFile: ctx.composeFile,
+    projectName: ctx.projectName,
+    gitCommonDir: ctx.gitCommonDir,
+    env: ctx.env,
+  }, options._exec ?? defaultExec);
+
+  emit({
+    feature: featureName,
+    project: ctx.projectName,
+    tree: ctx.tree,
+    status: result.status,
+    reason: result.reason,
+    reset: result.reset,
+    auth: result.auth,
+    ...(result.status === 'fail' && result.output ? { output: result.output } : {}),
+  });
+}
+
 function stoppedAnything({ killed, skipped, warnings }) {
   return killed.length + skipped.length + warnings.length > 0;
 }

package/src/commands/graph/diff.js

@@ -0,0 +1,74 @@
+import chalk from 'chalk';
+import { execFileSync } from 'child_process';
+import { loadGraph, getFreshness, staleCause } from '../../lib/graph/graph-loader.js';
+import { parseDiff, buildDiffTree, renderDiffTree, declarationDrift } from '../../lib/graph/diff-tree.js';
+import { detectDefaultBranch } from '../../lib/git/default-branch.js';
+
+const git = (cwd, ...args) => execFileSync('git', args, { cwd, stdio: 'pipe' }).toString();
+
+function fail(options, payload, lines) {
+  if (options.json) console.log(JSON.stringify({ ok: false, ...payload }, null, 2));
+  else for (const [tone, text] of lines) console.error(chalk[tone](text));
+  process.exit(1);
+}
+
+// Only the committed range: the graph is a snapshot of HEAD, so a diff of the working tree would put
+// lines the graph never saw against symbols at the wrong place.
+export async function graphDiffCommand(options = {}) {
+  const projectPath = options.path || process.cwd();
+  const loaded = loadGraph(projectPath);
+  if (!loaded.ok) {
+    fail(options, { reason: 'no-graph', detail: loaded.reason }, [
+      ['yellow', `\n○ Sem grafo (${loaded.reason}): leia o diff cru (git diff).\n`],
+    ]);
+  }
+
+  const freshness = getFreshness(projectPath, loaded.graph);
+  if (freshness.state !== 'fresh') {
+    fail(options, { reason: 'stale-graph', freshness }, [
+      ['yellow', `\n○ O grafo não é deste commit (${staleCause(freshness)}): a árvore sairia com símbolos e linhas errados.`],
+      ['gray', '   Rode `morph-spec graph refresh` e repita; ou leia o diff cru (git diff).\n'],
+    ]);
+  }
+
+  let base = options.base;
+  try {
+    base ??= git(projectPath, 'merge-base', detectDefaultBranch(projectPath) || 'main', 'HEAD').trim();
+  } catch {
+    fail(options, { reason: 'no-base' }, [['yellow', '\n○ Sem base para o diff: passe --base <ref>.\n']]);
+  }
+  const changes = parseDiff(git(projectPath, 'diff', '-U0', '--no-renames', '--no-color', base, 'HEAD'));
+  let uncommitted = [];
+  try {
+    const dirty = new Set(git(projectPath, 'diff', '--name-only', 'HEAD').split('\n').filter(Boolean));
+    uncommitted = [...changes.keys()].filter((f) => dirty.has(f));
+  } catch { uncommitted = []; }
+
+  const tree = buildDiffTree(loaded.graph, changes);
+  const drift = declarationDrift(tree, (file) => {
+    try { return git(projectPath, 'show', `HEAD:${file}`).split(/\r?\n/); } catch { return []; }
+  });
+  if (drift.length) {
+    fail(options, { reason: 'graph-drift', drift }, [
+      ['yellow', `\n○ O grafo diz ser deste commit, mas ${drift.length} símbolo(s) não estão na linha que ele aponta (ex.: ${drift[0].label} em ${drift[0].file}:${drift[0].line}).`],
+      ['gray', '   A extração leu arquivos diferentes do commit. Rode `morph-spec graph build` e repita; ou leia o diff cru (git diff).\n'],
+    ]);
+  }
+  const payload = { ok: true, base, head: freshness.headCommit, ...tree, uncommitted };
+  if (options.json) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+
+  const { added, modified, entries, files } = tree.counts;
+  console.log(chalk.green(`\n✅ ${added} novo(s) +, ${modified} alterado(s) ~, ${entries} entrada(s), em ${files} arquivo(s) — ${String(base).slice(0, 8)}..${String(freshness.headCommit).slice(0, 8)}`));
+  for (const line of renderDiffTree(tree)) console.log(`   ${line}`);
+  if (tree.unmapped.length) {
+    console.log(chalk.gray(`\n   Sem símbolo tocado (só import/topo do arquivo, config, doc, ou fora do .graphifyignore) — leia no diff:`));
+    for (const f of tree.unmapped) console.log(chalk.gray(`     ${f}`));
+  }
+  if (uncommitted.length) {
+    console.log(chalk.yellow(`\n   ⚠ Mudança não commitada em ${uncommitted.length} arquivo(s) do diff: ela não está nesta árvore. Commit e repita.`));
+  }
+  console.log('');
+}

package/src/commands/graph/status.js

@@ -37,7 +37,7 @@ export async function graphStatusCommand(options = {}) {
     console.log(chalk.yellow(`\n○ Sem grafo (${loaded.reason})`));
     console.log(chalk.gray(`   ${loaded.path}`));
     console.log(chalk.gray('   Gere com: morph-spec graph build'));
-    console.log(chalk.gray('   Sem grafo, scout e skills seguem por grep normalmente.\n'));
+    console.log(chalk.gray('   Sem grafo, as skills seguem por grep normalmente.\n'));
     return;
   }
 

package/src/commands/observability/cost.js

@@ -111,11 +111,9 @@ function printMetricsBody(m) {
   const tov = m.testOutsideVerify;
   const timed = (t) => `${String(t.runs).padStart(4)}×  ${fmtDuration(t.measuredMs / 1000).padStart(8)}`
     + (t.unmeasured ? chalk.gray(` (${t.unmeasured} sem duração)`) : '');
-  console.log('\n' + chalk.white.bold('Teste fora do verify (sub-agentes)')
+  console.log('\n' + chalk.white.bold('Teste fora do verify')
     + chalk.gray(` · de ${tov.total.runs} testes+verifies, ${fmtDuration(tov.total.measuredMs / 1000)} cronometrados`
       + (tov.total.unmeasured ? `, ${tov.total.unmeasured} sem duração` : '')));
-  console.log(`  sub-agente rodando verify cheio      ${timed(tov.subagentVerify)}`);
-  console.log(`  implementador, 3ª rodada em diante   ${timed(tov.implementerRound3Plus)}`);
   console.log(`  agente de review rodando teste       ${timed(tov.reviewTests)}`);
   console.log(chalk.gray(`    ${tov.reviewTests.byPersona.runs}× pela persona morph-* (o que o hook test-budget reconhece);`
     + ' o resto veio de um nome de dispatch (ver-, rev-, gate3-…)'));
@@ -163,7 +161,7 @@ function printMetricsBody(m) {
     return;
   }
   for (const [gate, g] of gates) {
-    console.log(`  gate ${gate}: ${g.decisions} decisões, ${g.paused} pausas → ${g.approvedAfterPause} aprovadas como estavam, `
+    console.log(`  gate ${gate}: ${g.decisions} decisões, ${g.paused} pausas (${g.pausedForHuman} para o humano) → ${g.approvedAfterPause} aprovadas como estavam, `
       + `${g.reworkedAfterPause} retrabalhadas${g.unapproved ? `, ${g.unapproved} desaprovações` : ''}`);
     for (const [signal, s] of Object.entries(g.bySignal)) {
       console.log(chalk.gray(`    ${signal}: ${s.paused} pausas, ${s.approvedAfterPause} aprovadas como estavam, ${s.reworkedAfterPause} retrabalhadas`));

package/src/commands/observability/telemetry.js

@@ -35,7 +35,7 @@ export function telemetryCommand(options = {}) {
   }
 
   section('Skills', summary.skills, s => `${chalk.green(s.name.padEnd(24))} ${s.count}`);
-  section('Personas despachadas', summary.personas, p => `${chalk.magenta(p.name.padEnd(24))} ${p.count}`);
+  section('Sub-agents despachados', summary.personas, p => `${chalk.magenta(p.name.padEnd(24))} ${p.count}`);
   section('Base de conhecimento (standards lidos explicitamente)', summary.standards,
     s => `${chalk.yellow(String(s.count).padStart(3))}×  ${s.path}`);
   if (summary.standards.length || summary.tools.some(t => t.name === 'Read')) {