dsh-input-traffic 0.6.1 → 0.7.0

package/INSTALL.ja.md

@@ -1,151 +1,151 @@
-# インストールガイド（公式 DSH CLI）
-
-このガイドは公式 `dsh plugin` コマンドのみを使用します。このコマンドは依存関係を profile にインストールし、`dsh.profile.bundles` を同期します。普通の `npm install`、profile での直接 `pnpm add`、profile マニフェストの手動編集で代用しないでください。
-
-- [日本語インストールガイド](./INSTALL.ja.md)
-- [English installation guide](./INSTALL.md)
-- [中文安装指南](./INSTALL.zh.md)
-- [한국어 설치 안내](./INSTALL.ko.md)
-- [日本語 README](./README.ja.md)
-- [English README](./README.en.md)
-- [中文 README](./README.md)
-- [한국어 README](./README.ko.md)
-- [Changelog](./CHANGELOG.md)
-- [日本語 changelog](./CHANGELOG.ja.md)
-- [한국어 changelog](./CHANGELOG.ko.md)
-
-このガイドのプレースホルダー：
-
-- `<profile>`：変更する DSH profile。通常は `web`；
-- `dsh-input-traffic`：npm パッケージ名とランタイムプラグイン ID。
-
-## 0. 前提と profile の確認
-
-```bash
-echo "DSH_HOME=${DSH_HOME:-$HOME/.dsh}"
-dsh --version
-ls "${DSH_HOME:-$HOME/.dsh}/profiles"
-```
-
-実行中の DSH プロセスが使う profile を使用してください。`web` が一般的ですが、実際の `--profile` 引数が優先されます。
-
-## 1. 公式インストール
-
-最新版をインストール：
-
-```bash
-dsh plugin --profile <profile> add dsh-input-traffic -w
-```
-
-（profile が pnpm workspace root の場合は `-w` が必要です。`web` はそうです。）
-
-現在のリリースを明示的にインストール：
-
-```bash
-dsh plugin --profile <profile> add dsh-input-traffic@0.2.9 -w
-```
-
-公式 CLI は profile の依存関係、ロックファイル、`dsh.profile.bundles` を自動更新します。手動で YAML を追加しないでください。
-
-### サプライチェーン冷却期間
-
-dsh ランタイムは pnpm 11 を使用し、`minimumReleaseAge` ポリシーが新規公開版を `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` でブロックすることがあります。`~/.dsh/profiles/web/pnpm-workspace.yaml` の `minimumReleaseAgeExclude` にバージョンを追加してください：
-
-```yaml
-minimumReleaseAgeExclude:
-  - dsh-input-traffic@0.2.9
-```
-
-## 2. アップグレード
-
-registry の最新版へアップグレード：
-
-```bash
-dsh plugin --profile <profile> update dsh-input-traffic -w
-```
-
-ホスト側の変更は DSH を再起動、ブラウザ側は Web ページをリフレッシュしてください。
-
-## 3. ローカルパス / link: 登録（代替）
-
-開発用やオフラインインストールでは、ローカルチェックアウトから登録できます：
-
-```bash
-#    ~/.dsh/profiles/web/package.json dependencies:
-#      "dsh-input-traffic": "link:<dsh-input-traffic の絶対パス>"
-#    ~/.dsh/profiles/web/cordis.patch.yml:
-#      - insert:
-#          - id: input-traffic
-#            name: dsh-input-traffic
-cd ~/.dsh/profiles/web && pnpm install && dsh web
-```
-
-または公式 CLI でローカルパスを追加（ネットワーク不要）：
-
-```bash
-dsh plugin --profile <profile> add /dsh-input-traffic の絶対パス/ -w
-```
-
-## 4. インストールの検証
-
-依存関係とインストール済みバージョンを確認：
-
-```bash
-grep -n "dsh-input-traffic" \
-  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
-```
-
-公式構成を確認：
-
-```bash
-dsh --profile <profile> --dump-default-config
-```
-
-以下が含まれている必要があります：
-
-```yaml
-- id: input-traffic
-  name: dsh-input-traffic
-```
-
-## 5. プラグインの検証
-
-DSH を再起動し、Web ページをリフレッシュしてください。セッションで以下を確認：
-
-1. 待機エリアに 3 段階プランニング dock が表示される；
-2. コンポーザ右側に「セッション凍結」ボタンが表示される；
-3. 公式設定パネルの「ビジー時の Enter キー動作」設定行が非表示になる；
-4. エージェントがビジーなときメッセージを送ると、待機エリアに赤/黄/緑プランニングボタン付きで配置される。
-
-## 日本語と韓国語のサポート状況
-
-プラグインには `ja` と `ko` の辞書が含まれていますが、現在の公式 DSH リリースは `LocaleRuntime` 経由で `zh` と `en` のみを提供します。純正 DSH で日本語または韓国語を選択すると `locale "<id>" is not registered` で失敗します。
-
-公式サポートが来る前に使うには、DSH フォークを保守して更新してください：
-
-- `packages/client/locale/src/locale-settings.ts`：`LOCALE_IDS` に `ja` と `ko` を追加。
-- `packages/client/locale/src/client/index.ts`：`LOCALES` に `{ id: 'ja', label: '日本語' }` と `{ id: 'ko', label: '한국어' }` を追加。
-- 対応するコア辞書とテストを追加し、フォーク版を再ビルドして実行。
-
-プラグイン単体では DSH のグローバル locale 一覧を拡張できません。
-
-## 6. トラブルシューティング
-
-| 症状 | 対処 |
-| --- | --- |
-| `dsh` が見つからない | 公式 DSH CLI をインストール/有効化。 |
-| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | profile の `pnpm-workspace.yaml` の `minimumReleaseAgeExclude` にバージョンを追加。 |
-| プラグインが「無効/未マウント」でエラーなし | profile 構成を確認。 |
-| client エントリが `__DSH_BOOT__` にない | `exports["./client"]` が存在し、host fiber が確立されていることを確認。 |
-| 凍結/再開ボタンが動作しない | セッション級ロックを使用する場合は session-guard がインストールされているか確認。未インストール時は fail-open で動作。 |
-| ブラウザが古い bundle を表示 | アップグレード後にハードリフレッシュ（Ctrl+Shift+R）。 |
-
-## 7. アンインストール
-
-公式コマンドを使用：
-
-```bash
-dsh plugin --profile <profile> remove dsh-input-traffic
-```
-
-再起動後、公式キュー dock と「ビジー時の Enter キー動作」設定行が復元されます。
+# インストールガイド（公式 DSH CLI）
+
+このガイドは公式 `dsh plugin` コマンドのみを使用します。このコマンドは依存関係を profile にインストールし、`dsh.profile.bundles` を同期します。普通の `npm install`、profile での直接 `pnpm add`、profile マニフェストの手動編集で代用しないでください。
+
+- [日本語インストールガイド](./INSTALL.ja.md)
+- [English installation guide](./INSTALL.md)
+- [中文安装指南](./INSTALL.zh.md)
+- [한국어 설치 안내](./INSTALL.ko.md)
+- [日本語 README](./README.ja.md)
+- [English README](./README.en.md)
+- [中文 README](./README.md)
+- [한국어 README](./README.ko.md)
+- [Changelog](./CHANGELOG.md)
+- [日本語 changelog](./CHANGELOG.ja.md)
+- [한국어 changelog](./CHANGELOG.ko.md)
+
+このガイドのプレースホルダー：
+
+- `<profile>`：変更する DSH profile。通常は `web`；
+- `dsh-input-traffic`：npm パッケージ名とランタイムプラグイン ID。
+
+## 0. 前提と profile の確認
+
+```bash
+echo "DSH_HOME=${DSH_HOME:-$HOME/.dsh}"
+dsh --version
+ls "${DSH_HOME:-$HOME/.dsh}/profiles"
+```
+
+実行中の DSH プロセスが使う profile を使用してください。`web` が一般的ですが、実際の `--profile` 引数が優先されます。
+
+## 1. 公式インストール
+
+最新版をインストール：
+
+```bash
+dsh plugin --profile <profile> add dsh-input-traffic -w
+```
+
+（profile が pnpm workspace root の場合は `-w` が必要です。`web` はそうです。）
+
+現在のリリースを明示的にインストール：
+
+```bash
+dsh plugin --profile <profile> add dsh-input-traffic@0.2.9 -w
+```
+
+公式 CLI は profile の依存関係、ロックファイル、`dsh.profile.bundles` を自動更新します。手動で YAML を追加しないでください。
+
+### サプライチェーン冷却期間
+
+dsh ランタイムは pnpm 11 を使用し、`minimumReleaseAge` ポリシーが新規公開版を `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` でブロックすることがあります。`~/.dsh/profiles/web/pnpm-workspace.yaml` の `minimumReleaseAgeExclude` にバージョンを追加してください：
+
+```yaml
+minimumReleaseAgeExclude:
+  - dsh-input-traffic@0.2.9
+```
+
+## 2. アップグレード
+
+registry の最新版へアップグレード：
+
+```bash
+dsh plugin --profile <profile> update dsh-input-traffic -w
+```
+
+ホスト側の変更は DSH を再起動、ブラウザ側は Web ページをリフレッシュしてください。
+
+## 3. ローカルパス / link: 登録（代替）
+
+開発用やオフラインインストールでは、ローカルチェックアウトから登録できます：
+
+```bash
+#    ~/.dsh/profiles/web/package.json dependencies:
+#      "dsh-input-traffic": "link:<dsh-input-traffic の絶対パス>"
+#    ~/.dsh/profiles/web/cordis.patch.yml:
+#      - insert:
+#          - id: input-traffic
+#            name: dsh-input-traffic
+cd ~/.dsh/profiles/web && pnpm install && dsh web
+```
+
+または公式 CLI でローカルパスを追加（ネットワーク不要）：
+
+```bash
+dsh plugin --profile <profile> add /dsh-input-traffic の絶対パス/ -w
+```
+
+## 4. インストールの検証
+
+依存関係とインストール済みバージョンを確認：
+
+```bash
+grep -n "dsh-input-traffic" \
+  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
+```
+
+公式構成を確認：
+
+```bash
+dsh --profile <profile> --dump-default-config
+```
+
+以下が含まれている必要があります：
+
+```yaml
+- id: input-traffic
+  name: dsh-input-traffic
+```
+
+## 5. プラグインの検証
+
+DSH を再起動し、Web ページをリフレッシュしてください。セッションで以下を確認：
+
+1. 待機エリアに 3 段階プランニング dock が表示される；
+2. コンポーザ右側に「セッション凍結」ボタンが表示される；
+3. 公式設定パネルの「ビジー時の Enter キー動作」設定行が非表示になる；
+4. エージェントがビジーなときメッセージを送ると、待機エリアに赤/黄/緑プランニングボタン付きで配置される。
+
+## 日本語と韓国語のサポート状況
+
+プラグインには `ja` と `ko` の辞書が含まれていますが、現在の公式 DSH リリースは `LocaleRuntime` 経由で `zh` と `en` のみを提供します。純正 DSH で日本語または韓国語を選択すると `locale "<id>" is not registered` で失敗します。
+
+公式サポートが来る前に使うには、DSH フォークを保守して更新してください：
+
+- `packages/client/locale/src/locale-settings.ts`：`LOCALE_IDS` に `ja` と `ko` を追加。
+- `packages/client/locale/src/client/index.ts`：`LOCALES` に `{ id: 'ja', label: '日本語' }` と `{ id: 'ko', label: '한국어' }` を追加。
+- 対応するコア辞書とテストを追加し、フォーク版を再ビルドして実行。
+
+プラグイン単体では DSH のグローバル locale 一覧を拡張できません。
+
+## 6. トラブルシューティング
+
+| 症状 | 対処 |
+| --- | --- |
+| `dsh` が見つからない | 公式 DSH CLI をインストール/有効化。 |
+| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | profile の `pnpm-workspace.yaml` の `minimumReleaseAgeExclude` にバージョンを追加。 |
+| プラグインが「無効/未マウント」でエラーなし | profile 構成を確認。 |
+| client エントリが `__DSH_BOOT__` にない | `exports["./client"]` が存在し、host fiber が確立されていることを確認。 |
+| 凍結/再開ボタンが動作しない | セッション級ロックを使用する場合は session-guard がインストールされているか確認。未インストール時は fail-open で動作。 |
+| ブラウザが古い bundle を表示 | アップグレード後にハードリフレッシュ（Ctrl+Shift+R）。 |
+
+## 7. アンインストール
+
+公式コマンドを使用：
+
+```bash
+dsh plugin --profile <profile> remove dsh-input-traffic
+```
+
+再起動後、公式キュー dock と「ビジー時の Enter キー動作」設定行が復元されます。

package/INSTALL.ko.md

@@ -1,151 +1,151 @@
-# 설치 안내(공식 DSH CLI)
-
-이 가이드는 공식 `dsh plugin` 명령만 사용합니다. 이 명령은 의존성을 profile에 설치하고 `dsh.profile.bundles`를 동기화합니다. 일반 `npm install`, profile에서 직접 `pnpm add`, profile 매니페스트 수동 편집으로 대체하지 마세요.
-
-- [한국어 설치 안내](./INSTALL.ko.md)
-- [English installation guide](./INSTALL.md)
-- [中文安装指南](./INSTALL.zh.md)
-- [日本語インストールガイド](./INSTALL.ja.md)
-- [한국어 README](./README.ko.md)
-- [English README](./README.en.md)
-- [中文 README](./README.md)
-- [日本語 README](./README.ja.md)
-- [Changelog](./CHANGELOG.md)
-- [日本語 changelog](./CHANGELOG.ja.md)
-- [한국어 changelog](./CHANGELOG.ko.md)
-
-이 가이드의 자리표시자:
-
-- `<profile>`: 수정할 DSH profile. 보통 `web`;
-- `dsh-input-traffic`: npm 패키지 이름이자 런타임 플러그인 ID.
-
-## 0. 사전 확인과 profile 확인
-
-```bash
-echo "DSH_HOME=${DSH_HOME:-$HOME/.dsh}"
-dsh --version
-ls "${DSH_HOME:-$HOME/.dsh}/profiles"
-```
-
-실행 중인 DSH 프로세스가 사용하는 profile을 사용하세요. `web`이 일반적이지만 실제 `--profile` 인자가 우선합니다.
-
-## 1. 공식 설치
-
-최신 버전 설치:
-
-```bash
-dsh plugin --profile <profile> add dsh-input-traffic -w
-```
-
-(profile이 pnpm workspace root면 `-w`가 필요합니다. `web`이 그렇습니다.)
-
-현재 릴리스 명시적 설치:
-
-```bash
-dsh plugin --profile <profile> add dsh-input-traffic@0.2.9 -w
-```
-
-공식 CLI는 profile 의존성, 잠금 파일, `dsh.profile.bundles`를 자동으로 갱신합니다. 수동으로 YAML을 추가하지 마세요.
-
-### 공급망 쿨링 기간
-
-dsh 런타임은 pnpm 11을 사용하며 `minimumReleaseAge` 정책이 새로 게시된 버전을 `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`으로 차단할 수 있습니다. `~/.dsh/profiles/web/pnpm-workspace.yaml`의 `minimumReleaseAgeExclude`에 버전을 추가하세요:
-
-```yaml
-minimumReleaseAgeExclude:
-  - dsh-input-traffic@0.2.9
-```
-
-## 2. 업그레이드
-
-registry 최신 버전으로 업그레이드:
-
-```bash
-dsh plugin --profile <profile> update dsh-input-traffic -w
-```
-
-호스트 변경은 DSH 재시작, 브라우저 측은 웹 페이지 새로고침이 필요합니다.
-
-## 3. 로컬 경로 / link: 등록(대안)
-
-개발 또는 오프라인 설치에서는 로컬 체크아웃에서 등록할 수 있습니다:
-
-```bash
-#    ~/.dsh/profiles/web/package.json dependencies:
-#      "dsh-input-traffic": "link:<dsh-input-traffic 절대 경로>"
-#    ~/.dsh/profiles/web/cordis.patch.yml:
-#      - insert:
-#          - id: input-traffic
-#            name: dsh-input-traffic
-cd ~/.dsh/profiles/web && pnpm install && dsh web
-```
-
-또는 공식 CLI로 로컬 경로 추가(네트워크 불필요):
-
-```bash
-dsh plugin --profile <profile> add /dsh-input-traffic 절대 경로/ -w
-```
-
-## 4. 설치 검증
-
-의존성과 설치 버전 확인:
-
-```bash
-grep -n "dsh-input-traffic" \
-  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
-```
-
-공식 구성 확인:
-
-```bash
-dsh --profile <profile> --dump-default-config
-```
-
-다음이 포함되어야 합니다:
-
-```yaml
-- id: input-traffic
-  name: dsh-input-traffic
-```
-
-## 5. 플러그인 검증
-
-DSH를 재시작하고 웹 페이지를 새로고침하세요. 세션에서 다음을 확인:
-
-1. 대기 영역에 3단계 계획 dock이 표시됨;
-2. 컴포저 우측에 "세션 동결" 버튼이 표시됨;
-3. 공식 설정 패널의 "바쁜 동안 Enter 키 동작" 설정 행이 숨겨짐;
-4. 에이전트가 바쁠 때 메시지를 보내면 대기 영역에 빨간/노란/초록 계획 버튼과 함께 배치됨.
-
-## 일본어·한국어 지원 상태
-
-플러그인에는 `ja`와 `ko` 사전이 포함되어 있지만, 현재 공식 DSH 릴리스는 `LocaleRuntime`을 통해 `zh`와 `en`만 제공합니다. 순정 DSH에서 일본어 또는 한국어를 선택하면 `locale "<id>" is not registered` 오류가 발생합니다.
-
-공식 지원 전에 사용하려면 DSH 포크를 유지하며 업데이트하세요:
-
-- `packages/client/locale/src/locale-settings.ts`: `LOCALE_IDS`에 `ja`와 `ko` 추가.
-- `packages/client/locale/src/client/index.ts`: `LOCALES`에 `{ id: 'ja', label: '日本語' }`와 `{ id: 'ko', label: '한국어' }` 추가.
-- 해당 핵심 사전과 테스트를 추가하고 포크 버전을 다시 빌드하여 실행.
-
-플러그인만으로는 DSH의 전역 locale 목록을 확장할 수 없습니다.
-
-## 6. 트러블슈팅
-
-| 증상 | 조치 |
-| --- | --- |
-| `dsh`를 찾을 수 없음 | 공식 DSH CLI를 설치/활성화. |
-| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | profile의 `pnpm-workspace.yaml` `minimumReleaseAgeExclude`에 버전 추가. |
-| 플러그인이「비활성화/미마운트」이며 오류 없음 | profile 구성을 확인. |
-| client 항목이 `__DSH_BOOT__`에 없음 | `exports["./client"]`가 있고 host fiber가 생성되었는지 확인. |
-| 동결/재개 버튼이 작동하지 않음 | 세션급 잠금을 사용하는 경우 session-guard가 설치되어 있는지 확인. 미설치 시 fail-open으로 동작. |
-| 브라우저가 오래된 bundle 표시 | 업그레이드 후 하드 새로고침(Ctrl+Shift+R). |
-
-## 7. 제거
-
-공식 명령 사용:
-
-```bash
-dsh plugin --profile <profile> remove dsh-input-traffic
-```
-
-재시작 후 공식 대기열 dock과 "바쁜 동안 Enter 키 동작" 설정 행이 복원됩니다.
+# 설치 안내(공식 DSH CLI)
+
+이 가이드는 공식 `dsh plugin` 명령만 사용합니다. 이 명령은 의존성을 profile에 설치하고 `dsh.profile.bundles`를 동기화합니다. 일반 `npm install`, profile에서 직접 `pnpm add`, profile 매니페스트 수동 편집으로 대체하지 마세요.
+
+- [한국어 설치 안내](./INSTALL.ko.md)
+- [English installation guide](./INSTALL.md)
+- [中文安装指南](./INSTALL.zh.md)
+- [日本語インストールガイド](./INSTALL.ja.md)
+- [한국어 README](./README.ko.md)
+- [English README](./README.en.md)
+- [中文 README](./README.md)
+- [日本語 README](./README.ja.md)
+- [Changelog](./CHANGELOG.md)
+- [日本語 changelog](./CHANGELOG.ja.md)
+- [한국어 changelog](./CHANGELOG.ko.md)
+
+이 가이드의 자리표시자:
+
+- `<profile>`: 수정할 DSH profile. 보통 `web`;
+- `dsh-input-traffic`: npm 패키지 이름이자 런타임 플러그인 ID.
+
+## 0. 사전 확인과 profile 확인
+
+```bash
+echo "DSH_HOME=${DSH_HOME:-$HOME/.dsh}"
+dsh --version
+ls "${DSH_HOME:-$HOME/.dsh}/profiles"
+```
+
+실행 중인 DSH 프로세스가 사용하는 profile을 사용하세요. `web`이 일반적이지만 실제 `--profile` 인자가 우선합니다.
+
+## 1. 공식 설치
+
+최신 버전 설치:
+
+```bash
+dsh plugin --profile <profile> add dsh-input-traffic -w
+```
+
+(profile이 pnpm workspace root면 `-w`가 필요합니다. `web`이 그렇습니다.)
+
+현재 릴리스 명시적 설치:
+
+```bash
+dsh plugin --profile <profile> add dsh-input-traffic@0.2.9 -w
+```
+
+공식 CLI는 profile 의존성, 잠금 파일, `dsh.profile.bundles`를 자동으로 갱신합니다. 수동으로 YAML을 추가하지 마세요.
+
+### 공급망 쿨링 기간
+
+dsh 런타임은 pnpm 11을 사용하며 `minimumReleaseAge` 정책이 새로 게시된 버전을 `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`으로 차단할 수 있습니다. `~/.dsh/profiles/web/pnpm-workspace.yaml`의 `minimumReleaseAgeExclude`에 버전을 추가하세요:
+
+```yaml
+minimumReleaseAgeExclude:
+  - dsh-input-traffic@0.2.9
+```
+
+## 2. 업그레이드
+
+registry 최신 버전으로 업그레이드:
+
+```bash
+dsh plugin --profile <profile> update dsh-input-traffic -w
+```
+
+호스트 변경은 DSH 재시작, 브라우저 측은 웹 페이지 새로고침이 필요합니다.
+
+## 3. 로컬 경로 / link: 등록(대안)
+
+개발 또는 오프라인 설치에서는 로컬 체크아웃에서 등록할 수 있습니다:
+
+```bash
+#    ~/.dsh/profiles/web/package.json dependencies:
+#      "dsh-input-traffic": "link:<dsh-input-traffic 절대 경로>"
+#    ~/.dsh/profiles/web/cordis.patch.yml:
+#      - insert:
+#          - id: input-traffic
+#            name: dsh-input-traffic
+cd ~/.dsh/profiles/web && pnpm install && dsh web
+```
+
+또는 공식 CLI로 로컬 경로 추가(네트워크 불필요):
+
+```bash
+dsh plugin --profile <profile> add /dsh-input-traffic 절대 경로/ -w
+```
+
+## 4. 설치 검증
+
+의존성과 설치 버전 확인:
+
+```bash
+grep -n "dsh-input-traffic" \
+  "${DSH_HOME:-$HOME/.dsh}/profiles/<profile>/package.json"
+```
+
+공식 구성 확인:
+
+```bash
+dsh --profile <profile> --dump-default-config
+```
+
+다음이 포함되어야 합니다:
+
+```yaml
+- id: input-traffic
+  name: dsh-input-traffic
+```
+
+## 5. 플러그인 검증
+
+DSH를 재시작하고 웹 페이지를 새로고침하세요. 세션에서 다음을 확인:
+
+1. 대기 영역에 3단계 계획 dock이 표시됨;
+2. 컴포저 우측에 "세션 동결" 버튼이 표시됨;
+3. 공식 설정 패널의 "바쁜 동안 Enter 키 동작" 설정 행이 숨겨짐;
+4. 에이전트가 바쁠 때 메시지를 보내면 대기 영역에 빨간/노란/초록 계획 버튼과 함께 배치됨.
+
+## 일본어·한국어 지원 상태
+
+플러그인에는 `ja`와 `ko` 사전이 포함되어 있지만, 현재 공식 DSH 릴리스는 `LocaleRuntime`을 통해 `zh`와 `en`만 제공합니다. 순정 DSH에서 일본어 또는 한국어를 선택하면 `locale "<id>" is not registered` 오류가 발생합니다.
+
+공식 지원 전에 사용하려면 DSH 포크를 유지하며 업데이트하세요:
+
+- `packages/client/locale/src/locale-settings.ts`: `LOCALE_IDS`에 `ja`와 `ko` 추가.
+- `packages/client/locale/src/client/index.ts`: `LOCALES`에 `{ id: 'ja', label: '日本語' }`와 `{ id: 'ko', label: '한국어' }` 추가.
+- 해당 핵심 사전과 테스트를 추가하고 포크 버전을 다시 빌드하여 실행.
+
+플러그인만으로는 DSH의 전역 locale 목록을 확장할 수 없습니다.
+
+## 6. 트러블슈팅
+
+| 증상 | 조치 |
+| --- | --- |
+| `dsh`를 찾을 수 없음 | 공식 DSH CLI를 설치/활성화. |
+| `ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION` | profile의 `pnpm-workspace.yaml` `minimumReleaseAgeExclude`에 버전 추가. |
+| 플러그인이「비활성화/미마운트」이며 오류 없음 | profile 구성을 확인. |
+| client 항목이 `__DSH_BOOT__`에 없음 | `exports["./client"]`가 있고 host fiber가 생성되었는지 확인. |
+| 동결/재개 버튼이 작동하지 않음 | 세션급 잠금을 사용하는 경우 session-guard가 설치되어 있는지 확인. 미설치 시 fail-open으로 동작. |
+| 브라우저가 오래된 bundle 표시 | 업그레이드 후 하드 새로고침(Ctrl+Shift+R). |
+
+## 7. 제거
+
+공식 명령 사용:
+
+```bash
+dsh plugin --profile <profile> remove dsh-input-traffic
+```
+
+재시작 후 공식 대기열 dock과 "바쁜 동안 Enter 키 동작" 설정 행이 복원됩니다.

package/README.en.md

@@ -23,16 +23,13 @@
 - [日本語 changelog](./CHANGELOG.ja.md)
 - [한국어 changelog](./CHANGELOG.ko.md)
 
-> **▼ DSH version support** (**compat/0.2.0 line, since 0.6.0**)
-> This line supports **the DSH 0.2.0 series only** (`>=0.2.0-rc.1 <0.2.1-0`, npm dist-tag `dsh-0.2.0`).
+> **▼ DSH version support** (compat/0.1.5 line, since 0.2.12-beta.1)
 > | DSH version | Status | Notes |
 > | --- | --- | --- |
-> | ≥ 0.2.0-rc.1 and < 0.2.1-0 | ✅ Supported | Verified against 0.2.0-rc.1; the host peer gate enforces this window |
-> | 0.1.7 series | → Use the `dsh-0.1.7` dist-tag (0.5.3, maintained on the compat/0.1.7 branch) |
-> | 0.1.5 series | → Use the `dsh-0.1.5` dist-tag (0.2.12-beta.1) |
-> | < 0.2.0-rc.1 or ≥ 0.2.1-0 | ⚠️ Not supported | The host preflight rejects the install outright; re-adaptation required from 0.2.1 |
+> | ≥ 0.1.5-alpha.1 | ✅ Supported | Verified against 0.1.5-rc.1 / rc.2 (type contracts mirrored from dsh-v0.1.5-rc.2) |
+> | < 0.1.5-alpha.1 | ⚠️ Not supported | Stay on the `main` line (0.2.11-beta.1, DSH 0.1.2+) or older |
 >
-> - **0.2.0-rc.1 is fully API-compatible with 0.1.7** (manifest / settings seats / slot mechanics / session format V4 untouched); the service face (`send` / `cancel` / `updateQueue` / `input.setDraft` / `input.notify`) has no recorded break. This line is a **metadata retarget**: peer/engines ranges and a dependency tree refreshed against the 0.2.0 host, plus one real code change — `dsh-client-ui-primitives` 0.2.0 removed the `*14` / `*16` size-suffix icon exports in favor of `*Medium` (explicit `IconProps.size` pixels behave as before; rendered sizes are unaffected).
+> - **The boundary is 0.1.5**: Session V3 (surface nodes), the dockkit Sidebar rewrite, and the Lexical composer are 0.1.5's structural changes. All three slot anchors this plugin shadows (`conversation.input.dock` / `conversation.input.right` / `settings.general.item`) survive in 0.1.5, and the service face (`send` / `cancel` / `updateQueue` / `blocks.set`) has no recorded break — so the code needs zero structural changes; only the supported segment is narrowed.
 > - **Queue strip position**: registered with `order: 1000`, so it sorts after every known contributor of the `conversation.input.dock` band (todo 0 / goal 10 / official queue 20 / dsh-perm-gate notice 30) and sits directly on top of the composer card. DSH has no "last" slot semantics, so this is a convention rather than a structural guarantee — a third-party plugin registering a larger `order` could still land below it.
 
 > **▼ Known DSH 0.1.5 regressions (host-side, not plugin bugs)**
@@ -54,6 +51,11 @@ A cordis client plugin assembled via the `dsh plugin` command and a bundle patch
 >
 > **Suggested pairing for now**: use it together with a **reminder** plugin (e.g. [dsh-notify](https://github.com/zhengjy01/dsh-notify), desktop notifications when it is time to freeze/resume) and a **billing/usage** plugin (e.g. [dsh-deepseek-usage](https://github.com/yyb16yyb-hub/dsh-deepseek-usage), [dsh-cost-tracker](https://github.com/yflmq001/dsh-cost-tracker), [dsh-billing-balance](https://github.com/YZz-S/dsh-billing-balance), to verify actual spend around a freeze) — a "remind → freeze → resume off-peak → verify" saving loop.
 
+<!-- host-compat:begin — generated by scripts/sync-hosts.mjs from scripts/hosts.mjs; DO NOT EDIT -->
+- **Supported DSH hosts:** `0.1.0-rc.2` `0.1.0-rc.3` `0.1.0-rc.6` `0.1.0-rc.7` `0.1.0-rc.8` `0.1.1-rc.1` `0.1.1-rc.2` `0.1.2-rc.1` `0.1.5-rc.1` `0.1.5-rc.2` `0.1.5-rc.3` `0.1.7-rc.1` `0.1.7-rc.2` `0.2.0-rc.1` `0.2.0-rc.2` (15 rc releases across lines 0.1.0 / 0.1.1 / 0.1.2 / 0.1.5 / 0.1.7 / 0.2.0)
+- **Runtime-verified:** `0.1.0-rc.2`, `0.1.0-rc.3`, `0.1.0-rc.6`, `0.1.0-rc.7`, `0.1.0-rc.8`, `0.1.1-rc.1`, `0.1.1-rc.2`, `0.1.2-rc.1`, `0.1.5-rc.1`, `0.1.5-rc.2`, `0.1.5-rc.3`, `0.1.7-rc.1`, `0.1.7-rc.2`, `0.2.0-rc.1`, `0.2.0-rc.2` — evidence in `.compat-results/`
+<!-- host-compat:end -->
+
 ## What it does
 
 - **Three tiers coexist**: while the agent is busy, every input lands in a waiting area first, then you choose when it enters the conversation — no longer a single "interrupt" or a single "queue":