@exabugs/dynamodb-client 1.19.0 → 1.20.0

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.20.0] - 2026-10-24
+
+### Added
+
+- **CLI `dynamodb-system-change start|finish`**（ADR 0006 の段階 5 = (c)）: terraform の apply・destroy の開始と終了を、記録 Lambda（`<app>-<env>-system-change-recorder`）に送る。asanowa・astro の `terraform-wrapper.sh` の記録の部分（開始・終了の呼び出し、`details` の組み立て、`parse-lambda-releases.py`）を Node にした。bash のラッパーは各アプリに残り、記録だけを委ねる。経路は従来と同じ AWS CLI の `aws lambda invoke`、送る本文も同じ。**記録の失敗・引数の誤りでも終了コード 0**（apply を止めない）。start は変更 ID（ULID）を標準出力に出し、ラッパーが finish の `--change-id` に渡す。両アプリの差（アプリ名、git の場所と未コミットの変更を調べる場所、`lambdaReleases` の切り詰め）は引数で渡す。使い方は `docs/SYSTEM_CHANGES.md` の「記録の CLI」
+- `@exabugs/dynamodb-client/system-changes/cli`: `extractLambdaReleases`（`parse-lambda-releases.py` の移植。出力は同じ）、`buildFinishDetails` / `limitReleases` / `resourceCountsOf`、`main` / `parseRecordArgs`、型
+
 ## [1.19.0] - 2026-10-24
 
 ### Added

package/README.md

@@ -198,7 +198,7 @@ const article = await articles.findOne({ title: 'Hello DynamoDB' });
 - **[疎な検索の警告と対応](docs/SCAN_WARNING.md)** - 検索を打ち切らず、警告(SPARSE_SCAN)で気づいてインデックス・スキーマ・ロジックを見直す
 - **[Records クライアントのヘルパー](docs/RECORDS_CLIENT.md)** - Lambda から Records を呼ぶ定型（`createRecordsClient` / `withCollection` / `lazyCollection`）
 - **[運用通知](docs/NOTIFY.md)** - ログ・アラームを、Slack・メールで管理者へ通知する部品（`@exabugs/dynamodb-client/notify`）
-- **[システム変更履歴](docs/SYSTEM_CHANGES.md)** - インフラの変更・リリースを `systemChanges` に記録し、Slack に送る部品と記録 Lambda のハンドラ（`@exabugs/dynamodb-client/system-changes`）
+- **[システム変更履歴](docs/SYSTEM_CHANGES.md)** - インフラの変更・リリースを `systemChanges` に記録し、Slack に送る部品と記録 Lambda のハンドラ（`@exabugs/dynamodb-client/system-changes`）、terraform のラッパーから記録する CLI（`dynamodb-system-change`）
 - **[Deployment](docs/DEPLOYMENT.md)** - Production deployment guide
 - **[Terraform Modules](terraform/README.md)** - Infrastructure as Code
 

package/bin/dynamodb-system-change.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+
+/**
+ * terraform の apply・destroy のシステム変更履歴への記録（docs/SYSTEM_CHANGES.md の「記録の CLI」）
+ */
+import '../dist/tools/dynamodb-system-change/run.js';

package/dist/server/handler.cjs

@@ -1,5 +1,5 @@
-// @exabugs/dynamodb-client v1.19.0
-// Built: 2026-10-24T07:44:43.731Z
+// @exabugs/dynamodb-client v1.20.0
+// Built: 2026-10-24T11:55:31.940Z
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -38980,7 +38980,7 @@ async function handler(event) {
       return createCorsResponse(HTTP_STATUS.OK);
     }
     if (event.requestContext.http.method === "GET" && event.requestContext.http.path === "/version") {
-      const version = "1.19.0";
+      const version = "1.20.0";
       return createSuccessResponse({ version, timestamp: (/* @__PURE__ */ new Date()).toISOString() }, requestId);
     }
     if (event.requestContext.http.method !== "POST") {

package/dist/server/media-handler.cjs

@@ -1,5 +1,5 @@
-// @exabugs/dynamodb-client v1.19.0
-// Built: 2026-10-24T07:44:43.731Z
+// @exabugs/dynamodb-client v1.20.0
+// Built: 2026-10-24T11:55:31.940Z
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/dist/server/media-process-handler-dlq.cjs

@@ -1,5 +1,5 @@
-// @exabugs/dynamodb-client v1.19.0
-// Built: 2026-10-24T07:44:43.731Z
+// @exabugs/dynamodb-client v1.20.0
+// Built: 2026-10-24T11:55:31.940Z
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/dist/server/media-process-handler.cjs

@@ -1,5 +1,5 @@
-// @exabugs/dynamodb-client v1.19.0
-// Built: 2026-10-24T07:44:43.731Z
+// @exabugs/dynamodb-client v1.20.0
+// Built: 2026-10-24T11:55:31.940Z
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/dist/tools/dynamodb-system-change/cli.d.ts

@@ -0,0 +1,35 @@
+import { type ReleasesLimit } from './details.js';
+import { type RunCommand } from './send.js';
+export interface CliIo {
+    out: (s: string) => void;
+    /** 標準エラー（改行は呼び出し側が付ける。バイト列も受ける） */
+    err: (s: string | Buffer) => void;
+}
+export interface CliDeps {
+    env?: NodeJS.ProcessEnv;
+    run?: RunCommand;
+    newChangeId?: () => string;
+    actor?: () => string;
+}
+export declare const USAGE = "\u4F7F\u3044\u65B9:\n  dynamodb-system-change start  --app <app> --env <env> --command <cmd> [\u5171\u901A]\n      \u2192 \u5909\u66F4 ID\uFF08ULID\uFF09\u3092\u6A19\u6E96\u51FA\u529B\u306B\u51FA\u3059\uFF08SKIP_CHANGE_RECORD=1 \u3067\u306F\u4F55\u3082\u51FA\u3055\u306A\u3044\uFF09\n  dynamodb-system-change finish --app <app> --env <env> --command <cmd> --exit-code <n>\n                                [--change-id <id>] [--log <file>] [\u5171\u901A]\n\n  --app <app>                \u30A2\u30D7\u30EA\u540D\uFF08details.app\u3002\u65E2\u5B9A\u306E\u95A2\u6570\u540D\u30FB\u5BFE\u8C61\u306B\u4F7F\u3046\uFF09\n  --env <env>                \u74B0\u5883\uFF08details.env\uFF09\n  --command <cmd>            \u30E9\u30C3\u30D1\u30FC\u306E\u30B3\u30DE\u30F3\u30C9\uFF08details.command\u3002destroy \u3067\u306F\u30EA\u30EA\u30FC\u30B9\u3092\u53D6\u308A\u51FA\u3055\u306A\u3044\uFF09\n  --exit-code <n>            terraform \u306E\u7D42\u4E86\u30B3\u30FC\u30C9\uFF080 = succeeded\u3001\u305D\u308C\u4EE5\u5916 = failed\u30020 \u4EE5\u5916\u306F details.exit_code\uFF09\n  --change-id <id>           start \u304C\u51FA\u3057\u305F\u5909\u66F4 ID\uFF08\u7A7A\u306A\u3089 changeId \u306A\u3057\u3067\u8A18\u9332\uFF09\n  --log <file>               plan / apply \u306E\u30ED\u30B0\uFF08\u4EF6\u6570\u3068 Lambda \u306E\u30EA\u30EA\u30FC\u30B9\u3092\u53D6\u308A\u51FA\u3059\uFF09\n\u5171\u901A:\n  --repo <dir>               git \u3092\u5B9F\u884C\u3059\u308B\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\uFF08\u65E2\u5B9A: \u30AB\u30EC\u30F3\u30C8\u30C7\u30A3\u30EC\u30AF\u30C8\u30EA\uFF09\n  --dirty-path <path>...     \u672A\u30B3\u30DF\u30C3\u30C8\u306E\u5909\u66F4\u3092\u8ABF\u3079\u308B\u5834\u6240\uFF08\u3042\u308C\u3070 commit \u306B -dirty\u3002\u65E2\u5B9A: \u4F5C\u696D\u30C4\u30EA\u30FC\u5168\u4F53\uFF09\n  --function <name>          \u8A18\u9332 Lambda\uFF08\u65E2\u5B9A: <app>-<env>-system-change-recorder\uFF09\n  --target <target>          \u5BFE\u8C61\uFF08\u65E2\u5B9A: terraform:<app>\uFF09\n  --region <region>          \u65E2\u5B9A: AWS_REGION\u3001\u7121\u3051\u308C\u3070 ap-northeast-1\n  --releases-max-items <n|none>  lambdaReleases \u306E\u4EF6\u6570\u306E\u4E0A\u9650\uFF08\u65E2\u5B9A: none\uFF09\n  --releases-max-bytes <n|none>  lambdaReleases \u306E JSON \u306E\u30D0\u30A4\u30C8\u6570\u306E\u4E0A\u9650\uFF08\u65E2\u5B9A: 3000\uFF09\n\n\u74B0\u5883\u5909\u6570: RECORD_DRY_RUN=1\uFF08\u547C\u3073\u51FA\u3055\u305A\u3001\u9001\u308B\u5185\u5BB9\u3092\u6A19\u6E96\u30A8\u30E9\u30FC\u306B\u51FA\u3059\uFF09\u3001SKIP_CHANGE_RECORD=1\uFF08\u8A18\u9332\u3057\u306A\u3044\uFF09\n\u7D42\u4E86\u30B3\u30FC\u30C9: start / finish \u306F\u5E38\u306B 0\uFF08\u8A18\u9332\u306E\u5931\u6557\u3067 apply \u3092\u6B62\u3081\u306A\u3044\uFF09\u3002--help \u306F 0\u3001\u30B5\u30D6\u30B3\u30DE\u30F3\u30C9\u306E\u8AA4\u308A\u306F 2";
+export interface RecordArgs {
+    app: string;
+    env: string;
+    command: string;
+    repo?: string;
+    dirtyPaths: string[];
+    functionName: string;
+    target: string;
+    region?: string;
+    limit: ReleasesLimit;
+    exitCode?: number;
+    changeId?: string;
+    log?: string;
+}
+/** 引数を解釈する（誤りは Error）。`--change-id` と `--log` は空の値を許す（ラッパーの変数が空のとき） */
+export declare function parseRecordArgs(sub: 'start' | 'finish', argv: string[]): RecordArgs;
+/** 終了の details（件数・exit_code・lambdaReleases）。destroy ではリリースを取り出さない */
+export declare function finishDetailsOf(args: RecordArgs): Record<string, unknown>;
+/** CLI 本体。終了コードを返す（process.exitCode は run.ts が設定する） */
+export declare function main(argv: string[], io: CliIo, deps?: CliDeps): number;
+//# sourceMappingURL=cli.d.ts.map

package/dist/tools/dynamodb-system-change/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/tools/dynamodb-system-change/cli.ts"],"names":[],"mappings":"AAcA,OAAO,EAA8B,KAAK,aAAa,EAAsB,MAAM,cAAc,CAAC;AAElG,OAAO,EACL,KAAK,UAAU,EAKhB,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzB,mCAAmC;IACnC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,KAAK,wxFAsBsD,CAAC;AAEzE,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAyBD,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAsDnF;AAYD,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzE;AA8DD,uDAAuD;AACvD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,GAAE,OAAY,GAAG,MAAM,CAW1E"}

package/dist/tools/dynamodb-system-change/cli.js

@@ -0,0 +1,226 @@
+/**
+ * `dynamodb-system-change start|finish`: terraform の apply・destroy の開始と終了を、システム変更履歴に記録する
+ * （ADR 0006 の段階 5 = (c)。docs/SYSTEM_CHANGES.md の「記録の CLI」）。
+ *
+ * 各アプリの terraform-wrapper.sh（bash）は残し、記録に送る部分（開始・終了の呼び出し、details の組み立て、
+ * Lambda のリリースの取り出し）だけをこの CLI に委ねる。**記録の失敗で apply を止めない**: start / finish は、
+ * 引数の誤りを含めて、常に終了コード 0 で終わる（警告は標準エラー）。
+ *
+ * 受け渡し: start は変更 ID（ULID）を標準出力に 1 行で出す（SKIP_CHANGE_RECORD=1 では何も出さない）。
+ * ラッパーはそれをシェルの変数に持ち、finish の `--change-id` に渡す（現行の CHANGE_ID と同じ）。
+ */
+import { readFileSync } from 'node:fs';
+import { ulid } from 'ulid';
+import { DEFAULT_RELEASES_MAX_BYTES, buildFinishDetails } from './details.js';
+import { extractLambdaReleases } from './releases.js';
+import { actorOf, commitOf, sendSystemChange, } from './send.js';
+export const USAGE = `使い方:
+  dynamodb-system-change start  --app <app> --env <env> --command <cmd> [共通]
+      → 変更 ID（ULID）を標準出力に出す（SKIP_CHANGE_RECORD=1 では何も出さない）
+  dynamodb-system-change finish --app <app> --env <env> --command <cmd> --exit-code <n>
+                                [--change-id <id>] [--log <file>] [共通]
+
+  --app <app>                アプリ名（details.app。既定の関数名・対象に使う）
+  --env <env>                環境（details.env）
+  --command <cmd>            ラッパーのコマンド（details.command。destroy ではリリースを取り出さない）
+  --exit-code <n>            terraform の終了コード（0 = succeeded、それ以外 = failed。0 以外は details.exit_code）
+  --change-id <id>           start が出した変更 ID（空なら changeId なしで記録）
+  --log <file>               plan / apply のログ（件数と Lambda のリリースを取り出す）
+共通:
+  --repo <dir>               git を実行するディレクトリ（既定: カレントディレクトリ）
+  --dirty-path <path>...     未コミットの変更を調べる場所（あれば commit に -dirty。既定: 作業ツリー全体）
+  --function <name>          記録 Lambda（既定: <app>-<env>-system-change-recorder）
+  --target <target>          対象（既定: terraform:<app>）
+  --region <region>          既定: AWS_REGION、無ければ ap-northeast-1
+  --releases-max-items <n|none>  lambdaReleases の件数の上限（既定: none）
+  --releases-max-bytes <n|none>  lambdaReleases の JSON のバイト数の上限（既定: ${DEFAULT_RELEASES_MAX_BYTES}）
+
+環境変数: RECORD_DRY_RUN=1（呼び出さず、送る内容を標準エラーに出す）、SKIP_CHANGE_RECORD=1（記録しない）
+終了コード: start / finish は常に 0（記録の失敗で apply を止めない）。--help は 0、サブコマンドの誤りは 2`;
+const SINGLE = {
+    '--app': 'app',
+    '--env': 'env',
+    '--command': 'command',
+    '--repo': 'repo',
+    '--function': 'functionName',
+    '--target': 'target',
+    '--region': 'region',
+    '--exit-code': 'exitCode',
+    '--change-id': 'changeId',
+    '--log': 'log',
+    '--releases-max-items': 'maxItems',
+    '--releases-max-bytes': 'maxBytes',
+};
+function limitValue(name, v, fallback) {
+    if (v === undefined)
+        return fallback;
+    if (v === 'none')
+        return undefined;
+    if (!/^\d+$/.test(v))
+        throw new Error(`${name} は 0 以上の整数か none`);
+    return Number(v);
+}
+/** 引数を解釈する（誤りは Error）。`--change-id` と `--log` は空の値を許す（ラッパーの変数が空のとき） */
+export function parseRecordArgs(sub, argv) {
+    const v = {};
+    const dirtyPaths = [];
+    let inDirty = false;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a in SINGLE) {
+            const value = argv[++i];
+            const key = SINGLE[a];
+            const allowEmpty = key === 'changeId' || key === 'log';
+            if (value === undefined || (!allowEmpty && (value === '' || value.startsWith('--')))) {
+                throw new Error(`${a} に値が要る`);
+            }
+            v[key] = value;
+            inDirty = false;
+        }
+        else if (a === '--dirty-path') {
+            inDirty = true;
+        }
+        else if (a.startsWith('--')) {
+            throw new Error(`未知の引数: ${a}`);
+        }
+        else if (inDirty) {
+            dirtyPaths.push(a);
+        }
+        else {
+            throw new Error(`位置が不正な引数: ${a}`);
+        }
+    }
+    for (const k of ['app', 'env', 'command']) {
+        if (!v[k])
+            throw new Error(`--${k} が要る`);
+    }
+    const app = v.app;
+    const env = v.env;
+    let exitCode;
+    if (sub === 'finish') {
+        if (v.exitCode === undefined || !/^\d+$/.test(v.exitCode)) {
+            throw new Error('--exit-code に 0 以上の整数が要る');
+        }
+        exitCode = Number(v.exitCode);
+    }
+    return {
+        app,
+        env,
+        command: v.command,
+        repo: v.repo,
+        dirtyPaths,
+        functionName: v.functionName ?? `${app}-${env}-system-change-recorder`,
+        target: v.target ?? `terraform:${app}`,
+        region: v.region,
+        limit: {
+            maxItems: limitValue('--releases-max-items', v.maxItems),
+            maxBytes: limitValue('--releases-max-bytes', v.maxBytes, DEFAULT_RELEASES_MAX_BYTES),
+        },
+        exitCode,
+        changeId: v.changeId || undefined,
+        log: v.log || undefined,
+    };
+}
+/** ログを読む（読めなければ undefined。不正な UTF-8 は置き換える） */
+function readLog(path) {
+    if (!path)
+        return undefined;
+    try {
+        return readFileSync(path).toString('utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 終了の details（件数・exit_code・lambdaReleases）。destroy ではリリースを取り出さない */
+export function finishDetailsOf(args) {
+    const exitCode = args.exitCode ?? 0;
+    const logText = readLog(args.log);
+    let releases = [];
+    if (args.command !== 'destroy' && logText !== undefined) {
+        try {
+            releases = extractLambdaReleases(logText);
+        }
+        catch {
+            releases = []; // 現行: 取り出しに失敗したら []
+        }
+    }
+    try {
+        return { ...buildFinishDetails({ exitCode, logText, releases, limit: args.limit }) };
+    }
+    catch {
+        return {}; // 現行: 組み立てに失敗したら {}
+    }
+}
+function record(args, result, extra, io, deps) {
+    const env = deps.env ?? process.env;
+    let payload;
+    try {
+        payload = {
+            kind: 'infra',
+            result,
+            target: args.target,
+            commit: commitOf(args.repo, args.dirtyPaths, deps.run),
+            actor: (deps.actor ?? actorOf)(),
+            // 開始と終了の両方に付ける（記録 Lambda は details を深くマージするので、同じキーが重なっても害はない）
+            details: { ...extra, app: args.app, env: args.env, command: args.command },
+            ...(args.changeId ? { changeId: args.changeId } : {}),
+        };
+    }
+    catch {
+        io.err('[change-record] ペイロードの作成に失敗しました（記録をスキップ）\n');
+        return;
+    }
+    sendSystemChange(payload, {
+        functionName: args.functionName,
+        region: args.region || env.AWS_REGION || 'ap-northeast-1',
+        dryRun: env.RECORD_DRY_RUN === '1',
+        warn: io.err,
+        run: deps.run,
+    });
+}
+/** start / finish の本体。記録の失敗・引数の誤りでも 0 を返す */
+function runRecord(sub, argv, io, deps) {
+    const env = deps.env ?? process.env;
+    if (env.SKIP_CHANGE_RECORD === '1')
+        return 0;
+    let args;
+    try {
+        args = parseRecordArgs(sub, argv);
+    }
+    catch (e) {
+        io.err(`[change-record] 引数の誤り（記録をスキップ）: ${e.message}\n`);
+        return 0;
+    }
+    try {
+        if (sub === 'start') {
+            const changeId = (deps.newChangeId ?? ulid)();
+            // 変更 ID は、記録の成否によらず出す（終了の記録に同じ ID を付ける。現行と同じ）
+            io.out(`${changeId}\n`);
+            record({ ...args, changeId }, 'started', {}, io, deps);
+        }
+        else {
+            const result = args.exitCode === 0 ? 'succeeded' : 'failed';
+            record(args, result, finishDetailsOf(args), io, deps);
+        }
+    }
+    catch (e) {
+        io.err(`[change-record] 記録に失敗しました（処理は続行）: ${e.message}\n`);
+    }
+    return 0;
+}
+/** CLI 本体。終了コードを返す（process.exitCode は run.ts が設定する） */
+export function main(argv, io, deps = {}) {
+    const [sub, ...rest] = argv;
+    // --help はサブコマンドの位置だけで見る（start / finish の引数の値の -h を拾わない）。
+    // USAGE は標準エラーに出す（start の標準出力は変更 ID の受け渡しに使うため、汚さない）
+    if (sub === '--help' || sub === '-h') {
+        io.err(`${USAGE}\n`);
+        return 0;
+    }
+    if (sub === 'start' || sub === 'finish')
+        return runRecord(sub, rest, io, deps);
+    io.err(`サブコマンドは start か finish（got: ${sub ?? 'なし'}）\n\n${USAGE}\n`);
+    return 2;
+}
+//# sourceMappingURL=cli.js.map

package/dist/tools/dynamodb-system-change/cli.js.map

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

package/dist/tools/dynamodb-system-change/details.d.ts

@@ -0,0 +1,42 @@
+/**
+ * 終了（succeeded / failed）の記録の `details` を組み立てる（両アプリの terraform-wrapper.sh の finish_change の
+ * Python を移植したもの）。純粋な関数だけ（ファイルの読み取りは呼び出し側）。
+ */
+import { type ExtractedLambdaRelease } from './releases.js';
+/** `lambdaReleases` の切り詰めの既定（asanowa の現行: 3000 バイトまで。件数の上限なし） */
+export declare const DEFAULT_RELEASES_MAX_BYTES = 3000;
+export interface ReleasesLimit {
+    /** 件数の上限（undefined は無制限）。astro の現行は 30 */
+    maxItems?: number;
+    /** `lambdaReleases` の JSON（区切りの空白なし、UTF-8）のバイト数の上限（undefined は無制限）。asanowa の現行は 3000 */
+    maxBytes?: number;
+}
+export interface FinishDetails {
+    add?: number;
+    change?: number;
+    destroy?: number;
+    exit_code?: number;
+    lambdaReleases?: ExtractedLambdaRelease[];
+    lambdaReleasesOmitted?: number;
+}
+/** ログの最後の完了の行から、件数を取り出す（無ければ undefined） */
+export declare function resourceCountsOf(logText: string): Pick<FinishDetails, 'add' | 'change' | 'destroy'> | undefined;
+/**
+ * 失敗を先に並べ（失敗は落とさない）、上限まで残す。入らなかった件数を omitted に返す。
+ * 記録 Lambda の details の上限（4096 バイト）に収めるため
+ */
+export declare function limitReleases(releases: readonly ExtractedLambdaRelease[], limit?: ReleasesLimit): {
+    items: ExtractedLambdaRelease[];
+    omitted: number;
+};
+/**
+ * 終了の details（件数・exit_code・lambdaReleases・lambdaReleasesOmitted。キーの順も現行と同じ）。
+ * 件数は、成功（exitCode 0）でログがあるときだけ
+ */
+export declare function buildFinishDetails(input: {
+    exitCode: number;
+    logText?: string;
+    releases: readonly ExtractedLambdaRelease[];
+    limit?: ReleasesLimit;
+}): FinishDetails;
+//# sourceMappingURL=details.d.ts.map

package/dist/tools/dynamodb-system-change/details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"details.d.ts","sourceRoot":"","sources":["../../../src/tools/dynamodb-system-change/details.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,sBAAsB,EAAa,MAAM,eAAe,CAAC;AAEvE,iEAAiE;AACjE,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAC1C,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAMD,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GACd,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC,GAAG,SAAS,CAM/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAC3C,KAAK,GAAE,aAAwD,GAC9D;IAAE,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAiBtD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC5C,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,GAAG,aAAa,CAUhB"}

package/dist/tools/dynamodb-system-change/details.js

@@ -0,0 +1,59 @@
+/**
+ * 終了（succeeded / failed）の記録の `details` を組み立てる（両アプリの terraform-wrapper.sh の finish_change の
+ * Python を移植したもの）。純粋な関数だけ（ファイルの読み取りは呼び出し側）。
+ */
+import { stripAnsi } from './releases.js';
+/** `lambdaReleases` の切り詰めの既定（asanowa の現行: 3000 バイトまで。件数の上限なし） */
+export const DEFAULT_RELEASES_MAX_BYTES = 3000;
+// `Apply complete! Resources: 1 added, 2 changed, 3 destroyed.` と `Destroy complete! Resources: 3 destroyed.`
+const COMPLETE = /(?:Apply|Destroy) complete! Resources: (\d+) (?:added|destroyed)(?:, (\d+) changed, (\d+) destroyed)?/g;
+/** ログの最後の完了の行から、件数を取り出す（無ければ undefined） */
+export function resourceCountsOf(logText) {
+    const ms = [...stripAnsi(logText).matchAll(COMPLETE)];
+    const m = ms[ms.length - 1];
+    if (!m)
+        return undefined;
+    if (m[2] === undefined)
+        return { add: 0, change: 0, destroy: Number(m[1]) }; // Destroy の短い形
+    return { add: Number(m[1]), change: Number(m[2]), destroy: Number(m[3]) };
+}
+/**
+ * 失敗を先に並べ（失敗は落とさない）、上限まで残す。入らなかった件数を omitted に返す。
+ * 記録 Lambda の details の上限（4096 バイト）に収めるため
+ */
+export function limitReleases(releases, limit = { maxBytes: DEFAULT_RELEASES_MAX_BYTES }) {
+    const sorted = [
+        ...releases.filter((d) => d.result === 'failed'),
+        ...releases.filter((d) => d.result !== 'failed'),
+    ];
+    const items = [];
+    for (const d of sorted) {
+        if (limit.maxItems !== undefined && items.length >= limit.maxItems)
+            break;
+        if (limit.maxBytes !== undefined &&
+            Buffer.byteLength(JSON.stringify([...items, d]), 'utf8') > limit.maxBytes) {
+            break;
+        }
+        items.push({ target: d.target, result: d.result, change: d.change });
+    }
+    return { items, omitted: sorted.length - items.length };
+}
+/**
+ * 終了の details（件数・exit_code・lambdaReleases・lambdaReleasesOmitted。キーの順も現行と同じ）。
+ * 件数は、成功（exitCode 0）でログがあるときだけ
+ */
+export function buildFinishDetails(input) {
+    const out = {};
+    if (input.exitCode === 0 && input.logText !== undefined) {
+        Object.assign(out, resourceCountsOf(input.logText));
+    }
+    if (input.exitCode !== 0)
+        out.exit_code = input.exitCode;
+    const { items, omitted } = limitReleases(input.releases, input.limit);
+    if (items.length > 0)
+        out.lambdaReleases = items;
+    if (omitted > 0)
+        out.lambdaReleasesOmitted = omitted;
+    return out;
+}
+//# sourceMappingURL=details.js.map

package/dist/tools/dynamodb-system-change/details.js.map

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

package/dist/tools/dynamodb-system-change/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `dynamodb-system-change`（terraform の apply・destroy のシステム変更履歴への記録の CLI。ADR 0006 の段階 5）の部品。
+ * 使い方は docs/SYSTEM_CHANGES.md の「記録の CLI」
+ */
+export { USAGE, finishDetailsOf, main, parseRecordArgs } from './cli.js';
+export type { CliDeps, CliIo, RecordArgs } from './cli.js';
+export { DEFAULT_RELEASES_MAX_BYTES, buildFinishDetails, limitReleases, resourceCountsOf, } from './details.js';
+export type { FinishDetails, ReleasesLimit } from './details.js';
+export { EXTRACT_MAX_ITEMS, extractLambdaReleases, splitLines, stripAnsi } from './releases.js';
+export type { ExtractedLambdaRelease } from './releases.js';
+export { actorOf, commitOf, pythonJsonDumps, runCommand, sendSystemChange } from './send.js';
+export type { RunCommand, SendOptions, SystemChangePayload } from './send.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/dynamodb-system-change/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/dynamodb-system-change/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAChG,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7F,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/tools/dynamodb-system-change/index.js

@@ -0,0 +1,9 @@
+/**
+ * `dynamodb-system-change`（terraform の apply・destroy のシステム変更履歴への記録の CLI。ADR 0006 の段階 5）の部品。
+ * 使い方は docs/SYSTEM_CHANGES.md の「記録の CLI」
+ */
+export { USAGE, finishDetailsOf, main, parseRecordArgs } from './cli.js';
+export { DEFAULT_RELEASES_MAX_BYTES, buildFinishDetails, limitReleases, resourceCountsOf, } from './details.js';
+export { EXTRACT_MAX_ITEMS, extractLambdaReleases, splitLines, stripAnsi } from './releases.js';
+export { actorOf, commitOf, pythonJsonDumps, runCommand, sendSystemChange } from './send.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/dynamodb-system-change/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/dynamodb-system-change/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEzE,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,aAAa,EACb,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAEhG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/dist/tools/dynamodb-system-change/releases.d.ts

@@ -0,0 +1,34 @@
+/**
+ * terraform の plan / apply のログから、Lambda のコードのリリース（作成・置き換え・コードの更新）の成功・失敗を取り出す。
+ *
+ * asanowa（ADR 0044）・astro（ADR-0011）の `infra/scripts/parse-lambda-releases.py` を Node に移植したもの
+ * （両アプリの版は、ロジックが同一。違いは docstring だけ）。出力は Python 版と同じ（テストで固定）。
+ *
+ * 取り出す条件（Terraform 1.x と AWS プロバイダ 6.x の実際の出力で確認済み）:
+ * - 計画の `# <アドレス> will be created / must be replaced / will be replaced, as requested / will be updated in-place`
+ *   のうち、aws_lambda_function で、作成・置き換え、または更新で `source_code_hash` の差分があるもの（= コードが変わる）。
+ *   設定だけの更新（環境変数・同時実行数など）は、対象外
+ * - 成功: `<アドレス>: Modifications complete after … [id=<関数名>]`（更新）/ `Creation complete after … [id=<関数名>]`（作成）
+ * - 失敗: `Error: creating Lambda Function (<名前>)` / `Error: updating Lambda Function (<名前>) code` /
+ *   `Error: waiting for Lambda Function (<名前>) code update|create`（設定の更新の失敗は、対象外）
+ */
+/** 取り出した 1 件（`details.lambdaReleases` の 1 件と同じ形） */
+export interface ExtractedLambdaRelease {
+    target: string;
+    result: 'succeeded' | 'failed';
+    change: 'create' | 'replace' | 'code';
+}
+/** 取り出す上限（Python 版の MAX_ITEMS） */
+export declare const EXTRACT_MAX_ITEMS = 50;
+/** 色コード（Python 版の ANSI） */
+export declare const ANSI_PATTERN: RegExp;
+/**
+ * Python の `str.splitlines()` と同じ区切りで行に分ける（\r\n、\n、\r、\v、\f、\x1c〜\x1e、\x85、U+2028、U+2029）。
+ * 末尾の区切りの後ろに空の行を作らない
+ */
+export declare function splitLines(text: string): string[];
+/** 色コードを除く */
+export declare function stripAnsi(text: string): string;
+/** ログから Lambda のリリースを取り出す（該当が無ければ空の配列。最大 EXTRACT_MAX_ITEMS 件） */
+export declare function extractLambdaReleases(text: string): ExtractedLambdaRelease[];
+//# sourceMappingURL=releases.d.ts.map

package/dist/tools/dynamodb-system-change/releases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../../../src/tools/dynamodb-system-change/releases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,oDAAoD;AACpD,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;CACvC;AAED,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AAEpC,2BAA2B;AAC3B,eAAO,MAAM,YAAY,QAAoB,CAAC;AAsB9C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAIjD;AAED,cAAc;AACd,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAoCD,iEAAiE;AACjE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,EAAE,CA2B5E"}

package/dist/tools/dynamodb-system-change/releases.js

@@ -0,0 +1,108 @@
+/**
+ * terraform の plan / apply のログから、Lambda のコードのリリース（作成・置き換え・コードの更新）の成功・失敗を取り出す。
+ *
+ * asanowa（ADR 0044）・astro（ADR-0011）の `infra/scripts/parse-lambda-releases.py` を Node に移植したもの
+ * （両アプリの版は、ロジックが同一。違いは docstring だけ）。出力は Python 版と同じ（テストで固定）。
+ *
+ * 取り出す条件（Terraform 1.x と AWS プロバイダ 6.x の実際の出力で確認済み）:
+ * - 計画の `# <アドレス> will be created / must be replaced / will be replaced, as requested / will be updated in-place`
+ *   のうち、aws_lambda_function で、作成・置き換え、または更新で `source_code_hash` の差分があるもの（= コードが変わる）。
+ *   設定だけの更新（環境変数・同時実行数など）は、対象外
+ * - 成功: `<アドレス>: Modifications complete after … [id=<関数名>]`（更新）/ `Creation complete after … [id=<関数名>]`（作成）
+ * - 失敗: `Error: creating Lambda Function (<名前>)` / `Error: updating Lambda Function (<名前>) code` /
+ *   `Error: waiting for Lambda Function (<名前>) code update|create`（設定の更新の失敗は、対象外）
+ */
+/** 取り出す上限（Python 版の MAX_ITEMS） */
+export const EXTRACT_MAX_ITEMS = 50;
+/** 色コード（Python 版の ANSI） */
+export const ANSI_PATTERN = /\x1b\[[0-9;]*m/g;
+const ADDR = String.raw `\S*aws_lambda_function\.[A-Za-z0-9_]+(?:\[[^\]\n]*\])?`;
+// 見出しの言い方: will be created / will be updated in-place / must be replaced / will be replaced, as requested（-replace）/
+// is tainted, so must be replaced / will be destroyed
+const HEADER = new RegExp(String.raw `^\s*# (` +
+    ADDR +
+    String.raw `) (will be created|will be updated in-place|will be destroyed|` +
+    String.raw `(?:is tainted, so )?must be replaced|will be replaced, as requested)`);
+const ANY_HEADER = /^\s*# \S+ (?:will|must|is) /;
+const DONE = new RegExp('^(' + ADDR + String.raw `): (Modifications|Creation) complete after \S+ \[id=([^\]\s]+)\]`);
+const FAILED = [
+    [/Error: creating Lambda Function \(([^)\s]+)\)/, 'create'],
+    [/Error: updating Lambda Function \(([^)\s]+)\) code/, 'code'],
+    [/Error: waiting for Lambda Function \(([^)\s]+)\) code update/, 'code'],
+    [/Error: waiting for Lambda Function \(([^)\s]+)\) create/, 'create'],
+];
+/**
+ * Python の `str.splitlines()` と同じ区切りで行に分ける（\r\n、\n、\r、\v、\f、\x1c〜\x1e、\x85、U+2028、U+2029）。
+ * 末尾の区切りの後ろに空の行を作らない
+ */
+export function splitLines(text) {
+    const lines = text.split(/\r\n|[\n\r\v\f\x1c\x1d\x1e\x85\u2028\u2029]/);
+    if (lines.length > 0 && lines[lines.length - 1] === '')
+        lines.pop();
+    return lines;
+}
+/** 色コードを除く */
+export function stripAnsi(text) {
+    return text.replace(ANSI_PATTERN, '');
+}
+/** 計画の見出しから「コードが変わる Lambda のアドレス → 変更の種類」を作る */
+function codeChangesOf(lines) {
+    const changes = new Map();
+    let i = 0;
+    while (i < lines.length) {
+        const m = HEADER.exec(lines[i]);
+        if (!m) {
+            i += 1;
+            continue;
+        }
+        const [, addr, action] = m;
+        let j = i + 1;
+        while (j < lines.length &&
+            !ANY_HEADER.test(lines[j]) &&
+            !lines[j].startsWith('Plan:') &&
+            !lines[j].startsWith('Do you want')) {
+            j += 1;
+        }
+        const block = lines.slice(i + 1, j);
+        if (action === 'will be created')
+            changes.set(addr, 'create');
+        else if (action.includes('replaced'))
+            changes.set(addr, 'replace');
+        else if (action === 'will be updated in-place' &&
+            block.some((l) => l.includes('source_code_hash'))) {
+            changes.set(addr, 'code');
+        }
+        i = j;
+    }
+    return changes;
+}
+/** ログから Lambda のリリースを取り出す（該当が無ければ空の配列。最大 EXTRACT_MAX_ITEMS 件） */
+export function extractLambdaReleases(text) {
+    const lines = splitLines(text).map(stripAnsi);
+    const codeChanges = codeChangesOf(lines);
+    const out = [];
+    const seen = new Set();
+    for (const raw of lines) {
+        const line = raw.replace(/^[│ ]+/, '').trimEnd();
+        const done = DONE.exec(line);
+        const change = done ? codeChanges.get(done[1]) : undefined;
+        if (done && change) {
+            const name = done[3];
+            if (!seen.has(name)) {
+                seen.add(name);
+                out.push({ target: name, result: 'succeeded', change });
+            }
+            continue;
+        }
+        for (const [rx, failedChange] of FAILED) {
+            const m = rx.exec(line);
+            if (m && !seen.has(m[1])) {
+                seen.add(m[1]);
+                out.push({ target: m[1], result: 'failed', change: failedChange });
+                break;
+            }
+        }
+    }
+    return out.slice(0, EXTRACT_MAX_ITEMS);
+}
+//# sourceMappingURL=releases.js.map

package/dist/tools/dynamodb-system-change/releases.js.map

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

package/dist/tools/dynamodb-system-change/run.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/tools/dynamodb-system-change/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/tools/dynamodb-system-change/run.ts"],"names":[],"mappings":""}

package/dist/tools/dynamodb-system-change/run.js

@@ -0,0 +1,6 @@
+import { main } from './cli.js';
+process.exitCode = main(process.argv.slice(2), {
+    out: (s) => process.stdout.write(s),
+    err: (s) => process.stderr.write(s),
+});
+//# sourceMappingURL=run.js.map

package/dist/tools/dynamodb-system-change/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/tools/dynamodb-system-change/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IAC7C,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;CACpC,CAAC,CAAC"}

package/dist/tools/dynamodb-system-change/send.d.ts

@@ -0,0 +1,43 @@
+/** 外部コマンドの実行（テストで差し替える） */
+export type RunCommand = (command: string, args: string[], options?: {
+    cwd?: string;
+}) => {
+    status: number | null;
+    stdout: Buffer;
+    stderr: Buffer;
+    error?: Error;
+};
+export declare const runCommand: RunCommand;
+/** 記録 Lambda に送る本文（記録 Lambda の入力。キーの順は現行と同じ） */
+export interface SystemChangePayload {
+    kind: string;
+    result: 'started' | 'succeeded' | 'failed';
+    target: string;
+    commit: string;
+    actor: string;
+    details: Record<string, unknown>;
+    changeId?: string;
+}
+/**
+ * Python の `json.dumps(x, ensure_ascii=False)` と同じ文字列（区切りは `, ` と `: `）。
+ * 送る内容（--payload）と、RECORD_DRY_RUN の表示を、現行と一字一句同じにするため
+ */
+export declare function pythonJsonDumps(value: unknown): string;
+/**
+ * コミット（`git rev-parse --short HEAD`。取れなければ unknown）。dirtyPaths に未コミットの変更があれば `-dirty`
+ * （`git diff-index --quiet HEAD -- <paths>` が 0 以外。git が無い・失敗も -dirty。現行と同じ）
+ */
+export declare function commitOf(repo: string | undefined, dirtyPaths: string[], run?: RunCommand): string;
+/** 実行者（`$(whoami)@$(hostname -s)`） */
+export declare function actorOf(): string;
+export interface SendOptions {
+    functionName: string;
+    region: string;
+    dryRun: boolean;
+    /** 警告の出力先（標準エラー。バイト列も受ける） */
+    warn: (message: string | Buffer) => void;
+    run?: RunCommand;
+}
+/** 記録 Lambda を呼ぶ。失敗は警告だけ（例外にしない）。記録 Lambda が無い環境は黙ってスキップ */
+export declare function sendSystemChange(payload: SystemChangePayload, options: SendOptions): void;
+//# sourceMappingURL=send.d.ts.map

package/dist/tools/dynamodb-system-change/send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.d.ts","sourceRoot":"","sources":["../../../src/tools/dynamodb-system-change/send.ts"],"names":[],"mappings":"AAUA,2BAA2B;AAC3B,MAAM,MAAM,UAAU,GAAG,CACvB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,KACvB;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAE9E,eAAO,MAAM,UAAU,EAAE,UAQxB,CAAC;AAEF,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOtD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,GAAG,aAAa,GAAG,MAAM,CAOjG;AAED,sCAAsC;AACtC,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IACzC,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAYD,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAsCzF"}

package/dist/tools/dynamodb-system-change/send.js

@@ -0,0 +1,97 @@
+/**
+ * 記録 Lambda（`<app>-<env>-system-change-recorder`）への送信（両アプリの terraform-wrapper.sh の record_change を
+ * 移植したもの）。
+ *
+ * 経路は現行のまま: AWS CLI の `aws lambda invoke`（認証は AWS CLI の認証情報。`AWS_PROFILE` などは環境変数で
+ * 引き継ぐ）。記録の失敗は、警告を出すだけで、例外にしない（apply・destroy を止めない）。
+ */
+import { spawnSync } from 'node:child_process';
+import { hostname, userInfo } from 'node:os';
+export const runCommand = (command, args, options) => {
+    const r = spawnSync(command, args, { cwd: options?.cwd, stdio: ['ignore', 'pipe', 'pipe'] });
+    return {
+        status: r.status,
+        stdout: r.stdout ?? Buffer.alloc(0),
+        stderr: r.stderr ?? Buffer.alloc(0),
+        error: r.error,
+    };
+};
+/**
+ * Python の `json.dumps(x, ensure_ascii=False)` と同じ文字列（区切りは `, ` と `: `）。
+ * 送る内容（--payload）と、RECORD_DRY_RUN の表示を、現行と一字一句同じにするため
+ */
+export function pythonJsonDumps(value) {
+    if (Array.isArray(value))
+        return `[${value.map(pythonJsonDumps).join(', ')}]`;
+    if (value !== null && typeof value === 'object') {
+        const entries = Object.entries(value).filter(([, v]) => v !== undefined);
+        return `{${entries.map(([k, v]) => `${JSON.stringify(k)}: ${pythonJsonDumps(v)}`).join(', ')}}`;
+    }
+    return JSON.stringify(value);
+}
+/**
+ * コミット（`git rev-parse --short HEAD`。取れなければ unknown）。dirtyPaths に未コミットの変更があれば `-dirty`
+ * （`git diff-index --quiet HEAD -- <paths>` が 0 以外。git が無い・失敗も -dirty。現行と同じ）
+ */
+export function commitOf(repo, dirtyPaths, run = runCommand) {
+    const head = run('git', ['rev-parse', '--short', 'HEAD'], { cwd: repo });
+    let commit = head.status === 0 && !head.error ? head.stdout.toString('utf8').replace(/\n+$/, '') : 'unknown';
+    const diff = run('git', ['diff-index', '--quiet', 'HEAD', '--', ...dirtyPaths], { cwd: repo });
+    if (diff.status !== 0 || diff.error)
+        commit = `${commit}-dirty`;
+    return commit;
+}
+/** 実行者（`$(whoami)@$(hostname -s)`） */
+export function actorOf() {
+    return `${userInfo().username}@${hostname().split('.')[0]}`;
+}
+const PREFIX = '[change-record]';
+const NL = Buffer.from('\n');
+/** 末尾の改行（0x0a）を除く（bash の `$(...)` と同じ） */
+function trimTrailingNewlines(buf) {
+    let end = buf.length;
+    while (end > 0 && buf[end - 1] === 0x0a)
+        end -= 1;
+    return buf.subarray(0, end);
+}
+/** 記録 Lambda を呼ぶ。失敗は警告だけ（例外にしない）。記録 Lambda が無い環境は黙ってスキップ */
+export function sendSystemChange(payload, options) {
+    const body = pythonJsonDumps(payload);
+    if (options.dryRun) {
+        options.warn(`${PREFIX}[dry-run] ${options.functionName} <- ${body}\n`);
+        return;
+    }
+    const run = options.run ?? runCommand;
+    const r = run('aws', [
+        'lambda',
+        'invoke',
+        '--function-name',
+        options.functionName,
+        '--region',
+        options.region,
+        '--cli-binary-format',
+        'raw-in-base64-out',
+        '--cli-connect-timeout',
+        '5',
+        '--cli-read-timeout',
+        '30',
+        '--payload',
+        body,
+        '/dev/null',
+    ]);
+    // 現行は `out="$(… 2>&1)"`（標準出力と標準エラーをまとめ、末尾の改行を除く）
+    const errText = r.error ? Buffer.from(`${r.error.message}\n`) : Buffer.alloc(0);
+    const out = trimTrailingNewlines(Buffer.concat([r.stdout, r.stderr, errText]));
+    const text = out.toString('utf8');
+    if (r.status !== 0 || r.error) {
+        if (text.includes('ResourceNotFoundException'))
+            return; // 記録 Lambda が無い環境は、スキップ
+        // 現行は `$(echo "$out" | head -c 200)`（バイトで 200。末尾の改行は $(...) が除く）
+        const head = trimTrailingNewlines(Buffer.concat([out, NL]).subarray(0, 200));
+        options.warn(Buffer.concat([Buffer.from(`${PREFIX} 記録に失敗しました（処理は続行）: `), head, NL]));
+    }
+    else if (text.includes('"FunctionError"')) {
+        options.warn(`${PREFIX} 記録 Lambda がエラーを返しました（処理は続行）\n`);
+    }
+}
+//# sourceMappingURL=send.js.map

package/dist/tools/dynamodb-system-change/send.js.map

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

package/docs/SYSTEM_CHANGES.md

@@ -104,10 +104,77 @@ export const handler = createSystemChangeHandler({
 - 管理画面の一覧・詳細は `SystemChangesList` / `SystemChangesShow`（`@exabugs/dynamodb-client/integrations/react-admin`。1.19.0。[react-admin-integration.md](react-admin-integration.md#運用の画面alertssystemchanges)）
 - 投稿は notify の `postSlackText`（`createSlackChannel` と同じ送信。URL の接頭辞の確認、URL を出さないエラー）
 
+## 記録の CLI（`dynamodb-system-change`。1.20.0）
+
+terraform の apply・destroy の開始と終了を、記録 Lambda（`<app>-<env>-system-change-recorder`）に送る CLI（[ADR 0006](adr/0006-library-owns-table-operations.md) の段階 5 = (c)）。asanowa・astro の `terraform-wrapper.sh` の「記録に送る部分」（開始・終了の呼び出し、`details` の組み立て、`parse-lambda-releases.py`）を Node にした。**bash のラッパーは各アプリに残し**（state のバックエンド、plan の保存と確認、環境の検査はアプリごとに違う）、記録だけをこの CLI に委ねる。
+
+- 経路は従来のまま: AWS CLI の `aws lambda invoke`（`--cli-connect-timeout 5 --cli-read-timeout 30`。認証は AWS CLI の認証情報で、`AWS_PROFILE` などは環境変数で引き継ぐ）。送る本文は従来の Python の `json.dumps` と同じ文字列
+- **記録の失敗で apply を止めない**: `start` / `finish` は、記録の失敗・引数の誤りでも終了コード 0（警告は標準エラーに `[change-record] …`）。記録 Lambda が無い環境（`ResourceNotFoundException`）は黙ってスキップ。サブコマンドの誤りだけ 2
+- 受け渡し: `start` は変更 ID（ULID）を標準出力に 1 行で出す（記録の成否によらず。`SKIP_CHANGE_RECORD=1` では何も出さない）。ラッパーはシェルの変数に持ち、`finish --change-id` に渡す
+- 環境変数は従来と同じ: `RECORD_DRY_RUN=1`（呼ばずに、送る内容を表示）、`SKIP_CHANGE_RECORD=1`（記録しない）、`AWS_REGION`（無ければ `ap-northeast-1`）
+
+```text
+dynamodb-system-change start  --app <app> --env <env> --command <cmd> [共通]
+dynamodb-system-change finish --app <app> --env <env> --command <cmd> --exit-code <n> [--change-id <id>] [--log <file>] [共通]
+共通: [--repo <dir>] [--function <name>] [--target <target>] [--region <region>]
+      [--releases-max-items <n|none>] [--releases-max-bytes <n|none>] [--dirty-path <path>...]
+```
+
+| 引数                   | 内容                                                                                                                                       |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| `--app` / `--env`      | `details.app` / `details.env`。既定の関数名 `<app>-<env>-system-change-recorder` と対象 `terraform:<app>` にも使う                         |
+| `--command`            | `details.command`（`apply` / `apply-auto` / `destroy` など）。`destroy` では Lambda のリリースを取り出さない                               |
+| `--exit-code`          | terraform の終了コード。0 は `succeeded`、それ以外は `failed` と `details.exit_code`                                                       |
+| `--log`                | plan / apply のログ。成功なら最後の完了の行から `add` / `change` / `destroy`、Lambda のリリースから `lambdaReleases`                       |
+| `--repo`               | git を実行するディレクトリ（既定: カレント）。`commit` は `git rev-parse --short HEAD`（取れなければ `unknown`）                           |
+| `--dirty-path`         | 未コミットの変更を調べる場所（`git diff-index --quiet HEAD -- <path>...`）。あれば `commit` に `-dirty`。最後に書く                        |
+| `--releases-max-items` | `lambdaReleases` の件数の上限（既定 `none`）                                                                                               |
+| `--releases-max-bytes` | `lambdaReleases` の JSON のバイト数の上限（既定 3000。details の上限 4096 に収める）。失敗を先に残し、省いた件数は `lambdaReleasesOmitted` |
+
+`actor` は `<ユーザー名>@<ホスト名の先頭>`（従来の `$(whoami)@$(hostname -s)`）。
+
+### ラッパーからの呼び方
+
+`set -euo pipefail` のラッパーでも止まらないよう、呼び出しには `|| true` を付ける（CLI が入っていない・node が無いときも apply を進める）。CLI が無いときは、記録が欠けたことに気づけるよう警告を出す。記録の部分は次のとおり（`$CHANGE_LOG` と `trap` の扱い、plan の確認はアプリのまま。`<…>` はアプリごとの値）:
+
+```bash
+SYSTEM_CHANGE="<node_modules の .bin>/dynamodb-system-change"   # npx は標準出力に余計な行を出しうるので使わない
+CHANGE_ARGS=(--app "<アプリ名>" --env "$ENV" --command "$COMMAND" [--repo "<git を実行する場所>"] --dirty-path <調べる場所>...)
+
+begin_change() {
+    [ -x "$SYSTEM_CHANGE" ] || echo "[change-record] CLI がありません（記録をスキップ）" >&2
+    CHANGE_ID="$("$SYSTEM_CHANGE" start "${CHANGE_ARGS[@]}" || true)"
+    CHANGE_OPEN=1
+}
+
+finish_change() {
+    local rc=$?
+    trap - EXIT
+    if [ "$CHANGE_OPEN" = "1" ]; then
+        CHANGE_OPEN=0
+        "$SYSTEM_CHANGE" finish "${CHANGE_ARGS[@]}" --change-id "$CHANGE_ID" --exit-code "$rc" --log "$CHANGE_LOG" || true
+    fi
+    rm -f "$CHANGE_LOG"
+    return "$rc"
+}
+```
+
+アプリごとの `CHANGE_ARGS`（従来の記録と同じ commit・details になる。`lambdaReleases` の上限は、両アプリとも既定の 3000 バイトを使う）:
+
+- **asanowa**: `--app "$APP" --env "$ENV" --command "$COMMAND" --dirty-path "$INFRA_ROOT" "$INFRA_ROOT/../functions" "$INFRA_ROOT/../packages"`（`--repo` は不要。ラッパーが `cd` した先で git を実行する）
+- **astro**: `--app "$PROJECT" --env "$ENV" --command "$COMMAND" --repo "$REPO_ROOT" --dirty-path infra apps functions packages`。上限は asanowa の既定（3000 バイト）に揃える（従来の「30 件まで」はやめる。件数の上限は付けない。64 文字の名前が並ぶと 30 件 → 約 27 件になり、超えた分は `lambdaReleasesOmitted` に残る）
+
+`--releases-max-items` / `--releases-max-bytes` は、既定と違う上限が要るときだけ使う。
+
+置き換えた後は、`record_change`・`new_change_id`・`finish_change` の Python と `parse-lambda-releases.py` を消せる。両アプリの `test-terraform-wrapper.sh` は、偽の `aws` を PATH に置く方式なので、そのまま使える（1.20.0 の開発時に、両アプリの検査がこの形のラッパーで全て通ることを確かめた）。
+
+部品（`@exabugs/dynamodb-client/system-changes/cli`）: `extractLambdaReleases(logText)`（`parse-lambda-releases.py` の移植。出力は同じ）、`buildFinishDetails` / `limitReleases` / `resourceCountsOf`、`main(argv, io, deps?)`。
+
 ## テスト
 
 - 単体: `src/system-changes/__tests__/`。ハンドラは、本物の `DynamoClient` に `fetch` だけを差し替えて固定する（`connect()` の呼び忘れを見逃さない）
 - 統合（DynamoDB Local。CI には入っていない）: `src/system-changes/__tests__/system-changes.integration.test.ts`（実行方法は PUBLISHING.md）
+- CLI: `__tests__/tools/dynamodb-system-change-*.test.ts`。Lambda のリリースの取り出しは、両アプリの本物のログ（`__tests__/tools/testdata/terraform-logs`。アカウント ID・URL・Cognito のユーザープール ID・ドメインは伏せた）で Python 版と同じ出力を固定する。送り方は偽の `aws` / `git`、止めないことは `set -euo pipefail` の bash のラッパーから CLI をプロセスとして呼んで確かめる
 
 ## アプリの移行（公開後の別作業）
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exabugs/dynamodb-client",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "DynamoDB Single-Table Client SDK with MongoDB-like API, Shadow Records, and Lambda implementation for serverless applications",
   "author": "exabugs",
   "license": "MIT",
@@ -8,7 +8,8 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "dynamodb-access-check": "./bin/dynamodb-access-check.js"
+    "dynamodb-access-check": "./bin/dynamodb-access-check.js",
+    "dynamodb-system-change": "./bin/dynamodb-system-change.js"
   },
   "keywords": [
     "dynamodb",
@@ -129,6 +130,10 @@
     "./system-changes": {
       "import": "./dist/system-changes/index.js",
       "types": "./dist/system-changes/index.d.ts"
+    },
+    "./system-changes/cli": {
+      "import": "./dist/tools/dynamodb-system-change/index.js",
+      "types": "./dist/tools/dynamodb-system-change/index.d.ts"
     }
   },
   "peerDependencies": {