@fprad0/skill-master-mcp 0.0.12 → 1.0.0

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.

package/docs/operations/reborn-menu-cyberpunk-transfer/ANALISE_MENU_REBORN_CYBERPUNK_2026-06-28.md

@@ -1,174 +1,174 @@
-# Analise - Menu Reborn Cyberpunk Pixel Art
-
-Data: 2026-06-28
-Projeto: `@fprad0/skill-master-mcp`
-Versao local analisada: `0.0.10`
-Publicacao: proibida neste computador. Publicar somente no computador autorizado.
-
-## Objetivo
-
-Planejar e entregar a evolucao do `skill-master-menu` para um menu terminal com fluxo visual Reborn cyberpunk pixel art inspirado no GIF de referencia e molduras HUD inspiradas nas imagens anexadas, mantendo todas as acoes atuais funcionais.
-
-O pedido nao e apenas cosmetico. O menu deve continuar sendo uma ferramenta operacional confiavel para status, doctor, build/check, update, ativacao, bootstrap, clientes MCP, aprendizado de skills e resumo Notion.
-
-## Estado entregue nesta maquina
-
-Implementado localmente:
-
-- sistema de frames cyberpunk ASCII em `bin/lib/menu-core.mjs`;
-- frame principal com `overview`, `actions`, `details`, `core` e `telemetry`;
-- intro `REBORN / SKILL_MASTER` para o menu visual e para `--run` em TTY;
-- confirmacao visual `CONFIRMATION GATE` no menu interativo;
-- estado `SKILL_MASTER WORKFLOW ONLINE` antes do handoff para o comando real;
-- resultado em frame `SUBROUTINE COMPLETE` ou `SUBROUTINE FAILED`;
-- fallback textual para terminal sem TTY, CI, `TERM=dumb` ou `SKILL_MASTER_NO_VISUAL=1`;
-- correcao do executor de acoes para nao usar shell por padrao;
-- resolucao de `npm-cli.js` no Windows para evitar falha com `C:\Program Files\...`;
-- preservacao do binario MCP `skill-master-mcp` sem HUD em stdout.
-
-## Referencias visuais copiadas para transferencia
-
-As referencias originais foram copiadas para dentro do repo para facilitar transferencia ao outro computador:
-
-```text
-docs/operations/reborn-menu-cyberpunk-transfer/references/cyberpunk-pattern-sheet.jpg
-docs/operations/reborn-menu-cyberpunk-transfer/references/cyan-hud-frame-sheet.jpg
-docs/operations/reborn-menu-cyberpunk-transfer/references/fluid-workflow-windows.gif
-```
-
-Leitura visual:
-
-- `cyberpunk-pattern-sheet.jpg`: biblioteca de cantos, setas, barras, chips, marcadores, janelas e micro detalhes.
-- `cyan-hud-frame-sheet.jpg`: frames retangulares com cortes chanfrados, bordas duplas, linhas ciano e areas vazias limpas.
-- `fluid-workflow-windows.gif`: janelas independentes sobre grid escuro, movimento procedural, paineis tecnicos e hierarquia de laboratorio visual.
-
-## Estado atual encontrado
-
-Arquivos principais:
-
-```text
-bin/skill-master-menu.mjs
-bin/lib/menu-core.mjs
-src/menu-core.test.ts
-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
-```
-
-O menu atual ja tem:
-
-- `skill-master-menu` como CLI humano separado do binario MCP stdio.
-- `bin/lib/menu-core.mjs` com renderer e logica testavel.
-- teclado com `up/down`, `j/k`, `enter`, `q`, `esc` e `ctrl+c`.
-- alternate screen com cursor oculto e escrita estavel.
-- frame cyberpunk inicial com `overview`, `actions`, `details`, `dna-core` e `telemetry`.
-- script de evidencia para gerar HTML/PNG de frames.
-- testes em `src/menu-core.test.ts`.
-
-## Validacao local deste pacote
-
-Durante a validacao local, `npm run check` revelou uma fragilidade cross-platform em `src/menu-core.test.ts`: dois testes esperavam caminho POSIX exato (`/tmp/...`), mas no Windows o renderer exibe separadores `\`.
-
-Foi aplicado um ajuste pequeno nos testes para validar as partes importantes do comando (`exec: /usr/bin/node` e `skill-master-doctor.mjs`) sem prender a suite ao separador de pasta do sistema operacional.
-
-Depois do ajuste:
-
-```powershell
-npm run check
-```
-
-Resultado local: build, 57 testes, matriz de 22 acoes e manifestos passaram.
-
-Durante o smoke `node bin/skill-master-menu.mjs --run public-npm`, apareceu uma falha real no Windows quando o Node estava em `C:\Program Files\...`. O executor foi corrigido para usar `spawn` sem shell por padrao e chamar `npm-cli.js` pelo Node no Windows.
-
-## Acoes atuais do menu
-
-O menu possui 22 acoes:
-
-```text
-status
-doctor
-check
-build
-publicNpm
-updateGlobal
-privateRegistry
-activationStatus
-activationBalanced
-activationAlwaysOn
-installGlobalSkills
-bootstrapGlobal
-registerClients
-promptRecommendation
-successNotifications
-studySkills
-approvalPackage
-markLearnedStudy
-rejectLearnedSkill
-activateLearnedLocal
-activateLearnedGlobal
-notionSummary
-```
-
-Pontos de atencao:
-
-- Acoes de update, registry, bootstrap, registro de clientes e ativacao global exigem confirmacao.
-- `check` e `build` ficam indisponiveis fora de checkout de desenvolvimento.
-- `--status`, `--help` e `--run <acao>` precisam continuar funcionando sem TTY.
-- O binario MCP stdio continua sendo `skill-master-mcp` e nao deve receber UI nem logs em stdout.
-
-## Lacunas visuais analisadas
-
-O estado inicial era funcional, mas ficava mais proximo de terminal classico do que das referencias:
-
-- Molduras usam caixas lineares simples; faltam cantos chanfrados e assimetrias tecnicas.
-- A paleta visual nas capturas esta muito branca; precisa reforcar ciano, cinza e pontos de amber com criterio.
-- O frame do menu nao parece uma janela cyberpunk recortada como a segunda imagem.
-- A animacao do DNA existe, mas pode ficar mais fluida e procedural como o GIF.
-- Os paineis poderiam parecer janelas independentes em um workflow visual, nao apenas caixas empilhadas.
-- Faltam micro detalhes: trilhas, marcadores, barras segmentadas, tabs tecnicas e respiros visuais.
-
-## Direcao tecnica recomendada
-
-Manter a arquitetura atual e evoluir por dentro de `menu-core`:
-
-1. Criar um pequeno sistema de frames ASCII/Unicode dentro de `bin/lib/menu-core.mjs`.
-2. Separar os estilos de frame em variantes: `hud`, `focus`, `cyan-cut`, `data-slab`, `running`.
-3. Preservar fallback sem cor e sem TTY.
-4. Continuar sem dependencia pesada de TUI.
-5. Expandir testes de layout para larguras diferentes.
-6. Expandir `scripts/render-menu-evidence.mjs` para gerar evidencias com mais ticks e estados.
-7. Criar uma verificacao funcional de todas as acoes sem executar publicacao.
-
-## Direcao visual recomendada
-
-Aplicar um visual terminal cyberpunk pixel art com:
-
-- fundo conceitual de grid atraves da evidencia HTML, sem depender disso no terminal real.
-- bordas ciano e brancas com cortes de canto.
-- detalhes pequenos de segmentos, pinos, trilhas e barras.
-- layout de janelas independentes inspirado no GIF.
-- DNA/helix mais fluido com scanline, fase e pulso de selecao.
-- foco visual claro no item selecionado.
-- texto sempre legivel antes de ornamentacao.
-
-## Riscos
-
-- Unicode/encoding no Windows pode quebrar se os caracteres forem usados sem cuidado.
-- Ornamento demais pode reduzir legibilidade em terminais pequenos.
-- Animacao demais pode causar flicker.
-- Testar acoes destrutivas exige confirmacao simulada ou validacao em dry-run.
-- Publicacao npm nao pode acontecer neste computador.
-
-## Resultado esperado
-
-Ao final da execucao no computador autorizado:
-
-- `skill-master-menu` abre com frame cyberpunk pixel art mais fiel as referencias.
-- O menu continua fluido, legivel e navegavel.
-- Todas as 22 acoes sao validadas por teste, smoke test ou matriz manual.
-- Evidencias visuais novas ficam em `docs/operations/assets`.
-- `npm run check` passa.
-- O pacote so e publicado no computador com autorizacoes npmjs.
+# Analise - Menu Reborn Cyberpunk Pixel Art
+
+Data: 2026-06-28
+Projeto: `@fprad0/skill-master-mcp`
+Versao local analisada: `0.0.10`
+Publicacao: proibida neste computador. Publicar somente no computador autorizado.
+
+## Objetivo
+
+Planejar e entregar a evolucao do `skill-master-menu` para um menu terminal com fluxo visual Reborn cyberpunk pixel art inspirado no GIF de referencia e molduras HUD inspiradas nas imagens anexadas, mantendo todas as acoes atuais funcionais.
+
+O pedido nao e apenas cosmetico. O menu deve continuar sendo uma ferramenta operacional confiavel para status, doctor, build/check, update, ativacao, bootstrap, clientes MCP, aprendizado de skills e resumo Notion.
+
+## Estado entregue nesta maquina
+
+Implementado localmente:
+
+- sistema de frames cyberpunk ASCII em `bin/lib/menu-core.mjs`;
+- frame principal com `overview`, `actions`, `details`, `core` e `telemetry`;
+- intro `REBORN / SKILL_MASTER` para o menu visual e para `--run` em TTY;
+- confirmacao visual `CONFIRMATION GATE` no menu interativo;
+- estado `SKILL_MASTER WORKFLOW ONLINE` antes do handoff para o comando real;
+- resultado em frame `SUBROUTINE COMPLETE` ou `SUBROUTINE FAILED`;
+- fallback textual para terminal sem TTY, CI, `TERM=dumb` ou `SKILL_MASTER_NO_VISUAL=1`;
+- correcao do executor de acoes para nao usar shell por padrao;
+- resolucao de `npm-cli.js` no Windows para evitar falha com `C:\Program Files\...`;
+- preservacao do binario MCP `skill-master-mcp` sem HUD em stdout.
+
+## Referencias visuais copiadas para transferencia
+
+As referencias originais foram copiadas para dentro do repo para facilitar transferencia ao outro computador:
+
+```text
+docs/operations/reborn-menu-cyberpunk-transfer/references/cyberpunk-pattern-sheet.jpg
+docs/operations/reborn-menu-cyberpunk-transfer/references/cyan-hud-frame-sheet.jpg
+docs/operations/reborn-menu-cyberpunk-transfer/references/fluid-workflow-windows.gif
+```
+
+Leitura visual:
+
+- `cyberpunk-pattern-sheet.jpg`: biblioteca de cantos, setas, barras, chips, marcadores, janelas e micro detalhes.
+- `cyan-hud-frame-sheet.jpg`: frames retangulares com cortes chanfrados, bordas duplas, linhas ciano e areas vazias limpas.
+- `fluid-workflow-windows.gif`: janelas independentes sobre grid escuro, movimento procedural, paineis tecnicos e hierarquia de laboratorio visual.
+
+## Estado atual encontrado
+
+Arquivos principais:
+
+```text
+bin/skill-master-menu.mjs
+bin/lib/menu-core.mjs
+src/menu-core.test.ts
+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
+```
+
+O menu atual ja tem:
+
+- `skill-master-menu` como CLI humano separado do binario MCP stdio.
+- `bin/lib/menu-core.mjs` com renderer e logica testavel.
+- teclado com `up/down`, `j/k`, `enter`, `q`, `esc` e `ctrl+c`.
+- alternate screen com cursor oculto e escrita estavel.
+- frame cyberpunk inicial com `overview`, `actions`, `details`, `dna-core` e `telemetry`.
+- script de evidencia para gerar HTML/PNG de frames.
+- testes em `src/menu-core.test.ts`.
+
+## Validacao local deste pacote
+
+Durante a validacao local, `npm run check` revelou uma fragilidade cross-platform em `src/menu-core.test.ts`: dois testes esperavam caminho POSIX exato (`/tmp/...`), mas no Windows o renderer exibe separadores `\`.
+
+Foi aplicado um ajuste pequeno nos testes para validar as partes importantes do comando (`exec: /usr/bin/node` e `skill-master-doctor.mjs`) sem prender a suite ao separador de pasta do sistema operacional.
+
+Depois do ajuste:
+
+```powershell
+npm run check
+```
+
+Resultado local: build, 57 testes, matriz de 22 acoes e manifestos passaram.
+
+Durante o smoke `node bin/skill-master-menu.mjs --run public-npm`, apareceu uma falha real no Windows quando o Node estava em `C:\Program Files\...`. O executor foi corrigido para usar `spawn` sem shell por padrao e chamar `npm-cli.js` pelo Node no Windows.
+
+## Acoes atuais do menu
+
+O menu possui 22 acoes:
+
+```text
+status
+doctor
+check
+build
+publicNpm
+updateGlobal
+privateRegistry
+activationStatus
+activationBalanced
+activationAlwaysOn
+installGlobalSkills
+bootstrapGlobal
+registerClients
+promptRecommendation
+successNotifications
+studySkills
+approvalPackage
+markLearnedStudy
+rejectLearnedSkill
+activateLearnedLocal
+activateLearnedGlobal
+notionSummary
+```
+
+Pontos de atencao:
+
+- Acoes de update, registry, bootstrap, registro de clientes e ativacao global exigem confirmacao.
+- `check` e `build` ficam indisponiveis fora de checkout de desenvolvimento.
+- `--status`, `--help` e `--run <acao>` precisam continuar funcionando sem TTY.
+- O binario MCP stdio continua sendo `skill-master-mcp` e nao deve receber UI nem logs em stdout.
+
+## Lacunas visuais analisadas
+
+O estado inicial era funcional, mas ficava mais proximo de terminal classico do que das referencias:
+
+- Molduras usam caixas lineares simples; faltam cantos chanfrados e assimetrias tecnicas.
+- A paleta visual nas capturas esta muito branca; precisa reforcar ciano, cinza e pontos de amber com criterio.
+- O frame do menu nao parece uma janela cyberpunk recortada como a segunda imagem.
+- A animacao do DNA existe, mas pode ficar mais fluida e procedural como o GIF.
+- Os paineis poderiam parecer janelas independentes em um workflow visual, nao apenas caixas empilhadas.
+- Faltam micro detalhes: trilhas, marcadores, barras segmentadas, tabs tecnicas e respiros visuais.
+
+## Direcao tecnica recomendada
+
+Manter a arquitetura atual e evoluir por dentro de `menu-core`:
+
+1. Criar um pequeno sistema de frames ASCII/Unicode dentro de `bin/lib/menu-core.mjs`.
+2. Separar os estilos de frame em variantes: `hud`, `focus`, `cyan-cut`, `data-slab`, `running`.
+3. Preservar fallback sem cor e sem TTY.
+4. Continuar sem dependencia pesada de TUI.
+5. Expandir testes de layout para larguras diferentes.
+6. Expandir `scripts/render-menu-evidence.mjs` para gerar evidencias com mais ticks e estados.
+7. Criar uma verificacao funcional de todas as acoes sem executar publicacao.
+
+## Direcao visual recomendada
+
+Aplicar um visual terminal cyberpunk pixel art com:
+
+- fundo conceitual de grid atraves da evidencia HTML, sem depender disso no terminal real.
+- bordas ciano e brancas com cortes de canto.
+- detalhes pequenos de segmentos, pinos, trilhas e barras.
+- layout de janelas independentes inspirado no GIF.
+- DNA/helix mais fluido com scanline, fase e pulso de selecao.
+- foco visual claro no item selecionado.
+- texto sempre legivel antes de ornamentacao.
+
+## Riscos
+
+- Unicode/encoding no Windows pode quebrar se os caracteres forem usados sem cuidado.
+- Ornamento demais pode reduzir legibilidade em terminais pequenos.
+- Animacao demais pode causar flicker.
+- Testar acoes destrutivas exige confirmacao simulada ou validacao em dry-run.
+- Publicacao npm nao pode acontecer neste computador.
+
+## Resultado esperado
+
+Ao final da execucao no computador autorizado:
+
+- `skill-master-menu` abre com frame cyberpunk pixel art mais fiel as referencias.
+- O menu continua fluido, legivel e navegavel.
+- Todas as 22 acoes sao validadas por teste, smoke test ou matriz manual.
+- Evidencias visuais novas ficam em `docs/operations/assets`.
+- `npm run check` passa.
+- O pacote so e publicado no computador com autorizacoes npmjs.