@takagaki/cortex-decisions-viewer 0.12.123 → 0.12.125

package/dist/build.js

@@ -118,6 +118,7 @@ const confirmed_1 = require("./confirmed");
 const minify_1 = require("./minify");
 const render_1 = require("./render");
 const ledger_dir_1 = require("./ledger-dir");
+const view_dir_1 = require("./view-dir");
 /**
  * この画面を作ったパッケージの版。**package.json を唯一の出どころにする。**
  * 別に持つと、公開した版と画面に出る版がずれる（しかも気づけない）。
@@ -732,12 +733,18 @@ function orderRecordsByLedgers(records, recordsDir, ctx, nowIso) {
  * 全部が人になるため。engine の人の手の表がビューアに届く段 5 で差し替える。
  * 取りこぼしの代償は「確認の一言が出ない」だけ（消せる範囲は変わらない）。
  *
+ * 記憶 v2 の案件で人の手の表の写し（`memory-hands`）が読めたときは、2 の確認の帳簿の代わりに表の `touched` を見る
+ * （cortex-engine #1094 鎖 3 V10b・B9a。確認の帳簿は記憶 v2 では書かれなくなる）。表が読めない晩は今の確認の帳簿に倒す。
+ *
  * @param p リポジトリルート相対の path（`Cortex/<区画>/records/…`）。帳簿の鍵は NFC なので NFC でも引く
  * @param status その記録の `rstatus`（`String()` 済み）
+ * @param hands 人の手の表（path → touched）。渡したときは確認の帳簿を見ない
  */
-function humanTouchedOf(p, status, confirmation) {
+function humanTouchedOf(p, status, confirmation, hands = null) {
     if ((0, confirmed_1.humanOwned)(p, status))
         return true;
+    if (hands)
+        return hands.get(p) === true || hands.get(p.normalize("NFC")) === true;
     const row = confirmation.get(p) ?? confirmation.get(p.normalize("NFC"));
     return !!row && row.deleted !== true;
 }
@@ -746,11 +753,11 @@ function humanTouchedOf(p, status, confirmation) {
  * （今の SiteData の形を保つ）。path は `repoRoot` 起点で作る（帳簿の鍵はリポジトリルート相対）。
  * 置き換えの逆引き（`attachSupersedes`）より前に呼ぶ。
  */
-function attachHumanTouched(records, recordsDir, repoRoot, confirmation) {
+function attachHumanTouched(records, recordsDir, repoRoot, confirmation, hands = null) {
     const recordsRel = path.relative(repoRoot, recordsDir).split(path.sep).join("/");
     for (const r of records) {
         const p = recordsRel ? `${recordsRel}/${r.fileName}` : r.fileName;
-        if (humanTouchedOf(p, r.rstatus, confirmation))
+        if (humanTouchedOf(p, r.rstatus, confirmation, hands))
             r.humanTouched = true;
     }
 }
@@ -2370,6 +2377,18 @@ async function externalizeBodies(site, outAbs) {
     }
 }
 async function build(opts) {
+    // 合わせの置き場（`--view-dir`）の一時フォルダは、ビルドが落ちても消す
+    const views = {};
+    try {
+        const r = await buildSite(opts, views);
+        return views.counts ? { ...r, viewCounts: views.counts } : r;
+    }
+    finally {
+        if (views.cleanup)
+            await views.cleanup();
+    }
+}
+async function buildSite(opts, views) {
     const dirAbs = await resolveDecisionsDir(opts.dir);
     const outAbs = path.resolve(opts.out);
     const exclude = new Set([...DEFAULT_EXCLUDE, ...opts.exclude].map((e) => e.toLowerCase()));
@@ -2399,7 +2418,22 @@ async function build(opts) {
     // 「リンクにしない」に倒れて全滅する**（以前は順序が逆だった）。
     const repoRoot = knowledgeRoot ? path.dirname(knowledgeRoot) : path.dirname(dirAbs);
     // 帳簿 10 本の置き場（既定は `<repoRoot>/.cortex`）。読み口はこの 1 つから読む
-    const ledgerDir = (0, ledger_dir_1.ledgerDirOf)(repoRoot, opts.ledgerDir);
+    let ledgerDir = (0, ledger_dir_1.ledgerDirOf)(repoRoot, opts.ledgerDir);
+    // 記憶 v2 の画面用ファイル（cortex-engine #1094 鎖 3 V10b）。checkout の HEAD とそろう封筒だけを差し替えた合わせの置き場を読む
+    // 合わせの置き場を作れなかった回（一時フォルダの失敗など）は今の帳簿の置き場のまま組む（取り出しの失敗で画面を止めない・数は出さない）
+    if (opts.viewDir) {
+        try {
+            const plan = await (0, view_dir_1.planViews)(path.resolve(opts.viewDir), (0, view_dir_1.checkoutGit)(repoRoot), ledgerDir);
+            const merged = await (0, view_dir_1.mergeLedgerDir)(ledgerDir, plan);
+            views.cleanup = merged.cleanup;
+            views.counts = plan.counts;
+            ledgerDir = merged.dir;
+            console.log((0, view_dir_1.viewCountsLine)(plan.counts));
+        }
+        catch (e) {
+            console.warn(`記憶 v2 の画面用ファイルを使えなかったので、今の帳簿から組みます: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
     const targetUrls = knowledgeRoot
         ? await buildTargetUrlMap(repoRoot, repo.baseUrl, repo.branch)
         : new Map();
@@ -2427,7 +2461,12 @@ async function build(opts) {
     // 目次と同じ順位（engine #551）。**読めないなら `null`** で、つながり画面の点は今までどおり一律
     const memoryRanking = await (0, ranking_1.readMemoryRanking)(repoRoot, ledgerDir);
     // 人の手の表の写し（engine #1094 q-10）。あれば記憶 v2 の案件で、確認の印とボタンを出さない。**無い案件は今と 1 バイトも同じ**（キーごと無い）
-    const memoryV2 = await (0, hands_1.readMemoryV2)(repoRoot, ledgerDir);
+    // 「記憶 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);
+    // 削除の確認の一言の材料（B9a）: 記憶 v2 の案件で表が読めたときは表、ほかは今の確認の帳簿
+    // （表が読めた案件は必ず記憶 v2 なので、表そのものを渡せばよい）
+    const touchedBy = memoryHands;
     // 記録の id → リポジトリルート相対のパス（順位のファイルの鍵と突き合わせる。`repoRoot` 起点・cwd 起点にしない）
     const recordRelPaths = new Map();
     const relOf = (dir, fileName) => {
@@ -2447,7 +2486,7 @@ async function build(opts) {
             rawDates.set(rec, rd);
     }
     // 人の手（削除の確認の文面を替える材料・cortex-engine #1094 段 4）。**置き換えより前に・repoRoot で**
-    attachHumanTouched(decisions, dirAbs, repoRoot, ledgers.confirmation);
+    attachHumanTouched(decisions, dirAbs, repoRoot, ledgers.confirmation, touchedBy);
     // 置き換えの逆引き（#699 F3）。**置き換えの無い案件では 1 件も付かない**
     attachSupersedes(decisions, (d) => rawDates.get(d) ?? d.fm.date, (d) => relOf(dirAbs, d.fileName));
     let home = null;
@@ -2490,7 +2529,7 @@ async function build(opts) {
             const recordsDir = path.join(knowledgeRoot, e.name, "records");
             const records = await loadGenericRecords(recordsDir, exclude, repo.baseUrl, repo.branch);
             // 人の手（削除の確認の文面を替える材料・cortex-engine #1094 段 4）
-            attachHumanTouched(records, recordsDir, repoRoot, ledgers.confirmation);
+            attachHumanTouched(records, recordsDir, repoRoot, ledgers.confirmation, touchedBy);
             // ルールの取り下げ（`retracted_by`・cortex-engine #1094 便 4-2d）。ルールの区画だけ・取り下げの無い案件では何も付かない
             if (e.name === "Rules")
                 attachRetractedBy(records, decisions, (d) => rawDates.get(d) ?? d.fm.date);

package/dist/cli.js

@@ -2,6 +2,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
+const promises_1 = require("node:fs/promises");
 const build_1 = require("./build");
 const program = new commander_1.Command();
 program
@@ -23,6 +24,10 @@ program
     .option("--webhook-url <url>", "Backlog Webhook 受信のLambda URL（環境変数 WEBHOOK_URL でも可）")
     .option("--webhook-token <token>", "リアルタイム同期の**案件別**トークン（環境変数 WEBHOOK_TOKEN でも可。艦隊共通トークンを渡さないこと）")
     .option("--ledger-dir <dir>", "ビューアが読む帳簿（.cortex の 10 本）の置き場（未指定なら <リポジトリルート>/.cortex）")
+    .option("--view-dir <dir>", "記憶 v2 の画面用ファイル（保管庫の gold/v1/c/view/ を取り出した手元のフォルダ）。checkout とそろう物だけ使い、ほかは帳簿の置き場から読む")
+    .option("--memory-v2-writer <state>", "栓 memory_v2_writer の値（off / shadow / on。on だけが記憶 v2 の案件）")
+    .option("--generated-at <text>", "生成時刻の表示（未指定ならビルドした時刻 \"YYYY-MM-DD HH:MM UTC\"。2 通りのビルドの突き合わせで揃える口）")
+    .option("--view-report <file>", "--view-dir の数（4 分類と目次に無い数）を JSON で書く先")
     .action(async (dir, opts) => {
     try {
         const result = await (0, build_1.build)({
@@ -32,7 +37,7 @@ program
             repoUrl: opts.repoUrl,
             branch: opts.branch,
             exclude: opts.exclude ?? [],
-            generatedAt: new Date().toISOString().replace("T", " ").slice(0, 16) + " UTC",
+            generatedAt: opts.generatedAt ?? new Date().toISOString().replace("T", " ").slice(0, 16) + " UTC",
             intakeUrl: opts.intakeUrl ?? process.env.INTAKE_URL,
             intakeToken: opts.intakeToken ?? process.env.INTAKE_TOKEN,
             projectKey: opts.projectKey,
@@ -40,7 +45,14 @@ program
             webhookUrl: opts.webhookUrl ?? process.env.WEBHOOK_URL,
             webhookToken: opts.webhookToken ?? process.env.WEBHOOK_TOKEN,
             ledgerDir: opts.ledgerDir,
+            viewDir: opts.viewDir,
+            memoryV2Writer: opts.memoryV2Writer,
         });
+        if (opts.viewReport) {
+            // 数だけ（名前・本文は書かない）。--view-dir を渡さなかった回は書かない
+            if (result.viewCounts)
+                await (0, promises_1.writeFile)(opts.viewReport, `${JSON.stringify(result.viewCounts)}\n`, "utf8");
+        }
         console.log(`✓ ${result.count} 件のレコードを ${result.outDir} にビルドしました`);
     }
     catch (err) {

package/dist/hands.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MEMORY_HANDS_VERSION = exports.MEMORY_HANDS_FILE = void 0;
 exports.isMemoryHandsCopy = isMemoryHandsCopy;
 exports.readMemoryV2 = readMemoryV2;
+exports.readMemoryHands = readMemoryHands;
+exports.isMemoryV2 = isMemoryV2;
 /**
  * 人の手の表の写し（`.cortex/memory-hands.json`）を読む（cortex-engine #1094 q-10・仕様 1-6）。
  *
@@ -38,15 +40,44 @@ function isMemoryHandsCopy(text) {
 }
 /** 案件リポに写しがあり、読める形か。無い → `false`（黙る）・壊れている → `false`（build のログに 1 行） */
 async function readMemoryV2(repoRoot, ledgerDir) {
+    return (await readMemoryHands(repoRoot, ledgerDir)) !== null;
+}
+/**
+ * 人の手の表の写しの中身（記録の path → 人の手があるか `touched`）。無い・読めない → `null`（壊れているときだけ build のログに 1 行）。
+ * 鍵は engine が綴った path（リポジトリルート相対・NFC）。値の欄は `touched` だけを持つ（素通しはしない）
+ */
+async function readMemoryHands(repoRoot, ledgerDir) {
     let text;
     try {
         text = await promises_1.default.readFile(node_path_1.default.join((0, ledger_dir_1.ledgerDirOf)(repoRoot, ledgerDir), exports.MEMORY_HANDS_FILE), "utf8");
     }
     catch {
-        return false;
+        return null;
     }
-    const ok = isMemoryHandsCopy(text);
-    if (!ok)
+    if (!isMemoryHandsCopy(text)) {
         console.warn(`${exports.MEMORY_HANDS_FILE}: 読めないので、この案件は記憶 v2 でないものとして出します`);
-    return ok;
+        return null;
+    }
+    const records = JSON.parse(text).records;
+    const out = new Map();
+    for (const [p, v] of Object.entries(records)) {
+        const row = v && typeof v === "object" && !Array.isArray(v) ? v : null;
+        // 🔴 厳密に true のときだけ（"true" や 1 を人の手と読まない）
+        out.set(p, !!row && row.touched === true);
+    }
+    return out;
+}
+/** 1 本の栓 `memory_v2_writer` の値の語彙（engine `scripts/observe/rollout.mjs` の `ROLLOUT_STATES`） */
+const WRITER_STATES = new Set(["off", "shadow", "on"]);
+/**
+ * この案件は記憶 v2 か（cortex-engine #1094 鎖 3 V10b・確定版 3 章 4）。**1 本の栓 `memory_v2_writer` の値で決める**
+ * （workflow が SSM の値を `--memory-v2-writer` で渡す・`on` だけが v2。`shadow` は `off` に潰す＝engine と同じ）。
+ * 橋の間（V11b まで）は、人の手の表の写しがあることとの OR（受け口 `infra/lambda/intake/logic.mjs` の `memoryV2GateOf` と同じ OR）。
+ * 渡されない・語彙外の値は「栓は on でない」と読む（写しがあれば v2・今と同じ）
+ */
+function isMemoryV2(writer, handsCopy) {
+    const w = typeof writer === "string" ? writer.trim() : "";
+    if (w && !WRITER_STATES.has(w))
+        console.warn(`--memory-v2-writer の値が語彙の外です（off として読みます）: ${JSON.stringify(w.slice(0, 20))}`);
+    return w === "on" || handsCopy;
 }

package/dist/render.js

@@ -5487,7 +5487,6 @@ a.ds-name:hover { text-decoration: underline; }
   border: 1px solid #f0b429; background: #fffdf5; border-radius: 12px;
   padding: 12px 16px; display: flex; flex-direction: column; gap: 8px;
 }
-.ds-orgnote.is-resolved { border-color: transparent; background: transparent; padding: 0; }
 .ds-orgnote-title { font-weight: 700; font-size: 13.5px; color: #8a5a00; }
 /* 案内が指す行。**囲うことで「どのチャンネルの話か」を示す**（開閉はしない） */
 .ds-orgnote-rows { display: flex; flex-direction: column; gap: 8px; margin-top: 2px; }
@@ -5755,10 +5754,6 @@ a.ds-tile:hover { text-decoration: none; }
    とは別物で、同じ色にすると「押して繋ぎましょう」と読まれる */
 .ds-gate-off { color: #9ca3af; }
 .ds-pipes { display: flex; flex-direction: column; gap: 8px; }
-/* GitHub App のインストールへのリンク。**独立した「組織ごとの接続状況」の節は
-   2026-08-20 に廃止した**（行のラベル＋必要な行だけ囲う形へ）が、
-   このクラスだけは案内と手順の両方で使い続けている */
-.ds-owner-install { font-size: 12.5px; white-space: nowrap; }
 /* 実行状況の行に直し方を添える。同じ run の未達を別の節にも出すと画面に2回並ぶ */
 .ds-pipe-wrap { display: flex; flex-direction: column; gap: 3px; }
 .ds-pipe-todo { font-size: 12.5px; color: var(--muted); line-height: 1.7; padding-left: 4px; }
@@ -9927,7 +9922,7 @@ ${calendarAddUrl.toString()}
      * 行と能力タイルが「トークン未設定」と言う**状態を作らないこと。
      *
      * **help は付けない。** 次の一手（インストール導線）は組織ごとの案内
-     * （githubNotConnectedNodes）が1つだけ持つ。行ごとに繰り返すと一覧が案内で埋まる。
+     * （githubRowHelpParts）が行ごとに持つ（#1233・帯は撤去した）。
      * ----------------------------------------------------------------------- */
     github: {
       text: "App が未インストール",
@@ -9952,13 +9947,13 @@ ${calendarAddUrl.toString()}
    * 休止状態の行に、状態の語に添えて**押す前から**出す定型の補足（#346）と、
    * 「接続を確認」を押した結果に添える定型の1文（#356）。
    * 鍵は「アダプタ種別（helpTypeOf）× 状態」。値は { resting, probed } で、どちらも文の
-   * パーツの配列。文字列はテキスト、{ link: <リンクの文字列> } は GitHub App の
-   * インストール設定へのリンク（GITHUB_APP_INSTALL_URL）。
+   * パーツの配列。文字列はテキスト、{ link, kind } は GitHub App の
+   * リンク（githubAppLinkUrl(kind) が宛先を作る）。
    *
    * ## 文の長さ（#356・オーナー却下を受けた原則）
    * **帯は症状だけ・行は具体的な一手だけ・説明を繰り返さない。** 0.12.22 では帯と行と
    * 押した結果に同じ admin の4文が3回出ており、オーナーが「長すぎ・冗長」と却下した。
-   *   - resting … **1文＋リンクだけ**（誰が・どこで。「何が起きているか」は帯が言う）
+   *   - resting … **1文＋リンクだけ**（誰が・どこで。「何が起きているか」は状態の札が言う）
    *   - probed  … **状態に応じた1文だけ**（1行目のサーバの needed が言わないことだけ）。
    *     押した結果に resting を繰り返さない——resting は押した瞬間に隠れ、needed が
    *     同じ操作（Configure から追加）を宛先つきで言う
@@ -9976,7 +9971,7 @@ ${calendarAddUrl.toString()}
    * 🔴 **DS_GATE[状態] が help を持つ状態にはエントリを置かない。** 置くと行の補足が2段になる
    * （github-state-reason.test.mjs の「行の補足は最大1段」が見張る）。
    *
-   * 🔴 **URL を文字列で書き写さない**（帯・押した結果と同じ定数を使う。写経すると張り替えで
+   * 🔴 **URL を文字列で書き写さない**（押した結果と同じ定数を使う。写経すると張り替えで
    * 片方だけ古くなる）。
    *
    * エントリがある状態では**この文だけ**を出し、サーバの needed / detail は出さない
@@ -9990,19 +9985,19 @@ ${calendarAddUrl.toString()}
    */
   var DS_GATE_RESTING_HELP = {
     github: {
+      // 🔴 **読めない行の中に、理由に合った一手だけを出す（#1233）。** 全体の帯は撤去した。
+      // 一手は組織の App の導入状況（githubRowHelpParts）で決まるので、関数で持つ
       unreachable: {
-        // 誰が（admin）・どこで（Configure の Repository access）だけ。理由は帯、宛先はリンクが持つ。
-        // 着地点（Repository access）を名指しするのは、押す前の画面からこの語が消えないため
-        //（設計レビュー②）。「admin が…してください」はオーナーの原文の形
-        resting: [
-          "このリポジトリの admin（管理者権限を持つ人）が、Configure の Repository access に追加してください。",
-          { link: "インストール設定を開く" },
-        ],
+        resting: function (row) { return githubRowHelpParts(row); },
         // 2026-09-02 の実測: admin でないリポジトリを Configure で選ぶと「request」タグが付き、
         // 組織オーナーの承認待ちになる（"Okay, updated" と出るのに対象に入らない）。
         // 1行目（サーバの needed）はこれを言わないので、ここだけが持つ
         probed: ["GitHub 側で request と表示された場合は、組織オーナーの承認待ちです。"],
       },
+      // App が組織に入っていない行（鍵が 1 本も無かった）。帯を撤去したので、この行が一手を持つ
+      no_token: {
+        resting: function (row) { return githubRowHelpParts(row); },
+      },
     },
   };
   /**
@@ -10019,9 +10014,32 @@ ${calendarAddUrl.toString()}
     return (byType && byType[gate]) || null;
   }
   /** 休止状態の行に出すパーツ（無ければ null） */
-  function restingHelpPartsOf(type, gate) {
+  function restingHelpPartsOf(type, gate, row) {
     var e = restingHelpEntryOf(type, gate);
-    return (e && e.resting) || null;
+    var r = e && e.resting;
+    return (typeof r === "function" ? r(row) : r) || null;
+  }
+  /**
+   * GitHub の読めない行に出す一手（#1233）。**組織の App の導入状況で理由に合わせる**。
+   * 窓口の断りの名前（installation_not_found 等）は行まで届いていないので、同じ分かれ目の
+   * 「appInstalled」 を使う（true＝App は入っている＝このリポジトリが選ばれていない）。
+   *
+   *   - no_token（鍵が 1 本も無い）／appInstalled が false・不明 → 「App を入れてください」（広い方）
+   *   - unreachable で appInstalled が true → 「このリポジトリを選んでください」
+   *
+   * 出さないもの: テナント外の断り（#841・導入の有無を明かさない）と、確かめられなかった
+   * 組織（source: "unknown"・帯が導線を出さない設計）
+   */
+  function githubRowHelpParts(row) {
+    if (!row) return null;
+    if (githubOrgRefused(row)) return null;
+    var owner = String(row.ref || "").split("/")[0];
+    var meta = owner ? githubOwnerMeta(owner) : null;
+    if (meta && meta.source === "unknown") return null;
+    if (row.gate === "unreachable" && meta && meta.appInstalled === true) {
+      return ["GitHub App の設定で、このリポジトリを選んでください。", { link: "インストール設定を開く →", kind: "settings" }];
+    }
+    return ["この組織に Cortex の GitHub App を入れてください。", { link: "GitHub App を入れる →", kind: "install" }];
   }
   /** 押した結果に添えるパーツ（無ければ null）。行と同じ表から引く（写経しない） */
   function probedHelpPartsOf(type, gate) {
@@ -10033,7 +10051,7 @@ ${calendarAddUrl.toString()}
     var p = el("p", { class: cls });
     parts.forEach(function (part) {
       if (typeof part === "string") p.appendChild(document.createTextNode(part));
-      else if (part && part.link) p.appendChild(el("a", { href: GITHUB_APP_INSTALL_URL, target: "_blank", rel: "noopener", text: part.link }));
+      else if (part && part.link) p.appendChild(el("a", { href: githubAppLinkUrl(part.kind), target: "_blank", rel: "noopener", text: part.link }));
     });
     return p;
   }
@@ -10088,16 +10106,18 @@ ${calendarAddUrl.toString()}
    *   - 状態がある（未測定の行には出すものが無い）
    *   - ok でない
    *   - missing_scope でない（スコープ名の札 .ds-probe-scope が既に持つ）
-   *   - no_token でない（GitHub は組織の帯が導線を1つだけ持つ設計・Slack は DS_GATE_NO_TOKEN の help）。
-   *     **ただし GitHub のテナント外の断り（#841）は出す**——帯は出ない（導入状態が分からない）ので、
-   *     「担当者へ」の 1 文（needed）を持つのはこの行だけ
+   *   - no_token でない（Slack は DS_GATE_NO_TOKEN の help）。
+   *     **GitHub の no_token は出す**（#1233・帯を撤去したので行が一手を持つ。
+   *     テナント外の断り（#841）は「担当者へ」の 1 文（needed））
    *   - not_in_channel でない（help は無いが、**状態の語そのものが操作の指示**
    *     「Slackで招待してください」。その下に夜間の「読めませんでした: not_in_channel」を
    *     並べても情報が増えず、招待という具体的な指示を薄める。help の有無とは別の軸）
    *   - dsGateOf(s).help が無い（あれば DS_GATE の固定文が次の一手を持っている）
    */
   function showsRestingReason(s) {
-    if (s.gate === "no_token" && String(s.type || "").indexOf("github") === 0 && githubOrgRefused(s)) return true;
+    // GitHub の no_token は常に出す（#1233・帯を撤去したので、行が一手を持つ）。
+    // 非テナント外は githubRowHelpParts の一手、テナント外の断り（#841）はサーバの needed の 1 文
+    if (s.gate === "no_token" && String(s.type || "").indexOf("github") === 0) return true;
     if (!s.gate || s.gate === "ok" || s.gate === "missing_scope" || s.gate === "no_token" || s.gate === "not_in_channel") return false;
     return !dsGateOf(s).help;
   }
@@ -10985,26 +11005,13 @@ ${calendarAddUrl.toString()}
         var again = !!(x.ref && seenRef[x.ref]);
         if (x.ref) seenRef[x.ref] = 1;
         var rowCard = extSourceCard(x, DS_TYPE[x.type] || { icon: "🔗", label: x.type || "その他" }, { quietHelp: again });
-        // 同じリポの issues / discussions を、接続確認の結果で揃えるための目印（updateGithubOrgBand）
+        // 同じリポの issues / discussions を、接続確認の結果で揃えるための目印（syncGithubSiblingRows）
         if (rowCard && rowCard.setAttribute && x.ref) rowCard.setAttribute("data-ref", x.ref);
         return rowCard;
       });
-      if (g.state === "warn") {
-        var warnBox = orgNoteBox(githubNotConnectedNodes(g), cards);
-        // 「接続を確認」が通ったとき帯をその場で畳めるよう、いま読めていないリポの一覧を持たせる
-        //（probeSection → updateGithubOrgBand）。同じリポの issues / discussions は 1 本と数える
-        var unreadRefs = [];
-        g.items.forEach(function (x) {
-          if (x.ref && x.gate && x.gate !== "ok" && unreadRefs.indexOf(x.ref) < 0) unreadRefs.push(x.ref);
-        });
-        warnBox.setAttribute("data-unread-refs", JSON.stringify(unreadRefs));
-        // 見出しの件数は夜間の値のことがある（画面の行数と違う）。初期値を持ち、増減だけ当てる
-        var titleEl = warnBox.querySelector(":scope > .ds-orgnote-title");
-        var m0 = titleEl ? /^⚠️ (\\d+)件のリポジトリを読み取れていません/.exec(titleEl.textContent || "") : null;
-        if (m0) warnBox.setAttribute("data-unread-count", m0[1]);
-        out.push(warnBox);
-        return;
-      }
+      // 🔴 **読めない組織を箱で囲まない（#1233）。** 読めないリポジトリが 1 件あるだけで、
+      // 並んでいる全部のタイルが黄色の枠に入っていた。エラーは読めない行の中だけに出す
+      //（理由に合った一手は extSourceCard の githubRowHelpParts）。
       if (g.state === "unsure") {
         // **確かめられなかった夜は、そう言う。** gh の不在・タイムアウト・
         // ネットワーク断で起きる。「接続OK」と出すと同じ画面の集計と食い違い、
@@ -11019,28 +11026,17 @@ ${calendarAddUrl.toString()}
   }
 
   /**
-   * 「接続を確認」の結果を、行が属する組織の帯へ反映する。
+   * 「接続を確認」の結果を、同じリポジトリの兄弟の行（issues / discussions）へそろえる。
    *
-   * 読めた行を帯の「読めていないリポ」から外し、**最後の 1 本だったら帯を畳む**。
-   * まだ読めない行が残るなら帯は残し、見出しの件数だけ減らす。読めなかった結果は
-   * 帯に戻す（読めていた行が後から読めなくなった場合も、帯が嘘をつかない）。
-   * 帯が無い行（組織が繋がっている）では何もしない。
+   * 帯は撤去した（#1233）。残すのは「行は 2 本でも接続は 1 つ」なので押した行と同じ判定に
+   * そろえる仕事だけ。**条件なしで毎回そろえる**（帯の有無・状態の変化に依らない）。
+   * 兄弟は同じ親（一覧・確かめられなかった組織の箱）の直下にいる。
    */
-  function updateGithubOrgBand(card, ref, ok) {
-    var box = card.closest ? card.closest(".ds-orgnote") : null;
-    if (!box || !ref) return;
-    var raw = box.getAttribute("data-unread-refs");
-    if (raw == null) return;
-    var refs;
-    try { refs = JSON.parse(raw) || []; } catch (e) { return; }
-    var at = refs.indexOf(ref);
-    if (ok && at >= 0) refs.splice(at, 1);
-    else if (!ok && at < 0) refs.push(ref);
-    else return;
-    box.setAttribute("data-unread-refs", JSON.stringify(refs));
-    // 同じリポの兄弟の行（issues / discussions）も、押した行と同じ判定に揃える
+  function syncGithubSiblingRows(card, ref, ok) {
+    var parent = card.parentNode;
+    if (!parent || !ref) return;
     var gateSrc = card.querySelector(".ds-gate");
-    var sibs = box.querySelectorAll(".ds-card[data-ref]");
+    var sibs = parent.querySelectorAll(":scope > .ds-card[data-ref]");
     for (var si = 0; gateSrc && si < sibs.length; si++) {
       var sib = sibs[si];
       if (sib === card || sib.getAttribute("data-ref") !== ref) continue;
@@ -11049,31 +11045,6 @@ ${calendarAddUrl.toString()}
       var sh = sib.querySelectorAll(".ds-gate-help");
       for (var hi = 0; hi < sh.length; hi++) sh[hi].hidden = ok;
     }
-    var title = box.querySelector(":scope > .ds-orgnote-title");
-    var cnt = parseInt(box.getAttribute("data-unread-count"), 10);
-    if (!isNaN(cnt)) {
-      cnt = Math.max(0, cnt + (ok ? -1 : 1));
-      box.setAttribute("data-unread-count", String(cnt));
-    }
-    var hasBand = !!title;
-    if (!hasBand) return;
-    if (refs.length === 0) {
-      // 帯だけを隠す。行（.ds-orgnote-rows）は残す
-      for (var i = 0; i < box.children.length; i++) {
-        var c = box.children[i];
-        if (c.classList.contains("ds-orgnote-rows")) continue;
-        c.hidden = true;
-      }
-      box.classList.add("is-resolved");
-      return;
-    }
-    for (var k = 0; k < box.children.length; k++) {
-      var ch = box.children[k];
-      if (!ch.classList.contains("ds-orgnote-rows")) ch.hidden = false;
-    }
-    box.classList.remove("is-resolved");
-    // 見出しが件数を持つ形（「N件のリポジトリを読み取れていません」）だけ数え直す
-    if (!isNaN(cnt)) title.textContent = "⚠️ " + Math.max(1, cnt) + "件のリポジトリを読み取れていません";
   }
 
   /** 確かめられなかった組織の案内。**導線は出さない** */
@@ -11092,111 +11063,6 @@ ${calendarAddUrl.toString()}
     ];
   }
 
-  /**
-   * 繋がっていない組織の案内。
-   *
-   * **「読めない」の原因は1つではない。** 以前はどの組織にも
-   * 「この組織に Cortex の GitHub App を入れると読めるようになります」と出していたが、
-   * **App は入っているのにそのリポジトリが選ばれていない**組織にはこれが効かない。
-   * インストールは済んでいるので、押しても画面は変わらず、何度押しても直らない。
-   *
-   * 「appInstalled」 が原因を分ける（engine がインストールトークンを取れたかどうか）:
-   *
-   * | 値 | 意味 | 案内 |
-   * |---|---|---|
-   * | 「false」 | App のトークンが取れなかった＝未インストール | インストールへ |
-   * | 「true」  | 取れたのに読めない＝そのリポジトリが未選択 | **インストール設定**へ |
-   * | 「null」  | その夜は確かめられなかった | **どちらも出さない**（押しても直るとは限らない） |
-   *
-   * **自社か顧客かで文言を分けない。** 組織名（「classmethod-*」）で分岐すると、
-   * 新しい自社組織が増えたときに黙って間違った案内を出す。どちらにも通じる文にする。
-   */
-  function githubNotConnectedNodes(g) {
-    var out = [];
-    var o = g.meta || {};
-    // **件数はグループが数えたものを優先する（工程1.5）。** まとめ表の 「repos」 /
-    // 「unreadable」 は夜間の値で、いま画面に出ている行の数と食い違うことがある
-    //（#101 で3度直した形）。「groupGithubByOwner」 は**いま並んでいる行**を数えている
-    var repos = o.repos != null ? o.repos : g.repos != null ? g.repos : g.items.length;
-    var unread = o.unreadable != null ? o.unreadable : g.unread != null ? g.unread : g.items.length;
-    var installed = o.appInstalled;
-    // **読める件数を出す。** 総数だけ出すと、同じ画面の集計と食い違う（#101 で3度直した形）
-    var head = repos + "リポジトリ中 " + unread + "件が読めていません。";
-    // 🔴 **見出しは 「installed」 の分岐の中で出す（#346）。** ここで1つに畳んでいたので、
-    // App 導入済みの組織にも「まだ接続されていません」と出て、**同じ帯の本文と矛盾**した
-    // （実機でオーナーが踏み、利用者が「組織の接続からやり直し」と誤解した）
-    if (installed === true) {
-      // 🔴 **帯は症状だけ（#356・オーナー却下を受けた原則）。** 0.12.22 ではここに9文
-      // （App の説明・Configure の手順・admin の4文・移動改名削除・お客様の組織）を入れ、
-      // 同じ説明が行と押した結果にも出て3回繰り返された。見出しは件数だけ・本文は2文だけ。
-      // **組織名は見出しに入れない**——各行のバッジ「{組織}（GitHub App）」が持っている。
-      // 組織が複数ある画面でも、組織ごとの帯のまま・見出しは同じ形。
-      //
-      // **見出しでは「読み取り対象に選ばれていません」と言い切らない。** 「appInstalled」 が
-      // 分けられるのは「①未インストール」と「②未選択／③消えた・改名」までで、**②と③は
-      // 分かれない**（App のトークンではどちらも 404）。見出しは事実だけを言う
-      out.push(el("div", {
-        class: "ds-orgnote-title",
-        text: "⚠️ " + unread + "件のリポジトリを読み取れていません",
-      }));
-      // App は入っている。**インストールをもう一度促さないこと**——済んでいる操作を促すのは
-      // 「設定する必要が無いものに設定を促す」偽の警告と同じで、しかも直らない。
-      //
-      // 「誰が・どこで」は各行の1文（DS_GATE_RESTING_HELP）が持つ。ここで繰り返さない。
-      // 「移動・改名・削除の可能性 → 登録から外して」も言わない——②と③を区別する材料が
-      // 無く、外す手段は行の「登録から削除」（#354）が常に持つ。
-      // 「お客様の組織では、組織のオーナーに承認を依頼」も外した——request（承認待ち）の
-      // 1文は押した結果が持つ（同じ表の probed）。
-      //
-      // ⚠ **件数の文 「head」（「{N}リポジトリ中 {M}件が読めていません。」）もこの枝では
-      // 出さない（#356）。** #101 で3度直した「読める件数を出す」を意図して覆した——見出しが
-      // 件数を持つので、本文で二重に言うと帯が3文になる。分母（登録数）は画面から消えるが、
-      // 箱の中に行が全部並んでいるので数えられる。false / null の枝は従来どおり head を出す。
-      //
-      // **「各行の案内」ではなく「アクセス不可の行の案内」と言う。** 帯の箱には読めている行も
-      // 一緒に入る（unread が1件でもあれば組織ごと warn）。案内を持つのは「アクセス不可」の
-      // 行だけなので、行に出ている状態の語そのもので指す（設計レビュー②の指摘）。
-      //
-      // **「読み取り対象に入っていません」はオーナーの文（#356）。** 2026-08-21 の
-      // 「②未選択と③消えた・改名を区別できないので断定しない」は、帯の本文については
-      // この文で覆した（見出しは引き続き断定しない）。③の逃げ道は「登録から削除」。
-      //
-      // **設定画面の宛先は App 個別ページ（#346）。** いまの宛先と、そこに着ける人の条件は
-      // 「appSettingsLink」 の項にある
-      out.push(el("p", {
-        class: "ds-group-note",
-        text: "GitHub App の読み取り対象に入っていません。アクセス不可の行の案内に従って追加してください。",
-      }));
-      out.push(appSettingsLink("インストール設定を開く →"));
-      return out;
-    }
-    if (installed === false) {
-      out.push(el("div", { class: "ds-orgnote-title", text: "⚠️ " + g.title + " はまだ接続されていません" }));
-      out.push(el("p", {
-        class: "ds-group-note",
-        text: head + "この組織に Cortex の GitHub App を入れると読めるようになります（Issues の読み取りだけ）。"
-          + "お客様の組織では、組織のオーナーに承認を依頼してください。",
-      }));
-      out.push(appInstallLink("この組織にインストール →"));
-      return out;
-    }
-    // 「null」（確かめられなかった）と、この値を知らない古い fleet-status.json。
-    // **導線を出さない。** どちらが原因か分からないので、押させると外れたほうを
-    // 押させることになる（済んでいるインストールをもう一度、あるいは効かない設定画面へ）。
-    //
-    // 見出しは件数を言わない（件数は本文だけが持つ・見出しと二重に言わない）。
-    // 「githubUnsureNodes」 の「接続を確認できませんでした」（＝その夜、確かめる処理自体が
-    // 走らなかった）とは意味が違う——こちらは**読めなかった事実はあるが、App の導入状況が
-    // 分からない**ので、語を分ける
-    out.push(el("div", { class: "ds-orgnote-title", text: "⚠️ " + g.title + " のリポジトリが読めていません（原因は確かめられていません）" }));
-    out.push(el("p", {
-      class: "ds-group-note",
-      text: head + "原因（GitHub App が入っていない／入っているがこれらのリポジトリが選ばれていない）は、"
-        + "今回の実行では確かめられませんでした。翌朝の表示をご確認ください。",
-    }));
-    return out;
-  }
-
   /**
    * Slack のチャンネルを**平らに**並べる（2026-08-20）。
    *
@@ -11398,38 +11264,14 @@ ${calendarAddUrl.toString()}
   var GITHUB_APP_INSTALL_URL = "https://github.com/apps/classmethod-cortex-reader/installations/new";
 
   /**
-   * GitHub App のインストールへ行くリンク（2026-08-20 に部品化）。
-   *
-   * **同じものを2箇所に書かない。** 組織ごとの案内と、追加フォームの手順が
-   * 同じ導線を持つ（#138 で「1箇所にしか無い」ことが事故になったので、
-   * **むしろ複数あるのが正しい**）。写経すると、URLの張り替えで片方だけ古くなる。
-   *
-   * **正本は手順の側。** 組織ごとの案内は行が無いと出ないので、
-   * 行0件の案件では手順側しか残らない。
-   *
-   * **⚠️ ただし手順は追加フォームの中にあり、追加フォームは
-   * SITE.intake が無いと丸ごと消える**（renderExternalAdders の冒頭）。
-   * つまり **intake 無し＋行0件** の案件では App の導線が1本も無くなる。
-   * いまは config.ts の intakeUrl が艦隊で1つ・全案件に渡っているので
-   * その組み合わせは起きない（2026-08-20 に確認）。
-   * **案件ごとに intake を出し分けるようになったら、ここを見直すこと。**
-   */
-  function appInstallLink(label) {
-    return el("a", {
-      class: "ds-owner-install",
-      href: GITHUB_APP_INSTALL_URL,
-      target: "_blank", rel: "noopener",
-      text: label || "GitHub App を入れる →",
-    });
-  }
-
-  /**
-   * すでに入っている App の**インストール設定**（対象リポジトリの追加）へ行くリンク。
+   * GitHub App の宛先 URL の作り手（入れる／インストール設定）。
+   * すでに入っている App の**インストール設定**（対象リポジトリの追加）へ行くリンクの宛先でもある。
    *
    * **宛先は App 個別ページ（「GITHUB_APP_INSTALL_URL」 と同じ定数・#346）。**
    * 「infra/lambda/shared/github-gate.mjs」 の 「githubConfigureUrl」 とも同じ宛先なので、
-   * **押す前（この帯・行の補足）と押した後（確認結果の文中）でリンク先が割れない**。
-   * 関数は残してある——呼び手が「入れる」ではなく「設定を開く」意図で呼ぶ場所だから。
+   * **押す前（行の一手）と押した後（確認結果の文中）でリンク先が割れない**。
+   * 「kind」（install / settings）は意図を渡すための引数で、いまは宛先が同じ。会社ごとの App
+   *（classmethod-cortex-portal #254）で割れる日に、ここだけを直す。
    *
    * ## なぜ他の2つの宛先を使わないか
    *
@@ -11453,13 +11295,11 @@ ${calendarAddUrl.toString()}
    * **GitHub 側の画面が変わったらここが最初に嘘になる。** 宛先を変えるときは
    * 「githubConfigureUrl」（サーバ）と揃えること。
    */
-  function appSettingsLink(label) {
-    return el("a", {
-      class: "ds-owner-install",
-      href: GITHUB_APP_INSTALL_URL,
-      target: "_blank", rel: "noopener",
-      text: label || "インストール設定を開く →",
-    });
+  function githubAppLinkUrl(kind) {
+    // 「kind」: "install"（組織に App を入れる）／"settings"（入っている App の対象リポジトリを選ぶ）。
+    // いまは同じ宛先（App 個別ページ）。会社ごとの App（classmethod-cortex-portal #254）が動くと
+    // 宛先が変わるので、**行の案内のリンクは全部ここを通す**（URL を 1 か所から作る）
+    return ({ install: GITHUB_APP_INSTALL_URL, settings: GITHUB_APP_INSTALL_URL })[kind] || GITHUB_APP_INSTALL_URL;
   }
 
   /**
@@ -14316,9 +14156,8 @@ ${calendarAddUrl.toString()}
         // 再読み込みまで）で、「接続を確認 → 閉じる → その場で接続OK」にならない。
         // 据え置きあり＝GitHub は叩かない（ストアの行は据え置きの対象外で毎回引く）。
         // 取り込む能力の即答（appendDispatchProbe）は先に同じ 1 行を持っている
-        // 組織の帯も同じ結果で描き直す（読めた最後の 1 本なら帯が消える）。
-        // 帯はページ描画時に 1 度だけ組むので、ここで触らないと再読み込みまで残る
-        if (probeTypeOf(s.type) === "github") updateGithubOrgBand(card, s.ref, j.gate === "ok");
+        // 同じリポジトリの兄弟の行（issues / discussions）も同じ判定にそろえる
+        if (probeTypeOf(s.type) === "github") syncGithubSiblingRows(card, s.ref, j.gate === "ok");
         reloadLiveState();
       } catch (e) {
         msg.className = "ds-toggle-msg is-error";
@@ -14334,11 +14173,10 @@ ${calendarAddUrl.toString()}
       label: "登録を解除",
       confirmLines: function () {
         return [
-          "「" + (s.name || s.ref) + "」を、Gold 昇格の読み取り対象から外します。",
+          "「" + (s.name || s.ref) + "」を、読み取り対象から外します。",
           "",
-          "次回の Gold 昇格（毎晩22時ごろ）から、このチャンネルは読み取られなくなります。",
-          "",
-          "※ 既に Gold 層に入った内容は消えません（Decision・用語集はそのまま残ります）。",
+          // 外したときの約束の 1 文（intake の REMOVED_PROMISE と同じ・cortex-engine #1094 c-30 G7）
+          "外すと、次の晩から読まなくなります。すでに記憶に入った内容は残ります。",
           "",
           "解除しますか？",
         ];
@@ -14433,11 +14271,10 @@ ${calendarAddUrl.toString()}
       label: "登録を解除",
       confirmLines: function () {
         return [
-          "「" + (s.name || s.ref) + "」を、Gold 昇格の読み取り対象から外します。",
-          "",
-          "次回の Gold 昇格（毎晩22時ごろ）から、このスペースは読み取られなくなります。",
+          "「" + (s.name || s.ref) + "」を、読み取り対象から外します。",
           "",
-          "※ 既に Gold 層に入った内容は消えません（Decision・用語集はそのまま残ります）。",
+          // 外したときの約束の 1 文（intake の REMOVED_PROMISE と同じ・cortex-engine #1094 c-30 G7）
+          "外すと、次の晩から読まなくなります。すでに記憶に入った内容は残ります。",
           // 解除は通知先の宣言（notify.json）を触らない（#572）。通知先のまま解除すると
           // 行が消えて画面から止められなくなる——先に止める手順をここで言う
           "※ 通知先にしている場合は、先に「通知を止める」を押してください（解除しても通知先は変わりません）。",
@@ -16224,24 +16061,10 @@ ${calendarAddUrl.toString()}
         placeholder: "owner/repo または https://github.com/owner/repo",
         namePlaceholder: "メモ（任意）",
         requiredNote: "リポジトリを入力してください。",
-        // **手順のリストにする（2026-08-20・Slack からの横展開）。**
-        //
-        // **App の導線をここに常設する（#138 の再発防止・唯一の防波堤）。**
-        // それまでは「組織ごとの接続状況」という独立した一覧の中にしか
-        // 導線が無く、**まだ何も繋いでいない案件＝一番 App を入れてほしい案件**の
-        // 画面に App へ行く道が1本も無かった（実機で踏んだ）。
-        //
-        // **行が0件でも、この手順は必ず出る**（追加フォームはグループの外にある）。
-        // 組織ごとの案内は行が無いと出ないので、**常設の正本はこちら**。
-        // 「案内側に導線があるから手順側は省く」とやると即再発する。
-        hint: [
-          { text: "読み取りたいリポジトリがある組織に、Cortex の GitHub App を入れます（Issues の読み取りだけ）。", node: appInstallLink() },
-          "そのリポジトリを下の欄に入れて「追加」を押します（owner/repo でも、GitHub のURLでも構いません）。",
-          // #660: 「Gold 昇格の材料になります」は嘘になった（性質が種類で固定・GitHub は
-          // 決定の抽出に使わない）。**手順の最終行が伝える重さは「記録に入る」**——
-          // 追加が Gold 昇格の意思決定になるチャット（上の 2 つ）とは別の文にする
-          "追加したリポジトリの Issues と PR の活動が、毎晩の記録に入ります（決定・用語集の材料にはしません）。やめるときは、その行の「登録から削除」を押します。",
-        ],
+        // 🔴 **追加の欄は入力と［追加］だけ（#1233）。** 以前は「App を入れる → リポジトリを足す」の
+        // 手順（1・2・3）と「GitHub App を入れる →」のリンクを置いていたが、リポジトリを足すのが先で、
+        // 読めなければ足した行の中が理由に合った一手を出す（githubRowHelpParts）。
+        // 「毎晩の記録に入る・決定と用語の材料にはしない」の説明は、モーダル上部の説明文が 1 回だけ持つ。
         build: function (repo, name) { return { op: "add-github-source", repo: repo, name: name }; },
         adder: "github",
       }));
@@ -17149,21 +16972,28 @@ ${calendarAddUrl.toString()}
     //
     // **ボタンより後ろに置く。** カードは横並びの flex なので、間に挟むと
     // 「登録を解除」が案内文の下の行へ落ちて、既存案件の行の形が変わる
-    gateHelpNodes(gate, "ds-gate-help").forEach(function (n) { card.appendChild(n); });
-    // **最後に測った理由と直し方を、押す前から出す（#346）。** 「アクセス不可 8時間前に確認」
-    // だけでは、押さない人（初見の PM 等）が止まる。表にエントリがある状態は定型の補足
-    // （リンク込み）だけ、無い状態は needed → detail のフォールバック。どちらも ds-gate-help
-    // を付ける——押した結果で置き換えるとき probeSection がまとめて隠す。
-    // **同じリポジトリの2本目の行（Discussions）には出さない**（opts.quietHelp）。
-    // 同じ長文が2行に並ぶと一覧が案内で埋まる。URL のリンク化は neededNode（innerHTML は使わない）
-    if (!(opts && opts.quietHelp) && showsRestingReason(s)) {
-      var restingParts = restingHelpPartsOf(s.type, s.gate);
-      if (restingParts) card.appendChild(restingHelpNode(restingParts, "ds-gate-help ds-gate-resting"));
-      else {
-        // **能力に畳んでから渡す（#548）。** ここへ来るのは Slack / GitHub / Google Chat の
-        // 行だけなので、ボタンが書いた detail（判定語）は従来どおり出さない
-        var reason = stateReasonOf({ needed: s.needed, detail: s.detail, gateBy: s.gateBy, cap: gateCapOfType(s.type) });
-        if (reason) card.appendChild(neededNode(reason, "ds-gate-help ds-gate-reason"));
+    // **案内の段は「登録から削除」「接続を確認」より後ろに置く（#1233）。** 案内は 100% 幅の段
+    // なので、間に挟むと「接続を確認」だけが案内の下へ落ち、正常な行と並びが違って見える。
+    // 押した結果（probe.detail）の手前に置く——結果が出たら案内は stale 処理で隠れる
+    function appendRowHelp() {
+      gateHelpNodes(gate, "ds-gate-help").forEach(function (n) { card.appendChild(n); });
+      // **最後に測った理由と直し方を、押す前から出す（#346）。** 「アクセス不可 8時間前に確認」
+      // だけでは、押さない人（初見の PM 等）が止まる。表にエントリがある状態は定型の補足
+      // （リンク込み）だけ、無い状態は needed → detail のフォールバック。どちらも ds-gate-help
+      // を付ける——押した結果で置き換えるとき probeSection がまとめて隠す。
+      // **同じリポジトリの2本目の行（Discussions）には出さない**（opts.quietHelp）。
+      // 同じ長文が2行に並ぶと一覧が案内で埋まる。URL のリンク化は neededNode（innerHTML は使わない）
+      if (!(opts && opts.quietHelp) && showsRestingReason(s)) {
+        var restingParts = restingHelpPartsOf(s.type, s.gate, s);
+        if (restingParts) card.appendChild(restingHelpNode(restingParts, "ds-gate-help ds-gate-resting"));
+        else if (!(String(s.type).indexOf("github") === 0 && (s.gate === "unreachable" || s.gate === "no_token") && !githubOrgRefused(s))) {
+          // GitHub の読めない行は表が一手を決める（出さないと決めた行＝確かめられなかった組織には、
+          // 理由文も重ねない）。テナント外の断りだけ、サーバの needed の 1 文がここへ来る
+          // **能力に畳んでから渡す（#548）。** ここへ来るのは Slack / GitHub / Google Chat の
+          // 行だけなので、ボタンが書いた detail（判定語）は従来どおり出さない
+          var reason = stateReasonOf({ needed: s.needed, detail: s.detail, gateBy: s.gateBy, cap: gateCapOfType(s.type) });
+          if (reason) card.appendChild(neededNode(reason, "ds-gate-help ds-gate-reason"));
+        }
       }
     }
     // 🔴 **「材料にしていない」の補足（「ds-not-ingested-note」）は撤去した（#660）。**
@@ -17193,8 +17023,11 @@ ${calendarAddUrl.toString()}
       var probe = probeSection(s, card, gateEl);
       // **ボタンは行の中（「登録を解除」の隣）。** 独立した段を作ると1行が2段になる
       card.appendChild(probe.btn);
+      appendRowHelp();
       // 押した結果の詳細だけを下に。**押すまでは空**なので行は伸びない
       card.appendChild(probe.detail);
+    } else {
+      appendRowHelp();
     }
     return card;
   }

package/dist/view-dir.js

@@ -0,0 +1,273 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VIEW_INDEX_FILE = exports.VIEW_HELD = exports.VIEW_NAMES = void 0;
+exports.blobShaOf = blobShaOf;
+exports.isReadableEnvelope = isReadableEnvelope;
+exports.classifyView = classifyView;
+exports.checkoutGit = checkoutGit;
+exports.planViews = planViews;
+exports.mergeLedgerDir = mergeLedgerDir;
+exports.viewCountsLine = viewCountsLine;
+/**
+ * 記憶 v2 の画面用ファイルの読み口 `--view-dir`（cortex-engine #1094 鎖 3 V10b・確定版 3 章 2）。
+ *
+ * engine の記憶側の晩の終わりの段 `views`（V10a・`scripts/memory-v2/memory/post.mjs`）が、`.cortex` の帳簿 8 本と順位（段 `ranking`）を
+ * 封筒 `{ v:1, name, run, at, commit, blob, text }` に包んで保管庫の `gold/v1/c/view/<名前>.json` に置き、最後に目次 `view-index.json`
+ * （名前ごとに `{ blob, commit, at, absent }`）を置く。workflow（engine の `build-viewer.yml`）がそれを 1 行の `aws s3 sync` で作業場に
+ * 取り出し、このビューアに `--view-dir` で渡す。🔴 **ビューアは保管庫を知らないまま**（ほどくのは手元のファイルだけ・AWS SDK を足さない）。
+ *
+ * ## 何をするか
+ *
+ * 目次を読み、名前ごとに封筒をほどいて分類する（`classifyView`・中身で決める）:
+ * - `same`: 封筒の本文が今の帳簿の置き場のファイルとバイトで同じ（無いの封筒は、置き場にも無い）→ **封筒の本文を使う**
+ * - `stale`・`unexplained`・`unverified`・`unreadable`: 中身が違うか読めない → 名前ごとに今の帳簿に倒す（数え分けは `classifyView`）
+ * 目次に載っていない名前（目次が無い晩を含む）は `missing` に数え、`.cortex` に倒す（橋の間・B8）。
+ *
+ * 使う物だけを差し替えた**合わせの置き場**（一時フォルダ）を作り、ビルドはそこを帳簿の置き場として読む（読み口は今の `--ledger-dir` と同じ 1 本）。
+ * 封筒の本文が使えるのは、HEAD の `.cortex` とバイトで同じとき（same）だけなので、橋の間は `.cortex` から組んだサイトと 1 バイトも変わらない。
+ *
+ * ## 名前（engine の宣言表 `publish: "viewer"` の行・V10a の `VIEW_HELD`）
+ *
+ * - 読む 11 本のうち、記憶側が置くのは 8 本＋順位 1 本（`VIEW_NAMES`）
+ * - 名寄せの提案（`gold-proposals`・A1 の答えまで）と確認の帳簿（`gold-confirmation`・B9a で人の手の表に寄せる）は置かれないので、いつも `.cortex` から読む
+ */
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = require("node:crypto");
+const promises_1 = __importDefault(require("node:fs/promises"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const ledger_dir_1 = require("./ledger-dir");
+/** 記憶側が置く名前（宣言表の `publish: "viewer"` の行から、置かない 2 本を除いた 8 本と順位）。並びは名前順 */
+exports.VIEW_NAMES = Object.freeze([
+    "gold-activity",
+    "gold-change-log",
+    "gold-member-engagement",
+    "gold-rederivation",
+    "gold-term-strength",
+    "memory-hands",
+    "memory-ranking",
+    "mirror-moved-meetings",
+    "story-days",
+]);
+/** 置かれない名前（いつも `.cortex` から読む）と理由 */
+exports.VIEW_HELD = Object.freeze({
+    "gold-proposals": "名寄せの提案のカード（A1 の答えまで .cortex）",
+    "gold-confirmation": "削除の確認の一言（記憶 v2 の案件では人の手の表に寄せる・B9a）",
+});
+/** 目次の名前（engine `VIEW_INDEX_NAME`） */
+exports.VIEW_INDEX_FILE = "view-index.json";
+const SHA_RE = /^[0-9a-f]{40}$/;
+const isSha = (s) => typeof s === "string" && SHA_RE.test(s);
+/** git の blob の sha（engine `blobShaOf` と同じ・utf8 のバイト列） */
+function blobShaOf(text) {
+    const body = Buffer.from(String(text), "utf8");
+    return (0, node_crypto_1.createHash)("sha1").update(Buffer.concat([Buffer.from(`blob ${body.length}\0`, "utf8"), body])).digest("hex");
+}
+/** 封筒が読める形か（engine `isReadableEnvelope` の写し） */
+function isReadableEnvelope(e) {
+    if (!e || typeof e !== "object" || Array.isArray(e))
+        return false;
+    const o = e;
+    if (o.v !== 1 || typeof o.name !== "string" || typeof o.run !== "string" || typeof o.at !== "string")
+        return false;
+    if (!isSha(o.commit))
+        return false;
+    if (o.absent === true)
+        return o.blob === null && o.text === null;
+    return isSha(o.blob) && typeof o.text === "string";
+}
+/**
+ * 1 本の封筒の分類（ビューアの読み手の比べ）。**中身で決める**: 封筒の本文が、今の帳簿の置き場のファイルとバイトで同じなら `same`（使う）。
+ *
+ * engine の `classifyEnvelope`（`view-publish.mjs`）は「封筒の commit が HEAD の祖先か」を先に見るが、ここはそれを使わない。
+ * 記憶側は同じ中身の晩に置き直さない（封筒の commit は古くなる）・ビルドの checkout は浅い（`fetch-depth: 2000`）・
+ * push で起きたビルドは公開より前の版を checkout していることがある、の 3 つで、祖先の判じが中身と関係なく落ちるため（実装レビュー 🔴1・🟠2）。
+ * git は、中身が違うときに「説明がつくか」を分けるのにだけ使う:
+ * - `stale`: 封筒の commit が HEAD の祖先でその版の blob と合う（後から帳簿が変わった）・HEAD が封筒の commit の祖先（checkout が公開より古い）・
+ *   目次と封筒が食い違う（取り出しと公開が重なった）
+ * - `unexplained`: 名前違い・本文の sha が blob と違う・その版の blob と違う・どちらも祖先でない（枝分かれ）
+ * - `unverified`: 中身が違い、封筒の commit が手元の履歴に無い（浅い clone）。門の外の数
+ * - `unreadable`: 封筒・目次の行が読めない・形が違う
+ */
+function classifyView({ envelope, expectedName, indexRow, currentBlob, head, isAncestor, blobAt, }) {
+    if (!indexRow || !isReadableEnvelope(envelope))
+        return "unreadable";
+    const e = envelope;
+    if (e.name !== expectedName)
+        return "unexplained";
+    if (e.absent !== true && blobShaOf(e.text) !== e.blob)
+        return "unexplained";
+    const envBlob = e.absent === true ? null : e.blob;
+    if (envBlob === currentBlob)
+        return "same";
+    // 目次と封筒の食い違い（取り出しの sync と公開の Put が重なった）は、後から変わったのと同じに数える
+    if (indexRow.commit !== e.commit || indexRow.blob !== e.blob || indexRow.absent !== (e.absent === true))
+        return "stale";
+    if (head === null)
+        return "unverified";
+    try {
+        if (isAncestor(e.commit, head))
+            return (blobAt(e.commit, e.name) ?? null) === envBlob ? "stale" : "unexplained";
+        return isAncestor(head, e.commit) ? "stale" : "unexplained";
+    }
+    catch {
+        return "unverified";
+    }
+}
+/** checkout の git（`repoRoot` で呼ぶ）。🔴 投げる口はそのまま投げる（比べの側で unexplained に倒す） */
+function checkoutGit(repoRoot) {
+    const git = (args) => (0, node_child_process_1.execFileSync)("git", args, { cwd: repoRoot, encoding: "utf8", stdio: ["ignore", "pipe", "pipe"] }).trim();
+    return {
+        head: () => {
+            const h = git(["rev-parse", "--verify", "HEAD^{commit}"]);
+            if (!isSha(h))
+                throw new Error("HEAD を読めません");
+            return h;
+        },
+        isAncestor: (a, b) => {
+            if (!isSha(a) || !isSha(b))
+                throw new Error("commit の形が違います");
+            try {
+                (0, node_child_process_1.execFileSync)("git", ["merge-base", "--is-ancestor", a, b], { cwd: repoRoot, stdio: "ignore" });
+                return true;
+            }
+            catch (e) {
+                // 1 は「祖先でない」。それ以外（128＝commit が無い・浅い clone）は判じられない
+                if (e.status === 1)
+                    return false;
+                throw e;
+            }
+        },
+        blobAt: (commit, name) => {
+            if (!isSha(commit))
+                throw new Error("commit の形が違います");
+            try {
+                const sha = git(["rev-parse", "--verify", "-q", `${commit}:./${ledger_dir_1.DEFAULT_LEDGER_DIR_NAME}/${name}.json`]);
+                return isSha(sha) ? sha : null;
+            }
+            catch {
+                // その版に commit があって、ファイルだけが無い → null。commit そのものが無いのは判じられない（投げる）
+                (0, node_child_process_1.execFileSync)("git", ["cat-file", "-e", `${commit}^{commit}`], { cwd: repoRoot, stdio: "ignore" });
+                return null;
+            }
+        },
+    };
+}
+async function readText(p) {
+    try {
+        return await promises_1.default.readFile(p, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+/** 目次を読む。無い → `null`・壊れている → `"unreadable"`・読める → 名前ごとの行 */
+async function readIndex(viewDir) {
+    const text = await readText(node_path_1.default.join(viewDir, exports.VIEW_INDEX_FILE));
+    if (text === null)
+        return null;
+    try {
+        const doc = JSON.parse(text);
+        const o = doc && typeof doc === "object" && !Array.isArray(doc) ? doc : null;
+        const names = o && o.v === 1 && o.names && typeof o.names === "object" && !Array.isArray(o.names) ? o.names : null;
+        if (!names)
+            return "unreadable";
+        const out = {};
+        for (const [k, v] of Object.entries(names)) {
+            const r = v && typeof v === "object" && !Array.isArray(v) ? v : null;
+            // 形の違う行は null（その名前は unreadable に数える。missing に紛れさせない・実装レビュー 🟡4）
+            if (!r || !isSha(r.commit) || !(r.blob === null || isSha(r.blob))) {
+                out[k] = null;
+                continue;
+            }
+            out[k] = { blob: r.blob, commit: r.commit, absent: r.absent === true };
+        }
+        return out;
+    }
+    catch {
+        return "unreadable";
+    }
+}
+/**
+ * 画面用ファイルの置き場を読んで、名前ごとに使うかを決める（ファイルは書かない）。`baseDir` は今の帳簿の置き場（`.cortex` か `--ledger-dir`）で、
+ * same は「封筒の本文がそのフォルダのファイルとバイトで同じ」（だから合わせの置き場は今の帳簿と 1 バイトも変わらない）。
+ * git（HEAD・祖先・その版の blob）は、中身が違うときの数え分けにだけ使う
+ */
+async function planViews(viewDir, git, baseDir) {
+    const classes = {};
+    const use = {};
+    const index = await readIndex(viewDir);
+    let head = null;
+    try {
+        head = git.head();
+    }
+    catch {
+        head = null;
+    }
+    for (const name of exports.VIEW_NAMES) {
+        if (index === null || (index !== "unreadable" && !Object.prototype.hasOwnProperty.call(index, name))) {
+            classes[name] = "missing";
+            continue;
+        }
+        if (index === "unreadable") {
+            classes[name] = "unreadable";
+            continue;
+        }
+        const text = await readText(node_path_1.default.join(viewDir, `${name}.json`));
+        let env = null;
+        try {
+            env = text === null ? null : JSON.parse(text);
+        }
+        catch {
+            env = null;
+        }
+        const cur = await readText(node_path_1.default.join(baseDir, `${name}.json`));
+        const c = classifyView({
+            envelope: env,
+            expectedName: name,
+            indexRow: index[name],
+            currentBlob: cur === null ? null : blobShaOf(cur),
+            head,
+            isAncestor: git.isAncestor,
+            blobAt: git.blobAt,
+        });
+        classes[name] = c;
+        if (c === "same")
+            use[name] = env.absent === true ? null : env.text;
+    }
+    const counts = { total: exports.VIEW_NAMES.length, same: 0, stale: 0, unexplained: 0, unreadable: 0, unverified: 0, missing: 0 };
+    for (const c of Object.values(classes))
+        counts[c] += 1;
+    return { classes, counts, use };
+}
+/**
+ * 合わせの置き場を作る: `baseDir`（`.cortex` か `--ledger-dir`）の中身を一時フォルダに写し、same の名前だけ封筒の本文で差し替える
+ * （「無い」の封筒はその名前を消す）。戻りの `cleanup` で消す
+ */
+async function mergeLedgerDir(baseDir, plan) {
+    const dir = await promises_1.default.mkdtemp(node_path_1.default.join(node_os_1.default.tmpdir(), "cortex-view-"));
+    try {
+        await promises_1.default.cp(baseDir, dir, { recursive: true });
+    }
+    catch (e) {
+        if (e?.code !== "ENOENT") {
+            await promises_1.default.rm(dir, { recursive: true, force: true });
+            throw e;
+        }
+    }
+    for (const [name, text] of Object.entries(plan.use)) {
+        const p = node_path_1.default.join(dir, `${name}.json`);
+        if (text === null)
+            await promises_1.default.rm(p, { force: true });
+        else
+            await promises_1.default.writeFile(p, text, "utf8");
+    }
+    return { dir, cleanup: () => promises_1.default.rm(dir, { recursive: true, force: true }) };
+}
+/** 数の 1 行（ビルドのログ。名前は出さない） */
+function viewCountsLine(c) {
+    return `記憶 v2 の画面用ファイル: ${c.total} 本のうち 使った ${c.same}・後から変わった ${c.stale}・説明のつかない ${c.unexplained}・読めない ${c.unreadable}・履歴で確かめられない ${c.unverified}・目次に無い ${c.missing}（使わなかった分は今の帳簿から読みました）`;
+}

package/package.json

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