@fprad0/skill-master-mcp 0.0.10 → 0.0.12

package/docs/prompt-tasks/PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md

@@ -0,0 +1,123 @@
+# Prompt Task 012 - Menu cyberpunk pixel frame
+
+Status: pronto para execucao
+Publicacao: proibida sem autorizacao explicita
+Branch sugerida: `feature/reborn-cyberpunk-menu`
+Commit sugerido: `feat(menu): add cyberpunk pixel frame system`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: evoluir o frame visual do `skill-master-menu` para ficar mais proximo das referencias cyberpunk pixel art copiadas em `docs/operations/reborn-menu-cyberpunk-transfer/references/`, sem quebrar nenhuma funcao do menu.
+
+Antes de editar:
+
+```powershell
+git status --short
+npm run check
+```
+
+## Contexto
+
+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
+```
+
+Referencias visuais:
+
+```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
+```
+
+O menu atual ja tem `formatCyberMenuFrame`, `formatRunningActionFrame`, `renderBox`, `joinHorizontalBoxes`, paineis `overview`, `actions`, `details`, `dna-core` e `telemetry`.
+
+## Escopo
+
+Implementar uma camada pequena de frame visual dentro de `bin/lib/menu-core.mjs`:
+
+- cantos chanfrados inspirados no frame ciano;
+- bordas duplas ou segmentadas em paineis importantes;
+- marcadores laterais e micro trilhas nos paineis;
+- variantes de frame para `overview`, `actions`, `details`, `dna-core`, `telemetry` e `running`;
+- foco visual mais forte no painel `details`;
+- selected action com indicador mais claro e legivel;
+- fallback sem cor preservado.
+
+Nao adicionar dependencia TUI pesada. Preferir funcoes pequenas e testaveis.
+
+## Requisitos de UX
+
+- O menu precisa parecer uma composicao de janelas cyberpunk, nao apenas caixas retangulares.
+- A ornamentacao nao pode competir com legibilidade.
+- Terminais compactos precisam continuar usaveis em `96x24`.
+- O item selecionado precisa estar sempre visivel.
+- Texto longo deve truncar com `~` ou quebrar de forma previsivel.
+- Sem flicker extra.
+
+## Requisitos tecnicos
+
+- Preservar `--status`, `--help` e `--run <acao>`.
+- Preservar comportamento non-TTY.
+- Preservar Node `18+`.
+- Nao colocar logs no binario MCP stdio.
+- Nao publicar, taggear ou fazer release.
+- Nao reverter alteracoes de outro usuario.
+
+## Arquivos provaveis
+
+Editar:
+
+```text
+bin/lib/menu-core.mjs
+src/menu-core.test.ts
+scripts/render-menu-evidence.mjs
+docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md
+```
+
+Possivelmente editar:
+
+```text
+CHANGELOG.md
+```
+
+Nao editar:
+
+```text
+dist/
+package-lock.json
+package.json
+manifests/channels/stable.json
+```
+
+## Aceite
+
+- `formatCyberMenuFrame` gera frame grande com cantos e barras mais cyberpunk.
+- `formatCyberMenuFrame` gera frame compacto sem perder selected action.
+- `formatRunningActionFrame` usa o mesmo DNA visual.
+- Testes cobrem strings-chave dos novos paineis.
+- Evidencias HTML/PNG podem ser regeneradas.
+- `npm run check` passa.
+
+## Validacao
+
+```powershell
+npm run check
+node scripts/render-menu-evidence.mjs
+node bin/skill-master-menu.mjs --status
+node bin/skill-master-menu.mjs --help
+node bin/skill-master-menu.mjs --run status
+```
+
+## Resultado esperado
+
+Entregar uma melhoria visual segura, com o frame mais proximo das imagens de referencia e sem alterar a matriz de acoes do menu.
+

package/docs/prompt-tasks/PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md

@@ -0,0 +1,114 @@
+# Prompt Task 013 - Menu fluid DNA animation
+
+Status: pronto para execucao
+Publicacao: proibida sem autorizacao explicita
+Branch sugerida: `feature/reborn-cyberpunk-menu`
+Commit sugerido: `feat(menu): add fluid dna terminal animation`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: evoluir o DNA visual e a sensacao de movimento do `skill-master-menu` para aproximar do GIF `fluid-workflow-windows.gif`, preservando baixo flicker, legibilidade e funcionamento total do menu.
+
+Antes de editar:
+
+```powershell
+git status --short
+npm run check
+```
+
+## Contexto
+
+A primeira passada do menu ja possui:
+
+- alternate screen;
+- tick de renderizacao;
+- `formatCyberMenuFrame`;
+- `dnaPanelLines`;
+- `telemetryPanelLines`;
+- `formatRunningActionFrame`;
+- evidencia visual via `scripts/render-menu-evidence.mjs`.
+
+O GIF de referencia sugere:
+
+- janelas tecnicas sobre grid;
+- movimento procedural em paineis;
+- formas geometricas que mudam sem poluir;
+- hierarquia de laboratorio visual;
+- animacao fluida, mas nao caotica.
+
+## Escopo
+
+Melhorar a sensacao de movimento em `bin/lib/menu-core.mjs`:
+
+- tornar `dnaPanelLines` mais fluido e menos blocado;
+- adicionar scanline ou pulso discreto conectado ao `tick`;
+- variar pequenos detalhes de borda conforme tick sem mudar layout;
+- fazer `telemetryPanelLines` parecer instrumento ativo;
+- melhorar `formatRunningActionFrame` para parecer transicao de workflow, nao apenas mensagem de execucao;
+- preservar as dimensoes finais de cada linha.
+
+Se fizer sentido, criar helpers pequenos:
+
+```text
+buildPulsePhase
+renderScanline
+renderSignalRail
+renderCornerTicks
+renderFluidWireframe
+```
+
+Os nomes podem variar, mas a intencao e separar visual procedural de layout.
+
+## Requisitos de qualidade
+
+- Nenhuma linha pode ultrapassar a largura calculada.
+- A animacao nao pode causar resize de painel.
+- O selected action nao pode sair da viewport.
+- O loop de renderizacao continua usando timeout atual ou ajuste conservador.
+- O menu deve continuar usavel em Windows Terminal, PowerShell e terminais comuns.
+
+## Arquivos provaveis
+
+Editar:
+
+```text
+bin/lib/menu-core.mjs
+src/menu-core.test.ts
+scripts/render-menu-evidence.mjs
+docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md
+```
+
+Possivelmente editar:
+
+```text
+docs/operations/assets/menu-frame-large.html
+docs/operations/assets/menu-frame-compact.html
+docs/operations/assets/menu-frame-running.html
+```
+
+Nao publicar e nao alterar secrets.
+
+## Aceite
+
+- O painel `DNA-CORE` fica visualmente mais fluido.
+- `TELEMETRY` mostra pulso/sinais que parecem vivos.
+- Running state fica coerente com o mesmo DNA visual.
+- Evidencias incluem ao menos tres estados: large, compact, running.
+- Testes validam dimensoes e presenca de paineis-chave.
+- `npm run check` passa.
+
+## Validacao
+
+```powershell
+npm run check
+node scripts/render-menu-evidence.mjs
+node bin/skill-master-menu.mjs --run status
+node bin/skill-master-menu.mjs --run doctor
+```
+
+## Resultado esperado
+
+O menu deve parecer uma interface operacional viva, com DNA fluido e janelas tecnicas, sem perder simplicidade de manutencao.
+

package/docs/prompt-tasks/PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md

@@ -0,0 +1,157 @@
+# Prompt Task 014 - Menu functional parity QA
+
+Status: pronto para execucao
+Publicacao: proibida sem autorizacao explicita
+Branch sugerida: `feature/reborn-cyberpunk-menu`
+Commit sugerido: `test(menu): verify functional parity for operator actions`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: garantir que o novo menu cyberpunk continua funcionando 100% para cada funcao. A mudanca visual nao pode quebrar aliases, confirmacoes, disabled states, direct run, status, help, TTY e non-TTY.
+
+Antes de editar:
+
+```powershell
+git status --short
+npm run check
+```
+
+## Matriz de acoes obrigatoria
+
+Validar estas 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
+```
+
+## Escopo
+
+Adicionar ou reforcar testes em `src/menu-core.test.ts`:
+
+- todas as acoes existem;
+- aliases resolvem para a key correta;
+- acoes perigosas exigem confirmacao;
+- `check` e `build` ficam desabilitadas fora de checkout de desenvolvimento;
+- frame grande contem selected action e detalhes;
+- frame compacto mantem selected action visivel;
+- running state mostra comando e area;
+- nenhuma linha excede a largura esperada em frames sem ANSI;
+- `formatHelp` lista acoes importantes.
+
+Se fizer sentido, criar um script de smoke test:
+
+```text
+scripts/verify-menu-actions.mjs
+```
+
+Esse script deve ser seguro e nao deve executar acoes destrutivas ou publicacao. Ele pode:
+
+- carregar `buildMenuCommands`;
+- imprimir matriz de acoes;
+- testar `resolveActionKey`;
+- validar comandos read-only com allowlist;
+- marcar acoes confirmadas como "requires manual confirmation".
+
+## Acoes read-only para smoke test
+
+Podem ser executadas automaticamente:
+
+```powershell
+node bin/skill-master-menu.mjs --run status
+node bin/skill-master-menu.mjs --run doctor
+node bin/skill-master-menu.mjs --run public-npm
+node bin/skill-master-menu.mjs --run activation-status
+node bin/skill-master-menu.mjs --run notifications
+node bin/skill-master-menu.mjs --run study-skills
+node bin/skill-master-menu.mjs --run approval-package
+node bin/skill-master-menu.mjs --run notion-summary
+```
+
+Acoes com confirmacao devem ser validadas por metadados, nao executadas automaticamente:
+
+```text
+updateGlobal
+privateRegistry
+activationAlwaysOn
+installGlobalSkills
+bootstrapGlobal
+registerClients
+rejectLearnedSkill
+activateLearnedLocal
+activateLearnedGlobal
+```
+
+## Requisitos de seguranca
+
+- Nao executar `npm publish`.
+- Nao executar update global sem autorizacao.
+- Nao aplicar bootstrap ou registro de clientes automaticamente.
+- Nao ativar skill global automaticamente.
+- Nao criar `.npmrc` com token.
+
+## Arquivos provaveis
+
+Editar:
+
+```text
+src/menu-core.test.ts
+```
+
+Possivelmente criar:
+
+```text
+scripts/verify-menu-actions.mjs
+docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md
+```
+
+## Aceite
+
+- Existe evidencia de que as 22 acoes foram revisadas.
+- Testes cobrem aliases, confirmacoes, disabled states e frames.
+- Smoke test documentado ou automatizado cobre acoes read-only.
+- `npm run check` passa.
+- Nao houve publicacao nem mudanca de credenciais.
+
+## Validacao
+
+```powershell
+npm run check
+node bin/skill-master-menu.mjs --help
+node bin/skill-master-menu.mjs --status
+node bin/skill-master-menu.mjs --run status
+node bin/skill-master-menu.mjs --run doctor
+node bin/skill-master-menu.mjs --run public-npm
+node bin/skill-master-menu.mjs --run activation-status
+node bin/skill-master-menu.mjs --run notifications
+node bin/skill-master-menu.mjs --run study-skills
+node bin/skill-master-menu.mjs --run approval-package
+node bin/skill-master-menu.mjs --run notion-summary
+```
+
+## Resultado esperado
+
+O menu fica visualmente melhor sem perder confiabilidade operacional.
+

package/docs/prompt-tasks/PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md

@@ -0,0 +1,127 @@
+# Prompt Task 015 - Transfer release handoff
+
+Status: pronto para execucao
+Publicacao: somente no computador autorizado
+Branch sugerida: `feature/reborn-cyberpunk-menu`
+Commit sugerido: `docs(release): add reborn menu handoff and evidence`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo original `skill-master-mcp`, no computador que possui autorizacoes npmjs.
+
+Objetivo: preparar o handoff final, atualizar documentacao de release, validar pacote e publicar somente depois de autorizacao explicita do usuario.
+
+## Entradas
+
+Usar como contexto:
+
+```text
+docs/operations/reborn-menu-cyberpunk-transfer/ANALISE_MENU_REBORN_CYBERPUNK_2026-06-28.md
+docs/operations/reborn-menu-cyberpunk-transfer/ORDEM_DE_EXECUCAO_MENU_REBORN_CYBERPUNK.md
+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
+```
+
+## Antes de publicar
+
+Conferir:
+
+```powershell
+git status --short
+npm run check
+npm pack --dry-run
+npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
+```
+
+## Escopo
+
+Atualizar, se aplicavel:
+
+```text
+CHANGELOG.md
+VERSION.md
+README.md
+docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md
+manifests/channels/stable.json
+manifests/channels/beta.json
+package.json
+package-lock.json
+```
+
+Criar ou atualizar evidencias:
+
+```text
+docs/operations/assets/menu-frame-large.html
+docs/operations/assets/menu-frame-compact.html
+docs/operations/assets/menu-frame-running.html
+docs/operations/assets/menu-frame-large.png
+docs/operations/assets/menu-frame-compact.png
+docs/operations/assets/menu-frame-running.png
+```
+
+## Regras de versionamento
+
+Se a mudanca for apenas visual + testes + docs, sugerir bump patch:
+
+```text
+0.0.11
+```
+
+Atualizar manifesto com:
+
+- nova `semver`;
+- novo `publishedAt` no momento da publicacao;
+- commit real depois do commit local;
+- changelog curto mencionando menu Reborn cyberpunk, DNA fluido e QA funcional.
+
+Nao inventar hash de commit. Preencher depois do commit real.
+
+## Publicacao
+
+So executar se o usuario autorizar explicitamente.
+
+Comando:
+
+```powershell
+npm publish --access public --registry=https://registry.npmjs.org
+```
+
+Depois da publicacao:
+
+```powershell
+npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
+npx -y @fprad0/skill-master-mcp@latest
+```
+
+## Handoff para usuarios
+
+Preparar resumo final com:
+
+- versao publicada;
+- commit;
+- arquivos principais alterados;
+- validacoes executadas;
+- como atualizar globalmente;
+- aviso de reiniciar Codex/Claude/Gemini/Antigravity se necessario.
+
+Comando de atualizacao sugerido:
+
+```powershell
+npm install -g @fprad0/skill-master-mcp@latest
+skill-master-menu --run doctor
+```
+
+## Aceite
+
+- `npm run check` passou.
+- `npm pack --dry-run` passou.
+- Evidencias visuais foram atualizadas.
+- Changelog e manifesto estao coerentes.
+- Publicacao ocorreu apenas se houve autorizacao explicita.
+- Nenhum segredo foi commitado.
+
+## Resultado esperado
+
+O outro computador publica uma versao nova do Skill Master com menu Reborn cyberpunk fluido, validada e transferivel por npmjs.
+

package/docs/prompt-tasks/PROMPT_TASK_016_CROSS_PLATFORM_MCP_AUTH_REGISTRATION.md

@@ -0,0 +1,107 @@
+# Prompt Task 016 - Cross-platform MCP auth registration
+
+Status: implementado localmente, pronto para aplicar no computador autorizado
+Publicacao: somente com autorizacao explicita
+Branch sugerida: `fix/cross-platform-mcp-registration`
+Commit sugerido: `fix(mcp): register clients with absolute node entrypoint`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: aplicar a correcao que faz Windows, Linux e macOS iniciarem o MCP `skill_master` de forma robusta em Codex, Claude, Gemini e Antigravity, sem depender do `PATH` global do npm.
+
+## Contexto
+
+O problema ocorre quando clientes MCP tentam iniciar:
+
+```text
+skill-master-mcp
+```
+
+Apps desktop podem nao herdar o `PATH` do terminal. O novo padrao deve ser:
+
+```text
+command = caminho absoluto do Node.js
+args = caminho absoluto para bin/skill-master.mjs
+```
+
+## Arquivos a aplicar
+
+```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/
+```
+
+## Requisitos
+
+- `skill-master-register-clients` deve escrever Codex TOML e JSON de clientes com Node absoluto.
+- `skill-master-doctor` deve diferenciar `absolute-node`, `path-bin`, `launcher`, `custom`, `missing` e `invalid-json`.
+- `skill-master-menu --status` deve mostrar se o MCP esta robusto.
+- `skill-master-menu --run bootstrap-global --yes` deve continuar instalando skills e registrando clientes.
+- Todas as 22 acoes do menu devem continuar presentes e protegidas quando necessario.
+
+## Validacao
+
+```powershell
+npm install
+npm run check
+node bin/skill-master-menu.mjs --status
+node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
+node bin/skill-master-doctor.mjs
+npm pack --dry-run
+```
+
+Inspecionar:
+
+```text
+.tmp-client-snippets/codex.config.toml
+.tmp-client-snippets/claude_desktop_config.skill_master.json
+```
+
+Confirmar que ambos usam:
+
+```text
+command = caminho absoluto do Node
+args = caminho absoluto do bin/skill-master.mjs
+```
+
+## Aplicacao no Codex
+
+Depois de validar:
+
+```powershell
+node bin/skill-master-register-clients.mjs --apply-codex --force
+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-codex --force
+skill-master-menu --run doctor
+```
+
+Reiniciar Codex apos aplicar.
+
+## Aceite
+
+- `npm run check` passa.
+- `npm pack --dry-run` passa.
+- Codex config usa Node absoluto + `bin/skill-master.mjs` absoluto.
+- Doctor nao classifica `path-bin` como robusto.
+- Menu action matrix passa.
+- Nenhum segredo e publicado.
+

package/docs/prompt-tasks/PROMPT_TASK_018_NPM_PUBLISH_2FA_SETUP.md

@@ -0,0 +1,80 @@
+# Prompt Task 018 - npm Publish 2FA Setup
+
+Status: pronto para execucao na maquina autorizada
+Publicacao: somente com autorizacao explicita
+Branch sugerida: `chore/npm-publish-2fa-setup`
+Commit sugerido: `docs(npm): add 2fa publication runbook and transfer prompt`
+
+## Objetivo
+
+Preparar a maquina autorizada para publicar novas versoes do `@fprad0/skill-master-mcp` no npmjs, resolvendo bloqueios de OTP/2FA sem contornar seguranca.
+
+## Contexto
+
+O registry publico ja contem:
+
+```text
+@fprad0/skill-master-mcp@0.0.11
+```
+
+Antes de publicar, sincronizar o checkout e confirmar que a proxima versao e maior que a publicada.
+
+## Arquivos de referencia
+
+```text
+docs/operations/npm-publication-transfer/README_PUBLICACAO_NPM_2FA_2026-06-29.md
+```
+
+## Passos
+
+1. Abrir no Chrome:
+
+```text
+https://www.npmjs.com/login
+https://www.npmjs.com/settings/~/tokens
+https://docs.npmjs.com/recovering-your-2fa-enabled-account/
+```
+
+2. Recuperar acesso 2FA por app autenticador correto ou recovery code oficial.
+
+3. Se for publicar manualmente:
+
+```bash
+npm login --registry=https://registry.npmjs.org
+npm whoami --registry=https://registry.npmjs.org
+npm run check
+npm pack --dry-run
+npm publish --access public --registry=https://registry.npmjs.org --otp=SEU_OTP_ATUAL
+```
+
+4. Se for publicar com token:
+
+```bash
+npm config set //registry.npmjs.org/:_authToken "NPM_TOKEN_AQUI"
+npm whoami --registry=https://registry.npmjs.org
+npm run check
+npm pack --dry-run
+npm publish --access public --registry=https://registry.npmjs.org
+```
+
+5. Validar:
+
+```bash
+npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
+```
+
+## Criterios de aceite
+
+- Acesso npm recuperado sem expor OTP, token ou recovery code.
+- `npm whoami` passa na maquina autorizada.
+- `npm run check` passa.
+- `npm pack --dry-run` passa.
+- Versao publicada e maior que a versao atual no registry.
+- Nenhum segredo foi commitado.
+
+## Nao fazer
+
+- Nao colar OTP, token ou recovery code no Codex.
+- Nao publicar se `package.json` ainda estiver em versao ja existente.
+- Nao desativar 2FA como solucao de conveniencia.
+- Nao commitar `.npmrc`.

package/docs/prompt-tasks/PROMPT_TASK_MASTER_EXECUTOR.md

@@ -0,0 +1,6 @@
+# Prompt Task Master - Construcao do Skill Master MCP 00.01
+
+> STATUS: HISTORICO / ORQUESTRADOR ORIGINAL
+>
+> Este arquivo foi o coordenador da construcao inicial `00.01`.
+> Ele deve ser tratado como registro historico. Para o estado atual, siga a documentacao consolidada da linha `00.02`.