bluelamp 6.4.16 → 6.5.0

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 設定がロードされます。
@@ -83,11 +83,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 +113,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 だと確認できるものだけを対象にする** (キー名一致だけで削除しない。他人の設定を消さない)。