feat(adaptation): enhance platform detection and cache path handling for OpenCode/KiloCode

Author: mikij

.gitignore

@@ -20,3 +20,6 @@ context-mode-guidance-*/
 .claude-worktrees/
 .vibetree/
 .cw/
+# CocoIndex Code (ccc)
+/.cocoindex_code/
+/.kilo/

README.md

@@ -919,7 +919,7 @@ Session continuity requires 4 hooks working together:
 | **SessionStart** | Restores state after compaction or resume | Yes | Yes | Yes | Yes | -- | -- | -- | Plugin | Yes | -- | -- | -- | ✓ (via session_start event) |
 | | **Session completeness** | **Full** | **High** | **High** | **High** | **Partial** | **High** | **High** | **High** | **Partial** | **--** | **Partial** | **--** | **High** |
 
-> **Note:** Full session continuity (capture + snapshot + restore) works on **Claude Code**, **Gemini CLI**, **VS Code Copilot**, and **JetBrains Copilot**. **OpenCode** provides **high** session continuity: it captures tool events and injects compaction snapshots via the plugin, but SessionStart is not yet available ([#14808](https://github.com/sst/opencode/issues/14808)), so startup/resume restore is not supported. **KiloCode** shares the same plugin architecture as OpenCode via the OpenCodeAdapter, so its continuity level depends on KiloCode's SessionStart support. **Cursor** captures tool events via `preToolUse`/`postToolUse`, but `sessionStart` is currently rejected by Cursor's validator ([forum report](https://forum.cursor.com/t/unknown-hook-type-sessionstart/149566)), so session restore after compaction is not available yet. **OpenClaw** uses native gateway plugin hooks (`api.on()`) for full session continuity. **Pi Coding Agent** provides high session continuity via extension hooks (`tool_call`, `tool_result`, `session_start`, `session_before_compact`). **Codex CLI** provides partial hook-based session tracking through PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, and Stop; MCP tools work. **Antigravity**, **Kiro**, and **Zed** have no hook support in the current release, so session tracking is not available.
+> **Note:** Full session continuity (capture + snapshot + restore) works on **Claude Code**, **Gemini CLI**, **VS Code Copilot**, and **JetBrains Copilot**. **OpenCode** provides **high** session continuity: it captures tool events and injects compaction snapshots via the plugin, but SessionStart is not yet available ([#14808](https://github.com/sst/opencode/issues/14808)), so startup/resume restore is not supported. There is a plugin available that enforces model to use context-mode on session start. More details on their [home page](https://github.com/AbdelrhmanUZaki/opencode-enforce-context-mode). **KiloCode** shares the same plugin architecture as OpenCode via the OpenCodeAdapter, so its continuity level depends on KiloCode's SessionStart support. **Cursor** captures tool events via `preToolUse`/`postToolUse`, but `sessionStart` is currently rejected by Cursor's validator ([forum report](https://forum.cursor.com/t/unknown-hook-type-sessionstart/149566)), so session restore after compaction is not available yet. **OpenClaw** uses native gateway plugin hooks (`api.on()`) for full session continuity. **Pi Coding Agent** provides high session continuity via extension hooks (`tool_call`, `tool_result`, `session_start`, `session_before_compact`). **Codex CLI** provides partial hook-based session tracking through PreToolUse, PostToolUse, SessionStart, UserPromptSubmit, and Stop; MCP tools work. **Antigravity**, **Kiro**, and **Zed** have no hook support in the current release, so session tracking is not available.
 
 <details>
 <summary><strong>What gets captured</strong></summary>

cli.bundle.mjs

@@ -34,7 +34,7 @@ export const PLATFORM_ENV_VARS = [
   ["claude-code", ["CLAUDE_PROJECT_DIR", "CLAUDE_SESSION_ID"]],
   ["gemini-cli", ["GEMINI_PROJECT_DIR", "GEMINI_CLI"]],
   ["openclaw", ["OPENCLAW_HOME", "OPENCLAW_CLI"]],
-  ["kilo", ["KILO", "KILO_PID"]],
+  ["kilo", ["KILO", "KILO_PID", "KILOCODE_VERSION"]],
   ["opencode", ["OPENCODE", "OPENCODE_PID"]],
   ["codex", ["CODEX_CI", "CODEX_THREAD_ID"]],
   ["cursor", ["CURSOR_TRACE_ID", "CURSOR_CLI"]],
@@ -53,6 +53,7 @@ export function detectPlatform(clientInfo?: { name: string; version?: string }):
   // ── Highest priority: MCP clientInfo ──────────────────
   if (clientInfo?.name) {
     const platform = CLIENT_NAME_TO_PLATFORM[clientInfo.name];
+    
     if (platform) {
       return {
         platform,

server.bundle.mjs

@@ -426,12 +426,13 @@ export class OpenCodeAdapter extends BaseAdapter implements HookAdapter {
   }
 
   getInstalledVersion(): string {
-    // Check ~/.cache/opencode/node_modules/ for context-mode
     try {
       const pkgPath = resolve(
         homedir(),
         ".cache",
         this.platform,
+        "packages",
+        "context-mode@latest",
         "node_modules",
         "context-mode",
         "package.json",

src/adapters/detect.ts

@@ -116,7 +116,7 @@ const args = process.argv.slice(2);
 if (args[0] === "doctor") {
   doctor().then((code) => process.exit(code));
 } else if (args[0] === "upgrade") {
-  upgrade();
+  upgrade(args[1]);
 } else if (args[0] === "hook") {
   hookDispatch(args[1], args[2]);
 } else if (args[0] === "insight") {
@@ -173,10 +173,10 @@ function defaultPluginRoot(): string {
 function cachePluginRoot(platform: string): string {
   if (process.platform === "win32") {
     const localApp = process.env.LOCALAPPDATA;
-    if (localApp) return resolve(localApp, platform, "node_modules", "context-mode");
-    return resolve(homedir(), "AppData", "Local", platform, "node_modules", "context-mode");
+    if (localApp) return resolve(localApp, platform, "packages", "context-mode@latest", "node_modules", "context-mode");
+    return resolve(homedir(), "AppData", "Local", platform, "packages", "context-mode@latest", "node_modules", "context-mode");
   }
-  return resolve(homedir(), ".cache", platform, "node_modules", "context-mode");
+  return resolve(homedir(), ".cache", platform, "packages", "context-mode@latest", "node_modules", "context-mode");
 }
 
 function getPluginRoot(): string {
@@ -570,9 +570,19 @@ async function insight(port: number) {
  * Upgrade — adapter-aware hook configuration
  * ------------------------------------------------------- */
 
-async function upgrade() {
+async function upgrade(source = 'remote') {
   if (process.stdout.isTTY) console.clear();
 
+  // local mode is available only from context-mode git clone otherwise ignore local mode
+  try {
+    const gitCheck = execFileSync("git", ["remote", "get-url", "origin"], { stdio: "pipe" }).toString().trim();
+    if (source !== "remote" && gitCheck !== "https://github.com/mksglu/context-mode.git") {
+      source = "remote"
+    }
+  } catch {
+    source = "remote"
+  }
+
   // Detect platform
   const detection = detectPlatform();
   const adapter = await getAdapter(detection.platform);
@@ -588,25 +598,34 @@ async function upgrade() {
   const s = p.spinner();
 
   // Step 1: Pull latest from GitHub
-  p.log.step("Pulling latest from GitHub...");
+  if (source==="remote") {
+    p.log.step("Pulling latest from GitHub...");
+  } else {
+    p.log.step("Copying local branch...");
+  }
   const localVersion = getLocalVersion();
   const tmpDir = join(tmpdir(), `context-mode-upgrade-${Date.now()}`);
 
   s.start("Cloning mksglu/context-mode");
   try {
-    execFileSync(
-      "git", ["clone", "--depth", "1", "https://github.com/mksglu/context-mode.git", tmpDir],
-      { stdio: "pipe", timeout: 30000 },
-    );
-    s.stop("Downloaded");
+    if (source === 'remote'){
+      execFileSync(
+        "git", ["clone", "--depth", "1", "https://github.com/mksglu/context-mode.git", tmpDir],
+        { stdio: "pipe", timeout: 30000 },
+      );
+      s.stop("Downloaded");
+    } else {
+      cpSync(".", tmpDir, { recursive: true });
+      s.stop("Copied");
+    }
 
     const srcDir = tmpDir;
     const newPkg = JSON.parse(
       readFileSync(resolve(srcDir, "package.json"), "utf-8"),
     );
     const newVersion = newPkg.version ?? "unknown";
 
-    if (newVersion === localVersion) {
+    if (newVersion === localVersion && source === "remote") {
       p.log.success(color.green("Already on latest") + ` — v${localVersion}`);
       rmSync(tmpDir, { recursive: true, force: true });
       return;

src/adapters/opencode/index.ts

@@ -29,6 +29,7 @@ import type { HookInput } from "./session/extract.js";
 import { buildResumeSnapshot } from "./session/snapshot.js";
 import type { SessionEvent } from "./types.js";
 import { AdapterPlatformType, OpenCodeAdapter } from "./adapters/opencode/index.js";
+import { PLATFORM_ENV_VARS } from "./adapters/detect.js";
 
 // ── Types ─────────────────────────────────────────────────
 
@@ -78,7 +79,14 @@ interface CompactingHookOutput {
 
 // ── Helpers ───────────────────────────────────────────────
 function getPlatform(): AdapterPlatformType {
-  return process.env.KILO_PID ? "kilo" : "opencode";
+  const [platform, vars] = PLATFORM_ENV_VARS.filter(p => p[0]==="kilo")[0];
+  for (const _var of vars){
+    if (process.env[_var]) {
+      return platform;
+    }
+  }
+  
+  return "opencode";
 }
 
 // ── Plugin Factory ────────────────────────────────────────