@takagaki/cortex-decisions-viewer 0.12.51 → 0.12.53

package/dist/render.js

@@ -55,6 +55,7 @@ exports.renderConnectionMap = renderConnectionMap;
 const node_crypto_1 = require("node:crypto");
 const google_chat_guide_images_1 = require("./google-chat-guide-images");
 const meet_guide_images_1 = require("./meet-guide-images");
+const figma_guide_images_1 = require("./figma-guide-images");
 // 操作タブの仮置き（#388）。判定の実体はあちら——ここは流し込みと配線だけ
 const pending_ops_1 = require("./pending-ops");
 /**
@@ -4675,6 +4676,10 @@ ${calendarAddUrl.toString()}
   var GCHAT_SHOT_STEP2 = "${google_chat_guide_images_1.GCHAT_APP_STEP2}";
   // 案件カレンダーに予定を作る手順の画像（#452）。理由は src/meet-guide-images.ts
   var MEET_SHOT_CREATE_EVENT = "${meet_guide_images_1.MEET_GUIDE_CREATE_EVENT}";
+  // Figma の「発行のしかた」に載せる手順の画像（#547）。理由は src/figma-guide-images.ts
+  var FIGMA_SHOT_STEP1 = "${figma_guide_images_1.FIGMA_GUIDE_STEP1}";
+  var FIGMA_SHOT_STEP2 = "${figma_guide_images_1.FIGMA_GUIDE_STEP2}";
+  var FIGMA_SHOT_STEP3 = "${figma_guide_images_1.FIGMA_GUIDE_STEP3}";
 
   function copyRow(text) {
     // **input と button を使わない。** 追加フォームの中に置くので、input を足すと
@@ -6737,7 +6742,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」 のまま。**
@@ -7107,7 +7119,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;
     }
 
@@ -7189,7 +7207,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;
@@ -7207,7 +7227,7 @@ ${calendarAddUrl.toString()}
       openConfirm(
         [
           "cortex-notetaker が「" + (SITE.title || "この案件") + "」のカレンダーを作り、案件の社内メンバーに予定作成の権限で共有します。",
-          "最長 " + CALENDAR_WAIT_MIN + " 分かかります。",
+          "できるまで数分〜十数分かかります。",
         ],
         { okLabel: "作る", okDanger: false, returnTo: btn },
       ).then(function (yes) {
@@ -10933,8 +10953,8 @@ ${calendarAddUrl.toString()}
    * その接続先の**いちばん新しい行**（問いは問わない）。待ちの基準と到着の判定に使う。
    *
    * 🔴 **「届くか」の行だけを見ない。** 押すと起きるのは同期そのものなので、
-   * 届いた答えが 「reachable」 とは限らない——Figma は当面 「ingested」 しか書かれず
-   * （書き手は S4）、Backlog / Drive も回によっては片方しか動かない。
+   * 届いた答えが 「reachable」 とは限らない——Backlog / Drive / Figma とも回によっては
+   * 片方しか動かない（Backlog の webhook 起点は「取り込み」だけ、Drive の先出しは「届くか」だけ）。
    * 「届くか」だけを見ると、**同期が終わって行が更新されているのに15分待たせる**。
    */
   function probeLatestRow(capId, ref) {
@@ -11813,7 +11833,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({
@@ -11849,8 +11870,8 @@ ${calendarAddUrl.toString()}
               else delete figSending[f.key];
             },
           }));
-          // 「接続を確認」（#523 S3）。**行を書くのは S4（engine）** なので、いまは
-          // 押すとデザイン同期が1回起きるだけ——札が出るのは S4 の配布後。
+          // 「接続を確認」（#523 S3）。押すとデザイン同期が1回起き、engine の同期が
+          // 「届くか」と「取り込み」の行を書く（#523 S4・engine #329）。届いたら札が差し替わる。
           // 並びは Slack の行と同じ（外すボタンの後ろ）
           appendDispatchProbe(row, "design", f.key);
           appendReachableReason(row, "design", f.key);
@@ -13674,12 +13695,36 @@ ${calendarAddUrl.toString()}
       // 特に file_comments:read の欠落は「同期は緑なのに指摘だけ増えない」という
       // 気づきにくい壊れ方をする（コメント同期は後から足した機能で、この案内が追随していなかった）。
       // 書き込み権限は1つも要らない。files:read（非推奨・広範）は選ばせないこと。
-      how: "Figma → Settings → Security → Personal access tokens で発行。スコープは file_content:read と file_comments:read の2つにチェックを入れてください（どちらも読み取りのみ・書き込み権限は要りません）",
+      // **画像内の番号（①〜⑧・下の shots）と、この文の言い回しの向きを揃える。**
+      // 文の側には数字を振らない——振ると画像の丸数字と二重に採番することになり、
+      // 「文の1番」と「画像の①」がずれたときに矛盾して見える（#547）
+      how: "Figma の左上の名前 → Settings → Security タブ → Personal access tokens の Generate new token で発行します。名前は任意（例: cortex token）、期限は90日などにし、スコープは file_content:read と file_comments:read の2つだけにチェックを入れてください（どちらも読み取りのみ・書き込み権限は要りません）。",
       // **スコープが正しくても、招待が無いと読めない。** トークンは「そのアカウントが
       // 見られるファイル」しか読めないので、招待漏れは 404 になる。権限の問題に見えないため
       // 現場で切り分けに時間がかかる（実際に踏んだ）。入力欄の隣に書いておく。
       note: "発行したアカウントを、対象の Figma ファイルに閲覧者として招待しておいてください（招待が無いとトークンが正しくても読めません）。"
         + "発行するのは、対象ファイルのあるチームで Dev または Full の席を持つ方にしてください。閲覧席（View/Collab）のトークンは取得回数が月 20 回までで、夜間同期が数日で止まります。",
+      // **手順の画像3枚（#547）。** Google Meet・Google Chat と同じ guideShot を通す
+      // （幅の上限・クリックで原寸に戻る振る舞いを1か所に揃える）。見出しは画像の並び順
+      // （1〜3枚目）、画像の中の丸数字（①〜⑧）は1枚の中の細かい手順——役割が別なので、
+      // 見出し側に丸数字を混ぜない
+      shots: [
+        {
+          src: FIGMA_SHOT_STEP1, width: "1000", height: "1114",
+          heading: "1. 左上の名前 → Settings",
+          alt: "Figma左上の自分の名前を押すとメニューが開き、その中のSettingsが赤枠で示されている。",
+        },
+        {
+          src: FIGMA_SHOT_STEP2, width: "1200", height: "1145",
+          heading: "2. Security タブ → Generate new token を押す",
+          alt: "Settings画面のSecurityタブが赤枠で示され、下のPersonal access tokensにあるGenerate new tokenのリンクも赤枠で示されている。",
+        },
+        {
+          src: FIGMA_SHOT_STEP3, width: "1100", height: "1428",
+          heading: "3. 名前・期限・スコープを決めて発行する",
+          alt: "Generate new tokenダイアログ。Token name欄・Expiration（90日）・file_comments:readとfile_content:readのチェックボックス・Generate tokenボタンが、それぞれ赤枠で示されている。",
+        },
+      ],
     },
     "backlog": {
       icon: "📋",
@@ -13883,6 +13928,15 @@ ${calendarAddUrl.toString()}
     // 発行のしかたを探している人がここを開く手掛かりを持てない（rt カードと同じ流儀）
     var guidanceBox = el("details", { class: "sec-fold" }, [el("summary", { text: "発行のしかた" })]);
     for (var gi = 0; gi < guidance.length; gi++) guidanceBox.appendChild(guidance[gi]);
+    // **手順の画像（#547）。** 文章（guidance）の下に、見出し→画像の対を並びの順に足す。
+    // shots を持たない種別（Backlog）ではこの節は素通りする
+    if (meta.shots) {
+      for (var si = 0; si < meta.shots.length; si++) {
+        var shot = meta.shots[si];
+        guidanceBox.appendChild(el("p", { class: "sec-how", text: shot.heading }));
+        guidanceBox.appendChild(guideShot({ src: shot.src, width: shot.width, height: shot.height, alt: shot.alt }));
+      }
+    }
 
     // **押すまで入力欄を出さない（2026-08-21・オーナー指摘）。**
     // 「今のAPIキーのセクション、欄があると思うんだけど…押すとフォームだけ出てくる」。

package/package.json

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