@polymorphism-tech/morph-spec 9.1.0 → 9.3.0

package/framework/templates/ui/design-system.css

@@ -1,226 +1,226 @@
-/**
- * Design System - {Project Name}
- *
- * CSS Variables generated from design-system.md
- * Use estas variáveis em todo o projeto para manter consistência visual.
- *
- * Template MORPH-SPEC by Polymorphism Tech
- */
-
-:root {
-  /* ========================================
-   * CORES PRINCIPAIS
-   * ======================================== */
-
-  --color-primary: #{hex da cor primária};
-  --color-primary-hover: #{hex da cor primária mais escura};
-  --color-primary-active: #{hex da cor primária ainda mais escura};
-
-  --color-secondary: #{hex da cor secundária};
-  --color-secondary-hover: #{hex};
-  --color-secondary-active: #{hex};
-
-  /* ========================================
-   * CORES DE ESTADO
-   * ======================================== */
-
-  --color-success: #{hex};
-  --color-success-bg: #{hex com transparência ou shade mais claro};
-  --color-success-border: #{hex};
-
-  --color-error: #{hex};
-  --color-error-bg: #{hex};
-  --color-error-border: #{hex};
-
-  --color-warning: #{hex};
-  --color-warning-bg: #{hex};
-  --color-warning-border: #{hex};
-
-  --color-info: #{hex};
-  --color-info-bg: #{hex};
-  --color-info-border: #{hex};
-
-  /* ========================================
-   * ESCALA DE NEUTROS (Cinzas)
-   * ======================================== */
-
-  --color-gray-50: #{hex};
-  --color-gray-100: #{hex};
-  --color-gray-200: #{hex};
-  --color-gray-300: #{hex};
-  --color-gray-400: #{hex};
-  --color-gray-500: #{hex};
-  --color-gray-600: #{hex};
-  --color-gray-700: #{hex};
-  --color-gray-800: #{hex};
-  --color-gray-900: #{hex};
-
-  /* ========================================
-   * TIPOGRAFIA - FONTES
-   * ======================================== */
-
-  --font-sans: '{Font Name}', -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif;
-  --font-serif: '{Font Name}', Georgia, 'Times New Roman', serif;
-  --font-mono: '{Font Name}', 'Fira Code', 'Courier New', Consolas, monospace;
-
-  /* ========================================
-   * TIPOGRAFIA - TAMANHOS
-   * ======================================== */
-
-  --text-xs: 0.75rem;      /* 12px */
-  --text-sm: 0.875rem;     /* 14px */
-  --text-base: 1rem;       /* 16px */
-  --text-lg: 1.125rem;     /* 18px */
-  --text-xl: 1.25rem;      /* 20px */
-  --text-2xl: 1.5rem;      /* 24px */
-  --text-3xl: 1.875rem;    /* 30px */
-  --text-4xl: 2.25rem;     /* 36px */
-  --text-5xl: 3rem;        /* 48px */
-
-  /* ========================================
-   * TIPOGRAFIA - LINE HEIGHTS
-   * ======================================== */
-
-  --leading-none: 1;
-  --leading-tight: 1.25;
-  --leading-snug: 1.375;
-  --leading-normal: 1.5;
-  --leading-relaxed: 1.625;
-  --leading-loose: 2;
-
-  /* ========================================
-   * TIPOGRAFIA - FONT WEIGHTS
-   * ======================================== */
-
-  --font-light: 300;
-  --font-regular: 400;
-  --font-medium: 500;
-  --font-semibold: 600;
-  --font-bold: 700;
-  --font-extrabold: 800;
-
-  /* ========================================
-   * ESPAÇAMENTO
-   * Baseado em múltiplos de {base}px (ex: 4px)
-   * ======================================== */
-
-  --space-0: 0;
-  --space-1: 0.25rem;   /* 4px */
-  --space-2: 0.5rem;    /* 8px */
-  --space-3: 0.75rem;   /* 12px */
-  --space-4: 1rem;      /* 16px */
-  --space-5: 1.25rem;   /* 20px */
-  --space-6: 1.5rem;    /* 24px */
-  --space-7: 1.75rem;   /* 28px */
-  --space-8: 2rem;      /* 32px */
-  --space-10: 2.5rem;   /* 40px */
-  --space-12: 3rem;     /* 48px */
-  --space-16: 4rem;     /* 64px */
-  --space-20: 5rem;     /* 80px */
-  --space-24: 6rem;     /* 96px */
-
-  /* ========================================
-   * BORDER RADIUS
-   * ======================================== */
-
-  --rounded-none: 0;
-  --rounded-sm: 0.125rem;   /* 2px */
-  --rounded-md: 0.375rem;   /* 6px */
-  --rounded-lg: 0.5rem;     /* 8px */
-  --rounded-xl: 0.75rem;    /* 12px */
-  --rounded-2xl: 1rem;      /* 16px */
-  --rounded-full: 9999px;
-
-  /* ========================================
-   * SOMBRAS (Shadows)
-   * ======================================== */
-
-  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
-  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
-  --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
-  --shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
-  --shadow-2xl: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
-
-  /* ========================================
-   * Z-INDEX LAYERS
-   * ======================================== */
-
-  --z-0: 0;
-  --z-10: 10;
-  --z-20: 20;
-  --z-30: 30;
-  --z-40: 40;
-  --z-50: 50;      /* Modals, dropdowns */
-  --z-100: 100;    /* Tooltips */
-  --z-max: 9999;   /* Toasts, notifications */
-
-  /* ========================================
-   * TRANSITIONS / ANIMATIONS
-   * ======================================== */
-
-  --transition-fast: 150ms ease-in-out;
-  --transition-base: 250ms ease-in-out;
-  --transition-slow: 350ms ease-in-out;
-
-  --ease-in: cubic-bezier(0.4, 0, 1, 1);
-  --ease-out: cubic-bezier(0, 0, 0.2, 1);
-  --ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
-
-  /* ========================================
-   * BREAKPOINTS (informativo - usar em media queries)
-   * ======================================== */
-
-  /* @media (min-width: 640px) - sm */
-  /* @media (min-width: 768px) - md */
-  /* @media (min-width: 1024px) - lg */
-  /* @media (min-width: 1280px) - xl */
-  /* @media (min-width: 1536px) - 2xl */
-}
-
-/* ========================================
- * MODO ESCURO (Dark Mode)
- * Opcional - ajuste as cores para dark theme
- * ======================================== */
-
-@media (prefers-color-scheme: dark) {
-  :root {
-    /* Inverter cores conforme necessário */
-    --color-gray-50: #{hex do gray-900};
-    --color-gray-900: #{hex do gray-50};
-    /* ... outras inversões */
-  }
-}
-
-/* ========================================
- * CLASSES UTILITÁRIAS (Exemplo)
- * ======================================== */
-
-/* Exemplo de uso das variáveis */
-.btn-primary {
-  background-color: var(--color-primary);
-  color: white;
-  padding: var(--space-2) var(--space-4);
-  border-radius: var(--rounded-md);
-  font-weight: var(--font-semibold);
-  transition: background-color var(--transition-base);
-}
-
-.btn-primary:hover {
-  background-color: var(--color-primary-hover);
-}
-
-.card {
-  background-color: white;
-  padding: var(--space-6);
-  border-radius: var(--rounded-lg);
-  box-shadow: var(--shadow-md);
-}
-
-.text-muted {
-  color: var(--color-gray-600);
-  font-size: var(--text-sm);
-}
-
-/* ========================================
- * FIM DO DESIGN SYSTEM
- * ======================================== */
+/**
+ * Design System - {Project Name}
+ *
+ * CSS Variables generated from design-system.md
+ * Use estas variáveis em todo o projeto para manter consistência visual.
+ *
+ * Template MORPH-SPEC by Polymorphism Tech
+ */
+
+:root {
+  /* ========================================
+   * CORES PRINCIPAIS
+   * ======================================== */
+
+  --color-primary: #{hex da cor primária};
+  --color-primary-hover: #{hex da cor primária mais escura};
+  --color-primary-active: #{hex da cor primária ainda mais escura};
+
+  --color-secondary: #{hex da cor secundária};
+  --color-secondary-hover: #{hex};
+  --color-secondary-active: #{hex};
+
+  /* ========================================
+   * CORES DE ESTADO
+   * ======================================== */
+
+  --color-success: #{hex};
+  --color-success-bg: #{hex com transparência ou shade mais claro};
+  --color-success-border: #{hex};
+
+  --color-error: #{hex};
+  --color-error-bg: #{hex};
+  --color-error-border: #{hex};
+
+  --color-warning: #{hex};
+  --color-warning-bg: #{hex};
+  --color-warning-border: #{hex};
+
+  --color-info: #{hex};
+  --color-info-bg: #{hex};
+  --color-info-border: #{hex};
+
+  /* ========================================
+   * ESCALA DE NEUTROS (Cinzas)
+   * ======================================== */
+
+  --color-gray-50: #{hex};
+  --color-gray-100: #{hex};
+  --color-gray-200: #{hex};
+  --color-gray-300: #{hex};
+  --color-gray-400: #{hex};
+  --color-gray-500: #{hex};
+  --color-gray-600: #{hex};
+  --color-gray-700: #{hex};
+  --color-gray-800: #{hex};
+  --color-gray-900: #{hex};
+
+  /* ========================================
+   * TIPOGRAFIA - FONTES
+   * ======================================== */
+
+  --font-sans: '{Font Name}', -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', sans-serif;
+  --font-serif: '{Font Name}', Georgia, 'Times New Roman', serif;
+  --font-mono: '{Font Name}', 'Fira Code', 'Courier New', Consolas, monospace;
+
+  /* ========================================
+   * TIPOGRAFIA - TAMANHOS
+   * ======================================== */
+
+  --text-xs: 0.75rem;      /* 12px */
+  --text-sm: 0.875rem;     /* 14px */
+  --text-base: 1rem;       /* 16px */
+  --text-lg: 1.125rem;     /* 18px */
+  --text-xl: 1.25rem;      /* 20px */
+  --text-2xl: 1.5rem;      /* 24px */
+  --text-3xl: 1.875rem;    /* 30px */
+  --text-4xl: 2.25rem;     /* 36px */
+  --text-5xl: 3rem;        /* 48px */
+
+  /* ========================================
+   * TIPOGRAFIA - LINE HEIGHTS
+   * ======================================== */
+
+  --leading-none: 1;
+  --leading-tight: 1.25;
+  --leading-snug: 1.375;
+  --leading-normal: 1.5;
+  --leading-relaxed: 1.625;
+  --leading-loose: 2;
+
+  /* ========================================
+   * TIPOGRAFIA - FONT WEIGHTS
+   * ======================================== */
+
+  --font-light: 300;
+  --font-regular: 400;
+  --font-medium: 500;
+  --font-semibold: 600;
+  --font-bold: 700;
+  --font-extrabold: 800;
+
+  /* ========================================
+   * ESPAÇAMENTO
+   * Baseado em múltiplos de {base}px (ex: 4px)
+   * ======================================== */
+
+  --space-0: 0;
+  --space-1: 0.25rem;   /* 4px */
+  --space-2: 0.5rem;    /* 8px */
+  --space-3: 0.75rem;   /* 12px */
+  --space-4: 1rem;      /* 16px */
+  --space-5: 1.25rem;   /* 20px */
+  --space-6: 1.5rem;    /* 24px */
+  --space-7: 1.75rem;   /* 28px */
+  --space-8: 2rem;      /* 32px */
+  --space-10: 2.5rem;   /* 40px */
+  --space-12: 3rem;     /* 48px */
+  --space-16: 4rem;     /* 64px */
+  --space-20: 5rem;     /* 80px */
+  --space-24: 6rem;     /* 96px */
+
+  /* ========================================
+   * BORDER RADIUS
+   * ======================================== */
+
+  --rounded-none: 0;
+  --rounded-sm: 0.125rem;   /* 2px */
+  --rounded-md: 0.375rem;   /* 6px */
+  --rounded-lg: 0.5rem;     /* 8px */
+  --rounded-xl: 0.75rem;    /* 12px */
+  --rounded-2xl: 1rem;      /* 16px */
+  --rounded-full: 9999px;
+
+  /* ========================================
+   * SOMBRAS (Shadows)
+   * ======================================== */
+
+  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+  --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+  --shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
+  --shadow-2xl: 0 25px 50px -12px rgba(0, 0, 0, 0.25);
+
+  /* ========================================
+   * Z-INDEX LAYERS
+   * ======================================== */
+
+  --z-0: 0;
+  --z-10: 10;
+  --z-20: 20;
+  --z-30: 30;
+  --z-40: 40;
+  --z-50: 50;      /* Modals, dropdowns */
+  --z-100: 100;    /* Tooltips */
+  --z-max: 9999;   /* Toasts, notifications */
+
+  /* ========================================
+   * TRANSITIONS / ANIMATIONS
+   * ======================================== */
+
+  --transition-fast: 150ms ease-in-out;
+  --transition-base: 250ms ease-in-out;
+  --transition-slow: 350ms ease-in-out;
+
+  --ease-in: cubic-bezier(0.4, 0, 1, 1);
+  --ease-out: cubic-bezier(0, 0, 0.2, 1);
+  --ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
+
+  /* ========================================
+   * BREAKPOINTS (informativo - usar em media queries)
+   * ======================================== */
+
+  /* @media (min-width: 640px) - sm */
+  /* @media (min-width: 768px) - md */
+  /* @media (min-width: 1024px) - lg */
+  /* @media (min-width: 1280px) - xl */
+  /* @media (min-width: 1536px) - 2xl */
+}
+
+/* ========================================
+ * MODO ESCURO (Dark Mode)
+ * Opcional - ajuste as cores para dark theme
+ * ======================================== */
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    /* Inverter cores conforme necessário */
+    --color-gray-50: #{hex do gray-900};
+    --color-gray-900: #{hex do gray-50};
+    /* ... outras inversões */
+  }
+}
+
+/* ========================================
+ * CLASSES UTILITÁRIAS (Exemplo)
+ * ======================================== */
+
+/* Exemplo de uso das variáveis */
+.btn-primary {
+  background-color: var(--color-primary);
+  color: white;
+  padding: var(--space-2) var(--space-4);
+  border-radius: var(--rounded-md);
+  font-weight: var(--font-semibold);
+  transition: background-color var(--transition-base);
+}
+
+.btn-primary:hover {
+  background-color: var(--color-primary-hover);
+}
+
+.card {
+  background-color: white;
+  padding: var(--space-6);
+  border-radius: var(--rounded-lg);
+  box-shadow: var(--shadow-md);
+}
+
+.text-muted {
+  color: var(--color-gray-600);
+  font-size: var(--text-sm);
+}
+
+/* ========================================
+ * FIM DO DESIGN SYSTEM
+ * ======================================== */

package/package.json

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

package/src/commands/observability/cost.js

@@ -145,6 +145,18 @@ function printMetricsBody(m) {
     ? trees.map(([tree, s]) => `${tree} rodou ${s.ran}, pulou ${s.skipped}`).join(' · ')
     : 'nenhum evento Verify na janela'}`);
   for (const [reason, n] of Object.entries(m.reuse.skipReasons)) console.log(chalk.gray(`    pulou ${n}×: ${reason}`));
+  const gates = Object.entries(m.gates);
+  if (!gates.length) {
+    console.log('  gates: nenhum evento Gate na janela');
+    return;
+  }
+  for (const [gate, g] of gates) {
+    console.log(`  gate ${gate}: ${g.decisions} decisões, ${g.paused} pausas → ${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`));
+    }
+  }
 }
 
 function printMetrics(feature, options, cwd) {

package/src/commands/project/status.js

@@ -1,6 +1,8 @@
 import chalk from 'chalk';
 import { loadState, getFeature, derivePhase, deriveOutputs } from '../../core/state/state-manager.js';
 import { sliceProgress } from '../../../framework/hooks/shared/slice-progress.js';
+import { formatNext } from '../../../framework/hooks/shared/next-step.js';
+import { nextStepFor } from '../../lib/next-step.js';
 
 const PHASE_SYMBOLS = {
   completed: '✅',
@@ -87,60 +89,6 @@ function calculateCompletionPercentage(feature) {
   return Math.round((completedPhases / totalPhases) * 100);
 }
 
-function getNextSteps(feature) {
-  const steps = [];
-
-  const phaseApprovalMap = {
-    plan: 'plan',
-    uiux: 'uiux',
-    implement: 'plan',
-    review: 'review'
-  };
-
-  const relevantGate = phaseApprovalMap[feature.phase];
-  const approvalGates = feature.approvalGates || {};
-
-  if (relevantGate && approvalGates[relevantGate] && !approvalGates[relevantGate].approved) {
-    steps.push({
-      type: 'approval',
-      message: `Approve ${relevantGate} to advance`,
-      command: `morph-spec approve ${feature.name || 'feature'} ${relevantGate}`
-    });
-  }
-
-  const requiredOutputs = feature.phase === 'uiux' ? [] : PHASE_OUTPUTS[feature.phase] || [];
-  const missingOutputs = requiredOutputs.filter(o => !feature.outputs[o]?.created);
-
-  if (missingOutputs.length > 0) {
-    steps.push({
-      type: 'output',
-      message: `Create missing outputs: ${missingOutputs.join(', ')}`,
-      command: null
-    });
-  }
-
-  const hasApprovalPending = relevantGate && approvalGates[relevantGate] && !approvalGates[relevantGate].approved;
-  if (missingOutputs.length === 0 && !hasApprovalPending) {
-    const currentPhaseIndex = PHASE_ORDER.findIndex(p => p.key === feature.phase);
-    if (currentPhaseIndex >= 0 && currentPhaseIndex < PHASE_ORDER.length - 1) {
-      const nextPhase = PHASE_ORDER[currentPhaseIndex + 1];
-      steps.push({
-        type: 'advance',
-        message: `Advance to ${nextPhase.name}`,
-        command: `morph-spec phase advance ${feature.name || 'feature'}`
-      });
-    } else if (currentPhaseIndex === PHASE_ORDER.length - 1) {
-      steps.push({
-        type: 'complete',
-        message: 'Feature complete! Consider archiving.',
-        command: null
-      });
-    }
-  }
-
-  return steps;
-}
-
 export async function statusCommand(featureName, options = {}) {
   if (!featureName) {
     console.error(chalk.red('✗ Error: Feature name required'));
@@ -191,7 +139,7 @@ export async function statusCommand(featureName, options = {}) {
       })),
       slices,
       approvals: feature.approvalGates || {},
-      nextSteps: getNextSteps(feature)
+      next: nextStepFor(featureName, process.cwd())
     };
 
     console.log(JSON.stringify(status, null, 2));
@@ -235,6 +183,7 @@ export async function statusCommand(featureName, options = {}) {
     console.log(`  Total: ${slices.total}`);
     console.log(chalk.green(`  ✓ Feitas: ${slices.done} (${percentage}%)`));
     if (slices.partial > 0) console.log(chalk.cyan(`  ▶ Parciais: ${slices.partial}`));
+    if (slices.blocked > 0) console.log(chalk.yellow(`  ⏸ Bloqueadas (esperam decisão): ${slices.blocked}`));
     if (slices.pending > 0) console.log(chalk.gray(`  ⬜ Pendentes: ${slices.pending}`));
     console.log('');
   }
@@ -258,19 +207,8 @@ export async function statusCommand(featureName, options = {}) {
     console.log('');
   }
 
-  const nextSteps = getNextSteps(feature);
-  if (nextSteps.length > 0) {
-    console.log(chalk.white.bold('Next Steps:'));
-    nextSteps.forEach((step, index) => {
-      console.log(chalk.yellow(`  ${index + 1}. ${step.message}`));
-      if (step.command) {
-        console.log(chalk.gray(`     → ${step.command}`));
-      }
-    });
-    console.log('');
-  } else {
-    console.log(chalk.green('✓ Nada pendente.\n'));
-  }
+  const next = nextStepFor(featureName, process.cwd());
+  if (next) console.log(chalk.yellow(`${formatNext(next)}\n`));
 
   console.log(chalk.gray('─'.repeat(60)));
   console.log(chalk.gray('Run with --verbose for detailed output'));

package/src/commands/state/advance.js

@@ -143,7 +143,7 @@ export async function advanceCommand(featureName, options = {}) {
         process.exit(1);
       }
 
-      console.error(chalk.red(`\n❌ A fase "${phase}" não pode ser encerrada — artefato(s) obrigatório(s) ausente(s) ou PARCIAL:`));
+      console.error(chalk.red(`\n❌ A fase "${phase}" não pode ser encerrada — artefato(s) obrigatório(s) ausente(s), PARCIAL ou BLOQUEADO:`));
       for (const rel of missingArtifacts) console.error(chalk.gray(`   • ${rel}`));
       console.error(chalk.gray('\n   Produza o artefato e rode de novo, ou passe --force para avançar assim mesmo.\n'));
       process.exit(1);

package/src/commands/state/approve.js

@@ -19,10 +19,10 @@ export { REVIEWED_SHA_TOKEN };
 
 const SIGNED_OFF = { required: [], reports: {}, checks: { status: 'ok', total: 0, missing: [], notProven: [] } };
 
-// The worst answer across every report present wins. `skip` (no verifier report, no git) never
+// The worst answer across every report present wins. `skip` (no report at all, no git) never
 // refuses falsely.
 function reviewStaleness(reports) {
-  if (reports.verifier.status === 'missing') return { status: 'skip' };
+  if (Object.values(reports).every((r) => r.status === 'missing')) return { status: 'skip' };
   const cwd = process.cwd();
   let head;
   try {

package/src/commands/state/gate-check.js

@@ -189,10 +189,10 @@ export async function gateCheckCommand(featureName, gateName, options = {}) {
     const computed = shouldPauseGate({ trust }, signals);
     const manual = feature.gateDecisions?.[gateName];
     const manualPause = manual?.source === 'manual' && manual.pause === true;
-    const { pause, reason } = manualPause ? { pause: true, reason: manual.reason } : computed;
+    const { pause, reason, signal } = manualPause ? { pause: true, reason: manual.reason, signal: 'manual' } : computed;
 
     const entry = await persistGateDecision(featureName, gateName, {
-      pause, reason, signals, trust, cwd, source: manualPause ? 'manual' : 'gate-check',
+      pause, reason, signal, signals, trust, cwd, source: manualPause ? 'manual' : 'gate-check',
     });
 
     if (options.json) {

package/src/commands/state/gate-decision.js

@@ -4,6 +4,7 @@ import { join } from 'path';
 import { getFeature, updateFeature } from '../../core/state/state-manager.js';
 import { assertOwnerTree, ownerTreeRefusalLines } from '../../lib/worktree/feature-truth.js';
 import { mockupsHash } from '../../lib/specs/screen-checklist.js';
+import { recordGateEvent } from '../../../framework/hooks/shared/gate-event.js';
 
 export const VALID_GATES = ['plan', 'uiux', 'review'];
 
@@ -31,7 +32,7 @@ export function readTrustFromConfig() {
  * The ONE write path of `gateDecisions.{gate}`, shared by `gate-decision` and `gate-check`.
  * Does not validate `gateName`. A uiux decision records the `mockupsHash` it saw.
  */
-export async function persistGateDecision(featureName, gateName, { pause, reason, signals = {}, trust, cwd = process.cwd(), source } = {}) {
+export async function persistGateDecision(featureName, gateName, { pause, reason, signal, signals = {}, trust, cwd = process.cwd(), source } = {}) {
   const entry = {
     pause,
     reason: reason || (pause ? 'risco detectado' : 'nenhum sinal de risco'),
@@ -43,6 +44,7 @@ export async function persistGateDecision(featureName, gateName, { pause, reason
   };
 
   await updateFeature(featureName, `gateDecisions.${gateName}`, entry);
+  recordGateEvent(cwd, { feature: featureName, gate: gateName, step: 'decision', pause, signal, source });
   return entry;
 }
 
@@ -91,6 +93,7 @@ export async function gateDecisionCommand(featureName, gateName, options = {}) {
     const entry = await persistGateDecision(featureName, gateName, {
       pause,
       reason: options.reason,
+      signal: 'manual',
       signals,
       trust: options.trust,
       source: 'manual',