@takagaki/cortex-decisions-viewer 0.12.68 → 0.12.69

package/dist/render.js

@@ -17,6 +17,9 @@ exports.sanitizeRegisteredNow = sanitizeRegisteredNow;
 exports.sanitizeIngestCounts = sanitizeIngestCounts;
 exports.sanitizeIngestFailures = sanitizeIngestFailures;
 exports.sanitizeStateNow = sanitizeStateNow;
+exports.devExcludedSkip = devExcludedSkip;
+exports.devExcludedRefs = devExcludedRefs;
+exports.devExcludedLabel = devExcludedLabel;
 exports.overlayStateOnFleet = overlayStateOnFleet;
 exports.chatRowsToAdd = chatRowsToAdd;
 exports.gchatRowsToAdd = gchatRowsToAdd;
@@ -554,8 +557,9 @@ const TOOL_KIND_ICONS = {
     "google-meet": "🎥",
 };
 /**
- * 状態の表示語と色。**4 語＋「登録状況を確認中です」しか出さない**（読み取り中／承認待ち／
- * 停止中／未確認、そして登録簿にしか無くまだ測っていない行の「確認中」・#581）。
+ * 状態の表示語と色。**5 語＋「登録状況を確認中です」しか出さない**（読み取り中／
+ * 接続OK（読み取りの対象外）／承認待ち／停止中／未確認、そして登録簿にしか無く
+ * まだ測っていない行の「確認中」・#581 / #640）。
  *
  * 色は既存の `ds-gate-*` を流用する——同じ画面で「緑＝読めている・橙＝人の操作待ち・
  * 灰＝分からない」の意味を 2 通りに増やさない。
@@ -568,6 +572,13 @@ const TOOL_KIND_ICONS = {
 function toolStateLabel(state) {
     if (state === "reading")
         return { text: "読み取り中", cls: "ds-gate-ok" };
+    // 届いてはいるが、Gold の材料にしていない（#640・engine #399）。**「読み取り中」と
+    // 言わない**——読みに行かないと決めた接続先なので、言えば画面が嘘をつく。
+    // **警告色にもしない**（`ds-gate-ok` のまま）——直すものが無い中立の事実で、橙にすると
+    // 直しに行かせる。状態名を `"excluded"` にしないのは、`liveToolItems` の中で
+    // `match.excluded`（登録簿の devExcluded ＝「停止中」）が別の意味で使われているため
+    if (state === "ok_not_ingested")
+        return { text: "接続OK（読み取りの対象外）", cls: "ds-gate-ok" };
     if (state === "waiting")
         return { text: "承認待ち", cls: "ds-gate-warn" };
     // 止めているものは警告色にしない（直す必要が無いので、橙にすると直しに行かせてしまう）
@@ -656,11 +667,13 @@ function regRowOfToolItem(item) {
  * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
  */
 function toolsFoldSummary(states) {
-    // 表示の順は状態の語と同じ（読み取り中→承認待ち→停止中→未確認→登録状況を確認中です）
-    var order = ["reading", "waiting", "stopped", "unknown", "pending"];
-    var count = { reading: 0, waiting: 0, stopped: 0, unknown: 0, pending: 0 };
+    // 表示の順は状態の語と同じ（読み取り中→接続OK（読み取りの対象外）→承認待ち→停止中→
+    // 未確認→登録状況を確認中です）。🔴 **新しい語をここへ足し忘れると、下の `order.indexOf`
+    // が `unknown` へ倒すので、畳んだ 1 行だけが「未確認」と言う**（開くと違う語が出る・#640）
+    var order = ["reading", "ok_not_ingested", "waiting", "stopped", "unknown", "pending"];
+    var count = { reading: 0, ok_not_ingested: 0, waiting: 0, stopped: 0, unknown: 0, pending: 0 };
     (states || []).forEach(function (s) {
-        // ⚠ 4 語のどれかに当たるかは **order で見る**（素のオブジェクトの添字だと
+        // ⚠ 5 語のどれかに当たるかは **order で見る**（素のオブジェクトの添字だと
         // "constructor" のような語が継承プロパティに当たって、知らない語が素通りする）
         var k = String(s == null ? "" : s);
         count[order.indexOf(k) < 0 ? "unknown" : k] += 1;
@@ -1172,6 +1185,145 @@ function sanitizeStateNow(v) {
     }
     return out.length ? out : null;
 }
+/**
+ * その行が「接続はできるが、Gold の材料にしていない」**中立**の事実か（#640・engine #399）。
+ *
+ * 夜間の Gold 昇格は、性質が「作業物」で取得ごと省いたソースにも到達性を 1 回書く
+ * （engine #399・PR #405）。同じ ref に 2 行が並ぶ:
+ *
+ * ```
+ * SK: dev##<owner>/<repo>#reachable   status: ok        by: gold
+ * SK: dev##<owner>/<repo>#ingested    status: skipped   by: gold
+ *                                     detail: 性質が作業物のため Gold の材料にしません
+ * ```
+ *
+ * 🔴 **「鍵が無くて取り込みを始めていない」`skipped` と混ぜない（#225）。** どちらも同じ語だが、
+ * 利用者が取るべき行動が正反対で、こちらは**何もしなくてよい**——警告（橙）に落とすと、
+ * GitHub を登録した全案件が「直すものがある」と言われる（engine #399 実装レビュー🟡3）。
+ * 見分ける材料は書き手（`by: "gold"`）で、理由文は engine が `by` の綴りを変えた日の保険。
+ *
+ * 🔴 **cap=`dev` で門を掛けるのが、「開発以外は 1 バイトも変わらない」の実体。**
+ * 課題管理・デザインの `skipped`（＝鍵未登録）はこの関数に一度も当たらない。他の能力にも
+ * 「読まないと決めた」が生まれたら、そのときに cap を足す（先回りして広げない——
+ * 広げた先の `skipped` が鍵未登録かどうかを、ここでは確かめられない）。
+ *
+ * ⚠ **チャットには同じ穴が残っている（この便では直さない・実装レビュー🟡8）。** engine の
+ * 門（`external-sources.sh`）は GitHub 専用ではなく、`nature: 作業物` を宣言した Slack
+ * チャンネル / Google Chat スペースにも `chat##…#ingested: skipped` を書く。ここは
+ * `cap !== "dev"` で弾くので、その接続先の Home は #640 以前と**まったく同じ嘘**
+ * （「読み取り中」）を言う。広げるときは、チャットの `skipped` に鍵未登録の書き手が
+ * いないことを先に確かめる。
+ *
+ * ⚠ **`goldState: "excluded"`（行の「読み取り停止中」）とも別物。** あちらは人が
+ * `dev-sources.json` の exclude に書いて止めたもので、こちらはソースの性質で門が省いたもの。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す。
+ * 正規表現も持たない——文字列の一致だけで足りる）。
+ */
+function devExcludedSkip(row) {
+    if (!row || row.cap !== "dev" || row.question !== "ingested")
+        return false;
+    if (row.status !== "skipped")
+        return false;
+    // 🔴 **書き手と理由の AND（片方だけで中立と決めない）。** engine の `neutral` の印は
+    // ストアの属性にならない（`connection-state-writer.mjs` の `historyArgs` は履歴を飛ばす
+    // だけ）ので、画面が中立と言える材料はこの 2 つしかない。`by: "gold"` だけで倒すと、
+    // 夜間が**本物の** `skipped` を dev に書き始めた日に、⚠️ にしたい行が黙って
+    // 「接続OK」に化ける（倒れる向きが問題を隠す側になる・設計レビュー🔴3）。
+    // 理由文の印は engine の 2 文（`性質が作業物のため…` / `ソースの性質により…`）に共通で、
+    // 正本は `infra/lambda/shared/adapters.mjs` の `INGEST_NEUTRAL_DETAIL_MARK`
+    // （写しのずれは `state-vocab-parity.test.mjs` が見張る）
+    if (row.by !== "gold")
+        return false;
+    var d = typeof row.detail === "string" ? row.detail : "";
+    return d.indexOf("材料にしません") >= 0;
+}
+/**
+ * 「いま材料にしていない」開発の接続先（#640）。**鍵は ref の生値**（`overlayStateOnFleet` の
+ * `dev` の鍵と同じ畳み方——揃えないと、行に札が出ないのに Home だけ出る食い違いになる）。
+ *
+ * 🔴 **同じ接続先の「届くか」のほうが新しければ、その中立は古い事実として捨てる。**
+ * 接続状態の行に TTL は無く、engine が中立の行を書くのは**門で省いた晩だけ**
+ * （`connection-state-write-gold.mjs` の `gatedIngestedRow`）。登録簿で性質を「会話」に
+ * 直すと、engine は翌晩から**行を書かないだけ**で、`ingested: ok` に上書きはしない。
+ * 鮮度を見ないと、**言われたとおりに直した人の画面が永久に変わらない**——
+ * 「登録簿で性質を『会話』にしてください」と出し続ける（設計レビュー🔴2）。
+ *
+ * 🔴 **比べる相手は「その晩の Gold 昇格が回った時刻」（`by: "gold"` の行の最新の `at`）。**
+ * 同じ ref の「届くか」と比べてはいけない——接続状態の SK は `cap#workspace#ref#question`
+ * で **`reachable` は 1 本しかなく**、「接続を確認」（`by: "button"`）がその 1 本を
+ * 上書きする。比べると次の 2 つが**どちらも**起きる（実装レビュー🔴1）:
+ *
+ *   - ボタンの行も比べる … 押した瞬間に `at` が今になり、**押しただけで札が消える**
+ *     （押した人には「確認したら読まれるようになった」と読める）
+ *   - 夜間の行だけ比べる … 押すと夜間の行が**消える**ので比べる相手を失い、
+ *     性質を直して消えたはずの札が**押しただけで復活する**
+ *
+ * 夜間の Gold 昇格は 1 回の run の全部の行に**同じ `at`** を書く（engine の
+ * `connection-state-write-gold.mjs` は `at` を run で 1 つだけ作る）。だから
+ * **書き手が `gold` の行の最新の `at`**＝その案件で夜間が最後に回った時刻で、これは
+ * ボタンが 1 本上書きしても残る（他の接続先・他の問いの行が持っている）。
+ * 中立の行自身も `by: "gold"` なので、**厳密に新しいときだけ**捨てれば同じ晩の組は残る。
+ *
+ * ⚠ **残る穴**: その案件の `by: "gold"` の行が**この 1 本だけ**（接続先が 1 つで、
+ * その `reachable` をボタンが上書きした）ときは比べる相手が無く、古い札が次の夜まで残る。
+ * 塞ぐのは engine 側（門を通らなくなった先の `ingested` の行を消す／`ok` を書く）で、
+ * 決定ログ `20260916-640.md` の「覆し方」に書いてある。
+ *
+ * 時刻はミリ秒ありの ISO に正規化済み（サーバの `normalizeAt`）なので辞書順で比べられる。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function devExcludedRefs(rows) {
+    var out = {};
+    // その案件で夜間の Gold 昇格が最後に回った時刻。**能力も問いも問わず集める**
+    // ——1 回の run は全部の行に同じ `at` を書くので、ボタンが 1 本上書きしても
+    // 他の行が同じ時刻を持っている（上の項）
+    var lastGoldAt = "";
+    var list = Array.isArray(rows) ? rows : [];
+    var i, r, k;
+    for (i = 0; i < list.length; i++) {
+        r = list[i];
+        if (!r)
+            continue;
+        if (r.by === "gold" && String(r.at) > lastGoldAt)
+            lastGoldAt = String(r.at);
+        if (r.cap !== "dev")
+            continue;
+        k = String(r.ref == null ? "" : r.ref);
+        if (!k)
+            continue;
+        if (devExcludedSkip(r) && (!out[k] || String(r.at) > String(out[k].at)))
+            out[k] = r;
+    }
+    for (k in out) {
+        if (!Object.prototype.hasOwnProperty.call(out, k))
+            continue;
+        // **厳密に新しいときだけ捨てる。** 同じ晩の組（`at` が同値）を落とさないため
+        if (lastGoldAt > String(out[k].at))
+            delete out[k];
+    }
+    return out;
+}
+/**
+ * 中立の行の理由文から、画面に出す短語を作る（#640）。
+ *
+ * 🔴 **engine が名指しを避けた性質を、画面が断定しない。** engine は性質が語彙
+ * （会話／作業物／参照資料）に載っているときだけ名指しし、載っていなければ
+ * 「ソースの性質により Gold の材料にしません」と書く（`gatedIngestedRow`）。
+ * viewer に性質の語彙の写しは持たない——持つと 4 枚目の写しになり、engine が
+ * 門に掛ける性質を増やした日に黙ってずれる（engine 設計レビュー🟡6 と同じ罠）。
+ * **理由文が名指ししている語をそのまま括弧に入れる**のが、写しを増やさない唯一の形。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function devExcludedLabel(detail) {
+    var d = typeof detail === "string" ? detail : "";
+    var at = d.indexOf("性質が");
+    var to = d.indexOf("のため");
+    var nature = at === 0 && to > 3 ? d.slice(3, to) : "";
+    return nature ? "読み取りの対象外（" + nature + "）" : "読み取りの対象外";
+}
 /**
  * ストアの「届くか」を行に重ねる。**まとめ表の時刻とは比べない。**
  * fleet-status.json は chat / dev の gate・needed を焼き込まない（観測の一本化・工程1。
@@ -1212,12 +1364,23 @@ function sanitizeStateNow(v) {
  * 画面に届かない（fleet-status.json には焼き込まれないので、ライブが届かない案件では出ない
  * ——それは意図。古いスナップショットの理由を出すより、出さないほうが嘘にならない）。
  * needed と同じく、上書きするときは空でも必ず載せる
+ *
+ * **開発の行だけ、`ingested` の中立の行も載せる（#640）。** 「接続できる」と「Gold の
+ * 材料にしている」は別の状態で、`reachable: ok` だけを載せると、読みに行かないと決めた
+ * リポジトリが画面で「読み取り中」になる（engine #399 の申し送り）。載せる欄は
+ * `ingestExcluded`（併記の札を出すか）と `ingestExcludedDetail`（語の括弧に入れる性質）。
+ * 🔴 **`goldState: "excluded"`（人が `dev-sources.json` の exclude で止めた）と別物。**
  */
 function overlayStateOnFleet(view, rows) {
     const v = view || {};
     if (!rows || !rows.length || !Array.isArray(v.externalSources))
         return v;
     const byKey = {};
+    // 「接続できる」と「Gold の材料にしている」は別の状態（#640）。**鮮度の門は
+    // `devExcludedRefs` 1 本**（タイル・Home と同じ規則を 2 枚にしない）。拾う対象は
+    // この下が捨てている行（`question !== "reachable"`）だけなので、チャット・
+    // Google Chat の経路は 1 バイトも変わらない
+    const excludedByRef = devExcludedRefs(rows);
     for (const r of rows) {
         if (r.question !== "reachable")
             continue;
@@ -1233,16 +1396,28 @@ function overlayStateOnFleet(view, rows) {
         if (!s || !s.ref)
             return s;
         let hit = null;
+        let ex = null;
         if (s.type === "slack")
             hit = byKey["chat\t" + String(s.workspace || "") + "\t" + String(s.ref)];
         else if (s.type === "google-chat")
             hit = byKey["google-chat\t" + String(s.ref)];
-        else if (String(s.type || "").indexOf("github") === 0)
+        else if (String(s.type || "").indexOf("github") === 0) {
             hit = byKey["dev\t" + String(s.ref)];
-        if (!hit)
-            return s;
+            // ⚠ 鍵は ref の生値（1 つ上の `dev` の鍵と同じ畳み方）。**`liveRowVerdict` だけは
+            // 両側を小文字に畳む**ので、大小が揺れた repo では Home にだけ札が出る食い違いが
+            // 作れる（#566 の宿題と同根・この便では直さず申し送り）
+            ex = excludedByRef[String(s.ref)] || null;
+        }
+        // **到達性の行が無い夜でも、併記だけは出す。** engine は 2 行を同じ晩に書くが、
+        // 片方しか届かない窓を「何も言わない」に倒すと、画面が知っている事実を捨てる
+        if (!hit) {
+            if (!ex)
+                return s;
+            changed = true;
+            return Object.assign({}, s, { ingestExcluded: true, ingestExcludedDetail: String(ex.detail || "") });
+        }
         changed = true;
-        return Object.assign({}, s, {
+        return Object.assign({}, s, ex ? { ingestExcluded: true, ingestExcludedDetail: String(ex.detail || "") } : {}, {
             gate: hit.status,
             gateAt: hit.at,
             gateBy: hit.by,
@@ -2507,7 +2682,12 @@ const TILE_CAPS = {
     // `cap: "google-chat"` の行は夜間の Gold 昇格が書く（#153 PR-E で結線済み）ので、
     // 夜間が一度走れば規則2/3（⚠️ / 接続OK）まで進む。走る前は規則4（実績なし→中立）
     "チャット-google-chat": { id: "google-chat", question: "reachable", noFact: "登録済み（接続は未確認です）", keyLabel: "", refKeyed: true },
-    "開発": { id: "dev", question: "reachable", noFact: "登録済み（接続は未確認です）", keyLabel: "", refKeyed: true },
+    // 🔴 **`alsoBad: ["ingested"]` は `devExcludedSkip` の篩と一対で足した（#640）。** 夜間が
+    // 「接続はできるが Gold の材料にしていない」を `ingested: skipped` で書くようになった
+    // （engine #399）ので、`reachable` だけを見ていると画面が「読み取り中」と嘘をつく。
+    // ただし `BAD_STATE_STATUSES.ingested` は `skipped` を**悪い**と数えるので、篩を外すと
+    // **GitHub を登録した全案件のタイルが ⚠️「取り込みを飛ばしました」**になる
+    "開発": { id: "dev", question: "reachable", noFact: "登録済み（接続は未確認です）", keyLabel: "", alsoBad: ["ingested"], refKeyed: true },
 };
 /**
  * 登録したばかりで、まだ実測の行が1件も届いていない接続先があるときの語（#523 決定6）。
@@ -2901,6 +3081,11 @@ function deriveCapTile(cap, ctx) {
     var skipped = 0;
     var noToken = 0;
     var unreachable = 0;
+    // 「接続はできるが Gold の材料にしていない」接続先（#640）。**警告には数えない。**
+    // 鮮度の門（古い中立を捨てる）は `devExcludedRefs` が持つ——ここに書き写すと、
+    // 行・Home・タイルで「いつ古いと見なすか」が割れる
+    var excludedRefs = meta.id === "dev" ? devExcludedRefs(rows) : {};
+    var excluded = 0;
     var okSeen = false;
     // 部分失敗の内訳の合計（#634）。**能力の全接続先を足す**——タイルは能力ぜんたいを 1 語で言う
     var sumOk = 0;
@@ -2917,6 +3102,15 @@ function deriveCapTile(cap, ctx) {
         // 出続ける（engine #314 の症状の候補3）。**篩い方の正本は stateRefKey 1箇所**
         if (refs && meta.refKeyed && !refs[stateRefKey(meta.id, r.ref, r.workspace)])
             continue;
+        // 🔴 **中立の事実を、悪い語の表に掛ける前に抜く（#640）。** `BAD_STATE_STATUSES.ingested`
+        // は `skipped` を悪いと数える（鍵が無くて始めていない、の意味）ので、ここを外すと
+        // **GitHub を登録した全案件のタイルが ⚠️ になる**（engine #399 実装レビュー🟡3）。
+        // 数えるのは**鮮度の門を通った分だけ**——性質を「会話」に直した接続先の古い行は
+        // ここで黙って落とす（⚠️ にもしない。直すものが無い過去の事実なので）。
+        // 件数は規則3 の見出しへ回す。「読まないと決めた」を黙って消すと、画面が
+        // 「全部読んでいます」と読める（#523「常に真実を表示する」）
+        if (devExcludedSkip(r))
+            continue;
         // **一度でも成功していれば実績あり。** `lastOkAt` を見るのは、いま失敗している行でも
         // 「繋がったことがある」のは事実だから（規則2が先に立つので表示は⚠️のまま）。
         // **実績は `question`（その能力が「実際に動いた」と言える問い）の側だけで数える**
@@ -2958,6 +3152,16 @@ function deriveCapTile(cap, ctx) {
         else
             unreachable++;
     }
+    // 「材料にしていない」は**接続先ごとに 1 件**（#640）。行を数えると、同じ ref の古い行が
+    // 残っている案件で件数が水増しされる。孤児の篩（#523 決定2）はここにも掛ける
+    // ——外した repo の中立の行が「読み取りの対象外が 3 件」に数え続けられないように
+    for (var ek in excludedRefs) {
+        if (!Object.prototype.hasOwnProperty.call(excludedRefs, ek))
+            continue;
+        if (refs && meta.refKeyed && !refs[stateRefKey(meta.id, ek)])
+            continue;
+        excluded++;
+    }
     // ---- 規則2: 実測が悪い → 警告 ----
     //
     // **失敗を先に言う。** 「鍵が無くて飛ばした」より「鍵はあるのに取れなかった」ほうが
@@ -2986,6 +3190,12 @@ function deriveCapTile(cap, ctx) {
     if (okSeen && sumFailed > 0) {
         return { rule: 3, state: "ok", text: "接続OK（" + sumOk + " 件取り込み・" + sumFailed + " 件失敗）", keyMissing: false };
     }
+    // **読みに行かないと決めた接続先は、件数で言う（#640）。** 「接続OK」の一言で丸めると
+    // 「決定・用語の材料になっている」と読めるし、⚠️ に落とすと直すものが無いのに直しに
+    // 行かせる。**帯は症状だけ**——性質を変える手順は行の補足が 1 行だけ持つ
+    if (okSeen && excluded > 0) {
+        return { rule: 3, state: "ok", text: "接続OK（読み取りの対象外が " + excluded + " 件）", keyMissing: false };
+    }
     if (okSeen)
         return { rule: 3, state: "ok", text: "接続OK", keyMissing: false };
     // ---- 規則4: 実績なし → 中立 ----
@@ -3333,12 +3543,28 @@ function liveToolItems(tools, registered, rows) {
         }
         return "reachable";
     };
+    // 「いま材料にしていない」接続先（#640）。**ループの外で 1 回だけ作る**
+    //（行ごとに作り直すと、行数 × 項目数の走査になる）
+    var excludedRefs = devExcludedRefs(rows);
     var stateOf = function (regKey, regRow, fallback) {
         var v = liveRowVerdict(regKey, regRow, rows, questionOf(regKey));
         if (!v)
             return fallback;
-        if (v.status === "ok")
+        if (v.status === "ok") {
+            // 「接続できる」と「Gold の材料にしている」を別に出す（#640・engine #399）。
+            // **届いていない行には出さない**（`v.status === "ok"` の中だけ）——「アクセス不可」の
+            // ほうが直す一手を持っているので、そちらを勝たせる（帯は症状）。
+            // 判定は `devExcludedSkip` 1 本（タイル・操作タブの行と共有）、行の突き合わせは
+            // `liveRowVerdict` 1 本（鍵の畳み方・複数行の勝ち方を 2 枚にしない・R10）
+            // 鮮度の門も 1 本（`devExcludedRefs`）を通す——性質を「会話」に直した接続先の
+            // 古い行で、Home だけが「読み取りの対象外」と言い続けないように
+            if (regKey === "dev") {
+                var iv = liveRowVerdict(regKey, regRow, rows, "ingested");
+                if (iv && devExcludedSkip(iv.row) && excludedRefs[String(iv.row.ref)])
+                    return "ok_not_ingested";
+            }
             return "reading";
+        }
         if (v.status === "bad")
             return "waiting";
         return "unknown";
@@ -4837,7 +5063,7 @@ a.ds-tile:hover { text-decoration: none; }
 .ds-check-label, .ds-check-action, .ds-check-detail,
 .ds-pipe-label, .ds-pipe-todo,
 .ds-empty, .sec-how, .modal-desc, .ds-toggle-msg,
-.ds-drive-note, .ds-inactive-note, .ds-gate-help,
+.ds-drive-note, .ds-inactive-note, .ds-gate-help, .ds-not-ingested-note,
 /* 案件カレンダーの行（#428）。**カレンダー ID は空白の無い長い連なり**で、
    失敗の理由（detail）も長さが読めない。ここを外すと会議のモーダルが横に溢れる */
 .mt-cal-banner, .mt-cal-note, .mt-cal-warn, .mt-cal-primary, .mt-cal-sub, .mt-cal-id .rt-copy-text,
@@ -4886,6 +5112,13 @@ a.ds-tile:hover { text-decoration: none; }
    トグルを撤去したいま、読み取られていないことを示すのはこのバッジだけ。
    **判断のバッジなので、由来や組織のバッジより強く出す** */
 .badge.ds-excluded { background: #f3f4f6; color: #4b5563; border: 1px solid #d1d5db; }
+/* 「接続はできるが Gold の材料にしていない」印（#640）。**「読み取り停止中」と同じ灰色**
+   ——どちらも「いまこの接続先がどう扱われているか」の印で、直すものが無い中立の事実。
+   橙（警告）にすると、直しようのないものを直しに行かせる */
+.badge.ds-not-ingested { background: #f3f4f6; color: #4b5563; border: 1px solid #d1d5db; }
+/* その理由と、変えたいときの一手（1 行だけ）。**行の補足（.ds-gate-help）と同じ見た目**だが、
+   「接続を確認」で隠される棚には置かない（押しても変わらない事実のため） */
+.ds-not-ingested-note { font-size: 12px; color: #6b7280; line-height: 1.6; margin: 4px 0 0; flex: 1 1 100%; }
 /* 登録の由来（#118）。**薄く出す**——読み取りの可否や Gold 対象かより弱い情報で、
    ここが目立つと「除外」「未宣言」の判断のバッジと同じ強さに見えてしまう */
 /* どの Slack ワークスペースのチャンネルか（#104）。**由来のバッジと同じ強さにする**——
@@ -5494,6 +5727,12 @@ var INGEST_TILE_ROWS = ${JSON.stringify(INGEST_TILE_ROWS)};
 ${sanitizeIngestCounts.toString()}
 ${sanitizeIngestFailures.toString()}
 ${sanitizeStateNow.toString()}
+  // 「接続はできるが Gold の材料にしていない」中立の行（#640）。🔴 **overlayStateOnFleet /
+  // deriveCapTile / liveToolItems / 行の併記が全部この 1 本を引く。** 落とすと 4 か所が
+  // 未定義を参照して、ライブ取得が丸ごと落ちる（画面が静的表示に戻る）
+${devExcludedSkip.toString()}
+${devExcludedRefs.toString()}
+${devExcludedLabel.toString()}
 ${overlayStateOnFleet.toString()}
   // Home の「使用ツール」（#275）。**判定と表示語の実体はビルド時の定義**——
   // 画面側に書き写すと、状態の言い換えが 2 枚になって片方だけ直る。
@@ -8684,10 +8923,20 @@ ${calendarAddUrl.toString()}
       // Issues と Discussions は同じ接続先（同じ dev 行）なので、理由・補足は1本目だけが
       // 持つ（#346）。同じ長文が2行に並ぶと一覧が案内で埋まる
       var seenRef = {};
+      // 「材料にしていない」の 1 行は、**この組織で実際に出した行があってから**畳む（#640）。
+      // 🔴 「seenRef」 を写経して「1 本目かどうか」でフラグを立てると、1 本目が
+      // 併記を持たない行だったときにフラグだけ消費され、**その組織のどの行にも
+      // 補足が出ない**（設計レビュー🟡5）。**出した行だけを数える**
+      var shownExcluded = false;
       var cards = g.items.map(function (x) {
         var again = !!(x.ref && seenRef[x.ref]);
         if (x.ref) seenRef[x.ref] = 1;
-        return extSourceCard(x, DS_TYPE[x.type] || { icon: "🔗", label: x.type || "その他" }, { quietHelp: again });
+        // 🔴 **フラグを立てるのは、その行が実際に補足を出すときだけ。** 出さない行
+        //（同じ ref の 2 本目・「読み取り停止中」）でフラグを消費すると、**その組織の
+        // どの行にも補足が出ない**（設計レビュー🟡5 と同じ罠。条件は 「extSourceCard」 と揃える）
+        var quietExcluded = shownExcluded;
+        if (!again && x && x.ingestExcluded === true && x.goldState !== "excluded") shownExcluded = true;
+        return extSourceCard(x, DS_TYPE[x.type] || { icon: "🔗", label: x.type || "その他" }, { quietHelp: again, quietExcluded: quietExcluded });
       });
       if (g.state === "warn") {
         out.push(orgNoteBox(githubNotConnectedNodes(g), cards));
@@ -9663,15 +9912,23 @@ ${calendarAddUrl.toString()}
   /**
    * 登録したばかりで、まだ実測の行が1件も届いていない接続先があるか（#523 決定6）。
    *
-   * **対象は取り込む4能力だけ**（「alsoBad」 を持つ能力＝規則4の文言が
+   * **対象は取り込む4能力だけ**（実績の問いが 「ingested」 の能力＝規則4の文言が
    * 「まだ取り込みがありません」の系）。チャット・開発の規則4は既に
    * 「接続は未確認です」と言っており、待っていることが読める。
    *
+   * 🔴 **判定に 「alsoBad」 の有無を使わない（#640）。** かつては「取り込む4能力は
+   * alsoBad を持つ」という**偶然の一致**を代用していたが、あちらは
+   * 「実績の問いとは別に、悪ければ⚠️にする問い」を並べる欄で、意味が違う。
+   * 開発に 「alsoBad: ["ingested"]」 を足した瞬間、**GitHub を登録した直後15分の
+   * 開発タイルが「登録済み（接続は未確認です）」から「確認しています…」に黙って変わる**
+   * ——今日の 7 能力では 「question === "ingested"」 と同値なので、表示は 1 バイトも
+   * 変わらないまま、意図（規則4の文言の系）をそのまま述語にする。
+   *
    * 上限は 「UNSETTLED_TTL_MS」（15分）。過ぎたら中立文に戻る——**待てば出ると言い続けない**。
    */
   function capConfirming(derCap) {
     var meta = TILE_CAPS[derCap];
-    if (!meta || !meta.alsoBad) return false;
+    if (!meta || meta.question !== "ingested") return false;
     var ops = pendingOpsNow();
     var now = Date.now();
     for (var i = 0; i < ops.length; i++) {
@@ -14283,6 +14540,31 @@ ${calendarAddUrl.toString()}
         title: "このリポジトリは読み取り対象から除外されています（開発の登録ファイル dev-sources.json の exclude）。この画面からは戻せません。",
       }));
     }
+    // 「接続できる」と「Gold の材料にしている」を別の状態として併記する（#640・engine #399）。
+    //
+    // **常に出す（gate の値で隠さない）。** 届かないことと材料にしていないことは別の事実で、
+    // 片方を隠すと「アクセス不可を直せば読まれる」と誤読させる（#523・オーナー決定
+    // 「操作タブは常に真実を表示する」）。
+    //
+    // 🔴 **「ds-gate」 ではなく 「badge」 で出す。** 行の「判定のバッジは 1 つ」を
+    // 「connection-probe.test.mjs」 が見張っており、「probeSection」 も 「gateEl」 の参照 1 本で
+    // 置き換える設計なので、「.ds-gate」 を 2 つにすると「押した結果がどちらを差し替えたか」が
+    // 構造的に決まらなくなる。**「読み取り停止中」（人が止めた）と同じ棚**に並べるのが正しい
+    // ——どちらも「判定」ではなく「この接続先がいまどう扱われているか」の印。
+    //
+    // 🔴 **警告色にしない。** 直すものが無い中立の事実で、橙にすると直しに行かせる。
+    // 語は短く（長文を入れると行が折り返す）——性質の変え方は下の補足 1 行が持つ
+    // 🔴 **「読み取り停止中」の行には出さない（実装レビュー🟡4）。** 人が exclude で止めた
+    // 行は engine が観測しなくなる＝ 2 行とも書き直されないので、古い中立の行が永久に残る。
+    // しかも止めてある以上、性質を「会話」にしても読まれない——**効かない一手**を案内する
+    // ことになる。灰色の札が 2 つ並ぶのも「繰り返さない」に反する
+    if (s.ingestExcluded === true && s.goldState !== "excluded") {
+      badges.appendChild(el("span", {
+        class: "badge ds-not-ingested",
+        text: devExcludedLabel(s.ingestExcludedDetail),
+        title: "接続はできています。この登録は Gold（決定・用語・メンバー・ルール）の材料にしていません。",
+      }));
+    }
     if (s.notify === true) badges.appendChild(notifyBadge());
     // **どのワークスペースのチャンネルかを、必ず行に出す（#104・2026-08-20 に社内も）。**
     //
@@ -14480,6 +14762,28 @@ ${calendarAddUrl.toString()}
         if (reason) card.appendChild(neededNode(reason, "ds-gate-help ds-gate-reason"));
       }
     }
+    // 「材料にしていない」の理由と、変えたいときの一手（#640）。**1 行だけ。**
+    //
+    // 🔴 **「ds-gate-help」 を付けない。** あちらは「接続を確認」を押した瞬間に
+    // 「probeSection」 がまとめて隠す札で、押した人がいちばん誤読しやすい瞬間
+    //（「確認したから読まれるようになった」）に、この 1 行だけが消える。
+    // 押しても変わらない事実なので、隠される棚に置かない（幅の扱いは CSS で揃える）。
+    //
+    // 🔴 **その組織のグループで最初の 1 行にだけ出す（「opts.quietExcluded」）。** GitHub の
+    // 既定は「作業物」なので、全行に出すと一覧が案内で埋まる（#356・オーナー却下の原則）。
+    // 同じリポジトリの 2 本目（Discussions）にも出さない（「opts.quietHelp」 と同じ理由）
+    if (s.ingestExcluded === true && s.goldState !== "excluded" && !(opts && (opts.quietHelp || opts.quietExcluded))) {
+      // 🔴 **性質を直書きしない（実装レビュー🟡2）。** すぐ上の札は理由文が名指しした語だけを
+      // 括弧に入れているのに、ここで「作業物」と書くと、engine が名指しを避けた回に
+      // **同じ行が 2 つのことを言う**（札は「読み取りの対象外」・補足は「作業物」）。
+      // 名指しできた回だけ性質を言い、できなかった回は事実だけを言う
+      var exNature = devExcludedLabel(s.ingestExcludedDetail).replace(/^読み取りの対象外（?/, "").replace(/）$/, "");
+      card.appendChild(el("p", {
+        class: "ds-not-ingested-note",
+        text: (exNature ? "この登録は「" + exNature + "」なので、" : "この登録は、")
+          + "決定・用語・メンバー・ルールの材料にしていません。議論の場として読ませるなら、登録簿で性質を「会話」にしてください",
+      }));
+    }
     // 「接続を確認」（2026-08-19）。**押せる人を絞らない**——読むだけで設定を変えないので、
     // 気づいた人がその場で確かめられるほうがよい（オーナー判断）。書き込みになる
     // 「表示名を更新する」は、押した結果の中から別のボタンとして出る（probeSection）。

package/package.json

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