dsh-perm-gate 0.2.1-beta.3 → 0.2.1-beta.5

package/CHANGELOG.ja.md

@@ -5,8 +5,58 @@
 形式は [Keep a Changelog](https://keepachangelog.com/ja/1.1.0/) に従い、
 このプロジェクトは [Semantic Versioning](https://semver.org/spec/v2.0.0.html) に準拠します。
 
+## [0.2.1-beta.5] - 2026-09-11
+
+### 修正
+
+- **DSH 0.1.2 ではゲートが全呼び出しで待機状態になり、「承認記録」ページが空のままでした。** セッションの
+  権限プリセット fold はログを `exec.agent.session.events` として読んでいました。DSH 0.1.1 はこの配列を
+  公開していましたが、0.1.2 はログを `Session.snapshotEvents()` / `ownEvents()` の背後に隠し `events`
+  メンバーを残していないため、読み取りは `undefined` を返し、`presetOf` も `undefined` を返し、
+  `presetInScope(undefined, ['permissive'])` によって `gateActive` が**すべての**呼び出しで false に
+  なりました —— ルール / grant / 拒否キーワード / 分類器 / P0 ハード拒否のいずれの判定も行われず、監査
+  イベントも記録されません（ゲート自身のティアを選択したセッションでも同様で、タブには失敗ではなく
+  「本セッションにはまだ承認記録がありません」と表示されていました）。fold は既知のすべてのアクセサ形状
+  （`events` 配列、`snapshotEvents()`、`ownEvents()`）でログを読み、ホストが何も公開しない場合にのみ
+  「イベントなし」に縮退します。fold キャッシュはログ長と末尾イベントの同一性をキーにします（0.1.2 の
+  スナップショットは同じ凍結イベントに対する毎回新しい配列のため）。`test/preset-scope.spec.ts` が両形状を
+  固定します。
+
+### 変更
+
+- **権限ティアの表示名を全サーフェスで「自动审查」に統一し、アイコンを廃止しました。**
+  `cordis.patch.yml` の preset `name:` が中国語の製品名になり、一般設定の既定行・入力欄のピッカー・
+  プラグイン設定タブのすべてで同じ表示になります。DSH 0.1.2 はプラグイン提供ティアの `name:` をそのまま
+  描画し、ローカライズするのは組み込み 3 値（`仅可查看` / `工作区内修改` / `完全权限`）だけなので、zh
+  セッションが見るのはこの 1 つの文字列です。マシン値は `permissive` のままです（`gatePresets` が照合
+  する値）。権限ピッカーのアイコン装飾は削除しました（`src/client/permission-icon.ts` を削除）：退役した
+  `auto` ティアの盾グリフに合わせるためのもので、0.1.2 では `aria-haspopup="menu"` セレクタ経由で設定行にも
+  適用され、ピッカーのグリフは組み込み値にのみ紐づくためプラグイン ティアは描画しません。
+
 ## [Unreleased]
 
+### 追加
+
+- Permissive ティアに `trustEscalation` 戦略を追加（ティア有効時に既定オン）：ゲートがすでに許可した呼び出しの
+  サンドボックス昇格承認をここで `allowed-once` と回答し、プロンプトを出さなくする。昇格は shell / pwsh / edit
+  ツールの内部 — `tools/pre-execute` の決着後 — から発生するため、ゲート自身の allow はそこに届かず、
+  LLM が `safe` と判定した呼び出しでも広げの確認を求めていた。ゲートが許可した呼び出しのみ
+  （`callId` とツール名で一致）がプロンプトをスキップし、`workspace-write` / `danger-full-access` を
+  命名する認識された昇格原因のみ適用。それ以外は変更なく人手へ委譲。自動回答はイベントフィードに記録
+  （`verdict: "escalation-auto"`、`mode: <ターゲット>`）。スイッチをオフにすると広げは人手ゲート化。
+
+### 修正
+
+- 設定カードがルール ファイルから編集可能なホワイトリストをシードするようになりました。
+  `installSettingsSection` はホスト設定スコープで `scope.set('allowlist', …)` を呼んでいましたが、
+  ホスト スコープは `get` / `watch` / `update` / `replace` だけ expose —
+  `set(field, value)` は *クライアント* の `mutate()` 用 convenience ラッパーで異なるオブジェクトなので、
+  呼び出しが投げて名前空間がシードされませんでした。
+  今度は `scope.update({ allowlist: … })` を使います。
+- `approval/request` リスナーが `prepend` で登録され、パッシブ オブザーバから回答ゲートになり、
+  ブラウザ プロンプトを描画するリモート ブリッジの前に位置するようになりました。
+  そのブリッジの後ろにリスナーがあれば、すでに示されたプロンプトしか記録できませんでした。
+
 ## [0.2.1-beta.3] - 2026-09-10
 
 ### 追加

package/CHANGELOG.ko.md

@@ -5,8 +5,58 @@
 형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)을 따르며,
 이 프로젝트는 [Semantic Versioning](https://semver.org/spec/v2.0.0.html)을 준수합니다.
 
+## [0.2.1-beta.5] - 2026-09-11
+
+### 수정
+
+- **DSH 0.1.2에서 게이트가 모든 호출에서 대기 상태가 되어 「승인 기록」 페이지가 비어 있었습니다.** 세션의
+  권한 preset fold가 로그를 `exec.agent.session.events`로 읽었습니다. DSH 0.1.1은 이 배열을
+  노출했지만 0.1.2는 로그를 `Session.snapshotEvents()` / `ownEvents()` 뒤로 감추고 `events` 멤버를
+  남기지 않아, 읽기가 `undefined`를 반환하고 `presetOf`도 `undefined`를 반환했으며
+  `presetInScope(undefined, ['permissive'])` 때문에 `gateActive`가 **모든** 호출에서 false가
+  되었습니다 —— 규칙 / grant / 거부 키워드 / 분류기 / P0 하드 거부 판정이 전혀 없고 감사 이벤트도
+  기록되지 않았습니다(게이트 자체 티어를 선택한 세션에서도 마찬가지여서, 탭에는 실패가 아니라
+  「이 세션에는 아직 승인 기록이 없습니다」가 표시되었습니다). fold는 알려진 모든 접근자 형태
+  (`events` 배열, `snapshotEvents()`, `ownEvents()`)로 로그를 읽고, 호스트가 아무것도 노출하지
+  않을 때만 "이벤트 없음"으로 축소됩니다. fold 캐시는 로그 길이와 마지막 이벤트의 동일성을 키로
+  사용합니다(0.1.2 스냅샷은 동일한 동결 이벤트에 대한 매번 새로운 배열입니다).
+  `test/preset-scope.spec.ts`가 두 형태를 고정합니다.
+
+### 변경
+
+- **권한 티어의 표시 이름을 모든 화면에서 「自动审查」로 통일하고 아이콘을 제거했습니다.**
+  `cordis.patch.yml`의 preset `name:`이 중국어 제품명이 되어 일반 설정 기본 행, 입력창 선택기,
+  플러그인 설정 탭이 모두 같은 이름을 표시합니다. DSH 0.1.2는 플러그인 티어의 `name:`을 그대로
+  렌더링하고 내장 세 값(`仅可查看` / `工作区内修改` / `完全权限`)만 지역화하므로, zh 세션이 보는 것은
+  이 하나의 문자열입니다. 머신 값은 `permissive` 그대로입니다(`gatePresets`가 대조하는 값).
+  권한 선택기의 아이콘 장식은 제거했습니다(`src/client/permission-icon.ts` 삭제): 은퇴한 `auto` 티어의
+  방패 글리프에 맞추기 위한 것이었고, 0.1.2에서는 `aria-haspopup="menu"` 선택자를 통해 설정 행에도
+  적용되었으며, 선택기의 글리프는 내장 값에만 연결되므로 플러그인 티어는 그리지 않습니다.
+
 ## [Unreleased]
 
+### 추가
+
+- Permissive 티어에 `trustEscalation` 전략 추가(티어 켜짐时 기본 켬): 게이트가 이미 허용한 호출의
+  샌드박스 승격 승인을 여기서 `allowed-once`로 응답하여 프롬프트를 표시하지 않음. 승격은 shell / pwsh / edit
+  도구 내부(`tools/pre-execute` 결착 후)에서 발생하므로 게이트의 allow는 여기에 닿지 않고,
+  LLM이 `safe`로 판정한 호출조차 승격 확인을 요구했음. 게이트가 허용한 호출만
+  (`callId` 및 툴 이름 일치) 프롬프트를 건너뛰고, `workspace-write` / `danger-full-access`를
+  명시하는 알려진 승격 원인에만 적용. 나머지는 변경 없이 사람에게 위임. 자동 응답은 이벤트 피드에 기록
+  (`verdict: "escalation-auto"`, `mode: <대상>`). 스위치를 끄면 승격은 사람 게이트화.
+
+### 수정
+
+- 설정 카드가 규칙 파일에서 편집 가능한 허용 목록을 시딩하도록 수정.
+  `installSettingsSection`은 호스트 설정 스코프에서 `scope.set('allowlist', …)`를 호출했지만,
+  호스트 스코프는 `get` / `watch` / `update` / `replace`만 제공 —
+  `set(field, value)`는 *클라이언트*의 `mutate()`용 convenience 래퍼로 다른 객체이므로
+  호출이 예외를 throw하고 네임스페이스가 시딩되지 않았음.
+  이제 `scope.update({ allowlist: … })`를 사용.
+- `approval/request` 리스너가 `prepend`로 등록되고 수동 옵서버에서 응답 게이트로 바뀌어,
+  브라우저 프롬프트를 렌더링하는 원격 브리ჯ 앞에 위치하게 됨.
+  그 브리ჯ 뒤에 리스너가 있으면 이미 표시된 프롬프트만 기록 가능했음.
+
 ## [0.2.1-beta.3] - 2026-09-10
 
 ### 추가

package/CHANGELOG.md

@@ -5,7 +5,84 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.2.1-beta.5] - 2026-09-11
+
+### Fixed
+
+- **The gate stood down on every call under DSH 0.1.2, so the Approvals page stayed empty.** The
+  session's permission-preset fold read the log as `exec.agent.session.events`. DSH 0.1.1 exposed
+  that array; 0.1.2 made the log private behind `Session.snapshotEvents()` / `ownEvents()` and kept
+  no `events` member, so the read returned `undefined`, `presetOf` answered `undefined`, and
+  `presetInScope(undefined, ['permissive'])` made `gateActive` false for **every** call: no rule,
+  grant, deny-keyword, classifier, or P0 hard-deny decision, and no audit event — including in
+  sessions that had selected the gate's own tier, which is why the tab showed "本会话暂无审批记录"
+  rather than a failure. The fold now reads the log through every known accessor shape
+  (`events` array, `snapshotEvents()`, `ownEvents()`) and degrades to "no events" only when the host
+  exposes none; the fold cache keys on the log's length plus its last event's identity, since a
+  0.1.2 snapshot is a fresh array over the same frozen events on every read. `test/preset-scope.spec.ts`
+  pins both shapes: a `0.1.2`-shaped session must yield a decision (and a recorded event), and a
+  grown log must re-fold so a preset switch takes effect on the next call.
+
+### Changed
+
+- **The permission tier is labelled 自动审查 on every surface, with no icon.** The preset's
+  `name:` in `cordis.patch.yml` is now the Chinese product string, and the General-settings default
+  row, the composer picker, and the plugin's settings tab all show it. DSH 0.1.2 renders a
+  plugin-contributed tier's `name:` verbatim and localizes only the three built-in values
+  (`仅可查看` / `工作区内修改` / `完全权限`), so the one host-supplied string is what a zh session sees;
+  the tier's machine value stays `permissive`, which is what `gatePresets` matches. The
+  permission-picker icon decoration is removed (`src/client/permission-icon.ts` deleted): it existed
+  to match the retired `auto` tier's shield glyph, it applied to the settings row through the
+  0.1.2 `aria-haspopup="menu"` selector, and a plugin tier draws no glyph because the composer's
+  glyphs are keyed to the built-in values only.
+
+## [0.2.1-beta.4] - 2026-09-11
+
+### Added
+
+- `trustEscalation` strategy in the Permissive tier (on by default while the tier is on): a
+  sandbox-escalation approval for a call this gate already allowed is answered `allowed-once`
+  here instead of prompting you. The escalation is raised by `approveEscalation` from *inside*
+  the shell / pwsh / edit tool body — after `tools/pre-execute` settled — so the gate's own
+  allow never reached it and a call the LLM graded `safe` still asked you to approve the
+  widening. Only the exact call the gate cleared (matched by `callId` and tool name) skips the
+  prompt, and only for a recognized escalation reason naming `workspace-write` /
+  `danger-full-access`; everything else delegates to the human unchanged. The auto-answer is
+  recorded on the event feed (`verdict:"escalation-auto"`, `mode:<target>`). Turn the switch
+  off to keep sandbox widening human-gated.
+
+### Fixed
+
+- The settings card now seeds the editable whitelist from the rules file. `installSettingsSection`
+  called `scope.set('allowlist', …)` on the **host** settings scope, which exposes only
+  `get` / `watch` / `update` / `replace` — `set(field, value)` is the *client* convenience wrapper
+  over `mutate()`, a different object — so the call threw and the namespace stayed unseeded.
+  It now uses `scope.update({ allowlist: … })`.
+- The `approval/request` listener is registered `prepend` and is now an answering gate rather than
+  a passive observer, so it sits ahead of the remote bridge that renders the browser prompt. A
+  listener behind that bridge could only ever record a prompt that had already been shown.
+- The browser half no longer imports `@deepseek-ai/dsh-client-runtime`, which DSH removed in
+  `0.1.2-alpha.1`. `ClientContext` now comes from `@deepseek-ai/cordis` — the alias DSH 0.1.1
+  defined as `export type ClientContext = Context`, so it names the same type on both lines — and
+  the settings card declares the four scope members it uses locally (`SettingsScopeLike`), the
+  same local-face pattern the host half already uses for the host `settings` service. The client
+  contract is byte-identical on both lines; only its exporting package moved.
+
+### Changed
+
+- DSH compatibility now ships as **two long-lived branches**, each with its own version series,
+  `engines.dsh`, and npm dist-tag: `main` / `0.2.x` / `>=0.1.2-alpha.1 <0.2.0-0` / `latest`, and
+  `legacy` / `1.x` / `>=0.1.0-rc.7 <0.1.2-alpha.1` / `legacy`. This branch is `main`. See
+  `RELEASING.md` for the branch layout and the cherry-pick flow.
+- On this line `ctx.slots` is declared by `@deepseek-ai/dsh-client-ui-renderer/client` — from
+  `0.1.2-alpha.1` on, `@deepseek-ai/dsh-client-runtime` is gone — so the client entry imports it.
+- Client devDependency floors raised from `^0.1.0-rc.7` to `^0.1.5-rc.2`, and
+  `@deepseek-ai/dsh-client-ui-renderer` added. The old floor meant the build could only ever
+  resolve the 0.1.0-rc.8 package set, so this line was never compiled against.
+- `npm run verify:line` (`scripts/verify-line.mjs`) installs this branch's line packages with
+  `npm install --no-save` and runs typecheck + tests + build against them, so a build always
+  compiles against the packages the branch ships for. `npm run verify:lines` is an opt-in drift
+  check that builds on both lines and compares the bundles.
 
 ## [0.2.1-beta.3] - 2026-09-10
 

package/INSTALL.ja.md

@@ -12,7 +12,7 @@
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
-`dsh-perm-gate` バージョン **0.2.1-beta.3**。判定チェーン、ルールファイル形式、Permissive
+`dsh-perm-gate` バージョン **0.2.1-beta.5**。判定チェーン、ルールファイル形式、自动审查
 ティアについては [日本語 README](./README.ja.md) を参照してください。
 
 ## 必要条件
@@ -23,13 +23,28 @@
 - インストール先の profile。ブラウザ側は `web` profile 向けにのみビルドされます
   （`package.json` の `dsh.client.platform = "web"`）。
 
+## DSH のバージョンに合う tag を選ぶ
+
+単一ビルドが DSH 両ラインをカバーするため、どちらの tag を選んでも動作するコードが
+インストールされます —— tag を残しておくのは、あなたがピン留めするバージョンが
+各ラインで意味を持つようにするためです。
+
+| DSH のバージョン | インストール方法 |
+|-----------------|-----------------|
+| `0.1.2-alpha.1` 以上（`0.1.5-rc.2` を含む） | `dsh plugin --profile web add dsh-perm-gate`（tag `latest`） |
+| `0.1.1-rc.2` まで | `dsh plugin --profile web add dsh-perm-gate@legacy` |
+
+DSH は `engines.dsh` を強制しないため、tag が選択メカニズムであり、互換性ゲート
+そのものではありません。単一ビルドが両ラインをカバーする理由と tag の公開方法については、
+[RELEASING.md](./RELEASING.md) を参照してください。
+
 ## 公式 CLI でインストール
 
 ```sh
 dsh plugin --profile web add dsh-perm-gate
 ```
 
-公開パッケージを取得し、`cordis.patch.yml`（Permissive セッション ティアとプラグイン
+公開パッケージを取得し、`cordis.patch.yml`（自动审查セッション ティアとプラグイン
 本体の挿入）を適用して、host / client の両方を組み込みます。
 
 ## ソースからインストール
@@ -84,7 +99,7 @@ dsh profile reload --profile web
    追加します。
 3. それらが提供していた preset の上書きを削除します。`cordis.patch.yml` は
    `permission.config.presets` を**丸ごと置換**するため、他プラグインの古い
-   key 単位パッチが Permissive ティア（または組み込みティア）を黙って消すことがあります。
+   key 単位パッチが自动审查ティア（または組み込みティア）を黙って消すことがあります。
 4. profile を再読込し、後述の `--list` で検証します。
 
 ## 検証
@@ -105,11 +120,11 @@ dsh-perm-gate --rules permissions.yaml --tool bash --args '{"command":"pnpm inst
   "defaultAction": "ask",
   "ruleCount": 8,
   "permissive": false,
-  "permissiveStrategies": { "trustAutoAllow": true, "alwaysConfirm": false, "llmAssist": false }
+  "permissiveStrategies": { "trustAutoAllow": true, "alwaysConfirm": false, "llmAssist": false, "trustEscalation": true }
 }
 ```
 
-UI では **設定 → プラグイン → Permissive 承認ティア** に、1 つのスイッチと 3 つの
+UI では **設定 → プラグイン → 自动审查** に、1 つのスイッチと 4 つの
 バックエンド戦略トグルが表示されます。
 
 ## アンインストール
@@ -119,12 +134,12 @@ dsh plugin --profile web remove dsh-perm-gate
 dsh profile reload --profile web
 ```
 
-プラグインを削除するとパッチの寄与も失われるため、Permissive ティアはセッションの
+プラグインを削除するとパッチの寄与も失われるため、自动审查ティアはセッションの
 権限ピッカーから再び消えます。
 
 ## トラブルシューティング
 
-**権限ピッカーに Permissive ティアが出ない。**
+**権限ピッカーに自动审查ティアが出ない。**
 DSH の bundle patch は `permission.config.presets` を key 単位でマージせず**全体置換**
 します。profile を再読込して `cordis.patch.yml` を再適用し、後から読み込まれる
 プラグインが `presets` を上書きしていないか確認してください。
@@ -136,9 +151,16 @@ loud-fail し、暗黙に無効化されることはありません。
 
 **`llmAssist` が発火しない。**
 `classifierEndpoint` / `classifierModel` / `classifierApiKey` が必要です
-（**設定 → プラグイン → Permissive 承認ティア** または `cordis.yml` で設定）。
+（**設定 → プラグイン → 自动审查** または `cordis.yml` で設定）。
 欠落や通信エラー時は人手のシームへフォールバックします。設計上 fail-closed です。
 
+**「承認記録」ページが空のまま。**
+ゲートが動作するのは `gatePresets` に列挙したティア（既定 `['permissive']`、
+ピッカーでの表示名が「自动审查」）だけなので、他のティアのセッションでは
+イベントを一切記録しません —— 記録したいセッションで権限ピッカーから
+「自动审查」を選んでください。preset を一度も選んでいないセッションも対象外です。
+新しいセッションの初期ティアは `permission.defaultPreset` 設定で決まります。
+
 **設定カードに「設定名前空間が利用できません」と出る。**
 プラグインが現在の profile に組み込まれていません。
 `dsh plugin --profile web add dsh-perm-gate` を実行して再読込してください。

package/INSTALL.ko.md

@@ -12,7 +12,7 @@
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
-`dsh-perm-gate` 버전 **0.2.1-beta.3**. 결정 체인, 규칙 파일 형식, Permissive 티어는
+`dsh-perm-gate` 버전 **0.2.1-beta.5**. 결정 체인, 규칙 파일 형식, 自动审查 티어는
 [한국어 README](./README.ko.md)를 참고하세요.
 
 ## 요구 사항
@@ -23,13 +23,28 @@
 - 설치할 profile. 브라우저 절반은 `web` profile용으로만 빌드됩니다
   (`package.json`의 `dsh.client.platform = "web"`).
 
+## DSH 버전에 맞는 tag 선택
+
+단일 빌드는 두 DSH 라인을 모두 커버하므로, 어느 tag를 골라도 작동하는 코드가
+설치됩니다 —— tag를 유지하는 이유는 당신이 고정하는 버전이 각 라인에서 의미 있게
+유지되도록 하기 위함입니다.
+
+| DSH 버전 | 설치 방법 |
+|----------|-----------|
+| `0.1.2-alpha.1` 이상 (`0.1.5-rc.2` 포함) | `dsh plugin --profile web add dsh-perm-gate` (tag `latest`) |
+| `0.1.1-rc.2` 이하 | `dsh plugin --profile web add dsh-perm-gate@legacy` |
+
+DSH는 `engines.dsh`를 강제하지 않으므로, tag는 선택 메커니즘이지 호환성 게이트가
+아닙니다. 단일 아티팩트가 두 라인을 커버하는 이유와 tag가 게시되는 방식에 대해서는
+[RELEASING.md](./RELEASING.md)를 참고하세요.
+
 ## 공식 CLI로 설치
 
 ```sh
 dsh plugin --profile web add dsh-perm-gate
 ```
 
-게시된 패키지를 가져오고 `cordis.patch.yml`(Permissive 세션 티어 + 플러그인 항목)을
+게시된 패키지를 가져오고 `cordis.patch.yml`(自动审查 세션 티어 + 플러그인 항목)을
 적용하여 host / client 양쪽을 조립합니다.
 
 ## 소스에서 설치
@@ -83,7 +98,7 @@ dsh profile reload --profile web
 2. 위 네 플러그인을 `cordis.yml`에서 제거하고 `dsh-perm-gate` 항목만 추가합니다.
 3. 해당 플러그인들이 제공하던 preset 재정의를 삭제합니다. `cordis.patch.yml`은
    `permission.config.presets`를 **전체 교체**하므로, 다른 플러그인의 오래된
-   key 단위 패치가 Permissive 티어(또는 내장 티어)를 조용히 없앨 수 있습니다.
+   key 단위 패치가 自动审查 티어(또는 내장 티어)를 조용히 없앨 수 있습니다.
 4. profile을 다시 불러오고 아래의 `--list`로 검증합니다.
 
 ## 검증
@@ -104,12 +119,12 @@ dsh-perm-gate --rules permissions.yaml --tool bash --args '{"command":"pnpm inst
   "defaultAction": "ask",
   "ruleCount": 8,
   "permissive": false,
-  "permissiveStrategies": { "trustAutoAllow": true, "alwaysConfirm": false, "llmAssist": false }
+  "permissiveStrategies": { "trustAutoAllow": true, "alwaysConfirm": false, "llmAssist": false, "trustEscalation": true }
 }
 ```
 
-UI의 **설정 → 플러그인 → Permissive 승인 티어**에 스위치 하나와 백엔드 전략 토글
-세 개가 표시되어야 합니다.
+UI의 **설정 → 플러그인 → 自动审查**에 스위치 하나와 백엔드 전략 토글
+네 개가 표시되어야 합니다.
 
 ## 제거
 
@@ -118,12 +133,12 @@ dsh plugin --profile web remove dsh-perm-gate
 dsh profile reload --profile web
 ```
 
-플러그인을 제거하면 패치 기여도 사라지므로 Permissive 티어가 세션 권한 선택기에서
+플러그인을 제거하면 패치 기여도 사라지므로 自动审查 티어가 세션 권한 선택기에서
 다시 사라집니다.
 
 ## 문제 해결
 
-**권한 선택기에 Permissive 티어가 없습니다.**
+**권한 선택기에 自动审查 티어가 없습니다.**
 DSH 번들 패치는 `permission.config.presets`를 key 단위로 병합하지 않고 **전체 교체**
 합니다. profile을 다시 불러와 `cordis.patch.yml`을 재적용하고, 더 늦게 로드되는
 플러그인이 `presets`를 덮어쓰지 않는지 확인하세요.
@@ -135,9 +150,15 @@ DSH 번들 패치는 `permission.config.presets`를 key 단위로 병합하지
 
 **`llmAssist`가 동작하지 않습니다.**
 `classifierEndpoint`, `classifierModel`, `classifierApiKey`가 필요합니다
-(**설정 → 플러그인 → Permissive 승인 티어** 또는 `cordis.yml`에서 지정).
+(**설정 → 플러그인 → 自动审查** 또는 `cordis.yml`에서 지정).
 값이 없거나 네트워크 오류가 나면 사람 승인 심으로 폴백합니다. 설계상 fail-closed입니다.
 
+**「승인 기록」 페이지가 계속 비어 있습니다.**
+게이트는 `gatePresets`에 나열한 티어(기본 `['permissive']`, 선택기 표시명 「自动审查」)
+에서만 동작하므로 다른 티어의 세션에서는 이벤트를 전혀 기록하지 않습니다 —— 기록하려면
+해당 세션에서 권한 선택기로 「自动审查」를 고르세요. preset을 한 번도 선택하지 않은
+세션도 범위 밖입니다. 새 세션의 초기 티어는 `permission.defaultPreset` 설정이 정합니다.
+
 **설정 카드에 "설정 네임스페이스를 사용할 수 없습니다"가 표시됩니다.**
 플러그인이 현재 profile에 조립되지 않았습니다.
 `dsh plugin --profile web add dsh-perm-gate`를 실행하고 다시 불러오세요.

package/INSTALL.md

@@ -12,8 +12,8 @@
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
-`dsh-perm-gate` version **0.2.1-beta.3**. Continue with the [README](./README.md) for the
-decision chain, the rules file format and the Permissive tier.
+`dsh-perm-gate` version **0.2.1-beta.5**. Continue with the [README](./README.md) for the
+decision chain, the rules file format and the 自动审查 tier.
 
 ## Requirements
 
@@ -23,13 +23,27 @@ decision chain, the rules file format and the Permissive tier.
 - A profile to install into — the browser half only ships for the `web` profile
   (`dsh.client.platform = "web"` in `package.json`).
 
+## Pick the tag for your DSH version
+
+One build serves both DSH lines, so either tag installs working code — the tag
+exists so a version you pin stays meaningful per line.
+
+| Your DSH | Install |
+|----------|---------|
+| `0.1.2-alpha.1` or newer (incl. `0.1.5-rc.2`) | `dsh plugin --profile web add dsh-perm-gate` (tag `latest`) |
+| up to `0.1.1-rc.2` | `dsh plugin --profile web add dsh-perm-gate@legacy` |
+
+DSH does not enforce `engines.dsh`, so the tags are the selection mechanism rather
+than a compatibility gate. See [RELEASING.md](./RELEASING.md) for why one artifact
+covers both lines and how the tags are published.
+
 ## Install with the official CLI
 
 ```sh
 dsh plugin --profile web add dsh-perm-gate
 ```
 
-This pulls the published package, applies its `cordis.patch.yml` (the Permissive
+This pulls the published package, applies its `cordis.patch.yml` (the 自动审查
 session tier plus the plugin entry) and assembles both halves.
 
 ## Install from source
@@ -86,7 +100,7 @@ and `dsh-movein-permissions`.
    entry above.
 3. Delete any preset overrides those plugins contributed — `cordis.patch.yml`
    **replaces** `permission.config.presets` wholesale, so stale per-key patches
-   from other plugins can silently drop the Permissive tier (or a built-in one).
+   from other plugins can silently drop the 自动审查 tier (or a built-in one).
 4. Reload the profile and verify with `--list` (below).
 
 ## Verify
@@ -107,12 +121,12 @@ Expected `--list` output shape:
   "defaultAction": "ask",
   "ruleCount": 8,
   "permissive": false,
-  "permissiveStrategies": { "trustAutoAllow": true, "alwaysConfirm": false, "llmAssist": false }
+  "permissiveStrategies": { "trustAutoAllow": true, "alwaysConfirm": false, "llmAssist": false, "trustEscalation": true }
 }
 ```
 
-In the UI, **Settings → Plugins → Permissive approval tier** should render one
-switch plus the three backend strategy toggles.
+In the UI, **Settings → Plugins → 自动审查** should render one
+switch plus the four backend strategy toggles.
 
 ## Uninstall
 
@@ -121,12 +135,12 @@ dsh plugin --profile web remove dsh-perm-gate
 dsh profile reload --profile web
 ```
 
-Removing the plugin also removes its patch contribution, so the Permissive tier
+Removing the plugin also removes its patch contribution, so the 自动审查 tier
 disappears from the session permission picker again.
 
 ## Troubleshooting
 
-**The Permissive tier is missing from the permission picker.**
+**The 自动审查 tier is missing from the permission picker.**
 The DSH bundle patch replaces the whole `permission.config.presets` map instead of
 merging per key. Reload the profile so `cordis.patch.yml` is re-applied, and make
 sure no later plugin overwrites `presets`.
@@ -138,10 +152,17 @@ fails loud at load — it is never silently disabled.
 
 **`llmAssist` never fires.**
 It needs `classifierEndpoint`, `classifierModel` and `classifierApiKey` (set them
-in **Settings → Plugins → Permissive approval tier** or in `cordis.yml`). Any
+in **Settings → Plugins → 自动审查** or in `cordis.yml`). Any
 missing value or network error falls back to the human seam — the gate is
 fail-closed by design.
 
+**The Approvals tab stays empty.**
+The gate is scoped to the tiers listed in `gatePresets` (default
+`['permissive']`), so it records nothing while the session runs in another tier —
+pick 自动审查 in the permission picker for the session you want recorded. A
+session that has never selected a preset is out of scope too. New sessions start
+in the tier named by the `permission.defaultPreset` setting.
+
 **Settings card shows "Settings namespace unavailable".**
 The plugin is not assembled into the active profile. Run
 `dsh plugin --profile web add dsh-perm-gate` and reload.

package/INSTALL.zh.md

@@ -12,7 +12,7 @@
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
-`dsh-perm-gate` 版本 **0.2.1-beta.3**。裁决链、规则文件格式与 Permissive 档位请见
+`dsh-perm-gate` 版本 **0.2.1-beta.5**。裁决链、规则文件格式与自动审查档位请见
 [中文 README](./README.zh.md)。
 
 ## 前置条件
@@ -23,13 +23,26 @@
 - 需要一个目标 profile —— 浏览器端只为 `web` profile 构建（`package.json`
   里 `dsh.client.platform = "web"`）。
 
+## 按你的 DSH 版本选择 tag
+
+单一构建同时覆盖两条 DSH 线，所以任一 tag 安装的代码都能工作 —— 保留 tag
+是为了让你锁定的版本在每条线上都有意义。
+
+| 你的 DSH | 安装方式 |
+|----------|----------|
+| `0.1.2-alpha.1` 或更高（含 `0.1.5-rc.2`） | `dsh plugin --profile web add dsh-perm-gate`（tag `latest`） |
+| 不高于 `0.1.1-rc.2` | `dsh plugin --profile web add dsh-perm-gate@legacy` |
+
+DSH 不强制 `engines.dsh`，因此 tag 是选择机制而非兼容性关卡。
+详见 [RELEASING.md](./RELEASING.md) 了解为何单一制品覆盖两条线以及 tag 的发布方式。
+
 ## 用官方 CLI 安装
 
 ```sh
 dsh plugin --profile web add dsh-perm-gate
 ```
 
-该命令会拉取已发布的包、应用 `cordis.patch.yml`（Permissive 会话档位 + 插件条目），
+该命令会拉取已发布的包、应用 `cordis.patch.yml`（自动审查会话档位 + 插件条目），
 并装配 host / client 两半。
 
 ## 从源码安装
@@ -82,7 +95,7 @@ dsh profile reload --profile web
 2. 从 `cordis.yml` 删除上述四个插件，只加入唯一的 `dsh-perm-gate` 条目。
 3. 删除这些插件贡献的 preset 覆盖 —— `cordis.patch.yml` 是**整体替换**
    `permission.config.presets`，其他插件遗留的逐 key 补丁可能静默抹掉
-   Permissive 档（或某个内置档）。
+   自动审查档（或某个内置档）。
 4. 重载 profile，并用下面的 `--list` 验证。
 
 ## 验证
@@ -103,11 +116,11 @@ dsh-perm-gate --rules permissions.yaml --tool bash --args '{"command":"pnpm inst
   "defaultAction": "ask",
   "ruleCount": 8,
   "permissive": false,
-  "permissiveStrategies": { "trustAutoAllow": true, "alwaysConfirm": false, "llmAssist": false }
+  "permissiveStrategies": { "trustAutoAllow": true, "alwaysConfirm": false, "llmAssist": false, "trustEscalation": true }
 }
 ```
 
-UI 里 **设置 → 插件 → Permissive 审批档** 应渲染出一个开关加三个后台策略开关。
+UI 里 **设置 → 插件 → 自动审查** 应渲染出一个开关加四个后台策略开关。
 
 ## 卸载
 
@@ -116,11 +129,11 @@ dsh plugin --profile web remove dsh-perm-gate
 dsh profile reload --profile web
 ```
 
-移除插件也会移除它的补丁贡献，Permissive 档位会重新从会话权限下拉框消失。
+移除插件也会移除它的补丁贡献，自动审查档位会重新从会话权限下拉框消失。
 
 ## 排查
 
-**权限下拉框里没有 Permissive 档。**
+**权限下拉框里没有自动审查档。**
 DSH 的 bundle patch 是整体替换 `permission.config.presets`，而非逐 key 合并。
 请重载 profile 让 `cordis.patch.yml` 重新生效，并确认没有更晚加载的插件覆盖了
 `presets`。
@@ -131,9 +144,15 @@ DSH 的 bundle patch 是整体替换 `permission.config.presets`，而非逐 key
 
 **`llmAssist` 从不触发。**
 需要配置 `classifierEndpoint`、`classifierModel`、`classifierApiKey`
-（在 **设置 → 插件 → Permissive 审批档** 或 `cordis.yml` 中填写）。
+（在 **设置 → 插件 → 自动审查** 或 `cordis.yml` 中填写）。
 任一缺失或网络错误都会回退到人工接缝 —— 门禁按设计 fail-closed。
 
+**「审批记录」页一直是空的。**
+门禁只在 `gatePresets` 列出的档位里工作（默认 `['permissive']`，即下拉框里的
+「自动审查」），会话处在别的档位时它不记录任何事件——请在权限下拉框为本会话选择
+「自动审查」。从未选过档位的会话同样在范围之外。新会话的初始档位由
+`permission.defaultPreset` 设置决定。
+
 **设置卡片显示「设置命名空间不可用」。**
 该插件未装配进当前 profile。执行 `dsh plugin --profile web add dsh-perm-gate`
 并重载。