@takagaki/cortex-decisions-viewer 0.12.66 → 0.12.68

package/dist/build.js

@@ -756,8 +756,24 @@ async function readGoldProposals(repoRoot) {
 // 27案件を実測したところ、案件の目的が記入済みなのは3件だけだった。
 // 残る24案件では、毎晩のAI生成が**案件を知らないまま**抽出を続けている。
 // ビューアの仕事は、その未記入を見えるようにして「書かせる圧」をかけること。
-/** 新しい形の自己記述の節。画面の最上部に出す */
-const HOME_GROUNDING_HEADINGS = ["この案件について", "ゴール", "体制"];
+/**
+ * 記入されていないと困る自己記述の節。**未記入の赤い帯はここだけを見る。**
+ *
+ * 🔴 **旧見出し「この案件について」への両対応は入れない**（#626 便 2・オーナー決定）。
+ * engine のマイグレーション 0093 が全プロジェクトの Home.md を改名済みで、旧見出しは
+ * どこにも残っていない。両対応にすると、次に見出しが動いたときにどちらが正本か
+ * 分からなくなる（改名は engine 側の 1 回きりの操作として完了している）。
+ *
+ * 🔴 **見出し名を「出す節」と「必須の節」で別々に書かない。** 片方だけ直すと
+ * 「節は最上部に出ているのに未記入の赤い帯も出る」という食い違った画面になる
+ * （0.12.66 の事故がまさにこの形だった）。必須から並びを組み立てる向きにしておくと、
+ * 任意の節を改名しても必須に昇格しない。
+ */
+const HOME_REQUIRED_GROUNDING_HEADINGS = ["このプロジェクトについて", "ゴール"];
+/** あれば出すが、無くてよい節（未記入の判定には使わない） */
+const HOME_OPTIONAL_GROUNDING_HEADINGS = ["体制"];
+/** 新しい形の自己記述の節。画面の最上部に、この並び順で出す */
+const HOME_GROUNDING_HEADINGS = [...HOME_REQUIRED_GROUNDING_HEADINGS, ...HOME_OPTIONAL_GROUNDING_HEADINGS];
 /** 旧い形。1つの節に「解きたいこと」「達成した状態」が同居していた */
 const HOME_LEGACY_GROUNDING_HEADING = "このプロジェクトが目指すもの";
 /**
@@ -830,9 +846,9 @@ async function buildHomeGrounding(rawMarkdown) {
             html: await renderGroundingSection(hit.body),
         });
     }
-    // 未記入の判定。新形式は「この案件について」と「ゴール」の2つ、旧形式は1つの節を見る。
-    // **どちらの節も無ければ未記入。** 節ごと消えている案件が実在する
-    const checkHeadings = hasNew ? ["この案件について", "ゴール"] : [HOME_LEGACY_GROUNDING_HEADING];
+    // 未記入の判定。新形式は「このプロジェクトについて」と「ゴール」の2つ、旧形式は1つの節を見る。
+    // **どちらの節も無ければ未記入。** 節ごと消えているプロジェクトが実在する
+    const checkHeadings = hasNew ? HOME_REQUIRED_GROUNDING_HEADINGS : [HOME_LEGACY_GROUNDING_HEADING];
     const unfilled = checkHeadings.some((h) => {
         const hit = find(h);
         return !hit || !hit.body.trim() || isUnwritten(hit.body);

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,6 +14,8 @@ exports.regRowOfToolItem = regRowOfToolItem;
 exports.toolsFoldSummary = toolsFoldSummary;
 exports.isAlreadyRegistered = isAlreadyRegistered;
 exports.sanitizeRegisteredNow = sanitizeRegisteredNow;
+exports.sanitizeIngestCounts = sanitizeIngestCounts;
+exports.sanitizeIngestFailures = sanitizeIngestFailures;
 exports.sanitizeStateNow = sanitizeStateNow;
 exports.overlayStateOnFleet = overlayStateOnFleet;
 exports.chatRowsToAdd = chatRowsToAdd;
@@ -38,6 +40,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 +61,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;
@@ -398,7 +404,7 @@ const CLAUDE_CODE_HOME = "https://claude.ai/code/";
 /** 素のリンクを**テストから固定するための入れ物**（LIVE_CONFIRM_LIMITS と同じ作法） */
 exports.CLAUDE_CODE_LINK = { home: CLAUDE_CODE_HOME };
 /**
- * 「この案件について聞く」導線の指示文。
+ * 「このプロジェクトについて聞く」導線の指示文。
  *
  * **AI 導線の指示文はここ1か所に持つ。** 書き写した先が増えると、URL は同じでも
  * **開いた先の AI への最初の一言が2通り**になる（`askAiUrl` と対で読む）。
@@ -1042,6 +1048,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,6 +1155,19 @@ 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;
@@ -2062,6 +2164,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 +2273,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 +2303,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 +2342,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);
 }
@@ -2702,6 +2902,9 @@ function deriveCapTile(cap, ctx) {
     var noToken = 0;
     var unreachable = 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)
@@ -2720,6 +2923,29 @@ function deriveCapTile(cap, ctx) {
         // ——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;
@@ -2753,6 +2979,13 @@ 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 };
+    }
     if (okSeen)
         return { rule: 3, state: "ok", text: "接続OK", keyMissing: false };
     // ---- 規則4: 実績なし → 中立 ----
@@ -2765,6 +2998,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 +3204,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 };
@@ -5192,6 +5482,17 @@ 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()}
 ${overlayStateOnFleet.toString()}
   // Home の「使用ツール」（#275）。**判定と表示語の実体はビルド時の定義**——
@@ -5222,6 +5523,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 +5539,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()}
@@ -5757,10 +6065,10 @@ ${calendarAddUrl.toString()}
   // 顧客も押すボタンなので、内側の運用事情を文面に出さない。
   var AI_COMMON = "";
   // Home（案件の入口）のAI編集。Gold層の4区画と違い規約READMEが無いので、Home自身を読ませて直させる。
-  // 「このプロジェクトが目指すもの」はAIが判断の方向を決める材料なので、未記入なら埋めることを促す。
+  // 「このプロジェクトについて」「ゴール」はAIが判断の方向を決める材料なので、未記入なら埋めることを促す。
   var HOME_EDIT_PROMPT = [
     "Cortex/Home.md を読んでから、このプロジェクトの入口ページを修正してください。",
-    "何を直すかは、まずわたしに質問してください。「この案件について」「ゴール」が未記入なら、そこを埋めるところから始めてください。",
+    "何を直すかは、まずわたしに質問してください。「このプロジェクトについて」「ゴール」が未記入なら、そこを埋めるところから始めてください。",
     "frontmatter（識別カード・engine 設定）は触らないでください。日付・進捗・実績値は書かないでください（変わるものの正本は課題管理ツール等の外部にあります）。",
     "このサイトの使い方の説明は書かないでください（説明は画面の側が持っています）。",
     "書き込む前に、変更内容を提示して承認を得てください。",
@@ -5774,7 +6082,7 @@ ${calendarAddUrl.toString()}
    * 「何をする案件か・誰のためか・どうなったら成功か」を必ず聞かせる。
    */
   var HOME_WRITE_PROMPT = [
-    "Cortex/Home.md を読んでから、このプロジェクトの「この案件について」「ゴール」の2つの節を埋めてください。",
+    "Cortex/Home.md を読んでから、「このプロジェクトについて」「ゴール」の2つの節を埋めてください。",
     "まず、わたしに質問して内容を聞き出してください。少なくとも次の3つを確かめてください: 何をするプロジェクトか／誰のためのプロジェクトか（顧客・利用者は誰か）／どうなったら成功と言えるか。",
     "聞き出した内容をもとに、2つの節を具体的な散文で書いてください。雛形の {{…}} は残さず、実際の内容に置き換えてください。",
     "この2つの節は、毎晩のAI生成（決定事項・用語集・メンバー・ルールの抽出）がプロジェクトを理解するために読む場所です。抽象的な言葉ではなく、このプロジェクトに固有の具体で書いてください。",
@@ -7150,7 +7458,7 @@ ${calendarAddUrl.toString()}
     "この仕組みについて": 1,
     "情報の見方": 1,
     "このサイトで見られるもの": 1,
-    "この案件について": 1,
+    "このプロジェクトについて": 1,
     "ゴール": 1,
     "体制": 1,
     "このプロジェクトが目指すもの": 1,
@@ -10762,6 +11070,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 +12182,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 +12197,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 のログ

package/package.json

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