@takagaki/cortex-decisions-viewer 0.12.37 → 0.12.38

package/dist/render.js

@@ -34,6 +34,9 @@ exports.secretStateFromNow = secretStateFromNow;
 exports.secretRegisteredAnywhere = secretRegisteredAnywhere;
 exports.sanitizeCapabilitiesNow = sanitizeCapabilitiesNow;
 exports.sanitizeGithubOwnersNow = sanitizeGithubOwnersNow;
+exports.sanitizeOnboardingNow = sanitizeOnboardingNow;
+exports.claudeAppRepoSlug = claudeAppRepoSlug;
+exports.claudeAppRequestText = claudeAppRequestText;
 exports.splitNeededParts = splitNeededParts;
 exports.ingestedAtOf = ingestedAtOf;
 exports.keyMissingText = keyMissingText;
@@ -1792,6 +1795,100 @@ function sanitizeGithubOwnersNow(v) {
     }
     return out.length ? out : null;
 }
+/**
+ * 立ち上げの申請の印（`registeredNow.onboarding`・#94）の語彙。
+ * サーバ側 `CLAUDE_APP_STATES`（`infra/lambda/intake/logic.mjs`）の写し。
+ *
+ * 🔴 **増やすときは `logic.mjs` の `CLAUDE_APP_STATES` と `registeredOnboarding` を
+ * 同じ便で直すこと。順番は「サーバが先・画面が後」。**
+ *
+ * 片方だけ増やすと、その語の扱いが写しの間でずれる:
+ *   - 画面だけ増やす … サーバが `null` に倒した語を画面が受け取ることは無いので実害は
+ *     出ないが、次に触る人は「画面は知っているのに出ない」を追うことになる
+ *   - サーバだけ増やす … サーバが新しい語を返し始めるのに画面の篩が落とす。
+ *     `sanitizeOnboardingNow` は落としたものを `null` にするので、**印を出してはいけない
+ *     案件へ節が出る**方向には倒れないが、印を出すべき案件で節が二度と出なくなる
+ *
+ * **写しを互いに固定する検査は置けない**（intake とビューアは別パッケージで、
+ * ビューアは infra を実行時に読まない）。だから順番をここに書いて守る。
+ */
+const CLAUDE_APP_STATES = ["unrequested", "requested"];
+/** op=state に足す能力名。**`STATE_CAP_NAMES` には入れない**（`ALL_STATE_CAPS` の項） */
+const ONBOARDING_CAP = "onboarding";
+/**
+ * `registeredNow.onboarding`（立ち上げの印）の許可リスト。
+ *
+ * **他の registeredNow のキーとは器が違う**——あちらは行の配列、こちらは1つの状態
+ * （`{ claudeGithubApp }`）なので、`sanitizeRegisteredNow` には混ぜない
+ * （混ぜると配列を期待している篩がオブジェクトを踏む）。
+ *
+ * 🔴 **知らない語は `null` に倒す。** 画面は `"unrequested"` のときだけ節を出すので、
+ * `null` に倒れる＝**印を出さない側**へ倒れる。ここを truthy 判定に緩めると、
+ * サーバが新しい語を返し始めた日に、印を出してはいけない案件へ節が出る。
+ * `_note` のような運用メモは通さない（誰も確認していない文章を顧客の画面に出さない）。
+ */
+function sanitizeOnboardingNow(v) {
+    if (!v || typeof v !== "object" || Array.isArray(v))
+        return null;
+    const s = typeof v.claudeGithubApp === "string" ? v.claudeGithubApp : "";
+    if (CLAUDE_APP_STATES.indexOf(s) < 0)
+        return null;
+    return { claudeGithubApp: s };
+}
+/**
+ * 申請文に埋める `owner/repo`（`repoBaseUrl` から導く。追加入力なし）。
+ *
+ * 🔴 **正規表現をクライアント側に書き写さないこと。** 埋め込みJSはテンプレート
+ * リテラルの中なので、`\/` がリテラルの解釈で潰れて**別物の正規表現**になる
+ * （`splitNeededParts` / `backlogTargetOf` と同じ理由。実際にここで一度壊した）。
+ *
+ * **`repoNameOf` とは別に持つ。** あちらは画面に出す短い名前（owner を落とす）で、
+ * こちらは申請の宛先を一意に決める値——**owner を落としてはいけない**。
+ *
+ * **github.com のURLだけを受ける。** 別ホストの slug で申請文を作ると、
+ * 存在しないリポジトリの追加を依頼させることになる。
+ * owner だけの URL（github.com/owner）は空文字（呼び出し側が節ごと出さない）。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ */
+function claudeAppRepoSlug(repoBaseUrl) {
+    const m = /^https?:\/\/github\.com\/(.+)$/.exec(String(repoBaseUrl == null ? "" : repoBaseUrl));
+    if (!m)
+        return "";
+    const slug = m[1].replace(/\/+$/, "").replace(/\.git$/, "");
+    return slug.indexOf("/") > 0 ? slug : "";
+}
+/**
+ * Claude GitHub App の追加申請の申請文（画面がコピーして Slack へ貼る）。
+ *
+ * 🔴 **申請者本人の GitHub アカウント名はここで決めない。** 画面はログインしている人の
+ * GitHub アカウントを知らない（ビューアは Basic 認証で、GitHub とは繋がっていない）ので、
+ * **本人が書き足す**と文中で頼む——ポータルの `buildApplicationText` と同じ判断で、
+ * 間違ったアカウントを admin に入れる事故を防ぐ。
+ *
+ * ⚠ 装飾のない素のテキスト。申請の宛先（Slack のチャンネル）は Markdown を解釈しない。
+ *
+ * **クロージャを持たない純関数に保つこと**（`.toString()` でクライアントへ渡す）。
+ *
+ * **案件名も入れる。** 承認する側（GitHub の管理チーム）はリポジトリ名だけでは
+ * どの案件の話か分からず、名前が似た案件が並ぶと取り違えの元になる。
+ *
+ * @param repoSlug `owner/repo`。取れなければ空文字（呼び出し側が節ごと出さない）
+ * @param projectName この案件の表示名（画面のタイトル）。空なら行ごと落とす
+ */
+function claudeAppRequestText(repoSlug, projectName) {
+    const name = typeof projectName === "string" ? projectName.trim() : "";
+    return [
+        "Claude GitHub App の追加をお願いします。",
+        "",
+        // **空の「案件: 」を出さない。** 名前の無い行は、書き忘れたようにしか読めない
+        ...(name ? ["案件: " + name] : []),
+        "対象リポジトリ: " + repoSlug,
+        "用途: Cortex（AI 案件ビューア）のコンテキストリポジトリを Claude Code から読む",
+        "",
+        "申請者: （ここにご自身の GitHub アカウント名を書いてください）",
+    ].join("\n");
+}
 /**
  * サーバが返した「次の一手」（`needed`）を、素の文字列と URL に切り分ける。
  *
@@ -3380,6 +3477,24 @@ button.site-icon[aria-busy="true"] .site-icon-plus { opacity: 0; }
 @media (max-width: 600px) {
   .tut-actions { flex-direction: column; align-items: flex-start; }
 }
+/* ---- Claude GitHub App の追加申請（#94）----
+   接続マップの直後・「データソースと自動化」の前に出る。**印を持つ案件にしか出ない**ので、
+   常設の節と同じ見た目にはしない（一度きりの手続き）。
+   🔴 **枠は症状・行は一手。** 帯にしないのは、いま何かが壊れているわけではないから。 */
+.claude-app { margin-top: 28px; }
+.claude-app-head { font-size: 16px; font-weight: 700; color: var(--text); margin: 0 0 6px; }
+.claude-app-lead { color: var(--text); font-size: 13.5px; line-height: 1.8; margin: 0 0 10px; }
+/* 申請文。**選べる形で出す**（コピーボタンが使えない環境でも手で取れるように）。
+   等幅にするのは、貼り先（Slack）で改行がそのまま効くことを見せるため */
+.claude-app-text {
+  width: 100%; box-sizing: border-box; min-height: 130px; resize: vertical;
+  border: 1px solid var(--border); border-radius: 8px; padding: 10px 12px;
+  background: var(--surface); color: var(--text);
+  font-family: var(--mono, ui-monospace, SFMono-Regular, Menlo, monospace);
+  font-size: 12px; line-height: 1.7;
+}
+.claude-app-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; margin-top: 8px; }
+.claude-app-done { color: #1a7f37; font-size: 13px; margin: 0; }
 /* ---- データソースと自動化 ---- */
 .datasources { margin-top: 34px; }
 .datasources-head { font-size: 18px; font-weight: 700; color: var(--text); margin: 0 0 4px; }
@@ -4174,6 +4289,14 @@ ${secretStateFromNow.toString()}
 ${secretRegisteredAnywhere.toString()}
 ${sanitizeCapabilitiesNow.toString()}
 ${sanitizeGithubOwnersNow.toString()}
+  // 立ち上げの申請の印（#94）。**判定の実体はビルド時の定義**——画面側に書き写すと
+  // 語彙の許可リストが2枚になる。
+  // 🔴 この2つの定数行を落とすと、流し込んだ関数が未定義を参照して画面が丸ごと死ぬ
+var CLAUDE_APP_STATES = ${JSON.stringify(CLAUDE_APP_STATES)};
+var ONBOARDING_CAP = ${JSON.stringify(ONBOARDING_CAP)};
+${sanitizeOnboardingNow.toString()}
+${claudeAppRepoSlug.toString()}
+${claudeAppRequestText.toString()}
 ${splitNeededParts.toString()}
 ${ingestedAtOf.toString()}
 var TILE_CAPS = ${JSON.stringify(TILE_CAPS)};
@@ -7393,6 +7516,27 @@ ${calendarAddUrl.toString()}
    * 指すのか説明できなくなる（realtime を別に持っているのと同じ理由）。
    */
   var LIVE_REGISTERED = null;
+  /**
+   * 立ち上げの申請の印（op=state の registeredNow.onboarding・#94）。
+   * 中身は claudeGithubApp の1欄（"unrequested" / "requested"）か null。**取得前も null。**
+   *
+   * 🔴 **null と "requested" を区別しないこと**——どちらも「節を出さない」で正しい。
+   * 取得前に出す形にすると、印を持たない既存案件（34 件）で**一瞬だけ節が出る**。
+   *
+   * **LIVE_REGISTERED とは別に持つ。** あちらは能力ごとの行の配列で、こちらは
+   * 1つの状態。同じ入れ物に混ぜると、配列を期待している篩とマージがオブジェクトを踏む。
+   *
+   * 注: ここは埋め込みJSのテンプレートリテラル内。**コメントでもバッククォートを使わない**
+   */
+  var LIVE_ONBOARDING = null;
+  /**
+   * この画面で「申請済み」を押して、サーバが保存を確定したか（#94）。
+   *
+   * **メモリだけに持つ**（localStorage には書かない）。押した直後に取り直す正本が
+   * 遅れた・落ちた回に、**役目を終えた申請文とボタンが戻ってくる**のを止めるためだけの旗で、
+   * 再読み込みすれば案件側のファイル（正本）を読み直す——だから正本は2つにならない。
+   */
+  var CLAUDE_APP_DONE = false;
   /**
    * いまの LIVE_REGISTERED を取りに行った時刻（op=state の要求を出した時刻・#388）。
    * 仮置きの失効「保存より後の live が同じことを言っている」の根拠。届いた時刻ではなく
@@ -12062,7 +12206,12 @@ ${calendarAddUrl.toString()}
    * ⚠ **並べ替えてから送る。** サーバのキャッシュキーは caps を並べ替えて繋ぐが、
    * こちらも定数の並びを固定しておく（同じ集合が何通りにも増えない）。
    */
-  var ALL_STATE_CAPS = Object.keys(STATE_CAP_NAMES).sort();
+  // 🔴 **立ち上げの印（#94）は STATE_CAP_NAMES には足さず、ここで足す。** あちらは
+  // 「能力名の対応表」で、capabilitiesNow の行・接続状態ストアの引き当てにも使われる
+  // ——足すと、能力でも何でもない onboarding の行が能力の一覧に生える。
+  // ここに足すのは**サーバへ「このファイルも読んで」と伝える**ためだけ（操作タブを
+  // 開いているときは常に要求される。要求は常に全量なので、載せれば必ず入る）。
+  var ALL_STATE_CAPS = Object.keys(STATE_CAP_NAMES).concat([ONBOARDING_CAP]).sort();
   /**
    * 一度でも開いた能力。**送る caps とは無関係**（送るのは常に全量）。
    *
@@ -12177,6 +12326,11 @@ ${calendarAddUrl.toString()}
         // （＝立ち上げ直後＝この仕組みが一番効く案件）は下で throw するので、
         // ここより後に置くと**その案件だけ素通り**する
         LIVE_REGISTERED = sanitizeRegisteredNow(j && j.registeredNow);
+        // 🔴 **立ち上げの印も fleet より先に読む（#94）。** 印を持つのは
+        // **新しく作った案件だけ**＝まとめ表（fleet-status.json）をまだ持たない案件で、
+        // 下の「fleet が無ければ throw」の経路に入る。ここより後に置くと、
+        // **この節が一番効くはずの案件でだけ**印が出ない
+        LIVE_ONBOARDING = sanitizeOnboardingNow(j && j.registeredNow && j.registeredNow.onboarding);
         LIVE_REGISTERED_AT = startedAt;
         LIVE_STATE = sanitizeStateNow(j && j.stateNow);
         // **欄の有無をそのまま覚える。** sanitize を通した後では「読めて0件」が消える
@@ -12212,6 +12366,8 @@ ${calendarAddUrl.toString()}
         syncAiLinks();
         // Home を開いていれば「使用ツール」の状態を実測で描き直す（#275）
         syncHomeTools();
+        // 立ち上げの申請の印（#94）。**ライブが届いて初めて出る**（それまでは空の受け皿）
+        paintClaudeAppSection();
         // 取得中に保存が効いていたら、迂回付きでもう一度取りに行く
         if (freshWanted) loadLiveFleet();
       })
@@ -12243,13 +12399,173 @@ ${calendarAddUrl.toString()}
         // 🔴 **ここでも「使用ツール」を描き直す（#275）。** 実測（stateNow）は fleet より
         // 先に読んでいるので、まとめ表を持たない案件でもこの経路で状態が確定する
         syncHomeTools();
+        // 🔴 **ここでも印を描き直す（#94）。** まとめ表（fleet-status.json）をまだ
+        // 持たない案件は上で throw してここへ来る——**印を持つのはまさにその案件**なので、
+        // ここに置かないと、この節が一番効くはずの新規案件でだけ何も出ない。
+        // 通信そのものが失敗した回は LIVE_ONBOARDING が null のままで、何も出ない
+        paintClaudeAppSection();
         // 取得中に保存が効いていたら、迂回付きでもう一度取りに行く
         if (freshWanted) loadLiveFleet();
       });
   }
 
+  /* ---------------------------------------------------------------------------
+   * Claude GitHub App の追加申請（#94）
+   * ---------------------------------------------------------------------------
+   * 案件の自動セットアップが終わったあと、「Claude Code からこのリポジトリを使うには
+   * 追加申請が要る」ことを伝える節。承認の完了は機械で検知しないので、
+   * **本人が「申請済み」を押すまで出し続ける。**
+   *
+   * 🔴 **仮置き（notePendingOp / pending-ops / localStorage）は使わない。**
+   * 印の正本は**案件側のファイル**（Cortex/onboarding.json）で、そこへの push は
+   * Cortex/** の変更としてビューアの再ビルドを起こす——つまり静的側もいずれ追いつく。
+   * localStorage に持つと、
+   *   - 別の端末・別の人が開いたときに印が戻る（正本が2つになる）
+   *   - 案件側のファイルを手で直しても画面が追いつかない
+   * という、正本を1つにすることで避けているズレを自分で作ることになる。
+   * 押した直後の追いつきは loadLiveFleet(true)（据え置きの迂回）1本で足りる。
+   *
+   * 🔴 **出す条件はライブの unrequested だけ。** null（取得前・取得失敗・知らない値）と
+   * requested では帯も行も出さない——取得前に出すと、**印を持たない既存案件で
+   * 一瞬だけ節が出る**（そしてその案件では押しても 404 で断られる）。
+   *
+   * 注: ここは埋め込みJSのテンプレートリテラル内。**コメントでもバッククォートを使わない**
+   * （リテラルが閉じて構文エラーになる。実際にそれで壊した）。
+   * ------------------------------------------------------------------------- */
+
+  /**
+   * 節の中身を作る。**呼ばれるのは unrequested のときだけ**（判定は paint 側）。
+   *
+   * 中身は「見出し・一手の1行・申請文・コピー・申請済み」だけ。
+   * **帯は症状・行は一手・繰り返さない**——申請文に書いてあることを行でもう一度言わない。
+   */
+  function buildClaudeAppSection(slug) {
+    var sec = el("section", { class: "claude-app" });
+    sec.appendChild(el("h2", { class: "claude-app-head", text: "Claude GitHub App" }));
+    sec.appendChild(el("p", {
+      class: "claude-app-lead",
+      text: "Claude Code からこのリポジトリを使うには、追加申請が必要です。",
+    }));
+    // 申請の宛先。**どこへ出すのかが無いと、文面だけあっても一手にならない**
+    sec.appendChild(el("p", {
+      class: "sec-how",
+      text: "Slack の #tf-github-classmethod で @g-cm-jsys-github-admin 宛てに、下の申請文を貼って依頼してください。",
+    }));
+    // 案件名は SITE.title（画面のタイトル＝この案件の表示名）。承認する側が
+    // リポジトリ名だけでは案件を特定できないので、両方を載せる
+    var text = claudeAppRequestText(slug, SITE.title);
+    // 選んで手でコピーできる形にする（コピーボタンが使えない環境のため。ポータルの②と同じ作法）
+    var field = el("textarea", {
+      class: "claude-app-text",
+      readonly: "readonly",
+      spellcheck: "false",
+      rows: "7",
+    });
+    field.value = text;
+    sec.appendChild(field);
+    var msg = el("div", { class: "ds-toggle-msg" });
+    var copyBtn = el("button", { class: "ds-toggle-btn", type: "button", text: "コピー" });
+    copyBtn.addEventListener("click", function () {
+      // コピーの作法は realtimeSyncCard と同じ（clipboard API → 選択 → 手でコピーの案内）。
+      // **黙って何も起きないにしない**
+      var done = function () { msg.className = "ds-toggle-msg is-ok"; msg.textContent = "✓ コピーしました。"; };
+      var fallback = function () {
+        try {
+          field.focus();
+          field.select();
+          if (document.execCommand && document.execCommand("copy")) return done();
+        } catch (e) { /* 下の案内へ */ }
+        msg.className = "ds-toggle-msg is-error";
+        msg.textContent = "⚠ 自動コピーできませんでした。選択された文字列を手でコピーしてください。";
+      };
+      try {
+        if (navigator.clipboard && navigator.clipboard.writeText) {
+          navigator.clipboard.writeText(text).then(done, fallback);
+        } else fallback();
+      } catch (e) { fallback(); }
+    });
+    var doneBtn = el("button", { class: "ds-toggle-btn", type: "button", text: "申請済み" });
+    doneBtn.addEventListener("click", function () { markClaudeAppRequested(doneBtn, msg); });
+    sec.appendChild(el("div", { class: "claude-app-actions" }, [copyBtn, doneBtn, msg]));
+    return sec;
+  }
+
+  /**
+   * 「申請済み」を押したとき。
+   *
+   * **sendConfig は通さない。** あちらは成功のたびに仮置き（notePendingOp）を書く
+   * 経路で、この機能は仮置きを持たないと決めてある（上の項）。使うのは同じ callIntake。
+   *
+   * 成功したら**その場で節を1行に差し替え**（押した手応えを返す）、
+   * loadLiveFleet(true) で正本を取り直す。失敗したら**サーバーが返した文をそのまま出す**
+   * ——ファイルを持たない案件の 404 の文面も、そのまま読めば何が無いのか分かる。
+   */
+  async function markClaudeAppRequested(btn, msg) {
+    if (!SITE.intake) return;
+    var endBusy = beginBusy(btn);
+    msg.className = "ds-toggle-msg";
+    msg.textContent = "保存中…";
+    try {
+      var res = await callIntake("config", { op: "claude-app-requested" });
+      var j = await res.json().catch(function () { return {}; });
+      if (!res.ok) {
+        msg.className = "ds-toggle-msg is-error";
+        msg.textContent = "✗ " + (j.message || "保存できませんでした。");
+        endBusy();
+        return;
+      }
+      // **節ごと1行に差し替える。** 申請文もボタンも役目を終えているので残さない。
+      // 旗を先に立てるのは、下の取り直しが届いたときの描き直しでも1行のままにするため
+      CLAUDE_APP_DONE = true;
+      paintClaudeAppSection();
+      // **正本を取り直す**（据え置きを迂回）。ここで印は requested になり、
+      // 次に描き直したときには節が出ない
+      loadLiveFleet(true);
+    } catch (e) {
+      msg.className = "ds-toggle-msg is-error";
+      msg.textContent = "✗ 通信に失敗しました。";
+      endBusy();
+    }
+  }
+
+  /**
+   * 節を描き直す。**冪等**（何度呼んでも同じ状態に落ち着く）。
+   *
+   * ライブの応答は操作タブを描いたあとに届くので、loadLiveFleet の成功・失敗の
+   * どちらからも呼ぶ（届くまでは受け皿が空のまま＝何も出ない）。
+   */
+  function paintClaudeAppSection() {
+    var slot = app.querySelector(".claude-app-slot");
+    if (!slot) return;
+    slot.textContent = "";
+    // 🔴 **正本が追いついたら旗を落とす。** 落とさないと「✓ 申請済みとして記録しました。」が
+    // リロードするまでセッション中ずっと残る——旗は「正本が届くまでのつなぎ」でしかない。
+    // 落とせば、押した経路も最初から requested だった経路も**同じ「何も出ない」**に落ち着く
+    if (LIVE_ONBOARDING && LIVE_ONBOARDING.claudeGithubApp === "requested") CLAUDE_APP_DONE = false;
+    // 押した直後（サーバが保存を確定した）は、正本が届く前でも1行だけ残す。
+    // **正本が requested を返せば、この旗が無くても同じ「何も出ない」に落ち着く**
+    if (CLAUDE_APP_DONE) {
+      slot.appendChild(el("section", { class: "claude-app" }, [
+        el("p", { class: "claude-app-done", text: "✓ 申請済みとして記録しました。" }),
+      ]));
+      return;
+    }
+    // 🔴 **ライブの unrequested のときだけ。** null・未取得・requested では何も出さない
+    if (!LIVE_ONBOARDING || LIVE_ONBOARDING.claudeGithubApp !== "unrequested") return;
+    // 申請文にリポジトリ名を埋められないなら、押しても宛先の分からない依頼になる
+    var slug = claudeAppRepoSlug(SITE.repoBaseUrl);
+    if (!slug) return;
+    // 押す先（intake）が無い構成では、押せないボタンだけを出さない
+    if (!SITE.intake) return;
+    slot.appendChild(buildClaudeAppSection(slug));
+  }
+
   function renderOps() {
     renderConnMap();
+    // 🔴 **受け皿は接続マップの直後・「データソースと自動化」より前**（利用者が最初に見る位置）。
+    // 中身が入るのはライブの応答が届いてからで、それまでは**空の受け皿**＝何も出ない
+    app.appendChild(el("div", { class: "claude-app-slot" }));
+    paintClaudeAppSection();
     // 🔴 **先読みが飛行中なら、いま作った図を確認中へ倒す（#264）。**
     // 先読み（起動時の loadLiveFleet）は操作タブを開く前に走るので、
     // 確認中へ倒す口（loadLiveFleet の connMapConfirmingShown の1回）は

package/package.json

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