@fprad0/skill-master-mcp 0.0.7 → 0.0.9

package/CHANGELOG.md

@@ -4,9 +4,25 @@ All notable changes to `skill_master` will be tracked here.
 
 ## [Unreleased]
 
+## [0.0.9] - 2026-06-28
+
+- Add Catholic-inspired moral governance with `skill_master_moral_discernment`, moral gates, and prompt-router integration.
+- Add broad domain routing with `skill_master_domain_router` and global multidisciplinary skill recommendations.
+- Add bundled global Skill Master skills for moral discernment, AI ethics, professional boundaries, languages, science, philosophy, sociology, engineering, source review, and release ethics.
+- Add `skill-master-install-global-skills` to install bundled skills into `CODEX_HOME/skills` or `~/.codex/skills`.
+- Add `skill-master-register-clients` to generate/apply MCP registration for Codex, Claude Desktop, and Gemini.
 - Prepare a public npm publication path with dedicated workflow and operator guide.
 - Upgrade release automation from Node `20` to Node `22`.
 
+## [0.0.8] - 2026-06-27
+
+- Add `skill_master_prompt_router` with `manual`, `balanced`, and `always-on-assisted` activation modes.
+- Add Dev Senior Master persona routing, safety gates, Notion/update detection, and learned-skill signals.
+- Add success-learning flows for human approval packages, local/global activation, study decisions, and rejection history.
+- Add `skill-master-activation`, `skill-master-success-skills`, and `skill-master-eval-activation` operator CLIs.
+- Expand the terminal menu with activation status, prompt recommendations, learned-skill notifications, study/reject actions, and Notion summaries.
+- Add activation evals with positive, negative, and risk cases plus `npm run eval:activation`.
+
 ## [0.0.7] - 2026-06-26
 
 - Add a visual terminal menu for `skill-master-menu` using `prompts`, with TTY detection and direct action mode.

package/README.md

@@ -1,6 +1,6 @@
 # Skill Master MCP
 
-Versao planejada: `00.02`
+Versao planejada: `00.03`
 
 Este repositorio e a base independente do MCP `skill_master`. Ele nao pertence ao LinkBiz e deve evoluir como um projeto pessoal, preferencialmente publicado em um GitHub particular.
 
@@ -8,9 +8,9 @@ Este repositorio e a base independente do MCP `skill_master`. Ele nao pertence a
 
 Criar um MCP capaz de catalogar skills locais e remotas, recomendar as melhores skills para um prompt e manter atualizacoes automaticas para varios computadores e usuarios.
 
-## Decisao da versao 00.02
+## Decisao da versao 00.03
 
-A versao `00.02` consolida:
+A versao `00.03` consolida:
 
 - distribuicao publica por `npmjs.org`
 - distribuicao privada por GitHub Packages
@@ -108,18 +108,23 @@ npm install -g @fprad0/skill-master-mcp
 npx -y @fprad0/skill-master-mcp@latest
 ```
 
-Estado atual validado em `2026-06-26`:
+Estado atual preparado em `2026-06-28`:
 
-- pacote publico publicado: `@fprad0/skill-master-mcp@0.0.7`
-- dist-tag `latest` apontando para `0.0.7`
-- workflow `Publish Skill Master to npmjs` concluido com sucesso
-- `npm install` e `npx` confirmados
+- release publica: `@fprad0/skill-master-mcp@0.0.9`
+- `latest` no npmjs aponta para `0.0.9`
+- validacao de pacote por tarball local confirmada
+- validacao de instalacao publica via `npm install @fprad0/skill-master-mcp@0.0.9` confirmada
 
 Comandos globais principais:
 
 ```bash
+skill-master-activation
+skill-master-eval-activation
+skill-master-install-global-skills
 skill-master-mcp
 skill-master-menu
+skill-master-register-clients
+skill-master-success-skills
 skill-master-update
 skill-master-configure-private-registry
 ```
@@ -136,10 +141,71 @@ O menu agora possui modo visual interativo para terminal com TTY e tambem aceita
 skill-master-menu --run status
 skill-master-menu --run check
 skill-master-menu --run update --yes
+skill-master-menu --run install-global-skills
+skill-master-menu --run bootstrap-global
+skill-master-menu --run register-clients
+skill-master-menu --run notifications
+skill-master-menu --run study-skills
+skill-master-menu --run approval-package
+skill-master-menu --run activation-status
+skill-master-menu --run recommend-prompt
+skill-master-menu --run notion-summary
 ```
 
 O menu visual usa `prompts` para ficar mais legivel no terminal e manter compatibilidade com `Node 18+`.
 
+Quando o menu detectar que o MCP ainda nao esta globalmente pronto neste computador, ele mostra um alerta forte e um aviso sutil explicando que a instalacao global e o registro dos clientes sao necessarios para o `skill_master` parecer parte do sistema em Codex, Claude e Gemini.
+
+Para instalar as skills globais embutidas de discernimento, conhecimento amplo, engenharia e governanca moral:
+
+```bash
+skill-master-install-global-skills
+```
+
+Para fazer o bootstrap global completo em um passo:
+
+```bash
+skill-master-bootstrap-global
+```
+
+Para registrar o MCP nos clientes principais usando o binario global `skill-master-mcp`:
+
+```bash
+skill-master-register-clients --apply-codex
+skill-master-register-clients --apply-claude
+skill-master-register-clients --apply-gemini
+```
+
+Atalho para gerar snippets e aplicar nos tres:
+
+```bash
+skill-master-register-clients --apply-all
+```
+
+Isso configura o servidor MCP `skill_master` em Codex, Claude Desktop e Gemini quando os arquivos de configuracao locais estiverem disponiveis. Reinicie o cliente depois do registro.
+
+O menu tambem mostra notificacoes de skills aprendidas pendentes e links externos para estudo. As acoes de ativacao sao:
+
+- `skill-master-menu --run activate-learned-local`: instala uma skill aprovada em `.codex/skills` do workspace atual.
+- `skill-master-menu --run activate-learned-global`: instala uma skill aprovada em `${CODEX_HOME:-~/.codex}/skills`.
+- `skill-master-menu --run mark-study`: registra uma skill candidata como material para estudo.
+- `skill-master-menu --run reject-skill`: rejeita uma skill candidata preservando historico.
+
+Para modo de ativacao e recomendacao local:
+
+```bash
+skill-master-activation --status
+skill-master-activation --set-mode balanced
+skill-master-activation --route-prompt "skill-master, recomende skills para este prompt"
+skill-master-activation --notion-summary
+```
+
+Para rodar as avaliacoes de ativacao antes de release:
+
+```bash
+npm run eval:activation
+```
+
 Para atualizar a instalacao global via npm sem iniciar o servidor MCP:
 
 ```bash
@@ -173,7 +239,7 @@ Os dois caminhos configuram:
 
 ## Compatibilidade com Claude e Gemini
 
-A versao `00.02` documenta compatibilidade operacional ja preparada para:
+A versao `00.03` documenta compatibilidade operacional ja preparada para:
 
 - Claude Desktop
 - Claude Code
@@ -200,18 +266,66 @@ O `skill_master` pode aprender com as skills ja existentes em cada maquina insta
 Ferramentas MCP principais:
 
 - `skill_master_refresh_catalog`
+- `skill_master_prompt_router`
+- `skill_master_activation_check`
+- `skill_master_recommend`
+- `skill_master_moral_discernment`
+- `skill_master_domain_router`
+- `skill_master_bootstrap_global`
+- `skill_master_install_global_skills`
 - `skill_master_prepare_skill_contribution`
 - `skill_master_review_skill_contribution`
+- `skill_master_prepare_success_skill`
+- `skill_master_review_success_skill`
+- `skill_master_list_unapproved_success_skills`
+- `skill_master_prepare_success_skill_approval_package`
+- `skill_master_activate_success_skill`
 
 O pacote de contribuicao nao envia arquivos automaticamente, nao executa skills desconhecidas e nao inclui caminhos completos ou corpo bruto por padrao.
 
+O fluxo de aprendizado por implementacoes bem-sucedidas cria rascunhos locais em staging, gera pacote de aprovacao humana e permite ativacao explicita em escopo local ou global. Ele exige evidencias, revisa risco/duplicidade e mantem candidatos externos como nao aprovados ate revisao humana. Nenhuma skill aprendida e publicada automaticamente.
+
 Leia:
 
 - [Rede segura de skills](docs/architecture/REDE_SEGURA_DE_SKILLS.md)
+- [Aprendizado de implementacoes bem-sucedidas](docs/architecture/APRENDIZADO_DE_IMPLEMENTACOES_BEM_SUCEDIDAS.md)
 
 ## Modos de ativacao em prompts
 
-A partir da versao `0.0.4`, clientes e agentes podem usar `skill_master_activation_check` antes de decidir se devem acionar recomendacoes de skills.
+Clientes e agentes podem usar `skill_master_prompt_router` como camada principal antes de decidir se devem acionar recomendacoes de skills, aplicar persona ou bloquear uma acao sensivel.
+
+Modos suportados:
+
+- `manual`: ativa apenas com mencao direta ao Skill Master ou gate bloqueante.
+- `balanced`: modo recomendado; ativa por mencao direta, tarefa tecnica com skill relevante, Notion, aprendizado, validacao, MCP ou publicacao.
+- `always-on-assisted`: avalia quase todo prompt, mas retorna `executionMode: no-op` quando nao houver ganho claro.
+
+Exemplo de chamada conceitual:
+
+```json
+{
+  "prompt": "skill-master, veja se existe uma skill para validar este deploy",
+  "activationMode": "balanced",
+  "riskTolerance": "normal"
+}
+```
+
+Saida esperada:
+
+```json
+{
+  "shouldActivate": true,
+  "personaOverlay": "Dev Senior Master",
+  "executionMode": "assist",
+  "safetyGates": [],
+  "learningOpportunity": false,
+  "notionUpdateNeeded": false
+}
+```
+
+Use `skill_master_activation_check` quando precisar apenas de uma decisao menor e retrocompativel de ativacao/recomendacao.
+
+Restricoes explicitas como `sem publicar`, `nao publicar` ou `nao publique` sao tratadas como execucao local. O router deve registrar `publication_explicitly_disabled` e nao pode transformar essa frase em autorizacao ou intencao de release.
 
 Ativacao explicita:
 
@@ -241,6 +355,11 @@ Cliente: chama skill_master_activation_check.
 Cliente: se ativar, chama skill_master_recommend ou segue as recomendacoes retornadas.
 ```
 
+Diagnostico importante:
+
+- `skill_master_list_sources` mostra `configPath`, `workspace` e se `workspaceRoots` esta configurado.
+- Se `workspaceRoots` estiver vazio, skills em `.codex/skills` do projeto nao serao catalogadas ate atualizar `sources.json` e reiniciar o processo MCP.
+
 ## Atualizacao automatica via npm
 
 Para instalacoes feitas por `npm install -g`, o caminho seguro de auto-update e executar `skill-master-update` fora do processo MCP.

package/VERSION.md

@@ -1,9 +1,9 @@
 # Versão
 
-Versão funcional planejada: `00.02`
+Versão funcional planejada: `00.03`
 
-Versão técnica para empacotamento semântico: `0.0.7`
+Versão técnica para empacotamento semântico: `0.0.9`
 
 ## Observação
 
-O nome `00.02` será usado na comunicação e nos documentos. Para ferramentas que exigem SemVer, como npm e alguns fluxos de release, usar `0.0.7`.
+O nome `00.03` será usado na comunicação e nos documentos. Para ferramentas que exigem SemVer, como npm e alguns fluxos de release, usar `0.0.9`.

package/bin/lib/menu-core.mjs

@@ -1,5 +1,6 @@
 import { spawn } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import os from 'node:os';
 import { join } from 'node:path';
 import process from 'node:process';
 
@@ -13,10 +14,91 @@ const ANSI = {
   red: '\x1b[31m',
 };
 
+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',
+];
+
 function colorize(text, color, enabled) {
   return enabled ? `${color}${text}${ANSI.reset}` : text;
 }
 
+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 hasSkillMaster = content.includes('skill_master');
+  const hasGlobalCommand = content.includes('command = "skill-master-mcp"') || content.includes("command = 'skill-master-mcp'");
+  const hasLauncher = content.includes('skill-master-launcher');
+
+  return {
+    present: true,
+    kind: hasGlobalCommand ? 'global' : hasLauncher ? 'launcher' : hasSkillMaster ? 'custom' : 'unknown',
+    globalCommand: hasGlobalCommand,
+  };
+}
+
+function readJsonState(filePath) {
+  if (!existsSync(filePath)) {
+    return { present: false, globalCommand: false };
+  }
+
+  try {
+    const parsed = JSON.parse(readFileSync(filePath, 'utf8'));
+    const server = parsed?.mcpServers?.skill_master;
+    return {
+      present: true,
+      globalCommand: server?.command === 'skill-master-mcp',
+    };
+  } catch {
+    return { present: true, 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 codexConfigPath = join(process.env.CODEX_HOME ?? join(os.homedir(), '.codex'), 'config.toml');
+  const claudeConfigPath = join(os.homedir(), '.config', 'Claude', 'claude_desktop_config.json');
+  const geminiConfigPath = join(os.homedir(), '.gemini', 'settings.json');
+  const codex = readClientConfigState(codexConfigPath);
+  const claude = readJsonState(claudeConfigPath);
+  const gemini = readJsonState(geminiConfigPath);
+  const ready = missing.length === 0 && codex.globalCommand && claude.globalCommand && gemini.globalCommand;
+  const mode = ready
+    ? 'ready'
+    : codex.kind === 'launcher' || claude.present || gemini.present
+      ? 'partial'
+      : 'missing';
+
+  return {
+    root,
+    required: REQUIRED_GLOBAL_SKILLS.length,
+    installed,
+    missing,
+    ready,
+    mode,
+    codex,
+    claude,
+    gemini,
+  };
+}
+
 export function readJson(rootDir, relativePath) {
   const target = join(rootDir, relativePath);
   if (!existsSync(target)) {
@@ -39,6 +121,10 @@ 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();
 
   return {
     packageName: packageJson?.name ?? 'nao encontrado',
@@ -47,9 +133,30 @@ export function getMenuStatus(rootDir) {
     manifestSemver: stableManifest?.semver ?? 'nao encontrado',
     versionText,
     rootDir,
+    pendingSuccessDrafts: countManifestFiles(successLearningDir),
+    studyCandidates: Array.isArray(studyCandidates?.candidates) ? studyCandidates.candidates.length : 0,
+    globalReadiness,
   };
 }
 
+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;
+}
+
 export function buildMenuCommands({ rootDir, currentFile, nodeExecPath = process.execPath }) {
   return [
     {
@@ -107,6 +214,133 @@ export function buildMenuCommands({ rootDir, currentFile, nodeExecPath = process
       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.',
+      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.',
+      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.',
+      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.',
+      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 as skills globais e registra Codex, Claude e Gemini no mesmo passo.',
+      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'],
+      label: 'Registrar Codex, Claude e Gemini',
+      description: 'Gera/aplica configuracoes MCP para reconhecer skill_master nos clientes principais.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-register-clients.mjs'), '--apply-all'],
+      confirmMessage: 'Aplicar registro do skill_master em Codex, Claude e Gemini?',
+    },
+    {
+      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.',
+      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.',
+      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.',
+      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.',
+      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.',
+      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.',
+      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.',
+      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.',
+      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.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--notion-summary'],
+    },
   ];
 }
 
@@ -138,6 +372,7 @@ export function isInteractiveTerminal() {
 }
 
 export function formatStatusReport(status) {
+  const readiness = status.globalReadiness;
   const lines = [
     'Skill Master MCP - status local',
     `Diretorio: ${status.rootDir}`,
@@ -145,6 +380,13 @@ export function formatStatusReport(status) {
     `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}`,
+    `Codex global: ${readiness.codex.globalCommand ? 'sim' : readiness.codex.kind}`,
+    `Claude global: ${readiness.claude.globalCommand ? 'sim' : readiness.claude.present ? 'nao-global' : 'ausente'}`,
+    `Gemini global: ${readiness.gemini.globalCommand ? 'sim' : readiness.gemini.present ? 'nao-global' : 'ausente'}`,
   ];
 
   if (status.versionText) {
@@ -155,6 +397,41 @@ export function formatStatusReport(status) {
   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 reconhecido como comando global neste computador.',
+        'Codex, Claude e Gemini podem ser apontados para skill-master-mcp.',
+        '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 e Gemini.',
+      ],
+      { 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)}+`;
@@ -168,9 +445,14 @@ export function formatMenuBanner(status, { useColor = false } = {}) {
     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'}`,
     colorize('Setas + Enter para navegar', ANSI.dim, useColor),
   ];
-  return renderPanelLines(lines, { color: ANSI.cyan, useColor });
+  return [
+    renderPanelLines(lines, { color: ANSI.cyan, useColor }),
+    formatGlobalAlert(status, { useColor }),
+  ].join('\n\n');
 }
 
 export function formatActionHeader(action, { useColor = false } = {}) {