@takagaki/cortex-decisions-viewer 0.12.30 → 0.12.32

package/dist/render.js

@@ -1,10 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNSETTLED_LIMITS = exports.LIVE_CONFIRM_LIMITS = void 0;
+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;
 exports.viewerAssetNames = viewerAssetNames;
+exports.isRepositorySlug = isRepositorySlug;
+exports.devRepositoryRefs = devRepositoryRefs;
+exports.claudeCodeRepositories = claudeCodeRepositories;
+exports.claudeCodeUrl = claudeCodeUrl;
+exports.isAlreadyRegistered = isAlreadyRegistered;
 exports.sanitizeRegisteredNow = sanitizeRegisteredNow;
 exports.sanitizeStateNow = sanitizeStateNow;
 exports.overlayStateOnFleet = overlayStateOnFleet;
@@ -32,6 +37,7 @@ exports.deriveCapTile = deriveCapTile;
 exports.renderConnectionMap = renderConnectionMap;
 const node_crypto_1 = require("node:crypto");
 const meet_guide_images_1 = require("./meet-guide-images");
+const google_chat_guide_images_1 = require("./google-chat-guide-images");
 // 操作タブの仮置き（#388）。判定の実体はあちら——ここは流し込みと配線だけ
 const pending_ops_1 = require("./pending-ops");
 /**
@@ -52,21 +58,27 @@ function renderSite(site, assets) {
             .replace(/^https?:\/\/github\.com\//, "")
             .replace(/\.git$/, "")
         : "";
-    const codeUrl = (prompt) => repoSlug
-        ? `https://claude.ai/code?repo=${repoSlug}&prompt=${encodeURIComponent(prompt)}`
-        : "https://claude.ai/code/";
-    const askUrl = codeUrl("このプロジェクトの概要について教えてください。");
+    // 組み立ての正本は claudeCodeUrl 1か所（#404）。ここは薄い包みに留める。
+    // `?? []` は必須——build.ts は fleet-status.json が無い案件で externalSources を持たない
+    const codeUrl = (prompt) => claudeCodeUrl(prompt, repoSlug, site.externalSources ?? []);
+    /** ヘッダー「AIに聞く」の指示文。data-ai-prompt に同じ値を残し、接続状況が届いたら href を組み直す */
+    const ASK_PROMPT = "このプロジェクトの概要について教えてください。";
+    const askUrl = codeUrl(ASK_PROMPT);
     // ※ 投入フォーム設定 site.intake は build.ts が --intake-url/--intake-token/--project-key から付与する。
     const dataJson = JSON.stringify(site).replace(/</g, "\\u003c");
     const safeTitle = escapeHtml(site.title);
     // 接続マップ（操作タブ最上部のSVG図）。ビルド時に生成し<template>で埋め込む。fleet情報が無ければ出さない
     const connMap = renderConnectionMap(site);
-    // チュートリアル（Homeタブ下部の「はじめに」セクション）。ボタンURLは既存の codeUrl を流用し、案件データ由来の値だけビルド時に埋める
-    const tutorialJson = JSON.stringify(buildTutorialData(site, codeUrl, repoSlug)).replace(/</g, "\\u003c");
+    // チュートリアル（Homeタブ下部の「はじめに」セクション）。**URLは焼き込まず指示文だけ渡す**（#404）
+    // ——URLは画面側が codeUrl で組む（登録した開発リポジトリを当日から載せるため）。
+    // 🔴 **この .replace(/</g, "\\u003c") を消さないこと。** </script> によるブレイクアウトを
+    // 防いでいる。指示文には案件データ（決定のタイトル）が入り、#404 以降は
+    // encodeURIComponent を通らない生の値がそのまま JSON に載る
+    const tutorialJson = JSON.stringify(buildTutorialData(site, repoSlug)).replace(/</g, "\\u003c");
     const githubBtn = site.repoBaseUrl
         ? `<a class="gh-btn" href="${escapeHtml(site.repoBaseUrl)}" target="_blank" rel="noopener" title="コンテキストリポジトリをGitHubで開く">${GITHUB_ICON}</a>`
         : "";
-    const askBtn = `<a class="ask-ai-btn" href="${escapeHtml(askUrl)}" target="_blank" rel="noopener" title="Claude Code Web でこの案件のリポジトリを開き、プロジェクトについて質問・調査できます">💬 プロジェクトについてAIに聞く</a>`;
+    const askBtn = `<a class="ask-ai-btn" href="${escapeHtml(askUrl)}" data-ai-prompt="${escapeHtml(ASK_PROMPT)}" target="_blank" rel="noopener" title="Claude Code Web でこの案件のリポジトリと、登録済みの開発リポジトリを開き、プロジェクトについて質問・調査できます">💬 プロジェクトについてAIに聞く</a>`;
     // CSPでインラインが拒否される環境向けの外部参照形。省略時は従来どおり埋め込む
     const styleTag = assets
         ? `<link rel="stylesheet" href="${escapeHtml(assets.css)}" />`
@@ -341,6 +353,111 @@ function sourceAdapter(type) {
         return "github";
     return "";
 }
+// ---------------------------------------------------------------------------
+// Claude Code への導線（#404）— **組み立てる場所は下の claudeCodeUrl 1か所だけ**
+//
+// 画面には Claude Code を開くボタンが7つある（ヘッダーの「AIに聞く」・Home の「挑戦する」・
+// 各区画の「＋AIで登録」「AIで編集」「AIで適用」・Home の「AIで編集」「AIで書く」）。
+// かつては7か所が別々に URL を組み立て、案件のコンテキストリポジトリ1本だけを渡していた。
+// **ボタンが増えるたびに写しが増える形**だったので、組み立てを1関数に寄せ、
+// 「ここ以外に claude.ai/code と書いたら赤くなる」テスト（claude-code-link）を付けてある。
+//
+// **クロージャを持たない function 宣言に保つこと**（.toString() でクライアントへ渡す）。
+// ---------------------------------------------------------------------------
+/**
+ * 説明用の素のリンク（リポジトリ指定なし）。「この仕組みについて」の Claude Code と、
+ * 案件リポジトリが owner/repo の形に解決できないときのフォールバックが使う。
+ *
+ * ⚠ **定数そのものを export してはいけない。** `export const` は CommonJS へ落ちるときに
+ * 参照が `exports.X` へ書き換えられ、**toString() で流し込んだ先には exports が無いので
+ * クライアントJSが丸ごと落ちる**（LIVE_CONFIRM_LIMITS の項に経緯がある）。
+ */
+const CLAUDE_CODE_HOME = "https://claude.ai/code/";
+/** 素のリンクを**テストから固定するための入れ物**（LIVE_CONFIRM_LIMITS と同じ作法） */
+exports.CLAUDE_CODE_LINK = { home: CLAUDE_CODE_HOME };
+/**
+ * owner/repo の形か（ポータル web/src/features/harness/harness-link.ts の REPOSITORY_SLUG と同じ形）。
+ *
+ * ⚠ **波括弧を含む量指定子（{2,} など）を書かないこと。** 配信スクリプトから
+ * この関数のソースを切り出すテストが、波括弧の対応で本体の末尾を決めている。
+ */
+function isRepositorySlug(ref) {
+    if (typeof ref !== "string")
+        return false;
+    if (!/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/.test(ref))
+        return false;
+    // 🔴 **パスに見える値を通さない**（`../evil` / `./x` / `a/..` / `.git/config`）。
+    // クエリの値なので実害は無い（受け取る側でパスとして解決されない）が、
+    // **「形の検査」だと言っている以上、形として通してはいけない**——通していると、
+    // この関数を別の用途（ファイルパスの組み立て等）に流用した人が静かに踏む。
+    // 所有者は「.」で始まれない（GitHub の規則）。リポジトリ名は `.github` のように
+    // 「.」で始まれるので、そちらは**点だけの区切り**だけを弾く。
+    var parts = ref.split("/");
+    if (parts[0].charAt(0) === ".")
+        return false;
+    return !/^\.+$/.test(parts[1]);
+}
+/**
+ * 接続済みの開発リポジトリの ref を**登録順**に取り出す。
+ *
+ * 🔴 **絞りは sourceAdapter（正本・#153）に任せる。** ここに独自の if 連鎖を書くと、
+ * 次のアダプタが増えたときに片方だけ直り、一覧に出ているリポジトリが AI 導線から消える。
+ *
+ * 🔴 **読み取り停止中（goldState === "excluded"）も載せる。** 読み取りを止めているのは
+ * 夜間の取り込みの話で、人が AI に見せたいかどうかとは別（オーナー決定・ポータルの
+ * ハーネスの導線と同じ規則）。
+ */
+function devRepositoryRefs(externals) {
+    var out = [];
+    (externals || []).forEach(function (s) {
+        if (!s || sourceAdapter(s.type) !== "github")
+            return;
+        if (!isRepositorySlug(s.ref))
+            return;
+        out.push(s.ref);
+    });
+    return out;
+}
+/**
+ * repositories= に載せる並び。**案件リポ → 開発リポ（登録順）**。
+ *
+ * 🔴 **大小文字を無視して重複排除・先勝ち。** 案件リポ自身が開発リポとしても登録されて
+ * いる案件があり、そのまま並べると同じリポジトリが2回載る。
+ * 🔴 **形の壊れた開発リポは、その1件だけ落とす。** 登録は人が書く JSON なので、
+ * 1行の書き間違いでボタンごと死なせない。
+ * 🔴 **案件リポが owner/repo の形でないときは空を返す**（呼び出し側が素のリンクへ倒す）。
+ *    ここで案件リポだけを落とすと「開発リポだけが開く」URL ができ、ヘッダーの
+ *    「このプロジェクトについてAIに聞く」が**別のリポジトリを開く**。
+ */
+function claudeCodeRepositories(projectRepo, devRefs) {
+    if (!isRepositorySlug(projectRepo))
+        return [];
+    var out = [String(projectRepo)];
+    var seen = [String(projectRepo).toLowerCase()];
+    (devRefs || []).forEach(function (ref) {
+        if (!isRepositorySlug(ref))
+            return;
+        var k = String(ref).toLowerCase();
+        if (seen.indexOf(k) >= 0)
+            return;
+        seen.push(k);
+        out.push(String(ref));
+    });
+    return out;
+}
+/**
+ * 🔴 **Claude Code への URL を組み立ててよい唯一の場所。**
+ * ここ以外に claude.ai/code の文字列を書かないこと（guard テストが見張っている）。
+ *
+ * repositories はカンマ区切りで**素のまま**載せる（公式の例がその形で、スラッシュも
+ * エンコードしない）。指示文だけ encodeURIComponent する。
+ */
+function claudeCodeUrl(prompt, projectRepo, externals) {
+    var repos = claudeCodeRepositories(projectRepo, devRepositoryRefs(externals));
+    if (!repos.length)
+        return CLAUDE_CODE_HOME;
+    return "https://claude.ai/code?repositories=" + repos.join(",") + "&prompt=" + encodeURIComponent(prompt);
+}
 /**
  * 外部ソースの行が「この能力・このアダプタのタイル」に属するか。
  *
@@ -563,6 +680,11 @@ const REGISTERED_FIELDS = {
     chat: ["ref", "name", "workspace", "orgUnknown", "origin", "goldState", "notify"],
     "google-chat": ["ref", "name"],
     dev: ["ref", "type"],
+    // 🔴 **意図的に外した開発リポジトリ（#391）。** サーバは前から別キーで返していたが、
+    // ここに無いので篩が丸ごと落としていた。**これが読めないと「読み取り停止中」の行を
+    // 消せない**——`registeredDev` は exclude された repo を落とすので、`dev` だけを見ていると
+    // 「停止中の行」と「登録から消えた行」がどちらも「dev に無い」になり、区別が付かない
+    devExcluded: ["ref", "type"],
     design: ["key", "name"],
     materials: ["id", "name"],
     issues: ["domain", "projectKey"],
@@ -572,12 +694,41 @@ const REGISTERED_REQUIRED = {
     chat: ["ref"],
     "google-chat": ["ref"],
     dev: ["ref"],
+    devExcluded: ["ref"],
     design: ["key"],
     materials: ["id"],
     issues: ["domain", "projectKey"],
 };
 /** 開発の種別に許す値。**知らない値は落とす**（画面のラベル・振り分けが決まらない） */
 const REGISTERED_DEV_TYPES = ["github-issues", "github-discussions"];
+/**
+ * 「もう登録されている」という断りの語尾。**正本は intake の `ALREADY_REGISTERED_SUFFIX`**
+ * （`infra/lambda/intake/logic.mjs`）で、ここはその写し。一致は
+ * `viewer/test/already-registered-parity.test.mjs` が見張っている。
+ *
+ * ⚠ **定数そのものを export しない**（CommonJS で `exports.X` に化け、流し込んだ先で落ちる）。
+ * テストから読む値は下の `ALREADY_REGISTERED` 経由。
+ */
+const ALREADY_REGISTERED_SUFFIX = "既に登録されています";
+/** 語尾を**テストから固定するための入れ物**（LIVE_CONFIRM_LIMITS と同じ作法） */
+exports.ALREADY_REGISTERED = { suffix: ALREADY_REGISTERED_SUFFIX };
+/**
+ * サーバの断りが「もう登録されている」か。
+ *
+ * 🔴 **これは失敗の判定ではなく、事実の判定（#409）。** サーバがこう答えた時点で、
+ * その接続先は登録ファイルに確かに在る。画面はこれを受けて**一覧に行を出す**——
+ * 「一覧は空なのに、追加すると既に登録されていると断られる」という袋小路を作らない。
+ *
+ * 🔴 **語尾で見る（能力ごとの主語まで写さない）。** 「このチャンネルは」「このスペースは」
+ * まで写すと、主語を1つ増やした日に画面だけ古い写しを持ち、その能力だけ袋小路が残る。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function isAlreadyRegistered(message) {
+    if (typeof message !== "string")
+        return false;
+    return message.indexOf(ALREADY_REGISTERED_SUFFIX) >= 0;
+}
 /**
  * 応答の registeredNow を、画面が扱ってよい形へ畳む。**通らなかったものは黙って落とす。**
  *
@@ -622,7 +773,8 @@ function sanitizeRegisteredNow(v) {
                     continue; // 葉は文字列だけ
                 item[f] = fv;
             }
-            if (cap === "dev" && item.type && REGISTERED_DEV_TYPES.indexOf(item.type) < 0)
+            // 種別の検査は dev と devExcluded の両方に掛ける（片側だけ緩いと篩の規則が割れる）
+            if ((cap === "dev" || cap === "devExcluded") && item.type && REGISTERED_DEV_TYPES.indexOf(item.type) < 0)
                 delete item.type;
             let full = true;
             for (const f of REGISTERED_REQUIRED[cap])
@@ -1018,7 +1170,44 @@ function subtractRemovedRegistered(view, reg) {
         for (const r of reg.dev || [])
             if (r && r.ref)
                 devRefs[String(r.ref)] = true;
-        const before = v.externalSources || [];
+        // 意図的に外した開発リポジトリ（#391）。**「停止中」と「消えた」を分ける唯一の材料**
+        //
+        // 🔴 **照合は小文字で行う。** サーバ側の `devExcludeSet`（logic.mjs）は exclude と sources を
+        // 小文字化して突き合わせるので、`dev-sources.json` の綴りが `Owner/Repo` と `owner/repo` で
+        // ずれている案件では、大小を区別すると**停止中の行が表示から消える**（「登録から消えた」と
+        // 誤読して引いてしまう）。
+        // 注: 下の `devRefs`（停止中でない行の照合）は従来どおり大小を区別する。こちらを変えると
+        // 既存の引き算の挙動が変わるので、本件では触らない
+        const lc = (v) => String(v == null ? "" : v).toLowerCase();
+        const excludedRefsLc = {};
+        for (const r of reg.devExcluded || [])
+            if (r && r.ref)
+                excludedRefsLc[lc(r.ref)] = true;
+        const devRefsLc = {};
+        for (const r of reg.dev || [])
+            if (r && r.ref)
+                devRefsLc[lc(r.ref)] = true;
+        // **読み取りを再開した行は、印だけ落として中身は残す（#391 の実装レビュー④）。**
+        //
+        // 再開すると repo は `dev` に戻り `devExcluded` から消える。下の引き算はこれを
+        // 「登録から消えた」と読んで行ごと引き、`devRowsToAdd` が素の行を作り直す——
+        // **表示名・ゲート・最終読み取りが次のビルドまで消える**。かといって行ごと残すと、
+        // 読み取りが再開しているのに「読み取り停止中」の札が出たままになる（画面が嘘をつく）。
+        // **印（goldState）だけを今の値に直して、行はそのまま使う**のが両方を満たす。
+        const raw = v.externalSources || [];
+        let reopened = false;
+        const before = raw.map((s) => {
+            if (!s || !s.ref || s.goldState !== "excluded")
+                return s;
+            if (String(s.type || "").indexOf("github") !== 0)
+                return s;
+            if (!Array.isArray(reg.dev) || !Array.isArray(reg.devExcluded))
+                return s;
+            if (excludedRefsLc[lc(s.ref)] === true || devRefsLc[lc(s.ref)] !== true)
+                return s;
+            reopened = true;
+            return Object.assign({}, s, { goldState: "on" });
+        });
         const after = before.filter((s) => {
             if (!s || !s.ref)
                 return true;
@@ -1035,14 +1224,20 @@ function subtractRemovedRegistered(view, reg) {
             }
             if (String(s.type || "").indexOf("github") === 0 && Array.isArray(reg.dev)) {
                 // 「読み取り停止中」（exclude）の行は登録簿の sources に居ないが、
-                // まとめ表はバッジを出すために保持している——引くと停止中の表示ごと消える
-                if (s.goldState === "excluded")
-                    return true;
+                // まとめ表はバッジを出すために保持している——引くと停止中の表示ごと消える。
+                // 🔴 **停止中かどうかは devExcluded で判断する（#391）。** それが読めない古い応答では
+                // 従来どおり保持する（判断できないので安全側）。読めるなら、そこに居なくなった行は
+                // **本当に登録から消えた**ので引いてよい——引かないと、停止中の行を解除したとき
+                // 「消したのに次のビルドまで戻り続ける」（仮置きが捨てられた後に復活する経路）
+                if (s.goldState === "excluded") {
+                    return Array.isArray(reg.devExcluded) ? excludedRefsLc[lc(s.ref)] === true : true;
+                }
                 return devRefs[String(s.ref)] === true;
             }
             return true;
         });
-        if (after.length !== before.length)
+        // **件数が変わらなくても、印を直したなら書き戻す**（再開した行は引かれないので長さが同じ）
+        if (after.length !== before.length || reopened)
             set({ externalSources: after });
     }
     if (Array.isArray(reg.design) || Array.isArray(reg.materials)) {
@@ -1951,7 +2146,7 @@ function renderConnectionMap(site) {
  * 各チャレンジのプロンプトは固定文（ビューアコードに実案件名は残さない）。
  * チャレンジ4だけは site.decisions から根拠付きの最新決定を選び、そのtitle/idを埋め込む。
  */
-function buildTutorialData(site, codeUrl, repoSlug) {
+function buildTutorialData(site, repoSlug) {
     const c4 = tutorialChallenge4Prompt(site.decisions);
     const specs = [
         {
@@ -2036,7 +2231,7 @@ function buildTutorialData(site, codeUrl, repoSlug) {
             n: i + 1,
             title: s.title,
             desc: s.desc,
-            url: codeUrl(s.prompt),
+            prompt: s.prompt,
         })),
     };
 }
@@ -3067,7 +3262,8 @@ a.ds-tile:hover { text-decoration: none; }
 /* 取り込みの条件は箇条書きで出す（ANDであることを読み飛ばせないように） */
 .sec-how-list { margin: 4px 0; padding-left: 1.3em; }
 .sec-how-list li { margin: 2px 0; }
-/* 会議の主催者向けの選択肢（Meet Recordings フォルダの共有・2026-08-29 オーナー承認）。
+/* 会議の主催者向けの選択肢（「Google Meet」フォルダの共有・2026-08-29 オーナー承認。
+   共有対象のフォルダ名は 2026-09-03 に Meet Recordings から Google Meet へ改めた・#393）。
    **折りたたまない。** 週次整理の節が「誰も見ない」で撤去された経緯があるので、
    知ってほしい選択肢を <details> の中に隠さない。従来の bot 招待の説明の下に、
    枠で囲った別の話として置く（差し替えではなく追加であることを見た目でも示す） */
@@ -3370,6 +3566,14 @@ var CAP_STATE_TEXT = ${JSON.stringify(CAP_STATE_TEXT)};
 var CAP_STATE_MARK = ${JSON.stringify(CAP_STATE_MARK)};
 ${externalCapability.toString()}
 ${sourceAdapter.toString()}
+  // Claude Code への導線（#404）。**組み立ての正本は上の claudeCodeUrl だけ。**
+  // 🔴 この定数行を落とすと、流し込んだ関数が未定義の CLAUDE_CODE_HOME を参照して
+  // 画面のスクリプトが丸ごと死ぬ（定数は export できないので、値はここで注入する）
+var CLAUDE_CODE_HOME = ${JSON.stringify(CLAUDE_CODE_HOME)};
+${isRepositorySlug.toString()}
+${devRepositoryRefs.toString()}
+${claudeCodeRepositories.toString()}
+${claudeCodeUrl.toString()}
 ${sourceMatchesAdapter.toString()}
 ${adapterList.toString()}
 ${adapterEntry.toString()}
@@ -3390,6 +3594,10 @@ var REGISTERED_CAP_NAMES = ${JSON.stringify(REGISTERED_CAP_NAMES)};
 var REGISTERED_FIELDS = ${JSON.stringify(REGISTERED_FIELDS)};
 var REGISTERED_REQUIRED = ${JSON.stringify(REGISTERED_REQUIRED)};
 var REGISTERED_DEV_TYPES = ${JSON.stringify(REGISTERED_DEV_TYPES)};
+  // 「もう登録されている」という断りの語尾（#409）。**この定数行を落とすと、
+  // 流し込んだ isAlreadyRegistered が未定義を参照して画面のスクリプトが丸ごと死ぬ**
+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)};
 ${sanitizeRegisteredNow.toString()}
@@ -3418,10 +3626,13 @@ ${pending_ops_1.pendingRepo.toString()}
 ${pending_ops_1.pendingFigmaKey.toString()}
 ${pending_ops_1.pendingDriveFolderId.toString()}
 ${pending_ops_1.pendingLabel.toString()}
+${pending_ops_1.pendingIsSpaceRef.toString()}
+${pending_ops_1.pendingIsSlackTeamId.toString()}
 ${pending_ops_1.pendingOpOf.toString()}
 ${pending_ops_1.sanitizePendingOps.toString()}
 ${pending_ops_1.rememberPendingOp.toString()}
 ${pending_ops_1.pendingSiteTimeMs.toString()}
+${pending_ops_1.pendingStale.toString()}
 ${pending_ops_1.pendingOpBuildCaughtUp.toString()}
 ${pending_ops_1.pendingLiveRowMatches.toString()}
 ${pending_ops_1.pendingOpLiveAgrees.toString()}
@@ -3570,19 +3781,31 @@ ${deriveCapTile.toString()}
    */
   var DRIVE_INGEST_ACCOUNT = "cortex-notetaker@classmethod.jp";
   /**
-   * 自分の「Meet Recordings」フォルダへの入口。
+   * 自分の「Google Meet」フォルダへの入口。
    *
    * **フォルダIDは人ごとに違うので、フォルダを直接指すURLは作れない。** 代わりに
    * ドライブの検索URLを使う——開いた人のドライブの中で検索が走るので、**1本で全員に効く**。
-   * フォルダはマイドライブ直下にでき、日本語環境でも名前は英語のまま作られる。
+   * フォルダはマイドライブ直下にでき、**日本語環境でも名前は英語のまま**作られる
+   *（オーナー1人の実測。ロケールによって違う可能性は残る）。
+   *
+   * 🔴 **検索結果には会議ごとのフォルダも並ぶ。** メモは「Google Meet」の中の
+   *「<会議名> - 日付」「<会議名> (recurring)」というフォルダに入るので、名前で検索すると
+   * それらも一緒に出てくる。**共有すべきなのは、それらを入れている親のほう**——
+   * 絞り込みでは決着しないので、owner:me で他人の共有を落としたうえで、
+   * **どれを選ぶかは手順の文で言う**（下の steps の1つ目）。
    *
    * **共有ダイアログを直接開くURLは無い。** リンクの先で「右クリック → 共有」の1手が要ることは、
    * 押す前に画面へ書く（リンクだけ置くと、開いた先で止まる人が出る）。
    */
-  var MEET_FOLDER_SEARCH_URL = "https://drive.google.com/drive/search?q=type:folder%20Meet%20Recordings";
+  var MEET_FOLDER_SEARCH_URL =
+    "https://drive.google.com/drive/search?q=type:folder%20owner:me%20%22Google%20Meet%22";
   // 手順の画像（data URI）。中身と埋め込み方の理由は src/meet-guide-images.ts に書いてある
   var MEET_SHOT_STEP1 = "${meet_guide_images_1.MEET_SHARE_STEP1}";
   var MEET_SHOT_STEP2 = "${meet_guide_images_1.MEET_SHARE_STEP2}";
+  // Google Chat の「スペースにアプリを追加する」手順の画像（#389）。理由は
+  // src/google-chat-guide-images.ts に書いてある（Meet と同じ埋め込み方）
+  var GCHAT_SHOT_STEP1 = "${google_chat_guide_images_1.GCHAT_APP_STEP1}";
+  var GCHAT_SHOT_STEP2 = "${google_chat_guide_images_1.GCHAT_APP_STEP2}";
 
   function copyRow(text) {
     // **input と button を使わない。** 追加フォームの中に置くので、input を足すと
@@ -3821,10 +4044,33 @@ ${deriveCapTile.toString()}
   var REPO_SLUG = SITE.repoBaseUrl
     ? SITE.repoBaseUrl.replace(/^https?:\\/\\/github\\.com\\//, "").replace(/\\.git$/, "")
     : "";
+  // 組み立ての正本は claudeCodeUrl（上で流し込んだビルド時の関数・#404）。
+  // 開発リポジトリは **まとめ表ではなく画面と同じ値**（まとめ表＋登録の即時値＋仮置き）から取る
+  // ——焼き込むと、登録した開発リポジトリがその日いっぱい AI 導線に載らない。
+  // 🔴 **var MERGE_KEYS の宣言より上に codeUrl を呼ぶトップレベル文を足さないこと。**
+  // fleetVal は MERGE_KEYS を読むが、var の初期化は宣言行に達するまで走らない
+  // （関数宣言の巻き上げでは undefined を読む）。呼び出しは全て描画（route）以降に置く
   function codeUrl(prompt) {
-    return REPO_SLUG
-      ? "https://claude.ai/code?repo=" + REPO_SLUG + "&prompt=" + encodeURIComponent(prompt)
-      : "https://claude.ai/code/";
+    return claudeCodeUrl(prompt, REPO_SLUG, fleetVal("externalSources") || []);
+  }
+  // AI 導線の a はここでだけ作る。href を決めてよいのは codeUrl だけ（#404）。
+  // 指示文を属性に残すのは、接続状況の応答が届いたときに href を組み直すため（syncAiLinks）
+  function aiLink(cls, prompt, text) {
+    var a = el("a", { class: cls, href: codeUrl(prompt), target: "_blank", rel: "noopener", text: text });
+    a.setAttribute("data-ai-prompt", prompt);
+    return a;
+  }
+  // 接続状況が届いた・保存が効いたときに、画面に出ている AI 導線の href を組み直す。
+  // 🔴 **pendingOpsNow の中（仮置きの失効）からは呼ばない**——codeUrl が fleetVal を
+  // 呼ぶので再入する。仮置きが失効して行が減ったときの貼り替えは行わない
+  // （15分後の話で、その頃には接続状況の応答が届いている）
+  // 🔴 **document を素で引かない（app.ownerDocument を使う）。** ここは接続状況の応答が
+  // 届いたときに走るので、**画面が畳まれた後に届く**ことがある（テストの window.close()・
+  // 実機のタブを閉じた直後）。掴んだノード越しなら、その後でも例外を投げずに済む
+  // ——投げると応答の後段（取り直しの停止など）が丸ごと落ちる
+  function syncAiLinks() {
+    var as = app.ownerDocument.querySelectorAll("a[data-ai-prompt]");
+    for (var i = 0; i < as.length; i++) as[i].href = codeUrl(as[i].getAttribute("data-ai-prompt"));
   }
   // editUrl（.../edit/<branch>/<path>）からリポジトリ相対のファイルパスを取り出す（プロンプトで対象を指し示すため）
   function repoPathOf(rec) {
@@ -3955,7 +4201,7 @@ ${deriveCapTile.toString()}
     if (!g) return null;
     var prompt = aiHead(g.skill) + g.add + AI_COMMON;
     return el("div", { class: "ai-add-bar" }, [
-      el("a", { class: "ai-add-btn", href: codeUrl(prompt), target: "_blank", rel: "noopener", text: "＋ AIで登録" }),
+      aiLink("ai-add-btn", prompt, "＋ AIで登録"),
     ]);
   }
   // 各Goldレコードの「AIで編集」ボタン（GitHubで編集の隣）。スキルの無い型では null
@@ -3967,7 +4213,7 @@ ${deriveCapTile.toString()}
     var target = (pathRef ? pathRef + " と " : "") + g.dir + "/README.md";
     var subject = "この" + g.noun + "「" + title + "」" + (pathRef ? "" : "（" + rec.id + "）");
     var prompt = aiHead(g.skill) + g.edit(target, subject) + AI_COMMON;
-    return el("a", { class: "ai-edit-btn", href: codeUrl(prompt), target: "_blank", rel: "noopener", text: "AIで編集" });
+    return aiLink("ai-edit-btn", prompt, "AIで編集");
   }
 
   // ---------- AIからの更新提案（.cortex/gold-proposals.json 由来） ----------
@@ -4027,7 +4273,7 @@ ${deriveCapTile.toString()}
     );
     lines.push("書き込む前に、変更内容を提示して承認を得てください。");
     var prompt = aiHead(g.skill) + lines.join("\\n") + AI_COMMON;
-    return el("a", { class: "ai-apply-btn", href: codeUrl(prompt), target: "_blank", rel: "noopener", text: "AIで適用" });
+    return aiLink("ai-apply-btn", prompt, "AIで適用");
   }
 
   /**
@@ -4275,7 +4521,7 @@ ${deriveCapTile.toString()}
     challenges.forEach(function (c) {
       var done = tutIsDone(c.n);
       var card = el("div", { class: "tut-card" + (done ? " tut-done" : "") });
-      var btn = el("a", { class: "tut-btn", href: c.url, target: "_blank", rel: "noopener", text: "🚀 挑戦する" });
+      var btn = aiLink("tut-btn", c.prompt, "🚀 挑戦する");
       var cb = el("input", { type: "checkbox" });
       cb.checked = done;
       var check = el("label", { class: "tut-check" }, [cb, el("span", { text: "完了" })]);
@@ -4371,11 +4617,8 @@ ${deriveCapTile.toString()}
    * 破棄の条件を2つ持つと、片方だけ直したときに挙動が割れる。
    */
   function iconPendingStale(pend, nowMs) {
-    if (!pend || isNaN(nowMs)) return false;
-    var byAt = typeof pend.at === "number" && nowMs > pend.at + TOMBSTONE_MARGIN_MS;
-    var gen0 = siteTimeMs(pend.gen0);
-    if (isNaN(gen0)) return byAt;
-    return byAt && nowMs > gen0 + TOMBSTONE_MARGIN_MS;
+    if (!pend) return false;
+    return pendingStale(pend.at, pend.gen0, nowMs);
   }
   /** いま覚えている反映待ちを記録する（保存・解除に共通の形） */
   function rememberIconPending(kind, dataUrl) {
@@ -4519,7 +4762,7 @@ ${deriveCapTile.toString()}
     // **本物が追いついたら仮画像を捨てる。** 残したままだと、次に差し替えた人にも
     // 古い仮画像が見え続ける（削除のトゥームストーンと同じ捨て方）
     var pend = readIconPending();
-    if (pend && iconPendingStale(pend, siteTimeMs(SITE.generatedAt))) clearIconPending();
+    if (pend && iconPendingStale(pend, pendingSiteTimeMs(SITE.generatedAt))) clearIconPending();
     var cur = projectIconCurrent();
     slot.textContent = "";
 
@@ -4741,7 +4984,7 @@ ${deriveCapTile.toString()}
     // （renderSiteIcon）——全タブから同じ場所で触れる形にした
     head.appendChild(titleWrap);
     var homeEditRow = el("div", { class: "detail-actions-row" }, [
-      el("a", { class: "ai-edit-btn", href: codeUrl(HOME_EDIT_PROMPT), target: "_blank", rel: "noopener", text: "AIで編集" }),
+      aiLink("ai-edit-btn", HOME_EDIT_PROMPT, "AIで編集"),
     ]);
     if (h.editUrl) {
       homeEditRow.appendChild(el("a", { class: "edit-btn", href: h.editUrl, target: "_blank", rel: "noopener", text: "GitHubで編集" }));
@@ -4796,7 +5039,7 @@ ${deriveCapTile.toString()}
       ]),
     ]);
     var actions = el("div", { class: "home-unfilled-actions" }, [
-      el("a", { class: "ai-add-btn", href: codeUrl(HOME_WRITE_PROMPT), target: "_blank", rel: "noopener", text: "AIで書く" }),
+      aiLink("ai-add-btn", HOME_WRITE_PROMPT, "AIで書く"),
     ]);
     if (SITE.home && SITE.home.editUrl) {
       actions.appendChild(el("a", { class: "edit-btn", href: SITE.home.editUrl, target: "_blank", rel: "noopener", text: "GitHubで編集" }));
@@ -5308,13 +5551,17 @@ ${deriveCapTile.toString()}
   }
 
   /**
-   * 主催者向けの選択肢: 「Meet Recordings」フォルダを1回共有すると、以後は招待が要らない。
+   * 主催者向けの選択肢: 「Google Meet」フォルダを1回共有すると、以後は招待が要らない。
    *
    * **上の bot 招待の説明は残したまま足す（2026-08-29 オーナー承認）。** 招待方式は
    * 参加するだけの会議・他社主催の会議で今も唯一の手段なので、置き換えではない。
    *
+   * **共有対象は 2026-09-03 に「Meet Recordings」から「Google Meet」へ改めた（#393）。**
+   * Gemini の保存先が変わり、メモは「Google Meet」の中の会議ごとのフォルダに入るようになった。
+   *
    * **手順の細目は書かない。** 正本は apps-script/docs/meet-recordings-sharing.md で、
-   * 「マイドライブの直下しか見ない」「メモを移すと対象外になる」等はそちらが持つ。
+   * 「共有したフォルダから1階層下までしか見ない」「メモを移すと対象外になる」
+   * 「Google Meet が無い環境では Meet Recordings を共有する」等はそちらが持つ。
    * 画面が担うのは**選択肢があることと、共有すると何が起きるかの1行**まで
    *（同じ説明を2箇所で維持すると、必ず片方が古くなる）。
    *
@@ -5326,11 +5573,14 @@ ${deriveCapTile.toString()}
   function meetingFolderShare(signal, aliasCount) {
     var box = el("div", { class: "mt-share" });
     box.appendChild(el("div", { class: "mt-share-title", text: "毎回の招待をやめる方法（会議の主催者向け・任意）" }));
-    box.appendChild(el("p", { text: "自分の Google ドライブにある「Meet Recordings」フォルダを、下のアカウントに「閲覧者」で1回だけ共有すると、以後あなたが主催する会議は招待が要らなくなります。会議名の目印はこれまでどおり必要です。" }));
+    box.appendChild(el("p", { text: "自分の Google ドライブにある「Google Meet」フォルダ（2026年7月より前から使っている環境では「Meet Recordings」）を、下のアカウントに「閲覧者」で1回だけ共有すると、以後あなたが主催する会議は招待が要らなくなります。会議名の目印はこれまでどおり必要です。「Google Meet」フォルダがまだ無い場合は、Gemini のメモを ON にした会議を1回主催すると作られます。" }));
     box.appendChild(copyRow(DRIVE_INGEST_ACCOUNT));
 
     /*
-     * 🔴 **「全部見られてしまうのでは」に答える**（2026-08-29 オーナー確定文・表記も含めて変えない）。
+     * 🔴 **「全部見られてしまうのでは」に答える**（2026-08-29 オーナー確定文）。
+     * **2026-09-03 に1語だけ更新した（#393）**——「ファイル名だけを見ます」は、共有フォルダの
+     * 1階層下まで見るようになって不正確になったので「フォルダ名とファイル名だけを見ます」に。
+     * それ以外は表記も含めて変えない。
      *
      * すぐ下の注記（.mt-share-note）は「**取り込むか**」に答えていて、
      * 「**見るのか**」に答えていない。共有をためらう理由はそちらなので、専用に1行置く。
@@ -5358,7 +5608,7 @@ ${deriveCapTile.toString()}
       : mark + "に当てはまらない";
     box.appendChild(el("p", {
       class: "mt-privacy",
-      text: "⚠ 共有を開始すると、bot はこのフォルダのファイル名だけを見ます。" + scope +
+      text: "⚠ 共有を開始すると、bot はこのフォルダの中のフォルダ名とファイル名だけを見ます。" + scope +
         "メモは、中身を開きません。読み取りも保存も行わないので、1on1や面談のメモがどこかに残ることはありません。",
     }));
 
@@ -5368,20 +5618,22 @@ ${deriveCapTile.toString()}
     // 押す前に書いておく（押した先で迷子にしない）
     box.appendChild(el("a", {
       class: "mt-share-open", href: MEET_FOLDER_SEARCH_URL, target: "_blank", rel: "noopener",
-      text: "自分の「Meet Recordings」フォルダを開く →",
+      text: "自分の「Google Meet」フォルダを開く →",
     }));
     var steps = el("ol", { class: "mt-share-steps" });
-    steps.appendChild(el("li", { text: "上のリンクを開くと、自分のドライブの中から「Meet Recordings」フォルダが検索されます。" }));
-    steps.appendChild(el("li", { text: "そのフォルダを右クリック（または右上の ⋮）して「共有」→「共有」を選びます。" }, [
+    // 🔴 **どれを選ぶかをここで言い切る。** 検索結果には会議ごとのフォルダも並ぶので、
+    // 「検索されます」だけで終えると、末尾に日付の付いたフォルダを共有してしまう人が出る
+    steps.appendChild(el("li", { text: "上のリンクを開くと、自分のドライブの中から「Google Meet」フォルダが検索されます。名前がちょうど「Google Meet」のものを選んでください。末尾に日付や (recurring) が付いたものは会議ごとのフォルダなので、それらを入れている親を選びます。" }));
+    steps.appendChild(el("li", { text: "そのフォルダを右クリック（または右上の ⋮）して「共有」→「共有」を選びます（画像は旧名称「Meet Recordings」のときの画面ですが、操作は同じです）。" }, [
       // **寸法を属性で書く。** 書かないと、モーダルを開いた瞬間に画像の高さのぶんだけ
       // 下の手順がずれる。loading=lazy は付けない——**data: URI には取得が無いので
       // 何もしない**のに、付いていると「遅延読み込みしている」という誤解が仕様として残る
       el("img", { class: "mt-shot", src: MEET_SHOT_STEP1, width: "664", height: "425",
-        alt: "Googleドライブの検索結果。Meet Recordings フォルダのメニューで「共有」を選び、右に開いたサブメニューの「共有」を指している画面。" }),
+        alt: "Googleドライブの検索結果。フォルダのメニューで「共有」を選び、右に開いたサブメニューの「共有」を指している画面（旧名称「Meet Recordings」のときの例）。" }),
     ]));
-    steps.appendChild(el("li", { text: "上のアカウントを貼り付け、権限を「閲覧者」にして「共有」を押します（通知のチェックは外して構いません）。" }, [
+    steps.appendChild(el("li", { text: "上のアカウントを貼り付け、権限を「閲覧者」にして「共有」を押します（通知のチェックは外して構いません。画像は旧名称「Meet Recordings」のときの画面ですが、操作は同じです）。" }, [
       el("img", { class: "mt-shot", src: MEET_SHOT_STEP2, width: "425", height: "220",
-        alt: "「Meet Recordings」を共有するダイアログ。宛先に cortex-notetaker のアカウントが入り、権限が「閲覧者」に設定され、右下に「共有」ボタンがある画面。" }),
+        alt: "フォルダを共有するダイアログ。宛先に cortex-notetaker のアカウントが入り、権限が「閲覧者」に設定され、右下に「共有」ボタンがある画面（旧名称「Meet Recordings」のときの例）。" }),
     ]));
     box.appendChild(steps);
 
@@ -6135,7 +6387,7 @@ ${deriveCapTile.toString()}
     // 記録の追加でも進むので、それで捨てると下地の古い行が残ったまま仮置きだけ消える
     var kept = prunePendingOps(PENDING_OPS, {
       now: Date.now(),
-      siteNowMs: siteTimeMs(rawFleetVal("generatedAt")),
+      siteNowMs: pendingSiteTimeMs(rawFleetVal("generatedAt")),
       live: LIVE_REGISTERED,
       liveAt: LIVE_REGISTERED_AT,
     });
@@ -6151,7 +6403,7 @@ ${deriveCapTile.toString()}
    * ——失敗した操作を「入っている」ように見せない（#184 の懸念その1）。
    * 作れたエントリを返す（切り出せない入力では null＝従来どおり live の読み直しに任せる）
    */
-  function notePendingOp(payload, targets) {
+  function notePendingOp(payload, targets, response) {
     if (!SITE.intake) return null;
     var entry = pendingOpOf(payload, {
       projectKey: SITE.intake.projectKey,
@@ -6160,6 +6412,8 @@ ${deriveCapTile.toString()}
       generatedAt: rawFleetVal("generatedAt") || "",
       // Backlog の解除は送る payload にドメインが無いので、表示中の一覧から補う
       targets: targets || null,
+      // 保存の応答（#391）。Slack の追加で、サーバが実測した組織（slackOrg）を受け取る
+      response: response || null,
     });
     if (!entry) return null;
     // **書く前に読み直す。** メモリの一覧に足して書き戻すだけだと、別のタブが書いた仮置きを
@@ -7163,15 +7417,58 @@ ${deriveCapTile.toString()}
         return sourceAdapter(s.type) === kind;
       });
     }
-    /** 行の見た目を決める値だけを並べる（時刻など毎回変わる値は入れない） */
+    /**
+     * 行の見た目を決める値だけを並べる（時刻など毎回変わる値は入れない）。
+     * 🔴 **「確かめられたか」も混ぜる（#409）。** 混ぜないと、応答が届いて
+     * 注記の要否が変わっても署名が同じままで、**一覧が作り直されない**
+     *（0件の一覧は行が増えないので、行だけを見ていると変化が現れない）
+     */
     function externalsSig(kind, extra) {
-      return JSON.stringify([liveExternals(kind), extra]);
+      return JSON.stringify([liveExternals(kind), extra, registrationUnreadable()]);
     }
     /**
      * **空の箱を置いてよいのは、そこへ足せる案件だけ。** 投入の口を持たない構成
      * （素の Decisions ビュー）で行も無い能力に空の箱を積むと、押しても何も無いモーダルになる。
      */
     function liveListWanted(kind) { return !!SITE.intake || liveExternals(kind).length > 0; }
+    /**
+     * 🔴 **「1件も登録されていない」と「確かめられなかった」を分ける（#409）。**
+     *
+     * サーバは登録ファイルを読めなかった能力を、**キーごと応答から落とす**
+     *（「読めなかった」を「0件」と混ぜないため。intake の buildRegisteredNow）。
+     * ところが画面はそれを「足す行が無い」としか受け取っていなかったので、
+     * **確かめられなかった結果が「登録されていません」として出ていた**。
+     * オーナーはそれを見て未登録だと読み、追加して「既に登録されています」と断られた。
+     *
+     * 🔴 **能力ごとのキーの有無で判定してはいけない（実装レビューの指摘）。** サーバは
+     * 「読めなかった」ときだけでなく **「そのファイルがまだ無い」ときにも同じくキーを落とす**
+     * （読んだ本文が null でも undefined でも、文字列でなければ同じ枝に落ちる）。
+     * キーの有無で見ると、**その能力をまだ使っていない案件**——つまり立ち上げ直後の、
+     * この画面が一番よく見られる状態——に**永久に消えない誤警報**が出る
+     * （「再読み込みしてください」と言われても、設定ファイルは再読み込みでは生えない）。
+     * しかも製品としては、その状態は「登録されていません」と言い切ると決めてある
+     * （engine の capabilities: ファイルの有無は実装の都合で、利用者にはどちらも「まだ登録していない」）。
+     *
+     * **だから応答まるごとで見る。** 登録ファイルの一覧（registeredNow）と
+     * 能力の状態（capabilitiesNow）は**サーバの同じ return から出る**ので、
+     * **両方とも無いときだけ**が「そもそも読みに行けなかった」——今回の症状の
+     * 3経路（ツリー取得の失敗・ツリーの打ち切り・応答そのものの失敗）は全部これに当たる。
+     *
+     * ⚠ この粒度では、**ファイル1本だけが読めなかった回**（8秒の打ち切り・単発の失敗）は
+     * 拾えない。そちらはサーバがログを出す経路なので、まず記録から追えるようにしてある。
+     */
+    function registrationUnreadable() {
+      return liveAnswered && LIVE_REGISTERED === null && LIVE_CAPS === null;
+    }
+    /**
+     * 空の一覧の代わりに出す1行。**帯は症状・行は一手・繰り返さない。**
+     * 空の一覧そのものを出さない——今回オーナーが踏んだのは「空の一覧を見て未登録だと読んだ」ことなので。
+     * 応答がまだ届いていない間は出さない（確かめる前に「確かめられなかった」と言わない）。
+     */
+    function unverifiedListNote(noun) {
+      if (!registrationUnreadable()) return null;
+      return el("div", { class: "ds-note", text: "登録されている" + noun + "を確認できませんでした。再読み込みしてください。" });
+    }
     // **箱にはアダプタのタグを付ける（#153）。** pushCap の無タグは「どのタイルにも出す」
     // 既定なので、タグを忘れると Slack の一覧が Google Chat モーダルに丸ごと出る
     if (liveListWanted("slack")) pushCap("チャット", liveList(
@@ -7179,7 +7476,11 @@ ${deriveCapTile.toString()}
       function () { return externalsSig("slack", slackWorkspaces()); },
       function (box) {
         var items = liveExternals("slack");
-        if (!items.length) return;
+        if (!items.length) {
+          var noteSlack = unverifiedListNote("チャンネル");
+          if (noteSlack) box.appendChild(noteSlack);
+          return;
+        }
         var meta = DS_TYPE["slack"] || { icon: "🔗", label: "Slack" };
         slackRows(items, meta).forEach(function (n) { box.appendChild(n); });
       },
@@ -7191,7 +7492,11 @@ ${deriveCapTile.toString()}
       function () { return externalsSig("google-chat", null); },
       function (box) {
         var items = liveExternals("google-chat");
-        if (!items.length) return;
+        if (!items.length) {
+          var noteGchat = unverifiedListNote("スペース");
+          if (noteGchat) box.appendChild(noteGchat);
+          return;
+        }
         var meta = DS_TYPE["google-chat"] || { icon: "💬", label: "Google Chat" };
         items.forEach(function (s) { box.appendChild(extSourceCard(s, meta)); });
       },
@@ -7201,7 +7506,11 @@ ${deriveCapTile.toString()}
       function () { return externalsSig("github", githubOwnersView() || null); },
       function (box) {
         var items = liveExternals("github");
-        if (!items.length) return;
+        if (!items.length) {
+          var noteDev = unverifiedListNote("リポジトリ");
+          if (noteDev) box.appendChild(noteDev);
+          return;
+        }
         // **meta は行ごとに引く**（issues と discussions でアイコンとラベルが違う）
         githubRows(items).forEach(function (n) { box.appendChild(n); });
       },
@@ -9553,22 +9862,43 @@ ${deriveCapTile.toString()}
     // 案内（アプリ追加の操作列）は独立の箱にせず、この手順リストが持つ（#170/#174 の圧縮方針。
     // fleet-status にデータが無い案件でもフォームは常設なので、案内も常に出る）
     //
-    // Google Chat アプリの表示名。**Marketplace 公開名として確定（2026-08-31 オーナー決定）。**
+    // Google Chat アプリの表示名。**Marketplace 公開名（2026-09-03 オーナー決定で
+    // 「Cortex Bot」から改称・#387。このモーダル分は #389 で済ませた）。**
     // 検索ワードとして本文に組み込む（コピー行は置かない——コマンドではなく検索語のため）
-    var GCHAT_APP_NAME = "Cortex Bot";
+    var GCHAT_APP_NAME = "Cortex by Classmethod";
     box.appendChild(addForm({
       title: "＋ Google Chat スペースを追加",
-      placeholder: "https://chat.google.com/room/XXXXXXXXXXX",
-      requiredNote: "スペースのURLを入力してください。",
+      // **いま画面に出ている形を例示する（#389）。** 旧UIの /room/ を例にしていたので、
+      // 新UIの人は自分のアドレスバーと見比べて「別のものを求められている」と読む
+      placeholder: "https://chat.google.com/app/chat/XXXXXXXXXXX",
+      // 素の spaces/<ID> も受ける（#389）ので、URL しか受けないとは書かない
+      requiredNote: "スペースの URL か spaces/… を入力してください。",
       // 手順リスト（#170 の型）。アプリ追加の話が先——Slack の招待と同じで、入っていないと
       // 1件も読めない。操作列は Google 公式ヘルプの現行手順に合わせる
       // （support.google.com/chat/answer/7655820）。DM が対象外であることもここで言う——
       // 貼って 400 になってから知るより先に
+      //
+      // **1行1手に詰める（2026-09-03 オーナー指示・#389）。** 手順の中に事情の説明が
+      // 混ざると、読む人が「自分がいま何をすべきか」を自分で切り出すことになる。
+      // 🔴 落とさない語（既存テストが固定している）: 「アプリと統合」「Gold 昇格の対象になり」
+      // 「登録を解除」「22時」——重さと止め方を伝える場所がこの手順しか無いため
       hint: [
-        "読み取りたいスペースに Cortex のアプリを追加します。スペース名をクリック → 「アプリと統合」 → 「アプリを追加」 で、「" + GCHAT_APP_NAME + "」を検索して追加します。",
-        "アプリが検索に出ないときは、貴社の Google Workspace 管理者が Marketplace からの導入をまだ承認していません。承認できるのは管理者だけで、反映まで最大24時間かかります（見つからない場合は担当者にご連絡ください）。",
-        "下の欄に、ブラウザでスペースを開いたときのURL（chat.google.com/room/…）を貼って「追加」を押します。DM（1対1のチャット）は読み取りの対象外です。",
-        "追加したスペースは毎晩の Gold 昇格の対象になり、Decision・用語集の材料になります。止めるときは、その行の「登録を解除」を押します（今夜の蒸留・22時ごろまでに解除すれば取り込まれません）。",
+        {
+          text: "読み取りたいスペースに Cortex のアプリを追加します。スペース名 → 「アプリと統合」 → 「アプリを追加」 で、「" + GCHAT_APP_NAME + "」を検索して追加します。",
+          // **画像は補助で、上の1文だけで手順が完結する**（読み上げ・画像が出ない環境）。
+          // 寸法は属性で明示——書かないと、モーダルを開いた瞬間に画像の高さのぶん下の手順がずれる。
+          // loading=lazy は付けない（data: URI には取得が無いので何もしない・Meet と同じ）。
+          // 2枚を div でくるむのは、hintNode の口を広げないため（1手順＝1ノードの約束を保つ）
+          node: el("div", {}, [
+            el("img", { class: "mt-shot", src: GCHAT_SHOT_STEP1, width: "900", height: "566",
+              alt: "Google Chat のスペースの画面。スペース名の横のメニューが開いていて、その中の「アプリと統合」が赤い枠で示されている。" }),
+            el("img", { class: "mt-shot", src: GCHAT_SHOT_STEP2, width: "900", height: "491",
+              alt: "「アプリと統合」の画面。右上の「＋ アプリを追加」が赤い枠で示され、その下に、このスペースに追加されているアプリの一覧が並んでいる。" }),
+          ]),
+        },
+        "検索に出ないときは、貴社の Google Workspace 管理者の承認がまだです（承認できるのは管理者だけ・反映まで最大24時間）。",
+        "下の欄に、ブラウザでスペースを開いたときのURL（chat.google.com/app/chat/… または /room/…）を貼って「追加」を押します。DM（1対1のチャット）は対象外です。",
+        "追加したスペースは毎晩の Gold 昇格の対象になり、Decision・用語集の材料になります。止めるときは、その行の「登録を解除」を押します（今夜のぶんは22時ごろまでに解除すれば取り込まれません）。",
       ],
       build: function (url) {
         return { op: "add-google-chat-space", url: url };
@@ -9762,6 +10092,37 @@ ${deriveCapTile.toString()}
           msg.textContent = "✗ " + (j.message || "保存できませんでした。");
           return;
         }
+        // 🔴 **「既に登録されています」は失敗ではない（#409）。**
+        //
+        // サーバがそう答えた時点で、その接続先は**登録ファイルに確かに在る**。
+        // それまでは赤い「✗」を出して終わっていたので、**一覧が空のまま**の画面で
+        // 追加した人は「登録されているらしいが、どこにも出ていない」という袋小路に落ちた
+        // （オーナーが cortex-test で踏んだ症状そのもの）。
+        // **サーバが教えてくれた事実を、そのまま一覧に反映する。**
+        //
+        // 仮置き（#388）に足すのは、保存が効いたときと同じ扱いでよい——
+        // 「登録ファイルに在る」という主張はどちらも同じで、仮置きは本物が追いつけば消える。
+        if (isAlreadyRegistered(j.message)) {
+          var known = notePendingOp(payload, hooks && typeof hooks.pendingTargets === "function" ? hooks.pendingTargets() : null, j);
+          if (known) {
+            // 帯は症状ではなく**いまの事実**。行が横に出るので、繰り返さない
+            msg.className = "ds-toggle-msg is-ok";
+            msg.textContent = "✓ " + j.message + "（一覧に出しました）";
+            repaintOpenLists();
+            endBusy();
+            // 🔴 **成功と同じ後始末をする（実装レビューの指摘）。** onDone は入力欄を空にする
+            // ——空にしないと、行が出たと言いながら URL が欄に残り、**もう一度押させる形**になる
+            // （そのうえ「触っている最中」と見なされて、節ごとの差し替えが以後ずっと見送られる）。
+            // 仮置きの entry を渡すので、控えの二重表示にはならない。
+            // ⚠ **節ごとの差し替えは呼ばない。** 入力欄と結果メッセージを抱えたこの節は
+            // 「触っている最中」なので、あちらは必ず早期 return する（呼んでも何も起きない）。
+            // 一覧を追いつかせているのは上の repaintOpenLists。
+            if (onDone) onDone(j, { pending: known });
+            // **登録の即時読み取りを取りに行く。** 仮置きは繋ぎで、本物はサーバが持っている
+            loadLiveFleet(true);
+            return;
+          }
+        }
         // サーバの文言をそのまま出す（貼り方の案内・取り違えの警告を含んでいる）。
         // **例外は「他の人が先に変えていた」だけ**——サーバは再読み込みを案内するが、
         // 画面は既に追いついているので、済んでいることをやらせる案内になる（#127）
@@ -9775,7 +10136,7 @@ ${deriveCapTile.toString()}
       // その場で「反映待ち」の行が出ている横では嘘（intake の文面は本便では触らない）。
       // **changed:false では書かない**（何も変わっていないのに追加したと見せない）
       var pendingEntry = j.changed !== false
-        ? notePendingOp(payload, hooks && typeof hooks.pendingTargets === "function" ? hooks.pendingTargets() : null)
+        ? notePendingOp(payload, hooks && typeof hooks.pendingTargets === "function" ? hooks.pendingTargets() : null, j)
         : null;
       msg.className = "ds-toggle-msg is-ok";
       msg.textContent = "";
@@ -9819,6 +10180,7 @@ ${deriveCapTile.toString()}
         }
         repaintOpenLists();
         refreshDataSources();
+        syncAiLinks();
       }
       if (hooks && typeof hooks.onSaved === "function") hooks.onSaved(j);
       // **保存が効いたら、いまの登録を読み直す（段階1）。** 一覧はまとめ表（夜間バッチ）から
@@ -10064,6 +10426,8 @@ ${deriveCapTile.toString()}
    * まだ文章なので、そちらを壊さない。横展開でそれぞれ配列に変えていく。
    *
    * 各要素は文字列か、{ text, node } （手順の中に部品を挟むとき。招待コマンドなど）。
+   * **1手順に2つ以上を挟むときは、呼び出し側が div でくるんで node に渡す**（#389 の手順画像
+   * 2枚）——ここを「配列も受ける」に広げると、5つのフォームが通る共通部品の口が増える。
    */
   function hintNode(hint) {
     if (!hint) return null;
@@ -10253,9 +10617,10 @@ ${deriveCapTile.toString()}
     // 折りたたみの見出しでまとめるのをやめた（オーナー指摘「複雑になっちゃってる」）ので、
     // **どの組織かを言うのは行のラベルだけ**になった。社内に何も出さないと、
     // ラベルの無い行が「社内」なのか「まだ分かっていない」のかを読み分けられない。
-    // **仮置きの行（#388）には出さない。** どの組織かはサーバが追加時に実測して書くが
-    // 応答には載らないので、ここで「クラスメソッド」と名乗ると嘘になる（本物の行が来れば付く）
-    if (s.type === "slack" && s.pending !== true) {
+    // **仮置きの行（#388/#391）は、サーバが実測した組織を応答で受け取れたときだけ札を出す。**
+    // 受け取れない古い intake の窓では札ごと出さない——ここで既定に落とすと
+    // 「クラスメソッド」と名乗り、測っていないことを断言してしまう
+    if (s.type === "slack" && (s.pending !== true || s.pendingOrg === true)) {
       // **順序は groupSlackByOrg と揃える（workspace が先）。**
       // 逆にすると、判定が済んで workspace が入った行に古い印が残っているとき、
       // **並びは「Hapio AI」なのにラベルだけ「組織が分かりません」**になる
@@ -10829,6 +11194,10 @@ ${deriveCapTile.toString()}
         repaintOpenLists();
         // まだ足りない行があるなら取り直しを続ける（無くなったら止める）
         refreshStateTimer();
+        // 開発リポジトリが増えていれば AI 導線の href を組み直す（#404）。
+        // 🔴 **後段の仕事より後ろに置く。** ここで投げると、図の復帰・取り直しタイマーが
+        // 丸ごと落ちる（href を貼り替えるだけの処理に、そこまで巻き込ませない）
+        syncAiLinks();
         // 取得中に保存が効いていたら、迂回付きでもう一度取りに行く
         if (freshWanted) loadLiveFleet();
       })
@@ -10851,6 +11220,12 @@ ${deriveCapTile.toString()}
         // **失敗しても取り直しは続ける**（期限が来れば止まる）。ここで止めると、
         // 一時的な失敗のあと画面が二度と追いつかない
         refreshStateTimer();
+        // 🔴 **ここでも AI 導線を貼り替える（#404）。** 「失敗」に見えて、
+        // **登録の即時値（registeredNow）は既に読めている**ことがある——まとめ表
+        // （fleet-status.json）をまだ持たない案件は、上で fleet が無いと投げてここへ来る。
+        // つまり**立ち上げ直後の案件＝開発リポジトリを登録したばかりの案件**では、
+        // この行だけがヘッダーの導線を追いつかせる。**後段の仕事より後ろに置く**（上と同じ理由）
+        syncAiLinks();
         // 取得中に保存が効いていたら、迂回付きでもう一度取りに行く
         if (freshWanted) loadLiveFleet();
       });
@@ -10904,7 +11279,7 @@ ${deriveCapTile.toString()}
       el("span", { text: ": 精製された確定情報を読む" }),
     ]));
     var codeLi = el("li", {}, [
-      el("a", { href: "https://claude.ai/code/", target: "_blank", rel: "noopener", text: "Claude Code" }),
+      el("a", { href: CLAUDE_CODE_HOME, target: "_blank", rel: "noopener", text: "Claude Code" }),
       el("span", { text: ": 議事録・課題・資料の生データまで含めて、AIに質問・調査する" }),
     ]);
     ways.appendChild(codeLi);
@@ -12569,8 +12944,8 @@ ${deriveCapTile.toString()}
    * 「作ったはずのものが出てこない」状態が永久に続く（破棄の条件は applyDeleteTombstones）。
    */
   function deletedStoreKey() { return "cortex-deleted:" + REPO_SLUG; }
-  /** 「削除より後に始まったビルドか」を判断するときの余裕（下の tombstoneStale） */
-  var TOMBSTONE_MARGIN_MS = 30 * 60 * 1000;
+  // 「削除より後に始まったビルドか」を判断するときの余裕は PENDING_OPS_MARGIN_MS（30分）。
+  // **同じ性質の待ちなので定数も1つ**（#391）——別に持つと片方だけ直したときに割れる
 
   function readTombstones() {
     try {
@@ -12596,14 +12971,9 @@ ${deriveCapTile.toString()}
     list.push({ path: path, id: (rec && rec.id) || "", at: Date.now(), gen0: SITE.generatedAt || "" });
     writeTombstones(list);
   }
-  /**
-   * ビルド時刻の文字列（cli.ts が入れる "YYYY-MM-DD HH:mm UTC"）をミリ秒に直す。
-   * 読めなければ NaN——呼び出し側は**隠し続ける側に倒す**（嘘の再表示より安全）。
-   */
-  function siteTimeMs(s) {
-    if (typeof s !== "string" || !s) return NaN;
-    return Date.parse(s.replace(" UTC", "Z").replace(" ", "T"));
-  }
+  // ビルド時刻の文字列（cli.ts が入れる "YYYY-MM-DD HH:mm UTC"）→ ms は
+  // pendingSiteTimeMs（pending-ops.ts の実体を流し込んである）を使う。**写しを持たない**
+  //——同じ変換が2つあると、片方だけ直したときに「消したのに戻る」が片側でだけ起きる（#391）
   /**
    * このトゥームストーンはもう用済みか（＝削除より後のビルドにも記録が残っている）。
    *
@@ -12617,12 +12987,8 @@ ${deriveCapTile.toString()}
    * 再表示が遅れるだけ）。
    */
   function tombstoneStale(t, nowMs) {
-    if (isNaN(nowMs)) return false;
-    var byAt = typeof t.at === "number" && nowMs > t.at + TOMBSTONE_MARGIN_MS;
-    var gen0 = siteTimeMs(t.gen0);
-    // gen0 を持たない古い形式のエントリは at だけで見る（後方互換・安全側）
-    if (isNaN(gen0)) return byAt;
-    return byAt && nowMs > gen0 + TOMBSTONE_MARGIN_MS;
+    if (!t) return false;
+    return pendingStale(t.at, t.gen0, nowMs);
   }
   /** トゥームストーンの相手を SITE から探す（id で引き、無ければパスで照合） */
   function findTombstoned(t) {
@@ -12647,7 +13013,7 @@ ${deriveCapTile.toString()}
   function applyDeleteTombstones() {
     var list = readTombstones();
     if (!list.length) return;
-    var nowMs = siteTimeMs(SITE.generatedAt);
+    var nowMs = pendingSiteTimeMs(SITE.generatedAt);
     var kept = [];
     for (var i = 0; i < list.length; i++) {
       var t = list[i];
@@ -13841,6 +14207,41 @@ ${deriveCapTile.toString()}
     }
   }
 
+  /**
+   * ポータル配下で index.html に着いたら、アドレスを末尾スラッシュの形へ書き戻す（#400）。
+   *
+   * 🔴 **なぜ要るか。** ポータルの「門」（CloudFront）は、署名付きCookieの検証が
+   * CloudFront Function より先に走る制約のせいで、**入口（末尾スラッシュのURL）にしか
+   * 置けない**。門は通行証を持っている人を index.html（署名必須の側）へ送り出すので、
+   * 何もしないと**アドレス欄が index.html のまま**になる。そのURLは門に当たらないため、
+   * ブックマーク・Slack共有されると翌日（通行証の期限切れ）にまた素の403になり、
+   * メンバーでない人が共有リンクを開いても参加リクエストの導線が出ない。
+   * ここで書き戻せば、人がコピーするURLが常に門の効く形になる。
+   *
+   * 🔴 **クエリとハッシュを持ち越す。** 書き戻したあとの共有URLは**必ず門を通る**ので、
+   * クエリを落とすと門の302がそれを運べない限り復元できない（門は運ぶ作りになっている）。
+   * ハッシュは302をまたいでブラウザが引き継ぐ。
+   * ⚠ ただし**ビューアはハッシュを読んでいない**（本文はJSで後から描くので、ブラウザの
+   * フラグメントスクロールも効かない）。ここで保つのは「アドレス欄に残す」ところまでで、
+   * 見出しまでスクロールする機能ではない。タブを1回押すと pushState が落とす
+   *
+   * ⚠ 表示にも相対参照にも影響しない——index.html と末尾スラッシュは相対URLの基準
+   * （ディレクトリ）が同じ。以降の pushState も相対なので、ここを直せば後続の遷移も
+   * すべて末尾スラッシュ基準になる。
+   * ⚠ 範囲は**案件と向けの2階層がそろったポータル配下**だけ（下の linkTitleToPortal は
+   * 案件1階層でよいので、同じ形に見えて要件が違う。共通化しない）。Amplify配信や
+   * ローカルの静的サーバで index.html を直接開いている人のアドレスは触らない
+   */
+  (function rewritePortalIndexUrl() {
+    if (!/^\\/p\\/[^/]+\\/[^/]+\\//.test(location.pathname)) return;
+    if (!/\\/index\\.html$/.test(location.pathname)) return;
+    try {
+      history.replaceState(history.state, "", "./" + location.search + location.hash);
+    } catch (e) {
+      // file:// など replaceState が使えない環境では何もしない（表示には影響しない）
+    }
+  })();
+
   window.addEventListener("popstate", route);
   /**
    * ヘッダーの案件名（#379）。**ポータル配下（/p/<key>/ の下）で開いているときだけ**、
@@ -13891,6 +14292,10 @@ ${deriveCapTile.toString()}
   // 保存直後の mirror とメニューの開閉が、タブを移るたびに畳まれる
   renderSiteIcon();
   route();
+  // AI 導線の href を起動時に1回だけ組み直す（#404）。仮置き（localStorage）は
+  // ビルド時には存在しないので、**焼いた href は起動の時点で既に古いことがある**。
+  // 🔴 route() の後に置く——ヘッダー以外の導線は route() が描くまで DOM に無い
+  syncAiLinks();
   /**
    * 接続状況の先読み（#264）。**開いたタブに関係なく、起動時に1回だけ取りに行く。**
    *