bizboost 6.4.13 → 6.6.2

package/README.md

@@ -1,11 +1,11 @@
-# bluelamp-neo
+# bluelamp
 
-BlueLamp Neo CLI — Claude Code 用 MCP セットアップ + 200 個の `bluelamp1` 〜 `bluelamp200` コマンドを提供する npm パッケージ。
+BlueLamp CLI — Claude Code 用 MCP セットアップ + 200 個の `bluelamp1` 〜 `bluelamp200` コマンドを提供する npm パッケージ。
 
 ## インストール (受講生向け)
 
 ```bash
-npm install -g bluelamp-neo
+npm install -g bluelamp
 ```
 
 インストール後、 `bluelamp1` 〜 `bluelamp200` のいずれかを実行すると Claude Code が起動し、 対応する slot の MCP 設定がロードされます。
@@ -69,7 +69,9 @@ cloud_proxy（portal 転送）では触れない **ローカル操作**（token
 
 別 npm パッケージも、ユーザーの設定編集も不要。これが「`npm install -g bluelamp` だけで MCP が増える」の実体。
 
-> **実装済み（Phase 151）**: 第1号が `lib/account-mcp/index.cjs`（MCP 名 `bluelamp-account`）。tool = `logout`（`~/.musuhi/portal-token.enc` を削除＝別アカウント切替の起点）/ `update_cli`（`npm i -g bluelamp@latest`）。`createMCPConfig()` に登録済み。効果はどちらも **次回 `bluelampN` 起動から**（起動中の gateway は起動時 token を保持するため in-session では切り替わらない）。
+> **実装済み（Phase 151）**: 第1号が `lib/account-mcp/index.cjs`（MCP 名 `bluelamp-account`）。tool = `logout`（`~/.musuhi/portal-token.enc` を削除＝別アカウント切替の起点）/ `update_cli`（`npm i -g bluelamp@latest`）。`createMCPConfig()` に登録済み。
+> `update_cli` の効果は **次回 `bluelampN` 起動から**（実行中のプロセスは差し替わらない）。`logout`／トークン差し替えが効くタイミングは**版で異なる**——6.6.0 までは次回起動から、板#341 N1 以降は gateway がトークンを毎回読み直すため**次の tool 呼び出しから**。
+> 📌 利用者向けの手順・失効時の復旧・罹患判定は `docs/support-knowledge/account-operations.md` が正本（ここには書き写さない）。
 
 ### `@bluelamp/mcp-shim` との違い
 
@@ -83,11 +85,11 @@ cloud_proxy（portal 転送）では触れない **ローカル操作**（token
 
 ```bash
 pnpm install                                                # workspace root で 1 回
-pnpm --filter bluelamp-neo run build:tsc                    # tsc emit のみ
-pnpm --filter bluelamp-neo run build                        # tsc emit → 難読化 (publish 用)
-pnpm --filter bluelamp-neo run tsc                          # 型チェックのみ
-pnpm --filter bluelamp-neo run test                         # node --test (auth + bin)
-pnpm --filter bluelamp-neo run generate:bins                # bin/bluelamp1-200.mjs 再生成
+pnpm --filter bluelamp run build:tsc                    # tsc emit のみ
+pnpm --filter bluelamp run build                        # tsc emit → 難読化 (publish 用)
+pnpm --filter bluelamp run tsc                          # 型チェックのみ
+pnpm --filter bluelamp run test                         # node --test (auth + bin)
+pnpm --filter bluelamp run generate:bins                # bin/bluelamp1-200.mjs 再生成
 ```
 
 ## ビルド出力
@@ -113,10 +115,19 @@ publish 対象は `dist/` + `README.md` のみ (`package.json files` で制限)
 | `bin/bluelamp-vscode-base` (CommonJS)            | `bin/bluelamp-vscode-base.mjs` (ESM)                  |
 | `bin/bluelamp1`〜200 (CommonJS)                  | `bin/bluelamp1.mjs`〜200 (ESM trampoline)             |
 | `scripts/generate-commands.js`                   | `scripts/generate-commands.ts` (`dist/scripts/...js`) |
-| `scripts/setup-mcps.js` (postinstall)            | `scripts/setup-mcps.ts` (**postinstall hook 無し**)   |
+| `scripts/setup-mcps.js` (postinstall)            | **廃止** (#358 で削除。理由は下記「`~/.mcp.json` を書かない」) |
 | `scripts/build.js` (354 行、 CJS)                | `scripts/build-obfuscate.mjs` (ESM、 同等難読化)     |
 
 ## 既知の制約
 
 - `bin/bluelamp-vscode-base.mjs` は内部で旧 `lib/mcp-server/portal-api-client.cjs` を `require` するが、 monorepo にはまだ移植されていないため **slot 設定の動的取得は無効**。 `DEFAULT_PROMPT_MAPPING` (18 個のデフォルト) にフォールバックする。
-- `setup-mcps.ts` は `~/.bluelamp/` / `~/.mcp.json` をユーザーホームに書き込むが、 `pnpm install` で自動実行されないよう **postinstall hook は意図的に外している**。 グローバル install で必要な場合は `node dist/scripts/setup-mcps.js` を手動実行する。
+## `~/.mcp.json` を書かない (postinstall 廃止の理由)
+
+**このパッケージは `~/.mcp.json` に定義を追加しない。** MCP は起動のたび launcher が一時 config を作って `--mcp-config` で渡す (上記「MCP 配布の仕組み」)。
+
+過去 (公開版 4.3.4〜6.4.1) は postinstall (`scripts/setup-mcps.js`) が `~/.mcp.json` を書き換えていたが、次の 2 つの実害を出したので廃止した (監査: 2026-07-30):
+
+1. 6.0.2〜6.4.1 が `bluelamp: {command: "bluelamp1"}` を書いていた。`bluelamp1` は MCP サーバーではなく launcher なので、素の `claude` から MCP として起動されると接続不能になる (`--mcp-config` が勝つ launcher 経由では症状が出ないため切り分けが極端に難しい)。→ 現在は launcher 起動時に **この 1 キーだけ** 自己修復で削除する (`src/lib/mcpJsonSelfHeal.ts`)。
+2. 4.3.4〜6.4.1 が `playwright` / `gmail` 等をキー名だけで無条件 delete していた。利用者が自分で登録した同名 MCP を黙って消しうる。
+
+**ルール: 今後 `~/.mcp.json` に触る処理を足す場合は、我々が書いた entry だと確認できるものだけを対象にする** (キー名一致だけで削除しない。他人の設定を消さない)。