@fprad0/skill-master-mcp 0.0.12 → 1.0.1

package/docs/planning/mcp-1.0.0/08_AUDITORIA_CRITICA_MENU_NOTA_E_DNA_REFINADO.md

@@ -0,0 +1,184 @@
+# Auditoria critica do skill-master-menu, nota e DNA refinado
+
+Data: 2026-06-30
+Repositorio auditado: `C:\Users\CDT\Documents\F.Prado\skill-master-mcp-release-publish`
+Versao local: `@fprad0/skill-master-mcp@1.0.0`
+Referencia visual: DNA fino, luminoso, vertical, com particulas ciano/azul e acentos magenta.
+
+## Nota geral
+
+Nota final: 8.4/10
+
+O `skill-master-menu` esta funcionalmente forte, com boa separacao entre modo humano e modo automatizado, matriz de acoes completa, mensagens de erro bem melhores que a versao anterior e validacoes reais passando.
+
+O ponto que mais segura a nota e visual: o DNA atual ja comunica "cyber terminal", mas ainda parece uma matriz tecnica blocada. Ele ainda nao alcanca o refinamento fino, vertical, luminoso e organico das imagens anexadas.
+
+## Notas por area
+
+- Funcionalidade do menu: 9.2/10
+- Fluxos non-TTY e automacao: 9.0/10
+- Mensagens de erro e confirmacao: 8.7/10
+- Compatibilidade Windows/Linux/macOS: 8.6/10
+- Testes e regressao: 9.1/10
+- Visual cyberpunk pixel art: 7.4/10
+- DNA visual comparado as referencias: 6.8/10
+- Evidencia visual/documentacao: 7.0/10
+
+## Testes executados
+
+Todos os comandos abaixo foram executados na maquina atual.
+
+```powershell
+node bin\skill-master-menu.mjs --status
+node bin\skill-master-menu.mjs --help
+npm run verify:menu
+node scripts\render-menu-evidence.mjs
+node bin\skill-master-menu.mjs --run prompt-router --prompt "auditar skill-master-menu e refinar DNA visual"
+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
+npm run check
+```
+
+## Resultado dos testes
+
+- `--status`: passou.
+- `--help`: passou e mostra os fluxos de automacao com `--manifest`, `--yes` e `--prompt`.
+- `verify:menu`: passou com 23 acoes esperadas.
+- `render-menu-evidence`: passou e gerou HTMLs em `docs/operations/assets`.
+- `prompt-router --prompt`: passou.
+- `prompt-router` sem `--prompt`: falhou corretamente com mensagem acionavel.
+- `activate-learned-local --yes`: falhou corretamente porque nao ha draft pronto.
+- `notifications`: passou e indicou 0 drafts pendentes e 8 skills externas para estudo.
+- `public-npm`: passou e retornou `1.0.0`.
+- `npm run check`: passou com 17 arquivos de teste e 96 testes.
+
+## Pontos fortes
+
+- O menu esta seguro para automacao: `--run`, `--status`, `--help`, `--prompt`, `--manifest` e `--yes` estao bem encaminhados.
+- Acoes mutaveis importantes estao protegidas por confirmacao ou por caminho explicito.
+- A falha de ativacao sem draft pronto e boa: falha fechado e explica o proximo passo.
+- `Global readiness` esta forte: Codex, Claude, Gemini e Antigravity aparecem robustos.
+- A matriz do menu esta protegida por teste automatizado.
+- A renderizacao usa alternate screen e frames estaveis, boa base para baixo flicker.
+
+## Problemas e correcoes recomendadas
+
+1. O DNA visual ainda esta espesso demais.
+
+O renderer usa `plotBrailleThick` com espessura variavel e isso deixa a helice mais pesada que as referencias. A imagem anexada pede filamentos finos, mais "fibra luminosa", menos bloco.
+
+2. O DNA precisa de mais altura relativa.
+
+O painel `DNA-CORE` fica pequeno dentro do menu. A referencia e vertical e dominante. Mesmo mantendo o layout atual, o painel direito deveria favorecer uma helice mais alta, talvez reduzindo telemetria quando o terminal tiver altura suficiente.
+
+3. O fundo visual do DNA ainda e tecnico demais.
+
+Hoje existem pontos de matriz/grid. A referencia pede particulas finas, poeira luminosa, pequenas estrelas e glow. No terminal isso pode virar braille discreto com baixa prioridade e cor `blue/teal`, sem poluir.
+
+4. O script de evidencia visual esta desatualizado.
+
+`scripts/render-menu-evidence.mjs` ainda usa status fake `0.0.12`, `00.06` e total `66`, enquanto o menu real esta em `1.0.0` e bundle `69`. Isso nao quebra o menu, mas enfraquece a evidencia visual.
+
+5. Alguns caracteres aparecem com risco de mojibake em ambientes sem UTF-8.
+
+Na renderizacao HTML tudo parece aceitavel, mas no terminal/log alguns blocos podem aparecer como `â...` dependendo da codepage. Vale adicionar teste/normalizacao para Windows PowerShell legado ou documentar uso de Windows Terminal/UTF-8.
+
+6. O help poderia separar melhor "comando humano" e "comando de automacao".
+
+Hoje funciona, mas a leitura ainda fica longa. Uma secao "Automacao sem TTY" deixaria o operador mais rapido.
+
+## Ideias para deixar o DNA mais refinado
+
+1. Criar modo `fine-helix`.
+
+Adicionar uma variante visual em `dnaPanelLines` com:
+
+- strand thickness base `0` ou `1`, nunca `2+` por padrao;
+- rungs finos com menos pontos;
+- amplitude menor e mais elegante;
+- mais altura por ciclo;
+- menos preenchimento no centro.
+
+2. Trocar "dense helix" por "luminous helix".
+
+O DNA deve parecer luz, nao massa. Usar:
+
+- strand frontal em `teal/white`;
+- strand traseira em `blue/gray`;
+- pontos de energia em `rose` ou `violet`;
+- highlight magenta apenas nos cruzamentos.
+
+3. Adicionar particulas orbitais deterministicas.
+
+Criar pequenos pontos ao redor da helice:
+
+- seed derivado de `action.key`;
+- particulas com baixa prioridade;
+- movimento lento por `tick`;
+- sem random em runtime para evitar flicker.
+
+4. Usar profundidade visual por prioridade, nao por espessura.
+
+Em vez de engrossar a fita quando ela vem para frente, manter o fio fino e aumentar:
+
+- cor;
+- prioridade;
+- brilho pontual;
+- densidade de particulas proximas.
+
+5. Criar rungs alternados e curvos.
+
+As imagens mostram barras internas delicadas. O terminal pode simular isso com linhas curtas alternadas:
+
+- nao desenhar rung em todo `pairEvery`;
+- alternar comprimento conforme profundidade;
+- usar pontos centrais brilhantes nos cruzamentos.
+
+6. Dar ao painel DNA um estado "hero" no boot.
+
+Na introducao do `skill_master`, o DNA poderia ocupar a tela quase toda por 4 a 6 frames antes de entrar no menu. Isso entrega o impacto visual sem comprometer a densidade funcional do menu.
+
+7. Atualizar as evidencias visuais.
+
+Gerar evidencias para:
+
+- frame grande;
+- frame compacto;
+- estado running;
+- intro DNA hero;
+- comparativo `dense` vs `fine`.
+
+## Onde mexer
+
+- `bin/lib/menu-core.mjs`
+  - `dnaPanelLines`
+  - `renderBrailleCanvas`
+  - `plotBrailleThick`
+  - area de montagem do painel direito em `formatCyberMenuFrame`
+
+- `scripts/render-menu-evidence.mjs`
+  - atualizar status fake para `1.0.0`;
+  - gerar evidencia do novo DNA fino;
+  - exportar mais ticks para validar movimento.
+
+- `src/menu-core.test.ts`
+  - validar que o frame compacto ainda mostra selected action;
+  - validar que o DNA refinado aparece em terminal curto;
+  - validar que a evidencia nao usa versao antiga.
+
+## Prioridade de execucao recomendada
+
+1. Corrigir `scripts/render-menu-evidence.mjs` para refletir `1.0.0`.
+2. Criar `fine-helix` em `dnaPanelLines` sem remover o modo atual.
+3. Adicionar particulas deterministicas e highlights magenta/ciano.
+4. Melhorar layout do painel direito para deixar o DNA mais alto quando houver espaco.
+5. Adicionar smoke visual/teste para evitar regressao em terminal 96x24.
+6. Gerar novas imagens de evidencia e comparar com as referencias anexadas.
+
+## Veredito senior
+
+O menu esta pronto do ponto de vista operacional. Eu confiaria nele para uso diario e para transferencia entre maquinas.
+
+Para virar uma experiencia realmente premium, o proximo salto deve ser visual: menos "terminal matrix blocado", mais "DNA holografico fino". A base tecnica esta boa; agora o refinamento e uma questao de composicao, densidade, contraste e movimento.

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

@@ -0,0 +1,103 @@
+# Prompt Task Master - Elevar skill-master-menu para nota 10/10
+
+Status: pronto para execucao
+Publicacao: proibida sem autorizacao explicita
+Repositorio alvo: `skill-master-mcp`
+Versao base: `@fprad0/skill-master-mcp@1.0.0`
+Branch sugerida: `feature/menu-score-10-dna-refinement`
+Commit sugerido da implementacao final: `feat(menu): refine dna tui and release evidence`
+Commit sugerido destes prompt tasks: `docs(tasks): add menu score 10 prompt tasks`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: aplicar uma sequencia controlada de melhorias para elevar a nota geral do `skill-master-menu` de `8.4/10` para `10/10`, preservando o funcionamento atual, compatibilidade Windows/Linux/macOS, baixo flicker e seguranca operacional.
+
+Use sempre `skill_master_mcp` nas decisoes relevantes:
+
+```text
+Use skill_master_activation_check antes de iniciar.
+Use as skills: skill-master-orchestrator, terminal-menu-operations e terminal-pixel-art-tui.
+```
+
+## Contexto da auditoria
+
+Auditoria em 2026-06-30 apontou:
+
+- nota geral atual: `8.4/10`;
+- funcionalidade forte;
+- `npm run check` passou com 17 arquivos de teste e 96 testes;
+- `verify:menu` passou com 23 acoes;
+- readiness global pronta para Codex, Claude, Gemini e Antigravity;
+- principal deficit: DNA visual ainda grosso/blocado;
+- evidencias visuais ainda usam dados fake antigos em `scripts/render-menu-evidence.mjs`;
+- ha risco de mojibake em terminais Windows legados sem UTF-8.
+
+## Ordem obrigatoria dos prompt tasks
+
+Execute nesta ordem:
+
+1. `01_PROMPT_TASK_FINE_HELIX_DNA.md`
+2. `02_PROMPT_TASK_DNA_HERO_BOOT_AND_MOTION.md`
+3. `03_PROMPT_TASK_MENU_UX_HELP_ERROR_COPY.md`
+4. `04_PROMPT_TASK_EVIDENCE_RENDERER_1_0_0.md`
+5. `05_PROMPT_TASK_CROSS_PLATFORM_UTF8_MOJIBAKE.md`
+6. `06_PROMPT_TASK_VISUAL_REGRESSION_QA.md`
+7. `07_PROMPT_TASK_PRE_RELEASE_SCORE_GATE_10_10.md`
+
+## Regras obrigatorias
+
+- Responder em PT-BR.
+- Diagnosticar antes de implementar.
+- Nao publicar npm, tag, release ou pacote sem autorizacao explicita.
+- Nao reescrever o menu inteiro.
+- Nao remover o modo visual atual sem criar fallback.
+- Nao quebrar `--status`, `--help`, `--run`, `--prompt`, `--manifest` ou `--yes`.
+- Nao executar acoes globais mutaveis sem confirmacao ou `--yes`.
+- Nao executar `npm publish`.
+- Nao alterar tokens, `.npmrc`, credenciais ou arquivos de auth.
+- Preservar Windows, Linux e macOS.
+- Registrar descobertas novas em `.md`.
+
+## Definition of Done 10/10
+
+- `npm run check` passa.
+- `npm pack --dry-run` passa.
+- `node scripts/render-menu-evidence.mjs` gera evidencias atualizadas.
+- Evidencias visuais usam `1.0.0` e bundle atual, nao `0.0.12`.
+- DNA visual tem modo fino, vertical, luminoso e menos blocado.
+- Intro/boot tem momento DNA hero sem prejudicar comandos non-TTY.
+- Help separa claramente automacao sem TTY.
+- Erros de TTY/manifests/drafts continuam acionaveis.
+- Testes cobrem dimensoes, selected action, DNA refinado, help e falhas esperadas.
+- Relatorio final atribui nova nota e justifica item por item.
+
+## Validacao final 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
+```
+
+## Formato da resposta final do executor
+
+- nota anterior:
+- nota final:
+- solucao aplicada:
+- arquivos alterados:
+- evidencias geradas:
+- comandos executados:
+- validacao visual:
+- validacao funcional:
+- riscos restantes:
+- publicacao npm: nao executada, salvo autorizacao explicita do usuario.

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

@@ -0,0 +1,116 @@
+# Prompt Task 01 - DNA fine helix refinado
+
+Status: pronto para execucao
+Publicacao: proibida sem autorizacao explicita
+Branch sugerida: `feature/menu-fine-helix-dna`
+Commit recomendado: `feat(menu): add fine helix dna renderer`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: refinar o painel `DNA-CORE` do `skill-master-menu` para aproximar das referencias visuais de DNA fino, vertical, luminoso, ciano/azul com acentos magenta, sem perder legibilidade nem estabilidade de terminal.
+
+## Diagnostico inicial obrigatorio
+
+Antes de editar:
+
+```powershell
+git status --short
+rg -n "function dnaPanelLines|plotBrailleThick|renderBrailleCanvas|DNA CYBER HELIX" bin\lib\menu-core.mjs src\menu-core.test.ts
+npm run check
+node scripts\render-menu-evidence.mjs
+```
+
+## Contexto
+
+A auditoria apontou:
+
+- DNA atual e reconhecivel, mas grosso/blocado;
+- o visual parece mais matriz tecnica que DNA holografico;
+- `plotBrailleThick` e a espessura dinamica deixam a fita pesada;
+- as referencias pedem fios finos, pontos de luz, espaco negativo e verticalidade.
+
+## Escopo permitido
+
+- Editar `bin/lib/menu-core.mjs`.
+- Editar `src/menu-core.test.ts`.
+- Atualizar docs de evidencia se necessario.
+- Criar helpers pequenos e locais para o renderer.
+
+## Fora de escopo
+
+- Reescrever o menu inteiro.
+- Adicionar dependencia TUI externa.
+- Remover o renderer atual sem fallback.
+- Alterar acoes do menu, aliases ou comportamento non-TTY.
+- Publicar pacote.
+
+## Implementacao esperada
+
+Criar ou evoluir uma variante `fine-helix` dentro de `dnaPanelLines`:
+
+- strand thickness base `0` ou `1`;
+- evitar `strandAWidth` e `strandBWidth` acima de `1` no modo fino;
+- reduzir preenchimento central;
+- usar amplitude mais elegante e menos quadrada;
+- tornar a helice mais alta dentro do painel;
+- rungs internos mais delicados, menos frequentes e com menor espessura;
+- manter movimento deterministico por `tick`;
+- usar profundidade por cor/prioridade, nao por massa;
+- preservar `fitText` e largura das linhas.
+
+## Direcao visual
+
+Paleta recomendada:
+
+- fio frontal: `teal` e `white`;
+- fio traseiro: `blue` e `gray`;
+- pontos de energia: `rose` e `violet`;
+- highlights raros: `white`;
+- evitar excesso de `amber` no DNA.
+
+Texto do painel:
+
+```text
+DNA CYBER HELIX / <area>
+luminous fine helix / low flicker
+```
+
+## Testes obrigatorios
+
+Adicionar ou ajustar testes para garantir:
+
+- `formatCyberMenuFrame` ainda contem `DNA CYBER HELIX`;
+- o frame contem `luminous fine helix`;
+- o frame compacto ainda mostra selected action;
+- nenhuma linha excede a largura esperada;
+- o DNA aparece em terminal curto `96x24`;
+- `npm run check` passa.
+
+## Validacao obrigatoria
+
+```powershell
+npm run check
+node scripts\render-menu-evidence.mjs
+node bin\skill-master-menu.mjs --help
+node bin\skill-master-menu.mjs --run prompt-router --prompt "validar fine helix"
+```
+
+## Criterios de aceite
+
+- O DNA parece mais fino e luminoso nas evidencias.
+- O menu continua legivel em `120x32` e `96x24`.
+- A telemetria e o selected action continuam visiveis.
+- Nao ha flicker novo em non-TTY.
+- Nenhum comando funcional regressa.
+
+## Formato da resposta final do executor
+
+- causa raiz visual:
+- solucao aplicada:
+- arquivos alterados:
+- evidencia visual gerada:
+- comandos executados:
+- nota DNA antes/depois:
+- riscos restantes:

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

@@ -0,0 +1,109 @@
+# Prompt Task 02 - DNA hero no boot e movimento premium
+
+Status: pronto para execucao
+Publicacao: proibida sem autorizacao explicita
+Branch sugerida: `feature/menu-dna-hero-boot`
+Commit recomendado: `feat(menu): add dna hero boot sequence`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: criar uma experiencia de entrada mais premium para o `skill-master-menu`, com um momento `DNA hero` na introducao visual do `skill_master`, preservando baixo flicker e sem afetar comandos non-TTY.
+
+## Diagnostico inicial obrigatorio
+
+```powershell
+git status --short
+rg -n "animateIntro|formatSkillMasterIntroFrame|formatRunningActionFrame|dnaPanelLines|visualHudAllowed" bin
+npm run check
+```
+
+## Contexto
+
+A auditoria recomendou que o DNA ocupe a tela quase toda por 4 a 6 frames no boot. Isso entrega impacto visual sem transformar o menu principal em uma tela decorativa pesada.
+
+## Escopo permitido
+
+- Editar `bin/skill-master-menu.mjs`.
+- Editar `bin/lib/menu-core.mjs`.
+- Editar `src/menu-core.test.ts`.
+- Editar `scripts/render-menu-evidence.mjs`.
+
+## Fora de escopo
+
+- Rodar visual em non-TTY.
+- Alterar fluxo MCP stdio.
+- Aumentar muito o tempo de boot.
+- Adicionar dependencia externa.
+- Publicar pacote.
+
+## Implementacao esperada
+
+Adicionar um frame de intro tipo `DNA hero`:
+
+- usa o mesmo canvas braille do DNA refinado;
+- ocupa mais largura/altura que o painel lateral;
+- dura 4 a 6 frames;
+- cada frame fica entre 180ms e 260ms;
+- nao limpa a tela de forma agressiva;
+- usa alternate screen e restaura cursor em `finally`;
+- desliga automaticamente quando `SKILL_MASTER_NO_VISUAL=1`, `CI=true`, `TERM=dumb` ou sem TTY.
+
+Sugestao de funcoes:
+
+```text
+formatSkillMasterDnaHeroFrame
+renderDnaHero
+animateDnaHeroIntro
+```
+
+## Regras de movimento
+
+- Movimento deve ser previsivel, nao aleatorio.
+- Particulas devem derivar de seed deterministico.
+- Fios devem parecer escanear de baixo para cima ou cima para baixo.
+- A animacao nao pode mudar o tamanho dos paineis.
+
+## Testes obrigatorios
+
+- Testar que `formatSkillMasterDnaHeroFrame` renderiza frame nao vazio.
+- Testar largura maxima sem ANSI.
+- Testar que textos-chave aparecem: `SKILL_MASTER`, `DNA`, `ONLINE`.
+- Testar que non-TTY nao imprime raw visual.
+- Manter testes existentes verdes.
+
+## Validacao obrigatoria
+
+```powershell
+npm run check
+node scripts\render-menu-evidence.mjs
+node bin\skill-master-menu.mjs --status
+node bin\skill-master-menu.mjs --run prompt-router --prompt "validar intro dna hero"
+```
+
+Teste manual recomendado:
+
+```powershell
+node bin\skill-master-menu.mjs
+```
+
+Abrir, observar 5 segundos, navegar com setas, sair com `q`.
+
+## Criterios de aceite
+
+- Boot visual fica mais marcante e refinado.
+- Non-TTY continua limpo e previsivel.
+- Cursor e tela sempre sao restaurados.
+- O menu principal abre normalmente depois do hero.
+- `npm run check` passa.
+
+## Formato da resposta final do executor
+
+- solucao aplicada:
+- arquivos alterados:
+- tempo de intro:
+- evidencias geradas:
+- teste manual TTY:
+- validacao non-TTY:
+- riscos restantes:

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

@@ -0,0 +1,99 @@
+# Prompt Task 03 - UX do help, erros e comandos de automacao
+
+Status: pronto para execucao
+Publicacao: proibida sem autorizacao explicita
+Branch sugerida: `feature/menu-help-error-polish`
+Commit recomendado: `fix(menu): clarify automation help and error copy`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: melhorar a clareza do `--help`, dos headers de acao e das mensagens de erro do `skill-master-menu`, para que um operador entenda rapidamente o que e humano, o que e automacao sem TTY, o que escreve local/global e qual proximo comando usar.
+
+## Diagnostico inicial obrigatorio
+
+```powershell
+git status --short
+node bin\skill-master-menu.mjs --help
+node bin\skill-master-menu.mjs --run prompt-router
+node bin\skill-master-menu.mjs --run activate-learned-local --yes
+rg -n "formatHelp|formatActionHeader|validateRunAction|automationHint|confirmMessage" bin src
+```
+
+## Contexto
+
+A auditoria indicou que o help funciona, mas ainda e longo. A nota 10/10 exige leitura mais rapida para operadores e IAs:
+
+- separar modo humano de automacao sem TTY;
+- destacar comandos seguros de diagnostico;
+- destacar comandos que escrevem local/global;
+- manter mensagens de erro acionaveis.
+
+## Escopo permitido
+
+- Editar `bin/skill-master-menu.mjs`.
+- Editar `bin/lib/menu-core.mjs`.
+- Editar `src/menu-core.test.ts`.
+- Atualizar docs se necessario.
+
+## Fora de escopo
+
+- Alterar comportamento funcional ja validado.
+- Remover confirmacoes.
+- Executar bootstrap, update global ou register clients.
+- Publicar pacote.
+
+## Implementacao esperada
+
+Reorganizar `formatHelp(commands)` com secoes:
+
+```text
+Uso humano
+Automacao sem TTY
+Diagnostico seguro
+Acoes que escrevem no workspace
+Acoes globais ou de risco alto
+Acoes disponiveis
+```
+
+Melhorar mensagens:
+
+- `promptRecommendation` sem `--prompt`: mostrar comando exato.
+- `activateLearnedLocal/Global` sem TTY: mostrar `--manifest <manifest.json> --yes`.
+- 0 drafts prontos: orientar `--approval-package` e `--list`.
+- 2+ drafts prontos: listar manifests e pedir selecao explicita.
+
+## Testes obrigatorios
+
+- `formatHelp` contem `Automacao sem TTY`.
+- `formatHelp` contem comandos `--manifest`, `--prompt`, `--yes`.
+- erro de prompt-router sem prompt contem comando exato.
+- erro de ativacao sem draft pronto continua claro.
+- `npm run check` passa.
+
+## Validacao obrigatoria
+
+```powershell
+npm run check
+node bin\skill-master-menu.mjs --help
+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
+```
+
+## Criterios de aceite
+
+- Help fica mais escaneavel.
+- Nenhuma acao perigosa parece segura por engano.
+- Mensagens indicam proximo comando concreto.
+- Non-TTY continua sem prompts interativos.
+
+## Formato da resposta final do executor
+
+- problema de UX encontrado:
+- copy ajustada:
+- arquivos alterados:
+- testes adicionados:
+- validacao executada:
+- risco restante: