@wpro-eng/opencode-config 1.2.0 → 1.4.0

package/command/wpromote-cleanup.md

@@ -0,0 +1,72 @@
+---
+description: Remove stale cache files, broken symlinks, and unused plugins from OpenCode's plugin cache
+---
+Clean up stale artifacts left behind by @wpro-eng/opencode-config and OpenCode's plugin cache.
+
+OpenCode's plugin cache (`~/.cache/opencode/package.json`) is append-only: it never removes plugins you've uninstalled from `opencode.json`. This command fixes that, along with other accumulated cruft.
+
+## Instructions
+
+Run each cleanup step below in order. Report what was found and what was removed. Use the Bash tool for filesystem operations.
+
+### 1. Remove old git-clone cache (legacy architecture)
+
+The plugin used to clone the team config repo via git. That was replaced by bundled npm assets. The entire `repos/` directory is inert.
+
+```
+rm -rf ~/.cache/opencode/wpromote-config/repos/
+rm -f ~/.cache/opencode/wpromote-config/opencode-config.sync-status.json
+```
+
+Report the size freed if the directory existed.
+
+### 2. Prune unused plugins from OpenCode's npm cache
+
+Read `~/.config/opencode/opencode.json` to get the active `plugin` list. Then read `~/.cache/opencode/package.json` to get cached dependencies.
+
+Any dependency in the cache that is NOT in the active plugin list AND is NOT `opencode-anthropic-auth` (OpenCode's built-in default plugin) should be removed:
+- Delete the entry from `~/.cache/opencode/package.json`
+- Delete the package directory from `~/.cache/opencode/node_modules/<pkg>/`
+- Delete `~/.cache/opencode/bun.lock` so Bun re-resolves cleanly on next startup
+
+List each removed package by name and version.
+
+**Important**: Also check for project-level `.opencode/opencode.json` plugin entries (in the current working directory) so you don't accidentally prune a plugin that's declared at the project level rather than the user level.
+
+### 3. Fix broken symlinks
+
+Check these locations for symlinks whose targets no longer exist:
+- `~/.config/opencode/skill/_plugins/opencode-config/*/`
+- `~/.config/opencode/plugin/_remote_opencode-config_*`
+- `~/.config/opencode/plugins/_remote_opencode-config_*`
+- `~/.config/opencode/mcp/_plugins/opencode-config/*/`
+
+Remove any broken symlinks. Report each one removed.
+
+### 4. Clean stale orchestration task files
+
+Check `~/.cache/opencode/wpromote-config/orchestration-tasks/` for session files older than 7 days:
+
+```bash
+find ~/.cache/opencode/wpromote-config/orchestration-tasks/ -name "ses_*.json" -mtime +7
+```
+
+Remove them and report the count.
+
+### 5. Rotate plugin log
+
+If `~/.cache/opencode/wpromote-config/plugin.log` is larger than 1MB, truncate it to the last 200 lines.
+
+## Output Format
+
+Present a summary table:
+
+| Category | Found | Cleaned | Details |
+|----------|-------|---------|---------|
+| Git clone cache | ... | ... | ... |
+| Unused cached plugins | ... | ... | ... |
+| Broken symlinks | ... | ... | ... |
+| Stale task files | ... | ... | ... |
+| Plugin log | ... | ... | ... |
+
+End with either "All clean, no restart needed." or "Restart OpenCode to pick up changes." if any cached plugins were removed or symlinks were fixed.

package/dist/index.js

@@ -9649,7 +9649,7 @@ function createDisableMatcher(disable) {
 }
 
 // src/index.ts
-import * as path8 from "path";
+import * as path9 from "path";
 
 // src/mcp-schema.ts
 import * as fs6 from "fs";
@@ -9880,8 +9880,191 @@ function updatePluginStatus(data) {
   writePluginStatus(status);
 }
 
+// src/auto-update.ts
+import * as fs8 from "fs";
+import * as path8 from "path";
+var PACKAGE_NAME = "@wpro-eng/opencode-config";
+var NPM_DIST_TAGS_URL = `https://registry.npmjs.org/-/package/${encodeURIComponent(PACKAGE_NAME)}/dist-tags`;
+var REGISTRY_FETCH_TIMEOUT = 5000;
+var BUN_INSTALL_TIMEOUT = 60000;
+function getOpenCodeCacheDir() {
+  const xdgCache = process.env.XDG_CACHE_HOME || path8.join(process.env.HOME || "~", ".cache");
+  return path8.join(xdgCache, "opencode");
+}
+function getOpenCodeConfigDir() {
+  const xdgConfig = process.env.XDG_CONFIG_HOME || path8.join(process.env.HOME || "~", ".config");
+  return path8.join(xdgConfig, "opencode");
+}
+function getCachedVersion() {
+  const pkgJsonPath = path8.join(getOpenCodeCacheDir(), "node_modules", PACKAGE_NAME, "package.json");
+  try {
+    if (!fs8.existsSync(pkgJsonPath))
+      return null;
+    const content = fs8.readFileSync(pkgJsonPath, "utf-8");
+    const pkg = JSON.parse(content);
+    return pkg.version ?? null;
+  } catch {
+    return null;
+  }
+}
+async function getLatestVersion() {
+  const controller = new AbortController;
+  const timeoutId = setTimeout(() => controller.abort(), REGISTRY_FETCH_TIMEOUT);
+  try {
+    const response = await fetch(NPM_DIST_TAGS_URL, {
+      signal: controller.signal,
+      headers: { Accept: "application/json" }
+    });
+    if (!response.ok)
+      return null;
+    const data = await response.json();
+    return data.latest ?? null;
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+function stripTrailingCommas(json) {
+  return json.replace(/,(\s*[}\]])/g, "$1");
+}
+function removeFromBunLock(cacheDir) {
+  const textLockPath = path8.join(cacheDir, "bun.lock");
+  const binaryLockPath = path8.join(cacheDir, "bun.lockb");
+  if (fs8.existsSync(textLockPath)) {
+    try {
+      const content = fs8.readFileSync(textLockPath, "utf-8");
+      const lock = JSON.parse(stripTrailingCommas(content));
+      if (lock.packages?.[PACKAGE_NAME]) {
+        delete lock.packages[PACKAGE_NAME];
+        fs8.writeFileSync(textLockPath, JSON.stringify(lock, null, 2));
+        logDebug(`Removed ${PACKAGE_NAME} from bun.lock`);
+        return true;
+      }
+      return false;
+    } catch {
+      try {
+        fs8.unlinkSync(textLockPath);
+        logDebug("Deleted unparseable bun.lock to force re-resolution");
+        return true;
+      } catch {
+        return false;
+      }
+    }
+  }
+  if (fs8.existsSync(binaryLockPath)) {
+    try {
+      fs8.unlinkSync(binaryLockPath);
+      logDebug("Deleted bun.lockb to force re-resolution");
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  return false;
+}
+function invalidatePackage() {
+  const cacheDir = getOpenCodeCacheDir();
+  const configDir = getOpenCodeConfigDir();
+  const pkgDirs = [
+    path8.join(cacheDir, "node_modules", PACKAGE_NAME),
+    path8.join(configDir, "node_modules", PACKAGE_NAME)
+  ];
+  let packageRemoved = false;
+  let lockRemoved = false;
+  for (const pkgDir of pkgDirs) {
+    if (fs8.existsSync(pkgDir)) {
+      fs8.rmSync(pkgDir, { recursive: true, force: true });
+      logDebug(`Removed cached package: ${pkgDir}`);
+      packageRemoved = true;
+    }
+  }
+  lockRemoved = removeFromBunLock(cacheDir);
+  return packageRemoved || lockRemoved;
+}
+async function runBunInstall() {
+  const cacheDir = getOpenCodeCacheDir();
+  const packageJsonPath = path8.join(cacheDir, "package.json");
+  if (!fs8.existsSync(packageJsonPath)) {
+    logDebug("No package.json in OpenCode cache, skipping bun install");
+    return false;
+  }
+  try {
+    const proc = Bun.spawn(["bun", "install"], {
+      cwd: cacheDir,
+      stdout: "ignore",
+      stderr: "ignore"
+    });
+    let timeoutId;
+    const timeoutPromise = new Promise((resolve5) => {
+      timeoutId = setTimeout(() => resolve5("timeout"), BUN_INSTALL_TIMEOUT);
+    });
+    const exitPromise = proc.exited.then(() => "completed");
+    const result = await Promise.race([exitPromise, timeoutPromise]);
+    clearTimeout(timeoutId);
+    if (result === "timeout") {
+      try {
+        proc.kill();
+      } catch {}
+      logError("bun install timed out after 60s");
+      return false;
+    }
+    if (proc.exitCode !== 0) {
+      logError(`bun install failed with exit code ${proc.exitCode}`);
+      return false;
+    }
+    return true;
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    logError(`bun install failed: ${message}`);
+    return false;
+  }
+}
+async function checkAndUpdate() {
+  const cachedVersion = getCachedVersion();
+  const latestVersion = await getLatestVersion();
+  if (!latestVersion) {
+    logDebug("Could not fetch latest version from npm registry, skipping update check");
+    return {
+      updateAvailable: false,
+      previousVersion: cachedVersion,
+      latestVersion: null,
+      installed: false
+    };
+  }
+  if (cachedVersion === latestVersion) {
+    logDebug(`Already on latest version: ${cachedVersion}`);
+    return {
+      updateAvailable: false,
+      previousVersion: cachedVersion,
+      latestVersion,
+      installed: false
+    };
+  }
+  log(`Update available: ${cachedVersion ?? "unknown"} \u2192 ${latestVersion}`);
+  invalidatePackage();
+  const installSuccess = await runBunInstall();
+  if (installSuccess) {
+    log(`Updated to ${latestVersion}. Restart OpenCode to apply.`);
+    return {
+      updateAvailable: true,
+      previousVersion: cachedVersion,
+      latestVersion,
+      installed: true
+    };
+  }
+  logError(`Failed to install update to ${latestVersion}`);
+  return {
+    updateAvailable: true,
+    previousVersion: cachedVersion,
+    latestVersion,
+    installed: false,
+    error: "bun install failed"
+  };
+}
+
 // src/index.ts
-var PACKAGE_ROOT = path8.resolve(import.meta.dir, "..");
+var PACKAGE_ROOT = path9.resolve(import.meta.dir, "..");
 var initialized = false;
 var REQUIRED_RUNTIME_PLUGINS = ["@tarquinen/opencode-dcp@latest"];
 var DEFAULT_OPENCODE_AGENTS_TO_DISABLE = ["build", "plan"];
@@ -10358,7 +10541,16 @@ var WpromoteConfigPlugin = async (ctx) => {
         }
       }
     },
-    event: async ({ event }) => {}
+    event: async ({ event }) => {
+      if (event.type !== "session.created")
+        return;
+      const props = event.properties;
+      if (props?.info?.parentID)
+        return;
+      checkAndUpdate().catch((err) => {
+        logError(`Auto-update check failed: ${err instanceof Error ? err.message : String(err)}`);
+      });
+    }
   };
 };
 var RemoteSkillsPlugin = WpromoteConfigPlugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wpro-eng/opencode-config",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Wpromote OpenCode plugin to sync team config assets on startup",
   "repository": {
     "type": "git",