@fprad0/skill-master-mcp 0.0.4 → 0.0.5

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.5] - 2026-06-26
+
+- Add `skill-master-update` to update the global npm installation safely outside the MCP stdio process.
+- Add a `skill-master-menu` option to run the global npm update flow.
+- Document npm-based auto-update usage for operators and scheduled tasks.
+
 ## [0.0.4] - 2026-06-26
 
 - Add `skill_master_activation_check` to decide when the MCP should activate for a prompt.

package/README.md

@@ -108,16 +108,17 @@ 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`
+- 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
 
-O pacote `0.0.3` adiciona o menu operacional. Depois da publicacao dessa versao, os comandos globais principais ficam:
+Comandos globais principais:
 
 ```bash
 skill-master-mcp
 skill-master-menu
+skill-master-update
 skill-master-configure-private-registry
 ```
 
@@ -127,6 +128,20 @@ O `skill-master-mcp` deve continuar reservado para clientes MCP via `stdio`. Par
 skill-master-menu
 ```
 
+Para atualizar a instalacao global via npm sem iniciar o servidor MCP:
+
+```bash
+skill-master-update
+```
+
+Esse comando executa o equivalente a:
+
+```bash
+npm install -g @fprad0/skill-master-mcp@latest --registry=https://registry.npmjs.org
+```
+
+Use `skill-master-update` antes de abrir ou depois de fechar o cliente MCP. Evite atualizar o pacote enquanto `skill-master-mcp` esta rodando em `stdio`, porque o cliente pode manter o processo antigo carregado ate ser reiniciado.
+
 Leia:
 
 - [Guia de publicacao no npm publico](docs/operations/GUIA_NPM_PUBLICO.md)
@@ -214,6 +229,41 @@ Cliente: chama skill_master_activation_check.
 Cliente: se ativar, chama skill_master_recommend ou segue as recomendacoes retornadas.
 ```
 
+## 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.
+
+Uso manual:
+
+```bash
+skill-master-update
+```
+
+Uso em agendamento Linux/macOS:
+
+```bash
+skill-master-update
+```
+
+Uso em agendamento Windows:
+
+```powershell
+skill-master-update
+```
+
+Validacao sem aplicar update:
+
+```bash
+skill-master-update --dry-run
+```
+
+Regra operacional:
+
+- nao atualizar dentro do processo `skill-master-mcp` em `stdio`
+- atualizar antes de iniciar o cliente MCP ou em janela agendada
+- reiniciar Codex, Claude, Gemini ou outro cliente MCP depois da atualizacao
+- para desenvolvimento com clone, continuar usando o launcher por manifesto e `git pull --ff-only`
+
 ## Arquivos principais
 
 - [Plano geral](docs/PLANO_SKILL_MASTER_00_01.md)

package/VERSION.md

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

package/bin/skill-master-menu.mjs

@@ -35,6 +35,11 @@ const commands = {
       '--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,
@@ -47,7 +52,8 @@ const menuItems = [
   ['2', commands.check],
   ['3', commands.build],
   ['4', commands.publicNpm],
-  ['5', commands.privateRegistry],
+  ['5', commands.updateGlobal],
+  ['6', commands.privateRegistry],
 ];
 
 function readJson(relativePath) {
@@ -76,6 +82,9 @@ Uso:
   skill-master-menu --status
   skill-master-menu --help
 
+Opcao 5 do menu:
+  atualiza o pacote global com npm install -g @fprad0/skill-master-mcp@latest
+
 O comando de menu e voltado para operacao humana. O binario MCP stdio continua sendo:
   skill-master-mcp
 `);

package/bin/skill-master-update.mjs

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+
+import { spawn } from 'node:child_process';
+
+const DEFAULT_PACKAGE = '@fprad0/skill-master-mcp@latest';
+const DEFAULT_REGISTRY = 'https://registry.npmjs.org';
+
+function printHelp() {
+  console.log(`Skill Master Update
+
+Uso:
+  skill-master-update
+  skill-master-update --dry-run
+  skill-master-update --package @fprad0/skill-master-mcp@latest
+  skill-master-update --registry https://registry.npmjs.org
+
+Este comando atualiza a instalacao global via npm. Ele deve ser executado fora
+do processo MCP stdio para evitar substituir arquivos enquanto o servidor esta
+em uso por um cliente.
+`);
+}
+
+function readOption(args, name, fallback) {
+  const index = args.indexOf(name);
+  if (index === -1) {
+    return fallback;
+  }
+
+  return args[index + 1] || fallback;
+}
+
+function buildInstallArgs(args) {
+  const packageName = readOption(args, '--package', DEFAULT_PACKAGE);
+  const registry = readOption(args, '--registry', DEFAULT_REGISTRY);
+  return ['install', '-g', packageName, `--registry=${registry}`];
+}
+
+function run(command, args) {
+  return new Promise((resolve) => {
+    console.log(`> ${command} ${args.join(' ')}`);
+    const child = spawn(command, args, {
+      env: process.env,
+      shell: process.platform === 'win32',
+      stdio: 'inherit',
+    });
+
+    child.on('close', (code) => resolve(code ?? 1));
+  });
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.includes('--help') || args.includes('-h')) {
+    printHelp();
+    return 0;
+  }
+
+  const installArgs = buildInstallArgs(args);
+
+  if (args.includes('--dry-run')) {
+    console.log(['npm', ...installArgs].join(' '));
+    return 0;
+  }
+
+  console.log('Atualizando Skill Master MCP por npm global.');
+  console.log('Feche/reinicie clientes MCP depois da atualizacao para carregar a nova versao.\n');
+
+  return run('npm', installArgs);
+}
+
+process.exitCode = await main();

package/manifests/channels/beta.json

@@ -2,12 +2,12 @@
   "name": "skill_master",
   "channel": "beta",
   "version": "00.02-beta",
-  "semver": "0.0.4",
-  "publishedAt": "2026-06-26T14:10:00-03:00",
+  "semver": "0.0.5",
+  "publishedAt": "2026-06-26T14:35:00-03:00",
   "git": {
     "repo": "https://github.com/FPrad0/skill-master-mcp",
     "branch": "main",
-    "commit": "545b4bb"
+    "commit": "af41244"
   },
   "node": {
     "minimum": "18.0.0"
@@ -19,7 +19,7 @@
     "buildCommand": "npm run build"
   },
   "changelog": [
-    "Canal beta acompanha a nova avaliacao de ativacao por prompt.",
-    "Clientes podem chamar skill_master_activation_check antes de decidir usar recomendacoes de skills."
+    "Canal beta acompanha o novo comando skill-master-update.",
+    "Update npm fica disponivel via comando separado e pelo menu operacional."
   ]
 }

package/manifests/channels/stable.json

@@ -2,12 +2,12 @@
   "name": "skill_master",
   "channel": "stable",
   "version": "00.02",
-  "semver": "0.0.4",
-  "publishedAt": "2026-06-26T14:10:00-03:00",
+  "semver": "0.0.5",
+  "publishedAt": "2026-06-26T14:35:00-03:00",
   "git": {
     "repo": "https://github.com/FPrad0/skill-master-mcp",
     "branch": "main",
-    "commit": "545b4bb"
+    "commit": "af41244"
   },
   "node": {
     "minimum": "18.0.0"
@@ -19,8 +19,8 @@
     "buildCommand": "npm run build"
   },
   "changelog": [
-    "Nova tool skill_master_activation_check para decidir ativacao por prompt.",
-    "Aliases explicitos suportados: skill-master, skill_master e skill-master-mcp.",
-    "Ativacao inferida quando o catalogo encontra skills relevantes para a tarefa."
+    "Novo binario skill-master-update para atualizar instalacao global via npm.",
+    "Menu operacional passa a incluir opcao de update global seguro.",
+    "Fluxo evita atualizar arquivos durante execucao do servidor MCP stdio."
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fprad0/skill-master-mcp",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "private": false,
   "type": "module",
   "description": "Personal MCP server that catalogs, recommends and reports skills with update-aware metadata.",
@@ -8,7 +8,8 @@
   "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"
+    "skill-master-mcp": "./bin/skill-master.mjs",
+    "skill-master-update": "./bin/skill-master-update.mjs"
   },
   "files": [
     "bin",