@fprad0/skill-master-mcp 0.0.12 → 1.0.1

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

@@ -1,140 +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.
-
+# 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.
+

package/docs/operations/cross-platform-auth-transfer/README_TRANSFERENCIA.md

@@ -1,85 +1,85 @@
-# Transferencia - Compatibilidade MCP Multi-OS
-
-Este pacote leva a correcao de compatibilidade do `skill-master-mcp` para Windows, Linux e macOS.
-
-## Zip gerado nesta maquina
-
-```text
-C:\Users\CDT\Documents\F.Prado\skill-master-cross-platform-auth-transfer-2026-06-28.zip
-```
-
-## Copiar para o outro computador
-
-Copie preservando os caminhos relativos:
-
-```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
-docs/operations/cross-platform-auth-transfer/
-docs/prompt-tasks/PROMPT_TASK_016_CROSS_PLATFORM_MCP_AUTH_REGISTRATION.md
-```
-
-Se tambem for levar o pacote visual Reborn, copie:
-
-```text
-bin/skill-master-menu.mjs
-scripts/render-menu-evidence.mjs
-docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md
-docs/operations/assets/menu-frame-large.html
-docs/operations/assets/menu-frame-compact.html
-docs/operations/assets/menu-frame-running.html
-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
-```
-
-## Sequencia no outro computador
-
-```powershell
-git status --short
-npm install
-npm run check
-npm pack --dry-run
-```
-
-Para testar registro sem aplicar:
-
-```powershell
-node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
-```
-
-Para aplicar no Codex e clientes:
-
-```powershell
-node bin/skill-master-register-clients.mjs --apply-all --force
-node bin/skill-master-doctor.mjs
-```
-
-Depois de publicar no npmjs:
-
-```powershell
-npm install -g @fprad0/skill-master-mcp@latest
-skill-master-register-clients --apply-all --force
-skill-master-menu --run doctor
-```
-
-Reinicie Codex, Claude, Gemini e Antigravity depois do registro.
-
-## Nao fazer
-
-- Nao publicar sem autorizacao explicita.
-- Nao copiar `.env`, `.npmrc` com token ou PAT.
-- Nao usar `git reset --hard`.
-- Nao prometer que npm consegue burlar autorizacao do sistema operacional.
+# Transferencia - Compatibilidade MCP Multi-OS
+
+Este pacote leva a correcao de compatibilidade do `skill-master-mcp` para Windows, Linux e macOS.
+
+## Zip gerado nesta maquina
+
+```text
+C:\Users\CDT\Documents\F.Prado\skill-master-cross-platform-auth-transfer-2026-06-28.zip
+```
+
+## Copiar para o outro computador
+
+Copie preservando os caminhos relativos:
+
+```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
+docs/operations/cross-platform-auth-transfer/
+docs/prompt-tasks/PROMPT_TASK_016_CROSS_PLATFORM_MCP_AUTH_REGISTRATION.md
+```
+
+Se tambem for levar o pacote visual Reborn, copie:
+
+```text
+bin/skill-master-menu.mjs
+scripts/render-menu-evidence.mjs
+docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md
+docs/operations/assets/menu-frame-large.html
+docs/operations/assets/menu-frame-compact.html
+docs/operations/assets/menu-frame-running.html
+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
+```
+
+## Sequencia no outro computador
+
+```powershell
+git status --short
+npm install
+npm run check
+npm pack --dry-run
+```
+
+Para testar registro sem aplicar:
+
+```powershell
+node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
+```
+
+Para aplicar no Codex e clientes:
+
+```powershell
+node bin/skill-master-register-clients.mjs --apply-all --force
+node bin/skill-master-doctor.mjs
+```
+
+Depois de publicar no npmjs:
+
+```powershell
+npm install -g @fprad0/skill-master-mcp@latest
+skill-master-register-clients --apply-all --force
+skill-master-menu --run doctor
+```
+
+Reinicie Codex, Claude, Gemini e Antigravity depois do registro.
+
+## Nao fazer
+
+- Nao publicar sem autorizacao explicita.
+- Nao copiar `.env`, `.npmrc` com token ou PAT.
+- Nao usar `git reset --hard`.
+- Nao prometer que npm consegue burlar autorizacao do sistema operacional.