@polymorphism-tech/morph-spec 9.0.0 → 9.1.0

package/bin/morph-spec.js

@@ -1,14 +1,5 @@
 #!/usr/bin/env node
 
-/**
- * morph-spec CLI v5
- *
- * In v5 the CLI is the *installer* — Claude executes everything else
- * autonomously based on MORPH.md and the core skills. Commands here are
- * limited to actions that humans take or operations Claude needs help with
- * (scaffolding, validation, context refresh).
- */
-
 import { program } from 'commander';
 import chalk from 'chalk';
 import { fileURLToPath } from 'url';
@@ -16,14 +7,9 @@ import { dirname, join } from 'path';
 import { readFileSync } from 'fs';
 import { renderLogo, maybePrintFirstRunBanner } from '../src/utils/banner.js';
 
-// Command modules load on demand. Importing all ~45 of them eagerly cost
-// ~700 ms on EVERY invocation (init.js alone pulls inquirer: ~550 ms), paid
-// by each hook that shells out to the CLI and by each CLI spawn in the suite.
-// test/bin/command-modules-import.test.js imports every path below, so a module
-// that breaks at import time still fails the suite, not only its own command.
+// Lazy: eager import of every command cost ~700 ms per invocation, paid by each hook that shells out.
 const lazy = (path, name) => async (...args) => (await import(path))[name](...args);
 
-// === Project / install ===
 const initCommand = lazy('../src/commands/project/init.js', 'initCommand');
 const setupInfraCommand = lazy('../src/commands/project/setup-infra-cmd.js', 'setupInfraCommand');
 const installPluginCommand = lazy('../src/commands/project/install-plugin-cmd.js', 'installPluginCommand');
@@ -48,7 +34,6 @@ const scoutCheckCommand = lazy('../src/commands/validation/scout-check.js', 'sco
 const planCheckCommand = lazy('../src/commands/validation/plan-check.js', 'planCheckCommand');
 const stackScanCommand = lazy('../src/commands/project/stack-scan.js', 'stackScanCommand');
 
-// === Approval gates (human-only) ===
 const approveCommand = lazy('../src/commands/state/approve.js', 'approveCommand');
 const approvalStatusCommand = lazy('../src/commands/state/approve.js', 'approvalStatusCommand');
 const unapproveCommand = lazy('../src/commands/state/approve.js', 'unapproveCommand');
@@ -63,15 +48,11 @@ const handoffCommand = lazy('../src/commands/state/handoff.js', 'handoffCommand'
 const listCommand = lazy('../src/commands/state/list.js', 'listCommand');
 const deleteCommand = lazy('../src/commands/state/delete.js', 'deleteCommand');
 
-// === Tasks ===
-
-// === Codebase graph ===
 const graphStatusCommand = lazy('../src/commands/graph/status.js', 'graphStatusCommand');
 const graphBuildCommand = lazy('../src/commands/graph/build.js', 'graphBuildCommand');
 const graphAffectedCommand = lazy('../src/commands/graph/affected.js', 'graphAffectedCommand');
 const graphExplainCommand = lazy('../src/commands/graph/explain.js', 'graphExplainCommand');
 
-// === Validation ===
 const validateCommand = lazy('./validate.js', 'validateCommand');
 const validateFeatureCommand = lazy('../src/commands/validation/validate-feature.js', 'validateFeatureCommand');
 const verifyCommand = lazy('../src/commands/validation/verify.js', 'verifyCommand');
@@ -80,20 +61,15 @@ const e2eUpCommand = lazy('../src/commands/e2e/e2e.js', 'e2eUpCommand');
 const e2eStatusCommand = lazy('../src/commands/e2e/e2e.js', 'e2eStatusCommand');
 const e2eDownCommand = lazy('../src/commands/e2e/e2e.js', 'e2eDownCommand');
 
-// === Scaffolding ===
 const scaffoldDotnetCommand = lazy('../src/commands/scaffold/scaffold.js', 'scaffoldDotnetCommand');
 const scaffoldNextjsCommand = lazy('../src/commands/scaffold/scaffold.js', 'scaffoldNextjsCommand');
 
-// === MCP setup ===
 const mcpSetupCommand = lazy('../src/commands/mcp/mcp-setup.js', 'mcpSetupCommand');
 
-// === Context refresh ===
 const contextRefreshCommand = lazy('../src/commands/context/context-refresh.js', 'contextRefreshCommand');
 
-// === Dashboard ===
 const dashboardCommand = lazy('../src/commands/dashboard/dashboard.js', 'dashboardCommand');
 
-// === Observability ===
 const telemetryCommand = lazy('../src/commands/observability/telemetry.js', 'telemetryCommand');
 const costCommand = lazy('../src/commands/observability/cost.js', 'costCommand');
 
@@ -104,9 +80,7 @@ const banner = `${renderLogo(pkg.version)}
   ${chalk.dim('Spec-driven development harness for Claude Code — by Polymorphism Tech')}
 `;
 
-// First run after an install/upgrade: show the install banner (npm ≥7 hides
-// postinstall output). Skipped for --version/--help (parsed/already-bannered)
-// and for non-TTY output — see maybePrintFirstRunBanner.
+// npm >=7 hides postinstall output, so the first run after an install shows the banner.
 const argvRest = process.argv.slice(2);
 const skipFirstRun = argvRest.length === 0 ||
   argvRest.some(a => ['-V', '--version', '-h', '--help'].includes(a));
@@ -120,7 +94,6 @@ program
   .version(pkg.version)
   .addHelpText('beforeAll', banner);
 
-// ─── Install ──────────────────────────────────────────────────────────────
 program
   .command('init')
   .description('Initialize MORPH-SPEC in current directory')
@@ -163,7 +136,6 @@ program
   .option('--reset', 'Remove morph-managed entries from .claude/settings.local.json')
   .action(doctorCommand);
 
-// ─── Status / inspection ──────────────────────────────────────────────────
 program
   .command('status <feature>')
   .description('Show feature status (phase, gate state, task counts)')
@@ -180,7 +152,6 @@ program
   .option('--json', 'Output as JSON')
   .action((options) => listCommand(options));
 
-// ─── Approval gates (dev-only) ────────────────────────────────────────────
 program
   .command('approve <feature> <gate>')
   .description('Approve a phase gate (plan, uiux, review). Enforces gate order (uiux and review require plan)')
@@ -293,7 +264,6 @@ program
   .option('--here', 'Force building/writing in the current directory, even if another tree owns this feature')
   .action((feature, options) => handoffCommand(feature, options));
 
-// ─── Codebase graph ───────────────────────────────────────────────────────
 const graphCommand = program
   .command('graph')
   .description('Grafo de codebase (graphify) com saneamento determinístico — fail-open: sem grafo, tudo segue por grep');
@@ -335,7 +305,6 @@ graphCommand
   .option('--json', 'Output as JSON')
   .action((symbol, options) => graphExplainCommand(symbol, options));
 
-// ─── Validation ───────────────────────────────────────────────────────────
 program
   .command('validate [validator]')
   .description('Run project validations (all | packages | next-components | spec-tasks)')
@@ -392,7 +361,6 @@ program
   .option('--json', 'Output as JSON')
   .action((feature, options) => mutateCommand(feature, options));
 
-// ─── Scaffolding ──────────────────────────────────────────────────────────
 const scaffoldCmd = program
   .command('scaffold')
   .description('Generate feature files from templates');
@@ -414,7 +382,6 @@ scaffoldCmd
   .option('-v, --verbose', 'Show detailed output')
   .action(scaffoldNextjsCommand);
 
-// ─── MCP setup ────────────────────────────────────────────────────────────
 const mcpCommand = program
   .command('mcp')
   .description('MCP server setup and configuration');
@@ -426,7 +393,6 @@ mcpCommand
   .option('--auto', 'Auto-install credential-free MCPs without prompts')
   .action((name, options) => mcpSetupCommand(name, options));
 
-// ─── Context refresh ──────────────────────────────────────────────────────
 const contextCommand = program
   .command('context')
   .description('Project context management (refresh)');
@@ -439,7 +405,6 @@ contextCommand
   .option('--json', 'Output scan result as JSON')
   .action((options) => contextRefreshCommand(options));
 
-// ─── E2E stack (Docker bring-up for runtime verification) ─────────────────
 const e2eCommand = program
   .command('e2e')
   .description("Lifecycle of the feature's verification stack (docker compose)");
@@ -464,7 +429,6 @@ e2eCommand
   .option('--json', 'Output as JSON')
   .action((feature, options) => e2eDownCommand(feature, options));
 
-// ─── Heavy nodes (build, tests, e2e) ─────────────────────────────────────
 const heavyCommand = program
   .command('heavy')
   .description('Slots por usuário para os nós pesados (build, testes, e2e), compartilhados entre as sessões');
@@ -481,7 +445,6 @@ heavyCommand
   .option('--label <label>', 'Nome do que roda, mostrado a quem espera pelo slot')
   .action((command, options) => heavyRunCommand(command, options));
 
-// ─── Worktree (optional, isolation) ───────────────────────────────────────
 const worktreeCommand = program
   .command('worktree')
   .description('Manage git worktrees for feature isolation');
@@ -493,10 +456,6 @@ worktreeCommand
   .option('--json', 'Output as JSON (always JSON — accepted so the WorktreeCreate hook can call setup and provision uniformly)')
   .action((feature, options) => worktreeSetupCommand(feature, options));
 
-// Task isolation — the tree `claude -w`, EnterWorktree and Agent
-// isolation:"worktree" ask for when the name is NOT a feature. Same infra as
-// setup (junctions, port block, git-invisible manifest, primary-root landing),
-// no feature identity. The WorktreeCreate hook is its main caller.
 worktreeCommand
   .command('provision <name>')
   .description('Create a task-isolation worktree at worktrees/{name}/ on branch morph-task/{name} — full morph infra, no feature identity')
@@ -511,10 +470,8 @@ worktreeCommand
   .option('--all', 'Link all shared dirs, not just node_modules')
   .action((options) => worktreeLinkCommand(options));
 
-// The SAFE removal — it drops the infra junctions before letting git near the
-// directory. Raw `git worktree remove` follows them out and empties the primary
-// root's .claude/ and .morph/framework/, so nothing in this repo (message, doc,
-// or skill) may point at it; they all point here.
+// Raw `git worktree remove` follows the infra junctions and empties the primary root's .claude/
+// and .morph/framework/: nothing in this repo may point at it, only at this command.
 worktreeCommand
   .command('remove [feature]')
   .description('Safely tear down a worktree (drops infra junctions first, PROVE-or-DECLINE) — does NOT close the feature; that is `finish`')
@@ -525,9 +482,6 @@ worktreeCommand
   .option('--json', 'Output as JSON (always JSON)')
   .action((feature, options) => worktreeRemoveCommand(feature, options));
 
-// Sub-agent trees (`agent-<hex>` on `morph-task/agent-<hex>`) outlive the agent: nothing
-// tells the harness the agent is done with its worktree. The reaper removes only what it can prove
-// is finished and lost-proof; the rest is listed with the reason.
 worktreeCommand
   .command('reap')
   .description('Remove the worktrees and branches of sub-agents that stopped clean (nothing uncommitted, no commit only they hold); everything else is listed with the reason and left alone')
@@ -542,11 +496,6 @@ worktreeCommand
   .option('--json', 'Output as JSON')
   .action((options) => worktreeListCommand(options));
 
-// ─── Branch housekeeping ──────────────────────────────────────────────────
-// `git branch --merged` cannot see a squash-merge, so the only command left for
-// a squash-merged branch is `git branch -D` — indistinguishable from discarding
-// real work. `prune` makes the distinction itself and deletes only what it
-// proved is already integrated.
 const branchCommand = program
   .command('branch')
   .description('Local branch housekeeping');
@@ -559,7 +508,6 @@ branchCommand
   .option('--json', 'Output as JSON')
   .action((options) => branchPruneCommand(options));
 
-// ─── Worktree env (shell-loadable port block) ─────────────────────────────
 program
   .command('env [feature]')
   .description('Print the worktree\'s dedicated environment (port block + COMPOSE_PROJECT_NAME), shell-loadable: eval "$(morph-spec env)" outside Claude Code; feature defaults to the morph/{f} or morph-task/{n} branch of cwd')
@@ -567,14 +515,12 @@ program
   .option('--powershell', 'Emit $env:K="V" lines instead of POSIX exports')
   .action((feature, options) => envCommand(feature, options));
 
-// ─── Fleet ────────────────────────────────────────────────────────────────
 program
   .command('fleet')
   .description('Fleet view — every active feature across primary root and worktrees (phase, gates, tasks, ports, handoff, activity)')
   .option('--json', 'Output as JSON')
   .action((options) => fleetCommand(options));
 
-// ─── Claims (advisory feature ownership) ──────────────────────────────────
 program
   .command('claim [feature]')
   .description('claim [feature] acquires it (moves this tree\'s previous claim in the same step); no args shows the board (claims are advisory warnings, never locks)')
@@ -584,7 +530,6 @@ program
   .option('--json', 'Output as JSON')
   .action((feature, options) => claimCommand(feature, options));
 
-// ─── Standards search (server-side, R2 token cut) ─────────────────────────
 program
   .command('standards')
   .description('Search STANDARDS.json server-side (top 3, digest + anchors) or print one section, instead of reading the whole registry. Bare: categories + counts')
@@ -595,7 +540,6 @@ program
   .option('--json', 'Output as JSON')
   .action((options) => standardsCommand(options));
 
-// ─── Sub-agent report protocol ────────────────────────────────────────────
 program
   .command('report-check <feature> [slices...]')
   .description('Audit slice report files (3-implement/reports/{slice}.md) against the work the dispatch actually wrote (telemetry, keyed by the agent that wrote the report). Exits 0 only when every audited slice is intact; naming slices audits only those')
@@ -624,7 +568,6 @@ program
   .option('--json', 'Output as JSON')
   .action((feature, options) => stackScanCommand(feature, options));
 
-// ─── Dashboard ────────────────────────────────────────────────────────────
 program
   .command('dashboard')
   .description('Open the morph-spec inspector dashboard')
@@ -632,7 +575,6 @@ program
   .option('--no-open', 'Don\'t auto-open browser')
   .action(dashboardCommand);
 
-// ─── Observability ────────────────────────────────────────────────────────
 program
   .command('telemetry')
   .description('Summarize the harness execution path from .morph/logs/events.jsonl (skills, personas, standards read, tool mix, prompts)')

package/bin/validate.js

@@ -1,26 +1,8 @@
 #!/usr/bin/env node
 
-/**
- * Validation CLI
- *
- * Runs validators for the current project stack (detected from .morph/config/config.json).
- *
- * .NET stacks:       packages
- * Next.js stack:      next-components
- *
- * Usage:
- *   morph-spec validate [options]
- *   morph-spec validate all
- *   morph-spec validate next-components  (Next.js projects)
- *   morph-spec validate packages         (.NET projects)
- *
- * MORPH-SPEC 3.0
- */
-
 import chalk from 'chalk';
 import { getStackProfile } from '../src/lib/stack/stack-profile.js';
 
-/** The validators of the current stack: .NET → packages, Next.js → next-components. */
 async function buildValidators(stack) {
   const validators = {};
 
@@ -49,9 +31,6 @@ async function buildValidators(stack) {
   return validators;
 }
 
-/**
- * Main validation command
- */
 export async function validateCommand(args = []) {
   const validatorName = args[0] || 'all';
   const options = parseOptions(args);
@@ -79,9 +58,6 @@ export async function validateCommand(args = []) {
   }
 }
 
-/**
- * Run all validators
- */
 async function runAllValidators(VALIDATORS, options) {
   const results = {};
   let totalErrors = 0;
@@ -101,12 +77,10 @@ async function runAllValidators(VALIDATORS, options) {
 
       results[name] = result;
 
-      // Count errors/warnings
       if (result.errors !== undefined) {
         totalErrors += result.errors;
         totalWarnings += result.warnings || 0;
       } else if (result.results) {
-        // Count issues in results array
         const issues = result.results.flatMap(r => r.issues || []);
         totalErrors += issues.filter(i => i.level === 'error').length;
         totalWarnings += issues.filter(i => i.level === 'warning').length;
@@ -118,7 +92,6 @@ async function runAllValidators(VALIDATORS, options) {
     }
   }
 
-  // Summary
   console.log(chalk.bold.cyan('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
   console.log(chalk.bold('📊 Validation Summary\n'));
 
@@ -135,15 +108,11 @@ async function runAllValidators(VALIDATORS, options) {
 
   console.log('');
 
-  // Exit with error code if errors found
   if (totalErrors > 0 && !options.noFail) {
     process.exit(1);
   }
 }
 
-/**
- * Run single validator
- */
 async function runValidator(VALIDATORS, name, options) {
   const validator = VALIDATORS[name];
 
@@ -152,7 +121,7 @@ async function runValidator(VALIDATORS, name, options) {
 
   try {
     const result = await validator.run('.', {
-      verbose: true, // Always verbose for single validator
+      verbose: true,
       autoFix: options.autoFix
     });
 
@@ -174,9 +143,6 @@ async function runValidator(VALIDATORS, name, options) {
   }
 }
 
-/**
- * Parse command-line options
- */
 function parseOptions(args) {
   const options = {
     verbose: false,
@@ -197,9 +163,6 @@ function parseOptions(args) {
   return options;
 }
 
-/**
- * Show help
- */
 export function showValidateHelp() {
   console.log(`
 ${chalk.bold.cyan('morph-spec validate')} - Run project validations
@@ -234,7 +197,6 @@ ${chalk.bold('INTEGRATION')}
 `);
 }
 
-// Run if called directly
 if (import.meta.url === `file://${process.argv[1]}`) {
   const args = process.argv.slice(2);
 

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "9.0.0",
+  "version": "9.1.0",
   "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

@@ -185,4 +185,4 @@ Never edited directly — go through CLI commands or `morph-spec update` instead
 
 ---
 
-*morph-spec v9.0.0 by Polymorphism Tech*
+*morph-spec v9.1.0 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -249,4 +249,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v9.0.0 by Polymorphism Tech*
+*morph-spec v9.1.0 by Polymorphism Tech*

package/framework/CLAUDE.md

@@ -39,7 +39,7 @@ Prefixo `morph-spec`; flags e porquês em `.morph/framework/CLI.md` (um `###` po
 
 ## Slash commands
 
-`/morph-proposal {f}` (plano), `/morph-apply {f}` (execução + Gate 3), `/morph-hotfix {f}`, `/morph-status [f]`.
+`/morph-plan {f}` (plano), `/morph-apply {f}` (execução + Gate 3), `/morph-hotfix {f}`, `/morph-status [f]`.
 
 ## Personas (em `.claude/agents/`)
 

package/framework/MORPH.md

@@ -199,4 +199,4 @@ Relatório ausente não prova que o agente falhou, e relatório presente não pr
 
 **Skills core** (`.claude/skills/{nome}/SKILL.md`, invocadas no momento indicado na descrição de cada uma): `morph-plan` (entrada: roteia, varre, entrevista, `plan.md`, gate do plano) · `morph-apply` (fatias → verify → review) · `morph-uiux` · `morph-review` · `morph-hotfix` · `morph-standards` · `morph-media` · `morph-machine`.
 
-`/morph-proposal` → `morph-plan`, `/morph-apply` e `/morph-hotfix` são atalhos da skill. Desvio do passo a passo vai justificado no relatório.
+`/morph-plan` invoca a skill direto; `/morph-apply` e `/morph-hotfix` são atalhos da skill homônima. Desvio do passo a passo vai justificado no relatório.

package/framework/agents.json

@@ -242,6 +242,8 @@
       ],
       "standards": [
         "frontend-design-system-naming",
+        "frontend-design-system-art-direction",
+        "frontend-design-system-premium-finish",
         "frontend-design-system-animations",
         "frontend-nextjs-motion-patterns",
         "architecture-code-comments",
@@ -251,7 +253,6 @@
         "marketing-site": {
           "when": "site de marketing: landing page, institucional, campanha — narrativa, conversão, movimento e SEO",
           "standards": [
-            "frontend-design-system-premium-finish",
             "frontend-design-system-ai-image-generation",
             "frontend-design-system-ai-video-generation",
             "frontend-scroll-driven-frame-scrub",
@@ -271,6 +272,13 @@
             "frontend-admin-app-feedback",
             "frontend-admin-app-page-structure"
           ]
+        },
+        "brand-moment": {
+          "when": "momento de marca dentro do produto: login e auth, onboarding, primeira tela, estado vazio de destaque, sucesso, vitrine — direção, cena e movimento",
+          "standards": [
+            "frontend-gsap-core",
+            "frontend-gsap-scrolltrigger"
+          ]
         }
       },
       "mcp": [
@@ -280,10 +288,10 @@
         "playwright",
         "graphify"
       ],
-      "model": "sonnet",
+      "model": "opus",
       "maxTurns": 120,
-      "effort": "medium",
-      "persona": "Você desenha sistemas, não telas isoladas. Pensa em tokens (cor, espaço, tipografia), componentes reutilizáveis, estados (default/hover/focus/disabled/loading/error), acessibilidade WCAG AA. Mockups em Tailwind direto, sem Figma intermediário. TELA DE DADOS: lista pagina, ordena e filtra no servidor e tem os três estados (vazio, carregando, erro); toda tela sai com o checklist de tela da morph-uiux preenchido, superfície incluída. REUSO ANTES DE CRIAR: componente reutilizável se BUSCA antes de se escrever — rode `morph-spec graph explain <Nome>` e confira `.morph/context/design-system.md` (sem grafo: `grep -rn`); criar um novo exige justificativa em uma linha no relatório da fatia, a mesma regra que já vale para token de design. COMENTÁRIO E TESTE: nenhum comentário, mesmo com vizinho comentado: nome, tipo e teste explicam (pós-condição no nome do teste); só o porquê invisível, sem `///`/JSDoc, id de cenário/fatia ou banner; um teste por pós-condição, cenários do mesmo comportamento em tabela, nenhum teste que só fixa texto."
+      "effort": "high",
+      "persona": "Você desenha sistemas E telas que alguém lembra. As duas réguas valem juntas: a de sistema (tokens de cor, espaço e tipografia, componentes reutilizáveis, estados default/hover/focus/disabled/loading/error, WCAG AA) e a estética, que é o que separa um design correto de um design aprovado. DIREÇÃO ANTES DE COMPONENTE: antes de qualquer componente, escreva em `1-design/direcao.md` o conceito em uma frase, a metáfora visual, o que torna a tela memorável e o que ela NÃO pode parecer (template shadcn cru, card branco centralizado, lista de ícones genérica). Tela nova ou momento de marca: explore 2 ou 3 direções distintas, recomende uma e justifique — o standard `frontend-design-system-art-direction` é a régua. SKILLS: carregue `frontend-design:frontend-design` sempre; `high-end-visual-design` em momento de marca; `redesign-existing-projects` em tela existente — cada uma só se instalada (a lista de skills da sessão diz); ausente, o standard de direção de arte é a régua e o relatório registra a ausência. CELULAR PRIMEIRO E NATIVO: folha inferior, zona do polegar, alvos de 44px, navegação que o polegar alcança; o celular é desenhado, nunca o desktop empilhado. MOVIMENTO COM INTENÇÃO: a ferramenta mais leve que entrega o efeito (CSS transition e `@keyframes` → animação por scroll em CSS → Framer Motion → GSAP com ScrollTrigger e timeline), orçamento de 60 fps, só `transform` e `opacity`, nada de layout thrash; `prefers-reduced-motion` tem versão estática digna, composta, nunca só a animação desligada. ACABAMENTO: camadas, luz (gradiente radial, trama discreta), vidro com moderação, sombra com a cor do tema, ritmo tipográfico (escala modular, tracking negativo no display), microinteração em foco, hover e envio. PROTÓTIPO E AUTOCRÍTICA: toda tela nova ou alterada vira `1-design/prototipos/{tela}.html` autossuficiente, com os tokens REAIS do projeto lidos do CSS de tokens (o `design-system.md` pode estar velho), desktop e celular lado a lado em moldura de aparelho, com controles animado, estático e pausar. Sirva por HTTP local (o Playwright MCP recusa `file:`), tire print em 1280 e em 390 (`{tela}-1280.png`, `{tela}-390.png` ao lado do HTML), avalie contra as duas réguas (hierarquia, contraste, ritmo, celular, \"parece template?\"), corrija e repita até passar; o relatório lista as rodadas e o que cada uma corrigiu. PROIBIDO: número ou dado inventado em tela real (cena ilustrativa não traz métrica), cópia de marca de terceiros, efeito que quebra contraste AA. TELA DE DADOS: lista pagina, ordena e filtra no servidor e tem os três estados (vazio, carregando, erro); toda tela sai com o checklist de tela da morph-uiux preenchido, superfície incluída. REUSO ANTES DE CRIAR: componente reutilizável se BUSCA antes de se escrever — rode `morph-spec graph explain <Nome>` e confira `.morph/context/design-system.md` (sem grafo: `grep -rn`); criar um novo exige justificativa em uma linha no relatório da fatia, a mesma regra que já vale para token de design. COMENTÁRIO E TESTE: nenhum comentário, mesmo com vizinho comentado: nome, tipo e teste explicam (pós-condição no nome do teste); só o porquê invisível, sem `///`/JSDoc, id de cenário/fatia ou banner; um teste por pós-condição, cenários do mesmo comportamento em tabela, nenhum teste que só fixa texto."
     },
     "infra-engineer": {
       "title": "Infrastructure / Jobs Engineer",

package/framework/commands/morph-apply.md

@@ -9,6 +9,6 @@ allowed-tools: Read, Write, Edit, Bash, Glob, Grep, Agent, AskUserQuestion, Skil
 Atalho: invoque `Skill(morph-apply)` com o nome da feature.
 
 Pré-requisito: o gate do plano aprovado, com `.morph/features/{feature}/2-plan/plan.md` e
-`2-plan/checks.json` (gravado por `morph-spec plan-check`). Faltando, rode `/morph-proposal {feature}`.
+`2-plan/checks.json` (gravado por `morph-spec plan-check`). Faltando, rode `/morph-plan {feature}`.
 
 **Feature:** $ARGUMENTS

package/framework/commands/morph-status.md

@@ -34,7 +34,7 @@ output completion (X/N outputs), slice progress (reports in `3-implement/reports
 After running the CLI, summarize:
 - Current phase and which gate (if any) is open
 - Outstanding outputs for the current phase
-- Recommended next slash command (`/morph-proposal`, `/morph-apply`, or a gate approval)
+- Recommended next slash command (`/morph-plan`, `/morph-apply`, or a gate approval)
 
 ---
 

package/framework/docs/CLI.md

@@ -16,7 +16,7 @@
 
 **Exceção `hotfix`:** esse tipo nunca despacha (`morph-hotfix` §7); o Gate 3 exige só `4-review/verifier.md`, escrito pelo orquestrador, e a assinatura humana continua obrigatória via `--approver` (o backstop de `--mode auto` acima permanece recusando).
 
-**No `uiux`, a assinatura `auto` é recusada (exit 1) onde o `gate-check uiux` pausaria pelo checklist de tela** — o mesmo predicado do `advance` (`uiuxChecklistPause`, em `risk-detector.js`), lido mesmo sem gate-check antes. Destravam: uma decisão gravada com `pause: false` (`gate-decision {f} uiux --pause false --reason …`, ou um gate-check que não pausou) e a assinatura humana (`--approver`); `--force` não. A decisão vale para o mockup que viu: ela grava `mockupsHash` (o `mockups.md` por conteúdo), e um mockup escrito ou mudado depois dela volta a ser conferido.
+**No `uiux`, a assinatura `auto` é recusada (exit 1) onde o `gate-check uiux` pausaria pelo checklist de tela ou pelo protótipo** — o mesmo predicado do `advance` (`uiuxChecklistPause`, em `risk-detector.js`), lido mesmo sem gate-check antes. Destravam: uma decisão gravada com `pause: false` (`gate-decision {f} uiux --pause false --reason …`, ou um gate-check que não pausou) e a assinatura humana (`--approver`); `--force` não. A decisão vale para o mockup que viu: ela grava `mockupsHash` (o `mockups.md` por conteúdo), e um mockup escrito ou mudado depois dela volta a ser conferido.
 
 **O hook state-sync.js** cobre o caminho manual: `AskUserQuestion` respondida com frase de aprovação (abaixo) → registra o gate no `feature.json` autoritativo com `approvedBy: "manual"`. **A feature é identificada pelo nome que a pergunta cita** — grava na árvore dona dela, nunca na "feature ativa" da sessão. Pergunta sem nome numa árvore com mais de uma feature: o hook **recusa gravar** e avisa — aprove por `morph-spec approve`.
 
@@ -42,7 +42,7 @@ Um stamp de `verification` com status `fail` (último `morph-spec verify` vermel
 
 **Prova de mídia:** do MESMO relatório e pelo MESMO leitor, o `gate-check` grava `signals.mediaClaims = {section, featureGeneratesMedia}`. `featureGeneratesMedia` é determinístico do disco — existe ao menos uma fatia do `checks.json` cujo `standards` cita `ai-agents-modalities-image-gen`, `ai-agents-media-video` ou `ai-agents-media-pipeline` — pelo id de STANDARDS.json ou pelo caminho, com ou sem `framework/`/`standards/` na frente, porque uma grafia não prevista desarmaria o guardrail sem uma linha de erro (`featureGeneratesMedia`, função exportada de `gate-check.js`, é onde essa normalização mora e é testada). Nessa condição, relatório **sem** a seção `## Mídia gerada` **pausa o Gate 3**: as quatro afirmações de mídia (custo, revisão humana, marcação, hot path não bloqueado) não foram provadas (`framework/evals/review-checklist.md`, "Feature que gera mídia").
 
-**Checklist de tela:** na `uiux` e no `review`, o `gate-check` grava `signals.screenChecklist` lido do `1-design/mockups.md` (`mockups`, `legacy`, `screens`, `problems`). Na **uiux**, checklist incompleto **pausa** nomeando a tela e o item, e um mockup sem nenhuma `## Tela:` é o problema "nenhuma tela declarada". No **review**, o que se cobra é o item **devido** — decidido, nem "não se aplica" nem a superfície (`uncovered`): cada um exige uma linha na seção `## Checklist de tela` do `verifier.md`, e a linha que o verificador marca como não verificável conta. Com item devido, relatório sem a seção ou com linha faltando (`section`, `uncovered`) **pausa** o Gate 3 (`evals/review-checklist.md`, "Contrato de tela"); tela toda "não se aplica" não deve nada e não pausa. **Mockup legado** — telas no formato antigo (`## S001: …`) e nenhuma `## Tela:`, o que o template anterior gerava — é **isento nas duas fases**, com a isenção à vista: o sinal grava `exempt: "checklist dispensado: mockup no formato antigo"` e a mesma razão aparece em "risk signals present". Mockup ausente não pausa. `screenChecklist` **não** é sobrescrevível por `--signals`.
+**Checklist de tela:** na `uiux` e no `review`, o `gate-check` grava `signals.screenChecklist` lido do `1-design/mockups.md` (`mockups`, `legacy`, `screens`, `problems`). Na **uiux**, checklist incompleto **pausa** nomeando a tela e o item, e um mockup sem nenhuma `## Tela:` é o problema "nenhuma tela declarada". Com o checklist completo, cada tela ainda deve o **protótipo** (`prototypes`, só na uiux): a linha `**Protótipo:** 1-design/prototipos/<tela>.html` dentro da `## Tela:`, o HTML e os prints `<tela>-1280.png` e `<tela>-390.png` ao lado dele; faltando um, **pausa** nomeando a tela e o arquivo ("protótipo incompleto"), pelo mesmo predicado. No **review**, o que se cobra é o item **devido** — decidido, nem "não se aplica" nem a superfície (`uncovered`): cada um exige uma linha na seção `## Checklist de tela` do `verifier.md`, e a linha que o verificador marca como não verificável conta. Com item devido, relatório sem a seção ou com linha faltando (`section`, `uncovered`) **pausa** o Gate 3 (`evals/review-checklist.md`, "Contrato de tela"); tela toda "não se aplica" não deve nada e não pausa. **Mockup legado** — telas no formato antigo (`## S001: …`) e nenhuma `## Tela:`, o que o template anterior gerava — é **isento nas duas fases**, com a isenção à vista: o sinal grava `exempt: "checklist dispensado: mockup no formato antigo"` e a mesma razão aparece em "risk signals present". Mockup ausente não pausa. `screenChecklist` **não** é sobrescrevível por `--signals`.
 
 **Por quê.** Fora do review a regra não vale (pausar o Gate 1/2 numa máquina sem docker travaria planejamento legítimo). Feature que não pina standard de mídia é **isenta automaticamente** — a regra não pede cerimônia de quem não gera mídia. `mediaClaims` **não** é sobrescrevível por `--signals`, pela mesma razão anti-spoof dos demais sinais de disco.
 
@@ -61,7 +61,7 @@ A tabela é a mesma régua que `shouldPauseGate` aplica e que o `gate-check` imp
 | `e2eSkipClass` (derivada) | environment/requested/unknown | e2e pulou sem dispensa legítima (só `project`). Só no **ship** |
 | `promptModel` | prompt/modelo tocado | Sem nó `evals` declarado, ou eval pulado neste verify. Só no **ship** |
 | `mediaClaims` | seção ausente | Feature que gera mídia, relatório sem `## Mídia gerada`. Só no **ship** |
-| `screenChecklist` | item em aberto | **uiux**: tela sem checklist completo, ou nenhuma `## Tela:`. **ship**: item decidido sem linha em `## Checklist de tela` |
+| `screenChecklist` | item em aberto | **uiux**: tela sem checklist completo, nenhuma `## Tela:`, ou tela sem protótipo e prints 1280/390. **ship**: item decidido sem linha em `## Checklist de tela` |
 | `planChecks` | ≠ `fresh` | `checks.json` ausente ou de outra versão do `plan.md`: rode `plan-check`. Só no **plano**; `approve`/`advance` automáticos recusam |
 | `sliceCount` | > 12 | Plano grande demais para uma feature |
 | `workType` | === 'hotfix' | Gate 3 pausa SEMPRE (ver "Gates por tipo de trabalho") |
@@ -268,7 +268,7 @@ Fail-open: uma poda que falha nunca derruba o comando. PROVE-or-DECLINE como o r
 
 ### claim
 
-**`morph-spec claim [feature] [--release] [--list] [--all] [--json]`** — posse **advisory** de feature. Cada sessão reclama sua feature ativa automaticamente (hook SessionStart) e renova o heartbeat a cada tool call; o registro vive em `<git-common-dir>/morph-spec/claims.json`, compartilhado por todos os worktrees. **`morph-spec claim <feature>` (sem flags) ADQUIRE** — se esta árvore já tinha claim vivo em outra feature, ele é liberado no mesmo passo (o CLI reporta "movido de X para Y"); é o jeito de trocar de feature no meio da tarefa sem a dança de dois passos `--release` + reclamar. `--list` força a leitura sem adquirir mesmo passando uma feature. **Claims avisam, nunca bloqueiam** — mas se o SessionStart avisar que outra sessão tem claim vivo, **confirme antes de `finish`/`archive`/`delete`**: duas sessões na mesma feature já custaram um recap.md inteiro e um sub-agent (o worktree sumiu debaixo dele). Claim órfão de sessão morta: `morph-spec claim <f> --release`. **O board mostra só claims VIVOS** (dentro do TTL de 30 min): um claim morto não avisa mais nada, e deixá-lo listado transformava o quadro em ruído (features encerradas há 20h e 73h ainda aparecendo). `--all` mostra o registro inteiro; a contagem dos omitidos sai no rodapé, nunca em silêncio.
+**`morph-spec claim [feature] [--release] [--list] [--all] [--json]`** — posse **advisory** de feature. Cada sessão reclama sua feature ativa automaticamente (hook SessionStart) e renova o heartbeat a cada tool call; o registro vive em `<git-common-dir>/morph-spec/claims.json`, compartilhado por todos os worktrees. **`morph-spec claim <feature>` (sem flags) ADQUIRE** — se esta árvore já tinha claim vivo em outra feature, ele é liberado no mesmo passo (o CLI reporta "movido de X para Y"); é o jeito de trocar de feature no meio da tarefa sem a dança de dois passos `--release` + reclamar. `--list` força a leitura sem adquirir mesmo passando uma feature. **Claims avisam, nunca bloqueiam** — mas se o SessionStart avisar que outra sessão tem claim vivo, **confirme antes de `finish`/`archive`/`delete`**: duas sessões na mesma feature já custaram o trabalho de uma fatia e um sub-agent (o worktree sumiu debaixo dele). Claim órfão de sessão morta: `morph-spec claim <f> --release`. **O board mostra só claims VIVOS** (dentro do TTL de 30 min): um claim morto não avisa mais nada, e deixá-lo listado transformava o quadro em ruído (features encerradas há 20h e 73h ainda aparecendo). `--all` mostra o registro inteiro; a contagem dos omitidos sai no rodapé, nunca em silêncio.
 
 ## Validação
 
@@ -735,7 +735,7 @@ Falhas do `--show` saem 1: id inexistente (`Standard "<id>" não existe.` com at
 **`--dry-run` prevê sem tocar em nada.** Previsão e execução são o **mesmo percurso**, com os **mesmos filtros** e o **mesmo coletor de efeitos**: em modo normal cada verbo executa *e* registra, em dry apenas registra.
 
 O relatório agrupa por natureza do efeito (apagar, criar diretório, copiar, escrever, mesclar, executar, índice do git) e **nomeia separadamente três grupos que ninguém adivinha da palavra "update"**:
-- **apagados por inteiro antes da reinstalação** — `.claude/{commands,rules,skills,agents}` e `.morph/{framework/standards,framework/hooks,framework/schemas,framework/rubrics,framework/evals,config}`, com a contagem de arquivos que hoje moram em cada um (`framework/rubrics` não é mais instalado: entra na lista só para sumir de instalações antigas);
+- **apagados por inteiro antes da reinstalação** — `.claude/{commands,rules,skills,agents}` e `.morph/{framework/standards,framework/hooks,framework/schemas,framework/evals,config}`, com a contagem de arquivos que hoje moram em cada um;
 - **fora do projeto** — `~/.claude/statusline.sh`, `~/.claude/statusline.py` e a mesclagem de `~/.claude/settings.json`;
 - **dentro do pacote da CLI** — `generate-refs.js` escrevendo `framework/hooks/shared/phase-utils.js` do pacote, que num `npm link` de desenvolvimento é o próprio repositório do framework. Em dry roda a variante `--check`, que verifica e não escreve.
 
@@ -743,17 +743,6 @@ O `--dry-run` **passa por cima** da saída antecipada de "CLI desatualizada": bl
 
 **Freio de major.** Um salto de **dois majors ou mais** é recusado sem `--force`, **antes de qualquer mutação** — recusar depois de mutar é meio-estado. A versão instalada vem de `.morph/.morphversion → morphVersion`, o mesmo registro que o `update` já lê; **nunca** de `config.json → frameworkVersion`, que o `update` escreve e jamais lê para decidir (medido: os dois divergem por um major inteiro num projeto real). Quando os dois discordam, a mensagem imprime **os dois** e diz qual decidiu — escolher em silêncio é acertar metade das vezes e nunca saber qual metade. `.morphversion` ausente ou ilegível é tratado como salto grande, com motivo próprio (`versão instalada indeterminável`) distinto do salto medido: "não sei quão velho isto é" é precisamente quando sobrescrever às cegas é mais perigoso. `--force` dispensa o freio e o relatório final **registra a dispensa**. `--dry-run` combinado com uma recusa **imprime o relatório**, com a recusa como primeiro item.
 
-**Feature em voo no formato anterior.** Antes de qualquer mutação, o `update` varre `.morph/features/` da raiz e de cada worktree que o `git worktree list` conhece; uma feature não encerrada (`status` diferente de `completed`/`abandoned`) com `2-plan/tasks.json` ou `0-proposal/` e sem `2-plan/plan.md` é do formato que esta versão não conduz, e o `update` recusa (exit 1, nada escrito):
-
-```
-Recusado: N feature(s) em voo no formato anterior ao plan.md (proposal/spec/tasks.json), que esta versão não conduz:
-  - <feature> (raiz | <caminho da worktree>)
-  Termine cada uma na 8.47: `npx @polymorphism-tech/morph-spec@8.47 <comando>` (por exemplo `finish <feature> --pr`),
-  ou arquive sem integrar: `morph-spec archive <feature> --force` (o Gate 3 dela não foi aprovado). Depois rode o `update` de novo.
-```
-
-`--force` **não** dispensa esta recusa (o freio de major, sim): a CLI nova não sabe conduzir essas features. Feature em `.morph/archive/` não conta. `--dry-run` põe as mesmas linhas no topo da previsão. A mesma regra roda no `init --force` e no `setup-infra` (inclusive `--reinstall`), que sobrescrevem `.morph/` e `.claude/` sem passar pelo `update`: recusam com as mesmas linhas e saem 1. No retorno programático, `{ refused: true, reason: 'old-format-features', features }`.
-
 **Por quê.** Não há travessia paralela — o resumo de uma execução real também sai do coletor, de modo que um ponto de emissão esquecido some das duas saídas ao mesmo tempo, em vez de mentir só no `--dry-run`.
 
 ## Grafo de codebase
@@ -810,7 +799,7 @@ O servidor MCP (`graphify-mcp`, 10 tools, todas aceitando `project_path`) está
 
 ### cost
 
-**`morph-spec cost [feature] [--by phase] [--all-trees] [--json]`** — custo da execução a partir do mesmo `events.jsonl`: bytes de contexto lidos por tipo (`rubric`/`standard`/`skill`/`agents`/`plan-artifact`/`code` — a janela `offset`/`limit` que o Read trouxe, quando o evento a tem), dispatches + tamanho de prompt e mix de tools. Bytes são **proxy determinística** de custo de token; os tokens reais vêm à parte: `SessionUsage` (sessão principal) e `AgentUsage` (cada sub-agent, lido do transcript dele), somados **só pelo `delta`** de cada amostra — o total de topo é acumulado e se repete a cada Stop, e amostra antiga sem `delta` fica fora da soma e é contada como legada. `--all-trees` agrega **toda árvore git** com log, mais os logs que o `finish` guardou em `.git/morph-spec/finish-backup/` antes de desmontar a worktree, deduplicados por `eventId`.
+**`morph-spec cost [feature] [--by phase] [--all-trees] [--json]`** — custo da execução a partir do mesmo `events.jsonl`: bytes de contexto lidos por tipo (`checklist`/`standard`/`skill`/`agents`/`plan-artifact`/`code` — a janela `offset`/`limit` que o Read trouxe, quando o evento a tem), dispatches + tamanho de prompt e mix de tools. Bytes são **proxy determinística** de custo de token; os tokens reais vêm à parte: `SessionUsage` (sessão principal) e `AgentUsage` (cada sub-agent, lido do transcript dele), somados **só pelo `delta`** de cada amostra — o total de topo é acumulado e se repete a cada Stop, e amostra antiga sem `delta` fica fora da soma e é contada como legada. `--all-trees` agrega **toda árvore git** com log, mais os logs que o `finish` guardou em `.git/morph-spec/finish-backup/` antes de desmontar a worktree, deduplicados por `eventId`.
 
 ### cost --metrics