@bluelamp/cli-token 1.3.0-rc.0 → 1.4.0-rc.0

package/README.md

@@ -30,6 +30,17 @@ const maybe = tryReadCliToken();
 | 艦隊の資格の門（1.1.0・n=2607） | `checkFleetGate` / `isAllowedForScope` / `getFleetEntitlementFilePath` / `getFleetGateLogPath` / `formatFleetGateLogLine` / `fleetGateRefusalMessage` / `parseFleetEntitlementCache` / `isFleetEntitlementFresh` |
 | 交換済み JWT の機体共有キャッシュ（1.2.0・n=2774） | `getExchangedJwt` / `evictExchangedJwt` / `exchangedJwtCacheKey` / `getExchangedJwtCacheDir` / `parseCachedExchangedJwt` / `isCachedExchangedJwtUsable` |
 | 機体の鍵・登録・札の延長（1.3.0・n=3918） | `startDeviceRegistration` / `pollDeviceRegistration` / `awaitDeviceApproval` / `saveApprovedDevice` / `loadOrCreateDeviceKey` / `readDeviceKey` / `signWithDeviceKey` / `devicePollMessage` / `tokenRefreshMessage` / `readDeviceId` / `saveDeviceId` / `ensureFreshCliToken` / `readFreshCliToken` / `needsRefresh` / `parseExpiresAt` |
+| 発火の前の CLI の更新（1.4.0・n=4082・`@bluelamp/cli-token/cli-update`） | `updateCliToMin` / `fetchMinCliVersion` / `runNpmBesideNode` / `readPackageVersion` / `describeCliUpdate` / `isOlderThan` / `selfUpdatePackage` / `selfUpdateExecArgs` / `parseSelfUpdateLine` |
+
+### 発火の前の CLI の更新（`@bluelamp/cli-token/cli-update`・1.4.0）
+
+定期便（routine・scheduler）が席を立てる前に、席が使う BlueLamp CLI を最低版（`GET {bluelamp}/cli/min-version`）へ上げる**単一実装**（箱 n=4076 → n=4082）。
+launchd の発火は PATH が `/usr/bin:/bin` だけで、6.7.2 以前の起動子は素の npm を見つけられず自己更新に失敗する。
+
+- どの CLI を上げるかは呼び出し側が `locate`（package の dir と版）で渡す。routine＝gateway の package／scheduler＝起動子の package
+- 古いときだけ node の隣の npm で `npm exec --yes --package=bluelamp@max(min,6.7.3) -- bluelamp-self-update --root <dir> --min <min>`（置き場の選び方は CLI の入口が持つ＝ここは二重に作らない）
+- 撃った後は `locate` を引き直して版を読む（入口の `ok` を鵜呑みにしない）。throw しない＝上げられなくても便は今の版で走る
+- 別の subpath にしてあるのは、トークンだけを使う消費側（VS Code 拡張の bundle）に child_process を引き込まないため
 
 ### 艦隊の資格の門（`checkFleetGate`）
 

package/dist/cjs/cli-update.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * 発火の前に BlueLamp CLI を最低版へ上げる——routine と scheduler の**単一実装**（箱 n=4076 → n=4082 で共用へ）。
+ *
+ * 定期便（routine・scheduler）は launchd から起きる＝PATH が /usr/bin:/bin だけ。6.7.2 以前の起動子は
+ * そこで素の npm を見つけられず自己更新に失敗し、古い gateway のまま load_knowledge を撃ち続ける（n=4058・n=4072）。
+ * ⇒ 席を立てる前に `/cli/min-version` と比べ、古いときだけ node の隣の npm で新しい版の入口を借りて上げる。
+ *
+ * ⛔ 置き場の選び方・npm の撃ち方は CLI の `bluelamp-self-update`（n=4072・selfUpdate.ts）が持つ。ここは二重に作らない。
+ *    ここがするのは「古いかを測る」と「新しい版の入口を npm exec で借りて撃つ」だけ（古い版には入口が無い）。
+ * 「どの CLI を上げるか」は呼び出し側が locate で渡す（routine＝gateway の package／scheduler＝起動子の package）。
+ *
+ * 制約は index.ts と同じ: node 標準モジュール以外に依存しない・console に出さない・throw しない（結果は CliUpdate で返す）。
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SELF_UPDATE_TIMEOUT_MS = exports.MIN_VERSION_TIMEOUT_MS = exports.SELF_UPDATE_DONE_ENV = exports.SELF_UPDATE_PACKAGE_ENV = exports.SELF_UPDATE_SINCE = exports.SELF_UPDATE_BIN = void 0;
+exports.isOlderThan = isOlderThan;
+exports.selfUpdatePackage = selfUpdatePackage;
+exports.selfUpdateExecArgs = selfUpdateExecArgs;
+exports.parseSelfUpdateLine = parseSelfUpdateLine;
+exports.describeCliUpdate = describeCliUpdate;
+exports.readPackageVersion = readPackageVersion;
+exports.fetchMinCliVersion = fetchMinCliVersion;
+exports.runNpmBesideNode = runNpmBesideNode;
+exports.updateCliToMin = updateCliToMin;
+const node_child_process_1 = require("node:child_process");
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+/** CLI の更新だけの入口（n=4072） */
+exports.SELF_UPDATE_BIN = 'bluelamp-self-update';
+/** 入口が入った最初の版。min がこれより低くても、入口はこの版から借りる */
+exports.SELF_UPDATE_SINCE = '6.7.3';
+/** 入口を借りる package を上書きする env（rc を撃つ検体のため。例 bluelamp@6.7.3-rc.1） */
+exports.SELF_UPDATE_PACKAGE_ENV = 'BLUELAMP_SELF_UPDATE_PACKAGE';
+/** 起動子が子へ渡す「もう上げた」の印（n=4072）。npm の子へは渡さない */
+exports.SELF_UPDATE_DONE_ENV = 'BLUELAMP_SELFUPDATE_DONE';
+exports.MIN_VERSION_TIMEOUT_MS = 2500;
+/** npm exec（入口の取得＋npm install）を待つ上限 */
+exports.SELF_UPDATE_TIMEOUT_MS = 180_000;
+/** 版の比較（a < b）。起動子の isOlderThan と同じ数え方（数字以外は 0） */
+function isOlderThan(a, b) {
+    const parse = (v) => String(v)
+        .trim()
+        .split('.')
+        .map((p) => {
+        const n = parseInt(p, 10);
+        return Number.isFinite(n) ? n : 0;
+    });
+    const pa = parse(a);
+    const pb = parse(b);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const x = pa[i] ?? 0;
+        const y = pb[i] ?? 0;
+        if (x !== y)
+            return x < y;
+    }
+    return false;
+}
+/** 入口を借りる package（env の上書き＞max(min, 入口の版)） */
+function selfUpdatePackage(minVersion, override) {
+    if (override && override.trim())
+        return override.trim();
+    return `bluelamp@${isOlderThan(minVersion, exports.SELF_UPDATE_SINCE) ? exports.SELF_UPDATE_SINCE : minVersion}`;
+}
+/** `npm` に渡す引数（⛔ @latest にしない・入れる版は --min で名指し） */
+function selfUpdateExecArgs(pkg, root, minVersion) {
+    return ['exec', '--yes', `--package=${pkg}`, '--', exports.SELF_UPDATE_BIN, '--root', root, '--min', minVersion];
+}
+/** 入口の stdout の最後の JSON 行（npm の出力が混じっても拾う）。無ければ null */
+function parseSelfUpdateLine(stdout) {
+    const lines = stdout.split(/\r?\n/).map((l) => l.trim()).filter(Boolean).reverse();
+    for (const line of lines) {
+        if (!line.startsWith('{'))
+            continue;
+        try {
+            const v = JSON.parse(line);
+            if (typeof v.ok !== 'boolean')
+                continue;
+            const str = (k) => (typeof v[k] === 'string' ? v[k] : undefined);
+            return {
+                ok: v.ok,
+                ...(str('from') ? { from: str('from') } : {}),
+                ...(str('to') ? { to: str('to') } : {}),
+                ...(str('root') ? { root: str('root') } : {}),
+                ...(str('reason') ? { reason: str('reason') } : {}),
+            };
+        }
+        catch {
+            // 次の行へ
+        }
+    }
+    return null;
+}
+/** 記録の行に足す括弧の中（current・skipped は何も足さない） */
+function describeCliUpdate(u) {
+    switch (u.kind) {
+        case 'updated':
+            return `CLI ${u.from}→${u.to}`;
+        case 'failed':
+            return `CLI の更新に失敗: ${u.reason}・${u.from} のまま（最低版 ${u.want}）`;
+        default:
+            return null;
+    }
+}
+/** package の dir の package.json の版（読めなければ null） */
+function readPackageVersion(root) {
+    try {
+        const v = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf-8')).version;
+        return typeof v === 'string' && v.trim() ? v.trim() : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** `<base>/cli/min-version` の最低版（base は `/api/bluelamp` 付き）。引けなければ null・throw しない */
+async function fetchMinCliVersion(base, fetchFn = fetch, timeoutMs = exports.MIN_VERSION_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetchFn(`${base.replace(/\/+$/, '')}/cli/min-version`, { signal: controller.signal });
+        if (!res.ok)
+            return null;
+        const v = (await res.json())?.data?.min_cli_version;
+        return typeof v === 'string' && v.trim() ? v.trim() : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * node の隣の npm で撃つ（launchd の発火は PATH が /usr/bin:/bin だけ＝素の npm は ENOENT）。
+ * Windows の npm.cmd は shell 経由でないと spawn できない。cwd は home（作業フォルダの package.json を拾わない）
+ */
+function runNpmBesideNode(args, nodePath = process.execPath) {
+    const dir = path.dirname(nodePath);
+    const win = process.platform === 'win32';
+    const beside = path.join(dir, win ? 'npm.cmd' : 'npm');
+    const bin = fs.existsSync(beside) ? beside : win ? 'npm.cmd' : 'npm';
+    const env = { ...process.env, PATH: process.env.PATH ? `${dir}${path.delimiter}${process.env.PATH}` : dir };
+    delete env[exports.SELF_UPDATE_DONE_ENV];
+    return new Promise((resolve) => {
+        (0, node_child_process_1.execFile)(win && bin.includes(' ') ? `"${bin}"` : bin, args, { cwd: os.homedir(), env, timeout: exports.SELF_UPDATE_TIMEOUT_MS, maxBuffer: 4 * 1024 * 1024, shell: win }, (err, stdout) => {
+            const e = err;
+            if (!e)
+                return resolve({ code: 0, stdout: String(stdout) });
+            const error = e.killed ? `時間切れ（${exports.SELF_UPDATE_TIMEOUT_MS / 1000} 秒）` : typeof e.code === 'string' ? e.code : undefined;
+            resolve({ code: typeof e.code === 'number' ? e.code : null, stdout: String(stdout ?? ''), ...(error ? { error } : {}) });
+        });
+    });
+}
+/**
+ * 席を立てる前に、locate が指す CLI を最低版へ上げる。throw しない＝上げられなくても便は今の版で走る。
+ */
+async function updateCliToMin(deps) {
+    try {
+        const cli = deps.locate();
+        if (!cli)
+            return { kind: 'skipped', reason: 'CLI が無い' };
+        if (!cli.version)
+            return { kind: 'skipped', reason: '版が読めない' };
+        const min = await deps.fetchMinVersion();
+        if (!min)
+            return { kind: 'skipped', reason: '最低版を引けない' };
+        if (!isOlderThan(cli.version, min))
+            return { kind: 'current', version: cli.version };
+        const run = await deps.runNpm(selfUpdateExecArgs(selfUpdatePackage(min, deps.env[exports.SELF_UPDATE_PACKAGE_ENV]), cli.root, min));
+        const line = parseSelfUpdateLine(run.stdout);
+        // ⛔ 入口の ok を鵜呑みにしない＝使う CLI を引き直して版を読む
+        const after = deps.locate();
+        const now = after?.version ?? null;
+        if (now && !isOlderThan(now, min))
+            return { kind: 'updated', from: cli.version, to: now };
+        const reason = (line?.ok && line.root && after && path.resolve(line.root) !== path.resolve(after.root)
+            ? `${line.to ?? min} は ${line.root} に入ったが、席が使うのは ${after.root}`
+            : undefined) ??
+            line?.reason ??
+            run.error ??
+            (run.code !== 0 ? `npm が失敗しました（終了コード ${run.code ?? 'null'}）` : `入れたはずの ${min} が見つかりません（いま ${now ?? '不明'}）`);
+        return { kind: 'failed', from: cli.version, want: min, reason };
+    }
+    catch (err) {
+        return { kind: 'skipped', reason: `測れない: ${err.message.slice(0, 80)}` };
+    }
+}
+//# sourceMappingURL=cli-update.js.map

package/dist/cjs/cli-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-update.js","sourceRoot":"","sources":["../../src/cli-update.ts"],"names":[],"mappings":"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"}

package/dist/esm/cli-update.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 発火の前に BlueLamp CLI を最低版へ上げる——routine と scheduler の**単一実装**（箱 n=4076 → n=4082 で共用へ）。
+ *
+ * 定期便（routine・scheduler）は launchd から起きる＝PATH が /usr/bin:/bin だけ。6.7.2 以前の起動子は
+ * そこで素の npm を見つけられず自己更新に失敗し、古い gateway のまま load_knowledge を撃ち続ける（n=4058・n=4072）。
+ * ⇒ 席を立てる前に `/cli/min-version` と比べ、古いときだけ node の隣の npm で新しい版の入口を借りて上げる。
+ *
+ * ⛔ 置き場の選び方・npm の撃ち方は CLI の `bluelamp-self-update`（n=4072・selfUpdate.ts）が持つ。ここは二重に作らない。
+ *    ここがするのは「古いかを測る」と「新しい版の入口を npm exec で借りて撃つ」だけ（古い版には入口が無い）。
+ * 「どの CLI を上げるか」は呼び出し側が locate で渡す（routine＝gateway の package／scheduler＝起動子の package）。
+ *
+ * 制約は index.ts と同じ: node 標準モジュール以外に依存しない・console に出さない・throw しない（結果は CliUpdate で返す）。
+ */
+/** CLI の更新だけの入口（n=4072） */
+export declare const SELF_UPDATE_BIN = "bluelamp-self-update";
+/** 入口が入った最初の版。min がこれより低くても、入口はこの版から借りる */
+export declare const SELF_UPDATE_SINCE = "6.7.3";
+/** 入口を借りる package を上書きする env（rc を撃つ検体のため。例 bluelamp@6.7.3-rc.1） */
+export declare const SELF_UPDATE_PACKAGE_ENV = "BLUELAMP_SELF_UPDATE_PACKAGE";
+/** 起動子が子へ渡す「もう上げた」の印（n=4072）。npm の子へは渡さない */
+export declare const SELF_UPDATE_DONE_ENV = "BLUELAMP_SELFUPDATE_DONE";
+export declare const MIN_VERSION_TIMEOUT_MS = 2500;
+/** npm exec（入口の取得＋npm install）を待つ上限 */
+export declare const SELF_UPDATE_TIMEOUT_MS = 180000;
+/** 版の比較（a < b）。起動子の isOlderThan と同じ数え方（数字以外は 0） */
+export declare function isOlderThan(a: string, b: string): boolean;
+/** 入口を借りる package（env の上書き＞max(min, 入口の版)） */
+export declare function selfUpdatePackage(minVersion: string, override: string | undefined): string;
+/** `npm` に渡す引数（⛔ @latest にしない・入れる版は --min で名指し） */
+export declare function selfUpdateExecArgs(pkg: string, root: string, minVersion: string): string[];
+export interface SelfUpdateLine {
+    ok: boolean;
+    from?: string;
+    to?: string;
+    root?: string;
+    reason?: string;
+}
+/** 入口の stdout の最後の JSON 行（npm の出力が混じっても拾う）。無ければ null */
+export declare function parseSelfUpdateLine(stdout: string): SelfUpdateLine | null;
+/** 発火の前の更新の結果 */
+export type CliUpdate = 
+/** 測れなかった・測る物が無い（CLI が無い・最低版が引けない）＝いまの版のまま */
+{
+    kind: 'skipped';
+    reason: string;
+} | {
+    kind: 'current';
+    version: string;
+} | {
+    kind: 'updated';
+    from: string;
+    to: string;
+} | {
+    kind: 'failed';
+    from: string;
+    want: string;
+    reason: string;
+};
+/** 記録の行に足す括弧の中（current・skipped は何も足さない） */
+export declare function describeCliUpdate(u: CliUpdate): string | null;
+/** 上げる対象の CLI（package の dir と、その package.json の版） */
+export interface InstalledCli {
+    root: string;
+    version: string | null;
+}
+export interface NpmRun {
+    code: number | null;
+    stdout: string;
+    error?: string;
+}
+export interface CliUpdateDeps {
+    /** 席が使う CLI を引く（上げた後にもう一度撃つ＝入口の ok を鵜呑みにしない）。無ければ null */
+    locate: () => InstalledCli | null;
+    /** 最低版（引けなければ null） */
+    fetchMinVersion: () => Promise<string | null>;
+    /** npm を撃つ（throw しない） */
+    runNpm: (args: string[]) => Promise<NpmRun>;
+    env: NodeJS.ProcessEnv;
+}
+/** package の dir の package.json の版（読めなければ null） */
+export declare function readPackageVersion(root: string): string | null;
+/** `<base>/cli/min-version` の最低版（base は `/api/bluelamp` 付き）。引けなければ null・throw しない */
+export declare function fetchMinCliVersion(base: string, fetchFn?: typeof fetch, timeoutMs?: number): Promise<string | null>;
+/**
+ * node の隣の npm で撃つ（launchd の発火は PATH が /usr/bin:/bin だけ＝素の npm は ENOENT）。
+ * Windows の npm.cmd は shell 経由でないと spawn できない。cwd は home（作業フォルダの package.json を拾わない）
+ */
+export declare function runNpmBesideNode(args: string[], nodePath?: string): Promise<NpmRun>;
+/**
+ * 席を立てる前に、locate が指す CLI を最低版へ上げる。throw しない＝上げられなくても便は今の版で走る。
+ */
+export declare function updateCliToMin(deps: CliUpdateDeps): Promise<CliUpdate>;
+//# sourceMappingURL=cli-update.d.ts.map

package/dist/esm/cli-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-update.d.ts","sourceRoot":"","sources":["../../src/cli-update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,2BAA2B;AAC3B,eAAO,MAAM,eAAe,yBAAyB,CAAC;AAEtD,2CAA2C;AAC3C,eAAO,MAAM,iBAAiB,UAAU,CAAC;AAEzC,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AAEtE,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,6BAA6B,CAAC;AAE/D,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,uCAAuC;AACvC,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAE9C,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAiBzD;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG1F;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1F;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAoBzE;AAED,iBAAiB;AACjB,MAAM,MAAM,SAAS;AACnB,8CAA8C;AAC5C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE,2CAA2C;AAC3C,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAS7D;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,YAAY,GAAG,IAAI,CAAC;IAClC,uBAAuB;IACvB,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,yBAAyB;IACzB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO9D;AAED,qFAAqF;AACrF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,OAAO,KAAa,EAC7B,SAAS,GAAE,MAA+B,GACzC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAaxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,GAAE,MAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBrG;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,CA0B5E"}

package/dist/esm/cli-update.js

@@ -0,0 +1,177 @@
+/**
+ * 発火の前に BlueLamp CLI を最低版へ上げる——routine と scheduler の**単一実装**（箱 n=4076 → n=4082 で共用へ）。
+ *
+ * 定期便（routine・scheduler）は launchd から起きる＝PATH が /usr/bin:/bin だけ。6.7.2 以前の起動子は
+ * そこで素の npm を見つけられず自己更新に失敗し、古い gateway のまま load_knowledge を撃ち続ける（n=4058・n=4072）。
+ * ⇒ 席を立てる前に `/cli/min-version` と比べ、古いときだけ node の隣の npm で新しい版の入口を借りて上げる。
+ *
+ * ⛔ 置き場の選び方・npm の撃ち方は CLI の `bluelamp-self-update`（n=4072・selfUpdate.ts）が持つ。ここは二重に作らない。
+ *    ここがするのは「古いかを測る」と「新しい版の入口を npm exec で借りて撃つ」だけ（古い版には入口が無い）。
+ * 「どの CLI を上げるか」は呼び出し側が locate で渡す（routine＝gateway の package／scheduler＝起動子の package）。
+ *
+ * 制約は index.ts と同じ: node 標準モジュール以外に依存しない・console に出さない・throw しない（結果は CliUpdate で返す）。
+ */
+import { execFile } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+/** CLI の更新だけの入口（n=4072） */
+export const SELF_UPDATE_BIN = 'bluelamp-self-update';
+/** 入口が入った最初の版。min がこれより低くても、入口はこの版から借りる */
+export const SELF_UPDATE_SINCE = '6.7.3';
+/** 入口を借りる package を上書きする env（rc を撃つ検体のため。例 bluelamp@6.7.3-rc.1） */
+export const SELF_UPDATE_PACKAGE_ENV = 'BLUELAMP_SELF_UPDATE_PACKAGE';
+/** 起動子が子へ渡す「もう上げた」の印（n=4072）。npm の子へは渡さない */
+export const SELF_UPDATE_DONE_ENV = 'BLUELAMP_SELFUPDATE_DONE';
+export const MIN_VERSION_TIMEOUT_MS = 2500;
+/** npm exec（入口の取得＋npm install）を待つ上限 */
+export const SELF_UPDATE_TIMEOUT_MS = 180_000;
+/** 版の比較（a < b）。起動子の isOlderThan と同じ数え方（数字以外は 0） */
+export function isOlderThan(a, b) {
+    const parse = (v) => String(v)
+        .trim()
+        .split('.')
+        .map((p) => {
+        const n = parseInt(p, 10);
+        return Number.isFinite(n) ? n : 0;
+    });
+    const pa = parse(a);
+    const pb = parse(b);
+    for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+        const x = pa[i] ?? 0;
+        const y = pb[i] ?? 0;
+        if (x !== y)
+            return x < y;
+    }
+    return false;
+}
+/** 入口を借りる package（env の上書き＞max(min, 入口の版)） */
+export function selfUpdatePackage(minVersion, override) {
+    if (override && override.trim())
+        return override.trim();
+    return `bluelamp@${isOlderThan(minVersion, SELF_UPDATE_SINCE) ? SELF_UPDATE_SINCE : minVersion}`;
+}
+/** `npm` に渡す引数（⛔ @latest にしない・入れる版は --min で名指し） */
+export function selfUpdateExecArgs(pkg, root, minVersion) {
+    return ['exec', '--yes', `--package=${pkg}`, '--', SELF_UPDATE_BIN, '--root', root, '--min', minVersion];
+}
+/** 入口の stdout の最後の JSON 行（npm の出力が混じっても拾う）。無ければ null */
+export function parseSelfUpdateLine(stdout) {
+    const lines = stdout.split(/\r?\n/).map((l) => l.trim()).filter(Boolean).reverse();
+    for (const line of lines) {
+        if (!line.startsWith('{'))
+            continue;
+        try {
+            const v = JSON.parse(line);
+            if (typeof v.ok !== 'boolean')
+                continue;
+            const str = (k) => (typeof v[k] === 'string' ? v[k] : undefined);
+            return {
+                ok: v.ok,
+                ...(str('from') ? { from: str('from') } : {}),
+                ...(str('to') ? { to: str('to') } : {}),
+                ...(str('root') ? { root: str('root') } : {}),
+                ...(str('reason') ? { reason: str('reason') } : {}),
+            };
+        }
+        catch {
+            // 次の行へ
+        }
+    }
+    return null;
+}
+/** 記録の行に足す括弧の中（current・skipped は何も足さない） */
+export function describeCliUpdate(u) {
+    switch (u.kind) {
+        case 'updated':
+            return `CLI ${u.from}→${u.to}`;
+        case 'failed':
+            return `CLI の更新に失敗: ${u.reason}・${u.from} のまま（最低版 ${u.want}）`;
+        default:
+            return null;
+    }
+}
+/** package の dir の package.json の版（読めなければ null） */
+export function readPackageVersion(root) {
+    try {
+        const v = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf-8')).version;
+        return typeof v === 'string' && v.trim() ? v.trim() : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** `<base>/cli/min-version` の最低版（base は `/api/bluelamp` 付き）。引けなければ null・throw しない */
+export async function fetchMinCliVersion(base, fetchFn = fetch, timeoutMs = MIN_VERSION_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetchFn(`${base.replace(/\/+$/, '')}/cli/min-version`, { signal: controller.signal });
+        if (!res.ok)
+            return null;
+        const v = (await res.json())?.data?.min_cli_version;
+        return typeof v === 'string' && v.trim() ? v.trim() : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * node の隣の npm で撃つ（launchd の発火は PATH が /usr/bin:/bin だけ＝素の npm は ENOENT）。
+ * Windows の npm.cmd は shell 経由でないと spawn できない。cwd は home（作業フォルダの package.json を拾わない）
+ */
+export function runNpmBesideNode(args, nodePath = process.execPath) {
+    const dir = path.dirname(nodePath);
+    const win = process.platform === 'win32';
+    const beside = path.join(dir, win ? 'npm.cmd' : 'npm');
+    const bin = fs.existsSync(beside) ? beside : win ? 'npm.cmd' : 'npm';
+    const env = { ...process.env, PATH: process.env.PATH ? `${dir}${path.delimiter}${process.env.PATH}` : dir };
+    delete env[SELF_UPDATE_DONE_ENV];
+    return new Promise((resolve) => {
+        execFile(win && bin.includes(' ') ? `"${bin}"` : bin, args, { cwd: os.homedir(), env, timeout: SELF_UPDATE_TIMEOUT_MS, maxBuffer: 4 * 1024 * 1024, shell: win }, (err, stdout) => {
+            const e = err;
+            if (!e)
+                return resolve({ code: 0, stdout: String(stdout) });
+            const error = e.killed ? `時間切れ（${SELF_UPDATE_TIMEOUT_MS / 1000} 秒）` : typeof e.code === 'string' ? e.code : undefined;
+            resolve({ code: typeof e.code === 'number' ? e.code : null, stdout: String(stdout ?? ''), ...(error ? { error } : {}) });
+        });
+    });
+}
+/**
+ * 席を立てる前に、locate が指す CLI を最低版へ上げる。throw しない＝上げられなくても便は今の版で走る。
+ */
+export async function updateCliToMin(deps) {
+    try {
+        const cli = deps.locate();
+        if (!cli)
+            return { kind: 'skipped', reason: 'CLI が無い' };
+        if (!cli.version)
+            return { kind: 'skipped', reason: '版が読めない' };
+        const min = await deps.fetchMinVersion();
+        if (!min)
+            return { kind: 'skipped', reason: '最低版を引けない' };
+        if (!isOlderThan(cli.version, min))
+            return { kind: 'current', version: cli.version };
+        const run = await deps.runNpm(selfUpdateExecArgs(selfUpdatePackage(min, deps.env[SELF_UPDATE_PACKAGE_ENV]), cli.root, min));
+        const line = parseSelfUpdateLine(run.stdout);
+        // ⛔ 入口の ok を鵜呑みにしない＝使う CLI を引き直して版を読む
+        const after = deps.locate();
+        const now = after?.version ?? null;
+        if (now && !isOlderThan(now, min))
+            return { kind: 'updated', from: cli.version, to: now };
+        const reason = (line?.ok && line.root && after && path.resolve(line.root) !== path.resolve(after.root)
+            ? `${line.to ?? min} は ${line.root} に入ったが、席が使うのは ${after.root}`
+            : undefined) ??
+            line?.reason ??
+            run.error ??
+            (run.code !== 0 ? `npm が失敗しました（終了コード ${run.code ?? 'null'}）` : `入れたはずの ${min} が見つかりません（いま ${now ?? '不明'}）`);
+        return { kind: 'failed', from: cli.version, want: min, reason };
+    }
+    catch (err) {
+        return { kind: 'skipped', reason: `測れない: ${err.message.slice(0, 80)}` };
+    }
+}
+//# sourceMappingURL=cli-update.js.map

package/dist/esm/cli-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-update.js","sourceRoot":"","sources":["../../src/cli-update.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluelamp/cli-token",
-  "version": "1.3.0-rc.0",
+  "version": "1.4.0-rc.0",
   "description": "BlueLamp CLI が保存するローカルトークンファイルの読み書きの単一実装",
   "keywords": [
     "bluelamp",
@@ -14,6 +14,11 @@
       "types": "./dist/esm/index.d.ts",
       "import": "./dist/esm/index.js",
       "require": "./dist/cjs/index.js"
+    },
+    "./cli-update": {
+      "types": "./dist/esm/cli-update.d.ts",
+      "import": "./dist/esm/cli-update.js",
+      "require": "./dist/cjs/cli-update.js"
     }
   },
   "main": "dist/cjs/index.js",