chore(opencode): point config at authenticated models, document the delegation contract

[BreakableHoodie]

Summary

Points opencode.json at models that actually exist on this account, drops a plugin that errors on every run, and writes down the delegation contract.

The bug

config model:       anthropic/claude-sonnet-4-5
config small_model: anthropic/claude-haiku-4-5

authenticated providers:      OpenCode Zen, OpenCode Go
anthropic/ models in catalog: 0

The config named a provider this account is not authenticated to and that carries zero models. Any run falling back to the config default failed outright — the file predates the Zen/Go subscriptions. Verified fixed: a bare opencode run now answers where it previously could not resolve a provider.

Also removes opencode-snip: its binary is not on PATH, so it logged snip binary not found in PATH — plugin disabled on every single run.

The contract, in CLAUDE.md

Four rules, each attached to the thing that broke while establishing them:

1. Relay only, never a raw opencode run. opencode.json sets edit/bash/read/task to ask; a headless run without the relay's --auto blocks forever on a prompt nobody can answer.
2. --model always, from opencode-go/*. That is the flat-rate subscription. opencode/* is Zen and is metered per token.
3. Brief via file, never argv. ~1.5 KB of argv hung past 180s; the identical text attached as a file returned in 11s. The relay feeds stdin for exactly this reason.
4. opencode.json is the tooling surface — it hands OpenCode our CLAUDE.md plus 17 instruction files, 6 MCP servers, four agents and five commands. That is why a delegated diff can honour invariants the brief never restated.

Cost data (measured, 3 runs)

Task	Model	Cost
#797 — delete one meta tag	glm-5.2	$0.65
#766 — schema loader	deepseek-v4-pro	$0.125
#766 — 14 fixture fixes	glm-5.2	$2.14

OpenCode Go is $10/month flat but capped in usage dollars: $12 per 5 hours, $30/week, $60/month. At $2.14/run that is ~5 runs per window; at $0.125 it is ~96. Model choice is a throughput decision, not just a cost one.

deepseek-v4-pro being 5× cheaper than glm-5.2 inverts the naive "pro tier = expensive" assumption, so CLAUDE.md states plainly that only these three runs are measured rather than implying a ranking.

Test plan

• make gate green — 1119 backend + 1000 frontend, lint, format, build
• opencode.json parses as valid JSON
• Bare opencode run smoke-tested end to end: returns CONFIG-OK via glm-5.2
• command -v snip confirms the removed plugin's binary is genuinely absent

Notes

Config only — no application code touched.

Built by Theo · 🤖 Claude Code

Summary by CodeRabbit

• Documentation

  • Expanded OpenCode delegation guidance with relay-only execution, model selection, file-based briefs, tooling requirements, provider configuration, cost information, and a default model.
  • Updated the React 19 title-management example and documented the removal of Helmet usage from the band profile page.

• Configuration

  • Updated the default and lightweight model selections.
  • Removed the OpenCode Snip integration from the configured plugins.

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: d057048d-b7b2-4b51-a805-6c6f84fe52de

📥 Commits

Reviewing files that changed from the base of the PR and between c926453 and 08244a5.

📒 Files selected for processing (1)

• CLAUDE.md

🚧 Files skipped from review as they are similar to previous changes (1)

• CLAUDE.md

---

📝 Walkthrough

Walkthrough

The change updates OpenCode model and plugin settings. It adds delegation workflow guidance and updates the React 19 title-management example in CLAUDE.md.

Changes

OpenCode delegation

Layer / File(s)	Summary
OpenCode runtime settings opencode.json	The primary model changes to opencode-go/glm-5.2. The small model changes to opencode-go/deepseek-v4-flash. The opencode-snip plugin is removed.
Delegation workflow and React 19 guidance CLAUDE.md	The document adds relay usage, explicit model selection, file-based briefs, tooling configuration, provider authentication requirements, cost data, usage caps, verification steps, and a default model. The React 19 example now references EventRecapPage.jsx and documents the removal of Helmet usage from BandProfilePage.jsx.

Estimated code review effort: 2 (Simple) | ~10 minutes

🚥 Pre-merge checks | ✅ 5 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Description check	⚠️ Warning	The description explains the changes and verification, but it omits the required Security / correctness notes and leaves the Closes # field incomplete.	Add the issue number after Closes # and add a Security / correctness notes section with None or the applicable security and correctness impacts.

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title uses the required chore prefix and clearly describes the OpenCode configuration and delegation documentation changes.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Schema Drift	✅ Passed	No files under migrations/ changed in origin/main..HEAD, so the conditional requirement to update database/setup-complete.sql is not triggered.
Csp Hash Drift	✅ Passed	The PR changes only CLAUDE.md and opencode.json; frontend/index.html and frontend/public/_headers are unchanged, and the current SHA-256 hash matches.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/opencode-delegation-config

---

_{Comment @coderabbitai help to get the list of available commands.}

[Copilot]

Pull request overview

Updates OpenCode configuration defaults to use authenticated opencode-go/* models and removes a plugin that is not available, while documenting an OpenCode delegation contract in CLAUDE.md so future delegated runs are consistent and unblocked.

Changes:

• Point opencode.json default model/small_model at opencode-go/* models instead of unauthenticated anthropic/*.
• Remove opencode-snip from the configured plugin list.
• Add a “Delegating to OpenCode” section to CLAUDE.md documenting the relay-based workflow and constraints.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
opencode.json	Switch default model settings to authenticated opencode-go/* and remove the missing opencode-snip plugin.
CLAUDE.md	Document OpenCode delegation workflow/contract and operational rules for using the relay and models.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CLAUDE.md`:
- Line 75: Update the `opencode run` guidance in `CLAUDE.md` to state that
headless runs without `--auto` reject `ask` permission requests rather than
blocking indefinitely. Preserve the recommendation to use `relay.mjs` and
explain its `--auto` behavior accurately.

🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: c76142b7-219b-4c14-a8dc-df18fe52c59d

📥 Commits

Reviewing files that changed from the base of the PR and between 56292db and 672da97.

📒 Files selected for processing (2)

• CLAUDE.md
• opencode.json