@takagaki/cortex-decisions-viewer 0.12.74 → 0.12.76

package/dist/repo.js

@@ -8,6 +8,7 @@ exports.classifyCommit = classifyCommit;
 exports.isFrontmatterKeyRename = isFrontmatterKeyRename;
 exports.collectAiChangeHistory = collectAiChangeHistory;
 exports.collectGoldCommitIdentities = collectGoldCommitIdentities;
+exports.readBlobsAt = readBlobsAt;
 exports.lastSubstantiveUpdate = lastSubstantiveUpdate;
 const node_child_process_1 = require("node:child_process");
 /**
@@ -825,6 +826,85 @@ function collectGoldCommitIdentities(cwd) {
     }
     return map;
 }
+/**
+ * 指定のコミットのファイルの中身を**まとめて 1 回**読む（`git cat-file --batch`）。
+ *
+ * 🔴 **レコードごとにプロセスを起こさない。** 帯（印）の判定は「人が確認した版と今の版で
+ * 説明文・本文が変わったか」を見るので、確認の基準コミットのレコードを読む必要がある。
+ * ここで `git show` をレコードごとに叩くと、用語が 1400 件ある案件でビルドが 1400 回
+ * git を起こす——`collectGoldCommitIdentities` と同じく「git の呼び出しはレコード数に
+ * 依存しない」の規律を保つため、key を stdin に流し込む `--batch` を 1 回だけ使う。
+ *
+ * @param keys `<commit>:<path>` の列（重複は畳む）。**空なら git を起こさない**。
+ *   🔴 **改行を含む key は git に渡す前に落とす**（`--batch` の問い合わせは 1 行 1 件なので、
+ *   1 つでも混ざると以降の key が**全部 1 つずつずれ**、`a.md` の中身が `b.md` として返る）
+ * @returns 引けた key → 中身（utf8）。**引けなかった key は入れない**——呼び出し側は
+ *   「入っていない ＝ 引けなかった（窓の外・改名・削除）」として扱うこと。
+ *   `missing` と「引けたが空」を言い分けるために、キーの有無で表す
+ */
+function readBlobsAt(cwd, keys) {
+    const out = new Map();
+    // 🔴 **改行（LF / CR）を含む key を git に渡さない。** `cat-file --batch` の問い合わせは
+    // 「1 行 1 件」で、応答も**問い合わせた順**に並ぶ前提でここは読んでいる。改行入りの key が
+    // 1 つ混ざると git はそれを 2 件として扱い、**そこから先の対応がすべて 1 つずれる**
+    // ——実測で `c.md` の欄に `b.md` の中身が入った（＝印の判定を他人の版と比べる）。
+    // ファイル名に改行を入れられる案件は稀だが、**壊れ方が「引けない」ではなく「別人の中身」**
+    // なので、落として「引けなかった」に倒す（呼び出し側は印を出さない側へ倒れる）
+    const wanted = [...new Set(keys.filter((k) => k !== "" && !/[\r\n]/.test(k)))];
+    if (!wanted.length)
+        return out;
+    let buf;
+    try {
+        buf = (0, node_child_process_1.execFileSync)("git", 
+        // 出力の形を読む人の git 設定に左右させない（gitLog と同じ理由）。
+        // `--batch` は素の中身をそのまま出すので、ここで要るのは色と引用の抑止だけ
+        ["-c", "core.quotepath=false", "-c", "color.ui=false", "cat-file", "--batch"], {
+            cwd,
+            // 🔴 **`input` を渡すので `gitLog` は使えない**（あちらは stdin を ignore している）。
+            //
+            // ⚠️ **末尾の改行は「無いと最後の 1 件が読まれない」ではない**（2026-09-20 に実測で訂正）。
+            // git 2.43 は EOF で最後の行を読むので、付けても付けなくても応答は 1 バイトも変わらない
+            // ——**テストで守れる不変条件ではない**（変異を当てても緑のまま）。それでも付けるのは、
+            // `--batch` の入力が「1 行 1 件」だと綴りの上で言い切るため（行の途中で EOF にしない）
+            input: wanted.join("\n") + "\n",
+            stdio: ["pipe", "pipe", "ignore"],
+            // 🔴 **Buffer で受ける。** ヘッダの size は**バイト数**なので、文字で数えると
+            // 日本語のレコード（実データはほぼ全部）で切り出し位置がずれる
+            maxBuffer: 256 * 1024 * 1024,
+        });
+    }
+    catch (e) {
+        // git が無い（ENOENT）・リポジトリでない（128）は既定の状態なので警告しない
+        //（`gitLog` と同じ規律）。戻り値は空＝「1 件も引けなかった」で、呼び出し側は
+        // 印を立てない側に倒れる（誤報より無言）
+        const err = e;
+        if (err.code !== "ENOENT" && err.status !== 128) {
+            console.warn(`人が確認した版の中身を git から取れませんでした（印は出さずに続けます）: ${String(e)}`);
+        }
+        return out;
+    }
+    // 応答は**問い合わせた順**に並ぶ。引けた行は `<oid> blob <size>` ＋ 中身、
+    // 引けない行は `<key> missing`（key をそのまま返すので oid の形に当たらない）
+    let pos = 0;
+    for (const key of wanted) {
+        if (pos >= buf.length)
+            break;
+        const nl = buf.indexOf(0x0a, pos);
+        if (nl < 0)
+            break;
+        const header = buf.toString("utf8", pos, nl);
+        pos = nl + 1;
+        const m = /^([0-9a-f]{40,64}) (\S+) (\d+)$/.exec(header);
+        // `missing` / `ambiguous` の行は中身が続かないので、次の key へ進むだけ
+        if (!m)
+            continue;
+        const size = Number(m[3]);
+        if (m[2] === "blob")
+            out.set(key, buf.toString("utf8", pos, pos + size));
+        pos += size + 1; // 中身の後ろに git が付ける改行
+    }
+    return out;
+}
 function lastSubstantiveUpdate(cwd, repoPath) {
     // 🔴 **浅い clone を最初に弾く。** 浅い clone では境界コミットが親を持たないため、
     // このファイルを触っていない直近のコミットまで `A <path>` として現れる（実測）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takagaki/cortex-decisions-viewer",
-  "version": "0.12.74",
+  "version": "0.12.76",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,