plugin-updater 1.0.0

package/README.md

@@ -0,0 +1,56 @@
+# plugin-updater
+
+Plugin lifecycle manager for OpenCode and Claude Code launchers. Handles install, update, rebuild, downgrade, and uninstall operations for all plugins.
+
+## Under-the-Hood Architecture
+
+```mermaid
+flowchart TD
+    %% Triggers
+    subgraph Execution_Triggers [Execution Triggers]
+        CLI_BOOT[CLI Startup (claude/oc)]
+        TUI_MENU[Launcher TUI Actions]
+        
+        CLI_BOOT -->|Auto-runs hook on start| UPDATER_CORE
+        TUI_MENU -->|Manual rebuild/downgrade/uninstall| UPDATER_CORE
+    end
+
+    %% Core Logic
+    subgraph Plugin_Updater [Updater Core Logic]
+        UPDATER_CORE[Updater Engine]
+        API_LAYER[global.OpenCodeAPI Interop]
+        GIT_MGR[Git Operations Manager]
+        DEPLOYER[Plugin Deployer]
+        
+        UPDATER_CORE <-->|Requests repo paths| API_LAYER
+        UPDATER_CORE -->|Trigger sync| GIT_MGR
+        UPDATER_CORE -->|Trigger deploy| DEPLOYER
+    end
+
+    %% External & Storage
+    subgraph Storage_and_Network [Storage & External]
+        GH_REPOS[GitHub (intisy/plugin-*)]
+        LOCAL_WORKSPACE[(.config/github/repos/intisy/)]
+        CC_PLUGINS[(.claude/plugin/)]
+        OC_PLUGINS[(.config/opencode/plugin/)]
+        
+        GIT_MGR <-->|git clone/pull| GH_REPOS
+        GIT_MGR -->|Updates source| LOCAL_WORKSPACE
+        DEPLOYER -->|Copies compiled output| CC_PLUGINS
+        DEPLOYER -->|Copies compiled output| OC_PLUGINS
+    end
+```
+
+## API
+
+| Method | Description |
+|---|---|
+| `rebuild(pluginItem)` | Pull latest and redeploy |
+| `downgrade(pluginItem, commitHash)` | Checkout specific commit |
+| `disable(pluginItem)` | Cleanup on disable |
+| `uninstall(pluginItem)` | Remove repo and deployed files |
+| `registerTests(testApi)` | Register sync verification tests |
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,92 @@
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const REPOS_DIR = path.join(require('os').homedir(), '.config', 'github');
+
+function executeGit(cmd, dir) {
+  try {
+    return execSync(cmd, { cwd: dir, timeout: 60000, stdio: "ignore" });
+  } catch (e) {
+    console.error(`[Updater] Git command failed: ${cmd} in ${dir}`);
+    return false;
+  }
+}
+
+module.exports = {
+  name: "plugin-updater",
+
+  /**
+   * Called by the launcher (OpenCode/Claude Code) to sync a specific plugin
+   */
+  updatePlugin: function(pluginName, gitUrl, branch = null, commitHash = null) {
+    const targetDir = path.join(REPOS_DIR, pluginName);
+    
+    // 1. Ensure directory exists and clone or pull
+    if (!fs.existsSync(targetDir)) {
+      if (!fs.existsSync(REPOS_DIR)) fs.mkdirSync(REPOS_DIR, { recursive: true });
+      const branchFlag = branch ? `--branch ${branch}` : "";
+      executeGit(`git clone --recurse-submodules ${branchFlag} ${gitUrl} ${pluginName}`, REPOS_DIR);
+    } else {
+      executeGit("git fetch origin", targetDir);
+      if (commitHash) {
+        executeGit(`git checkout ${commitHash}`, targetDir);
+      } else if (branch) {
+        executeGit(`git checkout ${branch}`, targetDir);
+        executeGit(`git pull --ff-only origin ${branch}`, targetDir);
+      } else {
+        executeGit("git checkout main || git checkout master", targetDir);
+        executeGit("git pull --ff-only", targetDir);
+      }
+      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);
+    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
+      }
+    }
+
+    // Determine deployment source (prefer dist, fallback to root)
+    const distPath = path.join(sourceDir, "dist");
+    const deploySource = fs.existsSync(distPath) ? distPath : sourceDir;
+
+    // Copy to execution path
+    if (!fs.existsSync(executionPath)) {
+      fs.mkdirSync(executionPath, { recursive: true });
+    }
+
+    try {
+      // Platform agnostic copy (using Node fs)
+      fs.cpSync(deploySource, executionPath, { recursive: true, force: true });
+      return true;
+    } catch (e) {
+      console.error(`[Updater] Deploy failed: ${e.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");
+  }
+};

package/package.json

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