dsh-manage-session 0.1.0-alpha.0 → 0.3.3

package/INSTALL.zh.md

@@ -44,7 +44,7 @@ dsh plugin --profile <profile> add dsh-manage-session -w
 显式安装指定版本：
 
 ```bash
-dsh plugin --profile <profile> add dsh-manage-session@0.1.0-alpha.0 -w
+dsh plugin --profile <profile> add dsh-manage-session@0.1.0-alpha.6 -w
 ```
 
 官方 CLI 会自动更新 profile 依赖、锁文件与 `dsh.profile.bundles`。不要手工添加 YAML 行。
@@ -55,7 +55,7 @@ DSH 运行时使用 pnpm 11，其 `minimumReleaseAge` 策略可能拦截刚发
 
 ```yaml
 minimumReleaseAgeExclude:
-  - dsh-manage-session@0.1.0-alpha.0
+  - dsh-manage-session@0.1.0-alpha.6
 ```
 
 ## 2. 重启宿主
@@ -128,8 +128,8 @@ dsh --profile <profile> --dump-default-config
 
 重启后，侧边栏入口 `dsh-manage-session` 可用，设置区使用 `session-steward` 命名空间。请确认：
 
-1. 两个开关均开启时，**病案室**与**体检**两个页签都会渲染。
-2. 关闭 `historyFiles` 后「病案室」页签消失，且所有 `session-history-*` 调用返回显式的 disabled 错误。
+1. 两个开关均开启时，**养老院**与**体检**两个页签都会渲染。
+2. 关闭 `historyFiles` 后「养老院」页签消失，且所有 `session-history-*` 调用返回显式的 disabled 错误。
 3. 关闭 `healthCheck` 后「体检」页签消失，且所有 `session-health-*` 调用返回显式的 disabled 错误。
 4. 对 `/session-steward/api` 调用未识别的方法时返回显式错误，而不是静默成功。
 

package/README.en.md

@@ -1,63 +1,77 @@
-# dsh-manage-session (Session Steward)
-
-A DSH web plugin for **session history files** and **session health checks**. It never touches session data itself.
-
-- **Records Room (history files)** — browse the official archive set and prune ids in bulk
-  (backup + atomic replace; a DSH restart is required for the host to reload it).
-- **Checkup (health)** — four gates → prescription (command list) → discharge (reversible repair with a
-  before/after comparison).
-
-> Naming boundary: **this package ships no search or index features**. Search/indexing belongs to
-> `dsh-search-index`; neither side mentions or re-interprets the other's fields.
-
-## Install
-
-```bash
-dsh plugin --profile web add dsh-manage-session
-```
-
-Restart the host process afterwards (refreshing the page is not enough).
-
-## Routes
-
-Prefix `/session-steward/api`; every method name is `session-*` (never `index-*`), and an unrecognized
-method returns an explicit error instead of failing silently.
-
-| Method | Domain | Purpose |
-|---|---|---|
-| `session-history-list` | history | list the official archive set (with source and degradation notes) |
-| `session-history-prune` | history | bulk-remove ids from the archive array (auto backup, restart required) |
-| `session-health-status` | health | switch state and method table (panel polling) |
-| `session-health-scan` | health | batch checkup (defaults to non-ok sessions only) |
-| `session-health-session` | health | one session's four-gate report plus prescription |
-| `session-health-repair` | health | reversible repair (quarantine the projection-cache record) with before/after |
-
-Settings namespace `session-steward`; sidebar entry id `dsh-manage-session`.
-
-## Switches (feature gates)
-
-| Switch | Field | When off |
-|---|---|---|
-| Session history files | `historyFiles` (default true) | `session-history-*` is not registered and the Records Room tab is not rendered |
-| Health check | `healthCheck` (default true) | `session-health-*` is not registered and the Checkup tab is not rendered |
-
-Closed domains return `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` — no empty shells.
-
-## Contract with `dsh-search-index`
-
-The archive file format (`global.archivedSessionIds` of `~/.dsh/storages/workspace.json`):
-**this plugin writes, the search-index plugin reads only**. See
-`dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`.
-
-## Development
-
-```bash
-pnpm install
-pnpm typecheck
-pnpm test
-pnpm build
-```
-
-## License
-
-MIT
+# dsh-manage-session (Session Steward)
+
+A DSH web plugin for **session history files** and **session health checks**. It never touches session data itself.
+
+- **Retirement Home (history files)** — browse the official archive set and prune ids in bulk
+  (backup + atomic replace; a DSH restart is required for the host to reload it).
+- **Checkup (health)** — four gates → prescription (command list) → discharge (reversible repair with a
+  before/after comparison).
+
+> Naming boundary: **this package ships no search or index features**. Search/indexing belongs to
+> `dsh-search-index`; neither side mentions or re-interprets the other's fields.
+
+## Screenshots
+
+A **Session Steward** entry sits next to Search and Settings at the bottom of the sidebar:
+
+![Sidebar entry](assets/left-sidebar.png)
+
+**Retirement Home (history files)** — the official archive set, each row carrying its size and whether the on-disk entity still exists; select rows to un-archive or purge:
+
+![Retirement Home](assets/archive.png)
+
+**Checkup** — the entry point of the four-gate checkup, which ends in a reversible prescription:
+
+![Checkup](assets/doctor.png)
+
+## Install
+
+```bash
+dsh plugin --profile web add dsh-manage-session
+```
+
+Restart the host process afterwards (refreshing the page is not enough).
+
+## Routes
+
+Prefix `/session-steward/api`; every method name is `session-*` (never `index-*`), and an unrecognized
+method returns an explicit error instead of failing silently.
+
+| Method | Domain | Purpose |
+|---|---|---|
+| `session-history-list` | history | list the official archive set (with source and degradation notes) |
+| `session-history-prune` | history | bulk-remove ids from the archive array (auto backup, restart required) |
+| `session-health-status` | health | switch state and method table (panel polling) |
+| `session-health-scan` | health | batch checkup (defaults to non-ok sessions only) |
+| `session-health-session` | health | one session's four-gate report plus prescription |
+| `session-health-repair` | health | reversible repair (quarantine the projection-cache record) with before/after |
+
+Settings namespace `session-steward`; sidebar entry id `dsh-manage-session`.
+
+## Switches (feature gates)
+
+| Switch | Field | When off |
+|---|---|---|
+| Session history files | `historyFiles` (default true) | `session-history-*` is not registered and the Retirement Home tab is not rendered |
+| Health check | `healthCheck` (default true) | `session-health-*` is not registered and the Checkup tab is not rendered |
+
+Closed domains return `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` — no empty shells.
+
+## Contract with `dsh-search-index`
+
+The archive file format (`global.archivedSessionIds` of `~/.dsh/storages/workspace.json`):
+**this plugin writes, the search-index plugin reads only**. See
+`dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`.
+
+## Development
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm test
+pnpm build
+```
+
+## License
+
+MIT

package/README.ja.md

@@ -1,63 +1,77 @@
-# dsh-manage-session（セッション・スチュワード）
-
-**セッション履歴ファイル**と**セッション健康チェック**のための DSH Web プラグインです。セッションデータそのものには一切触れません。
-
-- **カルテ室（履歴ファイル）** — 公式アーカイブ集合を閲覧し、ID を一括整理します
-  （バックアップ + アトミック置換。ホストに再読み込みさせるには DSH の再起動が必要です）。
-- **健診（健康チェック）** — 四つのゲート → 処方（コマンド一覧）→ 退院（before/after 比較を伴う
-  可逆的な修復）。
-
-> 命名の境界：**本パッケージは検索・インデックス機能を一切提供しません**。検索／インデックスは
-> `dsh-search-index` に属し、双方が相手のフィールドに言及したり再解釈したりすることはありません。
-
-## インストール
-
-```bash
-dsh plugin --profile web add dsh-manage-session
-```
-
-その後、ホストプロセスを再起動してください（ページの再読み込みでは不十分です）。
-
-## ルート
-
-プレフィックスは `/session-steward/api`。メソッド名はすべて `session-*`（`index-*` は使いません）で、
-未知のメソッドは黙って失敗せず明示的なエラーを返します。
-
-| メソッド | ドメイン | 用途 |
-|---|---|---|
-| `session-history-list` | history | 公式アーカイブ集合を一覧表示（取得元と縮退の注記付き） |
-| `session-history-prune` | history | アーカイブ配列から ID を一括削除（自動バックアップ、再起動が必要） |
-| `session-health-status` | health | スイッチの状態とメソッド一覧（パネルのポーリング用） |
-| `session-health-scan` | health | 一括健診（既定では非 ok のセッションのみ） |
-| `session-health-session` | health | 1 セッションの四ゲートレポートと処方 |
-| `session-health-repair` | health | 可逆的な修復（プロジェクションキャッシュのレコードを隔離）と before/after 対照 |
-
-設定名前空間は `session-steward`、サイドバーエントリ ID は `dsh-manage-session`。
-
-## スイッチ（フィーチャーゲート）
-
-| スイッチ | フィールド | オフのとき |
-|---|---|---|
-| セッション履歴ファイル | `historyFiles`（既定 true） | `session-history-*` は登録されず、カルテ室タブも描画されない |
-| 健康チェック | `healthCheck`（既定 true） | `session-health-*` は登録されず、健診タブも描画されない |
-
-閉じられたドメインは `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` を返します — 空の殻は残しません。
-
-## `dsh-search-index` との契約
-
-アーカイブファイル形式（`~/.dsh/storages/workspace.json` の `global.archivedSessionIds`）は、
-**本プラグインが書き込み、検索インデックスプラグインは読み取りのみ**です。詳細は
-`dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md` を参照してください。
-
-## 開発
-
-```bash
-pnpm install
-pnpm typecheck
-pnpm test
-pnpm build
-```
-
-## ライセンス
-
-MIT
+# dsh-manage-session（セッション・スチュワード）
+
+**セッション履歴ファイル**と**セッション健康チェック**のための DSH Web プラグインです。セッションデータそのものには一切触れません。
+
+- **カルテ室（履歴ファイル）** — 公式アーカイブ集合を閲覧し、ID を一括整理します
+  （バックアップ + アトミック置換。ホストに再読み込みさせるには DSH の再起動が必要です）。
+- **健診（健康チェック）** — 四つのゲート → 処方（コマンド一覧）→ 退院（before/after 比較を伴う
+  可逆的な修復）。
+
+> 命名の境界：**本パッケージは検索・インデックス機能を一切提供しません**。検索／インデックスは
+> `dsh-search-index` に属し、双方が相手のフィールドに言及したり再解釈したりすることはありません。
+
+## スクリーンショット
+
+サイドバー下部に **「会话管家」**（セッション・スチュワード）のエントリが追加され、検索・設定と並びます：
+
+![サイドバーのエントリ](assets/left-sidebar.png)
+
+**カルテ室（履歴ファイル）** — 公式アーカイブ集合の一覧。各行にサイズとディスク上の実体の有無を表示し、選択してアーカイブ解除または整理ができます：
+
+![カルテ室](assets/archive.png)
+
+**健診** — 四つのゲートによる健診の入口。スキャン後に可逆的な処方を提示します：
+
+![健診](assets/doctor.png)
+
+## インストール
+
+```bash
+dsh plugin --profile web add dsh-manage-session
+```
+
+その後、ホストプロセスを再起動してください（ページの再読み込みでは不十分です）。
+
+## ルート
+
+プレフィックスは `/session-steward/api`。メソッド名はすべて `session-*`（`index-*` は使いません）で、
+未知のメソッドは黙って失敗せず明示的なエラーを返します。
+
+| メソッド | ドメイン | 用途 |
+|---|---|---|
+| `session-history-list` | history | 公式アーカイブ集合を一覧表示（取得元と縮退の注記付き） |
+| `session-history-prune` | history | アーカイブ配列から ID を一括削除（自動バックアップ、再起動が必要） |
+| `session-health-status` | health | スイッチの状態とメソッド一覧（パネルのポーリング用） |
+| `session-health-scan` | health | 一括健診（既定では非 ok のセッションのみ） |
+| `session-health-session` | health | 1 セッションの四ゲートレポートと処方 |
+| `session-health-repair` | health | 可逆的な修復（プロジェクションキャッシュのレコードを隔離）と before/after 対照 |
+
+設定名前空間は `session-steward`、サイドバーエントリ ID は `dsh-manage-session`。
+
+## スイッチ（フィーチャーゲート）
+
+| スイッチ | フィールド | オフのとき |
+|---|---|---|
+| セッション履歴ファイル | `historyFiles`（既定 true） | `session-history-*` は登録されず、カルテ室タブも描画されない |
+| 健康チェック | `healthCheck`（既定 true） | `session-health-*` は登録されず、健診タブも描画されない |
+
+閉じられたドメインは `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }` を返します — 空の殻は残しません。
+
+## `dsh-search-index` との契約
+
+アーカイブファイル形式（`~/.dsh/storages/workspace.json` の `global.archivedSessionIds`）は、
+**本プラグインが書き込み、検索インデックスプラグインは読み取りのみ**です。詳細は
+`dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md` を参照してください。
+
+## 開発
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm test
+pnpm build
+```
+
+## ライセンス
+
+MIT

package/README.ko.md

@@ -1,61 +1,75 @@
-# dsh-manage-session (세션 스튜어드)
-
-**세션 히스토리 파일**과 **세션 상태 점검**을 위한 DSH 웹 플러그인입니다. 세션 데이터 자체는 건드리지 않습니다.
-
-- **기록 보관소(히스토리 파일)** — 공식 아카이브 집합을 조회하고 id를 일괄 정리합니다
-  (백업 + 원자적 교체, 호스트가 다시 로드하려면 DSH 재시작이 필요합니다).
-- **점검(상태)** — 네 개의 gate → 처방(명령 목록) → 퇴원(전후 비교가 포함된 되돌릴 수 있는 복구).
-
-> 이름 경계: **이 패키지는 검색이나 인덱스 기능을 제공하지 않습니다**. 검색/인덱싱은
-> `dsh-search-index`에 속하며, 어느 쪽도 상대방의 필드를 언급하거나 재해석하지 않습니다.
-
-## 설치
-
-```bash
-dsh plugin --profile web add dsh-manage-session
-```
-
-이후 호스트 프로세스를 재시작하세요(페이지 새로고침만으로는 부족합니다).
-
-## 라우트
-
-접두사 `/session-steward/api`; 모든 메서드 이름은 `session-*`이며(`index-*`는 결코 아닙니다), 인식되지 않는
-메서드는 조용히 실패하지 않고 명시적인 오류를 반환합니다.
-
-| 메서드 | 도메인 | 목적 |
-|---|---|---|
-| `session-history-list` | history | 공식 아카이브 집합 조회(출처 및 성능 저하 관련 주석 포함) |
-| `session-history-prune` | history | 아카이브 배열에서 id 일괄 제거(자동 백업, 재시작 필요) |
-| `session-health-status` | health | 스위치 상태와 메서드 표(패널 폴링) |
-| `session-health-scan` | health | 일괄 점검(기본값은 비정상 세션만) |
-| `session-health-session` | health | 단일 세션의 4-gate 리포트와 처방 |
-| `session-health-repair` | health | 되돌릴 수 있는 복구(프로젝션 캐시 레코드 격리)와 전후 비교 |
-
-설정 네임스페이스 `session-steward`; 사이드바 항목 id `dsh-manage-session`.
-
-## 스위치(기능 게이트)
-
-| 스위치 | 필드 | 꺼져 있을 때 |
-|---|---|---|
-| 세션 히스토리 파일 | `historyFiles`(기본값 true) | `session-history-*`가 등록되지 않고 기록 보관소 탭이 렌더링되지 않습니다 |
-| 상태 점검 | `healthCheck`(기본값 true) | `session-health-*`가 등록되지 않고 점검 탭이 렌더링되지 않습니다 |
-
-닫힌 도메인은 `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }`를 반환합니다 — 빈 껍데기는 남지 않습니다.
-
-## `dsh-search-index`와의 계약
-
-아카이브 파일 형식(`~/.dsh/storages/workspace.json`의 `global.archivedSessionIds`):
-**이 플러그인이 쓰고, search-index 플러그인은 읽기만 합니다**. `dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`를 참고하세요.
-
-## 개발
-
-```bash
-pnpm install
-pnpm typecheck
-pnpm test
-pnpm build
-```
-
-## 라이선스
-
-MIT
+# dsh-manage-session (세션 스튜어드)
+
+**세션 히스토리 파일**과 **세션 상태 점검**을 위한 DSH 웹 플러그인입니다. 세션 데이터 자체는 건드리지 않습니다.
+
+- **기록 보관소(히스토리 파일)** — 공식 아카이브 집합을 조회하고 id를 일괄 정리합니다
+  (백업 + 원자적 교체, 호스트가 다시 로드하려면 DSH 재시작이 필요합니다).
+- **점검(상태)** — 네 개의 gate → 처방(명령 목록) → 퇴원(전후 비교가 포함된 되돌릴 수 있는 복구).
+
+> 이름 경계: **이 패키지는 검색이나 인덱스 기능을 제공하지 않습니다**. 검색/인덱싱은
+> `dsh-search-index`에 속하며, 어느 쪽도 상대방의 필드를 언급하거나 재해석하지 않습니다.
+
+## 스크린샷
+
+사이드바 하단에 **「会话管家」**(세션 스튜어드) 항목이 추가되어 검색, 설정과 나란히 표시됩니다:
+
+![사이드바 항목](assets/left-sidebar.png)
+
+**기록 보관소(히스토리 파일)** — 공식 아카이브 집합 목록. 각 행에 용량과 디스크 실체 존재 여부를 표시하며, 선택하여 아카이브 해제 또는 정리를 할 수 있습니다:
+
+![기록 보관소](assets/archive.png)
+
+**점검** — 네 개의 gate 점검 입구이며, 검사 후 되돌릴 수 있는 처방을 제시합니다:
+
+![점검](assets/doctor.png)
+
+## 설치
+
+```bash
+dsh plugin --profile web add dsh-manage-session
+```
+
+이후 호스트 프로세스를 재시작하세요(페이지 새로고침만으로는 부족합니다).
+
+## 라우트
+
+접두사 `/session-steward/api`; 모든 메서드 이름은 `session-*`이며(`index-*`는 결코 아닙니다), 인식되지 않는
+메서드는 조용히 실패하지 않고 명시적인 오류를 반환합니다.
+
+| 메서드 | 도메인 | 목적 |
+|---|---|---|
+| `session-history-list` | history | 공식 아카이브 집합 조회(출처 및 성능 저하 관련 주석 포함) |
+| `session-history-prune` | history | 아카이브 배열에서 id 일괄 제거(자동 백업, 재시작 필요) |
+| `session-health-status` | health | 스위치 상태와 메서드 표(패널 폴링) |
+| `session-health-scan` | health | 일괄 점검(기본값은 비정상 세션만) |
+| `session-health-session` | health | 단일 세션의 4-gate 리포트와 처방 |
+| `session-health-repair` | health | 되돌릴 수 있는 복구(프로젝션 캐시 레코드 격리)와 전후 비교 |
+
+설정 네임스페이스 `session-steward`; 사이드바 항목 id `dsh-manage-session`.
+
+## 스위치(기능 게이트)
+
+| 스위치 | 필드 | 꺼져 있을 때 |
+|---|---|---|
+| 세션 히스토리 파일 | `historyFiles`(기본값 true) | `session-history-*`가 등록되지 않고 기록 보관소 탭이 렌더링되지 않습니다 |
+| 상태 점검 | `healthCheck`(기본값 true) | `session-health-*`가 등록되지 않고 점검 탭이 렌더링되지 않습니다 |
+
+닫힌 도메인은 `{ ok: false, error: '子域已关闭（…=false）：<method> 未注册' }`를 반환합니다 — 빈 껍데기는 남지 않습니다.
+
+## `dsh-search-index`와의 계약
+
+아카이브 파일 형식(`~/.dsh/storages/workspace.json`의 `global.archivedSessionIds`):
+**이 플러그인이 쓰고, search-index 플러그인은 읽기만 합니다**. `dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md`를 참고하세요.
+
+## 개발
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm test
+pnpm build
+```
+
+## 라이선스
+
+MIT