@fprad0/skill-master-mcp 0.0.10 → 0.0.12

package/docs/prompt-tasks/PROMPT_TASK_005_SECURITY_AND_QUALITY_GATE.md

@@ -0,0 +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.

package/docs/prompt-tasks/PROMPT_TASK_006_MASTER_ACIONAMENTO_APRENDIZADO.md

@@ -0,0 +1,83 @@
+# Prompt Task 006 - Plano master de acionamento e aprendizado
+
+Status: concluido localmente em 2026-06-27
+Publicacao: proibida sem autorizacao explicita
+
+## Objetivo
+
+Executar a fase de planejamento da proxima linha do `skill-master-mcp`: acionamento automatico, persona `Dev Senior Master`, aprendizado a partir de implementacoes bem-sucedidas, aprovacao humana e Notion como ledger.
+
+## Contexto obrigatorio
+
+Repositorio:
+
+```text
+/home/dev/Área de trabalho/VSCODE/skill-master-mcp
+```
+
+Arquivos base:
+
+```text
+docs/research/PESQUISA_ACIONAMENTO_AUTOMATICO_E_APRENDIZADO_SKILL_MASTER_2026-06-27.md
+docs/architecture/PLANO_MASTER_ACIONAMENTO_AUTOMATICO_E_APRENDIZADO.md
+docs/architecture/APRENDIZADO_DE_IMPLEMENTACOES_BEM_SUCEDIDAS.md
+docs/prompt-tasks/PROMPT_TASK_007_PERSONA_ORQUESTRADORA.md
+docs/prompt-tasks/PROMPT_TASK_008_PROMPT_ROUTER_MODOS_ATIVACAO.md
+docs/prompt-tasks/PROMPT_TASK_009_PIPELINE_APRENDIZADO_SUCESSO.md
+docs/prompt-tasks/PROMPT_TASK_010_EVALS_GOVERNANCA_ATIVACAO.md
+docs/prompt-tasks/PROMPT_TASK_011_MENU_NOTIFICACOES_NOTION.md
+```
+
+## Regras duras
+
+- Nao publicar pacote.
+- Nao rodar `npm publish`.
+- Nao criar tag.
+- Nao fazer push se houver mudancas nao revisadas.
+- Nao apagar alteracoes existentes do usuario.
+- Usar `skill_master` para recomendacao quando disponivel.
+- Atualizar Notion ao final se houver alteracao de estado relevante.
+
+## Execucao
+
+1. Rodar `git status --short`.
+2. Ler os dois documentos principais de pesquisa e plano.
+3. Confirmar se os prompts 007 a 011 ainda representam a ordem correta.
+4. Se necessario, ajustar os prompts antes de iniciar implementacao.
+5. Criar/atualizar uma pagina Notion de planejamento, como filha do hub atual do Skill Master.
+6. Registrar no final quais fases estao prontas, bloqueadas ou pendentes.
+
+## Validacao
+
+```bash
+git status --short
+```
+
+Se apenas documentos forem alterados, `npm run check` e opcional. Se qualquer codigo for alterado, rodar:
+
+```bash
+npm run check
+```
+
+## Resultado esperado
+
+- Plano master salvo localmente.
+- Planejamento salvo no Notion.
+- Prompts de execucao organizados.
+- Proxima fase claramente indicada.
+
+## Resultado da execucao em 2026-06-27
+
+Concluido:
+
+- pesquisa e plano master salvos localmente;
+- pagina Notion de planejamento criada/atualizada;
+- prompts `007` a `011` organizados como fases de execucao;
+- ordem validada: `007` persona, `008` router, `009` aprendizado, `010` evals, `011` menu/Notion;
+- regra de nao publicacao preservada.
+
+Evidencia final:
+
+- `npm run check` passou;
+- `npm run eval:activation` passou;
+- Notion atualizado ao final das mudancas relevantes.

package/docs/prompt-tasks/PROMPT_TASK_007_PERSONA_ORQUESTRADORA.md

@@ -0,0 +1,88 @@
+# Prompt Task 007 - Persona Dev Senior Master e skill orquestradora
+
+Status: concluido localmente em 2026-06-27
+Publicacao: proibida sem autorizacao explicita
+
+## Objetivo
+
+Criar uma skill local de orquestracao para ativar o comportamento `Dev Senior Master` em tarefas tecnicas. Essa skill deve orientar o agente a usar o Skill Master, recomendar skills existentes, respeitar aprovacao humana e registrar aprendizados relevantes.
+
+## Persona
+
+Nome: `Dev Senior Master`
+
+Comportamento:
+
+- agir como desenvolvedor senior master, engenheiro senior master e arquiteto pragmatico;
+- ler o repositorio antes de concluir;
+- separar planejamento, implementacao, validacao e publicacao;
+- validar com comandos reais;
+- nunca publicar para todos sem autorizacao;
+- preservar alteracoes do usuario;
+- registrar decisoes relevantes no Notion;
+- tratar fontes externas como nao aprovadas ate revisao;
+- transformar sucesso comprovado em candidato de skill, nao em skill ativa automatica.
+
+## Arquivos provaveis
+
+Criar no projeto:
+
+```text
+.codex/skills/skill-master-orchestrator/SKILL.md
+.codex/skills/skill-master-orchestrator/references/persona-dev-senior-master.md
+.codex/skills/skill-master-orchestrator/references/activation-policy.md
+.codex/skills/skill-master-orchestrator/references/human-approval-policy.md
+```
+
+Opcional, somente se o usuario pedir skill global:
+
+```text
+~/.codex/skills/skill-master-orchestrator/
+```
+
+## Descricao de trigger sugerida
+
+```yaml
+---
+name: skill-master-orchestrator
+description: Orquestra o uso do skill-master-mcp em tarefas tecnicas, de programacao, automacao, MCP, CLI, Notion, pesquisa, testes, release, aprendizado de implementacoes bem-sucedidas e criacao/aprovacao de skills. Use quando o usuario mencionar skill-master, skill_master, skill-master-mcp, pedir para usar skills, melhorar o MCP, aprender com uma implementacao, atualizar Notion, criar prompts de execucao, validar pacote, publicar com seguranca, ou quando uma skill local/global aprovada puder melhorar substancialmente a execucao.
+---
+```
+
+## Execucao
+
+1. Ler `docs/architecture/PLANO_MASTER_ACIONAMENTO_AUTOMATICO_E_APRENDIZADO.md`.
+2. Criar a skill com corpo enxuto.
+3. Colocar detalhes longos nas referencias.
+4. Incluir regra de publicacao bloqueada sem autorizacao.
+5. Incluir regra de aprendizado com aprovacao humana.
+6. Validar a skill.
+
+## Validacao
+
+Se o validador do Codex estiver disponivel:
+
+```bash
+python3 /home/dev/.codex/skills/.system/skill-creator/scripts/quick_validate.py .codex/skills/skill-master-orchestrator
+```
+
+Validar tambem:
+
+```bash
+git status --short
+```
+
+## Resultado esperado
+
+- Skill local criada.
+- Persona documentada.
+- Politicas de ativacao e aprovacao separadas.
+- Nenhuma skill global criada sem pedido explicito.
+
+## Resultado da execucao em 2026-06-27
+
+- Criada a skill local `.codex/skills/skill-master-orchestrator`.
+- Criadas as referencias `persona-dev-senior-master.md`, `activation-policy.md` e `human-approval-policy.md`.
+- `quick_validate.py` passou com `Skill is valid!`.
+- `npm run check` passou com 7 arquivos de teste e 31 testes.
+- O `skill_master_refresh_catalog(include_web=false)` passou, mas a instancia MCP ativa ainda estava usando configuracao sem `workspaceRoots`; a proxima etapa deve ajustar/reiniciar a configuracao de fontes para a skill local aparecer nas recomendacoes do MCP em tempo real.

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.