@takagaki/cortex-decisions-viewer 0.10.0 → 0.10.2

package/dist/render.js

@@ -15,6 +15,7 @@ exports.materialRowsToAdd = materialRowsToAdd;
 exports.issueRowsToAdd = issueRowsToAdd;
 exports.unsettledRegisteredCount = unsettledRegisteredCount;
 exports.registeredRowsToAdd = registeredRowsToAdd;
+exports.subtractRemovedRegistered = subtractRemovedRegistered;
 exports.mergeRegisteredFleet = mergeRegisteredFleet;
 exports.nextStateDelay = nextStateDelay;
 exports.renderConnectionMap = renderConnectionMap;
@@ -769,9 +770,140 @@ function registeredRowsToAdd(view, reg) {
     };
 }
 /**
- * まとめ表の3キー（externalSources / internalSources / backlogTarget）に、足りない行を足す。
+ * 登録ファイルから**消された**行を、まとめ表の写しから引く（段A補・2026-08-22）。
  *
- * **足すだけ。** 既存の行・欄は1つも書き換えない。
+ * 「解除しました」と出るのに、リロードすると数分間残る——追加は足していたのに、
+ * 削除はまとめ表の作り直し待ちだった。登録ファイルは今の正本なので、
+ * そこに無い行は消されたということ。
+ *
+ * 🔴 **能力のキーが在るときだけ引く。** キーが無い＝登録ファイルが読めなかった、なので
+ * 引くと「読めない」が「全部消えた」に化ける。
+ * 🔴 **チャットは origin が "derived" の行だけ。** dev-sources.json 側にも宣言された行
+ * （explicit / both）は channels.json から消してもエンジンがまだ読む——隠すと
+ * 「読まれているのに画面に無い」という逆向きの嘘になる。
+ * 🔴 **チャットの突き合わせは ref だけ（追加側と非対称にしてある）。** まとめ表の
+ * workspace はエンジンが実測で埋めることがあり、宣言（登録ファイル）側と食い違う。
+ * ID＋WSで引くと、実測で埋まった行を**誤って隠す**。ref 一致の登録が1つでも残って
+ * いれば引かない——引き損ね（数分の遅れ）は安全側、誤削除は嘘なので。
+ */
+function subtractRemovedRegistered(view, reg) {
+    const v = view || {};
+    if (!reg)
+        return v;
+    let out = v;
+    const set = (patch) => { out = out === v ? Object.assign({}, v, patch) : Object.assign(out, patch); };
+    if (Array.isArray(reg.chat) || Array.isArray(reg.dev)) {
+        const chatRefs = {};
+        for (const r of reg.chat || [])
+            if (r && r.ref)
+                chatRefs[String(r.ref)] = true;
+        const devRefs = {};
+        for (const r of reg.dev || [])
+            if (r && r.ref)
+                devRefs[String(r.ref)] = true;
+        const before = v.externalSources || [];
+        const after = before.filter((s) => {
+            if (!s || !s.ref)
+                return true;
+            if (s.type === "slack" && Array.isArray(reg.chat)) {
+                if (s.origin !== "derived")
+                    return true;
+                return chatRefs[String(s.ref)] === true;
+            }
+            if (String(s.type || "").indexOf("github") === 0 && Array.isArray(reg.dev)) {
+                // 「読み取り停止中」（exclude）の行は登録簿の sources に居ないが、
+                // まとめ表はバッジを出すために保持している——引くと停止中の表示ごと消える
+                if (s.goldState === "excluded")
+                    return true;
+                return devRefs[String(s.ref)] === true;
+            }
+            return true;
+        });
+        if (after.length !== before.length)
+            set({ externalSources: after });
+    }
+    if (Array.isArray(reg.design) || Array.isArray(reg.materials)) {
+        const internals = ((out.internalSources || v.internalSources) || []).slice();
+        let changed = false;
+        if (Array.isArray(reg.design)) {
+            const keys = {};
+            for (const r of reg.design)
+                if (r && r.key)
+                    keys[String(r.key)] = true;
+            for (let i = 0; i < internals.length; i++) {
+                const it = internals[i];
+                if (!it || it.kind !== REGISTERED_CAP_NAMES.design || !Array.isArray(it.figmaFiles))
+                    continue;
+                const files = it.figmaFiles.filter((f) => f && keys[String(f.key)] === true);
+                if (files.length !== it.figmaFiles.length) {
+                    internals[i] = Object.assign({}, it, { figmaFiles: files });
+                    changed = true;
+                }
+            }
+        }
+        if (Array.isArray(reg.materials)) {
+            const ids = {};
+            for (const r of reg.materials)
+                if (r && r.id)
+                    ids[String(r.id)] = true;
+            for (let i = 0; i < internals.length; i++) {
+                const it = internals[i];
+                if (!it || it.kind !== REGISTERED_CAP_NAMES.materials || !Array.isArray(it.driveFolderIds))
+                    continue;
+                const kept = it.driveFolderIds.filter((id) => ids[String(id)] === true);
+                if (kept.length !== it.driveFolderIds.length) {
+                    const names = {};
+                    for (const id of kept)
+                        if (it.driveFolderNames && it.driveFolderNames[id])
+                            names[id] = it.driveFolderNames[id];
+                    const patch = { driveFolderIds: kept, driveFolderNames: names };
+                    // 0件になったら empty に倒す（正本が0件と言っている）。倒さないと
+                    // 一覧が**無言で空**になり「まだ登録されていません」も出ない。
+                    // **倒すのは on のときだけ**——broken（設定が読めない）/ off（意図的な停止）は
+                    // 別の答えなので潰さない
+                    if (!kept.length && it.driveState === "on")
+                        patch.driveState = "empty";
+                    internals[i] = Object.assign({}, it, patch);
+                    changed = true;
+                }
+            }
+        }
+        if (changed)
+            set({ internalSources: internals });
+    }
+    if (Array.isArray(reg.issues)) {
+        // 鍵の畳み方は足す側（issueRowsToAdd）と同じにする——別の畳み方にすると
+        // 大小の違いで「引いた直後に別綴りで足し直される」形になる
+        const issueKey = (t) => String(t.domain).toLowerCase() + "/" + String(t.projectKey).toUpperCase();
+        const keys = {};
+        for (const r of reg.issues)
+            if (r)
+                keys[issueKey(r)] = true;
+        const bt = (out.backlogTarget || v.backlogTarget);
+        const cur = bt && Array.isArray(bt.targets) ? bt.targets : bt && bt.domain && bt.projectKey ? [bt] : [];
+        const kept = cur.filter((t) => t && keys[issueKey(t)] === true);
+        if (kept.length !== cur.length) {
+            const patch = Object.assign({}, bt || {}, { targets: kept });
+            // 単数の2つは先頭の接続先。0件なら欄ごと消す（「無い」を装った値で残さない）
+            if (kept.length) {
+                patch.domain = kept[0].domain;
+                patch.projectKey = kept[0].projectKey;
+            }
+            else {
+                delete patch.domain;
+                delete patch.projectKey;
+            }
+            set({ backlogTarget: patch });
+        }
+    }
+    return out;
+}
+/**
+ * まとめ表の3キー（externalSources / internalSources / backlogTarget）を、登録ファイルの
+ * 今の姿に合わせる——**消された行を引いてから、足りない行を足す**（段A補）。
+ *
+ * 引き算の条件と守りは subtractRemovedRegistered が持つ。既存の行の**欄**は書き換えない
+ * （状態・origin・名前はまとめ表のまま）。
  *
  * ⚠ 同期ソースの行がまだ無い能力（＝夜間バッチが一度も走っていない案件）には、
  * **その能力の行を作る**——作らないと、登録した Figma ファイル・Drive フォルダを
@@ -781,7 +913,8 @@ function registeredRowsToAdd(view, reg) {
  * （まとめ表が持っている値は上書きしない）。
  */
 function mergeRegisteredFleet(view, reg) {
-    const v = view || {};
+    // 先に「消された行」を引き、そのうえで「足りない行」を足す（登録ファイルが今の正本）
+    const v = subtractRemovedRegistered(view || {}, reg);
     const out = {
         externalSources: v.externalSources,
         internalSources: v.internalSources,
@@ -1954,6 +2087,12 @@ a.ds-name:hover { text-decoration: underline; }
 .ds-keyrow { flex: 1 1 100%; min-width: 0; margin-top: 10px; padding-top: 10px; border-top: 1px solid var(--border); }
 /* 一覧の直後に置くとき（Figma）は、行の中ではないので区切り線を持たない */
 .ds-keyrow-list { margin-top: 10px; padding-top: 0; border-top: none; }
+/* 🔴 **hidden を効かせる（2026-08-22）。** 鍵の欄は接続先が0件のあいだ hidden 属性で
+   畳む（作らないのではなく隠す——理由は syncKeyCardVisibility の項）。ところが
+   .ops-card は display: flex、.ds-keyrow は flex アイテムを名乗るので、
+   UA 既定の [hidden] { display: none } が**負ける**。畳んだつもりで出たままになる。
+   ⚠ CSS は jsdom から見えないので、この行はテストでは守れない（実機で見ること）。 */
+[hidden] { display: none !important; }
 /* 行の中に入った鍵カードは、カードの枠を持たない（行の一部に見せる） */
 .ops-card.ds-keycard { border: none; box-shadow: none; padding: 0; background: transparent; gap: 6px; }
 .ops-card.ds-keycard > .ops-card-head { gap: 8px; }
@@ -2184,6 +2323,7 @@ ${designRowsToAdd.toString()}
 ${materialRowsToAdd.toString()}
 ${issueRowsToAdd.toString()}
 ${internalOf.toString()}
+${subtractRemovedRegistered.toString()}
 ${registeredRowsToAdd.toString()}
 ${unsettledRegisteredCount.toString()}
 ${mergeRegisteredFleet.toString()}
@@ -3662,6 +3802,29 @@ ${nextStateDelay.toString()}
     if (add.design.length) out[REGISTERED_CAP_NAMES.design] = 1;
     if (add.materials.length) out[REGISTERED_CAP_NAMES.materials] = 1;
     if (add.issues.length) out[REGISTERED_CAP_NAMES.issues] = 1;
+    // **引き算で0件になった能力も同じ語に倒す（段A補）。** 夜間の capabilities は
+    // まだ「on」なので、そのまま出すとタイルは「接続OK」・一覧は0件という矛盾になる。
+    // 「未接続」と言い切るのは夜間が追いついてから（capabilities は引き算の対象外）
+    var raw = rawView();
+    var sub = subtractRemovedRegistered(raw, LIVE_REGISTERED);
+    var count = function (list, isType) {
+      var n = 0;
+      for (var j = 0; j < (list || []).length; j++) if (list[j] && isType(list[j])) n++;
+      return n;
+    };
+    var isSlack = function (x) { return x.type === "slack"; };
+    var isGh = function (x) { return String(x.type || "").indexOf("github") === 0; };
+    if (count(raw.externalSources, isSlack) > 0 && count(sub.externalSources, isSlack) === 0) out["チャット"] = 1;
+    if (count(raw.externalSources, isGh) > 0 && count(sub.externalSources, isGh) === 0) out["開発"] = 1;
+    var dRaw = internalOf(raw.internalSources || [], REGISTERED_CAP_NAMES.design);
+    var dSub = internalOf(sub.internalSources || [], REGISTERED_CAP_NAMES.design);
+    if (dRaw && (dRaw.figmaFiles || []).length > 0 && dSub && (dSub.figmaFiles || []).length === 0) out[REGISTERED_CAP_NAMES.design] = 1;
+    var mRaw = internalOf(raw.internalSources || [], REGISTERED_CAP_NAMES.materials);
+    var mSub = internalOf(sub.internalSources || [], REGISTERED_CAP_NAMES.materials);
+    if (mRaw && (mRaw.driveFolderIds || []).length > 0 && mSub && (mSub.driveFolderIds || []).length === 0) out[REGISTERED_CAP_NAMES.materials] = 1;
+    var btRaw = raw.backlogTarget;
+    var rawTargets = btRaw && Array.isArray(btRaw.targets) ? btRaw.targets.length : btRaw && btRaw.domain ? 1 : 0;
+    if (rawTargets > 0 && Array.isArray(LIVE_REGISTERED.issues) && LIVE_REGISTERED.issues.length === 0) out[REGISTERED_CAP_NAMES.issues] = 1;
     return out;
   }
   /** その能力に、まとめ表がまだ知らない行があるか */
@@ -3773,6 +3936,113 @@ ${nextStateDelay.toString()}
     return null;
   }
 
+  /** 鍵の種別 → その鍵が効く能力。**3つの口が共有する対応表**（下の不変条件を参照） */
+  var SECRET_CAP = { figma: "デザイン", backlog: "課題管理" };
+
+  /**
+   * 「この画面の鍵の欄に貼ってください」と案内しているチェックの id → その鍵が効く能力。
+   *
+   * **欄が出ていないときに出すと、存在しない場所を指す案内になる。** 最後の接続先を
+   * 外した直後（登録は0件・夜間のチェックは古いまま）に実際にそうなっていた。
+   * **id をここ1箇所に集める**——散らすと片方だけ直る。
+   */
+  var KEY_POINTING_CHECKS = { backlog_secrets: "課題管理", figma_token: "デザイン" };
+
+  /**
+   * 応答に添えられた接続先の一覧を採ったときの件数（Backlog の adoptTargets）。
+   *
+   * **鍵の欄の出し入れだけがこれを見る。** まとめ表（fleetVal）が新しい接続先を知るのは
+   * 次の取り直しの後なので、これが無いと「行はその場で出るのに、鍵の欄だけ遅れて出る」。
+   * 一覧そのものの正本は adoptTargets が持つローカルの targets で、ここは写しにしない
+   *（件数しか持たないのは、判断に要るのが件数だけだから）。
+   * **節を作り直すときに捨てる**（buildDataSources の先頭）——作り直しはスナップショットから
+   * 描き直すことなので、そこから先は素直にスナップショットを信じる。
+   */
+  var ADOPTED_TARGET_COUNT = null;
+
+  /**
+   * 鍵（APIキー/トークン）が意味を持つ接続先の数（オーナー決定 2026-08-22）。
+   * **0件なら、鍵の入力欄もタイルの「⚠ トークンが未設定です」も出さない**——
+   * 繋ぐ先が無いのに鍵だけ求めるのは順番の逆な案内になる。最初の一歩は
+   * 「＋ 接続先を追加」に揃える（2026-08-12 の「未接続でも欄を出す」B判断を上書き）。
+   *
+   * 🔴 **口は3つ。全部この関数を通す**（0.4.71 からの不変条件を 2026-08-22 に拡張）:
+   *   1. 鍵の入力カードの表示／非表示（syncKeyCardVisibility）
+   *   2. タイルの「⚠ トークンが未設定です」（tokenRelevant）
+   *   3. 鍵の欄を指すチェック行（KEY_POINTING_CHECKS）
+   * 別々に書くと「欄はあるのに未設定と言われない」「言われるのに欄が無い」
+   * 「無い欄を指す案内だけが出る」のどれかが起きる（3つとも実機で出た形）。
+   */
+  function keyTargetCount(cap) {
+    if (cap === "課題管理") {
+      // 応答で採った一覧のほうが新しい（まとめ表が追いつくのは次の取り直しから）
+      if (ADOPTED_TARGET_COUNT != null) return ADOPTED_TARGET_COUNT;
+      return backlogTargetsNow(internalSourceOf("課題管理")).length;
+    }
+    if (cap === "デザイン") {
+      var d = internalSourceOf("デザイン");
+      return d && d.figmaFiles ? d.figmaFiles.length : 0;
+    }
+    return 1;
+  }
+
+  /**
+   * この画面がいま持っている鍵カード（種別つき）。secretCard が作るたびに載せ、
+   * buildDataSources が節を作り直すたびに入れ替える。
+   *
+   * **DOM を検索しないのはなぜか。** カードは buildDataSources の中で作られるが、
+   * 置かれるのは能力モーダルの中身（＝タイルを押すまで文書に入らない切り離されたノード）。
+   * 組み立て直後に document から探しても**1枚も見つからない**。
+   */
+  var KEY_CARDS = [];
+
+  /**
+   * 鍵の欄と、その受け皿の出し入れ（オーナー決定 2026-08-22）。
+   *
+   * 🔴 **カードは常に作る。隠すだけにする。** 生成そのものを止めると、
+   * **0件でモーダルを開いたまま最初の接続先を足しても欄が現れない**——
+   * カードを作るのは buildDataSources のループ1回きりで、そのあとの描き直し
+   *（paint / liveList）は**鍵の欄を作り直さない**（入力中の値と「保存中…」を守るため）。
+   * 節ごとの差し替え（refreshDataSources）もモーダルが開いている間は何もしない。
+   * つまり**閉じて開き直すまで出ない**。表示の切り替えなら描き直しのたびに当て直せる。
+   *
+   * **受け皿ごと隠す。** .ds-keyrow は margin-top / padding-top / border-top を持つので、
+   * カードだけ畳むと**理由の無い余白と区切り線**が残る（レビューで実測）。
+   * 判定は「中に見えているカードが1枚も無いか」——OFF にした能力で受け皿だけが
+   * 残る形（カードを作らずに return する経路）も同じ理由でここに拾われる。
+   *
+   * ⚠ **3つの口のうち、描き直しに追随するのはこのカードだけ。** タイルの注記
+   *（tokenRelevant）とチェック行（allChecks）は**節を組み立てるときに固定**される。
+   * したがって**モーダルを開いたまま最後の1件を外した瞬間だけ**、鍵の欄は消えるのに
+   * タイル側は古いまま（「トークンが未設定です」や鍵の欄を指す案内が残る）になりうる。
+   * 閉じれば節が作り直されて揃う。タイルはオーバーレイの裏で読めないので実害が小さいと
+   * 判断して、ここは合わせていない——**揃えるなら3つとも同じ描き直しに載せること**
+   *（注記だけを動的にすると、判定が1箇所という不変条件のほうが先に壊れる）。
+   */
+  function syncKeyCardVisibility() {
+    var shown = {};
+    for (var k in SECRET_CAP) {
+      if (Object.prototype.hasOwnProperty.call(SECRET_CAP, k)) shown[k] = keyTargetCount(SECRET_CAP[k]) > 0;
+    }
+    for (var i = 0; i < KEY_CARDS.length; i++) {
+      // **対応表に無い種別は隠さない**（keyTargetCount の既定と同じく出す側に倒す）。
+      // 3つ目の鍵が足されて分岐を書き忘れた場合は key-card-visibility の [全種0件] が落ちる
+      KEY_CARDS[i].el.hidden = shown[KEY_CARDS[i].kind] === false;
+    }
+    eachKeySlot(function (slot) {
+      slot.hidden = !slot.querySelector("[data-secret-kind]:not([hidden])");
+    });
+  }
+
+  /** いま在る鍵の受け皿（.ds-keyrow）を順に渡す。置き場の正本は KEY_SLOTS */
+  function eachKeySlot(fn) {
+    var slots = KEY_SLOTS.backlog || {};
+    for (var d in slots) {
+      if (Object.prototype.hasOwnProperty.call(slots, d) && slots[d]) fn(slots[d]);
+    }
+    if (KEY_SLOTS.figma) fn(KEY_SLOTS.figma);
+  }
+
   /**
    * 能力ごとの「**スナップショットが答えている集合**」。
    *
@@ -4125,6 +4395,10 @@ ${nextStateDelay.toString()}
 
   function buildDataSources() {
     KEY_SLOTS = { backlog: {}, backlogNamed: false, figma: null };
+    // 鍵カードも受け皿と同じく作り直す（前回の切り離されたカードを掴んだままにしない）
+    KEY_CARDS = [];
+    // 作り直しはスナップショットから描き直すこと。応答で採った件数はここで捨てる
+    ADOPTED_TARGET_COUNT = null;
     var internals = fleetVal("internalSources") || [];
     var sources = fleetVal("externalSources") || [];
     var pipes = fleetVal("pipelines") || [];
@@ -4521,7 +4795,7 @@ ${nextStateDelay.toString()}
     // 連携の鍵は、その能力のところへ置く（画面下まで往復させない）
     // **GitHub（「external-sources」）はここに無い。** 読み取りトークンは廃止し、
     // 読み取りは GitHub App に一本化した。**この表に戻すと入力欄が復活する**
-    var SECRET_CAP = { figma: "デザイン", backlog: "課題管理" };
+    // （対応表そのものは SECRET_CAP。3つの口で共有するので上に置いてある）
     (SITE.secretKinds || []).forEach(function (k) {
       if (!SECRET_FORMS[k]) return;
       // **意図的にOFFにした能力にだけ、入力欄を出さない（0.4.71）。** 使わないと決めたものに
@@ -4541,6 +4815,11 @@ ${nextStateDelay.toString()}
         }));
         return;
       }
+      // 🔴 **接続先が0件でも、ここでは return しない（オーナー決定 2026-08-22 の実装注意）。**
+      // 「0件なら鍵の欄を出さない」のは決まりだが、**生成を止めると直せなくなる**——
+      // モーダルを開いたまま最初の接続先を足しても、欄は閉じて開き直すまで現れない
+      //（作るのはこのループ1回きりで、以後の描き直しは鍵の欄を作り直さない）。
+      // カードは常に作り、出し入れは syncKeyCardVisibility が hidden で行う
       // **Backlog は接続先のスペースごとにカードを出す（2026-08-20・#127）。**
       // キーはスペースごとに別なので、欄が1つだと**どちらの鍵を入れたのか
       // 誰にも分からない**まま片方の棚に入る（入れたのに動かない、が起きる）。
@@ -4623,8 +4902,16 @@ ${nextStateDelay.toString()}
       figma_token: "デザイン", figma_inventory: "デザイン",
       dev_sources_registered: "開発", dev_issues_derived: "開発",
     };
+    // 🔴 **鍵の欄を指すチェックは、鍵の欄が出ているときだけ出す（オーナー決定 2026-08-22）。**
+    // 「この画面の『Backlog のAPIキー』に貼ってください」は、接続先が0件で欄を畳んでいる
+    // あいだは**存在しない欄を指す案内**になる（最後の接続先を外した直後に実際に出た。
+    // 夜間のチェックは古いままなので、登録が0件になっても missing が残っている）。
+    // **ここで落とすので、タイルの注記と「セットアップの残り」の両方から消える**
+    // ——片方だけで畳むと、落ちた行がもう片方に湧いて出る（loose の拾い直しに落ちるため）
     var allChecks = (fleetVal("checks") || []).filter(function (c) {
-      return c != null && c.status === "missing";
+      if (c == null || c.status !== "missing") return false;
+      var kc = KEY_POINTING_CHECKS[c.id];
+      return !(kc && keyTargetCount(kc) === 0);
     });
     // **タイルに出せたものを覚えておく。** 振り分け先の能力タイルが立たない案件
     //（tools に宣言が無い・行も無い）では出す場所が無くなり、項目が**黙って消える**。
@@ -4848,7 +5135,8 @@ ${nextStateDelay.toString()}
       // 「入力欄はあるのに未設定だと言われない」「言われるのに入力欄が無い」のどちらかが起きる。
       // 0.4.70 は unset で入力欄を畳んでいたので注記も抑えていたが、案A で欄を出すようにしたため揃えた
       // 導出が無いデータでは判断材料が無いので、注記を出す側（＝入力欄と揃う側）に倒す
-      var tokenRelevant = derived != null ? derived !== "off" : true;
+      // 接続先0件の抑止は入力欄と**同じ関数**を通す（keyTargetCount の 🔴 不変条件）
+      var tokenRelevant = (derived != null ? derived !== "off" : true) && keyTargetCount(cap) > 0;
       if (tokenRelevant && sk && (SITE.secretKinds || []).indexOf(sk) >= 0 && !((fleetVal("secretSources") || {})[sk])) {
         body.appendChild(el("div", { class: "ds-tile-note", text: "⚠ トークンが未設定です" }));
       }
@@ -4970,6 +5258,8 @@ ${nextStateDelay.toString()}
       sec.appendChild(todo);
     }
 
+    // 組み立てたカードに、いまの件数で表示／非表示を当てる（詳細は syncKeyCardVisibility）
+    syncKeyCardVisibility();
     return sec;
   }
   function renderDataSources() {
@@ -5266,6 +5556,10 @@ ${nextStateDelay.toString()}
       if (x && x.domain && x.projectKey) out.push({ domain: String(x.domain), projectKey: String(x.projectKey) });
     }
     if (out.length) return out;
+    // 🔴 **正本（issues-config.json）が読めていて0件のときは、url から復元しない（段A補）。**
+    // このフォールバックは「古いまとめ表に targets が無い」案件を救うためのもの。
+    // 正本が「無い」と言っているのに復元すると、**最後の1件を解除してもリロードで戻ってくる**
+    if (LIVE_REGISTERED && Array.isArray(LIVE_REGISTERED.issues) && LIVE_REGISTERED.issues.length === 0) return [];
     var u = (s && s.url && backlogTargetOf(s.url)) || null;
     return u ? [u] : [];
   }
@@ -5516,6 +5810,10 @@ ${nextStateDelay.toString()}
       // **出し入れのたびに反映中を当て直す。** 外している間の描き直しはこの行に届かない
       // ので、戻すときに当てないと古い文言のまま出る
       applyReflect(emptyEl, reflectingNow());
+      // 🔴 **鍵の欄の出し入れは、描き直しのたびに当て直す（2026-08-22）。** 最初の1件を
+      // 足した瞬間に欄が現れ、最後の1件を外した瞬間に消えるのはここが効いているから。
+      // 節ごとの差し替え（refreshDataSources）はモーダルが開いている間は何もしない
+      syncKeyCardVisibility();
     }
 
     /**
@@ -5533,6 +5831,9 @@ ${nextStateDelay.toString()}
         if (x && x.domain && x.projectKey) next.push({ domain: String(x.domain), projectKey: String(x.projectKey) });
       }
       targets = next;
+      // **鍵の欄の判断もこの一覧に従わせる（2026-08-22）。** keyTargetCount はまとめ表を
+      // 見るので、ここで教えないと「行はその場で出るのに鍵の欄だけ次の取り直しまで出ない」
+      ADOPTED_TARGET_COUNT = targets.length;
       paint();
       return targetsGenerationOf(targets) !== before;
     }
@@ -5561,9 +5862,14 @@ ${nextStateDelay.toString()}
         var dom = String(targets[ti].domain || "").toLowerCase();
         if (dom && domains.indexOf(dom) === -1) domains.push(dom);
       }
-      // **0件の案件にも1つ出す。** 「接続先を足してからでないと鍵を入れられない」形にすると、
-      // 立ち上げ直後の案件が最初の一歩を踏めない（#138 で直したのと同じ穴）。
+      // **0件の案件にも受け皿は1つ作る。ただし中身は隠れている（2026-08-22）。**
+      // オーナー決定で「接続先が0件なら鍵の欄は出さない」になったが、**作らないのではなく
+      // 隠す**——受け皿ごと無いと、モーダルを開いたまま最初の1件を足したときに
+      // 鍵の欄を置く場所が無く、閉じて開き直すまで現れない（syncKeyCardVisibility の項）。
+      // 受け皿は0件のあいだ hidden なので、区切り線と余白も出ない。
       // 空文字のキーは「どのスペースとも結び付いていない受け皿」で、行の中には入らない
+      //（足した接続先のドメインに対応するスロットは無いので、鍵の欄はこの受け皿に
+      //  残ったまま一覧の下に現れる。paint() はこのキーを移動の対象から外している）
       if (!domains.length) domains.push("");
       for (var di = 0; di < domains.length; di++) keySlots[domains[di]] = el("div", { class: "ds-keyrow" });
       KEY_SLOTS.backlog = keySlots;
@@ -5927,7 +6233,7 @@ ${nextStateDelay.toString()}
         // how / note）。全文をここに移すと二重になり、片方だけ直る形になる
         // ——カードは接続マップとタイルの注記と条件を揃えているので、動かすと壊れやすい。
         hint: [
-          "Figma でトークンを発行します（読み取りだけ。スコープ2つ）。手順は上の「Figma のトークン」の欄にあります。",
+          "Figma でトークンを発行します（読み取りだけ。スコープ2つ）。手順は「Figma のトークン」の欄にあります（ファイルを追加すると上に出ます）。",
           "発行したアカウントを、読み取りたい Figma ファイルに閲覧者として招待します（招待が無いと、トークンが正しくても読めません）。",
           "そのファイルのURLを下の欄に貼って「追加」を押します。",
           "追加したファイルは、画面名と Figma へのリンクが毎晩同期されます（画像は取り込まれません）。",
@@ -6840,6 +7146,9 @@ ${nextStateDelay.toString()}
       box.__sig = next;
       while (box.firstChild) box.removeChild(box.firstChild);
       build(box);
+      // 一覧が変わった＝接続先の件数が変わったかもしれない。鍵の欄を当て直す
+      // （Figma の鍵の欄は一覧の**外**にあるので、ここで見ないと取り残される）
+      syncKeyCardVisibility();
     };
     box.__rebuild();
     return box;
@@ -7360,7 +7669,7 @@ ${nextStateDelay.toString()}
     //     押すまで見えないと成立しない
     //   - .sec-preferred … 「誰のアカウントで発行するのか」を**手順より先に**伝える行。
     //     未登録のときだけ出る＝これから貼る人にだけ出るので、畳むと存在理由が消える
-    return el("div", { class: "ops-card" + (inRow ? " ds-keycard" : ""), "data-secret-kind": kind }, [
+    var card = el("div", { class: "ops-card" + (inRow ? " ds-keycard" : ""), "data-secret-kind": kind }, [
       el("div", { class: "ops-card-head" }, [
         el("span", { class: "ops-card-icon", text: meta.icon }),
         el("h3", { class: "ops-card-title", text: cardTitle }),
@@ -7381,6 +7690,11 @@ ${nextStateDelay.toString()}
       // 説明が落ちるのは、いちばん落としてはいけない種類の欠落
       el("p", { class: "sec-note", text: "入れた値はここには表示されません（保存だけできます）。保存先は案件ごとに分かれているので、他の案件には影響しません。" }),
     ]);
+    // **作った鍵カードは1枚残らずここに載せる。** 出し入れ（接続先が0件のときに畳む）は
+    // DOM 検索ではなくこの控えで回す——カードは能力モーダルの中身で、タイルを押すまで
+    // 文書に入っていないため（syncKeyCardVisibility の項）
+    KEY_CARDS.push({ kind: kind, el: card });
+    return card;
   }
 
   // ---------- 接続マップ（ビルド時生成のSVGを<template>から取り出して表示） ----------

package/package.json

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