@cocorograph/hub-agent 0.6.33 → 0.6.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cocorograph/hub-agent",
-  "version": "0.6.33",
+  "version": "0.6.35",
   "description": "Hub Hosted Cockpit のローカル常駐 agent。Hub と outbound WSS で接続し、ローカルの tmux/pty を中継する。",
   "type": "module",
   "license": "UNLICENSED",

package/src/chat-signals.mjs

@@ -40,8 +40,14 @@ function _now() {
  * チャットのアクティビティを記録する。status / context_pct は与えられた分だけ更新し、
  * turnAt (= 最終アクティビティ時刻 / ソート用) は呼ばれるたびに前進させる。
  *
+ * inputPending: チャットセッションが permission / AskUserQuestion の応答待ちで
+ *   ターンをブロックしているか。サイドバーの「確認待ち」ドット & 通知の発火源にする
+ *   (status とは独立に持つ。SessionStatus enum を汚さず、status は processing のまま
+ *   "確認待ち" を別軸で表現するため)。permission 要求で true、次の assistant / result
+ *   イベント (= ユーザーが応答してターンが再開/完了) で false に落とす。
+ *
  * @param {string} cwd セッションの作業ディレクトリ
- * @param {{ status?: string, contextPct?: number|null }} patch
+ * @param {{ status?: string, contextPct?: number|null, inputPending?: boolean }} patch
  */
 export function recordChatActivity(cwd, patch = {}) {
   if (!cwd || typeof cwd !== "string") return
@@ -49,6 +55,7 @@ export function recordChatActivity(cwd, patch = {}) {
   const prev = _byCwd.get(cwd) || {
     status: null,
     context_pct: null,
+    inputPending: false,
     turnAt: 0,
     updatedAtMs: 0,
   }
@@ -59,6 +66,9 @@ export function recordChatActivity(cwd, patch = {}) {
   if (typeof patch.contextPct === "number" && Number.isFinite(patch.contextPct)) {
     next.context_pct = Math.max(0, Math.min(100, patch.contextPct))
   }
+  if (typeof patch.inputPending === "boolean") {
+    next.inputPending = patch.inputPending
+  }
   _byCwd.set(cwd, next)
 }
 
@@ -67,7 +77,7 @@ export function recordChatActivity(cwd, patch = {}) {
  *
  * @param {string} cwd
  * @param {number} [now]
- * @returns {{ status: string|null, context_pct: number|null, turnAt: number, updatedAtMs: number } | null}
+ * @returns {{ status: string|null, context_pct: number|null, inputPending?: boolean, turnAt: number, updatedAtMs: number } | null}
  */
 export function getChatSignal(cwd, now = _now()) {
   if (!cwd) return null

package/src/claude-stream-bridge.mjs

@@ -37,15 +37,23 @@ const CHAT_RESIDENT_ENABLED = process.env.HUB_AGENT_CHAT_RESIDENT !== "0"
 /** 改修4 (2026-05-29): resume セッションも常駐query化する (init を毎ターン送らず、
  *  1 セッション=1 query で system/init を初回 1 回のみにする。VS Code 拡張 / Claude Web
  *  と同じ挙動)。query 起動時に options.resume で過去文脈を引き継ぐ。
- *  env HUB_AGENT_CHAT_RESIDENT_RESUME="0" で従来の per-message (毎ターン init) に
- *  個別ロールバック可能 (新規セッションの常駐化は CHAT_RESIDENT_ENABLED 側で独立制御)。
- *  デフォルト有効。
- *  注意: 過去に「resume + 常駐」で『Continue from where you left off』暴走が疑われたが、
- *  原因は continue オプション (直近会話の自動継続) の誤用と Hub 不調の重なりと推定。
- *  本実装では continue は使わず resume (明示 session 指定) のみを用い、初回 input は
- *  ユーザーの実メッセージのみとすることで自動継続の暴走を回避する。 */
+ *
+ *  ⚠️ デフォルト無効化 (2026-06-02): 「眠っていたセッションを起こすと
+ *  『Continue from where you left off.』→『No response requested.』や /clear の
+ *  local-command-caveat が合成ユーザーバブルとして表示され、処理中になり、実メッセージが
+ *  キュー待ちになる」回帰が確認されたため既定 OFF に戻す。
+ *
+ *  根本原因: resident 経路 (sendMessage) は **空の InputQueue のまま query を起動してから
+ *  push** する設計のため、「resume + 入力がまだ空」の窓で SDK が中断/未完了セッションの
+ *  自動継続ターン (Continue from where you left off) を差し込む。per-message 経路は
+ *  InputQueue に push→即 close してから起動するためこの窓が無く、自動継続は起きない
+ *  (0.6.4 で暴走を潰した設計)。よって resumed セッションは per-message 経路に戻す。
+ *
+ *  env HUB_AGENT_CHAT_RESIDENT_RESUME="1" で個別に再有効化できる (空キュー窓を塞ぐ
+ *  根治を入れたら既定 ON へ戻す候補)。新規セッションの常駐化は CHAT_RESIDENT_ENABLED 側で
+ *  独立制御 (新規は resume しないため自動継続の窓が無く、既定 ON のまま安全)。 */
 const CHAT_RESIDENT_RESUME_ENABLED =
-  process.env.HUB_AGENT_CHAT_RESIDENT_RESUME !== "0"
+  process.env.HUB_AGENT_CHAT_RESIDENT_RESUME === "1"
 
 /** 多端末共有セッション (2026-05-30)。同じ Claude セッション (session_id) を複数端末で
  *  同時に開いて、どの端末でもライブ表示・入力・許可応答できるようにする。env
@@ -229,7 +237,10 @@ class ClaudeStreamSession {
      *  false に戻す。 */
     this._ultracodeCurrent = false
 
-    /** @type {Map<string, {resolve: (decision: object) => void}>} permission 応答待ち */
+    /** @type {Map<string, {resolve: (decision: object) => void, tool_name: string, input: object}>}
+     *  permission 応答待ち。tool_name / input も保持し、reattach 時に未応答分を
+     *  onPermission で再送 (replay) して「裏で動いていたセッションを開いたら確認待ち
+     *  カードが出ずに固まる」不具合を解消する (固まりの直接原因の修正)。 */
     this._permissionResolvers = new Map()
     /** 現在ターン実行中か (多重 query 防止) */
     this._busy = false
@@ -290,7 +301,11 @@ class ClaudeStreamSession {
     if (!this.onPermission) return { behavior: "allow", updatedInput: input }
     const request_id = randomUUID()
     return await new Promise((resolve) => {
-      this._permissionResolvers.set(request_id, { resolve })
+      this._permissionResolvers.set(request_id, {
+        resolve,
+        tool_name: toolName,
+        input,
+      })
       try {
         this.onPermission({ tool_name: toolName, input, request_id })
       } catch (err) {
@@ -344,6 +359,27 @@ class ClaudeStreamSession {
     // started=[] なのでバブル昇格は起きずチップ更新のみ (冪等)。onEvent は新しい
     // stream_id 宛の stream_group relay で確実に届き、session_group fanout で他端末にも届く。
     this._emitQueueState([], { force: true })
+    // 固まり解消 (2026-06-02): 未応答 permission を再送する。permission は in-flight な
+    // callback で jsonl hydrate では復元されないため、別セッションを表示中に裏で発生した
+    // 確認待ちは取りこぼされ、サーバー側 Promise が永久 pending になりセッションが固まる。
+    // 再アタッチした端末へ現在の未応答分を再 emit し、確認待ちカードを復元させる
+    // (browser 側は request_id で重複排除するので、既に表示済みの端末でも二重化しない)。
+    this._replayPendingPermissions()
+  }
+
+  /** 未応答 permission を onPermission 経由で再送する (reattach から呼ぶ)。 */
+  _replayPendingPermissions() {
+    if (!this.onPermission || this._permissionResolvers.size === 0) return
+    for (const [request_id, r] of this._permissionResolvers) {
+      try {
+        this.onPermission({ tool_name: r.tool_name, input: r.input, request_id })
+      } catch (err) {
+        this.logger?.warn(
+          { err: err.message, stream_id: this.stream_id, request_id },
+          "replay permission failed",
+        )
+      }
+    }
   }
 
   /** B11: 端末の最終アクティビティ時刻を更新する (死端末 GC の生存判定に使う)。 */
@@ -1135,6 +1171,7 @@ export class ClaudeStreamBridge extends EventEmitter {
         this.emit("permission", {
           stream_id: session.stream_id,
           session_id: session.sessionId,
+          cwd: session.cwd,
           request_id,
           tool_name,
           input,

package/src/main.mjs

@@ -28,6 +28,15 @@ import { fetchSessionHistory, listSessions } from "./claude-history.mjs"
 import { listAgents } from "./agents.mjs"
 import { listSkills } from "./skills.mjs"
 import { listSessionStates } from "./state.mjs"
+import {
+  DEFAULT_PROFILE_ID,
+  defaultConfigDir,
+  listProfiles,
+  getActiveProfile,
+  getActiveProjectsRoot,
+  setActiveProfile,
+  addProfile,
+} from "./profiles.mjs"
 import {
   buildClaudeCmd,
   createSession as createTmuxSession,
@@ -144,6 +153,34 @@ export function isFastPathMessage(type) {
   return type === "pty.data" || type === "pty.resize"
 }
 
+/**
+ * active プロファイルの configDir を process.env.CLAUDE_CONFIG_DIR へ反映する。
+ * 既定 (`~/.claude`) のときは変数を消して従来挙動 (Claude Code の既定パス) に戻す。
+ * SDK が起動する Claude Code サブプロセスはこの env を継承するため、以後の query() は
+ * このプロファイルの認証・履歴・設定ディレクトリで動く。全セッションの再起動とセットで使う。
+ *
+ * @param {{id:string,configDir:string}} profile
+ * @param {import('pino').Logger} [log]
+ */
+export function applyActiveProfileEnv(profile, log) {
+  const isDefault =
+    !profile ||
+    profile.id === DEFAULT_PROFILE_ID ||
+    profile.configDir === defaultConfigDir()
+  if (isDefault) {
+    delete process.env.CLAUDE_CONFIG_DIR
+  } else {
+    process.env.CLAUDE_CONFIG_DIR = profile.configDir
+  }
+  log?.info?.(
+    {
+      profile_id: profile?.id || DEFAULT_PROFILE_ID,
+      config_dir: process.env.CLAUDE_CONFIG_DIR || defaultConfigDir(),
+    },
+    "active claude profile applied",
+  )
+}
+
 export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
   const config = await readConfig()
   if (!config) {
@@ -155,6 +192,18 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
   const plugins = await loadPlugins(logger)
   const ctx = { logger, config, plugins }
 
+  // 起動時: 保存済み active プロファイルの CLAUDE_CONFIG_DIR を反映してから
+  // Claude SDK を初期化する。profiles.json が無ければ既定 (~/.claude) のまま。
+  try {
+    const activeProfile = await getActiveProfile()
+    applyActiveProfileEnv(activeProfile, logger)
+  } catch (err) {
+    logger.warn(
+      { err: err.message },
+      "failed to apply active claude profile; falling back to default ~/.claude",
+    )
+  }
+
   await runHookBroadcast(plugins, "onAgentStart", ctx)
 
   const resolvedPty = ptyModule || (await import("node-pty"))
@@ -218,23 +267,39 @@ export async function startDaemon({ version, ptyModule, claudeSdk } = {}) {
       // TUI を出さず、capture-pane スクレイプも bundle hook も発火しないための補完。
       //   - assistant (生成中) → processing + usage から context%
       //   - result   (ターン完了/入力待ち) → waiting
+      // assistant / result はターンの進行/完了 = permission 応答後に必ず流れるため、
+      // ここで inputPending を落として「確認待ち」ドット/通知を自己解消させる。
       if (event?.type === "assistant") {
         const pct = event.message?.usage ? contextPctFromUsage(event.message.usage) : null
         try {
-          recordChatActivity(cwd, { status: "processing", contextPct: pct })
+          recordChatActivity(cwd, {
+            status: "processing",
+            contextPct: pct,
+            inputPending: false,
+          })
         } catch {
           /* ignore */
         }
       } else if (event?.type === "result") {
         try {
-          recordChatActivity(cwd, { status: "waiting" })
+          recordChatActivity(cwd, { status: "waiting", inputPending: false })
         } catch {
           /* ignore */
         }
       }
       client.send({ type: "claude.event", stream_id, session_id, event })
     })
-    claudeBridge.on("permission", ({ stream_id, session_id, request_id, tool_name, input }) => {
+    claudeBridge.on("permission", ({ stream_id, session_id, cwd, request_id, tool_name, input }) => {
+      // 確認待ち信号 (2026-06-02): cwd キーで inputPending を立て、サイドバーの
+      // 「確認待ち」ドット & 通知の発火源にする。次の assistant/result で落ちる。
+      // これにより「裏で動いているセッションがどれか分からない」発見性の問題を解消する。
+      if (cwd) {
+        try {
+          recordChatActivity(cwd, { inputPending: true })
+        } catch {
+          /* ignore */
+        }
+      }
       // 多端末共有: session_id を載せて backend が session group へ broadcast できるように
       // する (全端末に許可ダイアログ → 先着 1 件採用)。
       client.send({
@@ -579,7 +644,14 @@ function startStateLoop({ client, plugins, logger, intervalMs, claudeBridge }) {
           const prevTurnAt = lastTurnAtByName.get(s.session_name) || 0
           if (chat.turnAt > prevTurnAt) {
             lastTurnAtByName.set(s.session_name, chat.turnAt)
-            const ev = chat.status === "processing" ? "prompt_submit" : "stop"
+            // 確認待ち (inputPending) は専用 event "input_required" を書き、サイドバーの
+            // 「確認待ち」ドット & 通知に橋渡しする。それ以外は従来通り processing →
+            // prompt_submit / それ以外 → stop。
+            const ev = chat.inputPending
+              ? "input_required"
+              : chat.status === "processing"
+                ? "prompt_submit"
+                : "stop"
             writeSessionEventFile(s.session_name, ev, chat.turnAt).catch(() => {})
           }
         }
@@ -910,10 +982,13 @@ async function dispatch(msg, ctx) {
         const cwd = msg.cwd || ""
         const session_id = msg.session_id || ""
         const maxLines = typeof msg.max_lines === "number" ? msg.max_lines : undefined
+        // active プロファイルの projects/ から読む (アカウント別に履歴がサイロ化されているため)。
+        const projectsRoot = await getActiveProjectsRoot()
         const result = await fetchSessionHistory({
           cwd,
           session_id,
           maxLines,
+          projectsRoot,
           logger: ctx.logger,
         })
         ctx.client.send({
@@ -934,7 +1009,14 @@ async function dispatch(msg, ctx) {
         const stream_id = msg.stream_id
         const cwd = msg.cwd || ""
         const limit = typeof msg.limit === "number" ? msg.limit : undefined
-        const result = await listSessions({ cwd, limit, logger: ctx.logger })
+        // active プロファイルの projects/ からセッション一覧を読む。
+        const projectsRoot = await getActiveProjectsRoot()
+        const result = await listSessions({
+          cwd,
+          limit,
+          projectsRoot,
+          logger: ctx.logger,
+        })
         ctx.client.send({
           type: "claude.sessions.response",
           stream_id,
@@ -944,6 +1026,86 @@ async function dispatch(msg, ctx) {
         })
         return
       }
+      case "profile.list": {
+        // Claude アカウント・プロファイル一覧と active を返す (Cockpit のアカウント切替UI用)。
+        const reg = await listProfiles()
+        ctx.client.send({
+          type: "profile.list.response",
+          request_id: msg.request_id,
+          active_id: reg.activeId,
+          profiles: reg.profiles.map((p) => ({
+            id: p.id,
+            label: p.label,
+            config_dir: p.configDir,
+          })),
+        })
+        return
+      }
+      case "profile.switch": {
+        // アカウント切替。active を永続化 → env 反映 → 全 Claude セッション強制再起動。
+        // 走行中ターンも中断する (アカウントが変わる以上、継続は不可)。
+        const id = msg.profile_id || msg.id || ""
+        try {
+          const target = await setActiveProfile(id)
+          applyActiveProfileEnv(target, ctx.logger)
+          // 全セッションを撤去 (frontend は exit 通知でセッション一覧をリロードする)。
+          const before = ctx.claudeBridge ? ctx.claudeBridge.list().length : 0
+          ctx.claudeBridge?.shutdown()
+          ctx.logger.info(
+            { profile_id: target.id, restarted: before },
+            "claude profile switched; all sessions reaped",
+          )
+          ctx.client.send({
+            type: "profile.switch.result",
+            request_id: msg.request_id,
+            ok: true,
+            active_id: target.id,
+            profile: {
+              id: target.id,
+              label: target.label,
+              config_dir: target.configDir,
+            },
+            reaped: before,
+          })
+        } catch (err) {
+          ctx.client.send({
+            type: "profile.switch.result",
+            request_id: msg.request_id,
+            ok: false,
+            profile_id: id,
+            error: err?.message || String(err),
+          })
+        }
+        return
+      }
+      case "profile.add": {
+        // 新規プロファイルを追加 (連番 id・中立パス `~/.claude-<n>`) し、共有資産を整備する。
+        // 追加直後はログイン未了 (needs_login)。ユーザーが端末で
+        // `CLAUDE_CONFIG_DIR=<config_dir> claude` → /login する必要がある。
+        try {
+          const created = await addProfile({ label: msg.label })
+          ctx.client.send({
+            type: "profile.add.result",
+            request_id: msg.request_id,
+            ok: true,
+            profile: {
+              id: created.id,
+              label: created.label,
+              config_dir: created.configDir,
+            },
+            needs_login: created.needsLogin,
+            login_command: `CLAUDE_CONFIG_DIR=${created.configDir} claude`,
+          })
+        } catch (err) {
+          ctx.client.send({
+            type: "profile.add.result",
+            request_id: msg.request_id,
+            ok: false,
+            error: err?.message || String(err),
+          })
+        }
+        return
+      }
       case "tmux.exec": {
         const args = Array.isArray(msg.args) ? msg.args : []
         const hookResult = await runHookChain(ctx.plugins, "interceptTmuxExec", {

package/src/profiles.mjs

@@ -0,0 +1,281 @@
+/**
+ * Claude アカウント・プロファイル管理。
+ *
+ * 1 台のマシンで複数の Claude アカウント (例: 個人 Max / チーム) を `CLAUDE_CONFIG_DIR`
+ * で切り替えて使うための仕組み。各プロファイルは独立した config ディレクトリを持ち、
+ * 認証・会話履歴 (`projects/`)・`.claude.json` をアカウント別に保持する。一方で
+ * skills / agents / commands / scripts / hooks / CLAUDE.md は symlink で共有し、
+ * settings.json はコピーで共有する (provisionProfile が面倒を見る)。
+ *
+ * 設計方針 (重要):
+ *  - 既定 (プライマリ) プロファイルは **常に `~/.claude`**。リネーム・移動しない。
+ *    profiles.json が存在しない単一アカウント利用者は、この仕組みに一切触れずに
+ *    従来どおり `~/.claude` で動く (完全に追加機能・ゼロ設定)。
+ *  - 2 つ目以降を足したときだけ `~/.claude-1` `~/.claude-2` … が生える (中立な連番)。
+ *    `~/.claude-0` は作らない。
+ *  - ディレクトリ名にプラン種別を埋め込まない。UI 表示は label で行う。
+ *
+ * レジストリは `~/.hub/profiles.json` に保存する (config.mjs と同じ ~/.hub 配下)。
+ */
+import { promises as fs } from "node:fs"
+import path from "node:path"
+import os from "node:os"
+
+import { paths as hubPaths, ensureConfigDir } from "./config.mjs"
+
+/** 既定 (プライマリ) プロファイルの ID。 */
+export const DEFAULT_PROFILE_ID = "default"
+
+/** `~/.claude` の絶対パス。 */
+export function defaultConfigDir() {
+  return path.join(os.homedir(), ".claude")
+}
+
+/** 既定プロファイルを合成して返す (永続化はしない)。 */
+export function makeDefaultProfile() {
+  return {
+    id: DEFAULT_PROFILE_ID,
+    label: "メイン",
+    configDir: defaultConfigDir(),
+  }
+}
+
+/** `~/.hub/profiles.json` の絶対パス。 */
+export function registryPath() {
+  return path.join(hubPaths.configDir, "profiles.json")
+}
+
+/** モジュール内キャッシュ (頻繁に呼ばれる getActiveConfigDir のため)。
+ *  setActiveProfile / 書き込み系で必ず無効化する。 */
+let _cache = null
+
+/** チルダ展開 (`~` / `~/...` を home 起点に解決)。それ以外は path.resolve。 */
+function resolveDir(dir) {
+  if (!dir) return defaultConfigDir()
+  if (dir === "~") return os.homedir()
+  if (dir.startsWith("~/")) return path.join(os.homedir(), dir.slice(2))
+  return path.resolve(dir)
+}
+
+/**
+ * レジストリを読み込む。存在しなければ既定プロファイルのみの仮想レジストリを返す。
+ * 返り値の profiles は必ず先頭に既定プロファイルを含み、configDir は絶対パスに正規化済み。
+ *
+ * @returns {Promise<{activeId: string, profiles: Array<{id:string,label:string,configDir:string}>}>}
+ */
+export async function loadRegistry() {
+  if (_cache) return _cache
+  let parsed = null
+  try {
+    const raw = await fs.readFile(registryPath(), "utf-8")
+    parsed = JSON.parse(raw)
+  } catch (err) {
+    if (err.code !== "ENOENT") throw err
+  }
+
+  const def = makeDefaultProfile()
+  let profiles = [def]
+  let activeId = DEFAULT_PROFILE_ID
+
+  if (parsed && Array.isArray(parsed.profiles)) {
+    // 既定以外を取り込み (configDir 正規化)。id 重複・default の二重定義は弾く。
+    const seen = new Set([DEFAULT_PROFILE_ID])
+    for (const p of parsed.profiles) {
+      if (!p || typeof p.id !== "string" || p.id === DEFAULT_PROFILE_ID) continue
+      if (seen.has(p.id)) continue
+      seen.add(p.id)
+      profiles.push({
+        id: p.id,
+        label: typeof p.label === "string" && p.label ? p.label : p.id,
+        configDir: resolveDir(p.configDir),
+      })
+    }
+    // 既定プロファイルのラベルだけはレジストリで上書きできる。
+    if (typeof parsed.defaultLabel === "string" && parsed.defaultLabel) {
+      def.label = parsed.defaultLabel
+    }
+    if (
+      typeof parsed.activeId === "string" &&
+      profiles.some((p) => p.id === parsed.activeId)
+    ) {
+      activeId = parsed.activeId
+    }
+  }
+
+  _cache = { activeId, profiles }
+  return _cache
+}
+
+/** レジストリを永続化する。default は profiles[] に含めず、追加分と activeId / defaultLabel だけ保存。 */
+async function saveRegistry(reg) {
+  await ensureConfigDir()
+  const def = reg.profiles.find((p) => p.id === DEFAULT_PROFILE_ID)
+  const payload = {
+    activeId: reg.activeId,
+    defaultLabel: def ? def.label : undefined,
+    profiles: reg.profiles
+      .filter((p) => p.id !== DEFAULT_PROFILE_ID)
+      .map((p) => ({ id: p.id, label: p.label, configDir: p.configDir })),
+  }
+  await fs.writeFile(registryPath(), JSON.stringify(payload, null, 2), {
+    mode: 0o600,
+  })
+  _cache = null
+}
+
+/** プロファイル一覧と active を返す (UI 表示用)。 */
+export async function listProfiles() {
+  const reg = await loadRegistry()
+  return { activeId: reg.activeId, profiles: reg.profiles }
+}
+
+/** active プロファイルオブジェクトを返す。 */
+export async function getActiveProfile() {
+  const reg = await loadRegistry()
+  return (
+    reg.profiles.find((p) => p.id === reg.activeId) || makeDefaultProfile()
+  )
+}
+
+/** active の config ディレクトリ絶対パス。 */
+export async function getActiveConfigDir() {
+  return (await getActiveProfile()).configDir
+}
+
+/** active の会話履歴ルート (`<configDir>/projects`)。 */
+export async function getActiveProjectsRoot() {
+  return path.join(await getActiveConfigDir(), "projects")
+}
+
+/**
+ * active プロファイルを切り替える。存在しない id はエラー。
+ * env (CLAUDE_CONFIG_DIR) の反映と全セッション再起動は呼び出し側 (main.mjs) の責務。
+ *
+ * @param {string} id
+ * @returns {Promise<{id:string,label:string,configDir:string}>} 切替後の active プロファイル
+ */
+export async function setActiveProfile(id) {
+  const reg = await loadRegistry()
+  const target = reg.profiles.find((p) => p.id === id)
+  if (!target) throw new Error(`unknown profile: ${id}`)
+  reg.activeId = id
+  await saveRegistry(reg)
+  return target
+}
+
+/** 次の連番 ID (既存の数値 id の最大 +1、最低 1)。 */
+function nextNumericId(profiles) {
+  let max = 0
+  for (const p of profiles) {
+    const n = Number.parseInt(p.id, 10)
+    if (Number.isInteger(n) && n > max) max = n
+  }
+  return String(max + 1)
+}
+
+/**
+ * プロファイルを新規追加する (連番 id・中立パス `~/.claude-<n>`)。
+ * ディレクトリ整備 (symlink / settings コピー) は provisionProfile が行う。
+ * 追加後もログインは未了 (ユーザーが端末で `/login` する必要がある)。
+ *
+ * @param {{label?: string}} [opts]
+ * @returns {Promise<{id:string,label:string,configDir:string, needsLogin: boolean}>}
+ */
+export async function addProfile(opts = {}) {
+  const reg = await loadRegistry()
+  const id = nextNumericId(reg.profiles)
+  const configDir = path.join(os.homedir(), `.claude-${id}`)
+  const profile = {
+    id,
+    label: opts.label && String(opts.label).trim() ? String(opts.label).trim() : `アカウント${id}`,
+    configDir,
+  }
+  reg.profiles.push(profile)
+  await saveRegistry(reg)
+  await provisionProfile(configDir)
+  return { ...profile, needsLogin: true }
+}
+
+/** 既定プロファイルから共有 symlink する資産 (アプリが書き込まない読み取り中心)。 */
+export const SHARED_SYMLINK_ITEMS = [
+  "agents",
+  "skills",
+  "commands",
+  "scripts",
+  "hooks",
+  "CLAUDE.md",
+]
+
+/** コピーで共有する資産 (アプリが書き換えるため symlink 不可)。 */
+export const SHARED_COPY_ITEMS = ["settings.json"]
+
+/**
+ * プロファイルディレクトリを整備する。
+ *  - 共有 symlink 資産: 既定 `~/.claude/<item>` への絶対 symlink を張る (既存・実体があれば触らない)。
+ *  - 共有コピー資産: 既定からコピー (プロファイル側に未存在のときだけ)。
+ * 認証・履歴・`.claude.json` には一切触れない (アカウント固有のため)。
+ *
+ * @param {string} configDir - 対象プロファイルの config ディレクトリ絶対パス
+ * @returns {Promise<{linked: string[], copied: string[], skipped: string[]}>}
+ */
+export async function provisionProfile(configDir) {
+  const base = defaultConfigDir()
+  await fs.mkdir(configDir, { recursive: true, mode: 0o700 })
+  const linked = []
+  const copied = []
+  const skipped = []
+
+  for (const item of SHARED_SYMLINK_ITEMS) {
+    const src = path.join(base, item)
+    const dst = path.join(configDir, item)
+    try {
+      await fs.access(src)
+    } catch {
+      skipped.push(`${item}(元無し)`)
+      continue
+    }
+    // dst が既に存在 (symlink/実体) なら触らない。
+    let exists = false
+    try {
+      await fs.lstat(dst)
+      exists = true
+    } catch {
+      /* not exists */
+    }
+    if (exists) {
+      skipped.push(`${item}(既存)`)
+      continue
+    }
+    await fs.symlink(src, dst)
+    linked.push(item)
+  }
+
+  for (const item of SHARED_COPY_ITEMS) {
+    const src = path.join(base, item)
+    const dst = path.join(configDir, item)
+    let dstExists = false
+    try {
+      await fs.lstat(dst)
+      dstExists = true
+    } catch {
+      /* not exists */
+    }
+    if (dstExists) {
+      skipped.push(`${item}(既存)`)
+      continue
+    }
+    try {
+      await fs.copyFile(src, dst)
+      copied.push(item)
+    } catch {
+      skipped.push(`${item}(元無し)`)
+    }
+  }
+
+  return { linked, copied, skipped }
+}
+
+/** テスト用: モジュールキャッシュを破棄する。 */
+export function _clearCache() {
+  _cache = null
+}