@fprad0/skill-master-mcp 0.0.10 → 0.0.12

package/docs/operations/GUIA_NPM_PUBLICO.md

@@ -0,0 +1,147 @@
+# Guia de Publicacao no npm Publico
+
+## Objetivo
+
+Distribuir o `skill_master` pelo `npmjs.org`, permitindo instalacao direta com:
+
+```bash
+npm install -g @fprad0/skill-master-mcp
+```
+
+ou execucao imediata com:
+
+```bash
+npx -y @fprad0/skill-master-mcp@latest
+```
+
+## Estado atual
+
+Em `2026-06-26`, o pacote:
+
+- ja esta funcional no GitHub Packages privado
+- ja esta publicado no `registry.npmjs.org`
+- ja responde em `npm view @fprad0/skill-master-mcp --registry=https://registry.npmjs.org`
+- ja pode ser instalado com `npm install -g @fprad0/skill-master-mcp`
+- ja pode ser executado com `npx -y @fprad0/skill-master-mcp@latest`
+
+Versao publica validada:
+
+- `0.0.2`
+
+Workflow de referencia:
+
+- `Publish Skill Master to npmjs`
+- run `28244958247`
+- status `success`
+
+## O que isso habilita na pratica
+
+Para uma maquina nova, o caminho mais simples agora e:
+
+```bash
+npm install -g @fprad0/skill-master-mcp
+```
+
+Se a ideia for testar sem install global:
+
+```bash
+npx -y @fprad0/skill-master-mcp@latest
+```
+
+## Validacoes locais recomendadas
+
+### Confirmar login no npmjs
+
+```bash
+npm whoami
+```
+
+### Verificar a versao publicada
+
+```bash
+npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
+```
+
+### Verificar dist-tags
+
+```bash
+npm view @fprad0/skill-master-mcp dist-tags --json --registry=https://registry.npmjs.org
+```
+
+### Smoke test via npx
+
+```bash
+npx -y @fprad0/skill-master-mcp@latest
+```
+
+## Publicacao local manual
+
+Com login valido no npmjs:
+
+```bash
+npm run publish:npm-public
+```
+
+Esse script publica com:
+
+```bash
+npm publish --access public --registry=https://registry.npmjs.org
+```
+
+## Publicacao por GitHub Actions
+
+O repositorio possui o workflow:
+
+```text
+Publish Skill Master to npmjs
+```
+
+Pre-requisitos:
+
+- secret `NPM_TOKEN` configurado no GitHub
+- token com permissao de publicacao na conta/escopo correto
+- versao do `package.json` ainda nao publicada no npm publico
+
+Fluxo:
+
+1. abrir `Actions` no GitHub
+2. escolher `Publish Skill Master to npmjs`
+3. informar o `ref` a publicar, por exemplo `main` ou uma tag
+4. executar o workflow
+
+O workflow faz:
+
+- `npm ci`
+- `npm run build`
+- `npm test`
+- `npm run check:manifest`
+- `npm run publish:npm-public`
+
+## Riscos e limites
+
+- publicacao no npm publico e visivel publicamente
+- nao e possivel republicar a mesma versao
+- antes de cada novo publish, confirme nome, escopo, metadados e estrategia de suporte
+- o fluxo privado no GitHub Packages continua valido para distribuicao fechada ou controlada
+
+## Checklist rapido depois da release
+
+```bash
+npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
+```
+
+```bash
+npm view @fprad0/skill-master-mcp dist-tags --json --registry=https://registry.npmjs.org
+```
+
+```bash
+npx -y @fprad0/skill-master-mcp@latest
+```
+
+Se quiser validar instalacao limpa:
+
+```bash
+mkdir skill-master-smoke && cd skill-master-smoke
+npm init -y
+npm install @fprad0/skill-master-mcp --registry=https://registry.npmjs.org
+```

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.
+