@fprad0/skill-master-mcp 0.0.11 → 1.0.0

package/bin/lib/menu-core.mjs

@@ -1,1154 +1,1629 @@
-import { spawn } from 'node:child_process';
-import { existsSync, readFileSync, readdirSync } from 'node:fs';
-import os from 'node:os';
-import { join } from 'node:path';
-import process from 'node:process';
-import {
-  assessCodexConfigContent,
-  assessMcpServerConfig,
-  defaultClientConfigPaths,
-} from './client-config.mjs';
-
-const ANSI = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-  cyan: '\x1b[36m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  red: '\x1b[31m',
-  white: '\x1b[37m',
-  gray: '\x1b[90m',
-  teal: '\x1b[38;5;80m',
-  amber: '\x1b[38;5;179m',
-  blue: '\x1b[38;5;75m',
-};
-
-const REQUIRED_GLOBAL_SKILLS = [
-  'catholic-moral-discernment',
-  'ai-ethics-human-dignity',
-  'professional-boundary-triage',
-  'broad-domain-router',
-  'language-quality-pt-en-fr',
-  'math-science-reasoning',
-  'philosophy-sociology-discernment',
-  'engineering-systems-master',
-  'source-authority-reviewer',
-  'release-ethics-gate',
-  'mcp-client-readiness',
-  'terminal-menu-operations',
-  'terminal-pixel-art-tui',
-];
-
-const BUNDLED_SKILL_DOMAIN_GROUPS = [
-  {
-    key: 'moral',
-    label: 'moral-core',
-    skills: [
-      'ai-ethics-human-dignity',
-      'broad-domain-router',
-      'catholic-moral-discernment',
-      'engineering-systems-master',
-      'language-quality-pt-en-fr',
-      'math-science-reasoning',
-      'philosophy-sociology-discernment',
-      'professional-boundary-triage',
-      'release-ethics-gate',
-      'source-authority-reviewer',
-    ],
-  },
-  {
-    key: 'frontend',
-    label: 'frontend-ui',
-    skills: [
-      'figma',
-      'figma-code-connect-components',
-      'figma-create-design-system-rules',
-      'figma-generate-design',
-      'figma-generate-library',
-      'figma-implement-design',
-      'figma-use',
-      'frontend-dev-guidelines',
-      'frontend-design',
-      'frontend-ui-ux-systems',
-      'nextjs',
-      'playwright',
-      'screenshot',
-      'senior-fullstack',
-      'shadcn',
-      'ui-component-primitives',
-      'webapp-testing',
-      'web-mobile-design-systems',
-      'winui-app',
-    ],
-  },
-  {
-    key: 'backend',
-    label: 'backend-data',
-    skills: [
-      'go-engineering',
-      'java-engineering',
-      'javascript-engineering',
-      'json-contract-design',
-      'mcp-builder',
-      'polyglot-backend-engineering',
-      'python-engineering',
-      'ruby-engineering',
-      'sql-postgresql-engineering',
-      'typescript-expert',
-    ],
-  },
-  {
-    key: 'ops',
-    label: 'ops-clients',
-    skills: [
-      'cli-creator',
-      'developer-workstation-ops',
-      'git-version-control-ops',
-      'github',
-      'mcp-client-readiness',
-      'multi-client-mcp-ops',
-      'openai-docs',
-      'skill-master-orchestrator',
-      'terminal-shell-ops',
-      'terminal-menu-operations',
-      'terminal-pixel-art-tui',
-      'windows-linux-platform-ops',
-    ],
-  },
-  {
-    key: 'knowledge',
-    label: 'knowledge',
-    skills: [
-      'language-quality-pt-en-fr-it-ru',
-      'math-physics-reasoning',
-    ],
-  },
-];
-
-const COMMAND_AREA_LABELS = {
-  status: 'diagnostico',
-  doctor: 'diagnostico',
-  check: 'desenvolvimento',
-  build: 'desenvolvimento',
-  publicNpm: 'distribuicao',
-  updateGlobal: 'distribuicao',
-  privateRegistry: 'registry',
-  activationStatus: 'ativacao',
-  activationBalanced: 'ativacao',
-  activationAlwaysOn: 'ativacao',
-  installGlobalSkills: 'skills-globais',
-  bootstrapGlobal: 'bootstrap-global',
-  registerClients: 'clientes-mcp',
-  promptRecommendation: 'roteamento',
-  successNotifications: 'aprendizado',
-  studySkills: 'aprendizado',
-  approvalPackage: 'aprovacao',
-  markLearnedStudy: 'aprovacao',
-  rejectLearnedSkill: 'aprovacao',
-  activateLearnedLocal: 'ativacao-skill',
-  activateLearnedGlobal: 'ativacao-skill',
-  notionSummary: 'documentacao',
-};
-
-function colorize(text, color, enabled) {
-  return enabled ? `${color}${text}${ANSI.reset}` : text;
-}
-
-function visibleLength(text) {
-  return String(text).replace(/\x1b\[[0-9;]*m/g, '').length;
-}
-
-function fitText(text, width) {
-  const value = String(text ?? '');
-  if (visibleLength(value) <= width) {
-    return `${value}${' '.repeat(width - visibleLength(value))}`;
-  }
-
-  return `${value.slice(0, Math.max(0, width - 1))}~`;
-}
-
-function splitText(text, width, maxLines = 3) {
-  const words = String(text ?? '').split(/\s+/).filter(Boolean);
-  const lines = [];
-  let current = '';
-
-  for (const word of words) {
-    const next = current ? `${current} ${word}` : word;
-    if (next.length <= width) {
-      current = next;
-      continue;
-    }
-    if (current) lines.push(current);
-    current = word.length > width ? word.slice(0, width - 1) + '~' : word;
-    if (lines.length >= maxLines) break;
-  }
-  if (current && lines.length < maxLines) lines.push(current);
-  return lines.length ? lines : [''];
-}
-
-function globalSkillsRoot() {
-  return join(process.env.CODEX_HOME ?? join(os.homedir(), '.codex'), 'skills');
-}
-
-function readClientConfigState(filePath) {
-  if (!existsSync(filePath)) {
-    return { present: false, kind: 'missing', globalCommand: false };
-  }
-
-  const content = readFileSync(filePath, 'utf8');
-  const assessment = assessCodexConfigContent(content);
-
-  return {
-    present: true,
-    kind: assessment.mode,
-    globalCommand: assessment.robust,
-    command: assessment.command,
-  };
-}
-
-function readJsonState(filePath) {
-  if (!existsSync(filePath)) {
-    return { present: false, kind: 'missing', globalCommand: false };
-  }
-
-  try {
-    const parsed = JSON.parse(readFileSync(filePath, 'utf8'));
-    const server = parsed?.mcpServers?.skill_master;
-    const assessment = assessMcpServerConfig(server);
-    return {
-      present: true,
-      kind: assessment.mode,
-      globalCommand: assessment.robust,
-      command: assessment.command,
-    };
-  } catch {
-    return { present: true, kind: 'invalid-json', globalCommand: false };
-  }
-}
-
-function inspectGlobalReadiness() {
-  const root = globalSkillsRoot();
-  const installed = REQUIRED_GLOBAL_SKILLS.filter((name) => existsSync(join(root, name, 'SKILL.md')));
-  const missing = REQUIRED_GLOBAL_SKILLS.filter((name) => !installed.includes(name));
-  const clientPaths = defaultClientConfigPaths();
-  const codex = readClientConfigState(clientPaths.codex);
-  const claude = readJsonState(clientPaths.claude);
-  const gemini = readJsonState(clientPaths.gemini);
-  const antigravity = readJsonState(clientPaths.antigravity);
-  const ready = missing.length === 0
-    && codex.globalCommand
-    && claude.globalCommand
-    && gemini.globalCommand
-    && antigravity.globalCommand;
-  const mode = ready
-    ? 'ready'
-    : codex.present || claude.present || gemini.present || antigravity.present
-      ? 'partial'
-      : 'missing';
-
-  return {
-    root,
-    required: REQUIRED_GLOBAL_SKILLS.length,
-    installed,
-    missing,
-    ready,
-    mode,
-    codex,
-    claude,
-    gemini,
-    antigravity,
-  };
-}
-
-export function readJson(rootDir, relativePath) {
-  const target = join(rootDir, relativePath);
-  if (!existsSync(target)) {
-    return null;
-  }
-
-  return JSON.parse(readFileSync(target, 'utf8'));
-}
-
-export function readText(rootDir, relativePath) {
-  const target = join(rootDir, relativePath);
-  if (!existsSync(target)) {
-    return null;
-  }
-
-  return readFileSync(target, 'utf8').trim();
-}
-
-export function getMenuStatus(rootDir) {
-  const packageJson = readJson(rootDir, 'package.json');
-  const stableManifest = readJson(rootDir, 'manifests/channels/stable.json');
-  const versionText = readText(rootDir, 'VERSION.md');
-  const successLearningDir = process.env.SKILL_MASTER_SUCCESS_LEARNING_DIR
-    ?? join(process.env.SKILL_MASTER_HOME ?? join(process.env.HOME ?? process.env.USERPROFILE ?? '', '.skill-master'), 'data', 'success-learning');
-  const studyCandidates = readJson(rootDir, 'network/unapproved-skill-candidates.json');
-  const globalReadiness = inspectGlobalReadiness();
-  const bundledCatalog = inspectBundledSkillCatalog(rootDir);
-
-  return {
-    packageName: packageJson?.name ?? 'nao encontrado',
-    semver: packageJson?.version ?? 'nao encontrado',
-    manifestVersion: stableManifest?.version ?? 'nao encontrado',
-    manifestSemver: stableManifest?.semver ?? 'nao encontrado',
-    versionText,
-    rootDir,
-    pendingSuccessDrafts: countManifestFiles(successLearningDir),
-    studyCandidates: Array.isArray(studyCandidates?.candidates) ? studyCandidates.candidates.length : 0,
-    globalReadiness,
-    bundledCatalog,
-  };
-}
-
-function countManifestFiles(directory) {
-  if (!directory || !existsSync(directory)) {
-    return 0;
-  }
-
-  let count = 0;
-  const visit = (current) => {
-    for (const entry of readdirSync(current, { withFileTypes: true })) {
-      const fullPath = join(current, entry.name);
-      if (entry.isDirectory()) visit(fullPath);
-      else if (entry.isFile() && entry.name === 'manifest.json') count += 1;
-    }
-  };
-
-  visit(directory);
-  return count;
-}
-
-function listBundledSkillNames(rootDir) {
-  const source = join(rootDir, 'docs', 'skill-candidates');
-  if (!existsSync(source)) {
-    return [];
-  }
-
-  const entries = readdirSync(source, { withFileTypes: true });
-  const directSkills = entries
-    .filter((entry) => entry.isDirectory() && existsSync(join(source, entry.name, 'SKILL.md')))
-    .map((entry) => entry.name);
-
-  if (directSkills.length) {
-    return Array.from(new Set(directSkills)).sort();
-  }
-
-  return Array.from(new Set(
-    entries
-      .filter((entry) => entry.isDirectory())
-      .flatMap((entry) => {
-        const versionPath = join(source, entry.name);
-        return readdirSync(versionPath, { withFileTypes: true })
-          .filter((skillEntry) => skillEntry.isDirectory() && existsSync(join(versionPath, skillEntry.name, 'SKILL.md')))
-          .map((skillEntry) => skillEntry.name);
-      }),
-  )).sort();
-}
-
-function inspectBundledSkillCatalog(rootDir) {
-  const names = listBundledSkillNames(rootDir);
-  const categories = BUNDLED_SKILL_DOMAIN_GROUPS.map((group) => ({
-    key: group.key,
-    label: group.label,
-    count: group.skills.filter((skill) => names.includes(skill)).length,
-  }));
-
-  return {
-    total: names.length,
-    names,
-    categories,
-  };
-}
-
-function formatBundledCategoryLine(catalog) {
-  if (!catalog?.categories?.length) {
-    return 'bundled skills: 0';
-  }
-
-  return catalog.categories
-    .filter((category) => category.count > 0)
-    .map((category) => `${category.label} ${category.count}`)
-    .join(' | ');
-}
-
-function resolveCommandArea(action) {
-  if (!action) {
-    return 'geral';
-  }
-
-  return COMMAND_AREA_LABELS[action.key] ?? 'geral';
-}
-
-function formatActionCommand(action) {
-  if (!action?.command) {
-    return '';
-  }
-
-  return [action.command, ...(action.args ?? [])].join(' ');
-}
-
-export function buildMenuCommands({ rootDir, currentFile, nodeExecPath = process.execPath }) {
-  const isDevCheckout = existsSync(join(rootDir, 'tsconfig.json')) && existsSync(join(rootDir, 'src'));
-  const repoOnlyReason = 'Disponivel apenas no clone de desenvolvimento; no pacote npm use Doctor ou Status.';
-
-  return [
-    {
-      key: 'status',
-      aliases: ['status'],
-      label: 'Status local',
-      description: 'Mostra versao local, manifesto e informacoes do pacote.',
-      details: ['Nao altera arquivos.', 'Use para confirmar se o menu esta lendo a instalacao correta.'],
-      success: 'Relatorio impresso com versao, canal, skills globais e clientes configurados.',
-      command: nodeExecPath,
-      args: [currentFile, '--status'],
-    },
-    {
-      key: 'doctor',
-      aliases: ['doctor', 'diagnostico', 'verificar-menu', 'validar-menu'],
-      label: 'Doctor do menu e clientes MCP',
-      description: 'Valida pacote, binarios, skills globais e registros em Codex, Claude, Gemini e Antigravity.',
-      details: ['Seguro para outros notebooks.', 'Nao publica versao e nao mexe em configuracoes sem uma acao separada.'],
-      success: 'Mostra um relatorio GO/NO-GO com proximos comandos recomendados.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-doctor.mjs')],
-    },
-    {
-      key: 'check',
-      aliases: ['check', 'gate'],
-      label: 'Rodar gate completo',
-      description: 'Executa build, testes e validacao de manifestos.',
-      details: ['Exige clone do repositorio com src, testes e tsconfig.', 'Nao e uma acao indicada para instalacao global via npm.'],
-      success: 'Build, testes e manifestos passam no checkout de desenvolvimento.',
-      disabledReason: isDevCheckout ? null : repoOnlyReason,
-      command: 'npm',
-      args: ['run', 'check'],
-    },
-    {
-      key: 'build',
-      aliases: ['build'],
-      label: 'Rodar build',
-      description: 'Compila o projeto localmente.',
-      details: ['Exige clone do repositorio com tsconfig.', 'Pacotes npm publicados ja usam dist precompilado.'],
-      success: 'dist atualizado no checkout de desenvolvimento.',
-      disabledReason: isDevCheckout ? null : repoOnlyReason,
-      command: 'npm',
-      args: ['run', 'build'],
-    },
-    {
-      key: 'publicNpm',
-      aliases: ['public-npm', 'npm', 'registry'],
-      label: 'Validar pacote no npm publico',
-      description: 'Consulta a versao publicada em registry.npmjs.org.',
-      details: ['Usa somente leitura no registry publico.', 'Bom para confirmar se outro notebook consegue instalar por npm.'],
-      success: 'Retorna a versao publicada atualmente no npmjs.',
-      command: 'npm',
-      args: [
-        'view',
-        '@fprad0/skill-master-mcp',
-        'version',
-        '--registry=https://registry.npmjs.org',
-      ],
-    },
-    {
-      key: 'updateGlobal',
-      aliases: ['update', 'update-global'],
-      label: 'Atualizar pacote global via npm',
-      description: 'Atualiza a instalacao global e exige reinicio do cliente MCP.',
-      details: ['Roda npm install -g fora do processo MCP stdio.', 'Use antes de abrir Codex, Claude, Gemini ou Antigravity.'],
-      success: 'Pacote global atualizado para a versao latest do npm publico.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-update.mjs')],
-      confirmMessage: 'Atualizar o pacote global agora?',
-    },
-    {
-      key: 'privateRegistry',
-      aliases: ['private-registry', 'private', 'github-packages'],
-      label: 'Configurar registry privado GitHub Packages',
-      description: 'Prepara o .npmrc e valida o acesso ao pacote privado.',
-      details: ['Uso avancado para ambientes privados.', 'Nao e necessario para o pacote publico do npmjs.'],
-      success: '.npmrc configurado e validacao npm view executada.',
-      command: nodeExecPath,
-      args: ['scripts/configure-private-registry.mjs', '--validate'],
-      confirmMessage: 'Rodar a configuracao de registry privado agora?',
-    },
-    {
-      key: 'activationStatus',
-      aliases: ['activation-status', 'modo', 'modo-ativacao'],
-      label: 'Modo de ativacao atual',
-      description: 'Mostra o modo manual, balanced ou always-on-assisted configurado localmente.',
-      details: ['Nao altera configuracao.', 'Ajuda a entender quando o Skill Master deve sugerir skills.'],
-      success: 'Modo atual e caminho da configuracao impressos no terminal.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--status'],
-    },
-    {
-      key: 'activationBalanced',
-      aliases: ['set-balanced', 'balanced'],
-      label: 'Usar modo balanced',
-      description: 'Define balanced como modo padrao de ativacao do Skill Master.',
-      details: ['Recomendado para uso diario.', 'Ativa o MCP quando ha ganho claro para o prompt.'],
-      success: 'Modo balanced salvo localmente.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--set-mode', 'balanced'],
-    },
-    {
-      key: 'activationAlwaysOn',
-      aliases: ['set-always-on', 'always-on-assisted'],
-      label: 'Usar modo always-on-assisted',
-      description: 'Define avaliacao assistida quase sempre ativa, mantendo no-op quando nao houver ganho.',
-      details: ['Mais agressivo que balanced.', 'Indicado para usuarios que querem o Skill Master avaliando quase todos os prompts.'],
-      success: 'Modo always-on-assisted salvo localmente.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--set-mode', 'always-on-assisted'],
-      confirmMessage: 'Alterar o modo local para always-on-assisted?',
-    },
-    {
-      key: 'installGlobalSkills',
-      aliases: ['install-global-skills', 'skills-globais', 'global-skills'],
-      label: 'Instalar skills globais do Skill Master',
-      description: 'Copia as skills amplas e morais embutidas para CODEX_HOME/skills ou ~/.codex/skills.',
-      details: ['Necessario para Codex descobrir as skills globais.', 'Pode ser reexecutado com seguranca pelo bootstrap.'],
-      success: 'Skills globais copiadas para a pasta global do usuario.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-install-global-skills.mjs')],
-      confirmMessage: 'Instalar as skills globais embutidas neste usuario?',
-    },
-    {
-      key: 'bootstrapGlobal',
-      aliases: ['bootstrap-global', 'global-bootstrap', 'ativar-global-completo'],
-      label: 'Ativar MCP global neste computador',
-      description: 'Instala skills globais e registra Codex, Claude, Gemini e Antigravity no mesmo passo.',
-      details: ['Acao principal para notebooks novos.', 'Depois reinicie os clientes para eles recarregarem MCP e skills.'],
-      success: 'Skills instaladas e configuracoes MCP aplicadas nos clientes encontrados.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-bootstrap-global.mjs')],
-      confirmMessage: 'Executar o bootstrap global do Skill Master neste computador?',
-    },
-    {
-      key: 'registerClients',
-      aliases: ['register-clients', 'registrar-clientes', 'codex-claude-gemini', 'antigravity'],
-      label: 'Registrar clientes MCP',
-      description: 'Gera/aplica configuracoes MCP para Codex, Claude, Gemini e Antigravity reconhecerem skill_master.',
-      details: ['Usa Node absoluto + bin/skill-master.mjs absoluto.', 'Preserva outros servidores MCP ja existentes nos JSONs.'],
-      success: 'Arquivos de configuracao mesclados com o servidor skill_master.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-register-clients.mjs'), '--apply-all'],
-      confirmMessage: 'Aplicar registro do skill_master em Codex, Claude, Gemini e Antigravity?',
-    },
-    {
-      key: 'promptRecommendation',
-      aliases: ['recommend-prompt', 'recomendar-prompt', 'prompt-router'],
-      label: 'Ver recomendacao para um prompt',
-      description: 'Abre um fluxo interativo para avaliar um prompt pelo router local.',
-      details: ['Ajuda a decidir se skill-master, skill_master ou skill-master-mcp deve agir.', 'Nao publica nem altera skills.'],
-      success: 'Router imprime recomendacao, modo de ativacao e gates aplicaveis.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--route-prompt-interactive'],
-    },
-    {
-      key: 'successNotifications',
-      aliases: ['notifications', 'notificacoes', 'success-notifications'],
-      label: 'Notificacoes de skills aprendidas',
-      description: 'Mostra drafts pendentes, aprovacoes e skills externas para estudar.',
-      details: ['Use para decidir o que aprovar, estudar ou rejeitar.', 'Nao ativa skill automaticamente.'],
-      success: 'Lista de pendencias e proximas acoes exibida.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--notify'],
-    },
-    {
-      key: 'studySkills',
-      aliases: ['study-skills', 'skills-estudo', 'estudar'],
-      label: 'Skills para estudar',
-      description: 'Lista skills externas e links de criadores ainda nao aprovados.',
-      details: ['Material de estudo, nao ativacao operacional.', 'Bom para revisao humana antes de virar skill local/global.'],
-      success: 'Links e motivos de estudo exibidos.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--study'],
-    },
-    {
-      key: 'approvalPackage',
-      aliases: ['approval-package', 'aprovar', 'pacote-aprovacao'],
-      label: 'Gerar pacote de aprovacao humana',
-      description: 'Cria um relatorio local para revisar e aprovar skills aprendidas.',
-      details: ['Exige decisao humana antes de ativacao.', 'Inclui riscos, evidencias e recomendacao.'],
-      success: 'Pacote local de aprovacao gerado.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--approval-package'],
-    },
-    {
-      key: 'markLearnedStudy',
-      aliases: ['mark-study', 'manter-estudo'],
-      label: 'Manter skill candidata para estudo',
-      description: 'Seleciona uma candidata e registra decisao de manter para estudo.',
-      details: ['Preserva historico sem ativar a skill.', 'Use quando a fonte ainda precisa revisao.'],
-      success: 'Decisao registrada no historico local.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--mark-study-interactive'],
-    },
-    {
-      key: 'rejectLearnedSkill',
-      aliases: ['reject-skill', 'rejeitar-skill'],
-      label: 'Rejeitar skill candidata',
-      description: 'Seleciona uma candidata, registra rejeicao e preserva historico.',
-      details: ['Nao apaga evidencias.', 'Use quando risco, fonte ou utilidade nao passam no gate.'],
-      success: 'Rejeicao registrada com motivo.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--reject-interactive'],
-      confirmMessage: 'Abrir fluxo para rejeitar uma skill candidata?',
-    },
-    {
-      key: 'activateLearnedLocal',
-      aliases: ['activate-learned-local', 'ativar-local', 'skill-local'],
-      label: 'Ativar skill aprendida no workspace',
-      description: 'Instala uma skill aprendida em .codex/skills do projeto atual.',
-      details: ['Escopo limitado ao workspace.', 'Mais conservador que ativar globalmente.'],
-      success: 'Skill copiada para .codex/skills do projeto.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--activate-interactive', '--target', 'local'],
-      confirmMessage: 'Selecionar e ativar uma skill aprendida no workspace atual?',
-    },
-    {
-      key: 'activateLearnedGlobal',
-      aliases: ['activate-learned-global', 'ativar-global', 'skill-global'],
-      label: 'Ativar skill aprendida global',
-      description: 'Instala uma skill aprendida em CODEX_HOME/skills ou ~/.codex/skills.',
-      details: ['Afeta todos os projetos deste usuario.', 'Use apenas depois de aprovacao humana.'],
-      success: 'Skill instalada no diretorio global de skills.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--activate-interactive', '--target', 'global'],
-      confirmMessage: 'Selecionar e ativar uma skill aprendida como skill global deste usuario?',
-    },
-    {
-      key: 'notionSummary',
-      aliases: ['notion-summary', 'resumo-notion'],
-      label: 'Abrir resumo para Notion',
-      description: 'Mostra um resumo copiavel do estado de ativacao para registrar no ledger Notion.',
-      details: ['Nao escreve no Notion sozinho.', 'Gera texto de continuidade para documentacao.'],
-      success: 'Resumo pronto para registro exibido.',
-      command: nodeExecPath,
-      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--notion-summary'],
-    },
-  ];
-}
-
-export function buildMenuChoices(commands) {
-  return commands.map((command) => ({
-    title: command.label,
-    description: [command.description, command.success ? `Resultado: ${command.success}` : null].filter(Boolean).join(' '),
-    value: command.key,
-    disabled: command.disabledReason ?? false,
-  })).concat({
-    title: 'Sair',
-    description: 'Fecha o menu operacional.',
-    value: '__exit__',
-  });
-}
-
-export function resolveActionKey(input, commands) {
-  const normalized = (input ?? '').trim().toLowerCase();
-  if (!normalized) {
-    return null;
-  }
-
-  return commands.find((command) =>
-    command.key.toLowerCase() === normalized || command.aliases.includes(normalized),
-  )?.key ?? null;
-}
-
-export function isInteractiveTerminal() {
-  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
-}
-
-export function formatStatusReport(status) {
-  const readiness = status.globalReadiness;
-  const bundledCatalog = status.bundledCatalog ?? { total: 0, categories: [] };
-  const lines = [
-    'Skill Master MCP - status local',
-    `Diretorio: ${status.rootDir}`,
-    `Pacote: ${status.packageName}`,
-    `Semver local: ${status.semver}`,
-    `Manifesto stable: ${status.manifestVersion}`,
-    `Manifesto semver: ${status.manifestSemver}`,
-    `Drafts de skills aprendidas: ${status.pendingSuccessDrafts}`,
-    `Skills externas para estudar: ${status.studyCandidates}`,
-    `Global readiness: ${readiness.ready ? 'pronto' : readiness.mode}`,
-    `Global skills instaladas: ${readiness.installed.length}/${readiness.required}`,
-    `Bundle de skills embutidas: ${bundledCatalog.total}`,
-    `Dominios do bundle: ${formatBundledCategoryLine(bundledCatalog)}`,
-    `Codex MCP robusto: ${readiness.codex.globalCommand ? 'sim' : readiness.codex.kind}`,
-    `Claude MCP robusto: ${readiness.claude.globalCommand ? 'sim' : readiness.claude.kind}`,
-    `Gemini MCP robusto: ${readiness.gemini.globalCommand ? 'sim' : readiness.gemini.kind}`,
-    `Antigravity MCP robusto: ${readiness.antigravity.globalCommand ? 'sim' : readiness.antigravity.kind}`,
-  ];
-
-  if (status.versionText) {
-    lines.push('', 'VERSION.md:');
-    lines.push(...status.versionText.split('\n').slice(0, 6));
-  }
-
-  return lines.join('\n');
-}
-
-function formatGlobalAlert(status, { useColor = false } = {}) {
-  const readiness = status.globalReadiness;
-  if (readiness.ready) {
-    return renderPanelLines(
-      [
-        colorize('GLOBAL READY', ANSI.bold, useColor),
-        'O MCP esta registrado de forma robusta neste computador.',
-        'Codex, Claude, Gemini e Antigravity podem iniciar com Node absoluto.',
-        'A instalacao global e as skills embutidas ja estao prontas para uso.',
-      ],
-      { color: ANSI.green, useColor },
-    );
-  }
-
-  return [
-    renderPanelLines(
-      [
-        colorize('ALERTA GLOBAL', ANSI.bold, useColor),
-        'Este computador ainda nao esta pronto para uso global do Skill Master.',
-        'Execute agora: skill-master-menu --run bootstrap-global --yes',
-        'Isso instala as skills globais e registra Codex, Claude, Gemini e Antigravity com Node absoluto.',
-      ],
-      { color: ANSI.red, useColor },
-    ),
-    renderPanelLines(
-      [
-        colorize('AVISO SUTIL', ANSI.dim, useColor),
-        'Sem instalacao global, o MCP continua util localmente, mas nao fica integrado como parte do sistema em todos os clientes.',
-        `Skills globais detectadas: ${readiness.installed.length}/${readiness.required}`,
-      ],
-      { color: ANSI.yellow, useColor },
-    ),
-  ].join('\n\n');
-}
-
-function renderPanelLines(lines, { color = ANSI.cyan, useColor = false } = {}) {
-  const width = Math.max(...lines.map((line) => line.length), 24);
-  const border = `+${'-'.repeat(width + 2)}+`;
-  const paintedBorder = colorize(border, color, useColor);
-  const body = lines.map((line) => `| ${line.padEnd(width)} |`);
-  return [paintedBorder, ...body, paintedBorder].join('\n');
-}
-
-export function formatMenuBanner(status, { useColor = false } = {}) {
-  const bundledCatalog = status.bundledCatalog ?? { total: 0, categories: [] };
-  const lines = [
-    colorize('Skill Master MCP', ANSI.bold, useColor),
-    'Menu operacional para manutencao local',
-    `Versao local ${status.semver}  |  canal ${status.manifestVersion}`,
-    `Pendencias: ${status.pendingSuccessDrafts} drafts  |  estudo: ${status.studyCandidates} links`,
-    `Global: ${status.globalReadiness.ready ? 'pronto' : 'requer instalacao global'}`,
-    `Bundle: ${bundledCatalog.total} skills  |  ${formatBundledCategoryLine(bundledCatalog)}`,
-    colorize('Setas + Enter para navegar', ANSI.dim, useColor),
-  ];
-  return [
-    renderPanelLines(lines, { color: ANSI.cyan, useColor }),
-    formatGlobalAlert(status, { useColor }),
-  ].join('\n\n');
-}
-
-function dnaPanelLines(tick, width, height, status, { useColor = false, compact = false } = {}) {
-  const lines = [];
-  const center = Math.floor(width / 2);
-  const graphLeft = 2;
-  const graphRight = Math.max(graphLeft + 8, width - 3);
-  const graphWidth = Math.max(10, graphRight - graphLeft + 1);
-  const radius = Math.max(3, Math.floor((graphWidth - 4) / 3.35));
-  const phase = tick / 6;
-  const bodyHeight = Math.max(compact ? 6 : 8, height - (compact ? 5 : 6));
-  const scanRow = bodyHeight > 0 ? tick % bodyHeight : 0;
-
-  lines.push(fitText(colorize('GENOME MATRIX', ANSI.bold, useColor), width));
-  lines.push(fitText(colorize(compact ? 'lab helix / scan stable' : 'procedural intelligence helix', ANSI.dim, useColor), width));
-  if (!compact) {
-    lines.push(fitText(colorize('signal map / sync locked / low flicker', ANSI.gray, useColor), width));
-  }
-
-  const place = (cells, col, char, color) => {
-    if (col >= 0 && col < width) cells[col] = colorize(char, color, useColor);
-  };
-
-  for (let row = 0; row < bodyHeight; row += 1) {
-    const angle = row * 0.49 + phase;
-    const left = Math.round(center + Math.sin(angle) * radius);
-    const right = Math.round(center + Math.sin(angle + Math.PI) * radius);
-    const min = Math.min(left, right);
-    const max = Math.max(left, right);
-    const chars = Array.from({ length: width }, () => ' ');
-    const front = Math.cos(angle) >= 0;
-    const leftColor = front ? ANSI.teal : ANSI.blue;
-    const rightColor = front ? ANSI.amber : ANSI.gray;
-    const bondColor = front ? ANSI.gray : ANSI.blue;
-    const scanActive = row === scanRow;
-
-    place(chars, graphLeft, row === 0 ? '┌' : row === bodyHeight - 1 ? '└' : '│', ANSI.gray);
-    place(chars, graphRight, row === 0 ? '┐' : row === bodyHeight - 1 ? '┘' : '│', ANSI.gray);
-
-    if (row === 0 || row === bodyHeight - 1) {
-      for (let col = graphLeft + 1; col < graphRight; col += 1) {
-        place(chars, col, '─', ANSI.gray);
-      }
-    }
-
-    for (let col = min + 2; col < max - 1; col += 1) {
-      const rungChar = row % 4 < 2 ? '═' : '─';
-      place(chars, col, scanActive ? '█' : rungChar, scanActive ? ANSI.white : bondColor);
-    }
-
-    place(chars, left - 1, '▓', leftColor);
-    place(chars, left, scanActive ? '█' : row % 2 === 0 ? '█' : '▓', scanActive ? ANSI.white : leftColor);
-    place(chars, left + 1, '▓', leftColor);
-    place(chars, right - 1, '▓', rightColor);
-    place(chars, right, scanActive ? '█' : row % 2 === 0 ? '█' : '▓', scanActive ? ANSI.white : rightColor);
-    place(chars, right + 1, '▓', rightColor);
-
-    if (row % 4 === 1 || row % 4 === 2) {
-      place(chars, center, scanActive ? '◆' : '◆', scanActive ? ANSI.white : ANSI.gray);
-    }
-
-    lines.push(chars.join(''));
-  }
-
-  lines.push(fitText('', width));
-  lines.push(fitText(colorize(compact ? 'helix stable' : 'helix stable   lattice aligned', ANSI.gray, useColor), width));
-  lines.push(fitText(colorize(compact ? `global ${status.globalReadiness.installed.length}/${status.globalReadiness.required}` : `global ${status.globalReadiness.installed.length}/${status.globalReadiness.required}   clients linked`, ANSI.amber, useColor), width));
-
-  return lines.slice(0, height).map((line) => fitText(line, width));
-}
-
-function renderMeterBar(value, total, width, { useColor = false, color = ANSI.teal } = {}) {
-  const safeTotal = Math.max(1, total);
-  const safeValue = Math.max(0, Math.min(value, safeTotal));
-  const fill = Math.round((safeValue / safeTotal) * width);
-  const filled = '█'.repeat(fill);
-  const empty = '░'.repeat(Math.max(0, width - fill));
-  return `${colorize(filled, color, useColor)}${colorize(empty, ANSI.gray, useColor)}`;
-}
-
-function renderSparkline(series, { useColor = false, color = ANSI.teal } = {}) {
-  const blocks = ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█'];
-  return series.map((value) => colorize(blocks[Math.max(0, Math.min(blocks.length - 1, value))], color, useColor)).join('');
-}
-
-function buildTelemetrySeries(seed, length, tick) {
-  return Array.from({ length }, (_, index) => {
-    const raw = Math.sin((index + 1 + seed) * 0.72 + tick * 0.18) + Math.cos((index + seed) * 0.33 + tick * 0.11);
-    const normalized = Math.max(0, Math.min(1, (raw + 2) / 4));
-    return Math.round(normalized * 7);
-  });
-}
-
-function buildOverviewSignalLine(status, width, tick, { useColor = false, compact = false } = {}) {
-  const signalWidth = Math.max(6, Math.min(compact ? 8 : 12, Math.floor(width / (compact ? 10 : 8))));
-  const healthWidth = Math.max(6, Math.min(compact ? 8 : 12, Math.floor(width / (compact ? 10 : 8))));
-  const signal = renderSparkline(
-    buildTelemetrySeries(status.globalReadiness.installed.length + status.pendingSuccessDrafts, signalWidth, tick),
-    { useColor, color: ANSI.teal },
-  );
-  const health = renderSparkline(
-    buildTelemetrySeries(status.studyCandidates + (status.globalReadiness.ready ? 7 : 3), healthWidth, tick + 3),
-    { useColor, color: ANSI.amber },
-  );
-  return compact
-    ? `signal ${signal} health ${health}`
-    : `signal ${signal}   health ${health}`;
-}
-
-function telemetryPanelLines(status, selected, width, height, { useColor = false, tick = 0, compact = false } = {}) {
-  const commandArea = resolveCommandArea(selected);
-  const bundledCatalog = status.bundledCatalog ?? { total: 0, categories: [] };
-  const categoryLead = bundledCatalog.categories
-    ?.filter((category) => category.count > 0)
-    .sort((left, right) => right.count - left.count)[0];
-  const categoryName = categoryLead?.label ?? 'none';
-  const categoryCount = categoryLead?.count ?? 0;
-  const meterWidth = Math.max(8, Math.min(16, width - 14));
-  const sparkWidth = Math.max(8, Math.min(compact ? 8 : 12, width - 18));
-  const skillsSpark = renderSparkline(buildTelemetrySeries(status.globalReadiness.installed.length + categoryCount, sparkWidth, tick), { useColor, color: ANSI.amber });
-  const draftsSpark = renderSparkline(buildTelemetrySeries(status.pendingSuccessDrafts + 2, sparkWidth, tick + 2), { useColor, color: ANSI.teal });
-  const studySpark = renderSparkline(buildTelemetrySeries(status.studyCandidates + 4, sparkWidth, tick + 4), { useColor, color: ANSI.blue });
-  const lines = [
-    fitText(colorize('SYSTEM WINDOWS', ANSI.bold, useColor), width),
-    fitText(colorize(`selected area  ${commandArea}`, ANSI.gray, useColor), width),
-    fitText(colorize(`dominant skill  ${categoryName} ${categoryCount}`, ANSI.gray, useColor), width),
-    fitText(`bundle   ${String(bundledCatalog.total).padStart(2, '0')}  ${renderMeterBar(bundledCatalog.total, Math.max(36, bundledCatalog.total), meterWidth, { useColor, color: ANSI.white })}`, width),
-    fitText(`global   ${status.globalReadiness.installed.length}/${status.globalReadiness.required} ${renderMeterBar(status.globalReadiness.installed.length, status.globalReadiness.required, meterWidth, { useColor, color: ANSI.amber })}`, width),
-    fitText(`skills   ${skillsSpark}`, width),
-    fitText(`drafts   ${String(status.pendingSuccessDrafts).padStart(2, '0')}  ${renderMeterBar(status.pendingSuccessDrafts, Math.max(6, status.pendingSuccessDrafts || 1), meterWidth, { useColor, color: ANSI.teal })}`, width),
-    fitText(`queue    ${draftsSpark}`, width),
-    fitText(`study    ${String(status.studyCandidates).padStart(2, '0')}  ${renderMeterBar(status.studyCandidates, Math.max(8, status.studyCandidates || 1), meterWidth, { useColor, color: ANSI.blue })}`, width),
-    fitText(`links    ${studySpark}`, width),
-    fitText(colorize(compact ? 'codex / claude / gemini' : 'codex / claude / gemini / antigravity', ANSI.dim, useColor), width),
-  ];
-
-  return lines.slice(0, height).map((line) => fitText(line, width));
-}
-
-function renderBox(lines, width, title, { useColor = false, color = ANSI.cyan, style = 'normal' } = {}) {
-  const innerWidth = Math.max(10, width - 4);
-  const titleText = title ? ` ${title.toUpperCase()} ` : '';
-  const topLeft = style === 'focus' ? '╭' : style === 'hud' ? '┏' : '┌';
-  const topRight = style === 'focus' ? '╮' : style === 'hud' ? '┓' : '┐';
-  const bottomLeft = style === 'focus' ? '╰' : style === 'hud' ? '┗' : '└';
-  const bottomRight = style === 'focus' ? '╯' : style === 'hud' ? '┛' : '┘';
-  const topFill = style === 'focus' ? '═' : '─';
-  const bottomTail = style === 'focus' ? '══' : '┄┄';
-  const top = `${topLeft}${titleText}${topFill.repeat(Math.max(0, width - 2 - titleText.length))}${topRight}`;
-  const bottom = `${bottomLeft}${topFill.repeat(Math.max(0, width - 4))}${bottomTail}${bottomRight}`;
-  const body = lines.map((line, index) => {
-    const left = index === 0
-      ? (style === 'focus' ? '╞' : '├')
-      : index === lines.length - 1
-        ? (style === 'focus' ? '╘' : '╰')
-        : '│';
-    const right = index === 0
-      ? (style === 'focus' ? '╡' : '┤')
-      : index === lines.length - 1
-        ? (style === 'focus' ? '╛' : '╯')
-        : '│';
-    return `${colorize(left, color, useColor)} ${fitText(line, innerWidth)} ${colorize(right, color, useColor)}`;
-  });
-  return [
-    colorize(top, color, useColor),
-    ...body,
-    colorize(bottom, color, useColor),
-  ];
-}
-
-function joinHorizontalBoxes(boxes, gutter = 2) {
-  const height = Math.max(...boxes.map((box) => box.lines.length));
-  const gap = ' '.repeat(gutter);
-  const rows = [];
-
-  for (let index = 0; index < height; index += 1) {
-    rows.push(boxes.map((box) => box.lines[index] ?? ' '.repeat(box.width)).join(gap));
-  }
-
-  return rows;
-}
-
-export function formatCyberMenuFrame(status, commands, selectedIndex, tick = 0, {
-  columns = 120,
-  rows = 32,
-  useColor = false,
-} = {}) {
-  const width = Math.max(72, Math.min(columns, 150));
-  const height = Math.max(22, Math.min(rows - 1, 42));
-  const compactMode = width < 104 || height < 27;
-  const rightWidth = compactMode ? (width >= 92 ? 28 : 26) : width >= 132 ? 44 : width >= 108 ? 38 : 30;
-  const gutter = 2;
-  const leftWidth = width - rightWidth - gutter;
-  const selected = commands[selectedIndex] ?? commands[0];
-  const actionArea = resolveCommandArea(selected);
-  const bundledCatalog = status.bundledCatalog ?? { total: 0, categories: [] };
-  const summaryOuterHeight = compactMode ? 7 : 8;
-  const bodyOuterHeight = Math.max(12, height - summaryOuterHeight - 1);
-  const detailOuterHeight = compactMode
-    ? Math.min(8, Math.max(7, Math.floor(bodyOuterHeight * 0.46)))
-    : Math.min(10, Math.max(8, Math.floor(bodyOuterHeight * 0.42)));
-  const actionOuterHeight = compactMode
-    ? Math.max(8, bodyOuterHeight - detailOuterHeight)
-    : Math.max(8, bodyOuterHeight - detailOuterHeight);
-  const rightBottomOuterHeight = compactMode
-    ? Math.min(8, Math.max(7, Math.floor(bodyOuterHeight * 0.4)))
-    : Math.min(10, Math.max(8, Math.floor(bodyOuterHeight * 0.34)));
-  const rightTopOuterHeight = Math.max(8, bodyOuterHeight - rightBottomOuterHeight);
-  const summaryInnerWidth = width - 4;
-  const actionInnerWidth = leftWidth - 4;
-  const detailInnerWidth = leftWidth - 4;
-  const rightInnerWidth = rightWidth - 4;
-  const summaryInnerHeight = summaryOuterHeight - 2;
-  const actionInnerHeight = actionOuterHeight - 2;
-  const detailInnerHeight = detailOuterHeight - 2;
-  const rightTopInnerHeight = rightTopOuterHeight - 2;
-  const rightBottomInnerHeight = rightBottomOuterHeight - 2;
-  const visibleActionRows = Math.max(compactMode ? 2 : 3, actionInnerHeight - (compactMode ? 2 : 3));
-  const scrollStart = Math.min(
-    Math.max(0, selectedIndex - Math.floor(visibleActionRows / 2)),
-    Math.max(0, commands.length - visibleActionRows),
-  );
-  const visibleCommands = commands.slice(scrollStart, scrollStart + visibleActionRows);
-
-  const summaryLines = compactMode
-    ? [
-        colorize('SKILL MASTER MENU', ANSI.bold, useColor),
-      `version ${status.semver} | channel ${status.manifestVersion} | readiness ${status.globalReadiness.ready ? 'ready' : status.globalReadiness.mode}`,
-      colorize(`GLOBAL SKILLS ${status.globalReadiness.installed.length}/${status.globalReadiness.required}`, ANSI.amber, useColor),
-      `bundle ${bundledCatalog.total} | drafts ${status.pendingSuccessDrafts} | study ${status.studyCandidates}`,
-      buildOverviewSignalLine(status, summaryInnerWidth, tick, { useColor, compact: true }),
-      colorize('compact cyberpunk hud / operator safe', ANSI.dim, useColor),
-    ]
-    : [
-        colorize('SKILL MASTER MENU', ANSI.bold, useColor),
-        `version ${status.semver} | channel ${status.manifestVersion} | readiness ${status.globalReadiness.ready ? 'ready' : status.globalReadiness.mode}`,
-        colorize(`GLOBAL SKILLS ${status.globalReadiness.installed.length}/${status.globalReadiness.required}`, ANSI.amber, useColor),
-        `bundle ${bundledCatalog.total} | drafts ${status.pendingSuccessDrafts} | study ${status.studyCandidates}`,
-        buildOverviewSignalLine(status, summaryInnerWidth, tick, { useColor, compact: false }),
-        formatBundledCategoryLine(bundledCatalog),
-        colorize('workflow windows / cyberpunk terminal / operator safe', ANSI.dim, useColor),
-      ];
-
-  const actionLines = [
-    colorize('ACTION GRID', ANSI.gray, useColor),
-    colorize('up/down move  enter run  q exit', ANSI.dim, useColor),
-    ...visibleCommands.map((command, offset) => {
-    const index = scrollStart + offset;
-    const marker = index === selectedIndex ? '▸' : '·';
-    const disabled = command.disabledReason ? ' [off]' : '';
-    const label = `${marker} ${command.label}${disabled}`;
-    return index === selectedIndex
-      ? colorize(fitText(label, actionInnerWidth), ANSI.teal, useColor)
-      : fitText(label, actionInnerWidth);
-    }),
-  ];
-
-  while (actionLines.length < actionInnerHeight) {
-    actionLines.push(fitText('', actionInnerWidth));
-  }
-
-  const descriptionLines = [
-    colorize('DETAIL FOCUS', ANSI.amber, useColor),
-    colorize(selected?.label ?? 'Nenhuma acao', ANSI.bold, useColor),
-    fitText(colorize(`area ${actionArea} | action ${Math.min(selectedIndex + 1, commands.length)}/${commands.length}`, ANSI.gray, useColor), detailInnerWidth),
-    fitText(colorize('────────────────────────────────', ANSI.amber, useColor), detailInnerWidth),
-    ...splitText(selected?.description, detailInnerWidth, 1),
-    ...splitText(selected?.success ? `resultado: ${selected.success}` : '', detailInnerWidth, 1),
-    ...splitText(`exec: ${formatActionCommand(selected)}`, detailInnerWidth, 1),
-    ...(selected?.confirmMessage ? splitText(`confirmacao: ${selected.confirmMessage}`, detailInnerWidth, 2) : []),
-    ...(selected?.disabledReason ? splitText(`Indisponivel: ${selected.disabledReason}`, detailInnerWidth, 2) : []),
-  ];
-
-  while (descriptionLines.length < detailInnerHeight) {
-    descriptionLines.push(fitText('', detailInnerWidth));
-  }
-
-  const rightTopLines = dnaPanelLines(tick, rightInnerWidth, rightTopInnerHeight, status, { useColor, compact: compactMode });
-  const rightBottomLines = telemetryPanelLines(status, selected, rightInnerWidth, rightBottomInnerHeight, { useColor, tick, compact: compactMode });
-  const summaryBox = renderBox(
-    summaryLines.slice(0, summaryInnerHeight).map((line) => fitText(line, summaryInnerWidth)),
-    width,
-    'overview',
-    { useColor, color: ANSI.white, style: 'hud' },
-  );
-  const actionBox = renderBox(
-    actionLines.slice(0, actionInnerHeight).map((line) => fitText(line, actionInnerWidth)),
-    leftWidth,
-    'actions',
-    { useColor, color: ANSI.gray, style: 'normal' },
-  );
-  const detailBox = renderBox(
-    descriptionLines.slice(0, detailInnerHeight).map((line) => fitText(line, detailInnerWidth)),
-    leftWidth,
-    'details',
-    { useColor, color: ANSI.amber, style: 'focus' },
-  );
-  const dnaBox = renderBox(rightTopLines, rightWidth, 'dna-core', { useColor, color: ANSI.white, style: 'hud' });
-  const telemetryBox = renderBox(rightBottomLines, rightWidth, 'telemetry', { useColor, color: ANSI.blue, style: 'normal' });
-  const bodyRows = joinHorizontalBoxes([
-    { lines: [...actionBox, ...detailBox], width: leftWidth },
-    { lines: [...dnaBox, ...telemetryBox], width: rightWidth },
-  ], gutter);
-
-  return [...summaryBox, '', ...bodyRows].join('\n');
-}
-
-export function formatRunningActionFrame(status, action, tick = 0, {
-  columns = 120,
-  rows = 32,
-  useColor = false,
-} = {}) {
-  const width = Math.max(72, Math.min(columns, 150));
-  const height = Math.max(18, Math.min(rows - 1, 30));
-  const innerWidth = width - 4;
-  const commandArea = resolveCommandArea(action);
-  const pulse = renderSparkline(buildTelemetrySeries((status.globalReadiness.installed.length || 1) + tick, Math.max(8, Math.min(18, Math.floor(innerWidth / 5))), tick), { useColor, color: ANSI.teal });
-  const lines = [
-    colorize('EXECUTION TRANSFER', ANSI.bold, useColor),
-    fitText(colorize(`area ${commandArea} | launching ${action?.label ?? 'acao'}`, ANSI.amber, useColor), innerWidth),
-    fitText(colorize(`pulse ${pulse}`, ANSI.gray, useColor), innerWidth),
-    fitText('', innerWidth),
-    ...splitText(action?.description ?? '', innerWidth, 2),
-    ...splitText(action?.success ? `resultado esperado: ${action.success}` : '', innerWidth, 2),
-    ...splitText(`exec: ${formatActionCommand(action)}`, innerWidth, 2),
-    fitText('', innerWidth),
-    fitText(colorize('alternando do HUD para o stream real do comando...', ANSI.dim, useColor), innerWidth),
-  ];
-
-  while (lines.length < Math.max(8, height - 2)) {
-    lines.push(fitText('', innerWidth));
-  }
-
-  return renderBox(
-    lines.slice(0, Math.max(8, height - 2)).map((line) => fitText(line, innerWidth)),
-    width,
-    'running',
-    { useColor, color: ANSI.teal, style: 'focus' },
-  ).join('\n');
-}
-
-export function formatActionHeader(action, { useColor = false } = {}) {
-  const lines = [
-    colorize(action.label, ANSI.bold, useColor),
-    action.description,
-    ...(action.details ?? []),
-    action.success ? `Resultado esperado: ${action.success}` : null,
-    action.disabledReason ? `Indisponivel: ${action.disabledReason}` : null,
-  ].filter(Boolean);
-
-  return renderPanelLines(
-    lines,
-    { color: ANSI.green, useColor },
-  );
-}
-
-export function formatResultMessage(code, { useColor = false } = {}) {
-  if (code === 0) {
-    return colorize('Comando concluido com sucesso.', ANSI.green, useColor);
-  }
-
-  return colorize(`Comando terminou com codigo ${code}.`, ANSI.red, useColor);
-}
-
-export function formatHelp(commands) {
-  const actionList = commands.map((command) => {
-    const aliases = command.aliases.length ? ` aliases: ${command.aliases.join(', ')}` : '';
-    const disabled = command.disabledReason ? ` indisponivel: ${command.disabledReason}` : '';
-    return `  - ${command.key}: ${command.label}\n    ${command.description}${aliases}${disabled}`;
-  }).join('\n');
-
-  return `Skill Master Menu
-
-Uso:
-  skill-master-menu
-  skill-master-menu --status
-  skill-master-menu --run <acao>
-  skill-master-menu --run update --yes
-  skill-master-menu --help
-
-Acoes disponiveis:
-${actionList}
-
-O comando de menu e voltado para operacao humana. O binario MCP stdio continua sendo:
-  skill-master-mcp
-`;
-}
-
-export function runCommand(action, { cwd, env = process.env } = {}) {
-  return new Promise((resolve) => {
-    const child = spawn(action.command, action.args, {
-      cwd,
-      env,
-      shell: process.platform === 'win32',
-      stdio: 'inherit',
-    });
-
-    child.on('close', (code) => {
-      resolve(code ?? 1);
-    });
-  });
-}
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import os from 'node:os';
+import { dirname, join } from 'node:path';
+import process from 'node:process';
+import {
+  assessCodexConfigContent,
+  assessMcpServerConfig,
+  defaultClientConfigPaths,
+} from './client-config.mjs';
+import { buildOperationResultCopy } from './operation-result.mjs';
+
+const ANSI = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  white: '\x1b[37m',
+  gray: '\x1b[90m',
+  teal: '\x1b[38;5;80m',
+  amber: '\x1b[38;5;179m',
+  blue: '\x1b[38;5;75m',
+  rose: '\x1b[38;5;211m',
+  violet: '\x1b[38;5;141m',
+};
+
+const REQUIRED_GLOBAL_SKILLS = [
+  'catholic-moral-discernment',
+  'ai-ethics-human-dignity',
+  'professional-boundary-triage',
+  'broad-domain-router',
+  'language-quality-pt-en-fr',
+  'math-science-reasoning',
+  'philosophy-sociology-discernment',
+  'engineering-systems-master',
+  'source-authority-reviewer',
+  'release-ethics-gate',
+  'mcp-client-readiness',
+  'terminal-menu-operations',
+  'terminal-pixel-art-tui',
+  'senior-master-code-optimizer',
+  'typescript-senior-master-engineering',
+  'python-senior-master-engineering',
+  'javascript-senior-master-engineering',
+  'go-senior-master-engineering',
+  'sql-senior-master-engineering',
+  'json-senior-master-engineering',
+  'ruby-senior-master-engineering',
+  'react-senior-master-engineering',
+  'html-senior-master-engineering',
+  'css-senior-master-engineering',
+  'csharp-senior-master-engineering',
+];
+
+const BUNDLED_SKILL_DOMAIN_GROUPS = [
+  {
+    key: 'moral',
+    label: 'moral-core',
+    skills: [
+      'ai-ethics-human-dignity',
+      'broad-domain-router',
+      'catholic-moral-discernment',
+      'engineering-systems-master',
+      'language-quality-pt-en-fr',
+      'math-science-reasoning',
+      'philosophy-sociology-discernment',
+      'professional-boundary-triage',
+      'release-ethics-gate',
+      'source-authority-reviewer',
+    ],
+  },
+  {
+    key: 'frontend',
+    label: 'frontend-ui',
+    skills: [
+      'figma',
+      'figma-code-connect-components',
+      'figma-create-design-system-rules',
+      'figma-generate-design',
+      'figma-generate-library',
+      'figma-implement-design',
+      'figma-use',
+      'frontend-dev-guidelines',
+      'frontend-design',
+      'frontend-ui-ux-systems',
+      'html-senior-master-engineering',
+      'nextjs',
+      'playwright',
+      'react-senior-master-engineering',
+      'screenshot',
+      'senior-fullstack',
+      'shadcn',
+      'css-senior-master-engineering',
+      'ui-component-primitives',
+      'webapp-testing',
+      'web-mobile-design-systems',
+      'winui-app',
+    ],
+  },
+  {
+    key: 'backend',
+    label: 'backend-data',
+    skills: [
+      'csharp-senior-master-engineering',
+      'go-engineering',
+      'go-senior-master-engineering',
+      'java-engineering',
+      'javascript-engineering',
+      'javascript-senior-master-engineering',
+      'json-contract-design',
+      'json-senior-master-engineering',
+      'mcp-builder',
+      'polyglot-backend-engineering',
+      'python-engineering',
+      'python-senior-master-engineering',
+      'ruby-engineering',
+      'ruby-senior-master-engineering',
+      'senior-master-code-optimizer',
+      'sql-postgresql-engineering',
+      'sql-senior-master-engineering',
+      'typescript-expert',
+      'typescript-senior-master-engineering',
+    ],
+  },
+  {
+    key: 'ops',
+    label: 'ops-clients',
+    skills: [
+      'cli-creator',
+      'developer-workstation-ops',
+      'git-version-control-ops',
+      'github',
+      'mcp-client-readiness',
+      'multi-client-mcp-ops',
+      'openai-docs',
+      'skill-master-orchestrator',
+      'terminal-shell-ops',
+      'terminal-menu-operations',
+      'terminal-pixel-art-tui',
+      'windows-linux-platform-ops',
+    ],
+  },
+  {
+    key: 'knowledge',
+    label: 'knowledge',
+    skills: [
+      'language-quality-pt-en-fr-it-ru',
+      'math-physics-reasoning',
+    ],
+  },
+];
+
+const COMMAND_AREA_LABELS = {
+  status: 'diagnostico',
+  doctor: 'diagnostico',
+  check: 'desenvolvimento',
+  build: 'desenvolvimento',
+  publicNpm: 'distribuicao',
+  updateGlobal: 'distribuicao',
+  privateRegistry: 'registry',
+  activationStatus: 'ativacao',
+  activationBalanced: 'ativacao',
+  activationAlwaysOn: 'ativacao',
+  installGlobalSkills: 'skills-globais',
+  installProjectSkills: 'skills-projeto',
+  bootstrapGlobal: 'bootstrap-global',
+  registerClients: 'clientes-mcp',
+  promptRecommendation: 'roteamento',
+  successNotifications: 'aprendizado',
+  studySkills: 'aprendizado',
+  approvalPackage: 'aprovacao',
+  markLearnedStudy: 'aprovacao',
+  rejectLearnedSkill: 'aprovacao',
+  activateLearnedLocal: 'ativacao-skill',
+  activateLearnedGlobal: 'ativacao-skill',
+  notionSummary: 'documentacao',
+};
+
+const CRITICAL_SYSTEM_SETUP_ACTIONS = new Set([
+  'bootstrapGlobal',
+]);
+
+const SUPPORT_SYSTEM_SETUP_ACTIONS = new Set([
+  'installGlobalSkills',
+  'registerClients',
+]);
+
+function colorize(text, color, enabled) {
+  return enabled ? `${color}${text}${ANSI.reset}` : text;
+}
+
+function getActionAttentionState(command, status) {
+  if (command?.disabledReason) return 'disabled';
+  if (!status?.globalReadiness?.ready) {
+    if (CRITICAL_SYSTEM_SETUP_ACTIONS.has(command?.key)) return 'critical';
+    if (SUPPORT_SYSTEM_SETUP_ACTIONS.has(command?.key)) return 'priority';
+  }
+  return 'normal';
+}
+
+function getActionAttentionBadge(command, status) {
+  const state = getActionAttentionState(command, status);
+  if (state === 'critical') return '[SETUP AGORA] ';
+  if (state === 'priority') return '[SISTEMA] ';
+  return '';
+}
+
+function getActionLineColor(command, selected, status) {
+  const state = getActionAttentionState(command, status);
+  if (selected && state === 'critical') return ANSI.rose;
+  if (selected && state === 'priority') return ANSI.amber;
+  if (selected) return ANSI.teal;
+  if (state === 'critical') return ANSI.rose;
+  if (state === 'priority') return ANSI.amber;
+  return null;
+}
+
+function buildSetupAlertLine(status, compact) {
+  if (status?.globalReadiness?.ready) return null;
+  return compact
+    ? 'SETUP GLOBAL PENDENTE -> use [SETUP AGORA] / [SISTEMA]'
+    : 'SETUP GLOBAL PENDENTE -> priorize [SETUP AGORA] e [SISTEMA] para autenticar o MCP no computador';
+}
+
+function visibleLength(text) {
+  return String(text).replace(/\x1b\[[0-9;]*m/g, '').length;
+}
+
+function fitText(text, width) {
+  const value = String(text ?? '');
+  if (visibleLength(value) <= width) {
+    return `${value}${' '.repeat(width - visibleLength(value))}`;
+  }
+
+  return `${value.slice(0, Math.max(0, width - 1))}~`;
+}
+
+function truncateVisibleText(text, width) {
+  if (width <= 0) return '';
+  const value = String(text ?? '');
+  let output = '';
+  let visible = 0;
+  let hasOpenAnsi = false;
+
+  for (let index = 0; index < value.length && visible < width;) {
+    if (value[index] === '\x1b' && value[index + 1] === '[') {
+      const end = value.indexOf('m', index);
+      if (end === -1) break;
+      const sequence = value.slice(index, end + 1);
+      output += sequence;
+      hasOpenAnsi = sequence !== ANSI.reset;
+      index = end + 1;
+      continue;
+    }
+
+    const [char] = Array.from(value.slice(index));
+    output += char;
+    visible += 1;
+    index += char.length;
+  }
+
+  return hasOpenAnsi ? `${output}${ANSI.reset}` : output;
+}
+
+function splitText(text, width, maxLines = 3) {
+  const words = String(text ?? '').split(/\s+/).filter(Boolean);
+  const lines = [];
+  let current = '';
+
+  for (const word of words) {
+    const next = current ? `${current} ${word}` : word;
+    if (next.length <= width) {
+      current = next;
+      continue;
+    }
+    if (current) lines.push(current);
+    current = word.length > width ? word.slice(0, width - 1) + '~' : word;
+    if (lines.length >= maxLines) break;
+  }
+  if (current && lines.length < maxLines) lines.push(current);
+  return lines.length ? lines : [''];
+}
+
+function globalSkillsRoot() {
+  return join(process.env.CODEX_HOME ?? join(os.homedir(), '.codex'), 'skills');
+}
+
+function readClientConfigState(filePath) {
+  if (!existsSync(filePath)) {
+    return { present: false, kind: 'missing', globalCommand: false };
+  }
+
+  const content = readFileSync(filePath, 'utf8');
+  const assessment = assessCodexConfigContent(content);
+
+  return {
+    present: true,
+    kind: assessment.mode,
+    globalCommand: assessment.robust,
+    command: assessment.command,
+  };
+}
+
+function readJsonState(filePath) {
+  if (!existsSync(filePath)) {
+    return { present: false, kind: 'missing', globalCommand: false };
+  }
+
+  try {
+    const parsed = JSON.parse(readFileSync(filePath, 'utf8'));
+    const server = parsed?.mcpServers?.skill_master;
+    const assessment = assessMcpServerConfig(server);
+    return {
+      present: true,
+      kind: assessment.mode,
+      globalCommand: assessment.robust,
+      command: assessment.command,
+    };
+  } catch {
+    return { present: true, kind: 'invalid-json', globalCommand: false };
+  }
+}
+
+function inspectGlobalReadiness() {
+  const root = globalSkillsRoot();
+  const installed = REQUIRED_GLOBAL_SKILLS.filter((name) => existsSync(join(root, name, 'SKILL.md')));
+  const missing = REQUIRED_GLOBAL_SKILLS.filter((name) => !installed.includes(name));
+  const clientPaths = defaultClientConfigPaths();
+  const codex = readClientConfigState(clientPaths.codex);
+  const claude = readJsonState(clientPaths.claude);
+  const gemini = readJsonState(clientPaths.gemini);
+  const antigravity = readJsonState(clientPaths.antigravity);
+  const ready = missing.length === 0
+    && codex.globalCommand
+    && claude.globalCommand
+    && gemini.globalCommand
+    && antigravity.globalCommand;
+  const mode = ready
+    ? 'ready'
+    : codex.present || claude.present || gemini.present || antigravity.present
+      ? 'partial'
+      : 'missing';
+
+  return {
+    root,
+    required: REQUIRED_GLOBAL_SKILLS.length,
+    installed,
+    missing,
+    ready,
+    mode,
+    codex,
+    claude,
+    gemini,
+    antigravity,
+  };
+}
+
+export function readJson(rootDir, relativePath) {
+  const target = join(rootDir, relativePath);
+  if (!existsSync(target)) {
+    return null;
+  }
+
+  return JSON.parse(readFileSync(target, 'utf8'));
+}
+
+export function readText(rootDir, relativePath) {
+  const target = join(rootDir, relativePath);
+  if (!existsSync(target)) {
+    return null;
+  }
+
+  return readFileSync(target, 'utf8').trim();
+}
+
+export function getMenuStatus(rootDir) {
+  const packageJson = readJson(rootDir, 'package.json');
+  const stableManifest = readJson(rootDir, 'manifests/channels/stable.json');
+  const versionText = readText(rootDir, 'VERSION.md');
+  const successLearningDir = process.env.SKILL_MASTER_SUCCESS_LEARNING_DIR
+    ?? join(process.env.SKILL_MASTER_HOME ?? join(process.env.HOME ?? process.env.USERPROFILE ?? '', '.skill-master'), 'data', 'success-learning');
+  const studyCandidates = readJson(rootDir, 'network/unapproved-skill-candidates.json');
+  const globalReadiness = inspectGlobalReadiness();
+  const bundledCatalog = inspectBundledSkillCatalog(rootDir);
+
+  return {
+    packageName: packageJson?.name ?? 'nao encontrado',
+    semver: packageJson?.version ?? 'nao encontrado',
+    manifestVersion: stableManifest?.version ?? 'nao encontrado',
+    manifestSemver: stableManifest?.semver ?? 'nao encontrado',
+    versionText,
+    rootDir,
+    pendingSuccessDrafts: countManifestFiles(successLearningDir),
+    studyCandidates: Array.isArray(studyCandidates?.candidates) ? studyCandidates.candidates.length : 0,
+    globalReadiness,
+    bundledCatalog,
+  };
+}
+
+function countManifestFiles(directory) {
+  if (!directory || !existsSync(directory)) {
+    return 0;
+  }
+
+  let count = 0;
+  const visit = (current) => {
+    for (const entry of readdirSync(current, { withFileTypes: true })) {
+      const fullPath = join(current, entry.name);
+      if (entry.isDirectory()) visit(fullPath);
+      else if (entry.isFile() && entry.name === 'manifest.json') count += 1;
+    }
+  };
+
+  visit(directory);
+  return count;
+}
+
+function listBundledSkillNames(rootDir) {
+  const source = join(rootDir, 'docs', 'skill-candidates');
+  if (!existsSync(source)) {
+    return [];
+  }
+
+  const entries = readdirSync(source, { withFileTypes: true });
+  const directSkills = entries
+    .filter((entry) => entry.isDirectory() && existsSync(join(source, entry.name, 'SKILL.md')))
+    .map((entry) => entry.name);
+
+  if (directSkills.length) {
+    return Array.from(new Set(directSkills)).sort();
+  }
+
+  return Array.from(new Set(
+    entries
+      .filter((entry) => entry.isDirectory())
+      .flatMap((entry) => {
+        const versionPath = join(source, entry.name);
+        return readdirSync(versionPath, { withFileTypes: true })
+          .filter((skillEntry) => skillEntry.isDirectory() && existsSync(join(versionPath, skillEntry.name, 'SKILL.md')))
+          .map((skillEntry) => skillEntry.name);
+      }),
+  )).sort();
+}
+
+function inspectBundledSkillCatalog(rootDir) {
+  const names = listBundledSkillNames(rootDir);
+  const categories = BUNDLED_SKILL_DOMAIN_GROUPS.map((group) => ({
+    key: group.key,
+    label: group.label,
+    count: group.skills.filter((skill) => names.includes(skill)).length,
+  }));
+
+  return {
+    total: names.length,
+    names,
+    categories,
+  };
+}
+
+function formatBundledCategoryLine(catalog) {
+  if (!catalog?.categories?.length) {
+    return 'bundled skills: 0';
+  }
+
+  return catalog.categories
+    .filter((category) => category.count > 0)
+    .map((category) => `${category.label} ${category.count}`)
+    .join(' | ');
+}
+
+function resolveCommandArea(action) {
+  if (!action) {
+    return 'geral';
+  }
+
+  return COMMAND_AREA_LABELS[action.key] ?? 'geral';
+}
+
+function formatActionCommand(action) {
+  if (!action?.command) {
+    return '';
+  }
+
+  return [action.command, ...(action.args ?? [])].join(' ');
+}
+
+function resolveNpmCommand(nodeExecPath) {
+  if (process.platform !== 'win32') {
+    return { command: 'npm', argsPrefix: [], shell: false };
+  }
+
+  const candidates = [
+    process.env.npm_execpath,
+    join(dirname(nodeExecPath), 'node_modules', 'npm', 'bin', 'npm-cli.js'),
+  ].filter(Boolean);
+  const npmCli = candidates.find((candidate) => existsSync(candidate));
+
+  if (npmCli) {
+    return { command: nodeExecPath, argsPrefix: [npmCli], shell: false };
+  }
+
+  return { command: 'npm.cmd', argsPrefix: [], shell: true };
+}
+
+export function buildMenuCommands({ rootDir, currentFile, nodeExecPath = process.execPath, invocationCwd = process.cwd() }) {
+  const isDevCheckout = existsSync(join(rootDir, 'tsconfig.json')) && existsSync(join(rootDir, 'src'));
+  const repoOnlyReason = 'Disponivel apenas no clone de desenvolvimento; no pacote npm use Doctor ou Status.';
+  const npmCommand = resolveNpmCommand(nodeExecPath);
+
+  return [
+    {
+      key: 'status',
+      aliases: ['status'],
+      label: 'Status local',
+      description: 'Mostra versao local, manifesto e informacoes do pacote.',
+      details: ['Nao altera arquivos.', 'Use para confirmar se o menu esta lendo a instalacao correta.'],
+      success: 'Relatorio impresso com versao, canal, skills globais e clientes configurados.',
+      command: nodeExecPath,
+      args: [currentFile, '--status'],
+    },
+    {
+      key: 'doctor',
+      aliases: ['doctor', 'diagnostico', 'verificar-menu', 'validar-menu'],
+      label: 'Doctor do menu e clientes MCP',
+      description: 'Valida pacote, binarios, skills globais e registros em Codex, Claude Desktop, Claude Code, Gemini e Antigravity.',
+      details: ['Seguro para outros notebooks.', 'Nao publica versao e nao mexe em configuracoes sem uma acao separada.'],
+      success: 'Mostra um relatorio GO/NO-GO com proximos comandos recomendados.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-doctor.mjs')],
+    },
+    {
+      key: 'check',
+      aliases: ['check', 'gate'],
+      label: 'Rodar gate completo',
+      description: 'Executa build, testes e validacao de manifestos.',
+      details: ['Exige clone do repositorio com src, testes e tsconfig.', 'Nao e uma acao indicada para instalacao global via npm.'],
+      success: 'Build, testes e manifestos passam no checkout de desenvolvimento.',
+      disabledReason: isDevCheckout ? null : repoOnlyReason,
+      command: npmCommand.command,
+      args: [...npmCommand.argsPrefix, 'run', 'check'],
+      shell: npmCommand.shell,
+    },
+    {
+      key: 'build',
+      aliases: ['build'],
+      label: 'Rodar build',
+      description: 'Compila o projeto localmente.',
+      details: ['Exige clone do repositorio com tsconfig.', 'Pacotes npm publicados ja usam dist precompilado.'],
+      success: 'dist atualizado no checkout de desenvolvimento.',
+      disabledReason: isDevCheckout ? null : repoOnlyReason,
+      command: npmCommand.command,
+      args: [...npmCommand.argsPrefix, 'run', 'build'],
+      shell: npmCommand.shell,
+    },
+    {
+      key: 'publicNpm',
+      aliases: ['public-npm', 'npm', 'registry'],
+      label: 'Validar pacote no npm publico',
+      description: 'Consulta a versao publicada em registry.npmjs.org.',
+      details: ['Usa somente leitura no registry publico.', 'Bom para confirmar se outro notebook consegue instalar por npm.'],
+      success: 'Retorna a versao publicada atualmente no npmjs.',
+      command: npmCommand.command,
+      args: [
+        ...npmCommand.argsPrefix,
+        'view',
+        '@fprad0/skill-master-mcp',
+        'version',
+        '--registry=https://registry.npmjs.org',
+      ],
+      shell: npmCommand.shell,
+    },
+    {
+      key: 'updateGlobal',
+      aliases: ['update', 'update-global'],
+      label: 'Atualizar pacote global via npm',
+      description: 'Atualiza a instalacao global e exige reinicio do cliente MCP.',
+      details: [
+        'A atualizacao deve ser feita fora do processo MCP stdio.',
+        'Se o menu estiver usando o pacote global no Windows, o fluxo faz handoff seguro em vez de atualizar a pasta em uso.',
+        'Use antes de abrir Codex, Claude, Gemini ou Antigravity.',
+      ],
+      success: 'Pacote global atualizado para a versao latest do npm publico.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-update.mjs')],
+      confirmMessage: 'Atualizar o pacote global agora?',
+    },
+    {
+      key: 'privateRegistry',
+      aliases: ['private-registry', 'private', 'github-packages'],
+      label: 'Configurar registry privado GitHub Packages',
+      description: 'Prepara o .npmrc e valida o acesso ao pacote privado.',
+      details: ['Uso avancado para ambientes privados.', 'Nao e necessario para o pacote publico do npmjs.'],
+      success: '.npmrc configurado e validacao npm view executada.',
+      command: nodeExecPath,
+      args: ['scripts/configure-private-registry.mjs', '--validate'],
+      confirmMessage: 'Rodar a configuracao de registry privado agora?',
+    },
+    {
+      key: 'activationStatus',
+      aliases: ['activation-status', 'modo', 'modo-ativacao'],
+      label: 'Modo de ativacao atual',
+      description: 'Mostra o modo manual, balanced ou always-on-assisted configurado localmente.',
+      details: ['Nao altera configuracao.', 'Ajuda a entender quando o Skill Master deve sugerir skills.'],
+      success: 'Modo atual e caminho da configuracao impressos no terminal.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--status'],
+    },
+    {
+      key: 'activationBalanced',
+      aliases: ['set-balanced', 'balanced'],
+      label: 'Usar modo balanced',
+      description: 'Define balanced como modo padrao de ativacao do Skill Master.',
+      details: ['Recomendado para uso diario.', 'Ativa o MCP quando ha ganho claro para o prompt.'],
+      success: 'Modo balanced salvo localmente.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--set-mode', 'balanced'],
+    },
+    {
+      key: 'activationAlwaysOn',
+      aliases: ['set-always-on', 'always-on-assisted'],
+      label: 'Usar modo always-on-assisted',
+      description: 'Define avaliacao assistida quase sempre ativa, mantendo no-op quando nao houver ganho.',
+      details: ['Mais agressivo que balanced.', 'Indicado para usuarios que querem o Skill Master avaliando quase todos os prompts.'],
+      success: 'Modo always-on-assisted salvo localmente.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--set-mode', 'always-on-assisted'],
+      confirmMessage: 'Alterar o modo local para always-on-assisted?',
+    },
+    {
+      key: 'installGlobalSkills',
+      aliases: ['install-global-skills', 'skills-globais', 'global-skills'],
+      label: 'Instalar skills globais do Skill Master',
+      description: 'Copia as skills amplas e morais embutidas para CODEX_HOME/skills ou ~/.codex/skills.',
+      details: ['Necessario para Codex descobrir as skills globais.', 'Pode ser reexecutado com seguranca pelo bootstrap.'],
+      success: 'Skills globais copiadas para a pasta global do usuario.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-install-global-skills.mjs')],
+      confirmMessage: 'Instalar as skills globais embutidas neste usuario?',
+    },
+    {
+      key: 'installProjectSkills',
+      aliases: ['install-project-skills', 'skills-projeto', 'project-skills', 'agents-skills'],
+      label: 'Instalar skills no projeto atual',
+      description: 'Copia o bundle para .agents/skills, .codex/skills, .claude/skills e .gemini/skills do projeto onde o menu foi aberto.',
+      details: ['Registra .skill-master/catalog.json e metadados em package.json quando existir.', `Projeto alvo: ${invocationCwd}`],
+      success: 'Skills de projeto copiadas e catalogo local atualizado.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-install-project-skills.mjs'), '--project-root', invocationCwd, '--sync-package-json'],
+      cwd: invocationCwd,
+      confirmMessage: 'Instalar e catalogar as skills do Skill Master no projeto atual?',
+    },
+    {
+      key: 'bootstrapGlobal',
+      aliases: ['bootstrap-global', 'global-bootstrap', 'ativar-global-completo'],
+      label: 'Ativar MCP global neste computador',
+      description: 'Instala skills globais e registra Codex, Claude, Gemini e Antigravity no mesmo passo.',
+      details: ['Acao principal para notebooks novos.', 'Depois reinicie os clientes para eles recarregarem MCP e skills.'],
+      success: 'Skills instaladas e configuracoes MCP aplicadas nos clientes encontrados.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-bootstrap-global.mjs')],
+      confirmMessage: 'Executar o bootstrap global do Skill Master neste computador?',
+    },
+    {
+      key: 'registerClients',
+      aliases: ['register-clients', 'registrar-clientes', 'codex-claude-gemini', 'antigravity'],
+      label: 'Registrar clientes MCP',
+      description: 'Gera/aplica configuracoes MCP para Codex, Claude Desktop, Claude Code, Gemini e Antigravity reconhecerem skill_master.',
+      details: ['Usa Node absoluto e o entrypoint absoluto do pacote.', 'Claude Code e registrado via claude mcp add quando o CLI esta disponivel.'],
+      success: 'Arquivos de configuracao mesclados com o servidor skill_master.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-register-clients.mjs'), '--apply-all'],
+      confirmMessage: 'Aplicar registro do skill_master em Codex, Claude, Gemini e Antigravity?',
+    },
+    {
+      key: 'promptRecommendation',
+      aliases: ['recommend-prompt', 'recomendar-prompt', 'prompt-router'],
+      label: 'Ver recomendacao para um prompt',
+      description: 'Abre um fluxo interativo para avaliar um prompt pelo router local.',
+      details: ['Ajuda a decidir se skill-master, skill_master ou skill-master-mcp deve agir.', 'Nao publica nem altera skills.'],
+      success: 'Router imprime recomendacao, modo de ativacao e gates aplicaveis.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--route-prompt-interactive'],
+    },
+    {
+      key: 'successNotifications',
+      aliases: ['notifications', 'notificacoes', 'success-notifications'],
+      label: 'Notificacoes de skills aprendidas',
+      description: 'Mostra drafts pendentes, aprovacoes e skills externas para estudar.',
+      details: ['Use para decidir o que aprovar, estudar ou rejeitar.', 'Nao ativa skill automaticamente.'],
+      success: 'Lista de pendencias e proximas acoes exibida.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--notify'],
+    },
+    {
+      key: 'studySkills',
+      aliases: ['study-skills', 'skills-estudo', 'estudar'],
+      label: 'Skills para estudar',
+      description: 'Lista skills externas e links de criadores ainda nao aprovados.',
+      details: ['Material de estudo, nao ativacao operacional.', 'Bom para revisao humana antes de virar skill local/global.'],
+      success: 'Links e motivos de estudo exibidos.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--study'],
+    },
+    {
+      key: 'approvalPackage',
+      aliases: ['approval-package', 'aprovar', 'pacote-aprovacao'],
+      label: 'Gerar pacote de aprovacao humana',
+      description: 'Cria um relatorio local para revisar e aprovar skills aprendidas.',
+      details: ['Exige decisao humana antes de ativacao.', 'Inclui riscos, evidencias e recomendacao.'],
+      success: 'Pacote local de aprovacao gerado.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--approval-package'],
+    },
+    {
+      key: 'markLearnedStudy',
+      aliases: ['mark-study', 'manter-estudo'],
+      label: 'Manter skill candidata para estudo',
+      description: 'Seleciona uma candidata e registra decisao de manter para estudo.',
+      details: ['Preserva historico sem ativar a skill.', 'Use quando a fonte ainda precisa revisao.'],
+      success: 'Decisao registrada no historico local.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--mark-study-interactive'],
+    },
+    {
+      key: 'rejectLearnedSkill',
+      aliases: ['reject-skill', 'rejeitar-skill'],
+      label: 'Rejeitar skill candidata',
+      description: 'Seleciona uma candidata, registra rejeicao e preserva historico.',
+      details: ['Nao apaga evidencias.', 'Use quando risco, fonte ou utilidade nao passam no gate.'],
+      success: 'Rejeicao registrada com motivo.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--reject-interactive'],
+      confirmMessage: 'Abrir fluxo para rejeitar uma skill candidata?',
+    },
+    {
+      key: 'activateLearnedLocal',
+      aliases: ['activate-learned-local', 'ativar-local', 'skill-local'],
+      label: 'Ativar skill aprendida no workspace',
+      description: 'Instala uma skill aprendida em .codex/skills do projeto atual.',
+      details: ['Escopo limitado ao workspace.', 'Mais conservador que ativar globalmente.'],
+      success: 'Skill copiada para .codex/skills do projeto.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--activate-interactive', '--target', 'local'],
+      confirmMessage: 'Selecionar e ativar uma skill aprendida no workspace atual?',
+    },
+    {
+      key: 'activateLearnedGlobal',
+      aliases: ['activate-learned-global', 'ativar-global', 'skill-global'],
+      label: 'Ativar skill aprendida global',
+      description: 'Instala uma skill aprendida em CODEX_HOME/skills ou ~/.codex/skills.',
+      details: ['Afeta todos os projetos deste usuario.', 'Use apenas depois de aprovacao humana.'],
+      success: 'Skill instalada no diretorio global de skills.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--activate-interactive', '--target', 'global'],
+      confirmMessage: 'Selecionar e ativar uma skill aprendida como skill global deste usuario?',
+    },
+    {
+      key: 'notionSummary',
+      aliases: ['notion-summary', 'resumo-notion'],
+      label: 'Abrir resumo para Notion',
+      description: 'Mostra um resumo copiavel do estado de ativacao para registrar no ledger Notion.',
+      details: ['Nao escreve no Notion sozinho.', 'Gera texto de continuidade para documentacao.'],
+      success: 'Resumo pronto para registro exibido.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--notion-summary'],
+    },
+  ];
+}
+
+export function buildMenuChoices(commands) {
+  return commands.map((command) => ({
+    title: command.label,
+    description: [command.description, command.success ? `Resultado: ${command.success}` : null].filter(Boolean).join(' '),
+    value: command.key,
+    disabled: command.disabledReason ?? false,
+  })).concat({
+    title: 'Sair',
+    description: 'Fecha o menu operacional.',
+    value: '__exit__',
+  });
+}
+
+export function resolveInitialSelectedIndex(status, commands) {
+  if (!status?.globalReadiness?.ready) {
+    const bootstrapIndex = commands.findIndex((command) => command.key === 'bootstrapGlobal');
+    if (bootstrapIndex >= 0) return bootstrapIndex;
+  }
+  return 0;
+}
+
+export function resolveActionKey(input, commands) {
+  const normalized = (input ?? '').trim().toLowerCase();
+  if (!normalized) {
+    return null;
+  }
+
+  return commands.find((command) =>
+    command.key.toLowerCase() === normalized || command.aliases.includes(normalized),
+  )?.key ?? null;
+}
+
+export function isInteractiveTerminal() {
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+
+export function formatStatusReport(status) {
+  const readiness = status.globalReadiness;
+  const bundledCatalog = status.bundledCatalog ?? { total: 0, categories: [] };
+  const lines = [
+    'Skill Master MCP - status local',
+    `Diretorio: ${status.rootDir}`,
+    `Pacote: ${status.packageName}`,
+    `Semver local: ${status.semver}`,
+    `Manifesto stable: ${status.manifestVersion}`,
+    `Manifesto semver: ${status.manifestSemver}`,
+    `Drafts de skills aprendidas: ${status.pendingSuccessDrafts}`,
+    `Skills externas para estudar: ${status.studyCandidates}`,
+    `Global readiness: ${readiness.ready ? 'pronto' : readiness.mode}`,
+    `Global skills instaladas: ${readiness.installed.length}/${readiness.required}`,
+    `Bundle de skills embutidas: ${bundledCatalog.total}`,
+    `Dominios do bundle: ${formatBundledCategoryLine(bundledCatalog)}`,
+    `Codex MCP robusto: ${readiness.codex.globalCommand ? 'sim' : readiness.codex.kind}`,
+    `Claude MCP robusto: ${readiness.claude.globalCommand ? 'sim' : readiness.claude.present ? readiness.claude.kind : 'ausente'}`,
+    `Gemini MCP robusto: ${readiness.gemini.globalCommand ? 'sim' : readiness.gemini.present ? readiness.gemini.kind : 'ausente'}`,
+    `Antigravity MCP robusto: ${readiness.antigravity.globalCommand ? 'sim' : readiness.antigravity.present ? readiness.antigravity.kind : 'ausente'}`,
+  ];
+
+  if (status.versionText) {
+    lines.push('', 'VERSION.md:');
+    lines.push(...status.versionText.split('\n').slice(0, 6));
+  }
+
+  return lines.join('\n');
+}
+
+function formatGlobalAlert(status, { useColor = false } = {}) {
+  const readiness = status.globalReadiness;
+  if (readiness.ready) {
+    return renderPanelLines(
+      [
+        colorize('GLOBAL READY', ANSI.bold, useColor),
+        'O MCP esta registrado com Node absoluto neste computador.',
+        'Codex, Claude Desktop, Claude Code, Gemini e Antigravity podem iniciar o servidor sem depender do PATH.',
+        'A instalacao global e as skills embutidas ja estao prontas para uso.',
+      ],
+      { color: ANSI.green, useColor },
+    );
+  }
+
+  return [
+    renderPanelLines(
+      [
+        colorize('ALERTA GLOBAL', ANSI.bold, useColor),
+        'Este computador ainda nao esta pronto para uso robusto do Skill Master.',
+        'Execute agora: skill-master-menu --run bootstrap-global --yes',
+        'Isso instala as skills globais e registra Codex, Claude Desktop, Claude Code, Gemini e Antigravity com Node absoluto.',
+        'Ou migre somente os clientes: skill-master-register-clients --apply-all --force',
+      ],
+      { color: ANSI.red, useColor },
+    ),
+    renderPanelLines(
+      [
+        colorize('AVISO SUTIL', ANSI.dim, useColor),
+        'Sem instalacao global, o MCP continua util localmente, mas nao fica integrado como parte do sistema em todos os clientes.',
+        `Skills globais detectadas: ${readiness.installed.length}/${readiness.required}`,
+      ],
+      { color: ANSI.yellow, useColor },
+    ),
+  ].join('\n\n');
+}
+
+function renderPanelLines(lines, { color = ANSI.cyan, useColor = false } = {}) {
+  const width = Math.max(...lines.map((line) => visibleLength(line)), 24) + 4;
+  return renderCyberFrame(
+    lines.map((line) => fitText(line, width - 4)),
+    width,
+    'skill-master',
+    { color, useColor, style: 'data' },
+  ).join('\n');
+}
+
+function patternFill(pattern, width) {
+  if (width <= 0) return '';
+  return Array.from({ length: Math.ceil(width / pattern.length) }, () => pattern).join('').slice(0, width);
+}
+
+function frameTokens(style) {
+  if (style === 'focus') {
+    return { topLeft: '╭╼', topRight: '╾╮', bottomLeft: '╰╼', bottomRight: '╾╯', fill: '═', left: '▌ ', right: ' ▐', accent: '▰', micro: '▱' };
+  }
+  if (style === 'hud') {
+    return { topLeft: '┏╾', topRight: '╼┓', bottomLeft: '┗╾', bottomRight: '╼┛', fill: '─', left: '▌ ', right: ' ▐', accent: '▰', micro: '▱' };
+  }
+  if (style === 'running') {
+    return { topLeft: '╔╼', topRight: '╾╗', bottomLeft: '╚╼', bottomRight: '╾╝', fill: '═', left: '▌▌', right: '▐▐', accent: '▰', micro: '▱' };
+  }
+  if (style === 'thin') {
+    return { topLeft: '┌╴', topRight: '╶┐', bottomLeft: '└╴', bottomRight: '╶┘', fill: '─', left: '│ ', right: ' │', accent: '▱', micro: '╍' };
+  }
+  return { topLeft: '╭╴', topRight: '╶╮', bottomLeft: '╰╴', bottomRight: '╶╯', fill: '─', left: '│ ', right: ' │', accent: '▰', micro: '▱' };
+}
+
+function fillWithPattern(text, width, fill) {
+  const length = visibleLength(text);
+  if (length >= width) return fitText(text, width);
+  return `${text}${patternFill(fill, width - length)}`;
+}
+
+function renderCyberRail(width, title, tokens, { bottom = false, tick = 0 } = {}) {
+  const left = bottom ? tokens.bottomLeft : tokens.topLeft;
+  const right = bottom ? tokens.bottomRight : tokens.topRight;
+  const innerWidth = Math.max(0, width - visibleLength(left) - visibleLength(right));
+  const phaseMicro = tick % 2 === 0 ? tokens.micro : tokens.fill;
+  const titleText = !bottom && title ? ` ${String(title).toUpperCase()} ` : '';
+  const titleWidth = titleText ? Math.min(visibleLength(titleText), Math.max(0, innerWidth - 8)) : 0;
+  const safeTitle = titleText ? fitText(titleText, titleWidth).trimEnd() : '';
+
+  if (bottom) {
+    const lead = patternFill(tokens.fill, Math.max(2, Math.floor(innerWidth * 0.18)));
+    const plate = innerWidth >= 34 ? `${tokens.accent}${tokens.accent}${tokens.accent}` : tokens.accent;
+    const vent = innerWidth >= 44 ? patternFill(`${phaseMicro}${tokens.fill}`, 8) : '';
+    return `${left}${fillWithPattern(`${lead}${plate}${tokens.fill}${vent}`, innerWidth, tokens.fill)}${right}`;
+  }
+
+  const leadWidth = Math.max(2, Math.min(10, Math.floor(innerWidth * 0.16)));
+  const lead = patternFill(tokens.fill, leadWidth);
+  const chip = innerWidth >= 36 ? `${tokens.accent}${phaseMicro}${phaseMicro}` : tokens.accent;
+  const tab = innerWidth >= 48 ? `${tokens.fill}${tokens.fill}${tokens.accent}${tokens.fill}` : tokens.fill;
+  return `${left}${fillWithPattern(`${lead}${safeTitle}${chip}${tab}`, innerWidth, tokens.fill)}${right}`;
+}
+
+function renderCyberFrame(lines, width, title, { useColor = false, color = ANSI.cyan, style = 'data', tick = 0 } = {}) {
+  const safeWidth = Math.max(16, width);
+  const innerWidth = safeWidth - 4;
+  const tokens = frameTokens(style);
+  const top = renderCyberRail(safeWidth, title, tokens, { tick });
+  const bottom = renderCyberRail(safeWidth, title, tokens, { bottom: true, tick });
+  const body = lines.map((line, index) => {
+    const marker = style === 'running' && index % 3 === Math.abs(tick % 3)
+      ? tokens.accent
+      : index === 0 || index === lines.length - 1
+        ? tokens.micro
+        : ' ';
+    const content = fitText(`${marker}${truncateVisibleText(line, Math.max(0, innerWidth - 1))}`, innerWidth);
+    return `${colorize(tokens.left, color, useColor)}${content}${colorize(tokens.right, color, useColor)}`;
+  });
+
+  return [
+    colorize(top, color, useColor),
+    ...body,
+    colorize(bottom, color, useColor),
+  ];
+}
+
+function renderCircuitRail(width, tick, { useColor = false, color = ANSI.teal } = {}) {
+  const patterns = ['<==/==>--', '<=/===/>-', '<<==--==>', '<==\\==>--'];
+  return colorize(patternFill(patterns[Math.abs(tick) % patterns.length], width), color, useColor);
+}
+
+function renderScanGrid(width, height, tick, { useColor = false } = {}) {
+  const lines = [];
+  const scanCol = width > 0 ? tick % width : 0;
+  const scanRow = height > 0 ? Math.floor(tick / 2) % height : 0;
+
+  for (let row = 0; row < height; row += 1) {
+    const cells = Array.from({ length: width }, (_, col) => {
+      if (row === scanRow && col % 3 === 0) return colorize('-', ANSI.white, useColor);
+      if (col === scanCol && row % 2 === 0) return colorize('|', ANSI.teal, useColor);
+      if ((row + col + tick) % 17 === 0) return colorize('+', ANSI.amber, useColor);
+      if (row % 4 === 0 && col % 8 === 0) return colorize('.', ANSI.gray, useColor);
+      return ' ';
+    });
+    lines.push(cells.join(''));
+  }
+
+  return lines;
+}
+
+const BRAILLE_DOTS = [
+  [0x01, 0x02, 0x04, 0x40],
+  [0x08, 0x10, 0x20, 0x80],
+];
+
+function createBrailleCanvas(width, height) {
+  return {
+    width,
+    height,
+    dots: Array.from({ length: height }, () => Array.from({ length: width }, () => 0)),
+    colors: Array.from({ length: height }, () => Array.from({ length: width }, () => 'gray')),
+    priorities: Array.from({ length: height }, () => Array.from({ length: width }, () => -1)),
+  };
+}
+
+function plotBraille(canvas, x, y, color = 'gray', priority = 0) {
+  if (x < 0 || y < 0) return;
+  const cellX = Math.floor(x / 2);
+  const cellY = Math.floor(y / 4);
+  if (cellX < 0 || cellY < 0 || cellX >= canvas.width || cellY >= canvas.height) return;
+  canvas.dots[cellY][cellX] |= BRAILLE_DOTS[x % 2][y % 4];
+  if (priority >= canvas.priorities[cellY][cellX]) {
+    canvas.colors[cellY][cellX] = color;
+    canvas.priorities[cellY][cellX] = priority;
+  }
+}
+
+function plotBrailleThick(canvas, x, y, radius = 0, color = 'gray', priority = 0) {
+  for (let dy = -radius; dy <= radius; dy += 1) {
+    for (let dx = -radius; dx <= radius; dx += 1) {
+      if (Math.abs(dx) + Math.abs(dy) <= radius + 1) {
+        plotBraille(canvas, x + dx, y + dy, color, priority);
+      }
+    }
+  }
+}
+
+function drawBrailleLine(canvas, x0, y0, x1, y1, thickness = 0, color = 'gray', priority = 0) {
+  const steps = Math.max(Math.abs(x1 - x0), Math.abs(y1 - y0), 1);
+  for (let step = 0; step <= steps; step += 1) {
+    const ratio = step / steps;
+    const x = Math.round(x0 + (x1 - x0) * ratio);
+    const y = Math.round(y0 + (y1 - y0) * ratio);
+    plotBrailleThick(canvas, x, y, thickness, color, priority);
+  }
+}
+
+function renderBrailleCanvas(canvas, { useColor = false } = {}) {
+  return canvas.dots.map((row, rowIndex) => row.map((value, colIndex) => {
+    if (value === 0) return ' ';
+    const color = ANSI[canvas.colors[rowIndex][colIndex]] ?? ANSI.teal;
+    return colorize(String.fromCodePoint(0x2800 + value), color, useColor);
+  }).join(''));
+}
+
+function renderStatusCapsule(label, value, width, { useColor = false, color = ANSI.teal } = {}) {
+  return fitText(`${colorize(`[${label}]`, color, useColor)} ${value}`, width);
+}
+
+function summarizeClientReadiness(globalReadiness) {
+  const states = [
+    ['cx', globalReadiness?.codex?.globalCommand],
+    ['cl', globalReadiness?.claude?.globalCommand],
+    ['gm', globalReadiness?.gemini?.globalCommand],
+    ['ag', globalReadiness?.antigravity?.globalCommand],
+  ];
+
+  return states
+    .map(([label, ready]) => `${label}${ready ? '+' : '-'}`)
+    .join(' ');
+}
+
+export function formatMenuBanner(status, { useColor = false } = {}) {
+  const bundledCatalog = status.bundledCatalog ?? { total: 0, categories: [] };
+  const lines = [
+    colorize('Skill Master MCP', ANSI.bold, useColor),
+    'Menu operacional para manutencao local',
+    `Versao local ${status.semver}  |  canal ${status.manifestVersion}`,
+    `Pendencias: ${status.pendingSuccessDrafts} drafts  |  estudo: ${status.studyCandidates} links`,
+    `Global: ${status.globalReadiness.ready ? 'pronto' : 'requer instalacao global'}`,
+    `Bundle: ${bundledCatalog.total} skills  |  ${formatBundledCategoryLine(bundledCatalog)}`,
+    colorize('Setas + Enter para navegar', ANSI.dim, useColor),
+  ];
+  return [
+    renderPanelLines(lines, { color: ANSI.cyan, useColor }),
+    formatGlobalAlert(status, { useColor }),
+  ].join('\n\n');
+}
+
+function dnaPanelLines(tick, width, height, status, selected, { useColor = false, compact = false } = {}) {
+  const lines = [];
+  const canvasWidth = Math.max(18, width);
+  const canvasHeight = Math.max(compact ? 8 : 10, height - 4);
+  const pixelWidth = canvasWidth * 2;
+  const pixelHeight = canvasHeight * 4;
+  const center = Math.floor(pixelWidth / 2);
+  const amplitude = Math.max(8, Math.min(Math.floor(pixelWidth * 0.24), compact ? 12 : 18));
+  const frameCount = 48;
+  const frameRatio = (tick % frameCount) / frameCount;
+  const phase = frameRatio * Math.PI * 2;
+  const scanPhase = (1 - Math.cos(frameRatio * Math.PI * 2)) / 2;
+  const pairEvery = compact ? 9 : 7;
+  const actionArea = resolveCommandArea(selected);
+  const canvas = createBrailleCanvas(canvasWidth, canvasHeight);
+
+  lines.push(fitText(colorize(`DNA CYBER HELIX / ${actionArea}`, ANSI.bold, useColor), width));
+  lines.push(fitText(colorize(compact ? 'dual strand / focus' : 'dense helix / low flicker', ANSI.dim, useColor), width));
+
+  const twist = compact ? 0.17 : 0.155;
+  const xA = (y) => Math.round(center + Math.sin(y * twist + phase) * amplitude);
+  const xB = (y) => Math.round(center - Math.sin(y * twist + phase) * amplitude);
+  const frontA = (y) => Math.cos(y * twist + phase) >= 0;
+  const scanY = Math.floor(scanPhase * Math.max(1, pixelHeight - 1));
+  const pulse = 0.82 + ((Math.sin(phase * 2) + 1) / 2) * 0.28;
+
+  for (let y = 0; y < pixelHeight; y += 8) {
+    plotBrailleThick(canvas, center, y, 0, 'gray', 0);
+  }
+
+  for (let y = 0; y < pixelHeight; y += 1) {
+    if (y % 10 === 0) {
+      for (let x = 2; x < pixelWidth - 2; x += 10) {
+        plotBraille(canvas, x, y, 'gray', 0);
+      }
+    }
+
+    const a = xA(y);
+    const b = xB(y);
+    const previousA = xA(Math.max(0, y - 1));
+    const previousB = xB(Math.max(0, y - 1));
+    const active = Math.abs(y - scanY) <= 2;
+    const nearA = frontA(y);
+    const wave = y * twist + phase;
+    const depthA = (Math.cos(wave) + 1) / 2;
+    const depthB = 1 - depthA;
+    const strandAWidth = Math.max(1, Math.round((compact ? 1 : 2) + depthA * 2 * pulse));
+    const strandBWidth = Math.max(1, Math.round((compact ? 1 : 2) + depthB * 2 * pulse));
+    const edgeSpread = compact ? 2 : 3;
+    const strandAColor = active ? 'white' : nearA ? 'rose' : 'violet';
+    const strandBColor = active ? 'white' : nearA ? 'teal' : 'blue';
+    const strandAPriority = active ? 7 : nearA ? 5 : 3;
+    const strandBPriority = active ? 7 : nearA ? 3 : 5;
+
+    if (y > 0) {
+      drawBrailleLine(canvas, previousA - edgeSpread, y - 1, a - edgeSpread, y, 0, nearA ? 'gray' : 'blue', 1);
+      drawBrailleLine(canvas, previousA + edgeSpread, y - 1, a + edgeSpread, y, 0, nearA ? 'gray' : 'blue', 1);
+      drawBrailleLine(canvas, previousB - edgeSpread, y - 1, b - edgeSpread, y, 0, nearA ? 'blue' : 'gray', 1);
+      drawBrailleLine(canvas, previousB + edgeSpread, y - 1, b + edgeSpread, y, 0, nearA ? 'blue' : 'gray', 1);
+      drawBrailleLine(canvas, previousA, y - 1, a, y, strandAWidth, strandAColor, strandAPriority);
+      drawBrailleLine(canvas, previousB, y - 1, b, y, strandBWidth, strandBColor, strandBPriority);
+    } else {
+      plotBrailleThick(canvas, a - edgeSpread, y, 0, nearA ? 'gray' : 'blue', 1);
+      plotBrailleThick(canvas, a + edgeSpread, y, 0, nearA ? 'gray' : 'blue', 1);
+      plotBrailleThick(canvas, b - edgeSpread, y, 0, nearA ? 'blue' : 'gray', 1);
+      plotBrailleThick(canvas, b + edgeSpread, y, 0, nearA ? 'blue' : 'gray', 1);
+      plotBrailleThick(canvas, a, y, strandAWidth, strandAColor, strandAPriority);
+      plotBrailleThick(canvas, b, y, strandBWidth, strandBColor, strandBPriority);
+    }
+
+    if ((y + tick) % pairEvery === 0 || active) {
+      const left = Math.min(a, b);
+      const right = Math.max(a, b);
+      const rungColor = active ? 'white' : nearA ? 'teal' : 'rose';
+      const rungPriority = active ? 6 : 4;
+      drawBrailleLine(canvas, left + 3, y, right - 3, y, active ? 1 : 0, rungColor, rungPriority);
+      for (let x = left + 3; x < right - 2; x += active ? 2 : 3) {
+        plotBrailleThick(canvas, x, y, active ? 1 : 0, rungColor, rungPriority);
+      }
+      plotBrailleThick(canvas, Math.round((left + right) / 2), y, active ? 1 : 0, active ? 'white' : 'amber', rungPriority + 1);
+      plotBrailleThick(canvas, a, y, active ? 1 : 0, strandAColor, strandAPriority + 1);
+      plotBrailleThick(canvas, b, y, active ? 1 : 0, strandBColor, strandBPriority + 1);
+    }
+  }
+
+  for (const line of renderBrailleCanvas(canvas, { useColor })) {
+    lines.push(line);
+  }
+
+  lines.push(renderStatusCapsule('HELIX', `frames ${tick % frameCount}/${frameCount} | global ${status.globalReadiness.installed.length}/${status.globalReadiness.required}`, width, { useColor, color: ANSI.amber }));
+
+  return lines.slice(0, height).map((line) => fitText(line, width));
+}
+
+function renderMeterBar(value, total, width, { useColor = false, color = ANSI.teal } = {}) {
+  const safeTotal = Math.max(1, total);
+  const safeValue = Math.max(0, Math.min(value, safeTotal));
+  const fill = Math.round((safeValue / safeTotal) * width);
+  const filled = '█'.repeat(fill);
+  const empty = '░'.repeat(Math.max(0, width - fill));
+  return `${colorize(filled, color, useColor)}${colorize(empty, ANSI.gray, useColor)}`;
+}
+
+function renderSparkline(series, { useColor = false, color = ANSI.teal } = {}) {
+  const blocks = ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█'];
+  return series.map((value) => colorize(blocks[Math.max(0, Math.min(blocks.length - 1, value))], color, useColor)).join('');
+}
+
+function buildTelemetrySeries(seed, length, tick) {
+  return Array.from({ length }, (_, index) => {
+    const raw = Math.sin((index + 1 + seed) * 0.72 + tick * 0.18) + Math.cos((index + seed) * 0.33 + tick * 0.11);
+    const normalized = Math.max(0, Math.min(1, (raw + 2) / 4));
+    return Math.round(normalized * 7);
+  });
+}
+
+function buildOverviewSignalLine(status, width, tick, { useColor = false, compact = false } = {}) {
+  const signalWidth = Math.max(6, Math.min(compact ? 8 : 12, Math.floor(width / (compact ? 10 : 8))));
+  const healthWidth = Math.max(6, Math.min(compact ? 8 : 12, Math.floor(width / (compact ? 10 : 8))));
+  const signal = renderSparkline(
+    buildTelemetrySeries(status.globalReadiness.installed.length + status.pendingSuccessDrafts, signalWidth, tick),
+    { useColor, color: ANSI.teal },
+  );
+  const health = renderSparkline(
+    buildTelemetrySeries(status.studyCandidates + (status.globalReadiness.ready ? 7 : 3), healthWidth, tick + 3),
+    { useColor, color: ANSI.amber },
+  );
+  return compact
+    ? `signal ${signal} health ${health}`
+    : `signal ${signal}   health ${health}`;
+}
+
+function telemetryPanelLines(status, selected, width, height, { useColor = false, tick = 0, compact = false } = {}) {
+  const commandArea = resolveCommandArea(selected);
+  const bundledCatalog = status.bundledCatalog ?? { total: 0, categories: [] };
+  const categoryLead = bundledCatalog.categories
+    ?.filter((category) => category.count > 0)
+    .sort((left, right) => right.count - left.count)[0];
+  const categoryName = categoryLead?.label ?? 'none';
+  const categoryCount = categoryLead?.count ?? 0;
+  const meterWidth = Math.max(8, Math.min(16, width - 14));
+  const sparkWidth = Math.max(8, Math.min(compact ? 8 : 12, width - 18));
+  const skillsSpark = renderSparkline(buildTelemetrySeries(status.globalReadiness.installed.length + categoryCount, sparkWidth, tick), { useColor, color: ANSI.amber });
+  const draftsSpark = renderSparkline(buildTelemetrySeries(status.pendingSuccessDrafts + 2, sparkWidth, tick + 2), { useColor, color: ANSI.teal });
+  const studySpark = renderSparkline(buildTelemetrySeries(status.studyCandidates + 4, sparkWidth, tick + 4), { useColor, color: ANSI.blue });
+  const lines = [
+    fitText(colorize('SYSTEM WINDOWS', ANSI.bold, useColor), width),
+    renderStatusCapsule('AREA', commandArea, width, { useColor, color: ANSI.blue }),
+    renderStatusCapsule('LEAD', `${categoryName} ${categoryCount}`, width, { useColor, color: ANSI.gray }),
+    fitText(`bundle   ${String(bundledCatalog.total).padStart(2, '0')}  ${renderMeterBar(bundledCatalog.total, Math.max(36, bundledCatalog.total), meterWidth, { useColor, color: ANSI.white })}`, width),
+    fitText(`global   ${status.globalReadiness.installed.length}/${status.globalReadiness.required} ${renderMeterBar(status.globalReadiness.installed.length, status.globalReadiness.required, meterWidth, { useColor, color: ANSI.amber })}`, width),
+    renderStatusCapsule('LINK', summarizeClientReadiness(status.globalReadiness), width, { useColor, color: ANSI.teal }),
+    fitText(`skills   ${skillsSpark}`, width),
+    fitText(`drafts   ${String(status.pendingSuccessDrafts).padStart(2, '0')}  ${renderMeterBar(status.pendingSuccessDrafts, Math.max(6, status.pendingSuccessDrafts || 1), meterWidth, { useColor, color: ANSI.teal })}`, width),
+    fitText(`queue    ${draftsSpark}`, width),
+    fitText(`study    ${String(status.studyCandidates).padStart(2, '0')}  ${renderMeterBar(status.studyCandidates, Math.max(8, status.studyCandidates || 1), meterWidth, { useColor, color: ANSI.blue })}`, width),
+    fitText(`links    ${studySpark}`, width),
+    fitText(colorize(compact ? 'codex / claude / gemini' : 'codex / claude / gemini / antigravity', ANSI.dim, useColor), width),
+  ];
+
+  return lines.slice(0, height).map((line) => fitText(line, width));
+}
+
+function cyberCorePanelLines(status, selected, width, height, { useColor = false, tick = 0, compact = false } = {}) {
+  const actionArea = resolveCommandArea(selected);
+  const gridHeight = Math.max(compact ? 4 : 6, height - (compact ? 5 : 6));
+  const gridWidth = Math.max(12, width);
+  const lines = [
+    fitText(colorize('SKILL_MASTER CORE', ANSI.bold, useColor), width),
+    fitText(colorize(compact ? 'cyber lattice / low flicker' : 'cyberpunk pixel art workflow engine', ANSI.dim, useColor), width),
+    fitText(colorize(`area ${actionArea} | tick ${String(tick).padStart(3, '0')}`, ANSI.gray, useColor), width),
+    fitText(renderCircuitRail(width, tick, { useColor, color: ANSI.teal }), width),
+    ...renderScanGrid(gridWidth, gridHeight, tick, { useColor }).map((line) => fitText(line, width)),
+    fitText(renderCircuitRail(width, tick + 2, { useColor, color: ANSI.amber }), width),
+    fitText(colorize(`global ${status.globalReadiness.installed.length}/${status.globalReadiness.required} | bundle ${status.bundledCatalog?.total ?? 0}`, ANSI.gray, useColor), width),
+  ];
+
+  return lines.slice(0, height).map((line) => fitText(line, width));
+}
+
+function renderBox(lines, width, title, { useColor = false, color = ANSI.cyan, style = 'normal' } = {}) {
+  const innerWidth = Math.max(10, width - 4);
+  const titleText = title ? ` ${title.toUpperCase()} ` : '';
+  const topLeft = style === 'focus' ? '╭' : style === 'hud' ? '┏' : '┌';
+  const topRight = style === 'focus' ? '╮' : style === 'hud' ? '┓' : '┐';
+  const bottomLeft = style === 'focus' ? '╰' : style === 'hud' ? '┗' : '└';
+  const bottomRight = style === 'focus' ? '╯' : style === 'hud' ? '┛' : '┘';
+  const topFill = style === 'focus' ? '═' : '─';
+  const bottomTail = style === 'focus' ? '══' : '┄┄';
+  const top = `${topLeft}${titleText}${topFill.repeat(Math.max(0, width - 2 - titleText.length))}${topRight}`;
+  const bottom = `${bottomLeft}${topFill.repeat(Math.max(0, width - 4))}${bottomTail}${bottomRight}`;
+  const body = lines.map((line, index) => {
+    const left = index === 0
+      ? (style === 'focus' ? '╞' : '├')
+      : index === lines.length - 1
+        ? (style === 'focus' ? '╘' : '╰')
+        : '│';
+    const right = index === 0
+      ? (style === 'focus' ? '╡' : '┤')
+      : index === lines.length - 1
+        ? (style === 'focus' ? '╛' : '╯')
+        : '│';
+    return `${colorize(left, color, useColor)} ${fitText(line, innerWidth)} ${colorize(right, color, useColor)}`;
+  });
+  return [
+    colorize(top, color, useColor),
+    ...body,
+    colorize(bottom, color, useColor),
+  ];
+}
+
+function joinHorizontalBoxes(boxes, gutter = 2) {
+  const height = Math.max(...boxes.map((box) => box.lines.length));
+  const gap = ' '.repeat(gutter);
+  const rows = [];
+
+  for (let index = 0; index < height; index += 1) {
+    rows.push(boxes.map((box) => box.lines[index] ?? ' '.repeat(box.width)).join(gap));
+  }
+
+  return rows;
+}
+
+export function formatCyberMenuFrame(status, commands, selectedIndex, tick = 0, {
+  columns = 120,
+  rows = 32,
+  useColor = false,
+} = {}) {
+  const width = Math.max(72, Math.min(columns, 150));
+  const height = Math.max(22, Math.min(rows - 1, 42));
+  const compactMode = width < 104 || height < 27;
+  const rightWidth = compactMode ? (width >= 92 ? 28 : 26) : width >= 132 ? 44 : width >= 118 ? 34 : width >= 108 ? 32 : 30;
+  const gutter = 2;
+  const leftWidth = width - rightWidth - gutter;
+  const selected = commands[selectedIndex] ?? commands[0];
+  const actionArea = resolveCommandArea(selected);
+  const bundledCatalog = status.bundledCatalog ?? { total: 0, categories: [] };
+  const summaryOuterHeight = compactMode ? 7 : 9;
+  const bodyOuterHeight = Math.max(12, height - summaryOuterHeight - 1);
+  const detailOuterHeight = compactMode
+    ? Math.min(8, Math.max(7, Math.floor(bodyOuterHeight * 0.46)))
+    : Math.min(10, Math.max(8, Math.floor(bodyOuterHeight * 0.42)));
+  const actionOuterHeight = compactMode
+    ? Math.max(8, bodyOuterHeight - detailOuterHeight)
+    : Math.max(8, bodyOuterHeight - detailOuterHeight);
+  const rightBottomOuterHeight = compactMode
+    ? Math.min(8, Math.max(7, Math.floor(bodyOuterHeight * 0.4)))
+    : Math.min(10, Math.max(9, Math.floor(bodyOuterHeight * 0.36)));
+  const rightTopOuterHeight = Math.max(8, bodyOuterHeight - rightBottomOuterHeight);
+  const summaryInnerWidth = width - 4;
+  const actionInnerWidth = leftWidth - 4;
+  const detailInnerWidth = leftWidth - 4;
+  const rightInnerWidth = rightWidth - 4;
+  const summaryInnerHeight = summaryOuterHeight - 2;
+  const actionInnerHeight = actionOuterHeight - 2;
+  const detailInnerHeight = detailOuterHeight - 2;
+  const rightTopInnerHeight = rightTopOuterHeight - 2;
+  const rightBottomInnerHeight = rightBottomOuterHeight - 2;
+  const visibleActionRows = Math.max(compactMode ? 2 : 3, actionInnerHeight - (compactMode ? 2 : 3));
+  const scrollStart = Math.min(
+    Math.max(0, selectedIndex - Math.floor(visibleActionRows / 2)),
+    Math.max(0, commands.length - visibleActionRows),
+  );
+  const visibleCommands = commands.slice(scrollStart, scrollStart + visibleActionRows);
+
+  const summaryLines = compactMode
+    ? [
+        colorize('SKILL MASTER MENU', ANSI.bold, useColor),
+        `version ${status.semver} | channel ${status.manifestVersion} | readiness ${status.globalReadiness.ready ? 'ready' : status.globalReadiness.mode}`,
+        colorize(`GLOBAL SKILLS ${status.globalReadiness.installed.length}/${status.globalReadiness.required}`, ANSI.amber, useColor),
+        `bundle ${bundledCatalog.total} | drafts ${status.pendingSuccessDrafts} | study ${status.studyCandidates}`,
+        buildOverviewSignalLine(status, summaryInnerWidth, tick, { useColor, compact: true }),
+        colorize(buildSetupAlertLine(status, true) ?? 'compact cyberpunk hud / operator safe', status.globalReadiness.ready ? ANSI.dim : ANSI.rose, useColor),
+      ]
+    : [
+        colorize('SKILL MASTER MENU', ANSI.bold, useColor),
+        `version ${status.semver} | channel ${status.manifestVersion} | readiness ${status.globalReadiness.ready ? 'ready' : status.globalReadiness.mode}`,
+        colorize(`GLOBAL SKILLS ${status.globalReadiness.installed.length}/${status.globalReadiness.required}`, ANSI.amber, useColor),
+        `bundle ${bundledCatalog.total} | drafts ${status.pendingSuccessDrafts} | study ${status.studyCandidates}`,
+        renderStatusCapsule('FOCUS', `${actionArea} / ${selected?.key ?? 'status'}`, summaryInnerWidth, { useColor, color: ANSI.teal }),
+        buildOverviewSignalLine(status, summaryInnerWidth, tick, { useColor, compact: false }),
+        colorize(buildSetupAlertLine(status, false) ?? formatBundledCategoryLine(bundledCatalog), status.globalReadiness.ready ? ANSI.white : ANSI.rose, useColor),
+        colorize(buildSetupAlertLine(status, false) ?? `clients ${summarizeClientReadiness(status.globalReadiness)}`, status.globalReadiness.ready ? ANSI.dim : ANSI.rose, useColor),
+      ];
+
+  const actionLines = [
+    colorize('ACTION MATRIX', ANSI.gray, useColor),
+    colorize('up/down move  enter run  q exit', ANSI.dim, useColor),
+    fitText(colorize(`window ${Math.min(selectedIndex + 1, commands.length)}/${commands.length} | visible ${visibleCommands.length}`, ANSI.gray, useColor), actionInnerWidth),
+    ...visibleCommands.map((command, offset) => {
+      const index = scrollStart + offset;
+      const marker = index === selectedIndex ? '>' : '·';
+      const disabled = command.disabledReason ? ' [off]' : '';
+      const flair = index === selectedIndex && !compactMode ? '  ◢' : '';
+      const badge = getActionAttentionBadge(command, status);
+      const label = `${marker} ${badge}${command.label}${disabled}${flair}`;
+      const color = getActionLineColor(command, index === selectedIndex, status);
+      const fitted = fitText(label, actionInnerWidth);
+      return color ? colorize(fitted, color, useColor) : fitted;
+    }),
+  ];
+
+  while (actionLines.length < actionInnerHeight) {
+    actionLines.push(fitText('', actionInnerWidth));
+  }
+
+  const descriptionLines = [
+    colorize('DETAIL FOCUS', ANSI.amber, useColor),
+    colorize(selected?.label ?? 'Nenhuma acao', ANSI.bold, useColor),
+    renderStatusCapsule('AREA', `${actionArea} | action ${Math.min(selectedIndex + 1, commands.length)}/${commands.length}`, detailInnerWidth, { useColor, color: ANSI.gray }),
+    fitText(colorize(patternFill('=-', 32), ANSI.amber, useColor), detailInnerWidth),
+    ...(() => {
+      const attention = getActionAttentionState(selected, status);
+      if (attention === 'critical') {
+        return splitText('priority: setup inicial fortemente recomendado. Esta acao autentica o MCP no sistema e prepara os clientes deste computador.', detailInnerWidth, 2);
+      }
+      if (attention === 'priority') {
+        return splitText('priority: suporte ao setup global. Use junto do bootstrap para deixar Codex, Claude, Gemini e skills prontos neste computador.', detailInnerWidth, 2);
+      }
+      return [];
+    })(),
+    ...splitText(selected?.description ? `desc: ${selected.description}` : '', detailInnerWidth, 1),
+    ...(selected?.key === 'updateGlobal'
+      ? splitText('recommended: se houver handoff ou aviso, feche o menu, rode o comando exibido e reabra os clientes MCP depois.', detailInnerWidth, 3)
+      : []),
+    ...((selected?.details ?? []).flatMap((detail) => splitText(`detail: ${detail}`, detailInnerWidth, 2))),
+    ...splitText(`exec: ${formatActionCommand(selected)}`, detailInnerWidth, 1),
+    ...splitText(selected?.success ? `result: ${selected.success}` : '', detailInnerWidth, 1),
+    ...(selected?.confirmMessage ? splitText(`confirmacao: ${selected.confirmMessage}`, detailInnerWidth, 2) : []),
+    ...(selected?.disabledReason ? splitText(`Indisponivel: ${selected.disabledReason}`, detailInnerWidth, 2) : []),
+  ];
+
+  while (descriptionLines.length < detailInnerHeight) {
+    descriptionLines.push(fitText('', detailInnerWidth));
+  }
+
+  const rightTopLines = dnaPanelLines(tick, rightInnerWidth, rightTopInnerHeight, status, selected, { useColor, compact: compactMode });
+  const rightBottomLines = telemetryPanelLines(status, selected, rightInnerWidth, rightBottomInnerHeight, { useColor, tick, compact: compactMode });
+  const summaryBox = renderCyberFrame(
+    summaryLines.slice(0, summaryInnerHeight).map((line) => fitText(line, summaryInnerWidth)),
+    width,
+    'overview',
+    { useColor, color: ANSI.white, style: 'hud', tick },
+  );
+  const actionBox = renderCyberFrame(
+    actionLines.slice(0, actionInnerHeight).map((line) => fitText(line, actionInnerWidth)),
+    leftWidth,
+    'actions',
+    { useColor, color: ANSI.gray, style: 'thin', tick },
+  );
+  const detailBox = renderCyberFrame(
+    descriptionLines.slice(0, detailInnerHeight).map((line) => fitText(line, detailInnerWidth)),
+    leftWidth,
+    'details',
+    { useColor, color: ANSI.amber, style: 'focus', tick },
+  );
+  const dnaBox = renderCyberFrame(rightTopLines, rightWidth, 'dna-core', { useColor, color: ANSI.white, style: 'hud', tick });
+  const telemetryBox = renderCyberFrame(rightBottomLines, rightWidth, 'telemetry', { useColor, color: ANSI.blue, style: 'thin', tick });
+  const bodyRows = joinHorizontalBoxes([
+    { lines: [...actionBox, ...detailBox], width: leftWidth },
+    { lines: [...dnaBox, ...telemetryBox], width: rightWidth },
+  ], gutter);
+
+  return [...summaryBox, '', ...bodyRows].join('\n');
+}
+
+export function formatRunningActionFrame(status, action, tick = 0, {
+  columns = 120,
+  rows = 32,
+  useColor = false,
+} = {}) {
+  const width = Math.max(72, Math.min(columns, 150));
+  const height = Math.max(18, Math.min(rows - 1, 30));
+  const innerWidth = width - 4;
+  const commandArea = resolveCommandArea(action);
+  const pulse = renderSparkline(buildTelemetrySeries((status.globalReadiness.installed.length || 1) + tick, Math.max(8, Math.min(18, Math.floor(innerWidth / 5))), tick), { useColor, color: ANSI.teal });
+  const gridHeight = Math.max(4, Math.min(8, height - 14));
+  const lines = [
+    colorize('SKILL_MASTER WORKFLOW ONLINE', ANSI.bold, useColor),
+    fitText(colorize(`area ${commandArea} | launching ${action?.label ?? 'acao'}`, ANSI.amber, useColor), innerWidth),
+    fitText(colorize(`pulse ${pulse}`, ANSI.gray, useColor), innerWidth),
+    fitText(renderCircuitRail(innerWidth, tick, { useColor, color: ANSI.teal }), innerWidth),
+    ...renderScanGrid(innerWidth, gridHeight, tick, { useColor }),
+    fitText('', innerWidth),
+    ...splitText(action?.description ?? '', innerWidth, 2),
+    ...splitText(action?.success ? `resultado esperado: ${action.success}` : '', innerWidth, 2),
+    ...splitText(`exec: ${formatActionCommand(action)}`, innerWidth, 2),
+    fitText('', innerWidth),
+    fitText(colorize('handoff: HUD -> stream real do comando', ANSI.dim, useColor), innerWidth),
+  ];
+
+  while (lines.length < Math.max(8, height - 2)) {
+    lines.push(fitText('', innerWidth));
+  }
+
+  return renderCyberFrame(
+    lines.slice(0, Math.max(8, height - 2)).map((line) => fitText(line, innerWidth)),
+    width,
+    'running',
+    { useColor, color: ANSI.teal, style: 'running', tick },
+  ).join('\n');
+}
+
+export function formatSkillMasterIntroFrame(status, tick = 0, {
+  columns = 120,
+  rows = 32,
+  useColor = false,
+  message = 'skill_master assumindo o workflow',
+} = {}) {
+  const width = Math.max(72, Math.min(columns, 150));
+  const height = Math.max(18, Math.min(rows - 1, 34));
+  const innerWidth = width - 4;
+  const gridHeight = Math.max(6, Math.min(12, height - 12));
+  const signal = renderSparkline(buildTelemetrySeries(status.pendingSuccessDrafts + status.studyCandidates + 5, Math.max(12, Math.min(28, Math.floor(innerWidth / 4))), tick), { useColor, color: ANSI.teal });
+  const lines = [
+    colorize('REBORN / SKILL_MASTER', ANSI.bold, useColor),
+    fitText(colorize(message, ANSI.amber, useColor), innerWidth),
+    fitText(colorize(`package ${status.packageName} | version ${status.semver} | channel ${status.manifestVersion}`, ANSI.gray, useColor), innerWidth),
+    fitText(colorize(`signal ${signal}`, ANSI.teal, useColor), innerWidth),
+    fitText(renderCircuitRail(innerWidth, tick, { useColor, color: ANSI.white }), innerWidth),
+    ...renderScanGrid(innerWidth, gridHeight, tick, { useColor }),
+    fitText(renderCircuitRail(innerWidth, tick + 3, { useColor, color: ANSI.amber }), innerWidth),
+    fitText(colorize(`global ${status.globalReadiness.installed.length}/${status.globalReadiness.required} | bundle ${status.bundledCatalog?.total ?? 0} | study ${status.studyCandidates}`, ANSI.gray, useColor), innerWidth),
+    fitText(colorize('modo visual seguro: terminal humano ativo / stdio MCP preservado', ANSI.dim, useColor), innerWidth),
+  ];
+
+  while (lines.length < Math.max(8, height - 2)) {
+    lines.push(fitText('', innerWidth));
+  }
+
+  return renderCyberFrame(
+    lines.slice(0, Math.max(8, height - 2)).map((line) => fitText(line, innerWidth)),
+    width,
+    'boot-sequence',
+    { useColor, color: ANSI.teal, style: 'hud', tick },
+  ).join('\n');
+}
+
+export function formatCyberConfirmFrame(status, action, tick = 0, {
+  columns = 120,
+  rows = 32,
+  useColor = false,
+} = {}) {
+  const width = Math.max(72, Math.min(columns, 140));
+  const height = Math.max(16, Math.min(rows - 1, 28));
+  const innerWidth = width - 4;
+  const commandArea = resolveCommandArea(action);
+  const lines = [
+    colorize('CONFIRMATION GATE', ANSI.bold, useColor),
+    fitText(colorize(action?.confirmMessage ?? 'Confirmar acao?', ANSI.amber, useColor), innerWidth),
+    fitText(`area ${commandArea} | action ${action?.key ?? 'unknown'}`, innerWidth),
+    fitText(renderCircuitRail(innerWidth, tick, { useColor, color: ANSI.amber }), innerWidth),
+    ...splitText(action?.description ?? '', innerWidth, 2),
+    ...splitText(action?.success ? `resultado esperado: ${action.success}` : '', innerWidth, 2),
+    fitText('', innerWidth),
+    fitText(colorize('Y/Enter confirma   N/Esc cancela', ANSI.teal, useColor), innerWidth),
+  ];
+
+  while (lines.length < Math.max(8, height - 2)) {
+    lines.push(fitText('', innerWidth));
+  }
+
+  return renderCyberFrame(
+    lines.slice(0, Math.max(8, height - 2)).map((line) => fitText(line, innerWidth)),
+    width,
+    'subroutine',
+    { useColor, color: ANSI.amber, style: 'focus', tick },
+  ).join('\n');
+}
+
+export function formatActionHeader(action, { useColor = false } = {}) {
+  const lines = [
+    colorize(action.label, ANSI.bold, useColor),
+    action.description,
+    ...(action.details ?? []),
+    action.success ? `Resultado esperado: ${action.success}` : null,
+    action.disabledReason ? `Indisponivel: ${action.disabledReason}` : null,
+  ].filter(Boolean);
+
+  const width = Math.max(72, Math.min(120, Math.max(...lines.map((line) => visibleLength(line))) + 8));
+  return renderCyberFrame(
+    lines.map((line) => fitText(line, width - 4)),
+    width,
+    'skill-master action',
+    { color: ANSI.green, useColor, style: 'hud' },
+  ).join('\n');
+}
+
+export function formatResultMessage(code, { useColor = false } = {}) {
+  const result = buildOperationResultCopy(code);
+  const tone = result.kind === 'ok' ? 'ok' : result.kind === 'warning' ? 'warning' : 'error';
+  const color = tone === 'ok' ? ANSI.green : tone === 'warning' ? ANSI.amber : ANSI.red;
+  const lines = [
+    colorize(result.heading, color, useColor),
+    result.summary,
+    result.next,
+    tone === 'warning' ? 'consulte o proximo passo recomendado no log acima' : null,
+  ];
+
+  return renderCyberFrame(
+    lines.filter(Boolean).map((line) => fitText(line, 68)),
+    72,
+    result.frameTitle,
+    { color, useColor, style: tone === 'ok' ? 'hud' : 'focus' },
+  ).join('\n');
+}
+
+export function formatPlainResultMessage(code, { useColor = false } = {}) {
+  const result = buildOperationResultCopy(code);
+  const color = result.kind === 'ok' ? ANSI.green : result.kind === 'warning' ? ANSI.amber : ANSI.red;
+  return colorize(result.summary, color, useColor);
+}
+
+export function formatHelp(commands) {
+  const actionList = commands.map((command) => {
+    const aliases = command.aliases.length ? ` aliases: ${command.aliases.join(', ')}` : '';
+    const disabled = command.disabledReason ? ` indisponivel: ${command.disabledReason}` : '';
+    return `  - ${command.key}: ${command.label}\n    ${command.description}${aliases}${disabled}`;
+  }).join('\n');
+
+  return `Skill Master Menu
+
+Uso:
+  skill-master-menu
+  skill-master-menu --status
+  skill-master-menu --run <acao>
+  skill-master-menu --run update --yes
+  skill-master-menu --help
+
+Acoes disponiveis:
+${actionList}
+
+O comando de menu e voltado para operacao humana. O binario MCP stdio continua sendo:
+  skill-master-mcp
+`;
+}
+
+export function runCommand(action, { cwd, env = process.env } = {}) {
+  return new Promise((resolve, reject) => {
+    let child;
+
+    try {
+      child = spawn(action.command, action.args, {
+        cwd,
+        env,
+        shell: Boolean(action.shell),
+        stdio: 'inherit',
+      });
+    } catch (error) {
+      reject(error);
+      return;
+    }
+
+    child.on('error', reject);
+    child.on('close', (code) => {
+      resolve(code ?? 1);
+    });
+  });
+}