@fprad0/skill-master-mcp 0.0.12 → 1.0.1

package/docs/planning/V0_0_9_ROADMAP_DISCERNIMENTO_E_CONHECIMENTO_AMPLO.md

@@ -1,181 +1,181 @@
-# V0.0.9 - Roadmap de discernimento moral e conhecimento amplo
-
-Data: 2026-06-27
-Status: planejamento, sem publicacao
-
-## Objetivo da versao
-
-Evoluir o `skill-master-mcp` de um roteador tecnico de skills para uma camada mais ampla de discernimento, qualidade e conhecimento, mantendo seguranca, revisao humana e obediencia ao escopo real do produto.
-
-## Resultado esperado
-
-Ao final da proxima versao, o MCP deve conseguir:
-
-- avaliar se uma tarefa tecnica tem risco moral ou humano;
-- aplicar gates inspirados na moral catolica;
-- rotear prompts por disciplinas de conhecimento;
-- deixar claro quando uma area exige profissional habilitado;
-- recomendar skills por dominio;
-- criar trilhas de estudo sem ativar conteudo nao aprovado;
-- melhorar a mensagem de venda para refletir capacidades reais.
-
-## Fase 1 - Governanca moral
-
-Arquivos:
-
-- `src/moral-governance.ts`
-- `src/moral-governance.test.ts`
-- `docs/architecture/GOVERNANCA_MORAL_CATOLICA.md`
-
-Entregas:
-
-- classificador de risco moral;
-- gates de dignidade humana, verdade, bem comum, justica e limite tecnico;
-- tool MCP `skill_master_moral_discernment`;
-- integracao no `skill_master_prompt_router`;
-- evals com prompts bons, ambiguos e ruins.
-
-Criterio de pronto:
-
-- prompts claramente danosos retornam `blocker`;
-- areas profissionais sensiveis retornam `refer` ou `warning`;
-- tarefas tecnicas comuns continuam fluindo sem friccao pesada.
-
-## Fase 2 - Fronteiras profissionais
-
-Arquivos:
-
-- `src/professional-boundaries.ts`
-- `src/professional-boundaries.test.ts`
-
-Dominios:
-
-- direito;
-- saude;
-- financas;
-- psicologia;
-- seguranca fisica;
-- educacao de menores;
-- decisao trabalhista;
-- decisao de credito;
-- privacidade e dados pessoais.
-
-Comportamento:
-
-- permitir informacao geral;
-- bloquear instrucao ilegal ou danosa;
-- recomendar profissional habilitado quando houver decisao real;
-- exigir fontes e jurisdicao quando o prompt envolver lei.
-
-## Fase 3 - Router de conhecimento amplo
-
-Arquivos:
-
-- `src/domain-router.ts`
-- `src/domain-router.test.ts`
-- `network/approved-domain-sources.json`
-
-Dominios iniciais:
-
-- ciencia;
-- filosofia;
-- sociologia;
-- direito;
-- matematica;
-- portugues;
-- ingles;
-- frances;
-- engenharia computacional;
-- engenharia de software;
-- engenharia de redes;
-- engenharia de IA;
-- seguranca;
-- produto;
-- documentacao;
-- catequese e doutrina catolica.
-
-Saida esperada:
-
-- dominio principal;
-- dominios secundarios;
-- skills recomendadas;
-- fontes aprovadas;
-- limites profissionais;
-- necessidade de pesquisa atualizada;
-- necessidade de Notion ou registro local.
-
-## Fase 4 - Skills candidatas
-
-Criar pacote de skills candidatas em:
-
-```text
-docs/skill-candidates/v0.0.9/
-```
-
-Essas skills nao devem ficar ativas ate revisao humana e decisao explicita.
-
-Skills candidatas iniciais:
-
-- `catholic-moral-discernment`;
-- `ai-ethics-human-dignity`;
-- `professional-boundary-triage`;
-- `broad-domain-router`;
-- `language-quality-pt-en-fr`;
-- `math-science-reasoning`;
-- `philosophy-sociology-discernment`;
-- `engineering-systems-master`.
-
-## Fase 5 - Menu e notificacoes
-
-Adicionar ao menu:
-
-- `moral-status`;
-- `moral-check-prompt`;
-- `domain-router`;
-- `professional-boundaries`;
-- `study-domain-skills`;
-- `approve-domain-skill`;
-
-Notificacoes:
-
-- skills candidatas aguardando aprovacao moral;
-- fontes de dominio ainda nao revisadas;
-- prompt bloqueado por risco moral;
-- prompt encaminhado para profissional habilitado;
-- evals morais pendentes antes de publicar.
-
-## Fase 6 - Mensagem de venda revisada
-
-Atualizar README e mensagem publica para dizer:
-
-- o que o MCP faz hoje;
-- o que e assistivo, nao automatico;
-- o que e baseado em aprovacao humana;
-- o que e camada moral opcional;
-- o que ainda e roadmap.
-
-## Ordem recomendada de implementacao
-
-1. Criar `moral-governance.ts` com regras puras e testes.
-2. Integrar gates morais no `prompt-router`.
-3. Criar tool MCP `skill_master_moral_discernment`.
-4. Criar `professional-boundaries.ts`.
-5. Criar `domain-router.ts`.
-6. Adicionar menu e notificacoes.
-7. Criar evals.
-8. Atualizar docs.
-9. Rodar `npm run check`.
-10. Pedir autorizacao antes de publicar.
-
-## Riscos
-
-- Prometer discernimento moral alem do que o software consegue cumprir.
-- Misturar opiniao pessoal com doutrina catolica sem fonte.
-- Dar aconselhamento profissional indevido.
-- Bloquear demais tarefas tecnicas comuns.
-- Criar um sistema moral rigido sem espaco para prudencia humana.
-- Ativar skills amplas sem revisao de fonte, licenca e risco.
-
-## Decisao de produto
-
-O caminho correto e tratar a proxima versao como "governanca assistiva", nao como "juiz automatico". O MCP deve ser forte para bloquear mal claro e humilde para encaminhar casos prudenciais, juridicos, espirituais e profissionais para revisao humana competente.
+# V0.0.9 - Roadmap de discernimento moral e conhecimento amplo
+
+Data: 2026-06-27
+Status: planejamento, sem publicacao
+
+## Objetivo da versao
+
+Evoluir o `skill-master-mcp` de um roteador tecnico de skills para uma camada mais ampla de discernimento, qualidade e conhecimento, mantendo seguranca, revisao humana e obediencia ao escopo real do produto.
+
+## Resultado esperado
+
+Ao final da proxima versao, o MCP deve conseguir:
+
+- avaliar se uma tarefa tecnica tem risco moral ou humano;
+- aplicar gates inspirados na moral catolica;
+- rotear prompts por disciplinas de conhecimento;
+- deixar claro quando uma area exige profissional habilitado;
+- recomendar skills por dominio;
+- criar trilhas de estudo sem ativar conteudo nao aprovado;
+- melhorar a mensagem de venda para refletir capacidades reais.
+
+## Fase 1 - Governanca moral
+
+Arquivos:
+
+- `src/moral-governance.ts`
+- `src/moral-governance.test.ts`
+- `docs/architecture/GOVERNANCA_MORAL_CATOLICA.md`
+
+Entregas:
+
+- classificador de risco moral;
+- gates de dignidade humana, verdade, bem comum, justica e limite tecnico;
+- tool MCP `skill_master_moral_discernment`;
+- integracao no `skill_master_prompt_router`;
+- evals com prompts bons, ambiguos e ruins.
+
+Criterio de pronto:
+
+- prompts claramente danosos retornam `blocker`;
+- areas profissionais sensiveis retornam `refer` ou `warning`;
+- tarefas tecnicas comuns continuam fluindo sem friccao pesada.
+
+## Fase 2 - Fronteiras profissionais
+
+Arquivos:
+
+- `src/professional-boundaries.ts`
+- `src/professional-boundaries.test.ts`
+
+Dominios:
+
+- direito;
+- saude;
+- financas;
+- psicologia;
+- seguranca fisica;
+- educacao de menores;
+- decisao trabalhista;
+- decisao de credito;
+- privacidade e dados pessoais.
+
+Comportamento:
+
+- permitir informacao geral;
+- bloquear instrucao ilegal ou danosa;
+- recomendar profissional habilitado quando houver decisao real;
+- exigir fontes e jurisdicao quando o prompt envolver lei.
+
+## Fase 3 - Router de conhecimento amplo
+
+Arquivos:
+
+- `src/domain-router.ts`
+- `src/domain-router.test.ts`
+- `network/approved-domain-sources.json`
+
+Dominios iniciais:
+
+- ciencia;
+- filosofia;
+- sociologia;
+- direito;
+- matematica;
+- portugues;
+- ingles;
+- frances;
+- engenharia computacional;
+- engenharia de software;
+- engenharia de redes;
+- engenharia de IA;
+- seguranca;
+- produto;
+- documentacao;
+- catequese e doutrina catolica.
+
+Saida esperada:
+
+- dominio principal;
+- dominios secundarios;
+- skills recomendadas;
+- fontes aprovadas;
+- limites profissionais;
+- necessidade de pesquisa atualizada;
+- necessidade de Notion ou registro local.
+
+## Fase 4 - Skills candidatas
+
+Criar pacote de skills candidatas em:
+
+```text
+docs/skill-candidates/v0.0.9/
+```
+
+Essas skills nao devem ficar ativas ate revisao humana e decisao explicita.
+
+Skills candidatas iniciais:
+
+- `catholic-moral-discernment`;
+- `ai-ethics-human-dignity`;
+- `professional-boundary-triage`;
+- `broad-domain-router`;
+- `language-quality-pt-en-fr`;
+- `math-science-reasoning`;
+- `philosophy-sociology-discernment`;
+- `engineering-systems-master`.
+
+## Fase 5 - Menu e notificacoes
+
+Adicionar ao menu:
+
+- `moral-status`;
+- `moral-check-prompt`;
+- `domain-router`;
+- `professional-boundaries`;
+- `study-domain-skills`;
+- `approve-domain-skill`;
+
+Notificacoes:
+
+- skills candidatas aguardando aprovacao moral;
+- fontes de dominio ainda nao revisadas;
+- prompt bloqueado por risco moral;
+- prompt encaminhado para profissional habilitado;
+- evals morais pendentes antes de publicar.
+
+## Fase 6 - Mensagem de venda revisada
+
+Atualizar README e mensagem publica para dizer:
+
+- o que o MCP faz hoje;
+- o que e assistivo, nao automatico;
+- o que e baseado em aprovacao humana;
+- o que e camada moral opcional;
+- o que ainda e roadmap.
+
+## Ordem recomendada de implementacao
+
+1. Criar `moral-governance.ts` com regras puras e testes.
+2. Integrar gates morais no `prompt-router`.
+3. Criar tool MCP `skill_master_moral_discernment`.
+4. Criar `professional-boundaries.ts`.
+5. Criar `domain-router.ts`.
+6. Adicionar menu e notificacoes.
+7. Criar evals.
+8. Atualizar docs.
+9. Rodar `npm run check`.
+10. Pedir autorizacao antes de publicar.
+
+## Riscos
+
+- Prometer discernimento moral alem do que o software consegue cumprir.
+- Misturar opiniao pessoal com doutrina catolica sem fonte.
+- Dar aconselhamento profissional indevido.
+- Bloquear demais tarefas tecnicas comuns.
+- Criar um sistema moral rigido sem espaco para prudencia humana.
+- Ativar skills amplas sem revisao de fonte, licenca e risco.
+
+## Decisao de produto
+
+O caminho correto e tratar a proxima versao como "governanca assistiva", nao como "juiz automatico". O MCP deve ser forte para bloquear mal claro e humilde para encaminhar casos prudenciais, juridicos, espirituais e profissionais para revisao humana competente.

package/docs/planning/mcp-1.0.0/00_RESUMO_EXECUTIVO_AUDITORIA_MENU.md

@@ -0,0 +1,118 @@
+# MCP 1.0.0 - Resumo Executivo da Auditoria do Menu
+
+Data da auditoria: 2026-06-30
+Pacote auditado: `@fprad0/skill-master-mcp@1.0.0`
+Diretorio testado: `C:\Users\CDT\Documents\F.Prado\skill-master-mcp-release-publish`
+
+## Objetivo
+
+Validar o `skill-master-menu` da versao `1.0.0`, testar as funcoes principais, identificar falhas reais e preparar planos de correcao avancados para a proxima iteracao do MCP Skill Master.
+
+O foco especial foi:
+
+- `Ativar skill aprendida no workspace`
+- `Ativar skill aprendida global`
+- confiabilidade do menu em Windows
+- qualidade visual cyberpunk pixel art
+- lentidao, UX ruim ou estados pouco claros
+
+## Resultado Geral
+
+O menu existe, abre via `--help`, `--status` e `--run`, renderiza frames cyberpunk nos comandos e possui 23 acoes registradas. A matriz oficial `npm run verify:menu` passou.
+
+O backend de ativacao de skill aprendida esta funcional. Testes isolados confirmaram que o core consegue ativar uma skill aprendida em alvo workspace e em alvo global temporario, criando:
+
+- `SKILL.md`
+- `skill-master-approval.json`
+
+Porem, as duas opcoes criticas do menu falham no modo `--run --yes`, porque o menu chama o subcomando interativo `--activate-interactive`. Em ambiente sem TTY, isso termina com:
+
+```text
+[skill_master] Interactive activation requires a TTY.
+```
+
+## Status por Area
+
+### Publicacao npm
+
+OK.
+
+```powershell
+npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
+```
+
+Resultado:
+
+```text
+1.0.0
+```
+
+### Menu e acoes registradas
+
+OK.
+
+```powershell
+npm run verify:menu
+```
+
+Resultado:
+
+```text
+Menu action matrix OK.
+Actions: 23
+Required actions: 23
+```
+
+### Doctor
+
+Parcial.
+
+O doctor passou nos principais pontos, mas reportou Claude Code ausente neste computador:
+
+```text
+[NO] Claude Code opcional - ausente em claude CLI
+[NO] Readiness global - partial
+```
+
+Isso nao bloqueia Codex, Claude Desktop, Gemini ou Antigravity, que apareceram configurados.
+
+### Gate completo
+
+Falhou em Windows por expectativas POSIX nos testes:
+
+- `src/client-config.test.ts`
+- `src/project-skills.test.ts`
+
+Essas falhas precisam entrar como correcao obrigatoria antes da proxima release.
+
+### Ativacao de skill aprendida
+
+Core OK, menu com bug.
+
+O motor direto `activateSuccessSkillDraft` passou para workspace e global temporarios.
+
+O CLI direto `skill-master-success-skills --activate <manifest> --target <path> --yes` tambem passou.
+
+O menu falha quando executado assim:
+
+```powershell
+node bin\skill-master-menu.mjs --run activate-learned-local --yes
+node bin\skill-master-menu.mjs --run activate-learned-global --yes
+```
+
+## Prioridades de Correcao
+
+1. Corrigir `activateLearnedLocal` e `activateLearnedGlobal` para suportarem modo nao interativo com `--yes`.
+2. Corrigir testes cross-platform Windows/Linux/macOS.
+3. Melhorar UX de acoes interativas chamadas via `--run`, exibindo mensagem clara e alternativa automatizavel.
+4. Refinar estado visual do menu para mostrar acoes bloqueadas, interativas, destrutivas, seguras e recomendadas.
+5. Adicionar suite de regressao que cria drafts temporarios e valida ativacao local/global fim a fim.
+
+## Arquivos de Planejamento
+
+- `01_MATRIZ_TESTES_MENU_E_RESULTADOS.md`
+- `02_PLANO_CORRECAO_ATIVAR_SKILL_APRENDIDA.md`
+- `03_PLANO_COMPATIBILIDADE_WINDOWS_LINUX_MACOS.md`
+- `04_PLANO_UI_CYBERPUNK_PIXEL_ART_E_PERFORMANCE.md`
+- `05_PROMPT_TASK_EXECUCAO_CORRECOES.md`
+- `06_CHECKLIST_REGRESSAO_PRE_RELEASE.md`