@fprad0/skill-master-mcp 0.0.12 → 1.0.0

package/docs/prompt-tasks/PROMPT_TASK_009_PIPELINE_APRENDIZADO_SUCESSO.md

@@ -1,105 +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.
+# 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

@@ -1,119 +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.
+# 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

@@ -1,120 +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.
+# 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.