tailii-host 0.1.0 → 0.3.0

package/dist/commands/launch.js

@@ -0,0 +1,716 @@
+// launch.ts
+// tailii (TS host) — tmux 上での claude 起動（launchCore）と engine 用 launcher の組み立て
+// Swift 版 Launch.swift の移植。
+// 指定 dir で tmux 上に claude をデタッチ起動し、承認フックは起動時 `--settings '<json>'` で
+// この起動プロセス限定に渡し（settings.json は書かない）、SessionMetadataStore に cwd を権威記録
+// する。SSH exec は非ログインシェルのため PATH を明示注入する。
+import { execFile, spawn } from "node:child_process";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { CodexAppServerManager } from "../codex/codexAppServer.js";
+import { HERDR_TAILII_SESSION, defaultHerdrPath, parseHerdrForegroundCommand, parseHerdrPaneList, parseHerdrCreatedTabPaneId, } from "../backend/herdr.js";
+import { claudeHookLaunchSettings, removeCodexHookSettings } from "./hookSettings.js";
+import { tailiiWorktreeRepoRoot } from "../services/gitService.js";
+import { ClaudeSessionStore } from "../sessions/claudeSessionStore.js";
+import { claudeProjectSlug, isInsideBase, standardize, expandTilde } from "../shared/paths.js";
+import { resolveSessionBackendKind } from "../backend/sessionBackend.js";
+import { SessionMetadataStore } from "../sessions/sessionMetadataStore.js";
+import { sleep } from "../shared/sleep.js";
+import { DEFAULT_TMUX_PATH, paneCommandLooksLikeAgent } from "../backend/tmux.js";
+/** tmux 内で起動する既定コマンド（claude TUI）。テストでは無害な値に差し替える。 */
+export const DEFAULT_INNER_COMMAND = "claude";
+/**
+ * codex（OpenAI Codex CLI）モードの既定コマンド。
+ * 承認統合は後続 Milestone のため、本スライスでは端末で承認応答できない前提で
+ * `-a never -s workspace-write`（workspace 内サンドボックスで承認プロンプトを出さず自律実行）にする。
+ */
+export const DEFAULT_CODEX_COMMAND = "codex -a never -s workspace-write";
+/**
+ * codex の既存会話 resume 用フラグ（サブコマンド `resume <SESSION_ID>` に前置）。
+ * `-a`/`-s` は resume サブコマンドでも有効（`codex resume --help` で確認済み, agent-tag）。
+ * resume は cwd+mtime で rollout を解決する tail の性質上、厳密な per-session 追尾は保証しない
+ * （同一 cwd の新しい rollout があるとそちらを追い得る。既知の制約）。
+ */
+export const CODEX_RESUME_FLAGS = "-a never -s workspace-write";
+/** モデル slug の安全文字（コマンド注入防止。カタログ由来だが二重に検証する）。 */
+const CODEX_MODEL_SAFE = /^[A-Za-z0-9._-]+$/;
+/** claude の permission mode 既知値（--permission-mode に安全に渡せる値のみ）。 */
+const CLAUDE_PERMISSION_MODES = new Set(["default", "acceptEdits", "plan", "auto"]);
+/**
+ * claude の resume/continue は古く大きいセッションで TUI 専用設問
+ * `Resume from summary?` を出してブロックする。この設問は transcript にもフックにも乗らず
+ * リモートから見えないため、閾値を実質無効化して常に従来どおりフル resume にする。
+ * claude 2.1.207 で確認した環境変数。
+ */
+const CLAUDE_RESUME_THRESHOLD_ENV = "CLAUDE_CODE_RESUME_THRESHOLD_MINUTES=525600 CLAUDE_CODE_RESUME_TOKEN_THRESHOLD=1000000000";
+/**
+ * claude 新規起動の inner コマンドを組み立てる（起動前モデル/モード選択の反映）。
+ * @param model 省略/不正文字は無視（アカウント既定モデル）。alias（'opus' 等）と完全 id の両方可。
+ * @param permissionMode 既知 4 値のみ採用。"default" はフラグ無しと等価なので付けない。
+ */
+export function claudeInnerCommand(opts) {
+    let cmd = DEFAULT_INNER_COMMAND;
+    if (opts.model && CODEX_MODEL_SAFE.test(opts.model))
+        cmd += ` --model ${opts.model}`;
+    if (opts.permissionMode &&
+        opts.permissionMode !== "default" &&
+        CLAUDE_PERMISSION_MODES.has(opts.permissionMode)) {
+        cmd += ` --permission-mode ${opts.permissionMode}`;
+    }
+    return cmd;
+}
+/**
+ * codex 新規起動の inner コマンドを組み立てる（codex-input）。
+ * 承認は App Server の JSON-RPC で処理する。ここでは TUI 単体起動用のsandboxとモデルを組み立てる。
+ * @param model 省略/不正文字は無視（既定モデル）。
+ * @param sandbox TUI 単体起動では省略時 workspace-write。remote resume ではこの文字列を使わない。
+ */
+export function codexInnerCommand(opts) {
+    const sandbox = opts.sandbox ?? "workspace-write";
+    let cmd = `codex -a never -s ${sandbox}`;
+    if (opts.model && CODEX_MODEL_SAFE.test(opts.model))
+        cmd += ` -m ${opts.model}`;
+    return cmd;
+}
+/** SSH exec（非ログインシェル）向けに注入する PATH。 */
+export function defaultInjectedPath() {
+    return [
+        "/opt/homebrew/bin",
+        path.join(os.homedir(), ".local/bin"),
+        // mise 管理ツール（例: codex）の解決用シムディレクトリ。非ログインシェルの SSH exec でも届くよう明示。
+        path.join(os.homedir(), ".local/share/mise/shims"),
+        "/usr/local/bin",
+        "/usr/bin",
+        "/bin",
+        "/usr/sbin",
+        "/sbin",
+    ].join(":");
+}
+/** シェル single-quote で安全に包む（内部の `'` は `'\''` へ）。tmux new に渡す inner コマンド用。 */
+export function shellSingleQuote(value) {
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+function defaultProcessRunner() {
+    return (executable, args, options) => new Promise((resolve, reject) => {
+        execFile(executable, args, { cwd: options.cwd, env: options.env, maxBuffer: 16 * 1024 * 1024 }, (error, stdout) => {
+            if (error && typeof error.code === "string") {
+                reject(error);
+                return;
+            }
+            const exitCode = error && typeof error.code === "number" ? error.code : error ? 1 : 0;
+            resolve({ exitCode, stdout: String(stdout) });
+        });
+    });
+}
+/** launch サブコマンドのエントリポイント（`--dir <path> --session <name>`）。 */
+export async function runLaunchCommand(args) {
+    let dirArg = null;
+    let sessionArg = null;
+    for (let i = 0; i < args.length; i += 1) {
+        if (args[i] === "--dir" && i + 1 < args.length) {
+            dirArg = args[i + 1];
+            i += 1;
+        }
+        else if (args[i] === "--session" && i + 1 < args.length) {
+            sessionArg = args[i + 1];
+            i += 1;
+        }
+    }
+    if (!dirArg) {
+        process.stderr.write("tailii launch: --dir <path> が必要です\n");
+        return 2;
+    }
+    if (!sessionArg) {
+        process.stderr.write("tailii launch: --session <name> が必要です\n");
+        return 2;
+    }
+    return launchCore({
+        dir: dirArg,
+        session: sessionArg,
+        baseDir: null,
+        binaryPath: currentBinaryPath(),
+        tmuxPath: DEFAULT_TMUX_PATH,
+        innerCommand: DEFAULT_INNER_COMMAND,
+        path: defaultInjectedPath(),
+        store: new SessionMetadataStore(),
+        now: () => Math.floor(Date.now() / 1000),
+        errorSink: (message) => process.stderr.write(message),
+        backend: resolveSessionBackendKind(),
+    });
+}
+/**
+ * `session_start` を `launchCore` へ橋渡しする EngineLauncher を組み立てる。
+ * `store` は TmuxSessionManager と同一インスタンスを渡すこと（起動直後の一覧に cwd が反映されるように）。
+ */
+export function makeSessionLauncher(options = {}) {
+    const store = options.store ?? new SessionMetadataStore();
+    const agent = options.agent ?? "claude";
+    const inner = options.innerCommand ?? (agent === "codex" ? DEFAULT_CODEX_COMMAND : DEFAULT_INNER_COMMAND);
+    const tmux = options.tmuxPath ?? DEFAULT_TMUX_PATH;
+    const backendOption = options.backend ?? "tmux";
+    const herdr = options.herdrPath ?? defaultHerdrPath();
+    const binary = currentBinaryPath();
+    const runner = options.runner ?? defaultProcessRunner();
+    const codexAppServer = agent === "codex" ? (options.codexAppServer ?? new CodexAppServerManager()) : null;
+    return async (cwd, name, baseDir, resumeSessionId, newSessionId, title, launchOptions) => {
+        let errorText = "";
+        // resume 先の worktree が削除済みなら repo ルートへフォールバック（deleted-worktree-resume）。
+        // session_start(resume) と session_reattach の両経路がこの閉包を通る。
+        if (resumeSessionId !== null && resumeSessionId !== undefined) {
+            const rescued = rescueMissingWorktreeCwd({
+                cwd,
+                claudeSessionId: agent === "claude" ? resumeSessionId : null,
+                ...(options.claudeProjectsDir !== undefined
+                    ? { projectsDir: options.claudeProjectsDir }
+                    : {}),
+            });
+            if (rescued !== null)
+                cwd = rescued;
+        }
+        // resume: claude は `<inner> --resume <id>`。resume でない新規起動は
+        // `<inner> --session-id <uuid>` で会話 id を固定し、host が tail 対象 jsonl を
+        // 事前に確定できるようにする（同一 cwd の別会話ログの流入を防ぐ）。会話名を付けた
+        // 新規起動は `--name '<title>'`（/resume ピッカー等に出る表示名, lazy-session）を添える。
+        // codex はこれらの制御を持たないため従来どおり素の inner（resume 指定も本スライスでは無視）。
+        let effectiveInner;
+        let effectiveProviderSessionId = agent === "claude" ? (resumeSessionId ?? newSessionId ?? null) : resumeSessionId;
+        let effectiveCwd = cwd;
+        let effectiveBaseDir = baseDir;
+        if (agent === "claude") {
+            if (resumeSessionId) {
+                effectiveInner = `${inner} --resume ${resumeSessionId}`;
+            }
+            else if (newSessionId) {
+                effectiveInner = `${inner} --session-id ${newSessionId}`;
+                if (title)
+                    effectiveInner += ` --name ${shellSingleQuote(title)}`;
+            }
+            else {
+                effectiveInner = inner;
+            }
+            effectiveInner = `${CLAUDE_RESUME_THRESHOLD_ENV} ${effectiveInner}`;
+        }
+        else {
+            if (codexAppServer === null) {
+                return { exitCode: 1, errorText: "Codex App Server が構成されていません。" };
+            }
+            // App Serverのthread/startには絶対cwdが必要。launchCoreと同じ規則で先に解決する。
+            const resolved = resolveWorkdir(cwd, baseDir, (message) => {
+                errorText += message;
+            });
+            if (resolved === null)
+                return { exitCode: 1, errorText };
+            effectiveCwd = resolved;
+            effectiveBaseDir = null;
+            try {
+                if (resumeSessionId !== null) {
+                    await codexAppServer.ensureRunning();
+                    effectiveProviderSessionId = resumeSessionId;
+                }
+                else {
+                    effectiveProviderSessionId = await codexAppServer.startThread({
+                        cwd: resolved,
+                        model: launchOptions?.codexModel && CODEX_MODEL_SAFE.test(launchOptions.codexModel)
+                            ? launchOptions.codexModel
+                            : null,
+                        sandbox: launchOptions?.codexSandbox ?? null,
+                    });
+                }
+            }
+            catch (error) {
+                return { exitCode: 1, errorText: `Codex App Server 起動失敗: ${String(error)}` };
+            }
+            const selectedInner = launchOptions?.codexModel !== undefined || launchOptions?.codexSandbox !== undefined
+                ? codexInnerCommand({
+                    model: launchOptions.codexModel ?? null,
+                    sandbox: launchOptions.codexSandbox ?? null,
+                })
+                : inner;
+            effectiveInner = codexRemoteResumeCommand(selectedInner, effectiveProviderSessionId, codexAppServer.remoteEndpoint);
+        }
+        const exitCode = await launchCore({
+            dir: effectiveCwd,
+            session: name,
+            baseDir: effectiveBaseDir,
+            binaryPath: binary,
+            tmuxPath: tmux,
+            backend: typeof backendOption === "function" ? backendOption() : backendOption,
+            herdrPath: herdr,
+            innerCommand: effectiveInner,
+            path: defaultInjectedPath(),
+            store,
+            now: () => Math.floor(Date.now() / 1000),
+            errorSink: (message) => {
+                errorText += message;
+            },
+            runner,
+            agent,
+            // resume は同一会話 id の jsonl に書き続ける（engine の tail 束縛と同じ前提）ため、
+            // resume 起動でも実効会話 id を権威記録し、以後の reattach で厳密束縛できるようにする。
+            claudeSessionId: agent === "claude" ? (resumeSessionId ?? newSessionId ?? null) : null,
+            providerSessionId: effectiveProviderSessionId,
+            displayTitle: title ?? null,
+        });
+        return {
+            exitCode,
+            errorText,
+            ...(effectiveProviderSessionId !== null
+                ? { providerSessionId: effectiveProviderSessionId }
+                : {}),
+        };
+    };
+}
+/** Codex TUIを共有App Serverの同一threadへ接続する安全なresumeコマンド。 */
+export function codexRemoteResumeCommand(_innerCommand, sessionId, remoteEndpoint) {
+    if (!/^[A-Za-z0-9._-]+$/.test(sessionId))
+        throw new Error("invalid Codex session ID");
+    if (!/^unix:\/\/[A-Za-z0-9_./-]*$/.test(remoteEndpoint)) {
+        throw new Error("invalid Codex App Server endpoint");
+    }
+    // model/sandbox/approval は thread/start/thread/resume の App Server 側を権威にする。
+    // TUI の resume 引数で `-a never` 等を再指定すると native approval 設定を上書きするため、
+    // remote TUI は同一 thread の表示クライアントとして必要最小限の引数だけで接続する。
+    // thread/start 直後は最初の user turn まで rollout が存在せず、running thread でも TUI の
+    // thread/resume は `no rollout found` になる。tmux pane を生かしたまま rollout 生成を待ち、
+    // App Server turn/start が materialize した直後に TUI を同じ thread へ接続する。
+    const sessionsRoot = '"${CODEX_HOME:-$HOME/.codex}/sessions"';
+    const waitForRollout = `while ! find ${sessionsRoot} -type f -name '*${sessionId}*.jsonl' -print -quit 2>/dev/null | grep -q .; do sleep 0.2; done`;
+    return `${waitForRollout}; exec codex resume --remote ${remoteEndpoint} --no-alt-screen ${sessionId}`;
+}
+/**
+ * launch の純ロジック（プロセス起動とパス類を注入できるためテスト可能）。
+ * 1. cwd 解決 + base 配下限定自動作成 → 2. フォルダ事前信頼 → 3. `--settings` へ承認フックを合成 →
+ * 4. 死んだ同名セッション掃除 → 5. tmux デタッチ起動 → 6. cwd 権威記録。
+ */
+export async function launchCore(options) {
+    const { session, binaryPath, tmuxPath, store, now, errorSink } = options;
+    const agent = options.agent ?? "claude";
+    const runner = options.runner ?? defaultProcessRunner();
+    // --- 1. cwd 解決 + base 配下限定自動作成 ---
+    const dir = resolveWorkdir(options.dir, options.baseDir, errorSink);
+    if (dir === null)
+        return 1;
+    // エージェント別の起動前準備。
+    // claude: 「フォルダを信頼しますか?」の事前回避（~/.claude.json）と settings.json フック注入。
+    // codex: Claude 固有処理は行わない。App Server が承認要求を JSON-RPC で配信するため、
+    //        旧版 Tailii の Codex hook を除去し、プロジェクト信頼だけを起動引数で付与する。
+    let innerCommand = options.innerCommand;
+    if (agent === "codex") {
+        // App Server の native approval と二重化しないよう、旧版が追加した hook だけを消す。
+        // 併せて `-c` で信頼を事前付与しトラストダイアログを回避（config.toml は書き換えない）。
+        try {
+            removeCodexHookSettings({ dir, binaryPath });
+        }
+        catch (error) {
+            errorSink(`tailii launch: 旧 Codex hook の除去失敗: ${String(error)}\n`);
+            return 1;
+        }
+        // App Server thread/start が cwd/permission を構造化設定する。remote TUI は表示購読者なので、
+        // CLI 側の trust/approval override を重ねず thread 設定をそのまま使う。
+    }
+    else {
+        // --- 1.5. claude の初回「フォルダを信頼しますか?」プロンプトを事前回避する ---
+        preTrustFolder(dir, options.claudeJsonPath);
+        // --- 2. 承認フックを settings.json へは書かず、この起動限定で `--settings` 経由で渡す ---
+        //   （settings.json に書くと同 dir の「tailii 非経由の通常 claude 起動」もフックを拾い、
+        //     承認ブローカー不在で全ツールがハングするため。2026-07-07 ユーザー指摘の根治）
+        const hookSettings = claudeHookLaunchSettings({
+            dir,
+            binaryPath,
+            session,
+            ...(options.hookGlobalMarkerPath !== undefined && {
+                globalMarkerPath: options.hookGlobalMarkerPath,
+            }),
+        });
+        if (hookSettings !== null) {
+            innerCommand = `${innerCommand} --settings ${shellSingleQuote(hookSettings)}`;
+        }
+    }
+    const env = { ...process.env, PATH: options.path };
+    // --- herdr backend: tmux セッションの代わりに herdr pane としてデタッチ起動する ---
+    if ((options.backend ?? "tmux") === "herdr") {
+        return launchHerdrPane({
+            session,
+            dir,
+            innerCommand,
+            agent,
+            herdrPath: options.herdrPath ?? defaultHerdrPath(),
+            injectedPath: options.path,
+            env,
+            runner,
+            store,
+            now,
+            errorSink,
+            ...(options.claudeSessionId !== undefined ? { claudeSessionId: options.claudeSessionId } : {}),
+            ...(options.providerSessionId !== undefined
+                ? { providerSessionId: options.providerSessionId }
+                : {}),
+            ...(options.displayTitle !== undefined ? { displayTitle: options.displayTitle } : {}),
+            ...(options.spawnDetached !== undefined ? { spawnDetached: options.spawnDetached } : {}),
+            ...(options.ensurePollMs !== undefined ? { ensurePollMs: options.ensurePollMs } : {}),
+        });
+    }
+    const runTmux = async (args) => {
+        try {
+            const result = await runner(tmuxPath, args, { env });
+            return { code: result.exitCode, out: result.stdout };
+        }
+        catch {
+            return { code: 127, out: "" };
+        }
+    };
+    // --- 2.5. 既存の「死んだ」同名セッションを掃除する（同名再利用を可能にする） ---
+    if ((await runTmux(["has-session", "-t", session])).code === 0) {
+        const panes = await runTmux(["list-panes", "-t", session, "-F", "#{pane_dead}"]);
+        const hasLive = panes.out.split("\n").some((line) => line.trim() === "0");
+        // Claude が終了してシェルだけ残った pane も stale。これを生存扱いすると --resume を
+        // 起動せず、iOS からの会話入力がシェルへ送られて無反応になる。
+        // Codex は App Server がターンを駆動し、rollout 待ち中の TUI が shell に見えるため除外する。
+        let hasAgent = true;
+        if (hasLive && agent === "claude") {
+            const current = await runTmux([
+                "display-message", "-p", "-t", session, "#{pane_current_command}",
+            ]);
+            hasAgent = current.code !== 0 || paneCommandLooksLikeAgent(current.out);
+        }
+        if (!hasLive || !hasAgent) {
+            await runTmux(["kill-session", "-t", session]);
+        }
+    }
+    // --- 3. tmux で claude をデタッチ起動 ---
+    // まだ存在するなら生きた pane がある（claude 稼働中）＝再作成不要。
+    // `-A` は付けない（sshd exec に TTY が無く attach 試行が非0終了するため）。
+    const alreadyLive = (await runTmux(["has-session", "-t", session])).code === 0;
+    if (!alreadyLive) {
+        let status;
+        try {
+            const result = await runner(tmuxPath, ["new", "-d", "-s", session, innerCommand], {
+                cwd: dir,
+                env,
+            });
+            status = result.exitCode;
+        }
+        catch (error) {
+            errorSink(`tailii launch: tmux 起動失敗 (${tmuxPath}): ${String(error)}\n`);
+            return 1;
+        }
+        if (status !== 0) {
+            errorSink(`tailii launch: tmux が非0終了 (${status})\n`);
+            return status;
+        }
+    }
+    // session名はrenameやmulti-pane化で曖昧になるため、以後の入出力target用に安定pane IDを保存する。
+    const paneResult = await runTmux(["display-message", "-p", "-t", session, "#{pane_id}"]);
+    const paneIdCandidate = paneResult.code === 0 ? paneResult.out.trim() : "";
+    const tmuxPaneId = /^%\d+$/.test(paneIdCandidate) ? paneIdCandidate : null;
+    // --- 4. cwd を権威記録（tmux は起動 cwd を安定に返さないため本ストアを権威とする） ---
+    try {
+        // 任意メタは必要なときだけ記録する（古いメタ形式との後方互換を保つ）。
+        store.put({
+            name: session,
+            cwd: dir,
+            createdAt: now(),
+            ...(agent === "codex" ? { agent } : {}),
+            ...(agent === "claude" && options.claudeSessionId
+                ? { claudeSessionId: options.claudeSessionId }
+                : {}),
+            ...(options.providerSessionId ? { providerSessionId: options.providerSessionId } : {}),
+            ...(tmuxPaneId !== null ? { tmuxPaneId } : {}),
+        });
+    }
+    catch (error) {
+        errorSink(`tailii launch: メタデータ保存失敗: ${String(error)}\n`);
+        return 1;
+    }
+    return 0;
+}
+/**
+ * herdr backend の起動実体。tmux の「死んだ同名セッション掃除 → デタッチ起動 → pane ID 記録」に
+ * 対応する herdr 版。ユーザーの default セッションを汚さないよう、専用 named session
+ * `tailii`（`--session` を全コマンドに前置）へ収容する:
+ * 1. tailii セッションサーバーの ensure（不在ならヘッドレス起動）→
+ * 2. stale pane 掃除（claude が終了してシェル化した pane）→
+ * 3. `tab create --cwd --env` で新タブ+pane 生成 → 4. `pane rename` で label=session 名 →
+ * 5. `pane run "exec /bin/zsh -lc '<inner>'"` で起動 → 6. backend/herdrPaneId 込みでメタ権威記録。
+ * （herdr 0.7.5 で `agent start` の pane 生成/cwd/env 指定が廃止されたため tab create 方式）
+ */
+async function launchHerdrPane(options) {
+    const { session, dir, agent, store, now, errorSink } = options;
+    const runHerdr = async (args) => {
+        try {
+            const result = await options.runner(options.herdrPath, ["--session", HERDR_TAILII_SESSION, ...args], { env: options.env });
+            return { code: result.exitCode, out: result.stdout };
+        }
+        catch (error) {
+            errorSink(`tailii launch: herdr 起動失敗 (${options.herdrPath}): ${String(error)}\n`);
+            return { code: 127, out: "" };
+        }
+    };
+    const spawnDetached = options.spawnDetached ??
+        ((executable, args) => {
+            const child = spawn(executable, args, { detached: true, stdio: "ignore" });
+            child.unref();
+        });
+    // --- 1. tailii セッションサーバーの ensure（`pane list` が通れば稼働中） ---
+    let paneList = await runHerdr(["pane", "list"]);
+    if (paneList.code !== 0) {
+        spawnDetached(options.herdrPath, ["--session", HERDR_TAILII_SESSION, "server"]);
+        const deadline = Date.now() + 5000;
+        const pollMs = options.ensurePollMs ?? 150;
+        while (Date.now() <= deadline) {
+            await sleep(pollMs);
+            paneList = await runHerdr(["pane", "list"]);
+            if (paneList.code === 0)
+                break;
+        }
+        if (paneList.code !== 0) {
+            errorSink(`tailii launch: herdr セッション '${HERDR_TAILII_SESSION}' を起動できませんでした\n`);
+            return 1;
+        }
+    }
+    // --- 2. 既存 pane の解決と stale 掃除（tmux の dead-session 掃除に対応） ---
+    const panes = parseHerdrPaneList(paneList.out);
+    const recordedPaneId = store.get(session)?.herdrPaneId;
+    let existing = (recordedPaneId !== undefined ? panes.find((pane) => pane.paneId === recordedPaneId) : undefined) ??
+        panes.find((pane) => pane.label === session) ??
+        null;
+    if (existing !== null && agent === "claude") {
+        // Claude が終了してシェルだけ残った pane は入力先として無効なので閉じて作り直す。
+        const info = await runHerdr(["pane", "process-info", "--pane", existing.paneId]);
+        const hasAgent = info.code !== 0 || paneCommandLooksLikeAgent(parseHerdrForegroundCommand(info.out));
+        if (!hasAgent) {
+            await runHerdr(["pane", "close", existing.paneId]);
+            existing = null;
+        }
+    }
+    let herdrPaneId = existing?.paneId ?? null;
+    if (existing === null) {
+        // --- 3. tab create で新タブ+pane を生成（0.7.5 で agent start の pane 生成/cwd/env 指定が
+        //     廃止されたため。anchor pane 不要なので pane ゼロの空セッションでも成立する）。
+        //     タブラベルは付けず herdr 既定表示（連番）に任せる（session-title のタブ反映は
+        //     2026-07-30 撤去）。 ---
+        const created = await runHerdr([
+            "tab", "create",
+            "--cwd", dir,
+            "--env", `PATH=${options.injectedPath}`,
+            "--no-focus",
+        ]);
+        if (created.code !== 0) {
+            errorSink(`tailii launch: herdr が非0終了 (${created.code})\n`);
+            return created.code === 0 ? 1 : created.code;
+        }
+        herdrPaneId = parseHerdrCreatedTabPaneId(created.out);
+        if (herdrPaneId === null) {
+            errorSink("tailii launch: herdr tab create の pane_id を解決できませんでした\n");
+            return 1;
+        }
+        // --- 4. pane label = session 名（セッション解決の権威: findPane fallback / list 生存判定） ---
+        const renamed = await runHerdr(["pane", "rename", herdrPaneId, session]);
+        if (renamed.code !== 0) {
+            await runHerdr(["pane", "close", herdrPaneId]);
+            errorSink(`tailii launch: herdr pane rename が非0終了 (${renamed.code})\n`);
+            return renamed.code;
+        }
+        // --- 5. innerCommand を起動。pane run はタイプ注入で argv のクォートを保持しないため
+        //     単一文字列で渡す。exec 前置で claude 終了と同時に pane が閉じる
+        //     （旧 agent start の「コマンド終了 = pane close」と同義。stale shell を残さない）。 ---
+        const ran = await runHerdr([
+            "pane", "run", herdrPaneId,
+            `exec /bin/zsh -lc ${shellSingleQuote(options.innerCommand)}`,
+        ]);
+        if (ran.code !== 0) {
+            await runHerdr(["pane", "close", herdrPaneId]);
+            errorSink(`tailii launch: herdr pane run が非0終了 (${ran.code})\n`);
+            return ran.code;
+        }
+    }
+    // --- cwd と backend を権威記録（tmux 版の store.put と同じ役割） ---
+    try {
+        store.put({
+            name: session,
+            cwd: dir,
+            createdAt: now(),
+            backend: "herdr",
+            ...(agent === "codex" ? { agent } : {}),
+            ...(agent === "claude" && options.claudeSessionId
+                ? { claudeSessionId: options.claudeSessionId }
+                : {}),
+            ...(options.providerSessionId ? { providerSessionId: options.providerSessionId } : {}),
+            ...(herdrPaneId !== null ? { herdrPaneId } : {}),
+        });
+    }
+    catch (error) {
+        errorSink(`tailii launch: メタデータ保存失敗: ${String(error)}\n`);
+        return 1;
+    }
+    return 0;
+}
+/**
+ * `~/.claude.json` の `projects[<dir>].hasTrustDialogAccepted` を true にしておく。
+ * claude は canonical パス（シンボリックリンク解決後）をキーに信頼を記録する。失敗は握り潰す。
+ */
+export function preTrustFolder(dir, claudeJsonPath) {
+    try {
+        const target = claudeJsonPath ?? path.join(os.homedir(), ".claude.json");
+        let key;
+        try {
+            key = fs.realpathSync.native(dir);
+        }
+        catch {
+            key = standardize(dir);
+        }
+        let root = {};
+        try {
+            const parsed = JSON.parse(fs.readFileSync(target, "utf8"));
+            if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+                root = parsed;
+            }
+        }
+        catch {
+            // 不在/壊れは空から作る。
+        }
+        const projects = typeof root["projects"] === "object" && root["projects"] !== null
+            ? root["projects"]
+            : {};
+        const entry = typeof projects[key] === "object" && projects[key] !== null
+            ? projects[key]
+            : {};
+        if (entry["hasTrustDialogAccepted"] === true)
+            return; // 既に信頼済み
+        entry["hasTrustDialogAccepted"] = true;
+        projects[key] = entry;
+        root["projects"] = projects;
+        const tmp = target + ".tmp";
+        fs.writeFileSync(tmp, JSON.stringify(root));
+        fs.renameSync(tmp, target);
+    }
+    catch {
+        // 失敗時は claude 側プロンプトへフォールバック。
+    }
+}
+/**
+ * cwd 入力を baseDir 基準で実パスへ解決し、baseDir 配下限定で未存在を自動作成する。
+ * `/` 始まり → 絶対採用 / `~` 始まり → ホーム展開 / 相対（空含む）→ `baseDir/<入力>`。
+ * `..` 脱出は拒否。不在 + 相対（= base 内側）のみ自動作成。失敗は errorSink へ出し null。
+ */
+export function resolveWorkdir(cwd, baseDir, errorSink) {
+    let resolved;
+    let isRelative;
+    if (cwd.startsWith("/")) {
+        resolved = standardize(cwd);
+        isRelative = false;
+    }
+    else if (cwd.startsWith("~")) {
+        resolved = standardize(expandTilde(cwd));
+        isRelative = false;
+    }
+    else {
+        if (!baseDir) {
+            errorSink(`tailii launch: 相対パスにはベースディレクトリの設定が必要です: '${cwd}'\n`);
+            return null;
+        }
+        const joined = cwd === "" ? baseDir : baseDir + "/" + cwd;
+        const candidate = standardize(joined);
+        if (!isInsideBase(candidate, baseDir)) {
+            errorSink(`tailii launch: 解決先がベースディレクトリの外側です: ${candidate}\n`);
+            return null;
+        }
+        resolved = candidate;
+        isRelative = true;
+    }
+    // 存在チェック。
+    let stat = null;
+    try {
+        stat = fs.statSync(resolved);
+    }
+    catch {
+        stat = null;
+    }
+    if (stat !== null) {
+        if (!stat.isDirectory()) {
+            errorSink(`tailii launch: 作業ディレクトリがファイルです: ${resolved}\n`);
+            return null;
+        }
+        return resolved;
+    }
+    // 不在: base 配下（相対）のみ自動作成。絶対/`~` の不在は作成せず error。
+    if (!isRelative) {
+        errorSink(`tailii launch: 作業ディレクトリが存在しません: ${resolved}\n`);
+        return null;
+    }
+    try {
+        fs.mkdirSync(resolved, { recursive: true });
+        return resolved;
+    }
+    catch (error) {
+        errorSink(`tailii launch: 作業ディレクトリの作成に失敗しました: ${resolved}: ${String(error)}\n`);
+        return null;
+    }
+}
+/**
+ * resume 対象の cwd（絶対/`~`）が削除済みの Tailii worktree なら repo ルートへ振り替える。
+ * 公式 Claude Code CLI の「worktree が消えていたら起動元ディレクトリで再開」と同じ挙動
+ * （deleted-worktree-resume）。振り替え不要・不能なら null。
+ * claude の `--resume <id>` はカレントプロジェクトの slug に閉じて検索するため、
+ * transcript jsonl を repo ルート側 slug へ移設してから振り替える。
+ * 移設に失敗しても振り替え自体は行う（claude 側の未検出エラーの方が dir 不在より情報が多い）。
+ */
+export function rescueMissingWorktreeCwd(options) {
+    const { cwd, claudeSessionId } = options;
+    if (!cwd.startsWith("/") && !cwd.startsWith("~"))
+        return null;
+    const resolved = standardize(cwd);
+    if (fs.existsSync(resolved))
+        return null;
+    const root = tailiiWorktreeRepoRoot(resolved);
+    if (root === null)
+        return null;
+    let rootStat;
+    try {
+        rootStat = fs.statSync(root);
+    }
+    catch {
+        return null;
+    }
+    if (!rootStat.isDirectory())
+        return null;
+    if (claudeSessionId !== null) {
+        const projectsDir = options.projectsDir ?? path.join(os.homedir(), ".claude", "projects");
+        const destDir = path.join(projectsDir, claudeProjectSlug(root));
+        const dest = path.join(destDir, `${claudeSessionId}.jsonl`);
+        if (!fs.existsSync(dest)) {
+            const src = new ClaudeSessionStore(projectsDir).transcriptPath(claudeSessionId);
+            if (src !== null && src !== dest) {
+                try {
+                    fs.mkdirSync(destDir, { recursive: true });
+                    fs.renameSync(src, dest);
+                }
+                catch {
+                    // 移設失敗は claude の resume エラーに委ねる（上のコメント参照）。
+                }
+                // セッション付帯ディレクトリ（`<slug>/<id>/`、/rewind のファイルスナップショット等）も同居させる。
+                const srcAssets = src.slice(0, -".jsonl".length);
+                const destAssets = path.join(destDir, claudeSessionId);
+                try {
+                    if (fs.existsSync(srcAssets) && !fs.existsSync(destAssets)) {
+                        fs.renameSync(srcAssets, destAssets);
+                    }
+                }
+                catch {
+                    // 付帯ディレクトリの移設失敗は無視する（transcript 本体が正）。
+                }
+            }
+        }
+    }
+    return root;
+}
+/** THIS 実行中エントリスクリプトの絶対パスを解決する（フック command 埋め込み用）。 */
+export function currentBinaryPath() {
+    const argv1 = process.argv[1];
+    if (argv1 && argv1.length > 0) {
+        return standardize(argv1);
+    }
+    return "tailii";
+}
+//# sourceMappingURL=launch.js.map