@khalilgharbaoui/opencode-claude-code-plugin 0.31.0 → 0.31.1

package/README.md

@@ -890,6 +890,8 @@ It carries the startup-diagnostics fields (plugin version, opencode version, `cl
 
 When Claude Code refused an entry in an `--mcp-config` it was handed, an **MCP config entries Claude Code skipped** section names each one with the CLI's own category and sentence. That section only appears when there is something in it. It matters because a skipped server is absent from the CLI's server list entirely rather than listed as broken, so the model silently does not have those tools; if the skipped name is `opencode_proxy` the report says so plainly, because then it is the plugin's own server and every proxied tool call in the session fails. The same thing is a warning in your terminal when it happens.
 
+A **Plugins Claude Code did not load** section works the same way for Claude plugins: one the CLI demoted at load time (for example, a dependency that is not installed) is absent from its plugin list, so its skills, commands and MCP servers are silently missing. The skill bridge is such a plugin (`opencode-skills`), and a failure there is reported as the plugin's own bug rather than your config. A plugin warning only counts when its content did not load; advisory feedback about a plugin that did load stays in the log at INFO.
+
 ```text
 /claude-code-doctor usage
 ```

package/dist/index.js

@@ -415,6 +415,7 @@ var DEFAULT_PROXY_TOOL_NAMES = [
   "Task"
 ];
 var PROXY_MCP_SERVER_NAME = "opencode_proxy";
+var SKILL_PLUGIN_NAME = "opencode-skills";
 
 // src/cli-events.ts
 function isRecord(value) {
@@ -595,9 +596,44 @@ function parseSystemInit(msg) {
     cliVersion: str(raw.claude_code_version),
     toolCount: Array.isArray(raw.tools) ? raw.tools.length : 0,
     mcpServers: servers,
-    mcpServerErrors: parseMcpServerErrors(msg)
+    mcpServerErrors: parseMcpServerErrors(msg),
+    pluginErrors: parsePluginDiagnostics(raw.plugin_errors),
+    pluginWarnings: parsePluginDiagnostics(raw.plugin_warnings),
+    loadedPlugins: parseLoadedPlugins(raw.plugins)
   };
 }
+function parsePluginDiagnostics(raw) {
+  if (!Array.isArray(raw)) return [];
+  const diagnostics = [];
+  for (const entry of raw) {
+    if (!isRecord(entry)) continue;
+    diagnostics.push({
+      plugin: str(entry.plugin) ?? "unknown",
+      type: str(entry.type) ?? "unknown",
+      message: str(entry.message) ?? ""
+    });
+  }
+  return diagnostics;
+}
+function parseLoadedPlugins(raw) {
+  if (!Array.isArray(raw)) return [];
+  const loaded = [];
+  for (const entry of raw) {
+    if (!isRecord(entry)) continue;
+    for (const id of [str(entry.source), str(entry.name)]) {
+      if (id && !loaded.includes(id)) loaded.push(id);
+    }
+  }
+  return loaded;
+}
+function describePluginLoadFailure(diagnostic) {
+  const detail = diagnostic.message ? ` Claude Code said: ${diagnostic.message}` : "";
+  const name = diagnostic.plugin.split("@", 1)[0];
+  if (name === SKILL_PLUGIN_NAME) {
+    return `Claude Code did not load the plugin's own skill bridge "${diagnostic.plugin}" (${diagnostic.type}), so the opencode skills it bridges are missing this session. This is a plugin bug or a corrupted scratch directory rather than your config: report it with this line.${detail}`;
+  }
+  return `Claude Code did not load plugin "${diagnostic.plugin}" (${diagnostic.type}), so its skills, commands and MCP servers are missing this session.${detail}`;
+}
 function apiKeySourceWarning(apiKeySource, ignoreAnthropicApiKey) {
   if (!apiKeySource || !API_KEY_SOURCES.has(apiKeySource)) return null;
   const base = `Claude Code authenticated with an API key (apiKeySource: ${apiKeySource}), so these turns bill as pay-as-you-go API usage instead of your subscription.`;
@@ -607,9 +643,32 @@ var warnedApiKeySources = /* @__PURE__ */ new Set();
 var warnedMcpFailures = /* @__PURE__ */ new Set();
 var warnedMcpSkips = /* @__PURE__ */ new Set();
 var lastMcpServerErrors = /* @__PURE__ */ new Map();
+var warnedPluginDiagnostics = /* @__PURE__ */ new Set();
+var lastPluginLoadFailures = /* @__PURE__ */ new Map();
 function snapshotMcpServerErrors() {
   return [...lastMcpServerErrors.values()];
 }
+function snapshotPluginLoadFailures() {
+  return [...lastPluginLoadFailures.values()];
+}
+function reportPluginDiagnostics(info) {
+  const report = (kind, diagnostic) => {
+    const loaded = kind === "warning" && info.loadedPlugins.includes(diagnostic.plugin);
+    const message = loaded ? `Claude Code has advisory feedback for plugin "${diagnostic.plugin}" (${diagnostic.type}): ${diagnostic.message}` : describePluginLoadFailure(diagnostic);
+    if (!loaded) lastPluginLoadFailures.set(diagnostic.plugin, { kind, ...diagnostic });
+    const key = `${kind}:${diagnostic.plugin}:${diagnostic.type}`;
+    const data = { plugin: diagnostic.plugin, type: diagnostic.type, kind };
+    if (warnedPluginDiagnostics.has(key)) {
+      log.debug(message, data);
+      return;
+    }
+    warnedPluginDiagnostics.add(key);
+    if (loaded) log.info(message, data);
+    else log.warn(message, data);
+  };
+  for (const diagnostic of info.pluginErrors) report("error", diagnostic);
+  for (const diagnostic of info.pluginWarnings) report("warning", diagnostic);
+}
 function reportSystemInit(msg, options = {}) {
   const info = parseSystemInit(msg);
   if (!info) return;
@@ -620,8 +679,11 @@ function reportSystemInit(msg, options = {}) {
     cliVersion: info.cliVersion ?? null,
     tools: info.toolCount,
     mcpServers: info.mcpServers,
-    mcpServerErrors: info.mcpServerErrors
+    mcpServerErrors: info.mcpServerErrors,
+    pluginErrors: info.pluginErrors,
+    pluginWarnings: info.pluginWarnings
   });
+  reportPluginDiagnostics(info);
   for (const error of info.mcpServerErrors) {
     lastMcpServerErrors.set(error.name, error);
     const key2 = `${error.name}:${error.type}`;
@@ -4869,6 +4931,18 @@ function formatDoctorReport(report) {
     lines.push("");
     lines.push("A skipped server is missing from the model's tools with no other sign of it.");
   }
+  if (report.pluginLoadFailures.length > 0) {
+    lines.push("");
+    lines.push("**Plugins Claude Code did not load**");
+    lines.push("");
+    lines.push("| plugin | kind | category | Claude Code said |");
+    lines.push("|---|---|---|---|");
+    for (const failure of report.pluginLoadFailures) {
+      lines.push(
+        `| ${failure.plugin} | ${failure.kind} | \`${failure.type}\` | ${failure.message || "no detail"} |`
+      );
+    }
+  }
   lines.push("");
   lines.push("**Plan usage**");
   lines.push("");
@@ -4967,6 +5041,7 @@ async function gatherDoctorReport(options) {
     pendingCalls: snapshotPendingProxyCalls(),
     proxyServers,
     mcpServerErrors: snapshotMcpServerErrors(),
+    pluginLoadFailures: snapshotPluginLoadFailures(),
     planUsage
   };
 }
@@ -4981,6 +5056,7 @@ async function buildDoctorReport(options) {
       pendingCalls: report.pendingCalls.length,
       proxyServers: report.proxyServers.map((server2) => server2.auth.status),
       mcpServerErrors: report.mcpServerErrors.length,
+      pluginLoadFailures: report.pluginLoadFailures.length,
       planUsage: report.planUsage.status
     });
     return formatDoctorReport(report);
@@ -6078,7 +6154,6 @@ import * as fs5 from "fs";
 import * as os3 from "os";
 import * as path7 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
-var SKILL_PLUGIN_NAME = "opencode-skills";
 function bundledSkillsDir() {
   try {
     const here = fileURLToPath2(import.meta.url);