@takagaki/cortex-decisions-viewer 0.12.13 → 0.12.15

package/dist/repo.js

@@ -1,8 +1,11 @@
 "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.isAiCommit = isAiCommit;
+exports.collectAiChangeHistory = collectAiChangeHistory;
 const node_child_process_1 = require("node:child_process");
 /**
  * GitHubのowner/repoを表すベースURLを解決する。
@@ -102,3 +105,347 @@ 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 無し・
+// メッセージ規約の変更 → 「履歴の節が出ない」だけで、他の表示は壊れない。
+/** 行頭に置いてコミットの境目を見分ける印。差分もパスも 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$/;
+/** 探索範囲（git の pathspec）。README や Context 配下の差分は最初から出力に入れない */
+const RECORD_PATHSPEC = "Cortex/*/records/*.md";
+/**
+ * そのコミットは「AIがやったこと」か。
+ *
+ * 🔴 **author だけでは判定できない。** 受け口の Lambda（`infra/lambda/intake`）は
+ * **人の操作の代理でコミットする**（`promoteCommitMessage` = 「Gold確認: …」、
+ * `deleteCommitMessage` = 「レコード削除: …」。logic.mjs:407,713）。その author は
+ * 共有トークンの持ち主で全員同じになる（index.mjs のコメント）。bot 名義だけで判定すると、
+ * **人が「確認済みにする」を押した操作が「AIによる変更」として画面に出る**。
+ * レコードのファイルを書き換える op はこの2つだけなので、件名で先に落とす。
+ *
+ * 判定は上から順に:
+ *   1. 件名が**人の操作の口**の規約 → 人
+ *   2. 件名が**夜間パイプライン**の規約 → AI（author が PAT 名義でも拾える）
+ *   3. author が bot 名義 → AI
+ *   4. それ以外 → 人（GitHub や手元から人が直接直したもの）
+ */
+function isAiCommit(id) {
+    const subject = id.subject || "";
+    // 1. 人の操作の代理（infra/lambda/intake/logic.mjs の promoteCommitMessage / deleteCommitMessage）
+    if (/^(Gold確認|レコード削除)[:：]/.test(subject))
+        return false;
+    // 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 true;
+    // 3. bot 名義
+    const who = `${id.name || ""} ${id.email || ""}`;
+    return /\[bot\]|github-actions/i.test(who);
+}
+/** 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",
+            ...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}`,
+        // 改名を追わない。追うと「変更（M）」の集合から外れて差分が取れなくなる。
+        // 改名は削除＋追加として素直に見せる。**log.follow=true を設定している人がいる**ので
+        // --no-follow も明示する（--follow が効くと1パス目と2パス目で対象がずれる）
+        "--no-renames",
+        "--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)
+            cur.files.push({ status: m[1], path: m[2] });
+    }
+    return commits;
+}
+/**
+ * パス2: 変更（M）の差分だけ。鍵は `<sha>` + NUL + `<path>`。
+ *
+ * 🔴 **遡る件数はパス1が決める（`mCount` = パス1の窓に入った「変更」コミットの数）。**
+ * `--diff-filter=M` は表示だけでなく**コミットの選択**にも効くので、ここで素の
+ * `-n400` を渡すと「変更のコミット 400 件」を探して**履歴の底まで歩き、その全部の
+ * パッチを生成する**——レコードの変更が少ないリポジトリほど無駄が大きく、
+ * 作った差分の大半はパス1の窓の外で一度も引かれない。
+ *
+ * パス1の窓は「レコードを触ったコミットの新しい 400 件」という連続した区間なので、
+ * その中の変更コミットは**全体で最も新しい mCount 件の変更コミットと一致する**。
+ * だから `-n mCount` で必要十分（多くも少なくもならない）。
+ */
+function readDiffs(cwd, mCount) {
+    if (mCount <= 0)
+        return new Map();
+    const out = gitLog(cwd, [
+        "log",
+        `-n${mCount}`,
+        "--no-renames",
+        "--no-follow",
+        "--no-color",
+        // diff.external / GIT_EXTERNAL_DIFF が設定されていると差分が丸ごと別物になる
+        "--no-ext-diff",
+        // 接頭辞を明示して固定する（diff.mnemonicPrefix / diff.noprefix の影響を消す）
+        "--src-prefix=a/",
+        "--dst-prefix=b/",
+        "-p",
+        // 文脈行は要らない。**変わった行だけ**を出す（画面のラベルも「消えた行／増えた行」）
+        "-U0",
+        "--diff-filter=M",
+        `--format=%x00%H`,
+        "--",
+        RECORD_PATHSPEC,
+    ]);
+    const diffs = new Map();
+    let sha = "";
+    let cur = null;
+    // 🔴 **ヘッダの見分けは「位置」で決める。行の見た目で決めない。**
+    // 差分の中身は「符号1文字 + 元の行」なので、レコードに `++ …` という行があると
+    // `+++ …` に、`-- …` があると `--- …` になる——**ファイルのヘッダと区別が付かない**。
+    // 見た目で判定すると、その行を落とすだけでなく**以降の差分が別のパスの下に入る**。
+    // 区間で見る: `diff --git` から最初の `@@` までがヘッダ、そこから次の
+    // `diff --git` までが中身。
+    let inHeader = false;
+    for (const line of out.split("\n")) {
+        if (line.startsWith(NUL)) {
+            sha = line.slice(1).trim();
+            cur = null;
+            inHeader = false;
+            continue;
+        }
+        if (line.startsWith("diff --git ")) {
+            cur = null;
+            inHeader = true;
+            continue;
+        }
+        if (inHeader) {
+            // パスは `+++ b/<path>` から取る（上の行は空白を含むパスで割れない）
+            if (line.startsWith("+++ ")) {
+                const p = line.slice(4).trim();
+                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;
+            }
+            // 最初のハンク見出しでヘッダは終わり（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));
+    }
+    return diffs;
+}
+/** 長すぎる差分は丸める（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の窓に入った「変更」コミットの数から数える
+    let mCount = 0;
+    for (const c of commits) {
+        if (c.files.some((f) => f.status === "M" && RECORD_PATH.test(f.path)))
+            mCount++;
+    }
+    const diffs = readDiffs(cwd, mCount);
+    const history = {};
+    /**
+     * 🔴 **削除でそのパスの収集を打ち切る。** 新しい順に走っているので、削除より古い世代は
+     * **人が消したはずの内容**——同じパスに記録が作り直されると（決定は除外リストを持たないので
+     * 実際に起こりうる）、消したはずの本文が新しい記録のページに「AIが書き換えました」として
+     * 出てしまう。最新が削除なら1件も溜まらないので、地図にも入らない（同じ1つの規則で両方効く）。
+     */
+    const gone = new Set();
+    for (const c of commits) {
+        const ai = isAiCommit(c);
+        for (const f of c.files) {
+            const p = f.path;
+            if (!RECORD_PATH.test(p))
+                continue;
+            const base = p.slice(p.lastIndexOf("/") + 1).toLowerCase();
+            if (base === "readme.md" || base === "template.md")
+                continue;
+            if (gone.has(p))
+                continue;
+            if (f.status === "D") {
+                gone.add(p);
+                continue;
+            }
+            if (!ai)
+                continue;
+            // A（作成）と M（変更）だけ。T（ファイル↔シンボリックリンクの置き換え）等は
+            // 「何が変わったか」を言えないので出さない
+            if (f.status !== "A" && f.status !== "M")
+                continue;
+            const list = history[p] || (history[p] = []);
+            if (list.length >= exports.AI_HISTORY_MAX_ENTRIES)
+                continue;
+            const entry = {
+                commit: c.sha,
+                at: c.at,
+                subject: c.subject,
+                kind: f.status === "A" ? "add" : "edit",
+                before: "",
+                after: "",
+            };
+            // **「追加（A）の差分を載せない」の門は readDiffs の --diff-filter=M ただ1つ。**
+            // ここでも status を見て二重に守ると、どちらを外しても症状が出ず、
+            // **テストで守れない不変条件**になる（実際に変異検証で素通りした）。門は1箇所に置く
+            // モード変更だけの M・binary 扱いの M は `+++` も `@@` も出さないので、ここは空になる
+            //（画面は「変わった行をここに出せませんでした」に倒れる）。.gitattributes で
+            // `*.md` に `-diff` を付けている案件では全件がその形になる
+            const d = diffs.get(c.sha + NUL + p);
+            if (d) {
+                const before = clampDiff(d.before.join("\n"));
+                const after = clampDiff(d.after.join("\n"));
+                entry.before = before.text;
+                entry.after = after.text;
+                if (before.truncated || after.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.13",
+  "version": "0.12.15",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,