@fprad0/skill-master-mcp 0.0.6 → 0.0.8

package/CHANGELOG.md

@@ -7,6 +7,21 @@ All notable changes to `skill_master` will be tracked here.
 - Prepare a public npm publication path with dedicated workflow and operator guide.
 - Upgrade release automation from Node `20` to Node `22`.
 
+## [0.0.8] - 2026-06-27
+
+- Add `skill_master_prompt_router` with `manual`, `balanced`, and `always-on-assisted` activation modes.
+- Add Dev Senior Master persona routing, safety gates, Notion/update detection, and learned-skill signals.
+- Add success-learning flows for human approval packages, local/global activation, study decisions, and rejection history.
+- Add `skill-master-activation`, `skill-master-success-skills`, and `skill-master-eval-activation` operator CLIs.
+- Expand the terminal menu with activation status, prompt recommendations, learned-skill notifications, study/reject actions, and Notion summaries.
+- Add activation evals with positive, negative, and risk cases plus `npm run eval:activation`.
+
+## [0.0.7] - 2026-06-26
+
+- Add a visual terminal menu for `skill-master-menu` using `prompts`, with TTY detection and direct action mode.
+- Extract the menu core into a reusable module for tests and future UI changes.
+- Keep the package compatible with Node `18+` instead of moving to a heavier TUI stack.
+
 ## [0.0.6] - 2026-06-26
 
 - Harden `skill-master-configure-private-registry` with HTTPS registry validation, scoped token handling, redacted dry-runs, timestamped backups, and POSIX `0600` permissions.

package/README.md

@@ -108,18 +108,21 @@ npm install -g @fprad0/skill-master-mcp
 npx -y @fprad0/skill-master-mcp@latest
 ```
 
-Estado atual validado em `2026-06-26`:
+Estado atual preparado em `2026-06-27`:
 
-- pacote publico publicado: `@fprad0/skill-master-mcp@0.0.5`
-- dist-tag `latest` apontando para `0.0.5`
-- workflow `Publish Skill Master to npmjs` concluido com sucesso
-- `npm install` e `npx` confirmados
+- release local preparada: `@fprad0/skill-master-mcp@0.0.8`
+- validacao de pacote por tarball local confirmada
+- publicacao no npmjs aguardando autenticacao npmjs nesta maquina
+- apos publicar, validar `npm install`, `npx` e dist-tag `latest`
 
 Comandos globais principais:
 
 ```bash
+skill-master-activation
+skill-master-eval-activation
 skill-master-mcp
 skill-master-menu
+skill-master-success-skills
 skill-master-update
 skill-master-configure-private-registry
 ```
@@ -130,6 +133,44 @@ O `skill-master-mcp` deve continuar reservado para clientes MCP via `stdio`. Par
 skill-master-menu
 ```
 
+O menu agora possui modo visual interativo para terminal com TTY e tambem aceita execucao direta por acao:
+
+```bash
+skill-master-menu --run status
+skill-master-menu --run check
+skill-master-menu --run update --yes
+skill-master-menu --run notifications
+skill-master-menu --run study-skills
+skill-master-menu --run approval-package
+skill-master-menu --run activation-status
+skill-master-menu --run recommend-prompt
+skill-master-menu --run notion-summary
+```
+
+O menu visual usa `prompts` para ficar mais legivel no terminal e manter compatibilidade com `Node 18+`.
+
+O menu tambem mostra notificacoes de skills aprendidas pendentes e links externos para estudo. As acoes de ativacao sao:
+
+- `skill-master-menu --run activate-learned-local`: instala uma skill aprovada em `.codex/skills` do workspace atual.
+- `skill-master-menu --run activate-learned-global`: instala uma skill aprovada em `${CODEX_HOME:-~/.codex}/skills`.
+- `skill-master-menu --run mark-study`: registra uma skill candidata como material para estudo.
+- `skill-master-menu --run reject-skill`: rejeita uma skill candidata preservando historico.
+
+Para modo de ativacao e recomendacao local:
+
+```bash
+skill-master-activation --status
+skill-master-activation --set-mode balanced
+skill-master-activation --route-prompt "skill-master, recomende skills para este prompt"
+skill-master-activation --notion-summary
+```
+
+Para rodar as avaliacoes de ativacao antes de release:
+
+```bash
+npm run eval:activation
+```
+
 Para atualizar a instalacao global via npm sem iniciar o servidor MCP:
 
 ```bash
@@ -190,18 +231,62 @@ O `skill_master` pode aprender com as skills ja existentes em cada maquina insta
 Ferramentas MCP principais:
 
 - `skill_master_refresh_catalog`
+- `skill_master_prompt_router`
+- `skill_master_activation_check`
+- `skill_master_recommend`
 - `skill_master_prepare_skill_contribution`
 - `skill_master_review_skill_contribution`
+- `skill_master_prepare_success_skill`
+- `skill_master_review_success_skill`
+- `skill_master_list_unapproved_success_skills`
+- `skill_master_prepare_success_skill_approval_package`
+- `skill_master_activate_success_skill`
 
 O pacote de contribuicao nao envia arquivos automaticamente, nao executa skills desconhecidas e nao inclui caminhos completos ou corpo bruto por padrao.
 
+O fluxo de aprendizado por implementacoes bem-sucedidas cria rascunhos locais em staging, gera pacote de aprovacao humana e permite ativacao explicita em escopo local ou global. Ele exige evidencias, revisa risco/duplicidade e mantem candidatos externos como nao aprovados ate revisao humana. Nenhuma skill aprendida e publicada automaticamente.
+
 Leia:
 
 - [Rede segura de skills](docs/architecture/REDE_SEGURA_DE_SKILLS.md)
+- [Aprendizado de implementacoes bem-sucedidas](docs/architecture/APRENDIZADO_DE_IMPLEMENTACOES_BEM_SUCEDIDAS.md)
 
 ## Modos de ativacao em prompts
 
-A partir da versao `0.0.4`, clientes e agentes podem usar `skill_master_activation_check` antes de decidir se devem acionar recomendacoes de skills.
+Clientes e agentes podem usar `skill_master_prompt_router` como camada principal antes de decidir se devem acionar recomendacoes de skills, aplicar persona ou bloquear uma acao sensivel.
+
+Modos suportados:
+
+- `manual`: ativa apenas com mencao direta ao Skill Master ou gate bloqueante.
+- `balanced`: modo recomendado; ativa por mencao direta, tarefa tecnica com skill relevante, Notion, aprendizado, validacao, MCP ou publicacao.
+- `always-on-assisted`: avalia quase todo prompt, mas retorna `executionMode: no-op` quando nao houver ganho claro.
+
+Exemplo de chamada conceitual:
+
+```json
+{
+  "prompt": "skill-master, veja se existe uma skill para validar este deploy",
+  "activationMode": "balanced",
+  "riskTolerance": "normal"
+}
+```
+
+Saida esperada:
+
+```json
+{
+  "shouldActivate": true,
+  "personaOverlay": "Dev Senior Master",
+  "executionMode": "assist",
+  "safetyGates": [],
+  "learningOpportunity": false,
+  "notionUpdateNeeded": false
+}
+```
+
+Use `skill_master_activation_check` quando precisar apenas de uma decisao menor e retrocompativel de ativacao/recomendacao.
+
+Restricoes explicitas como `sem publicar`, `nao publicar` ou `nao publique` sao tratadas como execucao local. O router deve registrar `publication_explicitly_disabled` e nao pode transformar essa frase em autorizacao ou intencao de release.
 
 Ativacao explicita:
 
@@ -231,6 +316,11 @@ Cliente: chama skill_master_activation_check.
 Cliente: se ativar, chama skill_master_recommend ou segue as recomendacoes retornadas.
 ```
 
+Diagnostico importante:
+
+- `skill_master_list_sources` mostra `configPath`, `workspace` e se `workspaceRoots` esta configurado.
+- Se `workspaceRoots` estiver vazio, skills em `.codex/skills` do projeto nao serao catalogadas ate atualizar `sources.json` e reiniciar o processo MCP.
+
 ## Atualizacao automatica via npm
 
 Para instalacoes feitas por `npm install -g`, o caminho seguro de auto-update e executar `skill-master-update` fora do processo MCP.

package/VERSION.md

@@ -2,8 +2,8 @@
 
 Versão funcional planejada: `00.02`
 
-Versão técnica para empacotamento semântico: `0.0.6`
+Versão técnica para empacotamento semântico: `0.0.8`
 
 ## Observação
 
-O nome `00.02` será usado na comunicação e nos documentos. Para ferramentas que exigem SemVer, como npm e alguns fluxos de release, usar `0.0.6`.
+O nome `00.02` será usado na comunicação e nos documentos. Para ferramentas que exigem SemVer, como npm e alguns fluxos de release, usar `0.0.8`.

package/bin/lib/menu-core.mjs

@@ -0,0 +1,353 @@
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import process from 'node:process';
+
+const ANSI = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+};
+
+function colorize(text, color, enabled) {
+  return enabled ? `${color}${text}${ANSI.reset}` : text;
+}
+
+export function readJson(rootDir, relativePath) {
+  const target = join(rootDir, relativePath);
+  if (!existsSync(target)) {
+    return null;
+  }
+
+  return JSON.parse(readFileSync(target, 'utf8'));
+}
+
+export function readText(rootDir, relativePath) {
+  const target = join(rootDir, relativePath);
+  if (!existsSync(target)) {
+    return null;
+  }
+
+  return readFileSync(target, 'utf8').trim();
+}
+
+export function getMenuStatus(rootDir) {
+  const packageJson = readJson(rootDir, 'package.json');
+  const stableManifest = readJson(rootDir, 'manifests/channels/stable.json');
+  const versionText = readText(rootDir, 'VERSION.md');
+  const successLearningDir = process.env.SKILL_MASTER_SUCCESS_LEARNING_DIR
+    ?? join(process.env.SKILL_MASTER_HOME ?? join(process.env.HOME ?? process.env.USERPROFILE ?? '', '.skill-master'), 'data', 'success-learning');
+  const studyCandidates = readJson(rootDir, 'network/unapproved-skill-candidates.json');
+
+  return {
+    packageName: packageJson?.name ?? 'nao encontrado',
+    semver: packageJson?.version ?? 'nao encontrado',
+    manifestVersion: stableManifest?.version ?? 'nao encontrado',
+    manifestSemver: stableManifest?.semver ?? 'nao encontrado',
+    versionText,
+    rootDir,
+    pendingSuccessDrafts: countManifestFiles(successLearningDir),
+    studyCandidates: Array.isArray(studyCandidates?.candidates) ? studyCandidates.candidates.length : 0,
+  };
+}
+
+function countManifestFiles(directory) {
+  if (!directory || !existsSync(directory)) {
+    return 0;
+  }
+
+  let count = 0;
+  const visit = (current) => {
+    for (const entry of readdirSync(current, { withFileTypes: true })) {
+      const fullPath = join(current, entry.name);
+      if (entry.isDirectory()) visit(fullPath);
+      else if (entry.isFile() && entry.name === 'manifest.json') count += 1;
+    }
+  };
+
+  visit(directory);
+  return count;
+}
+
+export function buildMenuCommands({ rootDir, currentFile, nodeExecPath = process.execPath }) {
+  return [
+    {
+      key: 'status',
+      aliases: ['status'],
+      label: 'Status local',
+      description: 'Mostra versao local, manifesto e informacoes do pacote.',
+      command: nodeExecPath,
+      args: [currentFile, '--status'],
+    },
+    {
+      key: 'check',
+      aliases: ['check', 'gate'],
+      label: 'Rodar gate completo',
+      description: 'Executa build, testes e validacao de manifestos.',
+      command: 'npm',
+      args: ['run', 'check'],
+    },
+    {
+      key: 'build',
+      aliases: ['build'],
+      label: 'Rodar build',
+      description: 'Compila o projeto localmente.',
+      command: 'npm',
+      args: ['run', 'build'],
+    },
+    {
+      key: 'publicNpm',
+      aliases: ['public-npm', 'npm', 'registry'],
+      label: 'Validar pacote no npm publico',
+      description: 'Consulta a versao publicada em registry.npmjs.org.',
+      command: 'npm',
+      args: [
+        'view',
+        '@fprad0/skill-master-mcp',
+        'version',
+        '--registry=https://registry.npmjs.org',
+      ],
+    },
+    {
+      key: 'updateGlobal',
+      aliases: ['update', 'update-global'],
+      label: 'Atualizar pacote global via npm',
+      description: 'Atualiza a instalacao global e exige reinicio do cliente MCP.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-update.mjs')],
+      confirmMessage: 'Atualizar o pacote global agora?',
+    },
+    {
+      key: 'privateRegistry',
+      aliases: ['private-registry', 'private', 'github-packages'],
+      label: 'Configurar registry privado GitHub Packages',
+      description: 'Prepara o .npmrc e valida o acesso ao pacote privado.',
+      command: nodeExecPath,
+      args: ['scripts/configure-private-registry.mjs', '--validate'],
+      confirmMessage: 'Rodar a configuracao de registry privado agora?',
+    },
+    {
+      key: 'activationStatus',
+      aliases: ['activation-status', 'modo', 'modo-ativacao'],
+      label: 'Modo de ativacao atual',
+      description: 'Mostra o modo manual, balanced ou always-on-assisted configurado localmente.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--status'],
+    },
+    {
+      key: 'activationBalanced',
+      aliases: ['set-balanced', 'balanced'],
+      label: 'Usar modo balanced',
+      description: 'Define balanced como modo padrao de ativacao do Skill Master.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--set-mode', 'balanced'],
+    },
+    {
+      key: 'activationAlwaysOn',
+      aliases: ['set-always-on', 'always-on-assisted'],
+      label: 'Usar modo always-on-assisted',
+      description: 'Define avaliacao assistida quase sempre ativa, mantendo no-op quando nao houver ganho.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--set-mode', 'always-on-assisted'],
+      confirmMessage: 'Alterar o modo local para always-on-assisted?',
+    },
+    {
+      key: 'promptRecommendation',
+      aliases: ['recommend-prompt', 'recomendar-prompt', 'prompt-router'],
+      label: 'Ver recomendacao para um prompt',
+      description: 'Abre um fluxo interativo para avaliar um prompt pelo router local.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--route-prompt-interactive'],
+    },
+    {
+      key: 'successNotifications',
+      aliases: ['notifications', 'notificacoes', 'success-notifications'],
+      label: 'Notificacoes de skills aprendidas',
+      description: 'Mostra drafts pendentes, aprovacoes e skills externas para estudar.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--notify'],
+    },
+    {
+      key: 'studySkills',
+      aliases: ['study-skills', 'skills-estudo', 'estudar'],
+      label: 'Skills para estudar',
+      description: 'Lista skills externas e links de criadores ainda nao aprovados.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--study'],
+    },
+    {
+      key: 'approvalPackage',
+      aliases: ['approval-package', 'aprovar', 'pacote-aprovacao'],
+      label: 'Gerar pacote de aprovacao humana',
+      description: 'Cria um relatorio local para revisar e aprovar skills aprendidas.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--approval-package'],
+    },
+    {
+      key: 'markLearnedStudy',
+      aliases: ['mark-study', 'manter-estudo'],
+      label: 'Manter skill candidata para estudo',
+      description: 'Seleciona uma candidata e registra decisao de manter para estudo.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--mark-study-interactive'],
+    },
+    {
+      key: 'rejectLearnedSkill',
+      aliases: ['reject-skill', 'rejeitar-skill'],
+      label: 'Rejeitar skill candidata',
+      description: 'Seleciona uma candidata, registra rejeicao e preserva historico.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--reject-interactive'],
+      confirmMessage: 'Abrir fluxo para rejeitar uma skill candidata?',
+    },
+    {
+      key: 'activateLearnedLocal',
+      aliases: ['activate-learned-local', 'ativar-local', 'skill-local'],
+      label: 'Ativar skill aprendida no workspace',
+      description: 'Instala uma skill aprendida em .codex/skills do projeto atual.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--activate-interactive', '--target', 'local'],
+      confirmMessage: 'Selecionar e ativar uma skill aprendida no workspace atual?',
+    },
+    {
+      key: 'activateLearnedGlobal',
+      aliases: ['activate-learned-global', 'ativar-global', 'skill-global'],
+      label: 'Ativar skill aprendida global',
+      description: 'Instala uma skill aprendida em CODEX_HOME/skills ou ~/.codex/skills.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-success-skills.mjs'), '--activate-interactive', '--target', 'global'],
+      confirmMessage: 'Selecionar e ativar uma skill aprendida como skill global deste usuario?',
+    },
+    {
+      key: 'notionSummary',
+      aliases: ['notion-summary', 'resumo-notion'],
+      label: 'Abrir resumo para Notion',
+      description: 'Mostra um resumo copiavel do estado de ativacao para registrar no ledger Notion.',
+      command: nodeExecPath,
+      args: [join(rootDir, 'bin', 'skill-master-activation.mjs'), '--notion-summary'],
+    },
+  ];
+}
+
+export function buildMenuChoices(commands) {
+  return commands.map((command) => ({
+    title: command.label,
+    description: command.description,
+    value: command.key,
+  })).concat({
+    title: 'Sair',
+    description: 'Fecha o menu operacional.',
+    value: '__exit__',
+  });
+}
+
+export function resolveActionKey(input, commands) {
+  const normalized = (input ?? '').trim().toLowerCase();
+  if (!normalized) {
+    return null;
+  }
+
+  return commands.find((command) =>
+    command.key.toLowerCase() === normalized || command.aliases.includes(normalized),
+  )?.key ?? null;
+}
+
+export function isInteractiveTerminal() {
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY);
+}
+
+export function formatStatusReport(status) {
+  const lines = [
+    'Skill Master MCP - status local',
+    `Diretorio: ${status.rootDir}`,
+    `Pacote: ${status.packageName}`,
+    `Semver local: ${status.semver}`,
+    `Manifesto stable: ${status.manifestVersion}`,
+    `Manifesto semver: ${status.manifestSemver}`,
+    `Drafts de skills aprendidas: ${status.pendingSuccessDrafts}`,
+    `Skills externas para estudar: ${status.studyCandidates}`,
+  ];
+
+  if (status.versionText) {
+    lines.push('', 'VERSION.md:');
+    lines.push(...status.versionText.split('\n').slice(0, 6));
+  }
+
+  return lines.join('\n');
+}
+
+function renderPanelLines(lines, { color = ANSI.cyan, useColor = false } = {}) {
+  const width = Math.max(...lines.map((line) => line.length), 24);
+  const border = `+${'-'.repeat(width + 2)}+`;
+  const paintedBorder = colorize(border, color, useColor);
+  const body = lines.map((line) => `| ${line.padEnd(width)} |`);
+  return [paintedBorder, ...body, paintedBorder].join('\n');
+}
+
+export function formatMenuBanner(status, { useColor = false } = {}) {
+  const lines = [
+    colorize('Skill Master MCP', ANSI.bold, useColor),
+    'Menu operacional para manutencao local',
+    `Versao local ${status.semver}  |  canal ${status.manifestVersion}`,
+    `Pendencias: ${status.pendingSuccessDrafts} drafts  |  estudo: ${status.studyCandidates} links`,
+    colorize('Setas + Enter para navegar', ANSI.dim, useColor),
+  ];
+  return renderPanelLines(lines, { color: ANSI.cyan, useColor });
+}
+
+export function formatActionHeader(action, { useColor = false } = {}) {
+  return renderPanelLines(
+    [
+      colorize(action.label, ANSI.bold, useColor),
+      action.description,
+    ],
+    { color: ANSI.green, useColor },
+  );
+}
+
+export function formatResultMessage(code, { useColor = false } = {}) {
+  if (code === 0) {
+    return colorize('Comando concluido com sucesso.', ANSI.green, useColor);
+  }
+
+  return colorize(`Comando terminou com codigo ${code}.`, ANSI.red, useColor);
+}
+
+export function formatHelp(commands) {
+  const actionList = commands.map((command) => `  - ${command.key}: ${command.label}`).join('\n');
+
+  return `Skill Master Menu
+
+Uso:
+  skill-master-menu
+  skill-master-menu --status
+  skill-master-menu --run <acao>
+  skill-master-menu --run update --yes
+  skill-master-menu --help
+
+Acoes disponiveis:
+${actionList}
+
+O comando de menu e voltado para operacao humana. O binario MCP stdio continua sendo:
+  skill-master-mcp
+`;
+}
+
+export function runCommand(action, { cwd, env = process.env } = {}) {
+  return new Promise((resolve) => {
+    const child = spawn(action.command, action.args, {
+      cwd,
+      env,
+      shell: process.platform === 'win32',
+      stdio: 'inherit',
+    });
+
+    child.on('close', (code) => {
+      resolve(code ?? 1);
+    });
+  });
+}