@takagaki/cortex-decisions-viewer 0.12.50 → 0.12.52

package/dist/render.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STATE_CONFIRMING = 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.ALREADY_REGISTERED = exports.LIVE_CONFIRM_LIMITS = exports.CLAUDE_CODE_LINK = void 0;
 exports.renderSite = renderSite;
 exports.renderSiteWithAssets = renderSiteWithAssets;
 exports.viewerAssetSources = viewerAssetSources;
@@ -28,6 +28,7 @@ exports.unsettledRegisteredCount = unsettledRegisteredCount;
 exports.registeredRowsToAdd = registeredRowsToAdd;
 exports.subtractRemovedRegistered = subtractRemovedRegistered;
 exports.mergeRegisteredFleet = mergeRegisteredFleet;
+exports.probeWaitPhase = probeWaitPhase;
 exports.nextStateDelay = nextStateDelay;
 exports.sanitizeSecretsNow = sanitizeSecretsNow;
 exports.secretStateFromNow = secretStateFromNow;
@@ -1623,6 +1624,44 @@ const UNSETTLED_POLL_MS = 60 * 1000;
  * 書き換えられ、toString() で流し込んだ先には exports が無い）。
  */
 exports.UNSETTLED_LIMITS = { ttlMs: UNSETTLED_TTL_MS, pollMs: UNSETTLED_POLL_MS };
+/**
+ * 「接続を確認」（dispatch 種別）を押したあと、結果が届いたか（#523 S3・設計レビュー🔴2）。
+ *
+ * Backlog / Drive / Figma の確認は**その案件の同期を1回起こす**ので、答えは接続状態
+ * ストアの行として数分〜十数分後に届く。押した瞬間には何も変わらない。
+ *
+ * 🔴 **壁時計で判定しない。** 「押した時刻より新しい行」で見ると、画面の時計とサーバの
+ * 時計がずれている端末で**永久に届かない**（または、届く前に届いたことになる）。
+ * 押す前にその行の `at` を控え、**辞書順でそれより大きい `at` の行**が来たら差し替える
+ * ——ストアの `at` は正規化済みの ISO 8601（Z・ミリ秒）なので、辞書順＝時刻順。
+ *
+ * 上限は `UNSETTLED_TTL_MS`（15分・仮置きと同じ）。過ぎたら**待てば出ると言い続けない**。
+ *
+ * @param wait { at: 押す前に控えた行の `at`（無ければ ""）, startedAt: 押した時刻 }
+ * @param row  いまのその ref の**いちばん新しい行**（問いは問わない。無ければ null）
+ *             ——押して起きるのは同期そのものなので、答えが `reachable` とは限らない
+ * @returns "arrived" | "timeout" | "waiting"（`wait` が無ければ ""）
+ */
+function probeWaitPhase(wait, row, now) {
+    if (!wait)
+        return "";
+    const base = String((wait && wait.at) || "");
+    const at = String((row && row.at) || "");
+    if (at && at > base)
+        return "arrived";
+    const started = Number((wait && wait.startedAt) || 0);
+    // 端末の時計が戻った回（NTP 補正）は待ち続けない——`nextStateDelay` と同じ理由で、
+    // 経過が負なら期限の判定に使わずに待ちを続ける
+    const age = now - started;
+    if (Number.isFinite(age) && age >= UNSETTLED_TTL_MS)
+        return "timeout";
+    return "waiting";
+}
+/**
+ * 待ちが上限に達したときの1文（#523 S3・決定8）。**「もう少しお待ちください」と言わない**
+ * ——15分待って届かないなら、待つのではなく実行状況を見に行く番。
+ */
+exports.PROBE_WAIT_TIMEOUT_TEXT = "まだ結果が届いていません（Actions の実行状況を確認してください）。";
 /**
  * 次に取り直すまでの ms。もう取り直す必要が無ければ null。
  *
@@ -3912,6 +3951,9 @@ a.ds-tile:hover { text-decoration: none; }
    （flex: 1 1 100%）——状態バッジの横に押し込むと、いちばん読ませたい一文が
    カード幅に負けて省略される。状態の語より弱く、しかし読める大きさで出す */
 .ds-gate-help { flex: 1 1 100%; margin: 4px 0 0; font-size: 12px; line-height: 1.7; color: #6b7280; }
+/* 「接続を確認」（dispatch）を押したあとの返事（#523 S3）。**必ず自分の行を占める**
+   ——行の途中に挟むと ID と「外す」が案内文の下へ落ちる（.ds-gate-help と同じ理由） */
+.ds-probe-wait { flex: 1 1 100%; margin: 4px 0 0; font-size: 12px; line-height: 1.7; color: #6b7280; }
 /* 管理者への依頼文（#521）。手順が複数行あるので details に畳む——開いたまま出すと、
    1行のはずの案内（.ds-gate-help / .ds-probe-help）が一覧を占領する */
 .ds-gate-request { margin-top: 4px; }
@@ -4403,6 +4445,10 @@ var ALREADY_REGISTERED_SUFFIX = ${JSON.stringify(ALREADY_REGISTERED_SUFFIX)};
 ${isAlreadyRegistered.toString()}
 var UNSETTLED_TTL_MS = ${JSON.stringify(UNSETTLED_TTL_MS)};
 var UNSETTLED_POLL_MS = ${JSON.stringify(UNSETTLED_POLL_MS)};
+  // dispatch の「接続を確認」の待ち（#523 S3）。**判定は1つの関数に閉じる**——
+  // 画面側に書き写すと、押した行と一覧の判定が別々にずれる（🔴2 の壁時計に戻る）
+${probeWaitPhase.toString()}
+var PROBE_WAIT_TIMEOUT_TEXT = ${JSON.stringify(exports.PROBE_WAIT_TIMEOUT_TEXT)};
 ${sanitizeRegisteredNow.toString()}
 ${chatRowsToAdd.toString()}
 ${gchatRowsToAdd.toString()}
@@ -6691,7 +6737,14 @@ ${calendarAddUrl.toString()}
       no_token: { text: "管理者の設定が必要です", cls: "ds-gate-muted" },
     },
     issues: { no_token: { text: "APIキーが未登録です", cls: "ds-gate-muted" } },
-    design: { no_token: { text: "トークンが未登録です", cls: "ds-gate-muted" } },
+    design: {
+      no_token: { text: "トークンが未登録です", cls: "ds-gate-muted" },
+      // 「アクセス不可」では、トークンの失効なのかキーの誤りなのかが行から辿れない（#523 S4）。
+      // 直し方は書き手（engine の figma-gate の写し）が理由（「トークンが無効か…（HTTP 403）」／
+      // 「ファイルが見つかりません（HTTP 404…）」）として運ぶので、**help は持たせない**
+      // （持たせると理由と 2 段になり「繰り返さない」に反する。理由は appendReachableReason が出す）
+      unreachable: { text: "ファイルを読めません", cls: "ds-gate-warn" },
+    },
   };
   /**
    * その能力の行に出す「届くか」の語。**能力ごとの言い換えが無ければ 「DS_GATE」 のまま。**
@@ -7061,7 +7114,13 @@ ${calendarAddUrl.toString()}
     }
 
     if (cal.phase === "pending") {
-      box.appendChild(el("p", { class: "mt-cal-note", text: "作成中（最長 " + CALENDAR_WAIT_MIN + " 分。自動で更新されます）" }));
+      // **承認された直後の人が最初に見る 1 行**（#540）。実際にかかるのはたいてい数分で、
+      // 15 分ごとの便を 1 本待つと十数分になる。**最長だけを出すと「20 分待つのか」と読める**
+      // ——待たされている感じを実際より大きくしない。止まったときは stale が別の文を出す
+      box.appendChild(el("p", {
+        class: "mt-cal-note",
+        text: "作成中です（数分〜十数分。自動で更新されます）",
+      }));
       return;
     }
 
@@ -7143,7 +7202,9 @@ ${calendarAddUrl.toString()}
             // 画面が言い換えると 2 枚になる（片方だけ古くなる）
             if (!res.ok) return fail((res.j && res.j.message) || "依頼できませんでした。しばらくしてからもう一度お試しください。");
             msg.className = "ds-toggle-msg is-ok";
-            msg.textContent = "✓ 依頼しました。作成中（最長 " + CALENDAR_WAIT_MIN + " 分）です。";
+            // 待ちの言い方は行から描く 1 行（pending）と揃える（#540）。
+            // 片方だけ「最長 20 分」だと、同じ待ちが 2 通りに見える
+            msg.textContent = "✓ 依頼しました。作成中です（数分〜十数分）。";
             // **押したことを覚える（#452）。** 下の取り直しで箱ごと作り直されると
             // この 1 行は消えるので、消えない側（行から描く 1 行）に引き継ぐ
             if (kind === "share") CALENDAR_SHARE_PRESSED = true;
@@ -7161,7 +7222,7 @@ ${calendarAddUrl.toString()}
       openConfirm(
         [
           "cortex-notetaker が「" + (SITE.title || "この案件") + "」のカレンダーを作り、案件の社内メンバーに予定作成の権限で共有します。",
-          "最長 " + CALENDAR_WAIT_MIN + " 分かかります。",
+          "できるまで数分〜十数分かかります。",
         ],
         { okLabel: "作る", okDanger: false, returnTo: btn },
       ).then(function (yes) {
@@ -8603,7 +8664,11 @@ ${calendarAddUrl.toString()}
   function refreshStateTimer() {
     var n = unsettledNow();
     var cal = calendarPollWanted();
-    if (!n && !cal) {
+    // 「接続を確認」（dispatch）の結果待ちも取り直しを回す理由になる（#523 S3）。
+    // **仮置きの数（unsettledNow）には1件も入らない**——押した行は既に登録済みなので、
+    // これを見ないと押した人は15分間なにも更新されない画面を見ることになる
+    var probing = probeWaitsPending();
+    if (!n && !cal && !probing) {
       if (stateTimer) { clearTimeout(stateTimer); stateTimer = null; }
       stateSince = null;
       return;
@@ -8614,7 +8679,9 @@ ${calendarAddUrl.toString()}
     // カレンダー待ちは**仮置きの15分の期限に載せない**（作成の約束は20分で、載せると
     // 最後の5分だけ静かに止まる＝文言が嘘になる時間帯ができる）。依頼の時刻から測った
     // 期限は calendarPollWanted が持っているので、ここは間隔だけを決める
-    var delay = cal ? UNSETTLED_POLL_MS : nextStateDelay(n, stateSince, Date.now());
+    // 確認の結果待ちも**仮置きの15分の期限に載せない**（期限は待ちごとに
+    // 「押した時刻」から測ってあり、「probeWaitsPending」 が切る）。ここは間隔だけ
+    var delay = cal || probing ? UNSETTLED_POLL_MS : nextStateDelay(n, stateSince, Date.now());
     if (delay == null) return;
     stateTimer = setTimeout(stateTick, delay);
   }
@@ -10847,11 +10914,165 @@ ${calendarAddUrl.toString()}
     return row;
   }
 
-  /** 一覧に出ている接続先の「届くか」をひとつの文字列にする（描き直しの要否の判定用） */
+  /* -------------------------------------------------------------------------
+   * dispatch の「接続を確認」（#523 S3・Backlog / Drive / Figma）
+   * -------------------------------------------------------------------------
+   * Slack / GitHub / Google Chat の確認（「probeSection」）は中央がその場で叩いて
+   * 答えを返すが、この3つは**中央が鍵を読まない**（#105 決定5）ので、押すと
+   * その案件の同期が1回起きるだけ。答えは接続状態ストアの行として後から届く。
+   *
+   * だから画面がすることは3つ:
+   *   1. 押す前にその行の 「at」 を控える（🔴2・壁時計を使わない）
+   *   2. 「確認を開始しました」を出して、取り直し（op=state）を回す
+   *   3. 控えた 「at」 より新しい行が届いたら、待ちを解いて札を描き直す
+   *      ——札そのものは 「appendReachableChip」 が描くので、ここは待ちの表示だけ
+   * ----------------------------------------------------------------------- */
+
+  /**
+   * 押した行ごとの待ち。**行の DOM ではなくここに持つ**——一覧は取り直しのたびに
+   * 作り直されるので、行に持たせると押した直後の1回で消える。
+   */
+  var PROBE_WAITS = {};
+
+  /** 待ちの鍵。**札の突き合わせと同じ畳み方**（「stateRefKey」）にする */
+  function probeWaitKey(capId, ref) {
+    return capId + "\\u0001" + (stateRefKey(capId, ref, "") || String(ref || ""));
+  }
+
+  /** その行の待ち（無ければ null）。**期限切れも返す**（文言を出し分けるのは呼び手） */
+  function probeWaitOf(capId, ref) {
+    return PROBE_WAITS[probeWaitKey(capId, ref)] || null;
+  }
+
+  /**
+   * その接続先の**いちばん新しい行**（問いは問わない）。待ちの基準と到着の判定に使う。
+   *
+   * 🔴 **「届くか」の行だけを見ない。** 押すと起きるのは同期そのものなので、
+   * 届いた答えが 「reachable」 とは限らない——Backlog / Drive / Figma とも回によっては
+   * 片方しか動かない（Backlog の webhook 起点は「取り込み」だけ、Drive の先出しは「届くか」だけ）。
+   * 「届くか」だけを見ると、**同期が終わって行が更新されているのに15分待たせる**。
+   */
+  function probeLatestRow(capId, ref) {
+    var rows = LIVE_STATE;
+    if (!rows || !rows.length || !capId) return null;
+    var want = stateRefKey(capId, ref, "");
+    if (!want) return null;
+    var best = null;
+    for (var i = 0; i < rows.length; i++) {
+      var r = rows[i];
+      if (!r || r.cap !== capId) continue;
+      if (stateRefKey(capId, r.ref, r.workspace) !== want) continue;
+      if (!best || String(r.at || "") > String(best.at || "")) best = r;
+    }
+    return best;
+  }
+
+  /**
+   * その行の待ちの相。届いていれば待ちを**その場で解く**（次の描き直しで札だけが残る）。
+   */
+  function probeWaitPhaseOf(capId, ref) {
+    var key = probeWaitKey(capId, ref);
+    var wait = PROBE_WAITS[key];
+    if (!wait) return "";
+    var phase = probeWaitPhase(wait, probeLatestRow(capId, ref), Date.now());
+    if (phase === "arrived") delete PROBE_WAITS[key];
+    return phase;
+  }
+
+  /** まだ結果を待っている行があるか（取り直しを続けるかの判断・「refreshStateTimer」） */
+  function probeWaitsPending() {
+    var now = Date.now();
+    for (var key in PROBE_WAITS) {
+      if (!Object.prototype.hasOwnProperty.call(PROBE_WAITS, key)) continue;
+      var w = PROBE_WAITS[key];
+      // **鍵から ref を戻さない。** 待ちに控えてある能力と ref をそのまま使う
+      if (probeWaitPhase(w, probeLatestRow(w.cap, w.ref), now) === "waiting") return true;
+    }
+    return false;
+  }
+
+  /**
+   * 能力 → 「op=probe」 に送る種別。**画面の能力名をそのまま送らない**
+   * （サーバの受け口はレジストリの id で、「materials」 ではなく 「drive」）。
+   * **空を返した能力にはボタンが出ない。**
+   */
+  function dispatchProbeTypeOf(capId) {
+    return { issues: "backlog", materials: "drive", design: "figma" }[String(capId || "")] || "";
+  }
+
+  /**
+   * 接続先1件の「接続を確認」（ボタン＋待ちの1文）を行に足す。
+   *
+   * **ボタンは行の中**（Slack の行と同じ・2026-08-20 の「1行が2段になる」を繰り返さない）。
+   * 待ちの1文は 「.ds-gate-help」 で行の最後に落とす（「appendReachableReason」 の項）。
+   */
+  function appendDispatchProbe(row, capId, ref) {
+    var type = dispatchProbeTypeOf(capId);
+    // **書き込み経路が無ければ出さない**（押しても何も起きないボタンを置かない）
+    if (!type || !SITE.intake || !ref) return row;
+    var btn = el("button", { class: "ds-toggle-btn", type: "button", text: "接続を確認" });
+    // 🔴 **「ds-gate-help」 を付けない。** あれは「最後に測った理由」の1段で、
+    // 行の補足が1段であることを見張る検査（#523 S1）が数えている。待ちの1文は
+    // 別の話（押した人へのその場の返事）なので、専用の class を持たせる
+    var note = el("p", { class: "ds-probe-wait" });
+    var phase = probeWaitPhaseOf(capId, ref);
+    var wait = probeWaitOf(capId, ref);
+    if (phase === "waiting") note.textContent = (wait && wait.message) || "";
+    else if (phase === "timeout") note.textContent = PROBE_WAIT_TIMEOUT_TEXT;
+    else note.hidden = true;
+
+    btn.addEventListener("click", async function () {
+      var endBusy = beginBusy(btn, "確認中…");
+      note.hidden = false;
+      note.textContent = "確認中…";
+      // 🔴 **押す前に、いまの行の 「at」 を控える（🔴2）。** 行が無ければ空文字
+      //（どんな 「at」 が来ても「新しい」と読める）
+      var before = probeLatestRow(capId, ref);
+      var key = probeWaitKey(capId, ref);
+      try {
+        var res = await callIntake("probe", { type: type, ref: ref });
+        var j = await res.json().catch(function () { return {}; });
+        if (!res.ok || j.queued === false) {
+          // サーバの文言をそのまま出す（回数制限・鍵未登録・ロール未登録・起動失敗）
+          note.textContent = j.message || "確認できませんでした。";
+          delete PROBE_WAITS[key];
+          endBusy();
+          return;
+        }
+        PROBE_WAITS[key] = {
+          cap: capId, ref: ref,
+          at: (before && before.at) || "",
+          startedAt: Date.now(),
+          message: j.message || "",
+        };
+        note.textContent = j.message || "";
+        // 待っているあいだは取り直しを回す（届いた行で一覧が描き直される）
+        refreshStateTimer();
+      } catch (e) {
+        note.textContent = "通信に失敗しました。";
+        delete PROBE_WAITS[key];
+      }
+      endBusy();
+    });
+    row.appendChild(btn);
+    row.appendChild(note);
+    return row;
+  }
+
+  /**
+   * 一覧に出ている接続先の「届くか」をひとつの文字列にする（描き直しの要否の判定用）。
+   *
+   * **待ちの相も混ぜる（#523 S3）。** 混ぜないと、15分の上限に達しても一覧が
+   * 作り直されず、「確認を開始しました」が出たまま止まる（待てば出ると言い続ける形）。
+   */
   function reachSigOf(capId, refs) {
+    var now = Date.now();
     return (refs || []).map(function (ref) {
-      var r = reachableStateOf(capId, ref && ref.ref != null ? ref.ref : ref, ref && ref.workspace);
-      return r ? r.status + "@" + r.at : "-";
+      var id = ref && ref.ref != null ? ref.ref : ref;
+      var r = reachableStateOf(capId, id, ref && ref.workspace);
+      var w = probeWaitOf(capId, id);
+      // 待っている行は**いちばん新しい行**で相を決める（「probeLatestRow」 の項）
+      return (r ? r.status + "@" + r.at : "-") + (w ? "/" + probeWaitPhase(w, probeLatestRow(capId, id), now) : "");
     }).join(",");
   }
 
@@ -10974,7 +11195,12 @@ ${calendarAddUrl.toString()}
       // 理由の1段は**行の最後**（ボタンより後ろ）に置く（appendReachableReason の項）
       var issuesRef = issuesRefOf(t.domain, t.projectKey);
       appendReachableChip(row, "issues", issuesRef);
-      if (!editable) return appendReachableReason(row, "issues", issuesRef);
+      // 「接続を確認」（#523 S3）。**外す権限が無くても押せる**——読むだけの操作で、
+      // 押せる人を絞らない（決定7）。ボタンの並びは Slack の行と同じ（外すボタンの後ろ）
+      if (!editable) {
+        appendDispatchProbe(row, "issues", issuesRef);
+        return appendReachableReason(row, "issues", issuesRef);
+      }
       var btn = el("button", { class: "ds-toggle-btn ds-danger", type: "button", text: "この接続先を外す" });
       btn.addEventListener("click", async function () {
         // **最後の1件かどうかは「押した時点」で数える。** 描画時の件数で決めると、
@@ -10994,6 +11220,7 @@ ${calendarAddUrl.toString()}
         sendConfig(payload, msg, btn, null, targetsHooks());
       });
       row.appendChild(btn);
+      appendDispatchProbe(row, "issues", issuesRef);
       return appendReachableReason(row, "issues", issuesRef);
     }
 
@@ -11466,6 +11693,11 @@ ${calendarAddUrl.toString()}
               // **クラスのハード代入をやめる**（片方だけ直し忘れる形を構造的に消す）
               onDone: function () { row.classList.add("ds-removed"); },
             }));
+            // 「接続を確認」（#523 S3）。押すと資料の同期が1回起き、共有が外れていれば
+            // 「フォルダを開けません…」が数分〜十数分後にこの行へ出る。
+            // **並びは Slack の行と同じ**（外すボタンの後ろ）——先に置くと、行の1つ目の
+            // ボタンが入れ替わる（既存のテストが「1つ目＝外す」で掴んでいるのと同じ読み順）
+            appendDispatchProbe(row, "materials", id);
             // 理由の1段は行の最後（ID と「このフォルダを外す」の後ろ・appendReachableReason の項）
             appendReachableReason(row, "materials", id);
             dlist.appendChild(row);
@@ -11596,7 +11828,8 @@ ${calendarAddUrl.toString()}
             // このファイルの取り込みが最後にどうなったか（段C）。測っていなければ null
             ingestedEl(designIngestedStateOf(f.key), "デザイン"),
           ]);
-          // このファイルに届くか（#523 S1）。書き手は S4（いまは行が無いので何も出ない）。
+          // このファイルに届くか（#523 S1）。書き手は engine の同期（#523 S4・engine #329）。
+          // 行が無いファイル（まだ一度も同期していない）には何も出ない。
           // 理由の1段は行の最後に置く（appendReachableReason の項）
           appendReachableChip(row, "design", f.key);
           row.appendChild(removeButton({
@@ -11632,6 +11865,10 @@ ${calendarAddUrl.toString()}
               else delete figSending[f.key];
             },
           }));
+          // 「接続を確認」（#523 S3）。押すとデザイン同期が1回起き、engine の同期が
+          // 「届くか」と「取り込み」の行を書く（#523 S4・engine #329）。届いたら札が差し替わる。
+          // 並びは Slack の行と同じ（外すボタンの後ろ）
+          appendDispatchProbe(row, "design", f.key);
           appendReachableReason(row, "design", f.key);
           // 描き直しのあとも「外した」ことが分かる形に戻す（figsRemoved の項に経緯）
           if (figsRemoved.indexOf(f.key) >= 0) {
@@ -12727,7 +12964,9 @@ ${calendarAddUrl.toString()}
     // 判定と文面は infra/lambda/shared/github-gate.mjs 側（画面に分岐を持たせない）。
     // **Google Chat は #347（同じ理由）。** スペースにアプリを追加した人が、その場で
     // 直ったことを確かめられる。判定は infra/lambda/shared/google-chat-gate.mjs 側。
-    // Backlog / Figma / Drive は実測そのものが新規なので、まだ出さない。
+    // **Backlog / Figma / Drive は「接続を確認」の型が違う**（#523 S3・レジストリの
+    // 「probe: dispatch」）。中央が叩くのではなく案件の同期を起こすので、ここではなく
+    // それぞれの一覧の行が 「appendDispatchProbe」 で出す。
     //
     // **origin === "explicit" でも出す。** 確認は読むだけで、どの登録ファイル由来かに
     // 関係なく効く（書き込みになる「表示名を更新する」だけが由来で出し分かれる）

package/package.json

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