@fprad0/skill-master-mcp 0.0.10 → 0.0.12

package/CHANGELOG.md

@@ -4,7 +4,18 @@ All notable changes to `skill_master` will be tracked here.
 
 ## [Unreleased]
 
-- Await explicit authorization before the next npm publication.
+## [0.0.12] - 2026-06-29
+
+- Publish the Reborn cyberpunk HUD layer with intro, visual confirmation, running workflow frame, and low-flicker interactive menu flow.
+- Redesign `DNA-CORE` into `DNA CYBER HELIX` with fuller braille pixel art, cyan/amber palette layering, halo fill, and a smoothed 36-frame animation cycle.
+- Add explicit Claude Code registration through `skill-master-register-clients --apply-claude-code`, using `claude mcp add` with absolute Node and package entrypoint.
+- Keep menu actions and MCP client registration robust across Codex, Claude, Gemini, and Antigravity while packaging updated visual evidence and handoff docs.
+
+## [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
 

package/README.md

@@ -108,13 +108,12 @@ 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
-- preparacao local seguinte: `0.0.10`, focada em confiabilidade do menu, doctor, Antigravity e separacao entre acoes globais e acoes de desenvolvimento
+- 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 publica o HUD Reborn `v0.0.12`, com DNA cyberpunk pixel art mais artistico e registro MCP multi-cliente com Node absoluto
 
 Comandos globais principais:
 
@@ -145,6 +144,7 @@ skill-master-menu --run doctor
 skill-master-menu --run check
 skill-master-menu --run update --yes
 skill-master-menu --run install-global-skills
+skill-master-menu --run install-project-skills
 skill-master-menu --run bootstrap-global
 skill-master-menu --run register-clients
 skill-master-menu --run notifications
@@ -157,7 +157,7 @@ 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:
 
@@ -173,7 +173,36 @@ 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`.
+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 bundle tambem inclui uma camada `senior master` de otimizacao e hardening por linguagem em `docs/skill-candidates/v0.0.12`, cobrindo TypeScript, Python, JavaScript, Go, SQL, JSON, Ruby, React, HTML, CSS e C#. Essas skills orientam escrita, organizacao, reducao de complexidade, performance, seguranca, testes e validacao real antes de declarar uma mudanca pronta.
+
+O pacote `v0.0.12` preserva esse bundle granular e adiciona a passada visual Reborn do menu, com HUD operacional mais estavel, estados de execucao mais claros e um `DNA-CORE` mais artistico em cyberpunk pixel art.
+
+Para instalar o mesmo bundle como skills locais de um projeto, rode o comando dentro da pasta do projeto:
+
+```bash
+skill-master-install-project-skills --sync-package-json
+```
+
+Por padrao ele copia as skills para:
+
+- `.agents/skills`
+- `.codex/skills`
+- `.claude/skills`
+- `.gemini/skills`
+
+O comando tambem grava `.skill-master/catalog.json` e, quando existe `package.json`, adiciona metadados em `skillMaster` e o script `skill-master:install-project-skills`. Isso permite que o projeto fique catalogado e que outro notebook reinstale as skills locais com:
+
+```bash
+npm run skill-master:install-project-skills
+```
+
+Para projetos npm que precisam materializar o lock depois de alterar dependencias ou scripts, rode:
+
+```bash
+npm install --package-lock-only
+```
 
 Para fazer o bootstrap global completo em um passo:
 
@@ -181,11 +210,12 @@ Para fazer o bootstrap global completo em um passo:
 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-claude-code --claude-code-scope user
 skill-master-register-clients --apply-gemini
 skill-master-register-clients --apply-antigravity
 ```
@@ -196,7 +226,26 @@ Atalho para gerar snippets e aplicar nos clientes principais:
 skill-master-register-clients --apply-all
 ```
 
-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.
+Isso configura o servidor MCP `skill_master` em Codex, Claude Desktop, Claude Code, Gemini e Antigravity quando os clientes locais estiverem disponiveis. Claude Code e registrado via `claude mcp add`; 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.04`
+Versão funcional planejada: `00.06`
 
-Versão técnica para empacotamento semântico: `0.0.10`
+Versão técnica para empacotamento semântico: `0.0.12`
 
 ## Observação
 
-O nome `00.04` será usado na comunicação e nos documentos. Para ferramentas que exigem SemVer, como npm e alguns fluxos de release, usar `0.0.10`.
+O nome `00.06` será usado na comunicação e nos documentos. Para ferramentas que exigem SemVer, como npm e alguns fluxos de release, usar `0.0.12`.

package/bin/lib/client-config.mjs

@@ -0,0 +1,293 @@
+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 buildClaudeCodeAddArgs(serverConfig, {
+  scope = 'user',
+  serverName = 'skill_master',
+} = {}) {
+  return [
+    'mcp',
+    'add',
+    serverName,
+    '--scope',
+    scope,
+    '--',
+    serverConfig.command,
+    ...(serverConfig.args ?? []),
+  ];
+}
+
+export function formatShellCommand(command, args = []) {
+  const quote = (value) => {
+    const text = String(value ?? '');
+    if (/^[A-Za-z0-9_./:@%+=,-]+$/.test(text)) return text;
+    return `"${text.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+  };
+  return [command, ...args].map(quote).join(' ');
+}
+
+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));
+}