@pecot/tools-mcp 0.0.0-stage → 1.0.1

package/cli/dist/domain/failure.js

@@ -0,0 +1,99 @@
+// awscli の失敗理由の種別判定（FR-009 / research R4）。
+//
+// awscli はエラーを構造化して返さないため、終了コードと stderr の文字列比較が唯一の手段になる。
+// 比較表は research R4 の表を元にしている。
+// awscli 2.36.40 の実採取（2026-09-07）で確認した文言を優先して直している。
+// 例えば `Found invalid choice` は、R4 の `Invalid choice` と大小文字が異なる。
+// AccessDenied / ResourceNotFound 系は実アカウントを使っていないため R4 転記のまま。
+/**
+awscli v2 の「構文不正」終了コード。
+*/
+const SYNTAX_ERROR_EXIT_CODE = 252;
+/**
+stderr の比較表。上から順に見るため、並びがそのまま優先順になる。
+
+auth-expired を auth-missing より先に置くのは、期限切れの stderr に「認証情報が無い」系の
+文言を併記する場合があるため。
+permission-denied は resource-not-found より先に置く。権限不足を「対象が無い」と誤って伝えないため。
+*/
+const STDERR_RULES = [
+    {
+        category: 'auth-expired',
+        fragments: [
+            'Error loading SSO Token',
+            'The SSO session associated with this profile has expired',
+            'ExpiredToken',
+            'InvalidClientTokenId',
+            'Token has expired',
+        ],
+    },
+    {
+        category: 'auth-missing',
+        fragments: [
+            'Unable to locate credentials',
+            'Missing the following required SSO configuration',
+        ],
+        // R4 の `The config profile (<name>) could not be found`。
+        // `could not be found` の断片だけでは、リソース不在の stderr も auth-missing になる。
+        // 例は `The specified log group could not be found`。
+        // aws_sso_login を促す誤案内になるので、文全体で比較する。
+        patterns: [/The config profile \(.+\) could not be found/],
+    },
+    {
+        category: 'permission-denied',
+        fragments: [
+            'AccessDenied',
+            'AccessDeniedException',
+            'UnauthorizedOperation',
+            'not authorized to perform',
+        ],
+    },
+    {
+        category: 'resource-not-found',
+        fragments: [
+            'ResourceNotFoundException',
+            'NoSuchBucket',
+            'NoSuchKey',
+            'QueueDoesNotExist',
+            'AWS.SimpleQueueService.NonExistentQueue',
+            '(404)',
+        ],
+    },
+    {
+        category: 'invalid-input',
+        fragments: [
+            'Unknown options',
+            // 実採取は `argument operation: Found invalid choice 'bogus-op'`。R4 転記の
+            // `Invalid choice` は大小文字が違って掛からないため、両方を並べる。
+            'Found invalid choice',
+            'Invalid choice',
+            'the following arguments are required:',
+        ],
+        // R4 の `argument ... is required`（v1 語法）。オプション名が可変なので正規表現で見る。
+        patterns: [/argument .+ is required/],
+    },
+];
+function doesMatch(rule, stderr) {
+    return rule.fragments.some(fragment => stderr.includes(fragment)) || (rule.patterns ?? []).some(pattern => pattern.test(stderr));
+}
+/**
+失敗の種別を決める。
+
+順は ENOENT → 時間切れ → 終了コード 252 → stderr 比較 → other。
+ENOENT を最優先にするのは、awscli 未導入では stderr に何が出ていても打つ手が
+「awscli を入れる」しかないため。
+*/
+export function classifyFailure(signals) {
+    if (signals.spawnErrorCode === 'ENOENT')
+        return 'awscli-missing';
+    if (signals.timedOut)
+        return 'timeout';
+    if (signals.exitCode === SYNTAX_ERROR_EXIT_CODE)
+        return 'invalid-input';
+    for (const rule of STDERR_RULES) {
+        if (doesMatch(rule, signals.stderr))
+            return rule.category;
+    }
+    return 'other';
+}
+//# sourceMappingURL=failure.js.map

package/cli/dist/domain/redact.d.ts

@@ -0,0 +1,5 @@
+/**
+アクセスキー ID・シークレット・セッショントークンを [redacted] に置き換える。
+*/
+export declare function redactSecrets(text: string): string;
+//# sourceMappingURL=redact.d.ts.map

package/cli/dist/domain/redact.js

@@ -0,0 +1,38 @@
+// 応答へ載せる前の秘匿化（FR-005 / SC-006 / research R10）。
+//
+// awscli の通常出力に秘密は含まれないが、想定外のエラーや --debug 相当の出力で
+// 資格情報が混入する事態を、応答側の最終段で塞ぐ。
+/**
+置換後の文字列。
+*/
+const REDACTED = '[redacted]';
+/**
+アクセスキー ID。R10 の `(AKIA|ASIA)[0-9A-Z]{16}` と同値（`A[KS]IA` は `AKIA|ASIA`）。
+*/
+const ACCESS_KEY_ID = /A[KS]IA[\dA-Z]{16}/g;
+/**
+値部だけを差し替える規則（キー名は残し、何が伏せられたか分かるようにする）。
+
+`i` を付けるのは、混入元の本命が環境変数（`AWS_SESSION_TOKEN=...`）とヘッダ
+（`X-Amz-Security-Token: ...`）の大文字形のため。
+
+値部を「空白と引用符以外の連続」にするのは、`\S+` だと JSON 文字列の閉じ引用符まで飲み込むため。
+`{"note":"aws_session_token=X"}` が不正 JSON になり、後段の JSON.parse が何も言わずに
+行配列へ切り替わる。
+*/
+const KEYED_SECRETS = [
+    /(aws_secret_access_key\s*=\s*)[^\s"']+/gi,
+    /(aws_session_token\s*=\s*)[^\s"']+/gi,
+    /(x-amz-security-token:\s*)[^\s"']+/gi,
+];
+/**
+アクセスキー ID・シークレット・セッショントークンを [redacted] に置き換える。
+*/
+export function redactSecrets(text) {
+    let redacted = text.replaceAll(ACCESS_KEY_ID, () => REDACTED);
+    for (const pattern of KEYED_SECRETS) {
+        redacted = redacted.replaceAll(pattern, (_match, key) => `${key}${REDACTED}`);
+    }
+    return redacted;
+}
+//# sourceMappingURL=redact.js.map

package/cli/dist/domain/s3-input.d.ts

@@ -0,0 +1,20 @@
+/**
+`s3://<bucket>/<key>` 形式か。
+
+空白を含む値は拒否しない。引数は shell を介さず、1 要素 1 値で awscli へ渡る。
+そのため `s3://b/k --recursive` のような値は「そういう名前のキー」として扱われ、
+別オプションには化けない（research R3）。
+*/
+export declare function validateS3Uri(value: string): string | undefined;
+/**
+`s3 ls` の位置引数として妥当か（バケット一覧・prefix 指定の双方を許す）。
+*/
+export declare function validateS3ListUri(value: string): string | undefined;
+/**
+書き出し先のローカルパスとして妥当か。
+
+`s3://…` を先に見るのは、絶対パスの検証だけでも弾けるが「相対パスだ」という案内になり、
+取得元と書き出し先を取り違えた利用者に誤った直し方を促すため。
+*/
+export declare function validateLocalPath(value: string): string | undefined;
+//# sourceMappingURL=s3-input.d.ts.map

package/cli/dist/domain/s3-input.js

@@ -0,0 +1,50 @@
+// S3 の入力値（オブジェクト URI・一覧 URI・ローカル出力先）の書式検証。
+//
+// research R7 の方向制約は「入力の形で表現できない」ことで担保しているが、値そのものが
+// 期待どおりの形かはここで見る。書式は contracts/mcp-tools.md の正規表現を逐語で写す。
+//
+// 戻り値は「入力名に続く述部」で、入力名と値の連結は arguments.ts が行う（`<name> <述部>: <value>`）。
+// 述部に助詞まで含めるのは、`s3://…` のような欧文始まりの語で助詞との間に空白が要るかどうかが
+// 語ごとに変わるため。文言の組み立てを 1 箇所に寄せると、規則を足したときに書式が割れない。
+import path from 'node:path';
+/**
+`aws_s3_cp` の取得元。バケットとキーの双方を要求する（契約表 aws_s3_cp の s3-uri）。
+*/
+const S3_OBJECT_URI = /^s3:\/\/[^/]+\/.+$/;
+/**
+`aws_s3_ls` の一覧対象。バケット一覧（`s3://`）と prefix 指定の双方を許す（契約表 aws_s3_ls）。
+*/
+// eslint-disable-next-line security/detect-unsafe-regex -- 前半の [^/]* と後半の '/' 以降は排他で backtracking しない
+const S3_LIST_URI = /^s3:\/\/[^/]*(?:\/.*)?$/;
+/**
+ローカルパスに紛れ込んだ S3 URI。大小文字を区別せずに見る。
+*/
+const S3_SCHEME = /^s3:\/\//i;
+/**
+`s3://<bucket>/<key>` 形式か。
+
+空白を含む値は拒否しない。引数は shell を介さず、1 要素 1 値で awscli へ渡る。
+そのため `s3://b/k --recursive` のような値は「そういう名前のキー」として扱われ、
+別オプションには化けない（research R3）。
+*/
+export function validateS3Uri(value) {
+    return S3_OBJECT_URI.test(value) ? undefined : 'は s3://<bucket>/<key> の形式で指定してください';
+}
+/**
+`s3 ls` の位置引数として妥当か（バケット一覧・prefix 指定の双方を許す）。
+*/
+export function validateS3ListUri(value) {
+    return S3_LIST_URI.test(value) ? undefined : 'は s3://<bucket>[/<prefix>] の形式で指定してください';
+}
+/**
+書き出し先のローカルパスとして妥当か。
+
+`s3://…` を先に見るのは、絶対パスの検証だけでも弾けるが「相対パスだ」という案内になり、
+取得元と書き出し先を取り違えた利用者に誤った直し方を促すため。
+*/
+export function validateLocalPath(value) {
+    if (S3_SCHEME.test(value))
+        return 'はローカルの絶対パスで指定してください（s3:// は書き出し先にできません）';
+    return path.isAbsolute(value) ? undefined : 'は絶対パスで指定してください';
+}
+//# sourceMappingURL=s3-input.js.map

package/cli/dist/domain/sso-output.d.ts

@@ -0,0 +1,23 @@
+/**
+抽出できた認証 URL とコードの組。片方だけでは利用者が認証を進められないため常に対で扱う。
+*/
+export interface SsoLoginPrompt {
+    readonly verificationUrl: string;
+    readonly userCode: string;
+    /**
+    コードを自動入力する URL。これを開けばコード入力が要らない。未到達なら無い。
+    */
+    readonly verificationUrlComplete?: string;
+}
+/**
+login-registry.ts が chunk 単位の再 parse を絞り込むのに使うため export する。
+*/
+export declare const AUTOFILL_MARKER = "Alternatively, you may visit the following URL which will autofill the code upon loading:";
+/**
+累積した出力から認証 URL とコードを取り出す。両方が揃うまでは undefined を返す。
+
+片方だけ返さないのは、URL だけを先に応答へ載せても利用者が認証を完了できないため。
+autofill URL は揃っていれば載せるだけで、これを待って確定を遅らせることはしない。
+*/
+export declare function parseSsoLoginOutput(text: string): SsoLoginPrompt | undefined;
+//# sourceMappingURL=sso-output.d.ts.map

package/cli/dist/domain/sso-output.js

@@ -0,0 +1,70 @@
+// `aws sso login --no-browser --use-device-code` の出力から認証 URL とコードを取り出す（research R5）。
+//
+// awscli はこの 2 値を構造化して返さないため、行の並びからの抽出が唯一の手段になる。
+// 実 awscli 2.36.40 の stdout（採取日 2026-09-07）は次の形で、マーカー行の後に空行を挟んで
+// 値が 1 行だけ置かれる。末尾にはコードを自動入力する URL がもう 1 本続く。
+//
+//   Browser will not be automatically opened.
+//   Please visit the following URL:
+//
+//   https://<start>.awsapps.com/start/#/device
+//
+//   Then enter the code:
+//
+//   ZHJW-WDMF
+//
+//   Alternatively, you may visit the following URL which will autofill the code upon loading:
+//
+//   `https://<start>.awsapps.com/start/#/device?user_code=ZHJW-WDMF`
+//
+// URL は各マーカー行より後ろの最初の 1 本だけを見る。末尾の autofill URL は
+// 「コードを URL に載せた形」で、これを開けば利用者はコード入力を省ける（RFC 8628 の
+// verification_uri_complete に相当する）。
+//
+// 子プロセスの出力は chunk 単位で届くので、呼び出し側は累積した stdout をそのつど渡し、
+// URL とコードが揃う（= undefined でなくなる）まで待つ。autofill 行は両者より後に届き得るため
+// 確定条件には入れない。遅れて届いた場合は、再度この関数を通せば補われる。
+const URL_MARKER = 'Please visit the following URL:';
+const CODE_MARKER = 'Then enter the code:';
+/**
+login-registry.ts が chunk 単位の再 parse を絞り込むのに使うため export する。
+*/
+export const AUTOFILL_MARKER = 'Alternatively, you may visit the following URL which will autofill the code upon loading:';
+/**
+マーカー以降で最初に現れる URL 行。
+*/
+const URL_LINE = /^https?:\/\/\S+$/;
+/**
+認証コード行（`ZHJW-WDMF` のようなハイフン区切りの英数）。
+*/
+const CODE_LINE = /^[\dA-Z]{4,}-[\dA-Z]{4,}$/;
+/**
+マーカー行より後で、pattern へ最初に一致する行を返す。
+
+行は trim してから見る。マーカーの比較を完全一致にするためと、CRLF が混在したときに
+末尾の `\r` で URL 行の `$` が外れるのを防ぐため。
+*/
+function findAfterMarker(lines, marker, pattern) {
+    const markerIndex = lines.indexOf(marker);
+    return markerIndex === -1 ? undefined : lines.slice(markerIndex + 1).find(line => pattern.test(line));
+}
+/**
+累積した出力から認証 URL とコードを取り出す。両方が揃うまでは undefined を返す。
+
+片方だけ返さないのは、URL だけを先に応答へ載せても利用者が認証を完了できないため。
+autofill URL は揃っていれば載せるだけで、これを待って確定を遅らせることはしない。
+*/
+export function parseSsoLoginOutput(text) {
+    const lines = text.split('\n').map(line => line.trim());
+    const verificationUrl = findAfterMarker(lines, URL_MARKER, URL_LINE);
+    const userCode = findAfterMarker(lines, CODE_MARKER, CODE_LINE);
+    if (verificationUrl === undefined || userCode === undefined)
+        return undefined;
+    const verificationUrlComplete = findAfterMarker(lines, AUTOFILL_MARKER, URL_LINE);
+    return {
+        verificationUrl,
+        userCode,
+        ...(verificationUrlComplete !== undefined && { verificationUrlComplete }),
+    };
+}
+//# sourceMappingURL=sso-output.js.map

package/cli/dist/infra/awscli.d.ts

@@ -0,0 +1,104 @@
+/**
+起動するコマンド。PATH 解決に委ねる（絶対パス指定はしない）。
+
+SSO のログインレジストリ（infra/sso/login-registry.ts）も同じコマンドで spawn するため
+export する。片方だけ絶対パス化するような差が入らないようにしておく。
+*/
+export declare const AWSCLI_COMMAND = "aws";
+/**
+awscli 出力の上限（バイト、research R8）。
+
+応答へ載せる際の切り詰め（mcp/result.ts の limitOutput）と、本モジュールの捕捉上限が
+同じ値を基準にする。依存方向が infra → mcp を許さないため、定義は infra に置く。
+*/
+export declare const OUTPUT_LIMIT_BYTES: number;
+/**
+子プロセスの stdout / stderr を捕捉する上限（バイト）。超過分は捨てる。
+
+research R8 の `filter-log-events` は既定 10,000 件で数 MiB になり得る。全件を溜めると
+同時実行数（4）と掛かってサーバの常駐メモリに直結するため、応答上限の 4 倍で打ち切る
+（切り詰め後の応答に必要な分は必ず残る）。
+*/
+export declare const CAPTURE_LIMIT_BYTES: number;
+/**
+生存中の awscli 子プロセス全てへ SIGTERM を送る。
+
+終了処理（mcp/serve.ts の onShutdown）から呼ぶ。既に終了した子への kill は no-op で、
+finalize 側が Set から外すため二重送出にはならない。
+*/
+export declare function killRunningAwscli(): void;
+/**
+子プロセスの実行結果。
+*/
+export interface SpawnResult {
+    readonly exitCode: number | null;
+    readonly signal: NodeJS.Signals | null;
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly timedOut: boolean;
+    /**
+    spawn 自体が失敗したときの errno（ENOENT 等）。成功時はキーごと無い。
+    */
+    readonly spawnErrorCode?: string;
+}
+export interface RunAwscliOptions {
+    readonly timeoutMs: number;
+    /**
+    呼び出し元がキャンセルされたら子プロセスへ SIGTERM を送る（任意）。
+  
+    MCP の tools/call は ToolCallContext.signal でキャンセルされる。配線しないと、クライアントが
+    諦めたあとも awscli が孤児として動き続ける。
+    */
+    readonly signal?: AbortSignal | undefined;
+}
+/**
+捕捉した stderr と、spawn の error から得た追加行を 1 本に束ねる。
+*/
+export declare function mergeStderr(captured: string, extra: string): string;
+/**
+上限まで chunk を溜める入れ物。
+*/
+export interface OutputCapture {
+    push(chunk: Readonly<Buffer>): void;
+    text(): string;
+}
+/**
+CAPTURE_LIMIT_BYTES まで溜め、超過分は捨てる capture を作る。
+
+SSO のログインレジストリ（infra/sso/login-registry.ts）も同じ上限で子プロセスの出力を
+溜めるため export する。上限が呼び出し元ごとに割れると、常駐メモリの見積もりが立たなくなる。
+*/
+export declare function createCapture(): OutputCapture;
+/**
+`aws <args>` を起動し、CAPTURE_LIMIT_BYTES まで capture した stdout / stderr を返す。
+
+timeout 到達・abort では SIGTERM を送り、`timedOut` / signal を結果へ載せる。
+起動 error は reject せず `exitCode: null` + `spawnErrorCode` に詰める。
+そのため呼び出し側は、失敗種別の判定を 1 か所（classifyFailure）に集約できる。
+*/
+export declare function runAwscli(arguments_: readonly string[], options: Readonly<RunAwscliOptions>): Promise<SpawnResult>;
+/**
+awscli の存在と版の確認結果。
+*/
+export type AwscliProbe = {
+    readonly ok: true;
+    readonly version: string;
+} | {
+    readonly ok: false;
+    readonly category: 'awscli-missing';
+    readonly message: string;
+};
+/**
+awscli の存在と版を確認し、成功結果だけをプロセス内に記憶する。
+
+毎回 `aws --version` を起こすとツール 1 件あたりの子プロセスが 2 本になるため、
+Promise 自体を memo する（並行呼び出しでも実行は 1 回）。
+ただし失敗（未導入・版不足）を memo すると、利用者が awscli を導入してもサーバ再起動まで全ツールが awscli-missing を返し続ける。
+そのため失敗時は memo を捨てて、次の呼び出しで再判定する。
+*/
+export declare function ensureAwscli(): Promise<AwscliProbe>;
+/**
+memo を捨てる。テストが版・PATH を差し替えるときに使う。
+*/
+export declare function resetAwscliProbe(): void;
+//# sourceMappingURL=awscli.d.ts.map

package/cli/dist/infra/awscli.js

@@ -0,0 +1,245 @@
+// awscli の子プロセス実行。
+//
+// shell:false で起動するため、引数配列の要素はそのまま 1 値として awscli に渡る
+// （連結や特殊文字による別コマンド委譲が構造的に起きない）。timeout / AbortSignal は
+// SIGTERM で子を落とし、起動失敗（ENOENT 等）は reject せず spawnErrorCode に詰める。
+import { spawn } from 'node:child_process';
+/**
+起動するコマンド。PATH 解決に委ねる（絶対パス指定はしない）。
+
+SSO のログインレジストリ（infra/sso/login-registry.ts）も同じコマンドで spawn するため
+export する。片方だけ絶対パス化するような差が入らないようにしておく。
+*/
+export const AWSCLI_COMMAND = 'aws';
+/**
+`aws --version` の待ち時間。実処理の timeout とは別枠。
+*/
+const PROBE_TIMEOUT_MS = 15_000;
+/**
+要求する最低版 [major, minor, patch]（research R5: `--use-device-code` は awscli 2.22 以降）。
+*/
+const MINIMUM_VERSION = [2, 22, 0];
+/**
+message に載せる最低版の表記。
+*/
+const MINIMUM_VERSION_TEXT = MINIMUM_VERSION.join('.');
+const VERSION_PATTERN = /aws-cli\/(\d+)\.(\d+)\.(\d+)/;
+/**
+awscli 出力の上限（バイト、research R8）。
+
+応答へ載せる際の切り詰め（mcp/result.ts の limitOutput）と、本モジュールの捕捉上限が
+同じ値を基準にする。依存方向が infra → mcp を許さないため、定義は infra に置く。
+*/
+export const OUTPUT_LIMIT_BYTES = 256 * 1024;
+/**
+子プロセスの stdout / stderr を捕捉する上限（バイト）。超過分は捨てる。
+
+research R8 の `filter-log-events` は既定 10,000 件で数 MiB になり得る。全件を溜めると
+同時実行数（4）と掛かってサーバの常駐メモリに直結するため、応答上限の 4 倍で打ち切る
+（切り詰め後の応答に必要な分は必ず残る）。
+*/
+export const CAPTURE_LIMIT_BYTES = OUTPUT_LIMIT_BYTES * 4;
+/**
+生存中の awscli 子プロセス。
+
+runAwscli が spawn 直後に足し、finalize（close / error のどちらか先）で外す。
+サーバが SIGTERM で畳まれるときは親が先に消える。
+そのため、ここを辿って子へも SIGTERM を送らないと、子が PPID 1 へ再親付けされて動き続ける。
+timeout を張っていた親が居なくなるので、打ち切りも働かない。
+*/
+const runningChildren = new Set();
+/**
+生存中の awscli 子プロセス全てへ SIGTERM を送る。
+
+終了処理（mcp/serve.ts の onShutdown）から呼ぶ。既に終了した子への kill は no-op で、
+finalize 側が Set から外すため二重送出にはならない。
+*/
+export function killRunningAwscli() {
+    for (const child of runningChildren)
+        child.kill('SIGTERM');
+}
+function errorCodeOf(error) {
+    return 'code' in error && typeof error.code === 'string' ? error.code : undefined;
+}
+/**
+捕捉した stderr と、spawn の error から得た追加行を 1 本に束ねる。
+*/
+export function mergeStderr(captured, extra) {
+    if (extra === '')
+        return captured;
+    if (captured === '')
+        return extra;
+    return `${captured}\n${extra}`;
+}
+/**
+CAPTURE_LIMIT_BYTES まで溜め、超過分は捨てる capture を作る。
+
+SSO のログインレジストリ（infra/sso/login-registry.ts）も同じ上限で子プロセスの出力を
+溜めるため export する。上限が呼び出し元ごとに割れると、常駐メモリの見積もりが立たなくなる。
+*/
+export function createCapture() {
+    const chunks = [];
+    let captured = 0;
+    return {
+        push(chunk) {
+            const room = CAPTURE_LIMIT_BYTES - captured;
+            if (room <= 0)
+                return;
+            const copied = Buffer.from(chunk.subarray(0, Math.min(room, chunk.length)));
+            captured += copied.length;
+            chunks.push(copied);
+        },
+        text() {
+            return Buffer.concat(chunks).toString('utf8');
+        },
+    };
+}
+/**
+`aws <args>` を起動し、CAPTURE_LIMIT_BYTES まで capture した stdout / stderr を返す。
+
+timeout 到達・abort では SIGTERM を送り、`timedOut` / signal を結果へ載せる。
+起動 error は reject せず `exitCode: null` + `spawnErrorCode` に詰める。
+そのため呼び出し側は、失敗種別の判定を 1 か所（classifyFailure）に集約できる。
+*/
+export async function runAwscli(arguments_, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types -- AbortSignal は内部状態を持つ
+options) {
+    return new Promise((resolve) => {
+        const stdoutCapture = createCapture();
+        const stderrCapture = createCapture();
+        let isTimedOut = false;
+        let isSettled = false;
+        const child = spawn(AWSCLI_COMMAND, [...arguments_], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: false,
+        });
+        runningChildren.add(child);
+        const timer = setTimeout(() => {
+            isTimedOut = true;
+            child.kill('SIGTERM');
+        }, options.timeoutMs);
+        timer.unref();
+        // abort 済みの signal に後からリスナを足しても発火しないため、現在値を先に見てから購読する。
+        const onAbort = () => {
+            child.kill('SIGTERM');
+        };
+        if (options.signal?.aborted === true)
+            onAbort();
+        else
+            options.signal?.addEventListener('abort', onAbort, { once: true });
+        child.stdout.on('data', (chunk) => {
+            stdoutCapture.push(chunk);
+        });
+        child.stderr.on('data', (chunk) => {
+            stderrCapture.push(chunk);
+        });
+        const finalize = (exitCode, signal, extraStderr, spawnErrorCode) => {
+            if (isSettled)
+                return;
+            isSettled = true;
+            runningChildren.delete(child);
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', onAbort);
+            // ENOENT 等で 'error' の直後に 'close' も発火する Node の仕様に対し、二重 finalize は
+            // settled で抑止している。稀に child が生存したまま残る場合への防御で kill しておく。
+            // 通常の close 後もここを通る（Node 24 の確認で child.killed は false のまま）。
+            // ただし _handle が既に null で kill() は no-op のため無害。
+            // catch は防御網で、通常は到達しない。
+            /* c8 ignore start -- catch 節（既に終了済みの kill が throw する場合）は観測されない防御網 */
+            if (!child.killed) {
+                try {
+                    child.kill();
+                }
+                catch {
+                    // 既に終了済みの場合の防御。SpawnResult には影響しないので握り潰す。
+                }
+            }
+            /* c8 ignore stop */
+            resolve({
+                exitCode,
+                signal,
+                stdout: stdoutCapture.text(),
+                stderr: mergeStderr(stderrCapture.text(), extraStderr),
+                timedOut: isTimedOut,
+                ...(spawnErrorCode !== undefined && { spawnErrorCode }),
+            });
+        };
+        child.on('error', (error) => {
+            // eslint-disable-next-line unicorn/no-null -- exitCode / signal は SpawnResult 契約で null
+            finalize(null, null, error.message, errorCodeOf(error));
+        });
+        child.on('close', (code, signal) => {
+            finalize(code, signal, '');
+        });
+    });
+}
+/**
+確認結果の memo。外から差し替えられるよう、プロパティを持つ入れ物にしている。
+*/
+const probeCache = { pending: undefined };
+/**
+検出した版が最低版以上か。
+
+major / minor / patch を 1 つの数へ畳む比較は minor / patch が 1000 以上で桁が衝突するため、
+上位から順に見るタプル比較にする。
+*/
+function isAtLeastMinimum(major, minor, patch) {
+    const [minimumMajor, minimumMinor, minimumPatch] = MINIMUM_VERSION;
+    if (major !== minimumMajor)
+        return major > minimumMajor;
+    if (minor !== minimumMinor)
+        return minor > minimumMinor;
+    return patch >= minimumPatch;
+}
+async function probeAwscli() {
+    const result = await runAwscli(['--version'], { timeoutMs: PROBE_TIMEOUT_MS });
+    if (result.spawnErrorCode === 'ENOENT') {
+        return {
+            ok: false,
+            category: 'awscli-missing',
+            message: `awscli が見つかりません。awscli v2 (${MINIMUM_VERSION_TEXT} 以上) を導入して PATH を通してください`,
+        };
+    }
+    const matched = VERSION_PATTERN.exec(`${result.stdout}\n${result.stderr}`) ?? undefined;
+    if (matched === undefined) {
+        return {
+            ok: false,
+            category: 'awscli-missing',
+            message: `awscli の版を判定できませんでした: ${result.stdout.trim()}`,
+        };
+    }
+    const major = Number(matched[1]);
+    const minor = Number(matched[2]);
+    const patch = Number(matched[3]);
+    const version = `${String(major)}.${String(minor)}.${String(patch)}`;
+    return isAtLeastMinimum(major, minor, patch)
+        ? { ok: true, version }
+        : {
+            ok: false,
+            category: 'awscli-missing',
+            message: `awscli ${MINIMUM_VERSION_TEXT} 以上が必要です（検出: ${version}）`,
+        };
+}
+/**
+awscli の存在と版を確認し、成功結果だけをプロセス内に記憶する。
+
+毎回 `aws --version` を起こすとツール 1 件あたりの子プロセスが 2 本になるため、
+Promise 自体を memo する（並行呼び出しでも実行は 1 回）。
+ただし失敗（未導入・版不足）を memo すると、利用者が awscli を導入してもサーバ再起動まで全ツールが awscli-missing を返し続ける。
+そのため失敗時は memo を捨てて、次の呼び出しで再判定する。
+*/
+export async function ensureAwscli() {
+    const pending = probeCache.pending ?? probeAwscli();
+    probeCache.pending = pending;
+    const resolved = await pending;
+    if (!resolved.ok && probeCache.pending === pending)
+        probeCache.pending = undefined;
+    return resolved;
+}
+/**
+memo を捨てる。テストが版・PATH を差し替えるときに使う。
+*/
+export function resetAwscliProbe() {
+    probeCache.pending = undefined;
+}
+//# sourceMappingURL=awscli.js.map

package/cli/dist/infra/ignore-rejection.d.ts

@@ -0,0 +1,6 @@
+/**
+promise の完了を待ち、失敗は捨てる。
+後始末のように、失敗しても呼び出し側の結果に影響しない処理で使う。
+*/
+export declare function ignoreRejection(promise: PromiseLike<unknown>): Promise<void>;
+//# sourceMappingURL=ignore-rejection.d.ts.map