@takagaki/cortex-decisions-viewer 0.12.67 → 0.12.69

package/dist/render.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STATE_CONFIRMING = exports.PROBE_WAIT_TIMEOUT_TEXT = exports.UNSETTLED_LIMITS = exports.ALREADY_REGISTERED = exports.LIVE_CONFIRM_LIMITS = exports.CLAUDE_CODE_LINK = void 0;
+exports.STATE_CONFIRMING = exports.PROBE_WAIT_TIMEOUT_TEXT = exports.UNSETTLED_LIMITS = exports.INGEST_LIMITS = exports.ALREADY_REGISTERED = exports.LIVE_CONFIRM_LIMITS = exports.CLAUDE_CODE_LINK = void 0;
 exports.renderSite = renderSite;
 exports.renderSiteWithAssets = renderSiteWithAssets;
 exports.viewerAssetSources = viewerAssetSources;
@@ -14,7 +14,12 @@ exports.regRowOfToolItem = regRowOfToolItem;
 exports.toolsFoldSummary = toolsFoldSummary;
 exports.isAlreadyRegistered = isAlreadyRegistered;
 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;
@@ -38,6 +43,8 @@ exports.secretRegisteredAnywhere = secretRegisteredAnywhere;
 exports.sanitizeCapabilitiesNow = sanitizeCapabilitiesNow;
 exports.sanitizeGithubOwnersNow = sanitizeGithubOwnersNow;
 exports.splitNeededParts = splitNeededParts;
+exports.ingestFacts = ingestFacts;
+exports.ingestSucceeded = ingestSucceeded;
 exports.ingestedAtOf = ingestedAtOf;
 exports.ingestedRowOf = ingestedRowOf;
 exports.runLogUrlOf = runLogUrlOf;
@@ -57,6 +64,8 @@ exports.calendarWaiting = calendarWaiting;
 exports.calendarTemplateUrl = calendarTemplateUrl;
 exports.calendarAddUrl = calendarAddUrl;
 exports.deriveCapTile = deriveCapTile;
+exports.ingestFailureRows = ingestFailureRows;
+exports.ingestFailureText = ingestFailureText;
 exports.derivePendingTile = derivePendingTile;
 exports.liveRowVerdict = liveRowVerdict;
 exports.liveRegistryOf = liveRegistryOf;
@@ -548,8 +557,9 @@ const TOOL_KIND_ICONS = {
     "google-meet": "🎥",
 };
 /**
- * 状態の表示語と色。**4 語＋「登録状況を確認中です」しか出さない**（読み取り中／承認待ち／
- * 停止中／未確認、そして登録簿にしか無くまだ測っていない行の「確認中」・#581）。
+ * 状態の表示語と色。**5 語＋「登録状況を確認中です」しか出さない**（読み取り中／
+ * 接続OK（読み取りの対象外）／承認待ち／停止中／未確認、そして登録簿にしか無く
+ * まだ測っていない行の「確認中」・#581 / #640）。
  *
  * 色は既存の `ds-gate-*` を流用する——同じ画面で「緑＝読めている・橙＝人の操作待ち・
  * 灰＝分からない」の意味を 2 通りに増やさない。
@@ -562,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" };
     // 止めているものは警告色にしない（直す必要が無いので、橙にすると直しに行かせてしまう）
@@ -650,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;
@@ -1042,6 +1061,89 @@ const RUN_URL_WRITERS = ["ingest", "gold", "nightly"];
  * （「Webhook」と断定すると嘘になる）
  */
 const RUN_SOURCE_WORDS = { central: "中央の処理", button: "その場で確認", auto: "保存時に確認" };
+/**
+ * 部分失敗の内訳の欄（#634）。サーバ側 `connection-state-keys.mjs` の
+ * `INGEST_FAILURE_KINDS` / `INGEST_FAILURES_MAX` / `INGEST_TEXT_MAX` / `INGEST_COUNT_KEYS` の写し。
+ *
+ * 🔴 **`STATE_ROW_FIELDS` は文字列の欄しか通さない**（`sanitizeStateNow` の `typeof fv === "string"`）。
+ * `counts`（オブジェクト）と `failures`（配列）は**そこを通らない**ので、下の 2 つの篩を
+ * 別に通す。通し忘れると欄は黙って消え、見出しの件数だけが出なくなる——**行は届いているのに
+ * 画面が何も言わない**形なので、実機でも「engine がまだ書いていないのだろう」と読めてしまう。
+ *
+ * ⚠ **定数を export しない**（`exports.X` に化けて、流し込んだ先で未定義になる）。
+ * 突き合わせは `viewer/test/state-vocab-parity.test.mjs`（サーバの正本と同じ値か）。
+ */
+const INGEST_FAILURE_KINDS = ["transient", "permanent"];
+const INGEST_FAILURES_MAX = 20;
+const INGEST_TEXT_MAX = 200;
+const INGEST_COUNT_KEYS = ["ok", "failed", "skipped"];
+const INGEST_COUNT_MAX = 1000000;
+/**
+ * タイルに並べる失敗の行の本数。**超えたぶんは「ほか N 件」に畳む。**
+ * 20 行並べるとタイルが理由文で埋まる（同じ形の実害が 0.4.71 にある）。
+ */
+const INGEST_TILE_ROWS = 3;
+/** 語と上限を**テストから固定するための入れ物**（`STATE_CONFIRMING` と同じ作法） */
+exports.INGEST_LIMITS = {
+    kinds: INGEST_FAILURE_KINDS,
+    failuresMax: INGEST_FAILURES_MAX,
+    textMax: INGEST_TEXT_MAX,
+    countKeys: INGEST_COUNT_KEYS,
+    countMax: INGEST_COUNT_MAX,
+    tileRows: INGEST_TILE_ROWS,
+};
+/**
+ * `counts` を篩う（#634）。**落として残りを出す**（サーバ側 `normalizeIngestCounts` と同じ規則）。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す。
+ * `INGEST_COUNT_KEYS` / `INGEST_COUNT_MAX` は CLIENT_JS 側に `var` で流し込んである）。
+ */
+function sanitizeIngestCounts(v) {
+    if (!v || typeof v !== "object" || Array.isArray(v))
+        return null;
+    var out = {};
+    var any = false;
+    for (var i = 0; i < INGEST_COUNT_KEYS.length; i++) {
+        var k = INGEST_COUNT_KEYS[i];
+        var n = v[k];
+        // **整数・非負・上限つきだけ。** 画面の見出しに出る数なので、`-1` や `1e30` を通さない
+        if (typeof n === "number" && isFinite(n) && Math.floor(n) === n && n >= 0 && n <= INGEST_COUNT_MAX) {
+            out[k] = n;
+            any = true;
+        }
+    }
+    return any ? out : null;
+}
+/**
+ * `failures` を篩う（#634）。**落として残りを出す**（サーバ側 `normalizeIngestFailures` と同じ規則）。
+ *
+ * `kind` が語彙外の値は `permanent` に倒す。**`transient` に倒さない**——画面は `transient` にだけ
+ * 「次回の取り込みで再試行します」を添えるので、知らない語をそちらへ倒すと、直さないと消えない
+ * 失敗に「待てば直る」と言うことになる。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す。
+ * `INGEST_FAILURE_KINDS` / `INGEST_FAILURES_MAX` / `INGEST_TEXT_MAX` は `var` で流し込んである）。
+ */
+function sanitizeIngestFailures(v) {
+    if (!Array.isArray(v))
+        return null;
+    var out = [];
+    for (var i = 0; i < v.length; i++) {
+        if (out.length >= INGEST_FAILURES_MAX)
+            break;
+        var f = v[i];
+        if (!f || typeof f !== "object" || Array.isArray(f))
+            continue;
+        if (typeof f.name !== "string" || !f.name)
+            continue;
+        out.push({
+            name: f.name.slice(0, INGEST_TEXT_MAX),
+            reason: typeof f.reason === "string" ? f.reason.slice(0, INGEST_TEXT_MAX) : "",
+            kind: INGEST_FAILURE_KINDS.indexOf(f.kind) >= 0 ? f.kind : "permanent",
+        });
+    }
+    return out.length ? out : null;
+}
 /** stateNow はライブ専用キーで build.ts の網にかからない。画面側でも許可リストを通す */
 function sanitizeStateNow(v) {
     if (!Array.isArray(v))
@@ -1066,10 +1168,162 @@ function sanitizeStateNow(v) {
         // `runUrl` は run ページの形だけ（#560）。形が違えば**欄だけ落として行は残す**
         if (item.runUrl && !RUN_URL_RE.test(item.runUrl))
             delete item.runUrl;
+        // 部分失敗の内訳（#634）。**上の走査は文字列の欄しか通さない**ので、オブジェクトと配列の
+        // この 2 欄はここで別に篩う。🔴 ここを落とすと欄は黙って消え、**行は届いているのに
+        // 見出しの件数と失敗の行だけが出ない**——「engine がまだ書いていない」と読めてしまう形になる。
+        // 秘密の除去はサーバ側（`queryConnectionState`）が済ませてある（`detail` と同じ扱い。
+        // 画面側に秘密のパターンの 2 枚目を持たない・設計レビュー🔴2）
+        if (item.question === "ingested") {
+            const c = sanitizeIngestCounts(r.counts);
+            if (c)
+                item.counts = c;
+            const f = sanitizeIngestFailures(r.failures);
+            if (f)
+                item.failures = f;
+        }
         out.push(item);
     }
     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。
@@ -1110,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;
@@ -1131,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,
@@ -2062,6 +2339,90 @@ function splitNeededParts(text) {
         out.push({ text: s.slice(at), url: false });
     return out;
 }
+/**
+ * 取り込みの行 1 本から「何件取り込めて、何件失敗したか」を読む（#634）。**判定はこの 1 本だけ。**
+ *
+ * 🔴 **タイル（`deriveCapTile`）・Home の「使用ツール」（`liveRowVerdict`）・行の札（`ingestedEl`）・
+ * 「最終同期」（`ingestedAtOf`）が全部ここを通る。** 分けると、同じ案件でタイルは「接続OK」・
+ * Home は「承認待ち」・札は「失敗」になる（`ops-ui-controls-policy.md` R10「タイルと行が違うことを
+ * 言ってはいけない」）。2026-09-16 の nicigas-ncp が踏んだのはまさにこの形の 1 枚目。
+ *
+ * ## 2 つの読み方
+ *
+ * 1. **新形式**（便 2 以降）… `counts` から読む。`status` は `ok`（部分失敗は「取り込めた」側）
+ * 2. **旧形式の橋**（便 1 の暫定）… `status: "failed"` で `counts` が無い行の `detail` から
+ *    件数を読む。engine の書き手は `251件取り込み・1件失敗・38件は取り込めない形式…`
+ *    （`scripts/connection-state-write-materials.mjs` の `ingestedDetail`）、中央 Apps Script は
+ *    `3件取り込み（カレンダー 2・合図 1）・1件失敗`（`apps-script/src/Main.gs`）と書く。
+ *    **cap を問わず全部の `ingested` の行に効く**（会議もこの便で部分失敗になる・設計レビュー🔴4）
+ *
+ * ⚠ **橋は便 2 で消してよい。** engine と中央の書き手が `counts` を書き始めたら、下の
+ * 「旧形式の橋」の分岐ごと削除できる（新形式の行は 1 つ目の分岐で答えが出る）。
+ * 消すときは番人テストの旧形式の題材も一緒に消す。
+ *
+ * 🔴 **正規表現は関数の中に literal で置く（外の const にしない）。** モジュール直下の const は
+ * tsc が `exports.X` に書き換え、`.toString()` で客先へ渡ったこの関数がブラウザで未定義を参照する
+ * ——ライブ取得が丸ごと落ちて画面が静的表示に戻る（`isCalendarId` の項と同じ穴・設計レビュー🔴1）。
+ *
+ * @returns 読めたときだけ。`partial` は「1 件以上取り込めて、1 件以上失敗した」
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function ingestFacts(row) {
+    if (!row || row.question !== "ingested")
+        return null;
+    // 🔴 **`skipped`（鍵が無くて取り込みを始めていない）の行は部分失敗にしない。** 件数が
+    // 付いていても、この行が言いたいのは「◯が未登録です」で、部分失敗として飲み込むと
+    // **鍵を入れるべき案件に「接続OK」と出る**（取るべき行動が違う・#225 が分けたかったもの）
+    var c = row.status === "skipped" ? null : row.counts;
+    // 🔴 **`ok` と `failed` のどちらも読めない `counts` は「新形式」と見なさない。** 契約は
+    // 3 つの鍵を個別に任意にしているので、`{ skipped: 38 }` だけの行がありうる。そこで即
+    // 「0 件取り込み・0 件失敗」と答えると、**同じ行の `detail` にある件数が読まれないまま
+    // 「同期が失敗しています」に戻る**——便 2 が半分だけ移った窓（counts は書き始めたが
+    // status はまだ `failed`）で起きる。読めないなら下の橋へ落とす
+    if (c && typeof c === "object" && !Array.isArray(c) && (typeof c.ok === "number" || typeof c.failed === "number")) {
+        var cok = typeof c.ok === "number" ? c.ok : 0;
+        var cfail = typeof c.failed === "number" ? c.failed : 0;
+        var cskip = typeof c.skipped === "number" ? c.skipped : 0;
+        return { ok: cok, failed: cfail, skipped: cskip, partial: cok > 0 && cfail > 0, legacy: false };
+    }
+    // ---- 旧形式の橋（便 2 で消してよい・上の項） ----
+    if (row.status !== "failed")
+        return null;
+    var d = typeof row.detail === "string" ? row.detail : "";
+    var mo = /([0-9][0-9,]*)\s*件取り込み/.exec(d);
+    var mf = /([0-9][0-9,]*)\s*件失敗/.exec(d);
+    // **件数を持たない失敗はここへ来ない。** 「フォルダを開けないため取り込めませんでした」
+    // 「取り込みが途中で終わりました」は件数の話ではないので、失敗のまま残るのが正しい
+    if (!mo || !mf)
+        return null;
+    var lok = parseInt(String(mo[1]).replace(/,/g, ""), 10);
+    var lfail = parseInt(String(mf[1]).replace(/,/g, ""), 10);
+    if (!(lok >= 0) || !(lfail >= 0))
+        return null;
+    var ms = /([0-9][0-9,]*)\s*件は取り込めない/.exec(d);
+    var lskip = ms ? parseInt(String(ms[1]).replace(/,/g, ""), 10) : 0;
+    // `0件取り込み・1件失敗`（フォルダを開けなかった回）は partial にならない＝失敗のまま
+    return { ok: lok, failed: lfail, skipped: lskip >= 0 ? lskip : 0, partial: lok > 0 && lfail > 0, legacy: true };
+}
+/**
+ * その行が「取り込めた」と言えるか（#634）。`ok` か、部分失敗（旧形式を含む）。
+ *
+ * **「最終同期」の材料**（`ingestedAtOf` / `ingestedRowOf`）。251 件取り込んだ回は
+ * **実際に取り込めている**ので、その回の時刻を「最終同期」として出すのが R4
+ * （「最終同期」は取り込めた時刻だけ）に沿う。旧形式では `status` が `failed` なので、
+ * ここを通さないと**前回の成功時刻が出続ける**（設計レビュー🟡11）。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function ingestSucceeded(row) {
+    if (!row)
+        return false;
+    if (row.status === "ok")
+        return true;
+    var f = ingestFacts(row);
+    return !!(f && f.partial);
+}
 /**
  * `stateNow` から、その能力の「最後に取り込めた時刻」を引く（#227 の時刻の一貫化）。
  *
@@ -2087,8 +2448,14 @@ function ingestedAtOf(rows, capId, refs) {
             continue;
         if (refs && !refs[stateRefKey(capId, r.ref, r.workspace)])
             continue;
-        const at = r.lastOkAt || (r.status === "ok" ? r.at : "");
-        if (typeof at === "string" && at > best)
+        // **部分失敗の回も「取り込めた」**（#634・`ingestSucceeded`）。251 件は実際にこの回で
+        // 取り込めているので、前回の成功時刻を出し続けるほうが嘘になる。
+        // 履歴（`lastOkAt`）と今回の時刻の**新しいほう**を採る——同じ 1 行の中の 2 つの時刻で、
+        // どちらもミリ秒ありの ISO に正規化済み（サーバの `normalizeAt`）なので辞書順で比べられる
+        const hist = typeof r.lastOkAt === "string" ? r.lastOkAt : "";
+        const okAt = ingestSucceeded(r) && typeof r.at === "string" ? r.at : "";
+        const at = okAt > hist ? okAt : hist;
+        if (at > best)
             best = at;
     }
     return best;
@@ -2111,8 +2478,12 @@ function ingestedRowOf(rows, capId, refs) {
             continue;
         if (refs && !refs[stateRefKey(capId, r.ref, r.workspace)])
             continue;
-        const at = r.lastOkAt || (r.status === "ok" ? r.at : "");
-        if (typeof at === "string" && at > best) {
+        // 選び方は `ingestedAtOf` と**同じ 1 本**（分かれると「最終同期の時刻」と
+        // 「そのリンク先の run」が別の行のものになる）
+        const hist = typeof r.lastOkAt === "string" ? r.lastOkAt : "";
+        const okAt = ingestSucceeded(r) && typeof r.at === "string" ? r.at : "";
+        const at = okAt > hist ? okAt : hist;
+        if (at > best) {
             best = at;
             bestRow = r;
         }
@@ -2146,9 +2517,13 @@ function runLogUrlOf(row) {
  * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
  */
 function lastSyncRunUrlOf(row) {
-    if (!row || row.status !== "ok")
+    // **部分失敗の回も「取り込めた」（#634）。** ここを `status === "ok"` のままにすると、
+    // 「最終同期」の時刻は部分失敗の回のものになったのに、その時刻を書いた run へ行けない
+    // ——R9（その時刻を書いた run にだけリンクを出す）が、まさにこの便の対象の回で満たせない
+    if (!ingestSucceeded(row))
         return "";
-    if (row.lastOkAt && row.lastOkAt !== row.at)
+    // 「最終同期」として出した時刻がこの行の `at` でないなら、リンク先の run は別の回のもの
+    if (row.lastOkAt && row.lastOkAt > row.at)
         return "";
     return runLogUrlOf(row);
 }
@@ -2307,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）。
@@ -2701,7 +3081,15 @@ 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;
+    var sumFailed = 0;
     for (var i = 0; i < rows.length; i++) {
         var r = rows[i];
         if (!r || r.cap !== meta.id)
@@ -2714,12 +3102,44 @@ 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`（その能力が「実際に動いた」と言える問い）の側だけで数える**
         // ——Drive に届いていても取り込みが0件なら「まだ取り込みがありません」が事実
         if (r.question === meta.question && (r.status === "ok" || r.lastOkAt))
             okSeen = true;
+        // 🔴 **部分失敗は「失敗」と数えない（#634・オーナー決定 2026-09-16）。** 251 件成功・
+        // 1 件失敗の行を `failed` に数えると、規則2 が能力ぜんたいを「同期が失敗しています」に
+        // 丸める——99.6% 取り込めているのに「共有資料が壊れている」と読める画面になる。
+        // **取り込めた実績はあるので `okSeen` は立てる**（旧形式の行は `status: "failed"` なので、
+        // ここで立てないと規則4 の「まだ取り込みがありません」に落ちる）。
+        // 件数は規則3 の見出しへ回す。判定の実体は `ingestFacts` 1 本（タイル・Home・行の札で共有）
+        var facts = r.question === meta.question ? ingestFacts(r) : null;
+        if (facts) {
+            sumOk += facts.ok;
+            sumFailed += facts.failed;
+        }
+        if (facts && facts.partial) {
+            okSeen = true;
+            continue;
+        }
+        // 🔴 **`ok` と名乗っていても 1 件も取り込めていなければ失敗として数える（#634）。**
+        // `failed` を「1 件も取り込めなかった」に限定した約束の裏返しで、書き手が取り違えると
+        // 見出しが「接続OK（0 件取り込み・3 件失敗）」という**自分で矛盾した文**になる。
+        // 契約では弾かない（行ごと落とすと失敗そのものが画面から消える）ので、ここで倒す
+        if (facts && facts.ok === 0 && facts.failed > 0) {
+            failed++;
+            continue;
+        }
         var bad = BAD_STATE_STATUSES[r.question] || [];
         if (bad.indexOf(r.status) < 0)
             continue;
@@ -2732,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: 実測が悪い → 警告 ----
     //
     // **失敗を先に言う。** 「鍵が無くて飛ばした」より「鍵はあるのに取れなかった」ほうが
@@ -2753,6 +3183,19 @@ function deriveCapTile(cap, ctx) {
         return { rule: 2, state: "warn", text: unreachable + "件が読めていません", keyMissing: false };
     }
     // ---- 規則3: 実績あり → 接続OK ----
+    //
+    // **部分失敗は件数で言う（#634）。** 「接続OK」の一言で丸めると 1 件の失敗が画面から消え、
+    // 「同期が失敗しています」で丸めると 251 件の成功が消える。**帯は症状だけ**
+    // （`ui-wording-symptom-then-one-action`）——何を直すかはタイルの中の失敗の行が言う
+    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: 実績なし → 中立 ----
@@ -2765,6 +3208,56 @@ function deriveCapTile(cap, ctx) {
         return { rule: 4, state: "idle", text: STATE_CONFIRMING_TEXT, keyMissing: false };
     return { rule: 4, state: "idle", text: meta.noFact, keyMissing: false };
 }
+/**
+ * その能力で取り込めなかったファイルの一覧（#634）。**タイルの中に 1 行ずつ出す材料。**
+ *
+ * 選び方は `ingestedAtOf` と同じ篩（`cap` / `question === "ingested"` / 登録簿の `refs`）。
+ * 孤児行（外した接続先の残骸）の失敗を並べない——外したフォルダのファイル名が
+ * いつまでも画面に残る（#523 決定2 と同じ理由）。
+ *
+ * 旧形式の行には一覧が無い（`detail` は件数しか持たない）ので 0 件になる。**それが橋の限界**で、
+ * 便 1 では帯の件数だけが出る。便 2 で書き手が `failures` を書き始めると行が並ぶ。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す。
+ * `stateRefKey` / `INGEST_FAILURES_MAX` はこれより前に流し込んである）。
+ */
+function ingestFailureRows(rows, capId, refs) {
+    var out = [];
+    if (!Array.isArray(rows) || !capId)
+        return out;
+    for (var i = 0; i < rows.length; i++) {
+        var r = rows[i];
+        if (!r || r.cap !== capId || r.question !== "ingested")
+            continue;
+        if (refs && !refs[stateRefKey(capId, r.ref, r.workspace)])
+            continue;
+        if (!Array.isArray(r.failures))
+            continue;
+        for (var j = 0; j < r.failures.length; j++) {
+            if (out.length >= INGEST_FAILURES_MAX)
+                return out;
+            var f = r.failures[j];
+            if (f && f.name)
+                out.push(f);
+        }
+    }
+    return out;
+}
+/**
+ * 取り込めなかったファイル 1 件の 1 行（#634）。**行は一手**（`ui-wording-symptom-then-one-action`）。
+ *
+ * 一手を添えるのは `transient`（相手側の一時エラー）だけ。**`permanent` には足さない**
+ * ——恒久エラーの直し方は理由ごとに違う（権限を直す／形式を変える）ので、一律の案内を
+ * ここで作ると嘘になる。何を直すかは書き手が `reason` に書く。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function ingestFailureText(f) {
+    var name = String((f && f.name) || "");
+    var reason = String((f && f.reason) || "");
+    var line = reason ? name + " — " + reason : name;
+    return f && f.kind === "transient" ? line + "（次回の取り込みで再試行します）" : line;
+}
 /**
  * 「まとめ表が知らない行がある」能力のタイルに、行と同じ答えを出せるか（#576）。
  *
@@ -2921,6 +3414,13 @@ function liveRowVerdict(regKey, reg, rows, question) {
         return null;
     if (hit.status === "ok")
         return { status: "ok", row: hit };
+    // 🔴 **部分失敗は「承認待ち」と言わない（#634）。** タイル（`deriveCapTile`）が
+    // 「接続OK（251 件取り込み・1 件失敗）」と言っている横で、Home の同じ接続先が
+    // 「承認待ち」になると、同じ画面の 2 か所が別のことを言う（R10）。判定は `ingestFacts` 1 本。
+    // **`row` は必ず添える**（呼び手が `v.row.at` を読む・設計レビュー🟡10）
+    var hitFacts = ingestFacts(hit);
+    if (hitFacts && hitFacts.partial)
+        return { status: "ok", row: hit };
     var bad = BAD_STATE_STATUSES[question] || [];
     if (bad.indexOf(hit.status) >= 0)
         return { status: "bad", row: hit };
@@ -3043,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";
@@ -4547,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,
@@ -4596,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）。**由来のバッジと同じ強さにする**——
@@ -5192,7 +5715,24 @@ var STATE_ROW_FIELDS = ${JSON.stringify(STATE_ROW_FIELDS)};
 var RUN_URL_RE = new RegExp(${JSON.stringify(RUN_URL_RE.source)});
 var RUN_URL_WRITERS = ${JSON.stringify(RUN_URL_WRITERS)};
 var RUN_SOURCE_WORDS = ${JSON.stringify(RUN_SOURCE_WORDS)};
+  // 部分失敗の内訳の欄（#634）。🔴 **この 6 行を落とすと、流し込んだ sanitizeIngestCounts /
+  // sanitizeIngestFailures が未定義を参照して、ライブ取得が丸ごと死ぬ**（定数は export できないので
+  // 値はここで注入する。「STATE_STATUSES」 と同じ作法）
+var INGEST_FAILURE_KINDS = ${JSON.stringify(INGEST_FAILURE_KINDS)};
+var INGEST_FAILURES_MAX = ${JSON.stringify(INGEST_FAILURES_MAX)};
+var INGEST_TEXT_MAX = ${JSON.stringify(INGEST_TEXT_MAX)};
+var INGEST_COUNT_KEYS = ${JSON.stringify(INGEST_COUNT_KEYS)};
+var INGEST_COUNT_MAX = ${JSON.stringify(INGEST_COUNT_MAX)};
+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 枚になって片方だけ直る。
@@ -5222,6 +5762,10 @@ ${splitNeededParts.toString()}
 ${stateRefKey.toString()}
 ${registeredRefKeys.toString()}
 ${fleetLastSyncOf.toString()}
+  // 部分失敗の判定（#634）。🔴 **ingestedAtOf / deriveCapTile / liveRowVerdict / ingestedEl が
+  // すべてこの 1 本を引く。** 落とすと「最終同期」もタイルも Home も未定義を参照して落ちる
+${ingestFacts.toString()}
+${ingestSucceeded.toString()}
 ${ingestedAtOf.toString()}
 ${ingestedRowOf.toString()}
 ${runLogUrlOf.toString()}
@@ -5234,6 +5778,9 @@ var BAD_STATE_STATUSES = ${JSON.stringify(BAD_STATE_STATUSES)};
 var STATE_CONFIRMING_TEXT = ${JSON.stringify(STATE_CONFIRMING_TEXT)};
 ${keyMissingText.toString()}
 ${deriveCapTile.toString()}
+  // タイルの中の失敗の行（#634）。**stateRefKey / INGEST_FAILURES_MAX より後に置く**
+${ingestFailureRows.toString()}
+${ingestFailureText.toString()}
   // 登録直後のタイル（#576）。**registeredRefKeys / stateRefKey / BAD_STATE_STATUSES より後に置く**
   //（上の 3 つを引く。前に置くと var の BAD_STATE_STATUSES が undefined で判定が丸ごと死ぬ）
 ${derivePendingTile.toString()}
@@ -8376,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));
@@ -9355,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++) {
@@ -10762,6 +11327,24 @@ ${calendarAddUrl.toString()}
       if (tokenRelevant && sk && secretKindsShown().indexOf(sk) >= 0 && !secretPresentForTile(sk)) {
         body.appendChild(el("div", { class: "ds-tile-note", text: "⚠ トークンが未設定です" }));
       }
+      // 取り込めなかったファイル（#634）。**帯は症状（件数）・行は一手。**
+      // 帯が「接続OK（251 件取り込み・1 件失敗）」と言っているのに、どのファイルが取り込めて
+      // いないのかが画面から分からないと、利用者は run のログを読みに行くしかない
+      // （＝案件リポに入っていない人には辿れない）。
+      // **出すのは導出が答えている回だけ**——まとめ表由来の warn で導出を捨てた回（derive が null）は
+      // 「同期の run そのものが落ちた」という別の事実を言っているので、そこへ内訳を混ぜない
+      if (derive && derive.state === "ok") {
+        var failDerCap = derCapOf(cap, adapter);
+        var failCapId = (TILE_CAPS[failDerCap] && TILE_CAPS[failDerCap].id) || "";
+        var fails = failCapId ? ingestFailureRows(LIVE_STATE, failCapId, refKeysOf(failDerCap)) : [];
+        for (var fi = 0; fi < fails.length && fi < INGEST_TILE_ROWS; fi++) {
+          body.appendChild(el("div", { class: "ds-tile-note", text: "⚠ " + ingestFailureText(fails[fi]) }));
+        }
+        // **残りは畳む。** 20 行並べるとタイルが理由文で埋まる（0.4.71 で溢れた形）
+        if (fails.length > INGEST_TILE_ROWS) {
+          body.appendChild(el("div", { class: "ds-tile-note ds-tile-todo", text: "ほか " + (fails.length - INGEST_TILE_ROWS) + " 件" }));
+        }
+      }
       // 🔴 **セットアップの残り（checks）の長文はタイルに出さない（#230・オーナー指摘）。**
       //
       // 出所は engine の夜間チェックの 「action」 欄で、**この設定画面が無かった頃の
@@ -11856,7 +12439,14 @@ ${calendarAddUrl.toString()}
     if (!r) return null;
     var when = rtAgo(r.at);
     var text = "";
-    if (r.status === "ok") text = when ? "取り込み: " + when + "に成功" : "取り込み: 成功";
+    // 🔴 **部分失敗は「失敗」と書かない（#634・設計レビュー🔴3）。** 判定はタイルと同じ 1 本
+    // （「ingestFacts」）を通す。ここを掃かないと、便 2 で Backlog / Figma が ok ＋
+    // counts.failed > 0 を書き始めた瞬間、**タイルは「接続OK（N 件取り込み・M 件失敗）」・
+    // 札は「取り込み: ◯◯に成功」**になり、失敗が行から消える（R10 の逆向き）。
+    // 件数を添えるのは失敗が 1 件以上あるときだけ——全部成功した回に「（0 件失敗）」を出さない
+    var f = ingestFacts(r);
+    var fw = f && f.failed > 0 ? "（" + f.failed + " 件失敗）" : "";
+    if (r.status === "ok" || (f && f.partial)) text = (when ? "取り込み: " + when + "に成功" : "取り込み: 成功") + fw;
     else if (r.status === "failed") text = when ? "取り込み: " + when + "に失敗" : "取り込み: 失敗";
     // 🔴 **「スキップ」で終わらせない（#225）。** 鍵が無くて飛ばしたのが skipped の実体で、
     // 「スキップ」とだけ書かれても**次に何をすればいいのか読み取れない**。しかも
@@ -11864,8 +12454,10 @@ ${calendarAddUrl.toString()}
     // 語は鍵カードの名前と揃える（keyMissingText の項）
     else if (r.status === "skipped") text = "取り込み: 未実行（" + keyMissingText(cap) + "）";
     if (!text) return null;
+    // 赤にするのは「1 件も取り込めなかった」回だけ（#634）。部分失敗は取り込めているので、
+    // 件数を添えた成功の札のまま出す（色で「壊れている」と言わない）
     var span = el("span", {
-      class: "ds-ingest" + (r.status === "failed" ? " ds-ingest-failed" : ""),
+      class: "ds-ingest" + (r.status === "failed" && !(f && f.partial) ? " ds-ingest-failed" : ""),
       text: text,
     });
     // その行を書いた run へ（#560）。成功でも失敗でも、この時刻を書いた run のログ
@@ -13948,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 に社内も）。**
     //
@@ -14145,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.67",
+  "version": "0.12.69",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,