@takagaki/cortex-decisions-viewer 0.12.31 → 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;
@@ -53,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)}" />`
@@ -342,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);
+}
 /**
  * 外部ソースの行が「この能力・このアダプタのタイル」に属するか。
  *
@@ -585,6 +701,34 @@ const REGISTERED_REQUIRED = {
 };
 /** 開発の種別に許す値。**知らない値は落とす**（画面のラベル・振り分けが決まらない） */
 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 を、画面が扱ってよい形へ畳む。**通らなかったものは黙って落とす。**
  *
@@ -2002,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 = [
         {
@@ -2087,7 +2231,7 @@ function buildTutorialData(site, codeUrl, repoSlug) {
             n: i + 1,
             title: s.title,
             desc: s.desc,
-            url: codeUrl(s.prompt),
+            prompt: s.prompt,
         })),
     };
 }
@@ -3422,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()}
@@ -3442,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()}
@@ -3888,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) {
@@ -4022,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
@@ -4034,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 由来） ----------
@@ -4094,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で適用");
   }
 
   /**
@@ -4342,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: "完了" })]);
@@ -4805,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で編集" }));
@@ -4860,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で編集" }));
@@ -7238,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(
@@ -7254,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); });
       },
@@ -7266,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)); });
       },
@@ -7276,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); });
       },
@@ -9858,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）
@@ -9915,6 +10180,7 @@ ${deriveCapTile.toString()}
         }
         repaintOpenLists();
         refreshDataSources();
+        syncAiLinks();
       }
       if (hooks && typeof hooks.onSaved === "function") hooks.onSaved(j);
       // **保存が効いたら、いまの登録を読み直す（段階1）。** 一覧はまとめ表（夜間バッチ）から
@@ -10928,6 +11194,10 @@ ${deriveCapTile.toString()}
         repaintOpenLists();
         // まだ足りない行があるなら取り直しを続ける（無くなったら止める）
         refreshStateTimer();
+        // 開発リポジトリが増えていれば AI 導線の href を組み直す（#404）。
+        // 🔴 **後段の仕事より後ろに置く。** ここで投げると、図の復帰・取り直しタイマーが
+        // 丸ごと落ちる（href を貼り替えるだけの処理に、そこまで巻き込ませない）
+        syncAiLinks();
         // 取得中に保存が効いていたら、迂回付きでもう一度取りに行く
         if (freshWanted) loadLiveFleet();
       })
@@ -10950,6 +11220,12 @@ ${deriveCapTile.toString()}
         // **失敗しても取り直しは続ける**（期限が来れば止まる）。ここで止めると、
         // 一時的な失敗のあと画面が二度と追いつかない
         refreshStateTimer();
+        // 🔴 **ここでも AI 導線を貼り替える（#404）。** 「失敗」に見えて、
+        // **登録の即時値（registeredNow）は既に読めている**ことがある——まとめ表
+        // （fleet-status.json）をまだ持たない案件は、上で fleet が無いと投げてここへ来る。
+        // つまり**立ち上げ直後の案件＝開発リポジトリを登録したばかりの案件**では、
+        // この行だけがヘッダーの導線を追いつかせる。**後段の仕事より後ろに置く**（上と同じ理由）
+        syncAiLinks();
         // 取得中に保存が効いていたら、迂回付きでもう一度取りに行く
         if (freshWanted) loadLiveFleet();
       });
@@ -11003,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);
@@ -14016,6 +14292,10 @@ ${deriveCapTile.toString()}
   // 保存直後の mirror とメニューの開閉が、タブを移るたびに畳まれる
   renderSiteIcon();
   route();
+  // AI 導線の href を起動時に1回だけ組み直す（#404）。仮置き（localStorage）は
+  // ビルド時には存在しないので、**焼いた href は起動の時点で既に古いことがある**。
+  // 🔴 route() の後に置く——ヘッダー以外の導線は route() が描くまで DOM に無い
+  syncAiLinks();
   /**
    * 接続状況の先読み（#264）。**開いたタブに関係なく、起動時に1回だけ取りに行く。**
    *

package/package.json

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