@takagaki/cortex-decisions-viewer 0.12.80 → 0.12.81

package/dist/build.js

@@ -58,6 +58,7 @@ const gray_matter_1 = __importDefault(require("gray-matter"));
 const marked_1 = require("marked");
 const sanitize_html_1 = __importDefault(require("sanitize-html"));
 const repo_1 = require("./repo");
+const engagement_1 = require("./engagement");
 const rederivation_1 = require("./rederivation");
 // 直近のGold昇格で追加されたレコードのパス集合。レコード生成の各所から参照するのでモジュールスコープに置く
 // （引数で引き回すと呼び出し側の改修が広範囲になる）。build() の冒頭で1回だけ解決する。
@@ -2051,6 +2052,9 @@ async function build(opts) {
             blobs: { read: 0, skipped: 0 },
         }
         : null;
+    // 関与の帳簿（便 14b・#709）。関係者の一覧を目次と同じ「関わりの多い順」に並べる材料。
+    // **読めない・使えないなら `null`** で、関係者の並びは今までと 1 バイトも同じ
+    const engagement = await (0, engagement_1.readEngagementLedger)(repoRoot);
     const decisions = [];
     for (const fileName of mdFiles) {
         const raw = await node_fs_1.promises.readFile(path.join(dirAbs, fileName), "utf8");
@@ -2106,7 +2110,12 @@ async function build(opts) {
             const records = await loadGenericRecords(recordsDir, exclude, repo.baseUrl, repo.branch);
             // 「人が確認した版から変わりました」の帯と、用語集の並び（#665 便 12b）。
             // **帳簿を持たない案件では 1 件も付かず、並びもそのまま**（下の attachRederived）
-            const ordered = await attachRederived(records, recordsDir, rederive, opts.generatedAt);
+            const rederived = await attachRederived(records, recordsDir, rederive, opts.generatedAt);
+            // 関係者だけ、関与の多い順（engine の目次と同じ `order`・便 14b）。用語集の並び
+            // （`orderByActivity`）とは帳簿も式も別で、区画が重ならないので順番に当てても干渉しない
+            const ordered = e.name === "Members"
+                ? (0, engagement_1.orderMembersByEngagement)(rederived, (r) => r.id, engagement, opts.generatedAt)
+                : rederived;
             // レコード0件でもタブは出す（空状態から「＋AIで登録」できる導線になる）。
             // records/ 自体が無いディレクトリ（その区画が未導入の案件）はタブにしない
             if (records.length || (await isDirectory(recordsDir))) {

package/dist/engagement.js

@@ -0,0 +1,209 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.weightOf = exports.WEIGHTS = exports.HALF_LIFE_DAYS = exports.ENGAGEMENT_LEDGER_VERSION = exports.ENGAGEMENT_LEDGER_PATH = void 0;
+exports.scoreOf = scoreOf;
+exports.engagementOrder = engagementOrder;
+exports.parseEngagementLedger = parseEngagementLedger;
+exports.readEngagementLedger = readEngagementLedger;
+exports.orderMembersByEngagement = orderMembersByEngagement;
+/**
+ * 関係者の一覧を「関わりの多い順」に並べる（便 14b・#709）。
+ *
+ * ## 写しの正本は engine
+ *
+ * 式の正本は cortex-engine の `scripts/engagement/tiers.mjs`（`scoreOf` と `assignTiers` の
+ * `order`）と `scripts/engagement/weights.mjs`（重みの表・半減期）。記憶の目次
+ * （`Cortex/Index.md` の関係者の節・`scripts/memory-index.mjs` の `memberRows`）は正本を直に
+ * 呼んでいるので、**画面の並びがここでずれると、同じ人が画面と目次で別の順に出る**。
+ * どちらも正しく描画され、エラーも空欄も出ない——だから写しの契約を表で持つ
+ * （`test/member-engagement-parity.test.mjs` が engine の
+ * `test/fixtures/engagement-tiers-contract.json` を 1 バイト違わず写した表を読む）。
+ *
+ * **写すのは並び（`order`）だけ。** 段階（`tiers`）・群（`groups`）・上位集合（`top_set`）・
+ * 食い違い（`mismatch`）・不感帯（`basis`）は画面が使わない。とくに `order` は便 #543 で群分けを
+ * やめて「score 降順・同点は `person` 昇順」だけになったので、**不感帯の基準にも段階にも
+ * 依存しない**。使わない式を写すと、正本が直した日に写しの直し忘れが静かに残る。
+ *
+ * ## 🔴 帳簿が無い・壊れている・版が違う案件は「今までと 1 バイトも同じ画面」
+ *
+ * 読み方は目次（`parseLedgerText` と `memberRows`）と同じ規律:
+ * - 無い・JSON として読めない・オブジェクトでない・`version` が違う → 並べ替えない
+ * - **読めても使える行が 0 件なら並べ替えない**（観測が始まったばかりの案件の
+ *   `{"version":1,"people":[]}`。目次が「本式と名乗らない」のと同じ線）
+ * - 壊れた行（`null`・`person` が文字列でない・`id_kind`/`id` が無い）は**その行だけ捨てる**
+ *   （行の中の `counts_by_month` は均さない＝正本と同じ値を渡す）
+ *
+ * ## 🔴 時計を中で読まない
+ *
+ * `now` は引数（ビルドの `generatedAt`）。半減期が全員共通なので、全ての月が過去なら `now` を
+ * 動かしても順は変わらないが、先付けの月（経過日数 0 に切り上げる）があると変わる。
+ */
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_path_1 = __importDefault(require("node:path"));
+/** 帳簿の置き場（engine `scripts/engagement/keys.mjs` の `LEDGER_PATH`） */
+exports.ENGAGEMENT_LEDGER_PATH = ".cortex/gold-member-engagement.json";
+/** 帳簿の版（engine `scripts/memory-index.mjs` の `LEDGER_VERSION`。違ったら読まない） */
+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**）。
+ *
+ * 🔴 契約の表（fixture）は `message.posted` しか使っていないので、**ここの写し間違いは表では
+ * 捕まらない**。重みの番人は `test/member-engagement-parity.test.mjs` の `[重み]` が持つ。
+ */
+exports.WEIGHTS = Object.freeze({
+    "message.posted": 1.0,
+    "message.edited": 0.3,
+    "message.deleted": 0,
+    "comment.posted": 1.0,
+    "comment.edited": 0.3,
+    "comment.deleted": 0,
+    "comment.resolved": 1.0,
+    "issue.created": 1.5,
+    "issue.updated": 0.3,
+    "issue.closed": 1.0,
+    "page.revised": 1.5,
+    "page.deleted": 0,
+    "commit.pushed": 1.0,
+    "pr.opened": 1.5,
+    "pr.merged": 1.5,
+    "pr.closed": 1.0,
+    "review.submitted": 1.5,
+    "utterance.spoken": 1.0,
+    "meeting.held": 1.0,
+    "record.confirmed": 2.0,
+    "record.edited": 2.0,
+    "record.deleted": 0,
+});
+const DAY_MS = 86400000;
+const cmp = (a, b) => (a < b ? -1 : a > b ? 1 : 0);
+/** 1 件の重み。語彙外は 0（engine `weightOf`） */
+const weightOf = (kind) => Object.prototype.hasOwnProperty.call(exports.WEIGHTS, kind) ? exports.WEIGHTS[kind] : 0;
+exports.weightOf = weightOf;
+/** 月の中央日（`YYYY-MM` → その月の 15 日 12:00 UTC・engine `monthCenterMs`） */
+const monthCenterMs = (month) => Date.parse(`${month}-15T12:00:00Z`);
+/**
+ * score = Σ_月 Σ_kind w × n × 0.5^(その月の中央日からの経過日数 / 90)（engine `scoreOf` の写し）。
+ *
+ * 🔴 **足す順を正本と同じに決め打つ**（月昇順 × `kind` 昇順）。浮動小数の和は順序で最下位
+ * ビットが変わるので、順を変えると同点の判定が正本とずれうる。
+ * 未来の月は経過日数 0 に切り上げる（増幅させない）。
+ */
+function scoreOf(countsByMonth, nowIso) {
+    const nowMs = Date.parse(nowIso);
+    let total = 0;
+    for (const month of Object.keys(countsByMonth || {}).sort(cmp)) {
+        const elapsedDays = Math.max(0, (nowMs - monthCenterMs(month)) / DAY_MS);
+        const decay = Math.pow(0.5, elapsedDays / exports.HALF_LIFE_DAYS);
+        const byKind = (countsByMonth || {})[month] || {};
+        for (const kind of Object.keys(byKind).sort(cmp))
+            total += (0, exports.weightOf)(kind) * Number(byKind[kind] || 0) * decay;
+    }
+    return total;
+}
+/** engine `unresolvedPersonOf`（順位に混ぜる鍵。画面には出ない） */
+const unresolvedPersonOf = (u) => `unresolved:${String(u.id_kind)}:${String(u.id)}`;
+/**
+ * 並び（engine `assignTiers(...).order` の写し）。**score 降順・同点は `person` 昇順。**
+ *
+ * 名簿に無い発言者（`unresolved:`）も**順位には混ぜる**（正本と同じ母集団で並べる）。
+ * 画面に出ないので位置が空くだけで、名簿の人どうしの前後は変わらない。
+ */
+function engagementOrder(ledger, nowIso) {
+    const entries = [
+        ...ledger.people.map((p) => ({ person: p.person, counts: p.counts_by_month || {} })),
+        ...ledger.unresolved.map((u) => ({ person: unresolvedPersonOf(u), counts: u.counts_by_month || {} })),
+    ];
+    const scores = new Map();
+    for (const e of entries)
+        scores.set(e.person, scoreOf(e.counts, nowIso));
+    return entries
+        .slice()
+        .sort((a, b) => (scores.get(b.person) - scores.get(a.person)) || cmp(a.person, b.person))
+        .map((e) => e.person);
+}
+/**
+ * 帳簿の生テキストを読む。**読めない・使えないときは `null`**（＝並べ替えない）。
+ *
+ * 規律は engine の目次と同じ（`parseLedgerText` → `memberRows` の行の篩 → 使える行 0 件なら
+ * 本式と名乗らない）。
+ */
+function parseEngagementLedger(text) {
+    if (text === null || text === undefined || String(text).trim() === "")
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(String(text));
+    }
+    catch {
+        return null;
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+        return null;
+    const obj = parsed;
+    if (Number(obj.version) !== exports.ENGAGEMENT_LEDGER_VERSION)
+        return null;
+    const rowsOf = (value) => (Array.isArray(value) ? value : []).filter((v) => Boolean(v) && typeof v === "object");
+    const peopleRows = rowsOf(obj.people);
+    const unresolvedRows = rowsOf(obj.unresolved);
+    // 使える行の数は篩う前で数える（目次の `usableRows` と同じ線）。篩ったあとに 0 人になっても
+    // 画面は元の並びのまま（全員が「帳簿にいない人」になるだけ）なので、結果はどちらでも同じ
+    if (peopleRows.length + unresolvedRows.length === 0)
+        return null;
+    // 🔴 **`counts_by_month` は均さずにそのまま渡す**（実装レビュー 🟡1）。文字列などの壊れた値を
+    // ここで `{}` に直すと、正本（`p.counts_by_month || {}` をそのまま `scoreOf` に渡す）と
+    // 並びが食い違う。壊れた値で並びが崩れるなら、直すのは正本の側（申し送り）
+    return {
+        people: peopleRows
+            .filter((p) => typeof p.person === "string" && p.person !== "")
+            .map((p) => ({ person: p.person, counts_by_month: p.counts_by_month })),
+        unresolved: unresolvedRows
+            .filter((u) => u.id_kind != null && u.id != null)
+            .map((u) => ({ id_kind: u.id_kind, id: u.id, counts_by_month: u.counts_by_month })),
+    };
+}
+/** 案件リポから帳簿を読む（無ければ `null`・例外にしない） */
+async function readEngagementLedger(repoRoot) {
+    let text;
+    try {
+        text = await promises_1.default.readFile(node_path_1.default.join(repoRoot, exports.ENGAGEMENT_LEDGER_PATH), "utf8");
+    }
+    catch {
+        return null;
+    }
+    return parseEngagementLedger(text);
+}
+/**
+ * 関係者の記録を帳簿の並びに並べ替える。
+ *
+ * - 帳簿が `null` → **同じ配列をそのまま返す**（1 バイトも触らない）
+ * - 帳簿にいる人（`member:<id>` ＝ 記録の `id`）は `order` の位置順
+ * - 帳簿にいない人は**末尾**へ、**元の並びのまま**（安定）
+ * - 🔴 **確認済みかどうか（`status`）は見ない**（#690 と同じ・オーナー決定 2026-09-21
+ *   「アクティブ、ドラフト関係なく」）。受け取りもしない
+ *
+ * @param idOf 記録の `id`（frontmatter の `id`。帳簿の `person` と同じ綴り）
+ */
+function orderMembersByEngagement(records, idOf, ledger, nowIso) {
+    if (!ledger || !records.length)
+        return records;
+    const position = new Map();
+    engagementOrder(ledger, nowIso).forEach((person, i) => {
+        if (!position.has(person))
+            position.set(person, i);
+    });
+    return records
+        .map((r, i) => ({ r: r, i: i, pos: position.get(idOf(r)) }))
+        .sort((a, b) => {
+        if (a.pos != null && b.pos != null && a.pos !== b.pos)
+            return a.pos - b.pos;
+        if ((a.pos == null) !== (b.pos == null))
+            return a.pos == null ? 1 : -1;
+        return a.i - b.i;
+    })
+        .map((s) => s.r);
+}

package/dist/rederivation.js

@@ -51,7 +51,7 @@ const commit_classify_1 = require("./commit-classify");
 exports.LEDGER_VERSION = 1;
 /** 帯を出す区画。**用語とメンバーだけ**（Decisions は積み上げ・Rules は便 13） */
 const BAND_SECTION_RE = /^Cortex\/(?:Glossary|Members)\/records\/[^/]+\.md$/;
-/** 並びを変える区画。**用語集だけ**（メンバーの並びは便 14） */
+/** 並びを変える区画。**用語集だけ**（関係者の並びは関与の帳簿で `engagement.ts` が決める・便 14b） */
 const ORDER_SECTION_RE = /^Cortex\/Glossary\/records\/[^/]+\.md$/;
 /** ACT-R base-level の減衰（#432 裁定 5-5: d = 0.5） */
 const ACTR_DECAY = 0.5;
@@ -493,7 +493,7 @@ function rederivedBandOf(recordPath, status, ledgers, identities, verdict, miss)
  * - 活性度を持つレコードが 1 件も無い区画は **1 バイトも触らない**（帳簿が無い案件は従来順）
  * - 活性度を知らないレコードは**末尾**へ、**元の並びのまま**（安定）
  * - 同じ活性度なら元の並び（日付降順 → タイトル昇順がそのまま残る）
- * - 用語集だけ（メンバーの並びは便 14・Decisions と Rules は対象外）
+ * - 用語集だけ（関係者の並びは `engagement.ts`・便 14b。Decisions と Rules は対象外）
  *
  * ℹ️ `ledgers` と `statusOf` は**受け取り続ける**。`ledgers` は活性度のために要る。
  * `statusOf` は並びに使わなくなったが、**引数から落とすと「群分けを足し戻す」退行が

package/package.json

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