@takagaki/cortex-decisions-viewer 0.12.85 → 0.12.87

package/dist/rederivation.js

@@ -24,7 +24,7 @@ exports.humanFollowupOf = humanFollowupOf;
  *
  * | 帳簿 | 何を持つか | 書き手 |
  * | --- | --- | --- |
- * | `.cortex/gold-confirmation.json` | レコードごとの「人が確認した版」と、そこから変わったか（**sha だけ**） | 夜間（全置換・git から作り直せる） |
+ * | `.cortex/gold-confirmation.json` | レコードごとの「人が確認した版」と、その後の機械の書き直しの最新（`rewritten`・中身の指紋つき・#799） | 夜間（全置換・git から作り直せる） |
  * | `.cortex/gold-rederivation.json` | 書き直しの根拠の件数・shadow の「書くつもりだった差分」 | 夜間（追記・区画ごとの節） |
  * | `.cortex/gold-activity.json` | 「最後に見た日」と触れた日の列（＋観測の到達点 `cursor`） | 夜間（追記・剪定つき） |
  *
@@ -46,7 +46,6 @@ const node_crypto_1 = __importDefault(require("node:crypto"));
 const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
 const gray_matter_1 = __importDefault(require("gray-matter"));
-const commit_classify_1 = require("./commit-classify");
 /** 帳簿の版（違ったら空として扱う・engine `LEDGER_VERSION`） */
 exports.LEDGER_VERSION = 1;
 /** 帯を出す区画。**用語とメンバーだけ**（Decisions は積み上げ・Rules は便 13） */
@@ -147,6 +146,16 @@ async function readRederivationLedgers(repoRoot) {
                 : [];
             // 中身の指紋は**文字列のときだけ**持つ（engine #546 が書く。古い帳簿の行には無い）
             const contentSha = typeof confirmed.content_sha === "string" ? confirmed.content_sha : "";
+            // 機械の書き直し（#799）。**オブジェクトのときだけ**持つ。欄が無い（#799 より前の帳簿）・
+            // null（確認の後に機械の書き直しが無い）はどちらもキーごと無い＝帯は出ない
+            const rw = asRecord(row?.rewritten);
+            const rewritten = rw
+                ? {
+                    at: typeof rw.at === "string" ? rw.at : "",
+                    commit: typeof rw.commit === "string" ? rw.commit : "",
+                    contentSha: typeof rw.content_sha === "string" ? rw.content_sha : "",
+                }
+                : null;
             out.confirmation.set(p, {
                 at: confirmed.at != null ? String(confirmed.at) : "",
                 by: confirmed.by != null ? String(confirmed.by) : "",
@@ -154,6 +163,13 @@ async function readRederivationLedgers(repoRoot) {
                 commit: commit,
                 changedBy: changedBy,
                 ...(contentSha ? { contentSha: contentSha } : {}),
+                ...(rewritten ? { rewritten: rewritten } : {}),
+                // 🔴 **厳密に true のときだけ**（"true" や 1 を削除と読まない）
+                ...(confirmed.deleted === true ? { deleted: true } : {}),
+                // 基準コミットでの path（改名の前の確認）。**空でない文字列で、今の path と違うときだけ**持つ
+                ...(typeof confirmed.path === "string" && confirmed.path !== "" && confirmed.path !== p
+                    ? { basePath: confirmed.path }
+                    : {}),
             });
         }
     }
@@ -350,9 +366,10 @@ function sameRederivedContent(a, b) {
 /**
  * 「説明文と本文」の指紋。**帳簿の `confirmed.content_sha` と突き合わせる綴り**。
  *
- * 🔴 比べる相手は engine #546 が書く `confirmed.content_sha`。**一致したときだけ
- * 「変わっていない」と言い、食い違ったら git へ落とす**（`attachRederived`）——engine が
- * 別の綴りで指紋を作っていた場合に、全レコードへ誤報が出るのを避けるため。
+ * 🔴 比べる相手は engine が書く 2 つの指紋——`rewritten.content_sha`（機械が書き直した版・#799）と
+ * `confirmed.content_sha`（人が確認した版・#546）。帯は「今の指紋 ＝ 書き直した版 ≠ 確認した版」の
+ * ときだけ出る（`rederivedBandOf`）。**綴りがずれると「今 ＝ 書き直した版」が当たらなくなり、
+ * 帯は出ない側に倒れる**（誤報より無言）。
  *
  * engine の写し: `cortex-engine/scripts/rederive/content-sha.mjs`・一致の番人:
  * `cortex-engine/test/rederive-history.test.mjs` の #546 の節（ここを変えたら engine の `VIEWER_SHA` を計算し直す）
@@ -362,12 +379,12 @@ function contentShaOf(raw) {
     return node_crypto_1.default.createHash("sha256").update(c.description + "\u0000" + c.body, "utf8").digest("hex");
 }
 /**
- * そのレコードが印の**候補**なら、人が確認した版を git から引くための key
- * （`<基準コミット>:<path>`）。候補でなければ null。
+ * そのレコードが帯の**候補**か（決定表の行 0〜4・中身を読む前の安い行だけ）。候補なら
+ * `<基準コミット>:<path>`（人が確認した版を git から引くときの key）、候補でなければ null。
  *
- * 🔴 **決定表の行 0〜3 と同じ門**（`rederivedBandOf` の手前の安い行だけ）。ここで候補を
- * 絞ってから `readBlobsAt` に**まとめて 1 回**渡す——全レコードぶんの key を作ると、
- * 用語が 1400 件ある案件で毎晩 1400 個の blob を読むことになる。
+ * 🔴 **ここで候補を絞ってから今の版を読む**——全レコードぶん作業ツリーを読むと、
+ * 用語が 1400 件ある案件で毎晩 1400 件を読むことになる。git に渡るのはさらにその中の
+ * 「帳簿に人が確認した版の指紋が無い」記録だけ（`attachRederived`）。
  */
 function rederivedContentKey(recordPath, status, ledgers) {
     if (!isConfirmedStatus(status))
@@ -375,132 +392,83 @@ function rederivedContentKey(recordPath, status, ledgers) {
     if (!BAND_SECTION_RE.test(recordPath))
         return null;
     const conf = ledgers.confirmation.get(recordPath);
-    if (!conf || !conf.commit || !conf.changedBy.length)
+    if (!conf || !conf.commit || conf.deleted || conf.basePath)
+        return null;
+    const rw = conf.rewritten;
+    if (!rw || !rw.contentSha || !rw.at)
         return null;
     return `${conf.commit}:${recordPath}`;
 }
 /**
- * そのレコードに帯を立てるか（#665 の**決定表**・上から順に評価し、当たった行で終わる）。
+ * そのレコードに帯を立てるか（#799 の**決定表**・上から順に評価し、当たった行で終わる）。
  *
  * | 順 | 条件 | 結果 |
  * | --- | --- | --- |
- * | **0** | **その記録の `status` が `draft`（＝「AI生成・未確認」の札が出る）** | **立てない**（#667） |
- * | 1 | path が用語・メンバーのレコードでない | 立てない |
- * | 2 | `confirmation` に行が無い／基準コミットが空／確認日が日時として読めない | 立てない |
- * | 3 | `changed_by` が空 | 立てない |
- * | 4 | `changed_by` の 1 件ずつに 4a〜4e を当てて**残りが 0 件** | 立てない |
- * | 4a | sha が基準コミットと同じ | その sha を落とす |
- * | 4b | sha が git の窓に無い | 落とす（**不明**・`miss.unresolved` に数える） |
- * | 4c | 分類が「人」または「不明」 | 落とす |
- * | 4d | **どちらかの綴りで引っ越し** | 落とす |
- * | 4e | author 日付が確認日**以前**（epoch 比較） | 落とす |
- * | 5 | 残りのうち最も新しい author 日付を「書き直した日」にする | 候補になる |
- * | **8** | **人が確認した版から「説明文（`description`）か本文」が変わったか**（`verdict`） | **`changed` のときだけ立てる** |
- * | 6 | 根拠は、帳簿の行の `commit` が `changed_by` に入っているときだけ出す | 出す／出さない |
- * | 7 | 基準コミットが削除のコミットなら「戻す」を出さない（`baseDeleted`） | — |
- *
- * 🔴 **行 8 がこの機能の本丸**（2026-09-20 の誤報）。前はここが無く、「確認の基準コミットより
- * 後に機械のコミットがその path に 1 件でもあるか」だけで立てていた——**ファイルの中身を
- * 1 バイトも見ていなかった**ので、移行でフロントマターの使わない 1 行（`side: cm`）が
- * 消えただけの回にも、関係者 11 人の画面に「変わりました」が出た。
+ * | 0 | その記録の `status` が `draft`（＝「AI生成・未確認」の札が出る） | 出さない（#667） |
+ * | 1 | path が用語・メンバーのレコードでない | 出さない |
+ * | 2 | `confirmation` に行が無い／基準コミットが空 | 出さない |
+ * | 3 | **基準コミットがこの path を消した（`confirmed.deleted`）／基準コミットでの path が今と違う（`confirmed.path`・改名の前の確認）** | **出さない** |
+ * | 4 | **`rewritten` が無い（古い帳簿）・null・指紋が空・日時が空** | **出さない** |
+ * | 5 | 今の版が読めない | 出さない（`miss.unreadable` に数える） |
+ * | 6 | **今の版の指紋 ≠ `rewritten.content_sha`**（後から人や機械が直した） | **出さない** |
+ * | 7a | 帳簿に人が確認した版の指紋がある: **今の指紋 = その指紋**（元に戻った） | **出さない** |
+ * | 7b | 指紋が無い（engine が自信を持てない形・#546 より前）: git の基準版と比べて `changed` でない | 出さない |
+ * | 8 | 根拠は、根拠の帳簿の行の `commit` が `rewritten.commit` と同じときだけ出す | 出す／出さない |
+ *
+ * 🔴 **人か機械かを画面が見分けない**（#799）。前は `changed_by` の sha ごとに git の素性
+ *（名義・件名・trailer）を引き、engine の分類の**写し**で機械の書き直しを拾っていた。
+ * 写しはずれる（App 名義の画面操作を機械と読む日が来る）ので、見分けは engine に 1 か所で
+ * 寄せ、画面は「今の版が、engine が機械の書き直しと呼んだ版そのものか」だけを指紋で見る。
+ * 後から人や別の機械が直していれば指紋が合わないので、「戻す」が人の編集を消すことはない。
  *
  * @param status その記録の `rstatus`（`String()` 済み）。**2 番目の必須引数**にしてある——
  *   末尾の任意引数にすると、渡し忘れが「行 0 の門が静かに開く」になる（設計レビュー 🔴3）
- * @param verdict 行 8 の答えを引く関数（`(recordPath, baseCommit) => ContentVerdict`）。
- *   🔴 **必須引数**にしてある——任意にすると、渡し忘れが「中身を見ない昔の判定」に静かに戻る。
- *   `changed` 以外（`same` / `unknown`）は**立てない**
+ * @param nowShaOf 今の版（作業ツリー）の `contentShaOf`。読めなければ null。
+ *   🔴 **必須引数**——任意にすると、渡し忘れが「指紋を見ずに出す」に静かに倒れる
+ * @param verdict 行 7b の答えを引く関数（`(recordPath, baseCommit) => ContentVerdict`）。
+ *   帳簿に人が確認した版の指紋がある記録では**呼ばない**
  * @param miss 立たなかった理由を数える器（呼び出し側で 1 つ作って全レコードで共有する）
  */
-function rederivedBandOf(recordPath, status, ledgers, identities, verdict, miss) {
-    // 0. 「AI生成・未確認」の札が出る記録には帯を重ねない（#667）。**綴りは 1 か所**
-    //（ここで `status === "draft"` と直書きすると、判定が 2 つに増えて一致が崩れる）
-    if (!isConfirmedStatus(status))
-        return null;
-    if (!BAND_SECTION_RE.test(recordPath))
+function rederivedBandOf(recordPath, status, ledgers, nowShaOf, verdict, miss) {
+    // 0〜4. 中身を読む前の門（候補の絞り込みと同じ 1 つの関数に寄せる。2 つに増やすと一致が崩れる）
+    if (!rederivedContentKey(recordPath, status, ledgers))
         return null;
     const conf = ledgers.confirmation.get(recordPath);
-    // 基準コミットが空の行はここで落とす（読み手は並びのために持っている）
-    if (!conf || !conf.commit || !conf.changedBy.length)
+    const rw = conf.rewritten;
+    // 5. 今の版の指紋
+    const now = nowShaOf(recordPath);
+    if (now == null) {
+        if (miss)
+            miss.unreadable.add(recordPath);
         return null;
-    // 確認日が読めない帳簿では「後か前か」を言えないので立てない（順序の確かめが要）
-    const confirmedMs = Date.parse(conf.at);
-    if (!Number.isFinite(confirmedMs))
-        return null;
-    let newest = null;
-    /** 確認より後の**人**のコミットの最新（帳簿が前の夜のもので、基準点がまだ動いていない夜） */
-    let newestHuman = 0;
-    for (const sha of conf.changedBy) {
-        // 4a. 基準コミット自身が並んでいる帳簿（作り直し前・手で書いたもの）に引っかからない
-        if (sha === conf.commit)
-            continue;
-        const id = identities.get(sha);
-        if (!id) {
-            // 4b. 窓の外・浅い clone ＝ 見分けられない（不明）。**画面には出さずログに数える**
-            //（設計レビュー 🟡10: 帯が静かに消える経路がこれ）
-            if (miss)
-                miss.unresolved.add(sha);
-            continue;
-        }
-        // 4e. 🔴 **確認より後であることを git の日付（epoch）で確かめる。** `changed_by` は engine が
-        // 「基準点より後」で作るが、帳簿は前の夜のものが残りうる（全置換に失敗した回・人が後から
-        // 確認して基準点が動いた回）。ここを外すと**確認より前の変更で帯が立つ**。
-        // ⚠️ 「後か」の真の正本は engine が見た git のトポロジ順（`history.mjs:141-145`）で、
-        // ここは**安全網**。author 日付は rebase・cherry-pick で前後しうるので、
-        // ずれたときは「立てない」側に倒れる（設計レビュー 🟡12）
-        const ms = Date.parse(id.at);
-        if (!Number.isFinite(ms) || ms <= confirmedMs)
-            continue;
-        // 4c・4d. 機械の書き直しだけを残す（件名は分類と同じものを渡す）
-        const classified = (0, commit_classify_1.classifyGoldCommit)({
-            authorName: id.authorName,
-            authorEmail: id.authorEmail,
-            subject: id.subject,
-            body: id.body,
-        });
-        if (!(0, commit_classify_1.isMachineRewrite)(classified, id.subject)) {
-            if (classified.by === "human" && ms > newestHuman)
-                newestHuman = ms;
-            continue;
-        }
-        if (!newest || ms > newest.ms)
-            newest = { at: id.at, ms: ms };
     }
-    if (!newest)
-        return null;
-    // 🔴 **人が最後に言ったなら立てない。** engine は基準点を「最後に人が触ったコミット」に
-    // 置くので、正しい帳簿の `changed_by` に人のコミットは入らない（`history.mjs:141`）。
-    // だが前の夜の帳簿が残った朝には「機械の書き直し → その後の人の編集」が並びうる。
-    // そこで帯を立てると、**「戻す」がその人の新しい編集ごと基準コミットへ戻す**——この機能で
-    // いちばん重い壊れ方なので、既定（立てない側）に倒す。engine が次の夜に基準点を動かす
-    if (newestHuman > newest.ms)
+    // 6. 🔴 **今の版が、engine が「機械の書き直し」と呼んだ版そのものか。** 違えば、その後に
+    // 人か別の機械が直している——そこで帯を出すと「戻す」がその直しごと消す
+    if (now !== rw.contentSha)
         return null;
-    // 8. 🔴 **中身が変わったか。** ここまでは「機械がこの path を触ったか」しか見ていない。
-    // 触っただけ（フロントマターの使わない欄が移行で消えた・`identities` の欄が足された）で
-    // 印を立てると、説明文が 1 文字も変わっていない回に「変わりました」が出る（2026-09-20 の誤報）。
-    // 引けないとき（`unknown`）も立てない——誤報より無言
-    if (verdict(recordPath, conf.commit) !== "changed")
+    // 7. 人が確認した版から中身が変わっているか
+    if (conf.contentSha) {
+        // 7a. 機械が書き直したが、中身は人が確認した版と同じ（書き戻った・欄だけ触った）
+        if (now === conf.contentSha)
+            return null;
+    }
+    else if (verdict(recordPath, conf.commit) !== "changed") {
+        // 7b. 指紋が無い行は git の基準版と比べる（`same` も `unknown` も出さない）
         return null;
-    // 6. 根拠の件数は「この帯のコミットの記録」から出す（別の夜の数字を並べない）
+    }
+    // 8. 根拠の件数は「この書き直しのコミットの記録」から出す（別の夜の数字を並べない）
     const red = ledgers.rederivation.get(recordPath);
-    const evidence = red && red.evidence != null && red.commit && conf.changedBy.includes(red.commit)
-        ? red.evidence
-        : null;
-    // 7. 基準コミットが削除のコミットか（窓の外なら分からないので false 側＝リンクは出す。
-    // プロンプト側に「取れなかったときの逃げ道」を書いてある）
-    const base = identities.get(conf.commit);
-    const baseDeleted = base ? commit_classify_1.DELETE_SUBJECT_RE.test(base.subject) : false;
+    const evidence = red && red.evidence != null && red.commit && rw.commit && red.commit === rw.commit ? red.evidence : null;
     return {
         confirmedAt: conf.at,
         // 🔴 **券の無い確認では名前を器に入れない**（設計レビュー 🟡4）。画面が出さないだけだと、
-        // 名前は `site-data` の JSON として全案件のページに配られ続ける（`commit-classify.ts`
-        // の `Operated-By`「値そのものを持ち回さない」と同じ流儀）。しかも engine の `by` は
+        // 名前は `site-data` の JSON として全案件のページに配られ続ける。しかも engine の `by` は
         // `confirmer || authorName` の合成で、**券が無ければ「ただ触った人」でしかない**
         confirmedBy: conf.verified ? conf.by : "",
         confirmedVerified: conf.verified,
         baseCommit: conf.commit,
-        changedAt: newest.at,
+        changedAt: rw.at,
         ...(evidence != null ? { evidence: evidence } : {}),
-        ...(baseDeleted ? { baseDeleted: true } : {}),
     };
 }
 /**

package/dist/render.js

@@ -4237,12 +4237,14 @@ function buildTutorialData(site, repoSlug) {
             prompt: TUT_BACKLOG_PROMPT,
         });
     }
-    // 画面インベントリを読む体験（デザインを同期している案件のみ出す）
+    // デザインの指摘を読む体験（デザインを同期している案件のみ出す）。
+    // #727 K10 で取り込むのは Figma のコメント（デザイン/指摘/）だけになり、画面の本体は
+    // AI が Figma の MCP で開く。移行期は inventory が残る案件もあるので、文言はどちらでも嘘にしない
     const usesDesign = capOn("デザイン") ?? internals.some((s) => s.kind === "デザイン" && s.enabled !== false);
     if (usesDesign) {
         specs.push({
             title: "デザインを読んでみよう",
-            desc: "画面インベントリから1画面を選んで理解する",
+            desc: "Figmaの指摘から1画面を選んで理解する",
             prompt: TUT_DESIGN_PROMPT,
         });
     }
@@ -4310,10 +4312,11 @@ const TUT_BACKLOG_PROMPT = [
     "今回はコメントの追加だけです。課題の削除・クローズ・属性変更はしないでください。",
 ].join("\n");
 const TUT_DESIGN_PROMPT = [
-    "デザイン/inventory/ の画面インベントリから画面を1つ選び、それがどんな画面なのかを説明してください。1画面1ファイルで、frontmatter に安定ID（design:{fileKey}:{nodeId}）とFigmaへのディープリンクがあります。",
-    "どの画面が見たいかは、まずわたしに質問してください（希望が無ければ主要そうな画面をあなたが選んでかまいません）。",
-    "画面の役割・主な要素・前後の画面とのつながりを説明し、関連する決定・用語・課題があれば安定IDをたどって補足し、最後にFigmaで実物を開くリンクを提示してください。",
-    "読むだけの練習です。インベントリはFigmaからの同期で上書きされる生成物なので、手で編集しないでください。",
+    "デザイン/指摘/ に取り込んだ Figma のコメント（Figmaファイルごとのディレクトリに月ごとの md）から指摘を1つ選び、それがどの画面への指摘なのかを説明してください。各指摘には安定ID（figma-comment:{fileKey}:{commentId}）と、その画面をFigmaで開くリンクがあります。",
+    "画面そのものは取り込んでいません。Figma の MCP で開いて読んでください（プロジェクトによっては デザイン/inventory/ が残っているので、あれば手がかりに使ってかまいません）。Figma の MCP が使えないときは、そう伝えてリンクを示すところで止めてください。",
+    "どの指摘・画面が見たいかは、まずわたしに質問してください（希望が無ければ未解決の指摘をあなたが選んでかまいません）。",
+    "画面の役割・主な要素と、指摘が何を求めているかを説明し、関連する決定・用語・課題があれば安定IDをたどって補足し、最後にFigmaで実物を開くリンクを提示してください。",
+    "読むだけの練習です。デザイン/ の下はFigmaからの同期で上書きされる生成物なので手で編集せず、Figma にコメントも書き込まないでください。",
 ].join("\n");
 const TUT_SLACK_PROMPT = [
     "Cortex のチュートリアルを完了したことを、このプロジェクトの Slack チャンネルに投稿してください。最後のステップです。",
@@ -4983,6 +4986,13 @@ button.site-icon[aria-busy="true"] .site-icon-plus { opacity: 0; }
 .badge.followup-open { background: #eff6ff; color: #1e40af; border-color: #bfdbfe; }
 .badge.followup-superseded, .badge.followup-dropped { background: #f5f5f4; color: #57534e; border-color: #d6d3d1; }
 .followup-section { margin: 14px 0 4px; }
+/* 置き換え（#699 F3）。印は「その後」の置き換え済みと同じ色（同じ意味なので） */
+.badge.retired { background: #f5f5f4; color: #57534e; border: 1px solid #d6d3d1; }
+.supersede-section { margin: 14px 0 4px; }
+.supersede-list { list-style: none; margin: 0 0 8px; padding: 0; }
+.supersede-row { display: flex; flex-wrap: wrap; gap: 8px; align-items: baseline; font-size: 13.5px; line-height: 1.7; padding: 2px 0; }
+.supersede-id { font-size: 12.5px; color: var(--muted); word-break: break-all; }
+.supersede-unconfirmed { font-size: 12px; color: #92400e; background: #fffbeb; border: 1px solid #fde68a; border-radius: 4px; padding: 0 6px; }
 .followup-human { font-size: 13.5px; margin: 0 0 6px; color: #166534; }
 .followup-list, .followup-evidence { list-style: none; margin: 0 0 8px; padding: 0; }
 .followup-row, .followup-evidence-row { display: flex; flex-wrap: wrap; gap: 8px; align-items: baseline; font-size: 13.5px; line-height: 1.7; padding: 2px 0; }
@@ -6556,6 +6566,7 @@ ${calendarAddUrl.toString()}
   var FOLLOWUP_FILTER_LABEL = { "followup-done": "その後: 完了", "followup-open": "その後: 進行中", "followup-none": "その後: 記録なし" };
   function statusLabel(v) {
     if (Object.prototype.hasOwnProperty.call(FOLLOWUP_FILTER_LABEL, v)) return FOLLOWUP_FILTER_LABEL[v];
+    if (v === RETIRED_FILTER) return "置き換え済み";
     return v === "draft" ? "未確認のみ" : v === "proposed" ? "提案ありのみ" : v;
   }
   /**
@@ -6568,6 +6579,8 @@ ${calendarAddUrl.toString()}
     var opts = [];
     if (hasUnverified(items)) opts.push("draft");
     if ((items || []).some(hasProposals)) opts.push("proposed");
+    // 置き換え済み（#699 F3）。決定にしか付かない印なので、決定の一覧でだけ選択肢になる
+    if ((items || []).some(isRetired)) opts.push(RETIRED_FILTER);
     if (withFollowup) {
       ["followup-done", "followup-open", "followup-none"].forEach(function (v) {
         if ((items || []).some(function (r) { return matchesFollowupFilter(r, v); })) opts.push(v);
@@ -6585,6 +6598,8 @@ ${calendarAddUrl.toString()}
   function matchesStatusFilter(rec, withFollowup) {
     if (!listState.status) return true;
     if (listState.status === "proposed") return hasProposals(rec);
+    // 決定以外の一覧（タブを移っても絞り込みは残る）では絞らない——全件が消えないように
+    if (listState.status === RETIRED_FILTER) return rec && rec._kind === "decision" ? isRetired(rec) : true;
     if (Object.prototype.hasOwnProperty.call(FOLLOWUP_FILTER_LABEL, listState.status)) return withFollowup ? matchesFollowupFilter(rec, listState.status) : true;
     return rec.rstatus === listState.status;
   }
@@ -6879,6 +6894,66 @@ ${calendarAddUrl.toString()}
     return false;
   }
 
+  /* -------------------------------------------------------------------------
+   * 置き換え（#699 F3・オーナー決定 A-1'）
+   * -------------------------------------------------------------------------
+   * **逆引きはビルド側が組んである**（supersedes.ts＝engine supersedes-index.mjs の写し）。
+   * rec.supersededBy（置き換え先・新しい順）と rec.supersedesIds（置き換えた決定）は、無ければキーごと無い。
+   * 🔴 古い側の superseded_by（夜間の精製が書く写し）は画面でも読まない。
+   */
+  var RETIRED_FILTER = "retired";
+  /** もう有効でない（確認済みの置き換えが 1 本以上） */
+  function isRetired(rec) {
+    return !!(rec && rec.supersededBy && rec.supersededBy.retired);
+  }
+  /** 一覧・詳細の印。「その後」の印が同じ「置き換え済み」を出しているときは並べない */
+  function retiredBadge(rec) {
+    if (!isRetired(rec) || followupMarkOf(rec) === "superseded") return null;
+    return el("span", { class: "badge retired", text: "置き換え済み" });
+  }
+  /** 決定 1 件の行。SITE にあれば題名で詳細へのリンク、無ければ ID だけ */
+  function supersedeRow(id, date, unconfirmed) {
+    var rec = byId[id];
+    var li = el("li", { class: "supersede-row" });
+    if (rec && rec._kind === "decision") {
+      var a = el("a", { href: "?id=" + encodeURIComponent(id), text: rec.title });
+      a.addEventListener("click", function (ev) {
+        if (ev.defaultPrevented || ev.button !== 0 || ev.metaKey || ev.ctrlKey || ev.shiftKey || ev.altKey) return;
+        ev.preventDefault();
+        go(id);
+      });
+      li.appendChild(a);
+    }
+    li.appendChild(el("span", { class: "supersede-id mono", text: (date ? date + " · " : "") + id }));
+    if (unconfirmed) {
+      li.appendChild(el("span", { class: "supersede-unconfirmed", title: "置き換えた側の決定が、まだ人の確認を経ていません", text: "未確認" }));
+    }
+    return li;
+  }
+  /** 詳細の節「置き換え先の決定」「置き換えた決定」。どちらも無ければ null（要素を作らない） */
+  function supersedeSection(d) {
+    var by = (d && d.supersededBy && d.supersededBy.by) || [];
+    var reps = (d && d.supersedesIds) || [];
+    if (!by.length && !reps.length) return null;
+    var box = el("div", { class: "supersede-section" });
+    if (by.length) {
+      box.appendChild(el("div", { class: "section-label", text: "置き換え先の決定" }));
+      var ul = el("ul", { class: "supersede-list supersede-by" });
+      by.forEach(function (b) { ul.appendChild(supersedeRow(b.id, b.date, !b.confirmed)); });
+      box.appendChild(ul);
+    }
+    if (reps.length) {
+      box.appendChild(el("div", { class: "section-label", text: "置き換えた決定" }));
+      var ul2 = el("ul", { class: "supersede-list supersede-replaces" });
+      reps.forEach(function (id) {
+        var r = byId[id];
+        ul2.appendChild(supersedeRow(id, r && r._kind === "decision" ? r.date : "", false));
+      });
+      box.appendChild(ul2);
+    }
+    return box;
+  }
+
   // 未確認が1件も無い一覧では絞り込みを出さない
   function hasUnverified(items) {
     return (items || []).some(function (r) { return r.rstatus === "draft"; });
@@ -12216,7 +12291,7 @@ ${calendarAddUrl.toString()}
       "会議": { icon: "🎙", desc: "文字起こしから議事録を生成" },
       "共有資料": { icon: "📁", desc: "資料をMarkdown化して取り込み" },
       "チャット": { icon: "💬", desc: "チャンネルの会話をGoldの材料に" },
-      "デザイン": { icon: "🎨", desc: "画面インベントリの同期" },
+      "デザイン": { icon: "🎨", desc: "Figmaのコメント（指摘）の取り込み" },
       "開発": { icon: "🐙", desc: "IssuesをGoldの材料に" },
       "ハーネス連携": { icon: "🧰", desc: "スキルカタログを開く（Claude Code で使う／定期実行にする）" },
     };
@@ -14924,15 +14999,16 @@ ${calendarAddUrl.toString()}
               var lines = [
                 "「" + (f.name || f.key) + "」をデザイン同期の対象から外します。",
                 "",
-                "次回の同期から、このファイルの画面は画面インベントリに現れなくなります。",
+                "次回の同期から、このファイルのコメントは取り込まれなくなります。",
               ];
               // **最後の1件は結果が違う。** 同期は空の設定だと何もせずに終わるので、
-              // 取り込み済みの画面インベントリが消えずに残る（sync_designs.py は
+              // 取り込み済みの分（デザイン/指摘/、移行前の案件は デザイン/inventory/）が
+              // 消えずに残る（sync_designs.py は
               // 全再生成の手前で早期returnする）。ここで伝えないと放置される。
               if (figsLeft === 1) {
                 lines.push(
                   "",
-                  "これが最後の1件です。外すとデザイン同期は何もしなくなりますが、すでに取り込んだ画面インベントリはリポジトリに残ります（不要なら手で削除してください）。",
+                  "これが最後の1件です。外すとデザイン同期は何もしなくなりますが、すでに取り込んだ分（デザイン/ の下）はリポジトリに残ります（不要なら手で削除してください）。",
                 );
               }
               lines.push("", "外しますか？");
@@ -18033,6 +18109,7 @@ ${calendarAddUrl.toString()}
         draftBadge(d),
         proposalBadge(d),
         followupBadge(d),
+        retiredBadge(d),
         latestBadge(d),
         el("span", { class: "mono", text: d.date || "----" }),
         catBadge(d.category),
@@ -18196,7 +18273,7 @@ ${calendarAddUrl.toString()}
   /**
    * 2 つの日時が同じ瞬間か。**印の行を決めるのに使う。**
    *
-   * 🔴 突き合わせるのは rec.rederived.changedAt（機械の書き直しの author 日付）と
+   * 🔴 突き合わせるのは rec.rederived.changedAt（帳簿の rewritten.at＝機械の書き直しの日時・#799）と
    * 変更履歴の at。**器にはコミットの sha が 1 つも入っていない**（evidence は
    * 根拠の**件数**であって sha ではない）ので、sha では突き合わせられない。
    * 綴りが違っても同じ瞬間なら当てる（どちらも git の author 日付だが、器の出どころが別）
@@ -18251,7 +18328,7 @@ ${calendarAddUrl.toString()}
   // 🔴 **この時点では、どのプロジェクトにもこの欄はまだ無い。** 無ければ節ごと出さない
   //    （今までと同じに見えること）のが、この節のいちばん大事な性質。
   // 🔴 **画面の中では linkedIds / .linked-ids / .li-* と呼ぶ。** フロントマターの欄名の綴りは
-  //    GoldCommitIdentity（帯のコミットの筆者）と同じ語なので、画面の名前には持ち込まない。
+  //    GoldCommitIdentity（帯のコミットの筆者・#799 で撤去）と同じ語だったので、画面の名前には持ち込まない。
   //    欄名を綴るのは FM_LINKED_IDS 1 本だけ（書く側も同じ定数を引く。正本は src/external-id.ts）
   var FM_LINKED_IDS = ${JSON.stringify(external_id_1.FM_LINKED_IDS)};
   // 道具の読める名前。🔴 **語彙の外の種類は、その綴りをそのまま出す**
@@ -19614,6 +19691,7 @@ ${calendarAddUrl.toString()}
     var meta = el("div", { class: "detail-meta" }, [
       draftBadge(d),
       proposalBadge(d),
+      retiredBadge(d),
       latestBadge(d),
       el("span", { class: "mono", text: d.date || "----" }),
       catBadge(d.category),
@@ -19659,6 +19737,10 @@ ${calendarAddUrl.toString()}
       app.appendChild(ul);
     }
 
+    // 置き換え（#699 F3）。本文・参照の後、「その後の記録」の前。置き換えの無い決定では何も作らない
+    var sup = supersedeSection(d);
+    if (sup) app.appendChild(sup);
+
     appendRecordFooter(d);
   }
 
@@ -19671,9 +19753,11 @@ ${calendarAddUrl.toString()}
   }
 
   // ---------- エクスプローラー（Miller columns: Gold層から関係を辿るカラム表示） ----------
+  // superseded_by は**辺としては描かない**（ビルド側の MIRROR_RELS）。ここに置くのは
+  // レコード情報（frontmatter）のパネルが英語の語のまま出さないためだけ（凡例の REL_LABEL には足さない）
   var REL_LABEL = {
     based_on: "根拠", derived_from: "由来", relates_to: "関連",
-    supersedes: "置換", reference: "参照", source: "出典", link: "リンク",
+    supersedes: "置換", superseded_by: "置換先", reference: "参照", source: "出典", link: "リンク",
   };
   var explorerState = { folder: null, path: [], q: "", sx: 0, autoRight: false };
   // 索引もグラフ本体と同じ材料（削除済みを除いたもの）から作る。別々に間引くと、
@@ -20000,6 +20084,10 @@ ${calendarAddUrl.toString()}
           badge.style.borderColor = REL_COLOR[r.rel] || "#cbd5e1";
           row.appendChild(badge);
           row.appendChild(fmTargetLink(String(r.target)));
+          // 夜間処理が古い側に書く置換先の写しは、置き換えた側が未確認なら unconfirmed: true を持つ（#699 F3）
+          if (r.rel === "superseded_by" && r.unconfirmed === true) {
+            row.appendChild(el("span", { class: "supersede-unconfirmed", title: "置き換えた側の決定が、まだ人の確認を経ていません", text: "未確認" }));
+          }
           cell.appendChild(row);
         });
       } else if (k === FM_LINKED_IDS && Array.isArray(v)) {

package/dist/repo.js

@@ -7,7 +7,6 @@ exports.normalizeToHttps = normalizeToHttps;
 exports.classifyCommit = classifyCommit;
 exports.isFrontmatterKeyRename = isFrontmatterKeyRename;
 exports.collectAiChangeHistory = collectAiChangeHistory;
-exports.collectGoldCommitIdentities = collectGoldCommitIdentities;
 exports.readBlobsAt = readBlobsAt;
 exports.lastSubstantiveUpdate = lastSubstantiveUpdate;
 const node_child_process_1 = require("node:child_process");
@@ -761,81 +760,13 @@ const LAST_UPDATE_RENAME_OPT = "--find-renames=50%";
  * ここでは使わない——差分の取得にもう1回 git を呼ぶ割に、Home.md ではマイグレーションの
  * 件名規約で落ちる形しか観測されていない（適用しないと決めた・設計レビュー承認済み）。
  */
-/* ===========================================================================
- * レコードを触ったコミットの素性（帯「人が確認した版から変わりました」の材料・#665）
- * ===========================================================================
- * `.cortex/gold-confirmation.json` の `changed_by` は **sha だけ**を持つ。人が確認した
- * 版から「**機械が**書き直したか」を見分けるには、その sha の author・件名・本文
- *（`Operated-By:` trailer）が要る——帳簿には無いので git から取る。
- *
- * 🔴 **レコード数に依存しない 1 回の `git log`。** 「ビルド1回につき git は2回」の規律
- *（`collectAiChangeHistory`）に**3 回目**を足す形になるが、per-path で呼ばない点は保つ。
- * sha を並べて `git log --no-walk <sha…>` にしない——sha の数（実データで 54・多い案件では
- * 数百）でコマンドラインが伸び、ARG_MAX と「履歴に無い sha で log 全体が落ちる」に当たる。
- */
-/**
- * 素性を読むコミット数の上限。
- *
- * ビューアのビルドは **fetch-depth 2000** で checkout する（engine `build-viewer.yml`）ので、
- * それ以上遡っても届かない。窓の外・浅い clone の sha は**見分けられない＝「不明」**に倒れ、
- * 帯は立たない（既定は不明・#432 裁定 5-7）。差分や本文を読まない軽い pass なので、
- * 履歴の窓とそろえて広く取る。
- */
-const GOLD_IDENTITY_MAX_COMMITS = 2000;
-/** 本文（`%B`）の前に置く印。件名の区切り（US）とは別の文字にする（件名にも本文にも現れない） */
-const RSEP = "";
-/**
- * レコードを触ったコミットの素性を sha で引ける表にする（新しい順に上限まで）。
- *
- * git が無い・リポジトリでない・浅い clone で届かない sha は**表に載らない**
- *（呼び出し側は「載っていない sha は不明」として扱うこと）。
- */
-function collectGoldCommitIdentities(cwd) {
-    const out = gitLog(cwd, [
-        "log",
-        `-n${GOLD_IDENTITY_MAX_COMMITS}`,
-        "--no-color",
-        // 本文まで読むので、コミットの境目（NUL）と本文の始まり（RSEP）を別の印で固定する。
-        // 件名に US が混ざっても壊れないよう、下で 5 つ目以降を件名として繋ぎ直す
-        `--format=%x00%H%x1f%aI%x1f%an%x1f%ae%x1f%s%x1e%B`,
-        "--",
-        RECORD_PATHSPEC,
-    ], "レコードを触ったコミットの素性");
-    const map = new Map();
-    // 🔴 **行で切らない（NUL で切る）。** 本文は複数行なので、1 行 1 コミットの読み方は使えない
-    for (const chunk of out.split(NUL)) {
-        if (!chunk)
-            continue;
-        const at = chunk.indexOf(RSEP);
-        const head = at === -1 ? chunk : chunk.slice(0, at);
-        // 本文の末尾の改行は git が付けるもので、trailer の判定（行頭 ^）には影響しない
-        const body = at === -1 ? "" : chunk.slice(at + RSEP.length);
-        const parts = head.split(US);
-        const sha = parts[0] || "";
-        if (!sha)
-            continue;
-        // 同じ sha が 2 度出ることは無いが、出ても新しい側（先に出たもの）を残す
-        if (map.has(sha))
-            continue;
-        map.set(sha, {
-            sha: sha,
-            at: parts[1] || "",
-            authorName: parts[2] || "",
-            authorEmail: parts[3] || "",
-            subject: parts.slice(4).join(US),
-            body: body,
-        });
-    }
-    return map;
-}
 /**
  * 指定のコミットのファイルの中身を**まとめて 1 回**読む（`git cat-file --batch`）。
  *
  * 🔴 **レコードごとにプロセスを起こさない。** 帯（印）の判定は「人が確認した版と今の版で
  * 説明文・本文が変わったか」を見るので、確認の基準コミットのレコードを読む必要がある。
  * ここで `git show` をレコードごとに叩くと、用語が 1400 件ある案件でビルドが 1400 回
- * git を起こす——`collectGoldCommitIdentities` と同じく「git の呼び出しはレコード数に
- * 依存しない」の規律を保つため、key を stdin に流し込む `--batch` を 1 回だけ使う。
+ * git を起こす——「git の呼び出しはレコード数に依存しない」の規律を保つため、key を stdin に流し込む `--batch` を 1 回だけ使う。
  *
  * @param keys `<commit>:<path>` の列（重複は畳む）。**空なら git を起こさない**。
  *   🔴 **改行を含む key は git に渡す前に落とす**（`--batch` の問い合わせは 1 行 1 件なので、