@bluelamp/secret-exec 0.1.0

package/README.md

@@ -0,0 +1,41 @@
+# @bluelamp/secret-exec
+
+> 🔒 **これは値を返さない口です。**
+> 取れるのは「金庫にその名前が**在るか無いか**」と「値を**使えるか**（子プロセスが値を環境変数で受けて走れたか＝子の終了コード）」だけです。
+> 値を標準出力・標準エラー・戻り値・ファイル・コマンドの引数に出す口は、このパッケージには**ありません**。今後も作りません。
+> 値を見たい用途（表示・コピー・ファイルへの書き出し）には使えません。それは設計上の意図です。
+
+金庫（password-manager）に置いた値を、**子プロセスの環境変数にだけ**入れてコマンドを実行します。終了コードは子のものをそのまま返します。
+
+## 使い方
+
+```bash
+npm i -g @bluelamp/secret-exec
+
+bluelamp-secret exec <ENV名>=<金庫の名前> [<ENV名>=<金庫の名前> …] -- <コマンド> [引数…]
+
+# 例: 金庫の「my-db」を PGURL に入れて psql を撃つ（シェルの展開が要るときは sh -c で包む）
+bluelamp-secret exec PGURL=my-db -- sh -c 'psql "$PGURL" -c "select 1"'
+
+# 例: 2 つ入れて python を走らせる
+bluelamp-secret exec API_KEY=some-api DB_URL=some-db -- python3 job.py
+
+# 例: 在るか・使えるかだけを確かめる（値の長さが 0 でなければ 0 で終わる）
+bluelamp-secret exec X=my-db -- sh -c 'test -n "$X"'
+```
+
+- ログイン済みのトークン（`@bluelamp/cli-token` が読む `~/.musuhi/portal-token.enc`）で金庫を引きます。先に `bluelamp1` などでログインしてください。
+- 接続先は `BLUELAMP_PORTAL_API_BASE_URL` > `PORTAL_URL` > 既定（`https://api.motohi.jp/api/bluelamp`）の順です。
+- ENV 名は `^[A-Z_][A-Z0-9_]*$` の形だけ受けます。コマンドはシェルを通さずに起動します。
+- 1 つでも引けなければ（無い・権限なし・未ログイン）、子を起こさずに「ENV 名・金庫の名前・理由」だけを標準エラーへ出して非 0 で終わります。HTTP の本文や例外の文言は出しません。
+- 引いたことは金庫の監査に残ります（誰が・どの秘密を）。
+- ⚠️ 子のコマンドが自分で値を印字すれば、それは出ます（`echo "$PGURL"` のように書かない）。
+
+## 終了コード
+
+| コード | 意味 |
+|---|---|
+| 子の終了コード | 子が走った（シグナルで終わったときは 128+番号） |
+| 1 | 未ログイン・金庫に無い・権限なし・ポータルに届かない（子は起こさない） |
+| 2 | 引数の形が違う |
+| 127 | コマンドを起動できなかった |

package/bin/bluelamp-secret.mjs

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+/**
+ * bluelamp-secret — 金庫の値を子プロセスの環境変数にだけ入れてコマンドを走らせる（箱 n=2018 設計④′）。
+ *   bluelamp-secret exec <ENV名>=<金庫の名前> [...] -- <コマンド> [引数…]
+ * 🔒 値を返さない口: 値は stdout・stderr・戻り値・ファイルに出ない（README の冒頭・src/index.ts の頭注）。
+ * 判定と組み立ては dist/index.js（unit テスト済み）。ここは実物の網・トークン・子プロセス・シグナルを繋ぐだけ。
+ */
+import { spawn } from 'node:child_process';
+import { constants as osConstants } from 'node:os';
+import { tryReadCliToken } from '@bluelamp/cli-token';
+import { runSecretExec } from '../dist/index.js';
+
+// 端末の Ctrl-C は同じプロセスグループの子にも届く＝親は受け流して子の終了を待つ。
+// SIGTERM / SIGHUP は親だけに来うるので子へ回す。
+const FORWARDED = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+
+runSecretExec(process.argv.slice(2), {
+  env: process.env,
+  loadToken: () => tryReadCliToken(),
+  fetch: (url, init) => globalThis.fetch(url, init),
+  spawn: (command, args, options) => spawn(command, args, options),
+  stderr: (text) => process.stderr.write(text),
+  signalNumbers: osConstants.signals,
+  onParentSignal: (forward) => {
+    const handlers = FORWARDED.map((sig) => {
+      const h = () => {
+        if (sig !== 'SIGINT') forward(sig);
+      };
+      process.on(sig, h);
+      return [sig, h];
+    });
+    return () => handlers.forEach(([sig, h]) => process.off(sig, h));
+  },
+}).then(
+  (code) => process.exit(code),
+  () => {
+    // ⛔ 例外の文言は出さない（値や要求を引用しうる）
+    process.stderr.write('bluelamp-secret: 想定外の失敗で止まりました\n');
+    process.exit(1);
+  },
+);

package/dist/index.js

@@ -0,0 +1,218 @@
+/**
+ * @bluelamp/secret-exec — `bluelamp-secret exec`（箱 n=2018 設計④′）
+ *
+ * 🔒 これは「値を返さない口」である（実装より先に書いた線・README の冒頭と同じ）。
+ *   取れるのは「金庫にその名前が在るか無いか」と「値を使えるか（子プロセスが env で受けて走れたか＝終了コード）」だけ。
+ *   ⛔ 値を標準出力・標準エラー・戻り値・ファイル・argv・ログ・エラーの文言に出す口を作らない。
+ *   ⛔ 値を返す関数を export しない（呼び手に値を渡す API を足したくなったら、それはこのパッケージの仕事ではない）。
+ */
+/**
+ * 🕳 塞いでいる穴: MCP の `get_secret` は値を返り値にしていたため、値が会話の転写に残った。
+ *   その口を閉じると、値を Bash で使っていた手順（21 日で 235 回）が壊れる。⇒ 値を「見せずに使う」口をここに置く。
+ *
+ * 🔑 値の通り道は「金庫の HTTP 応答 → 子の env」の 1 本だけ。
+ *   ⛔ HTTP の本文・fetch の例外をそのまま出さない（本文は値を、例外は要求を引用しうる）。
+ *      失敗は「どの ENV 名・どの金庫の名前が・なぜ」だけを返す。
+ * 🔑 パッケージの外へ出す API は無い（package.json の exports は package.json だけ）。
+ *   下の export は同じパッケージの bin と unit テストのためのもの。値を返す関数は export しない（`extractSecretValue` は非公開）。`runSecretExec` の戻り値は終了コードだけ。
+ * 🔑 使用の記録: `GET /vault/:service` は backend 側で監査 `get`（誰が・どの秘密を）を 1 行書く。
+ *
+ * 判定と組み立ては純粋関数（unit で直接撃つ）、網と子プロセスは `runSecretExec` の deps に寄せる。
+ */
+/** ENV 名として受ける形。⛔ これ以外（小文字・記号・先頭数字）は受けない */
+export const ENV_NAME_PATTERN = /^[A-Z_][A-Z0-9_]*$/;
+/** 既定のポータル API（bluelamp CLI の portal-api-client・TokenManager と同じ値） */
+export const DEFAULT_PORTAL_API_BASE_URL = 'https://api.motohi.jp/api/bluelamp';
+export const USAGE = '使い方: bluelamp-secret exec <ENV名>=<金庫の名前> [<ENV名>=<金庫の名前> …] -- <コマンド> [引数…]\n' +
+    '  金庫の値を子プロセスの環境変数にだけ入れて <コマンド> を実行し、その終了コードで終わります。\n' +
+    '  値は画面・引数・ログに出ません。シェルの展開が要るときは -- sh -c \'psql "$PGURL" -c "select 1"\' のように渡します。\n';
+/** 引数を解析する（`process.argv.slice(2)` を受ける）。値はここに来ない＝金庫の名前だけ */
+export function parseExecArgs(argv) {
+    if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help' || argv[0] === 'help') {
+        return { ok: false, help: true, error: '' };
+    }
+    if (argv[0] !== 'exec') {
+        return { ok: false, help: false, error: `不明な操作です（受けるのは exec だけ）` };
+    }
+    const sep = argv.indexOf('--');
+    if (sep === -1) {
+        return { ok: false, help: false, error: '`--` の後に実行するコマンドを書いてください' };
+    }
+    const specs = argv.slice(1, sep);
+    const command = argv[sep + 1];
+    if (command === undefined || command === '') {
+        return { ok: false, help: false, error: '`--` の後に実行するコマンドがありません' };
+    }
+    if (specs.length === 0) {
+        return { ok: false, help: false, error: '<ENV名>=<金庫の名前> を 1 つ以上書いてください' };
+    }
+    const bindings = [];
+    const seen = new Set();
+    for (const spec of specs) {
+        const eq = spec.indexOf('=');
+        // ⛔ 失敗の文言に spec 全体を引用しない（名前の位置に値を書き間違えた場合に値が出るため）。ENV 名の側だけ出す。
+        if (eq <= 0) {
+            return { ok: false, help: false, error: `<ENV名>=<金庫の名前> の形ではない引数があります（${bindings.length + 1} 番目）` };
+        }
+        const env = spec.slice(0, eq);
+        const name = spec.slice(eq + 1);
+        if (!ENV_NAME_PATTERN.test(env)) {
+            return { ok: false, help: false, error: `ENV 名は ^[A-Z_][A-Z0-9_]*$ の形だけ受けます（${bindings.length + 1} 番目）` };
+        }
+        if (name === '') {
+            return { ok: false, help: false, error: `${env}: 金庫の名前が空です` };
+        }
+        // `.`／`..` は URL の区間として解決され、金庫の外の経路を指してしまう（%2E も URL 側で同じに扱われる）
+        if (name === '.' || name === '..') {
+            return { ok: false, help: false, error: `${env}: 金庫の名前に . / .. は使えません` };
+        }
+        if (seen.has(env)) {
+            return { ok: false, help: false, error: `${env}: 同じ ENV 名が 2 回あります` };
+        }
+        seen.add(env);
+        bindings.push({ env, name });
+    }
+    return { ok: true, bindings, command, args: argv.slice(sep + 2) };
+}
+/** 基底 URL（BLUELAMP_PORTAL_API_BASE_URL > PORTAL_URL > 既定。portal-api-client.cjs と同じ順） */
+export function resolvePortalApiBaseUrl(env) {
+    const base = env.BLUELAMP_PORTAL_API_BASE_URL || env.PORTAL_URL || DEFAULT_PORTAL_API_BASE_URL;
+    return base.replace(/\/+$/, '');
+}
+/**
+ * 金庫の 1 件を引く URL。
+ * 🔑 vault の sub-app は内部で `/api/vault/...` に経路を切るが、bluelamp module ごと `/api/bluelamp` に
+ *    載っているので外から見える経路は `<base>/vault/...`（base は /api/bluelamp まで含む）。
+ *    🔬 実測（無認証）: `/api/bluelamp/api/vault/x` → 404／`/api/bluelamp/vault/x` → 401。
+ *    mcp-list/bluelamp/playwright/src/fillSecret.ts の VAULT_FILL_PATH と同じ結論。
+ */
+export function buildVaultUrl(baseUrl, name) {
+    return `${baseUrl}/vault/${encodeURIComponent(name)}`;
+}
+/** 子の env を合成する（親を書き換えない） */
+export function composeChildEnv(parentEnv, values) {
+    const out = {};
+    for (const [k, v] of Object.entries(parentEnv))
+        if (typeof v === 'string')
+            out[k] = v;
+    for (const [k, v] of Object.entries(values))
+        out[k] = v;
+    return out;
+}
+/** 金庫の応答本文から値を取り出す。形が違えば null（⛔ 本文を呼び手へ返さない・値は runSecretExec の中で子の env へ渡すだけ） */
+function extractSecretValue(body) {
+    if (!body || typeof body !== 'object')
+        return null;
+    const b = body;
+    if (b.success !== true || !b.data || typeof b.data !== 'object')
+        return null;
+    return typeof b.data.secret === 'string' ? b.data.secret : null;
+}
+/** HTTP の状態を理由の文言にする（⛔ 本文は使わない） */
+export function describeVaultStatus(status) {
+    if (status === 401)
+        return '未ログインかトークンが無効です（bluelamp1 などでログインし直してください）';
+    if (status === 403)
+        return 'この秘密へのアクセス権がありません';
+    if (status === 404)
+        return '金庫に見つかりません';
+    return `金庫が HTTP ${status} を返しました`;
+}
+/** 子の終わり方を終了コードにする（シグナルは 128+番号＝シェルと同じ） */
+export function exitCodeOf(code, signal, signalNumbers) {
+    if (typeof code === 'number')
+        return code;
+    if (signal && typeof signalNumbers[signal] === 'number')
+        return 128 + signalNumbers[signal];
+    return 1;
+}
+const PREFIX = 'bluelamp-secret: ';
+/** 実行する。戻り値は終了コード */
+export async function runSecretExec(argv, deps) {
+    const parsed = parseExecArgs(argv);
+    if (!parsed.ok) {
+        if (parsed.help) {
+            deps.stderr(USAGE);
+            return argv.length === 0 ? 2 : 0;
+        }
+        deps.stderr(`${PREFIX}${parsed.error}\n${USAGE}`);
+        return 2;
+    }
+    const token = deps.loadToken();
+    if (!token) {
+        deps.stderr(`${PREFIX}未ログインです（bluelamp1 などでログインしてから撃ってください）\n`);
+        return 1;
+    }
+    const baseUrl = resolvePortalApiBaseUrl(deps.env);
+    const values = {};
+    // 🔑 全部そろってから子を起こす（一部だけ入った env で走らせない）
+    for (const { env, name } of parsed.bindings) {
+        let res;
+        try {
+            res = await deps.fetch(buildVaultUrl(baseUrl, name), {
+                method: 'GET',
+                headers: { 'X-CLI-Token': token, Accept: 'application/json', 'User-Agent': 'bluelamp-secret/1' },
+            });
+        }
+        catch {
+            // ⛔ 例外の文言は出さない（要求 URL・ヘッダを引用する実装がある）
+            deps.stderr(`${PREFIX}${env}=${name}: ポータルに届きませんでした\n`);
+            return 1;
+        }
+        if (!res.ok) {
+            deps.stderr(`${PREFIX}${env}=${name}: ${describeVaultStatus(res.status)}\n`);
+            return 1;
+        }
+        let body;
+        try {
+            body = await res.json();
+        }
+        catch {
+            deps.stderr(`${PREFIX}${env}=${name}: 金庫の応答を読めませんでした\n`);
+            return 1;
+        }
+        const value = extractSecretValue(body);
+        if (value === null) {
+            deps.stderr(`${PREFIX}${env}=${name}: 金庫の応答に値がありませんでした\n`);
+            return 1;
+        }
+        values[env] = value;
+    }
+    const childEnv = composeChildEnv(deps.env, values);
+    return new Promise((resolve) => {
+        let settled = false;
+        let detach = () => { };
+        const finish = (code) => {
+            if (settled)
+                return;
+            settled = true;
+            detach();
+            resolve(code);
+        };
+        let child;
+        try {
+            child = deps.spawn(parsed.command, parsed.args, { stdio: 'inherit', shell: false, env: childEnv });
+        }
+        catch (e) {
+            const code = e?.code;
+            deps.stderr(`${PREFIX}コマンドを起動できませんでした: ${parsed.command}${code ? `（${code}）` : ''}\n`);
+            finish(127);
+            return;
+        }
+        if (deps.onParentSignal) {
+            detach = deps.onParentSignal((signal) => {
+                try {
+                    child.kill(signal);
+                }
+                catch {
+                    // 既に終わっている
+                }
+            });
+        }
+        child.on('error', (err) => {
+            deps.stderr(`${PREFIX}コマンドを起動できませんでした: ${parsed.command}${err?.code ? `（${err.code}）` : ''}\n`);
+            finish(127);
+        });
+        child.on('exit', (code, signal) => finish(exitCodeOf(code, signal, deps.signalNumbers)));
+    });
+}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@bluelamp/secret-exec",
+  "version": "0.1.0",
+  "description": "金庫の値を子プロセスの環境変数にだけ入れてコマンドを実行する（値を返さない口）",
+  "keywords": [
+    "bluelamp",
+    "cli",
+    "secret"
+  ],
+  "license": "MIT",
+  "author": "BlueLamp <dev@bluelamp.app>",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "bluelamp-secret": "./bin/bluelamp-secret.mjs"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mikoto-co-jp/mikoto-monorepo.git",
+    "directory": "packages/secret-exec"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "tsc": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && node --test tests/*.test.mjs"
+  },
+  "dependencies": {
+    "@bluelamp/cli-token": "1.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}