Skip to content

Commit bad502d

Browse files
committed
fix(agents): Orca の overlay 下でも OpenCode の permission を読ませる
- Motivation: Orca はステータス表示用 plugin を置くため OPENCODE_CONFIG_DIR を overlay へ向けるが、OpenCode v2 はこれを global config の置き換えとして扱う (anomalyco/opencode#32825)。配備した permission が丸ごと無視され、未掲載コマンドが無条件実行になっていた - Change: shellenv.sh で OPENCODE_CONFIG_DIR があるときだけ OPENCODE_CONFIG を設定する。あわせて今セッションで書いたコメントを圧縮し、理由はドキュメントへ寄せる - Impact: 実環境で global config が document 0 件から 218 rules へ復活。1,793 tests passed
1 parent 494c6b5 commit bad502d

5 files changed

Lines changed: 92 additions & 29 deletions

File tree

‎docs/change/0002-opencode-ask-by-default.md‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -259,8 +259,12 @@ read / edit は 50 / 52 件で変化なし(224 → 218 rules)
259259
global config の**置き換え**として扱う(upstream の既知の不具合
260260
[#32825](https://github.com/anomalyco/opencode/issues/32825)、Open)。
261261
overlay に `opencode.json` が無いため permission 層ごと消える。
262-
回避策は `OPENCODE_CONFIG` の併用
262+
263+
対処として `shellenv.sh` に条件付きで `OPENCODE_CONFIG` を入れた
264+
(2026-09-21)。`OPENCODE_CONFIG_DIR` があるときだけ働く。実環境で
265+
global config が 0 件から 218 rules へ復活することを確認済み
263266
([試験環境の隔離方法](../research/opencode-test-isolation.md))。
267+
**反映には `chezmoi apply` と新しいセッションが要る。**
264268

265269
### 段階 2 の詳細
266270

‎docs/research/opencode-test-isolation.md‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -259,6 +259,80 @@ B の状態を実測した。`git status --short` は無確認で実行され、
259259

260260
サイズと評価コストは倍になるが、判定結果は変わらない。
261261

262+
### なぜ Orca が `OPENCODE_CONFIG_DIR` を設定するのか
263+
264+
[stablyai/orca#10328](https://github.com/stablyai/orca/pull/10328) が該当機能。
265+
266+
> OpenCode reports status via a JS **plugin** dropped into `OPENCODE_CONFIG_DIR`
267+
> (unlike Claude/Codex, which use managed `hooks.json` scripts).
268+
269+
Orca のサイドバーへ Idle / Working / Done を出すためだけの仕組み。Claude や
270+
Codex は `hooks.json` で済むが、OpenCode は plugin を置く必要があり、その
271+
置き場所として `OPENCODE_CONFIG_DIR` を使っている。
272+
273+
Orca は**既存の `OPENCODE_CONFIG_DIR` があれば symlink で overlay へ mirror**
274+
してから自分の plugin を足す設計で、ユーザー設定を壊さない配慮がある。
275+
元の値は `ORCA_OPENCODE_SOURCE_CONFIG_DIR` に退避される。
276+
277+
**しかし既定の `~/.config/opencode` は mirror の対象外。** mirror するのは
278+
「ユーザーが既に指定していた config dir」だけなので、`OPENCODE_CONFIG_DIR` を
279+
設定していない環境では plugin だけの素の overlay が作られる。
280+
281+
さらに Orca 側のレビューには次の記述がある。
282+
283+
> OpenCode also confirmed **`OPENCODE_CONFIG_DIR` is additive**:
284+
> default XDG config and the extra directory were both loaded.
285+
286+
**検証されたのは OpenCode 1.18.x(v1)。** v2 で挙動が変わったため、
287+
Orca の前提が崩れている。どちらも単体では正しく、組み合わせで壊れる。
288+
289+
### overlay の plugin は v2 でロードに失敗している
290+
291+
`~/.local/share/opencode/log/opencode.log` より。
292+
293+
```text
294+
level=WARN message="failed to load plugin"
295+
target=.../opencode-overlays/<hash>/plugins/orca-opencode-status.js
296+
cause="Plugin must export a default definition with an id and an effect or
297+
setup function. SchemaError(Missing key at ["default"]["effect"]
298+
/ ["default"]["setup"])"
299+
```
300+
301+
つまり現状は、**overlay の目的(ステータス表示)が達成できていないまま、
302+
副作用(global config を隠す)だけが出ている**。
303+
304+
Orca は [#14612](https://github.com/stablyai/orca/pull/14612) で V2 互換に
305+
取り組んでいるが、そちらは `server()` を足す内容で、2.0.10 が要求する
306+
`effect` / `setup` とは噛み合っていない(PR 本文に「1.18.18 で検証、
307+
v2 では未確認」と明記されている)。
308+
309+
### 採用した対処
310+
311+
`home/dot_config/shell/shellenv.sh.tmpl` に条件付きで入れた。
312+
`shellenv.sh` は `.zshenv` から無条件に source され、**zsh のあらゆる起動で
313+
最初に走る**ため、Orca がログインシェル経由で opencode を起動する経路に
314+
間に合う。
315+
316+
```sh
317+
if [[ -n "${OPENCODE_CONFIG_DIR:-}" && -f "${HOME}/.config/opencode/opencode.json" ]]; then
318+
export OPENCODE_CONFIG="${HOME}/.config/opencode/opencode.json"
319+
fi
320+
```
321+
322+
`OPENCODE_CONFIG_DIR` があるときだけ働くので、二重 merge を避けられる。
323+
Orca が将来 mirror するようになったり overlay をやめたりしても、
324+
自然に無害化する。
325+
326+
実環境での確認(`opencode api config.get`):
327+
328+
| 条件 | global config |
329+
| --- | --- |
330+
| 現状の Orca セッション | **document 0 件** |
331+
| 条件分岐が発火した状態 | **218 rules を 1 回** |
332+
333+
Orca 側には `agentStatusHooksEnabled` を `false` にして overlay をやめる
334+
経路もあるが、内部の `PtySpawnConfig` の値で、UI から切れるかは**未確認**。
335+
262336
## 8. 配備先の想定は正しい
263337

264338
実環境の `~/.config/opencode/` には OpenCode 自身が作った `service.json` が

‎home/dot_config/agents/common.toml.tmpl‎

Lines changed: 2 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -665,20 +665,9 @@ auto_update = false
665665
# 実在しない名前を deny したまま気付けなくなる。
666666
# see docs/spec/agent-permissions.md 「OpenCode へ渡さないもの」
667667

668-
# OpenCode 専用の shell allow。**[bash] allow とは別物**で、共用しない。
669-
#
670-
# [bash] allow は Claude / Copilot と共有しており、未掲載のコマンドを
671-
# classifier (auto / assisted) へ委ねる前提で組まれている。OpenCode に
672-
# classifier は無く、未掲載は既定 ask になる。前提が違うので分けている。
673-
#
674-
# ★ここに載せたものだけが **無確認で実行される**。選定基準は「副作用なし・
675-
# 冪等・任意コード実行を含まない」。ビルド系 (gcc / cmake / uv sync /
676-
# mise run) と find は、実行するコードを自分で決められるので載せない。
677-
# ★find に対して「-exec の付いた形だけ deny する」案は採らない。
678-
# `find . -exe""c …` がクォートで deny を素通りし、`find *` の allow に
679-
# 一致して無確認になるため。deny パターンは allow を残す口実にならない。
668+
# OpenCode 専用の shell allow ([bash] とは共用しない。前提が違う)。
669+
# ここに載せたものだけが無確認で実行される。任意コード実行を含むものは載せない。
680670
# see docs/change/0002-opencode-ask-by-default.md 「段階 1 の詳細」
681-
# docs/research/opencode-shell-allow-and-plugin-gate.md
682671
[opencode.shell]
683672
allow = [
684673
"git diff",

‎home/dot_config/shell/shellenv.sh.tmpl‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,13 @@ export PATH="${HOME}/bin:${PATH}"
9696
# 代わりに導入先をここで通す。
9797
[[ -d "${HOME}/.opencode/bin" ]] && export PATH="${HOME}/.opencode/bin:${PATH}"
9898

99+
# Orca が OPENCODE_CONFIG_DIR を設定すると、v2 では global config が読まれなくなる。
100+
# OPENCODE_CONFIG を併用して戻す。無条件に設定すると二重 merge になるので条件付き。
101+
# see docs/research/opencode-test-isolation.md
102+
if [[ -n "${OPENCODE_CONFIG_DIR:-}" && -f "${HOME}/.config/opencode/opencode.json" ]]; then
103+
export OPENCODE_CONFIG="${HOME}/.config/opencode/opencode.json"
104+
fi
105+
99106
# for CUDA
100107
if [[ -e "/usr/local/cuda" ]]; then
101108
export PATH="/usr/local/cuda/bin:${PATH}"

‎scripts/opencode_probe.sh‎

Lines changed: 4 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -2,26 +2,15 @@
22

33
set -euo pipefail
44

5-
# OpenCode を隔離環境で実行する。
6-
#
7-
# 実環境のセッション DB (~/.local/share/opencode/opencode.db) を汚さずに
8-
# permission や plugin の挙動を試すための入口。
9-
#
10-
# ★XDG_CONFIG_HOME / XDG_DATA_HOME / HOME は差し替えてはいけない。
11-
# OpenCode は config dir の決定に XDG_CONFIG_HOME を使わず、認証情報は
12-
# セッション DB の credential テーブルにあるため、どれを差し替えても
13-
# 「Model unavailable」か認証失敗になる。
14-
# see docs/research/opencode-test-isolation.md
5+
# OpenCode を隔離環境で実行する。実環境のセッション DB を汚さない。
156
#
167
# Usage:
178
# mise run opencode:probe -- '<prompt>'
189
# OPENCODE_PROBE_CONFIG=<dir> mise run opencode:probe -- '<prompt>'
1910
#
20-
# OPENCODE_PROBE_CONFIG を渡すと global config も隔離する。
21-
#
22-
# ★渡さない場合は OPENCODE_CONFIG_DIR を **明示的に外す**。環境に値が残って
23-
# いると黙って継承してしまい、試験結果が呼び出し元の状態に左右される
24-
# (Orca 経由のセッションは opencode.json を持たない overlay を指している)。
11+
# ★XDG_CONFIG_HOME / XDG_DATA_HOME / HOME は差し替えない (いずれも壊れる)。
12+
# 隔離は OPENCODE_DB と OPENCODE_CONFIG_DIR で行う。
13+
# see docs/research/opencode-test-isolation.md
2514

2615
REAL_DB="${HOME}/.local/share/opencode/opencode.db"
2716
WORKDIR="${OPENCODE_PROBE_DIR:-/tmp/opencode/probe}"

0 commit comments

Comments
 (0)