@fprad0/skill-master-mcp 0.0.10 → 0.0.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (108) hide show
  1. package/CHANGELOG.md +12 -1
  2. package/README.md +59 -10
  3. package/VERSION.md +3 -3
  4. package/bin/lib/client-config.mjs +293 -0
  5. package/bin/lib/menu-core.mjs +509 -131
  6. package/bin/lib/skill-installation.mjs +215 -0
  7. package/bin/skill-master-bootstrap-global.mjs +2 -1
  8. package/bin/skill-master-doctor.mjs +92 -32
  9. package/bin/skill-master-install-global-skills.mjs +4 -42
  10. package/bin/skill-master-install-project-skills.mjs +97 -0
  11. package/bin/skill-master-menu.mjs +91 -6
  12. package/bin/skill-master-register-clients.mjs +91 -115
  13. package/docs/operations/GUIA_MULTI_COMPUTADOR.md +262 -0
  14. package/docs/operations/GUIA_NPM_PUBLICO.md +147 -0
  15. package/docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md +66 -0
  16. package/docs/operations/assets/menu-frame-compact.html +76 -0
  17. package/docs/operations/assets/menu-frame-compact.png +0 -0
  18. package/docs/operations/assets/menu-frame-large.html +84 -0
  19. package/docs/operations/assets/menu-frame-large.png +0 -0
  20. package/docs/operations/assets/menu-frame-running.html +80 -0
  21. package/docs/operations/assets/menu-frame-running.png +0 -0
  22. package/docs/operations/cross-platform-auth-transfer/ANALISE_COMPATIBILIDADE_MCP_2026-06-28.md +140 -0
  23. package/docs/operations/cross-platform-auth-transfer/README_TRANSFERENCIA.md +85 -0
  24. package/docs/operations/reborn-menu-cyberpunk-transfer/ANALISE_MENU_REBORN_CYBERPUNK_2026-06-28.md +174 -0
  25. package/docs/operations/reborn-menu-cyberpunk-transfer/HANDOFF_IMPLEMENTACAO_REBORN_CYBERPUNK_2026-06-28.md +119 -0
  26. package/docs/operations/reborn-menu-cyberpunk-transfer/ORDEM_DE_EXECUCAO_MENU_REBORN_CYBERPUNK.md +134 -0
  27. package/docs/operations/reborn-menu-cyberpunk-transfer/README_TRANSFERENCIA.md +84 -0
  28. package/docs/operations/reborn-menu-cyberpunk-transfer/README_TRANSFERENCIA_REBORN_PACKAGE.md +56 -0
  29. package/docs/operations/reborn-menu-cyberpunk-transfer/references/cyan-hud-frame-sheet.jpg +0 -0
  30. package/docs/operations/reborn-menu-cyberpunk-transfer/references/cyberpunk-pattern-sheet.jpg +0 -0
  31. package/docs/operations/reborn-menu-cyberpunk-transfer/references/fluid-workflow-windows.gif +0 -0
  32. package/docs/prompt-tasks/PROMPT_TASK_001_BOOTSTRAP_SKILL_MASTER_MCP.md +6 -0
  33. package/docs/prompt-tasks/PROMPT_TASK_002_AUTO_UPDATE_LAUNCHER.md +6 -0
  34. package/docs/prompt-tasks/PROMPT_TASK_003_REMOTE_MANIFEST_AND_RELEASES.md +6 -0
  35. package/docs/prompt-tasks/PROMPT_TASK_004_MULTI_USER_DISTRIBUTION.md +6 -0
  36. package/docs/prompt-tasks/PROMPT_TASK_005_SECURITY_AND_QUALITY_GATE.md +6 -0
  37. package/docs/prompt-tasks/PROMPT_TASK_006_MASTER_ACIONAMENTO_APRENDIZADO.md +83 -0
  38. package/docs/prompt-tasks/PROMPT_TASK_007_PERSONA_ORQUESTRADORA.md +88 -0
  39. package/docs/prompt-tasks/PROMPT_TASK_008_PROMPT_ROUTER_MODOS_ATIVACAO.md +156 -0
  40. package/docs/prompt-tasks/PROMPT_TASK_009_PIPELINE_APRENDIZADO_SUCESSO.md +105 -0
  41. package/docs/prompt-tasks/PROMPT_TASK_010_EVALS_GOVERNANCA_ATIVACAO.md +119 -0
  42. package/docs/prompt-tasks/PROMPT_TASK_011_MENU_NOTIFICACOES_NOTION.md +120 -0
  43. package/docs/prompt-tasks/PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md +123 -0
  44. package/docs/prompt-tasks/PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md +114 -0
  45. package/docs/prompt-tasks/PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md +157 -0
  46. package/docs/prompt-tasks/PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md +127 -0
  47. package/docs/prompt-tasks/PROMPT_TASK_016_CROSS_PLATFORM_MCP_AUTH_REGISTRATION.md +107 -0
  48. package/docs/prompt-tasks/PROMPT_TASK_018_NPM_PUBLISH_2FA_SETUP.md +80 -0
  49. package/docs/prompt-tasks/PROMPT_TASK_MASTER_EXECUTOR.md +6 -0
  50. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/SKILL.md +399 -0
  51. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/common-patterns.md +331 -0
  52. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/complete-examples.md +872 -0
  53. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/component-patterns.md +502 -0
  54. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/data-fetching.md +767 -0
  55. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/file-organization.md +502 -0
  56. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/loading-and-error-states.md +501 -0
  57. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/performance.md +406 -0
  58. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/routing-guide.md +364 -0
  59. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/styling-guide.md +428 -0
  60. package/docs/skill-candidates/v0.0.11/frontend-dev-guidelines/resources/typescript-standards.md +418 -0
  61. package/docs/skill-candidates/v0.0.11/git-version-control-ops/SKILL.md +34 -0
  62. package/docs/skill-candidates/v0.0.11/go-engineering/SKILL.md +34 -0
  63. package/docs/skill-candidates/v0.0.11/java-engineering/SKILL.md +34 -0
  64. package/docs/skill-candidates/v0.0.11/javascript-engineering/SKILL.md +34 -0
  65. package/docs/skill-candidates/v0.0.11/json-contract-design/SKILL.md +34 -0
  66. package/docs/skill-candidates/v0.0.11/multi-client-mcp-ops/SKILL.md +36 -0
  67. package/docs/skill-candidates/v0.0.11/nextjs/SKILL.md +745 -0
  68. package/docs/skill-candidates/v0.0.11/nextjs/agents/openai.yaml +3 -0
  69. package/docs/skill-candidates/v0.0.11/nextjs/references/app-router-files.md +94 -0
  70. package/docs/skill-candidates/v0.0.11/python-engineering/SKILL.md +34 -0
  71. package/docs/skill-candidates/v0.0.11/ruby-engineering/SKILL.md +34 -0
  72. package/docs/skill-candidates/v0.0.11/senior-fullstack/SKILL.md +209 -0
  73. package/docs/skill-candidates/v0.0.11/senior-fullstack/references/architecture_patterns.md +103 -0
  74. package/docs/skill-candidates/v0.0.11/senior-fullstack/references/development_workflows.md +103 -0
  75. package/docs/skill-candidates/v0.0.11/senior-fullstack/references/tech_stack_guide.md +103 -0
  76. package/docs/skill-candidates/v0.0.11/senior-fullstack/scripts/code_quality_analyzer.py +114 -0
  77. package/docs/skill-candidates/v0.0.11/senior-fullstack/scripts/fullstack_scaffolder.py +114 -0
  78. package/docs/skill-candidates/v0.0.11/senior-fullstack/scripts/project_scaffolder.py +114 -0
  79. package/docs/skill-candidates/v0.0.11/shadcn/SKILL.md +573 -0
  80. package/docs/skill-candidates/v0.0.11/shadcn/agents/openai.yaml +3 -0
  81. package/docs/skill-candidates/v0.0.11/sql-postgresql-engineering/SKILL.md +34 -0
  82. package/docs/skill-candidates/v0.0.11/terminal-shell-ops/SKILL.md +34 -0
  83. package/docs/skill-candidates/v0.0.11/typescript-expert/SKILL.md +429 -0
  84. package/docs/skill-candidates/v0.0.11/typescript-expert/references/tsconfig-strict.json +92 -0
  85. package/docs/skill-candidates/v0.0.11/typescript-expert/references/typescript-cheatsheet.md +383 -0
  86. package/docs/skill-candidates/v0.0.11/typescript-expert/references/utility-types.ts +335 -0
  87. package/docs/skill-candidates/v0.0.11/typescript-expert/scripts/ts_diagnostic.py +203 -0
  88. package/docs/skill-candidates/v0.0.11/ui-component-primitives/SKILL.md +34 -0
  89. package/docs/skill-candidates/v0.0.11/web-mobile-design-systems/SKILL.md +34 -0
  90. package/docs/skill-candidates/v0.0.11/windows-linux-platform-ops/SKILL.md +34 -0
  91. package/docs/skill-candidates/v0.0.12/csharp-senior-master-engineering/SKILL.md +32 -0
  92. package/docs/skill-candidates/v0.0.12/css-senior-master-engineering/SKILL.md +32 -0
  93. package/docs/skill-candidates/v0.0.12/go-senior-master-engineering/SKILL.md +32 -0
  94. package/docs/skill-candidates/v0.0.12/html-senior-master-engineering/SKILL.md +32 -0
  95. package/docs/skill-candidates/v0.0.12/javascript-senior-master-engineering/SKILL.md +32 -0
  96. package/docs/skill-candidates/v0.0.12/json-senior-master-engineering/SKILL.md +32 -0
  97. package/docs/skill-candidates/v0.0.12/python-senior-master-engineering/SKILL.md +32 -0
  98. package/docs/skill-candidates/v0.0.12/react-senior-master-engineering/SKILL.md +32 -0
  99. package/docs/skill-candidates/v0.0.12/ruby-senior-master-engineering/SKILL.md +32 -0
  100. package/docs/skill-candidates/v0.0.12/senior-master-code-optimizer/SKILL.md +48 -0
  101. package/docs/skill-candidates/v0.0.12/sql-senior-master-engineering/SKILL.md +31 -0
  102. package/docs/skill-candidates/v0.0.12/typescript-senior-master-engineering/SKILL.md +35 -0
  103. package/examples/client-configs/claude-code.commands.md +11 -7
  104. package/manifests/channels/beta.json +7 -7
  105. package/manifests/channels/stable.json +8 -8
  106. package/package.json +14 -2
  107. package/scripts/render-menu-evidence.mjs +130 -0
  108. package/scripts/verify-menu-actions.mjs +117 -0
@@ -0,0 +1,85 @@
1
+ # Transferencia - Compatibilidade MCP Multi-OS
2
+
3
+ Este pacote leva a correcao de compatibilidade do `skill-master-mcp` para Windows, Linux e macOS.
4
+
5
+ ## Zip gerado nesta maquina
6
+
7
+ ```text
8
+ C:\Users\CDT\Documents\F.Prado\skill-master-cross-platform-auth-transfer-2026-06-28.zip
9
+ ```
10
+
11
+ ## Copiar para o outro computador
12
+
13
+ Copie preservando os caminhos relativos:
14
+
15
+ ```text
16
+ bin/lib/client-config.mjs
17
+ bin/lib/menu-core.mjs
18
+ bin/skill-master-bootstrap-global.mjs
19
+ bin/skill-master-doctor.mjs
20
+ bin/skill-master-register-clients.mjs
21
+ scripts/verify-menu-actions.mjs
22
+ src/client-config.test.ts
23
+ src/menu-core.test.ts
24
+ package.json
25
+ README.md
26
+ CHANGELOG.md
27
+ docs/operations/GUIA_MULTI_COMPUTADOR.md
28
+ docs/operations/cross-platform-auth-transfer/
29
+ docs/prompt-tasks/PROMPT_TASK_016_CROSS_PLATFORM_MCP_AUTH_REGISTRATION.md
30
+ ```
31
+
32
+ Se tambem for levar o pacote visual Reborn, copie:
33
+
34
+ ```text
35
+ bin/skill-master-menu.mjs
36
+ scripts/render-menu-evidence.mjs
37
+ docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md
38
+ docs/operations/assets/menu-frame-large.html
39
+ docs/operations/assets/menu-frame-compact.html
40
+ docs/operations/assets/menu-frame-running.html
41
+ docs/operations/reborn-menu-cyberpunk-transfer/
42
+ docs/prompt-tasks/PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md
43
+ docs/prompt-tasks/PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md
44
+ docs/prompt-tasks/PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md
45
+ docs/prompt-tasks/PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md
46
+ ```
47
+
48
+ ## Sequencia no outro computador
49
+
50
+ ```powershell
51
+ git status --short
52
+ npm install
53
+ npm run check
54
+ npm pack --dry-run
55
+ ```
56
+
57
+ Para testar registro sem aplicar:
58
+
59
+ ```powershell
60
+ node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
61
+ ```
62
+
63
+ Para aplicar no Codex e clientes:
64
+
65
+ ```powershell
66
+ node bin/skill-master-register-clients.mjs --apply-all --force
67
+ node bin/skill-master-doctor.mjs
68
+ ```
69
+
70
+ Depois de publicar no npmjs:
71
+
72
+ ```powershell
73
+ npm install -g @fprad0/skill-master-mcp@latest
74
+ skill-master-register-clients --apply-all --force
75
+ skill-master-menu --run doctor
76
+ ```
77
+
78
+ Reinicie Codex, Claude, Gemini e Antigravity depois do registro.
79
+
80
+ ## Nao fazer
81
+
82
+ - Nao publicar sem autorizacao explicita.
83
+ - Nao copiar `.env`, `.npmrc` com token ou PAT.
84
+ - Nao usar `git reset --hard`.
85
+ - Nao prometer que npm consegue burlar autorizacao do sistema operacional.
@@ -0,0 +1,174 @@
1
+ # Analise - Menu Reborn Cyberpunk Pixel Art
2
+
3
+ Data: 2026-06-28
4
+ Projeto: `@fprad0/skill-master-mcp`
5
+ Versao local analisada: `0.0.10`
6
+ Publicacao: proibida neste computador. Publicar somente no computador autorizado.
7
+
8
+ ## Objetivo
9
+
10
+ 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.
11
+
12
+ 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.
13
+
14
+ ## Estado entregue nesta maquina
15
+
16
+ Implementado localmente:
17
+
18
+ - sistema de frames cyberpunk ASCII em `bin/lib/menu-core.mjs`;
19
+ - frame principal com `overview`, `actions`, `details`, `core` e `telemetry`;
20
+ - intro `REBORN / SKILL_MASTER` para o menu visual e para `--run` em TTY;
21
+ - confirmacao visual `CONFIRMATION GATE` no menu interativo;
22
+ - estado `SKILL_MASTER WORKFLOW ONLINE` antes do handoff para o comando real;
23
+ - resultado em frame `SUBROUTINE COMPLETE` ou `SUBROUTINE FAILED`;
24
+ - fallback textual para terminal sem TTY, CI, `TERM=dumb` ou `SKILL_MASTER_NO_VISUAL=1`;
25
+ - correcao do executor de acoes para nao usar shell por padrao;
26
+ - resolucao de `npm-cli.js` no Windows para evitar falha com `C:\Program Files\...`;
27
+ - preservacao do binario MCP `skill-master-mcp` sem HUD em stdout.
28
+
29
+ ## Referencias visuais copiadas para transferencia
30
+
31
+ As referencias originais foram copiadas para dentro do repo para facilitar transferencia ao outro computador:
32
+
33
+ ```text
34
+ docs/operations/reborn-menu-cyberpunk-transfer/references/cyberpunk-pattern-sheet.jpg
35
+ docs/operations/reborn-menu-cyberpunk-transfer/references/cyan-hud-frame-sheet.jpg
36
+ docs/operations/reborn-menu-cyberpunk-transfer/references/fluid-workflow-windows.gif
37
+ ```
38
+
39
+ Leitura visual:
40
+
41
+ - `cyberpunk-pattern-sheet.jpg`: biblioteca de cantos, setas, barras, chips, marcadores, janelas e micro detalhes.
42
+ - `cyan-hud-frame-sheet.jpg`: frames retangulares com cortes chanfrados, bordas duplas, linhas ciano e areas vazias limpas.
43
+ - `fluid-workflow-windows.gif`: janelas independentes sobre grid escuro, movimento procedural, paineis tecnicos e hierarquia de laboratorio visual.
44
+
45
+ ## Estado atual encontrado
46
+
47
+ Arquivos principais:
48
+
49
+ ```text
50
+ bin/skill-master-menu.mjs
51
+ bin/lib/menu-core.mjs
52
+ src/menu-core.test.ts
53
+ scripts/render-menu-evidence.mjs
54
+ docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md
55
+ docs/operations/assets/menu-frame-large.html
56
+ docs/operations/assets/menu-frame-compact.html
57
+ docs/operations/assets/menu-frame-running.html
58
+ ```
59
+
60
+ O menu atual ja tem:
61
+
62
+ - `skill-master-menu` como CLI humano separado do binario MCP stdio.
63
+ - `bin/lib/menu-core.mjs` com renderer e logica testavel.
64
+ - teclado com `up/down`, `j/k`, `enter`, `q`, `esc` e `ctrl+c`.
65
+ - alternate screen com cursor oculto e escrita estavel.
66
+ - frame cyberpunk inicial com `overview`, `actions`, `details`, `dna-core` e `telemetry`.
67
+ - script de evidencia para gerar HTML/PNG de frames.
68
+ - testes em `src/menu-core.test.ts`.
69
+
70
+ ## Validacao local deste pacote
71
+
72
+ 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 `\`.
73
+
74
+ 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.
75
+
76
+ Depois do ajuste:
77
+
78
+ ```powershell
79
+ npm run check
80
+ ```
81
+
82
+ Resultado local: build, 57 testes, matriz de 22 acoes e manifestos passaram.
83
+
84
+ 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.
85
+
86
+ ## Acoes atuais do menu
87
+
88
+ O menu possui 22 acoes:
89
+
90
+ ```text
91
+ status
92
+ doctor
93
+ check
94
+ build
95
+ publicNpm
96
+ updateGlobal
97
+ privateRegistry
98
+ activationStatus
99
+ activationBalanced
100
+ activationAlwaysOn
101
+ installGlobalSkills
102
+ bootstrapGlobal
103
+ registerClients
104
+ promptRecommendation
105
+ successNotifications
106
+ studySkills
107
+ approvalPackage
108
+ markLearnedStudy
109
+ rejectLearnedSkill
110
+ activateLearnedLocal
111
+ activateLearnedGlobal
112
+ notionSummary
113
+ ```
114
+
115
+ Pontos de atencao:
116
+
117
+ - Acoes de update, registry, bootstrap, registro de clientes e ativacao global exigem confirmacao.
118
+ - `check` e `build` ficam indisponiveis fora de checkout de desenvolvimento.
119
+ - `--status`, `--help` e `--run <acao>` precisam continuar funcionando sem TTY.
120
+ - O binario MCP stdio continua sendo `skill-master-mcp` e nao deve receber UI nem logs em stdout.
121
+
122
+ ## Lacunas visuais analisadas
123
+
124
+ O estado inicial era funcional, mas ficava mais proximo de terminal classico do que das referencias:
125
+
126
+ - Molduras usam caixas lineares simples; faltam cantos chanfrados e assimetrias tecnicas.
127
+ - A paleta visual nas capturas esta muito branca; precisa reforcar ciano, cinza e pontos de amber com criterio.
128
+ - O frame do menu nao parece uma janela cyberpunk recortada como a segunda imagem.
129
+ - A animacao do DNA existe, mas pode ficar mais fluida e procedural como o GIF.
130
+ - Os paineis poderiam parecer janelas independentes em um workflow visual, nao apenas caixas empilhadas.
131
+ - Faltam micro detalhes: trilhas, marcadores, barras segmentadas, tabs tecnicas e respiros visuais.
132
+
133
+ ## Direcao tecnica recomendada
134
+
135
+ Manter a arquitetura atual e evoluir por dentro de `menu-core`:
136
+
137
+ 1. Criar um pequeno sistema de frames ASCII/Unicode dentro de `bin/lib/menu-core.mjs`.
138
+ 2. Separar os estilos de frame em variantes: `hud`, `focus`, `cyan-cut`, `data-slab`, `running`.
139
+ 3. Preservar fallback sem cor e sem TTY.
140
+ 4. Continuar sem dependencia pesada de TUI.
141
+ 5. Expandir testes de layout para larguras diferentes.
142
+ 6. Expandir `scripts/render-menu-evidence.mjs` para gerar evidencias com mais ticks e estados.
143
+ 7. Criar uma verificacao funcional de todas as acoes sem executar publicacao.
144
+
145
+ ## Direcao visual recomendada
146
+
147
+ Aplicar um visual terminal cyberpunk pixel art com:
148
+
149
+ - fundo conceitual de grid atraves da evidencia HTML, sem depender disso no terminal real.
150
+ - bordas ciano e brancas com cortes de canto.
151
+ - detalhes pequenos de segmentos, pinos, trilhas e barras.
152
+ - layout de janelas independentes inspirado no GIF.
153
+ - DNA/helix mais fluido com scanline, fase e pulso de selecao.
154
+ - foco visual claro no item selecionado.
155
+ - texto sempre legivel antes de ornamentacao.
156
+
157
+ ## Riscos
158
+
159
+ - Unicode/encoding no Windows pode quebrar se os caracteres forem usados sem cuidado.
160
+ - Ornamento demais pode reduzir legibilidade em terminais pequenos.
161
+ - Animacao demais pode causar flicker.
162
+ - Testar acoes destrutivas exige confirmacao simulada ou validacao em dry-run.
163
+ - Publicacao npm nao pode acontecer neste computador.
164
+
165
+ ## Resultado esperado
166
+
167
+ Ao final da execucao no computador autorizado:
168
+
169
+ - `skill-master-menu` abre com frame cyberpunk pixel art mais fiel as referencias.
170
+ - O menu continua fluido, legivel e navegavel.
171
+ - Todas as 22 acoes sao validadas por teste, smoke test ou matriz manual.
172
+ - Evidencias visuais novas ficam em `docs/operations/assets`.
173
+ - `npm run check` passa.
174
+ - O pacote so e publicado no computador com autorizacoes npmjs.
@@ -0,0 +1,119 @@
1
+ # Handoff - Implementacao Reborn Cyberpunk HUD
2
+
3
+ Data: 2026-06-28
4
+ Projeto: `@fprad0/skill-master-mcp`
5
+ Publicacao: somente no computador autorizado e somente com aprovacao explicita.
6
+
7
+ ## O que foi entregue
8
+
9
+ - HUD terminal cyberpunk pixel art para `skill-master-menu`.
10
+ - Intro visual `REBORN / SKILL_MASTER`.
11
+ - Frame principal com `overview`, `actions`, `details`, `core` e `telemetry`.
12
+ - Confirmacao visual para acoes protegidas.
13
+ - Estado visual `SKILL_MASTER WORKFLOW ONLINE` antes do comando real.
14
+ - Frames de resultado `SUBROUTINE COMPLETE` e `SUBROUTINE FAILED`.
15
+ - Saida textual/fallback para CI, terminal sem TTY, `TERM=dumb` e `SKILL_MASTER_NO_VISUAL=1`.
16
+ - Executor de acoes sem shell por padrao.
17
+ - Resolucao de `npm-cli.js` no Windows para evitar falha com caminhos em `C:\Program Files`.
18
+ - Registro MCP robusto usando Node absoluto e entrypoint absoluto do pacote.
19
+
20
+ ## Limite importante
21
+
22
+ O HUD visual e apenas para CLI humano (`skill-master-menu` e acoes humanas). O binario MCP `skill-master-mcp` continua limpo para `stdio`; nao adicionar animacao, logs humanos ou frames no stdout do servidor MCP.
23
+
24
+ ## Arquivos principais alterados
25
+
26
+ ```text
27
+ bin/lib/client-config.mjs
28
+ bin/lib/menu-core.mjs
29
+ bin/skill-master-bootstrap-global.mjs
30
+ bin/skill-master-doctor.mjs
31
+ bin/skill-master-menu.mjs
32
+ bin/skill-master-register-clients.mjs
33
+ scripts/verify-menu-actions.mjs
34
+ scripts/render-menu-evidence.mjs
35
+ src/client-config.test.ts
36
+ src/menu-core.test.ts
37
+ package.json
38
+ README.md
39
+ CHANGELOG.md
40
+ docs/operations/GUIA_MULTI_COMPUTADOR.md
41
+ docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md
42
+ docs/operations/assets/menu-frame-large.html
43
+ docs/operations/assets/menu-frame-compact.html
44
+ docs/operations/assets/menu-frame-running.html
45
+ docs/operations/cross-platform-auth-transfer/
46
+ docs/operations/reborn-menu-cyberpunk-transfer/
47
+ docs/prompt-tasks/PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md
48
+ docs/prompt-tasks/PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md
49
+ docs/prompt-tasks/PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md
50
+ docs/prompt-tasks/PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md
51
+ docs/prompt-tasks/PROMPT_TASK_016_CROSS_PLATFORM_MCP_AUTH_REGISTRATION.md
52
+ ```
53
+
54
+ ## Validacoes executadas nesta maquina
55
+
56
+ ```powershell
57
+ npm run check
58
+ node scripts/verify-menu-actions.mjs
59
+ node scripts/render-menu-evidence.mjs
60
+ npm pack --dry-run
61
+ node bin/skill-master-menu.mjs --run status
62
+ node bin/skill-master-menu.mjs --run doctor
63
+ node bin/skill-master-menu.mjs --run public-npm
64
+ node bin/skill-master-menu.mjs --run activation-status
65
+ node bin/skill-master-menu.mjs --run notifications
66
+ node bin/skill-master-menu.mjs --run study-skills
67
+ node bin/skill-master-menu.mjs --run notion-summary
68
+ ```
69
+
70
+ Resultado: build, 57 testes, matriz de 22 acoes, manifestos, smokes seguros e dry-run de pacote passaram.
71
+
72
+ ## Sequencia no computador autorizado
73
+
74
+ ```powershell
75
+ git status --short
76
+ npm install
77
+ npm run check
78
+ node scripts/render-menu-evidence.mjs
79
+ npm pack --dry-run
80
+ ```
81
+
82
+ Validar registro de clientes:
83
+
84
+ ```powershell
85
+ node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
86
+ node bin/skill-master-doctor.mjs
87
+ ```
88
+
89
+ Aplicar registro local depois de revisar:
90
+
91
+ ```powershell
92
+ node bin/skill-master-register-clients.mjs --apply-all --force
93
+ node bin/skill-master-doctor.mjs
94
+ ```
95
+
96
+ Publicar somente depois de autorizacao explicita:
97
+
98
+ ```powershell
99
+ npm publish --access public --registry=https://registry.npmjs.org
100
+ npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
101
+ ```
102
+
103
+ Depois da publicacao no outro computador:
104
+
105
+ ```powershell
106
+ npm install -g @fprad0/skill-master-mcp@latest
107
+ skill-master-register-clients --apply-all --force
108
+ skill-master-menu --run doctor
109
+ ```
110
+
111
+ Reinicie Codex, Claude, Gemini e Antigravity depois do registro.
112
+
113
+ ## Nao fazer
114
+
115
+ - Nao publicar deste computador.
116
+ - Nao copiar `.env`, `.npmrc` com token, PAT ou qualquer segredo.
117
+ - Nao usar `git reset --hard`.
118
+ - Nao colocar HUD no stdout do `skill-master-mcp`.
119
+ - Nao prometer autenticacao que burle permissoes do sistema operacional; o que foi implementado e registro robusto com executavel absoluto.
@@ -0,0 +1,134 @@
1
+ # Ordem de Execucao - Menu Reborn Cyberpunk
2
+
3
+ Publicacao: executar somente no computador autorizado.
4
+
5
+ ## Visao geral
6
+
7
+ Esta ordem divide a melhoria do menu em quatro prompt tasks para reduzir risco:
8
+
9
+ 1. `PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md`
10
+ 2. `PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md`
11
+ 3. `PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md`
12
+ 4. `PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md`
13
+
14
+ ## Antes de iniciar
15
+
16
+ No computador de execucao/publicacao:
17
+
18
+ ```powershell
19
+ git status --short
20
+ node -v
21
+ npm -v
22
+ git --version
23
+ npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
24
+ ```
25
+
26
+ Regras:
27
+
28
+ - Nao usar `git reset --hard`.
29
+ - Nao reverter alteracoes de outro agente.
30
+ - Nao publicar sem autorizacao explicita.
31
+ - Nao expor `.env`, tokens, PATs ou `.npmrc` com segredo.
32
+ - Trabalhar em branch separada.
33
+
34
+ Branch sugerida:
35
+
36
+ ```text
37
+ feature/reborn-cyberpunk-menu
38
+ ```
39
+
40
+ ## Sequencia
41
+
42
+ ### 1. Frame pixel art
43
+
44
+ Executar `PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md`.
45
+
46
+ Meta: transformar as molduras e paineis para o estilo cyberpunk pixel art, preservando o renderer atual.
47
+
48
+ Validacao minima:
49
+
50
+ ```powershell
51
+ npm run check
52
+ node scripts/render-menu-evidence.mjs
53
+ node bin/skill-master-menu.mjs --status
54
+ node bin/skill-master-menu.mjs --help
55
+ ```
56
+
57
+ ### 2. DNA fluido e janelas procedural
58
+
59
+ Executar `PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md`.
60
+
61
+ Meta: aproximar o DNA visual e a composicao das janelas do GIF, com movimento limpo e baixo flicker.
62
+
63
+ Validacao minima:
64
+
65
+ ```powershell
66
+ npm run check
67
+ node scripts/render-menu-evidence.mjs
68
+ ```
69
+
70
+ ### 3. Paridade funcional
71
+
72
+ Executar `PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md`.
73
+
74
+ Meta: provar que cada funcao do menu continua executavel, bloqueada corretamente ou protegida por confirmacao.
75
+
76
+ Validacao minima:
77
+
78
+ ```powershell
79
+ npm run check
80
+ node bin/skill-master-menu.mjs --run status
81
+ node bin/skill-master-menu.mjs --run doctor
82
+ node bin/skill-master-menu.mjs --run public-npm
83
+ node bin/skill-master-menu.mjs --run activation-status
84
+ node bin/skill-master-menu.mjs --run notifications
85
+ node bin/skill-master-menu.mjs --run study-skills
86
+ node bin/skill-master-menu.mjs --run approval-package
87
+ node bin/skill-master-menu.mjs --run notion-summary
88
+ ```
89
+
90
+ ### 4. Handoff, release e publicacao
91
+
92
+ Executar `PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md`.
93
+
94
+ Meta: preparar changelog, manifesto, evidencias e publicacao no npmjs somente apos aprovacao.
95
+
96
+ Validacao minima antes de pedir autorizacao para publicar:
97
+
98
+ ```powershell
99
+ npm run check
100
+ npm pack --dry-run
101
+ ```
102
+
103
+ Depois da autorizacao explicita, publicar e validar:
104
+
105
+ ```powershell
106
+ npm publish --access public --registry=https://registry.npmjs.org
107
+ npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
108
+ ```
109
+
110
+ ## Arquivos deste pacote
111
+
112
+ ```text
113
+ docs/operations/reborn-menu-cyberpunk-transfer/ANALISE_MENU_REBORN_CYBERPUNK_2026-06-28.md
114
+ docs/operations/reborn-menu-cyberpunk-transfer/HANDOFF_IMPLEMENTACAO_REBORN_CYBERPUNK_2026-06-28.md
115
+ docs/operations/reborn-menu-cyberpunk-transfer/ORDEM_DE_EXECUCAO_MENU_REBORN_CYBERPUNK.md
116
+ docs/operations/reborn-menu-cyberpunk-transfer/README_TRANSFERENCIA.md
117
+ docs/operations/reborn-menu-cyberpunk-transfer/references/cyberpunk-pattern-sheet.jpg
118
+ docs/operations/reborn-menu-cyberpunk-transfer/references/cyan-hud-frame-sheet.jpg
119
+ docs/operations/reborn-menu-cyberpunk-transfer/references/fluid-workflow-windows.gif
120
+ docs/prompt-tasks/PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md
121
+ docs/prompt-tasks/PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md
122
+ docs/prompt-tasks/PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md
123
+ docs/prompt-tasks/PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md
124
+ src/menu-core.test.ts
125
+ ```
126
+
127
+ ## Commits sugeridos
128
+
129
+ ```text
130
+ feat(menu): add cyberpunk pixel frame system
131
+ feat(menu): add fluid dna terminal animation
132
+ test(menu): verify functional parity for operator actions
133
+ docs(release): add reborn menu handoff and evidence
134
+ ```
@@ -0,0 +1,84 @@
1
+ # Transferencia - Reborn Cyberpunk Menu
2
+
3
+ Este pacote foi preparado para levar a melhoria do menu do `skill-master-mcp` para outro computador, onde existem as credenciais e autorizacoes corretas para publicar no npmjs.
4
+
5
+ ## Arquivo zip gerado nesta maquina
6
+
7
+ ```text
8
+ C:\Users\CDT\Documents\F.Prado\skill-master-reborn-cyberpunk-auth-transfer-2026-06-28.zip
9
+ ```
10
+
11
+ ## Copiar para o outro computador
12
+
13
+ Copie estes itens preservando os caminhos relativos dentro do repo:
14
+
15
+ ```text
16
+ bin/lib/client-config.mjs
17
+ bin/lib/menu-core.mjs
18
+ bin/skill-master-bootstrap-global.mjs
19
+ bin/skill-master-doctor.mjs
20
+ bin/skill-master-menu.mjs
21
+ bin/skill-master-register-clients.mjs
22
+ scripts/verify-menu-actions.mjs
23
+ scripts/render-menu-evidence.mjs
24
+ src/client-config.test.ts
25
+ src/menu-core.test.ts
26
+ package.json
27
+ README.md
28
+ CHANGELOG.md
29
+ docs/operations/GUIA_MULTI_COMPUTADOR.md
30
+ docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md
31
+ docs/operations/assets/menu-frame-large.html
32
+ docs/operations/assets/menu-frame-compact.html
33
+ docs/operations/assets/menu-frame-running.html
34
+ docs/operations/cross-platform-auth-transfer/
35
+ docs/operations/reborn-menu-cyberpunk-transfer/
36
+ docs/prompt-tasks/PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md
37
+ docs/prompt-tasks/PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md
38
+ docs/prompt-tasks/PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md
39
+ docs/prompt-tasks/PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md
40
+ docs/prompt-tasks/PROMPT_TASK_016_CROSS_PLATFORM_MCP_AUTH_REGISTRATION.md
41
+ ```
42
+
43
+ O pacote inclui tanto a melhoria visual Reborn quanto a correcao de registro MCP multi-OS.
44
+
45
+ As imagens/GIF de referencia ja estao dentro de:
46
+
47
+ ```text
48
+ docs/operations/reborn-menu-cyberpunk-transfer/references/
49
+ ```
50
+
51
+ ## Como usar no outro computador
52
+
53
+ 1. Abrir o repo original `skill-master-mcp`.
54
+ 2. Garantir que a working tree esta limpa ou que as mudancas existentes foram compreendidas.
55
+ 3. Criar a branch `feature/reborn-cyberpunk-menu`.
56
+ 4. Ler `HANDOFF_IMPLEMENTACAO_REBORN_CYBERPUNK_2026-06-28.md`.
57
+ 5. Revisar os prompt tasks de 012 a 016 se quiser auditar a origem das mudancas.
58
+ 6. Rodar validacoes.
59
+ 7. Publicar somente depois de autorizacao explicita.
60
+
61
+ ## Comandos de verificacao inicial
62
+
63
+ ```powershell
64
+ git status --short
65
+ node -v
66
+ npm -v
67
+ git --version
68
+ npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
69
+ npm run check
70
+ node scripts/render-menu-evidence.mjs
71
+ npm pack --dry-run
72
+ ```
73
+
74
+ ## Observacoes de seguranca
75
+
76
+ - Nao copiar `.env`.
77
+ - Nao copiar `.npmrc` com token.
78
+ - Nao colocar PAT em arquivo versionado.
79
+ - Nao publicar a partir deste computador.
80
+ - Nao executar `git reset --hard`.
81
+
82
+ ## Resultado esperado
83
+
84
+ O outro computador deve receber contexto suficiente para implementar, validar, empacotar e publicar a melhoria do menu sem depender desta conversa.
@@ -0,0 +1,56 @@
1
+ # Transferencia - Reborn Cyberpunk Menu
2
+
3
+ Este pacote foi preparado para levar a melhoria do menu do `skill-master-mcp` para outro computador, onde existem as credenciais e autorizacoes corretas para publicar no npmjs.
4
+
5
+ ## Copiar para o outro computador
6
+
7
+ Copie estes itens preservando os caminhos relativos dentro do repo:
8
+
9
+ ```text
10
+ src/menu-core.test.ts
11
+ docs/operations/reborn-menu-cyberpunk-transfer/
12
+ docs/prompt-tasks/PROMPT_TASK_012_MENU_CYBERPUNK_PIXEL_FRAME.md
13
+ docs/prompt-tasks/PROMPT_TASK_013_MENU_FLUID_DNA_ANIMATION.md
14
+ docs/prompt-tasks/PROMPT_TASK_014_MENU_FUNCTIONAL_PARITY_QA.md
15
+ docs/prompt-tasks/PROMPT_TASK_015_TRANSFER_RELEASE_HANDOFF.md
16
+ ```
17
+
18
+ `src/menu-core.test.ts` contem um pequeno ajuste cross-platform para os testes aceitarem caminhos Windows e POSIX.
19
+
20
+ As imagens/GIF de referencia ja estao dentro de:
21
+
22
+ ```text
23
+ docs/operations/reborn-menu-cyberpunk-transfer/references/
24
+ ```
25
+
26
+ ## Como usar no outro computador
27
+
28
+ 1. Abrir o repo original `skill-master-mcp`.
29
+ 2. Garantir que a working tree esta limpa ou que as mudancas existentes foram compreendidas.
30
+ 3. Criar a branch `feature/reborn-cyberpunk-menu`.
31
+ 4. Ler `ORDEM_DE_EXECUCAO_MENU_REBORN_CYBERPUNK.md`.
32
+ 5. Executar os prompt tasks de 012 a 015 em ordem.
33
+ 6. Rodar validacoes.
34
+ 7. Publicar somente depois de autorizacao explicita.
35
+
36
+ ## Comandos de verificacao inicial
37
+
38
+ ```powershell
39
+ git status --short
40
+ node -v
41
+ npm -v
42
+ git --version
43
+ npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
44
+ ```
45
+
46
+ ## Observacoes de seguranca
47
+
48
+ - Nao copiar `.env`.
49
+ - Nao copiar `.npmrc` com token.
50
+ - Nao colocar PAT em arquivo versionado.
51
+ - Nao publicar a partir deste computador.
52
+ - Nao executar `git reset --hard`.
53
+
54
+ ## Resultado esperado
55
+
56
+ O outro computador deve receber contexto suficiente para implementar, validar, empacotar e publicar a melhoria do menu sem depender desta conversa.
@@ -0,0 +1,6 @@
1
+ # Prompt Task 001 - Bootstrap do MCP Skill Master 00.01
2
+
3
+ > STATUS: HISTORICO / EXECUCAO JA CONCLUIDA
4
+ >
5
+ > Este prompt task pertence a fase inicial `00.01`.
6
+ > Mantenha como referencia historica. Nao usar como fonte principal para novas instalacoes ou distribuicao atual.
@@ -0,0 +1,6 @@
1
+ # Prompt Task 002 - Launcher e Auto-Update Seguro
2
+
3
+ > STATUS: HISTORICO / EXECUCAO JA INCORPORADA
4
+ >
5
+ > Este prompt task pertence ao ciclo inicial de construcao.
6
+ > O comportamento atual do auto-update deve ser consultado nos guias operacionais vigentes.
@@ -0,0 +1,6 @@
1
+ # Prompt Task 003 - Manifestos Remotos, Releases e Canais
2
+
3
+ > STATUS: HISTORICO / EXECUCAO PARCIALMENTE INCORPORADA
4
+ >
5
+ > Este prompt task representa uma etapa de construcao da linha `00.01`.
6
+ > O comportamento vigente deve ser consultado nos guias operacionais atuais.
@@ -0,0 +1,6 @@
1
+ # Prompt Task 004 - Distribuicao para Varios Usuarios
2
+
3
+ > STATUS: HISTORICO / EXECUCAO JA INCORPORADA
4
+ >
5
+ > Este prompt task registra a fase de estruturacao da distribuicao multiusuario.
6
+ > Para distribuicao atual, use os guias atualizados de npm publico, multi-computador e compatibilidade de clientes.