@fprad0/skill-master-mcp 0.0.12 → 1.0.1

package/bin/lib/doctor-core.mjs

@@ -0,0 +1,202 @@
+function bySeverity(a, b) {
+  const rank = { blocker: 0, partial: 1 };
+  return (rank[a.severity] ?? 99) - (rank[b.severity] ?? 99);
+}
+
+function missingBinsIssue(missingBins) {
+  return {
+    severity: 'blocker',
+    code: 'bins-missing',
+    summary: `Binarios globais ausentes: ${missingBins.join(', ')}`,
+  };
+}
+
+function packageIssue(packageJson) {
+  return {
+    severity: 'blocker',
+    code: 'package-invalid',
+    summary: `Pacote local inesperado: ${packageJson?.name ?? 'desconhecido'}`,
+  };
+}
+
+function skillsIssue(missingSkills) {
+  return {
+    severity: 'partial',
+    code: 'skills-missing',
+    summary: `Skills globais faltando: ${missingSkills.join(', ')}`,
+  };
+}
+
+function clientIssue(name, state) {
+  if (state.configured) {
+    return null;
+  }
+
+  if (name === 'Claude Code') {
+    if (state.optionalMissing || state.mode === 'cli-missing') {
+      return {
+        severity: 'partial',
+        code: 'claude-code-cli-missing',
+        summary: 'Claude Code opcional neste computador: CLI nao encontrado.',
+      };
+    }
+
+    if (state.mode === 'list-failed') {
+      return {
+        severity: 'partial',
+        code: 'claude-code-list-failed',
+        summary: 'Claude Code encontrado, mas o comando `claude mcp list` falhou.',
+      };
+    }
+
+    return {
+      severity: 'partial',
+      code: 'claude-code-config',
+      summary: 'Claude Code ainda nao reconhece o servidor skill_master.',
+    };
+  }
+
+  if (state.mode === 'invalid-json') {
+    return {
+      severity: 'blocker',
+      code: `${name.toLowerCase().replace(/\s+/g, '-')}-invalid-json`,
+      summary: `${name} possui JSON invalido em ${state.filePath}`,
+    };
+  }
+
+  return {
+    severity: 'partial',
+    code: `${name.toLowerCase().replace(/\s+/g, '-')}-config-missing`,
+    summary: `${name} ainda nao esta configurado com um MCP robusto.`,
+  };
+}
+
+export function diagnoseReadiness({
+  packageOk,
+  packageJson,
+  binResults,
+  missingSkills,
+  clients,
+}) {
+  const issues = [];
+  const missingBins = binResults.filter(([, ok]) => !ok).map(([bin]) => bin);
+
+  if (!packageOk) {
+    issues.push(packageIssue(packageJson));
+  }
+
+  if (missingBins.length) {
+    issues.push(missingBinsIssue(missingBins));
+  }
+
+  if (missingSkills.length) {
+    issues.push(skillsIssue(missingSkills));
+  }
+
+  for (const [name, state] of clients) {
+    const issue = clientIssue(name, state);
+    if (issue) {
+      issues.push(issue);
+    }
+  }
+
+  issues.sort(bySeverity);
+  const dominantFailure = issues[0]?.summary ?? 'nenhuma';
+  const hasBlockers = issues.some((issue) => issue.severity === 'blocker');
+  const ready = issues.length === 0;
+
+  return {
+    ready,
+    mode: ready ? 'ready' : hasBlockers ? 'blocked' : 'partial',
+    dominantFailure,
+    issues,
+    missingBins,
+    missingSkills,
+    clientIssues: issues.filter((issue) => issue.code.includes('config') || issue.code.includes('claude-code')),
+  };
+}
+
+function hasOnlyClaudeCodeIssue(diagnosis) {
+  return diagnosis.issues.length > 0
+    && diagnosis.issues.every((issue) => issue.code.startsWith('claude-code-'));
+}
+
+export function recommendedActionsForDiagnosis(diagnosis, clients = []) {
+  if (diagnosis.ready) {
+    return ['Reinicie os clientes MCP se voce acabou de aplicar alguma configuracao.'];
+  }
+
+  const dominantCode = diagnosis.issues[0]?.code ?? null;
+
+  if (dominantCode === 'package-invalid') {
+    return [
+      'Use o pacote instalado correto de @fprad0/skill-master-mcp ou reinstale a versao global.',
+      'npm install -g @fprad0/skill-master-mcp@latest --registry=https://registry.npmjs.org',
+    ];
+  }
+
+  if (dominantCode === 'bins-missing') {
+    return [
+      'npm install -g @fprad0/skill-master-mcp@latest --registry=https://registry.npmjs.org',
+      'Depois abra um novo terminal e rode: skill-master-doctor',
+    ];
+  }
+
+  if (dominantCode?.endsWith('invalid-json')) {
+    return [
+      'skill-master-register-clients --apply-all --force',
+      'Depois rode: skill-master-doctor',
+    ];
+  }
+
+  if (hasOnlyClaudeCodeIssue(diagnosis)) {
+    const cliMissing = diagnosis.issues.some((issue) => issue.code === 'claude-code-cli-missing');
+    if (cliMissing) {
+      return [
+        'Instale ou abra o Claude Code neste computador; se voce nao usa esse cliente, pode ignorar este aviso.',
+        'skill-master-register-clients --apply-claude-code --claude-code-scope user',
+      ];
+    }
+
+    return [
+      'skill-master-register-clients --apply-claude-code --claude-code-scope user',
+      'Depois valide com: claude mcp list',
+    ];
+  }
+
+  if (diagnosis.missingSkills.length) {
+    return [
+      'skill-master-install-global-skills --overwrite',
+      'Depois rode: skill-master-doctor',
+    ];
+  }
+
+  const missingRequiredClients = clients.filter(([name, state]) => name !== 'Claude Code' && !state.configured);
+  if (missingRequiredClients.length > 1) {
+    return [
+      'skill-master-register-clients --apply-all --force',
+      'Depois reinicie Codex, Claude Desktop, Gemini e Antigravity.',
+    ];
+  }
+
+  const clientFixMap = new Map([
+    ['Codex', 'skill-master-register-clients --apply-codex --force'],
+    ['Claude Desktop', 'skill-master-register-clients --apply-claude --force'],
+    ['Gemini CLI', 'skill-master-register-clients --apply-gemini --force'],
+    ['Antigravity', 'skill-master-register-clients --apply-antigravity --force'],
+  ]);
+
+  for (const [name, state] of clients) {
+    if (!state.configured && clientFixMap.has(name)) {
+      return [
+        clientFixMap.get(name),
+        'Depois rode: skill-master-doctor',
+      ];
+    }
+  }
+
+  return [
+    'skill-master-register-clients --apply-all --force',
+    'skill-master-install-global-skills --overwrite',
+  ];
+}