@lunacode/opencode-plugin-intelligence 0.1.0 → 0.1.2

package/README.md

@@ -2,6 +2,8 @@
 
 OpenCode v2 plugin that annotates model display names with the Artificial Analysis Intelligence Index.
 
+![OpenCode model picker showing Artificial Analysis intelligence scores alongside model names](.github/preview.heic)
+
 ## What it does
 
 Matched models appear as `Model Name (AIQ: 60)` in the `/models` picker. Scores retain up to two decimal places, for example `(AIQ: 53.97)`. AIQ is the Artificial Analysis Intelligence Index score, not a leaderboard rank or a human IQ score.
@@ -12,7 +14,7 @@ It fetches the leaderboard once and writes a local cache file. It reuses that ca
 
 ## Install
 
-This plugin is **OpenCode v2 only** and requires **v2.0.28 or newer v2**. It is **not compatible with OpenCode v1**.
+This plugin is **OpenCode v2 only** and requires **v2.0.28 or newer v2** and **Node.js 20 or newer**. It is **not compatible with OpenCode v1**.
 
 Add the package to `opencode.json` or `opencode.jsonc`:
 
@@ -37,16 +39,18 @@ Default cache path (shared with the previous version):
 
 Environment variables (set on the OpenCode server):
 
-- `OPENCODE_INTELLIGENCE_FORCE_REFRESH=1` forces a re-fetch instead of reading the cache when the plugin loads.
+- `OPENCODE_INTELLIGENCE_FORCE_REFRESH=1` forces a re-fetch instead of reading the cache when the plugin loads. If it fails, annotations are skipped; this mode does not fall back to stale scores.
 - `OPENCODE_INTELLIGENCE_CACHE_PATH=/path/to/leaderboard.json` overrides the cache location.
 
-Manual refresh:
+Manual refresh from a local checkout (uses `OPENCODE_INTELLIGENCE_CACHE_PATH` if set):
 
 ```bash
 npm run refresh-cache
 ```
 
-Reload the plugin or restart OpenCode after manually refreshing to load the new scores. There is no background polling timer. An expired cache refreshes on the next load; if that refresh fails, the plugin warns and uses the stale cache. Separate OpenCode server processes may each issue a refresh; explicit refreshes bypass the 24-hour expiry. If no leaderboard can be loaded, the plugin warns and leaves model names unchanged.
+Reload the plugin or restart OpenCode after manually refreshing to load the new scores. There is no background polling timer. An expired cache refreshes on the next load; if that refresh fails, the plugin warns and uses the stale cache. Separate OpenCode server processes may each issue a refresh; explicit refreshes bypass the 24-hour expiry. If no leaderboard can be loaded, the plugin warns and leaves model names unchanged. Malformed or unreadable cache files also skip annotations; they are not automatically replaced. Use a manual or forced refresh to replace them.
+
+Cache loading and refresh failures also show an error toast in the OpenCode TUI. The toast says whether saved scores are still in use or scores are unavailable. Console warnings remain available on headless servers.
 
 ## Matching and limitations
 
@@ -64,6 +68,20 @@ node --test
 
 When changing leaderboard fetching or parsing, also run `npm run refresh-cache`.
 
+## Publishing
+
+GitHub Actions runs Biome and tests on branch pushes and pull requests. Pushing a `v<version>` tag runs the same checks and publishes to npm using trusted publishing. The tag must match `package.json`, for example `v0.1.0` for version `0.1.0`.
+
+Configure a GitHub Actions trusted publisher in the npm package's settings:
+
+- Organization or user: `SharkyRawr`
+- Repository: `opencode-plugin-intelligence`
+- Workflow filename: `publish.yml`
+- Environment name: leave blank
+- Allow direct publishing with `npm publish`
+
+No npm token secret is required. If the package does not exist yet, publish its first version manually before configuring the trusted publisher. Use a new version for the first tag-triggered publish; npm cannot overwrite an existing version. See [npm's trusted publishing documentation](https://docs.npmjs.com/trusted-publishers) for setup details.
+
 ## License
 
 Licensed under [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/): attribution, noncommercial use, and share-alike are required. See [LICENSE](LICENSE) for the full terms.

package/package.json

@@ -1,17 +1,23 @@
 {
   "name": "@lunacode/opencode-plugin-intelligence",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "license": "CC-BY-NC-SA-4.0",
   "description": "Annotate OpenCode model names with the Artificial Analysis Intelligence Index.",
   "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SharkyRawr/opencode-plugin-intelligence.git"
+  },
   "publishConfig": {
     "access": "public"
   },
   "exports": {
-    ".": "./index.js"
+    ".": "./index.js",
+    "./tui": "./tui.js"
   },
   "files": [
     "index.js",
+    "tui.js",
     "src",
     "scripts/refresh-cache.mjs",
     "README.md",

package/src/cache-status.js

@@ -0,0 +1,11 @@
+// Read the startup result so a TUI attaching after setup still sees failures.
+export const cacheStatusRpc = {
+  id: "opencode-plugin-intelligence",
+  methods: {
+    status: {
+      input: { type: "null" },
+      output: { anyOf: [{ type: "string" }, { type: "null" }] },
+    },
+  },
+  events: {},
+};

package/src/index.js

@@ -1,3 +1,4 @@
+import { cacheStatusRpc } from "./cache-status.js";
 import {
   readLeaderboardCache,
   refreshLeaderboardCache,
@@ -9,9 +10,13 @@ export const IntelligencePlugin = {
   id: "opencode-plugin-intelligence",
   async setup(ctx) {
     let leaderboard;
+    let errorMessage = null;
     try {
       const options = {
         cachePath: process.env.OPENCODE_INTELLIGENCE_CACHE_PATH,
+        onRefreshError(error) {
+          errorMessage = `Leaderboard refresh failed; using saved scores. ${error.message ?? error}`;
+        },
       };
       leaderboard =
         process.env.OPENCODE_INTELLIGENCE_FORCE_REFRESH === "1"
@@ -22,24 +27,31 @@ export const IntelligencePlugin = {
         "opencode-plugin-intelligence: Failed to load Artificial Analysis leaderboard cache",
         error,
       );
-      return;
+      errorMessage = `Leaderboard could not be loaded; scores are unavailable. ${error.message ?? error}`;
     }
 
-    if (!leaderboard?.models?.length) return;
-
-    const annotateName = createModelNameAnnotator(leaderboard);
-    const registration = await ctx.model.transform((editor) => {
-      for (const model of editor.list()) {
-        const name = annotateName(model.id, model.name);
-        if (name !== model.name) {
-          editor.update(model.providerID, model.id, (draft) => {
-            draft.name = name;
-          });
+    let registration;
+    if (leaderboard?.models?.length) {
+      const annotateName = createModelNameAnnotator(leaderboard);
+      registration = await ctx.model.transform((editor) => {
+        for (const model of editor.list()) {
+          const name = annotateName(model.id, model.name);
+          if (name !== model.name) {
+            editor.update(model.providerID, model.id, (draft) => {
+              draft.name = name;
+            });
+          }
         }
-      }
+      });
+    }
+    const statusRegistration = await ctx.rpc.register(cacheStatusRpc, {
+      status: async () => errorMessage,
     });
 
-    return () => registration.dispose();
+    return async () => {
+      await statusRegistration.dispose();
+      await registration?.dispose();
+    };
   },
 };
 

package/src/leaderboard-cache.js

@@ -26,26 +26,23 @@ async function fetchLeaderboardHtml() {
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
 
-  let response;
-
   try {
-    response = await fetch(LEADERBOARD_URL, {
+    const response = await fetch(LEADERBOARD_URL, {
       signal: controller.signal,
       headers: {
-        "user-agent": "opencode-plugin-intelligence/0.1.0",
+        "user-agent": "opencode-plugin-intelligence/0.1.1",
       },
     });
+    if (!response.ok) {
+      throw new Error(
+        `Artificial Analysis request failed with ${response.status}`,
+      );
+    }
+
+    return await response.text();
   } finally {
     clearTimeout(timeout);
   }
-
-  if (!response.ok) {
-    throw new Error(
-      `Artificial Analysis request failed with ${response.status}`,
-    );
-  }
-
-  return response.text();
 }
 
 async function fetchLeaderboardSnapshot() {
@@ -92,6 +89,7 @@ export async function readLeaderboardCache({
   directory,
   worktree,
   cachePath,
+  onRefreshError,
 } = {}) {
   const resolvedCachePath = resolveCachePath({
     directory,
@@ -128,6 +126,7 @@ export async function readLeaderboardCache({
       "opencode-plugin-intelligence: Refresh failed; using stale leaderboard cache",
       error,
     );
+    onRefreshError?.(error);
     return cached;
   }
 }

package/src/leaderboard-parser.js

@@ -15,9 +15,7 @@ function visit(value, predicate) {
         return result;
       }
     }
-  }
-
-  if (value && typeof value === "object") {
+  } else if (value && typeof value === "object") {
     for (const item of Object.values(value)) {
       const result = visit(item, predicate);
 

package/src/model-annotations.js

@@ -35,12 +35,6 @@ function scoreTag(score) {
   return `(AIQ: ${Number(score.toFixed(2)).toString()})`;
 }
 
-function setModelOverride(providerConfig, modelId, displayName) {
-  providerConfig.models ||= {};
-  providerConfig.models[modelId] ||= {};
-  providerConfig.models[modelId].name = displayName;
-}
-
 function baseDisplayName(name) {
   return name.replace(INTELLIGENCE_TAG_PATTERN, "");
 }
@@ -162,65 +156,3 @@ export function createModelNameAnnotator(leaderboard) {
     return `${baseName} ${scoreTag(matchedModel.intelligenceIndex)}`;
   };
 }
-
-export function applyIntelligenceAnnotations(config, leaderboard) {
-  if (!leaderboard?.models?.length) {
-    return;
-  }
-
-  config.provider ||= {};
-  const annotateName = createModelNameAnnotator(leaderboard);
-
-  for (const providerConfig of Object.values(config.provider)) {
-    providerConfig.models ||= {};
-
-    for (const [modelId, modelConfig] of Object.entries(
-      providerConfig.models,
-    )) {
-      const currentName = modelConfig.name || modelId;
-      const name = annotateName(modelId, currentName);
-      if (name !== currentName) setModelOverride(providerConfig, modelId, name);
-    }
-  }
-}
-
-export function buildProviderNamePatch(providers, leaderboard) {
-  const config = { provider: {} };
-  const candidateConfig = { provider: {} };
-
-  for (const provider of providers) {
-    if (!provider?.id || !provider?.models) {
-      continue;
-    }
-
-    candidateConfig.provider[provider.id] = { models: {} };
-
-    for (const [modelId, model] of Object.entries(provider.models)) {
-      candidateConfig.provider[provider.id].models[modelId] = {
-        name: model.name,
-      };
-    }
-  }
-
-  applyIntelligenceAnnotations(candidateConfig, leaderboard);
-
-  for (const provider of providers) {
-    if (!provider?.id || !provider?.models) {
-      continue;
-    }
-
-    for (const [modelId, model] of Object.entries(provider.models)) {
-      const nextName =
-        candidateConfig.provider?.[provider.id]?.models?.[modelId]?.name;
-
-      if (!nextName || nextName === model.name) {
-        continue;
-      }
-
-      config.provider[provider.id] ||= { models: {} };
-      config.provider[provider.id].models[modelId] = { name: nextName };
-    }
-  }
-
-  return config;
-}

package/src/tui.js

@@ -0,0 +1,26 @@
+import { cacheStatusRpc } from "./cache-status.js";
+
+/** @type {import("@opencode/plugin/tui").Plugin.Definition} */
+export default {
+  id: "opencode-plugin-intelligence",
+  async setup(ctx) {
+    try {
+      const message = await ctx.client.rpc(cacheStatusRpc).status(null, {
+        location: ctx.location,
+      });
+      if (message) {
+        ctx.ui.toast.show({
+          title: "Artificial Analysis",
+          message,
+          variant: "error",
+          duration: 10000,
+        });
+      }
+    } catch (error) {
+      console.warn(
+        "opencode-plugin-intelligence: Failed to read leaderboard cache status",
+        error,
+      );
+    }
+  },
+};

package/tui.js

@@ -0,0 +1 @@
+export { default } from "./src/tui.js";