@fprad0/skill-master-mcp 0.0.2 → 0.0.3

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.3] - 2026-06-26
+
+- Add `skill-master-menu` as a human-facing CLI for local status, checks, build, public npm validation, and private registry setup.
+- Keep `skill-master-mcp` reserved for MCP clients over `stdio`.
+- Document public npm install state and global commands.
+
 ## [0.0.2] - 2026-06-25
 
 - Add private-registry setup helpers for Windows, Linux, and Node-based package flows.

package/README.md

@@ -10,14 +10,15 @@ Criar um MCP capaz de catalogar skills locais e remotas, recomendar as melhores
 
 ## Decisao da versao 00.02
 
-A versao `00.02` consolida a distribuicao multiplataforma e o pacote privado:
+A versao `00.02` consolida:
 
-- repositorio pessoal no GitHub como fonte de verdade
+- distribuicao publica por `npmjs.org`
+- distribuicao privada por GitHub Packages
 - manifesto remoto de versao e canal
 - launcher local com verificacao de atualizacao
 - atualizacao por `git pull --ff-only` quando o diretorio estiver limpo
 - fallback seguro quando houver alteracoes locais
-- arquitetura preparada para pacote npm privado, GitHub Releases e MCP remoto no futuro
+- arquitetura preparada para MCP remoto no futuro
 
 ## Compatibilidade atual
 
@@ -25,32 +26,38 @@ O projeto agora possui fluxo operacional para:
 
 - Windows: `scripts/install-skill-master.ps1`, `scripts/update-skill-master.ps1`, `scripts/skill-master-launcher.ps1`
 - Linux: `scripts/install-skill-master.sh`, `scripts/update-skill-master.sh`, `scripts/skill-master-launcher.sh`
-- Clientes AI: Codex, Claude Desktop, Claude Code, Gemini CLI, Gemini Code Assist e clientes MCP genericos via stdio
+- clientes AI: Codex, Claude Desktop, Claude Code, Gemini CLI, Gemini Code Assist e clientes MCP genericos via stdio
 
-Requisitos praticos nos dois ambientes:
+Requisitos praticos:
 
-- `git`
+- `git` para o modo clone + launcher
 - `node` `18+`
 - `npm`
-- acesso ao repositorio GitHub configurado
+- acesso ao repositorio GitHub configurado no fluxo privado
 
 ## Instalacao rapida
 
 ### Windows
 
 ```powershell
-powershell -ExecutionPolicy Bypass -File scripts/install-skill-master.ps1
+npm install -g @fprad0/skill-master-mcp
 ```
 
-### Linux
+### Linux / macOS
 
 ```bash
-bash scripts/install-skill-master.sh
+npm install -g @fprad0/skill-master-mcp
+```
+
+Se a ideia for apenas testar sem install global:
+
+```bash
+npx -y @fprad0/skill-master-mcp@latest
 ```
 
 ## Instalacao via pacote privado
 
-O projeto agora tambem pode ser distribuido como pacote privado via GitHub Packages.
+O projeto tambem pode ser distribuido como pacote privado via GitHub Packages.
 
 Nome do pacote:
 
@@ -64,7 +71,7 @@ Fluxo resumido:
 2. configurar o cliente MCP para executar `npx -y @fprad0/skill-master-mcp@latest`;
 3. reiniciar o cliente.
 
-Atalho operacional:
+Atalhos operacionais:
 
 - Windows: `powershell -ExecutionPolicy Bypass -File .\scripts\configure-private-registry.ps1 -Validate`
 - Linux: `bash ./scripts/configure-private-registry.sh --validate`
@@ -87,17 +94,38 @@ Leia:
 
 ## Instalacao via npm publico
 
-O repositório agora tambem pode ser preparado para distribuicao por `npmjs.org`, que e o caminho necessario para chegar em instalacao simples com:
+O pacote publico ja esta disponivel em `npmjs.org`.
+
+Comandos principais:
 
 ```bash
 npm install -g @fprad0/skill-master-mcp
 ```
 
-Estado atual:
+```bash
+npx -y @fprad0/skill-master-mcp@latest
+```
+
+Estado atual validado em `2026-06-26`:
+
+- pacote publico publicado: `@fprad0/skill-master-mcp@0.0.2`
+- dist-tag `latest` apontando para `0.0.2`
+- workflow `Publish Skill Master to npmjs` concluido com sucesso
+- `npm install` e `npx` confirmados
+
+O pacote `0.0.3` adiciona o menu operacional. Depois da publicacao dessa versao, os comandos globais principais ficam:
 
-- o fluxo de publicacao publica foi preparado no repositório;
-- o pacote `0.0.2` ainda nao esta publicado no npm publico neste momento;
-- enquanto isso nao acontecer, o install simples por `npm install` continua bloqueado pelo uso de GitHub Packages privado.
+```bash
+skill-master-mcp
+skill-master-menu
+skill-master-configure-private-registry
+```
+
+O `skill-master-mcp` deve continuar reservado para clientes MCP via `stdio`. Para operacao humana, status local e checks, use:
+
+```bash
+skill-master-menu
+```
 
 Leia:
 
@@ -118,7 +146,7 @@ Os dois caminhos configuram:
 
 ## Compatibilidade com Claude e Gemini
 
-A versao `00.02` documenta compatibilidade operacional com:
+A versao `00.02` documenta compatibilidade operacional ja preparada para:
 
 - Claude Desktop
 - Claude Code
@@ -136,11 +164,11 @@ Leia:
 
 O `skill_master` pode aprender com as skills ja existentes em cada maquina instalada, mas o compartilhamento entre computadores segue um fluxo seguro:
 
-- catalogo local automatico;
-- deduplicacao por nome e hash;
-- pacote local de contribuicao;
-- revisao de risco e privacidade;
-- aprovacao humana antes de qualquer distribuicao.
+- catalogo local automatico
+- deduplicacao por nome e hash
+- pacote local de contribuicao
+- revisao de risco e privacidade
+- aprovacao humana antes de qualquer distribuicao
 
 Ferramentas MCP principais:
 

package/VERSION.md

@@ -2,8 +2,8 @@
 
 Versão funcional planejada: `00.02`
 
-Versão técnica para empacotamento semântico: `0.0.2`
+Versão técnica para empacotamento semântico: `0.0.3`
 
 ## 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.2`.
+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.3`.

package/bin/skill-master-menu.mjs

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } 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',
+    ],
+  },
+  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.privateRegistry],
+];
+
+function readJson(relativePath) {
+  const target = join(rootDir, relativePath);
+  if (!existsSync(target)) {
+    return null;
+  }
+
+  return JSON.parse(readFileSync(target, 'utf8'));
+}
+
+function readText(relativePath) {
+  const target = join(rootDir, relativePath);
+  if (!existsSync(target)) {
+    return null;
+  }
+
+  return readFileSync(target, 'utf8').trim();
+}
+
+function printHelp() {
+  console.log(`Skill Master Menu
+
+Uso:
+  skill-master-menu
+  skill-master-menu --status
+  skill-master-menu --help
+
+O comando de menu e voltado para operacao humana. O binario MCP stdio continua sendo:
+  skill-master-mcp
+`);
+}
+
+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);
+  }
+}
+
+function runCommand(commandConfig) {
+  return new Promise((resolve) => {
+    console.log(`\n> ${commandConfig.command} ${commandConfig.args.join(' ')}\n`);
+
+    const child = spawn(commandConfig.command, commandConfig.args, {
+      cwd: rootDir,
+      env: process.env,
+      shell: process.platform === 'win32',
+      stdio: 'inherit',
+    });
+
+    child.on('close', (code) => {
+      resolve(code ?? 1);
+    });
+  });
+}
+
+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}.`);
+      }
+    }
+  } finally {
+    rl.close();
+  }
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.includes('--help') || args.includes('-h')) {
+    printHelp();
+    return 0;
+  }
+
+  if (args.includes('--status')) {
+    printStatus();
+    return 0;
+  }
+
+  return runInteractiveMenu();
+}
+
+const exitCode = await main();
+process.exitCode = exitCode;

package/manifests/channels/beta.json

@@ -2,12 +2,12 @@
   "name": "skill_master",
   "channel": "beta",
   "version": "00.02-beta",
-  "semver": "0.0.2",
-  "publishedAt": "2026-06-25T18:40:33-03:00",
+  "semver": "0.0.3",
+  "publishedAt": "2026-06-26T13:05:00-03:00",
   "git": {
     "repo": "https://github.com/FPrad0/skill-master-mcp",
     "branch": "main",
-    "commit": "1a3cf8c"
+    "commit": "933b9fe"
   },
   "node": {
     "minimum": "18.0.0"
@@ -19,7 +19,7 @@
     "buildCommand": "npm run build"
   },
   "changelog": [
-    "Canal beta acompanha a base 00.02 com helper do registry privado no pacote.",
-    "Documentacao operacional e exemplos de clientes passam a viajar no tarball."
+    "Canal beta acompanha o novo binario skill-master-menu.",
+    "Menu operacional permite status, checks, build e validacoes npm sem afetar o servidor MCP stdio."
   ]
 }

package/manifests/channels/stable.json

@@ -2,12 +2,12 @@
   "name": "skill_master",
   "channel": "stable",
   "version": "00.02",
-  "semver": "0.0.2",
-  "publishedAt": "2026-06-25T18:40:33-03:00",
+  "semver": "0.0.3",
+  "publishedAt": "2026-06-26T13:05:00-03:00",
   "git": {
     "repo": "https://github.com/FPrad0/skill-master-mcp",
     "branch": "main",
-    "commit": "1a3cf8c"
+    "commit": "933b9fe"
   },
   "node": {
     "minimum": "18.0.0"
@@ -19,8 +19,8 @@
     "buildCommand": "npm run build"
   },
   "changelog": [
-    "Pacote privado agora inclui helper para configurar registry e validar acesso.",
-    "Tarball publicado passa a levar guias operacionais e exemplos de clientes MCP.",
-    "Gate npm run check volta a ser compativel com Node 18 ou superior."
+    "Novo binario skill-master-menu para operacao humana local.",
+    "Binario skill-master-mcp permanece reservado para clientes MCP via stdio.",
+    "README passa a documentar instalacao publica e comandos globais."
   ]
 }

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@fprad0/skill-master-mcp",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "private": false,
   "type": "module",
   "description": "Personal MCP server that catalogs, recommends and reports skills with update-aware metadata.",
   "main": "dist/index.js",
   "bin": {
     "skill-master-configure-private-registry": "./bin/skill-master-configure-private-registry.mjs",
+    "skill-master-menu": "./bin/skill-master-menu.mjs",
     "skill-master-mcp": "./bin/skill-master.mjs"
   },
   "files": [