plugin-updater 1.0.0 → 1.0.8

package/.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Set version from tag
+        run: |
+          VERSION="${{ github.ref_name }}"
+          VERSION="${VERSION#v}"
+          npm version $VERSION --allow-same-version --no-git-tag-version
+
+      - run: npm publish --access public

package/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="KubernetesApiProvider"><![CDATA[{}]]></component>
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_25" default="true" project-jdk-name="25" project-jdk-type="JavaSDK">
+    <output url="file://$PROJECT_DIR$/out" />
+  </component>
+</project>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/plugin-updater.iml" filepath="$PROJECT_DIR$/.idea/plugin-updater.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/plugin-updater.iml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="JAVA_MODULE" version="4">
+  <component name="NewModuleRootManager" inherit-compiler-output="true">
+    <exclude-output />
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

package/SPEC.md

@@ -0,0 +1,13 @@
+# Plugin Updater - Specifications & Test Requirements
+
+## Goal
+Reliable core update mechanism for all OpenCode and Claude Code plugins.
+
+## Requirements
+- [ ] **Installation Order**: Must be installed FIRST in OpenCode, as it is responsible for installing all other plugins.
+- [ ] **Reliability**: Must never fail or crash, as the entire ecosystem depends on it.
+- [ ] **Launch Detection (Early Launch)**: 
+  - The updater exports an `earlyLaunch(configDir)` function. 
+  - Hub plugins (opencode-hub / claude-hub) MUST detect the updater and call `earlyLaunch` before OpenCode invokes it, deferring update flow management to the Hub.
+  - If launched directly via the normal application command (no hub / optional dependency), the updater executes its update routine automatically and MUST NOT install the Hub, as the Hub is strictly optional.
+  - Path resolution relies on the `configDir` passed by `earlyLaunch` or inferred from `process.argv`/input, NEVER relying on static environment variables like `CC_LAUNCHER`.

package/index.js

@@ -1,32 +1,52 @@
-const fs = require('fs');
+const fs = require('fs');
 const path = require('path');
+const os = require('os');
 const { execSync } = require('child_process');
 
-const REPOS_DIR = path.join(require('os').homedir(), '.config', 'github');
+let EARLY_LAUNCH_CONFIG_DIR = null;
 
-function executeGit(cmd, dir) {
+function getAppConfigDir(appName) {
+  if (EARLY_LAUNCH_CONFIG_DIR) {
+    return EARLY_LAUNCH_CONFIG_DIR;
+  }
+  const home = os.homedir();
+  const directPath = path.join(home, `.${appName}`);
+  const configPath = path.join(home, ".config", appName);
+  return fs.existsSync(directPath) ? directPath : configPath;
+}
+
+function getReposDir() {
+  const isClaude = process.argv.join(' ').includes('claude');
+  const appName = isClaude ? "claude" : "opencode";
+  return path.join(getAppConfigDir(appName), "repos");
+}
+
+function executeGit(command, cwd) {
   try {
-    return execSync(cmd, { cwd: dir, timeout: 60000, stdio: "ignore" });
-  } catch (e) {
-    console.error(`[Updater] Git command failed: ${cmd} in ${dir}`);
+    execSync(command, { cwd, stdio: "ignore" });
+    return true;
+  } catch (error) {
+    console.error(`[Updater] Git error in ${cwd}: ${error.message}`);
     return false;
   }
 }
 
-module.exports = {
+const updaterAPI = {
   name: "plugin-updater",
 
-  /**
-   * Called by the launcher (OpenCode/Claude Code) to sync a specific plugin
-   */
+  earlyLaunch: function(configDir) {
+    EARLY_LAUNCH_CONFIG_DIR = configDir;
+    global.__PLUGIN_UPDATER_HANDLED_BY_HUB__ = true;
+  },
+
   updatePlugin: function(pluginName, gitUrl, branch = null, commitHash = null) {
-    const targetDir = path.join(REPOS_DIR, pluginName);
+    const reposDir = getReposDir();
+    const targetDir = path.join(reposDir, pluginName);
     
-    // 1. Ensure directory exists and clone or pull
     if (!fs.existsSync(targetDir)) {
-      if (!fs.existsSync(REPOS_DIR)) fs.mkdirSync(REPOS_DIR, { recursive: true });
+      if (!fs.existsSync(reposDir)) fs.mkdirSync(reposDir, { recursive: true });
       const branchFlag = branch ? `--branch ${branch}` : "";
-      executeGit(`git clone --recurse-submodules ${branchFlag} ${gitUrl} ${pluginName}`, REPOS_DIR);
+      executeGit(`git clone --recurse-submodules ${branchFlag} ${gitUrl} ${pluginName}`, reposDir);
     } else {
       executeGit("git fetch origin", targetDir);
       if (commitHash) {
@@ -40,53 +60,91 @@ module.exports = {
       }
       executeGit("git submodule update --init --recursive", targetDir);
     }
-
     return true;
   },
 
-  /**
-   * Called to deploy the compiled output to the execution directory
-   */
   deployToExecutionDir: function(pluginName, executionPath) {
-    const sourceDir = path.join(REPOS_DIR, pluginName);
+    const sourceDir = path.join(getReposDir(), pluginName);
     if (!fs.existsSync(sourceDir)) return false;
 
-    // Build if package.json exists
     if (fs.existsSync(path.join(sourceDir, "package.json"))) {
       try {
         execSync("npm install", { cwd: sourceDir, stdio: "ignore" });
         execSync("npm run build", { cwd: sourceDir, stdio: "ignore" });
-      } catch (e) {
-        // Fallback or ignore if no build step
+      } catch (error) {
+        console.error(`[Updater] Build failed for ${pluginName}: ${error.message}`);
       }
     }
 
-    // Determine deployment source (prefer dist, fallback to root)
     const distPath = path.join(sourceDir, "dist");
     const deploySource = fs.existsSync(distPath) ? distPath : sourceDir;
+    const pluginExecutionPath = path.join(executionPath, pluginName);
 
-    // Copy to execution path
-    if (!fs.existsSync(executionPath)) {
-      fs.mkdirSync(executionPath, { recursive: true });
+    if (!fs.existsSync(pluginExecutionPath)) {
+      fs.mkdirSync(pluginExecutionPath, { recursive: true });
     }
 
     try {
-      // Platform agnostic copy (using Node fs)
-      fs.cpSync(deploySource, executionPath, { recursive: true, force: true });
+      fs.cpSync(deploySource, pluginExecutionPath, { recursive: true, force: true });
       return true;
-    } catch (e) {
-      console.error(`[Updater] Deploy failed: ${e.message}`);
+    } catch (error) {
+      console.error(`[Updater] Deploy failed for ${pluginName}: ${error.message}`);
       return false;
     }
   },
 
-  /**
-   * Specific logic to install/update the launcher itself
-   */
-  installLauncher: function() {
-    // Logic to install opencode-hub / claude-hub if they are missing
-    this.updatePlugin("core-hub", "https://github.com/intisy/core-hub.git");
-    this.updatePlugin("opencode-hub", "https://github.com/intisy/opencode-hub.git");
-    this.updatePlugin("claude-hub", "https://github.com/intisy/claude-hub.git");
+  rebuild: function(pluginObjOrName) {
+    const pluginName = typeof pluginObjOrName === 'string' ? pluginObjOrName : pluginObjOrName.name;
+    const targetDir = path.join(getReposDir(), pluginName);
+    if (fs.existsSync(targetDir)) {
+      try { fs.rmSync(targetDir, { recursive: true, force: true }); } catch (e) {}
+    }
+    return null;
+  },
+
+  disable: function(plugin) {
+    try {
+      const configDir = EARLY_LAUNCH_CONFIG_DIR || path.dirname(getReposDir());
+      const pluginExecutionPath = path.join(configDir, "plugin", plugin.name);
+      if (fs.existsSync(pluginExecutionPath)) {
+        fs.rmSync(pluginExecutionPath, { recursive: true, force: true });
+      }
+    } catch (e) {}
+  },
+
+  uninstall: function(plugin) {
+    this.disable(plugin);
+    const targetDir = path.join(getReposDir(), plugin.name);
+    if (fs.existsSync(targetDir)) {
+      try { fs.rmSync(targetDir, { recursive: true, force: true }); } catch (e) {}
+    }
   }
 };
+
+const pluginUpdaterEntry = async function(input) {
+  if (!global.__PLUGIN_UPDATER_HANDLED_BY_HUB__) {
+    const configDir = (input && input.configDir) ? input.configDir : path.dirname(getReposDir());
+    updaterAPI.earlyLaunch(configDir);
+
+    const pluginsJsonPath = path.join(configDir, "config", "plugins.json");
+    if (fs.existsSync(pluginsJsonPath)) {
+      try {
+        const plugins = JSON.parse(fs.readFileSync(pluginsJsonPath, "utf-8"));
+        for (const plugin of plugins) {
+          if (plugin.url && plugin.enabled !== false && plugin.type !== "npm") {
+            updaterAPI.updatePlugin(plugin.name, plugin.url, plugin.branch || null, plugin.commit || null);
+            updaterAPI.deployToExecutionDir(plugin.name, path.join(configDir, "plugin"));
+          }
+        }
+      } catch (e) {
+        console.error("[Updater] Failed to parse plugins.json", e);
+      }
+    }
+  }
+  return {};
+};
+
+const apiMethods = { ...updaterAPI };
+delete apiMethods.name;
+Object.assign(pluginUpdaterEntry, apiMethods);
+module.exports = pluginUpdaterEntry;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plugin-updater",
-  "version": "1.0.0",
+  "version": "1.0.8",
   "description": "Plugin lifecycle manager for OpenCode and Claude Code launchers",
   "main": "index.js",
   "license": "MIT",
@@ -9,5 +9,11 @@
     "type": "git",
     "url": "git+https://github.com/intisy/plugin-updater.git"
   },
-  "keywords": ["opencode", "claude", "plugin", "updater", "lifecycle"]
+  "keywords": [
+    "opencode",
+    "claude",
+    "plugin",
+    "updater",
+    "lifecycle"
+  ]
 }