@takagaki/cortex-decisions-viewer 0.12.172 → 0.12.173

package/dist/build.js

@@ -82,6 +82,7 @@ const memory_evidence_1 = require("./memory-evidence");
 const hands_1 = require("./hands");
 const rederivation_1 = require("./rederivation");
 const external_id_1 = require("./external-id");
+const member_origin_1 = require("./member-origin");
 const home_project_1 = require("./home-project");
 const supersedes_1 = require("./supersedes");
 const minify_1 = require("./minify");
@@ -2400,6 +2401,8 @@ async function buildSite(opts, views) {
     // 「記憶 v2 の案件か」は 1 本の栓 `memory_v2_writer` の値で決める（cortex-engine #1094 鎖 3 V10b）。橋の間は写しとの OR
     const memoryHands = await (0, hands_1.readMemoryHands)(repoRoot, ledgerDir);
     const memoryV2 = (0, hands_1.isMemoryV2)(opts.memoryV2Writer, memoryHands !== null);
+    // 関係者の「つながっている ID」の出どころ（cortex-engine #1911 便 B4b）。`--view-dir` の中の平文を読むだけ。無い・読めない案件は何も付かない（今と 1 バイトも同じ）
+    const memberOrigins = opts.viewDir ? await (0, member_origin_1.readMemberOrigins)(path.resolve(opts.viewDir)) : null;
     // 記録の id → リポジトリルート相対のパス（順位のファイルの鍵と突き合わせる。`repoRoot` 起点・cwd 起点にしない）
     const recordRelPaths = new Map();
     const relOf = (dir, fileName) => {
@@ -2463,6 +2466,15 @@ async function buildSite(opts, views) {
             // 旧い取り下げが普通に見えないよう、`retracted_by` を 1 本以上持つルールは一覧（と件数・つながり）から外す
             if (e.name === "Rules")
                 records = records.filter((r) => !r.relations.some((x) => x.rel === "retracted_by"));
+            // つながっている ID の出どころ（関係者だけ・`fm.identities` と同じ並びの別の表）
+            if (memberOrigins)
+                for (const r of records) {
+                    if (!(0, external_id_1.isMemberRecord)(r.rtype, r.fm.id, e.name))
+                        continue;
+                    const o = (0, member_origin_1.originsOfMember)(r.fm, String(r.fm.id ?? r.id), memberOrigins);
+                    if (o)
+                        r.idOrigins = o;
+                }
             // 関連の資料（cortex-engine #1094 F8）。ルール・用語だけ・欄の無い記録には何も付かない
             attachRelatedMaterials(e.name, records, refs);
             // 根拠（references）。ルール・用語・関係者を決定と同じリンクにする（用語・関係者の移行前の source は先頭の 1 本）

package/dist/member-origin.js

@@ -0,0 +1,115 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ORIGIN_WORDS = exports.MEMBER_ORIGIN_FILE = void 0;
+exports.identityKeyOf = identityKeyOf;
+exports.parseMemberOrigins = parseMemberOrigins;
+exports.readMemberOrigins = readMemberOrigins;
+exports.originsOfMember = originsOfMember;
+/**
+ * 関係者の「つながっている ID」の出どころ（cortex-engine #1911 便 B4b・仕様 `member.identity-origin`）。
+ *
+ * engine の記憶側の晩の終わりの段 `origin`（`scripts/memory-v2/memory/post.mjs` の `stageMemberOrigin`）が、各 ID 行が「どうやって分かったか」を
+ * 保管庫の `gold/v1/c/view/member-identity-origin.json` に置く。`--view-dir` の作業場（`view-dir.ts`）に取り出された同じ名前のファイルを、ここは**読むだけ**。
+ * 形は `{ "v": 1, "members": { "<関係者の id>": { "<主張の鍵 pc:…>": "self|peer|exact|name|ai" } } }`（封筒・目次なし。名簿の要約と同じ平文）。
+ *
+ * ## 🔴 約束
+ *
+ * - **記録の `fm.identities[]` の要素には足さない。** 画面の編集の書き戻しで機械の行が人の行に固まらないよう、記録ごとに**並びが `fm.identities` と同じ別の表**
+ *   （`idOrigins`・出どころの語か `null`）で持つ。画面は `idOrigins[i]` を `fm.identities[i]` の出どころとして読む
+ * - **ブラウザ側にハッシュを持ち込まない。** 鍵（`pc:<種類>:<sha256 先頭 32>`）の突き合わせはビルドでだけ行う
+ * - **読めない値は昇格させない。** ファイルが無い・壊れている・版が違う・語彙の外の値・鍵の形が違う行は無かったことにする（その行は空欄のまま）
+ * - 鍵の計算は engine の `identityKeyOf`（`scripts/memory-v2/spine/person-keys.mjs`）と**完全に同じ**: 小文字に畳むのはメールだけ（GitHub の login は畳まない）、
+ *   値は前後の空白を落とす。同じ固定ケース表（`test/fixtures/identity-origin-keys.json`）を `viewer/test/member-origin.test.mjs` が検査する
+ */
+const node_crypto_1 = require("node:crypto");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+const external_id_1 = require("./external-id");
+/** `--view-dir` の中の置き場（engine `ORIGIN_VIEW_NAME` + `.json`） */
+exports.MEMBER_ORIGIN_FILE = "member-identity-origin.json";
+/** 出どころの語彙（engine `ORIGIN_WORDS`・強い順） */
+exports.ORIGIN_WORDS = ["self", "peer", "exact", "name", "ai"];
+/** 主張の ID の種類（engine `PERSON_ID_KINDS`） */
+const ID_KINDS = ["email", "git_author", "github_login", "slack_user", "google_chat_user", "figma_user", "backlog_user"];
+const KEY_RE = /^pc:[a-z_]+:[0-9a-f]{32}$/;
+const isWord = (w) => typeof w === "string" && exports.ORIGIN_WORDS.includes(w);
+/** 主張の鍵（engine `identityKeyOf` と同じ）。形が違えば `null` */
+function identityKeyOf(entry) {
+    const raw = entry !== null && typeof entry === "object" && !Array.isArray(entry) ? entry.id : entry;
+    const s = String(raw ?? "");
+    const i = s.indexOf(":");
+    if (i <= 0)
+        return null;
+    const kind = s.slice(0, i);
+    const id = s.slice(i + 1).trim();
+    if (!ID_KINDS.includes(kind) || !id)
+        return null;
+    let v = id;
+    if (kind === "email") {
+        v = id.toLowerCase();
+        if (!/^[^@\s]+@[^@\s]+$/.test(v))
+            return null;
+    }
+    return `pc:${kind}:${(0, node_crypto_1.createHash)("sha256").update(v, "utf8").digest("hex").slice(0, 32)}`;
+}
+/** 中身を読む（投げない）。形が違う・版が違う → `null`。語彙の外の値・鍵の形が違う行は捨てる */
+function parseMemberOrigins(text) {
+    let data;
+    try {
+        data = JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+    if (!data || typeof data !== "object" || Array.isArray(data))
+        return null;
+    const o = data;
+    if (o.v !== 1 || !o.members || typeof o.members !== "object" || Array.isArray(o.members))
+        return null;
+    const out = new Map();
+    for (const [id, keys] of Object.entries(o.members)) {
+        if (!keys || typeof keys !== "object" || Array.isArray(keys))
+            continue;
+        const m = new Map();
+        for (const [k, w] of Object.entries(keys))
+            if (KEY_RE.test(k) && isWord(w))
+                m.set(k, w);
+        if (m.size)
+            out.set(id, m);
+    }
+    return out;
+}
+/** `--view-dir` から読む。無い → `null`（黙る）・壊れている → `null`（build のログに 1 行） */
+async function readMemberOrigins(viewDir) {
+    let text;
+    try {
+        text = await promises_1.default.readFile(node_path_1.default.join(viewDir, exports.MEMBER_ORIGIN_FILE), "utf8");
+    }
+    catch {
+        return null;
+    }
+    const parsed = parseMemberOrigins(text);
+    if (!parsed)
+        console.warn(`${exports.MEMBER_ORIGIN_FILE} を読めませんでした（つながっている ID の「どうやって分かったか」は空欄で出します）`);
+    return parsed;
+}
+/**
+ * 関係者 1 人の `fm.identities` と同じ並びの出どころの表。1 行も当たらなければ `undefined`（キーごと載せない＝出どころの無い案件は今と 1 バイトも同じ）。
+ * `fm.identities` の要素が文字列でも `{ id }` でも鍵は同じ（engine と同じ）
+ */
+function originsOfMember(fm, memberId, origins) {
+    if (!origins)
+        return undefined;
+    const mine = origins.get(memberId);
+    const list = fm[external_id_1.FM_LINKED_IDS];
+    if (!mine || !Array.isArray(list))
+        return undefined;
+    const out = list.map((e) => {
+        const k = identityKeyOf(e);
+        return k ? mine.get(k) ?? null : null;
+    });
+    return out.some((w) => w !== null) ? out : undefined;
+}

package/dist/render.js

@@ -19366,7 +19366,9 @@ ${story_1.splitByNameLinks.toString()}
   // 名前一致／AI が判定。レコード情報のパネルも同じ表を引く（2 度書かない）
   var LI_BASIS = {
     verified: { text: "ポータルで確定", tone: "is-firm" },
-    declared: { text: "本人が申告", tone: "is-firm" },
+    // 🔴 「本人が申告」は画面に出さない（cortex-engine #1911 便 B4b・リーダーの答え 6238278773 の 3）。旧い declared の行は人が書いた行と機械の行が
+    // 混ざっていて、本人が申告した証拠ではない。本人の確定は出どころ（LI_ORIGIN の self）だけで言う。declared は空欄（読めない値と同じく何も言わない）
+    declared: { text: "", tone: "is-plain" },
     exact: { text: "メール一致", tone: "is-firm" },
     name_match: { text: "名前一致", tone: "is-machine" },
     name_only: { text: "名前一致", tone: "is-machine" },
@@ -19379,6 +19381,15 @@ ${story_1.splitByNameLinks.toString()}
   var LI_BASIS_UNREADABLE = "（根拠を読み取れません）";
   // basis が無い行（出どころを言わない）。空欄で出す（「本人が申告」に倒さない）
   var LI_BASIS_NONE = { text: "", tone: "is-plain" };
+  // 出どころ（cortex-engine #1911 便 B4b・仕様 member.portal-id-list の（ ）の言い方）。ビルドが記録ごとに持つ表 idOrigins[i]（fm.identities と同じ並び）の語。
+  // 🔴 語彙の外の値は無かったことにする（読めない値を昇格させない）。ハッシュ・鍵の突き合わせはビルドでだけ行う
+  var LI_ORIGIN = {
+    self: { text: "本人が確定", tone: "is-firm" },
+    peer: { text: "周りの人が確定", tone: "is-firm" },
+    exact: { text: "同じメール・同じコミット", tone: "is-firm" },
+    name: { text: "名前の一致", tone: "is-machine" },
+    ai: { text: "AI が材料から結んだ", tone: "is-machine" },
+  };
   // 🔴 **5 列目の「場」（scope）は #704 で足した。** engine は綴りだけ予約していて、いまは
   // 人が手で書いたときだけ入る。無い行は素の空（「いつから」と同じ——空が正常）
   var LI_COLS = ["道具", "この人のページ", "どうやって分かったか", "いつから", "場"];
@@ -19425,6 +19436,19 @@ ${story_1.splitByNameLinks.toString()}
    * 🔴 **語彙の外はそのまま出して、中立の色に置く**——知らない根拠を、確かな側にも
    * 機械の側にも倒さない
    */
+  /** 出どころの語 → 画面の言葉と色。語彙の外・無い → null（呼び手は basis に戻る） */
+  function liOrigin(word) {
+    return typeof word === "string" && Object.prototype.hasOwnProperty.call(LI_ORIGIN, word) ? LI_ORIGIN[word] : null;
+  }
+  /**
+   * この行の「どうやって分かったか」。出どころの表がある記録（記憶 v2 の案件）は 5 つの言い方だけで、表に無い行は空欄
+   * （取り下げた行・結び先が別の人の行に、旧い basis の言い方を出さない）。表が無い記録（出どころを渡されない案件）だけ、今までの basis の言い方
+   */
+  function liWhy(rec, index, ent) {
+    var origins = rec && Array.isArray(rec.idOrigins) ? rec.idOrigins : null;
+    if (origins) return liOrigin(origins[index]) || LI_BASIS_NONE;
+    return liBasis(ent ? ent.basis : null);
+  }
   function liBasis(raw) {
     // 🔴 **declared（いちばん強い段）に倒してよいのは「欄が無い／空」のときだけ。**
     // 以前は typeof raw === "string" でない値を一律に空扱いしていたので、
@@ -19507,6 +19531,43 @@ ${story_1.splitByNameLinks.toString()}
     }
     return host;
   }
+  /**
+   * Slack の行の「場」の列に出す言い方（リンクの行き先の判断には使わない・表示だけ）。
+   *
+   * 🔴 **内部の値（team_id・組織のドメインなど）を画面に出さない。**
+   *   1. 場が接続済みワークスペースの team_id かドメインと一致し、操作画面で登録した名前（name）があれば、その名前
+   *   2. 名前が引けないときは、登録した Slack チャンネルの URL のホスト（xxx.slack.com の形）をそのまま。
+   *      場と結べる登録（workspace か URL のホストの頭が場）のホストが 1 つに決まるときだけ
+   *   3. どちらも引けなければ場の値のまま（推し量らない）
+   */
+  function liScopeLabel(kind, scope) {
+    if (kind !== "slack_user" || scope === "") return scope;
+    var want = scope.toLowerCase();
+    var list = slackWorkspaces() || [];
+    var hit = null;
+    for (var i = 0; i < list.length; i++) {
+      var w = list[i];
+      if (!w) continue;
+      if (w.teamId === scope || (typeof w.domain === "string" && w.domain.toLowerCase() === want)) { hit = w; break; }
+    }
+    var named = hit && typeof hit.name === "string" ? hit.name.trim() : "";
+    // 名前が引けなかったワークスペースは name に team_id が入る（空にはしない）＝名前ではない
+    if (named !== "" && named !== hit.teamId && named.toLowerCase() !== want && named.toLowerCase() !== String(hit.domain || "").toLowerCase()) return named;
+    var srcs = (fleetVal("externalSources") || []).filter(function (x) {
+      return x && x.type === "slack" && typeof x.url === "string";
+    });
+    var host = "";
+    for (var j = 0; j < srcs.length; j++) {
+      var m = LI_SLACK_CHANNEL_HOST.exec(srcs[j].url);
+      if (!m) continue;
+      var h = m[1].toLowerCase() + ".slack.com";
+      var tied = srcs[j].workspace === scope || (hit && srcs[j].workspace === hit.teamId) || m[1].toLowerCase() === want;
+      if (!tied) continue;
+      if (host && host !== h) return scope;
+      host = h;
+    }
+    return host || scope;
+  }
   /**
    * Backlog のユーザーのページを組むスペースのドメイン（決められなければ空文字）。
    *
@@ -19576,7 +19637,7 @@ ${story_1.splitByNameLinks.toString()}
     var list = fm ? fm[FM_LINKED_IDS] : null;
     if (!Array.isArray(list)) return [];
     var out = [];
-    list.forEach(function (ent) {
+    list.forEach(function (ent, index) {
       if (!ent || typeof ent !== "object" || Array.isArray(ent)) return;
       if (typeof ent.id !== "string") return;
       var whole = ent.id.trim();
@@ -19584,7 +19645,7 @@ ${story_1.splitByNameLinks.toString()}
       var typed = LI_TYPED_ID.exec(whole);
       var kind = typed ? typed[1] : "";
       var value = typed ? typed[2] : whole;
-      var basis = liBasis(ent.basis);
+      var basis = liWhy(rec, index, ent);
       // 場は文字列のときだけ（数やオブジェクトを String() して出さない）
       var scope = typeof ent.scope === "string" ? ent.scope.trim() : "";
       out.push({
@@ -19595,7 +19656,7 @@ ${story_1.splitByNameLinks.toString()}
         tone: basis.tone,
         // 🔴 since が無い行の「いつから」は素の空。印（ダッシュ等）を足さない——空が正常
         since: typeof ent.since === "string" ? ent.since : "",
-        scope: scope,
+        scope: liScopeLabel(kind, scope),
       });
     });
     return out;
@@ -19858,7 +19919,7 @@ ${story_1.splitByNameLinks.toString()}
     if (linked) app.appendChild(linked);
     var history = changeLogSection(rec);
     if (history) app.appendChild(history);
-    var fmp = renderFmPanel(rec.fm);
+    var fmp = renderFmPanel(rec.fm, rec.idOrigins);
     if (fmp) app.appendChild(fmp);
     appendDeleteFoot(rec);
     // 開き直しても削除済みのまま見せる（印は rec が持っている）
@@ -21379,7 +21440,7 @@ ${story_1.splitByNameLinks.toString()}
     }
     return String(x);
   }
-  function renderFmPanel(fm) {
+  function renderFmPanel(fm, idOrigins) {
     if (!fm || !Object.keys(fm).length) return null;
     var panel = el("details", { class: "fm-panel" });
     panel.appendChild(el("summary", { class: "fm-title", text: "レコード情報（frontmatter）" }));
@@ -21415,10 +21476,10 @@ ${story_1.splitByNameLinks.toString()}
         // 🔴 **欄自体は隠さない**（frontmatter のパネルは今までどおり全部そのまま出す）。
         // ただしこの欄はオブジェクトの配列なので、下の join に落とすと [object Object] になる
         // ——1行1件で id と根拠の日本語を出す（上の「つながっている ID」と同じ言葉で）
-        v.forEach(function (ent) {
+        v.forEach(function (ent, index) {
           var line = el("div", { class: "fm-li" });
           if (ent && typeof ent === "object" && !Array.isArray(ent) && typeof ent.id === "string") {
-            var basisText = liBasis(ent.basis).text;
+            var basisText = liWhy({ idOrigins: idOrigins }, index, ent).text;
             line.textContent = basisText ? ent.id + "（" + basisText + "）" : ent.id;
           } else {
             // 形が外れている要素も消さずに読める形で残す（文字列で書かれた欄を含む）

package/package.json

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