feat(registry): Add OCX profile preservation for worktrees

[kdcokenny]

Summary

When OpenCode is launched via ocx opencode -p <profile>, the worktree plugin now automatically preserves the profile context when spawning new worktrees.

Changes

OCX CLI (packages/cli/src/commands/opencode.ts)

• Added resolveOcxBin() helper to find OCX binary path
• Added environment variables when spawning OpenCode:
  • OCX_CONTEXT=1 - Marker that OCX launched this session
  • OCX_BIN=<path> - Absolute path to OCX binary
  • OCX_PROFILE=<name> - Resolved effective profile

Worktree Plugin (workers/kdco-registry/files/plugin/worktree.ts, .opencode/plugin/worktree.ts)

• Added parseOcxContext() to detect OCX context from env vars
• Added buildWorktreeCommand() to generate correct spawn command
• Proper shell escaping with quoted values for paths with spaces
• Fails loud if OCX context detected but binary missing

Documentation

• Updated AGENTS.md with new env vars and "Worktree Profile Preservation" section
• Updated facades/opencode-worktree/README.md with "OCX Profile Support" section

Behavior

Launch Command	Worktree Spawns
opencode	opencode --session <id>
ocx opencode	ocx opencode --session <id>
ocx opencode -p work	ocx opencode -p work --session <id>

Multiple simultaneous sessions with different profiles work independently (env vars are process-scoped).

Testing

• Code review passed
• Shell escaping verified (paths with spaces, injection prevention)
• Philosophy compliance (5 Laws) verified
• Manual testing pending

---

Summary by cubic

Preserves OCX profile context when spawning new worktrees. If you launched OpenCode via ocx opencode -p , worktrees now start with the same profile using the OCX binary.

• New Features
  • Detects OCX context via env vars: OCX_CONTEXT, OCX_BIN, OCX_PROFILE.
  • Builds worktree argv and applies platform-specific shell escaping (bash, Windows batch); spawns “ocx opencode -p --session ” or “opencode --session ” when not under OCX.
  • CLI sets OCX context envs; fails loudly if OCX_BIN cannot be resolved. Documentation updated to cover profile preservation.

^{Written for commit a6b7c7e. Summary will update on new commits.}

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Updated (UTC)
✅ Deployment successful! View logs	ocx	a6b7c7e	Jan 22 2026, 06:11 PM

[cubic-dev-ai]

1 issue found across 5 files

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="workers/kdco-registry/files/plugin/worktree.ts">

<violation number="1" location="workers/kdco-registry/files/plugin/worktree.ts:84">
P2: Double-escaping issue: values are pre-escaped with `escapeBash()` and quoted here, but `terminal.ts` will escape the entire command string again. When the result is placed in a bash script in an unquoted context, the escaped quotes (`\"`) don't prevent word splitting on spaces. Paths or profile names with spaces will break.

Consider removing the escaping here and letting the terminal code handle it, or using single quotes which survive the transformation:</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 53.60%. Comparing base (aaa67a2) to head (a6b7c7e).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@           Coverage Diff           @@
##             main      #80   +/-   ##
=======================================
  Coverage   53.60%   53.60%           
=======================================
  Files          36       36           
  Lines        2722     2722           
=======================================
  Hits         1459     1459           
  Misses       1263     1263           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[cubic-dev-ai]

1 issue found across 3 files (changes from recent commits).

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="workers/kdco-registry/files/plugin/worktree/terminal.ts">

<violation number="1" location="workers/kdco-registry/files/plugin/worktree/terminal.ts:65">
P2: Incorrect escaping for quoted batch arguments. `escapeBatch()` is designed for unquoted contexts (adds `^&`, `^<`, etc.), but here it's applied inside double quotes where metacharacters don't need caret escaping. Only `%` needs escaping as `%%` inside quotes. This will cause arguments containing `&`, `<`, `>`, `|`, or `^` to include incorrect literal caret characters.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}