@takagaki/cortex-decisions-viewer 0.12.70 → 0.12.72

package/dist/render.js

@@ -20,6 +20,7 @@ exports.sanitizeStateNow = sanitizeStateNow;
 exports.devExcludedSkip = devExcludedSkip;
 exports.devExcludedRefs = devExcludedRefs;
 exports.devExcludedLabel = devExcludedLabel;
+exports.devExcludedBadgeVisible = devExcludedBadgeVisible;
 exports.overlayStateOnFleet = overlayStateOnFleet;
 exports.chatRowsToAdd = chatRowsToAdd;
 exports.gchatRowsToAdd = gchatRowsToAdd;
@@ -567,8 +568,8 @@ const TOOL_KIND_ICONS = {
 };
 /**
  * 状態の表示語と色。**5 語＋「登録状況を確認中です」しか出さない**（読み取り中／
- * 接続OK（読み取りの対象外）／承認待ち／停止中／未確認、そして登録簿にしか無く
- * まだ測っていない行の「確認中」・#581 / #640）。
+ * 接続OK（活動を記録中）／承認待ち／停止中／未確認、そして登録簿にしか無く
+ * まだ測っていない行の「確認中」・#581 / #640 / #660）。
  *
  * 色は既存の `ds-gate-*` を流用する——同じ画面で「緑＝読めている・橙＝人の操作待ち・
  * 灰＝分からない」の意味を 2 通りに増やさない。
@@ -582,12 +583,17 @@ function toolStateLabel(state) {
     if (state === "reading")
         return { text: "読み取り中", cls: "ds-gate-ok" };
     // 届いてはいるが、Gold の材料にしていない（#640・engine #399）。**「読み取り中」と
-    // 言わない**——読みに行かないと決めた接続先なので、言えば画面が嘘をつく。
+    // 言わない**——決定・用語の材料にしないと決めた接続先なので、言えば画面が嘘をつく。
     // **警告色にもしない**（`ds-gate-ok` のまま）——直すものが無い中立の事実で、橙にすると
     // 直しに行かせる。状態名を `"excluded"` にしないのは、`liveToolItems` の中で
     // `match.excluded`（登録簿の devExcluded ＝「停止中」）が別の意味で使われているため
+    //
+    // 🔴 **語は行の札・タイルと同じ「活動を記録中」（#660）。** 2026-09-18 のオーナー決定で
+    // ソースの性質は種類で固定になり、GitHub は「作業の記録」に固定された。「読み取りの
+    // 対象外」は**何もしていない**ように読めるが、実際は活動を記録している——engine #480 で
+    // Issues / Discussions の活動が毎晩の観測に載るので、「対象外」は事実としても古い
     if (state === "ok_not_ingested")
-        return { text: "接続OK（読み取りの対象外）", cls: "ds-gate-ok" };
+        return { text: "接続OK（活動を記録中）", cls: "ds-gate-ok" };
     if (state === "waiting")
         return { text: "承認待ち", cls: "ds-gate-warn" };
     // 止めているものは警告色にしない（直す必要が無いので、橙にすると直しに行かせてしまう）
@@ -676,7 +682,7 @@ function regRowOfToolItem(item) {
  * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
  */
 function toolsFoldSummary(states) {
-    // 表示の順は状態の語と同じ（読み取り中→接続OK（読み取りの対象外）→承認待ち→停止中→
+    // 表示の順は状態の語と同じ（読み取り中→接続OK（活動を記録中）→承認待ち→停止中→
     // 未確認→登録状況を確認中です）。🔴 **新しい語をここへ足し忘れると、下の `order.indexOf`
     // が `unknown` へ倒すので、畳んだ 1 行だけが「未確認」と言う**（開くと違う語が出る・#640）
     var order = ["reading", "ok_not_ingested", "waiting", "stopped", "unknown", "pending"];
@@ -1315,23 +1321,55 @@ function devExcludedRefs(rows) {
     return out;
 }
 /**
- * 中立の行の理由文から、画面に出す短語を作る（#640）。
+ * 中立の行に添える札の語（#660。#640 では理由文から性質を切り出していた）。
+ *
+ * 🔴 **性質を括弧に入れない。** 2026-09-18 のオーナー決定（分類 A）で、ソースの性質は
+ * 登録ごとの選択肢ではなくなり**種類で固定**された。GitHub は「作業の記録」に固定で、
+ * 利用者が画面から変えられるものではない——変えられないものを行に出しても、
+ * 「どうすればよいか」が一つも増えない（#356 の原則「行は一手」）。
  *
- * 🔴 **engine が名指しを避けた性質を、画面が断定しない。** engine は性質が語彙
- * （会話／作業物／参照資料）に載っているときだけ名指しし、載っていなければ
- * 「ソースの性質により Gold の材料にしません」と書く（`gatedIngestedRow`）。
- * viewer に性質の語彙の写しは持たない——持つと 4 枚目の写しになり、engine が
- * 門に掛ける性質を増やした日に黙ってずれる（engine 設計レビュー🟡6 と同じ罠）。
- * **理由文が名指ししている語をそのまま括弧に入れる**のが、写しを増やさない唯一の形。
+ * 🔴 **「読み取りの対象外」とも言わない。** engine #480 から Issues / Discussions の活動は
+ * **毎晩の観測として貯まる**ので、「対象外」＝何もしていない、は事実として古い。
+ * 出すのは「活動を記録中」の 1 語だけで、「決定の材料にはしない」はモーダルの見出し・
+ * 注記・札の `title` が持つ（帯は症状・行は一手・繰り返さない・2026-09-02）。
+ *
+ * ⚠ **引数 `detail`（行の `ingestExcludedDetail`）は読まない**が、欄は残す——engine の理由文を材料にする実装へ
+ * 戻すときに呼び出し側を触らずに済む。**旧文面（`性質が◯◯のため…`）と新文面
+ * （`活動の記録として観測しています…`）のどちらでも同じ札**になることの番人は
+ * `dev-activity-words.test.mjs`（印の判定から DOM まで通す形で見る）。
  *
  * **クロージャを持たない純関数に保つこと**（`.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 + "）" : "読み取りの対象外";
+function devExcludedLabel(_detail) {
+    return "活動を記録中";
+}
+/**
+ * その行に「活動を記録中」の札を出すか（#660）。**判定を 1 本にするための関数。**
+ *
+ * 🔴 **アクセス不可の行には出さない。** 届いていない接続先に「記録中」と出すと、
+ * **アクセス不可を直す一手より先に「問題ない」と読める**。#640 は「片方を隠すと
+ * 『アクセス不可を直せば読まれる』と誤読させる」として常に出していたが、性質が
+ * 種類で固定になった（＝直せば読まれるようになる、という誤読の余地が消えた）いま、
+ * 残るのは「届いていないのに記録していると言う嘘」のほうなので、発注書 #660 の
+ * 「届くようにする一手が先」に倒す。タイル（規則2が規則3より先）と Home
+ * （`v.status === "ok"` の中だけ）は元からこの倒し方で、行だけが例外だった（R10）。
+ *
+ * 🔴 **測れていない回（`gate` が空）は出す。** engine は中立の 2 行を同じ晩に書くが、
+ * 片方しか届かない窓がある。そこを「出さない」に倒すと、画面が知っている事実を捨てる
+ * （`overlayStateOnFleet` の項・#640）。隠すのは**測った結果が悪かったとき**だけ。
+ *
+ * 🔴 **「読み取り停止中」（人が `dev-sources.json` の exclude で止めた）にも出さない。**
+ * 止めた行は engine が観測しなくなる＝古い中立の行が永久に残るうえ、止めてある以上は
+ * 記録もされない。灰色の札が 2 つ並ぶのも「繰り返さない」に反する（#640 実装レビュー🟡4）。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す。
+ * `probeSection` が押した結果でも同じ 1 本を呼ぶ——判定を 2 枚にしない）。
+ */
+function devExcludedBadgeVisible(s) {
+    if (!s || s.ingestExcluded !== true || s.goldState === "excluded")
+        return false;
+    var g = String(s.gate == null ? "" : s.gate);
+    return g === "" || g === "ok";
 }
 /**
  * ストアの「届くか」を行に重ねる。**まとめ表の時刻とは比べない。**
@@ -1377,7 +1415,9 @@ function devExcludedLabel(detail) {
  * **開発の行だけ、`ingested` の中立の行も載せる（#640）。** 「接続できる」と「Gold の
  * 材料にしている」は別の状態で、`reachable: ok` だけを載せると、読みに行かないと決めた
  * リポジトリが画面で「読み取り中」になる（engine #399 の申し送り）。載せる欄は
- * `ingestExcluded`（併記の札を出すか）と `ingestExcludedDetail`（語の括弧に入れる性質）。
+ * `ingestExcluded`（併記の札を出しうるか）と `ingestExcludedDetail`（engine が書いた理由文の
+ * 生値）。⚠ **理由文はいま画面に出ない**（#660 で札は engine の文面に依らない 1 語になった）
+ * ——engine の文面を材料にする実装へ戻すときのために、欄だけ運び続ける。
  * 🔴 **`goldState: "excluded"`（人が `dev-sources.json` の exclude で止めた）と別物。**
  */
 function overlayStateOnFleet(view, rows) {
@@ -3199,11 +3239,18 @@ function deriveCapTile(cap, ctx) {
     if (okSeen && sumFailed > 0) {
         return { rule: 3, state: "ok", text: "接続OK（" + sumOk + " 件取り込み・" + sumFailed + " 件失敗）", keyMissing: false };
     }
-    // **読みに行かないと決めた接続先は、件数で言う（#640）。** 「接続OK」の一言で丸めると
-    // 「決定・用語の材料になっている」と読めるし、⚠️ に落とすと直すものが無いのに直しに
-    // 行かせる。**帯は症状だけ**——性質を変える手順は行の補足が 1 行だけ持つ
+    // **決定・用語の材料にしていない接続先があれば、そう言う（#640・#660）。** 「接続OK」の
+    // 一言で丸めると「決定・用語の材料になっている」と読めるし、⚠️ に落とすと直すものが
+    // 無いのに直しに行かせる。**帯は症状だけ**——詳しい説明はタイルを開いた先の見出しが持つ。
+    //
+    // 🔴 **件数は出さない（#660）。** #640 は「読み取りの対象外が N 件」と数えていたが、
+    // 性質が種類で固定になった以上、GitHub の登録は**全件がこれ**で、N を出すと
+    // 「残りは読んでいる」と読める（#640 の申し送りにオーナー判断として上げてあった）。
+    // 語は行の札・Home と同じ「活動を記録中」に揃える（R10：タイルと行が違うことを言わない）。
+    // **`excluded` は分岐の材料としてそのまま使う**——孤児の篩（#523 決定2）と鮮度の門
+    // （`devExcludedRefs`）を通った件数が 0 なら、この枝に来てはいけない
     if (okSeen && excluded > 0) {
-        return { rule: 3, state: "ok", text: "接続OK（読み取りの対象外が " + excluded + " 件）", keyMissing: false };
+        return { rule: 3, state: "ok", text: "接続OK（活動を記録中）", keyMissing: false };
     }
     if (okSeen)
         return { rule: 3, state: "ok", text: "接続OK", keyMissing: false };
@@ -5129,7 +5176,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-not-ingested-note,
+.ds-drive-note, .ds-inactive-note, .ds-gate-help,
 /* 案件カレンダーの行（#428）。**カレンダー ID は空白の無い長い連なり**で、
    失敗の理由（detail）も長さが読めない。ここを外すと会議のモーダルが横に溢れる */
 .mt-cal-banner, .mt-cal-note, .mt-cal-warn, .mt-cal-primary, .mt-cal-sub, .mt-cal-id .rt-copy-text,
@@ -5178,13 +5225,11 @@ a.ds-tile:hover { text-decoration: none; }
    トグルを撤去したいま、読み取られていないことを示すのはこのバッジだけ。
    **判断のバッジなので、由来や組織のバッジより強く出す** */
 .badge.ds-excluded { background: #f3f4f6; color: #4b5563; border: 1px solid #d1d5db; }
-/* 「接続はできるが Gold の材料にしていない」印（#640）。**「読み取り停止中」と同じ灰色**
-   ——どちらも「いまこの接続先がどう扱われているか」の印で、直すものが無い中立の事実。
-   橙（警告）にすると、直しようのないものを直しに行かせる */
+/* 「接続はできるが、決定・用語集の材料にしていない」印（#640・語は #660）。
+   **「読み取り停止中」と同じ灰色**——どちらも「いまこの接続先がどう扱われているか」の印で、
+   直すものが無い中立の事実。橙（警告）にすると、直しようのないものを直しに行かせる。
+   届いていない回は 「hidden」 で伏せる（上の [hidden] の !important が inline-block に勝つ） */
 .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）。**由来のバッジと同じ強さにする**——
@@ -5462,6 +5507,19 @@ a.ds-tile:hover { text-decoration: none; }
 .ops-card-icon { font-size: 22px; line-height: 1; }
 .ops-card-title { font-size: 15px; font-weight: 700; color: var(--text); margin: 0; }
 .ops-card-desc { color: var(--muted); font-size: 13px; line-height: 1.7; margin: 0; flex: 1 1 auto; }
+/* 手動投入のカードの「どう送ると良いか」（#663）。
+   🔴 **margin: 0 を明示する**——.ops-card は column flex の gap: 10px なので、
+   素の <p> だとブラウザ既定マージンが gap に上乗せされて段が離れる（.ops-card-desc と同じ理由）。
+   **色を desc と同じ var(--muted) にしない**——地続きに見えて「段を分ける」意図が消える。
+   左罫で説明文と役割が違うことを示す。**罫は var(--border) にしない**——#e3e6ea は白地に対して
+   コントラスト比 1.15 で、実機ではほぼ見えない（実装レビュー🟡5）。
+   🔴 **このルールは番人テストが見ている。** CSS は <style> に埋め込まれるので、
+   丸ごと消す・display: none を足す形の退行は material-intake-wording.test.mjs が赤にする
+   （「CSS は jsdom から見えない」は誤りだった・実装レビュー🔴1）。 */
+.ops-card-hint {
+  margin: 0; font-size: 12.5px; line-height: 1.7; color: var(--text);
+  border-left: 3px solid var(--accent); padding: 2px 0 2px 10px;
+}
 .ops-card-btn {
   align-self: flex-start; display: inline-flex; align-items: center; gap: 4px;
   padding: 8px 16px; border-radius: 999px; border: 1px solid var(--accent);
@@ -5806,6 +5864,7 @@ ${sanitizeStateNow.toString()}
 ${devExcludedSkip.toString()}
 ${devExcludedRefs.toString()}
 ${devExcludedLabel.toString()}
+${devExcludedBadgeVisible.toString()}
 ${overlayStateOnFleet.toString()}
   // Home の「使用ツール」（#275）。**判定と表示語の実体はビルド時の定義**——
   // 画面側に書き写すと、状態の言い換えが 2 枚になって片方だけ直る。
@@ -8996,20 +9055,14 @@ ${calendarAddUrl.toString()}
       // Issues と Discussions は同じ接続先（同じ dev 行）なので、理由・補足は1本目だけが
       // 持つ（#346）。同じ長文が2行に並ぶと一覧が案内で埋まる
       var seenRef = {};
-      // 「材料にしていない」の 1 行は、**この組織で実際に出した行があってから**畳む（#640）。
-      // 🔴 「seenRef」 を写経して「1 本目かどうか」でフラグを立てると、1 本目が
-      // 併記を持たない行だったときにフラグだけ消費され、**その組織のどの行にも
-      // 補足が出ない**（設計レビュー🟡5）。**出した行だけを数える**
-      var shownExcluded = false;
+      // ⚠ 「quietExcluded」（「材料にしていない」の補足を組織で 1 回だけ出す仕掛け）は
+      // #660 で撤去した——補足そのものを撤去したので、畳む対象が無い。**足し戻すときは
+      // 「1 本目かどうか」ではなく「実際に出した行があったか」で数えること**（1 本目が
+      // 出さない行だったときにフラグだけ消費され、その組織のどの行にも出なくなる・#640 設計レビュー🟡5）
       var cards = g.items.map(function (x) {
         var again = !!(x.ref && seenRef[x.ref]);
         if (x.ref) seenRef[x.ref] = 1;
-        // 🔴 **フラグを立てるのは、その行が実際に補足を出すときだけ。** 出さない行
-        //（同じ 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 });
+        return extSourceCard(x, DS_TYPE[x.type] || { icon: "🔗", label: x.type || "その他" }, { quietHelp: again });
       });
       if (g.state === "warn") {
         out.push(orgNoteBox(githubNotConnectedNodes(g), cards));
@@ -10357,7 +10410,11 @@ ${calendarAddUrl.toString()}
         : " Cortex のアプリは、会話の読み取りと、通知先に設定したスペースへの確認・通知の投稿だけに使われます。読み取った会話は、本文そのものを保存するのではなく、決定事項・用語などの抽出結果としてプロジェクトの記録に反映されます。";
       m.modal.appendChild(el("p", { class: "modal-desc", text: "ここに並んでいる" + chatNoun + "は、例外なく全て毎晩の Gold 昇格が読み取り、Decision・用語集の材料になります。読み取りを止めるには「登録を解除」してください。" + chatScope }));
     } else if (cap === "開発") {
-      m.modal.appendChild(el("p", { class: "modal-desc", text: "ここに並んでいるリポジトリの Issues を毎晩の Gold 昇格が読み取り、Decision・用語集の材料になります。読み取りをやめるには「登録から削除」してください。" }));
+      // 🔴 **開発の開示文は「記録に使う・決定の抽出には使わない」（#660）。** 2026-09-18 の
+      // オーナー決定でソースの性質は種類で固定になり、GitHub は「作業の記録」に固定された。
+      // **この 2 文が「決定の材料にはしない」を言う唯一の場所**——行の札は「活動を記録中」と
+      // だけ言い、同じ文を行ごとに繰り返さない（帯は症状・行は一手・繰り返さない・2026-09-02）
+      m.modal.appendChild(el("p", { class: "modal-desc", text: "ここに並んでいるリポジトリの Issues と PR の活動を、毎晩記録として読みます（誰が何をしているかの把握に使います）。決定・用語集の抽出には使いません。記録をやめるには「登録から削除」してください。" }));
     }
     // **なぜこの状態なのかを、押した先でも読めるようにする（#125②）。** タイルは常時出す
     // ようになったので、未接続の能力を押したときに中身が空になる場面が増えた。
@@ -11528,8 +11585,11 @@ ${calendarAddUrl.toString()}
     }
 
     // 注記は全能力の後ろに1つ。**何が Gold の材料になるのかを1文で言う。**
+    // 🔴 **GitHub を同じ文に混ぜない（#660）。** 性質が種類で固定になり、GitHub は
+    // 決定・用語集の材料にしない。ひとまとめに「材料になります」と言うと、この注記だけが
+    // 画面の他の全部（見出し・行の札・タイル）と食い違う
     if (anyCap) {
-      sec.appendChild(el("p", { class: "ds-note", text: "登録されている Slack チャンネル・Google Chat スペース・GitHub リポジトリは、毎晩の Gold 昇格が読み取り、Decision・用語集の材料になります。チャンネルとスペースは登録を解除すると、リポジトリは登録から削除すると、以後は読み取られません。" }));
+      sec.appendChild(el("p", { class: "ds-note", text: "登録されている Slack チャンネル・Google Chat スペースは、毎晩の Gold 昇格が読み取り、Decision・用語集の材料になります。GitHub リポジトリは Issues と PR の活動を記録として読み、決定・用語集の材料にはしません。チャンネルとスペースは登録を解除すると、リポジトリは登録から削除すると、以後は読み取られません。" }));
     }
 
     if (pipes.length) {
@@ -11978,6 +12038,17 @@ ${calendarAddUrl.toString()}
         var v = probeVerdict(s, j);
         gateEl.className = "ds-gate " + v.cls;
         gateEl.textContent = v.text;
+        // 🔴 **「活動を記録中」の札も、押した結果で出し入れする（#660）。** ここを忘れると、
+        // アクセス不可の行を直して押したときに**行は「接続OK」なのに札だけ消えたまま**に
+        // なり、「決定の材料になっている」と読める（逆向きも同じで、届かなくなった行が
+        // 「記録中」と言い続ける）。**判定は 「devExcludedBadgeVisible」 1 本**——
+        // 描画時と押した後で別の条件を書くと、同じ行が 2 つのことを言う
+        var exBadgeNow = card.querySelector(".badge.ds-not-ingested");
+        if (exBadgeNow) {
+          exBadgeNow.hidden = !devExcludedBadgeVisible({
+            ingestExcluded: s.ingestExcluded, goldState: s.goldState, gate: j.gate,
+          });
+        }
         // 古い「X分前に確認」を残さない（下に出るいまの結果と、時刻が2つ並ぶ）
         var oldAt = card.querySelector(".ds-gate-at");
         if (oldAt) oldAt.remove();
@@ -13942,7 +14013,10 @@ ${calendarAddUrl.toString()}
         hint: [
           { text: "読み取りたいリポジトリがある組織に、Cortex の GitHub App を入れます（Issues の読み取りだけ）。", node: appInstallLink() },
           "そのリポジトリを下の欄に入れて「追加」を押します（owner/repo でも、GitHub のURLでも構いません）。",
-          "追加したリポジトリの Issues が、毎晩の Gold 昇格の材料になります。やめるときは、その行の「登録から削除」を押します。",
+          // #660: 「Gold 昇格の材料になります」は嘘になった（性質が種類で固定・GitHub は
+          // 決定の抽出に使わない）。**手順の最終行が伝える重さは「記録に入る」**——
+          // 追加が Gold 昇格の意思決定になるチャット（上の 2 つ）とは別の文にする
+          "追加したリポジトリの Issues と PR の活動が、毎晩の記録に入ります（決定・用語集の材料にはしません）。やめるときは、その行の「登録から削除」を押します。",
         ],
         build: function (repo, name) { return { op: "add-github-source", repo: repo, name: name }; },
         adder: "github",
@@ -14628,11 +14702,7 @@ ${calendarAddUrl.toString()}
         title: "このリポジトリは読み取り対象から除外されています（開発の登録ファイル dev-sources.json の exclude）。この画面からは戻せません。",
       }));
     }
-    // 「接続できる」と「Gold の材料にしている」を別の状態として併記する（#640・engine #399）。
-    //
-    // **常に出す（gate の値で隠さない）。** 届かないことと材料にしていないことは別の事実で、
-    // 片方を隠すと「アクセス不可を直せば読まれる」と誤読させる（#523・オーナー決定
-    // 「操作タブは常に真実を表示する」）。
+    // 「接続できる」と「決定の材料にしている」を別の状態として併記する（#640・#660）。
     //
     // 🔴 **「ds-gate」 ではなく 「badge」 で出す。** 行の「判定のバッジは 1 つ」を
     // 「connection-probe.test.mjs」 が見張っており、「probeSection」 も 「gateEl」 の参照 1 本で
@@ -14641,17 +14711,32 @@ ${calendarAddUrl.toString()}
     // ——どちらも「判定」ではなく「この接続先がいまどう扱われているか」の印。
     //
     // 🔴 **警告色にしない。** 直すものが無い中立の事実で、橙にすると直しに行かせる。
-    // 語は短く（長文を入れると行が折り返す）——性質の変え方は下の補足 1 行が持つ
-    // 🔴 **「読み取り停止中」の行には出さない（実装レビュー🟡4）。** 人が exclude で止めた
-    // 行は engine が観測しなくなる＝ 2 行とも書き直されないので、古い中立の行が永久に残る。
-    // しかも止めてある以上、性質を「会話」にしても読まれない——**効かない一手**を案内する
-    // ことになる。灰色の札が 2 つ並ぶのも「繰り返さない」に反する
-    if (s.ingestExcluded === true && s.goldState !== "excluded") {
-      badges.appendChild(el("span", {
+    // 語は短く（長文を入れると行が折り返す）——「決定の材料にはしない」はモーダルの
+    // 見出しと 「title」 が持つ（#660。行ごとに繰り返さない・2026-09-02）。
+    //
+    // 🔴 **要素は必ず作り、出し入れは 「hidden」 でやる（#660）。** 出す条件は
+    // 「devExcludedBadgeVisible」 1 本だが、「probeSection」 は押した結果で 「.ds-gate」 しか
+    // 差し替えない。作らずに条件分岐で消すと、**アクセス不可の行を直して「接続を確認」を
+    // 押しても札が戻らない**（行は「接続OK」なのに札が無い＝材料にしていると読める）。
+    // 「[hidden]」 に 「display:none !important」 を当ててあるので、「.badge」 の
+    // 「display:inline-block」 に負けない
+    // 🔴 **作るかどうかも 「devExcludedBadgeVisible」 に決めさせる（判定を 2 枚にしない）。**
+    // 「gate を ok にしたら出るか」＝「この行はそもそも札を持ちうるか」。条件を書き写すと、
+    // 「読み取り停止中」の扱いを片方だけ直した日に、**作られるが永久に伏せられる札**や
+    // **止めてある行の札**が生まれる（実装レビュー🟡3）
+    if (devExcludedBadgeVisible(Object.assign({}, s, { gate: "ok" }))) {
+      var exBadge = el("span", {
         class: "badge ds-not-ingested",
         text: devExcludedLabel(s.ingestExcludedDetail),
-        title: "接続はできています。この登録は Gold（決定・用語・メンバー・ルール）の材料にしていません。",
-      }));
+        // ⚠ **「接続はできています」と書かない。** 到達性をまだ測れていない回（gate が空）も
+        // 札は出るので、行の判定が「登録状況を確認中です」なのに title だけが接続を断言する
+        //（同じ行が 2 つのことを言う・実装レビュー🟡2）
+        title: "Issues と PR の活動を記録として読みます。決定・用語集の材料にはしません。",
+      });
+      // ⚠ 「el」 は属性で渡す（「setAttribute("hidden", false)」 は 「hidden="false"」 になり、
+      // HTML では**存在するだけで真**）。真偽はプロパティで入れる
+      exBadge.hidden = !devExcludedBadgeVisible(s);
+      badges.appendChild(exBadge);
     }
     if (s.notify === true) badges.appendChild(notifyBadge());
     // **どのワークスペースのチャンネルかを、必ず行に出す（#104・2026-08-20 に社内も）。**
@@ -14814,9 +14899,16 @@ ${calendarAddUrl.toString()}
               // **「読み取りを止める」への案内は消した（2026-08-21）。** そのボタンごと
               // 撤去したので、指す先が画面に無い。**代わりの手段は書かない**
               //——削除がその手段そのもので、他に無い
-              "次回の Gold 昇格から、このリポジトリの Issues は読み取られません。",
+              "次回の夜間の処理から、このリポジトリの Issues と PR の活動は記録されません。",
               "",
-              "すでに作られた Decision・用語集は消えません。",
+              // 🔴 **不可逆性を必ず書く**（docs/setup-ui-spec.md の確認ダイアログの規則）。
+              // #660 で「すでに作られた Decision・用語集は消えません。」は落とした
+              //——GitHub は決定・用語集の材料にしないと画面が 4 か所で言い切る以上、
+              // この 1 行だけが「GitHub が Decision を作った」と言うことになる。
+              // **代わりに、いま本当に残るもの**を書く: 観測の台帳（engine の obs/）は
+              // Delete が Deny で**誰にも消せない**ので、「記録中」と言い切るぶん
+              // #640 のときより強い事実になっている
+              "すでに記録した活動は消えません。",
               "",
               "削除しますか？",
             ];
@@ -14850,28 +14942,13 @@ ${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 + "」なので、" : "この登録は、")
-          + "決定・用語・メンバー・ルールの材料にしていません。議論の場として読ませるなら、登録簿で性質を「会話」にしてください",
-      }));
-    }
+    // 🔴 **「材料にしていない」の補足（「ds-not-ingested-note」）は撤去した（#660）。**
+    // #640 の文は「この登録は『作業物』なので…議論の場として読ませるなら、登録簿で性質を
+    // 『会話』にしてください」で、**画面に定義の無い語で JSON を手で直せと言っていた**
+    //（実測: 艦隊 49 案件・GitHub 登録 53 行で切り替えた案件は 0 件）。2026-09-18 の
+    // オーナー決定で性質は種類で固定になり、**利用者が変えられる一手はもう無い**ので、
+    // 行に長文を置く理由が消えた。言うべきことはモーダルの見出し（能力を開いた先の 2 文）と
+    // 札の 「title」 が持つ。**足し戻さないこと**（行は一手・繰り返さない・2026-09-02）
     // 「接続を確認」（2026-08-19）。**押せる人を絞らない**——読むだけで設定を変えないので、
     // 気づいた人がその場で確かめられるほうがよい（オーナー判断）。書き込みになる
     // 「表示名を更新する」は、押した結果の中から別のボタンとして出る（probeSection）。
@@ -15435,7 +15512,17 @@ ${calendarAddUrl.toString()}
       return opsCard("🗒️", "会議の文字起こしを追加", "顧客主催の会議など、自動取り込みできない会議の文字起こしファイル（.txt / .docx 等）から議事録を生成します。ファイルを選ぶかテキストを貼って送信すると、数分で反映されます。", "transcript", "文字起こしを追加");
     }
     if (cap === "共有資料") {
-      return opsCard("📎", "共有資料を追加", "提案書・仕様書・議事メモなどの資料を Markdown 化して 共有資料 に取り込みます。ファイルを選ぶかテキストを貼って送信すると、数分で反映されます。", "material", "資料を追加");
+      // hint（#663）: 文字の層が無い PDF（画面の印刷・スキャン・画像を貼ったもの）は
+      // どの変換ツールでも文字が取れない。**「PDF が読めない」とは言わない**——読めないのは
+      // 画面を保存したものとスキャン・写真から作ったものだけで、文字の層がある PDF は今までどおり読める。
+      // **「画面を印刷した PDF」と書かない**（実装レビュー🟡4）——実際の操作は macOS の
+      // 印刷ダイアログの「PDF として保存」で、当人は「印刷していない」と読む。「スキャンした画像」も
+      // 同じで、スキャナの出力は普通 PDF なので「自分のは画像じゃない」と読まれる。
+      // **Google のスライド・ドキュメントは書かない**——「元のファイル」がローカルに存在せず、
+      // 書き出す時点で必ず形式を選ばされるので、指示どおりに行動できない（設計レビュー🔴3）。
+      // その一手は docs/ops-ui-user-stories.md の Drive の節が持つ。
+      return opsCard("📎", "共有資料を追加", "提案書・仕様書・議事メモなどの資料を Markdown 化して 共有資料 に取り込みます。ファイルを選ぶかテキストを貼って送信すると、数分で反映されます。", "material", "資料を追加",
+        "PowerPoint・Word・Excel は、PDF にせず元のファイルのまま送ってください（そのほうが正確に読めます）。画面を「PDF として保存」したものや、スキャン・写真から作った PDF は、文字を取り出せないので中身が空になります。");
     }
     return null;
   }
@@ -16200,7 +16287,17 @@ ${calendarAddUrl.toString()}
     if (!mapAsOf) return;
     wrap.appendChild(el("p", { class: "conn-map-asof", text: "設定と件数は " + mapAsOf + " 時点・接続状態は最新です。" }));
   }
-  function opsCard(icon, title, desc, kind, btnLabel) {
+  /**
+   * 手動投入のカード。hint は任意（#663）。
+   *
+   * **説明文と同じ段落に混ぜない。** 1 段目（desc）は「押すと何が起きるか」、
+   * 2 段目（hint）は「どう送ると良いか」で役割が違う。渡さなければ段ごと出ないので、
+   * 会議のカードは 1 文字も変わらない。
+   *
+   * ⚠ この関数は埋め込み JS（テンプレートリテラル）の中にある。**コメントにバッククォートを
+   * 書かない**——その場でリテラルが閉じて、離れた行が構文エラーになる。
+   */
+  function opsCard(icon, title, desc, kind, btnLabel, hint) {
     var btn = el("button", { class: "ops-card-btn", text: "＋ " + btnLabel });
     btn.addEventListener("click", function () { openIntakeModal(kind); });
     return el("div", { class: "ops-card" }, [
@@ -16209,6 +16306,7 @@ ${calendarAddUrl.toString()}
         el("h3", { class: "ops-card-title", text: title }),
       ]),
       el("p", { class: "ops-card-desc", text: desc }),
+      hint ? el("p", { class: "ops-card-hint", text: hint }) : null,
       btn,
     ]);
   }
@@ -16353,9 +16451,19 @@ ${calendarAddUrl.toString()}
     var mk = makeModal(isT ? "会議の文字起こしを追加" : "共有資料を追加", false);
     var overlay = mk.overlay;
     var modal = mk.modal;
+    // 🔴 **資料の案内はカードだけでは届かない**（#663・設計レビュー🔴2）。makeModal は
+    // 前のオーバーレイを必ず閉じるので、**ファイルを選ぶ瞬間、カードの hint は画面に無い**。
+    // 事故（画面を印刷した PDF を投入して日本語 0 文字）が起きるのはこの文を読んでいる最中なので、
+    // 症状と一手はここにも要る。**カードと同じ文は書かない**——「繰り返さない」は
+    // 「同じ説明を段を変えて並べるな」であって、事故の瞬間に黙れという意味ではない。
+    // **症状を括弧に落として一手を前に出す**（実装レビュー🟡3）。ただし症状そのものは消さない
+    // ——元のファイルを持っていない人（Slack の画面を保存した人）には「元のファイルを優先」が
+    // 一手にならず、自分の PDF が駄目だと分かるのは症状の側だけだから。
+    // 列挙の先頭を PDF から元のファイルに入れ替えてある（**受け付ける拡張子は 1 つも変えていない**。
+    // allowedExt は下のまま）。
     modal.appendChild(el("p", { class: "modal-desc", text: isT
       ? "文字起こしファイル（テキスト・Word・PDF・字幕 等）を選んで送信してください。（送信後、数分で議事録が自動生成されます）"
-      : "資料ファイル（PDF・Word・PowerPoint・Excel・テキスト・画像 等）を選んで送信してください。（送信後、数分で内容が Markdown に変換されて取り込まれます）" }));
+      : "資料ファイル（PowerPoint・Word・Excel・PDF・テキスト・画像 等）を選んで送信してください。元のファイルがあれば PDF より優先してください（画面を保存した PDF・スキャンした PDF からは文字を取り出せません）。（送信後、数分で内容が Markdown に変換されて取り込まれます）" }));
 
     var selectedFiles = [];
     var allowedExt = isT

package/package.json

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