@takagaki/cortex-decisions-viewer 0.12.96 → 0.12.98

package/dist/build.js

@@ -62,6 +62,7 @@ const marked_1 = require("marked");
 const sanitize_html_1 = __importDefault(require("sanitize-html"));
 const repo_1 = require("./repo");
 const engagement_1 = require("./engagement");
+const story_1 = require("./story");
 const rederivation_1 = require("./rederivation");
 // 直近のGold昇格で追加されたレコードのパス集合。レコード生成の各所から参照するのでモジュールスコープに置く
 // （引数で引き回すと呼び出し側の改修が広範囲になる）。build() の冒頭で1回だけ解決する。
@@ -2208,10 +2209,14 @@ async function build(opts) {
     // 同一プロセスで2回ビルドしても前回の値が残らないよう、毎回入れ替える
     PROPOSALS_BY_PATH = await readGoldProposals(repoRoot);
     PROPOSAL_PATHS_MATCHED = new Set();
-    // 再導出の 3 帳簿（#665 便 12b）。**帳簿が無い案件では帯も並び替えも作らない**。
+    // 再導出の 3 帳簿（#665 便 12b）と用語の強さ（#790）。**帳簿が無い案件では帯も並び替えも作らない**。
     // 人か機械かの見分けは engine が帳簿（`rewritten`）に書くので、画面は git の素性を読まない（#799）
+    //
+    // 🔴 **強さ（`state` が on のときだけ中身が入る）だけの案件でも器を作る**——作らないと、活性度の帳簿を
+    // 持たない案件で用語集が目次（engine の `termRows`）と違う順になる。帯は `confirmation` の行が無ければ
+    // 1 件も立たない（`rederivedContentKey` の門）ので、器を作っても帯・印は変わらない
     const ledgers = await (0, rederivation_1.readRederivationLedgers)(repoRoot);
-    const rederive = ledgers.confirmation.size || ledgers.activity.size
+    const rederive = ledgers.confirmation.size || ledgers.activity.size || ledgers.strength.size
         ? {
             ledgers: ledgers,
             // 🔴 **`repoRoot` で走らせる**（`collectAiChangeHistory` の `process.cwd()` に倣わない）。
@@ -2356,6 +2361,8 @@ async function build(opts) {
     // 走るのは latestGeneratedPaths と同じ **リポジトリルート**（process.cwd()）——
     // Decisions ディレクトリで実行すると pathspec に一致せず常に空になる
     const aiHistory = (0, repo_1.collectAiChangeHistory)(process.cwd());
+    // ストーリーの日々の動き（#901 V2-5）。帳簿で on の日のファイルが無ければ null（キーごと出さない）
+    const story = await (0, story_1.readStory)(repoRoot, renderGroundingSection, (p) => repo.baseUrl ? `${repo.baseUrl}/edit/${repo.branch}/${encodePath(p)}` : null);
     // 案件アイコン（#348）。Cortex構成でなければ undefined（旧レイアウトには置き場が無い）
     const projectIcon = await findProjectIcon(knowledgeRoot);
     const site = {
@@ -2414,6 +2421,8 @@ async function build(opts) {
         // 「知らないことはキーが無いことで表す」に合わせる（空の器を通さない）
         // 空の器は通さない（0件なら undefined = キーごと出さない）
         aiHistory: Object.keys(aiHistory).length ? aiHistory : undefined,
+        // 載せる日が無い案件（帳簿なし・壊れ・shadow の日だけ・ファイルなし）はキーごと出さない
+        story: story ?? undefined,
     };
     // サムネイル（デザイン画面等）をサイトに同梱し、ノードのパスをサイト内相対に書き換える
     await node_fs_1.promises.mkdir(outAbs, { recursive: true });

package/dist/rederivation.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HUMAN_FOLLOWUP_STATES = exports.FOLLOWUP_EVIDENCE_VERDICTS = exports.FOLLOWUP_SHOWN_STATES = exports.DECISION_FOLLOWUP_FILE = exports.emptyLedgers = exports.LEDGER_VERSION = void 0;
+exports.HUMAN_FOLLOWUP_STATES = exports.FOLLOWUP_EVIDENCE_VERDICTS = exports.FOLLOWUP_SHOWN_STATES = exports.DECISION_FOLLOWUP_FILE = exports.emptyLedgers = exports.TERM_STRENGTH_FILE = exports.LEDGER_VERSION = void 0;
 exports.isConfirmedStatus = isConfirmedStatus;
 exports.parseLedger = parseLedger;
 exports.readRederivationLedgers = readRederivationLedgers;
@@ -20,15 +20,17 @@ exports.readDecisionFollowup = readDecisionFollowup;
 exports.shownFollowupOf = shownFollowupOf;
 exports.humanFollowupOf = humanFollowupOf;
 /**
- * 再導出の 3 帳簿を読み、帯「人が確認した版から変わりました」と用語集の並びを作る（#665 便 12b）。
+ * 再導出の 3 帳簿（＋用語の強さの帳簿）を読み、帯「人が確認した版から変わりました」と用語集の並びを作る（#665 便 12b）。
  *
  * | 帳簿 | 何を持つか | 書き手 |
  * | --- | --- | --- |
  * | `.cortex/gold-confirmation.json` | レコードごとの「人が確認した版」と、その後の機械の書き直しの最新（`rewritten`・中身の指紋つき・#799） | 夜間（全置換・git から作り直せる） |
  * | `.cortex/gold-rederivation.json` | 書き直しの根拠の件数・shadow の「書くつもりだった差分」 | 夜間（追記・区画ごとの節） |
  * | `.cortex/gold-activity.json` | 「最後に見た日」と触れた日の列（＋観測の到達点 `cursor`） | 夜間（追記・剪定つき） |
+ * | `.cortex/gold-term-strength.json` | 用語ごとの強さ（場面の数・使った人の数・資料の下地）と栓の状態 `state`（#790・engine #727） | 夜間（全置換） |
  *
- * 形の正本は cortex-engine `scripts/rederive/ledgers.mjs` と `docs/cortex-derived-files.md`。
+ * 形の正本は cortex-engine `scripts/rederive/ledgers.mjs` と `docs/cortex-derived-files.md`
+ * （強さの帳簿は `scripts/gold/term-gate.mjs` の `strengthLedgerOf`）。
  *
  * ## 🔴 帳簿が無い・壊れている・古い形の案件は「今までと 1 バイトも同じ画面」
  *
@@ -80,10 +82,13 @@ const MIN_ELAPSED_DAYS = 0.5;
 function isConfirmedStatus(status, recordPath = null) {
     return !(0, confirmed_1.machineOwned)(recordPath, status);
 }
+/** 強さの帳簿のファイル名（`.cortex/` の下） */
+exports.TERM_STRENGTH_FILE = "gold-term-strength.json";
 const emptyLedgers = () => ({
     confirmation: new Map(),
     rederivation: new Map(),
     activity: new Map(),
+    strength: new Map(),
 });
 exports.emptyLedgers = emptyLedgers;
 /**
@@ -103,15 +108,19 @@ function parseLedger(text) {
         return null;
     }
 }
-/** 1 本読む。無い（ENOENT）ことは警告しない（既定の状態）。壊れているときだけ 1 行残す */
-async function readOne(repoRoot, file) {
+/**
+ * 1 本読む。無い（ENOENT）ことは警告しない（既定の状態）。壊れているときだけ 1 行残す。
+ *
+ * @param then 警告の括弧の中（読めなかったあと画面がどうなるか）。強さの帳簿は帯を持たないので文言を変える
+ */
+async function readOne(repoRoot, file, then = "帯と並びは出さずに続けます") {
     let raw;
     try {
         raw = await promises_1.default.readFile(node_path_1.default.join(repoRoot, ".cortex", file), "utf8");
     }
     catch (e) {
         if (e?.code !== "ENOENT") {
-            console.warn(`${file} を読めませんでした（帯と並びは出さずに続けます）: ${String(e)}`);
+            console.warn(`${file} を読めませんでした（${then}）: ${String(e)}`);
         }
         return null;
     }
@@ -119,7 +128,7 @@ async function readOne(repoRoot, file) {
     // **壊れている・版が違うときは 1 行残す。** 静かに 0 件になると、帯が出ない理由が
     // 「夜間がまだ書いていない」のか「読めていない」のか切り分けられない
     if (!parsed)
-        console.warn(`${file} の形式か version が想定と違います（帯と並びは出さずに続けます）`);
+        console.warn(`${file} の形式か version が想定と違います（${then}）`);
     return parsed;
 }
 const asRecord = (v) => v != null && typeof v === "object" && !Array.isArray(v) ? v : null;
@@ -219,6 +228,38 @@ async function readRederivationLedgers(repoRoot) {
             }
         }
     }
+    // 用語の強さ（#790）。**engine の目次（`scripts/memory-index.mjs` の `termStrengthLookup`）の写し**
+    const strengthThen = "用語集は今の並びのまま続けます";
+    const strength = await readOne(repoRoot, exports.TERM_STRENGTH_FILE, strengthThen);
+    if (strength) {
+        const terms = strength.terms;
+        // 🔴 **engine と同じ判定**（`body.version !== 1`（厳密）・`!body.terms || typeof body.terms !== "object"`）。
+        // `readOne` の `parseLedger` は `Number(version)` で読むので `"1"` を通す——目次は通さないので、ここで締める。
+        // 壊れているのと同じなので 1 行残す（無いときだけ黙る）
+        if (strength.version !== exports.LEDGER_VERSION || !terms || typeof terms !== "object") {
+            console.warn(`${exports.TERM_STRENGTH_FILE} の形式か version が想定と違います（${strengthThen}）`);
+        }
+        else if (strength.state === "on") {
+            // 🔴 **並びに使うのは `state === "on"` のときだけ**。`shadow` は「夜間が数えているが、まだ並びに
+            // 効かせない」段階で、目次も栓が on になるまで強さを使わない。ここで shadow を読むと、画面だけが
+            // 先に並び替わり、目次（AI に渡る順）と食い違う。on 以外は既定の状態なので警告しない
+            const t = terms;
+            for (const p of Object.keys(t)) {
+                // 語ごとの値は engine と同じ門（`Object.hasOwn(terms, p) && terms[p] && typeof terms[p] === "object"`。
+                // `Object.keys` は自前のキーだけを返すので `hasOwn` はここで満たされている）。
+                // 通らない語はキーごと持たない＝「知らない」（末尾へ）
+                const v = t[p];
+                if (!v || typeof v !== "object")
+                    continue;
+                const s = v;
+                out.strength.set(p, {
+                    scenes: Number(s.scenes) || 0,
+                    people: Number(s.people) || 0,
+                    base: s.base === true,
+                });
+            }
+        }
+    }
     return out;
 }
 /** `YYYY-MM-DD` を「その日の正午（UTC）」として読む（時刻を持たない日付に時差を持ち込まない） */
@@ -312,23 +353,28 @@ function normalizeForCompare(text) {
 const MEMBER_DECISIONS_START = "<!-- cortex-engine:member-decisions -->";
 const MEMBER_DECISIONS_END = "<!-- /cortex-engine:member-decisions -->";
 /**
- * 本文から engine の機械ブロック（「この人が関わった決定」）を取り除く（#702）。
- *
- * 🔴 **engine の写し（`scripts/rederive/content-sha.mjs`）と同じ規則。** 変えたら両方を変える。
- * 開始の印**だけ**の行（行末の `\r` は無視）から、終了の印**だけ**の行までを（両端を含めて）消す。終了の印が
- * 無ければ本文の終わりまで消す。塊の前後の空行も除き、両側に本文が残れば空行 1 行でつなぐ。そのあと末尾の空行を落とす。ブロックの無い本文は触らない。
+ * engine が決定の記録の末尾に書く「その後」の塊の印（#901 V2-2）。始まりの印は属性つき
+ * （`<!-- cortex-engine:followup sha=… in=… -->`）なので完全一致ではなく形で当てる。
+ * 🔴 **engine の写し（`scripts/rederive/sections.mjs` の `isFollowupBegin`・`FOLLOWUP_END`）と 1 バイト一致。**
+ * 行末の `\r` を落としてから当てる（CRLF の記録でも印の行として当てる）
+ */
+const FOLLOWUP_BEGIN_RE = /^<!-- cortex-engine:followup(?: [^\n]*?)? -->$/;
+const FOLLOWUP_END = "<!-- /cortex-engine:followup -->";
+const isFollowupBegin = (line) => FOLLOWUP_BEGIN_RE.test(String(line ?? "").replace(/\r$/, ""));
+/**
+ * 本文から engine の機械の塊を 1 つ取り除く規則の本体（2 つの塊で同じ 1 本）。
  *
- * 毎晩書き換わる機械の一覧を「人が確認した版から中身が変わっています」に数えないため。
- * ブロックの外を人が 1 文字でも直せば、従来どおり指紋は変わる。
+ * 🔴 **engine の写し（`scripts/rederive/content-sha.mjs` の `withoutBlockText`）と同じ規則。** 変えたら両方を変える。
+ * 開始の印の行（最初の 1 つ・行末の `\r` は無視）から、終了の印**だけ**の行までを（両端を含めて）消す。終了の印が
+ * 無ければ本文の終わりまで消す。塊の前後の空行も除き、両側に本文が残れば空行 1 行でつなぐ。そのあと末尾の空行を落とす。塊の無い本文は触らない。
  */
-function stripMemberDecisions(body) {
+function withoutBlock(body, isBegin, endMarker) {
     const lines = body.split("\n");
-    // 行末の `\r` は見ない（CRLF の記録でも印の行として当てる。当てないと毎晩印が立つ）
-    const is = (marker) => (line) => line.replace(/\r$/, "") === marker;
-    const start = lines.findIndex(is(MEMBER_DECISIONS_START));
+    const start = lines.findIndex((line) => isBegin(line));
     if (start < 0)
         return body;
-    const endRel = lines.slice(start + 1).findIndex(is(MEMBER_DECISIONS_END));
+    // 行末の `\r` は見ない（CRLF の記録でも印の行として当てる。当てないと毎晩印が立つ）
+    const endRel = lines.slice(start + 1).findIndex((line) => line.replace(/\r$/, "") === endMarker);
     const end = endRel < 0 ? lines.length : start + 1 + endRel + 1;
     const isBlank = (line) => line.trim() === "";
     // 塊の前後の空行も一緒に除き、両側に本文が残れば空行 1 行でつなぐ（engine の書き手と同じ規則・#702 実装レビュー R1）
@@ -343,6 +389,30 @@ function stripMemberDecisions(body) {
         kept.pop();
     return kept.join("\n");
 }
+/**
+ * 本文から engine の機械ブロック（「この人が関わった決定」）を取り除く（#702）。
+ *
+ * 🔴 **engine の写し（`scripts/rederive/content-sha.mjs` の `withoutMemberDecisionsText`）と同じ規則。**
+ * 開始の印**だけ**の行（行末の `\r` は無視）から終了の印**だけ**の行まで。
+ *
+ * 毎晩書き換わる機械の一覧を「人が確認した版から中身が変わっています」に数えないため。
+ * ブロックの外を人が 1 文字でも直せば、従来どおり指紋は変わる。
+ */
+function stripMemberDecisions(body) {
+    return withoutBlock(body, (line) => line.replace(/\r$/, "") === MEMBER_DECISIONS_START, MEMBER_DECISIONS_END);
+}
+/**
+ * 本文から決定の「その後」の塊（#901 V2-2）を取り除く。規則は `stripMemberDecisions` と同じ 1 本
+ * （始まりの印だけ `isFollowupBegin` の形で当てる）。
+ *
+ * 🔴 **engine の写し（V2-2・`scripts/rederive/content-sha.mjs` の `withoutFollowupText`）と 1 バイト一致・
+ * 番人は `test/followup-block-sha.test.mjs`**（engine の `contentShaOf` を実際に呼んで焼いた表
+ * `test/fixtures/followup-sha-contract.json`）。塊は機械が材料の変わった夜に `active` の決定にも書き直すので、
+ * 除かないと「人が確認した版から変わりました」に数える。塊の無い記録の指紋は 1 バイトも変えない。
+ */
+function withoutFollowup(body) {
+    return withoutBlock(body, isFollowupBegin, FOLLOWUP_END);
+}
 function comparableContent(raw) {
     let data = {};
     let content = String(raw ?? "");
@@ -357,7 +427,8 @@ function comparableContent(raw) {
     }
     return {
         description: normalizeForCompare(String(data.description ?? "")),
-        body: normalizeForCompare(stripMemberDecisions(content)),
+        // engine と同じ順（目録の塊 → その後の塊）
+        body: normalizeForCompare(withoutFollowup(stripMemberDecisions(content))),
     };
 }
 /** 2 つの版で「説明文と本文」が同じか（frontmatter の他の欄の差は見ない） */
@@ -496,11 +567,24 @@ function rederivedBandOf(recordPath, status, ledgers, nowShaOf, verdict, miss) {
  * **流し込んだ別の実体**で、2 つが一致していることは `rederived-mark-ui.test.mjs` の `[札との一致]` が見る。
  * ここで変えるのは**並びだけ**で、札・帯・印・プロンプトに渡る材料は 1 つも変えていない。
  *
- * - 活性度を持つレコードが 1 件も無い区画は **1 バイトも触らない**（帳簿が無い案件は従来順）
+ * - 活性度を持つレコードが 1 件も無い区画は活性度の段では **1 バイトも触らない**（帳簿が無い案件は従来順。
+ *   強さの段は別に通る・下の「強さの段」）
  * - 活性度を知らないレコードは**末尾**へ、**元の並びのまま**（安定）
  * - 同じ活性度なら元の並び（日付降順 → タイトル昇順がそのまま残る）
  * - 用語集だけ（関係者の並びは `engagement.ts`・便 14b。Decisions と Rules は対象外）
  *
+ * ## 強さの段（#790・engine #727）
+ *
+ * 活性度で並べた**後に**、用語の強さ（場面の数 → 使った人の数 → 資料の下地の辞書式降順）を
+ * かぶせる（`rankByStrength`）。🔴 **engine の目次（`scripts/memory-index.mjs` の `termRows`）の写し**
+ * ——画面と目次で同じ語の順番が食い違うと「目次の上から N 件を AI に読ませる」構想（#544）の
+ * 土台が崩れるので、**目次と同じ並び**にする。一致は `glossary-activity-parity.test.mjs` の
+ * `[強さ]`（engine を実際に呼んで焼いた表）が見る。
+ * - 🔴 **帳簿の `state` が `"on"` のときだけ**（`readRederivationLedgers` がそれ以外を空にする）
+ * - 強さを持つ語が 1 件も無ければ活性度の並びのまま（帳簿が無い案件は 1 バイトも触らない）
+ * - 強さを知らない語は**末尾**へ、活性度の並びのまま。同点も活性度の並びのまま（安定）
+ * - 🔴 活性度の帳簿が無く強さだけある案件でも並べる（活性度の段が「何もしない」でも強さの段は飛ばさない）
+ *
  * ℹ️ `ledgers` と `statusOf` は**受け取り続ける**。`ledgers` は活性度のために要る。
  * `statusOf` は並びに使わなくなったが、**引数から落とすと「群分けを足し戻す」退行が
  * コンパイルで止まる代わりに、変異検証でそれを実演できなくなる**（`ledgers` と同じ流儀）。
@@ -512,6 +596,11 @@ function rederivedBandOf(recordPath, status, ledgers, nowShaOf, verdict, miss) {
 function orderByActivity(records, pathOf, statusOf, ledgers, nowIso) {
     if (!records.length)
         return records;
+    // 🔴 **強さの段は活性度の段の後に必ず通す**（活性度が 1 件も無い案件でも・上の「強さの段」）
+    return rankByStrength(rankByActivity(records, pathOf, ledgers, nowIso), pathOf, ledgers);
+}
+/** 活性度の段。活性度を持つ語が 1 件も無ければ**渡された配列をそのまま返す** */
+function rankByActivity(records, pathOf, ledgers, nowIso) {
     // この区画が並べ替えの対象か（用語集で、活性度の行が 1 件以上あるか）
     const scored = records.map((r, i) => {
         const p = pathOf(r);
@@ -537,6 +626,40 @@ function orderByActivity(records, pathOf, statusOf, ledgers, nowIso) {
     })
         .map((s) => s.r);
 }
+/**
+ * 強さの段（#790）。**engine `scripts/glossary/activity.mjs` の `rankByStrength` の写し**——鍵・同点・
+ * 「知らない」の扱いを 1 つでも変えると、画面と目次で同じ語の順番が割れる。
+ *
+ * - 強さを持つ語が 1 件も無ければ**渡された配列をそのまま返す**（`state` が on でない案件はここ）
+ * - 知らない語（帳簿に無い・用語集の区画の外）は末尾へ、渡された順のまま
+ * - 鍵は `[場面の数, 使った人の数, 下地]` の辞書式降順。同点は渡された順（＝活性度の並び・安定）
+ */
+function rankByStrength(records, pathOf, ledgers) {
+    if (!ledgers.strength.size)
+        return records;
+    const scored = records.map((r, i) => {
+        const p = pathOf(r);
+        return { r: r, i: i, s: ORDER_SECTION_RE.test(p) ? (ledgers.strength.get(p) ?? null) : null };
+    });
+    if (!scored.some((x) => x.s != null))
+        return records;
+    const key = (s) => [s.scenes, s.people, s.base ? 1 : 0];
+    return scored
+        .slice()
+        .sort((a, b) => {
+        if ((a.s == null) !== (b.s == null))
+            return a.s == null ? 1 : -1;
+        if (a.s != null && b.s != null) {
+            const ka = key(a.s);
+            const kb = key(b.s);
+            for (let k = 0; k < ka.length; k++)
+                if (ka[k] !== kb[k])
+                    return kb[k] - ka[k];
+        }
+        return a.i - b.i;
+    })
+        .map((x) => x.r);
+}
 /* ---------------------------------------------------------------------------
  * 決定の「その後」の帳簿（#705・engine #509 便 4）
  * ---------------------------------------------------------------------------

package/dist/render.js

@@ -4736,6 +4736,15 @@ button.site-icon[aria-busy="true"] .site-icon-plus { opacity: 0; }
 /* 戻す（ディープリンク）は「押すと何かが起きる」側なので塗る */
 .rederived-btn-back { background: #1d4ed8; color: #fff; }
 .rederived-btn-back:hover { background: #1e40af; color: #fff; }
+/* ---- ストーリー（#901 V2-5・日ごとのカード。新しい日が上）---- */
+.story-cards { display: flex; flex-direction: column; gap: 14px; }
+.story-card {
+  border: 1px solid var(--border); border-radius: var(--radius); padding: 14px 18px; background: var(--surface);
+}
+.story-card-heading { margin: 0 0 8px; font-size: 15px; }
+.story-card-edit { display: inline-block; margin-top: 8px; font-size: 12.5px; }
+.story-card .body h2 { font-size: 14px; margin: 14px 0 6px; }
+.story-card .body h3 { font-size: 13.5px; margin: 12px 0 6px; }
 /* ---- Home（案件の自己記述）---- */
 /* 未記入の警告。**画面でいちばん強い赤にする**——27案件中24案件が未記入のまま
    毎晩のAI生成が走っている状態で、控えめに出しても読まれない */
@@ -6207,6 +6216,11 @@ ${calendarAddUrl.toString()}
   (SITE.sections || []).forEach(function (sec) {
     TABS.push({ key: "dir:" + sec.name, label: dirLabel(sec.name), items: sec.records });
   });
+  // ストーリー（#901 V2-5）。区画の後・ナレッジグラフと操作の前。
+  // **build が載せた日があるときだけ**（帳簿で on の日のファイルが無い案件はキーごと無い＝タブも出ない）
+  if (SITE.story && SITE.story.length) {
+    TABS.push({ key: "story", label: "ストーリー" });
+  }
   if (SITE.graph && SITE.graph.nodes.length > 0) {
     TABS.push({ key: "graph", label: "ナレッジグラフ" });
   }
@@ -8321,6 +8335,9 @@ ${calendarAddUrl.toString()}
       "explorer": {
         text: "決定・用語・レポートを起点に、つながり（根拠・出典・リンク）を1列ずつ辿る表示です。行をクリックすると右に次の列が開きます。",
       },
+      "story": {
+        text: "このプロジェクトの日々の動きを、1日ずつまとめた記録です。直したいことや足したいことは、その日の「人の追記」に書けます。",
+      },
       "dir:レポート": {
         text: "レポートの生成は終了し、履歴として凍結されています（レポートはSlack配信に一本化されました）。以下は過去に生成されたレコードです。",
       },
@@ -8345,9 +8362,26 @@ ${calendarAddUrl.toString()}
     if (listState.tab === "decisions") { renderDecisionList(); return; }
     if (listState.tab === "graph") { renderKnowledge(); return; }
     if (listState.tab === "ops") { renderOps(); return; }
+    if (listState.tab === "story") { renderStory(); return; }
     renderGenericList();
   }
 
+  // ---------- ストーリー（#901 V2-5）----------
+  // 日ごとのカード（新しい日が上＝build が並べた順のまま）。本文は build の関所（marked → sanitize）を
+  // 通した HTML で、印のコメントと機械の語の行は build が除いてある。見出しは textContent で入れる
+  function renderStory() {
+    var list = el("div", { class: "story-cards" });
+    (SITE.story || []).forEach(function (d) {
+      list.appendChild(el("section", { class: "story-card" }, [
+        el("h3", { class: "story-card-heading", text: d.heading || d.date }),
+        d.bodyHtml ? el("div", { class: "body", html: d.bodyHtml }) : null,
+        // その日のファイルを GitHub で開く（表示の文字にファイル名を出さない）。URL が無い案件は出さない
+        d.editUrl ? el("a", { class: "story-card-edit", href: d.editUrl, target: "_blank", rel: "noopener", text: "GitHub で追記する" }) : null,
+      ]));
+    });
+    app.appendChild(list);
+  }
+
   // 導入経緯（overview.adoption）の表示情報。Home見出し横のチップに出すラベルだけを返す。
   function adoptionInfo(v) {
     // 3種とも同じ形（ラベルのみ）。導入前のDecisionの薄さの注記は出さない

package/dist/story.js

@@ -0,0 +1,245 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORY_MAX_FILE_BYTES = exports.STORY_EMPTY_LINE = exports.STORY_MAX_DAYS = exports.STORY_DAYS_DIR = exports.STORY_LEDGER_PATH = void 0;
+exports.parseStoryLedger = parseStoryLedger;
+exports.onDaysOf = onDaysOf;
+exports.storyDayMarkdown = storyDayMarkdown;
+exports.readStory = readStory;
+/**
+ * ストーリーのタブ（#901 記憶 v2・V2-5）。engine V2-3 が書く日々の動き
+ * （`Cortex/Story/Days/YYYY-MM/YYYY-MM-DD.md`）と帳簿（`.cortex/story-days.json`）を読み、画面に載せる日を組む。
+ *
+ * 形の正本は engine の `scripts/story/ledger.mjs`（帳簿・版 1）と `scripts/story/days.mjs`（`renderDayFile`・`lateBlockOf`）。
+ *
+ * ## 🔴 タブを出す条件（分類 B・`docs/product-decisions.md` 2026-09-28）
+ *
+ * 画面はストーリーの書き手の栓（engine の語彙の契約の名前）を読まない。🔴 栓の名前をこのファイルに書かない——
+ * tools の追跡ファイルに栓の名前が出ると、語彙の番人（`infra/test/observations-stack.test.ts`）が「tools が使う栓」と数える。
+ * だから **帳簿が読めて（版 1）、`days` に `mode === "on"` の日があり、
+ * その日のファイルが 1 枚以上ある** ときだけ載せる。shadow の夜は `Cortex/**` を 1 バイトも変えず帳簿だけ
+ * 書く（`mode: "shadow"`）ので、shadow の日しか無い案件ではタブも器も出さない（今までと 1 バイトも同じ画面）。
+ * 帳簿が無い・壊れている・ファイルが無い → `null`（壊れているときだけ build のログに 1 行）。
+ *
+ * ## 🔴 機械の語を画面に出さない
+ *
+ * 印の HTML コメント（`<!-- cortex-engine:story-day … -->`・`story-late`・その終わり）は捨てる。本文の行に
+ * `urn:`・ファイル名・`cortex-engine`・`sha=` が紛れていたら**行ごと伏せる**（本文は AI が書いた行なので、
+ * 語だけ消すと文が壊れる）。課題番号・コミットの ID は engine の門が落とすので重ねない（`MACHINE_WORD_RE`）。
+ * 人の追記には伏せ字を掛けない（落とすのは印の行だけ）。本文の Markdown は他の本文と同じ関所（marked → sanitize）を呼び手が通す。
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+exports.STORY_LEDGER_PATH = ".cortex/story-days.json";
+exports.STORY_DAYS_DIR = "Cortex/Story/Days";
+/** 載せる日の上限（新しい日から。分類 B・約 3 か月） */
+exports.STORY_MAX_DAYS = 90;
+const DAY_RE = /^\d{4}-\d{2}-\d{2}$/;
+const MONTH_RE = /^\d{4}-\d{2}$/;
+const HUMAN_HEADING = "## 人の追記";
+/** engine の印の行（始まり・終わり。属性は問わない）。画面には出さない */
+const STORY_MARKER_RE = /^<!--\s*\/?cortex-engine:story-(?:day|late)(?:\s[^\n]*?)?\s*-->$/;
+const LATE_BEGIN_RE = /^<!--\s*cortex-engine:story-late(?:\s[^\n]*?)?\s*-->$/;
+const LATE_END_RE = /^<!--\s*\/cortex-engine:story-late\s*-->$/;
+/**
+ * 画面に出さない機械の語。当たった行は**行ごと伏せる**（機械の行だけ。人の追記には掛けない）。
+ *
+ * 🔴 **明らかな機械の語だけ**: 印の残り（`<!--`・`-->`）・`urn:`・`cortex-engine`・`sha=`・ファイル名と置き場
+ * （`.md`・`Days/`・`story-days.json`・`.cortex/`）。課題番号（`#123`）・コミットの ID（16 進）・拡張子・パス・設定キーは
+ * **engine の門が行ごと落としてから書く**（`scripts/story/gates.mjs` の `MECHANISM_PATTERNS`・G-S3）ので、画面で重ねない。
+ * 重ねると、門を通った正当な行（`COVID-19`・`ISO-27001`・`A-1 案`）まで画面が黙って消す（実装レビュー 🟠1）
+ */
+const MACHINE_WORD_RE = /urn:|cortex-engine|sha=|<!--|-->|\.md\b|Days\/|story-days\.json|\.cortex\//;
+/** 見出しの行（`##`〜`######`） */
+const SUBHEADING_RE = /^#{2,6}\s/;
+/** 伏せて本文が空になった日の 1 行 */
+exports.STORY_EMPTY_LINE = "この日は表示できる行がありません。";
+/** 1 枚の上限（これを超えるファイルは読まない・分類 B。engine の 1 枚は 4 KiB ＋ 人の追記） */
+exports.STORY_MAX_FILE_BYTES = 64 * 1024;
+/** 帳簿を読む（投げない）。無い → `{ missing }`、壊れ・版違い → `{ broken }` */
+function parseStoryLedger(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+            return "broken";
+        const o = parsed;
+        if (o.version !== 1)
+            return "broken";
+        if (!o.days || typeof o.days !== "object" || Array.isArray(o.days))
+            return "broken";
+        return { days: o.days };
+    }
+    catch {
+        return "broken";
+    }
+}
+/** 帳簿で `mode: "on"` の日 */
+function onDaysOf(ledger) {
+    const out = new Set();
+    for (const [day, row] of Object.entries(ledger.days)) {
+        if (!DAY_RE.test(day) || !row || typeof row !== "object")
+            continue;
+        if (row.mode === "on")
+            out.add(day);
+    }
+    return out;
+}
+/** 曜日つきの見出し（`# 2026-09-24（木）`）の文字。無ければ日付だけ */
+function headingOf(lines, day) {
+    for (const l of lines) {
+        const m = l.match(/^#\s+(.+?)\s*$/);
+        if (m && m[1].startsWith(day) && !MACHINE_WORD_RE.test(m[1]))
+            return m[1];
+        if (l.trim() !== "")
+            break;
+    }
+    return day;
+}
+/** 中身の無い見出し（次の見出しか終わりまで空行しか無い）を落とす（伏せた結果「後から届いた記録」の見出しだけが残る、を防ぐ） */
+function withoutEmptySections(lines) {
+    return lines.filter((l, i) => {
+        if (!SUBHEADING_RE.test(l))
+            return true;
+        for (let j = i + 1; j < lines.length; j++) {
+            if (SUBHEADING_RE.test(lines[j]))
+                return false;
+            if (lines[j].trim() !== "")
+                return true;
+        }
+        return false;
+    });
+}
+/**
+ * Days 1 枚の本文を、画面に出す Markdown にする（純関数）。
+ *
+ * - 先頭の `# 日付（曜）` は見出しとして別に使うので本文から除く
+ * - 印の行は捨てる。`## 人の追記` の下（後から届いた記録の塊を除く）が空なら見出しごと出さない
+ * - 人の追記の後ろに足された「後から届いた記録」（人が機械の塊を直した日）は、人の追記より前に寄せる
+ * - 機械の語が紛れた行は行ごと伏せる（機械の行だけ）。中身の無い見出しは落とし、空になった日は 1 行の案内にする
+ */
+function storyDayMarkdown(content, day) {
+    const lines = String(content ?? "").replace(/^\ufeff/, "").split("\n").map((l) => l.replace(/\r$/, ""));
+    const heading = headingOf(lines, day);
+    // 先頭の `# ` 見出し（最初の空でない行だけ）を除く
+    const first = lines.findIndex((l) => l.trim() !== "");
+    const body = first >= 0 && /^#\s/.test(lines[first]) ? lines.slice(first + 1) : lines;
+    const at = body.findIndex((l) => l.trim() === HUMAN_HEADING);
+    const main = at < 0 ? body : body.slice(0, at);
+    const tail = at < 0 ? [] : body.slice(at + 1);
+    // 人の追記の後ろの塊（後から届いた記録）と人の行を分ける
+    const human = [];
+    const lateAfter = [];
+    let inLate = false;
+    for (const l of tail) {
+        const t = l.trim();
+        if (LATE_BEGIN_RE.test(t)) {
+            inLate = true;
+            lateAfter.push("");
+            continue;
+        }
+        if (inLate) {
+            if (LATE_END_RE.test(t)) {
+                inLate = false;
+                continue;
+            }
+            lateAfter.push(l);
+            continue;
+        }
+        human.push(l);
+    }
+    // 機械の行: 印と機械の語の行を伏せる
+    const clean = (ls) => ls.filter((l) => !STORY_MARKER_RE.test(l.trim()) && !MACHINE_WORD_RE.test(l));
+    // 🔴 人の追記: 落とすのは**印の行だけ**（人が書いた行を画面が黙って消さない・実装レビュー 🟠2）
+    const humanKept = human.filter((l) => !STORY_MARKER_RE.test(l.trim()));
+    const out = withoutEmptySections([...clean(main), ...clean(lateAfter)]);
+    if (humanKept.some((l) => l.trim() !== ""))
+        out.push("", HUMAN_HEADING, ...humanKept);
+    // 空行の続きを 1 行に・前後の空行を落とす
+    const md = out.join("\n").replace(/\n{3,}/g, "\n\n").trim();
+    // 伏せて空になった日は、見出しだけのカードにしない
+    return { heading: heading, markdown: md || exports.STORY_EMPTY_LINE };
+}
+/**
+ * 案件のストーリーを読む。**載せる日が無ければ `null`**（タブも器も出さない）。
+ *
+ * @param renderMarkdown 本文の関所（build の marked → sanitize）。ここでは HTML を作らない
+ */
+async function readStory(repoRoot, renderMarkdown, 
+// その日のファイルを GitHub で開く URL（リポジトリ相対パス → URL。リポジトリの URL が無い案件は null）
+editUrlOf = () => null) {
+    let text;
+    try {
+        text = await node_fs_1.promises.readFile(node_path_1.default.join(repoRoot, exports.STORY_LEDGER_PATH), "utf8");
+    }
+    catch (e) {
+        // 無いのが既定（ストーリーの書き手の栓を入れた案件だけが持つ）。無いことは警告しない
+        if (e?.code !== "ENOENT") {
+            console.warn(`story-days.json を読めませんでした（ストーリーは出さずに続けます）: ${String(e)}`);
+        }
+        return null;
+    }
+    // 空の帳簿（空文字・空白だけ）は engine と同じく「空」＝無いのと同じ（警告しない）
+    if (text.trim() === "")
+        return null;
+    const ledger = parseStoryLedger(text);
+    if (ledger === "broken") {
+        // 壊れ・版違いは 1 行残す（「夜間がまだ書いていない」と切り分けるため）
+        console.warn("story-days.json の形式か version が想定と違います（ストーリーは出さずに続けます）");
+        return null;
+    }
+    const on = onDaysOf(ledger);
+    if (!on.size)
+        return null;
+    const root = node_path_1.default.join(repoRoot, exports.STORY_DAYS_DIR);
+    let months;
+    try {
+        months = (await node_fs_1.promises.readdir(root, { withFileTypes: true })).filter((d) => d.isDirectory() && MONTH_RE.test(d.name)).map((d) => d.name);
+    }
+    catch {
+        return null;
+    }
+    const files = [];
+    for (const m of months) {
+        let names;
+        try {
+            names = await node_fs_1.promises.readdir(node_path_1.default.join(root, m));
+        }
+        catch {
+            continue;
+        }
+        for (const n of names) {
+            const day = n.endsWith(".md") ? n.slice(0, -3) : "";
+            // ファイル名が日付の形で、月の置き場と合い、帳簿で on の日だけ（README などは出さない）
+            if (!DAY_RE.test(day) || day.slice(0, 7) !== m || !on.has(day))
+                continue;
+            const abs = node_path_1.default.join(root, m, n);
+            // 🔴 通常のファイルだけ（リンクは辿らない）・1 枚の上限を超えるものは読まない（分類 B）
+            try {
+                const st = await node_fs_1.promises.lstat(abs);
+                if (!st.isFile() || st.size > exports.STORY_MAX_FILE_BYTES)
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            files.push({ day: day, abs: abs, rel: `${exports.STORY_DAYS_DIR}/${m}/${n}` });
+        }
+    }
+    files.sort((a, b) => (a.day < b.day ? 1 : a.day > b.day ? -1 : 0));
+    const out = [];
+    for (const f of files.slice(0, exports.STORY_MAX_DAYS)) {
+        let raw;
+        try {
+            raw = await node_fs_1.promises.readFile(f.abs, "utf8");
+        }
+        catch {
+            continue;
+        }
+        const { heading, markdown } = storyDayMarkdown(raw, f.day);
+        const editUrl = editUrlOf(f.rel);
+        out.push({ date: f.day, heading: heading, bodyHtml: await renderMarkdown(markdown), ...(editUrl ? { editUrl: editUrl } : {}) });
+    }
+    return out.length ? out : null;
+}

package/package.json

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