oh-my-claudecode-opencode 0.5.4 → 0.6.1

package/assets/agents/scientist.md

@@ -45,7 +45,7 @@ TOOL USAGE RULES:
 NOT AVAILABLE (will fail if attempted):
 - Write: Use Python to write files instead
 - Edit: You should not edit code files
-- Task: You do not delegate to other agents
+- call_omco_agent: You do not delegate to other agents
 - WebSearch/WebFetch: Use researcher agent for external research
 </Tools_Available>
 
@@ -706,8 +706,8 @@ sed -i 's/foo/bar/' script.py
 
 5. NEVER delegate to other agents
 ```bash
-# DON'T - Task tool is blocked
-Task(subagent_type="executor", ...)
+# DON'T - call_omco_agent tool is blocked
+call_omco_agent(subagent_type="executor", ...)
 ```
 
 6. NEVER run interactive prompts

package/assets/skills/deepinit.md

@@ -85,7 +85,7 @@ This creates a navigable hierarchy:
 ### Step 1: Map Directory Structure
 
 ```
-Task(subagent_type="explore", model="haiku",
+call_omco_agent(subagent_type="explore", model="haiku", run_in_background=true,
   prompt="List all directories recursively. Exclude: node_modules, .git, dist, build, __pycache__, .venv, coverage, .next, .nuxt")
 ```
 

package/assets/skills/orchestrate.md

@@ -122,11 +122,11 @@ I will use omc_task with:
 ```typescript
 // CORRECT: Always background, always parallel, ALWAYS pass model explicitly!
 // Contextual Grep (internal)
-Task(subagent_type="explore", model="haiku", prompt="Find auth implementations in our codebase...")
-Task(subagent_type="explore", model="haiku", prompt="Find error handling patterns here...")
+call_omco_agent(subagent_type="explore", model="haiku", run_in_background=true, prompt="Find auth implementations in our codebase...")
+call_omco_agent(subagent_type="explore", model="haiku", run_in_background=true, prompt="Find error handling patterns here...")
 // Reference Grep (external)
-Task(subagent_type="researcher", model="sonnet", prompt="Find JWT best practices in official docs...")
-Task(subagent_type="researcher", model="sonnet", prompt="Find how production apps handle auth in Express...")
+call_omco_agent(subagent_type="researcher", model="sonnet", run_in_background=true, prompt="Find JWT best practices in official docs...")
+call_omco_agent(subagent_type="researcher", model="sonnet", run_in_background=true, prompt="Find how production apps handle auth in Express...")
 // Continue working immediately. Collect with background_output when needed.
 
 // WRONG: Sequential or blocking
@@ -259,7 +259,7 @@ Claude models are prone to premature completion claims. Before saying "done", yo
 
 2. **Invoke Architect for verification** (ALWAYS pass model explicitly!):
 ```
-Task(subagent_type="architect", model="opus", prompt="VERIFY COMPLETION REQUEST:
+call_omco_agent(subagent_type="architect", model="opus", run_in_background=false, prompt="VERIFY COMPLETION REQUEST:
 Original task: [describe the original request]
 What I implemented: [list all changes made]
 Verification done: [list tests run, builds checked]

package/assets/skills/ralph.md

@@ -49,9 +49,9 @@ Ralph automatically activates Ultrawork for maximum parallel execution. You MUST
 
 **CRITICAL: Always pass `model` parameter explicitly!**
 ```
-Task(subagent_type="oh-my-claudecode:architect-low", model="haiku", prompt="...")
-Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="...")
-Task(subagent_type="oh-my-claudecode:architect", model="opus", prompt="...")
+call_omco_agent(subagent_type="oh-my-claudecode:architect-low", model="haiku", run_in_background=true, prompt="...")
+call_omco_agent(subagent_type="oh-my-claudecode:executor", model="sonnet", run_in_background=true, prompt="...")
+call_omco_agent(subagent_type="oh-my-claudecode:architect", model="opus", run_in_background=true, prompt="...")
 ```
 
 ### Background Execution Rules
@@ -107,7 +107,7 @@ Before outputting the completion promise:
 When you believe the task is complete:
 1. **First**, spawn Architect to verify your work (ALWAYS pass model explicitly!):
    ```
-   Task(subagent_type="oh-my-claudecode:architect", model="opus", prompt="Verify this implementation is complete: [describe what you did]")
+   call_omco_agent(subagent_type="oh-my-claudecode:architect", model="opus", run_in_background=false, prompt="Verify this implementation is complete: [describe what you did]")
    ```
 
 2. **Wait for Architect's assessment**

package/assets/skills/research.md

@@ -60,17 +60,17 @@ When given a research goal, decompose into 3-7 independent stages:
 
 ### Parallel Scientist Invocation
 
-Fire independent stages in parallel via Task tool:
+Fire independent stages in parallel via call_omco_agent tool:
 
 ```
 // Stage 1 - Simple data gathering
-Task(subagent_type="oh-my-claudecode:scientist-low", model="haiku", prompt="[RESEARCH_STAGE:1] Investigate...")
+call_omco_agent(subagent_type="oh-my-claudecode:scientist-low", model="haiku", run_in_background=true, prompt="[RESEARCH_STAGE:1] Investigate...")
 
 // Stage 2 - Standard analysis
-Task(subagent_type="oh-my-claudecode:scientist", model="sonnet", prompt="[RESEARCH_STAGE:2] Analyze...")
+call_omco_agent(subagent_type="oh-my-claudecode:scientist", model="sonnet", run_in_background=true, prompt="[RESEARCH_STAGE:2] Analyze...")
 
 // Stage 3 - Complex reasoning
-Task(subagent_type="oh-my-claudecode:scientist-high", model="opus", prompt="[RESEARCH_STAGE:3] Deep analysis of...")
+call_omco_agent(subagent_type="oh-my-claudecode:scientist-high", model="opus", run_in_background=true, prompt="[RESEARCH_STAGE:3] Deep analysis of...")
 ```
 
 ### Smart Model Routing
@@ -100,7 +100,7 @@ After parallel execution completes, verify findings:
 
 ```
 // Cross-validation stage
-Task(subagent_type="oh-my-claudecode:scientist", model="sonnet", prompt="
+call_omco_agent(subagent_type="oh-my-claudecode:scientist", model="sonnet", run_in_background=false, prompt="
 [RESEARCH_VERIFICATION]
 Cross-validate these findings for consistency:
 
@@ -181,9 +181,9 @@ When stages analyze different data sources:
 
 ```
 // All fire simultaneously
-Task(subagent_type="oh-my-claudecode:scientist-low", model="haiku", prompt="[STAGE:1] Analyze src/api/...")
-Task(subagent_type="oh-my-claudecode:scientist-low", model="haiku", prompt="[STAGE:2] Analyze src/utils/...")
-Task(subagent_type="oh-my-claudecode:scientist-low", model="haiku", prompt="[STAGE:3] Analyze src/components/...")
+call_omco_agent(subagent_type="oh-my-claudecode:scientist-low", model="haiku", run_in_background=true, prompt="[STAGE:1] Analyze src/api/...")
+call_omco_agent(subagent_type="oh-my-claudecode:scientist-low", model="haiku", run_in_background=true, prompt="[STAGE:2] Analyze src/utils/...")
+call_omco_agent(subagent_type="oh-my-claudecode:scientist-low", model="haiku", run_in_background=true, prompt="[STAGE:3] Analyze src/components/...")
 ```
 
 ### Hypothesis Battery (Parallel)
@@ -192,9 +192,9 @@ When testing multiple hypotheses:
 
 ```
 // Test hypotheses simultaneously
-Task(subagent_type="oh-my-claudecode:scientist", model="sonnet", prompt="[HYPOTHESIS:A] Test if caching improves...")
-Task(subagent_type="oh-my-claudecode:scientist", model="sonnet", prompt="[HYPOTHESIS:B] Test if batching reduces...")
-Task(subagent_type="oh-my-claudecode:scientist", model="sonnet", prompt="[HYPOTHESIS:C] Test if lazy loading helps...")
+call_omco_agent(subagent_type="oh-my-claudecode:scientist", model="sonnet", run_in_background=true, prompt="[HYPOTHESIS:A] Test if caching improves...")
+call_omco_agent(subagent_type="oh-my-claudecode:scientist", model="sonnet", run_in_background=true, prompt="[HYPOTHESIS:B] Test if batching reduces...")
+call_omco_agent(subagent_type="oh-my-claudecode:scientist", model="sonnet", run_in_background=true, prompt="[HYPOTHESIS:C] Test if lazy loading helps...")
 ```
 
 ### Cross-Validation (Sequential)
@@ -206,7 +206,7 @@ When verification depends on all findings:
 [stages complete]
 
 // Then sequential verification
-Task(subagent_type="oh-my-claudecode:scientist-high", model="opus", prompt="
+call_omco_agent(subagent_type="oh-my-claudecode:scientist-high", model="opus", run_in_background=false, prompt="
 [CROSS_VALIDATION]
 Validate consistency across all findings:
 - Finding 1: ...

package/assets/skills/ultraqa.md

@@ -40,7 +40,7 @@ If no structured goal provided, interpret the argument as a custom goal.
    - `--custom`: Run appropriate command and check for pattern
    - `--interactive`: Use qa-tester for interactive CLI/service testing:
      ```
-     Task(subagent_type="oh-my-claudecode:qa-tester", model="sonnet", prompt="TEST:
+     call_omco_agent(subagent_type="oh-my-claudecode:qa-tester", model="sonnet", run_in_background=true, prompt="TEST:
      Goal: [describe what to verify]
      Service: [how to start]
      Test cases: [specific scenarios to verify]")
@@ -52,7 +52,7 @@ If no structured goal provided, interpret the argument as a custom goal.
 
 3. **ARCHITECT DIAGNOSIS**: Spawn architect to analyze failure
    ```
-   Task(subagent_type="oh-my-claudecode:architect", model="opus", prompt="DIAGNOSE FAILURE:
+   call_omco_agent(subagent_type="oh-my-claudecode:architect", model="opus", run_in_background=false, prompt="DIAGNOSE FAILURE:
    Goal: [goal type]
    Output: [test/build output]
    Provide root cause and specific fix recommendations.")
@@ -60,7 +60,7 @@ If no structured goal provided, interpret the argument as a custom goal.
 
 4. **FIX ISSUES**: Apply architect's recommendations
    ```
-   Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="FIX:
+   call_omco_agent(subagent_type="oh-my-claudecode:executor", model="sonnet", run_in_background=true, prompt="FIX:
    Issue: [architect diagnosis]
    Files: [affected files]
    Apply the fix precisely as recommended.")

package/assets/skills/ultrawork.md

@@ -54,19 +54,19 @@ This skill enhances Claude's capabilities by:
 
 ```
 // Simple question → LOW tier (saves tokens!)
-Task(subagent_type="oh-my-claudecode:architect-low", model="haiku", prompt="What does this function return?")
+call_omco_agent(subagent_type="oh-my-claudecode:architect-low", model="haiku", run_in_background=true, prompt="What does this function return?")
 
 // Standard implementation → MEDIUM tier
-Task(subagent_type="oh-my-claudecode:executor", model="sonnet", prompt="Add error handling to login")
+call_omco_agent(subagent_type="oh-my-claudecode:executor", model="sonnet", run_in_background=true, prompt="Add error handling to login")
 
 // Complex refactoring → HIGH tier
-Task(subagent_type="oh-my-claudecode:executor-high", model="opus", prompt="Refactor auth module using JWT across 5 files")
+call_omco_agent(subagent_type="oh-my-claudecode:executor-high", model="opus", run_in_background=true, prompt="Refactor auth module using JWT across 5 files")
 
 // Quick file lookup → LOW tier
-Task(subagent_type="oh-my-claudecode:explore", model="haiku", prompt="Find where UserService is defined")
+call_omco_agent(subagent_type="oh-my-claudecode:explore", model="haiku", run_in_background=true, prompt="Find where UserService is defined")
 
 // Thorough search → MEDIUM tier
-Task(subagent_type="oh-my-claudecode:explore-medium", model="sonnet", prompt="Find all authentication patterns in the codebase")
+call_omco_agent(subagent_type="oh-my-claudecode:explore-medium", model="sonnet", run_in_background=true, prompt="Find all authentication patterns in the codebase")
 ```
 
 ## Background Execution Rules

package/bin/doctor.js

@@ -4,6 +4,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import * as os from "node:os";
+import { execSync } from "node:child_process";
 var OPENCODE_CONFIG_DIR = path.join(os.homedir(), ".config", "opencode");
 var PLUGIN_NAME = "oh-my-claudecode-opencode";
 function checkPluginInstalled() {
@@ -163,13 +164,107 @@ function checkOmcoConfig() {
     details: "Optional: create .opencode/omco.json for custom config"
   };
 }
+function checkVersionUpdate() {
+  const pluginPkgPath = path.join(OPENCODE_CONFIG_DIR, "node_modules", PLUGIN_NAME, "package.json");
+  try {
+    if (!fs.existsSync(pluginPkgPath)) {
+      return {
+        status: "FAIL",
+        message: "Plugin not installed"
+      };
+    }
+    const pkg = JSON.parse(fs.readFileSync(pluginPkgPath, "utf-8"));
+    const installedVersion = pkg.version;
+    try {
+      const npmVersion = execSync(`npm view ${PLUGIN_NAME} version`, {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"]
+      }).trim();
+      if (installedVersion === npmVersion) {
+        return {
+          status: "OK",
+          message: `Up to date (v${installedVersion})`
+        };
+      } else {
+        return {
+          status: "WARN",
+          message: `Update available: v${installedVersion} → v${npmVersion}`,
+          fix: `Run: cd ~/.config/opencode && npm install ${PLUGIN_NAME}@latest`
+        };
+      }
+    } catch (npmError) {
+      return {
+        status: "OK",
+        message: "Could not check npm registry (offline?)",
+        details: `Installed: v${installedVersion}`
+      };
+    }
+  } catch (e) {
+    return {
+      status: "FAIL",
+      message: `Failed to check version: ${e.message}`
+    };
+  }
+}
+function checkToolCompatibility() {
+  const distPath = path.join(OPENCODE_CONFIG_DIR, "node_modules", PLUGIN_NAME, "dist", "index.js");
+  const skillPath = path.join(OPENCODE_CONFIG_DIR, "node_modules", PLUGIN_NAME, "assets", "skills", "orchestrate.md");
+  try {
+    if (!fs.existsSync(distPath)) {
+      return {
+        status: "FAIL",
+        message: "dist/index.js not found"
+      };
+    }
+    const distContent = fs.readFileSync(distPath, "utf-8");
+    const hasNewTool = distContent.includes("call_omco_agent");
+    const hasOldTool = distContent.includes("call_omo_agent");
+    let hasDeprecatedSkillAPI = false;
+    if (fs.existsSync(skillPath)) {
+      const skillContent = fs.readFileSync(skillPath, "utf-8");
+      hasDeprecatedSkillAPI = skillContent.includes("Task(subagent_type");
+    }
+    if (hasOldTool) {
+      return {
+        status: "WARN",
+        message: "Using deprecated tool name (call_omo_agent)",
+        fix: `Update to v0.6.0+: cd ~/.config/opencode && npm install ${PLUGIN_NAME}@latest`
+      };
+    }
+    if (hasDeprecatedSkillAPI) {
+      return {
+        status: "WARN",
+        message: "Skills still reference Claude Code Task() API",
+        fix: `Update to v0.6.0+: cd ~/.config/opencode && npm install ${PLUGIN_NAME}@latest`
+      };
+    }
+    if (hasNewTool) {
+      return {
+        status: "OK",
+        message: "Tool API is up to date (call_omco_agent)"
+      };
+    }
+    return {
+      status: "WARN",
+      message: "Tool API compatibility unclear",
+      fix: `Reinstall: cd ~/.config/opencode && npm install ${PLUGIN_NAME}@latest`
+    };
+  } catch (e) {
+    return {
+      status: "FAIL",
+      message: `Failed to check tool compatibility: ${e.message}`
+    };
+  }
+}
 function runDiagnostics() {
   const checks = {
     pluginInstalled: checkPluginInstalled(),
     pluginInConfig: checkPluginInConfig(),
     assetsPresent: checkAssetsPresent(),
     packageDependency: checkPackageDependency(),
-    omcoConfigValid: checkOmcoConfig()
+    omcoConfigValid: checkOmcoConfig(),
+    versionUpdate: checkVersionUpdate(),
+    toolCompatibility: checkToolCompatibility()
   };
   const values = Object.values(checks);
   const summary = {

package/bin/doctor.ts

@@ -4,6 +4,7 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as os from 'node:os';
+import { execSync } from 'node:child_process';
 
 const OPENCODE_CONFIG_DIR = path.join(os.homedir(), '.config', 'opencode');
 const PLUGIN_NAME = 'oh-my-claudecode-opencode';
@@ -27,6 +28,8 @@ interface DiagnosticReport {
     assetsPresent: CheckResult;
     packageDependency: CheckResult;
     omcoConfigValid: CheckResult;
+    versionUpdate: CheckResult;
+    toolCompatibility: CheckResult;
   };
   summary: {
     total: number;
@@ -234,6 +237,120 @@ function checkOmcoConfig(): CheckResult {
   };
 }
 
+// ============================================================
+// CHECK 6: Version Update Check
+// ============================================================
+function checkVersionUpdate(): CheckResult {
+  const pluginPkgPath = path.join(OPENCODE_CONFIG_DIR, 'node_modules', PLUGIN_NAME, 'package.json');
+
+  try {
+    if (!fs.existsSync(pluginPkgPath)) {
+      return {
+        status: 'FAIL',
+        message: 'Plugin not installed'
+      };
+    }
+
+    const pkg = JSON.parse(fs.readFileSync(pluginPkgPath, 'utf-8'));
+    const installedVersion = pkg.version;
+
+    // Try to check npm registry for latest version
+    try {
+      const npmVersion = execSync(`npm view ${PLUGIN_NAME} version`, {
+        encoding: 'utf-8',
+        stdio: ['pipe', 'pipe', 'pipe']
+      }).trim();
+
+      if (installedVersion === npmVersion) {
+        return {
+          status: 'OK',
+          message: `Up to date (v${installedVersion})`
+        };
+      } else {
+        return {
+          status: 'WARN',
+          message: `Update available: v${installedVersion} → v${npmVersion}`,
+          fix: `Run: cd ~/.config/opencode && npm install ${PLUGIN_NAME}@latest`
+        };
+      }
+    } catch (npmError) {
+      // Network error or npm not available
+      return {
+        status: 'OK',
+        message: 'Could not check npm registry (offline?)',
+        details: `Installed: v${installedVersion}`
+      };
+    }
+  } catch (e) {
+    return {
+      status: 'FAIL',
+      message: `Failed to check version: ${(e as Error).message}`
+    };
+  }
+}
+
+// ============================================================
+// CHECK 7: Tool Compatibility Check
+// ============================================================
+function checkToolCompatibility(): CheckResult {
+  const distPath = path.join(OPENCODE_CONFIG_DIR, 'node_modules', PLUGIN_NAME, 'dist', 'index.js');
+  const skillPath = path.join(OPENCODE_CONFIG_DIR, 'node_modules', PLUGIN_NAME, 'assets', 'skills', 'orchestrate.md');
+
+  try {
+    if (!fs.existsSync(distPath)) {
+      return {
+        status: 'FAIL',
+        message: 'dist/index.js not found'
+      };
+    }
+
+    const distContent = fs.readFileSync(distPath, 'utf-8');
+    const hasNewTool = distContent.includes('call_omco_agent');
+    const hasOldTool = distContent.includes('call_omo_agent');
+
+    // Check skill file for deprecated Task() API
+    let hasDeprecatedSkillAPI = false;
+    if (fs.existsSync(skillPath)) {
+      const skillContent = fs.readFileSync(skillPath, 'utf-8');
+      hasDeprecatedSkillAPI = skillContent.includes('Task(subagent_type');
+    }
+
+    if (hasOldTool) {
+      return {
+        status: 'WARN',
+        message: 'Using deprecated tool name (call_omo_agent)',
+        fix: `Update to v0.6.0+: cd ~/.config/opencode && npm install ${PLUGIN_NAME}@latest`
+      };
+    }
+
+    if (hasDeprecatedSkillAPI) {
+      return {
+        status: 'WARN',
+        message: 'Skills still reference Claude Code Task() API',
+        fix: `Update to v0.6.0+: cd ~/.config/opencode && npm install ${PLUGIN_NAME}@latest`
+      };
+    }
+
+    if (hasNewTool) {
+      return {
+        status: 'OK',
+        message: 'Tool API is up to date (call_omco_agent)'
+      };
+    }
+
+    return {
+      status: 'WARN',
+      message: 'Tool API compatibility unclear',
+      fix: `Reinstall: cd ~/.config/opencode && npm install ${PLUGIN_NAME}@latest`
+    };
+  } catch (e) {
+    return {
+      status: 'FAIL',
+      message: `Failed to check tool compatibility: ${(e as Error).message}`
+    };
+  }
+}
+
 // ============================================================
 // MAIN
 // ============================================================
@@ -244,6 +361,8 @@ function runDiagnostics(): DiagnosticReport {
     assetsPresent: checkAssetsPresent(),
     packageDependency: checkPackageDependency(),
     omcoConfigValid: checkOmcoConfig(),
+    versionUpdate: checkVersionUpdate(),
+    toolCompatibility: checkToolCompatibility(),
   };
 
   const values = Object.values(checks);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-claudecode-opencode",
-  "version": "0.5.4",
+  "version": "0.6.1",
   "description": "OpenCode port of oh-my-claudecode - Multi-agent orchestration plugin (omco)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",