@takagaki/cortex-decisions-viewer 0.12.106 → 0.12.107

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）。**無ければ空文字。**
  *
@@ -5601,6 +5716,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 +6409,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()}
@@ -14636,6 +14763,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 +15276,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 +15917,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）。
           // 行が無いファイル（まだ一度も同期していない）には何も出ない。

package/package.json

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