@fprad0/skill-master-mcp 0.0.9 → 0.0.11

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to `skill_master` will be tracked here.
 
 ## [Unreleased]
 
+## [0.0.11] - 2026-06-28
+
+- Register MCP clients with an absolute Node.js executable plus the absolute `bin/skill-master.mjs` entrypoint, avoiding PATH-dependent startup failures in Windows, Linux, macOS, and desktop MCP clients.
+- Add shared client-config helpers, Codex/JSON config assessment, doctor reporting for robust vs legacy registration modes, and a menu action matrix verifier.
+- Add a second bundled global skill pack `v0.0.11` with more granular language, data, terminal, Git, OS, MCP client and UI/design skills for global installation.
+
+## [0.0.10] - 2026-06-28
+
+- Expand the bundled global skill catalog with frontend, backend, CLI, workstation, OpenAI docs, GitHub, design, Playwright, WinUI, language, math, physics, and MCP-building coverage.
+- Align the menu with the bundled catalog by showing bundle totals, domain counts, selected action metadata, and operational context directly in the TUI.
+- Fix the interactive menu return path so keyboard selection works again after running an action and returning to the menu.
+- Redesign the visual menu with cyberpunk-style procedural frames, a genome matrix panel, and telemetry windows while keeping low-flicker alternate-screen behavior.
+- Add `skill-master-doctor` coverage for package, PATH, bundled skills, and Codex, Claude, Gemini, and Antigravity registration checks.
+- Keep development-only actions disabled when the menu runs from a published npm package instead of a source checkout.
+
 ## [0.0.9] - 2026-06-28
 
 - Add Catholic-inspired moral governance with `skill_master_moral_discernment`, moral gates, and prompt-router integration.

package/README.md

@@ -108,17 +108,18 @@ npm install -g @fprad0/skill-master-mcp
 npx -y @fprad0/skill-master-mcp@latest
 ```
 
-Estado atual preparado em `2026-06-28`:
+Fluxo atual:
 
-- release publica: `@fprad0/skill-master-mcp@0.0.9`
-- `latest` no npmjs aponta para `0.0.9`
-- validacao de pacote por tarball local confirmada
-- validacao de instalacao publica via `npm install @fprad0/skill-master-mcp@0.0.9` confirmada
+- instalacao publica simples por `npm install -g @fprad0/skill-master-mcp`
+- execucao sem install global por `npx -y @fprad0/skill-master-mcp@latest`
+- validacao rapida da versao publicada por `npm view @fprad0/skill-master-mcp version --registry=https://registry.npmjs.org`
+- esta linha de release amplia o bundle global para `v0.0.11` e endurece o registro MCP multi-cliente com Node absoluto
 
 Comandos globais principais:
 
 ```bash
 skill-master-activation
+skill-master-doctor
 skill-master-eval-activation
 skill-master-install-global-skills
 skill-master-mcp
@@ -139,6 +140,7 @@ O menu agora possui modo visual interativo para terminal com TTY e tambem aceita
 
 ```bash
 skill-master-menu --run status
+skill-master-menu --run doctor
 skill-master-menu --run check
 skill-master-menu --run update --yes
 skill-master-menu --run install-global-skills
@@ -154,7 +156,15 @@ skill-master-menu --run notion-summary
 
 O menu visual usa `prompts` para ficar mais legivel no terminal e manter compatibilidade com `Node 18+`.
 
-Quando o menu detectar que o MCP ainda nao esta globalmente pronto neste computador, ele mostra um alerta forte e um aviso sutil explicando que a instalacao global e o registro dos clientes sao necessarios para o `skill_master` parecer parte do sistema em Codex, Claude e Gemini.
+Quando o menu detectar que o MCP ainda nao esta globalmente pronto neste computador, ele mostra um alerta forte e um aviso sutil explicando que a instalacao global e o registro dos clientes sao necessarios para o `skill_master` parecer parte do sistema em Codex, Claude, Gemini e Antigravity.
+
+Em instalacoes globais via npm, o menu tambem separa acoes operacionais de acoes de desenvolvimento. Acoes como `check` e `build` dependem do clone completo do repositorio; quando o pacote estiver instalado globalmente, use:
+
+```bash
+skill-master-menu --run doctor
+skill-master-menu --run status
+skill-master-menu --run bootstrap-global --yes
+```
 
 Para instalar as skills globais embutidas de discernimento, conhecimento amplo, engenharia e governanca moral:
 
@@ -162,27 +172,51 @@ Para instalar as skills globais embutidas de discernimento, conhecimento amplo,
 skill-master-install-global-skills
 ```
 
+No estado atual do pacote, esse bundle global tambem inclui cobertura para frontend, backend, CLI, terminal, GitHub, Windows/Linux, clientes MCP, design, Figma, Playwright, idiomas e raciocinio tecnico, usando uma combinacao de skills locais aprovadas e skills oficiais empacotadas em `docs/skill-candidates/v0.0.10` e `docs/skill-candidates/v0.0.11`.
+
+O pacote `v0.0.11` amplia a granularidade com skills dedicadas para TypeScript, Python, JavaScript, Java, Ruby, Go, SQL/PostgreSQL, contratos JSON, Git, shell/terminal, Windows/Linux, operacao multi-cliente MCP, componentes UI e sistemas web/mobile.
+
 Para fazer o bootstrap global completo em um passo:
 
 ```bash
 skill-master-bootstrap-global
 ```
 
-Para registrar o MCP nos clientes principais usando o binario global `skill-master-mcp`:
+Para registrar o MCP nos clientes principais, use o registrador. Ele grava `command` com o Node.js absoluto e `args` com o caminho absoluto de `bin/skill-master.mjs`, evitando falhas de `PATH` em Windows, Linux, macOS e apps desktop que nao herdam o terminal:
 
 ```bash
 skill-master-register-clients --apply-codex
 skill-master-register-clients --apply-claude
 skill-master-register-clients --apply-gemini
+skill-master-register-clients --apply-antigravity
 ```
 
-Atalho para gerar snippets e aplicar nos tres:
+Atalho para gerar snippets e aplicar nos clientes principais:
 
 ```bash
 skill-master-register-clients --apply-all
 ```
 
-Isso configura o servidor MCP `skill_master` em Codex, Claude Desktop e Gemini quando os arquivos de configuracao locais estiverem disponiveis. Reinicie o cliente depois do registro.
+Isso configura o servidor MCP `skill_master` em Codex, Claude Desktop, Gemini e Antigravity quando os arquivos de configuracao locais estiverem disponiveis. Reinicie o cliente depois do registro.
+
+Se um cliente ja tiver uma configuracao antiga por `skill-master-mcp`, `npx` ou launcher local e nao estiver iniciando, force a migracao para o modo robusto:
+
+```bash
+skill-master-register-clients --apply-all --force
+skill-master-menu --run doctor
+```
+
+No Codex, o bloco recomendado fica no formato:
+
+```toml
+[mcp_servers.skill_master]
+command = "/caminho/absoluto/para/node"
+args = ["/caminho/absoluto/para/bin/skill-master.mjs"]
+startup_timeout_sec = 120
+
+[mcp_servers.skill_master.env]
+SKILL_MASTER_UPDATE_CHANNEL = "stable"
+```
 
 O menu tambem mostra notificacoes de skills aprendidas pendentes e links externos para estudo. As acoes de ativacao sao:
 

package/VERSION.md

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

package/bin/lib/client-config.mjs

@@ -0,0 +1,268 @@
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import process from 'node:process';
+import { fileURLToPath } from 'node:url';
+
+export const DEFAULT_SERVER_ENV = {
+  SKILL_MASTER_UPDATE_CHANNEL: 'stable',
+};
+
+export function defaultClaudeConfigPath(home = os.homedir(), platform = process.platform) {
+  if (platform === 'win32') {
+    return path.join(process.env.APPDATA ?? path.join(home, 'AppData', 'Roaming'), 'Claude', 'claude_desktop_config.json');
+  }
+
+  if (platform === 'darwin') {
+    return path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+  }
+
+  return path.join(home, '.config', 'Claude', 'claude_desktop_config.json');
+}
+
+export function defaultClientConfigPaths({
+  home = os.homedir(),
+  env = process.env,
+  platform = process.platform,
+} = {}) {
+  return {
+    codex: path.join(env.CODEX_HOME ?? path.join(home, '.codex'), 'config.toml'),
+    claude: defaultClaudeConfigPath(home, platform),
+    gemini: path.join(home, '.gemini', 'settings.json'),
+    antigravity: path.join(home, '.gemini', 'config', 'mcp_config.json'),
+  };
+}
+
+export function buildSkillMasterServerConfig({
+  rootDir,
+  nodeExecPath = process.execPath,
+  env = DEFAULT_SERVER_ENV,
+} = {}) {
+  const packageRoot = rootDir ?? path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
+  const serverEntry = path.join(packageRoot, 'bin', 'skill-master.mjs');
+
+  return {
+    command: nodeExecPath,
+    args: [serverEntry],
+    env: { ...env },
+    metadata: {
+      mode: 'absolute-node',
+      packageRoot,
+      serverEntry,
+    },
+  };
+}
+
+function tomlString(value) {
+  return JSON.stringify(String(value));
+}
+
+function tomlStringArray(values) {
+  return `[${values.map((value) => tomlString(value)).join(', ')}]`;
+}
+
+export function buildCodexBlock(serverConfig) {
+  const envEntries = Object.entries(serverConfig.env ?? {});
+  const envBlock = envEntries.length
+    ? `\n[mcp_servers.skill_master.env]\n${envEntries.map(([key, value]) => `${key} = ${tomlString(value)}`).join('\n')}\n`
+    : '';
+
+  return `
+[mcp_servers.skill_master]
+command = ${tomlString(serverConfig.command)}
+args = ${tomlStringArray(serverConfig.args ?? [])}
+startup_timeout_sec = 120
+${envBlock}`;
+}
+
+export function buildJsonMcpSnippet(serverConfig) {
+  return {
+    mcpServers: {
+      skill_master: {
+        command: serverConfig.command,
+        args: serverConfig.args ?? [],
+        env: serverConfig.env ?? {},
+      },
+    },
+  };
+}
+
+export function ensureParent(filePath) {
+  mkdirSync(path.dirname(filePath), { recursive: true });
+}
+
+function backupPath(filePath) {
+  const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+  return `${filePath}.invalid-${stamp}.bak`;
+}
+
+export function readJsonOrEmpty(filePath, { recoverInvalidJson = false } = {}) {
+  if (!existsSync(filePath)) return {};
+  const raw = readFileSync(filePath, 'utf8').trim();
+  if (!raw) return {};
+  try {
+    return JSON.parse(raw);
+  } catch (error) {
+    if (recoverInvalidJson) {
+      copyFileSync(filePath, backupPath(filePath));
+      return {};
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Invalid JSON at ${filePath}: ${message}`);
+  }
+}
+
+export function writeJson(filePath, value) {
+  ensureParent(filePath);
+  writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
+}
+
+export function mergeMcpServer(filePath, serverConfig, options = {}) {
+  const current = readJsonOrEmpty(filePath, options);
+  const next = {
+    ...current,
+    mcpServers: {
+      ...(current.mcpServers ?? {}),
+      skill_master: buildJsonMcpSnippet(serverConfig).mcpServers.skill_master,
+    },
+  };
+  writeJson(filePath, next);
+}
+
+export function removeCodexSkillMasterBlock(content) {
+  const lines = String(content ?? '').split('\n');
+  const kept = [];
+  let skipping = false;
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed === '[mcp_servers.skill_master]') {
+      skipping = true;
+      continue;
+    }
+    if (skipping && trimmed.startsWith('[') && !trimmed.startsWith('[mcp_servers.skill_master')) {
+      skipping = false;
+    }
+    if (!skipping) kept.push(line);
+  }
+  return kept.join('\n').trimEnd();
+}
+
+export function appendCodexServer(filePath, serverConfig, { force = false } = {}) {
+  ensureParent(filePath);
+  const current = existsSync(filePath) ? readFileSync(filePath, 'utf8') : '';
+  if (current.includes('[mcp_servers.skill_master]') && !force) {
+    return false;
+  }
+  const base = force ? removeCodexSkillMasterBlock(current) : current.trimEnd();
+  writeFileSync(filePath, `${base}\n${buildCodexBlock(serverConfig)}`, 'utf8');
+  return true;
+}
+
+function normalizeSlashes(value) {
+  return String(value ?? '').replace(/\\/g, '/').toLowerCase();
+}
+
+function basename(value) {
+  const normalized = normalizeSlashes(value);
+  return normalized.split('/').pop() ?? '';
+}
+
+function isNodeCommand(command) {
+  const name = basename(command);
+  return name === 'node' || name === 'node.exe';
+}
+
+function hasSkillMasterEntryArg(args = []) {
+  return args.some((arg) => normalizeSlashes(arg).endsWith('/bin/skill-master.mjs'));
+}
+
+function hasLauncherArg(args = []) {
+  return args.some((arg) => {
+    const normalized = normalizeSlashes(arg);
+    return normalized.endsWith('/scripts/skill-master-launcher.ps1')
+      || normalized.endsWith('/scripts/skill-master-launcher.sh');
+  });
+}
+
+export function assessMcpServerConfig(server) {
+  if (!server?.command) {
+    return {
+      present: Boolean(server),
+      robust: false,
+      mode: server ? 'missing-command' : 'missing',
+      command: server?.command ?? null,
+    };
+  }
+
+  const command = String(server.command);
+  const args = Array.isArray(server.args) ? server.args : [];
+  const commandName = basename(command);
+  const normalizedCommand = normalizeSlashes(command);
+
+  if (isNodeCommand(command) && hasSkillMasterEntryArg(args)) {
+    return { present: true, robust: true, mode: 'absolute-node', command };
+  }
+
+  if (commandName === 'skill-master-mcp' || commandName === 'skill-master-mcp.cmd') {
+    return { present: true, robust: false, mode: 'path-bin', command };
+  }
+
+  if ((normalizedCommand.includes('powershell') || commandName === 'bash' || commandName === 'env') && hasLauncherArg(args)) {
+    return { present: true, robust: false, mode: 'launcher', command };
+  }
+
+  return { present: true, robust: false, mode: 'custom', command };
+}
+
+function parseTomlStringToken(token) {
+  const value = String(token ?? '').trim();
+  if (!value) return '';
+  if (value.startsWith('"')) {
+    try {
+      return JSON.parse(value);
+    } catch {
+      return value.slice(1, -1);
+    }
+  }
+  if (value.startsWith("'")) {
+    return value.slice(1, -1);
+  }
+  return value;
+}
+
+function parseTomlStringArray(value) {
+  const matches = [...String(value ?? '').matchAll(/"(?:\\.|[^"])*"|'[^']*'/g)];
+  return matches.map((match) => parseTomlStringToken(match[0]));
+}
+
+export function extractCodexSkillMasterServer(content) {
+  const lines = String(content ?? '').split('\n');
+  const block = [];
+  let collecting = false;
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (trimmed === '[mcp_servers.skill_master]') {
+      collecting = true;
+      continue;
+    }
+    if (collecting && trimmed.startsWith('[')) {
+      break;
+    }
+    if (collecting) block.push(line);
+  }
+
+  if (!block.length) return null;
+
+  const commandLine = block.find((line) => line.trim().startsWith('command'));
+  const argsLine = block.find((line) => line.trim().startsWith('args'));
+  const commandToken = commandLine?.match(/=\s*("(?:\\.|[^"])*"|'[^']*')/)?.[1] ?? null;
+  const command = commandToken ? parseTomlStringToken(commandToken) : null;
+  const args = argsLine ? parseTomlStringArray(argsLine.split('=').slice(1).join('=')) : [];
+
+  return command ? { command, args } : null;
+}
+
+export function assessCodexConfigContent(content) {
+  return assessMcpServerConfig(extractCodexSkillMasterServer(content));
+}