@fprad0/skill-master-mcp 0.0.11 → 0.0.12

package/bin/skill-master-register-clients.mjs

@@ -1,14 +1,17 @@
 #!/usr/bin/env node
+import { spawnSync } from 'node:child_process';
 import { mkdirSync, writeFileSync } from 'node:fs';
 import os from 'node:os';
 import path, { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import {
   appendCodexServer,
+  buildClaudeCodeAddArgs,
   buildCodexBlock,
   buildJsonMcpSnippet,
   buildSkillMasterServerConfig,
   defaultClientConfigPaths,
+  formatShellCommand,
   mergeMcpServer,
   writeJson,
 } from './lib/client-config.mjs';
@@ -30,14 +33,18 @@ Uso:
   skill-master-register-clients --write-snippets
   skill-master-register-clients --apply-codex
   skill-master-register-clients --apply-claude
+  skill-master-register-clients --apply-claude-code
   skill-master-register-clients --apply-gemini
   skill-master-register-clients --apply-antigravity
   skill-master-register-clients --apply-all
   skill-master-register-clients --apply-codex --force
+  skill-master-register-clients --apply-claude-code --claude-code-scope user
 
 Registra o servidor MCP skill_master como stdio usando Node absoluto e o
 entrypoint absoluto do pacote. Isso evita falhas de PATH em Windows, Linux,
 macOS e apps desktop que nao herdam o terminal.
+
+Para Claude Code, o registrador usa o CLI oficial: claude mcp add.
 `);
   process.exit(0);
 }
@@ -48,22 +55,63 @@ const codexConfig = readValue('--codex-config', clientPaths.codex);
 const claudeConfig = readValue('--claude-config', clientPaths.claude);
 const geminiConfig = readValue('--gemini-config', clientPaths.gemini);
 const antigravityConfig = readValue('--antigravity-config', clientPaths.antigravity);
+const claudeCodeScope = readValue('--claude-code-scope', 'user');
+const claudeCodeCommand = readValue('--claude-code-command', 'claude');
 
 const applyAll = has('--apply-all');
 const applyCodex = applyAll || has('--apply-codex');
 const applyClaude = applyAll || has('--apply-claude');
+const applyClaudeCode = applyAll || has('--apply-claude-code');
 const applyGemini = applyAll || has('--apply-gemini');
 const applyAntigravity = applyAll || has('--apply-antigravity');
-const writeSnippets = applyAll || has('--write-snippets') || !(applyCodex || applyClaude || applyGemini || applyAntigravity);
+const writeSnippets = applyAll || has('--write-snippets') || !(applyCodex || applyClaude || applyClaudeCode || applyGemini || applyAntigravity);
 const force = has('--force');
 const serverConfig = buildSkillMasterServerConfig({ rootDir });
 const codexBlock = buildCodexBlock(serverConfig);
 const jsonSnippet = buildJsonMcpSnippet(serverConfig);
+const claudeCodeArgs = buildClaudeCodeAddArgs(serverConfig, { scope: claudeCodeScope });
+
+function commandExists(command) {
+  const lookup = process.platform === 'win32' ? 'where' : 'command';
+  const lookupArgs = process.platform === 'win32' ? [command] : ['-v', command];
+  const result = spawnSync(lookup, lookupArgs, { shell: process.platform !== 'win32', stdio: 'ignore' });
+  return result.status === 0;
+}
+
+function runClaudeCodeRegistration() {
+  if (!commandExists(claudeCodeCommand)) {
+    return {
+      ok: false,
+      skipped: true,
+      message: `Claude Code CLI '${claudeCodeCommand}' not found; run manually: ${formatShellCommand(claudeCodeCommand, claudeCodeArgs)}`,
+    };
+  }
+
+  const result = spawnSync(claudeCodeCommand, claudeCodeArgs, {
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'pipe'],
+  });
+  const output = `${result.stdout ?? ''}${result.stderr ?? ''}`.trim();
+
+  return {
+    ok: result.status === 0,
+    skipped: false,
+    message: result.status === 0
+      ? `Claude Code registered via ${formatShellCommand(claudeCodeCommand, claudeCodeArgs)}`
+      : `Claude Code registration failed (${result.status ?? 'unknown'}): ${output || 'no output'}`,
+  };
+}
 
 const writeSnippetsFiles = () => {
   mkdirSync(snippetsDir, { recursive: true });
   writeFileSync(path.join(snippetsDir, 'codex.config.toml'), codexBlock.trimStart(), 'utf8');
   writeJson(path.join(snippetsDir, 'claude_desktop_config.skill_master.json'), jsonSnippet);
+  writeFileSync(
+    path.join(snippetsDir, 'claude-code.commands.md'),
+    `# Claude Code - registrar skill_master\n\n\`\`\`bash\n${formatShellCommand(claudeCodeCommand, claudeCodeArgs)}\n\`\`\`\n\nDepois reinicie a sessao do Claude Code e valide com:\n\n\`\`\`bash\nclaude mcp list\n\`\`\`\n`,
+    'utf8',
+  );
+  writeJson(path.join(snippetsDir, 'claude-code.project.mcp.json'), jsonSnippet);
   writeJson(path.join(snippetsDir, 'gemini.settings.skill_master.json'), jsonSnippet);
   writeJson(path.join(snippetsDir, 'antigravity.mcp_config.skill_master.json'), jsonSnippet);
 };
@@ -78,7 +126,14 @@ if (applyCodex) {
 }
 if (applyClaude) {
   mergeMcpServer(claudeConfig, serverConfig, { recoverInvalidJson: force });
-  actions.push(`Claude config merged at ${claudeConfig}`);
+  actions.push(`Claude Desktop config merged at ${claudeConfig}`);
+}
+if (applyClaudeCode) {
+  const result = runClaudeCodeRegistration();
+  actions.push(result.message);
+  if (!result.ok && !result.skipped) {
+    process.exitCode = 1;
+  }
 }
 if (applyGemini) {
   mergeMcpServer(geminiConfig, serverConfig, { recoverInvalidJson: force });
@@ -95,4 +150,4 @@ console.log(`- Args: ${serverConfig.args.join(' ')}`);
 for (const action of actions) {
   console.log(`- ${action}`);
 }
-console.log('- Restart Codex, Claude, Gemini or Antigravity after registration.');
+console.log('- Restart Codex, Claude Desktop, Claude Code, Gemini or Antigravity after registration.');

package/docs/operations/GUIA_MULTI_COMPUTADOR.md

@@ -57,7 +57,7 @@ skill-master-menu --run doctor
 skill-master-menu --run bootstrap-global --yes
 ```
 
-O bootstrap registra Codex, Claude Desktop, Gemini CLI e Antigravity. Depois, reinicie os clientes.
+O bootstrap registra Codex, Claude Desktop, Claude Code, Gemini CLI e Antigravity quando os clientes locais estiverem disponiveis. Depois, reinicie os clientes.
 
 ## 3. Instalacao em um novo computador
 
@@ -155,6 +155,13 @@ skill-master-register-clients --apply-all --force
 skill-master-menu --run doctor
 ```
 
+Para corrigir apenas o Claude Code depois de `npm install -g @fprad0/skill-master-mcp`, use:
+
+```bash
+skill-master-register-clients --apply-claude-code --claude-code-scope user
+claude mcp list
+```
+
 No modelo clone + launcher, o cliente deve chamar o launcher, nao o `dist/index.js` diretamente.
 
 Exemplo conceitual:

package/docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md

@@ -0,0 +1,66 @@
+# Menu Visual Evidence - 2026-06-28
+
+## Objetivo
+
+Registrar evidencias da passada Reborn cyberpunk pixel art do `skill-master-menu`:
+
+- `overview` com mini-graficos
+- `telemetry` com sparklines e barras
+- `DNA-CORE` como animacao principal no lado direito, evoluida para `DNA CYBER HELIX`, com matriz braille 2x4, canvas mais cheio, paleta cyberpunk harmonica e scan vivo em cadencia mais fluida
+- intro `BOOT-SEQUENCE`, confirmacao visual e estado `running`
+- layout compacto para terminais menores
+- estado visual de execucao antes de transferir para o stream real do comando
+
+## Arquivos de evidencia
+
+Gerados pelo script:
+
+```bash
+node scripts/render-menu-evidence.mjs
+```
+
+Arquivos HTML:
+
+- `docs/operations/assets/menu-frame-large.html`
+- `docs/operations/assets/menu-frame-compact.html`
+- `docs/operations/assets/menu-frame-running.html`
+
+## O que validar visualmente
+
+### Frame grande
+
+- overview com identidade HUD
+- linha de sinal com mini-graficos
+- `DNA-CORE // DNA CYBER HELIX` como painel visual dominante no lado direito
+- dupla helice renderizada em braille/pixel art, com fitas mais encorpadas, pares de base pontilhados e scan em movimento
+- halo pixelado de baixa prioridade ao redor das fitas para preencher melhor o painel sem virar bloco solido
+- paleta por camada: fita cyan, fita ambar, bases azuis, scan branco e grid cinza
+- ciclo de 36 frames com easing senoidal para suavizar a rotacao visual
+- loop visual do menu em 160ms por frame para animacao mais fluida sem alterar os comandos `--run`
+- `details` com hierarquia visual maior que `actions`
+- `telemetry` com barras e sparklines
+
+### Frame compacto
+
+- identidade cyberpunk preservada
+- menu continua selecionavel e legivel
+- DNA-CORE e telemetry continuam presentes em versao condensada
+
+### Running state
+
+- transicao visual clara entre HUD e stream real do comando
+- acao, area e comando ficam explicitos antes da execucao
+
+### Fluxos extras cobertos por teste
+
+- intro `REBORN / SKILL_MASTER`
+- confirmacao `CONFIRMATION GATE`
+- resultado `SUBROUTINE COMPLETE` ou `SUBROUTINE FAILED`
+- saida textual preservada quando nao ha TTY
+
+## Evidencia tecnica
+
+- renderer principal: `bin/lib/menu-core.mjs`
+- fluxo interativo: `bin/skill-master-menu.mjs`
+- testes: `src/menu-core.test.ts`
+- validacao: `npm run check`, `node scripts/verify-menu-actions.mjs`, `npm pack --dry-run`

package/docs/operations/assets/menu-frame-compact.html

@@ -0,0 +1,76 @@
+<!doctype html>
+<html lang="pt-BR">
+<head>
+  <meta charset="utf-8" />
+  <title>Menu Frame 96x24</title>
+  <style>
+    :root {
+      color-scheme: dark;
+      --bg: #060606;
+      --panel: #0d0d0d;
+      --grid: rgba(255,255,255,0.06);
+      --line: rgba(255,255,255,0.25);
+      --text: #f3f3f3;
+      --muted: #8f949c;
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      min-height: 100vh;
+      background:
+        linear-gradient(var(--grid) 1px, transparent 1px),
+        linear-gradient(90deg, var(--grid) 1px, transparent 1px),
+        radial-gradient(circle at top, rgba(255,255,255,0.06), transparent 35%),
+        var(--bg);
+      background-size: 48px 48px, 48px 48px, auto, auto;
+      color: var(--text);
+      font-family: "Courier New", monospace;
+      padding: 32px;
+    }
+    .frame {
+      max-width: max-content;
+      background: linear-gradient(180deg, rgba(255,255,255,0.03), rgba(255,255,255,0.01));
+      border: 1px solid var(--line);
+      box-shadow: 0 0 0 1px rgba(255,255,255,0.04), 0 24px 64px rgba(0,0,0,0.45);
+      padding: 20px 24px;
+      white-space: pre;
+      line-height: 1.1;
+      font-size: 13px;
+      border-radius: 8px;
+    }
+    .title {
+      margin: 0 0 16px;
+      color: var(--muted);
+      letter-spacing: 0.12em;
+      text-transform: uppercase;
+      font-size: 12px;
+    }
+  </style>
+</head>
+<body>
+  <p class="title">Menu Frame 96x24</p>
+  <pre class="frame">┏╾────────── OVERVIEW▰▱▱──▰───────────────────────────────────────────────────────────────────╼┓
+▌ ▱SKILL MASTER MENU                                                                           ▐
+▌  version 0.0.11 | channel 00.05 | readiness ready                                            ▐
+▌  GLOBAL SKILLS 13/13                                                                         ▐
+▌  bundle 54 | drafts 3 | study 8                                                              ▐
+▌ ▱signal ██▇▅▄▃▃▃ health ██▇▆▄▃▃▃                                                             ▐
+┗╾────────────────▰▰▰─▱─▱─▱─▱─────────────────────────────────────────────────────────────────╼┛
+
+┌╴───────── ACTIONS▱╍╍──▱───────────────────────────────────────╶┐  ┏╾─── DNA-CORE▰───────────╼┓
+│ ╍ACTION GRID                                                   │  ▌ ▱DNA CYBER HELIX / ativa ▐
+│  up/down move  enter run  q exit                               │  ▌   ⠁  ⠸⣿⣿⡁     ⠁   ⡸⡻⡻    ▐
+│  . Rejeitar skill candidata                                    │  ▌       ⠈⠻⢿⣷⣦⣄⣀⠄⢀⣤⣴⡾⠞⠊     ▐
+│  . Ativar skill aprendida no workspace                         │  ▌   ⠁     ⠁⣈⣽⣿⣿⣿⣿⣭⣅⡀  ⠁    ▐
+│  &gt; Ativar skill aprendida global                               │  ▌       ⣀⣴⣿⠿⠛⠛⠓⠒⠛⠛⠻⢿⣷⣤⡀    ▐
+│ ╍. Abrir resumo para Notion                                    │  ▌ ▱ ⠁  ⠸⣿⣿⡁     ⠁   ⡹⡿⡿    ▐
+└╴───────────▱▱▱─╍─╍─╍─╍────────────────────────────────────────╶┘  ┗╾────▰───────────────────╼┛
+╭╼═════════ DETAILS▰▱▱══▰═══════════════════════════════════════╾╮  ┌╴─── TELEMETRY▱──────────╶┐
+▌ ▱DETAIL FOCUS                                                  ▐  │ ╍SYSTEM WINDOWS          │
+▌  Ativar skill aprendida global                                 ▐  │  selected area  ativacao │
+▌  area ativacao-skill | action 21/22                            ▐  │  dominant skill  fronten │
+▌  -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=                              ▐  │  bundle   54  ██████████ │
+▌ ▱Instala uma skill aprendida em CODEX_HOME/skills ou           ▐  │ ╍global   13/13 ████████ │
+╰╼═══════════▰▰▰═▱═▱═▱═▱════════════════════════════════════════╾╯  └╴────▱───────────────────╶┘</pre>
+</body>
+</html>

package/docs/operations/assets/menu-frame-large.html

@@ -0,0 +1,84 @@
+<!doctype html>
+<html lang="pt-BR">
+<head>
+  <meta charset="utf-8" />
+  <title>Menu Frame 120x32</title>
+  <style>
+    :root {
+      color-scheme: dark;
+      --bg: #060606;
+      --panel: #0d0d0d;
+      --grid: rgba(255,255,255,0.06);
+      --line: rgba(255,255,255,0.25);
+      --text: #f3f3f3;
+      --muted: #8f949c;
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      min-height: 100vh;
+      background:
+        linear-gradient(var(--grid) 1px, transparent 1px),
+        linear-gradient(90deg, var(--grid) 1px, transparent 1px),
+        radial-gradient(circle at top, rgba(255,255,255,0.06), transparent 35%),
+        var(--bg);
+      background-size: 48px 48px, 48px 48px, auto, auto;
+      color: var(--text);
+      font-family: "Courier New", monospace;
+      padding: 32px;
+    }
+    .frame {
+      max-width: max-content;
+      background: linear-gradient(180deg, rgba(255,255,255,0.03), rgba(255,255,255,0.01));
+      border: 1px solid var(--line);
+      box-shadow: 0 0 0 1px rgba(255,255,255,0.04), 0 24px 64px rgba(0,0,0,0.45);
+      padding: 20px 24px;
+      white-space: pre;
+      line-height: 1.1;
+      font-size: 13px;
+      border-radius: 8px;
+    }
+    .title {
+      margin: 0 0 16px;
+      color: var(--muted);
+      letter-spacing: 0.12em;
+      text-transform: uppercase;
+      font-size: 12px;
+    }
+  </style>
+</head>
+<body>
+  <p class="title">Menu Frame 120x32</p>
+  <pre class="frame">┏╾────────── OVERVIEW▰▱▱──▰───────────────────────────────────────────────────────────────────────────────────────────╼┓
+▌ ▱SKILL MASTER MENU                                                                                                   ▐
+▌  version 0.0.11 | channel 00.05 | readiness ready                                                                    ▐
+▌  GLOBAL SKILLS 13/13                                                                                                 ▐
+▌  bundle 54 | drafts 3 | study 8                                                                                      ▐
+▌  signal ██▇▅▄▃▃▃▄▅▄▄   health ██▇▆▄▃▃▃▄▄▄▄                                                                           ▐
+▌ ▱moral-core 10 | frontend-ui 19 | backend-data 10 | ops-clients 12 | knowledge 2                                     ▐
+┗╾────────────────────▰▰▰─▱─▱─▱─▱─────────────────────────────────────────────────────────────────────────────────────╼┛
+
+┌╴────────── ACTIONS▱╍╍──▱────────────────────────────────────────────────────╶┐  ┏╾───── DNA-CORE▰───────────────────╼┓
+│ ╍ACTION GRID                                                                 │  ▌ ▱DNA CYBER HELIX / diagnostico     ▐
+│  up/down move  enter run  q exit                                             │  ▌   ⠁    ⠸⣿⣿⣄ ⠄ ⠅ ⠄ ⠄ ⠅ ⠄ ⠄ ⡽⡻⡻   ⠁  ▐
+│  . Status local                                                              │  ▌         ⠈⠛⠿⢿⣷⣶⣤⣄⣀⣀ ⢀⢀⣀⣤⣴⠶⠟⠛⠉       ▐
+│  &gt; Doctor do menu e clientes MCP                                             │  ▌   ⠁     ⠁    ⢉⣙⣿⣿⠿⣿⣿⣿⣭⣅⣀⡀ ⠁     ⠁  ▐
+│  . Rodar gate completo [off]                                                 │  ▌         ⢀⣤⣶⣿⠟⠋⠉⠁⠈ ⠈ ⠉⠙⠛⠻⢿⣷⣦⣄       ▐
+│  . Rodar build [off]                                                         │  ▌   ⠁    ⠰⣿⣿⡛⠒⠒⠒⠓⠒⠒⠒⠒⠒⠓⠒⠒⠒⠒⠚⡻⣿⡷   ⠁  ▐
+│  . Validar pacote no npm publico                                             │  ▌         ⠈⠻⠿⣿⣶⣦⣤⣠⡀⠠ ⠠ ⣠⣠⣤⡶⠾⠚⠊       ▐
+│  . Atualizar pacote global via npm                                           │  ▌   ⠁     ⠁   ⠈⠉⣛⣻⣿⣿⣶⣾⣿⣯⣉⡀  ⠁     ⠁  ▐
+│  . Configurar registry privado GitHub Packages                               │  ▌          ⣀⣤⣶⠾⠛⠋⠉   ⠉⠉⠛⠻⠿⣿⣶⣤⣀       ▐
+│  . Modo de ativacao atual                                                    │  ▌   ⠁    ⢰⣿⣿⠉ ⠈ ⠉ ⠈ ⠈ ⠉ ⠈ ⠈⠉⢻⢿⢷   ⠁  ▐
+│ ╍                                                                            │  ▌         ⠙⠿⣿⣶⣦⣔ ⠐ ⠐ ⠐ ⠐⢀⣰⣤⡶⠷⠓⠁      ▐
+└╴─────────────▱▱▱─╍─╍─╍─╍────────────────────────────────────────────────────╶┘  ▌ ▱frames 8/36  global 13/13         ▐
+╭╼══════════ DETAILS▰▱▱══▰════════════════════════════════════════════════════╾╮  ┗╾──────▰▰▰─────────────────────────╼┛
+▌ ▱DETAIL FOCUS                                                                ▐  ┌╴───── TELEMETRY▱──────────────────╶┐
+▌  Doctor do menu e clientes MCP                                               ▐  │ ╍SYSTEM WINDOWS                    │
+▌  area diagnostico | action 2/22                                              ▐  │  selected area  diagnostico        │
+▌  -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=                                            ▐  │  dominant skill  frontend-ui 19    │
+▌  Valida pacote, binarios, skills globais e registros em Codex, Claude, Gemin ▐  │  bundle   54  ████████████████     │
+▌  resultado: Mostra um relatorio GO/NO-GO com proximos comandos recomendados. ▐  │  global   13/13 ████████████████   │
+▌ ▱exec: /usr/bin/node /tmp/skill-master/bin/skill-master-doctor.mjs           ▐  │ ╍skills   ▅▇██▇▅▄▄▄▄▅▅             │
+╰╼═════════════▰▰▰═▱═▱═▱═▱════════════════════════════════════════════════════╾╯  └╴──────▱▱▱─────────────────────────╶┘</pre>
+</body>
+</html>

package/docs/operations/assets/menu-frame-running.html

@@ -0,0 +1,80 @@
+<!doctype html>
+<html lang="pt-BR">
+<head>
+  <meta charset="utf-8" />
+  <title>Menu Running State</title>
+  <style>
+    :root {
+      color-scheme: dark;
+      --bg: #060606;
+      --panel: #0d0d0d;
+      --grid: rgba(255,255,255,0.06);
+      --line: rgba(255,255,255,0.25);
+      --text: #f3f3f3;
+      --muted: #8f949c;
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      min-height: 100vh;
+      background:
+        linear-gradient(var(--grid) 1px, transparent 1px),
+        linear-gradient(90deg, var(--grid) 1px, transparent 1px),
+        radial-gradient(circle at top, rgba(255,255,255,0.06), transparent 35%),
+        var(--bg);
+      background-size: 48px 48px, 48px 48px, auto, auto;
+      color: var(--text);
+      font-family: "Courier New", monospace;
+      padding: 32px;
+    }
+    .frame {
+      max-width: max-content;
+      background: linear-gradient(180deg, rgba(255,255,255,0.03), rgba(255,255,255,0.01));
+      border: 1px solid var(--line);
+      box-shadow: 0 0 0 1px rgba(255,255,255,0.04), 0 24px 64px rgba(0,0,0,0.45);
+      padding: 20px 24px;
+      white-space: pre;
+      line-height: 1.1;
+      font-size: 13px;
+      border-radius: 8px;
+    }
+    .title {
+      margin: 0 0 16px;
+      color: var(--muted);
+      letter-spacing: 0.12em;
+      text-transform: uppercase;
+      font-size: 12px;
+    }
+  </style>
+</head>
+<body>
+  <p class="title">Menu Running State</p>
+  <pre class="frame">╔╼══════════ RUNNING▰════▰════════════════════════════════════════════════════════════════════════════════════════════╾╗
+▌▌▱SKILL_MASTER WORKFLOW ONLINE                                                                                       ▐▐
+▌▌ area diagnostico | launching Doctor do menu e clientes MCP                                                         ▐▐
+▌▌▰pulse █▇▅▄▃▃▄▄▅▄▃▂▂▂▄▆▇█                                                                                           ▐▐
+▌▌ &lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/&gt;-&lt;=/===/▐▐
+▌▌ .    |  .   +   .       .    +  .       .     + .       .      +.       .       +       .       .+      .       . +▐▐
+▌▌▰           +                +                +                +                +                +                + ▐▐
+▌▌ -  - |-  -+ -  -  -  -  -  -  -  -  -  -  - +-  -  -  -  -  -+ -  -  -  -  -  -  -  -  -  -  - +-  -  -  -  -  -+ -▐▐
+▌▌          +                +                +                +                +                +                +   ▐▐
+▌▌▰.    |  +       .       .+      .       . +     .       .  +    .       .   +   .       .    +  .       .     + .  ▐▐
+▌▌        +                +                +                +                +                +                +     ▐▐
+▌▌      |+                +                +                +                +                +                +      ▐▐
+▌▌▰     +                +                +                +                +                +                +       ▐▐
+▌▌                                                                                                                    ▐▐
+▌▌ Valida pacote, binarios, skills globais e registros em Codex, Claude, Gemini e Antigravity.                        ▐▐
+▌▌▰resultado esperado: Mostra um relatorio GO/NO-GO com proximos comandos recomendados.                               ▐▐
+▌▌ exec: /usr/bin/node /tmp/skill-master/bin/skill-master-doctor.mjs                                                  ▐▐
+▌▌                                                                                                                    ▐▐
+▌▌▰handoff: HUD -&gt; stream real do comando                                                                             ▐▐
+▌▌                                                                                                                    ▐▐
+▌▌                                                                                                                    ▐▐
+▌▌▰                                                                                                                   ▐▐
+▌▌                                                                                                                    ▐▐
+▌▌                                                                                                                    ▐▐
+▌▌▰                                                                                                                   ▐▐
+▌▌▱                                                                                                                   ▐▐
+╚╼════════════════════▰▰▰═════════════════════════════════════════════════════════════════════════════════════════════╾╝</pre>
+</body>
+</html>

package/docs/operations/cross-platform-auth-transfer/ANALISE_COMPATIBILIDADE_MCP_2026-06-28.md

@@ -0,0 +1,140 @@
+# Analise - Compatibilidade MCP Windows Linux macOS
+
+Data: 2026-06-28
+Projeto: `@fprad0/skill-master-mcp`
+Status: correcoes aplicadas localmente, publicacao proibida neste computador
+
+## Problema
+
+O `skill_master` podia ser instalado corretamente por npm, mas alguns clientes MCP nao conseguiam iniciar o servidor. O ponto mais provavel era a configuracao dos clientes usando:
+
+```text
+command = "skill-master-mcp"
+```
+
+Esse formato depende do `PATH` do processo que abriu o cliente. Em apps desktop no Windows e macOS, e tambem em ambientes Linux com launchers grafico/systemd, o `PATH` pode nao conter a pasta global do npm. Resultado: o pacote esta instalado, mas o cliente diz que nao consegue autorizar/iniciar/encontrar o MCP.
+
+## Limite importante
+
+Nenhum pacote npm deve burlar autorizacoes do sistema operacional ou do cliente MCP. A correcao segura e suportada e:
+
+- registrar o servidor com executavel Node absoluto;
+- passar o entrypoint `bin/skill-master.mjs` absoluto em `args`;
+- manter bootstrap explicito para alterar configs de usuario;
+- diagnosticar configuracoes antigas como `path-bin` ou `launcher`.
+
+## Correcao aplicada
+
+Foi criado um modulo compartilhado:
+
+```text
+bin/lib/client-config.mjs
+```
+
+Ele centraliza:
+
+- paths padrao de Codex, Claude Desktop, Gemini e Antigravity;
+- geracao de config MCP robusta;
+- bloco TOML do Codex;
+- snippets JSON;
+- merge de configs JSON;
+- avaliacao de configs robustas vs antigas.
+
+Novo padrao de servidor:
+
+```json
+{
+  "command": "/caminho/absoluto/para/node",
+  "args": ["/caminho/absoluto/para/bin/skill-master.mjs"],
+  "env": {
+    "SKILL_MASTER_UPDATE_CHANNEL": "stable"
+  }
+}
+```
+
+No Codex:
+
+```toml
+[mcp_servers.skill_master]
+command = "/caminho/absoluto/para/node"
+args = ["/caminho/absoluto/para/bin/skill-master.mjs"]
+startup_timeout_sec = 120
+
+[mcp_servers.skill_master.env]
+SKILL_MASTER_UPDATE_CHANNEL = "stable"
+```
+
+## Arquivos alterados
+
+```text
+bin/lib/client-config.mjs
+bin/lib/menu-core.mjs
+bin/skill-master-bootstrap-global.mjs
+bin/skill-master-doctor.mjs
+bin/skill-master-register-clients.mjs
+scripts/verify-menu-actions.mjs
+src/client-config.test.ts
+src/menu-core.test.ts
+package.json
+README.md
+CHANGELOG.md
+docs/operations/GUIA_MULTI_COMPUTADOR.md
+```
+
+Tambem existem arquivos de planejamento visual anteriores em:
+
+```text
+docs/operations/reborn-menu-cyberpunk-transfer/
+docs/prompt-tasks/PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md
+docs/prompt-tasks/PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md
+docs/prompt-tasks/PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md
+docs/prompt-tasks/PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md
+```
+
+## Validacao executada localmente
+
+```powershell
+npm install
+npm run check
+node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
+node bin/skill-master-menu.mjs --status
+node bin/skill-master-doctor.mjs
+```
+
+Resultado:
+
+- build passou;
+- 12 arquivos de teste passaram;
+- 55 testes passaram;
+- matriz de 22 acoes do menu passou;
+- manifestos passaram;
+- snippets gerados usam Node absoluto + `bin/skill-master.mjs` absoluto.
+
+## O que validar no computador autorizado
+
+```powershell
+git status --short
+npm install
+npm run check
+npm pack --dry-run
+node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
+node bin/skill-master-doctor.mjs
+```
+
+Depois de publicar e instalar globalmente:
+
+```powershell
+npm install -g @fprad0/skill-master-mcp@latest
+skill-master-register-clients --apply-all --force
+skill-master-menu --run doctor
+```
+
+Reiniciar Codex depois do registro.
+
+## Riscos restantes
+
+- O usuario ainda precisa permitir que o cliente MCP leia sua configuracao local.
+- macOS Gatekeeper nao deve bloquear scripts npm comuns, mas ambientes corporativos podem ter politicas proprias.
+- Windows pode exigir que Node esteja instalado e acessivel no caminho absoluto gravado.
+- Se o usuario mover/remover a instalacao global depois do registro, e preciso rodar `skill-master-register-clients --apply-all --force` novamente.
+