@takagaki/cortex-decisions-viewer 0.12.119 → 0.12.121

package/dist/repo.js

@@ -1,12 +1,9 @@
 "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;
 exports.lastSubstantiveUpdate = lastSubstantiveUpdate;
 const node_child_process_1 = require("node:child_process");
 /**
@@ -120,47 +117,14 @@ function normalizeToHttps(url) {
     }
     return null;
 }
-// ---- AIによるレコードの変更履歴（git 由来）------------------------------------
+// ---- git の履歴の読み口（Home の最終更新日が使う）------------------------------
 //
-// レコード詳細の「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 ";
+// 記録ページの「更新履歴」は engine の帳簿を読む（change-log.ts・#1094 便 35b-1 U2）。ここに残るのは
+// Home の「実質的な最終更新日」（lastSubstantiveUpdate）だけ。
 /** 行頭に置いてコミットの境目を見分ける印。差分もパスも 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 /
@@ -207,80 +171,13 @@ function classifyCommit(id) {
 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 無し・リポジトリでない・出力が大きすぎる）は空文字にする。
  * @param what 警告に出す「何が取れなかったか」。呼び出し元が増えたので引数化した——
  *   固定文のままだと Home の最終更新日が取れない日に「AIの変更履歴を…」という
  *   嘘の警告が出て、診断がその文言に引っ張られる
  */
-function gitLog(cwd, args, what = "AIの変更履歴") {
+function gitLog(cwd, args, what = "git の履歴") {
     try {
         // 🔴 **出力の形は、読む人の git 設定に左右させない。** ここで組み立てているのは
         // 機械が読む出力なので、人の ~/.gitconfig で形が変わる余地を全部潰す:
@@ -328,397 +225,6 @@ function gitLog(cwd, args, what = "AIの変更履歴") {
         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",
-        // 🔴 **件名（%s）は必ず最後に置く**（件名に区切り文字が混ざっても繋ぎ直せるように）。
-        // `Operated-By:` トレーラーは値だけを RS 区切りの1行で取る（改行が入ると1行1コミットが壊れる）
-        `--format=%x00%H%x1f%aI%x1f%an%x1f%ae%x1f%(trailers:key=Operated-By,valueonly,separator=%x1e)%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);
-            // 件名に区切り文字が混ざっても壊れないよう、6つ目以降は件名として繋ぎ直す
-            cur = {
-                sha: parts[0] || "",
-                at: parts[1] || "",
-                name: parts[2] || "",
-                email: parts[3] || "",
-                operatedBy: parts[4] || "",
-                subject: parts.slice(5).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;
-}
 // ---- Home の「実質的な最終更新日」 ------------------------------------------
 //
 // Home タイトル横の「最終更新: YYYY-MM-DD」の出どころ。Home の自己記述（この案件に
@@ -735,12 +241,12 @@ function collectAiChangeHistory(cwd) {
 //   嘘をつくのは目的そのものへの裏切りで、見た目が自然なので誰も気づけない。
 //   既知の例外が1つ: **権限（mode）だけのコミット**は --name-status では M と区別が
 //   付かず、実質更新に数えてしまう。区別には差分をもう1回 git から取る必要があり
-//   （AI変更履歴側の modeOnly がそれ）、Home.md にモードだけの変更が入る形は実質
-//   無いので、ここでは扱わないと決めた（isFrontmatterKeyRename の見送りと同じ理由）
+//   、Home.md にモードだけの変更が入る形は実質
+//   無いので、ここでは扱わないと決めた
 /** 遡るコミット数の上限。Home.md 1ファイルの履歴なので、これで実質十分 */
 const LAST_UPDATE_MAX_COMMITS = 50;
 /**
- * 改名の検出閾値。🔴 **既存の RENAME_OPT（90%）を共有しない。50%（git の既定）を明示する。**
+ * 改名の検出閾値。🔴 **記録の履歴の検出（以前は 90%）と共有しない。50%（git の既定）を明示する。**
  *
  * 90% はレコード群の「誤検出＝人が消した本文が別の記録のページに出る」という重い事故を
  * 避けるための数字。ここは対象が Home.md 1ファイルで、誤検出の被害は「日付が少し
@@ -759,16 +265,14 @@ const LAST_UPDATE_RENAME_OPT = "--find-renames=50%";
  * 示す鮮度のヒントだから。
  *
  * 日付は author date（%aI）の先頭10文字。committer date にしないのは rebase や
- * マージで日付が動くため（既存 AiChangeEntry.at と同じ選択で、読む人の log.date
- * 設定にも左右されない）。タイムゾーンは書いた人のオフセット基準——bot の UTC 編集が
+ * マージで日付が動くため（読む人の log.date 設定にも左右されない）。タイムゾーンは書いた人のオフセット基準——bot の UTC 編集が
  * JST より1日古く出ることがあるが、それは「古い方向」なので許容する。
  *
  * git が無い・リポジトリでない・浅い clone・窓内が全部機械的 → null
  * （表示が出ないだけで、他は壊れない）。
  *
- * frontmatter の項目名だけの付け替えを落とす構造の規則（isFrontmatterKeyRename）は
- * ここでは使わない——差分の取得にもう1回 git を呼ぶ割に、Home.md ではマイグレーションの
- * 件名規約で落ちる形しか観測されていない（適用しないと決めた・設計レビュー承認済み）。
+ * frontmatter の項目名だけの付け替えを落とす構造の規則は使わない——差分の取得にもう1回 git を
+ * 呼ぶ割に、Home.md ではマイグレーションの件名規約で落ちる形しか観測されていない。
  */
 function lastSubstantiveUpdate(cwd, repoPath) {
     // 🔴 **浅い clone を最初に弾く。** 浅い clone では境界コミットが親を持たないため、
@@ -789,8 +293,7 @@ function lastSubstantiveUpdate(cwd, repoPath) {
     catch {
         return null; // git が無い・リポジトリでない（既定の状態なので警告もしない）
     }
-    // 単一ファイルなので --follow で改名を git 側に追跡させる（readCommits が --no-follow
-    // なのは複数レコードを1回の log で読むため。ここはその制約が当てはまらない）
+    // 単一ファイルなので --follow で改名を git 側に追跡させる
     const out = gitLog(cwd, [
         "log",
         `-n${LAST_UPDATE_MAX_COMMITS}`,