@fprad0/skill-master-mcp 0.0.12 → 1.0.0

package/docs/prompt-tasks/PROMPT_TASK_016_CROSS_PLATFORM_MCP_AUTH_REGISTRATION.md

@@ -1,107 +1,107 @@
-# Prompt Task 016 - Cross-platform MCP auth registration
-
-Status: implementado localmente, pronto para aplicar no computador autorizado
-Publicacao: somente com autorizacao explicita
-Branch sugerida: `fix/cross-platform-mcp-registration`
-Commit sugerido: `fix(mcp): register clients with absolute node entrypoint`
-
-## Prompt para executar
-
-Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
-
-Objetivo: aplicar a correcao que faz Windows, Linux e macOS iniciarem o MCP `skill_master` de forma robusta em Codex, Claude, Gemini e Antigravity, sem depender do `PATH` global do npm.
-
-## Contexto
-
-O problema ocorre quando clientes MCP tentam iniciar:
-
-```text
-skill-master-mcp
-```
-
-Apps desktop podem nao herdar o `PATH` do terminal. O novo padrao deve ser:
-
-```text
-command = caminho absoluto do Node.js
-args = caminho absoluto para bin/skill-master.mjs
-```
-
-## Arquivos a aplicar
-
-```text
-bin/lib/client-config.mjs
-bin/lib/menu-core.mjs
-bin/skill-master-bootstrap-global.mjs
-bin/skill-master-doctor.mjs
-bin/skill-master-register-clients.mjs
-scripts/verify-menu-actions.mjs
-src/client-config.test.ts
-src/menu-core.test.ts
-package.json
-README.md
-CHANGELOG.md
-docs/operations/GUIA_MULTI_COMPUTADOR.md
-docs/operations/cross-platform-auth-transfer/
-```
-
-## Requisitos
-
-- `skill-master-register-clients` deve escrever Codex TOML e JSON de clientes com Node absoluto.
-- `skill-master-doctor` deve diferenciar `absolute-node`, `path-bin`, `launcher`, `custom`, `missing` e `invalid-json`.
-- `skill-master-menu --status` deve mostrar se o MCP esta robusto.
-- `skill-master-menu --run bootstrap-global --yes` deve continuar instalando skills e registrando clientes.
-- Todas as 22 acoes do menu devem continuar presentes e protegidas quando necessario.
-
-## Validacao
-
-```powershell
-npm install
-npm run check
-node bin/skill-master-menu.mjs --status
-node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
-node bin/skill-master-doctor.mjs
-npm pack --dry-run
-```
-
-Inspecionar:
-
-```text
-.tmp-client-snippets/codex.config.toml
-.tmp-client-snippets/claude_desktop_config.skill_master.json
-```
-
-Confirmar que ambos usam:
-
-```text
-command = caminho absoluto do Node
-args = caminho absoluto do bin/skill-master.mjs
-```
-
-## Aplicacao no Codex
-
-Depois de validar:
-
-```powershell
-node bin/skill-master-register-clients.mjs --apply-codex --force
-node bin/skill-master-doctor.mjs
-```
-
-Depois de publicar e instalar globalmente:
-
-```powershell
-npm install -g @fprad0/skill-master-mcp@latest
-skill-master-register-clients --apply-codex --force
-skill-master-menu --run doctor
-```
-
-Reiniciar Codex apos aplicar.
-
-## Aceite
-
-- `npm run check` passa.
-- `npm pack --dry-run` passa.
-- Codex config usa Node absoluto + `bin/skill-master.mjs` absoluto.
-- Doctor nao classifica `path-bin` como robusto.
-- Menu action matrix passa.
-- Nenhum segredo e publicado.
-
+# Prompt Task 016 - Cross-platform MCP auth registration
+
+Status: implementado localmente, pronto para aplicar no computador autorizado
+Publicacao: somente com autorizacao explicita
+Branch sugerida: `fix/cross-platform-mcp-registration`
+Commit sugerido: `fix(mcp): register clients with absolute node entrypoint`
+
+## Prompt para executar
+
+Voce e Reborn/Codex trabalhando no repo `skill-master-mcp`.
+
+Objetivo: aplicar a correcao que faz Windows, Linux e macOS iniciarem o MCP `skill_master` de forma robusta em Codex, Claude, Gemini e Antigravity, sem depender do `PATH` global do npm.
+
+## Contexto
+
+O problema ocorre quando clientes MCP tentam iniciar:
+
+```text
+skill-master-mcp
+```
+
+Apps desktop podem nao herdar o `PATH` do terminal. O novo padrao deve ser:
+
+```text
+command = caminho absoluto do Node.js
+args = caminho absoluto para bin/skill-master.mjs
+```
+
+## Arquivos a aplicar
+
+```text
+bin/lib/client-config.mjs
+bin/lib/menu-core.mjs
+bin/skill-master-bootstrap-global.mjs
+bin/skill-master-doctor.mjs
+bin/skill-master-register-clients.mjs
+scripts/verify-menu-actions.mjs
+src/client-config.test.ts
+src/menu-core.test.ts
+package.json
+README.md
+CHANGELOG.md
+docs/operations/GUIA_MULTI_COMPUTADOR.md
+docs/operations/cross-platform-auth-transfer/
+```
+
+## Requisitos
+
+- `skill-master-register-clients` deve escrever Codex TOML e JSON de clientes com Node absoluto.
+- `skill-master-doctor` deve diferenciar `absolute-node`, `path-bin`, `launcher`, `custom`, `missing` e `invalid-json`.
+- `skill-master-menu --status` deve mostrar se o MCP esta robusto.
+- `skill-master-menu --run bootstrap-global --yes` deve continuar instalando skills e registrando clientes.
+- Todas as 22 acoes do menu devem continuar presentes e protegidas quando necessario.
+
+## Validacao
+
+```powershell
+npm install
+npm run check
+node bin/skill-master-menu.mjs --status
+node bin/skill-master-register-clients.mjs --write-snippets --snippets-dir .tmp-client-snippets
+node bin/skill-master-doctor.mjs
+npm pack --dry-run
+```
+
+Inspecionar:
+
+```text
+.tmp-client-snippets/codex.config.toml
+.tmp-client-snippets/claude_desktop_config.skill_master.json
+```
+
+Confirmar que ambos usam:
+
+```text
+command = caminho absoluto do Node
+args = caminho absoluto do bin/skill-master.mjs
+```
+
+## Aplicacao no Codex
+
+Depois de validar:
+
+```powershell
+node bin/skill-master-register-clients.mjs --apply-codex --force
+node bin/skill-master-doctor.mjs
+```
+
+Depois de publicar e instalar globalmente:
+
+```powershell
+npm install -g @fprad0/skill-master-mcp@latest
+skill-master-register-clients --apply-codex --force
+skill-master-menu --run doctor
+```
+
+Reiniciar Codex apos aplicar.
+
+## Aceite
+
+- `npm run check` passa.
+- `npm pack --dry-run` passa.
+- Codex config usa Node absoluto + `bin/skill-master.mjs` absoluto.
+- Doctor nao classifica `path-bin` como robusto.
+- Menu action matrix passa.
+- Nenhum segredo e publicado.
+

package/docs/prompt-tasks/PROMPT_TASK_018_NPM_PUBLISH_2FA_SETUP.md

@@ -1,80 +1,80 @@
-# Prompt Task 018 - npm Publish 2FA Setup
-
-Status: pronto para execucao na maquina autorizada
-Publicacao: somente com autorizacao explicita
-Branch sugerida: `chore/npm-publish-2fa-setup`
-Commit sugerido: `docs(npm): add 2fa publication runbook and transfer prompt`
-
-## Objetivo
-
-Preparar a maquina autorizada para publicar novas versoes do `@fprad0/skill-master-mcp` no npmjs, resolvendo bloqueios de OTP/2FA sem contornar seguranca.
-
-## Contexto
-
-O registry publico ja contem:
-
-```text
-@fprad0/skill-master-mcp@0.0.11
-```
-
-Antes de publicar, sincronizar o checkout e confirmar que a proxima versao e maior que a publicada.
-
-## Arquivos de referencia
-
-```text
-docs/operations/npm-publication-transfer/README_PUBLICACAO_NPM_2FA_2026-06-29.md
-```
-
-## Passos
-
-1. Abrir no Chrome:
-
-```text
-https://www.npmjs.com/login
-https://www.npmjs.com/settings/~/tokens
-https://docs.npmjs.com/recovering-your-2fa-enabled-account/
-```
-
-2. Recuperar acesso 2FA por app autenticador correto ou recovery code oficial.
-
-3. Se for publicar manualmente:
-
-```bash
-npm login --registry=https://registry.npmjs.org
-npm whoami --registry=https://registry.npmjs.org
-npm run check
-npm pack --dry-run
-npm publish --access public --registry=https://registry.npmjs.org --otp=SEU_OTP_ATUAL
-```
-
-4. Se for publicar com token:
-
-```bash
-npm config set //registry.npmjs.org/:_authToken "NPM_TOKEN_AQUI"
-npm whoami --registry=https://registry.npmjs.org
-npm run check
-npm pack --dry-run
-npm publish --access public --registry=https://registry.npmjs.org
-```
-
-5. Validar:
-
-```bash
-npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
-```
-
-## Criterios de aceite
-
-- Acesso npm recuperado sem expor OTP, token ou recovery code.
-- `npm whoami` passa na maquina autorizada.
-- `npm run check` passa.
-- `npm pack --dry-run` passa.
-- Versao publicada e maior que a versao atual no registry.
-- Nenhum segredo foi commitado.
-
-## Nao fazer
-
-- Nao colar OTP, token ou recovery code no Codex.
-- Nao publicar se `package.json` ainda estiver em versao ja existente.
-- Nao desativar 2FA como solucao de conveniencia.
-- Nao commitar `.npmrc`.
+# Prompt Task 018 - npm Publish 2FA Setup
+
+Status: pronto para execucao na maquina autorizada
+Publicacao: somente com autorizacao explicita
+Branch sugerida: `chore/npm-publish-2fa-setup`
+Commit sugerido: `docs(npm): add 2fa publication runbook and transfer prompt`
+
+## Objetivo
+
+Preparar a maquina autorizada para publicar novas versoes do `@fprad0/skill-master-mcp` no npmjs, resolvendo bloqueios de OTP/2FA sem contornar seguranca.
+
+## Contexto
+
+O registry publico ja contem:
+
+```text
+@fprad0/skill-master-mcp@0.0.11
+```
+
+Antes de publicar, sincronizar o checkout e confirmar que a proxima versao e maior que a publicada.
+
+## Arquivos de referencia
+
+```text
+docs/operations/npm-publication-transfer/README_PUBLICACAO_NPM_2FA_2026-06-29.md
+```
+
+## Passos
+
+1. Abrir no Chrome:
+
+```text
+https://www.npmjs.com/login
+https://www.npmjs.com/settings/~/tokens
+https://docs.npmjs.com/recovering-your-2fa-enabled-account/
+```
+
+2. Recuperar acesso 2FA por app autenticador correto ou recovery code oficial.
+
+3. Se for publicar manualmente:
+
+```bash
+npm login --registry=https://registry.npmjs.org
+npm whoami --registry=https://registry.npmjs.org
+npm run check
+npm pack --dry-run
+npm publish --access public --registry=https://registry.npmjs.org --otp=SEU_OTP_ATUAL
+```
+
+4. Se for publicar com token:
+
+```bash
+npm config set //registry.npmjs.org/:_authToken "NPM_TOKEN_AQUI"
+npm whoami --registry=https://registry.npmjs.org
+npm run check
+npm pack --dry-run
+npm publish --access public --registry=https://registry.npmjs.org
+```
+
+5. Validar:
+
+```bash
+npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org
+```
+
+## Criterios de aceite
+
+- Acesso npm recuperado sem expor OTP, token ou recovery code.
+- `npm whoami` passa na maquina autorizada.
+- `npm run check` passa.
+- `npm pack --dry-run` passa.
+- Versao publicada e maior que a versao atual no registry.
+- Nenhum segredo foi commitado.
+
+## Nao fazer
+
+- Nao colar OTP, token ou recovery code no Codex.
+- Nao publicar se `package.json` ainda estiver em versao ja existente.
+- Nao desativar 2FA como solucao de conveniencia.
+- Nao commitar `.npmrc`.

package/docs/prompt-tasks/PROMPT_TASK_019_TOKEN_ECONOMY_GLOBAL_SKILLS.md

@@ -0,0 +1,56 @@
+# PROMPT TASK 019 - Token Economy Global Skills
+
+## Objetivo
+
+Revisar, aprovar e integrar skills globais de economia de tokens ao `skill-master-mcp`, para reduzir desperdicio de contexto em Codex, Claude, Gemini e Antigravity.
+
+## Contexto
+
+Foram criados os drafts:
+
+```text
+docs/skill-candidates/v0.0.12/token-economy-orchestrator/SKILL.md
+docs/skill-candidates/v0.0.12/prompt-budget-gate/SKILL.md
+docs/skill-candidates/v0.0.12/context-compression-handoff/SKILL.md
+```
+
+Pesquisa e plano:
+
+```text
+docs/operations/token-economy-transfer/ANALISE_AVANCADA_ECONOMIA_TOKENS_2026-06-30.md
+docs/operations/token-economy-transfer/PLANO_DEV_SENIOR_MASTER_TOKEN_ECONOMY_2026-06-30.md
+```
+
+## Execucao
+
+1. Revisar os drafts das skills.
+2. Validar que nao duplicam skills globais existentes.
+3. Ajustar descricoes de ativacao.
+4. Rodar:
+
+```bash
+npm install
+npm run check
+npm pack --dry-run
+```
+
+5. Criar pacote de aprovacao humana.
+6. Depois de aprovado, instalar globalmente pelo fluxo do `skill_master`.
+
+## Criterios de aceite
+
+- Skills sao curtas, acionaveis e seguras.
+- Cobrem Codex, Claude, Gemini e Antigravity sem depender de API privada.
+- Preservam contexto em tarefas de alto risco.
+- Nao prometem economia exata sem medicao.
+- `npm run check` passa.
+- `npm pack --dry-run` inclui os arquivos.
+
+## Futuro
+
+Adicionar ao `skill_master_prompt_router`:
+
+- recomendacao automatica de `token-economy-orchestrator`;
+- modo de budget por prompt;
+- menu action `token-economy`;
+- metricas estimadas de economia.

package/docs/prompt-tasks/PROMPT_TASK_MASTER_EXECUTOR.md

@@ -1,6 +1,6 @@
-# Prompt Task Master - Construcao do Skill Master MCP 00.01
-
-> STATUS: HISTORICO / ORQUESTRADOR ORIGINAL
->
-> Este arquivo foi o coordenador da construcao inicial `00.01`.
-> Ele deve ser tratado como registro historico. Para o estado atual, siga a documentacao consolidada da linha `00.02`.
+# Prompt Task Master - Construcao do Skill Master MCP 00.01
+
+> STATUS: HISTORICO / ORQUESTRADOR ORIGINAL
+>
+> Este arquivo foi o coordenador da construcao inicial `00.01`.
+> Ele deve ser tratado como registro historico. Para o estado atual, siga a documentacao consolidada da linha `00.02`.