@takagaki/cortex-decisions-viewer 0.12.118 → 0.12.120

package/dist/build.js

@@ -40,11 +40,12 @@ exports.DECISION_FIRMNESS = exports.PROJECT_ICON_EXTS = exports.MIRROR_RELS = vo
 exports.sanitizeBody = sanitizeBody;
 exports.findProjectIcon = findProjectIcon;
 exports.readFleetSources = readFleetSources;
-exports.attachRederived = attachRederived;
+exports.orderRecordsByLedgers = orderRecordsByLedgers;
 exports.humanTouchedOf = humanTouchedOf;
 exports.attachHumanTouched = attachHumanTouched;
 exports.rawFrontmatterDate = rawFrontmatterDate;
 exports.attachSupersedes = attachSupersedes;
+exports.attachRetractedBy = attachRetractedBy;
 exports.readGoldProposals = readGoldProposals;
 exports.buildHomeGrounding = buildHomeGrounding;
 exports.collectMeetings = collectMeetings;
@@ -68,6 +69,7 @@ const marked_1 = require("marked");
 const sanitize_html_1 = __importDefault(require("sanitize-html"));
 const canonical_evidence_1 = require("./canonical-evidence");
 const evidence_names_1 = require("./evidence-names");
+const change_log_1 = require("./change-log");
 const repo_1 = require("./repo");
 const engagement_1 = require("./engagement");
 const story_1 = require("./story");
@@ -114,6 +116,7 @@ const supersedes_1 = require("./supersedes");
 const confirmed_1 = require("./confirmed");
 const minify_1 = require("./minify");
 const render_1 = require("./render");
+const ledger_dir_1 = require("./ledger-dir");
 /**
  * この画面を作ったパッケージの版。**package.json を唯一の出どころにする。**
  * 別に持つと、公開した版と画面に出る版がずれる（しかも気づけない）。
@@ -706,85 +709,16 @@ async function readFleetSources(repoRoot) {
     return { externalSources, slackWorkspaces, internalSources, pipelines, capabilities, fleetGeneratedAt, secretSources, secretSpaces, checks, githubOwners, backlogTarget, tools };
 }
 /**
- * 区画のレコードに帯を載せ、用語集の並びを活性度にする（#665 便 12b）。
+ * 区画のレコードを活性度・強さの順に並べる（用語集だけが動く・#665 便 12b → #1094 便 e4 で帯を外した）。
  *
- * 🔴 **帳簿が無い案件では、渡された配列をそのまま返す**（帯のキーも付かない・並びも従来のまま）。
- * 44 案件のうち帳簿を持つのは栓 `rederive` を入れた案件だけなので、ここが「何もしない」に
- * 倒れることが**既定の経路**である。
- *
- * 🔴 **突き合わせはビルド時にここで閉じる**（`proposals` と同じ）。画面側でパスを組み立て直すと、
- * `repoPathOf` が `editUrl` 由来なので **`repoBaseUrl` が無い案件で帯が黙って消える**。
+ * 🔴 **帳簿が無い案件では、渡された配列をそのまま返す**（並びも従来のまま）。
  */
-async function attachRederived(records, recordsDir, ctx, nowIso, 
-// 番人テストが「git に渡った key」を数えるための差し替え口。本番は常に既定の `readBlobsAt`
-readBlobs = repo_1.readBlobsAt) {
+function orderRecordsByLedgers(records, recordsDir, ctx, nowIso) {
     if (!ctx)
         return records;
-    // 🔴 **レコードのパスは `repoRoot` から作る**（`toRepoRelative` の `process.cwd()` 起点で
-    // 作らない）。帳簿のキーは常にリポジトリルート相対（`Cortex/Glossary/records/…`）なので、
-    // Decisions ディレクトリから CLI を叩いた案件では cwd 起点だと 1 件も突き合わない
     const recordsRel = path.relative(ctx.repoRoot, recordsDir).split(path.sep).join("/");
     const pathOf = (r) => (recordsRel ? `${recordsRel}/${r.fileName}` : r.fileName);
-    // 🔴 **「確認済み」は `status` だけで決まる**（#667）。帯も並びも同じ `rstatus` を見る
-    // ——ここで別のものを渡すと、画面の札と食い違う（「未確認」の札が付いた記録に帯が出る）
-    const statusOf = (r) => r.rstatus;
-    // 決定表の行 5〜7 の材料。**帯の候補になったレコードのぶんだけ**今の版を読み、指紋を作る。
-    // 帳簿に人が確認した版の指紋が無い候補だけ、`<基準コミット>:<path>` をまとめて 1 回 git から引く。
-    // 🔴 **キーが 0 件の区画では git を起こさない**（この関数は区画ごとに呼ばれる）
-    const keyOf = new Map();
-    // 今の版は**作業ツリーから読む**——画面が描いているのはこのファイルであって HEAD ではない
-    const now = new Map();
-    const nowSha = new Map();
-    for (const r of records) {
-        const key = (0, rederivation_1.rederivedContentKey)(pathOf(r), statusOf(r), ctx.ledgers);
-        if (!key)
-            continue;
-        const p = pathOf(r);
-        let nowRaw;
-        try {
-            nowRaw = await node_fs_1.promises.readFile(path.join(ctx.repoRoot, p), "utf8");
-        }
-        catch {
-            // 読めなければ「読めなかった」側（`rederivedBandOf` が帯を出さずに数える）
-            continue;
-        }
-        now.set(p, nowRaw);
-        const sha = (0, rederivation_1.contentShaOf)(nowRaw);
-        nowSha.set(p, sha);
-        const conf = ctx.ledgers.confirmation.get(p);
-        // 🔴 **今の版が機械の書き直しの版でなければ git を読まない**（帯は出ないと決まっている）。
-        // 人が確認した版の指紋が帳簿にあれば、それで決まるので git を読まない（engine #546）
-        if (sha !== conf?.rewritten?.contentSha)
-            continue;
-        if (conf.contentSha) {
-            if (ctx.blobs)
-                ctx.blobs.skipped++;
-            continue;
-        }
-        keyOf.set(r, key);
-    }
-    if (ctx.blobs)
-        ctx.blobs.read += keyOf.size;
-    const bases = keyOf.size ? readBlobs(ctx.repoRoot, [...keyOf.values()]) : new Map();
-    const verdict = (p, baseCommit) => {
-        const nowRaw = now.get(p);
-        const baseRaw = bases.get(`${baseCommit}:${p}`);
-        if (nowRaw == null || baseRaw == null) {
-            // 浅い clone の窓の外・確認の後に改名された・基準コミットにこの path が無い。
-            // **帯は出さない**（誤報より無言）が、静かに消える経路なのでログの器に数える
-            ctx.miss.unreadable.add(p);
-            return "unknown";
-        }
-        return (0, rederivation_1.sameRederivedContent)(baseRaw, nowRaw) ? "same" : "changed";
-    };
-    const nowShaOf = (p) => nowSha.get(p) ?? null;
-    for (const r of records) {
-        const band = (0, rederivation_1.rederivedBandOf)(pathOf(r), statusOf(r), ctx.ledgers, nowShaOf, verdict, ctx.miss);
-        // **印が立たないレコードにはキーごと付けない**（空の器を通さない）
-        if (band)
-            r.rederived = band;
-    }
-    return (0, rederivation_1.orderByActivity)(records, pathOf, statusOf, ctx.ledgers, nowIso);
+    return (0, rederivation_1.orderByActivity)(records, pathOf, (r) => r.rstatus, ctx.ledgers, nowIso);
 }
 /**
  * 記録に人の手があるか（cortex-engine #1094 段 4・削除の確認の文面を替える材料）。
@@ -824,7 +758,8 @@ function attachHumanTouched(records, recordsDir, repoRoot, confirmation) {
  *
  * 🔴 **逆引きは `supersedes.ts`（engine `scripts/gold/supersedes-index.mjs` の写し）だけで組む**。
  * 材料は新しい側の `relations[supersedes]` だけで、古い側の `superseded_by`（夜間の精製が書く写し）は
- * 読まない。確認済み＝新しい側の `status` が `active`。
+ * 読まない。確定＝古い側に人の手が無い（status が人の値でない）か、新しい側を人が確認した（cortex-engine #1094 段 4）。
+ * 口には記録の path（`Cortex/Decisions/records/…`・`repoRoot` 起点）を渡す。
  *
  * 置き換えが無い決定には**キーごと付けない**（今までと同じ SiteData）
  */
@@ -846,9 +781,11 @@ function rawFrontmatterDate(raw) {
     v = v.replace(/\s+#.*$/, "").trim();
     return v;
 }
-function attachSupersedes(decisions, rawDateOf = (d) => d.fm.date) {
+function attachSupersedes(decisions, rawDateOf = (d) => d.fm.date, pathOf = () => undefined) {
     const input = decisions.map((d) => ({
         id: d.id,
+        // 口（`humanOwned`）に区画を伝える path。無ければ写しが決定の区画で聞く
+        path: pathOf(d),
         // 🔴 **frontmatter に書かれたままの date の文字列**（`rawFrontmatterDate`）。gray-matter は時刻・時差つきの
         // date を Date に読み、sanitizeFm は UTC の日付にするので、`2026-07-01T01:00:00+09:00` が 6/30 にずれる。
         // engine は日付を Date にしない読み方（CORE_SCHEMA）で書かれた文字列の先頭 8 桁を使う。
@@ -891,6 +828,35 @@ function attachSupersedes(decisions, rawDateOf = (d) => d.fm.date) {
             d.supersedesIds = replaced;
     }
 }
+/**
+ * ルールに取り下げ（`relations[retracted_by]`・cortex-engine #1094 便 4-2d）を載せる。
+ *
+ * 取り下げ＝この線が 1 本以上（決定の「置き換えられた」と同じ導出・engine の目次と同じ）。
+ * target は取り下げを決めた決定の ID。実在する決定なら記録の綴りと決定日を添える（無ければ ID のまま・日付は空）。
+ * **取り下げの無いルール・ルール以外の区画にはキーごと付けない**（今までと同じ SiteData）
+ */
+function attachRetractedBy(records, decisions, rawDateOf = (d) => d.date) {
+    const byKey = new Map();
+    for (const d of decisions) {
+        const k = (0, supersedes_1.decisionKeyOf)(d.id);
+        if (!byKey.has(k))
+            byKey.set(k, d);
+    }
+    for (const r of records) {
+        const out = [];
+        for (const rel of r.relations) {
+            if (rel.rel !== "retracted_by")
+                continue;
+            const k = (0, supersedes_1.decisionKeyOf)(rel.target);
+            if (!k || out.some((x) => (0, supersedes_1.decisionKeyOf)(x.id) === k))
+                continue;
+            const d = byKey.get(k);
+            out.push({ id: d ? d.id : k, date: d ? (0, supersedes_1.decisionDateOf)(rawDateOf(d), d.id) : "" });
+        }
+        if (out.length)
+            r.retractedBy = out;
+    }
+}
 /**
  * AIからの更新提案（`.cortex/gold-proposals.json`）を読む。
  *
@@ -908,11 +874,16 @@ function attachSupersedes(decisions, rawDateOf = (d) => d.fm.date) {
 function optionalText(v) {
     return typeof v === "string" && v.trim() !== "" ? v : "";
 }
-async function readGoldProposals(repoRoot) {
+/**
+ * engine の `normalized_match`（表記ゆれ）のカードの理由の文に入っている句。画面から外す印（#1094 便 35a-1）。
+ * 🔴 engine の `scripts/silver/build.mjs` の `WHY_NOT_DECIDED.normalized_match` の文を変えるときはここも揃える（片方だけだと静かに外れなくなる）
+ */
+const NORMALIZE_CARD_WHY = /区切り・姓と名の順・会社名を除くと同じ名前/;
+async function readGoldProposals(repoRoot, ledgerDir) {
     const empty = new Map();
     let json;
     try {
-        const raw = await node_fs_1.promises.readFile(path.join(repoRoot, ".cortex", "gold-proposals.json"), "utf8");
+        const raw = await node_fs_1.promises.readFile(path.join((0, ledger_dir_1.ledgerDirOf)(repoRoot, ledgerDir), "gold-proposals.json"), "utf8");
         json = JSON.parse(raw);
     }
     catch (e) {
@@ -997,6 +968,11 @@ async function readGoldProposals(repoRoot) {
         // この 1 欄だけ覆した（決定ログ 20260925-699-f7b.md）
         if (row.decide === "portal")
             proposal.decide = "portal";
+        // 表記ゆれ（区切り・姓と名の順・会社名を直すと名簿に当たる）の名寄せカードは出さない（cortex-engine #1094 便 35a-1・
+        // 10/5 オーナー: 画面に人が押す操作を残さない）。engine は今後これを数えるだけにして自動で結ぶ。
+        // 🔴 見分けは engine の理由の文（`normalized_match` の `why`）。ほかの名寄せカードは今までどおり出す
+        if (proposal.kind === "identity" && NORMALIZE_CARD_WHY.test(proposal.why ?? ""))
+            continue;
         const list = byPath.get(recordPath);
         if (list)
             list.push(proposal);
@@ -1525,7 +1501,7 @@ async function buildTargetUrlMap(repoRoot, repoBaseUrl, branch) {
  * 🔴 **`buildTargetUrlMap` は触らない**（移る間だけ残す表・詳細画面の飛び先の正本）。ここは名前と、
  * 写しのパス → 根拠の ID の対応だけを持つ。資料の題名を Drive の鍵にも載せるために、表の URL を読むだけ
  */
-async function buildEvidenceBook(repoRoot, targetUrls, externalSources = []) {
+async function buildEvidenceBook(repoRoot, targetUrls, externalSources = [], ledgerDir) {
     const book = (0, evidence_names_1.emptyEvidenceBook)();
     const rel = (file) => path.relative(repoRoot, file).split(path.sep).join("/");
     const heading = (text) => text.match(/^#\s+(.+?)\s*$/m)?.[1] ?? null;
@@ -1540,7 +1516,7 @@ async function buildEvidenceBook(repoRoot, targetUrls, externalSources = []) {
     // 片付けで移した議事録のリンク（URL の鍵 → 「定例名 日付」・cortex-engine #968 R-6・A-R6-3）。表が無い・読めない案件は今どおり
     // （種類の既定の名前）。資料より先に載せる（同じ鍵に資料の題名が先に付かないように）
     try {
-        const table = JSON.parse(await node_fs_1.promises.readFile(path.join(repoRoot, evidence_names_1.MOVED_MEETINGS_FILE), "utf8"));
+        const table = JSON.parse(await node_fs_1.promises.readFile(path.join((0, ledger_dir_1.ledgerDirOf)(repoRoot, ledgerDir), evidence_names_1.MOVED_MEETINGS_FILE), "utf8"));
         for (const [url, name] of (0, evidence_names_1.movedMeetingNamesOf)(table))
             putName(foldKeyOf(url), name);
     }
@@ -2421,43 +2397,34 @@ async function build(opts) {
     // 解決するので、あとから作ると空の表・空の実在判定が渡り、**実在するパスまで
     // 「リンクにしない」に倒れて全滅する**（以前は順序が逆だった）。
     const repoRoot = knowledgeRoot ? path.dirname(knowledgeRoot) : path.dirname(dirAbs);
+    // 帳簿 10 本の置き場（既定は `<repoRoot>/.cortex`）。読み口はこの 1 つから読む
+    const ledgerDir = (0, ledger_dir_1.ledgerDirOf)(repoRoot, opts.ledgerDir);
     const targetUrls = knowledgeRoot
         ? await buildTargetUrlMap(repoRoot, repo.baseUrl, repo.branch)
         : new Map();
     // fleet-status.json は 1 回だけ読む（読み手が警告を出すので、2 回読むと警告が 2 行になる）。
     // 名前の帳（チャンネル名）と、下の「データソースと自動化」で同じものを使う
     const fleet = await readFleetSources(repoRoot);
-    const evidenceBook = knowledgeRoot ? await buildEvidenceBook(repoRoot, targetUrls, fleet.externalSources) : (0, evidence_names_1.emptyEvidenceBook)();
+    const evidenceBook = knowledgeRoot ? await buildEvidenceBook(repoRoot, targetUrls, fleet.externalSources, ledgerDir) : (0, evidence_names_1.emptyEvidenceBook)();
     const refs = createRefResolver({ repoRoot, targetUrls, repoBaseUrl: repo.baseUrl, branch: repo.branch, book: evidenceBook });
     // AIからの更新提案。**レコードを組み立てる前に読む**——各レコードが自分の分を
     // takeProposals で引き取るので、後から読んでも載せる先が既に閉じている。
     // 同一プロセスで2回ビルドしても前回の値が残らないよう、毎回入れ替える
-    PROPOSALS_BY_PATH = await readGoldProposals(repoRoot);
+    PROPOSALS_BY_PATH = await readGoldProposals(repoRoot, ledgerDir);
     PROPOSAL_PATHS_MATCHED = new Set();
-    // 再導出の 3 帳簿（#665 便 12b）と用語の強さ（#790）。**帳簿が無い案件では帯も並び替えも作らない**。
-    // 人か機械かの見分けは engine が帳簿（`rewritten`）に書くので、画面は git の素性を読まない（#799）
-    //
+    // 用語集の並びの帳簿（活性度・強さ #790）。**帳簿が無い案件では並び替えを作らない**。
     // 🔴 **強さ（`state` が on のときだけ中身が入る）だけの案件でも器を作る**——作らないと、活性度の帳簿を
-    // 持たない案件で用語集が目次（engine の `termRows`）と違う順になる。帯は `confirmation` の行が無ければ
-    // 1 件も立たない（`rederivedContentKey` の門）ので、器を作っても帯・印は変わらない
-    const ledgers = await (0, rederivation_1.readRederivationLedgers)(repoRoot);
-    const rederive = ledgers.confirmation.size || ledgers.activity.size || ledgers.strength.size
-        ? {
-            ledgers: ledgers,
-            // 🔴 **`repoRoot` で走らせる**（`collectAiChangeHistory` の `process.cwd()` に倣わない）。
-            // あちらは「リポジトリルートで実行すること」が前提の既存の制約だが、こちらは repoRoot を
-            // 既に知っている（帳簿をそこから読んでいる）。Decisions ディレクトリから CLI を叩いた
-            // ときも今の版と基準版が引け、帯が黙って消えない
-            repoRoot: repoRoot,
-            miss: { unreadable: new Set() },
-            blobs: { read: 0, skipped: 0 },
-        }
+    // 持たない案件で用語集が目次（engine の `termRows`）と違う順になる。
+    // 確認の帳簿（`confirmation`）は削除の確認の一言（`humanTouchedOf`）が使うが、並びには関係しない
+    const ledgers = await (0, rederivation_1.readRederivationLedgers)(repoRoot, ledgerDir);
+    const rederive = ledgers.activity.size || ledgers.strength.size
+        ? { ledgers: ledgers, repoRoot: repoRoot }
         : null;
     // 関与の帳簿（便 14b・#709）。関係者の一覧を目次と同じ「関わりの多い順」に並べる材料。
     // **読めない・使えないなら `null`** で、関係者の並びは今までと 1 バイトも同じ
-    const engagement = await (0, engagement_1.readEngagementLedger)(repoRoot);
+    const engagement = await (0, engagement_1.readEngagementLedger)(repoRoot, ledgerDir);
     // 目次と同じ順位（engine #551）。**読めないなら `null`** で、つながり画面の点は今までどおり一律
-    const memoryRanking = await (0, ranking_1.readMemoryRanking)(repoRoot);
+    const memoryRanking = await (0, ranking_1.readMemoryRanking)(repoRoot, ledgerDir);
     // 記録の id → リポジトリルート相対のパス（順位のファイルの鍵と突き合わせる。`repoRoot` 起点・cwd 起点にしない）
     const recordRelPaths = new Map();
     const relOf = (dir, fileName) => {
@@ -2479,7 +2446,7 @@ async function build(opts) {
     // 人の手（削除の確認の文面を替える材料・cortex-engine #1094 段 4）。**置き換えより前に・repoRoot で**
     attachHumanTouched(decisions, dirAbs, repoRoot, ledgers.confirmation);
     // 置き換えの逆引き（#699 F3）。**置き換えの無い案件では 1 件も付かない**
-    attachSupersedes(decisions, (d) => rawDates.get(d) ?? d.fm.date);
+    attachSupersedes(decisions, (d) => rawDates.get(d) ?? d.fm.date, (d) => relOf(dirAbs, d.fileName));
     let home = null;
     let homeGrounding;
     let homeUpdatedAt;
@@ -2521,9 +2488,11 @@ async function build(opts) {
             const records = await loadGenericRecords(recordsDir, exclude, repo.baseUrl, repo.branch);
             // 人の手（削除の確認の文面を替える材料・cortex-engine #1094 段 4）
             attachHumanTouched(records, recordsDir, repoRoot, ledgers.confirmation);
-            // 「人が確認した版から変わりました」の帯と、用語集の並び（#665 便 12b）。
-            // **帳簿を持たない案件では 1 件も付かず、並びもそのまま**（下の attachRederived）
-            const rederived = await attachRederived(records, recordsDir, rederive, opts.generatedAt);
+            // ルールの取り下げ（`retracted_by`・cortex-engine #1094 便 4-2d）。ルールの区画だけ・取り下げの無い案件では何も付かない
+            if (e.name === "Rules")
+                attachRetractedBy(records, decisions, (d) => rawDates.get(d) ?? d.fm.date);
+            // 用語集の並び（活性度・強さ）。**帳簿を持たない案件では並びもそのまま**
+            const rederived = orderRecordsByLedgers(records, recordsDir, rederive, opts.generatedAt);
             // 関係者だけ、関与の多い順（engine の目次と同じ `order`・便 14b）。用語集の並び
             // （`orderByActivity`）とは帳簿も式も別で、区画が重ならないので順番に当てても干渉しない
             const ordered = e.name === "Members"
@@ -2558,21 +2527,6 @@ async function build(opts) {
     // **突き合わなかった提案の件数をビルドログに出す。** path が1文字違うだけで
     // 画面から静かに消えるので、出さないと「提案が出ない」の原因に辿り着けない。
     // 表示からは落とす（どのレコードの話か分からない提案は、出しても行動につながらない）
-    // 🔴 **帯が静かに消える経路を 1 行残す。** 今の版か、人が確認した版の中身を
-    // 引けないと「説明文が変わったか」を言えないので、帯は出さない（誤報より無言）。
-    // 出さないと「印が出ない」の原因を「中身が変わっていない」と切り分けられない
-    if (rederive && rederive.miss.unreadable.size) {
-        const paths = [...rederive.miss.unreadable];
-        console.warn(`gold-confirmation.json: 人が確認した版か今の版の中身を ${paths.length} 件引けませんでした` +
-            `（浅い clone か、確認の後に改名・削除された。変わったかを言えないので帯は出しません）: ` +
-            paths.slice(0, 3).join(", ") + (paths.length > 3 ? " ほか" : ""));
-    }
-    // 🔴 **指紋（engine #546）が効いているかを 1 行残す。** 一致した記録は git を読まないので、
-    // 「読んだ件数」が候補の数より減っていれば効いている。警告ではないので console.log
-    if (rederive?.blobs && rederive.blobs.read + rederive.blobs.skipped > 0) {
-        console.log(`gold-confirmation.json: 人が確認した版の中身を git から ${rederive.blobs.read} 件読みました` +
-            `（中身の指紋で決めた ${rederive.blobs.skipped} 件は読んでいません）`);
-    }
     const unmatched = [...PROPOSALS_BY_PATH.keys()].filter((k) => !PROPOSAL_PATHS_MATCHED.has(k));
     if (unmatched.length) {
         console.warn(`gold-proposals.json: レコードに突き合わない提案が ${unmatched.length} 件ありました（表示しません）: ` +
@@ -2598,19 +2552,17 @@ async function build(opts) {
     // すでにある会議（投入モーダルの「会議名」の選択肢）。intake の有無に関わらず載せる——
     // 出し分けは表示側の仕事で、ここで絞ると「投入の口を後から付けたら選択肢が空」になる
     const meetings = await collectMeetings(repoRoot);
-    // AIによるレコードの変更履歴を git から取る。**レコード数に関わらず git は2回だけ呼ぶ**。
-    // git が無い・浅い clone・該当0件なら空で、履歴の節が出ないだけ（他の表示は壊れない）。
-    // 走るのは latestGeneratedPaths と同じ **リポジトリルート**（process.cwd()）——
-    // Decisions ディレクトリで実行すると pathspec に一致せず常に空になる
-    const aiHistory = (0, repo_1.collectAiChangeHistory)(process.cwd());
+    // 記録ページの「更新履歴」。engine が毎晩書く帳簿（ledger-dir の gold-change-log.json）だけを読む（git は読まない）。
+    // 無い・壊れ・版違いは null で、画面は「更新履歴はまだありません」の 1 つの形になる
+    const changeLog = await (0, change_log_1.readChangeLog)(repoRoot, ledgerDir);
     // ストーリー（#901 V2-5）の日本時間の今日。日・週・月の3つで同じ日にそろえるため1回だけ計算する
     const storyToday = (0, story_1.todayJst)(new Date(opts.generatedAt));
     // ストーリーの日々の動き（#901 V2-5）。帳簿で on の日のファイルが無ければ null（キーごと出さない）
     const story = await (0, story_1.readStory)(repoRoot, renderGroundingSection, (p) => repo.baseUrl ? `${repo.baseUrl}/edit/${repo.branch}/${encodePath(p)}` : null, 
     // 動きのない日を埋める終点＝ビルドの時刻の日本時間の日付（時計を注入できる）
-    storyToday);
+    storyToday, ledgerDir);
     // 週・月のあらすじ（#901）。週・月のファイルが無ければ null（キーごと出さない＝今までと同じ画面）
-    const storyDigest = await (0, story_1.readStoryDigest)(repoRoot, renderGroundingSection, (p) => repo.baseUrl ? `${repo.baseUrl}/edit/${repo.branch}/${encodePath(p)}` : null, storyToday);
+    const storyDigest = await (0, story_1.readStoryDigest)(repoRoot, renderGroundingSection, (p) => repo.baseUrl ? `${repo.baseUrl}/edit/${repo.branch}/${encodePath(p)}` : null, storyToday, ledgerDir);
     // 案件アイコン（#348）。Cortex構成でなければ undefined（旧レイアウトには置き場が無い）
     const projectIcon = await findProjectIcon(knowledgeRoot);
     const site = {
@@ -2667,7 +2619,7 @@ async function build(opts) {
         // null（無い・壊れ・version違い）は undefined へ落とす——SiteData の
         // 「知らないことはキーが無いことで表す」に合わせる（空の器を通さない）
         // 空の器は通さない（0件なら undefined = キーごと出さない）
-        aiHistory: Object.keys(aiHistory).length ? aiHistory : undefined,
+        changeLog: changeLog ?? undefined,
         // 載せる日が無い案件（帳簿なし・壊れ・shadow の日だけ・ファイルなし）はキーごと出さない
         story: story ?? undefined,
         storyDigest: storyDigest ?? undefined,

package/dist/change-log.js

@@ -0,0 +1,187 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHANGE_LOG_MAX_ROWS = exports.CHANGE_LOG_VERSION = exports.CHANGE_LOG_FILE = void 0;
+exports.isCleanUrl = isCleanUrl;
+exports.jstDay = jstDay;
+exports.parseChangeLog = parseChangeLog;
+exports.readChangeLog = readChangeLog;
+/**
+ * 記録ページの「更新履歴」の材料（cortex-engine #1094 便 35b-1 U2・設計 D3）。
+ *
+ * 読むのは engine が毎晩書く帳簿 `gold-change-log.json`（ledger-dir の下）だけ。git は読まない。
+ * 形の契約は engine `test/fixtures/change-log-contract.json`（tools の `viewer/test/fixtures/` へ配られる）。
+ *
+ * ## 🔴 読めなければ空（縮退は 1 つの形）
+ *
+ * 帳簿が無い・壊れ・版違い・形違いは `null`（画面は「更新履歴はまだありません」。今の欄には戻さない）。
+ * 1 行でも契約に反すれば全体を捨てる（engine は書く前に同じ基準で検査するので、viewer を engine より厳しくしない）。
+ *
+ * ## 🔴 禁止語の表は写さない
+ *
+ * 機械の語（frontmatter・commit …）を `what` に出さない番人は engine の持ち物（`hasForbiddenTerm`）。
+ * 写すと表が 2 つになるので、ここは**構造・表示の安全・メールの形・Operated-By**だけを見る。
+ *
+ * ## 日付
+ *
+ * `at` は git の author date（作者のオフセット付き）。engine は同じ日のまとめを JST で行うので、画面の日付も
+ * **固定 +9 時間の UTC 算術**で JST に直す（閲覧者のタイムゾーンに依存しない・Date の地域表示は使わない）。
+ */
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const ledger_dir_1 = require("./ledger-dir");
+/** 置き場（engine `scripts/gold/change-log.mjs` の `CHANGE_LOG_PATH`） */
+exports.CHANGE_LOG_FILE = "gold-change-log.json";
+/** 形の版（engine の `CHANGE_LOG_VERSION`。違ったら読まない） */
+exports.CHANGE_LOG_VERSION = 1;
+/** 1 記録で画面に渡す行数の上限（窓の `per_record` と同じ 50） */
+exports.CHANGE_LOG_MAX_ROWS = 50;
+/** `why` は 1 行 3 本まで（engine の `WHY_MAX`） */
+const WHY_MAX = 3;
+/** 載る記録のパス（4 区画の記録。README・雛形・入れ子は載らない） */
+const RECORD_PATH = /^Cortex\/(Decisions|Glossary|Members|Rules)\/records\/[^/]+\.md$/;
+const isObj = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+/** メールの形（URL の部分を除いて見る） */
+// engine `change-log.mjs` の定義と同じ（緩めると、URL の後ろのメールや非 ASCII のローカル部が通る）
+const URL_IN_TEXT_RE = /https?:\/\/[^\s"'<>)\]]+/g;
+const EMAIL_RE = /[^\s@/:]+@[^\s@/:]+\.[^\s@/:]+/;
+const hasEmailShape = (text) => EMAIL_RE.test(text.replace(URL_IN_TEXT_RE, " "));
+/**
+ * `why.url` の検査（engine `cleanUrl` と同じ述語）。http(s) だけ・userinfo なし・クエリとフラグメントなし・
+ * 正規化しても同じ文字列。`javascript:` や `mailto:` は通らない
+ */
+function isCleanUrl(raw) {
+    if (typeof raw !== "string")
+        return false;
+    const s = raw.trim().replace(/[.,;:!?)\]>"'、。）」』]+$/u, "");
+    if (!/^https?:\/\//i.test(s))
+        return false;
+    let u;
+    try {
+        u = new URL(s);
+    }
+    catch {
+        return false;
+    }
+    if (!/^https?:$/.test(u.protocol))
+        return false;
+    if (u.username || u.password)
+        return false;
+    u.search = "";
+    u.hash = "";
+    return u.toString() === raw;
+}
+/** 日本時間の `YYYY/M/D`。読めない値は `null` */
+function jstDay(at) {
+    const t = Date.parse(at);
+    if (!Number.isFinite(t))
+        return null;
+    const d = new Date(t + 9 * 3600 * 1000);
+    return `${d.getUTCFullYear()}/${d.getUTCMonth() + 1}/${d.getUTCDate()}`;
+}
+const ROW_KEYS = ["at", "by", "what", "why", "commit"];
+const BY_KINDS = ["member", "night", "unknown"];
+const norm = (p) => p.normalize("NFC");
+/** 中身を読む（投げない）。契約に 1 つでも反すれば `null` */
+function parseChangeLog(text) {
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (!isObj(value) || value.version !== exports.CHANGE_LOG_VERSION)
+        return null;
+    if (Object.keys(value).some((k) => !["version", "window", "records"].includes(k)))
+        return null;
+    const w = value.window;
+    if (!isObj(w) || !Number.isInteger(w.days) || w.days <= 0 || !Number.isInteger(w.per_record) || w.per_record <= 0)
+        return null;
+    if (!isObj(value.records))
+        return null;
+    const rows = Object.create(null);
+    let seq = 0;
+    for (const rec of Object.values(value.records)) {
+        if (!isObj(rec))
+            return null;
+        if (Object.keys(rec).some((k) => k !== "path" && k !== "rows"))
+            return null;
+        if (typeof rec.path !== "string" || !rec.path || !Array.isArray(rec.rows))
+            return null;
+        const recPath = norm(rec.path);
+        const out = [];
+        for (const r of rec.rows) {
+            if (!isObj(r))
+                return null;
+            if (Object.keys(r).some((k) => !ROW_KEYS.includes(k)))
+                return null;
+            if (typeof r.at !== "string")
+                return null;
+            const t = Date.parse(r.at);
+            const day = jstDay(r.at);
+            if (!Number.isFinite(t) || !day)
+                return null;
+            const by = r.by;
+            if (!isObj(by) || typeof by.kind !== "string" || !BY_KINDS.includes(by.kind))
+                return null;
+            if (Object.keys(by).some((k) => k !== "kind" && k !== "member"))
+                return null;
+            if (by.kind === "member" && (typeof by.member !== "string" || !by.member))
+                return null;
+            if (by.kind !== "member" && "member" in by)
+                return null;
+            if (typeof r.what !== "string" || !r.what)
+                return null;
+            if (!/^[0-9a-f]{7,64}$/.test(String(r.commit ?? "")))
+                return null;
+            if (!Array.isArray(r.why) || r.why.length > WHY_MAX)
+                return null;
+            const why = [];
+            for (const x of r.why) {
+                if (!isObj(x) || Object.keys(x).some((k) => k !== "label" && k !== "url"))
+                    return null;
+                if (typeof x.label !== "string" || !x.label || !isCleanUrl(x.url))
+                    return null;
+                why.push({ label: x.label, url: x.url });
+            }
+            const row = {
+                day, who: by.kind, what: r.what, why, commit: r.commit, _t: t, _i: seq++,
+            };
+            if (by.kind === "member")
+                row.member = by.member;
+            out.push(row);
+        }
+        // 記録の鍵（id）の綴りは走査しない。載る記録のパスの形でないものは捨てる（__proto__ などの鍵も入らない）
+        if (!RECORD_PATH.test(recPath))
+            continue;
+        (rows[recPath] ||= []).push(...out);
+    }
+    // メール・Operated-By は行の中のどこにも持たない（URL の部分を除いたメールの形も）
+    const rowsText = JSON.stringify([value.window, ...Object.values(value.records).map((r) => (isObj(r) ? r.rows : null))]);
+    if (hasEmailShape(rowsText) || /operated-by/i.test(rowsText))
+        return null;
+    const result = { windowDays: w.days, rows: {} };
+    for (const [p, list] of Object.entries(rows)) {
+        // 新しい順（時刻の数値で・同じ時刻は元の並びのまま）→ 50 行で切る
+        list.sort((a, b) => b._t - a._t || a._i - b._i);
+        result.rows[p] = list.slice(0, exports.CHANGE_LOG_MAX_ROWS).map(({ _t, _i, ...row }) => row);
+    }
+    return result;
+}
+/** 案件リポから読む。無い → `null`（黙る）・壊れている → `null`（build のログに 1 行） */
+async function readChangeLog(repoRoot, ledgerDir) {
+    let text;
+    try {
+        text = await promises_1.default.readFile(node_path_1.default.join((0, ledger_dir_1.ledgerDirOf)(repoRoot, ledgerDir), exports.CHANGE_LOG_FILE), "utf8");
+    }
+    catch {
+        return null;
+    }
+    const parsed = parseChangeLog(text);
+    if (!parsed)
+        console.warn(`${exports.CHANGE_LOG_FILE}: 読めないので、記録ページの更新履歴は「まだありません」と出します`);
+    return parsed;
+}

package/dist/cli.js

@@ -22,6 +22,7 @@ program
     .option("--secret-kinds <kinds>", "鍵の入力欄を出す連携（カンマ区切り。例: figma,backlog）")
     .option("--webhook-url <url>", "Backlog Webhook 受信のLambda URL（環境変数 WEBHOOK_URL でも可）")
     .option("--webhook-token <token>", "リアルタイム同期の**案件別**トークン（環境変数 WEBHOOK_TOKEN でも可。艦隊共通トークンを渡さないこと）")
+    .option("--ledger-dir <dir>", "ビューアが読む帳簿（.cortex の 10 本）の置き場（未指定なら <リポジトリルート>/.cortex）")
     .action(async (dir, opts) => {
     try {
         const result = await (0, build_1.build)({
@@ -38,6 +39,7 @@ program
             secretKinds: opts.secretKinds,
             webhookUrl: opts.webhookUrl ?? process.env.WEBHOOK_URL,
             webhookToken: opts.webhookToken ?? process.env.WEBHOOK_TOKEN,
+            ledgerDir: opts.ledgerDir,
         });
         console.log(`✓ ${result.count} 件のレコードを ${result.outDir} にビルドしました`);
     }

package/dist/engagement.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.weightOf = exports.WEIGHTS = exports.HALF_LIFE_DAYS = exports.ENGAGEMENT_LEDGER_VERSION = exports.ENGAGEMENT_LEDGER_PATH = void 0;
+exports.weightOf = exports.WEIGHTS = exports.HALF_LIFE_DAYS = exports.ENGAGEMENT_LEDGER_VERSION = exports.ENGAGEMENT_LEDGER_FILE = void 0;
 exports.scoreOf = scoreOf;
 exports.engagementOrder = engagementOrder;
 exports.parseEngagementLedger = parseEngagementLedger;
@@ -43,8 +43,9 @@ exports.orderMembersByEngagement = orderMembersByEngagement;
  */
 const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
+const ledger_dir_1 = require("./ledger-dir");
 /** 帳簿の置き場（engine `scripts/engagement/keys.mjs` の `LEDGER_PATH`） */
-exports.ENGAGEMENT_LEDGER_PATH = ".cortex/gold-member-engagement.json";
+exports.ENGAGEMENT_LEDGER_FILE = "gold-member-engagement.json";
 /** 帳簿の版（engine `scripts/memory-index.mjs` の `LEDGER_VERSION`。違ったら読まない） */
 exports.ENGAGEMENT_LEDGER_VERSION = 1;
 /** 半減期（日）。engine `weights.mjs` の `HALF_LIFE_DAYS`（正本 6-B「半減期 90 日固定」） */
@@ -187,10 +188,10 @@ function parseEngagementLedger(text) {
     };
 }
 /** 案件リポから帳簿を読む（無ければ `null`・例外にしない） */
-async function readEngagementLedger(repoRoot) {
+async function readEngagementLedger(repoRoot, ledgerDir) {
     let text;
     try {
-        text = await promises_1.default.readFile(node_path_1.default.join(repoRoot, exports.ENGAGEMENT_LEDGER_PATH), "utf8");
+        text = await promises_1.default.readFile(node_path_1.default.join((0, ledger_dir_1.ledgerDirOf)(repoRoot, ledgerDir), exports.ENGAGEMENT_LEDGER_FILE), "utf8");
     }
     catch {
         return null;

package/dist/evidence-names.js

@@ -60,7 +60,7 @@ function minuteLabel(id) {
  * 片付けで移した会議の表（engine が目次と同じコミットで置く・cortex-engine #968 R-6・A-R6-3）。
  * 写しを片付けた案件だけが持つ。無ければ今どおり（移した議事録のリンクは種類の既定の名前で出る）
  */
-exports.MOVED_MEETINGS_FILE = ".cortex/mirror-moved-meetings.json";
+exports.MOVED_MEETINGS_FILE = "mirror-moved-meetings.json";
 /**
  * 移した会議の表 → `[移した URL, 会議の名前（「定例名 日付」）]` の並び。形が違う表・行は読まない（名前を当て推量しない）。
  * 名前は `minuteLabel`（`minute:` の根拠と同じ 1 本）で作る——同じ会議が `minute:` で書かれても URL で書かれても同じ名前になる

package/dist/ledger-dir.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_LEDGER_DIR_NAME = void 0;
+exports.defaultLedgerDir = defaultLedgerDir;
+exports.ledgerDirOf = ledgerDirOf;
+/**
+ * ビューアが読む帳簿（10 本）の置き場（cortex-engine #1094 便 3-11 の tools（T1））。
+ *
+ * 既定は `<リポジトリルート>/.cortex`（今までと同じ）。`--ledger-dir` で別のフォルダを指せる。
+ * ビューアは保管庫（S3）も栓も知らない（AWS SDK を足さない）。どこから持ってくるかは呼び出し側（workflow）の仕事で、
+ * ここは「そのフォルダの下の `<名前>.json` を読む」だけ。
+ *
+ * 🔴 `.cortex` という綴りの読み口は**ここ 1 か所だけ**（番人 `test/ledger-dir.test.mjs` が数える）。
+ */
+const node_path_1 = __importDefault(require("node:path"));
+/** 帳簿の置き場の既定の名前（リポジトリルートの下） */
+exports.DEFAULT_LEDGER_DIR_NAME = ".cortex";
+/** 既定の置き場: `<repoRoot>/.cortex` */
+function defaultLedgerDir(repoRoot) {
+    return node_path_1.default.join(repoRoot, exports.DEFAULT_LEDGER_DIR_NAME);
+}
+/** 呼び出し側が渡した置き場。無ければ既定 */
+function ledgerDirOf(repoRoot, ledgerDir) {
+    return ledgerDir ? node_path_1.default.resolve(ledgerDir) : defaultLedgerDir(repoRoot);
+}