@takagaki/cortex-decisions-viewer 0.12.106 → 0.12.108

package/dist/build.js

@@ -60,6 +60,7 @@ const path = __importStar(require("node:path"));
 const gray_matter_1 = __importDefault(require("gray-matter"));
 const marked_1 = require("marked");
 const sanitize_html_1 = __importDefault(require("sanitize-html"));
+const canonical_evidence_1 = require("./canonical-evidence");
 const repo_1 = require("./repo");
 const engagement_1 = require("./engagement");
 const story_1 = require("./story");
@@ -1577,10 +1578,54 @@ function extractBodyLinks(content) {
     }
     return [...out];
 }
-/** Backlogの課題URL（…/view/KEY-123 や #comment付き）なら課題キーに正規化する */
-function backlogViewKey(url) {
-    const m = url.match(/\/view\/([A-Z][A-Z0-9_]*-\d+)(?:[#?]|$)/);
-    return m ? m[1] : null;
+/**
+ * 根拠の URL の種類（`canonicalEvidence` の `kind`）→ グラフの層（#968 tools 1）。
+ *
+ * 🔴 **全部 `external` に潰さない。** Backlog の課題キーは今までどおり `bronze`、Google
+ * ドキュメント／ドライブ・Figma・Slack・Google Chat は資料・デザイン・チャットの層として
+ * `silver` に寄せる——根拠が同期ミラーの ID から元ツールの URL に書き換わっていっても
+ * （engine #968 便 3）、課題・資料・会議の層の色が消えないようにするため。`bronze`/`silver`/
+ * `external` は今は同じ色・同じ凡例行（`GROUP_STYLE`）なので、見た目は変わらない
+ */
+const EVIDENCE_GROUP = {
+    backlog: "bronze",
+    gdoc: "silver",
+    drive: "silver",
+    "drive-folder": "silver",
+    figma: "silver",
+    slack: "silver",
+    gchat: "silver",
+};
+/** 元ツールが無い根拠（engine #968 設計v3・将来の語彙）。リンクにせず、機械の語（urn:…）を画面に出さない */
+const NO_ORIGINAL_TOOL_PREFIX = "urn:cortex:obs:";
+const NO_ORIGINAL_TOOL_LABEL = "元のツールが無い根拠";
+/**
+ * `canonicalEvidence` の `kind` → 画面に出す読める名前（題名が引けない種類の既定ラベル）。
+ *
+ * 🔴 **`key` は常に畳んだ後の鍵（`canon.parentKey ?? canon.key`）。** コメント・返信の
+ * `#comment-N` / `#issuecomment-N` は呼び出し側で既に外れているので、ここで二重に取り除かない
+ * ——GitHub の `#12`（Issue 番号そのもの）まで一緒に削ってしまう事故になる
+ */
+function readableEvidenceLabel(kind, key, fallback) {
+    switch (kind) {
+        case "backlog":
+            return key.toUpperCase();
+        case "github":
+            return key.replace(/^gh:/, "");
+        case "gdoc":
+            return "Google ドキュメント";
+        case "drive":
+        case "drive-folder":
+            return "Google ドライブの資料";
+        case "figma":
+            return "Figma のデザイン";
+        case "slack":
+            return "Slack のメッセージ";
+        case "gchat":
+            return "Google Chat のメッセージ";
+        default:
+            return fallback;
+    }
 }
 /**
  * 全レコードのfrontmatter（relations / source / references）と本文リンクから関係グラフを構築する（engine #551・分類A 10/1）。
@@ -1640,6 +1685,34 @@ function buildGraph(decisions, home, sections, targetUrls, repoBaseUrl) {
     // （leaderの実測で77件）を無くすのが今回の決定の本題なので、ここも揃えて飛び先を外す
     // （`graph-gold-only.test.mjs` の「議事録を根拠にした決定」で固定）。
     const dropMirrorBlob = (url) => url == null || (repoBaseUrl != null && url.startsWith(`${repoBaseUrl}/blob/`)) ? undefined : url;
+    // 課題・GitHub 等の鍵（`canonicalEvidence` の `key`、コメントは親の鍵）→ 先に作った点のID。
+    // 同じ課題を「課題キー」「URL」「コメントのURL」のどの形で指していても、1つの点に畳むために使う
+    // （#968 tools 1・設計v3「点を正規化の鍵で畳む」）
+    const evidenceKeyToNodeId = new Map();
+    /**
+     * 根拠の URL を、`canonicalEvidence` の鍵で重複を畳んで点にする（#968 tools 1）。
+     * 解けない（対応表でしか引けない・URLが2本以上混ざる等）URL は、今までどおり生のURLをIDにする。
+     */
+    const addEvidenceUrlNode = (rawUrl, fallbackLabel, preferFallbackLabel = false) => {
+        const canon = (0, canonical_evidence_1.canonicalEvidence)(rawUrl);
+        if (!canon)
+            return addNode({ id: rawUrl, label: fallbackLabel, group: "external", url: dropMirrorBlob(rawUrl) });
+        // コメント・返信は独立の点にせず、親（課題・Issue）の点に畳む
+        const foldKey = canon.parentKey ?? canon.key;
+        const existing = evidenceKeyToNodeId.get(foldKey);
+        if (existing && nodes.has(existing))
+            return existing;
+        const group = canon.kind === "url" ? "external" : EVIDENCE_GROUP[canon.kind] ?? "external";
+        // 対応表に無い種類（kind: "url"）は、元から有効だった生URLに近い綴りをIDにする
+        // （既存の点のURL・1番目に見つかった記録の飛び先を変えない）
+        const id = canon.kind === "url" ? canon.url : foldKey;
+        // fallbackLabel が markdown リンクの表示文字列等（既に読める名前）なら、それを使う
+        // （例: 資料の題名）。生URLしか無いときだけ、根拠の種類から読める名前を補う
+        const label = canon.kind === "url" || preferFallbackLabel ? fallbackLabel : readableEvidenceLabel(canon.kind, foldKey, fallbackLabel);
+        const nodeId = addNode({ id, label, group, url: dropMirrorBlob(canon.url) });
+        evidenceKeyToNodeId.set(foldKey, nodeId);
+        return nodeId;
+    };
     // 参照先IDから層を推定してノード化する
     const classifyTarget = (target) => {
         if (nodes.has(target))
@@ -1651,7 +1724,11 @@ function buildGraph(decisions, home, sections, targetUrls, repoBaseUrl) {
             return resolved;
         let group = "phantom";
         let label = target;
-        if (target.startsWith("minute:") ||
+        if (target.startsWith(NO_ORIGINAL_TOOL_PREFIX)) {
+            // 元ツールが無い根拠（engine #968 の将来の語彙）。リンクにせず、機械の語（urn:…）を出さない
+            return addNode({ id: target, label: NO_ORIGINAL_TOOL_LABEL, group: "phantom" });
+        }
+        else if (target.startsWith("minute:") ||
             target.startsWith("material:") ||
             target.startsWith("design:") ||
             target.startsWith("figma-comment:")) {
@@ -1662,15 +1739,20 @@ function buildGraph(decisions, home, sections, targetUrls, repoBaseUrl) {
                 return addNode({ id: target, label, group, url });
         }
         else if (/^[A-Z][A-Z0-9_]*-\d+$/.test(target)) {
-            group = "bronze"; // 課題キー → 同期mdから解決した実Backlog URLに飛べるようにする
+            // 課題キー → 同期mdから解決した実Backlog URLに飛べるようにする（#968 便1までは1バイトも変えない表示）。
+            // 同じ課題が先にURLの形で現れていれば、その点に畳む
+            group = "bronze";
+            const foldKey = target.toLowerCase();
+            const existing = evidenceKeyToNodeId.get(foldKey);
+            if (existing && nodes.has(existing))
+                return existing;
             const url = dropMirrorBlob(targetUrls.get(target));
-            if (url)
-                return addNode({ id: target, label, group, url });
+            const nodeId = addNode(url ? { id: target, label, group, url } : { id: target, label, group });
+            evidenceKeyToNodeId.set(foldKey, nodeId);
+            return nodeId;
         }
         else if (/^https?:\/\//.test(target)) {
-            group = "external";
-            label = target.replace(/^https?:\/\//, "").slice(0, 60);
-            return addNode({ id: target, label, group, url: dropMirrorBlob(target) });
+            return addEvidenceUrlNode(target, target.replace(/^https?:\/\//, "").slice(0, 60));
         }
         else if (target.includes("/") || target.toLowerCase().endsWith(".md")) {
             // リポジトリ内ファイルへの生のパス参照（同期ミラーの議事録・資料など）。
@@ -1696,13 +1778,11 @@ function buildGraph(decisions, home, sections, targetUrls, repoBaseUrl) {
     const addReferenceEdges = (fromId, references) => {
         for (const ref of references) {
             if (ref.url) {
-                const url = dropMirrorBlob(ref.url);
-                const id = addNode({
-                    id: ref.url,
-                    label: ref.label.slice(0, 60),
-                    group: url ? "external" : "silver",
-                    url,
-                });
+                // ref.label はマークダウンリンクの表示文字列（既に読める名前のことが多い。例: 資料の題名）。
+                // 生URLそのものがラベルのとき（本文の裸URL等）だけ、根拠の種類から読める名前を補う
+                const hasHumanLabel = ref.label !== ref.url;
+                const fallback = hasHumanLabel ? ref.label.slice(0, 60) : ref.label.replace(/^https?:\/\//, "").slice(0, 60);
+                const id = addEvidenceUrlNode(ref.url, fallback, hasHumanLabel);
                 edges.push({ from: fromId, to: id, rel: "reference" });
             }
             else {
@@ -1712,8 +1792,7 @@ function buildGraph(decisions, home, sections, targetUrls, repoBaseUrl) {
     };
     const addLinkEdges = (fromId, links) => {
         for (const link of links) {
-            const key = backlogViewKey(link);
-            edges.push({ from: fromId, to: classifyTarget(key ?? link), rel: "link" });
+            edges.push({ from: fromId, to: classifyTarget(link), rel: "link" });
         }
     };
     for (const d of decisions) {
@@ -2445,6 +2524,9 @@ function createRefResolver(opts) {
         const trimmed = String(ref ?? "").trim();
         if (!trimmed)
             return { label: trimmed, url: null };
+        // 元ツールが無い根拠（engine #968 の将来の語彙）。リンクにせず、機械の語（urn:…）を出さない
+        if (trimmed.startsWith(NO_ORIGINAL_TOOL_PREFIX))
+            return { label: NO_ORIGINAL_TOOL_LABEL, url: null };
         const mdLink = trimmed.match(/^\[([^\]]+)\]\(([^)]+)\)$/);
         if (mdLink) {
             // 🔴 http(s) 以外（`javascript:` `data:` 等）はリンクにしない。ラベルだけ残す。
@@ -2455,8 +2537,13 @@ function createRefResolver(opts) {
                 return { label: mdLink[1], url: null };
             return { label: mdLink[1], url: mdLink[2] };
         }
-        if (/^https?:\/\//.test(trimmed))
-            return { label: trimmed, url: trimmed };
+        if (/^https?:\/\//.test(trimmed)) {
+            // 裸のURL（markdownリンクでラベルを添えていないもの）は、分かる種類なら読める名前にする
+            // （#968 tools 1「URL → 読める名前」）。**url は変えない**（正規化で既存のリンクを壊さない）
+            const canon = (0, canonical_evidence_1.canonicalEvidence)(trimmed);
+            const label = canon && canon.kind !== "url" ? readableEvidenceLabel(canon.kind, canon.parentKey ?? canon.key, trimmed) : trimmed;
+            return { label, url: trimmed };
+        }
         // 正本のURL（課題キー・material:・design:・minute:）。**ここが「ツールへ飛ぶ」の本体**
         const known = targetUrls.get(trimmed);
         if (known)

package/dist/canonical-evidence.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * **根拠の名前の正規化**（cortex-engine #968 設計 v3 §1.4）。
+ *
+ * 正本は cortex-engine `scripts/gold/ref-tokens.mjs#canonicalEvidence`。ここはその TypeScript の写し
+ * （ビューアは engine のコードを import できないので、ロジックごと複製する）。
+ *
+ * 🔴 **写しを直したら、`test/fixtures/evidence-canonical-cases.json`（両リポに同じバイトで置く）で
+ * 両方の実装が同じ答えを返すことを確かめる。** 手で見比べて直すと、どちらかの枝だけ直って
+ * 静かに食い違う。
+ *
+ * 比べるのは `key`、画面がリンク先として使うのは `url`。課題と GitHub の `key` は engine の
+ * 既存の印（`refTokens`）と同じ綴り（小文字の課題キー・`gh:o/r#N`）——ビューアの他の場所
+ * （課題キーをそのまま ID にする `classifyTarget` の旧経路）と当たり方をそろえるため。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.githubRefToken = void 0;
+exports.syntaxNormalizedUrl = syntaxNormalizedUrl;
+exports.canonicalEvidence = canonicalEvidence;
+/** 課題キーだけの値（`PJ_CORTEX-12`）。engine の `ISSUE_KEY_RE` と同じ形の全体一致 */
+const WHOLE_ISSUE_KEY_RE = /^([A-Z][A-Z0-9_]{1,20})-(\d+)$/;
+/** `owner/repo#N` だけの値 */
+const WHOLE_GH_SHORT_RE = /^([A-Za-z0-9._-]+)\/([A-Za-z0-9._-]+)#(\d+)$/;
+/** スキーム・ホスト・残り（パス・クエリ・断片） */
+const URL_PARTS_RE = /^(https?):\/\/([^/?#\s]+)([^\s]*)$/i;
+/** GitHub の issue / PR を指す 2 つの綴りを同じ印にする（engine `githubRefToken` と同じ） */
+const githubRefToken = (owner, repo, num) => `gh:${String(owner).toLowerCase()}/${String(repo).toLowerCase()}#${num}`;
+exports.githubRefToken = githubRefToken;
+/**
+ * URL の構文の正規化（RFC 3986 §6.2.2）。スキームとホストを小文字・既定のポートを落とす・`%xx` を大文字・
+ * 末尾の句読点と末尾の `/` を落とす。日本語はエンコードしない。URL でなければ `null`。
+ */
+function syntaxNormalizedUrl(raw) {
+    let t = String(raw ?? "").trim();
+    for (let prev = ""; prev !== t;) {
+        prev = t;
+        t = t.replace(/[).,;:、。]+$/, "").replace(/\/+$/, "");
+    }
+    const m = t.match(URL_PARTS_RE);
+    if (!m)
+        return null;
+    const scheme = m[1].toLowerCase();
+    let host = m[2].toLowerCase();
+    if ((scheme === "http" && host.endsWith(":80")) || (scheme === "https" && host.endsWith(":443"))) {
+        host = host.replace(/:\d+$/, "");
+    }
+    const rest = m[3].replace(/%[0-9a-f]{2}/gi, (x) => x.toUpperCase()).replace(/\/+(?=$|[?#])/, "");
+    return `${scheme}://${host}${rest}`;
+}
+/**
+ * 値全体が URL 1 本の形のときだけ、その URL を返す（素の URL・`[ラベル](URL)`・Slack の `<URL|ラベル>`）。
+ * パスに URL を添えた値・文の中に URL がある値は `null`。Markdown のエスケープ（`PJ\_CORTEX`）は外す
+ */
+function wholeUrlOf(value) {
+    const v = value.trim();
+    const m = v.match(/^(https?:\/\/\S+)$/i) ||
+        v.match(/^\[[^\]\n]*\]\((https?:\/\/[^)\s]+)\)$/i) ||
+        v.match(/^<(https?:\/\/[^|>\s]+)(?:\|[^>]*)?>$/i);
+    return m ? m[1].replace(/\\_/g, "_") : null;
+}
+function toMap(v) {
+    if (v instanceof Map)
+        return v;
+    return new Map(Object.entries(v ?? {}));
+}
+const queryOf = (rest) => {
+    const q = rest.indexOf("?");
+    if (q < 0)
+        return new URLSearchParams();
+    const h = rest.indexOf("#", q);
+    return new URLSearchParams(rest.slice(q + 1, h < 0 ? undefined : h));
+};
+const pathOf = (rest) => rest.replace(/[?#].*$/, "");
+const fragmentOf = (rest) => {
+    const h = rest.indexOf("#");
+    return h < 0 ? "" : rest.slice(h + 1);
+};
+const GDOC_KINDS = new Set(["document", "spreadsheets", "presentation", "forms"]);
+const BACKLOG_HOST_RE = /\.(?:backlog\.jp|backlog\.com|backlogtool\.com)$/;
+/** 種類ごとの解き方（URL を構文正規化した後）。当たらなければ汎用の `url` 種に落ちる */
+function canonicalOfUrl(url, ctx) {
+    const m = url.match(URL_PARTS_RE);
+    const host = m[2];
+    const rest = m[3];
+    const p = pathOf(rest);
+    const q = queryOf(rest);
+    if (host === "docs.google.com") {
+        const g = p.match(/^\/([a-z]+)\/(?:u\/\d+\/)?d\/([A-Za-z0-9_-]{10,})/);
+        if (g && GDOC_KINDS.has(g[1])) {
+            return { kind: "gdoc", key: `gfile:${g[2]}`, url: `https://docs.google.com/${g[1]}/d/${g[2]}` };
+        }
+        const fd = p.match(/^\/file\/d\/([A-Za-z0-9_-]{10,})/);
+        if (fd)
+            return { kind: "drive", key: `gfile:${fd[1]}`, url: `https://drive.google.com/file/d/${fd[1]}/view` };
+    }
+    if (host === "drive.google.com") {
+        const f = p.match(/^\/file\/(?:u\/\d+\/)?d\/([A-Za-z0-9_-]{10,})/);
+        const id = f ? f[1] : /^\/(?:open|uc)$/.test(p) && /^[A-Za-z0-9_-]{10,}$/.test(q.get("id") || "") ? q.get("id") : "";
+        if (id)
+            return { kind: "drive", key: `gfile:${id}`, url: `https://drive.google.com/file/d/${id}/view` };
+        const d = p.match(/^\/drive\/(?:u\/\d+\/)?folders\/([A-Za-z0-9_-]{10,})/);
+        if (d)
+            return { kind: "drive-folder", key: `gfolder:${d[1]}`, url: `https://drive.google.com/drive/folders/${d[1]}` };
+    }
+    if (host.endsWith(".slack.com")) {
+        const s = p.match(/^\/archives\/([A-Z0-9]+)(?:\/p(\d+))?$/);
+        if (s) {
+            const hosts = toMap(ctx.slackHosts);
+            const h = String(hosts.get(s[1]) || "").trim().toLowerCase() || host;
+            const thread = s[2] && /^\d+\.\d+$/.test(q.get("thread_ts") || "") ? q.get("thread_ts") : "";
+            const key = `slack:${s[1]}${s[2] ? `:p${s[2]}` : ""}`;
+            const tail = `${s[2] ? `/p${s[2]}` : ""}${thread ? `?thread_ts=${thread}` : ""}`;
+            return { kind: "slack", key, url: `https://${h}/archives/${s[1]}${tail}` };
+        }
+    }
+    if (host === "chat.google.com" || host === "mail.google.com") {
+        const room = host === "chat.google.com" ? p.match(/^\/(?:u\/\d+\/)?room\/([A-Za-z0-9_-]+)/) : null;
+        const inMail = host === "mail.google.com" && /^\/chat(?:\/|$)/.test(p) ? fragmentOf(rest).match(/^chat\/space\/([A-Za-z0-9_-]+)/) : null;
+        const space = (room && room[1]) || (inMail && inMail[1]);
+        if (space)
+            return { kind: "gchat", key: `gchat:${space}`, url: `https://chat.google.com/room/${space}` };
+    }
+    if (BACKLOG_HOST_RE.test(host)) {
+        const v = p.match(/^\/view\/([A-Z][A-Z0-9_]{1,20}-\d+)$/);
+        if (v) {
+            const c = fragmentOf(rest).match(/^comment-(\d+)$/);
+            const issue = v[1].toLowerCase();
+            return {
+                kind: "backlog",
+                key: c ? `${issue}#comment-${c[1]}` : issue,
+                url: `https://${host}/view/${v[1]}${c ? `#comment-${c[1]}` : ""}`,
+                ...(c ? { parentKey: issue } : {}),
+            };
+        }
+        const w = p.match(/^\/alias\/wiki\/(\d+)$/);
+        if (w)
+            return { kind: "backlog", key: `backlog:${host}:wiki:${w[1]}`, url: `https://${host}/alias/wiki/${w[1]}` };
+        const d = p.match(/^\/document\/([^/]+)\/([0-9a-f]{32})$/i);
+        if (d)
+            return { kind: "backlog", key: `backlog:${host}:doc:${d[2].toLowerCase()}`, url: `https://${host}/document/${d[1]}/${d[2].toLowerCase()}` };
+    }
+    if (host === "figma.com" || host === "www.figma.com") {
+        const f = p.match(/^\/(design|file|proto|board)\/([A-Za-z0-9]{10,})(?:\/branch\/([A-Za-z0-9]{10,}))?(?:\/|$)/);
+        if (f) {
+            const fileKey = f[3] || f[2];
+            const node = String(q.get("node-id") || "").trim().replace(/%3A/gi, ":");
+            if (node && !/^\d+[-:]\d+$/.test(node))
+                return { kind: "url", key: `url:${url}`, url };
+            const n = node ? node.replace(":", "-") : "";
+            const seg = f[1] === "board" ? "board" : "design";
+            return { kind: "figma", key: `figma:${fileKey}${n ? `:${n.replace("-", ":")}` : ""}`, url: `https://www.figma.com/${seg}/${fileKey}${n ? `?node-id=${n}` : ""}` };
+        }
+    }
+    if (host === "github.com" || host === "www.github.com") {
+        const g = p.match(/^\/([^/]+)\/([^/]+)\/(?:issues|pull|discussions)\/(\d+)$/);
+        if (g) {
+            const [o, r] = [g[1].toLowerCase(), g[2].toLowerCase()];
+            const issue = (0, exports.githubRefToken)(o, r, g[3]);
+            const c = fragmentOf(rest).match(/^(issuecomment-\d+|discussioncomment-\d+|discussion_r\d+|pullrequestreview-\d+)$/);
+            return {
+                kind: "github",
+                key: c ? `${issue}#${c[1]}` : issue,
+                url: `https://github.com/${o}/${r}/issues/${g[3]}${c ? `#${c[1]}` : ""}`,
+                ...(c ? { parentKey: issue } : {}),
+            };
+        }
+    }
+    return { kind: "url", key: `url:${url}`, url };
+}
+/**
+ * 根拠の名前の正規化。解けない入力（Gold の ID・`minute:`・`material:`・`design:`・リポのパス・
+ * ホストの決まらない課題キー・URL が 2 本以上の値）は `null`。engine 版と 1:1 対応。
+ */
+function canonicalEvidence(value, ctx = {}) {
+    const raw = String(value ?? "").trim();
+    if (!raw)
+        return null;
+    const key = raw.match(WHOLE_ISSUE_KEY_RE);
+    if (key) {
+        const domains = toMap(ctx.backlogDomains);
+        const host = String(domains.get(key[1]) || "")
+            .trim()
+            .toLowerCase()
+            .replace(/^https?:\/\//, "")
+            .replace(/\/+$/, "");
+        return host ? canonicalOfUrl(`https://${host}/view/${raw}`, ctx) : null;
+    }
+    const gh = raw.match(WHOLE_GH_SHORT_RE);
+    if (gh)
+        return canonicalOfUrl(`https://github.com/${gh[1]}/${gh[2]}/issues/${gh[3]}`, ctx);
+    const url = wholeUrlOf(raw);
+    if (!url)
+        return null;
+    const normalized = syntaxNormalizedUrl(url);
+    return normalized ? canonicalOfUrl(normalized, ctx) : null;
+}

package/dist/render.js

@@ -50,6 +50,12 @@ exports.ingestFacts = ingestFacts;
 exports.ingestSucceeded = ingestSucceeded;
 exports.ingestedAtOf = ingestedAtOf;
 exports.ingestedRowOf = ingestedRowOf;
+exports.reflectedStateOf = reflectedStateOf;
+exports.jstNightLabel = jstNightLabel;
+exports.jstCalendarDay = jstCalendarDay;
+exports.nextMemoryReflectGoldAtMs = nextMemoryReflectGoldAtMs;
+exports.memoryReflectDoneAtMs = memoryReflectDoneAtMs;
+exports.memoryReflectTextOf = memoryReflectTextOf;
 exports.runLogUrlOf = runLogUrlOf;
 exports.lastSyncRunUrlOf = lastSyncRunUrlOf;
 exports.runSourceWordOf = runSourceWordOf;
@@ -2591,6 +2597,115 @@ function ingestedRowOf(rows, capId, refs) {
     }
     return bestRow;
 }
+/**
+ * `reflected` の行（能力ごとに 1 本・cortex-engine #968 条件 4・E3）を探す。ref は接続先の ID では
+ * なく決まった語 `memory`（サーバの定数は `STATE_MEMORY_REF`。埋め込み関数は共有定数を参照できず
+ * 綴りを写して持つ——`exemptFromRegistrySieve` と同じ判断。ずれは state-vocab-parity.test.mjs）。
+ * 無ければ null（栓 `memory_reflect_row` が off の今の姿。T2 の行は何も出さない）。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function reflectedStateOf(rows, capId) {
+    if (!Array.isArray(rows) || !capId)
+        return null;
+    for (const r of rows) {
+        if (r && r.cap === capId && r.question === "reflected" && r.ref === "memory")
+            return r;
+    }
+    return null;
+}
+/**
+ * ISO 時刻を「Gold の夜の日」の表示（`M/D`）にする（cortex-engine #968 設計 v1 §3）。
+ *
+ * **engine の `nightDayOf`（−12 時間）と同じ切り方。** Gold は JST 22:00 に始まり日をまたいで
+ * 終わるので、素の日付だと同じ晩の記録が「9/28」と「9/29」に分かれる。12 時間引いてから
+ * JST の日付を読むと、22:00 に始まった晩はいつも開始した日の日付になる。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ * @returns `M/D`（ゼロ埋めなし）。読めない値は null
+ */
+function jstNightLabel(iso) {
+    const ms = typeof iso === "string" && iso ? Date.parse(iso) : NaN;
+    if (!Number.isFinite(ms))
+        return null;
+    const JST_MS = 9 * 60 * 60 * 1000;
+    const d = new Date(ms - 12 * 60 * 60 * 1000 + JST_MS);
+    return (d.getUTCMonth() + 1) + "/" + d.getUTCDate();
+}
+/** JST の暦日（`YYYY-MM-DD`）。`jstNightLabel` と違い −12 時間をしない（素の日付の比較用） */
+function jstCalendarDay(ms) {
+    const JST_MS = 9 * 60 * 60 * 1000;
+    const d = new Date(ms + JST_MS);
+    const p = (n) => (n < 10 ? "0" + n : String(n));
+    return d.getUTCFullYear() + "-" + p(d.getUTCMonth() + 1) + "-" + p(d.getUTCDate());
+}
+/**
+ * ある時刻（`ms`）の後、最初に来る JST 22:00（update-gold の cron・T2）。
+ *
+ * 🔴 **「22」はここ 1 か所だけに書く**（.github/workflows の `update-gold.yml` の cron
+ * `0 13 * * *`（UTC）＝ JST 22:00 と番人（memory-reflect-line.test.mjs）が突き合わせる）。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function nextMemoryReflectGoldAtMs(ms) {
+    const GOLD_HOUR_JST = 22;
+    const JST_MS = 9 * 60 * 60 * 1000;
+    const jst = new Date(ms + JST_MS);
+    const goldUtcMs = Date.UTC(jst.getUTCFullYear(), jst.getUTCMonth(), jst.getUTCDate(), GOLD_HOUR_JST, 0, 0, 0) - JST_MS;
+    return goldUtcMs > ms ? goldUtcMs : goldUtcMs + 24 * 60 * 60 * 1000;
+}
+/**
+ * Gold の夜間 job が走り切っている（はずの）締切（T2）。
+ *
+ * 🔴 **「105」（Gold の最長実行時間・分）もここ 1 か所だけ。** 余白 30 分を足す
+ * （番人が update-gold の実測の最長と突き合わせる）。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function memoryReflectDoneAtMs(goldAtMs) {
+    const GOLD_MAX_MINUTES = 105;
+    const MARGIN_MINUTES = 30;
+    return goldAtMs + (GOLD_MAX_MINUTES + MARGIN_MINUTES) * 60000;
+}
+/**
+ * 「記憶に反映」の文言（接続先 1 件・cortex-engine #968 条件 4・T2）。発注書の下書き
+ * （#968 -5925683579）の表のとおり。**R（`reflected` の行）が無ければ null**（栓 off の今の姿。
+ * 行は何も出さない）。
+ *
+ * @param reflected `reflectedStateOf` の答え（R）
+ * @param ingestedRow その能力の `ingested` の行（N＝`lastNewAt` を読む。なければ比べない）
+ * @param nowMs 時計。**呼び手が渡す**（ここで `Date.now()` を読まない。日付爆弾を避ける）
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function memoryReflectTextOf(reflected, ingestedRow, nowMs) {
+    if (!reflected)
+        return null;
+    const lastOkAt = typeof reflected.lastOkAt === "string" ? reflected.lastOkAt : "";
+    const night = jstNightLabel(lastOkAt);
+    // R の読み口（`detail`）が bronze 以外（写し・API から作った）なら、N とは比べない
+    // （写しと S3 の時刻を比べると嘘になるため）
+    if (reflected.detail && reflected.detail !== "bronze") {
+        return night ? "記憶の更新: " + night + " の夜" : null;
+    }
+    // 一度も反映していない（成功した lastOkAt がまだ無い）。言い切れる材料が無いので何も出さない
+    if (!night)
+        return null;
+    const rMs = Date.parse(lastOkAt);
+    // 門で外した接続先（`ingested: skipped`・書き手 gold）の `lastNewAt` は比べない（申し送り）
+    const n = ingestedRow && ingestedRow.status !== "skipped" && typeof ingestedRow.lastNewAt === "string" ? ingestedRow.lastNewAt : "";
+    const nMs = n ? Date.parse(n) : NaN;
+    if (!n || !Number.isFinite(nMs) || nMs <= rMs)
+        return "記憶に反映: " + night + " の夜まで";
+    const goldAt = nextMemoryReflectGoldAtMs(nMs);
+    if (nowMs < goldAt) {
+        const tonight = jstCalendarDay(goldAt) === jstCalendarDay(nowMs);
+        return "取り込み済み・" + (tonight ? "今夜" : "明日の夜") + " 22:00 に記憶へ反映";
+    }
+    if (nowMs < memoryReflectDoneAtMs(goldAt))
+        return "取り込み済み・いま記憶へ反映しています";
+    return "取り込み済みの原文がまだ記憶に入っていません → 次の定時に自動でやり直します";
+}
 /**
  * 行の横に出す「実行ログ」のリンク先（#560）。**無ければ空文字。**
  *
@@ -4798,14 +4913,21 @@ button.site-icon[aria-busy="true"] .site-icon-plus { opacity: 0; }
 }
 .card:hover { border-color: var(--accent); }
 .card-meta { display: flex; flex-wrap: wrap; gap: 8px; align-items: center; font-size: 12.5px; color: var(--muted); margin-bottom: 6px; }
-.card-title { font-size: 16px; font-weight: 650; margin: 2px 0 6px; color: var(--text); }
+/* card-title はカードの見出し（#1 新しいタブでも開けるよう <a> にした）。見た目は元の <div> と揃える */
+.card-title { display: block; font-size: 16px; font-weight: 650; margin: 2px 0 6px; color: var(--text); }
 .card-summary { color: #3b424c; font-size: 14px; margin: 0; }
 .empty { color: var(--muted); text-align: center; padding: 48px 0; }
 .pager { display: flex; align-items: center; justify-content: center; gap: 14px; padding: 20px 0 4px; }
-.pager-btn { padding: 6px 14px; border-radius: 8px; border: 1px solid var(--border); background: var(--surface); color: inherit; cursor: pointer; font: inherit; }
+.pager-btn { display: inline-block; padding: 6px 14px; border-radius: 8px; border: 1px solid var(--border); background: var(--surface); color: inherit; cursor: pointer; font: inherit; }
 .pager-btn:hover:not(:disabled) { border-color: var(--muted); }
 .pager-btn:disabled { opacity: .4; cursor: default; }
+/* ボタンの見た目の <a> に下線は要らない（.trace-btn 等、押しボタン型のリンクと同じ扱い） */
+a.pager-btn:hover { text-decoration: none; }
+/* 前へ／次へ（#2）の端は <a> ではなく <span>（キーボードでも踏めないように）。このクラスで見た目をそろえる */
+.pager-btn.is-disabled { opacity: .4; cursor: default; pointer-events: none; }
 .pager-ind { color: var(--muted); font-size: 13px; min-width: 72px; text-align: center; }
+/* 詳細の「前へ／次へ」は本文の上（戻るリンクのすぐ下）に置くので、一覧の下の余白は要らない */
+.detail-pager { justify-content: flex-start; padding: 0 0 16px; }
 
 /* ---- badges / chips ---- */
 .badge {
@@ -5601,6 +5723,10 @@ a.ds-tile:hover { text-decoration: none; }
    どちらが重いのか読めない） */
 .ds-ingest { font-size: 11px; color: var(--muted); flex: 0 0 auto; font-variant-numeric: tabular-nums; }
 .ds-ingest-failed { color: #b45309; font-weight: 600; }
+/* 「記憶に反映」（cortex-engine #968 条件4・T2）。「取り込み」（.ds-ingest）の下に1行。
+   **必ず自分の行を占める**（flex: 1 1 100%）——.ds-gate-help と同じ理由（チップの横に
+   押し込むと省略される）。強さは .ds-ingest と同じ弱さ（添え物として読ませる） */
+.ds-reflect { flex: 1 1 100%; margin: 2px 0 0; font-size: 11px; color: var(--muted); font-variant-numeric: tabular-nums; }
 .ds-gate::before { content: ""; width: 8px; height: 8px; border-radius: 999px; background: currentColor; }
 .ds-gate-ok { color: #1f7a45; }
 .ds-gate-warn { color: #b45309; }
@@ -6290,6 +6416,14 @@ ${ingestFacts.toString()}
 ${ingestSucceeded.toString()}
 ${ingestedAtOf.toString()}
 ${ingestedRowOf.toString()}
+  // 「記憶に反映」（#968 条件 4・T2）。🔴 **ingestedEl より前に置く。** 落とすと行の描画が
+  // 未定義を参照して画面のスクリプトが丸ごと死ぬ
+${reflectedStateOf.toString()}
+${jstNightLabel.toString()}
+${jstCalendarDay.toString()}
+${nextMemoryReflectGoldAtMs.toString()}
+${memoryReflectDoneAtMs.toString()}
+${memoryReflectTextOf.toString()}
 ${runLogUrlOf.toString()}
 ${lastSyncRunUrlOf.toString()}
 ${runSourceWordOf.toString()}
@@ -8450,11 +8584,37 @@ ${calendarAddUrl.toString()}
     });
     return a;
   }
+  // 一覧 ⇄ 詳細のスクロール位置（#1 一覧→詳細→戻るで毎回スクロールが消える問題）。
+  //
+  // ⚠ ブラウザ既定の自動復元（scrollRestoration: "auto"）に任せない。** この画面は
+  // 一覧も詳細も同じ #app を毎回 innerHTML="" で作り直す静的サイトなので、戻ったときの
+  // 高さが自動復元の計算と噛み合わず当てにできない。代わりに「一覧を離れた瞬間のY」を
+  // 自分で1つだけ覚え、一覧へ戻るときに明示的に scrollTo する（分類B 2026-10-01）。
+  //
+  // ⚠ 詳細→詳細（後述の前へ／次へ）では更新しない。** 更新すると、何件か読み進めてから
+  // 一覧へ戻ったときに「最後に見ていた詳細でのスクロール位置」に飛んでしまう。
+  // 一覧に戻る行き先は常に「一覧を離れたときの位置」でなければならない
+  var savedListScrollY = 0;
+  // どのタブの一覧で覚えた位置か（実装レビュー②）。** route() は詳細を描くとき、その記録の
+  // 種類で listState.tab を書き換える（例: 用語集の一覧からウィキリンクで決定の詳細へ移ると
+  // listState.tab は "decisions" になる）。そこで「一覧へ戻る」を押すと、戻る先はその
+  // 書き換わった後のタブになるので、離れたときのタブと戻る先のタブが違うことがある。
+  // 違うタブに離れたときのYを当てはめない（合わなければ先頭へ）
+  var savedListTab = null;
+  // 直前に描いたのが詳細（not foundも含む）か一覧か。popstate（ブラウザの戻る／進む）は
+  // go() を通らないので、この印で「詳細→一覧」の遷移だけを見分けて復元する
+  var lastWasDetail = false;
+  if ("scrollRestoration" in history) history.scrollRestoration = "manual";
+
   function go(id) {
+    // 一覧から詳細へ移るときだけ、今の一覧のスクロール位置とタブを覚える
+    if (id && !lastWasDetail) { savedListScrollY = window.scrollY; savedListTab = listState.tab; }
     var url = id ? "?id=" + encodeURIComponent(id) : tabUrl(listState.tab);
     history.pushState({}, "", url);
     route();
-    window.scrollTo(0, 0);
+    // 詳細は常に先頭から。一覧は、離れたときと同じタブに戻るときだけ元の位置へ
+    if (id) window.scrollTo(0, 0);
+    else window.scrollTo(0, listState.tab === savedListTab ? savedListScrollY : 0);
   }
 
   var listState = { tab: DEFAULT_TAB, q: "", category: "", month: "", status: "", page: 1 };
@@ -8482,6 +8642,38 @@ ${calendarAddUrl.toString()}
     return el("div", { class: "pager" }, [prev, ind, next]);
   }
 
+  /** 新しいタブ・新しいウィンドウ等を求めるクリックではない（左クリック・修飾キー無し）か */
+  function isPlainClick(ev) {
+    return !ev.defaultPrevented && ev.button === 0 && !ev.metaKey && !ev.ctrlKey && !ev.shiftKey && !ev.altKey;
+  }
+
+  /**
+   * 一覧カードの見出し（#1）。普通の a href="?id=..." にして、中クリック・
+   * Ctrl/Cmd クリックで新しいタブでも開けるようにする（opsTabLink と同じ型）。
+   * 素のクリックは今までどおり SPA 内遷移（go）のまま——1 件ずつ確かめるときに
+   * ページ全体の再読み込みを挟まない。
+   */
+  function cardTitleLink(rec, extraClass) {
+    var a = el("a", {
+      class: "card-title" + (extraClass || ""),
+      href: "?id=" + encodeURIComponent(rec.id),
+      text: humanTitle(rec.title),
+    });
+    a.addEventListener("click", function (ev) {
+      if (ev.defaultPrevented) return;
+      if (!isPlainClick(ev)) {
+        // 新しいタブ・新しいウィンドウ等はブラウザの既定の動作に任せる。
+        // ここで止めないと、外側のカードの click にも伝わって SPA 内遷移も重ねて走ってしまう
+        ev.stopPropagation();
+        return;
+      }
+      ev.preventDefault();
+      ev.stopPropagation();
+      go(rec.id);
+    });
+    return a;
+  }
+
   function monthLabel(m) {
     var p = m.split("-");
     return p[0] + "年" + parseInt(p[1], 10) + "月";
@@ -8550,6 +8742,7 @@ ${calendarAddUrl.toString()}
 
   // ---------- 一覧 ----------
   function renderList() {
+    lastWasDetail = false;
     app.innerHTML = "";
     renderTabs();
     renderInfoBar();
@@ -14636,6 +14829,22 @@ ${calendarAddUrl.toString()}
     return frag([span].concat(runTrailNodes(r)));
   }
 
+  /**
+   * 「記憶に反映」の行（cortex-engine #968 条件 4・T2）。**「取り込み」の行の下に 1 行**。
+   * 材料は「reflectedStateOf」（R）と、同じ能力の「ingested」の行（N＝「lastNewAt」）。
+   * **R が無ければ何も出さない**（栓「memory_reflect_row」が off の今の姿。「ingestedEl」 と同じ原則）。
+   *
+   * @param r その能力の「ingested」の行（「ingestedEl」に渡したのと同じ行。無くても R だけで判定する）
+   * @param capId 接続状態ストアの能力名（issues / design 等。「ingestedEl」 の「cap」は画面の
+   *   ラベルなので使えない——「keyMissingText」用の別物）
+   */
+  function memoryReflectEl(r, capId) {
+    var reflected = reflectedStateOf(LIVE_STATE, capId);
+    var text = memoryReflectTextOf(reflected, r, Date.now());
+    if (!text) return null;
+    return el("p", { class: "ds-reflect", text: text });
+  }
+
   /**
    * その接続先の「届くか」の行（接続状態ストア・#523 S1）。**無ければ null。**
    *
@@ -15133,6 +15342,8 @@ ${calendarAddUrl.toString()}
         pendingBadgeEl(t),
         // この接続先の取り込みが最後にどうなったか（段C）。測っていなければ null
         ingestedEl(ingestedStateOf(t.domain, t.projectKey), "課題管理"),
+        // 「記憶に反映」（cortex-engine #968 条件4・T2）。R が無ければ null（栓offの今の姿）
+        memoryReflectEl(ingestedStateOf(t.domain, t.projectKey), "issues"),
       ]);
       // この接続先に届くか（#523 S1）。**「取り込み」とは別の問い**なので併記する
       // ——鍵はあるが 403 でプロジェクトが見えない、は取り込みの失敗より前の話。
@@ -15772,6 +15983,8 @@ ${calendarAddUrl.toString()}
             pendingBadgeEl(f),
             // このファイルの取り込みが最後にどうなったか（段C）。測っていなければ null
             ingestedEl(designIngestedStateOf(f.key), "デザイン"),
+            // 「記憶に反映」（cortex-engine #968 条件4・T2）。R が無ければ null（栓offの今の姿）
+            memoryReflectEl(designIngestedStateOf(f.key), "design"),
           ]);
           // このファイルに届くか（#523 S1）。書き手は engine の同期（#523 S4・engine #329）。
           // 行が無いファイル（まだ一度も同期していない）には何も出ない。
@@ -19030,11 +19243,16 @@ ${calendarAddUrl.toString()}
     return sel;
   }
 
-  function drawCards() {
+  /**
+   * 今の絞り込み（検索語・期間・カテゴリー・状態）を当てた決定の一覧（並びは
+   * SITE.decisions の順＝新しい順のまま）。drawCards と、詳細の「前へ／次へ」
+   * （#2）の両方がここを通る——一覧の並びと前後移動の並びがずれないように、口を1つにする。
+   */
+  function filteredDecisions() {
     var q = listState.q.trim().toLowerCase();
     // 削除済みは絞り込みの手前で落とす（分母も一緒に減るので「12/13件」が残らない）
     var all = visibleRecords(SITE.decisions);
-    var items = all.filter(function (d) {
+    return all.filter(function (d) {
       if (listState.month && d.date.slice(0, 7) !== listState.month) return false;
       if (listState.category && d.category !== listState.category) return false;
       if (!matchesStatusFilter(d, !!SITE.decisionFollowup)) return false;
@@ -19044,6 +19262,11 @@ ${calendarAddUrl.toString()}
       }
       return true;
     });
+  }
+
+  function drawCards() {
+    var all = visibleRecords(SITE.decisions);
+    var items = filteredDecisions();
 
     var wrap = document.getElementById("card-list");
     wrap.innerHTML = "";
@@ -19077,7 +19300,7 @@ ${calendarAddUrl.toString()}
       var card = el("div", { class: "card", title: d.id, "data-record-id": d.id }, [
         meta,
         // 消したレコードは一覧でも取り消し線（次のビルドまで一覧には残る）
-        el("div", { class: "card-title" + (d.deleted ? " is-deleted" : ""), text: humanTitle(d.title) }),
+        cardTitleLink(d, d.deleted ? " is-deleted" : ""),
         d.summary ? el("p", { class: "card-summary", text: d.summary }) : null,
       ]);
       card.addEventListener("click", function () { go(d.id); });
@@ -19090,8 +19313,7 @@ ${calendarAddUrl.toString()}
 
   // ---------- 汎用一覧（records/ を持つディレクトリ） ----------
   function renderGenericList() {
-    var tab = null;
-    TABS.forEach(function (t) { if (t.key === listState.tab) tab = t; });
+    var tab = findTab(listState.tab);
     // 削除済みは描画の手前で落とす（件数の分母・絞り込みの選択肢もこれ1本で揃う）
     var items = visibleRecords(tab && tab.items ? tab.items : []);
 
@@ -19112,12 +19334,7 @@ ${calendarAddUrl.toString()}
     app.appendChild(listWrap);
 
     function draw() {
-      var q = listState.q.trim().toLowerCase();
-      var shown = items.filter(function (r) {
-        if (!matchesStatusFilter(r)) return false;
-        if (!q) return true;
-        return (r.title + " " + r.summary + " " + r.searchText).toLowerCase().indexOf(q) !== -1;
-      });
+      var shown = filteredGenericItems(tab);
       listWrap.innerHTML = "";
       if (!shown.length) {
         countEl.textContent = "0 / " + items.length + " 件";
@@ -19146,7 +19363,7 @@ ${calendarAddUrl.toString()}
         meta.appendChild(traceR);
         var card = el("div", { class: "card", title: r.id, "data-record-id": r.id }, [
           meta,
-          el("div", { class: "card-title" + (r.deleted ? " is-deleted" : ""), text: humanTitle(r.title) }),
+          cardTitleLink(r, r.deleted ? " is-deleted" : ""),
           r.summary ? el("p", { class: "card-summary", text: r.summary }) : null,
         ]);
         card.addEventListener("click", function () { go(r.id); });
@@ -19916,6 +20133,68 @@ ${calendarAddUrl.toString()}
   function visibleRecords(items) {
     return (items || []).filter(function (r) { return !r.deleted; });
   }
+
+  /** タブkeyからTABSの該当行を探す（見つからなければ null） */
+  function findTab(key) {
+    var found = null;
+    TABS.forEach(function (t) { if (t.key === key) found = t; });
+    return found;
+  }
+
+  /**
+   * 今の絞り込み（検索語・状態）を当てた汎用一覧（用語集・関係者・ルール等）。
+   * renderGenericList の draw と、詳細の「前へ／次へ」（#2）の両方がここを通る
+   */
+  function filteredGenericItems(tab) {
+    var q = listState.q.trim().toLowerCase();
+    var items = visibleRecords(tab && tab.items ? tab.items : []);
+    return items.filter(function (r) {
+      if (!matchesStatusFilter(r)) return false;
+      if (!q) return true;
+      return (r.title + " " + r.summary + " " + r.searchText).toLowerCase().indexOf(q) !== -1;
+    });
+  }
+
+  /**
+   * 絞り込んだ並び（filtered）に今の記録が無ければ、絞り込み前の既定の並び（fallback。
+   * 削除済みを除いた新しい順）を使う（#2 一覧を経ずに開いたとき・絞り込みに
+   * 合わない記録を開いたときは既定の順、の受け皿）。
+   */
+  function pagerOrder(filtered, fallback, id) {
+    for (var i = 0; i < filtered.length; i++) { if (filtered[i].id === id) return filtered; }
+    return fallback;
+  }
+
+  /**
+   * 詳細画面の「前へ／次へ」（#2）。ordered の中で id の前後の記録へ移る。
+   * 端（先頭・末尾）では押せない。ordered に id が無ければ何も出さない
+   * （削除済みを直リンクで開いた等、並びそのものが無いとき）
+   */
+  function buildDetailPager(ordered, id) {
+    var idx = -1;
+    for (var i = 0; i < ordered.length; i++) { if (ordered[i].id === id) { idx = i; break; } }
+    if (idx === -1) return null;
+    var prevRec = idx > 0 ? ordered[idx - 1] : null;
+    var nextRec = idx < ordered.length - 1 ? ordered[idx + 1] : null;
+    function navBtn(rec, cls, text) {
+      // 端では押せない。<a href="#"> のままだとポインタは止められても、Tab→Enter では
+      // 踏めてしまう（#へ飛んで popstate が走り、詳細を描き直してしまう）ので、
+      // 端では href を持たない <span> にする（実装レビュー④）
+      if (!rec) return el("span", { class: "pager-btn is-disabled " + cls, "aria-disabled": "true", text: text });
+      var a = el("a", { class: "pager-btn " + cls, href: "?id=" + encodeURIComponent(rec.id), text: text });
+      a.addEventListener("click", function (ev) {
+        if (!isPlainClick(ev)) { ev.stopPropagation(); return; }
+        ev.preventDefault();
+        ev.stopPropagation();
+        go(rec.id);
+      });
+      return a;
+    }
+    return el("div", { class: "pager detail-pager" }, [
+      navBtn(prevRec, "detail-pager-prev", "← 前へ"),
+      navBtn(nextRec, "detail-pager-next", "次へ →"),
+    ]);
+  }
   /**
    * 削除済みを除いたグラフ。**消費側で1行ずつ摘まむのではなく、ここ1箇所で作る**
    * ——グラフ・エクスプローラー・件数表示が別々に間引くと、片方だけ消え残る。
@@ -19940,6 +20219,7 @@ ${calendarAddUrl.toString()}
 
   // ---------- 汎用詳細 ----------
   function renderGenericDetail(r) {
+    lastWasDetail = true;
     app.innerHTML = "";
     countEl.textContent = "";
 
@@ -19947,6 +20227,12 @@ ${calendarAddUrl.toString()}
     back.addEventListener("click", function (ev) { ev.preventDefault(); go(null); });
     app.appendChild(back);
 
+    // 前へ／次へ（#2）。一覧の今の絞り込み・並びの順。一覧を経ずに開いたときは既定の順
+    var pagerTabG = findTab("dir:" + r._section);
+    var orderedG = pagerOrder(filteredGenericItems(pagerTabG), visibleRecords(pagerTabG ? pagerTabG.items : []), r.id);
+    var detailPagerG = buildDetailPager(orderedG, r.id);
+    if (detailPagerG) app.appendChild(detailPagerG);
+
     var head = el("div", { class: "detail-head" });
     head.appendChild(el("div", {}, [ el("h1", { class: "detail-title", text: humanTitle(r.title) }) ]));
     var traceBtn2 = el("a", { class: "trace-btn", href: "?tab=graph", text: "🕸 つながり" });
@@ -20632,6 +20918,7 @@ ${calendarAddUrl.toString()}
 
   // ---------- Decision詳細 ----------
   function renderDetail(d) {
+    lastWasDetail = true;
     app.innerHTML = "";
     countEl.textContent = "";
 
@@ -20639,6 +20926,11 @@ ${calendarAddUrl.toString()}
     back.addEventListener("click", function (ev) { ev.preventDefault(); go(null); });
     app.appendChild(back);
 
+    // 前へ／次へ（#2）。一覧の今の絞り込み・並びの順。一覧を経ずに開いたときは既定の順（新しい順）
+    var orderedD = pagerOrder(filteredDecisions(), visibleRecords(SITE.decisions), d.id);
+    var detailPagerD = buildDetailPager(orderedD, d.id);
+    if (detailPagerD) app.appendChild(detailPagerD);
+
     var head = el("div", { class: "detail-head" });
     var headLeft = el("div", {}, [ el("h1", { class: "detail-title", text: humanTitle(d.title) }) ]);
     head.appendChild(headLeft);
@@ -20717,6 +21009,7 @@ ${calendarAddUrl.toString()}
   }
 
   function renderNotFound(id) {
+    lastWasDetail = true;
     app.innerHTML = "";
     var back = el("a", { class: "detail-back", href: "?", text: "← 一覧へ戻る" });
     back.addEventListener("click", function (ev) { ev.preventDefault(); go(null); });
@@ -21201,7 +21494,24 @@ ${calendarAddUrl.toString()}
     }
   })();
 
-  window.addEventListener("popstate", route);
+  // ブラウザの「戻る」「進む」。go() を通らないので、ここで一覧⇄詳細のスクロールだけ別に見る
+  // （#1 ブラウザの戻るでも一覧のスクロール位置を保つ）
+  window.addEventListener("popstate", function () {
+    var goingToId = getParam("id");
+    var cameFromDetail = lastWasDetail;
+    // 「進む」で一覧→詳細に戻ることもある（戻る→スクロール→進む、で位置が古くなる実装レビュー③）。
+    // go() と同じ条件で、そのときの一覧の位置とタブを覚え直す
+    if (goingToId && !cameFromDetail) { savedListScrollY = window.scrollY; savedListTab = listState.tab; }
+    route();
+    if (!goingToId && cameFromDetail) {
+      // 一覧へ戻る。離れたときと同じタブのときだけ元の位置へ（違えば先頭）
+      window.scrollTo(0, listState.tab === savedListTab ? savedListScrollY : 0);
+    } else if (goingToId) {
+      // 詳細はブラウザの戻る／進むでも常に先頭から
+      // （scrollRestoration を manual にしたので、ここで明示しないとブラウザがどこへも戻さない）
+      window.scrollTo(0, 0);
+    }
+  });
   /**
    * ヘッダーの案件名（#379）。**ポータル配下（/p/<key>/ の下）で開いているときだけ**、
    * ポータルの案件一覧（同一オリジンの /）へ戻るリンクにする。

package/package.json

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