sesame-kit 0.4.1 → 0.5.0

package/docs/ja/integration.md

@@ -0,0 +1,181 @@
+<!-- [English](../en/integration.md) | 日本語 -->
+
+# 他言語からの組み込み (`sesame serve`)
+
+> [English](../en/integration.md) · [ドキュメント目次](./index.md)
+
+`sesame serve` は常駐する JSON-RPC 2.0 デーモンです。一度サインインするとクラウド接続を維持し続け、操作の実行とイベントの配信を繰り返します。すべての機能を任意の言語から呼び出せます。
+
+## 1. サインインしてデーモンを起動
+
+デーモンは保存済みのログイン情報を使い、デーモン自身はサインインしません。CLI で一度サインインしてから、デーモンを起動します。
+
+```bash
+sesame login your@email.com && sesame verify   # if not already signed in
+sesame serve --http 8080                        # serve over HTTP on port 8080
+```
+
+デーモンは起動時にトークンを出力します（`~/.config/sesame-kit/serve.token` にも保存されます）。すべての HTTP リクエストは `Authorization: Bearer <token>` を送る必要があります。
+
+> 同一マシンでの利用なら、フラグなしの `sesame serve` は Unix ソケットで待ち受け、トークンは不要です。ここで HTTP を使うのは、任意の言語・任意のマシンから動作するためです。
+
+## 2. 最初の呼び出し — ライブラリのインストール不要
+
+HTTP 上の素の JSON-RPC です。POST できるものなら何でも動作します。
+
+```bash
+TOKEN=...   # the token printed by `sesame serve`
+
+curl -s -H "Authorization: Bearer $TOKEN" -H "content-type: application/json" \
+  -d '{"jsonrpc":"2.0","id":1,"method":"lock.unlock","params":{"name":"front"}}' \
+  http://127.0.0.1:8080/rpc
+```
+
+同じものを Python で、標準ライブラリだけで（pip install 不要）：
+
+```python
+import json, urllib.request
+
+TOKEN = "..."   # the token printed by `sesame serve`
+
+def rpc(method, params=None):
+    body = json.dumps({"jsonrpc": "2.0", "id": 1, "method": method, "params": params or {}}).encode()
+    req = urllib.request.Request("http://127.0.0.1:8080/rpc", data=body,
+        headers={"content-type": "application/json", "authorization": f"Bearer {TOKEN}"})
+    return json.load(urllib.request.urlopen(req))
+
+print(rpc("status"))
+print(rpc("lock.unlock", {"name": "front"}))
+```
+
+レスポンスは成功時に `{"jsonrpc":"2.0","id":1,"result": ...}`、失敗時に `{"jsonrpc":"2.0","id":1,"error":{"code","message","data":{"kind"}}}` です。
+
+## 3. メソッドと渡す値の調べ方
+
+`sesame rpc` は全メソッドとそのパラメータを一覧します（必須はそのまま、任意は `[brackets]` で表示）：
+
+```bash
+sesame rpc
+```
+
+```text
+lock.unlock                  [name] [deviceUUID] [secretKey]
+lock.status                  deviceUUID
+devices.list
+device.history               deviceUUID [pageSize]
+ir.send                      [remote] key
+org.getEmployees             companyID
+…
+79 methods.
+```
+
+この一覧から、使いたいメソッドの行を読みます。各行は `メソッド名  <必須> [任意]` の形です。例えば `device.history  deviceUUID [pageSize]` は、**`deviceUUID` が必須・`pageSize` が任意**という意味です。
+
+あとは各パラメータに**値**を入れるだけです。値の出所は 2 種類あります。
+
+- **ID 系**（`deviceUUID` / `companyID` など）は、別の一覧メソッドが返します。`deviceUUID` なら `devices.list` の結果から取ります：
+
+  ```bash
+  sesame rpc devices.list
+  # → [{"deviceUUID":"AB12CD34...","deviceName":"front", ...}, ...]
+  ```
+
+- **自分で決める値**（`pageSize` / `name` など）は、任意で好きな値を入れます。`pageSize` は取得件数です。
+
+決めた値を `--params` の JSON に入れて呼びます：
+
+```bash
+sesame rpc device.history --params '{"deviceUUID":"AB12CD34...","pageSize":10}'
+```
+
+ここで決めた**メソッド名と params が、そのまま任意のクライアントから送る内容**です（セクション2の `method` / `params` フィールドに対応します）。
+
+> ロック操作は `deviceUUID` の代わりに設定名も受け付けます。`{"name":"front"}` が `lock.unlock` / `lock.lock` / `lock.toggle` / `lock.click` で動きます（`lock.status` は `deviceUUID` を取ります）。
+
+正確なパラメータ型（例えばコード生成用）が必要なら、`sesame rpc --json rpc.discover` が完全な OpenRPC 文書を返します。各メソッドのエントリが param の型を持ちます：
+
+```json
+{
+  "name": "device.history",
+  "params": [
+    { "name": "deviceUUID", "required": true,  "schema": { "type": "string" } },
+    { "name": "pageSize",   "required": false, "schema": { "type": "number" } }
+  ]
+}
+```
+
+## 4. 同梱クライアント（任意）
+
+薄いクライアントが上記をラップし、JSON を手で組み立てる代わりに `c.unlock("front")` と書けます。任意であり、セクション 2 はこれらなしでも動作します。
+
+**Node** — `npm install sesame-kit` の後：
+
+```js
+import { SesameClient } from "sesame-kit/client";
+
+const c = SesameClient.unix();                          // default Unix socket
+console.log(await c.unlock("front"));                   // convenience method
+console.log(await c.call("device.history", { deviceUUID: "AB12CD34...", pageSize: 10 })); // any method
+console.log((await c.discover()).methods.map((m) => m.name));  // list methods from JS
+await c.subscribe(["lockState"], (topic, p) => console.log(topic, p)); // always await
+
+// const h = SesameClient.http("http://127.0.0.1:8080");   // token auto-read from serve.token
+// const w = await SesameClient.ws("ws://127.0.0.1:8081");  // npm i ws for header auth
+```
+
+**Python** — クライアントはパッケージに同梱される単一ファイルです：
+
+```bash
+pip install ./clients/python                       # from a cloned repo
+pip install "$(npm root -g)/sesame-kit/clients/python"   # from a global `npm install -g sesame-kit`
+```
+```python
+from sesame_client import SesameClient
+
+c = SesameClient.unix()                       # default Unix socket
+print(c.unlock("front"))                      # convenience method
+print(c.call("device.history", deviceUUID="AB12CD34...", pageSize=10))  # any method
+print(c.discover_names())                     # list methods from Python
+c.subscribe(["lockState"], lambda topic, payload: print(topic, payload))
+# HTTP: SesameClient.http("http://127.0.0.1:8080") / embedded: SesameClient.stdio()
+```
+
+## 経路（フレーミング）
+
+同じメソッドが 5 つの経路で利用できます。ネットワークアクセスには HTTP/WS/gRPC を、ローカルマシンには Unix ソケットまたは stdio を使います。
+
+| フレーミング | 用途 | イベント | 認証 |
+|---|---|---|---|
+| stdio | 組み込み（子プロセス） | `event.*` 通知 | 親プロセスの信頼を継承 |
+| Unix ソケット | ローカルデーモン、複数クライアント | `event.*` 通知 | ファイルパーミッション 0600 |
+| HTTP | 任意の言語 / ブラウザ | `GET /events`（SSE） | `Authorization: Bearer <token>` |
+| WebSocket | 任意の言語 / ブラウザ（全二重） | `event.*` 通知 | トークン |
+| gRPC | 多言語向けの型付きスタブ | `Subscribe` ストリーム | トークン（メタデータ） |
+
+gRPC は型付きです。`src/serve/sesame.proto` には op ごとに型付きメソッドがあります。スタブは
+`python -m grpc_tools.protoc -I src/serve --python_out=. --grpc_python_out=. src/serve/sesame.proto`
+で生成します。スカラー/配列パラメータは protobuf 型、動的パラメータは JSON 文字列フィールド、レスポンスは `JsonRpc{json}` です。型付きメソッドを持たない op は汎用の `Invoke` を使います。
+
+## イベント
+
+```jsonc
+// request (over Unix socket / WebSocket / stdio):
+{"jsonrpc":"2.0","id":1,"method":"events.subscribe","params":{"topics":["lockState","deviceUpdate"]}}
+// then notifications arrive (no id):
+{"jsonrpc":"2.0","method":"event.lockState","params":{ /* state */ }}
+```
+
+トピック：`lockState`、`deviceUpdate`。HTTP では `GET /events?topics=…`（SSE）を、gRPC では `Subscribe` ストリームを使います。`POST /rpc` と gRPC の `Invoke` はリクエスト/レスポンス専用で、`events.*` を拒否します。
+
+## エラー
+
+エラーは `{error:{code, message, data:{kind}}}` です。`kind` は次のいずれかです：
+`not_authenticated`（CLI でサインインしてからデーモンを再起動）/ `connection_lost`（クラウド接続が切断）/ `timeout` / `bad_params` / `not_implemented`（不明なメソッド）/ `internal`（それ以外。詳細は `message` に）。
+
+## 互換性
+
+結果の形はメソッド固有です。互換性を確認するには、コントラクトバージョンを読みます。`status` は `contractVersion` を返し、`rpc.discover` は `info["x-contractVersion"]` を返します。これは機械向けコントラクトの SemVer であり、互換性を壊す変更のみがメジャーを上げます。
+
+## セキュリティ境界
+
+対話的ログインは CLI 専用で、デーモン内では決して実行されません。Unix ソケットは同一ユーザーの任意のプロセスから使えます（CLI と同じ境界）。HTTP / WS / gRPC は TCP 上であり、起動時に生成されるループバックトークンを要求します。これらは平文（TLS なし）であり、ループバックでのみ公開するか、SSH / TLS リバースプロキシ経由でトンネルします。POSIX のみ対応です（Windows UDS は対象外。stdio / HTTP / WS / gRPC は動作します）。

package/docs/{library.ja.md → ja/library.md}

@@ -1,12 +1,12 @@
-<!-- [English](./library.md) | 日本語 -->
+<!-- [English](../en/library.md) | 日本語 -->
 
 # ライブラリとして使う
 
-> English: [library.md](./library.md)
+> [English](../en/library.md) · [ドキュメント目次](./index.md)
 
-`sesame` CLI と同じ機能を Node.js から直接呼べる。他言語から使うなら [`sesame serve`](../README.ja.md#言語非依存バックエンド-sesame-serve) を、Node 内で使うならこちら。
+`sesame` CLI と同じ機能を Node.js から直接呼べます。他言語から使うなら [`sesame serve`](../../README.ja.md#言語非依存バックエンド-sesame-serve) を、Node 内で使うならこちら。
 
-## 一番楽な形: `use()` ヘルパ (auto connect/close)
+## `use()` ヘルパ (auto connect/close)
 
 ```js
 import { SesameHub3 } from "sesame-kit";
@@ -53,10 +53,11 @@ await SesameHub3.use(async (hub) => {
   await hub.lockDevice({ deviceUUID, secretKey });
   await hub.toggleDevice({ deviceUUID, secretKey });
   await hub.botClickDevice({ deviceUUID, secretKey });
-  await hub.triggerLockDevice({ deviceUUID, secretKey, cmd: 83 });   // 任意 cmd
+  await hub.triggerLockDevice({ deviceUUID, secretKey, cmd: 83 });   // 生 itemCode: 83=解錠, 82=施錠, 88=トグル, 89=クリック
 
   // IR
   await hub.sendIRDirect({
+    // irType はリモコン種別: 49152 (0xC000)=エアコン, 8192=TV, 32768=扇風機, 57344=照明
     hub3DeviceId, irDeviceUUID, irType: 49152, command: keyUUID, operation: "learnEmit",
   });
   const keys = await hub.getIRCodesDirect({ hub3DeviceId, irDeviceUUID });

package/docs/ja/migration.md

@@ -0,0 +1,13 @@
+<!-- [English](../en/migration.md) | 日本語 -->
+
+# 旧版からのマイグレーション
+
+> [English](../en/migration.md) · [ドキュメント目次](./index.md)
+
+旧 `sesame-hub3` (CLI=`hub3-ir`) からのアップグレード:
+
+- CLI 名は `sesame` に変更 (旧 `hub3-ir` は廃止)。シェルスクリプトを使っている場合は置換。
+- 設定とトークンは `~/.config/sesame-kit` に保存されます。
+- config は単一の `devices` マップに保存されます。`locks` は読み込み時に毎回再構築される派生 view で、保存されるキーではありません。`sesame locks sync-from-devices` でサーバから `devices` を取り込みます。
+
+旧 `.env + .tokens.json + keys.json` からの移行は `sesame migrate` がそのまま使えます。

package/docs/ja/quickstart.md

@@ -0,0 +1,51 @@
+<!-- [English](../en/quickstart.md) | 日本語 -->
+
+# クイックスタート
+
+> [English](../en/quickstart.md) · [ドキュメント目次](./index.md)
+
+数分でコマンドラインからロックを開けます。
+
+## 1. インストール
+
+```bash
+npm install -g sesame-kit     # グローバル CLI: `sesame ...`
+# インストールせず実行: npx sesame-kit ...
+```
+
+Node.js 18 以上が必要です。
+
+## 2. サインイン
+
+```bash
+sesame init                 # ~/.config/sesame-kit/ を作成 (初回のみ)
+sesame login your@email.com # 確認コードがメールに届く
+sesame verify               # コードを入力
+```
+
+`verify` がデバイスを鍵ごと自動で取り込むので、直後から操作できます。
+
+## 3. ロックを操作する
+
+`sesame` を引数なしで実行すると対話メニューが表示され、デバイスと各デバイスで使える操作が一覧されます。
+
+```bash
+sesame      # ↑↓ 移動 · →（または Enter）決定 · ←（または Esc）戻る · q 終了
+```
+
+やりたいことが決まっていれば直接実行することもできます。主語はデバイスです: `sesame <device> <action>`（部分一致）。
+
+```bash
+sesame front status            # 現在状態 (施錠 / 解錠)
+sesame front unlock            # 解錠
+sesame front lock              # 施錠
+```
+
+## 次のステップ
+
+- CLI の全コマンド: [CLI リファレンス](./commands.md)
+- クラウドを介さず Bluetooth で操作する: [BLE 直接制御](./ble.md)
+- 他言語から呼び出す: [`sesame serve` 連携](./integration.md)
+- Node コードから使う: [Node ライブラリ](./library.md)
+
+> クラウド制御にはサインインが必要です。BLE 単独の制御はサインインなしで動作します — [BLE 直接制御](./ble.md)を参照。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sesame-kit",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "SESAME cloud CLI & library (lock control + Hub3 IR + device management). Node.js port of biz3 React app with the Cognito consumer client swapped in for long-lived sessions.",
   "author": "Ikuma Fukumoto",
   "license": "MIT",
@@ -43,6 +43,9 @@
     "./devices": {
       "types": "./types/devices.d.ts",
       "default": "./src/devices.js"
+    },
+    "./client": {
+      "default": "./clients/js/sesame-client.mjs"
     }
   },
   "bin": {
@@ -85,7 +88,8 @@
     "build:rpc-schema": "node scripts/gen-rpc-schema.mjs",
     "build:grpc-proto": "node scripts/gen-grpc-proto.mjs",
     "build": "tsc -p tsconfig.json && node scripts/gen-rpc-schema.mjs && node scripts/gen-grpc-proto.mjs",
-    "prepack": "tsc -p tsconfig.json && node scripts/gen-rpc-schema.mjs && node scripts/gen-grpc-proto.mjs"
+    "prepack": "tsc -p tsconfig.json && node scripts/gen-rpc-schema.mjs && node scripts/gen-grpc-proto.mjs",
+    "release": "bash scripts/release.sh"
   },
   "dependencies": {
     "@aws-sdk/client-cognito-identity-provider": "^3.1057.0",

package/src/cli/serve.js

@@ -65,7 +65,7 @@ export function registerServeCommand(program) {
   program.command("serve")
     .description("常駐 JSON-RPC バックエンド (stdio/UDS/HTTP/WS/gRPC で全機能を他言語へ公開)")
     .option("--stdio", "stdin/stdout で NDJSON JSON-RPC (埋め込み: 親が子プロセスとして spawn)")
-    .option("--socket [path]", "Unix domain socket (省略時 ~/.config/sesame-hub3/sesame.sock)")
+    .option("--socket [path]", "Unix domain socket (省略時 ~/.config/sesame-kit/sesame.sock)")
     .option("--no-socket", "UDS を無効化")
     .option("--http [port]", `HTTP(+SSE) を listen (既定 ${DEF.http})`)
     .option("--ws [port]", `WebSocket を listen (既定 ${DEF.ws})`)

package/src/cli.js

@@ -198,7 +198,7 @@ async function pickLockName(program, configStore, current) {
   if (current) return current;
   const cfg = configStore.load();
   const names = Object.keys(cfg.locks || {});
-  if (names.length === 0) die("ロックが未登録です。`sesame lock add` か `sesame lock sync-from-devices` を実行してください。", 2);
+  if (names.length === 0) die("ロックが未登録です。`sesame locks add` か `sesame locks sync-from-devices` を実行してください。", 2);
   if (names.length === 1) return names[0];
   if (!canPrompt(program)) return null;
   return selectFromList("どのロック?", names, (n) => {
@@ -459,7 +459,7 @@ async function cmdInit(_opts, program) {
     console.log(``);
     console.log(`次のステップ (所要 約3分):`);
     console.log(`  1. sesame login <email>             # email に確認コードが届く → sesame verify <code>`);
-    console.log(`  2a. ロックを使うなら:  sesame lock sync-from-devices     # 自動取り込み`);
+    console.log(`  2a. ロックを使うなら:  sesame locks sync-from-devices    # 自動取り込み`);
     console.log(`  2b. Hub3 IR を使うなら: sesame remote sync-from-devices   # Hub3+リモコン+キーを一括取得`);
     console.log(``);
     console.log(`概念: Hub3=IR を飛ばす中継器 / remote=リモコン定義 / lock=施錠デバイス。`);
@@ -1010,7 +1010,7 @@ async function resolveLockEntry(program, name) {
 
 /**
  * 単発コマンドの経路を決定する。
- *   - 既定 (全部モード): 能力フル。経路はツールが自動選択する。BLE はスキャン/接続のオーバーヘッドが
+ *   - 既定 (オート): 能力フル。経路はツールが自動選択する。BLE はスキャン/接続のオーバーヘッドが
  *     あるため毎回は張らず、cloud で運べる op は cloud、cloud で運べない op (autolock など BLE 必須)
  *     のみ BLE で一時接続する (cloud が速いという意味ではなく、BLE の接続コストを毎回払わないため)。
  *   - `--ble-only` / `--cloud-only`: 経路を固定したいときの明示指定 (最優先)。
@@ -1029,7 +1029,7 @@ function pickTransport(op, options, model) {
     if (!allowed.includes("cloud")) { die(`${op} はクラウドでは実機に反映されません (BLE 必須)。--ble-only か無指定で。`, 2); }
     return "cloud";
   }
-  // 全部モード: cloud で運べるなら cloud (BLE の接続コストを避けるため)。cloud 不可な op (autolock) のみ BLE。
+  // オート: cloud で運べるなら cloud (BLE の接続コストを避けるため)。cloud 不可な op (autolock) のみ BLE。
   return allowed.includes("cloud") ? "cloud" : "ble";
 }
 
@@ -1300,7 +1300,7 @@ async function cmdSession(names, options, program) {
 
   let blePromise = null;
   if (loggedIn) {
-    // 全部モードのアプリ的挙動: クラウドでメニューを即表示し、BLE は **バックグラウンド** で接続する
+    // オートのアプリ的挙動: クラウドでメニューを即表示し、BLE は **バックグラウンド** で接続する
     // (繋がったデバイスは次の描画で ·BLE に昇格し、以降 BLE 優先)。起動を BLE スキャンで待たせない。
     if (lockTargets.length) console.error("[ble] バックグラウンドで接続中... (クラウドで操作可能)");
     blePromise = connectBle();
@@ -1347,7 +1347,7 @@ const DEVICE_ACTIONS = new Set(["unlock", "lock", "toggle", "click", "status", "
  * デバイス主語の実行: `sesame <device> [action] [args]`。
  *   - action 省略 + TTY → そのデバイス (複数可) の対話セッション。
  *   - action 省略 + 非対話 → status を表示。
- *   - action 指定 → 1 発実行 (cmdAct に委譲。経路は全部モードで自動)。
+ *   - action 指定 → 1 発実行 (cmdAct に委譲。経路はオートで自動)。
  */
 async function cmdDeviceOp(device, action, args, options, program) {
   if (!action) {
@@ -1512,7 +1512,7 @@ export async function run(argv = process.argv) {
     // この前に設定すると後で追加する全サブコマンドへ継承される。--json 時は writeErr 側で抑止。
     .showHelpAfterError()
     .showSuggestionAfterError()
-    .option("--config-dir <path>", "設定ディレクトリ上書き (default: ~/.config/sesame-hub3)")
+    .option("--config-dir <path>", "設定ディレクトリ上書き (default: ~/.config/sesame-kit)")
     .option("--debug", "詳細ログ")
     .option("--json", "JSON 出力");
 
@@ -1615,7 +1615,7 @@ devices だけで完結します (手入力は呼び名のみ):
   // ---------- デバイス主語の実行 (sesame <device> [action]) ----------
   // 主語はデバイス。`sesame front unlock` = front.unlock() 相当 (SDK の device.method() と同じ)。
   // action 省略は対話メニュー (= そのデバイスの session)。引数なし `sesame` は全デバイスの session。
-  // 経路は既定「全部モード」(能力フル・自動。BLE 必須 op のみ BLE)。固定は --ble-only / --cloud-only。
+  // 経路は既定「オート」(能力フル・自動。BLE 必須 op のみ BLE)。固定は --ble-only / --cloud-only。
   // 例: sesame front unlock / sesame kitchen click / sesame front autolock 30 / sesame front --ble-only
   //
   // 実体は隠し op コマンド。先頭トークンが既知コマンドでなければ run() がここへ振り分ける。
@@ -1755,9 +1755,11 @@ devices だけで完結します (手入力は呼び名のみ):
     // BLE 権限/電源エラーは macOS なら該当設定ペインを自動で開いて誘導する。
     if (maybeHandleBleError(err)) { finishCli(); return; }
     const code = (typeof err.exitCode === "number" && err.exitCode !== 0) ? err.exitCode : 1;
-    // commander の usage エラーは非 JSON 時すでに stderr へ整形済み (usage 付き) なので二重出力を避ける。
-    if (typeof err.code === "string" && err.code.startsWith("commander.") && !CLI_JSON) {
-      process.exitCode = code; finishCli(); return;
+    // commander の usage エラー。非 JSON 時は commander が stderr に整形済み (usage 付き) なので二重出力を避ける。
+    if (typeof err.code === "string" && err.code.startsWith("commander.")) {
+      if (!CLI_JSON) { process.exitCode = code; finishCli(); return; }
+      // --json: commander のメッセージ先頭 "error: " を剥がして封筒に載せる (error が二重にならないように)。
+      die((err.message || "usage error").replace(/^error:\s*/i, ""), code); return;
     }
     die(withStaleHint(err.message || String(err)), code);
   }
@@ -1814,6 +1816,6 @@ function withStaleHint(msg) {
     /not found/i.test(m) ||
     /invalid.*device/i.test(m);
   if (!looksStale) return m;
-  return `${m}\nヒント: ローカル config が古い可能性があります。\n  IR キー: sesame remote sync-keys [name]\n  ロック/Hub3: sesame lock sync-from-devices / sesame hub3 sync-from-devices`;
+  return `${m}\nヒント: ローカル config が古い可能性があります。\n  IR キー: sesame remote sync-keys [name]\n  ロック/Hub3: sesame locks sync-from-devices / sesame hub3 sync-from-devices`;
 }
 

package/src/client.js

@@ -2,7 +2,7 @@
 // 低レベル WS (Hub3WsClient) とトークン管理 / 設定解決を内部で抱える。
 //
 // 使い方:
-//   const hub = await SesameHub3.fromConfig();   // ~/.config/sesame-hub3 から
+//   const hub = await SesameHub3.fromConfig();   // ~/.config/sesame-kit から
 //   await hub.connect();
 //   await hub.send("ac", "停止");                  // (remote名, キー名 or keyUUID)
 //   await hub.close();
@@ -65,7 +65,7 @@ const UUID_RE = /^[0-9a-fA-F-]{32,}$/;
 
 export class SesameHub3 {
   /**
-   * 既定の設定ディレクトリ (~/.config/sesame-hub3 等) から読み込んで構築。
+   * 既定の設定ディレクトリ (~/.config/sesame-kit 等) から読み込んで構築。
    * CLI 内部はこのファクトリを使う。
    * @param {{ configDir?: string, debug?: boolean }} [opts]
    */

package/src/config.js

@@ -135,7 +135,7 @@ export class ConfigStore {
     // mode 0600 で保存する (Review M-5)。
     // 注: POSIX 専用。Windows では mode は read-only flag になる程度。
     // 既存ディレクトリの mode は変更されない (新規作成時のみ反映) ので、
-    // 旧バージョンで作られた場合は手動で `chmod 700 ~/.config/sesame-hub3` が必要。
+    // 旧バージョンで作られた場合は手動で `chmod 700 ~/.config/sesame-kit` が必要。
     mkdirSync(dirname(this.configPath), { recursive: true, mode: 0o700 });
     writeFileSync(this.configPath, JSON.stringify(persist, null, 2) + "\n", { mode: 0o600 });
   }

package/src/paths.js

@@ -1,16 +1,16 @@
 // 設定ディレクトリ解決。優先順位:
 //   1. 明示渡し (overrideDir, CLI --config-dir)
-//   2. env SESAME_HUB3_HOME (アプリ専用)
-//   3. env XDG_CONFIG_HOME → $XDG_CONFIG_HOME/sesame-hub3
-//   4. ~/.config/sesame-hub3
+//   2. env SESAME_KIT_HOME (アプリ専用)
+//   3. env XDG_CONFIG_HOME → $XDG_CONFIG_HOME/sesame-kit
+//   4. ~/.config/sesame-kit
 import { homedir } from "node:os";
 import { resolve } from "node:path";
 
-const APP_DIRNAME = "sesame-hub3";
+const APP_DIRNAME = "sesame-kit";
 
 export function resolveConfigDir(overrideDir) {
   if (overrideDir) return resolve(overrideDir);
-  if (process.env.SESAME_HUB3_HOME) return resolve(process.env.SESAME_HUB3_HOME);
+  if (process.env.SESAME_KIT_HOME) return resolve(process.env.SESAME_KIT_HOME);
   const xdg = process.env.XDG_CONFIG_HOME;
   if (xdg) return resolve(xdg, APP_DIRNAME);
   return resolve(homedir(), ".config", APP_DIRNAME);