feat(adaptation): enhance platform detection and cache path handling …

[mikij]

…for OpenCode/KiloCode

What / Why / How

• I want to add new argument to CLI for upgrade so it will make OpenCode/KiloCode plugin development/testing much easier allowing it to update itself from local git branch. CLI should support local upgrade (context-mode upgrade local) which copies current git branch instead of cloning latest GH published version.
• Plugin needs to support new cache folder location. OpenCode silently changed (not documented) where is plugin stored inside of .cache folder (before .cache/opencode/node_modules/context-mode, now .cache/opencode/packages/context-mode@latest/node_modules/context-mode), so doctor or upgrade will not properly work for new versions of OpenCode/KiloCode. KiloCode also has a bug that uses OpenCode folder location instead of own. So `context-mode upgrade/doctor' will not work until that is resolved for KiloCode.

This fails in doctor:

■  Hook script exists: FAIL — not found at /Users/mickey/.cache/kilo/packages/context-mode@latest/node_modules/context-mode/hooks/pretooluse.mjs

Addition:

1. OpenCode now has SessionStart (via experimental.chat.messages.transform) — no longer "not yet available"
2. Both OpenCode and KiloCode now have high continuity (all 4 hooks working)
3. The AGENTS.md copy step is now optional rather than required for routing awareness

Affected platforms

• Claude Code
• Cursor
• VS Code Copilot (GitHub Copilot)
• JetBrains Copilot
• Gemini CLI
• Qwen Code
• OpenCode
• KiloCode
• Codex CLI
• OpenClaw (Pi Agent)
• Pi
• Kiro
• Antigravity
• Zed
• All platforms

Test plan

Checklist

• Tests added/updated (TDD: red → green)
• npm test passes
• npm run typecheck passes
• Docs updated if needed (README, platform-support.md)
• No Windows path regressions (forward slashes only)
• Targets next branch (unless hotfix)

Cross-platform notes

Our CI runs on Ubuntu, macOS, and Windows.

• If touching file paths, verify forward-slash normalization on Windows
• If touching hook paths, verify no backslash separators
• Use path.join() / path.resolve(), never hardcode / separators
• Use event-based stdin reading — readFileSync(0) breaks on Windows
• Use os.tmpdir(), never hardcode /tmp

[mikij]

@mksglu this is test run result from main

[mikij]

from next