@fprad0/skill-master-mcp 0.0.12 → 1.0.1

package/docs/planning/mcp-1.0.0/prompt-tasks-nota-10-10/04_PROMPT_TASK_EVIDENCE_RENDERER_1_0_0.md

@@ -0,0 +1,97 @@
+# Prompt Task 04 - Evidencias visuais atualizadas para 1.0.0
+
+Status: pronto para execucao
+Publicacao: proibida sem autorizacao explicita
+Branch sugerida: `feature/menu-evidence-1-0-0`
+Commit recomendado: `docs(menu): refresh visual evidence for version 1.0.0`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: atualizar `scripts/render-menu-evidence.mjs` e as evidencias visuais para refletirem a versao real `1.0.0`, o bundle atual e os novos estados do DNA refinado, evitando evidencia fake antiga.
+
+## Diagnostico inicial obrigatorio
+
+```powershell
+git status --short
+node bin\skill-master-menu.mjs --status
+node scripts\render-menu-evidence.mjs
+rg -n "0.0.12|00.06|total: 66|menu-frame" scripts docs src
+```
+
+## Contexto
+
+A auditoria encontrou que `scripts/render-menu-evidence.mjs` ainda usa:
+
+- `semver: 0.0.12`;
+- `manifestVersion: 00.06`;
+- bundle fake `66`;
+- evidencias limitadas a large, compact e running.
+
+Isso enfraquece a confianca visual e tecnica da release.
+
+## Escopo permitido
+
+- Editar `scripts/render-menu-evidence.mjs`.
+- Editar `docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md` ou criar novo relatorio.
+- Atualizar `docs/operations/assets/*.html`.
+- Atualizar testes em `src/menu-core.test.ts` se o script exportar novos estados.
+
+## Fora de escopo
+
+- Publicar pacote.
+- Gerar binarios grandes sem necessidade.
+- Alterar referencias originais anexadas.
+- Alterar comportamento do menu sem necessidade.
+
+## Implementacao esperada
+
+Atualizar o renderer para gerar:
+
+- `menu-frame-large.html`;
+- `menu-frame-compact.html`;
+- `menu-frame-running.html`;
+- `menu-frame-dna-hero.html`;
+- `menu-frame-fine-helix.html`;
+- opcional: `menu-frame-score-10-contact-sheet.html`.
+
+Dados devem vir preferencialmente de helper compartilhado ou fixture atualizada:
+
+```text
+semver: 1.0.0
+manifestVersion: 1.0.0
+manifestSemver: 1.0.0
+bundle: valor atual do status real ou fixture documentada
+global readiness: ready
+```
+
+## Testes obrigatorios
+
+- Teste ou smoke que falha se `scripts/render-menu-evidence.mjs` voltar a conter `0.0.12`.
+- Testar que os HTMLs sao gerados.
+- Testar que os frames contem `1.0.0`.
+
+## Validacao obrigatoria
+
+```powershell
+npm run check
+node scripts\render-menu-evidence.mjs
+Select-String -Path docs\operations\assets\*.html -Pattern "1.0.0"
+Select-String -Path scripts\render-menu-evidence.mjs -Pattern "0.0.12"
+```
+
+## Criterios de aceite
+
+- Evidencias refletem a versao 1.0.0.
+- Evidencias incluem DNA refinado.
+- Nenhum HTML de evidencia mostra versao antiga.
+- `npm run check` passa.
+
+## Formato da resposta final do executor
+
+- evidencia antiga encontrada:
+- evidencia atualizada:
+- arquivos gerados:
+- validacao executada:
+- pendencias visuais:

package/docs/planning/mcp-1.0.0/prompt-tasks-nota-10-10/05_PROMPT_TASK_CROSS_PLATFORM_UTF8_MOJIBAKE.md

@@ -0,0 +1,99 @@
+# Prompt Task 05 - Compatibilidade UTF-8 e mojibake em Windows/Linux/macOS
+
+Status: pronto para execucao
+Publicacao: proibida sem autorizacao explicita
+Branch sugerida: `fix/menu-cross-platform-utf8`
+Commit recomendado: `fix(menu): harden terminal unicode fallback`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: reduzir risco de mojibake e caracteres quebrados no `skill-master-menu`, especialmente em Windows PowerShell legado, sem perder o visual premium em terminais modernos.
+
+## Diagnostico inicial obrigatorio
+
+```powershell
+git status --short
+node bin\skill-master-menu.mjs --help
+node scripts\render-menu-evidence.mjs
+rg -n "â|Ã|\\u|renderMeterBar|renderSparkline|renderCyberFrame|BRAILLE" bin src scripts docs
+```
+
+## Contexto
+
+A auditoria observou risco de caracteres como `â...` aparecerem em logs/terminais dependendo da codepage. O menu usa Unicode intencionalmente, mas precisa de fallback ou deteccao para ambientes limitados.
+
+## Escopo permitido
+
+- Editar `bin/lib/menu-core.mjs`.
+- Editar `bin/skill-master-menu.mjs` se necessario.
+- Editar `src/menu-core.test.ts`.
+- Documentar recomendacao de terminal.
+
+## Fora de escopo
+
+- Remover todo Unicode do menu premium.
+- Reescrever renderer.
+- Adicionar dependencia externa.
+- Publicar pacote.
+
+## Implementacao esperada
+
+Adicionar uma politica clara:
+
+- modo premium Unicode quando terminal suporta;
+- modo ASCII/low-glyph quando `TERM=dumb`, `SKILL_MASTER_ASCII=1`, codepage incompatível ou CI;
+- nunca imprimir raw escape/Unicode pesado em non-TTY.
+
+Sugestao:
+
+```text
+supportsUnicodeTerminal()
+resolveGlyphSet()
+renderSparkline(..., glyphSet)
+renderMeterBar(..., glyphSet)
+renderCyberFrame(..., glyphSet)
+```
+
+Fallback ASCII sugerido:
+
+```text
+block: #
+empty: .
+frame: + - |
+sparkline: . : - = #
+braille: . * + o
+```
+
+## Testes obrigatorios
+
+- `SKILL_MASTER_ASCII=1 node bin\skill-master-menu.mjs --help` nao contem caracteres mojibake.
+- `formatCyberMenuFrame` em modo ASCII nao excede largura.
+- modo padrao continua com visual premium.
+- non-TTY continua sem raw visual.
+
+## Validacao obrigatoria
+
+```powershell
+npm run check
+$env:SKILL_MASTER_ASCII='1'; node bin\skill-master-menu.mjs --help; Remove-Item Env:\SKILL_MASTER_ASCII
+$env:TERM='dumb'; node bin\skill-master-menu.mjs --status; Remove-Item Env:\TERM
+node scripts\render-menu-evidence.mjs
+```
+
+## Criterios de aceite
+
+- Terminais modernos mantem visual premium.
+- Ambientes limitados tem fallback legivel.
+- Testes cobrem glyph mode.
+- Nenhum mojibake novo aparece em help/status.
+
+## Formato da resposta final do executor
+
+- causa do risco:
+- fallback criado:
+- arquivos alterados:
+- validacao Windows:
+- validacao non-TTY:
+- riscos restantes:

package/docs/planning/mcp-1.0.0/prompt-tasks-nota-10-10/06_PROMPT_TASK_VISUAL_REGRESSION_QA.md

@@ -0,0 +1,105 @@
+# Prompt Task 06 - QA visual e regressao do menu
+
+Status: pronto para execucao
+Publicacao: proibida sem autorizacao explicita
+Branch sugerida: `test/menu-visual-regression`
+Commit recomendado: `test(menu): add visual regression coverage`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: criar uma camada de QA visual e funcional para impedir regressao do DNA refinado, do menu compacto, do running state e dos comandos non-TTY.
+
+## Diagnostico inicial obrigatorio
+
+```powershell
+git status --short
+npm run check
+rg -n "formatCyberMenuFrame|formatRunningActionFrame|formatSkillMasterIntroFrame|render-menu-evidence|verify:menu" src scripts package.json
+```
+
+## Contexto
+
+A nota 10/10 depende de o visual premium nao quebrar o menu. O QA deve proteger:
+
+- selected action visivel;
+- largura das linhas;
+- painel DNA renderizado;
+- help com automacao;
+- falhas esperadas sem TTY;
+- evidencias atualizadas.
+
+## Escopo permitido
+
+- Editar `src/menu-core.test.ts`.
+- Criar ou editar scripts de verificacao em `scripts/`.
+- Atualizar `package.json` apenas se criar script novo necessario.
+- Atualizar docs de QA.
+
+## Fora de escopo
+
+- Introduzir Playwright se nao for necessario.
+- Criar snapshots frageis enormes.
+- Testar publicacao npm.
+- Executar acoes globais mutaveis.
+
+## Implementacao esperada
+
+Adicionar testes para:
+
+- frame grande `120x32`;
+- frame compacto `96x24`;
+- terminal curto;
+- running state;
+- DNA hero se existir;
+- modo ASCII se implementado;
+- help sem TTY;
+- erros esperados de `prompt-router` sem `--prompt`;
+- `activate-learned-local --yes` sem draft pronto.
+
+Criar script opcional:
+
+```text
+scripts/verify-menu-visual.mjs
+```
+
+Ele deve:
+
+- gerar frames sem ANSI;
+- validar largura maxima;
+- validar presenca de paineis;
+- validar ausencia de versao antiga;
+- nao executar acoes mutaveis.
+
+## Validacao obrigatoria
+
+```powershell
+npm run check
+node scripts\verify-menu-actions.mjs
+node scripts\render-menu-evidence.mjs
+node bin\skill-master-menu.mjs --run prompt-router
+node bin\skill-master-menu.mjs --run activate-learned-local --yes
+```
+
+Se criar script novo:
+
+```powershell
+node scripts\verify-menu-visual.mjs
+```
+
+## Criterios de aceite
+
+- Regressao visual basica e detectavel por teste.
+- Nao ha snapshots gigantes e frageis.
+- Testes protegem terminal curto.
+- Falhas esperadas continuam claras.
+- `npm run check` passa.
+
+## Formato da resposta final do executor
+
+- cobertura adicionada:
+- scripts adicionados:
+- falhas esperadas testadas:
+- comandos executados:
+- riscos restantes:

package/docs/planning/mcp-1.0.0/prompt-tasks-nota-10-10/07_PROMPT_TASK_PRE_RELEASE_SCORE_GATE_10_10.md

@@ -0,0 +1,104 @@
+# Prompt Task 07 - Gate pre-release e nova nota 10/10
+
+Status: pronto para execucao
+Publicacao: proibida sem autorizacao explicita
+Branch sugerida: `release/menu-score-10-readiness`
+Commit recomendado: `docs(menu): add score 10 release readiness report`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: executar o gate final de qualidade para confirmar se o `skill-master-menu` atingiu nota `10/10`, documentar evidencias, riscos restantes e comandos para transferencia/publicacao futura sem publicar nada.
+
+## Diagnostico inicial obrigatorio
+
+```powershell
+git status --short
+npm run check
+node bin\skill-master-menu.mjs --status
+node scripts\render-menu-evidence.mjs
+```
+
+## Rubrica 10/10
+
+Atribua nota para cada area:
+
+- Funcionalidade do menu
+- Fluxos non-TTY e automacao
+- Mensagens de erro e confirmacao
+- Compatibilidade Windows/Linux/macOS
+- Testes e regressao
+- Visual cyberpunk pixel art
+- DNA visual comparado as referencias
+- Evidencia visual/documentacao
+- Prontidao para transferencia entre computadores
+
+Regra:
+
+- nenhuma area abaixo de `9.5`;
+- media final deve ser `10/10` apenas se nao houver pendencia critica;
+- se algo ficar abaixo, gerar nova task especifica.
+
+## Validacao obrigatoria
+
+```powershell
+git status --short
+npm run check
+node bin\skill-master-menu.mjs --status
+node bin\skill-master-menu.mjs --help
+node bin\skill-master-menu.mjs --run prompt-router --prompt "validar menu nota 10"
+node bin\skill-master-menu.mjs --run prompt-router
+node bin\skill-master-menu.mjs --run activate-learned-local --yes
+node bin\skill-master-menu.mjs --run notifications
+node bin\skill-master-menu.mjs --run public-npm
+node scripts\render-menu-evidence.mjs
+npm pack --dry-run
+```
+
+## Relatorio a criar
+
+Criar um arquivo em:
+
+```text
+MCP 1.0.0/09_RELATORIO_FINAL_MENU_NOTA_10_10.md
+```
+
+O relatorio deve conter:
+
+- nota anterior;
+- nota final;
+- comparativo antes/depois;
+- arquivos alterados;
+- evidencias visuais geradas;
+- comandos executados;
+- resultado de cada comando;
+- riscos restantes;
+- instrucoes para aplicar no outro computador;
+- confirmacao: nenhuma publicacao foi feita.
+
+## Fora de escopo
+
+- Nao publicar npm.
+- Nao criar tag.
+- Nao fazer release.
+- Nao alterar credenciais.
+- Nao executar bootstrap/register global sem pedido explicito.
+
+## Criterios de aceite
+
+- Relatorio final existe.
+- `npm run check` passa.
+- `npm pack --dry-run` passa.
+- Evidencias visuais foram atualizadas.
+- Nota final e justificada com criterios objetivos.
+- Se nao atingir 10/10, ha lista curta de bloqueadores e tasks novas.
+
+## Formato da resposta final do executor
+
+- nota final:
+- passou no gate: sim/nao:
+- relatorio criado:
+- comandos executados:
+- publicacao npm:
+- proximos passos:

package/docs/planning/mcp-1.0.0/prompt-tasks-nota-10-10/README_ORDEM_EXECUCAO_NOTA_10_10.md

@@ -0,0 +1,77 @@
+# Ordem de execucao - Prompt tasks nota 10/10
+
+Este pacote transforma a auditoria `08_AUDITORIA_CRITICA_MENU_NOTA_E_DNA_REFINADO.md` em tarefas executaveis para elevar o `skill-master-menu` de `8.4/10` para `10/10`.
+
+## Como usar
+
+No outro computador, abra uma nova conversa Codex no repo `skill-master-mcp` e comece colando o conteudo de:
+
+```text
+00_PROMPT_TASK_MASTER_NOTA_10_10.md
+```
+
+Depois execute as tasks na ordem abaixo.
+
+## Sequencia recomendada
+
+1. `00_PROMPT_TASK_MASTER_NOTA_10_10.md`
+
+Coordena todo o trabalho, define a rubrica 10/10 e protege contra publicacao acidental.
+
+2. `01_PROMPT_TASK_FINE_HELIX_DNA.md`
+
+Refina o DNA atual para uma helice fina, luminosa e menos blocada.
+
+3. `02_PROMPT_TASK_DNA_HERO_BOOT_AND_MOTION.md`
+
+Cria o momento visual de entrada com DNA hero, sem afetar non-TTY.
+
+4. `03_PROMPT_TASK_MENU_UX_HELP_ERROR_COPY.md`
+
+Melhora help, mensagens de erro, copy operacional e comandos de automacao.
+
+5. `04_PROMPT_TASK_EVIDENCE_RENDERER_1_0_0.md`
+
+Atualiza evidencias visuais para `1.0.0` e remove dados fake antigos.
+
+6. `05_PROMPT_TASK_CROSS_PLATFORM_UTF8_MOJIBAKE.md`
+
+Adiciona fallback/guardrails para Unicode, UTF-8 e terminais limitados.
+
+7. `06_PROMPT_TASK_VISUAL_REGRESSION_QA.md`
+
+Cria protecao de regressao visual e funcional.
+
+8. `07_PROMPT_TASK_PRE_RELEASE_SCORE_GATE_10_10.md`
+
+Executa o gate final, reatribui nota e cria o relatorio `09_RELATORIO_FINAL_MENU_NOTA_10_10.md`.
+
+## Regras globais
+
+- Nao publicar npm sem autorizacao explicita.
+- Nao criar tag/release sem autorizacao explicita.
+- Nao reescrever o menu inteiro.
+- Nao quebrar `--status`, `--help`, `--run`, `--prompt`, `--manifest`, `--yes`.
+- Nao executar acoes globais mutaveis sem confirmacao.
+- Rodar `npm run check` em cada task que alterar codigo.
+- Gerar evidencias visuais depois das tasks de UI.
+
+## Comando de validacao final esperado
+
+```powershell
+npm run check
+node scripts\render-menu-evidence.mjs
+npm pack --dry-run
+```
+
+## Resultado esperado
+
+Ao final, o menu deve ter:
+
+- visual DNA fino e premium;
+- intro hero refinada;
+- help mais escaneavel;
+- evidencia visual atualizada;
+- fallback para terminais limitados;
+- testes protegendo regressao;
+- relatorio final justificando nota `10/10`.

package/docs/prompt-tasks/PROMPT_TASK_001_BOOTSTRAP_SKILL_MASTER_MCP.md

@@ -1,6 +1,6 @@
-# Prompt Task 001 - Bootstrap do MCP Skill Master 00.01
-
-> STATUS: HISTORICO / EXECUCAO JA CONCLUIDA
->
-> Este prompt task pertence a fase inicial `00.01`.
-> Mantenha como referencia historica. Nao usar como fonte principal para novas instalacoes ou distribuicao atual.
+# Prompt Task 001 - Bootstrap do MCP Skill Master 00.01
+
+> STATUS: HISTORICO / EXECUCAO JA CONCLUIDA
+>
+> Este prompt task pertence a fase inicial `00.01`.
+> Mantenha como referencia historica. Nao usar como fonte principal para novas instalacoes ou distribuicao atual.

package/docs/prompt-tasks/PROMPT_TASK_002_AUTO_UPDATE_LAUNCHER.md

@@ -1,6 +1,6 @@
-# Prompt Task 002 - Launcher e Auto-Update Seguro
-
-> STATUS: HISTORICO / EXECUCAO JA INCORPORADA
->
-> Este prompt task pertence ao ciclo inicial de construcao.
-> O comportamento atual do auto-update deve ser consultado nos guias operacionais vigentes.
+# Prompt Task 002 - Launcher e Auto-Update Seguro
+
+> STATUS: HISTORICO / EXECUCAO JA INCORPORADA
+>
+> Este prompt task pertence ao ciclo inicial de construcao.
+> O comportamento atual do auto-update deve ser consultado nos guias operacionais vigentes.

package/docs/prompt-tasks/PROMPT_TASK_003_REMOTE_MANIFEST_AND_RELEASES.md

@@ -1,6 +1,6 @@
-# Prompt Task 003 - Manifestos Remotos, Releases e Canais
-
-> STATUS: HISTORICO / EXECUCAO PARCIALMENTE INCORPORADA
->
-> Este prompt task representa uma etapa de construcao da linha `00.01`.
-> O comportamento vigente deve ser consultado nos guias operacionais atuais.
+# Prompt Task 003 - Manifestos Remotos, Releases e Canais
+
+> STATUS: HISTORICO / EXECUCAO PARCIALMENTE INCORPORADA
+>
+> Este prompt task representa uma etapa de construcao da linha `00.01`.
+> O comportamento vigente deve ser consultado nos guias operacionais atuais.

package/docs/prompt-tasks/PROMPT_TASK_004_MULTI_USER_DISTRIBUTION.md

@@ -1,6 +1,6 @@
-# Prompt Task 004 - Distribuicao para Varios Usuarios
-
-> STATUS: HISTORICO / EXECUCAO JA INCORPORADA
->
-> Este prompt task registra a fase de estruturacao da distribuicao multiusuario.
-> Para distribuicao atual, use os guias atualizados de npm publico, multi-computador e compatibilidade de clientes.
+# Prompt Task 004 - Distribuicao para Varios Usuarios
+
+> STATUS: HISTORICO / EXECUCAO JA INCORPORADA
+>
+> Este prompt task registra a fase de estruturacao da distribuicao multiusuario.
+> Para distribuicao atual, use os guias atualizados de npm publico, multi-computador e compatibilidade de clientes.

package/docs/prompt-tasks/PROMPT_TASK_005_SECURITY_AND_QUALITY_GATE.md

@@ -1,6 +1,6 @@
-# Prompt Task 005 - Security and Quality Gate
-
-> STATUS: HISTORICO / REFERENCIA DE HARDENING
->
-> Este prompt task continua util como referencia de qualidade, mas pertence ao ciclo inicial `00.01`.
-> Nao substitui os checks, workflows e guias atualizados do repositorio.
+# Prompt Task 005 - Security and Quality Gate
+
+> STATUS: HISTORICO / REFERENCIA DE HARDENING
+>
+> Este prompt task continua util como referencia de qualidade, mas pertence ao ciclo inicial `00.01`.
+> Nao substitui os checks, workflows e guias atualizados do repositorio.