@takagaki/cortex-decisions-viewer 0.12.14 → 0.12.16

package/dist/repo.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_HISTORY_MAX_ENTRIES = void 0;
 exports.resolveRepo = resolveRepo;
 exports.latestGeneratedPaths = latestGeneratedPaths;
 exports.normalizeToHttps = normalizeToHttps;
+exports.classifyCommit = classifyCommit;
+exports.isFrontmatterKeyRename = isFrontmatterKeyRename;
+exports.collectAiChangeHistory = collectAiChangeHistory;
 const node_child_process_1 = require("node:child_process");
 /**
  * GitHubのowner/repoを表すベースURLを解決する。
@@ -102,3 +106,584 @@ function normalizeToHttps(url) {
     }
     return null;
 }
+// ---- AIによるレコードの変更履歴（git 由来）------------------------------------
+//
+// レコード詳細の「AIによる最近の変更」の出どころ。**以前は週次整理レポート
+// （.cortex/weekly-curation-report.json の actions）を読んでいたが、あれは毎回全置換で、
+// 翌週の実行でレポートが差し替わると前の履歴が画面から消えた**（オーナーが実際に踏んだ）。
+// 「黙って書き換えられた記録を作らない」という節の目的に対して、1週間で消える履歴は
+// 用を成さない。git のコミットは消えないので、そちらを正本にする。
+//
+// **git の呼び出しはレコード数に依存させない。ビルド1回につき2回だけ呼ぶ。**
+// レコードごとに git log を回すと、案件が育つほどビルドが線形に遅くなる。
+//
+//   パス1: --name-status  … コミットの素性（誰が・いつ・何を言って）と触ったパスだけ。出力は軽い
+//   パス2: -p -U0 --diff-filter=M … **変更（M）の差分だけ**。追加（A）の差分は取らない
+//                                   ——追加時の「変更後」はレコード本文そのもので、
+//                                     同じページに全文が既に出ている（site の JSON が二重になる）
+//
+// 例外は全部握って空を返す（latestGeneratedPaths と同じ規律）。浅い clone・git 無し・
+// メッセージ規約の変更 → 「履歴の節が出ない」だけで、他の表示は壊れない。
+/** ファイル節の始まりの印 */
+const DIFF_HEADER = "diff --" + "git ";
+/** 行頭に置いてコミットの境目を見分ける印。差分もパスも NUL では始まらない */
+const NUL = "\u0000";
+/** コミット1行の中の区切り（Unit Separator）。コミットメッセージに現れない制御文字を選ぶ */
+const US = "\u001f";
+/** 遡るコミット数の上限。深追いしてもビルドが遅くなるだけで、画面に出るのはレコードごとに数件 */
+const AI_HISTORY_MAX_COMMITS = 400;
+/** レコードごとに画面へ渡す件数（分類B・2026-08-29）。折りたたみの中でも1件が差分を持つので絞る */
+exports.AI_HISTORY_MAX_ENTRIES = 5;
+/** 変更前・変更後それぞれの文字数の上限。超えたら丸めて truncated を立てる */
+const AI_HISTORY_MAX_DIFF_CHARS = 2000;
+/** レコードのパスの形。README・雛形はレコードではない */
+const RECORD_PATH = /^Cortex\/[^/]+\/records\/[^/]+\.md$/;
+/**
+ * 下の pathspec が git 側で拾う範囲。**`RECORD_PATH` より広い。**
+ * git の pathspec の `*` は `/` をまたぐので、`Cortex/A/records/sub/x.md` のような
+ * 入れ子も git は選ぶ。**パス2へ渡す件数はこちらで数える**——狭いほうで数えると
+ * 窓が浅くなり、**窓の端の本物の変更が黙って消える**（レビューで指摘された潜在の欠陥）。
+ */
+const PATHSPEC_MATCH = /^Cortex\/.*\/records\/.*\.md$/;
+/** 探索範囲（git の pathspec）。README や Context 配下の差分は最初から出力に入れない */
+const RECORD_PATHSPEC = "Cortex/*/records/*.md";
+function classifyCommit(id) {
+    const subject = id.subject || "";
+    // 1. 人の操作の代理（infra/lambda/intake/logic.mjs の promoteCommitMessage / deleteCommitMessage）
+    if (/^(Gold確認|レコード削除)[:：]/.test(subject))
+        return "human";
+    // 2. データ構造の引っ越し。実データの件名は「エンジンマイグレーションを適用（schema_version更新）」。
+    //
+    // 🔴 **素の部分一致にしない（頭に錨を打ち、bot 名義とのANDにする）。** 夜間パイプラインの件名は
+    // **レコードの見出しを埋め込む**（実データ: 「用語集にPMプレイブック・オーケストレーター・
+    // keystoneをdraftで追加」）。素の部分一致だと、「スキーマ移行」「DBマイグレーション」という
+    // **用語が1つ登録された晩**に、そのコミットが起票したレコードが全部（実データで最大29件）
+    // 履歴から消える——しかも消えたことは画面に出ない。下の規則3が同じ理由で接頭辞に限っている。
+    if (looksLikeBot(id) && /^(エンジン)?マイグレーション|^スキーマ移行|^schema[_-]?version|^(apply\s+)?[a-z ]*migration/i.test(subject)) {
+        return "migration";
+    }
+    // 2. 夜間パイプライン（cortex-engine）の規約。**コロンより前（接頭辞）だけを見る。**
+    //    素の部分一致にすると「自動生成された用語を手で直した」「週次整理の取りこぼしを補完」
+    //    のような**人が書いた件名**まで AI に倒れ、顧客の画面に「AIがこの記録を書き換えました」と
+    //    出る（この関数が防ごうとしている誤帰属の、ちょうど逆向き）。
+    //    規約側は「Gold自動追記: …」「週次整理: …」の形なので、接頭辞で足りる。
+    //
+    //    ⚠️ **見るのは件名（%s）だけ。** latestGeneratedPaths（このファイル上部）の
+    //    `--grep` は**メッセージ本文も**対象なので、判定の範囲が揃っていない。
+    //    本文まで足すと複数行になって1行1コミットのパースが壊れるため、ここは件名に留める。
+    //    件名に規約が無く本文にだけある形で engine が回っても、**規則3（bot 名義）で拾える**
+    //    ——夜間パイプラインは GitHub Actions の bot 名義でコミットするため。
+    const scope = /^([^:：]{1,40})[:：]/.exec(subject);
+    if (scope && /自動追記|自動生成|週次整理/.test(scope[1]))
+        return "ai";
+    // 4. bot 名義
+    return looksLikeBot(id) ? "ai" : "human";
+}
+/** 夜間パイプラインの名義（GitHub Actions の bot） */
+function looksLikeBot(id) {
+    return /\[bot\]|github-actions/i.test(`${id.name || ""} ${id.email || ""}`);
+}
+/**
+ * 🔴 **フロントマターの「項目名だけ」が変わった差分か。**（purpose に依存しない構造の規則）
+ *
+ * 消えた行と増えた行が**すべて `key: value` の形**で、**値の集合が変わっていない**なら、
+ * それは項目名の付け替え＝データ構造の引っ越しであって、記録の内容の変化ではない。
+ * 実データの `summary: "X"` → `description: "X"` はこれで落ちる。件名の書き方が
+ * 変わっても落ちるので、上の件名の規則の**裏取り**になる。
+ *
+ * 一方 `definition: 旧` → `definition: 新`（本物の精製）は**値が変わる**ので残る。
+ *
+ * **片側だけの変更（追加だけ・削除だけ）は対象にしない。** 「フロントマターに項目が
+ * 1つ増えた」を機械的に落とすと、AIが definition や aliases を足した**本物の精製まで消える**。
+ * 実データの「`status:` 行の後付け」はこの規則では落とさず、件名の規則に任せる——
+ * **構造の規則は「内容が変わっていないと証明できるもの」だけに限る。**
+ */
+// ⚠️ 名前は「フロントマターの」だが、**見ているのは差分の行だけで、その行が
+// frontmatter の内側かどうかは判定していない**（差分だけでは境界が分からない）。
+// 本文に `key: value` の形の行があり、値を保ったままキーだけ変える変更は落ちる。
+// 実データではその形は1件も無いが、そういう規則だと承知して使うこと。
+function isFrontmatterKeyRename(before, after) {
+    const lines = (t) => t.split("\n").filter((l) => l.trim() !== "");
+    const bs = lines(before);
+    const as = lines(after);
+    if (!bs.length || !as.length)
+        return false;
+    const KEY_VALUE = /^\s*([A-Za-z_][\w-]*)\s*:\s*(.*)$/;
+    const parse = (arr) => {
+        const keys = [];
+        const values = [];
+        for (const l of arr) {
+            const m = KEY_VALUE.exec(l);
+            if (!m)
+                return null;
+            keys.push(m[1]);
+            values.push(m[2].trim());
+        }
+        return { keys, values };
+    };
+    const b = parse(bs);
+    const a = parse(as);
+    if (!b || !a)
+        return false;
+    const same = (x, y) => x.length === y.length && [...x].sort().join("\u0000") === [...y].sort().join("\u0000");
+    // 値が同じで、項目名が変わっている＝付け替え
+    return same(b.values, a.values) && !same(b.keys, a.keys);
+}
+/**
+ * 改名の検出。**90% 一致以上を改名とみなす。**
+ *
+ * 100%（完全一致だけ）も検討したが、**実データで唯一の「本物の改名」を取りこぼす**ことが
+ * 分かったのでやめた。カナリアの全履歴を数えた結果:
+ *
+ *   50% → 117件 / 90% → 117件 / 100% → 116件
+ *   100% だけが落とすもの: R096 gold-external-sources.json.md → dev-sources.json.md
+ *     （同じ用語の正真正銘の改名。差分は id: の1行だけ。100% だと削除＋追加に割れ、
+ *       削除で打ち切られて**改名前の起票が丸ごと消える**——直そうとしている症状そのもの）
+ *
+ * **50% まで下げても増える改名は1件も無い**（＝この案件に「似た別レコードが繋がる」形は無い）。
+ * それでも 90% に留めるのは、**誤検出の被害が重い**から——別々の記録が繋がると
+ * 「人が消した本文が別の記録のページに出る」（0.12.15 の実装レビューで直した失敗）が再発する。
+ * Gold のレコードで別々の記録が9割一致することは事実上ないので、ここが安全と実用の折り合い。
+ *
+ * 🔴 **閾値を動かすときは readDiffs の --diff-filter と mCount の数え方も一緒に見ること。**
+ * 100% 未満の改名は**中身も変わっている**ので、差分を取って「書き換え」として出す必要がある。
+ * 揃えないと、人が「改名しながら中身も直した」変更が**無音で消える**。
+ */
+const RENAME_OPT = "--find-renames=90%";
+/** git log を1回。失敗（git 無し・リポジトリでない・出力が大きすぎる）は空文字にする */
+function gitLog(cwd, args) {
+    try {
+        // 🔴 **出力の形は、読む人の git 設定に左右させない。** ここで組み立てているのは
+        // 機械が読む出力なので、人の ~/.gitconfig で形が変わる余地を全部潰す:
+        //
+        //   core.quotepath=false … 既定の git は ASCII 以外を含むパスを
+        //     `"Cortex/Glossary/records/\344\273\256…"` と引用符でくるむ。用語集・メンバーの
+        //     レコードは**日本語のファイル名**なので、付け忘れると画面側の照合キー
+        //     （repoPathOf の生パス）と一致せず、履歴が**丸ごと出なくなる**（実装中に踏んだ）。
+        //     なお、これが消すのは**非ASCIIの引用だけ**。ファイル名に `"` `\` 制御文字が
+        //     入ると git は常に引用符でくるむ——そのレコードは RECORD_PATH に一致せず、
+        //     履歴が出ないだけになる（事故ではないが、出ない理由はこれ）
+        //   diff.mnemonicPrefix / diff.noprefix … `+++ b/<path>` の接頭辞が `w/` になったり
+        //     消えたりする。パスの取り出しが狂うので、下で接頭辞を明示して固定する
+        //   log.showSignature=false … 署名の検証結果が本文に混ざる
+        //   color.ui=false / --no-color … 色の制御文字が混ざる
+        return (0, node_child_process_1.execFileSync)("git", [
+            "-c", "core.quotepath=false",
+            "-c", "log.showSignature=false",
+            "-c", "color.ui=false",
+            // 改名検出の探索上限（既定1000）。**読む人の設定で改名が黙って切れる**のを防ぐ。
+            // pathspec でレコードだけに絞ってあるので、実際に比べる数は多くても数百
+            "-c", "diff.renameLimit=100000",
+            ...args,
+        ], {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+            // 既定の 1MB では足りない。差分を丸ごと受け取るので広めに取り、
+            // 溢れたら例外 → 上位で空扱い（履歴が出ないだけでビルドは通る）
+            maxBuffer: 256 * 1024 * 1024,
+        });
+    }
+    catch (e) {
+        // **握り潰すが、異常なものは無言にしない。** maxBuffer 超過や git の内部エラーまで
+        // 「履歴の節が消える」に潰れると、**ある日消えても誰も気づけない**。
+        //
+        // ただし「**git が無い**（ENOENT）」「**git リポジトリでない**（git の致命エラー = 128）」は
+        // **既定の状態**——手元のビルドやテストで普通に起きるので、ここで警告するとログが
+        // 常に注意で埋まる（gold-proposals / weekly-curation の「無いことは警告しない」と同じ規律）。
+        // 戻り値の契約（空文字 = 履歴なしで正常継続）はどちらでも変えない
+        const err = e;
+        if (err.code !== "ENOENT" && err.status !== 128) {
+            console.warn(`AIの変更履歴を git から取れませんでした（履歴は出さずに続けます）: ${String(e)}`);
+        }
+        return "";
+    }
+}
+/** パス1: コミットの素性と、そのコミットが触ったレコードのパス（新しい順） */
+function readCommits(cwd) {
+    const out = gitLog(cwd, [
+        "log",
+        `-n${AI_HISTORY_MAX_COMMITS}`,
+        // 🔴 **改名を検出する（0.12.16）。** --no-renames だと `Cortex/用語集/` → `Cortex/Glossary/`
+        // のようなディレクトリの引っ越しが**削除＋追加**に割れ、(1) 新パスに「AIがこの記録を
+        // 作成しました」が立ち (2) 旧パスは削除扱いで**移動より前の履歴が丸ごと消える**。
+        // 追跡は collectAiChangeHistory 側で1パスで行う（--follow は単一パス専用で、
+        // レコードごとに git を呼ぶことになり「ビルド1回につき2回」を壊す）。
+        // **log.follow=true を設定している人がいる**ので --no-follow も明示する
+        RENAME_OPT,
+        "--no-follow",
+        "--no-color",
+        // パス2と揃える（--name-status はテキスト差分を作らないので発火しないが、
+        // 「読む人の git 設定に左右させない」の徹底を非対称にしない）
+        "--no-ext-diff",
+        "--name-status",
+        `--format=%x00%H%x1f%aI%x1f%an%x1f%ae%x1f%s`,
+        "--",
+        RECORD_PATHSPEC,
+    ]);
+    const commits = [];
+    let cur = null;
+    for (const line of out.split("\n")) {
+        if (line.startsWith(NUL)) {
+            const parts = line.slice(1).split(US);
+            // 件名に区切り文字が混ざっても壊れないよう、5つ目以降は件名として繋ぎ直す
+            cur = {
+                sha: parts[0] || "",
+                at: parts[1] || "",
+                name: parts[2] || "",
+                email: parts[3] || "",
+                subject: parts.slice(4).join(US),
+                files: [],
+            };
+            if (cur.sha)
+                commits.push(cur);
+            continue;
+        }
+        if (!cur)
+            continue;
+        const m = /^([A-Z])\d*\t(.+)$/.exec(line);
+        if (!m)
+            continue;
+        if (m[1] === "R") {
+            // 改名は「旧パス<TAB>新パス」の2列。行頭の `R100` の数字は一致度
+            const i = m[2].indexOf("\t");
+            if (i === -1)
+                continue;
+            const score = parseInt(/^R(\d+)/.exec(line)?.[1] || "", 10);
+            cur.files.push({
+                status: "R",
+                path: m[2].slice(i + 1),
+                from: m[2].slice(0, i),
+                score: Number.isFinite(score) ? score : undefined,
+            });
+            continue;
+        }
+        // 🔴 **複製（C）は改名と同じ扱いにしない。** 複製は**元ファイルが残る**ので、
+        // 対応表を張ると元レコードの履歴が複製先へ移り、**元のページが空になる**。
+        // いまは `--find-copies` を渡していないので届かない（`diff.renames=copies` が
+        // 設定されていても `--find-renames` が優先されることを実測で確認済み）。
+        // あとから複製検出を足す人は、ここで扱いを決めること
+        if (m[1] === "C")
+            continue;
+        cur.files.push({ status: m[1], path: m[2] });
+    }
+    return commits;
+}
+/**
+ * パス2: 変更（M）の差分だけ。鍵は `<sha>` + NUL + `<path>`。
+ *
+ * 🔴 **遡る件数はパス1が決める（`changeCount` = パス1の窓に入った「変更または改名」のコミット数）。**
+ * `--diff-filter` は表示だけでなく**コミットの選択**にも効くので、ここで素の
+ * `-n400` を渡すと「変更のコミット 400 件」を探して**履歴の底まで歩き、その全部の
+ * パッチを生成する**——レコードの変更が少ないリポジトリほど無駄が大きく、
+ * 作った差分の大半はパス1の窓の外で一度も引かれない。
+ *
+ * パス1の窓は「レコードを触ったコミットの新しい 400 件」という連続した区間なので、
+ * その中の該当コミットは**全体で最も新しい changeCount 件と一致する**。
+ * だから `-n changeCount` で必要十分（多くも少なくもならない）。
+ * **数え方は --diff-filter と必ず揃えること**（片方だけ変えると取りこぼす）。
+ */
+function readDiffs(cwd, changeCount) {
+    const empty = { diffs: new Map(), modeOnly: new Set() };
+    if (changeCount <= 0)
+        return empty;
+    const out = gitLog(cwd, [
+        "log",
+        `-n${changeCount}`,
+        // パス1と**同じ改名の設定**にする（違えるとコミットの選択がずれ、mCount の前提が崩れる）
+        RENAME_OPT,
+        "--no-follow",
+        "--no-color",
+        // diff.external / GIT_EXTERNAL_DIFF が設定されていると差分が丸ごと別物になる
+        "--no-ext-diff",
+        // 接頭辞を明示して固定する（diff.mnemonicPrefix / diff.noprefix の影響を消す）
+        "--src-prefix=a/",
+        "--dst-prefix=b/",
+        "-p",
+        // 文脈行は要らない。**変わった行だけ**を出す（画面のラベルも「消えた行／増えた行」）
+        "-U0",
+        // **M だけでなく R も取る。** 100% 未満の改名は中身も変わっているので、その差分が要る
+        //（純粋な改名は R でもパッチを持たないので、ここに入っても何も増えない）
+        "--diff-filter=MR",
+        `--format=%x00%H`,
+        "--",
+        RECORD_PATHSPEC,
+    ]);
+    const diffs = new Map();
+    /**
+     * 🔴 **「中身は本当に変わっていない」と言い切れるものだけを集める。**
+     * テキスト差分が出ない節は3種類あり、意味がまったく違う:
+     *
+     *   old mode / new mode … **権限だけの変更**。中身は変わっていない（ここに入れる）
+     *   Binary files … differ … **中身は変わったが、差分を出せない**（.gitattributes の -diff）
+     *   similarity index 100% … 純粋な改名（R のスコアで分かるので、ここでは扱わない）
+     *
+     * これを区別せずに「差分が空なら落とす」とすると、`*.md` を -diff にしている案件で
+     * **本物の書き換えが丸ごと消える**（レビューで指摘された潜在の欠陥）。
+     */
+    const modeOnly = new Set();
+    let sha = "";
+    let cur = null;
+    /** いまのファイル節の新パス（`diff --git a/X b/Y` の Y）。`+++` が来たら確定して消す */
+    let headerPath = "";
+    let sawModeLine = false;
+    /** ファイル節の終わりで、テキスト差分が出なかった理由を確定する */
+    const closeSection = () => {
+        if (headerPath && sawModeLine && sha)
+            modeOnly.add(sha + NUL + headerPath);
+        headerPath = "";
+        sawModeLine = false;
+    };
+    // 🔴 **ヘッダの見分けは「位置」で決める。行の見た目で決めない。**
+    // 差分の中身は「符号1文字 + 元の行」なので、レコードに `++ …` という行があると
+    // `+++ …` に、`-- …` があると `--- …` になる——**ファイルのヘッダと区別が付かない**。
+    // 見た目で判定すると、その行を落とすだけでなく**以降の差分が別のパスの下に入る**。
+    // 区間で見る: `diff --git` から最初の `@@` までがヘッダ、そこから次の
+    // `diff --git` までが中身。
+    let inHeader = false;
+    for (const line of out.split("\n")) {
+        if (line.startsWith(NUL)) {
+            closeSection();
+            sha = line.slice(1).trim();
+            cur = null;
+            inHeader = false;
+            continue;
+        }
+        if (line.startsWith(DIFF_HEADER)) {
+            closeSection();
+            cur = null;
+            inHeader = true;
+            // 権限だけの変更・binary は `+++` を出さないので、ここでしかパスを取れない。
+            // 接頭辞は --src-prefix / --dst-prefix で固定してあるので、` b/` の**最後の**
+            // 出現で割ればよい（レコード名に空白は入りうるが、` b/` は入らない）
+            const rest = line.slice(DIFF_HEADER.length);
+            const at = rest.lastIndexOf(" b/");
+            headerPath = at === -1 ? "" : rest.slice(at + 3);
+            continue;
+        }
+        if (inHeader) {
+            // パスは `+++ b/<path>` から取る（上の行は空白を含むパスで割れない）
+            if (line.startsWith("+++ ")) {
+                const p = line.slice(4).trim();
+                headerPath = "";
+                sawModeLine = false;
+                if (p === "/dev/null" || !sha) {
+                    cur = null;
+                    continue;
+                }
+                const path = p.startsWith("b/") ? p.slice(2) : p;
+                cur = { before: [], after: [] };
+                diffs.set(sha + NUL + path, cur);
+                continue;
+            }
+            if (line.startsWith("old mode ") || line.startsWith("new mode "))
+                sawModeLine = true;
+            // 最初のハンク見出しでヘッダは終わり（index / old mode / `---` はここで捨てる）
+            if (line.startsWith("@@"))
+                inHeader = false;
+            continue;
+        }
+        if (!cur)
+            continue;
+        // 2つ目以降のハンク見出し。中身の行には必ず符号が付くので、素の `@@` は見出しだけ
+        if (line.startsWith("@@"))
+            continue;
+        // `` は符号が付かないので、下の2つに落ちず自然に無視される
+        if (line.startsWith("-"))
+            cur.before.push(line.slice(1));
+        else if (line.startsWith("+"))
+            cur.after.push(line.slice(1));
+    }
+    closeSection();
+    return { diffs, modeOnly };
+}
+/** 長すぎる差分は丸める（site の JSON に丸ごと載るので上限が要る） */
+function clampDiff(text) {
+    if (text.length <= AI_HISTORY_MAX_DIFF_CHARS)
+        return { text, truncated: false };
+    let end = AI_HISTORY_MAX_DIFF_CHARS;
+    // 上位サロゲートで切ると、絵文字が半分だけ残って末尾が置換文字になる。1つ戻す
+    const code = text.charCodeAt(end - 1);
+    if (code >= 0xd800 && code <= 0xdbff)
+        end -= 1;
+    return { text: text.slice(0, end), truncated: true };
+}
+/**
+ * レコードのリポジトリ相対パス → AIによる変更（新しい順・最大 AI_HISTORY_MAX_ENTRIES 件）。
+ *
+ * 画面は既存の `repoPathOf(rec)`（editUrl から剥がしたパス）でここを引く。
+ * **いまリポジトリに無いレコード（最新の状態が削除）は地図に入れない**——
+ * もう開けないページの履歴を配っても読む人がいない。
+ */
+function collectAiChangeHistory(cwd) {
+    const commits = readCommits(cwd);
+    if (!commits.length)
+        return {};
+    // パス2に渡す件数を、パス1の窓に入った「変更または改名」のコミット数から数える。
+    // **readDiffs の --diff-filter と同じ集合を数えること**（片方だけ変えると差分を取りこぼす）
+    let changeCount = 0;
+    for (const c of commits) {
+        if (c.files.some((f) => (f.status === "M" || f.status === "R") && PATHSPEC_MATCH.test(f.path)))
+            changeCount++;
+    }
+    const { diffs, modeOnly } = readDiffs(cwd, changeCount);
+    const history = {};
+    /**
+     * 🔴 **削除でそのパスの収集を打ち切る。鍵は「そのコミット時点の生パス」。**
+     *
+     * 新しい順に走っているので、削除より古い世代は**人が消したはずの内容**——同じパスに
+     * 記録が作り直されると、消したはずの本文が新しい記録のページに出てしまう。
+     *
+     * **正本パスで引いてはいけない。** 改名追跡を入れると別々の記録が同じ正本パスに写像されるので、
+     * 「削除で空いたパスに、あとから別の記録が改名で入ってくる」形で、
+     * **移動してきた生きている記録の履歴まで丸ごと消える**（実装レビューで捕まえた）。
+     * 生パスで持ち、改名を見たときに新→旧へ伝播させると、2つの形が順序で綺麗に分かれる:
+     *
+     *   α 改名してから削除された（その記録は死んでいる）… `D 新` を R より先に見るので、
+     *     R のとき gone に 新 が居る → 旧へ伝播して古い履歴も捨てる
+     *   β 削除で空いたパスに、あとから別の記録が入った … `R 旧→新` を D より先に見るので、
+     *     伝播せず、あとから来る `D 新` は生パス 新 にだけ効く。移動してきた記録は
+     *     生パス 旧 で照合されるので生き残る
+     */
+    const gone = new Set();
+    /**
+     * 🔴 **改名の追跡。「そのコミット時点のパス」→「いまのパス（正本）」。**
+     *
+     * 新しい順に走りながら育てる。改名 R(旧 → 新) を見たら、その時点より**古い**コミットで
+     * 旧パスに出会ったものは、いまの記録の履歴として積む。これで `--follow` と同じことを
+     * **git を1回も余分に呼ばずに**やる。改名が連鎖していても（A→B→C）順に付け替わって繋がる。
+     */
+    const renamedTo = new Map();
+    /** そのコミット時点のパスから、いまのパス（正本）を引く */
+    const canonicalOf = (p) => renamedTo.get(p) || p;
+    /** レコードとして扱うパスか（区画の規約・雛形はレコードではない） */
+    const isRecord = (p) => {
+        if (!RECORD_PATH.test(p))
+            return false;
+        const base = p.slice(p.lastIndexOf("/") + 1).toLowerCase();
+        return base !== "readme.md" && base !== "template.md";
+    };
+    for (const c of commits) {
+        const kind = classifyCommit(c);
+        /**
+         * このコミットの改名。**対応表への反映は、通常のエントリを処理し終えてから行う。**
+         * 途中で書き換えると、同じコミットの他のエントリの正本が git の出力順に左右される。
+         * `-M` だけなら実際には起こらない（R の元/先は同じコミットの他のエントリに現れない）が、
+         * あとから `-C` を足した瞬間に静かに壊れるので、順序を不変条件として固定しておく。
+         */
+        const renames = [];
+        for (const f of c.files) {
+            if (f.status === "R" && f.from) {
+                const canon = canonicalOf(f.path);
+                renames.push({ from: f.from, to: f.path, canon });
+                // **中身も変わった改名（100% 未満）だけを「書き換え」として出す。**
+                // 一致度 100 は**中身が1文字も変わっていない移動**——記録の内容の変化ではないので
+                // 履歴の点にしない。**スコアで判定する**（差分の有無で判定すると、差分が
+                // 取れなかっただけの変更と区別が付かない）
+                if (kind === "ai" && isRecord(canon) && !gone.has(f.path) && f.score !== 100) {
+                    pushEntry(canon, c, f.path, "edit");
+                }
+                continue;
+            }
+            const canon = canonicalOf(f.path);
+            if (!isRecord(canon))
+                continue;
+            if (gone.has(f.path))
+                continue;
+            if (f.status === "D") {
+                gone.add(f.path);
+                continue;
+            }
+            // 履歴に出すのは AI がやったことだけ（人の操作・データ構造の引っ越しは出さない）
+            if (kind !== "ai")
+                continue;
+            // A（作成）と M（変更）だけ。T（ファイル↔シンボリックリンクの置き換え）・
+            // C（複製・そもそも検出していない）等は「何が変わったか」を言えないので出さない
+            if (f.status !== "A" && f.status !== "M")
+                continue;
+            pushEntry(canon, c, f.path, f.status === "A" ? "add" : "edit");
+        }
+        for (const r of renames) {
+            // α: 改名先が既に死んでいるなら、改名元も死んでいる（古い履歴を捨てる）
+            if (gone.has(r.to))
+                gone.add(r.from);
+            // 改名先の名前は、これより古いコミットでは**別のもの**を指す。対応表から外す。
+            // ⚠️ **この1行はテストで守れていない**（外しても全テストが緑のまま）。外しても症状が
+            // 出ないのは、名前が再利用される形では手前の `gone` が先に効いてしまうため。
+            // 消さないでほしい: 連鎖する改名で、古い側の同名ファイルが新しい記録に
+            // 紐づく余地を残さないための一行
+            renamedTo.delete(r.to);
+            // 🔴 **写像を張れない改名は、旧パスをそこで打ち切る。**
+            // レコードの形をしていないところへ（`records/2026/A.md` のようなサブフォルダ・
+            // `README.md`）出ていった、あるいはそこから来た改名で、旧パスを生かしたままにすると、
+            // **旧パスは「もう無いのに生きている」**状態になる。そこに新しい記録が作り直されると、
+            // **前の記録の作成・本文が新しい記録のページに出る**——0.12.15 で直した
+            // 「人が消した本文が別の記録に出る」と同じ型（レビューで実測・再現された）
+            if (isRecord(r.canon) && isRecord(r.from))
+                renamedTo.set(r.from, r.canon);
+            else
+                gone.add(r.from);
+        }
+    }
+    /** 1件を積む。**中身が変わっていない「書き換え」は積まない** */
+    function pushEntry(canon, c, rawPath, kind) {
+        const list = history[canon] || (history[canon] = []);
+        if (list.length >= exports.AI_HISTORY_MAX_ENTRIES)
+            return;
+        let before = "";
+        let after = "";
+        let truncated = false;
+        const key = c.sha + NUL + rawPath;
+        // **「追加（A）の差分を載せない」の門は readDiffs の --diff-filter ただ1つ。**
+        // ここでも status を見て二重に守ると、どちらを外しても症状が出ず、
+        // **テストで守れない不変条件**になる（実際に変異検証で素通りした）。門は1箇所に置く
+        const d = diffs.get(key);
+        if (d) {
+            const b = clampDiff(d.before.join("\n"));
+            const a = clampDiff(d.after.join("\n"));
+            before = b.text;
+            after = a.text;
+            truncated = b.truncated || a.truncated;
+        }
+        if (kind === "edit") {
+            // 🔴 **構造の規則A: 中身が変わっていないと「言い切れる」変更だけを落とす。**
+            //
+            // ⚠️ **「差分が空」と「差分が取れなかった」を同じにしてはいけない**（レビュー指摘）。
+            // テキスト差分が出ない理由は3つあり、意味がまったく違う:
+            //
+            //   ① 権限だけの変更 …… 中身は変わっていない（git が old mode/new mode で明言）→ 落とす
+            //   ② 純粋な改名 …………… 中身は変わっていない（R のスコア100で判定済み）→ ここへ来ない
+            //   ③ 取れなかった ……… binary 扱い（.gitattributes の -diff）・パス2の窓の外・
+            //                        パス2そのものの失敗。**中身は変わっているかもしれない**
+            //
+            // ③を落とすと、`*.md` を -diff にしている案件で**本物の書き換えが丸ごと消え**、
+            // パス2が失敗した日には**全案件で履歴が無言で全滅**する。だから③は落とさず、
+            // 差分の代わりに画面へ「出せませんでした」と断らせる
+            if (!before && !after && modeOnly.has(key))
+                return;
+            // 🔴 **構造の規則B: フロントマターの項目名だけの付け替えは出さない。**
+            // データ構造の引っ越しであって内容の変化ではない（件名の規則の裏取り）。
+            // ⚠️ ただし裏取りできるのは**実データで見た2つの形のうち1つだけ**
+            //（`summary:`→`description:` の169件。`status:` の後付け300件は件名の規則だけが頼り）
+            if (isFrontmatterKeyRename(before, after))
+                return;
+        }
+        const entry = {
+            commit: c.sha,
+            at: c.at,
+            subject: c.subject,
+            kind,
+            before,
+            after,
+        };
+        if (truncated)
+            entry.truncated = true;
+        list.push(entry);
+    }
+    // 空の器は返さない（「知らないことはキーが無いことで表す」）
+    for (const p of Object.keys(history)) {
+        if (!history[p].length)
+            delete history[p];
+    }
+    return history;
+}

package/package.json

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