@polymorphism-tech/morph-spec 9.8.0 → 10.0.0

package/src/scripts/setup-infra.js

@@ -18,10 +18,11 @@ import { injectMorphImport } from '../utils/claude-md-injector.js';
 import { saveProjectMorphVersion, getInstalledCLIVersion, getProjectMorphVersion } from '../utils/version-checker.js';
 import { installClaudeHooks, installGlobalStatusline } from '../utils/claude-settings-manager.js';
 import { installSkills } from '../utils/skills-installer.js';
-import { installAgents, installDomainAgents } from '../utils/agents-installer.js';
+import { installAgents } from '../utils/agents-installer.js';
 import { resolvePrimaryRoot } from '../commands/project/worktree.js';
 import { reconcileLegacyTemplatesCopy } from '../lib/installers/templates-reconcile.js';
 import { realEffects } from '../lib/installers/effects.js';
+import { installRulesForStack } from '../lib/installers/rules-installer.js';
 
 const FRAMEWORK_DIR = join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'framework');
 
@@ -41,31 +42,7 @@ async function installRequiredPlugins(log, exec) {
   }
 }
 
-/** Also removes orphan rules in rulesDest that are no longer in the install set. */
-export function installRulesForStack(rulesSrc, rulesDest, projectTags, fx = realEffects()) {
-  const sourceFiles = readdirSync(rulesSrc).filter(f => f.endsWith('.md'));
-  const installed = new Set();
-
-  for (const file of sourceFiles) {
-    const content = readFileSync(join(rulesSrc, file), 'utf-8');
-    const stacks = parseStacks(content);
-    if (shouldInstall(stacks, projectTags)) {
-      fx.copyFile(join(rulesSrc, file), join(rulesDest, file));
-      installed.add(file);
-    }
-  }
-
-  // Calado em `dryRun`: `cleanFrameworkDirs()` já apagou `.claude/rules/` inteiro antes da execução real.
-  if (!fx.dryRun) {
-    for (const file of readdirSync(rulesDest).filter(f => f.endsWith('.md'))) {
-      if (!installed.has(file)) {
-        fx.remove(join(rulesDest, file));
-      }
-    }
-  }
-
-  return { installed: installed.size };
-}
+export { installRulesForStack };
 
 /** Clean-slate: removes only a framework command the stack filtered out, never one the user wrote. */
 export function installCommandsForStack(commandsSrc, commandsDest, projectTags, fx = realEffects()) {
@@ -118,10 +95,7 @@ async function installStackAwareAssets(targetPath, log) {
   log('Installing agents...');
   const agentCounts = await installAgents(targetPath, FRAMEWORK_DIR, { projectTags });
 
-  log('Installing domain agents...');
-  const domainCounts = await installDomainAgents(targetPath, FRAMEWORK_DIR, { projectTags });
-
-  return { agentCounts, domainCounts, projectTags };
+  return { agentCounts, projectTags };
 }
 
 /**
@@ -138,9 +112,9 @@ export async function updateClaudeMdAgentsBlock(claudeMdPath, agents = [], optio
 
   const list = agents.length > 0
     ? agents.map(a => `- \`${a.name}\` — ${a.title}${a.domains?.length ? ` (${a.domains.join(', ')})` : ''}`).join('\n')
-    : '_Nenhuma persona instalada — configure `project.stack` em `.morph/config/config.json` e rode `morph-spec setup-infra --reinstall`._';
+    : '_Nenhum agente instalado — rode `morph-spec setup-infra --reinstall`._';
 
-  const block = `${START}\n**Personas instaladas neste projeto** (derivado de agents.json na última instalação):\n\n${list}\n${END}`;
+  const block = `${START}\n**Agentes do Gate 3** (derivado de agents.json na última instalação):\n\n${list}\n${END}`;
   const updated = content.replace(
     new RegExp(`${START}[\\s\\S]*?${END}`),
     block
@@ -178,16 +152,10 @@ export async function setupInfra(targetPath, {
 
   if (reinstall) {
     log('setup-infra (reinstall): re-installing stack-aware assets...');
-    const { agentCounts, domainCounts } = await installStackAwareAssets(targetPath, log);
+    const { agentCounts } = await installStackAwareAssets(targetPath, log);
     await updateClaudeMdAgentsBlock(join(targetPath, '.claude', 'CLAUDE.md'), agentCounts?.agents ?? []);
     log('setup-infra (reinstall): complete.');
-    return {
-      agents: {
-        tier1: agentCounts?.tier1 ?? 0,
-        tier2: agentCounts?.tier2 ?? 0,
-        specialists: domainCounts?.specialists ?? 0,
-      },
-    };
+    return { agents: { installed: agentCounts?.installed ?? 0 } };
   }
 
   await installRequiredPlugins(log, _exec);
@@ -316,7 +284,7 @@ export async function setupInfra(targetPath, {
   const claudeDest = join(targetPath, '.claude');
 
   log('Steps 10-13: Installing stack-aware assets...');
-  const { agentCounts, domainCounts, projectTags } = await installStackAwareAssets(targetPath, log);
+  const { agentCounts, projectTags } = await installStackAwareAssets(targetPath, log);
 
   log('Step 14: Installing .claude/CLAUDE.md...');
   const runtimeClaudeMdDest = join(claudeDest, 'CLAUDE.md');
@@ -374,7 +342,9 @@ export async function setupInfra(targetPath, {
       log(`  ✓ graphify ${installed} já instalado`);
     } else {
       const { kind } = detectInstaller();
-      if (!kind) {
+      if (process.env.MORPH_NO_TOOL_INSTALL === '1') {
+        log(`  ○ graphify não instalado (MORPH_NO_TOOL_INSTALL=1). Depois: uv tool install ${GRAPHIFY_PACKAGE}==${GRAPHIFY_VERSION}`);
+      } else if (!kind) {
         log(`  ⚠ Sem uv/pipx/python — grafo indisponível. Depois: uv tool install ${GRAPHIFY_PACKAGE}==${GRAPHIFY_VERSION}`);
       } else {
         // Sem o extra [sql] os arquivos .sql são ignorados em silêncio.
@@ -382,7 +352,8 @@ export async function setupInfra(targetPath, {
         const { cmd, args } = installArgs(kind, { withSql });
         try {
           _exec(`${cmd} ${args.join(' ')}`, { stdio: 'ignore' });
-          log(`  ✓ graphify ${GRAPHIFY_VERSION}${withSql ? ' [sql]' : ''} via ${kind}`);
+          if (probe() === GRAPHIFY_VERSION) log(`  ✓ graphify ${GRAPHIFY_VERSION}${withSql ? ' [sql]' : ''} via ${kind}`);
+          else log(`  ⚠ ${kind} instalou o graphify, mas o binário não responde (nem no PATH nem no venv da ferramenta) — rode ${cmd} ${args.join(' ')} --force no seu terminal`);
         } catch {
           log(`  ⚠ Falha ao instalar o graphify via ${kind} — manualmente: ${cmd} ${args.join(' ')}`);
         }
@@ -414,11 +385,5 @@ export async function setupInfra(targetPath, {
 
   log('setup-infra: complete.');
 
-  return {
-    agents: {
-      tier1: agentCounts?.tier1 ?? 0,
-      tier2: agentCounts?.tier2 ?? 0,
-      specialists: domainCounts?.specialists ?? 0,
-    },
-  };
+  return { agents: { installed: agentCounts?.installed ?? 0 } };
 }

package/src/utils/agents-installer.js

@@ -4,15 +4,8 @@ import { shouldInstall } from '../lib/stack-filter.js';
 import { realEffects } from '../lib/installers/effects.js';
 import { REVIEW_ROLES, VERDICT_TOKEN, REVIEWED_SHA_TOKEN, VERDICTS } from '../lib/review-reports.js';
 
-export const DEFAULT_AGENT_TOOLS = 'Read, Write, Edit, Bash, Glob, Grep';
+export const DEFAULT_AGENT_TOOLS = 'Read, Glob, Grep, Bash';
 
-/** Derived from the effective tool scope (Write or Edit), so a persona made read-only stops being one. */
-export function isImplementer(agent) {
-  const tools = String(agent?.tools ?? DEFAULT_AGENT_TOOLS).split(',').map((t) => t.trim());
-  return tools.includes('Write') || tools.includes('Edit');
-}
-
-// The value hardcoded before the field existed: an agents.json without `maxTurns` renders byte-for-byte as before.
 export const DEFAULT_MAX_TURNS = 20;
 
 const CHECKPOINT_PERCENT = 70;
@@ -43,84 +36,12 @@ export function resolveMaxTurns(agent) {
   return agent.maxTurns ?? DEFAULT_MAX_TURNS;
 }
 
-export const VALID_EFFORTS = ['low', 'medium', 'high', 'xhigh', 'max'];
-
-// Absent: no `effort:` line, so the sub-agent inherits the session effort.
-export function effortProblem(value) {
-  if (value === undefined) return null;
-  return VALID_EFFORTS.includes(value) ? null : `esperado um de ${VALID_EFFORTS.join('|')}`;
-}
-
-export function effortError(id, value) {
-  const problem = effortProblem(value);
-  if (!problem) return null;
-  return `agents.json: persona "${id}" tem effort inválido (${JSON.stringify(value)}) — ${problem}. ` +
-    'Remova o campo para herdar o effort da sessão.';
-}
-
-const SURFACE_ID_RE = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
-
-const SURFACE_KEYS = new Set(['when', 'standards']);
-
-// A standard both universal and in a surface is refused: the persona would keep
-// loading it on every surface without anyone noticing.
-export function surfacesProblem(surfaces, standards = []) {
-  if (surfaces === undefined) return null;
-  if (surfaces === null || typeof surfaces !== 'object' || Array.isArray(surfaces)) {
-    return 'esperado objeto { "<superfície>": { when, standards } }';
-  }
-  const entries = Object.entries(surfaces);
-  if (entries.length === 0) return 'esperado ao menos uma superfície';
-
-  const universal = new Set(Array.isArray(standards) ? standards : []);
-  for (const [name, def] of entries) {
-    if (!SURFACE_ID_RE.test(name)) return `superfície "${name}" — o id é kebab-case (ex.: "admin-app")`;
-    if (def === null || typeof def !== 'object' || Array.isArray(def)) {
-      return `superfície "${name}" — esperado { when, standards }`;
-    }
-    const unknown = Object.keys(def).filter((k) => !SURFACE_KEYS.has(k));
-    if (unknown.length > 0) return `superfície "${name}" — campo desconhecido: ${unknown.join(', ')}`;
-    if (typeof def.when !== 'string' || def.when.trim() === '') {
-      return `superfície "${name}" — "when" precisa dizer que telas são dessa superfície`;
-    }
-    const ids = def.standards;
-    if (!Array.isArray(ids) || ids.length === 0 || ids.some((s) => typeof s !== 'string' || s.trim() === '')) {
-      return `superfície "${name}" — "standards" precisa ser uma lista não vazia de ids`;
-    }
-    const repeated = ids.filter((s, i) => ids.indexOf(s) !== i);
-    if (repeated.length > 0) return `superfície "${name}" repete ${[...new Set(repeated)].join(', ')}`;
-    const overlap = ids.filter((s) => universal.has(s));
-    if (overlap.length > 0) {
-      return `superfície "${name}" repete standard da lista universal (${overlap.join(', ')}) — ` +
-        'um standard é universal OU de uma superfície';
-    }
-  }
-  return null;
-}
-
-export function surfacesError(id, surfaces, standards) {
-  const problem = surfacesProblem(surfaces, standards);
-  if (!problem) return null;
-  return `agents.json: persona "${id}" tem surfaces inválido — ${problem}. ` +
-    'Remova o campo para a persona ler só `standards`.';
-}
-
-/** @returns {string[]} unique ids of `standards` plus every surface's, universal first */
 export function personaStandardIds(persona) {
-  const ids = [...(Array.isArray(persona?.standards) ? persona.standards : [])];
-  const surfaces = persona?.surfaces;
-  if (surfaces && typeof surfaces === 'object' && !Array.isArray(surfaces)) {
-    for (const def of Object.values(surfaces)) {
-      if (Array.isArray(def?.standards)) ids.push(...def.standards);
-    }
-  }
-  return [...new Set(ids)];
+  return [...new Set(Array.isArray(persona?.standards) ? persona.standards : [])];
 }
 
 function personaError(agent) {
-  return maxTurnsError(agent.id, agent.maxTurns)
-    ?? surfacesError(agent.id, agent.surfaces, agent.standards)
-    ?? effortError(agent.id, agent.effort);
+  return maxTurnsError(agent.id, agent.maxTurns);
 }
 
 // `tools:` is a strict allowlist: without Skill no skill runs, without ToolSearch no deferred MCP tool loads.
@@ -165,6 +86,8 @@ const MANAGED_HEADER =
   '     Do NOT edit by hand: changes are overwritten on `morph-spec update` / `setup-infra --reinstall`.\n' +
   '     To change this persona, edit agents.json and regenerate. Drift is flagged by `morph-spec doctor`. -->';
 
+const MANAGED_HEADER_MARKER = MANAGED_HEADER.split('\n')[0];
+
 export async function installAgents(projectDir, frameworkDir = 'framework', options = {}) {
   const { projectTags = [], fx = realEffects() } = options;
 
@@ -213,24 +136,30 @@ export async function installAgents(projectDir, frameworkDir = 'framework', opti
   // Silent in dryRun: the real update's cleanFrameworkDirs() already emptied the dir.
   if (!fx.dryRun) {
     for (const file of readdirSync(targetDir)) {
-      if (allPossible.has(file) && !installedFilenames.has(file)) {
-        fx.remove(join(targetDir, file));
-      }
+      if (installedFilenames.has(file)) continue;
+      const path = join(targetDir, file);
+      if (allPossible.has(file) || isManagedOrphan(file, path)) fx.remove(path);
     }
   }
 
   return { installed, agents: installedAgents };
 }
 
+// Only the managed header proves the file is ours: a hand-written morph-*.md is never deleted.
+function isManagedOrphan(file, path) {
+  if (!file.startsWith('morph-') || !file.endsWith('.md')) return false;
+  try {
+    return readFileSync(path, 'utf-8').includes(MANAGED_HEADER_MARKER);
+  } catch {
+    return false;
+  }
+}
+
 // Deterministic: the doctor drift check compares files byte-for-byte against this output.
 export function renderAgentMd(agent, knownMcpIds = null) {
   const description = buildDescription(agent);
   // One value for the frontmatter and the body: the sub-agent never sees its own frontmatter.
   const maxTurns = resolveMaxTurns(agent);
-  const surfaces = surfacesError(agent.id, agent.surfaces, agent.standards);
-  if (surfaces) throw new Error(surfaces);
-  const effort = effortError(agent.id, agent.effort);
-  if (effort) throw new Error(effort);
   const frontmatter = buildFrontmatter(agent, description, knownMcpIds, maxTurns);
   const body = buildBody(agent, maxTurns);
   return `---\n${frontmatter}---\n\n${MANAGED_HEADER}\n\n${body}\n`;
@@ -251,10 +180,8 @@ function buildFrontmatter(agent, description, knownMcpIds, maxTurns) {
     `description: ${description}`,
     `model: ${agent.model ?? 'inherit'}`,
     `tools: ${buildToolsLine(agent, knownMcpIds)}`,
-    // Position fixed so an agents.json without the field renders byte-for-byte as before.
     `maxTurns: ${maxTurns}`,
   ];
-  if (agent.effort) lines.push(`effort: ${agent.effort}`);
   if (agent.color) lines.push(`color: ${agent.color}`);
   lines.push(`memory: project`, '');
   return lines.join('\n');
@@ -267,58 +194,9 @@ function buildDescription(agent) {
   return desc.length > 200 ? desc.slice(0, 197) + '...' : desc;
 }
 
-const NEON_CAUTION = 'NEON: o MCP `neon` inspeciona schema e ensaia migração numa branch descartável ' +
-  '(prepare_database_migration → complete_database_migration); ele também APAGA branch e projeto — ' +
-  'nunca chame tool destrutiva sem confirmação humana explícita.';
-
 const STANDARDS_HINT = 'Digest de cada um: `morph-spec standards --find <id>`; só a seção que importa: ' +
   '`morph-spec standards --show <id>#<âncora>` (`--show <id>` lista as âncoras).';
 
-export const DISPATCH_CONTRACT = [
-  '## Contrato de dispatch',
-  '',
-  'O dispatch traz só o que muda por fatia: id e título, `cobre` com o texto de cada cenário, `arquivos`, `standards`, ' +
-    'o caminho do relatório e, se houver, o worktree. O resto é este contrato.',
-  '',
-  '1. RELATÓRIO: GRAVE o arquivo de relatório que o dispatch nomeia (`.morph/features/{feature}/3-implement/reports/F{n}.md`) ' +
-    'ANTES de encerrar — é o retorno autoritativo, não a sua mensagem final.',
-  '2. ESTADO: NÃO toque em `plan.md`, `checks.json`, `feature.json` nem `state.json`: o estado é do orquestrador.',
-  '3. TESTE: a prova é do orquestrador (`morph-spec verify {feature}`, depois do seu retorno), não sua. Escreva os testes pelo orçamento: ' +
-    'um por Cn `prova: teste`, na camada mais baixa que o prova (a de cima só para o que só existe lá), variantes em tabela (`[Theory]`/`it.each`); `leitura` sem teste. NÃO rode teste a cada marco nem faça ciclo red→green: ' +
-    'escreva código e testes, compile, e rode SÓ o filtro dos seus testes UMA vez, em primeiro plano, antes do relatório ' +
-    '(`vitest related <arquivos da fatia> --run`; `dotnet test --filter "FullyQualifiedName~<Classe>" --no-build` após o build); ' +
-    'se falhar, corrija e rode só os que falharam. Teto: 3 rodadas (`verify --filter` conta, exit 3 não); ' +
-    'o hook nega a 4ª e o `verify` sem `--filter`: grave `PARCIAL` com o que ainda falha e devolva. ' +
-    'Grave a saída em arquivo (`… > .morph/logs/test-last.log 2>&1`, sem nada depois) e leia o arquivo — um pipe troca o exit do teste pelo do último comando. ' +
-    'Em batch paralelo SEM isolamento, só compile. Com `isolation: "worktree"`, o mesmo vale no seu worktree, e o último ato é o commit na branch dele.',
-  '4. SOBREVIVÊNCIA: o limite de turnos corta sem aviso: commite `chore(F{n}): wip …` a cada marco (um arquivo ou uma fatia escrita), não só ao fim — ' +
-    'e só os seus arquivos (`git add <paths>`, nunca diretório). Sem commit, a retomada recomeça do zero.',
-  '5. PROCESSOS: encerre dev server pelo PID que você mesmo subiu. Build e suíte pesados rodam por `morph-spec heavy run -- <comando>`, em primeiro plano; ' +
-    'exit 3 é fila cheia: não repita nem espere em laço, diga no relatório o que não rodou.',
-  '6. REUSO: antes de criar tipo, componente, hook ou serviço NOVO, verifique se já existe: `morph-spec graph explain <nome>` e ' +
-    '`graph affected <conceito> --uses-only`; sem grafo (`no-graph`), caia para `grep -rn "<nome>"` e siga — a ausência de grafo nunca bloqueia. ' +
-    'Se criar mesmo assim, diga por que em uma linha no relatório.',
-  '7. MUTAÇÃO: nunca altere, reverta, mova ou apague código de produção para ver um teste falhar; a prova de que o teste morde é do verificador.',
-  '8. ESCRITA: código e teste do projeto só por Write/Edit, nunca pelo Bash (heredoc, `sed -i`, script que grava): os guards só enxergam Write/Edit.',
-  '9. BLOQUEIO: decisão que não é sua (requisito contra o plano ou um ADR, escolha deixada ao humano) → `BLOQUEADO` na 1ª linha, ' +
-    'com a pergunta e as opções. Dificuldade técnica não é bloqueio.',
-  '',
-  'Formato do relatório (o `report-check` lê estas marcas):',
-  '',
-  '```',
-  '# F1 — <título>',
-  'O que foi feito, em 2-3 frases: o comportamento entregue e onde ele mora, sem repetir a lista de arquivos.',
-  '**Arquivos:** `src/a.cs`, `src/a.test.cs`',
-  '**Checks:**',
-  '- C1 — provado: `a.test.cs` › nome do teste (ou `arquivo:linha`)',
-  '- C2 — não provado: por quê',
-  '```',
-  '',
-  '`**Arquivos:**` lista TODO arquivo criado ou modificado, inclusive artefato auxiliar fora do plano (factory, seed, config gerada): ' +
-    'arquivo em produção sem dono é falha de protocolo que o Gate 3 aponta. Todo cenário que a fatia `cobre` aparece em `**Checks:**`. ' +
-    'Problemas e como foram resolvidos vão em prosa depois.',
-];
-
 export const REVIEW_REPORT_CONTRACT = [
   '## Relatório do Gate 3',
   '',
@@ -346,57 +224,20 @@ function buildBody(agent, maxTurns) {
     '',
   ];
 
-  // The shape without effort or surfaces renders byte-for-byte as the old fixture.
-  const legacyShape = !agent.effort && !agent.surfaces && isImplementer(agent);
-
-  if (legacyShape && agent.domains?.length) {
-    lines.push('## Domains', ...agent.domains.map(d => `- ${d}`), '');
-  }
-
-  if (!legacyShape && agent.mcp?.includes('neon')) {
-    lines.push(NEON_CAUTION, '');
-  }
-
   if (agent.standards?.length) {
-    lines.push('## Standards to consult on demand');
-    if (!legacyShape) lines.push(STANDARDS_HINT);
+    lines.push('## Standards to consult on demand', STANDARDS_HINT);
     for (const s of agent.standards) lines.push(`- ${s}`);
     lines.push('');
   }
 
-  if (agent.surfaces) {
-    const read = agent.standards?.length ? 'Read the list above plus only' : 'Read only';
-    lines.push(
-      '## Standards by surface',
-      '',
-      'A screen is ONE surface — the mockup checklist names it (`Superfície`). ' +
-        `${read} the list of that screen's surface; never another surface's standards for that screen.`,
-      '',
-    );
-    for (const [name, def] of Object.entries(agent.surfaces)) {
-      lines.push(`### ${name}`, def.when, ...def.standards.map((s) => `- ${s}`), '');
-    }
-  }
-
-  if (agent.effort && isImplementer(agent)) {
-    lines.push(...DISPATCH_CONTRACT, '');
-  } else if (isImplementer(agent)) {
-    lines.push(
-      '## How you operate',
-      '',
-      'You are a domain persona dispatched per task. Read the spec/tasks/standards passed to you, do the work, and report each doneCriteria with its evidence. Refer to MORPH.md section 6 for the dispatch contract.',
-      '',
-    );
-  } else {
-    lines.push(
-      '## Como você opera',
-      '',
-      'Você é read-only: nunca escreva, edite nem reverta código, testes, o plano ou `feature.json` (nada de `git checkout --`). ' +
-        'O entregável é o arquivo de relatório que o dispatch nomeia; sem arquivo nomeado, é a sua mensagem final (no scout, o mapa).',
-      '',
-    );
-    if (Object.hasOwn(REVIEW_ROLES, agent.id)) lines.push(...REVIEW_REPORT_CONTRACT, '');
-  }
+  lines.push(
+    '## Como você opera',
+    '',
+    'Você é read-only: nunca escreva, edite nem reverta código, testes, o plano ou `feature.json` (nada de `git checkout --`). ' +
+      'O entregável é o arquivo de relatório que o dispatch nomeia; sem arquivo nomeado, é a sua mensagem final.',
+    '',
+  );
+  if (Object.hasOwn(REVIEW_ROLES, agent.id)) lines.push(...REVIEW_REPORT_CONTRACT, '');
 
   lines.push(
     // `PARCIAL` on line 1 is what report-check reads; "no verdict" keeps a partial
@@ -409,17 +250,6 @@ function buildBody(agent, maxTurns) {
       '`PARCIAL` on line 1, done, remaining, files, no verdict (final report only) — then continue or stop, your call; the final report replaces it.',
   );
 
-  // The only text every implementer dispatch is guaranteed to carry.
-  if (agent.effort && isImplementer(agent)) {
-    lines.push(
-      '',
-      '## Working fast',
-      '',
-      'Independent tool calls go in the SAME response: read every listed file at once, fire the searches together. ' +
-        'Check a library API in the `context7` MCP before guessing (load a deferred `mcp__` tool with ToolSearch).',
-    );
-  }
-
   return lines.join('\n');
 }
 
@@ -428,10 +258,6 @@ function checkpointTurn(maxTurns) {
   return Math.max(1, Math.floor((maxTurns * CHECKPOINT_PERCENT) / 100));
 }
 
-export async function installDomainAgents(projectDir, frameworkDir, options) {
-  return { specialists: 0 };
-}
-
 export function checkMissingAgents(projectDir, frameworkDir, projectTags = []) {
   const targetDir = join(projectDir, '.claude', 'agents');
   const installedFiles = new Set();

package/src/utils/hooks-installer.js

@@ -1,11 +1,10 @@
 import { join, dirname } from 'path';
 import { readFile } from 'fs/promises';
-import { existsSync, chmodSync, readdirSync } from 'fs';
+import { existsSync, readdirSync } from 'fs';
 import { homedir } from 'os';
-import { execSync } from 'child_process';
 import { realEffects } from '../lib/installers/effects.js';
 
-const HOOKS_VERSION = '3.14.0';
+const HOOKS_VERSION = '3.17.0';
 
 const OLD_DISPATCH_COMMAND = 'node framework/hooks/agent-teams/dispatch.js';
 
@@ -25,9 +24,6 @@ const MORPH_ALLOW = [
   'Edit(.morph/context/**)',
   'Bash(mkdir:.morph/**)',
   'Bash(ls:.morph/**)',
-  // An auto-mode deny here pauses the review mutation round.
-  'Bash(morph-spec mutate:*)',
-  'Bash(npx morph-spec mutate:*)',
 ];
 
 const MORPH_PERMISSIONS = MORPH_DENY;
@@ -64,7 +60,7 @@ const MORPH_HOOKS = [
     hooks: [{
       type: 'command',
       command: 'node framework/hooks/claude-code/core/chain.js',
-      args: ['pre-bash-denylist', 'test-budget', 'conventional-commit', 'block-destructive-worktree-removal', 'block-raw-worktree-add', 'warn-bash-source-write', 'heavy-gate', 'worktree-env-inject']
+      args: ['pre-bash-denylist', 'test-budget', 'conventional-commit', 'block-destructive-worktree-removal', 'block-raw-worktree-add', 'heavy-gate', 'worktree-env-inject']
     }]
   },
 
@@ -117,7 +113,7 @@ const MORPH_HOOKS = [
     hooks: [{
       type: 'command',
       command: 'node framework/hooks/claude-code/core/chain.js',
-      args: ['telemetry-log', 'loop-detect', 'graph-refresh-kick', 'heavy-release', 'test-budget'],
+      args: ['telemetry-log', 'loop-detect', 'graph-refresh-kick', 'heavy-release', 'masked-exit'],
       timeout: 10
     }]
   },
@@ -129,7 +125,7 @@ const MORPH_HOOKS = [
     hooks: [{
       type: 'command',
       command: 'node framework/hooks/claude-code/core/chain.js',
-      args: ['telemetry-log', 'heavy-release', 'test-budget'],
+      args: ['telemetry-log', 'heavy-release'],
       timeout: 5,
       async: true
     }]
@@ -254,6 +250,8 @@ export async function installClaudeHooks(targetPath, { fx = realEffects() } = {}
   const STALE_ALLOW = [
     'Write(.morph/features/**)',
     'Write(.morph/context/**)',
+    'Bash(morph-spec mutate:*)',
+    'Bash(npx morph-spec mutate:*)',
   ];
   settings.permissions.allow = settings.permissions.allow.filter(
     p => !MORPH_ALLOW.includes(p) && !STALE_ALLOW.includes(p)
@@ -292,78 +290,6 @@ export async function installClaudeHooks(targetPath, { fx = realEffects() } = {}
   return { installed, updated: !alreadyCurrent };
 }
 
-function findPython() {
-  if (process.platform !== 'win32') {
-    for (const cmd of ['python3', 'python']) {
-      try {
-        const ver = execSync(`${cmd} --version`, { encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'] });
-        if ((ver + '').includes('Python 3')) return cmd;
-      } catch { /* not on PATH */ }
-    }
-    return null;
-  }
-  for (const cmd of ['python3', 'py', 'python']) {
-    try {
-      const ver = execSync(`${cmd} --version`, { encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'] });
-      if ((ver + '').includes('Python 3')) return cmd;
-    } catch { /* not on PATH */ }
-  }
-  const base = join(homedir(), 'AppData', 'Local', 'Programs', 'Python');
-  if (existsSync(base)) {
-    let dirs;
-    try { dirs = readdirSync(base); } catch { dirs = []; }
-    const py3 = dirs
-      .filter(d => /^Python3\d*/i.test(d))
-      .sort()
-      .reverse();
-    for (const dir of py3) {
-      const exe = join(base, dir, 'python.exe');
-      if (existsSync(exe)) return exe;
-    }
-  }
-  return null;
-}
-
-function tryInstallPython() {
-  const log = (msg) => process.stdout.write(`  ${msg}\n`);
-  log('⚠ Python 3 not found — attempting automatic installation...');
-
-  try {
-    if (process.platform === 'win32') {
-      execSync('winget install -e --id Python.Python.3.12 --accept-source-agreements --accept-package-agreements', {
-        stdio: 'inherit',
-        timeout: 120_000,
-      });
-    } else if (process.platform === 'darwin') {
-      execSync('brew install python3', { stdio: 'inherit', timeout: 120_000 });
-    } else {
-      try {
-        execSync('sudo apt-get update -qq && sudo apt-get install -y python3', { stdio: 'inherit', timeout: 120_000 });
-      } catch {
-        execSync('sudo dnf install -y python3', { stdio: 'inherit', timeout: 120_000 });
-      }
-    }
-    log('✓ Python 3 installed successfully.');
-    return true;
-  } catch (err) {
-    log(`✗ Automatic Python installation failed: ${err.message}`);
-    log('  Please install Python 3 manually: https://www.python.org/downloads/');
-    return false;
-  }
-}
-
-function resolvePythonForStatusline() {
-  let python = findPython();
-  if (python) return python;
-
-  if (tryInstallPython()) {
-    python = findPython();
-    if (python) return python;
-  }
-
-  return 'python3';
-}
-
 /**
  * Writes OUTSIDE the project (`~/.claude/`), so `--dry-run` must name these effects separately.
  * @returns {Promise<{ installed: boolean, globalDir: string }>}
@@ -372,23 +298,13 @@ export async function installGlobalStatusline(hooksSourceDir, globalClaudeDirOve
   const globalDir = globalClaudeDirOverride || join(homedir(), '.claude');
   fx.ensureDir(globalDir);
 
-  const scripts = ['statusline.sh', 'statusline.py'];
-  for (const fname of scripts) {
-    const src = join(hooksSourceDir, fname);
-    if (existsSync(src)) {
-      fx.copyFile(src, join(globalDir, fname));
-      if (process.platform !== 'win32' && !fx.dryRun) {
-        try { chmodSync(join(globalDir, fname), 0o755); } catch { /* non-critical */ }
-      }
-    }
+  fx.copyFile(join(hooksSourceDir, '..', 'statusline.js'), join(globalDir, 'statusline.js'));
+  for (const legacy of ['statusline.py', 'statusline.sh']) {
+    if (existsSync(join(globalDir, legacy))) fx.remove(join(globalDir, legacy));
   }
 
   const settingsPath = join(globalDir, 'settings.json');
-
-  // Claude Code on Windows cannot execute .sh directly.
-  const statuslineCommand = process.platform === 'win32'
-    ? `"${resolvePythonForStatusline()}" "${join(globalDir, 'statusline.py').replace(/\\/g, '/')}"`
-    : join(globalDir, 'statusline.sh').replace(/\\/g, '/');
+  const statuslineCommand = `node "${join(globalDir, 'statusline.js').replace(/\\/g, '/')}"`;
 
   // Without refreshInterval the status line only re-renders on events, freezing
   // the rate-limit countdown through a long turn. Shallow merge: only `statusLine` is ours.

package/framework/hooks/claude-code/core/warn-bash-source-write.js

@@ -1,23 +0,0 @@
-#!/usr/bin/env node
-// Warn only: a source file written by the shell skips every Write/Edit guard. The command still runs.
-import { contextResult, runStandalone } from '../../shared/hook-response.js';
-import { stateExists } from '../../shared/state-reader.js';
-import { writeTargets } from '../../shared/command-tokens.js';
-import { isProjectSource } from '../../shared/source-files.js';
-
-export async function run(payload) {
-  try {
-    if (!stateExists()) return null;
-    const sources = writeTargets(payload?.tool_input?.command || '').filter(isProjectSource);
-    if (!sources.length) return null;
-    return contextResult(
-      `⚠️ Código do projeto escrito pelo Bash (${sources.join(', ')}): os guards de escrita (fase, arquivo protegido, comment-guard) ` +
-        'só enxergam Write/Edit. Reescreva esse arquivo por Write/Edit.',
-      'PreToolUse',
-    );
-  } catch {
-    return null;
-  }
-}
-
-await runStandalone(run);