@takagaki/cortex-decisions-viewer 0.12.123 → 0.12.124

package/dist/build.js

@@ -118,6 +118,7 @@ const confirmed_1 = require("./confirmed");
 const minify_1 = require("./minify");
 const render_1 = require("./render");
 const ledger_dir_1 = require("./ledger-dir");
+const view_dir_1 = require("./view-dir");
 /**
  * この画面を作ったパッケージの版。**package.json を唯一の出どころにする。**
  * 別に持つと、公開した版と画面に出る版がずれる（しかも気づけない）。
@@ -732,12 +733,18 @@ function orderRecordsByLedgers(records, recordsDir, ctx, nowIso) {
  * 全部が人になるため。engine の人の手の表がビューアに届く段 5 で差し替える。
  * 取りこぼしの代償は「確認の一言が出ない」だけ（消せる範囲は変わらない）。
  *
+ * 記憶 v2 の案件で人の手の表の写し（`memory-hands`）が読めたときは、2 の確認の帳簿の代わりに表の `touched` を見る
+ * （cortex-engine #1094 鎖 3 V10b・B9a。確認の帳簿は記憶 v2 では書かれなくなる）。表が読めない晩は今の確認の帳簿に倒す。
+ *
  * @param p リポジトリルート相対の path（`Cortex/<区画>/records/…`）。帳簿の鍵は NFC なので NFC でも引く
  * @param status その記録の `rstatus`（`String()` 済み）
+ * @param hands 人の手の表（path → touched）。渡したときは確認の帳簿を見ない
  */
-function humanTouchedOf(p, status, confirmation) {
+function humanTouchedOf(p, status, confirmation, hands = null) {
     if ((0, confirmed_1.humanOwned)(p, status))
         return true;
+    if (hands)
+        return hands.get(p) === true || hands.get(p.normalize("NFC")) === true;
     const row = confirmation.get(p) ?? confirmation.get(p.normalize("NFC"));
     return !!row && row.deleted !== true;
 }
@@ -746,11 +753,11 @@ function humanTouchedOf(p, status, confirmation) {
  * （今の SiteData の形を保つ）。path は `repoRoot` 起点で作る（帳簿の鍵はリポジトリルート相対）。
  * 置き換えの逆引き（`attachSupersedes`）より前に呼ぶ。
  */
-function attachHumanTouched(records, recordsDir, repoRoot, confirmation) {
+function attachHumanTouched(records, recordsDir, repoRoot, confirmation, hands = null) {
     const recordsRel = path.relative(repoRoot, recordsDir).split(path.sep).join("/");
     for (const r of records) {
         const p = recordsRel ? `${recordsRel}/${r.fileName}` : r.fileName;
-        if (humanTouchedOf(p, r.rstatus, confirmation))
+        if (humanTouchedOf(p, r.rstatus, confirmation, hands))
             r.humanTouched = true;
     }
 }
@@ -2370,6 +2377,18 @@ async function externalizeBodies(site, outAbs) {
     }
 }
 async function build(opts) {
+    // 合わせの置き場（`--view-dir`）の一時フォルダは、ビルドが落ちても消す
+    const views = {};
+    try {
+        const r = await buildSite(opts, views);
+        return views.counts ? { ...r, viewCounts: views.counts } : r;
+    }
+    finally {
+        if (views.cleanup)
+            await views.cleanup();
+    }
+}
+async function buildSite(opts, views) {
     const dirAbs = await resolveDecisionsDir(opts.dir);
     const outAbs = path.resolve(opts.out);
     const exclude = new Set([...DEFAULT_EXCLUDE, ...opts.exclude].map((e) => e.toLowerCase()));
@@ -2399,7 +2418,22 @@ 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);
+    let ledgerDir = (0, ledger_dir_1.ledgerDirOf)(repoRoot, opts.ledgerDir);
+    // 記憶 v2 の画面用ファイル（cortex-engine #1094 鎖 3 V10b）。checkout の HEAD とそろう封筒だけを差し替えた合わせの置き場を読む
+    // 合わせの置き場を作れなかった回（一時フォルダの失敗など）は今の帳簿の置き場のまま組む（取り出しの失敗で画面を止めない・数は出さない）
+    if (opts.viewDir) {
+        try {
+            const plan = await (0, view_dir_1.planViews)(path.resolve(opts.viewDir), (0, view_dir_1.checkoutGit)(repoRoot), ledgerDir);
+            const merged = await (0, view_dir_1.mergeLedgerDir)(ledgerDir, plan);
+            views.cleanup = merged.cleanup;
+            views.counts = plan.counts;
+            ledgerDir = merged.dir;
+            console.log((0, view_dir_1.viewCountsLine)(plan.counts));
+        }
+        catch (e) {
+            console.warn(`記憶 v2 の画面用ファイルを使えなかったので、今の帳簿から組みます: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
     const targetUrls = knowledgeRoot
         ? await buildTargetUrlMap(repoRoot, repo.baseUrl, repo.branch)
         : new Map();
@@ -2427,7 +2461,12 @@ async function build(opts) {
     // 目次と同じ順位（engine #551）。**読めないなら `null`** で、つながり画面の点は今までどおり一律
     const memoryRanking = await (0, ranking_1.readMemoryRanking)(repoRoot, ledgerDir);
     // 人の手の表の写し（engine #1094 q-10）。あれば記憶 v2 の案件で、確認の印とボタンを出さない。**無い案件は今と 1 バイトも同じ**（キーごと無い）
-    const memoryV2 = await (0, hands_1.readMemoryV2)(repoRoot, ledgerDir);
+    // 「記憶 v2 の案件か」は 1 本の栓 `memory_v2_writer` の値で決める（cortex-engine #1094 鎖 3 V10b）。橋の間は写しとの OR
+    const memoryHands = await (0, hands_1.readMemoryHands)(repoRoot, ledgerDir);
+    const memoryV2 = (0, hands_1.isMemoryV2)(opts.memoryV2Writer, memoryHands !== null);
+    // 削除の確認の一言の材料（B9a）: 記憶 v2 の案件で表が読めたときは表、ほかは今の確認の帳簿
+    // （表が読めた案件は必ず記憶 v2 なので、表そのものを渡せばよい）
+    const touchedBy = memoryHands;
     // 記録の id → リポジトリルート相対のパス（順位のファイルの鍵と突き合わせる。`repoRoot` 起点・cwd 起点にしない）
     const recordRelPaths = new Map();
     const relOf = (dir, fileName) => {
@@ -2447,7 +2486,7 @@ async function build(opts) {
             rawDates.set(rec, rd);
     }
     // 人の手（削除の確認の文面を替える材料・cortex-engine #1094 段 4）。**置き換えより前に・repoRoot で**
-    attachHumanTouched(decisions, dirAbs, repoRoot, ledgers.confirmation);
+    attachHumanTouched(decisions, dirAbs, repoRoot, ledgers.confirmation, touchedBy);
     // 置き換えの逆引き（#699 F3）。**置き換えの無い案件では 1 件も付かない**
     attachSupersedes(decisions, (d) => rawDates.get(d) ?? d.fm.date, (d) => relOf(dirAbs, d.fileName));
     let home = null;
@@ -2490,7 +2529,7 @@ async function build(opts) {
             const recordsDir = path.join(knowledgeRoot, e.name, "records");
             const records = await loadGenericRecords(recordsDir, exclude, repo.baseUrl, repo.branch);
             // 人の手（削除の確認の文面を替える材料・cortex-engine #1094 段 4）
-            attachHumanTouched(records, recordsDir, repoRoot, ledgers.confirmation);
+            attachHumanTouched(records, recordsDir, repoRoot, ledgers.confirmation, touchedBy);
             // ルールの取り下げ（`retracted_by`・cortex-engine #1094 便 4-2d）。ルールの区画だけ・取り下げの無い案件では何も付かない
             if (e.name === "Rules")
                 attachRetractedBy(records, decisions, (d) => rawDates.get(d) ?? d.fm.date);

package/dist/cli.js

@@ -2,6 +2,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
+const promises_1 = require("node:fs/promises");
 const build_1 = require("./build");
 const program = new commander_1.Command();
 program
@@ -23,6 +24,10 @@ program
     .option("--webhook-url <url>", "Backlog Webhook 受信のLambda URL（環境変数 WEBHOOK_URL でも可）")
     .option("--webhook-token <token>", "リアルタイム同期の**案件別**トークン（環境変数 WEBHOOK_TOKEN でも可。艦隊共通トークンを渡さないこと）")
     .option("--ledger-dir <dir>", "ビューアが読む帳簿（.cortex の 10 本）の置き場（未指定なら <リポジトリルート>/.cortex）")
+    .option("--view-dir <dir>", "記憶 v2 の画面用ファイル（保管庫の gold/v1/c/view/ を取り出した手元のフォルダ）。checkout とそろう物だけ使い、ほかは帳簿の置き場から読む")
+    .option("--memory-v2-writer <state>", "栓 memory_v2_writer の値（off / shadow / on。on だけが記憶 v2 の案件）")
+    .option("--generated-at <text>", "生成時刻の表示（未指定ならビルドした時刻 \"YYYY-MM-DD HH:MM UTC\"。2 通りのビルドの突き合わせで揃える口）")
+    .option("--view-report <file>", "--view-dir の数（4 分類と目次に無い数）を JSON で書く先")
     .action(async (dir, opts) => {
     try {
         const result = await (0, build_1.build)({
@@ -32,7 +37,7 @@ program
             repoUrl: opts.repoUrl,
             branch: opts.branch,
             exclude: opts.exclude ?? [],
-            generatedAt: new Date().toISOString().replace("T", " ").slice(0, 16) + " UTC",
+            generatedAt: opts.generatedAt ?? new Date().toISOString().replace("T", " ").slice(0, 16) + " UTC",
             intakeUrl: opts.intakeUrl ?? process.env.INTAKE_URL,
             intakeToken: opts.intakeToken ?? process.env.INTAKE_TOKEN,
             projectKey: opts.projectKey,
@@ -40,7 +45,14 @@ program
             webhookUrl: opts.webhookUrl ?? process.env.WEBHOOK_URL,
             webhookToken: opts.webhookToken ?? process.env.WEBHOOK_TOKEN,
             ledgerDir: opts.ledgerDir,
+            viewDir: opts.viewDir,
+            memoryV2Writer: opts.memoryV2Writer,
         });
+        if (opts.viewReport) {
+            // 数だけ（名前・本文は書かない）。--view-dir を渡さなかった回は書かない
+            if (result.viewCounts)
+                await (0, promises_1.writeFile)(opts.viewReport, `${JSON.stringify(result.viewCounts)}\n`, "utf8");
+        }
         console.log(`✓ ${result.count} 件のレコードを ${result.outDir} にビルドしました`);
     }
     catch (err) {

package/dist/hands.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MEMORY_HANDS_VERSION = exports.MEMORY_HANDS_FILE = void 0;
 exports.isMemoryHandsCopy = isMemoryHandsCopy;
 exports.readMemoryV2 = readMemoryV2;
+exports.readMemoryHands = readMemoryHands;
+exports.isMemoryV2 = isMemoryV2;
 /**
  * 人の手の表の写し（`.cortex/memory-hands.json`）を読む（cortex-engine #1094 q-10・仕様 1-6）。
  *
@@ -38,15 +40,44 @@ function isMemoryHandsCopy(text) {
 }
 /** 案件リポに写しがあり、読める形か。無い → `false`（黙る）・壊れている → `false`（build のログに 1 行） */
 async function readMemoryV2(repoRoot, ledgerDir) {
+    return (await readMemoryHands(repoRoot, ledgerDir)) !== null;
+}
+/**
+ * 人の手の表の写しの中身（記録の path → 人の手があるか `touched`）。無い・読めない → `null`（壊れているときだけ build のログに 1 行）。
+ * 鍵は engine が綴った path（リポジトリルート相対・NFC）。値の欄は `touched` だけを持つ（素通しはしない）
+ */
+async function readMemoryHands(repoRoot, ledgerDir) {
     let text;
     try {
         text = await promises_1.default.readFile(node_path_1.default.join((0, ledger_dir_1.ledgerDirOf)(repoRoot, ledgerDir), exports.MEMORY_HANDS_FILE), "utf8");
     }
     catch {
-        return false;
+        return null;
     }
-    const ok = isMemoryHandsCopy(text);
-    if (!ok)
+    if (!isMemoryHandsCopy(text)) {
         console.warn(`${exports.MEMORY_HANDS_FILE}: 読めないので、この案件は記憶 v2 でないものとして出します`);
-    return ok;
+        return null;
+    }
+    const records = JSON.parse(text).records;
+    const out = new Map();
+    for (const [p, v] of Object.entries(records)) {
+        const row = v && typeof v === "object" && !Array.isArray(v) ? v : null;
+        // 🔴 厳密に true のときだけ（"true" や 1 を人の手と読まない）
+        out.set(p, !!row && row.touched === true);
+    }
+    return out;
+}
+/** 1 本の栓 `memory_v2_writer` の値の語彙（engine `scripts/observe/rollout.mjs` の `ROLLOUT_STATES`） */
+const WRITER_STATES = new Set(["off", "shadow", "on"]);
+/**
+ * この案件は記憶 v2 か（cortex-engine #1094 鎖 3 V10b・確定版 3 章 4）。**1 本の栓 `memory_v2_writer` の値で決める**
+ * （workflow が SSM の値を `--memory-v2-writer` で渡す・`on` だけが v2。`shadow` は `off` に潰す＝engine と同じ）。
+ * 橋の間（V11b まで）は、人の手の表の写しがあることとの OR（受け口 `infra/lambda/intake/logic.mjs` の `memoryV2GateOf` と同じ OR）。
+ * 渡されない・語彙外の値は「栓は on でない」と読む（写しがあれば v2・今と同じ）
+ */
+function isMemoryV2(writer, handsCopy) {
+    const w = typeof writer === "string" ? writer.trim() : "";
+    if (w && !WRITER_STATES.has(w))
+        console.warn(`--memory-v2-writer の値が語彙の外です（off として読みます）: ${JSON.stringify(w.slice(0, 20))}`);
+    return w === "on" || handsCopy;
 }

package/dist/view-dir.js

@@ -0,0 +1,273 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VIEW_INDEX_FILE = exports.VIEW_HELD = exports.VIEW_NAMES = void 0;
+exports.blobShaOf = blobShaOf;
+exports.isReadableEnvelope = isReadableEnvelope;
+exports.classifyView = classifyView;
+exports.checkoutGit = checkoutGit;
+exports.planViews = planViews;
+exports.mergeLedgerDir = mergeLedgerDir;
+exports.viewCountsLine = viewCountsLine;
+/**
+ * 記憶 v2 の画面用ファイルの読み口 `--view-dir`（cortex-engine #1094 鎖 3 V10b・確定版 3 章 2）。
+ *
+ * engine の記憶側の晩の終わりの段 `views`（V10a・`scripts/memory-v2/memory/post.mjs`）が、`.cortex` の帳簿 8 本と順位（段 `ranking`）を
+ * 封筒 `{ v:1, name, run, at, commit, blob, text }` に包んで保管庫の `gold/v1/c/view/<名前>.json` に置き、最後に目次 `view-index.json`
+ * （名前ごとに `{ blob, commit, at, absent }`）を置く。workflow（engine の `build-viewer.yml`）がそれを 1 行の `aws s3 sync` で作業場に
+ * 取り出し、このビューアに `--view-dir` で渡す。🔴 **ビューアは保管庫を知らないまま**（ほどくのは手元のファイルだけ・AWS SDK を足さない）。
+ *
+ * ## 何をするか
+ *
+ * 目次を読み、名前ごとに封筒をほどいて分類する（`classifyView`・中身で決める）:
+ * - `same`: 封筒の本文が今の帳簿の置き場のファイルとバイトで同じ（無いの封筒は、置き場にも無い）→ **封筒の本文を使う**
+ * - `stale`・`unexplained`・`unverified`・`unreadable`: 中身が違うか読めない → 名前ごとに今の帳簿に倒す（数え分けは `classifyView`）
+ * 目次に載っていない名前（目次が無い晩を含む）は `missing` に数え、`.cortex` に倒す（橋の間・B8）。
+ *
+ * 使う物だけを差し替えた**合わせの置き場**（一時フォルダ）を作り、ビルドはそこを帳簿の置き場として読む（読み口は今の `--ledger-dir` と同じ 1 本）。
+ * 封筒の本文が使えるのは、HEAD の `.cortex` とバイトで同じとき（same）だけなので、橋の間は `.cortex` から組んだサイトと 1 バイトも変わらない。
+ *
+ * ## 名前（engine の宣言表 `publish: "viewer"` の行・V10a の `VIEW_HELD`）
+ *
+ * - 読む 11 本のうち、記憶側が置くのは 8 本＋順位 1 本（`VIEW_NAMES`）
+ * - 名寄せの提案（`gold-proposals`・A1 の答えまで）と確認の帳簿（`gold-confirmation`・B9a で人の手の表に寄せる）は置かれないので、いつも `.cortex` から読む
+ */
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const ledger_dir_1 = require("./ledger-dir");
+/** 記憶側が置く名前（宣言表の `publish: "viewer"` の行から、置かない 2 本を除いた 8 本と順位）。並びは名前順 */
+exports.VIEW_NAMES = Object.freeze([
+    "gold-activity",
+    "gold-change-log",
+    "gold-member-engagement",
+    "gold-rederivation",
+    "gold-term-strength",
+    "memory-hands",
+    "memory-ranking",
+    "mirror-moved-meetings",
+    "story-days",
+]);
+/** 置かれない名前（いつも `.cortex` から読む）と理由 */
+exports.VIEW_HELD = Object.freeze({
+    "gold-proposals": "名寄せの提案のカード（A1 の答えまで .cortex）",
+    "gold-confirmation": "削除の確認の一言（記憶 v2 の案件では人の手の表に寄せる・B9a）",
+});
+/** 目次の名前（engine `VIEW_INDEX_NAME`） */
+exports.VIEW_INDEX_FILE = "view-index.json";
+const SHA_RE = /^[0-9a-f]{40}$/;
+const isSha = (s) => typeof s === "string" && SHA_RE.test(s);
+/** git の blob の sha（engine `blobShaOf` と同じ・utf8 のバイト列） */
+function blobShaOf(text) {
+    const body = Buffer.from(String(text), "utf8");
+    return (0, node_crypto_1.createHash)("sha1").update(Buffer.concat([Buffer.from(`blob ${body.length}\0`, "utf8"), body])).digest("hex");
+}
+/** 封筒が読める形か（engine `isReadableEnvelope` の写し） */
+function isReadableEnvelope(e) {
+    if (!e || typeof e !== "object" || Array.isArray(e))
+        return false;
+    const o = e;
+    if (o.v !== 1 || typeof o.name !== "string" || typeof o.run !== "string" || typeof o.at !== "string")
+        return false;
+    if (!isSha(o.commit))
+        return false;
+    if (o.absent === true)
+        return o.blob === null && o.text === null;
+    return isSha(o.blob) && typeof o.text === "string";
+}
+/**
+ * 1 本の封筒の分類（ビューアの読み手の比べ）。**中身で決める**: 封筒の本文が、今の帳簿の置き場のファイルとバイトで同じなら `same`（使う）。
+ *
+ * engine の `classifyEnvelope`（`view-publish.mjs`）は「封筒の commit が HEAD の祖先か」を先に見るが、ここはそれを使わない。
+ * 記憶側は同じ中身の晩に置き直さない（封筒の commit は古くなる）・ビルドの checkout は浅い（`fetch-depth: 2000`）・
+ * push で起きたビルドは公開より前の版を checkout していることがある、の 3 つで、祖先の判じが中身と関係なく落ちるため（実装レビュー 🔴1・🟠2）。
+ * git は、中身が違うときに「説明がつくか」を分けるのにだけ使う:
+ * - `stale`: 封筒の commit が HEAD の祖先でその版の blob と合う（後から帳簿が変わった）・HEAD が封筒の commit の祖先（checkout が公開より古い）・
+ *   目次と封筒が食い違う（取り出しと公開が重なった）
+ * - `unexplained`: 名前違い・本文の sha が blob と違う・その版の blob と違う・どちらも祖先でない（枝分かれ）
+ * - `unverified`: 中身が違い、封筒の commit が手元の履歴に無い（浅い clone）。門の外の数
+ * - `unreadable`: 封筒・目次の行が読めない・形が違う
+ */
+function classifyView({ envelope, expectedName, indexRow, currentBlob, head, isAncestor, blobAt, }) {
+    if (!indexRow || !isReadableEnvelope(envelope))
+        return "unreadable";
+    const e = envelope;
+    if (e.name !== expectedName)
+        return "unexplained";
+    if (e.absent !== true && blobShaOf(e.text) !== e.blob)
+        return "unexplained";
+    const envBlob = e.absent === true ? null : e.blob;
+    if (envBlob === currentBlob)
+        return "same";
+    // 目次と封筒の食い違い（取り出しの sync と公開の Put が重なった）は、後から変わったのと同じに数える
+    if (indexRow.commit !== e.commit || indexRow.blob !== e.blob || indexRow.absent !== (e.absent === true))
+        return "stale";
+    if (head === null)
+        return "unverified";
+    try {
+        if (isAncestor(e.commit, head))
+            return (blobAt(e.commit, e.name) ?? null) === envBlob ? "stale" : "unexplained";
+        return isAncestor(head, e.commit) ? "stale" : "unexplained";
+    }
+    catch {
+        return "unverified";
+    }
+}
+/** checkout の git（`repoRoot` で呼ぶ）。🔴 投げる口はそのまま投げる（比べの側で unexplained に倒す） */
+function checkoutGit(repoRoot) {
+    const git = (args) => (0, node_child_process_1.execFileSync)("git", args, { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+    return {
+        head: () => {
+            const h = git(["rev-parse", "--verify", "HEAD^{commit}"]);
+            if (!isSha(h))
+                throw new Error("HEAD を読めません");
+            return h;
+        },
+        isAncestor: (a, b) => {
+            if (!isSha(a) || !isSha(b))
+                throw new Error("commit の形が違います");
+            try {
+                (0, node_child_process_1.execFileSync)("git", ["merge-base", "--is-ancestor", a, b], { cwd: repoRoot, stdio: "ignore" });
+                return true;
+            }
+            catch (e) {
+                // 1 は「祖先でない」。それ以外（128＝commit が無い・浅い clone）は判じられない
+                if (e.status === 1)
+                    return false;
+                throw e;
+            }
+        },
+        blobAt: (commit, name) => {
+            if (!isSha(commit))
+                throw new Error("commit の形が違います");
+            try {
+                const sha = git(["rev-parse", "--verify", "-q", `${commit}:./${ledger_dir_1.DEFAULT_LEDGER_DIR_NAME}/${name}.json`]);
+                return isSha(sha) ? sha : null;
+            }
+            catch {
+                // その版に commit があって、ファイルだけが無い → null。commit そのものが無いのは判じられない（投げる）
+                (0, node_child_process_1.execFileSync)("git", ["cat-file", "-e", `${commit}^{commit}`], { cwd: repoRoot, stdio: "ignore" });
+                return null;
+            }
+        },
+    };
+}
+async function readText(p) {
+    try {
+        return await promises_1.default.readFile(p, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+/** 目次を読む。無い → `null`・壊れている → `"unreadable"`・読める → 名前ごとの行 */
+async function readIndex(viewDir) {
+    const text = await readText(node_path_1.default.join(viewDir, exports.VIEW_INDEX_FILE));
+    if (text === null)
+        return null;
+    try {
+        const doc = JSON.parse(text);
+        const o = doc && typeof doc === "object" && !Array.isArray(doc) ? doc : null;
+        const names = o && o.v === 1 && o.names && typeof o.names === "object" && !Array.isArray(o.names) ? o.names : null;
+        if (!names)
+            return "unreadable";
+        const out = {};
+        for (const [k, v] of Object.entries(names)) {
+            const r = v && typeof v === "object" && !Array.isArray(v) ? v : null;
+            // 形の違う行は null（その名前は unreadable に数える。missing に紛れさせない・実装レビュー 🟡4）
+            if (!r || !isSha(r.commit) || !(r.blob === null || isSha(r.blob))) {
+                out[k] = null;
+                continue;
+            }
+            out[k] = { blob: r.blob, commit: r.commit, absent: r.absent === true };
+        }
+        return out;
+    }
+    catch {
+        return "unreadable";
+    }
+}
+/**
+ * 画面用ファイルの置き場を読んで、名前ごとに使うかを決める（ファイルは書かない）。`baseDir` は今の帳簿の置き場（`.cortex` か `--ledger-dir`）で、
+ * same は「封筒の本文がそのフォルダのファイルとバイトで同じ」（だから合わせの置き場は今の帳簿と 1 バイトも変わらない）。
+ * git（HEAD・祖先・その版の blob）は、中身が違うときの数え分けにだけ使う
+ */
+async function planViews(viewDir, git, baseDir) {
+    const classes = {};
+    const use = {};
+    const index = await readIndex(viewDir);
+    let head = null;
+    try {
+        head = git.head();
+    }
+    catch {
+        head = null;
+    }
+    for (const name of exports.VIEW_NAMES) {
+        if (index === null || (index !== "unreadable" && !Object.prototype.hasOwnProperty.call(index, name))) {
+            classes[name] = "missing";
+            continue;
+        }
+        if (index === "unreadable") {
+            classes[name] = "unreadable";
+            continue;
+        }
+        const text = await readText(node_path_1.default.join(viewDir, `${name}.json`));
+        let env = null;
+        try {
+            env = text === null ? null : JSON.parse(text);
+        }
+        catch {
+            env = null;
+        }
+        const cur = await readText(node_path_1.default.join(baseDir, `${name}.json`));
+        const c = classifyView({
+            envelope: env,
+            expectedName: name,
+            indexRow: index[name],
+            currentBlob: cur === null ? null : blobShaOf(cur),
+            head,
+            isAncestor: git.isAncestor,
+            blobAt: git.blobAt,
+        });
+        classes[name] = c;
+        if (c === "same")
+            use[name] = env.absent === true ? null : env.text;
+    }
+    const counts = { total: exports.VIEW_NAMES.length, same: 0, stale: 0, unexplained: 0, unreadable: 0, unverified: 0, missing: 0 };
+    for (const c of Object.values(classes))
+        counts[c] += 1;
+    return { classes, counts, use };
+}
+/**
+ * 合わせの置き場を作る: `baseDir`（`.cortex` か `--ledger-dir`）の中身を一時フォルダに写し、same の名前だけ封筒の本文で差し替える
+ * （「無い」の封筒はその名前を消す）。戻りの `cleanup` で消す
+ */
+async function mergeLedgerDir(baseDir, plan) {
+    const dir = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "cortex-view-"));
+    try {
+        await promises_1.default.cp(baseDir, dir, { recursive: true });
+    }
+    catch (e) {
+        if (e?.code !== "ENOENT") {
+            await promises_1.default.rm(dir, { recursive: true, force: true });
+            throw e;
+        }
+    }
+    for (const [name, text] of Object.entries(plan.use)) {
+        const p = node_path_1.default.join(dir, `${name}.json`);
+        if (text === null)
+            await promises_1.default.rm(p, { force: true });
+        else
+            await promises_1.default.writeFile(p, text, "utf8");
+    }
+    return { dir, cleanup: () => promises_1.default.rm(dir, { recursive: true, force: true }) };
+}
+/** 数の 1 行（ビルドのログ。名前は出さない） */
+function viewCountsLine(c) {
+    return `記憶 v2 の画面用ファイル: ${c.total} 本のうち 使った ${c.same}・後から変わった ${c.stale}・説明のつかない ${c.unexplained}・読めない ${c.unreadable}・履歴で確かめられない ${c.unverified}・目次に無い ${c.missing}（使わなかった分は今の帳簿から読みました）`;
+}

package/package.json

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