@takagaki/cortex-decisions-viewer 0.12.84 → 0.12.86

package/README.md

@@ -40,7 +40,7 @@ cortex-decisions-viewer build [dir] [options]
 | --- | --- | --- |
 | `[dir]` | `Decisions` | Decisionsディレクトリ（リポジトリルートからの相対 or 絶対） |
 | `-o, --out <dir>` | `site` | 出力ディレクトリ |
-| `-t, --title <title>` | `Decisions` | サイトタイトル |
+| `-t, --title <title>` | `Decisions` | サイトタイトル（`Cortex/Home.md` の frontmatter `project` が読めればそちらを優先。これは読めないときの控え） |
 | `--repo-url <url>` | （git remoteから解決） | GitHubリポジトリURL。CIで git remote が引けない場合に明示指定 |
 | `--branch <branch>` | `main`（環境変数 `AWS_BRANCH` があればそれ） | 編集リンク・参照リンクが指すブランチ |
 | `--exclude <files...>` | （なし） | 一覧から除外する追加ファイル名。既定で `README.md` / `template.md` は除外 |

package/dist/build.js

@@ -36,12 +36,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROJECT_ICON_EXTS = void 0;
+exports.PROJECT_ICON_EXTS = exports.MIRROR_RELS = void 0;
 exports.sanitizeBody = sanitizeBody;
 exports.findProjectIcon = findProjectIcon;
 exports.readFleetSources = readFleetSources;
 exports.attachRederived = attachRederived;
 exports.attachDecisionFollowup = attachDecisionFollowup;
+exports.rawFrontmatterDate = rawFrontmatterDate;
+exports.attachSupersedes = attachSupersedes;
 exports.readGoldProposals = readGoldProposals;
 exports.buildHomeGrounding = buildHomeGrounding;
 exports.collectMeetings = collectMeetings;
@@ -96,6 +98,8 @@ function takeProposals(filePath) {
     return hit;
 }
 const external_id_1 = require("./external-id");
+const home_project_1 = require("./home-project");
+const supersedes_1 = require("./supersedes");
 const render_1 = require("./render");
 /**
  * この画面を作ったパッケージの版。**package.json を唯一の出どころにする。**
@@ -112,6 +116,11 @@ const PKG_VERSION = (() => {
     }
 })();
 const DEFAULT_EXCLUDE = ["README.md", "template.md"];
+/**
+ * グラフ・エクスプローラーに描かない関係（#699 F3）。`superseded_by` は engine の夜間の精製が古い側に書く
+ * `supersedes` の写しで、描くと同じ置き換えが逆向きにもう 1 本出る。frontmatter のパネルには今までどおり出る
+ */
+exports.MIRROR_RELS = new Set(["superseded_by"]);
 /** frontmatterのrelationsを安全に正規化する */
 function toRelations(value) {
     if (!Array.isArray(value))
@@ -794,6 +803,78 @@ function attachDecisionFollowup(decisions, recordsDir, repoRoot, ledger) {
     }
     return [...ledger.keys()].filter((k) => !matched.has(k.normalize("NFC")));
 }
+/**
+ * 決定に置き換えの逆引き（置き換え先・置き換えた決定）を載せる（cortex-engine #699 F3・A-1'）。
+ *
+ * 🔴 **逆引きは `supersedes.ts`（engine `scripts/gold/supersedes-index.mjs` の写し）だけで組む**。
+ * 材料は新しい側の `relations[supersedes]` だけで、古い側の `superseded_by`（夜間の精製が書く写し）は
+ * 読まない。確認済み＝新しい側の `status` が `active`。
+ *
+ * 置き換えが無い決定には**キーごと付けない**（今までと同じ SiteData）
+ */
+/**
+ * frontmatter に**書かれたままの** `date` の値（トップレベルの `date:` の行・引用符と行末のコメントを外す）。
+ * 無い・frontmatter が無ければ undefined。置き換えの逆引きの決定日だけに使う（engine と同じ日付にするため）
+ */
+function rawFrontmatterDate(raw) {
+    const m = String(raw ?? "").replace(/^\uFEFF/, "").match(/^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/);
+    if (!m)
+        return undefined;
+    const line = m[1].match(/^date:[ \t]*(.*)$/m);
+    if (!line)
+        return undefined;
+    let v = line[1].replace(/\r$/, "").trim();
+    const q = v.match(/^(["'])(.*)\1(?:\s+#.*)?$/);
+    if (q)
+        return q[2];
+    v = v.replace(/\s+#.*$/, "").trim();
+    return v;
+}
+function attachSupersedes(decisions, rawDateOf = (d) => d.fm.date) {
+    const input = decisions.map((d) => ({
+        id: d.id,
+        // 🔴 **frontmatter に書かれたままの date の文字列**（`rawFrontmatterDate`）。gray-matter は時刻・時差つきの
+        // date を Date に読み、sanitizeFm は UTC の日付にするので、`2026-07-01T01:00:00+09:00` が 6/30 にずれる。
+        // engine は日付を Date にしない読み方（CORE_SCHEMA）で書かれた文字列の先頭 8 桁を使う。
+        // 無ければ写しが ID の先頭 8 桁から取る
+        date: rawDateOf(d),
+        status: d.fm.status,
+        supersedes: d.relations.filter((r) => r.rel === "supersedes").map((r) => r.target),
+    }));
+    const index = (0, supersedes_1.supersedesIndex)(input);
+    const idOfKey = new Map();
+    for (const d of decisions) {
+        const k = (0, supersedes_1.decisionKeyOf)(d.id);
+        if (!idOfKey.has(k))
+            idOfKey.set(k, d.id);
+    }
+    for (const d of decisions) {
+        const key = (0, supersedes_1.decisionKeyOf)(d.id);
+        const entry = index.get(key);
+        if (entry && entry.by.length) {
+            d.supersededBy = {
+                by: entry.by.map((b) => ({ id: b.id, date: b.date, confirmed: b.confirmed })),
+                retired: entry.retired,
+            };
+        }
+        const replaced = [];
+        for (const r of d.relations) {
+            if (r.rel !== "supersedes")
+                continue;
+            const k = (0, supersedes_1.decisionKeyOf)(r.target);
+            // engine の規則と同じく、自分自身・実在しない決定は数えない
+            if (!k || k === key)
+                continue;
+            const id = idOfKey.get(k);
+            if (id === undefined)
+                continue;
+            if (!replaced.includes(id))
+                replaced.push(id);
+        }
+        if (replaced.length)
+            d.supersedesIds = replaced;
+    }
+}
 /**
  * AIからの更新提案（`.cortex/gold-proposals.json`）を読む。
  *
@@ -1508,7 +1589,8 @@ async function scanContent(repoRoot, goldDirName, repoBaseUrl, branch) {
                     }
                 }
                 for (const r of toRelations(data.relations))
-                    edges.push({ target: r.target, rel: r.rel });
+                    if (!exports.MIRROR_RELS.has(r.rel))
+                        edges.push({ target: r.target, rel: r.rel });
             }
             else {
                 const keyMatch = raw.slice(0, 4000).match(/^- 課題キー: (\S+)$/m);
@@ -1617,6 +1699,9 @@ function buildGraph(decisions, home, sections, content, targetUrls, repoBaseUrl,
     };
     const addRelationEdges = (fromId, relations) => {
         for (const r of relations) {
+            // 🔴 `superseded_by` は描かない（#699 F3）。新しい側の `supersedes` の写しで、描くと同じ置き換えが 2 本になる
+            if (exports.MIRROR_RELS.has(r.rel))
+                continue;
             edges.push({ from: fromId, to: classifyTarget(r.target), rel: r.rel });
         }
     };
@@ -2062,11 +2147,18 @@ async function build(opts) {
     // **読めない・使えないなら `null`** で、関係者の並びは今までと 1 バイトも同じ
     const engagement = await (0, engagement_1.readEngagementLedger)(repoRoot);
     const decisions = [];
+    const rawDates = new Map();
     for (const fileName of mdFiles) {
         const raw = await node_fs_1.promises.readFile(path.join(dirAbs, fileName), "utf8");
         const rec = await parseDecision(raw, fileName, repoRelDir, repo.baseUrl, repo.branch, refs);
         decisions.push(rec);
+        // 置き換えの逆引きの決定日（書かれたままの文字列・SiteData には載せない）
+        const rd = rawFrontmatterDate(raw);
+        if (rd !== undefined)
+            rawDates.set(rec, rd);
     }
+    // 置き換えの逆引き（#699 F3）。**置き換えの無い案件では 1 件も付かない**
+    attachSupersedes(decisions, (d) => rawDates.get(d) ?? d.fm.date);
     // 決定の「その後」（#705）。**帳簿を持たない案件では 1 件も付かず、絞り込みの印も立たない**
     // （`decisionFollowup` はキーごと無い＝今までと 1 バイトも同じ画面）
     const followupLedger = await (0, rederivation_1.readDecisionFollowup)(repoRoot);
@@ -2081,12 +2173,15 @@ async function build(opts) {
     let home = null;
     let homeGrounding;
     let homeUpdatedAt;
+    // Home.md の本文（ヘッダーの案件名を frontmatter の `project` から決めるため。無ければ null）
+    let homeRaw = null;
     const sections = [];
     // グラフに渡す区画（**並べ替える前**の配列を持つ。上の sections とレコードの実体は同じ）
     const graphSections = [];
     if (knowledgeRoot) {
         try {
             const raw = await node_fs_1.promises.readFile(path.join(knowledgeRoot, "Home.md"), "utf8");
+            homeRaw = raw;
             home = await parseGeneric(raw, "Home.md", toRepoRelative(knowledgeRoot), repo.baseUrl, repo.branch);
             // 自己記述の節を取り出し、**本文からは抜く**（最上部に出すので、残すと2度出る）。
             // 旧い使い方の説明もここで落ちる（説明はビューアが持つようになった）
@@ -2194,7 +2289,8 @@ async function build(opts) {
     // 案件アイコン（#348）。Cortex構成でなければ undefined（旧レイアウトには置き場が無い）
     const projectIcon = await findProjectIcon(knowledgeRoot);
     const site = {
-        title: opts.title,
+        // 🔴 **案件名の正本は Home.md の `project`**（engine #699 F10）。`--title` は読めないときの控え
+        title: (0, home_project_1.resolveSiteTitle)(homeRaw, opts.title),
         generatedAt: opts.generatedAt,
         // **package.json から読む。** 手で書くと、上げ忘れて嘘の版が出る
         viewerVersion: PKG_VERSION,

package/dist/cli.js

@@ -12,7 +12,7 @@ program
     .description("Decisionsディレクトリを静的サイトにビルドする")
     .argument("[dir]", "Decisionsディレクトリ（未指定なら Cortex/Decisions/records → Cortex/Decisions → Decisions の順で自動検出）")
     .option("-o, --out <dir>", "出力ディレクトリ", "site")
-    .option("-t, --title <title>", "サイトタイトル", "Decisions")
+    .option("-t, --title <title>", "サイトタイトル（Cortex/Home.md の project が読めればそちらを優先。これは読めないときの控え）", "Decisions")
     .option("--repo-url <url>", "GitHubリポジトリURL（未指定なら git remote から解決）")
     .option("--branch <branch>", "編集リンクが指すブランチ（既定: main / 環境変数 AWS_BRANCH）")
     .option("--exclude <files...>", "一覧から除外する追加ファイル名（既定で README.md / template.md は除外）", [])

package/dist/engagement.js

@@ -50,7 +50,7 @@ exports.ENGAGEMENT_LEDGER_VERSION = 1;
 /** 半減期（日）。engine `weights.mjs` の `HALF_LIFE_DAYS`（正本 6-B「半減期 90 日固定」） */
 exports.HALF_LIFE_DAYS = 90;
 /**
- * 行為 1 件の重み。engine `weights.mjs` の `WEIGHTS` の写し（22 値・**表に無い `kind` は 0**）。
+ * 行為 1 件の重み。engine `weights.mjs` の `WEIGHTS` の写し（24 値・**表に無い `kind` は 0**）。
  *
  * 🔴 契約の表（fixture）は `message.posted` しか使っていないので、**ここの写し間違いは表では
  * 捕まらない**。重みの番人は `test/member-engagement-parity.test.mjs` の `[重み]` が持つ。
@@ -80,6 +80,9 @@ exports.WEIGHTS = Object.freeze({
     "record.deleted": 0,
     // 本文を取り込んだ（engine #695）。人の行為ではないので 0（話した人は `utterance.spoken` で数える）
     "body.captured": 0,
+    // 人の宣言の指紋（cortex-engine #699 F1）。宣言の取り込みが書く行で、関与には数えない（0）。
+    // 場は宣言専用（`decl:<owner/repo>`）で帳簿にもともと入らないが、網羅のため写す
+    "decl.recorded": 0,
 });
 const DAY_MS = 86400000;
 const cmp = (a, b) => (a < b ? -1 : a > b ? 1 : 0);

package/dist/home-project.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * `Cortex/Home.md` の frontmatter `project`（案件の表示名）を読む（engine #699 F10）。
+ *
+ * ## なぜビューアが自分で読むのか
+ *
+ * 案件の表示名の**正本は Home.md の `project`**（`title` は頁の名前 "Home" で、表示名ではない）。
+ * これまでヘッダーの案件名は `--title`（engine の viewer-config.json の title、旧 Amplify は
+ * `viewerTitle ?? key`）の写しだけを見ていたので、Home.md で改名しても写しを直すまで
+ * ヘッダーが古い名前のままだった。build の時点で Home を読んでいるので、ここで正本を直接見る。
+ * 読めないとき（Home が無い・`project` が空・`{{プロジェクト名}}` のまま等）は `--title` に倒す。
+ *
+ * ## 読み方は infra の正本の写し
+ *
+ * 正本は `infra/scripts/lib/home-md.mjs` の `parseHomeProjectName`（名簿・Apps Script と同じ規則）。
+ * ビューアは npm で配る別パッケージなので import できず、写しを持つ。
+ * **規則を変えるときは両側を同じ便で直すこと。** 一致は `viewer/test/home-grounding.test.mjs` の
+ * parity の節が、infra の題材（`infra/test/fixtures/home-md-cases.mjs`・通る題材と弾く題材の両方）で検査する。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseHomeProjectName = parseHomeProjectName;
+exports.resolveSiteTitle = resolveSiteTitle;
+/** 区切り行か（`---`。行末の空白は許す） */
+const isDelimiter = (line) => /^---[ \t]*$/.test(line);
+/** `project:` の右側を値にする（正本の `parseScalar` と同じ規則） */
+function parseScalar(rest) {
+    const raw = rest.trim();
+    if (raw === "")
+        return { ok: false, reason: "EMPTY" };
+    const q = raw.charAt(0);
+    if (q === '"') {
+        let out = "";
+        for (let i = 1; i < raw.length; i += 1) {
+            const c = raw.charAt(i);
+            if (c === "\\") {
+                // `\"` と `\\` だけを剥がす（他のエスケープは原文のまま）
+                const n = raw.charAt(i + 1);
+                if (n === '"' || n === "\\") {
+                    out += n;
+                    i += 1;
+                    continue;
+                }
+                out += c;
+                continue;
+            }
+            if (c === '"')
+                return { ok: true, value: out };
+            out += c;
+        }
+        return { ok: false, reason: "BROKEN_VALUE" };
+    }
+    if (q === "'") {
+        let out = "";
+        for (let i = 1; i < raw.length; i += 1) {
+            const c = raw.charAt(i);
+            if (c === "'") {
+                if (raw.charAt(i + 1) === "'") {
+                    out += "'";
+                    i += 1;
+                    continue;
+                }
+                return { ok: true, value: out };
+            }
+            out += c;
+        }
+        return { ok: false, reason: "BROKEN_VALUE" };
+    }
+    // 裸の値: 空白の後ろの `#` から先はコメント。行頭の `#` は値が無いのと同じ
+    if (q === "#")
+        return { ok: false, reason: "EMPTY" };
+    const bare = (/^(.*?)(?:[ \t]+#.*)?$/.exec(raw) ?? [raw, raw])[1].trim();
+    // YAML の null は「無い」
+    if (bare === "null" || bare === "~")
+        return { ok: false, reason: "EMPTY" };
+    // 1 行の文字列以外（ブロックスカラー・flow・アンカー／エイリアス／タグ）は読まない
+    if (/^[|>][+-]?$/.test(bare) || /^[\[{&*!]/.test(bare))
+        return { ok: false, reason: "UNSUPPORTED" };
+    return { ok: true, value: bare };
+}
+/** Home.md の本文から `project` を読む（純関数。正本 `parseHomeProjectName` の写し） */
+function parseHomeProjectName(markdown) {
+    const text = String(markdown ?? "").replace(/^/, "").replace(/\r\n?/g, "\n");
+    const lines = text.split("\n");
+    if (lines.length === 0 || !isDelimiter(lines[0]))
+        return { ok: false, reason: "NO_FRONTMATTER" };
+    let end = -1;
+    for (let i = 1; i < lines.length; i += 1) {
+        if (isDelimiter(lines[i])) {
+            end = i;
+            break;
+        }
+    }
+    if (end < 0)
+        return { ok: false, reason: "UNCLOSED_FRONTMATTER" };
+    for (let i = 1; i < end; i += 1) {
+        const m = /^project:(.*)$/.exec(lines[i]);
+        if (!m)
+            continue;
+        const scalar = parseScalar(m[1]);
+        if (!scalar.ok)
+            return scalar;
+        const value = scalar.value.trim();
+        if (value === "")
+            return { ok: false, reason: "EMPTY" };
+        if (/\{\{[\s\S]*\}\}/.test(value))
+            return { ok: false, reason: "PLACEHOLDER" };
+        return { ok: true, project: value };
+    }
+    return { ok: false, reason: "MISSING" };
+}
+/**
+ * ヘッダーに出す案件名を決める。Home.md の `project` が読めればそれ、読めなければ `--title`。
+ * @param homeRaw Home.md の本文（無ければ null）
+ * @param fallback `--title` の値
+ */
+function resolveSiteTitle(homeRaw, fallback) {
+    if (homeRaw == null)
+        return fallback;
+    const parsed = parseHomeProjectName(homeRaw);
+    return parsed.ok ? parsed.project : fallback;
+}

package/dist/render.js

@@ -4983,6 +4983,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 +6563,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 +6576,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 +6595,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 +6891,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"; });
@@ -18033,6 +18105,7 @@ ${calendarAddUrl.toString()}
         draftBadge(d),
         proposalBadge(d),
         followupBadge(d),
+        retiredBadge(d),
         latestBadge(d),
         el("span", { class: "mono", text: d.date || "----" }),
         catBadge(d.category),
@@ -19614,6 +19687,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 +19733,10 @@ ${calendarAddUrl.toString()}
       app.appendChild(ul);
     }
 
+    // 置き換え（#699 F3）。本文・参照の後、「その後の記録」の前。置き換えの無い決定では何も作らない
+    var sup = supersedeSection(d);
+    if (sup) app.appendChild(sup);
+
     appendRecordFooter(d);
   }
 
@@ -19671,9 +19749,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 +20080,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/supersedes.js

@@ -0,0 +1,112 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIRMED_STATUS = void 0;
+exports.decisionKeyOf = decisionKeyOf;
+exports.decisionDateOf = decisionDateOf;
+exports.supersedesIndex = supersedesIndex;
+exports.supersedesOf = supersedesOf;
+exports.retiredIdsOf = retiredIdsOf;
+/**
+ * 決定の置き換え（`supersedes`）の逆引き（cortex-engine #699 F3・オーナー決定 A-1'・A-1''）。
+ *
+ * ## 🔴 これは写しで、正本は engine にある
+ *
+ * 正本: cortex-engine `scripts/gold/supersedes-index.mjs`（`supersedesIndex`・`decisionKeyOf`・
+ * `decisionDateOf`）。**題材で一致を確かめる**: 両リポに同じ `supersedes-index-contract.json`
+ * （tools は `test/fixtures/`）を置き、`test/supersedes-index-parity.test.mjs` が全ケースを流す。
+ * 規則を変えるときは engine の正本・この写し・題材を同じ日に直す（**tools 側で規則を足さない**）。
+ *
+ * ## 規則（A-1'）
+ *
+ * 1. 置き換えの正本は**新しい側の `relations[supersedes]` だけ**。古い側の `superseded_by`
+ *    （engine の夜間の精製が書く写し）は逆引きの材料にしない
+ * 2. **確認済み＝新しい側の `status` が `active`**。空・`draft`・語彙の外は「未確認」
+ * 3. **置き換えられた（もう有効でない・retired）＝確認済みの置き換えが 1 本以上**
+ * 4. 置き換え先は**全部・新しい順**（決定日の降順 → ID の降順・同じ ID は 1 回）
+ * 5. 自分自身を指す・実在しない ID は数えない。古い側の `status` は問わない
+ */
+const node_path_1 = __importDefault(require("node:path"));
+/** 確認済みとみなす新しい側の status（これだけ） */
+exports.CONFIRMED_STATUS = "active";
+/**
+ * 決定を指す文字列を突き合わせの鍵にする（`decision:` の頭・パス・`.md` を落とす）。
+ * engine は `path.basename`（Linux で走る＝posix）なので、ここも posix で固定する
+ */
+function decisionKeyOf(ref) {
+    return node_path_1.default.posix.basename(String(ref ?? "").trim().replace(/^decision:/, ""), ".md");
+}
+/** `YYYY-MM-DD`。frontmatter の `date`（`20260910` / `2026-09-10`）→ ID の先頭 8 桁 → 無ければ空 */
+function decisionDateOf(date, id) {
+    const raw = String(date ?? "").trim();
+    const ymd = raw.match(/^(\d{4})-?(\d{2})-?(\d{2})/) || decisionKeyOf(id).match(/^(\d{4})(\d{2})(\d{2})/);
+    return ymd ? `${ymd[1]}-${ymd[2]}-${ymd[3]}` : "";
+}
+function normalize(d) {
+    if (!d || typeof d !== "object")
+        return null;
+    const r = d;
+    const id = String(r.id ?? "").trim();
+    if (!id)
+        return null;
+    return {
+        id,
+        key: decisionKeyOf(id),
+        date: decisionDateOf(r.date, id),
+        status: typeof r.status === "string" ? r.status.trim() : "",
+        supersedes: (Array.isArray(r.supersedes) ? r.supersedes : []).map(decisionKeyOf).filter(Boolean),
+    };
+}
+/** 新しい順（決定日の降順 → ID の降順）。日付の無いものは最後 */
+function newestFirst(a, b) {
+    if (a.date !== b.date) {
+        if (!a.date)
+            return 1;
+        if (!b.date)
+            return -1;
+        return a.date < b.date ? 1 : -1;
+    }
+    return a.id < b.id ? 1 : a.id > b.id ? -1 : 0;
+}
+/**
+ * 置き換えの逆引き。
+ *
+ * @returns `Map<古い決定の鍵, SupersedesEntry>`。置き換えが 1 本も無い決定は入らない
+ */
+function supersedesIndex(decisions) {
+    const src = decisions instanceof Map ? decisions.values() : decisions || [];
+    const list = [...src].map(normalize).filter((d) => d !== null);
+    const byKey = new Map();
+    for (const d of list)
+        if (!byKey.has(d.key))
+            byKey.set(d.key, d);
+    const out = new Map();
+    for (const d of list) {
+        for (const target of new Set(d.supersedes)) {
+            const old = byKey.get(target);
+            if (!old || old.key === d.key)
+                continue; // 実在しない・自分自身
+            const entry = out.get(old.key) || { id: old.id, by: [], retired: false };
+            if (entry.by.some((x) => decisionKeyOf(x.id) === d.key))
+                continue;
+            const confirmed = d.status === exports.CONFIRMED_STATUS;
+            entry.by.push({ id: d.id, date: d.date, status: d.status, confirmed });
+            if (confirmed)
+                entry.retired = true;
+            out.set(old.key, entry);
+        }
+    }
+    for (const entry of out.values())
+        entry.by.sort(newestFirst);
+    return out;
+}
+/** その決定の逆引き（無ければ空の形） */
+function supersedesOf(index, id) {
+    return index.get(decisionKeyOf(id)) || { id: String(id ?? ""), by: [], retired: false };
+}
+/** 置き換えられた（確認済みの置き換えがある）決定の ID の集合 */
+function retiredIdsOf(index) {
+    return new Set([...index.values()].filter((e) => e.retired).map((e) => e.id));
+}

package/package.json

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