@takagaki/cortex-decisions-viewer 0.10.1 → 0.10.2

package/dist/render.js

@@ -2087,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; }
@@ -3930,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);
+  }
+
   /**
    * 能力ごとの「**スナップショットが答えている集合**」。
    *
@@ -4282,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") || [];
@@ -4678,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）。** 使わないと決めたものに
@@ -4698,6 +4815,11 @@ ${nextStateDelay.toString()}
         }));
         return;
       }
+      // 🔴 **接続先が0件でも、ここでは return しない（オーナー決定 2026-08-22 の実装注意）。**
+      // 「0件なら鍵の欄を出さない」のは決まりだが、**生成を止めると直せなくなる**——
+      // モーダルを開いたまま最初の接続先を足しても、欄は閉じて開き直すまで現れない
+      //（作るのはこのループ1回きりで、以後の描き直しは鍵の欄を作り直さない）。
+      // カードは常に作り、出し入れは syncKeyCardVisibility が hidden で行う
       // **Backlog は接続先のスペースごとにカードを出す（2026-08-20・#127）。**
       // キーはスペースごとに別なので、欄が1つだと**どちらの鍵を入れたのか
       // 誰にも分からない**まま片方の棚に入る（入れたのに動かない、が起きる）。
@@ -4780,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 に宣言が無い・行も無い）では出す場所が無くなり、項目が**黙って消える**。
@@ -5005,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: "⚠ トークンが未設定です" }));
       }
@@ -5127,6 +5258,8 @@ ${nextStateDelay.toString()}
       sec.appendChild(todo);
     }
 
+    // 組み立てたカードに、いまの件数で表示／非表示を当てる（詳細は syncKeyCardVisibility）
+    syncKeyCardVisibility();
     return sec;
   }
   function renderDataSources() {
@@ -5677,6 +5810,10 @@ ${nextStateDelay.toString()}
       // **出し入れのたびに反映中を当て直す。** 外している間の描き直しはこの行に届かない
       // ので、戻すときに当てないと古い文言のまま出る
       applyReflect(emptyEl, reflectingNow());
+      // 🔴 **鍵の欄の出し入れは、描き直しのたびに当て直す（2026-08-22）。** 最初の1件を
+      // 足した瞬間に欄が現れ、最後の1件を外した瞬間に消えるのはここが効いているから。
+      // 節ごとの差し替え（refreshDataSources）はモーダルが開いている間は何もしない
+      syncKeyCardVisibility();
     }
 
     /**
@@ -5694,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;
     }
@@ -5722,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;
@@ -6088,7 +6233,7 @@ ${nextStateDelay.toString()}
         // how / note）。全文をここに移すと二重になり、片方だけ直る形になる
         // ——カードは接続マップとタイルの注記と条件を揃えているので、動かすと壊れやすい。
         hint: [
-          "Figma でトークンを発行します（読み取りだけ。スコープ2つ）。手順は上の「Figma のトークン」の欄にあります。",
+          "Figma でトークンを発行します（読み取りだけ。スコープ2つ）。手順は「Figma のトークン」の欄にあります（ファイルを追加すると上に出ます）。",
           "発行したアカウントを、読み取りたい Figma ファイルに閲覧者として招待します（招待が無いと、トークンが正しくても読めません）。",
           "そのファイルのURLを下の欄に貼って「追加」を押します。",
           "追加したファイルは、画面名と Figma へのリンクが毎晩同期されます（画像は取り込まれません）。",
@@ -7001,6 +7146,9 @@ ${nextStateDelay.toString()}
       box.__sig = next;
       while (box.firstChild) box.removeChild(box.firstChild);
       build(box);
+      // 一覧が変わった＝接続先の件数が変わったかもしれない。鍵の欄を当て直す
+      // （Figma の鍵の欄は一覧の**外**にあるので、ここで見ないと取り残される）
+      syncKeyCardVisibility();
     };
     box.__rebuild();
     return box;
@@ -7521,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 }),
@@ -7542,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.1",
+  "version": "0.10.2",
   "description": "Cortexの意思決定記録（Decisions/*.md）を静的サイトにビルドして閲覧する。各レコードに「Edit on GitHub」リンクを付与する。",
   "license": "UNLICENSED",
   "private": false,