@fprad0/skill-master-mcp 0.0.11 → 1.0.0

package/docs/prompt-tasks/PROMPT_TASK_008_PROMPT_ROUTER_MODOS_ATIVACAO.md

@@ -0,0 +1,156 @@
+# Prompt Task 008 - Prompt router e modos de ativacao
+
+Status: concluido localmente em 2026-06-27
+Publicacao: proibida sem autorizacao explicita
+
+## Objetivo
+
+Implementar o roteador de ativacao do Skill Master, com modos `manual`, `balanced` e `always-on-assisted`.
+
+O roteador deve decidir se o Skill Master deve participar do prompt, quais skills recomendar, qual persona aplicar e quais bloqueios de seguranca existem.
+
+## Arquivos provaveis
+
+```text
+src/prompt-router.ts
+src/prompt-router.test.ts
+src/index.ts
+src/types.ts
+bin/lib/menu-core.mjs
+README.md
+```
+
+## Tool MCP proposta
+
+Nome:
+
+```text
+skill_master_prompt_router
+```
+
+Entrada:
+
+```json
+{
+  "prompt": "texto do usuario",
+  "activationMode": "manual|balanced|always-on-assisted",
+  "projectContext": "opcional",
+  "availableSkills": [],
+  "riskTolerance": "low|normal|high"
+}
+```
+
+Saida:
+
+```json
+{
+  "shouldActivate": true,
+  "activationReason": "mencao direta ou tarefa tecnica",
+  "recommendedSkills": [],
+  "personaOverlay": "Dev Senior Master",
+  "executionMode": "plan|assist|block|no-op",
+  "safetyGates": [],
+  "learningOpportunity": false,
+  "notionUpdateNeeded": false,
+  "nextAction": "string curta"
+}
+```
+
+## Heuristicas minimas
+
+Acionar sempre quando o prompt contiver:
+
+- `skill-master`;
+- `skill_master`;
+- `skill-master-mcp`;
+- "use o skill";
+- "crie uma skill";
+- "aprenda com isso";
+- "atualize o Notion";
+- "pesquise e implemente";
+- "publique";
+- "valide npm";
+- "melhore o MCP".
+
+Nao acionar em modo `balanced` quando:
+
+- for pergunta casual;
+- for traducao simples;
+- for formatacao pequena;
+- for horario/data simples;
+- nao houver ganho claro de skill.
+
+Em `always-on-assisted`, pode acionar como avaliador silencioso, mas deve retornar `executionMode: no-op` se nao houver ganho.
+
+## Testes obrigatorios
+
+Criar fixtures com:
+
+- mencao direta;
+- tarefa tecnica clara;
+- tarefa de Notion;
+- tarefa de aprendizado;
+- tarefa simples que nao deve acionar;
+- tarefa perigosa que deve bloquear publicacao sem autorizacao.
+
+Rodar:
+
+```bash
+npm run check
+```
+
+## Resultado esperado
+
+- Router implementado.
+- Tool MCP registrada.
+- Testes cobrindo positivo, negativo e risco.
+- Sem publicacao.
+
+## Resultado da execucao em 2026-06-27
+
+Implementado:
+
+- modulo `src/prompt-router.ts`;
+- teste `src/prompt-router.test.ts`;
+- tool MCP `skill_master_prompt_router`;
+- diagnostico adicional em `skill_master_list_sources`;
+- documentacao de uso no `README.md`.
+
+Contrato entregue:
+
+- modos `manual`, `balanced` e `always-on-assisted`;
+- persona `Dev Senior Master`;
+- `executionMode` com `plan`, `assist`, `block` e `no-op`;
+- gates de seguranca para publicacao, segredos, comandos destrutivos, Notion e skills aprendidas;
+- deteccao de oportunidade de aprendizado;
+- deteccao de necessidade de atualizar Notion;
+- bloqueio quando houver publicacao sem autorizacao explicita.
+
+Validacao:
+
+```bash
+npm run check
+```
+
+Resultado:
+
+- build TypeScript passou;
+- `8` arquivos de teste passaram;
+- `39` testes passaram;
+- manifestos `stable` e `beta` validos.
+
+Smoke MCP local via stdio:
+
+- `tools/list` confirmou `skill_master_prompt_router`;
+- `skill_master_refresh_catalog` retornou `45` skills;
+- contagem do catalogo: `7` skills de workspace e `38` locais;
+- `skill_master_prompt_router` recomendou `skill-master-orchestrator` como primeira skill;
+- `executionMode` retornou `assist` para prompt local com restricao `sem publicar`;
+- gate `publication_explicitly_disabled` confirmou que `sem publicar` e restricao local, nao autorizacao de release.
+
+Observacao operacional:
+
+- o codigo local ja registra `skill_master_prompt_router`;
+- o MCP ativo da sessao anterior estava com `workspaceRoots: []`;
+- o smoke local reiniciado com `SKILL_MASTER_CONFIG` e `SKILL_MASTER_WORKSPACE` apontando para este repositorio confirmou `workspaceRoots` e skill de workspace funcionando;
+- para o cliente MCP principal usar isso, ele precisa ser reiniciado apontando para a versao local atualizada ou receber uma proxima versao publicada somente apos autorizacao explicita.

package/docs/prompt-tasks/PROMPT_TASK_009_PIPELINE_APRENDIZADO_SUCESSO.md

@@ -0,0 +1,105 @@
+# Prompt Task 009 - Pipeline de aprendizado de implementacoes bem-sucedidas
+
+Status: concluido localmente em 2026-06-27
+Publicacao: proibida sem autorizacao explicita
+
+## Objetivo
+
+Evoluir o fluxo de sucesso existente para transformar implementacoes comprovadamente bem-sucedidas em skills candidatas, com aprovacao humana antes de ativacao local ou global.
+
+## Arquivos base
+
+```text
+src/success-learning.ts
+src/success-learning.test.ts
+bin/skill-master-success-skills.mjs
+network/approved-skills.json
+network/unapproved-skill-candidates.json
+docs/architecture/APRENDIZADO_DE_IMPLEMENTACOES_BEM_SUCEDIDAS.md
+```
+
+## Modelo de evidencia
+
+Cada aprendizado deve registrar:
+
+- titulo;
+- problema resolvido;
+- contexto do projeto;
+- data;
+- evidencias de sucesso;
+- comandos executados;
+- arquivos relevantes;
+- testes passados;
+- decisao do usuario;
+- riscos;
+- quando usar;
+- quando nao usar;
+- fonte local ou externa;
+- status de aprovacao.
+
+## Fluxo
+
+1. Capturar sucesso.
+2. Redigir resumo do padrao.
+3. Verificar se ha segredo/token.
+4. Verificar se o padrao ja existe.
+5. Gerar skill candidata.
+6. Salvar como pendente.
+7. Mostrar no menu.
+8. Permitir aprovar local, aprovar global, manter para estudo ou rejeitar.
+9. Registrar decisao no Notion.
+
+## Regras de seguranca
+
+- Nunca incluir tokens, senhas, cookies ou `.env`.
+- Nunca aprovar fonte web automaticamente.
+- Nunca ativar global sem confirmacao humana.
+- Nunca sobrescrever skill existente sem backup ou confirmacao.
+- Sempre manter link de origem e evidencia.
+
+## Testes obrigatorios
+
+- sucesso local vira candidato pendente;
+- candidato com segredo e bloqueado;
+- candidato duplicado e detectado;
+- aprovacao local escreve no local certo;
+- aprovacao global exige flag explicita;
+- rejeicao mantem historico;
+- Notion update e recomendado quando decisao muda.
+
+Rodar:
+
+```bash
+npm run check
+```
+
+## Resultado esperado
+
+- Pipeline implementado.
+- Menu consegue mostrar pendencias.
+- Skills candidatas ficam separadas das aprovadas.
+- Sem publicacao.
+
+## Resultado da execucao em 2026-06-27
+
+Implementado/validado:
+
+- pipeline `src/success-learning.ts` para gerar draft de skill aprendida;
+- revisao de evidencia, duplicidade, risco e candidatos externos;
+- pacote de aprovacao humana;
+- ativacao local/global somente com confirmacao explicita;
+- CLI `skill-master-success-skills`;
+- decisao `study` para manter skill candidata como material de estudo;
+- decisao `rejected` preservando historico;
+- recomendacao de atualizacao no Notion quando uma decisao muda;
+- menu com acoes de notificacao, estudo, pacote de aprovacao, ativacao local/global, manter para estudo e rejeitar.
+
+Validacao:
+
+- `npm run check` passou;
+- `src/success-learning.test.ts` passou com `7` testes;
+- `node bin/skill-master-success-skills.mjs --help` passou.
+
+Publicacao:
+
+- nenhuma publicacao, tag, release ou push executado.

package/docs/prompt-tasks/PROMPT_TASK_010_EVALS_GOVERNANCA_ATIVACAO.md

@@ -0,0 +1,119 @@
+# Prompt Task 010 - Evals, governanca e seguranca de ativacao
+
+Status: concluido localmente em 2026-06-27
+Publicacao: proibida sem autorizacao explicita
+
+## Objetivo
+
+Criar uma suite de avaliacoes para provar que a ativacao automatica do Skill Master e util, segura e controlada antes de qualquer release publica.
+
+## Arquivos provaveis
+
+```text
+src/prompt-router.test.ts
+src/activation.test.ts
+src/success-learning.test.ts
+docs/architecture/PLANO_MASTER_ACIONAMENTO_AUTOMATICO_E_APRENDIZADO.md
+docs/research/PESQUISA_ACIONAMENTO_AUTOMATICO_E_APRENDIZADO_SKILL_MASTER_2026-06-27.md
+```
+
+## Categorias de eval
+
+### Positivos obrigatorios
+
+- mencao direta a `skill-master`;
+- pedido de criar skill;
+- pedido de usar skill existente;
+- pedido de atualizar Notion;
+- pedido de pesquisar na web e implementar;
+- pedido de aprender com sucesso;
+- pedido de melhorar MCP;
+- pedido de validar npm/release.
+
+### Negativos obrigatorios
+
+- traducao curta;
+- pergunta casual;
+- horario/data simples;
+- ajuste de frase;
+- resposta conceitual curta sem necessidade de repo.
+
+### Risco obrigatorio
+
+- publicar pacote;
+- apagar arquivos;
+- mexer em token;
+- instalar pacote global;
+- aprovar skill externa;
+- executar comando destrutivo;
+- transformar web em skill ativa.
+
+## Metricas
+
+- precisao minima em `balanced`: 85%;
+- falso positivo maximo em prompts simples: 10%;
+- falso negativo maximo em prompts tecnicos: 15%;
+- bloqueio obrigatorio para publicacao sem autorizacao: 100%;
+- bloqueio obrigatorio para segredo/token: 100%;
+
+## Saida esperada da avaliacao
+
+Gerar relatorio com:
+
+- total de casos;
+- acertos;
+- falsos positivos;
+- falsos negativos;
+- bloqueios corretos;
+- casos ambiguos;
+- recomendacao de modo padrao.
+
+## Validacao
+
+```bash
+npm run check
+```
+
+Se criar script especifico:
+
+```bash
+npm run eval:activation
+```
+
+## Resultado esperado
+
+- Evals automatizados.
+- Gates de seguranca testados.
+- Relatorio local.
+- Sem publicacao.
+
+## Resultado da execucao em 2026-06-27
+
+Implementado:
+
+- `src/activation-evals.ts`;
+- `src/activation-evals.test.ts`;
+- `bin/skill-master-eval-activation.mjs`;
+- script `npm run eval:activation`;
+- gates adicionais no router para `npm install -g`, skill externa e skill da web;
+- relatorio local com total, acertos, falsos positivos, falsos negativos, bloqueios corretos e recomendacao de modo.
+
+Resultado do eval:
+
+- total: `19` casos;
+- acertos: `19`;
+- falhas: `0`;
+- precisao: `100%`;
+- falsos positivos: `0`;
+- falsos negativos: `0`;
+- bloqueios corretos: `2`;
+- recomendacao: `balanced-ready`.
+
+Validacao:
+
+- `npm run check` passou;
+- `npm run eval:activation` passou.
+
+Publicacao:
+
+- nenhuma publicacao, tag, release ou push executado.

package/docs/prompt-tasks/PROMPT_TASK_011_MENU_NOTIFICACOES_NOTION.md

@@ -0,0 +1,120 @@
+# Prompt Task 011 - Menu, notificacoes e ledger Notion
+
+Status: concluido localmente em 2026-06-27
+Publicacao: proibida sem autorizacao explicita
+
+## Objetivo
+
+Melhorar o menu do Skill Master para mostrar o estado de ativacao, pendencias de skills, candidatos de aprendizado e proximas acoes. O menu deve ajudar o usuario a decidir, nao interromper o trabalho.
+
+## Arquivos provaveis
+
+```text
+bin/skill-master-menu.mjs
+bin/lib/menu-core.mjs
+src/menu-core.test.ts
+bin/skill-master-success-skills.mjs
+README.md
+docs/architecture/PLANO_MASTER_ACIONAMENTO_AUTOMATICO_E_APRENDIZADO.md
+```
+
+## Notificacoes desejadas
+
+Mostrar no topo do menu:
+
+- modo de ativacao atual;
+- quantidade de skills candidatas aguardando aprovacao;
+- quantidade de skills para estudar;
+- ultima verificacao de catalogo;
+- se ha recomendacao de atualizar Notion;
+- se ha release pendente de autorizacao.
+
+## Acoes do menu
+
+Adicionar opcoes:
+
+- alterar modo de ativacao;
+- ver recomendacao para um prompt;
+- ver skills candidatas;
+- aprovar skill local;
+- aprovar skill global;
+- manter skill para estudo;
+- rejeitar candidata;
+- gerar pacote de aprovacao humana;
+- abrir resumo para Notion;
+
+## Regras de UX no terminal
+
+- Usar blocos curtos e escaneaveis.
+- Priorizar cores/labels somente se suportado sem quebrar Windows/Linux.
+- Sempre oferecer comando alternativo nao interativo.
+- Nao repetir alerta se nao houver mudanca de estado.
+- Separar "informativo" de "acao necessaria".
+
+## Notion
+
+Ao final de mudancas relevantes, atualizar uma pagina de continuidade com:
+
+- o que foi implementado;
+- o que foi testado;
+- pendencias;
+- candidatos aprovados/reprovados;
+- se publicacao esta bloqueada aguardando autorizacao.
+
+## Validacao
+
+```bash
+npm run check
+node bin/skill-master-menu.mjs --help
+node bin/skill-master-success-skills.mjs --help
+```
+
+## Resultado esperado
+
+- Menu mostra status util.
+- Notificacoes nao invasivas.
+- Fluxo de aprovacao fica acessivel.
+- Notion atualizado.
+- Sem publicacao.
+
+## Resultado da execucao em 2026-06-27
+
+Implementado/validado:
+
+- menu visual com painel de status;
+- notificacoes de drafts de skills aprendidas;
+- lista de skills externas para estudo;
+- geracao de pacote de aprovacao humana;
+- ativacao de skill aprendida local/global;
+- novas acoes de modo de ativacao;
+- recomendacao interativa para prompt;
+- manter skill candidata para estudo;
+- rejeitar skill candidata preservando historico;
+- resumo para Notion;
+- CLI `skill-master-activation`.
+
+Acoes de menu relevantes:
+
+```bash
+skill-master-menu --run activation-status
+skill-master-menu --run set-balanced
+skill-master-menu --run set-always-on
+skill-master-menu --run prompt-router
+skill-master-menu --run notifications
+skill-master-menu --run study-skills
+skill-master-menu --run approval-package
+skill-master-menu --run mark-study
+skill-master-menu --run reject-skill
+skill-master-menu --run notion-summary
+```
+
+Validacao:
+
+- `npm run check` passou;
+- `node bin/skill-master-menu.mjs --help` passou;
+- `node bin/skill-master-success-skills.mjs --help` passou;
+- `node bin/skill-master-activation.mjs --help` passou.
+
+Publicacao:
+
+- nenhuma publicacao, tag, release ou push executado.

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.
+