@fprad0/skill-master-mcp 0.0.6 → 0.0.7

package/CHANGELOG.md

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

@@ -110,8 +110,8 @@ npx -y @fprad0/skill-master-mcp@latest
 
 Estado atual validado em `2026-06-26`:
 
-- pacote publico publicado: `@fprad0/skill-master-mcp@0.0.5`
-- dist-tag `latest` apontando para `0.0.5`
+- pacote publico publicado: `@fprad0/skill-master-mcp@0.0.7`
+- dist-tag `latest` apontando para `0.0.7`
 - workflow `Publish Skill Master to npmjs` concluido com sucesso
 - `npm install` e `npx` confirmados
 
@@ -130,6 +130,16 @@ 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
+```
+
+O menu visual usa `prompts` para ficar mais legivel no terminal e manter compatibilidade com `Node 18+`.
+
 Para atualizar a instalacao global via npm sem iniciar o servidor MCP:
 
 ```bash

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.7`
 
 ## 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.7`.

package/bin/lib/menu-core.mjs

@@ -0,0 +1,227 @@
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync } 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');
+
+  return {
+    packageName: packageJson?.name ?? 'nao encontrado',
+    semver: packageJson?.version ?? 'nao encontrado',
+    manifestVersion: stableManifest?.version ?? 'nao encontrado',
+    manifestSemver: stableManifest?.semver ?? 'nao encontrado',
+    versionText,
+    rootDir,
+  };
+}
+
+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?',
+    },
+  ];
+}
+
+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}`,
+  ];
+
+  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}`,
+    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);
+    });
+  });
+}

package/bin/skill-master-menu.mjs

@@ -1,179 +1,172 @@
 #!/usr/bin/env node
 
-import { spawn } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
+import prompts from 'prompts';
+import { dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { createInterface } from 'node:readline/promises';
-import { stdin as input, stdout as output } from 'node:process';
-
-const rootDir = dirname(dirname(fileURLToPath(import.meta.url)));
-
-const commands = {
-  status: {
-    label: 'Mostrar status local',
-    command: process.execPath,
-    args: [fileURLToPath(import.meta.url), '--status'],
-  },
-  check: {
-    label: 'Rodar gate completo',
-    command: 'npm',
-    args: ['run', 'check'],
-  },
-  build: {
-    label: 'Rodar build',
-    command: 'npm',
-    args: ['run', 'build'],
-  },
-  publicNpm: {
-    label: 'Validar pacote no npm publico',
-    command: 'npm',
-    args: [
-      'view',
-      '@fprad0/skill-master-mcp',
-      'version',
-      '--registry=https://registry.npmjs.org',
-    ],
-  },
-  updateGlobal: {
-    label: 'Atualizar pacote global via npm',
-    command: process.execPath,
-    args: [join(rootDir, 'bin', 'skill-master-update.mjs')],
-  },
-  privateRegistry: {
-    label: 'Configurar registry privado GitHub Packages',
-    command: process.execPath,
-    args: ['scripts/configure-private-registry.mjs', '--validate'],
-  },
-};
-
-const menuItems = [
-  ['1', commands.status],
-  ['2', commands.check],
-  ['3', commands.build],
-  ['4', commands.publicNpm],
-  ['5', commands.updateGlobal],
-  ['6', commands.privateRegistry],
-];
-
-function readJson(relativePath) {
-  const target = join(rootDir, relativePath);
-  if (!existsSync(target)) {
-    return null;
+import {
+  buildMenuChoices,
+  buildMenuCommands,
+  formatActionHeader,
+  formatHelp,
+  formatMenuBanner,
+  formatResultMessage,
+  formatStatusReport,
+  getMenuStatus,
+  isInteractiveTerminal,
+  resolveActionKey,
+  runCommand,
+} from './lib/menu-core.mjs';
+
+const currentFile = fileURLToPath(import.meta.url);
+const rootDir = dirname(dirname(currentFile));
+const commands = buildMenuCommands({ rootDir, currentFile });
+
+function parseArgs(argv) {
+  const parsed = {
+    help: false,
+    status: false,
+    yes: false,
+    run: null,
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    switch (arg) {
+      case '--help':
+      case '-h':
+        parsed.help = true;
+        break;
+      case '--status':
+        parsed.status = true;
+        break;
+      case '--yes':
+        parsed.yes = true;
+        break;
+      case '--run':
+        parsed.run = argv[++i] ?? null;
+        break;
+      default:
+        throw new Error(`Unknown argument: ${arg}`);
+    }
   }
 
-  return JSON.parse(readFileSync(target, 'utf8'));
+  return parsed;
 }
 
-function readText(relativePath) {
-  const target = join(rootDir, relativePath);
-  if (!existsSync(target)) {
-    return null;
-  }
+function printHelp() {
+  console.log(formatHelp(commands));
+}
 
-  return readFileSync(target, 'utf8').trim();
+function printStatus() {
+  console.log(formatStatusReport(getMenuStatus(rootDir)));
 }
 
-function printHelp() {
-  console.log(`Skill Master Menu
+async function runSelectedAction(action, { yes = false, useColor = false } = {}) {
+  if (action.confirmMessage && !yes) {
+    if (!isInteractiveTerminal()) {
+      throw new Error(`Action ${action.key} requires --yes outside an interactive terminal.`);
+    }
 
-Uso:
-  skill-master-menu
-  skill-master-menu --status
-  skill-master-menu --help
+    const confirmation = await prompts({
+      type: 'confirm',
+      name: 'confirmed',
+      message: action.confirmMessage,
+      initial: false,
+    });
 
-Opcao 5 do menu:
-  atualiza o pacote global com npm install -g @fprad0/skill-master-mcp@latest
+    if (!confirmation.confirmed) {
+      return { cancelled: true, code: 0 };
+    }
+  }
 
-O comando de menu e voltado para operacao humana. O binario MCP stdio continua sendo:
-  skill-master-mcp
-`);
+  console.log('');
+  console.log(formatActionHeader(action, { useColor }));
+  console.log('');
+  const code = await runCommand(action, { cwd: rootDir });
+  console.log('');
+  console.log(formatResultMessage(code, { useColor }));
+  return { cancelled: false, code };
 }
 
-function printStatus() {
-  const packageJson = readJson('package.json');
-  const stableManifest = readJson('manifests/channels/stable.json');
-  const versionText = readText('VERSION.md');
-
-  console.log('Skill Master MCP - status local');
-  console.log(`Diretorio: ${rootDir}`);
-  console.log(`Pacote: ${packageJson?.name ?? 'nao encontrado'}`);
-  console.log(`Semver local: ${packageJson?.version ?? 'nao encontrado'}`);
-  console.log(`Manifesto stable: ${stableManifest?.version ?? 'nao encontrado'}`);
-  console.log(`Manifesto semver: ${stableManifest?.semver ?? 'nao encontrado'}`);
-
-  if (versionText) {
-    const firstLines = versionText.split('\n').slice(0, 6).join('\n');
-    console.log('\nVERSION.md:');
-    console.log(firstLines);
-  }
-}
+async function runVisualMenu() {
+  while (true) {
+    console.clear();
+    const status = getMenuStatus(rootDir);
+    console.log(formatMenuBanner(status, { useColor: true }));
+    console.log('');
+
+    const selection = await prompts({
+      type: 'select',
+      name: 'action',
+      message: 'Escolha uma acao',
+      choices: buildMenuChoices(commands),
+      initial: 0,
+    });
 
-function runCommand(commandConfig) {
-  return new Promise((resolve) => {
-    console.log(`\n> ${commandConfig.command} ${commandConfig.args.join(' ')}\n`);
+    if (!selection.action || selection.action === '__exit__') {
+      return 0;
+    }
 
-    const child = spawn(commandConfig.command, commandConfig.args, {
-      cwd: rootDir,
-      env: process.env,
-      shell: process.platform === 'win32',
-      stdio: 'inherit',
-    });
+    const action = commands.find((entry) => entry.key === selection.action);
+    if (!action) {
+      return 1;
+    }
 
-    child.on('close', (code) => {
-      resolve(code ?? 1);
+    const result = await runSelectedAction(action, { useColor: true });
+    if (result.cancelled) {
+      continue;
+    }
+
+    const nextStep = await prompts({
+      type: 'toggle',
+      name: 'keepGoing',
+      message: 'Voltar ao menu?',
+      initial: true,
+      active: 'sim',
+      inactive: 'nao',
     });
-  });
-}
 
-async function runInteractiveMenu() {
-  const rl = createInterface({ input, output });
-
-  try {
-    while (true) {
-      console.log('\nSkill Master Menu');
-      for (const [key, item] of menuItems) {
-        console.log(`  ${key}. ${item.label}`);
-      }
-      console.log('  0. Sair');
-
-      const answer = (await rl.question('\nEscolha uma opcao: ')).trim();
-
-      if (answer === '0' || answer.toLowerCase() === 'q') {
-        return 0;
-      }
-
-      const selected = menuItems.find(([key]) => key === answer)?.[1];
-      if (!selected) {
-        console.log('Opcao invalida.');
-        continue;
-      }
-
-      const code = await runCommand(selected);
-      if (code !== 0) {
-        console.log(`\nComando terminou com codigo ${code}.`);
-      }
+    if (!nextStep.keepGoing) {
+      return result.code;
     }
-  } finally {
-    rl.close();
   }
 }
 
 async function main() {
-  const args = process.argv.slice(2);
+  const args = parseArgs(process.argv.slice(2));
 
-  if (args.includes('--help') || args.includes('-h')) {
+  if (args.help) {
     printHelp();
     return 0;
   }
 
-  if (args.includes('--status')) {
+  if (args.status) {
     printStatus();
     return 0;
   }
 
-  return runInteractiveMenu();
+  if (args.run) {
+    const actionKey = resolveActionKey(args.run, commands);
+    if (!actionKey) {
+      throw new Error(`Unknown action: ${args.run}`);
+    }
+
+    const action = commands.find((entry) => entry.key === actionKey);
+    const result = await runSelectedAction(action, { yes: args.yes, useColor: isInteractiveTerminal() });
+    return result.code;
+  }
+
+  if (!isInteractiveTerminal()) {
+    throw new Error('Interactive menu requires a TTY. Use --run <acao> or --status in automated environments.');
+  }
+
+  return runVisualMenu();
 }
 
-const exitCode = await main();
-process.exitCode = exitCode;
+try {
+  process.exitCode = await main();
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`[skill_master] ${message}\n`);
+  process.exitCode = 1;
+}

package/manifests/channels/beta.json

@@ -2,12 +2,12 @@
   "name": "skill_master",
   "channel": "beta",
   "version": "00.02-beta",
-  "semver": "0.0.6",
-  "publishedAt": "2026-06-26T16:45:00-03:00",
+  "semver": "0.0.7",
+  "publishedAt": "2026-06-26T20:15:00-03:00",
   "git": {
     "repo": "https://github.com/FPrad0/skill-master-mcp",
     "branch": "main",
-    "commit": "c203ead"
+    "commit": "ec57c95"
   },
   "node": {
     "minimum": "18.0.0"
@@ -19,7 +19,7 @@
     "buildCommand": "npm run build"
   },
   "changelog": [
-    "Canal beta acompanha o configurador privado mais seguro.",
-    "Fluxos de token passam a suportar arquivo, stdin e armazenamento literal somente com opt-in."
+    "Canal beta acompanha o menu visual no terminal.",
+    "Fluxo interativo agora tem selecao visual, confirmacao e modo direto por acao."
   ]
 }

package/manifests/channels/stable.json

@@ -2,12 +2,12 @@
   "name": "skill_master",
   "channel": "stable",
   "version": "00.02",
-  "semver": "0.0.6",
-  "publishedAt": "2026-06-26T16:45:00-03:00",
+  "semver": "0.0.7",
+  "publishedAt": "2026-06-26T20:15:00-03:00",
   "git": {
     "repo": "https://github.com/FPrad0/skill-master-mcp",
     "branch": "main",
-    "commit": "c203ead"
+    "commit": "ec57c95"
   },
   "node": {
     "minimum": "18.0.0"
@@ -19,8 +19,8 @@
     "buildCommand": "npm run build"
   },
   "changelog": [
-    "Configurador privado passa a gravar referencia de variavel de ambiente por padrao.",
-    "Validacao de registry HTTPS, backups com timestamp, dry-run redigido e permissao 0600 em POSIX.",
-    "Novas entradas --token-file, --token-stdin e --store-token."
+    "Menu operacional ganha interface visual no terminal com prompts.",
+    "Core do menu foi extraido para modulo reutilizavel e testavel.",
+    "Compatibilidade Node 18+ foi preservada sem migrar para TUI pesada."
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fprad0/skill-master-mcp",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "private": false,
   "type": "module",
   "description": "Personal MCP server that catalogs, recommends and reports skills with update-aware metadata.",
@@ -51,6 +51,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "prompts": "^2.4.2",
     "zod": "^4.4.3"
   },
   "devDependencies": {