dsh-session-guard 3.2.4 → 4.0.0

package/CHANGELOG.md

@@ -1,216 +1,227 @@
-# Changelog
-
-All notable changes to `dsh-session-guard` are recorded here. Versions follow semver.
-
-- [English changelog](./CHANGELOG.md)
-- [日本語 changelog](./CHANGELOG.ja.md)
-- [한국어 changelog](./CHANGELOG.ko.md)
-
-## 3.2.4 — 2026-09-27
-
-### Fixed
-- **Session format v4 adaptation (host >= 0.1.7-rc.1)**: the three session-writing paths no longer use the retired `source: { kind: 'plugin', plugin: 'session-guard' }` signature, which the v4 host rejects with `SessionFormatError` (whole round fails). All three now use the producer-owned kind:
-  - delayed-resume notice injection (`src/wiring.js`);
-  - auto-retry notice injection (`src/retry.js`);
-  - pause-resume followup (`src/pause-gate.js`, ```kind: `plugin:${pluginId}````).
-  - **tool-result v4 native adaptation (N1)**: `findToolOutcome` in `src/pause-gate.js` now reads the v4 first-class `role:'tool'` message (`toolCallId`/`isError` at message top level) first; the v3 `tool-result` block path is kept as historical fallback. Without this, a failed tool at pause time was reported as completed on resume ("do not re-run") — a silent wrong decision. `src/tool-call-id.js` reads the native top-level id first; stale 0.1.1/0.1.2-era header notes corrected to the three-shape generation table.
-  `form` and all other fields are unchanged; the host's own v3-to-v4 migration lifts existing legacy rows, so no historical data is rewritten. Evidence: `@deepseek-ai/dsh-session-format-v3-to-v4@0.1.7-rc.2` validates only that `source.kind` is non-empty and not `'plugin'`.
-
-## 0.4.0 — 2026-09-18 (mis-versioned; superseded by 3.0.0)
-
-### Fixed
-
-- **Version identity.** This line was published as `0.4.0` while `dsh.plugin.json` and this
-  changelog already said `3.0.0` — one artifact with two version numbers. `package.json` is now
-  `3.0.0`, so the package version, the manifest version and the changelog agree. `0.4.0` is kept
-  here as a historical record because npm versions are immutable; `dist-tag dsh-0.1.5` should be
-  repointed to `3.0.0` once it is published.
-- **Docs.** README/INSTALL (zh/en/ja/ko) no longer describe the sibling line as living on `main`.
-  The 0.1.2 line's release branch is **`legacy/0.1.2`** (npm dist-tag `dsh-0.1.2`, version `0.3.1`);
-  `main` is frozen at `0.2.0-beta.1`. The duplicated branch fragment in the INSTALL.zh/ja/ko install
-  command is fixed, explicit dist-tag install commands are documented, and "2.x / 3.x" is
-  now marked as a **line nickname** rather than a version number.
-
-### Notes
-
-- **No source changes** relative to `3.0.0`; `0.4.0` is a packaging-only publish of the same tree.
-
-## 3.0.0 — 2026-09-14
-
-### Changed
-
-- **DSH v0.1.5-rc.2 dedicated line (`compat/0.1.5`).** `engines.dsh` and the `dsh-client-*`
-  peer ranges narrow to `>=0.1.5-rc.2 <0.2.0-0` (strict-semver prerelease matching means the
-  old `>=0.1.0-rc.7` range never matches `0.1.5-rc.2`); `dsh.plugin.json` gains `engines.dsh`.
-  The 2.x / 0.2.x line on `main` keeps serving DSH 0.1.0-rc.7 … 0.1.2-rc.1.
-- **`session.events` → `snapshotEvents()`.** DSH 0.1.5 removed the `session.events` array
-  accessor (compatibility-guide §20.3). `pause-gate.js` now reads session events through a
-  dual-path helper: `snapshotEvents()` first, the legacy `events` array as a defensive
-  fallback, `null` (fail-open) when neither exists. Affects `findToolOutcome` and
-  `lastUserPrompt` only; event-type matching is unchanged.
-
-### Unchanged
-
-- Zero changes on every other integration seam: the self-held webServer prefix route
-  (`/session-guard/rpc`), `settings.register`, the `settings.plugin.item` card slot,
-  client injections, and `llm.listConfigurableProviders()` are all verified intact against
-  the published 0.1.5-rc.2 bundle (`tools/check-api-drift.ps1`, 12/12 required assertions).
-
-### Pending
-
-- Live smoke on a real DSH 0.1.5-rc.2 host (same status as the perm-gate 0.1.5 line).
-
-## 0.2.0-beta.2 — 2026-09-13
-
-### Fixed (DSH 0.1.5 compat — `compat/0.1.5` branch)
-
-- **Dual-path resume enqueue.** DSH 0.1.5 turns the Inbox into an agent-loop read-only
-  projection, so `agent.followup` may no longer exist. The resume flow now tries
-  `agent.followup` first, falls back to `agent.send`, and degrades to a warn (never throws)
-  when neither is available — a failed enqueue can no longer break resume.
-- **Resume messages carry `source.form: 'instructions'`** per the 0.1.5 `ContextFormed`
-  message-source contract (`kind: 'plugin'` is a built-in kind; older DSH versions ignore
-  the extra field).
-- **`webServer.register` is wrapped in try/catch**: a failed route registration now logs an
-  error instead of throwing out of `apply` and breaking host plugin loading.
-- Verified against the 0.1.5-rc.2 source: the `WebRoute` contract (exact/prefix + SSE) is
-  unchanged, so client `fetch('/session-guard/...')` paths need no `/api` prefix.
-
-## 0.2.0-beta.1 — 2026-09-10
-
-### Added
-
-- **Step-level gate (`agent/pre-step`).** During peak hours the turn is now held **before** the
-  next step's model request instead of being interrupted at a turn boundary: the session keeps
-  running until the next `agent/pre-step`, where the gate holds it (setting `stepLevelPause`, on by
-  default). The turn resumes **in place** off-peak — no followup message needed. Hold conditions:
-  peak (Beijing time) + not weekend + `step > 1` + official target provider (`providerGuard`) +
-  not request-held + not bypassed in this peak window. New module `src/step-gate.js` (pure
-  `decideStepHold` + hold / release / abort / timeout engine).
-- **`stepResume` port + RPC + `/resume`.** `sessionGuard.stepResume(sessionId, {bypass})`,
-  `POST /session-guard/rpc {action:'stepResume'}` and `/resume` all release the gate; a manual
-  resume also stops gating that session for the rest of the peak window.
-- **Timeout escalation.** `stepGateTimeoutMs` (default 300000) releases the gate and escalates to a
-  turn-level **force** pause, so a long peak neither deadlocks nor drips one step every five minutes.
-- **"⏸ Pause session" button** (client, slot `conversation.input.right`, id `session-guard-pause`,
-  order 20 — left of input-traffic's freeze button). It polls `/session-guard/state` once a second,
-  stays disabled while nothing is held, and calls `stepResume` when it is. The status badge moved to
-  order 40 and now reports the number of step-held sessions.
-- **New settings**: `stepLevelPause`, `stepGateTimeoutMs`.
-- **New state**: `GET /session-guard/state` now returns `paused: { step, turn }` and
-  `stepGate: { held, since, bypass }`; `/status` returns `stepHeld`; `/diag` returns `stepGate`.
-  The service port's `state().paused` stays boolean for compatibility (new field `pausedStep`).
-
-### Fixed
-
-- **Deadlock between a held step and a turn-level pause.** `pauseTask` / `resumeTask` /
-  `cancelTask` now release the step gate first: a step hold sits at `agent/pre-step`, where no
-  `assistant/message` or `tool/result` can ever arrive, so a `safe` pause used to wait forever and
-  never persisted `paused`.
-
-### Changed
-
-- **Peak entry no longer interrupts running turns** when `stepLevelPause` is on (`onEnterPeak` arms
-  the step gate instead of calling `stopNextTurn`); with it off the previous turn-level behaviour is
-  unchanged.
-- input-traffic's freeze button label is now **"Freeze & append"** (`冻结追加` / `凍結して追加` /
-  `동결 후 추가`), and its resume label **"Resume & append"** (`恢复追加` / `再開して追加` /
-  `재개 후 추가`) — it freezes the turn and keeps queued messages, distinct from the pause button.
-- **The pause button is a toggle now**: "Pause session" / "Resume session" (no disabled grey state).
-  Clicking "Pause session" calls the new `stepPause` action, which holds the session at the **next
-  step boundary** (step 1 included, regardless of peak or provider); "Resume session" calls
-  `stepResume`. New port method `sessionGuard.stepPause(sessionId)`.
-- **SSE push**: new route `GET /session-guard/events?session=<id>` pushes step-gate state changes the
-  moment they happen, so peak auto-holds flip the button to "Resume session" without waiting for a
-  poll; the 10s `/session-guard/state` poll remains as a fallback. `/state` now reports
-  `paused.manual` and `stepGate.manual`.
-- **Styling aligned** with input-traffic's composer button (24px height, 6px radius, 12px font, the
-  same border/hover/pressed tokens) for both the pause button and the status badge; styles are
-  injected once via `<style data-plugin-css="session-guard-client">`.
-
-## Unreleased
-
-### Added
-
-- **Official-source two-dimensional guard (peak × target provider).** Peak hours now block only
-  requests whose target route is a DeepSeek official source; local/third-party providers keep
-  running. Verdict order: explicit `officialProviders` id list → live `baseURL` endpoint →
-  catalog builtin endpoint (pi-ai's `deepseek`) → builtin id (`deepseek-official`); each verdict
-  reports `matchedBy`. New modules: `src/provider.js` (pure), `src/provider-directory.js`,
-  `src/deferrals.js`, `src/request-guard.js`, `src/targets.js`, `src/wiring.js`.
-- **Request-level backstop (`agent/request`).** Covers sessions started after peak entry and
-  sessions switched to an official source mid-run — the 30s tick only handled sessions that were
-  already `running` at the transition. Default `hold` mode suspends the request without an error
-  and releases it at the exact off-peak instant (`msUntilOffPeak`); `error` mode throws a
-  recognizable `PEAK_DEFERRED` failure and records a deferral for off-peak resume.
-- **New settings**: `providerGuard`, `officialProviders`, `officialBaseURLs`, `deferredResume`,
-  `deferredResumeText`, `deferredMode`, `deferredMaxHoldMs` (default 6h), `guardSubagents`.
-- **New routes**: `GET /session-guard/provider?provider=<id>` (verdict diagnostics);
-  `/session-guard/status` now reports `providerGuard` / `held` / `deferred`;
-  `/session-guard/state` reports the session's last target.
-- **Drift guard** `tools/check-api-drift.ps1` asserting the required APIs exist on
-  `dsh-v0.1.1-rc.2` / `dsh-v0.1.2-rc.1` / `dsh-v0.1.3-alpha.2` / `dsh-v0.1.5-alpha.1`.
-
-### Changed
-
-- **DSH dual-version support (0.1.0-rc.7 … 0.1.2-rc.1).** One artifact now covers both
-  `dsh-v0.1.1-rc.2` and `dsh-v0.1.2-rc.1`. The `tool/result` call-id dual read
-  (`content[].toolCallId` first, `source.callId` fallback — both forms appear in replay logs of
-  both versions) is extracted to the dependency-free `src/tool-call-id.js` with unit tests.
-  `dsh.client.inject` no longer names `@deepseek-ai/dsh-client-runtime` (removed in 0.1.2) or
-  `@deepseek-ai/dsh-client-ui-slots` (not a dynamic client row); peer ranges widened to
-  `>=0.1.0-rc.7 <0.2.0-0` and the removed package dropped. Added `engines.dsh` and a
-  version-compatibility table to the README (ZH/EN).
-- **Settings surface stays on the intersection API**: `settings.register` + `settings.get` only;
-  `installSection` (0.1.2+) and the removed `installSettingsSection` are never used. Optional
-  APIs (`model/selection`, `llm.listConfigurableProviders`, `settings.get`) are feature-probed and
-  degrade instead of throwing.
-- **`src/retry.js` short-circuits only the exact `PEAK_DEFERRED` sentinel.** 429 / `RATE_LIMIT` /
-  `TRANSPORT` / timeout failures remain transient, so DSH's global retry (`dsh-llm-retry` on
-  `agent/request-error`) and this plugin's own retry semantics are unchanged. `dsh-llm-retry`
-  itself is never touched.
-- Badge distinguishes "peak · official only" from "peak · all paused".
-
-## 0.1.4 — 2026-09-09
-
-### Changed
-
-- **Public beta release** of the dual-version line (`0.1.4-beta.1`): version metadata, README
-  compatibility table and package metadata aligned for the beta channel.
-
-## 0.1.3 — 2026-09-09
-
-### Fixed
-
-- **package.json encoding restored**: description was corrupted (GB2312 bytes misread as UTF-8); rewritten with correct Chinese text.
-- **Missing metadata**: added `repository`, `homepage` fields.
-- **peerDependencies corrected**: removed pinned `dsh-llm` exact version; added `cordis`, `dsh-client-runtime`, `dsh-client-locale`, `dsh-client-ui-settings`, `dsh-client-ui-slots` as optional peers matching `dsh.client.inject`.
-- Added `dsh.plugin.json` manifest.
-
-## 0.1.2 — 2026-08-28
-
-### Fixed
-
-- **Peak timezone fixed**: 峰谷判定固定北京时间 (`BILLING_TIMEZONE`)，周末判定用配置时区。
-
-## 0.1.1 — 2026-08-24
-
-### Added
-
-- **Backend auto-retry (D9)**: `turn/end` transient failures (error/429/max-tokens) trigger adaptive-backoff `followup(retryText)` resume; permanent failures (auth/balance/model/context limit) stop; user intervention or successful turn resets consecutive failure count.
-- **Freeze/gate yield**: retry skips when `isFrozen(sessionId)` is true (queueLocked / paused / taskControl paused), never bypasses the session gate.
-
-### Changed
-
-- `sessionGuard` redundant port now exposes `state(sessionId)` returning `{ queueLocked, lockReason, paused, taskControlAvailable, taskControl }`.
-- HTTP route `GET /session-guard/diag` returns runtime diagnostics including retry state.
-
-### Fixed
-
-- Weekend detection now uses `Intl.DateTimeFormat` with the configured timezone instead of bare `getUTCDay()`, fixing an 8-hour boundary bug for Beijing timezone.
-
-## 0.1.0 — 2026-08-18
-
-### Added
-
-- Initial release: peak auto-pause (global), weekend mode, per-session freeze/resume via `sessionGuard` redundant port + RPC bridge, custom session gate (`agent.cancel keepInbox + goals.pause + session/event safe boundary + followup resume`), settings panel (Settings → Plugins → session-guard).
+# Changelog
+
+All notable changes to `dsh-session-guard` are recorded here. Versions follow semver.
+
+- [English changelog](./CHANGELOG.md)
+- [日本語 changelog](./CHANGELOG.ja.md)
+- [한국어 changelog](./CHANGELOG.ko.md)
+
+## 4.0.0 — 2026-09-29
+
+### Changed
+- **DSH 0.2.0 line adaptation**: `engines.dsh` and the four `@deepseek-ai/dsh-client-*` peers move to `>=0.2.0-rc.1 <0.2.1-0` (replacing the 0.1.7 ranges); npm dist-tag `dsh-0.2.0`; manifest version aligned to `4.0.0`. The plugin-facing API surface (manifest / settings / HMR / slots / session v4) is unchanged from 0.1.7 — no runtime code changes.
+- `@deepseek-ai/cordis` peer floor aligned to `^4.0.4` (the 0.2.0-rc.1 host UI packages declare `~4.0.4`; the previous `^4.0.1` accepted it but understated the floor).
+
+### Fixed
+- `src/client/family-section.tsx` landed in version control (it had existed only in the working tree since 3.2.x, so a clean checkout could not build).
+- eslint flat config: dropped the core `no-unused-vars` rule — it mis-flags TS type-signature parameters; the typescript-eslint variant is kept, and the lint baseline is green again.
+- v4 source-kind static gates (`tests/source-kind.test.mjs`) are now tracked and run in `npm test` (248 tests).
+
+## 3.2.4 — 2026-09-27
+
+### Fixed
+- **Session format v4 adaptation (host >= 0.1.7-rc.1)**: the three session-writing paths no longer use the retired `source: { kind: 'plugin', plugin: 'session-guard' }` signature, which the v4 host rejects with `SessionFormatError` (whole round fails). All three now use the producer-owned kind:
+  - delayed-resume notice injection (`src/wiring.js`);
+  - auto-retry notice injection (`src/retry.js`);
+  - pause-resume followup (`src/pause-gate.js`, ```kind: `plugin:${pluginId}````).
+  - **tool-result v4 native adaptation (N1)**: `findToolOutcome` in `src/pause-gate.js` now reads the v4 first-class `role:'tool'` message (`toolCallId`/`isError` at message top level) first; the v3 `tool-result` block path is kept as historical fallback. Without this, a failed tool at pause time was reported as completed on resume ("do not re-run") — a silent wrong decision. `src/tool-call-id.js` reads the native top-level id first; stale 0.1.1/0.1.2-era header notes corrected to the three-shape generation table.
+  `form` and all other fields are unchanged; the host's own v3-to-v4 migration lifts existing legacy rows, so no historical data is rewritten. Evidence: `@deepseek-ai/dsh-session-format-v3-to-v4@0.1.7-rc.2` validates only that `source.kind` is non-empty and not `'plugin'`.
+
+## 0.4.0 — 2026-09-18 (mis-versioned; superseded by 3.0.0)
+
+### Fixed
+
+- **Version identity.** This line was published as `0.4.0` while `dsh.plugin.json` and this
+  changelog already said `3.0.0` — one artifact with two version numbers. `package.json` is now
+  `3.0.0`, so the package version, the manifest version and the changelog agree. `0.4.0` is kept
+  here as a historical record because npm versions are immutable; `dist-tag dsh-0.1.5` should be
+  repointed to `3.0.0` once it is published.
+- **Docs.** README/INSTALL (zh/en/ja/ko) no longer describe the sibling line as living on `main`.
+  The 0.1.2 line's release branch is **`legacy/0.1.2`** (npm dist-tag `dsh-0.1.2`, version `0.3.1`);
+  `main` is frozen at `0.2.0-beta.1`. The duplicated branch fragment in the INSTALL.zh/ja/ko install
+  command is fixed, explicit dist-tag install commands are documented, and "2.x / 3.x" is
+  now marked as a **line nickname** rather than a version number.
+
+### Notes
+
+- **No source changes** relative to `3.0.0`; `0.4.0` is a packaging-only publish of the same tree.
+
+## 3.0.0 — 2026-09-14
+
+### Changed
+
+- **DSH v0.1.5-rc.2 dedicated line (`compat/0.1.5`).** `engines.dsh` and the `dsh-client-*`
+  peer ranges narrow to `>=0.1.5-rc.2 <0.2.0-0` (strict-semver prerelease matching means the
+  old `>=0.1.0-rc.7` range never matches `0.1.5-rc.2`); `dsh.plugin.json` gains `engines.dsh`.
+  The 2.x / 0.2.x line on `main` keeps serving DSH 0.1.0-rc.7 … 0.1.2-rc.1.
+- **`session.events` → `snapshotEvents()`.** DSH 0.1.5 removed the `session.events` array
+  accessor (compatibility-guide §20.3). `pause-gate.js` now reads session events through a
+  dual-path helper: `snapshotEvents()` first, the legacy `events` array as a defensive
+  fallback, `null` (fail-open) when neither exists. Affects `findToolOutcome` and
+  `lastUserPrompt` only; event-type matching is unchanged.
+
+### Unchanged
+
+- Zero changes on every other integration seam: the self-held webServer prefix route
+  (`/session-guard/rpc`), `settings.register`, the `settings.plugin.item` card slot,
+  client injections, and `llm.listConfigurableProviders()` are all verified intact against
+  the published 0.1.5-rc.2 bundle (`tools/check-api-drift.ps1`, 12/12 required assertions).
+
+### Pending
+
+- Live smoke on a real DSH 0.1.5-rc.2 host (same status as the perm-gate 0.1.5 line).
+
+## 0.2.0-beta.2 — 2026-09-13
+
+### Fixed (DSH 0.1.5 compat — `compat/0.1.5` branch)
+
+- **Dual-path resume enqueue.** DSH 0.1.5 turns the Inbox into an agent-loop read-only
+  projection, so `agent.followup` may no longer exist. The resume flow now tries
+  `agent.followup` first, falls back to `agent.send`, and degrades to a warn (never throws)
+  when neither is available — a failed enqueue can no longer break resume.
+- **Resume messages carry `source.form: 'instructions'`** per the 0.1.5 `ContextFormed`
+  message-source contract (`kind: 'plugin'` is a built-in kind; older DSH versions ignore
+  the extra field).
+- **`webServer.register` is wrapped in try/catch**: a failed route registration now logs an
+  error instead of throwing out of `apply` and breaking host plugin loading.
+- Verified against the 0.1.5-rc.2 source: the `WebRoute` contract (exact/prefix + SSE) is
+  unchanged, so client `fetch('/session-guard/...')` paths need no `/api` prefix.
+
+## 0.2.0-beta.1 — 2026-09-10
+
+### Added
+
+- **Step-level gate (`agent/pre-step`).** During peak hours the turn is now held **before** the
+  next step's model request instead of being interrupted at a turn boundary: the session keeps
+  running until the next `agent/pre-step`, where the gate holds it (setting `stepLevelPause`, on by
+  default). The turn resumes **in place** off-peak — no followup message needed. Hold conditions:
+  peak (Beijing time) + not weekend + `step > 1` + official target provider (`providerGuard`) +
+  not request-held + not bypassed in this peak window. New module `src/step-gate.js` (pure
+  `decideStepHold` + hold / release / abort / timeout engine).
+- **`stepResume` port + RPC + `/resume`.** `sessionGuard.stepResume(sessionId, {bypass})`,
+  `POST /session-guard/rpc {action:'stepResume'}` and `/resume` all release the gate; a manual
+  resume also stops gating that session for the rest of the peak window.
+- **Timeout escalation.** `stepGateTimeoutMs` (default 300000) releases the gate and escalates to a
+  turn-level **force** pause, so a long peak neither deadlocks nor drips one step every five minutes.
+- **"⏸ Pause session" button** (client, slot `conversation.input.right`, id `session-guard-pause`,
+  order 20 — left of input-traffic's freeze button). It polls `/session-guard/state` once a second,
+  stays disabled while nothing is held, and calls `stepResume` when it is. The status badge moved to
+  order 40 and now reports the number of step-held sessions.
+- **New settings**: `stepLevelPause`, `stepGateTimeoutMs`.
+- **New state**: `GET /session-guard/state` now returns `paused: { step, turn }` and
+  `stepGate: { held, since, bypass }`; `/status` returns `stepHeld`; `/diag` returns `stepGate`.
+  The service port's `state().paused` stays boolean for compatibility (new field `pausedStep`).
+
+### Fixed
+
+- **Deadlock between a held step and a turn-level pause.** `pauseTask` / `resumeTask` /
+  `cancelTask` now release the step gate first: a step hold sits at `agent/pre-step`, where no
+  `assistant/message` or `tool/result` can ever arrive, so a `safe` pause used to wait forever and
+  never persisted `paused`.
+
+### Changed
+
+- **Peak entry no longer interrupts running turns** when `stepLevelPause` is on (`onEnterPeak` arms
+  the step gate instead of calling `stopNextTurn`); with it off the previous turn-level behaviour is
+  unchanged.
+- input-traffic's freeze button label is now **"Freeze & append"** (`冻结追加` / `凍結して追加` /
+  `동결 후 추가`), and its resume label **"Resume & append"** (`恢复追加` / `再開して追加` /
+  `재개 후 추가`) — it freezes the turn and keeps queued messages, distinct from the pause button.
+- **The pause button is a toggle now**: "Pause session" / "Resume session" (no disabled grey state).
+  Clicking "Pause session" calls the new `stepPause` action, which holds the session at the **next
+  step boundary** (step 1 included, regardless of peak or provider); "Resume session" calls
+  `stepResume`. New port method `sessionGuard.stepPause(sessionId)`.
+- **SSE push**: new route `GET /session-guard/events?session=<id>` pushes step-gate state changes the
+  moment they happen, so peak auto-holds flip the button to "Resume session" without waiting for a
+  poll; the 10s `/session-guard/state` poll remains as a fallback. `/state` now reports
+  `paused.manual` and `stepGate.manual`.
+- **Styling aligned** with input-traffic's composer button (24px height, 6px radius, 12px font, the
+  same border/hover/pressed tokens) for both the pause button and the status badge; styles are
+  injected once via `<style data-plugin-css="session-guard-client">`.
+
+## Unreleased
+
+### Added
+
+- **Official-source two-dimensional guard (peak × target provider).** Peak hours now block only
+  requests whose target route is a DeepSeek official source; local/third-party providers keep
+  running. Verdict order: explicit `officialProviders` id list → live `baseURL` endpoint →
+  catalog builtin endpoint (pi-ai's `deepseek`) → builtin id (`deepseek-official`); each verdict
+  reports `matchedBy`. New modules: `src/provider.js` (pure), `src/provider-directory.js`,
+  `src/deferrals.js`, `src/request-guard.js`, `src/targets.js`, `src/wiring.js`.
+- **Request-level backstop (`agent/request`).** Covers sessions started after peak entry and
+  sessions switched to an official source mid-run — the 30s tick only handled sessions that were
+  already `running` at the transition. Default `hold` mode suspends the request without an error
+  and releases it at the exact off-peak instant (`msUntilOffPeak`); `error` mode throws a
+  recognizable `PEAK_DEFERRED` failure and records a deferral for off-peak resume.
+- **New settings**: `providerGuard`, `officialProviders`, `officialBaseURLs`, `deferredResume`,
+  `deferredResumeText`, `deferredMode`, `deferredMaxHoldMs` (default 6h), `guardSubagents`.
+- **New routes**: `GET /session-guard/provider?provider=<id>` (verdict diagnostics);
+  `/session-guard/status` now reports `providerGuard` / `held` / `deferred`;
+  `/session-guard/state` reports the session's last target.
+- **Drift guard** `tools/check-api-drift.ps1` asserting the required APIs exist on
+  `dsh-v0.1.1-rc.2` / `dsh-v0.1.2-rc.1` / `dsh-v0.1.3-alpha.2` / `dsh-v0.1.5-alpha.1`.
+
+### Changed
+
+- **DSH dual-version support (0.1.0-rc.7 … 0.1.2-rc.1).** One artifact now covers both
+  `dsh-v0.1.1-rc.2` and `dsh-v0.1.2-rc.1`. The `tool/result` call-id dual read
+  (`content[].toolCallId` first, `source.callId` fallback — both forms appear in replay logs of
+  both versions) is extracted to the dependency-free `src/tool-call-id.js` with unit tests.
+  `dsh.client.inject` no longer names `@deepseek-ai/dsh-client-runtime` (removed in 0.1.2) or
+  `@deepseek-ai/dsh-client-ui-slots` (not a dynamic client row); peer ranges widened to
+  `>=0.1.0-rc.7 <0.2.0-0` and the removed package dropped. Added `engines.dsh` and a
+  version-compatibility table to the README (ZH/EN).
+- **Settings surface stays on the intersection API**: `settings.register` + `settings.get` only;
+  `installSection` (0.1.2+) and the removed `installSettingsSection` are never used. Optional
+  APIs (`model/selection`, `llm.listConfigurableProviders`, `settings.get`) are feature-probed and
+  degrade instead of throwing.
+- **`src/retry.js` short-circuits only the exact `PEAK_DEFERRED` sentinel.** 429 / `RATE_LIMIT` /
+  `TRANSPORT` / timeout failures remain transient, so DSH's global retry (`dsh-llm-retry` on
+  `agent/request-error`) and this plugin's own retry semantics are unchanged. `dsh-llm-retry`
+  itself is never touched.
+- Badge distinguishes "peak · official only" from "peak · all paused".
+
+## 0.1.4 — 2026-09-09
+
+### Changed
+
+- **Public beta release** of the dual-version line (`0.1.4-beta.1`): version metadata, README
+  compatibility table and package metadata aligned for the beta channel.
+
+## 0.1.3 — 2026-09-09
+
+### Fixed
+
+- **package.json encoding restored**: description was corrupted (GB2312 bytes misread as UTF-8); rewritten with correct Chinese text.
+- **Missing metadata**: added `repository`, `homepage` fields.
+- **peerDependencies corrected**: removed pinned `dsh-llm` exact version; added `cordis`, `dsh-client-runtime`, `dsh-client-locale`, `dsh-client-ui-settings`, `dsh-client-ui-slots` as optional peers matching `dsh.client.inject`.
+- Added `dsh.plugin.json` manifest.
+
+## 0.1.2 — 2026-08-28
+
+### Fixed
+
+- **Peak timezone fixed**: 峰谷判定固定北京时间 (`BILLING_TIMEZONE`)，周末判定用配置时区。
+
+## 0.1.1 — 2026-08-24
+
+### Added
+
+- **Backend auto-retry (D9)**: `turn/end` transient failures (error/429/max-tokens) trigger adaptive-backoff `followup(retryText)` resume; permanent failures (auth/balance/model/context limit) stop; user intervention or successful turn resets consecutive failure count.
+- **Freeze/gate yield**: retry skips when `isFrozen(sessionId)` is true (queueLocked / paused / taskControl paused), never bypasses the session gate.
+
+### Changed
+
+- `sessionGuard` redundant port now exposes `state(sessionId)` returning `{ queueLocked, lockReason, paused, taskControlAvailable, taskControl }`.
+- HTTP route `GET /session-guard/diag` returns runtime diagnostics including retry state.
+
+### Fixed
+
+- Weekend detection now uses `Intl.DateTimeFormat` with the configured timezone instead of bare `getUTCDay()`, fixing an 8-hour boundary bug for Beijing timezone.
+
+## 0.1.0 — 2026-08-18
+
+### Added
+
+- Initial release: peak auto-pause (global), weekend mode, per-session freeze/resume via `sessionGuard` redundant port + RPC bridge, custom session gate (`agent.cancel keepInbox + goals.pause + session/event safe boundary + followup resume`), settings panel (Settings → Plugins → session-guard).

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 dsh-session-guard contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 dsh-session-guard contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -34,14 +34,23 @@
 > | --- | --- | --- | --- | --- |
 > | 0.1.0-rc.7 ~ 0.1.1-rc.x | ➖ 不在本线（`legacy/0.1.2` 之前的历史版本） | `ctx.settings.register(ns, schema, { base })` | ✅ 形状一致 | ✅ 无平台值导入 |
 > | 0.1.2-alpha.2+ / 0.1.2-rc.1 | ➖ 不在本线 → 用 `legacy/0.1.2`（npm `@dsh-0.1.2`） | `register` 仍保留（另加 `installSection`） | ✅ 形状一致 | ✅ 无平台值导入 |
-> | **0.1.7-rc.1+** | ✅（**本线**，dist-tag `dsh-0.1.7`） | 声明式：Config `.volatile()` 字段由宿主投影成表单，`register` 已删除 | ✅ 事件经 `snapshotEvents()` 双路径读取 | ✅ 客户端设置卡改 `configForms` |
+> | **0.2.0-rc.1+** | ✅（**本线**，dist-tag `dsh-0.2.0`，npm `4.0.0`） | 声明式：Config `.volatile()` 字段由宿主投影成表单，`register` 已删除 | ✅ 事件经 `snapshotEvents()` 双路径读取 | ✅ 客户端设置卡改 `configForms` |
+> | 0.1.7-rc.1+ | ✅（`compat/0.1.7` 分支，dist-tag `dsh-0.1.7`） | 声明式：Config `.volatile()` 字段由宿主投影成表单，`register` 已删除 | ✅ 事件经 `snapshotEvents()` 双路径读取 | ✅ 客户端设置卡改 `configForms` |
 > | 0.1.5-rc.2 | ✅（`compat/0.1.5` 分支，dist-tag `dsh-0.1.5`） | `register` 仍在（字符串命名空间） | ✅ 事件经 `snapshotEvents()` 双路径读取 | ✅ |
 >
-> **本线身份**：分支 `compat/0.1.7`，npm 版本号 **`3.1.0`**（semver），dist-tag **`dsh-0.1.7`**。
-> `package.json` 与 `dsh.plugin.json` 的 `engines.dsh` 与三个 `@deepseek-ai/dsh-client-*`
-> peer 线统一为 `>=0.1.7-rc.1 <0.2.0-0`。
+> **本线身份**：分支 `compat/0.2.0`，npm 版本号 **`4.0.0`**（semver），dist-tag **`dsh-0.2.0`**。
+> `package.json` 与 `dsh.plugin.json` 的 `engines.dsh` 与四个 `@deepseek-ai/dsh-client-*`
+> peer 线统一为 `>=0.2.0-rc.1 <0.2.1-0`；`@deepseek-ai/cordis` peer 下限对齐宿主线的 `^4.0.4`。
 > 历史上 README 曾用「2.x / 3.x」当**线代号**，那是叙述习惯，**不是注册表里可拉取的版本号** ——
-> 请一律以 npm 版本号 `0.3.1`（0.1.2 线）、`3.0.0`/`3.0.1`（0.1.5 线）与 `3.1.0`（0.1.7 线）为准。
+> 请一律以 npm 版本号 `0.3.1`（0.1.2 线）、`3.0.0`/`3.0.1`（0.1.5 线）、`3.2.4`（0.1.7 线）与 `4.0.0`（0.2.0 线）为准。
+>
+> **0.2.0 适配（compat/0.2.0 分支，npm 4.0.0）**：
+> 0.2.0-rc.1 对本插件用到的插件 API（manifest/settings/HMR/slot/会话 V4）与 0.1.7 完全兼容，
+> 适配为元数据换代（peer/engines/dist-tag/版本 4.0.0）。随基线一并对齐的工程修复：
+> ① `src/client/family-section.tsx` 补入版本管理（此前仅在本地工作区，纯净 checkout 无法 build）；
+> ② eslint 配置去掉对 TS 类型签名误报的核心 `no-unused-vars`，lint 基线可全绿；
+> ③ v4 写路径署名静态闸（`tests/source-kind.test.mjs`）随基线带入本线；
+> ④ `@deepseek-ai/cordis` peer 对齐 `^4.0.4`（0.2.0-rc.1 宿主 UI 包声明 `~4.0.4`，原 `^4.0.1` 不冲突但下限过旧）。
 >
 > **其它线的落点**：DSH `0.1.2-rc.x` 宿主请使用分支 **`legacy/0.1.2`**（npm dist-tag
 > `dsh-0.1.2`，版本 `0.3.1`）。**`main` 已冻结在 `0.2.0-beta.1`，不是 0.1.2 线的发布分支。**

package/cordis.patch.yml

@@ -1,10 +1,10 @@
-# dsh-session-guard bundle patch：一行装配进 profile。
-#
-# host 半（src/index.js）注册 sessionGuard 服务（冗余端口，供 input-traffic 适配）、
-# 高峰自动会话门（taskControl.pause/resume，缺失时回退锁等待队列）、
-# /session-guard/* 路由与 设置→插件→session-guard 子板块（简单开关）。
-# 浏览器半（src/client/index.js，经 package.json dsh.client 声明）提供
-# 高峰状态徽标 + 无 input-traffic 时的回退冻结按钮。
-- insert:
-    - id: session-guard
-      name: dsh-session-guard
+# dsh-session-guard bundle patch：一行装配进 profile。
+#
+# host 半（src/index.js）注册 sessionGuard 服务（冗余端口，供 input-traffic 适配）、
+# 高峰自动会话门（taskControl.pause/resume，缺失时回退锁等待队列）、
+# /session-guard/* 路由与 设置→插件→session-guard 子板块（简单开关）。
+# 浏览器半（src/client/index.js，经 package.json dsh.client 声明）提供
+# 高峰状态徽标 + 无 input-traffic 时的回退冻结按钮。
+- insert:
+    - id: session-guard
+      name: dsh-session-guard