@polymorphism-tech/morph-spec 9.2.0 → 9.3.0

package/framework/hooks/claude-code/core/worktree-context.js

@@ -10,6 +10,7 @@ import {
   getPendingGates,
 } from '../../shared/state-reader.js';
 import { sliceProgress } from '../../shared/slice-progress.js';
+import { collectNextSignals, decideNext, formatNext } from '../../shared/next-step.js';
 import { contextResult, runStandalone } from '../../shared/hook-response.js';
 import { acquireClaim, foreignClaim, claimAge } from '../../shared/claim-registry.js';
 import { rotateActivityLogIfLarge } from '../../shared/activity-logger.js';
@@ -133,11 +134,31 @@ function buildHandoffLine(dir, feature) {
   }
 }
 
+// No git here, so verify staleness is unknown: an escalation the tree already moved past, or the
+// root skeleton of a feature living in a worktree, would be an order read from stale facts.
+function buildNextLine(dir, feature) {
+  try {
+    const signals = collectNextSignals(feature, dir);
+    if (!signals) return null;
+    if (signals.worktreePath && !samePath(resolve(signals.worktreePath), resolve(dir))) {
+      return `▶ ${feature} vive no worktree ${signals.worktreePath}: abra a sessão lá (aqui é o esqueleto de nascimento).`;
+    }
+    const next = decideNext(signals);
+    if (next.action === 'escalate') return `▶ verify vermelho de novo: rode \`morph-spec next ${feature}\` antes de agir.`;
+    return `▶ ${formatNext(next)} (confirme com \`morph-spec next ${feature}\` depois de mudar a árvore)`;
+  } catch {
+    return null;
+  }
+}
+
 function buildWorktreeContext(dir, feature) {
   const phase = getFeaturePhase(feature, dir);
   let text = `🌳 Worktree desta feature: ${feature} (branch morph/${feature}, fase ${phase}). ` +
     `Trabalhe apenas nesta feature nesta sessão; o estado vive no .morph/ deste worktree.`;
 
+  const nextLine = buildNextLine(dir, feature);
+  if (nextLine) text += `\n${nextLine}`;
+
   const envLine = buildEnvLine(dir);
   if (envLine) text += `\n${envLine}`;
 
@@ -173,6 +194,8 @@ function buildActiveFeatureSummary(dir) {
   if (pending.length) {
     text += ` · gates pendentes: ${pending.join(', ')}`;
   }
+  const nextLine = buildNextLine(dir, active.name);
+  if (nextLine) text += `\n${nextLine}`;
   return text;
 }
 

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

@@ -390,13 +390,14 @@ def derive_phase(feature_dir, gates):
 
 
 PARTIAL_MARKER = re.compile(r'^[\s#>*_]*PARCIAL\b')
+BLOCKED_MARKER = re.compile(r'^[\s#>*_]*BLOQUEADO\b')
 
 
 def count_slices(feature_dir):
     """(done, total) of the slices in 2-plan/checks.json.
 
     Same rule as framework/hooks/shared/slice-progress.js: a slice is done when
-    3-implement/reports/{id}.md exists and its first line is not PARCIAL.
+    3-implement/reports/{id}.md exists and its first line is neither PARCIAL nor BLOQUEADO.
     """
     try:
         slices = json.loads((feature_dir / '2-plan' / 'checks.json').read_text(encoding='utf-8')).get('slices')
@@ -412,7 +413,7 @@ def count_slices(feature_dir):
         except Exception:
             continue
         first = next((line for line in text.splitlines() if line.strip()), '')
-        if not PARTIAL_MARKER.match(first):
+        if not PARTIAL_MARKER.match(first) and not BLOCKED_MARKER.match(first):
             done += 1
     return done, len(ids)
 

package/framework/hooks/shared/gate-event.js

@@ -0,0 +1,18 @@
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { appendTelemetryEvent } from './telemetry-logger.js';
+
+export const GATE_EVENT = 'Gate';
+export const GATE_STEPS = ['decision', 'approve', 'unapprove'];
+
+/**
+ * The trail `cost --metrics` turns into "what did the human do with each pause":
+ * `gateDecisions` keeps only the latest decision, so the history lives here.
+ */
+export function recordGateEvent(projectPath, { feature, gate, step, pause, signal, source, approvedBy }) {
+  if (!existsSync(join(projectPath || process.cwd(), '.morph'))) return;
+  const event = { event: GATE_EVENT, feature, gate, step };
+  if (step === 'decision') Object.assign(event, { pause: pause === true, signal: signal ?? null, source: source ?? null });
+  else event.approvedBy = approvedBy ?? null;
+  appendTelemetryEvent(event, projectPath);
+}

package/framework/hooks/shared/next-step.js

@@ -0,0 +1,107 @@
+// The single rule of "what the session does next". `decideNext` is pure: collectors feed facts.
+// Hooks and the CLI share it so the SessionStart pre-fetch and `morph-spec next` never disagree.
+
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { derivePhaseForFeature } from './state-reader.js';
+import { sliceProgress, readySlices } from './slice-progress.js';
+
+export const FIX_ATTEMPTS = 3;
+
+const step = (action, command, reason, extra = {}) => ({ action, command, reason, ...extra });
+
+/**
+ * @param {{ feature: string, phase: string, slices: object|null, gates: object,
+ *   verification: { status?: string }|null, verificationStale?: boolean, failStreak?: number }} s
+ * `verificationStale` undefined = unknown (the hook has no git): read as fresh.
+ */
+export function decideNext(s) {
+  const f = s.feature;
+  const approved = (g) => s.gates?.[g]?.approved === true;
+  // The hotfix pipeline (scout, human approval, ship) lives in its own skill, end to end.
+  const skill = (name) => (s.workType === 'hotfix' ? `/morph-hotfix ${f}` : `/${name} ${f}`);
+
+  switch (s.phase) {
+    case 'plan':
+      return s.slices
+        ? step('gate', `morph-spec gate-check ${f} plan`, 'plano extraído: o gate do plano decide a pausa')
+        : step('plan', `/morph-plan ${f}`, 'sem checks.json: escreva o plan.md e rode plan-check até zero erro');
+
+    case 'uiux':
+      return step('design', `morph-spec gate-check ${f} uiux`, 'complete 1-design/ (morph-uiux) e passe o gate de uiux');
+
+    case 'implement': {
+      if (!s.slices) return step('plan', skill('morph-plan'), 'sem checks.json: plan.md curto (uma fatia) e plan-check até zero erro');
+      if (s.slices.done < s.slices.total) {
+        const ready = readySlices(s.slices);
+        if (!ready.length) {
+          const waiting = s.slices.slices.filter((sl) => sl.status === 'bloqueado').map((sl) => sl.id);
+          if (waiting.length) {
+            return step('decide', 'AskUserQuestion (decisão da fatia)',
+              'relatório BLOQUEADO: decida pelo plano/ADR ou pergunte, e retome o MESMO agente com a resposta — nunca re-despache',
+              { slices: waiting });
+          }
+          return step('blocked', `morph-spec report-check ${f}`, 'fatias pendentes sem dependência satisfeita');
+        }
+        const partial = ready.filter((sl) => sl.status === 'parcial').map((sl) => sl.id);
+        return step('dispatch', skill('morph-apply'),
+          partial.length ? `retome ${partial.join(', ')} (PARCIAL) e despache as prontas` : 'despache as fatias prontas',
+          { slices: ready.map((sl) => sl.id) });
+      }
+      const v = s.verification;
+      if (!v?.status || s.verificationStale === true) {
+        return step('verify', `morph-spec verify ${f}`, v?.status ? 'a árvore andou desde o último verify' : 'todas as fatias relatadas, sem verify');
+      }
+      if (v.status === 'fail') {
+        const streak = s.failStreak ?? 0;
+        if (streak > 0 && streak % FIX_ATTEMPTS === 0) {
+          return step('escalate', 'AskUserQuestion (aceitar/continuar/parar)',
+            `${streak} verifies vermelhos seguidos, nunca uma tentativa a mais por conta própria. `
+            + `aceitar → ${skill('morph-review')} (o verify vermelho pausa o gate: o humano assina lá); `
+            + 'continuar → corrija e rode o verify de novo; parar → encerre aqui. Segue `escalate` até a árvore andar');
+        }
+        return step('fix', `morph-spec verify ${f}`,
+          `corrija pelo feedback do verify e rode de novo (${FIX_ATTEMPTS - (streak % FIX_ATTEMPTS)} tentativa(s) antes de perguntar)`);
+      }
+      return step('review', skill('morph-review'), 'verify verde: Gate 3');
+    }
+
+    case 'review':
+      return approved('review')
+        ? step('finish', `morph-spec finish ${f} --pr|--merge`, 'Gate 3 aprovado: arquiva e integra num passo')
+        : step('review', skill('morph-review'), 'relatórios do Gate 3 e gate-check review');
+
+    default:
+      return step('status', `morph-spec status ${f}`, `fase desconhecida: ${s.phase ?? '—'}`);
+  }
+}
+
+export function formatNext(n) {
+  const slices = n.slices?.length ? ` [${n.slices.join(', ')}]` : '';
+  return `próximo: ${n.action}${slices} → ${n.command} — ${n.reason}`;
+}
+
+/** Facts readable from `hooks/shared`; the CLI adds `verificationStale` (git) on top. Null without feature.json. */
+export function collectNextSignals(featureName, cwd) {
+  const featureDir = join(cwd, '.morph', 'features', featureName);
+  let feature;
+  try {
+    const path = join(featureDir, 'feature.json');
+    if (!existsSync(path)) return null;
+    feature = JSON.parse(readFileSync(path, 'utf8').replace(/^/, ''));
+  } catch {
+    return null;
+  }
+  let phase = 'plan';
+  try { phase = derivePhaseForFeature(featureName, cwd) || 'plan'; } catch {}
+  return {
+    feature: featureName,
+    workType: feature.workType ?? 'feature',
+    worktreePath: feature.worktree?.path ?? null,
+    phase,
+    slices: sliceProgress(featureDir),
+    gates: feature.approvals || feature.approvalGates || {},
+    verification: feature.verification ?? null,
+    failStreak: feature.verifications?.feature?.failStreak ?? 0,
+  };
+}

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

@@ -4,7 +4,10 @@ import { join } from 'path';
 /** `PARCIAL` on the report's first non-blank line, tolerating heading/bold/quote typography. */
 export const PARTIAL_MARKER = /^[\s#>*_]*PARCIAL\b/;
 
-export const SLICE_STATUSES = ['pendente', 'parcial', 'feito'];
+/** `BLOQUEADO`: the slice waits on a decision only the human can make; re-dispatching it repeats the question. */
+export const BLOCKED_MARKER = /^[\s#>*_]*BLOQUEADO\b/;
+
+export const SLICE_STATUSES = ['pendente', 'parcial', 'bloqueado', 'feito'];
 
 export function checksPath(featureDir) {
   return join(featureDir, '2-plan', 'checks.json');
@@ -17,10 +20,11 @@ export function sliceReportPath(featureDir, sliceId) {
 export function sliceStatusFromReport(text) {
   if (text == null) return 'pendente';
   const first = String(text).split(/\r?\n/).find((l) => l.trim() !== '') ?? '';
+  if (BLOCKED_MARKER.test(first)) return 'bloqueado';
   return PARTIAL_MARKER.test(first) ? 'parcial' : 'feito';
 }
 
-/** @returns {{ total, done, partial, pending, slices } | null} null when the checks text is unreadable */
+/** @returns {{ total, done, partial, blocked, pending, slices } | null} null when the checks text is unreadable */
 export function sliceProgressFrom(checksText, readReport) {
   let slices;
   try {
@@ -39,7 +43,14 @@ export function sliceProgressFrom(checksText, readReport) {
       status: sliceStatusFromReport(readReport(s.id)),
     }));
   const count = (status) => out.filter((s) => s.status === status).length;
-  return { total: out.length, done: count('feito'), partial: count('parcial'), pending: count('pendente'), slices: out };
+  return {
+    total: out.length,
+    done: count('feito'),
+    partial: count('parcial'),
+    blocked: count('bloqueado'),
+    pending: count('pendente'),
+    slices: out,
+  };
 }
 
 function readOrNull(path) {
@@ -57,7 +68,7 @@ export function sliceProgress(featureDir) {
 export function readySlices(progress) {
   if (!progress) return [];
   const done = new Set(progress.slices.filter((s) => s.status === 'feito').map((s) => s.id));
-  return progress.slices.filter((s) => s.status !== 'feito' && s.depends.every((d) => done.has(d)));
+  return progress.slices.filter((s) => s.status !== 'feito' && s.status !== 'bloqueado' && s.depends.every((d) => done.has(d)));
 }
 
 // Loose on purpose: a false "complete" costs a read, a false "incomplete"
@@ -94,6 +105,8 @@ export function inspectReport(path, { covers = [] } = {}) {
   const firstLine = body.split('\n').find((l) => l.trim() !== '') ?? '';
   const partial = PARTIAL_MARKER.test(firstLine);
   if (partial) missing.push('partial');
+  const blocked = BLOCKED_MARKER.test(firstLine);
+  if (blocked) missing.push('blocked');
 
-  return { exists: true, complete: missing.length === 0, missing, partial };
+  return { exists: true, complete: missing.length === 0, missing, partial, blocked };
 }

package/framework/hooks/shared/state-writer.js

@@ -4,6 +4,7 @@
 import { readFileSync, writeFileSync, renameSync, unlinkSync, existsSync, mkdirSync } from 'fs';
 import { join, dirname } from 'path';
 import { clearStateCache } from './state-reader.js';
+import { recordGateEvent } from './gate-event.js';
 
 const STATE_FILE = '.morph/state.json';
 const STATE_VERSION = '5.0.0';
@@ -81,10 +82,14 @@ export function setGateApproved(featureName, gate, meta = {}, projectPath) {
       ...(meta.selfAssessed ? { selfAssessed: true } : {}),
     };
     feature.updatedAt = now;
-    return persistFeature(featureName, feature, projectPath);
+    if (!persistFeature(featureName, feature, projectPath)) return false;
   } catch {
     return false;
   }
+  try {
+    recordGateEvent(projectPath, { feature: featureName, gate, step: 'approve', approvedBy: meta.approvedBy || 'manual' });
+  } catch {}
+  return true;
 }
 
 // Stamps identity so a feature born implicitly by a hook is never an anonymous

package/framework/mcp/registry.json

@@ -277,9 +277,39 @@
         "warnings": ["OAuth against your Neon account on first use. The server can delete branches and projects: keep destructive calls behind a human."],
         "setupGuide": "Run: claude mcp add --transport http neon https://mcp.neon.tech/mcp"
       }
+    },
+    "microsoft-learn": {
+      "phases": ["plan", "implement"],
+      "tools": ["microsoft_docs_search", "microsoft_docs_fetch", "microsoft_code_sample_search"],
+      "serverNames": ["microsoft-learn", "plugin_microsoft-docs_microsoft-learn"],
+      "detection": "mcpServers includes microsoft-learn or enabledPlugins includes microsoft-docs",
+      "fallback": "context7, then WebFetch on learn.microsoft.com",
+      "usage": "Official, current .NET 10 / ASP.NET Core / EF Core / Microsoft Agent Framework docs and code samples: search first, fetch the page when the excerpt is cut. Use it for any API the model may know from an older version",
+      "healthCheck": {
+        "toolPattern": "microsoft-learn",
+        "testCall": "Call microsoft_docs_search with query 'EF Core 10 what is new'",
+        "testParams": {
+          "query": "EF Core 10 what is new"
+        },
+        "successIndicator": "Returns Microsoft Learn excerpts with contentUrl",
+        "failureHint": "Microsoft Learn MCP not responding. Re-add it: claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp"
+      },
+      "install": {
+        "autoInstall": false,
+        "transport": "http",
+        "config": {
+          "type": "http",
+          "url": "https://learn.microsoft.com/api/mcp"
+        },
+        "credentials": [],
+        "prerequisites": [],
+        "stackRelevance": ["dotnet"],
+        "warnings": [],
+        "setupGuide": "Run: claude mcp add --transport http microsoft-learn https://learn.microsoft.com/api/mcp"
+      }
     }
   },
-  "_phaseMatrixNote": "Keys must be the v5 phases from framework/phases.json. The v4 keys 'design' and 'tasks' both collapsed into 'plan'; 'review' was absent entirely, so a project in review resolved to undefined. Stack-scoped MCPs (asaas, neon) stay out of this matrix on purpose — only universal ones are listed.",
+  "_phaseMatrixNote": "Keys must be the v5 phases from framework/phases.json. The v4 keys 'design' and 'tasks' both collapsed into 'plan'; 'review' was absent entirely, so a project in review resolved to undefined. Stack-scoped MCPs (asaas, neon, microsoft-learn) stay out of this matrix on purpose — only universal ones are listed.",
   "phaseMatrix": {
     "plan": ["context7", "graphify"],
     "uiux": ["playwright", "context7", "stitch", "morph-assets"],

package/framework/schemas/feature.schema.json

@@ -95,6 +95,7 @@
               "additionalProperties": false
             },
             "attempts": { "type": "integer", "minimum": 1 },
+            "failStreak": { "type": "integer", "minimum": 0, "description": "Persisted red verifies in a row, reset to 0 by a green one. Read by `morph-spec next` (decideNext in framework/hooks/shared/next-step.js) to turn the fix loop into an escalation every FIX_ATTEMPTS reds. Absent on entries written before the field existed, which is why it is NOT in required." },
             "updatedAt": { "type": "string", "format": "date-time" }
           },
           "additionalProperties": false

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

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

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

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

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

@@ -4,7 +4,7 @@ description: Executa as fatias do plano de uma feature morph-spec — dispatch p
 version: core
 when_to_use: Use com o gate do plano aprovado, em "use /morph-apply {feature}" ou "implementar feature"
 user-invocable: true
-cliVersion: "9.2.0"
+cliVersion: "9.3.0"
 ---
 
 # morph-apply
@@ -108,6 +108,7 @@ relatório, não a mensagem** — a mensagem final pode não chegar ou vir resum
 | `ok` | siga |
 | `report-stale` | **não re-despache**: o agente escreveu depois de relatar; leia `observed` e atualize o relatório |
 | `report-incomplete` + `resume` | `PARCIAL` na 1ª linha = a fatia não está pronta — o `report-check` o acusa como `report-incomplete`. Retome o MESMO agente por `SendMessage`, colando `tree.dirty`, `tree.commits` e o que falta |
+| `report-blocked` + `ask-human` | `BLOQUEADO` na 1ª linha = decisão que não é do agente; a pergunta e as opções estão no relatório. **Não re-despache.** Plano ou ADR já decide → decida e registre; senão `AskUserQuestion`. Retome o MESMO agente com a resposta |
 | `report-incomplete` + `complete-degraded` | complete a partir da mensagem, carimbe DEGRADADO e registre a falha no relatório |
 | `work-landed-report-missing` | não re-despache; grave você o relatório, DEGRADADO |
 | `no-work-no-report` / `report-missing-evidence-unknown` | re-despache uma vez; segunda ausência sem trabalho = escale |
@@ -131,7 +132,8 @@ verify da feature. `--filter` é do loop do próprio sub-agente; o Gate 3 e o CI
 inteira. Nó de teste sem `expectedCount`, ou fatia que apagou teste de propósito (limpeza, `morph-spec tests-audit`): acrescente `--record-baseline` a ESTA rodada — ela mede e
 prova de uma vez; nunca um segundo verify só para gravar a baseline. Vermelho: corrija com `verify.feedback` (direto no código, ou re-despachando a fatia dona)
 e rode de novo; **3 tentativas** sem verde → `AskUserQuestion` ("Verify de {feature} vermelho após 3
-tentativas — aceitar com ressalva, continuar tentando, ou parar?").
+tentativas — aceitar com ressalva, continuar tentando, ou parar?"). Quem conta é o `feature.json`:
+`morph-spec next {feature}` devolve `fix` enquanto há tentativa e `escalate` na 3ª vermelha seguida.
 
 **Cenário que julga saída de LLM** (`prova: eval`): a evidência é rodar, não ler código. Com nó
 `runner: "evals"`: `morph-spec verify {feature} --filter {id-do-nó-evals} --skip-e2e --no-persist`

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

@@ -4,7 +4,7 @@ description: ADW cirúrgico de hotfix — resolve uma queda/bug crítico de prod
 version: core
 when_to_use: Use quando chegar "/morph-hotfix {feature}", quando a morph-plan rotear o pedido como workType hotfix, ou quando o usuário disser "produção caiu / hotfix / urgente" a respeito de um incidente
 user-invocable: true
-cliVersion: "9.2.0"
+cliVersion: "9.3.0"
 ---
 
 # morph-hotfix

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

@@ -4,7 +4,7 @@ description: Cuida da RAM e da CPU da máquina enquanto o morph-spec trabalha
 version: core
 when_to_use: Use quando a máquina estiver lenta ou sem RAM, um comando pesado esperou ou foi recusado pela fila, sobrou worktree de sub-agent, ou vários sub-agents pesados vão rodar em paralelo
 user-invocable: false
-cliVersion: "9.2.0"
+cliVersion: "9.3.0"
 ---
 
 # morph-machine

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

@@ -4,7 +4,7 @@ description: Conduz a AUTORIA de mídia gerada por IA — escolher o modelo pelo
 version: core
 when_to_use: Use quando a tarefa for PRODUZIR imagem ou vídeo por IA (catálogo, marketing, asset de LP) e alguém precisar decidir modelo, prompt e aprovação
 user-invocable: true
-cliVersion: "9.2.0"
+cliVersion: "9.3.0"
 stacks:
   - dotnet
   - nextjs

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

@@ -4,7 +4,7 @@ description: Leva uma feature do pedido ao plano aprovado — roteia o tipo de t
 version: core
 when_to_use: Use quando uma feature, bug ou chore começar ("/morph-plan {feature}", "vamos planejar X"), ou ao retomar uma feature cujo gate plan ainda não foi aprovado
 user-invocable: true
-cliVersion: "9.2.0"
+cliVersion: "9.3.0"
 ---
 
 # morph-plan

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

@@ -4,7 +4,7 @@ description: Conduz o Gate 3 — despacha verificador ∥ revisor (∥ seguranç
 version: core
 when_to_use: Use quando a fase review começar, com todas as fatias com relatório final e o verify da feature verde
 user-invocable: true
-cliVersion: "9.2.0"
+cliVersion: "9.3.0"
 ---
 
 # morph-review

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

@@ -4,7 +4,7 @@ description: Localiza um standard específico via busca server-side (morph-spec
 version: core
 when_to_use: Use quando precisar consultar um standard específico durante a implementação
 user-invocable: true
-cliVersion: "9.2.0"
+cliVersion: "9.3.0"
 ---
 
 # morph-standards

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

@@ -4,7 +4,7 @@ description: Conduz a fase opcional de UI/UX de uma feature com plano aprovado
 version: core
 when_to_use: Use quando o ramo de design for tomado (morph-spec advance {feature} --design, depois do gate do plano) e antes de /morph-apply
 user-invocable: true
-cliVersion: "9.2.0"
+cliVersion: "9.3.0"
 ---
 
 # morph-uiux
@@ -22,6 +22,7 @@ Entra depois do gate do plano, quando a `morph-plan` §6 decidiu que a feature c
 
 - WCAG AA e todos os estados de componente interativo (default/hover/focus/disabled/loading/error), não só o caminho feliz.
 - Reusa token e componente existentes antes de criar; token novo precisa de justificativa. Sistemas, não telas isoladas.
+- Tarefa principal da tela em até 3 interações, uma ação primária por tela, voltar/cancelar sempre à vista. Erro diz o que fazer a seguir; conteúdo gerado por IA aparece marcado como tal.
 - **Toda tela sai com o checklist de tela preenchido.** O `advance --design` já escreveu `1-design/mockups.md` a partir do template do pacote, a fonte única dos dez itens (tabela `### Checklist de tela` dentro de cada `## Tela:`). "Não se aplica" vale se escrito; `…`, vazio ou "a definir" reprovam. Design sem tela nova ou alterada (só componente ou estilo): apague o `1-design/mockups.md` semeado. É o checklist que faz a lista de 2 000 linhas paginar: o verificador do Gate 3 cobra cada item decidido em `## Checklist de tela`. Tela de dados segue os standards de `admin-app` (lista/tabela, formulário, feedback, estrutura de página); login, onboarding, primeira tela, estado vazio de destaque e sucesso são `brand-moment`.
 - **Conformidade não basta: a régua estética vale junto.** Direção escrita antes de componente (`1-design/direcao.md`: conceito, metáfora, o que torna a tela memorável, o que ela não pode parecer; 2 ou 3 direções para tela nova ou momento de marca), celular desenhado e não derivado, movimento com versão estática digna. A régua é o standard `frontend-design-system-art-direction`.
 - **Toda tela nova ou alterada tem protótipo renderizado e conferido por print.** `1-design/prototipos/{tela}.html` autossuficiente, com os tokens reais do projeto (lidos do CSS de tokens), desktop e celular lado a lado, controles animado/estático/pausar; prints `{tela}-1280.png` e `{tela}-390.png` ao lado, saídos do laço de autocrítica. A `## Tela:` aponta o protótipo na linha `**Protótipo:**`.

package/framework/standards/STANDARDS.meta.json

@@ -1123,7 +1123,7 @@
         "MCP server",
         "MCP client"
       ],
-      "verifiedAgainst": "Claude Code 2.1.282 MCP tooling — context7, Playwright (as plugin and as a project MCP server); GitHub via `gh` CLI; Neon via its MCP or `neonctl`.",
+      "verifiedAgainst": "Claude Code 2.1.282 MCP tooling — context7, Playwright (as plugin and as a project MCP server); GitHub via `gh` CLI; Neon via its MCP or `neonctl`; Microsoft Learn MCP (`https://learn.microsoft.com/api/mcp`, tools listed by `tools/list` on 2026-10-17).",
       "provedBy": []
     },
     "frontend-admin-app-data-table": {

package/framework/standards/ai-agents/setup.md

@@ -331,6 +331,8 @@ AIAgent instrumented = agent.AsBuilder()
 
 ## 7. What NOT to do (anti-patterns)
 
+`morph-spec stack-scan` cobra três linhas desta tabela no código: Semantic Kernel, hosted agent service e versão flutuante.
+
 | Wrong | Right |
 |-------|-------|
 | `using Microsoft.SemanticKernel` | `using Microsoft.Agents.AI` |

package/framework/standards/integration/mcp/mcp-tools.md

@@ -5,7 +5,7 @@
 > **Keywords:** mcp, model-context-protocol, mcp-tools, context7, playwright, mcp-client
 > **Load When:** an MCP tool is used in any morph-spec phase
 
-**Verified against:** Claude Code 2.1.282 MCP tooling — context7, Playwright (as plugin and as a project MCP server); GitHub via `gh` CLI; Neon via its MCP or `neonctl`. Last-verified: 2026-09-24.
+**Verified against:** Claude Code 2.1.282 MCP tooling — context7, Playwright (as plugin and as a project MCP server); GitHub via `gh` CLI; Neon via its MCP or `neonctl`; Microsoft Learn MCP (`https://learn.microsoft.com/api/mcp`, tools listed by `tools/list` on 2026-10-17). Last-verified: 2026-10-17.
 
 ---
 
@@ -138,6 +138,7 @@ Fallback: manual image creation, stock photos, or placeholder divs.
 |------|----------|---------|
 | **Neon CLI (`neonctl`) / psql** | Database schema, tables, relationships, RLS | `psql <DB_URL> -c "SELECT ..."` |
 | **Context7** | Library docs for architecture decisions | `mcp__context7__query-docs()` |
+| **Microsoft Learn** (stack .NET) | Official docs for a .NET/EF Core/MAF decision (limits, what is new, migration) | `mcp__microsoft-learn__microsoft_docs_search({ query })` |
 | **GitHub CLI (`gh`)** | Check existing code patterns, PRs | `gh search code` (Bash) |
 
 ```bash
@@ -213,6 +214,7 @@ gh issue create --title "F1: Create Entity Lead" \
 | **Neon CLI (`neonctl`) / psql** | Run migrations, create RLS policies | `dotnet ef database update` |
 | **GitHub CLI (`gh`)** | Create PR, push branches | `gh pr create` (Bash) |
 | **Context7** | Look up API usage during coding | `mcp__context7__query-docs()` |
+| **Microsoft Learn** (stack .NET) | Current .NET 10 / EF Core / ASP.NET Core / MAF API: search, then fetch the page when the excerpt is cut | `mcp__microsoft-learn__microsoft_docs_search({ query })` → `microsoft_docs_fetch({ url })`; `microsoft_code_sample_search` for snippets |
 | **Playwright** | Smoke test deployed features, verify UI | `mcp__playwright__browser_navigate()` |
 | **Vercel** | Deploy, check logs, manage env vars | `mcp__vercel__list_projects()` |
 | **Azure CLI** | Resource management, deployments | `az` commands |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "9.2.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) {