@bluelamp/secret-exec 0.3.1 → 0.4.0

package/README.md

@@ -3,10 +3,11 @@
 > 🔒 **これは値を返さない口です。**
 > 取れるのは「金庫にその名前が**在るか無いか**」と「値を**使えるか**（子プロセスが値を環境変数で受けて走れたか＝子の終了コード）」だけです。
 > 値を標準出力・標準エラー・戻り値・ファイル・コマンドの引数に出す口は、このパッケージには**ありません**。今後も作りません。
-> 値を見たい用途（表示・コピー・ファイルへの書き出し）には使えません。それは設計上の意図です。
+> 値を見たい用途（表示・ファイルへの書き出し）には使えません。それは設計上の意図です。
+> 例外は 1 つだけ: `copy` は、**持ち主の画面に出る確認の窓で「コピー」を押したときだけ**値をクリップボードへ入れます（下の「クリップボードへ入れる」）。値は出力には出ません。
 
 金庫（password-manager）に置いた値を、**子プロセスの環境変数にだけ**入れてコマンドを実行します（`exec`）。終了コードは子のものをそのまま返します。
-値を会話に出さずに金庫へ**入れる**口（`put`）も同梱しています（下の「値を金庫へ入れる」）。
+値を会話に出さずに金庫へ**入れる**口（`put`）と、持ち主の確認を挟んでクリップボードへ入れる口（`copy`）も同梱しています。
 
 ## 使い方
 
@@ -77,3 +78,16 @@ bluelamp-secret put my-db --file ./db-url.txt --url https://db.example.com
 - `resolveHandoffBins(overrideEnvNames)` … node と bluelamp-secret の実体の絶対パス（launchd の貧しい PATH に依らない）。見つからなければ null
 
 ⛔ 値を返す口は無い（テスト P10 が export の一覧を縛る）。外側の `env -u CLAUDE_CODE_OAUTH_TOKEN`（親の継承を切る）は呼び手が付ける。
+
+## クリップボードへ入れる（copy）
+
+```bash
+bluelamp-secret copy "<金庫の名前>"
+```
+
+- 持ち主の画面に OS の確認の窓（「<名前> のパスワードをクリップボードにコピーしますか？」コピー／やめる）を出し、**「コピー」を押したときだけ**値をクリップボードへ入れます。45 秒たってクリップボードがまだその値なら空にします（別の物をコピーし直していれば触りません）。
+- 決めるのは毎回、画面の前の持ち主です。エージェント（Claude Code など）から撃っても、窓を押さなければ入りません。窓が 120 秒押されなければ「やめる」と同じです。
+- 名前が完全に一致しなければ、名前か利用者名に（大文字小文字を問わず）含む候補を窓に並べて選んでもらいます（最大 20 件）。名前は値の列を持たない一覧で当てるので、「やめる」を押したときは金庫の値を引きません。
+- Mac: 窓は `osascript`、クリップボードは `pbcopy`。Windows: PowerShell のフォームと `System.Windows.Forms.Clipboard`（クリップボードの履歴とクラウド同期には載せない印を付けます）。WSL から撃っても Windows 側の画面とクリップボードに出ます。
+- 窓を出せない機体では**黙ってコピーせず断ります**: ssh 越し（`SSH_CONNECTION` 等）・CI・画面にログインしていない利用者の Mac・WSL でない Linux。
+- 出力は「コピーしました」「やめました」と理由だけです。終了コード: 0 コピーした／1 失敗／2 引数の形／3 やめた／4 窓を出せない。

package/bin/bluelamp-secret.mjs

@@ -3,6 +3,7 @@
  * bluelamp-secret — 金庫の値を子プロセスの環境変数にだけ入れてコマンドを走らせる（箱 n=2018 設計④′）。
  *   bluelamp-secret exec <ENV名>=<金庫の名前> [...] -- <コマンド> [引数…]
  *   <値を出すコマンド> | bluelamp-secret put <金庫の名前> [--note 文] [--username 名] [--url URL] [--file パス] [--force]（箱 n=2498）
+ *   bluelamp-secret copy "<金庫の名前>"（箱 n=3738・持ち主の画面の確認の窓で「コピー」を押したときだけクリップボードへ）
  * 🔒 値を返さない口: 値は stdout・stderr・戻り値・ファイルに出ない（README の冒頭・src/index.ts の頭注）。
  * 判定と組み立ては dist/index.js（unit テスト済み）。ここは実物の網・トークン・子プロセス・シグナルを繋ぐだけ。
  */
@@ -10,7 +11,8 @@ import { spawn } from 'node:child_process';
 import { readFile } from 'node:fs/promises';
 import { constants as osConstants } from 'node:os';
 import { tryReadCliToken } from '@bluelamp/cli-token';
-import { runSecretExec, runSecretPut } from '../dist/index.js';
+import { runSecretCopy, runSecretExec, runSecretPut } from '../dist/index.js';
+import { clipboardBackend, consoleIsMine, isWsl, scheduleClear } from '../dist/clipboard.js';
 
 // 端末の Ctrl-C は同じプロセスグループの子にも届く＝親は受け流して子の終了を待つ。
 // SIGTERM / SIGHUP は親だけに来うるので子へ回す。
@@ -33,7 +35,21 @@ const run =
         readFile: (p) => readFile(p, 'utf8'),
         stderr: (text) => process.stderr.write(text),
       })
-    : runExec();
+    : argv[0] === 'copy'
+      ? runSecretCopy(argv, {
+          env: process.env,
+          host: {
+            platform: process.platform,
+            isWsl: process.platform === 'linux' && isWsl(process.env),
+            consoleIsMine: process.platform === 'darwin' && consoleIsMine(),
+          },
+          loadToken: () => tryReadCliToken(),
+          fetch: (url, init) => globalThis.fetch(url, init),
+          backend: (kind) => clipboardBackend(kind),
+          scheduleClear: (kind, value, seconds) => scheduleClear(kind, value, seconds),
+          stderr: (text) => process.stderr.write(text),
+        })
+      : runExec();
 
 function runExec() {
   return runSecretExec(argv, {

package/dist/clear-clipboard.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clear-clipboard.js

@@ -0,0 +1,22 @@
+/**
+ * `bluelamp-secret copy` が切り離して起こす子（箱 n=3738）: 標準入力で値を受け、秒数を待って、クリップボードがまだ
+ * その値なら空にする（持ち主が別の物をコピーしていたら触らない）。⛔ 何も出力しない。
+ *   node clear-clipboard.js <mac|windows|wsl> <秒>
+ */
+import { clipboardBackend } from './clipboard.js';
+const KINDS = ['mac', 'windows', 'wsl'];
+async function main() {
+    const kind = process.argv[2];
+    const seconds = Number(process.argv[3]);
+    if (!KINDS.includes(kind) || !Number.isFinite(seconds) || seconds < 0)
+        return;
+    const chunks = [];
+    for await (const c of process.stdin)
+        chunks.push(c);
+    const value = Buffer.concat(chunks).toString('utf8');
+    if (value === '')
+        return;
+    await new Promise((r) => setTimeout(r, seconds * 1000));
+    await clipboardBackend(kind).clearIfSame(value);
+}
+main().then(() => process.exit(0), () => process.exit(1));

package/dist/clipboard.d.ts

@@ -0,0 +1,20 @@
+import { type DialogAnswer, type DialogKind } from './copy.js';
+export interface ClipboardBackend {
+    /** 窓を出して答えを待つ（choices が null なら確認だけ） */
+    dialog(prompt: string, choices: readonly string[] | null): Promise<DialogAnswer>;
+    /** 値をクリップボードへ置く。置けたら true */
+    write(value: string): Promise<boolean>;
+    /** クリップボードがまだ値と同じなら空にする */
+    clearIfSame(value: string): Promise<'cleared' | 'changed' | 'failed'>;
+}
+/** 窓の種類に合う口を返す。WSL は Windows 側の powershell.exe を撃つ（窓とクリップボードは Windows の画面に出る） */
+export declare function clipboardBackend(kind: DialogKind): ClipboardBackend;
+/** WSL の中か（/proc/version に microsoft） */
+export declare function isWsl(env: Readonly<Record<string, string | undefined>>): boolean;
+/** Mac の画面（/dev/console）の持ち主がこのプロセスの利用者か。測れなければ false（＝窓を出さない） */
+export declare function consoleIsMine(): boolean;
+/**
+ * 後で消す子を切り離して起こす（親はすぐ終わる・子は秒数の後にまだ同じ値なら空にする）。値は子の標準入力で渡す。
+ * 🔑 detached＝別のプロセス群。撃った席のシェルが終わっても子は残って消しに行く。
+ */
+export declare function scheduleClear(kind: DialogKind, value: string, seconds: number): Promise<boolean>;

package/dist/clipboard.js

@@ -0,0 +1,133 @@
+/**
+ * `bluelamp-secret copy` の OS の口（箱 n=3738）— 確認の窓・クリップボード・後で消す子。判定は copy.ts（純粋関数）。
+ *
+ * 🔑 値の通り道は「index.ts → クリップボードの子（pbcopy／powershell）の標準入力」と「→ 後で消す子の標準入力」の 2 本だけ。
+ *    ⛔ 値を argv・env・ファイル・子の出力に載せない（子の stderr は捨て、stdout は窓の答え・ok/cleared の語だけを読む）。
+ * 🔑 パッケージの外へは出ない（package.json の exports に無い）。
+ */
+import { spawn } from 'node:child_process';
+import * as fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { MAC_CHOOSE_SCRIPT, MAC_CONFIRM_SCRIPT, WINDOWS_CLEAR_SCRIPT, WINDOWS_SET_SCRIPT, parseDialogAnswer, powerShellArgs, windowsDialogScript, } from './copy.js';
+/** pbcopy／pbpaste が文字化けしないように UTF-8 を名指す（親の LANG が空の機体がある） */
+const MAC_ENV = { ...process.env, LANG: 'en_US.UTF-8', LC_ALL: 'en_US.UTF-8' };
+const WSL_POWERSHELL = '/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe';
+/**
+ * 子を起こして stdout を読む。
+ * 🔑 窓を出す子は hide=false。Windows の windowsHide は STARTUPINFO に SW_HIDE を入れ、WinForms の最初の
+ *    ShowDialog がそれを受けて窓が見えないまま開く（🔬 2026-10-25 CI の Windows で実測: 窓は 120 秒開いたが上位の窓に出なかった）。
+ */
+function runChild(command, args, input, env, hide = true) {
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(command, [...args], { stdio: [input === null ? 'ignore' : 'pipe', 'pipe', 'ignore'], env, windowsHide: hide });
+        }
+        catch {
+            resolve({ code: 127, stdout: '' });
+            return;
+        }
+        const chunks = [];
+        child.stdout?.on('data', (c) => chunks.push(c));
+        child.on('error', () => resolve({ code: 127, stdout: '' }));
+        child.on('close', (code) => resolve({ code: code ?? 1, stdout: Buffer.concat(chunks).toString('utf8') }));
+        if (input !== null) {
+            child.stdin?.on('error', () => { });
+            child.stdin?.end(input, 'utf8');
+        }
+    });
+}
+function macBackend() {
+    return {
+        async dialog(prompt, choices) {
+            const args = choices === null ? ['-e', MAC_CONFIRM_SCRIPT, prompt] : ['-e', MAC_CHOOSE_SCRIPT, prompt, ...choices];
+            const r = await runChild('osascript', args, null);
+            return r.code === 0 ? parseDialogAnswer(r.stdout) : { kind: 'nogui' };
+        },
+        async write(value) {
+            return (await runChild('pbcopy', [], value, MAC_ENV)).code === 0;
+        },
+        async clearIfSame(value) {
+            const now = await runChild('pbpaste', [], null, MAC_ENV);
+            if (now.code !== 0)
+                return 'failed';
+            if (now.stdout !== value)
+                return 'changed';
+            return (await runChild('pbcopy', [], '', MAC_ENV)).code === 0 ? 'cleared' : 'failed';
+        },
+    };
+}
+function windowsBackend(powershell) {
+    return {
+        async dialog(prompt, choices) {
+            const r = await runChild(powershell, powerShellArgs(windowsDialogScript(prompt, choices)), null, undefined, false);
+            return r.code === 0 ? parseDialogAnswer(r.stdout) : { kind: 'nogui' };
+        },
+        async write(value) {
+            const r = await runChild(powershell, powerShellArgs(WINDOWS_SET_SCRIPT), value);
+            return r.code === 0 && r.stdout.trim() === 'ok';
+        },
+        async clearIfSame(value) {
+            const r = await runChild(powershell, powerShellArgs(WINDOWS_CLEAR_SCRIPT), value);
+            const s = r.stdout.trim();
+            if (r.code !== 0)
+                return 'failed';
+            return s === 'cleared' || s === 'changed' ? s : 'failed';
+        },
+    };
+}
+/** 窓の種類に合う口を返す。WSL は Windows 側の powershell.exe を撃つ（窓とクリップボードは Windows の画面に出る） */
+export function clipboardBackend(kind) {
+    if (kind === 'mac')
+        return macBackend();
+    if (kind === 'windows')
+        return windowsBackend('powershell.exe');
+    return windowsBackend(fs.existsSync(WSL_POWERSHELL) ? WSL_POWERSHELL : 'powershell.exe');
+}
+/** WSL の中か（/proc/version に microsoft） */
+export function isWsl(env) {
+    if (env.WSL_DISTRO_NAME)
+        return true;
+    try {
+        return /microsoft/i.test(fs.readFileSync('/proc/version', 'utf8'));
+    }
+    catch {
+        return false;
+    }
+}
+/** Mac の画面（/dev/console）の持ち主がこのプロセスの利用者か。測れなければ false（＝窓を出さない） */
+export function consoleIsMine() {
+    try {
+        return typeof process.getuid === 'function' && fs.statSync('/dev/console').uid === process.getuid();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 後で消す子を切り離して起こす（親はすぐ終わる・子は秒数の後にまだ同じ値なら空にする）。値は子の標準入力で渡す。
+ * 🔑 detached＝別のプロセス群。撃った席のシェルが終わっても子は残って消しに行く。
+ */
+export function scheduleClear(kind, value, seconds) {
+    const script = fileURLToPath(new URL('./clear-clipboard.js', import.meta.url));
+    return new Promise((resolve) => {
+        let child;
+        try {
+            child = spawn(process.execPath, [script, kind, String(seconds)], {
+                detached: true,
+                stdio: ['pipe', 'ignore', 'ignore'],
+                windowsHide: true,
+            });
+        }
+        catch {
+            resolve(false);
+            return;
+        }
+        child.on('error', () => resolve(false));
+        child.stdin?.on('error', () => resolve(false));
+        child.stdin?.end(value, 'utf8', () => {
+            child.unref();
+            resolve(true);
+        });
+    });
+}

package/dist/copy.d.ts

@@ -0,0 +1,96 @@
+/**
+ * `bluelamp-secret copy` の判定と組み立て（箱 n=3738）— 純粋関数だけ。網・子プロセスは clipboard.ts と index.ts の deps。
+ *
+ * 🔑 決めるのは毎回、持ち主の画面に出る OS の確認の窓の「コピー」。席（Claude Code）が撃っても、窓を押さなければ入らない。
+ *    ⇒ 窓を出せない機体（ssh 越し・CI・GUI の無い Linux・他人の画面）では黙ってコピーせず断る。
+ * ⛔ ここに値は来ない（窓に出すのは金庫の名前だけ・値は index.ts の中でクリップボードの子の標準入力へ渡すだけ）。
+ */
+/** クリップボードに置いておく秒数（過ぎてまだその値なら空にする） */
+export declare const CLEAR_AFTER_SECONDS = 45;
+/** 名前の当てで窓に並べる最大の件数（多すぎる時は絞ってもらう） */
+export declare const MAX_CHOICES = 20;
+/** 確認の窓を開けておく秒数（押されなければ「やめる」と同じ） */
+export declare const DIALOG_TIMEOUT_SECONDS = 120;
+export type CopyParseResult = {
+    ok: true;
+    name: string;
+} | {
+    ok: false;
+    help: boolean;
+    error: string;
+};
+/** `copy <金庫の名前>` を解析する（`process.argv.slice(2)` を受ける）。⛔ 失敗の文言に引数の中身を引用しない */
+export declare function parseCopyArgs(argv: readonly string[]): CopyParseResult;
+/** 一覧の 1 件（値の列は無い） */
+export interface VaultListEntry {
+    service: string;
+    username?: string | null;
+}
+/** 一覧の応答から名前と利用者名だけを取り出す。形が違えば null（⛔ note など他の列は使わない） */
+export declare function readVaultList(body: unknown): VaultListEntry[] | null;
+export type NameMatch = {
+    kind: 'exact';
+    name: string;
+} | {
+    kind: 'candidates';
+    names: string[];
+    total: number;
+} | {
+    kind: 'none';
+};
+/**
+ * 名前を当てる。完全一致が在ればそれ。無ければ名前か利用者名に（大文字小文字を問わず）含む物を候補にする。
+ * 例: 「ishii」→「Google 役割アカウント（窓口の箱・ishii.s）」。同じ名前（自分の分と共有されてきた分）は 1 つに畳む。
+ */
+export declare function matchVaultName(entries: readonly VaultListEntry[], query: string): NameMatch;
+export type DialogKind = 'mac' | 'windows' | 'wsl';
+export interface HostInfo {
+    platform: string;
+    env: Readonly<Record<string, string | undefined>>;
+    /** Linux のとき WSL の中か */
+    isWsl: boolean;
+    /** Mac のとき、画面（/dev/console）の持ち主がこのプロセスの利用者か。測れなければ false */
+    consoleIsMine: boolean;
+}
+export type DialogSupport = {
+    ok: true;
+    kind: DialogKind;
+} | {
+    ok: false;
+    reason: string;
+};
+/** 確認の窓を持ち主の画面に出せるか（⛔ 出せない時は黙ってコピーしない） */
+export declare function detectDialogSupport(host: HostInfo): DialogSupport;
+/** 確認の窓に出す文 */
+export declare function confirmPrompt(name: string): string;
+/** 候補を選ぶ窓に出す文 */
+export declare function choosePrompt(query: string, shown: number, total: number): string;
+/** 確認の窓（argv: 文）。stdout に copy／cancel／nogui:<番号> */
+export declare const MAC_CONFIRM_SCRIPT: string;
+/** 候補を選ぶ窓（argv: 文, 候補…）。stdout に pick:<番号（0 から）>／cancel／nogui:<番号> */
+export declare const MAC_CHOOSE_SCRIPT: string;
+/** `-EncodedCommand` に渡す形（UTF-16LE の base64） */
+export declare function encodePowerShell(script: string): string;
+/** powershell.exe に渡す引数（スクリプトは encoded で渡す＝値はここに来ない） */
+export declare function powerShellArgs(script: string): string[];
+/**
+ * 窓（確認か候補選び）を出す PowerShell。stdout に copy／pick:<番号>／cancel／nogui。
+ * 🔑 session 0（サービス）や非対話では窓が誰にも見えない＝nogui。MessageBox はボタンの名前を変えられないので小さなフォームで出す。
+ */
+export declare function windowsDialogScript(prompt: string, choices: readonly string[] | null): string;
+/** 標準入力の値をクリップボードへ置く PowerShell（クリップボードの履歴・クラウド同期には載せない印を付ける） */
+export declare const WINDOWS_SET_SCRIPT: string;
+/** 標準入力の値とクリップボードが同じなら空にする PowerShell。stdout に cleared／changed */
+export declare const WINDOWS_CLEAR_SCRIPT: string;
+export type DialogAnswer = {
+    kind: 'copy';
+} | {
+    kind: 'pick';
+    index: number;
+} | {
+    kind: 'cancel';
+} | {
+    kind: 'nogui';
+};
+/** 窓の子の stdout を答えにする（知らない形は nogui＝コピーしない側へ倒す） */
+export declare function parseDialogAnswer(stdout: string): DialogAnswer;

package/dist/copy.js

@@ -0,0 +1,207 @@
+/**
+ * `bluelamp-secret copy` の判定と組み立て（箱 n=3738）— 純粋関数だけ。網・子プロセスは clipboard.ts と index.ts の deps。
+ *
+ * 🔑 決めるのは毎回、持ち主の画面に出る OS の確認の窓の「コピー」。席（Claude Code）が撃っても、窓を押さなければ入らない。
+ *    ⇒ 窓を出せない機体（ssh 越し・CI・GUI の無い Linux・他人の画面）では黙ってコピーせず断る。
+ * ⛔ ここに値は来ない（窓に出すのは金庫の名前だけ・値は index.ts の中でクリップボードの子の標準入力へ渡すだけ）。
+ */
+/** クリップボードに置いておく秒数（過ぎてまだその値なら空にする） */
+export const CLEAR_AFTER_SECONDS = 45;
+/** 名前の当てで窓に並べる最大の件数（多すぎる時は絞ってもらう） */
+export const MAX_CHOICES = 20;
+/** 確認の窓を開けておく秒数（押されなければ「やめる」と同じ） */
+export const DIALOG_TIMEOUT_SECONDS = 120;
+/** `copy <金庫の名前>` を解析する（`process.argv.slice(2)` を受ける）。⛔ 失敗の文言に引数の中身を引用しない */
+export function parseCopyArgs(argv) {
+    if (argv[0] !== 'copy')
+        return { ok: false, help: false, error: '不明な操作です（受けるのは exec と put と copy だけ）' };
+    const rest = argv.slice(1);
+    if (rest.length === 0 || rest.includes('-h') || rest.includes('--help'))
+        return { ok: false, help: true, error: '' };
+    if (rest.some((a) => a.startsWith('-')))
+        return { ok: false, help: false, error: 'copy はオプションを受けません' };
+    if (rest.length !== 1)
+        return { ok: false, help: false, error: '金庫の名前は 1 つだけ書いてください（空白を含むなら "" で囲みます）' };
+    const name = rest[0];
+    if (name === '' || name === '.' || name === '..')
+        return { ok: false, help: false, error: '金庫の名前が使えない形です' };
+    return { ok: true, name };
+}
+/** 一覧の応答から名前と利用者名だけを取り出す。形が違えば null（⛔ note など他の列は使わない） */
+export function readVaultList(body) {
+    if (!body || typeof body !== 'object')
+        return null;
+    const b = body;
+    if (b.success !== true || !Array.isArray(b.data))
+        return null;
+    const out = [];
+    for (const e of b.data) {
+        if (!e || typeof e !== 'object')
+            continue;
+        const { service, username } = e;
+        if (typeof service !== 'string')
+            continue;
+        out.push({ service, username: typeof username === 'string' ? username : null });
+    }
+    return out;
+}
+/**
+ * 名前を当てる。完全一致が在ればそれ。無ければ名前か利用者名に（大文字小文字を問わず）含む物を候補にする。
+ * 例: 「ishii」→「Google 役割アカウント（窓口の箱・ishii.s）」。同じ名前（自分の分と共有されてきた分）は 1 つに畳む。
+ */
+export function matchVaultName(entries, query) {
+    if (entries.some((e) => e.service === query))
+        return { kind: 'exact', name: query };
+    const q = query.toLowerCase();
+    const names = [];
+    for (const e of entries) {
+        const hit = e.service.toLowerCase().includes(q) || (e.username ?? '').toLowerCase().includes(q);
+        if (hit && !names.includes(e.service))
+            names.push(e.service);
+    }
+    if (names.length === 0)
+        return { kind: 'none' };
+    return { kind: 'candidates', names: names.slice(0, MAX_CHOICES), total: names.length };
+}
+/** 確認の窓を持ち主の画面に出せるか（⛔ 出せない時は黙ってコピーしない） */
+export function detectDialogSupport(host) {
+    // 🔑 ssh 越しは窓が向こうの機体の画面に出る（撃った人の画面ではない）。CI は見ている人がいない。
+    if (host.env.SSH_CONNECTION || host.env.SSH_CLIENT || host.env.SSH_TTY) {
+        return { ok: false, reason: 'ssh 越しです' };
+    }
+    if (host.env.CI)
+        return { ok: false, reason: 'CI の中です' };
+    if (host.platform === 'darwin') {
+        return host.consoleIsMine ? { ok: true, kind: 'mac' } : { ok: false, reason: 'この利用者は画面にログインしていません' };
+    }
+    if (host.platform === 'win32')
+        return { ok: true, kind: 'windows' };
+    if (host.platform === 'linux' && host.isWsl)
+        return { ok: true, kind: 'wsl' };
+    return { ok: false, reason: 'この OS では確認の窓に対応していません' };
+}
+/** 確認の窓に出す文 */
+export function confirmPrompt(name) {
+    return `「${name}」のパスワードをクリップボードにコピーしますか？\n${CLEAR_AFTER_SECONDS} 秒たつとクリップボードから消えます。`;
+}
+/** 候補を選ぶ窓に出す文 */
+export function choosePrompt(query, shown, total) {
+    const more = total > shown ? `（${total} 件のうち ${shown} 件を出しています。名前を長く書くと絞れます）` : '';
+    return `「${query}」に当たる名前がいくつかあります。コピーするパスワードを選んでください。${more}\n${CLEAR_AFTER_SECONDS} 秒たつとクリップボードから消えます。`;
+}
+// ── Mac（osascript）。名前・文は argv で渡す（スクリプトに埋め込まない＝引用の崩れが無い） ──────────
+/** 確認の窓（argv: 文）。stdout に copy／cancel／nogui:<番号> */
+export const MAC_CONFIRM_SCRIPT = [
+    'on run argv',
+    'try',
+    'tell me to activate',
+    `set r to display dialog (item 1 of argv) with title "BlueLamp 金庫" buttons {"やめる", "コピー"} default button "コピー" cancel button "やめる" with icon caution giving up after ${DIALOG_TIMEOUT_SECONDS}`,
+    'on error number n',
+    'if n is -128 then return "cancel"',
+    'return "nogui:" & n',
+    'end try',
+    'if gave up of r then return "cancel"',
+    'return "copy"',
+    'end run',
+].join('\n');
+/** 候補を選ぶ窓（argv: 文, 候補…）。stdout に pick:<番号（0 から）>／cancel／nogui:<番号> */
+export const MAC_CHOOSE_SCRIPT = [
+    'on run argv',
+    'set p to item 1 of argv',
+    'set c to rest of argv',
+    'try',
+    'tell me to activate',
+    'set r to choose from list c with title "BlueLamp 金庫" with prompt p default items {item 1 of c} OK button name "コピー" cancel button name "やめる"',
+    'on error number n',
+    'return "nogui:" & n',
+    'end try',
+    'if r is false then return "cancel"',
+    'set picked to item 1 of r',
+    'repeat with i from 1 to count of c',
+    'if item i of c is picked then return "pick:" & (i - 1)',
+    'end repeat',
+    'return "cancel"',
+    'end run',
+].join('\n');
+// ── Windows（PowerShell）。文と候補は base64 の JSON で埋める・値は標準入力でだけ渡す ──────────
+/** `-EncodedCommand` に渡す形（UTF-16LE の base64） */
+export function encodePowerShell(script) {
+    return Buffer.from(script, 'utf16le').toString('base64');
+}
+/** powershell.exe に渡す引数（スクリプトは encoded で渡す＝値はここに来ない） */
+export function powerShellArgs(script) {
+    return ['-NoProfile', '-NonInteractive', '-Sta', '-ExecutionPolicy', 'Bypass', '-EncodedCommand', encodePowerShell(script)];
+}
+/**
+ * 窓（確認か候補選び）を出す PowerShell。stdout に copy／pick:<番号>／cancel／nogui。
+ * 🔑 session 0（サービス）や非対話では窓が誰にも見えない＝nogui。MessageBox はボタンの名前を変えられないので小さなフォームで出す。
+ */
+export function windowsDialogScript(prompt, choices) {
+    const data = Buffer.from(JSON.stringify({ prompt, choices: choices ?? [] }), 'utf8').toString('base64');
+    return [
+        "$ErrorActionPreference = 'Stop'",
+        'try {',
+        "  if ((Get-Process -Id $PID).SessionId -eq 0 -or -not [Environment]::UserInteractive) { 'nogui'; exit 0 }",
+        '  Add-Type -AssemblyName System.Windows.Forms',
+        '  Add-Type -AssemblyName System.Drawing',
+        `  $d = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String('${data}')) | ConvertFrom-Json`,
+        '  $f = New-Object Windows.Forms.Form',
+        "  $f.Text = 'BlueLamp 金庫'; $f.TopMost = $true; $f.StartPosition = 'CenterScreen'",
+        "  $f.FormBorderStyle = 'FixedDialog'; $f.MinimizeBox = $false; $f.MaximizeBox = $false",
+        "  $f.AutoSize = $true; $f.AutoSizeMode = 'GrowAndShrink'; $f.Padding = New-Object Windows.Forms.Padding 12",
+        "  $p = New-Object Windows.Forms.FlowLayoutPanel; $p.FlowDirection = 'TopDown'; $p.AutoSize = $true; $p.AutoSizeMode = 'GrowAndShrink'",
+        '  $l = New-Object Windows.Forms.Label; $l.Text = $d.prompt; $l.AutoSize = $true; $l.MaximumSize = New-Object Drawing.Size 480, 0',
+        '  $p.Controls.Add($l)',
+        '  $lb = $null',
+        '  if (@($d.choices).Count -gt 0) {',
+        '    $lb = New-Object Windows.Forms.ListBox; $lb.Width = 460; $lb.Height = [Math]::Min(@($d.choices).Count, 12) * 20 + 8',
+        '    foreach ($c in $d.choices) { [void]$lb.Items.Add([string]$c) }',
+        '    $lb.SelectedIndex = 0; $p.Controls.Add($lb)',
+        '  }',
+        "  $bp = New-Object Windows.Forms.FlowLayoutPanel; $bp.FlowDirection = 'RightToLeft'; $bp.AutoSize = $true; $bp.Width = 460",
+        "  $ok = New-Object Windows.Forms.Button; $ok.Text = 'コピー'; $ok.Name = 'copy'; $ok.DialogResult = 'OK'; $ok.AutoSize = $true",
+        "  $ng = New-Object Windows.Forms.Button; $ng.Text = 'やめる'; $ng.Name = 'cancel'; $ng.DialogResult = 'Cancel'; $ng.AutoSize = $true",
+        '  $bp.Controls.Add($ng); $bp.Controls.Add($ok); $p.Controls.Add($bp)',
+        '  $f.AcceptButton = $ok; $f.CancelButton = $ng; $f.Controls.Add($p)',
+        `  $t = New-Object Windows.Forms.Timer; $t.Interval = ${DIALOG_TIMEOUT_SECONDS * 1000}`,
+        "  $t.Add_Tick({ $t.Stop(); $f.DialogResult = 'Cancel' }); $t.Start()",
+        '  $f.Add_Shown({ $f.Activate() })',
+        '  $r = $f.ShowDialog()',
+        "  if ($r -eq 'OK') { if ($lb) { 'pick:' + $lb.SelectedIndex } else { 'copy' } } else { 'cancel' }",
+        "} catch { 'nogui' }",
+    ].join('\n');
+}
+/** 標準入力の値をクリップボードへ置く PowerShell（クリップボードの履歴・クラウド同期には載せない印を付ける） */
+export const WINDOWS_SET_SCRIPT = [
+    "$ErrorActionPreference = 'Stop'",
+    '[Console]::InputEncoding = New-Object Text.UTF8Encoding $false',
+    '$v = [Console]::In.ReadToEnd()',
+    'Add-Type -AssemblyName System.Windows.Forms',
+    '$o = New-Object Windows.Forms.DataObject',
+    '$o.SetData([Windows.Forms.DataFormats]::UnicodeText, $v)',
+    "foreach ($k in 'ExcludeClipboardContentFromMonitorProcessing', 'CanIncludeInClipboardHistory', 'CanUploadToCloudClipboard') {",
+    '  $o.SetData($k, (New-Object IO.MemoryStream (, [byte[]](0, 0, 0, 0))))',
+    '}',
+    '[Windows.Forms.Clipboard]::SetDataObject($o, $true)',
+    "'ok'",
+].join('\n');
+/** 標準入力の値とクリップボードが同じなら空にする PowerShell。stdout に cleared／changed */
+export const WINDOWS_CLEAR_SCRIPT = [
+    "$ErrorActionPreference = 'Stop'",
+    '[Console]::InputEncoding = New-Object Text.UTF8Encoding $false',
+    '$v = [Console]::In.ReadToEnd()',
+    'Add-Type -AssemblyName System.Windows.Forms',
+    "if ([Windows.Forms.Clipboard]::GetText() -ceq $v) { [Windows.Forms.Clipboard]::Clear(); 'cleared' } else { 'changed' }",
+].join('\n');
+/** 窓の子の stdout を答えにする（知らない形は nogui＝コピーしない側へ倒す） */
+export function parseDialogAnswer(stdout) {
+    const s = stdout.trim();
+    if (s === 'copy')
+        return { kind: 'copy' };
+    if (s === 'cancel')
+        return { kind: 'cancel' };
+    const m = /^pick:(\d+)$/.exec(s);
+    if (m)
+        return { kind: 'pick', index: Number(m[1]) };
+    return { kind: 'nogui' };
+}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 /**
- * @bluelamp/secret-exec — `bluelamp-secret exec`（箱 n=2018 設計④′）と `bluelamp-secret put`（箱 n=2498・下の put の節）
+ * @bluelamp/secret-exec — `bluelamp-secret exec`（箱 n=2018 設計④′）と `bluelamp-secret put`（箱 n=2498・下の put の節）と
+ *   `bluelamp-secret copy`（箱 n=3738・末尾の copy の節）
  *
  * 🔒 これは「値を返さない口」である（実装より先に書いた線・README の冒頭と同じ）。
  *   取れるのは「金庫にその名前が在るか無いか」と「値を使えるか（子プロセスが env で受けて走れたか＝終了コード）」だけ。
@@ -19,6 +20,8 @@
  *
  * 判定と組み立ては純粋関数（unit で直接撃つ）、網と子プロセスは `runSecretExec` の deps に寄せる。
  */
+import type { ClipboardBackend } from './clipboard.js';
+import { type DialogKind, type HostInfo } from './copy.js';
 /** ENV 名として受ける形。⛔ これ以外（小文字・記号・先頭数字）は受けない */
 export declare const ENV_NAME_PATTERN: RegExp;
 /** 既定のポータル API（bluelamp CLI の portal-api-client・TokenManager と同じ値） */
@@ -135,4 +138,20 @@ export interface SecretPutDeps {
 }
 /** put を実行する。戻り値は終了コード（0 保存して一致／1 失敗／2 引数・入力の形／3 既に在る） */
 export declare function runSecretPut(argv: readonly string[], deps: SecretPutDeps): Promise<number>;
+/**
+ * 🔒 決めるのは毎回、持ち主の画面の窓。値の通り道は「金庫の GET → クリップボードの子の標準入力（と後で消す子の標準入力）」だけ。
+ *   ⛔ 値を出力に出さない（出すのは「コピーしました」「やめました」と理由だけ）。⛔ 窓を出せない機体では黙ってコピーしない。
+ * 🔑 名前は一覧（値の列を持たない）で先に当てる＝窓で「やめる」を押されたら金庫の値は引かない（監査の get も残らない）。
+ * 終了コード: 0 コピーした／1 失敗／2 引数の形／3 やめた／4 窓を出せない
+ */
+export interface SecretCopyDeps {
+    env: Readonly<Record<string, string | undefined>>;
+    host: Omit<HostInfo, 'env'>;
+    loadToken: () => string | null;
+    fetch: FetchLike;
+    backend: (kind: DialogKind) => Pick<ClipboardBackend, 'dialog' | 'write'>;
+    scheduleClear: (kind: DialogKind, value: string, seconds: number) => Promise<boolean>;
+    stderr: (text: string) => void;
+}
+export declare function runSecretCopy(argv: readonly string[], deps: SecretCopyDeps): Promise<number>;
 export {};

package/dist/index.js

@@ -1,5 +1,6 @@
 /**
- * @bluelamp/secret-exec — `bluelamp-secret exec`（箱 n=2018 設計④′）と `bluelamp-secret put`（箱 n=2498・下の put の節）
+ * @bluelamp/secret-exec — `bluelamp-secret exec`（箱 n=2018 設計④′）と `bluelamp-secret put`（箱 n=2498・下の put の節）と
+ *   `bluelamp-secret copy`（箱 n=3738・末尾の copy の節）
  *
  * 🔒 これは「値を返さない口」である（実装より先に書いた線・README の冒頭と同じ）。
  *   取れるのは「金庫にその名前が在るか無いか」と「値を使えるか（子プロセスが env で受けて走れたか＝終了コード）」だけ。
@@ -19,6 +20,7 @@
  *
  * 判定と組み立ては純粋関数（unit で直接撃つ）、網と子プロセスは `runSecretExec` の deps に寄せる。
  */
+import { CLEAR_AFTER_SECONDS, choosePrompt, confirmPrompt, detectDialogSupport, matchVaultName, parseCopyArgs, readVaultList, } from './copy.js';
 /** ENV 名として受ける形。⛔ これ以外（小文字・記号・先頭数字）は受けない */
 export const ENV_NAME_PATTERN = /^[A-Z_][A-Z0-9_]*$/;
 /** 既定のポータル API（bluelamp CLI の portal-api-client・TokenManager と同じ値） */
@@ -28,7 +30,10 @@ export const USAGE = '使い方: bluelamp-secret exec <ENV名>=<金庫の名前>
     '  値は画面・引数・ログに出ません。シェルの展開が要るときは -- sh -c \'psql "$PGURL" -c "select 1"\' のように渡します。\n' +
     '使い方: <値を出すコマンド> | bluelamp-secret put <金庫の名前> [--note 文] [--username 名] [--url URL] [--file パス] [--force]\n' +
     '  値を標準入力（または --file のファイル）から読んで金庫へ入れ、読み戻して一致を確かめます。末尾の改行 1 つは落とします。\n' +
-    '  既に在る名前は --force が無ければ止まります。標準入力が端末なら受けません（打ち込んだ値が画面に残るため）。\n';
+    '  既に在る名前は --force が無ければ止まります。標準入力が端末なら受けません（打ち込んだ値が画面に残るため）。\n' +
+    '使い方: bluelamp-secret copy "<金庫の名前>"\n' +
+    '  持ち主の画面に確認の窓を出し、「コピー」を押したときだけ値をクリップボードへ入れます（45 秒で消えます）。\n' +
+    '  名前が完全に一致しなければ、当たる候補を窓に並べて選んでもらいます。窓を出せない機体（ssh 越し・CI など）では断ります。\n';
 /** `.`／`..` は URL の区間として解決され、金庫の外の経路を指してしまう（%2E も URL 側で同じに扱われる） */
 function isUsableVaultName(name) {
     return name !== '' && name !== '.' && name !== '..';
@@ -39,7 +44,7 @@ export function parseExecArgs(argv) {
         return { ok: false, help: true, error: '' };
     }
     if (argv[0] !== 'exec') {
-        return { ok: false, help: false, error: `不明な操作です（受けるのは exec と put だけ）` };
+        return { ok: false, help: false, error: `不明な操作です（受けるのは exec と put と copy だけ）` };
     }
     const sep = argv.indexOf('--');
     if (sep === -1) {
@@ -250,7 +255,7 @@ const PUT_VALUE_OPTIONS = ['--note', '--username', '--url', '--file'];
  */
 export function parsePutArgs(argv) {
     if (argv[0] !== 'put')
-        return { ok: false, help: false, error: '不明な操作です（受けるのは exec と put だけ）' };
+        return { ok: false, help: false, error: '不明な操作です（受けるのは exec と put と copy だけ）' };
     const rest = argv.slice(1);
     if (rest.length === 0 || rest.includes('-h') || rest.includes('--help'))
         return { ok: false, help: true, error: '' };
@@ -422,3 +427,88 @@ export async function runSecretPut(argv, deps) {
     deps.stderr(`${PREFIX}${name}: 保存しました（${value.length} 文字・読み戻して一致）\n`);
     return 0;
 }
+export async function runSecretCopy(argv, deps) {
+    const parsed = parseCopyArgs(argv);
+    if (!parsed.ok) {
+        if (parsed.help) {
+            deps.stderr(USAGE);
+            return argv.length <= 1 ? 2 : 0;
+        }
+        deps.stderr(`${PREFIX}${parsed.error}\n${USAGE}`);
+        return 2;
+    }
+    const query = parsed.name;
+    const support = detectDialogSupport({ ...deps.host, env: deps.env });
+    if (!support.ok) {
+        deps.stderr(`${PREFIX}確認の窓を出せないのでコピーしません（${support.reason}）\n`);
+        return 4;
+    }
+    const token = deps.loadToken();
+    if (!token) {
+        deps.stderr(`${PREFIX}未ログインです（bluelamp1 などでログインしてから撃ってください）\n`);
+        return 1;
+    }
+    const baseUrl = resolvePortalApiBaseUrl(deps.env);
+    let entries = null;
+    try {
+        const res = await deps.fetch(`${baseUrl}/vault/list`, { method: 'GET', headers: cliHeaders(token) });
+        if (!res.ok) {
+            deps.stderr(`${PREFIX}金庫の一覧を引けませんでした（${describeVaultStatus(res.status)}）\n`);
+            return 1;
+        }
+        entries = readVaultList(await res.json());
+    }
+    catch {
+        entries = null;
+    }
+    if (entries === null) {
+        deps.stderr(`${PREFIX}金庫の一覧を読めませんでした\n`);
+        return 1;
+    }
+    const match = matchVaultName(entries, query);
+    if (match.kind === 'none') {
+        deps.stderr(`${PREFIX}${query}: 金庫に当たる名前がありません\n`);
+        return 1;
+    }
+    const backend = deps.backend(support.kind);
+    let name;
+    if (match.kind === 'exact') {
+        const answer = await backend.dialog(confirmPrompt(match.name), null);
+        if (answer.kind === 'nogui')
+            return refuseNoGui(deps);
+        if (answer.kind !== 'copy')
+            return cancelled(deps);
+        name = match.name;
+    }
+    else {
+        const answer = await backend.dialog(choosePrompt(query, match.names.length, match.total), match.names);
+        if (answer.kind === 'nogui')
+            return refuseNoGui(deps);
+        if (answer.kind !== 'pick' || match.names[answer.index] === undefined)
+            return cancelled(deps);
+        name = match.names[answer.index];
+    }
+    const got = await fetchSecretValue(deps.fetch, baseUrl, token, name);
+    if (!got.ok) {
+        deps.stderr(`${PREFIX}${name}: ${got.reason}（コピーしていません）\n`);
+        return 1;
+    }
+    if (!(await backend.write(got.value))) {
+        deps.stderr(`${PREFIX}${name}: クリップボードに入れられませんでした\n`);
+        return 1;
+    }
+    if (!(await deps.scheduleClear(support.kind, got.value, CLEAR_AFTER_SECONDS))) {
+        deps.stderr(`${PREFIX}${name}: コピーしました。ただし ${CLEAR_AFTER_SECONDS} 秒後に消す仕掛けを起こせませんでした（使い終わったら別の物をコピーして上書きしてください）\n`);
+        return 0;
+    }
+    deps.stderr(`${PREFIX}${name}: コピーしました（${CLEAR_AFTER_SECONDS} 秒たつとクリップボードから消えます）\n`);
+    return 0;
+}
+function refuseNoGui(deps) {
+    deps.stderr(`${PREFIX}確認の窓を出せないのでコピーしません（画面に窓を出せませんでした）\n`);
+    return 4;
+}
+function cancelled(deps) {
+    deps.stderr(`${PREFIX}やめました（クリップボードは変えていません）\n`);
+    return 3;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bluelamp/secret-exec",
-  "version": "0.3.1",
-  "description": "金庫の値を子プロセスの環境変数にだけ入れてコマンドを実行し（exec）、標準入力から金庫へ入れる（put）。値を画面・引数・ログに出さない口",
+  "version": "0.4.0",
+  "description": "金庫の値を子プロセスの環境変数にだけ入れてコマンドを実行し（exec）、標準入力から金庫へ入れる（put）・持ち主の確認の窓でクリップボードへ入れる（copy）。値を画面・引数・ログに出さない口",
   "keywords": [
     "bluelamp",
     "cli",