@minimalcorp/tsunagi 0.1.55 → 0.3.0

package/dist/server/routes/claude-profiles.js

@@ -0,0 +1,138 @@
+import * as os from 'os';
+import { ptyManager } from '../pty-manager.js';
+import { prisma } from '../lib/db.js';
+import { deleteEnv, getEnv, setEnv } from '../lib/repositories/environment.js';
+import { CLAUDE_PROFILE_ENV_KEY, DEFAULT_CLAUDE_PROFILE, buildClaudeLoginCommand, claudeLoginPtyEnv, claudeProfileExists, createClaudeProfile, deleteClaudeProfile, getClaudeAuthStatus, listClaudeProfiles, } from '../lib/claude-profiles.js';
+import { notifyEnvChanged } from '../lib/pty-env-sync.js';
+/** ログイン用 PTY の sessionId の接頭辞（タブの PTY と区別する） */
+const LOGIN_SESSION_PREFIX = 'claude-login-';
+function validateScope(scope, owner, repo) {
+    if (scope !== 'global' && scope !== 'owner' && scope !== 'repo')
+        return 'Invalid scope';
+    if (scope === 'owner' && !owner)
+        return 'owner is required for scope=owner';
+    if (scope === 'repo' && (!owner || !repo))
+        return 'owner and repo are required for scope=repo';
+    return null;
+}
+async function getAssignment(scope, owner, repo) {
+    const row = await prisma.environmentVariable.findFirst({
+        where: {
+            key: CLAUDE_PROFILE_ENV_KEY,
+            scope,
+            ...(scope !== 'global' && { owner }),
+            ...(scope === 'repo' && { repo }),
+        },
+    });
+    const merged = await getEnv(scope, owner, repo);
+    const assignment = {
+        assigned: row?.value ?? null,
+        effective: merged[CLAUDE_PROFILE_ENV_KEY] ?? DEFAULT_CLAUDE_PROFILE,
+    };
+    return assignment;
+}
+function syncPtyEnv(fastify) {
+    notifyEnvChanged().catch((err) => fastify.log.warn(err, 'Failed to sync PTY env'));
+}
+export async function claudeProfilesRoutes(fastify) {
+    // GET /claude-profiles - システム既定 + 登録済みプロファイルとログイン状態
+    fastify.get('/claude-profiles', async (_request, reply) => {
+        const profiles = await listClaudeProfiles();
+        const data = await Promise.all([
+            getClaudeAuthStatus(DEFAULT_CLAUDE_PROFILE).then((status) => ({
+                slug: DEFAULT_CLAUDE_PROFILE,
+                name: 'System default',
+                // CLAUDE_CONFIG_DIR を付けない（普段ターミナルで claude を使うときと同じ設定）
+                configDir: null,
+                status,
+            })),
+            ...profiles.map(async (profile) => ({
+                ...profile,
+                status: await getClaudeAuthStatus(profile.slug),
+            })),
+        ]);
+        return reply.send({ data: { profiles: data } });
+    });
+    // GET /claude-profiles/:slug/status - ログイン状態（ログイン用ダイアログで完了を確認する）
+    fastify.get('/claude-profiles/:slug/status', async (request, reply) => {
+        const { slug } = request.params;
+        if (!(await claudeProfileExists(slug))) {
+            return reply.status(404).send({ error: 'Profile not found' });
+        }
+        return reply.send({ data: { status: await getClaudeAuthStatus(slug) } });
+    });
+    // POST /claude-profiles - プロファイル作成
+    fastify.post('/claude-profiles', async (request, reply) => {
+        try {
+            const profile = await createClaudeProfile(request.body?.name ?? '');
+            return reply.status(201).send({ data: { profile } });
+        }
+        catch (err) {
+            return reply.status(400).send({ error: err instanceof Error ? err.message : String(err) });
+        }
+    });
+    // DELETE /claude-profiles/:slug - プロファイル削除（logout してディレクトリごと消す）
+    fastify.delete('/claude-profiles/:slug', async (request, reply) => {
+        const { slug } = request.params;
+        if (slug === DEFAULT_CLAUDE_PROFILE || !(await claudeProfileExists(slug))) {
+            return reply.status(404).send({ error: 'Profile not found' });
+        }
+        await deleteClaudeProfile(slug);
+        syncPtyEnv(fastify);
+        return reply.status(204).send();
+    });
+    // POST /claude-profiles/:slug/login - ログイン用 PTY を起動し `claude auth login` を実行する
+    fastify.post('/claude-profiles/:slug/login', async (request, reply) => {
+        const { slug } = request.params;
+        if (!(await claudeProfileExists(slug))) {
+            return reply.status(404).send({ error: 'Profile not found' });
+        }
+        // 同じプロファイルのログイン用 PTY が残っていれば閉じる
+        const prefix = `${LOGIN_SESSION_PREFIX}${slug}-`;
+        for (const id of ptyManager.listSessions()) {
+            if (id.startsWith(prefix))
+                ptyManager.deleteSession(id);
+        }
+        const sessionId = `${prefix}${crypto.randomUUID()}`;
+        const { env, unsetKeys } = claudeLoginPtyEnv(slug);
+        const session = ptyManager.createSession(sessionId, os.homedir(), env, unsetKeys);
+        // シェルの初期化（プロンプト表示）を待つため少し遅延させて書き込む
+        setTimeout(() => session.pty.write(`${buildClaudeLoginCommand()}\n`), 300);
+        return reply.status(201).send({ data: { sessionId } });
+    });
+    // DELETE /claude-profiles/login/:sessionId - ログイン用 PTY を閉じる
+    fastify.delete('/claude-profiles/login/:sessionId', async (request, reply) => {
+        const { sessionId } = request.params;
+        if (!sessionId.startsWith(LOGIN_SESSION_PREFIX)) {
+            return reply.status(400).send({ error: 'Not a login session' });
+        }
+        ptyManager.deleteSession(sessionId);
+        return reply.status(204).send();
+    });
+    // GET /claude-profiles/assignment - スコープのプロファイル割り当て
+    fastify.get('/claude-profiles/assignment', async (request, reply) => {
+        const { scope, owner, repo } = request.query;
+        const error = validateScope(scope, owner, repo);
+        if (error)
+            return reply.status(400).send({ error });
+        return reply.send({ data: { assignment: await getAssignment(scope, owner, repo) } });
+    });
+    // PUT /claude-profiles/assignment - スコープのプロファイル割り当てを変更する
+    fastify.put('/claude-profiles/assignment', async (request, reply) => {
+        const { scope, owner, repo, slug } = request.body ?? {};
+        const error = validateScope(scope, owner, repo);
+        if (error)
+            return reply.status(400).send({ error });
+        if (slug !== null && !(await claudeProfileExists(slug))) {
+            return reply.status(400).send({ error: 'Profile not found' });
+        }
+        if (slug === null) {
+            await deleteEnv(CLAUDE_PROFILE_ENV_KEY, scope, owner, repo);
+        }
+        else {
+            await setEnv(CLAUDE_PROFILE_ENV_KEY, slug, scope, owner, repo);
+        }
+        syncPtyEnv(fastify);
+        return reply.send({ data: { assignment: await getAssignment(scope, owner, repo) } });
+    });
+}

package/dist/server/routes/env.js

@@ -1,4 +1,11 @@
 import * as envRepo from '../lib/repositories/environment.js';
+import { RESERVED_ENV_KEYS } from '../lib/claude-profiles.js';
+import { notifyEnvChanged } from '../lib/pty-env-sync.js';
+const RESERVED_KEY_ERROR = 'Claude の認証は Settings の Claude Profile で設定してください';
+/** 変更後、起動中のターミナルに反映する（失敗しても API 自体は成功扱い） */
+function syncPtyEnv(fastify) {
+    notifyEnvChanged().catch((err) => fastify.log.warn(err, 'Failed to sync PTY env'));
+}
 export async function envRoutes(fastify) {
     // GET /env
     fastify.get('/env', async (request, reply) => {
@@ -30,6 +37,9 @@ export async function envRoutes(fastify) {
             if (!key || !value || !scope) {
                 return reply.status(400).send({ error: 'Missing required fields: key, value, scope' });
             }
+            if (RESERVED_ENV_KEYS.includes(key)) {
+                return reply.status(400).send({ error: RESERVED_KEY_ERROR });
+            }
             if (scope === 'owner' && !owner) {
                 return reply.status(400).send({ error: 'Missing required field: owner for scope=owner' });
             }
@@ -39,6 +49,7 @@ export async function envRoutes(fastify) {
                 });
             }
             await envRepo.setEnv(key, value, scope, owner, repo);
+            syncPtyEnv(fastify);
             return reply.status(201).send({ data: { success: true } });
         }
         catch (error) {
@@ -53,6 +64,9 @@ export async function envRoutes(fastify) {
             if (!key || !value || !scope) {
                 return reply.status(400).send({ error: 'Missing required fields: key, value, scope' });
             }
+            if (RESERVED_ENV_KEYS.includes(key)) {
+                return reply.status(400).send({ error: RESERVED_KEY_ERROR });
+            }
             if (scope === 'owner' && !owner) {
                 return reply.status(400).send({ error: 'Missing required field: owner for scope=owner' });
             }
@@ -62,6 +76,7 @@ export async function envRoutes(fastify) {
                 });
             }
             await envRepo.setEnv(key, value, scope, owner, repo);
+            syncPtyEnv(fastify);
             return reply.status(200).send({ data: { success: true } });
         }
         catch (error) {
@@ -80,6 +95,9 @@ export async function envRoutes(fastify) {
                     error: 'Missing required query parameters: key, scope',
                 });
             }
+            if (RESERVED_ENV_KEYS.includes(key)) {
+                return reply.status(400).send({ error: RESERVED_KEY_ERROR });
+            }
             if (scope === 'owner' && !owner) {
                 return reply.status(400).send({
                     error: 'Missing required query parameter: owner for scope=owner',
@@ -94,6 +112,7 @@ export async function envRoutes(fastify) {
             if (!success) {
                 return reply.status(404).send({ error: 'Environment variable not found' });
             }
+            syncPtyEnv(fastify);
             return reply.status(200).send({ data: { success: true } });
         }
         catch (error) {
@@ -116,7 +135,8 @@ export async function envRoutes(fastify) {
                     error: 'Missing required query parameters: owner, repo for scope=repo',
                 });
             }
-            const envVars = await envRepo.getAllEnv(scope, owner || undefined, repo || undefined);
+            // 予約キー（Claude プロファイルの割り当て）は専用 UI で扱うため一覧に含めない
+            const envVars = (await envRepo.getAllEnv(scope, owner || undefined, repo || undefined)).filter((env) => !RESERVED_ENV_KEYS.includes(env.key));
             return reply.status(200).send({ data: { envVars } });
         }
         catch (error) {
@@ -131,7 +151,11 @@ export async function envRoutes(fastify) {
             if (!key || !scope || typeof enabled !== 'boolean') {
                 return reply.status(400).send({ error: 'key, scope, and enabled are required' });
             }
+            if (RESERVED_ENV_KEYS.includes(key)) {
+                return reply.status(400).send({ error: RESERVED_KEY_ERROR });
+            }
             await envRepo.toggleEnv(key, scope, enabled, owner, repo);
+            syncPtyEnv(fastify);
             return reply.status(200).send({ data: { success: true } });
         }
         catch (error) {

package/dist/server/routes/onboarding.js

@@ -1,15 +1,24 @@
-import { getEnv } from '../lib/repositories/environment.js';
 import { isLocalLlmReady } from '../lib/local-llm.js';
+import { DEFAULT_CLAUDE_PROFILE, getClaudeAuthStatus, listClaudeProfiles, } from '../lib/claude-profiles.js';
+/** システム既定かいずれかの Claude プロファイルがログイン済みか */
+async function isClaudeLoggedIn() {
+    if ((await getClaudeAuthStatus(DEFAULT_CLAUDE_PROFILE)).loggedIn)
+        return true;
+    const profiles = await listClaudeProfiles();
+    const statuses = await Promise.all(profiles.map((p) => getClaudeAuthStatus(p.slug)));
+    return statuses.some((status) => status.loggedIn);
+}
 export async function onboardingRoutes(fastify) {
     // GET /onboarding/status
     fastify.get('/onboarding/status', async (_request, reply) => {
         try {
-            const globalEnv = await getEnv('global');
-            const hasGlobalToken = Boolean(globalEnv.ANTHROPIC_API_KEY || globalEnv.CLAUDE_CODE_OAUTH_TOKEN);
-            // 実験的機能のローカルLLM（Ollama / LM Studio）を設定済みなら、Anthropic のトークンがなくても claude を起動できる
-            const localLlmReady = await isLocalLlmReady();
+            const [claudeLoggedIn, localLlmReady] = await Promise.all([
+                isClaudeLoggedIn(),
+                // 実験的機能のローカルLLM（Ollama / LM Studio）を設定済みなら、Claude にログインしていなくても claude を起動できる
+                isLocalLlmReady(),
+            ]);
             return reply.status(200).send({
-                data: { completed: hasGlobalToken || localLlmReady, hasGlobalToken, localLlmReady },
+                data: { completed: claudeLoggedIn || localLlmReady, claudeLoggedIn, localLlmReady },
             });
         }
         catch (error) {

package/dist/server/routes/terminal.js

@@ -1,23 +1,9 @@
-import * as fs from 'fs/promises';
-import * as os from 'os';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
 import { ptyManager } from '../pty-manager.js';
 import { prisma } from '../lib/db.js';
-import { getWorktreePath } from '../lib/worktree-manager.js';
-import { getEnv } from '../lib/repositories/environment.js';
-import { ensureClaudeOnboardingCompleted, removeLocalModelFromUserSettings, } from '../lib/claude-config-guard.js';
-import { LOCAL_LLM_UNSET_ENV_KEYS, LOCAL_MODEL_ALIAS, buildLocalLlmEnv, } from '../lib/local-llm-env.js';
-import { ensureActiveLoaded, getLocalLlmSettings } from '../lib/local-llm.js';
-import { LOCAL_LLM_PROXY_URL, buildClaudeCommand, isLocalLlmMode } from '../lib/claude-command.js';
-// このファイル基準で解決する(cwd 非依存):
-//   dev:        apps/server/src/routes      → apps/server/scripts
-//   build:      apps/server/dist/routes     → apps/server/scripts
-//   npm bundle: <pkg>/dist/server/routes    → <pkg>/dist/scripts
-const TSUNAGI_EDITOR_PATH = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../../scripts/monaco-editor.sh');
-// Fastify(API) の公開ポート。index.ts と同じ既定値・同じ環境変数(TSUNAGI_SERVER_PORT)を見る。
-// monaco-editor.sh など PTY 内のプロセスが API を叩く際の同一ホスト向けベース URL に使う。
-const SERVER_PORT = Number(process.env.TSUNAGI_SERVER_PORT) || 2791;
+import { ensureActiveLoaded } from '../lib/local-llm.js';
+import { buildClaudeCommand, isLocalLlmMode } from '../lib/claude-command.js';
+import { PtyLaunchError, prepareClaudeConfigForSession, resolvePtyLaunch, startPtySession, } from '../lib/pty-launch.js';
+import { getEnvPending, initPtyEnvSync, respawnSessionNow } from '../lib/pty-env-sync.js';
 /**
  * 再接続時の画面復元用 scrollback から「端末への問い合わせ（クエリ）」シーケンスを除去する。
  *
@@ -41,24 +27,9 @@ function stripTerminalQueries(s) {
         .replace(/\x1b\[[?>]?[0-9;]*n/g, '') // DSR: ESC[?6n(主犯) / ESC[6n / ESC[5n など
         .replace(/\x1b\[[?>=]?[0-9;]*c/g, ''); // DA: ESC[c / ESC[0c / ESC[>c / ESC[=c
 }
-/**
- * ローカルLLMタブで注入する環境変数を返す。Claude Code は tsunagi の中継口に接続し、
- * 中継口が使用中のモデルへ転送する。最初の発言を待たせないよう、読み込みはここで始めておく（完了は待たない）
- */
-async function prepareLocalLlm() {
-    const { active, extraEnv } = await getLocalLlmSettings();
-    if (!active) {
-        throw new Error('ローカルLLMのモデルが未設定です。Settings で使用するモデルを選んでください');
-    }
-    ensureActiveLoaded().catch(() => undefined);
-    return buildLocalLlmEnv({
-        proxyUrl: LOCAL_LLM_PROXY_URL,
-        contextTokens: active.contextTokens,
-        extraEnv,
-    });
-}
 export async function terminalRoutes(fastify) {
     const io = fastify.io;
+    initPtyEnvSync(io);
     // socket.io イベントハンドラ
     io.on('connection', (socket) => {
         let boundSessionId = null;
@@ -97,6 +68,8 @@ export async function terminalRoutes(fastify) {
             socket.removeAllListeners('resize');
             socket.removeAllListeners('input');
             socket.join(room);
+            // 環境変数の変更が未反映ならクライアントに伝える（反映待ちバッジ）
+            socket.emit('env-pending', { sessionId, pending: getEnvPending(sessionId) });
             // 接続確立 → GCタイマーをキャンセル
             ptyManager.cancelGc(sessionId);
             // この socket を PTY の所有者(active socket)にする。input の書き込みは所有者の
@@ -133,6 +106,10 @@ export async function terminalRoutes(fastify) {
             dataHandlerDispose = () => dataHandler.dispose();
             // PTYプロセス終了 → room全体に通知（全接続クライアントに終了を伝える）+ セッション削除
             const exitHandler = ptyProcess.onExit(({ exitCode }) => {
+                // 環境変数の反映のための作り直し（pty-env-sync）。新しい PTY が同じ sessionId で
+                // 既に動いているため、終了扱い・セッション削除はしない
+                if (session.respawning)
+                    return;
                 io.to(room).emit('exit', { exitCode });
                 // Ctrl+C等でClaudeが強制終了した場合にclaudeStatusをidleにリセット
                 // todos は残す（Claude 側の Task はセッションに永続化され、--resume 後も続きから使われる）
@@ -171,6 +148,7 @@ export async function terminalRoutes(fastify) {
                     return;
                 if (ptyManager.getActiveSocket(sessionId) !== socket.id)
                     return;
+                session.lastInputAt = Date.now();
                 ptyProcess.write(data);
             });
         });
@@ -204,8 +182,7 @@ export async function terminalRoutes(fastify) {
     });
     // POST /terminal/sessions - セッション作成（または既存セッション再利用）
     fastify.post('/terminal/sessions', async (request, reply) => {
-        const { cwd, env, sessionId: requestedSessionId, claude } = request.body ?? {};
-        let { command } = request.body ?? {};
+        const { cwd, env, sessionId: requestedSessionId, claude, command } = request.body ?? {};
         const sessionId = requestedSessionId ?? crypto.randomUUID();
         // 既存セッションが生きていれば再利用
         const existing = ptyManager.getSession(sessionId);
@@ -213,95 +190,22 @@ export async function terminalRoutes(fastify) {
             fastify.log.info({ sessionId }, 'Reusing existing PTY session');
             return reply.status(200).send({ sessionId, reused: true });
         }
-        // sessionId(=tab_id) から Task を解決する。cwd / env の決定に使う。
-        // Taskに紐づかないタブは Tab レコードが存在しないため null になる。
-        const tab = await prisma.tab
-            .findUnique({ where: { tabId: sessionId }, include: { task: true } })
-            .catch((err) => {
-            fastify.log.warn({ err, sessionId }, 'Failed to load tab');
-            return null;
-        });
-        // cwd は Task があればサーバー側で worktree パスを導出する（クライアントの state に依存しない）。
-        // クライアント指定の cwd は Task に紐づかないタブのフォールバックとしてのみ使う。
-        const defaultDir = path.join(os.homedir(), '.tsunagi', 'workspaces');
-        let workingDir = tab
-            ? getWorktreePath(tab.task.owner, tab.task.repo, tab.task.branch)
-            : (cwd ?? defaultDir);
-        // cwd が存在するか確認。Task のタブは worktree 必須（無ければ起動しない）、
-        // それ以外はデフォルトにフォールバック
+        const launchRequest = { cwd, env };
         try {
-            await fs.access(workingDir);
-        }
-        catch {
-            if (tab) {
-                fastify.log.warn({ sessionId, workingDir }, 'worktree does not exist');
-                return reply.status(409).send({ error: `Worktree not found at ${workingDir}` });
-            }
-            fastify.log.warn({ sessionId, workingDir }, 'cwd does not exist, falling back to default');
-            workingDir = defaultDir;
-        }
-        // デフォルトディレクトリが存在しない場合も作成する
-        await fs.mkdir(workingDir, { recursive: true });
-        try {
-            // repo スコープまで階層マージした環境変数を取得する（global → owner → repo、後勝ちで上書き）。
-            // Taskに紐づかないタブは global のみになる。
-            let dbEnv = {};
-            const tabMode = tab?.mode;
-            try {
-                dbEnv = tab ? await getEnv('repo', tab.task.owner, tab.task.repo) : await getEnv('global');
-                fastify.log.info({ count: Object.keys(dbEnv).length, owner: tab?.task.owner, repo: tab?.task.repo }, 'Loaded env vars');
-            }
-            catch (err) {
-                fastify.log.warn({ err }, 'Failed to load env vars');
-            }
-            // ローカルLLMタブ: Anthropic の代わりに tsunagi の中継口（→ Ollama / LM Studio）で claude を動かす。
-            // DB の環境変数より後に適用し、Anthropic の認証トークンは環境変数ごと取り除く。
-            let providerEnv = {};
-            let unsetKeys = [];
-            if (isLocalLlmMode(tabMode)) {
-                try {
-                    providerEnv = await prepareLocalLlm();
-                }
-                catch (err) {
-                    return reply
-                        .status(400)
-                        .send({ error: err instanceof Error ? err.message : String(err) });
-                }
-                unsetKeys = LOCAL_LLM_UNSET_ENV_KEYS;
-            }
-            if (claude) {
-                command = await buildClaudeCommand(sessionId, (tabMode ?? 'claude'));
-            }
-            // 優先順位: リクエストで渡されたenv > ローカルLLMのprovider env > DB env(global/owner/repo) > tsunagi独自のEDITOR設定
-            // tsunagi-editor.sh をデフォルトにすることで Ctrl+G が Monaco Modal を開く。
-            // DB / リクエストで EDITOR が明示設定されている場合はそちらが優先される。
-            const tsunagiDefaultEnv = {
-                EDITOR: TSUNAGI_EDITOR_PATH,
-                TSUNAGI_SESSION_ID: sessionId,
-                // monaco-editor.sh が API(Fastify) を叩くためのベース URL。サーバーと同一
-                // ホストなので localhost。単一ポート化で API は SERVER_PORT(既定 2791)。
-                TSUNAGI_API_BASE: `http://localhost:${SERVER_PORT}`,
-            };
-            const mergedEnv = { ...tsunagiDefaultEnv, ...dbEnv, ...providerEnv, ...env };
-            const session = ptyManager.createSession(sessionId, workingDir, mergedEnv, unsetKeys);
-            // コマンドが指定されていればPTY起動後にシェルへ書き込む
-            if (command) {
-                const cmd = command.endsWith('\n') ? command : command + '\n';
-                // claude logout で ~/.claude.json の hasCompletedOnboarding がリセットされて
-                // いると、次回 claude 起動時にオンボーディングウィザードが表示され --resume/
-                // --session-id を前提にした自動起動フローが止まるため、起動前に補正する。
-                await ensureClaudeOnboardingCompleted();
-                // 監視の取りこぼしに備え、起動前にも中継口の名前が既定モデルに残っていないか補正する
-                await removeLocalModelFromUserSettings(LOCAL_MODEL_ALIAS);
-                // シェルの初期化（プロンプト表示）を待つため少し遅延させて書き込む
-                setTimeout(() => {
-                    session.pty.write(cmd);
-                }, 300);
-            }
+            const launch = await resolvePtyLaunch(sessionId, launchRequest);
+            await startPtySession(sessionId, launch, {
+                request: launchRequest,
+                launchClaude: Boolean(claude),
+                command,
+            });
             return reply.status(201).send({ sessionId, reused: false });
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
+            if (err instanceof PtyLaunchError) {
+                fastify.log.warn({ sessionId, err: message }, 'Failed to launch PTY');
+                return reply.status(err.statusCode).send({ error: message });
+            }
             return reply.status(500).send({ error: message });
         }
     });
@@ -326,9 +230,19 @@ export async function terminalRoutes(fastify) {
         catch (err) {
             return reply.status(400).send({ error: err instanceof Error ? err.message : String(err) });
         }
+        // 環境変数の反映で PTY を作り直したときも claude を起動し直す
+        session.options.launchClaude = true;
+        await prepareClaudeConfigForSession(session);
         session.pty.write(`${command}\n`);
         return reply.status(204).send();
     });
+    // POST /terminal/sessions/:sessionId/respawn - 環境変数の変更を今すぐ反映する（PTY を作り直す）
+    fastify.post('/terminal/sessions/:sessionId/respawn', async (request, reply) => {
+        const ok = await respawnSessionNow(request.params.sessionId);
+        if (!ok)
+            return reply.status(404).send({ error: 'Session not found' });
+        return reply.status(204).send();
+    });
     // DELETE /terminal/sessions/:sessionId - セッション明示削除（PTY kill）
     fastify.delete('/terminal/sessions/:sessionId', async (request, reply) => {
         const { sessionId } = request.params;

package/dist/server/routes/version.js

@@ -1,3 +1,5 @@
+import { findRestartBlockers, getAutoUpdateStatus } from '../lib/auto-update.js';
+import { requestRestart } from '../lib/restart.js';
 import { checkForUpdateNow, getUpdateStatus } from '../lib/update-check.js';
 export async function versionRoutes(fastify) {
     // GET /version - 実行中のバージョンと npm の最新バージョン
@@ -15,4 +17,18 @@ export async function versionRoutes(fastify) {
         }
         return reply.status(200).send({ data: getUpdateStatus() });
     });
+    // POST /version/restart - インストール済みの新しいバージョンを再起動で適用する。
+    // 実行中（running / waiting）のタスクがあれば止まってしまうため 409 で拒否する
+    fastify.post('/version/restart', async (_request, reply) => {
+        if (getAutoUpdateStatus().state !== 'ready') {
+            return reply.status(400).send({ error: 'No update is ready to apply' });
+        }
+        const blockers = await findRestartBlockers();
+        if (blockers.length > 0) {
+            return reply.status(409).send({ error: 'Tasks are running', data: { blockers } });
+        }
+        // 応答を返してから終了処理に入る
+        reply.raw.once('finish', requestRestart);
+        return reply.status(202).send({ data: getUpdateStatus() });
+    });
 }

package/dist/single-instance-lock.js

@@ -7,7 +7,8 @@ import * as path from 'node:path';
  * - Writes current PID to `~/.tsunagi/state/tsunagi.lock` on acquire
  * - On startup, if lock file exists and its PID is alive, exits with error
  * - Stale locks (PID not alive) are removed automatically
- * - Lock is released on SIGINT / SIGTERM / exit
+ * - Lock is released on process exit. Signal handling is left to the caller
+ *   (the entry waits for the app to stop before exiting)
  */
 function getTsunagiDataDir() {
     return process.env.TSUNAGI_DATA_DIR || path.join(os.homedir(), '.tsunagi');
@@ -79,20 +80,5 @@ export function acquireSingleInstanceLock() {
         }
     }
     fs.writeFileSync(lockFilePath, String(process.pid), 'utf-8');
-    process.on('SIGINT', () => {
-        releaseLock();
-        process.exit(0);
-    });
-    process.on('SIGTERM', () => {
-        releaseLock();
-        process.exit(0);
-    });
-    process.on('exit', () => {
-        releaseLock();
-    });
-    process.on('uncaughtException', (err) => {
-        console.error('[tsunagi] Uncaught exception:', err);
-        releaseLock();
-        process.exit(1);
-    });
+    process.on('exit', releaseLock);
 }

package/dist/update-lifecycle.d.ts

@@ -0,0 +1,19 @@
+/**
+ * entry が古く、再インストールで更新してほしいか。
+ * 古い entry でも取り決めの範囲内で自動更新は続ける（versions.ts 参照）。
+ */
+export declare function isEntryOutdated(): boolean;
+/** entry が npm でインストールされたパッケージから起動しており、自動更新を使うか */
+export declare function isAutoUpdateEnabled(): boolean;
+/**
+ * 前回正常に起動した版と違う版（初めて起動する版）なら、マイグレーション前に DB を退避する。
+ * 起動に失敗すると entry がこの退避を戻して前の版で起動し直す。
+ */
+export declare function snapshotDbBeforeFirstStart(version: string): void;
+/** 前の版が使っていたポートが空くまで待つ（上限付き） */
+export declare function waitForPortsFree(ports: number[], timeoutMs?: number): Promise<void>;
+/**
+ * 起動完了後、実行中より古いバージョンを消す（インストール済み・途中とも）。
+ * 実行中より新しいものはインストール中・再起動待ちの可能性があるため残す。
+ */
+export declare function removeVersionsOlderThan(version: string): void;

package/dist/update-lifecycle.js

@@ -0,0 +1,93 @@
+import * as fs from 'node:fs';
+import * as net from 'node:net';
+import * as path from 'node:path';
+import { ENTRY_PROTOCOL, compareVersions, getTsunagiDataDir, getVersionsDir, parseVersion, updateEntryState, } from './versions.js';
+/**
+ * App-side part of the auto-update: everything the entry (cli.ts) leaves to
+ * the app, so that it can change with each version.
+ */
+/** 初めて起動するバージョンが書き換える可能性のあるファイル（データディレクトリからの相対パス） */
+const DB_FILES = ['state/tsunagi.db', 'state/tsunagi.db-wal', 'state/tsunagi.db-shm'];
+const SNAPSHOT_PREFIX = 'pre-update-';
+const SNAPSHOT_RETENTION = 3;
+/** entry から起動されたか。dev 起動（with-plugin.ts）や直接実行では null */
+function getEntryProtocol() {
+    const value = Number(process.env.TSUNAGI_ENTRY_PROTOCOL);
+    return Number.isInteger(value) && value > 0 ? value : null;
+}
+/**
+ * entry が古く、再インストールで更新してほしいか。
+ * 古い entry でも取り決めの範囲内で自動更新は続ける（versions.ts 参照）。
+ */
+export function isEntryOutdated() {
+    const protocol = getEntryProtocol();
+    return protocol !== null && protocol < ENTRY_PROTOCOL;
+}
+/** entry が npm でインストールされたパッケージから起動しており、自動更新を使うか */
+export function isAutoUpdateEnabled() {
+    return getEntryProtocol() !== null && process.env.TSUNAGI_AUTO_UPDATE === '1';
+}
+/**
+ * 前回正常に起動した版と違う版（初めて起動する版）なら、マイグレーション前に DB を退避する。
+ * 起動に失敗すると entry がこの退避を戻して前の版で起動し直す。
+ */
+export function snapshotDbBeforeFirstStart(version) {
+    const lastGood = process.env.TSUNAGI_LAST_GOOD;
+    if (!lastGood || lastGood === version || getEntryProtocol() === null)
+        return;
+    const dataDir = getTsunagiDataDir();
+    const backupsDir = path.join(dataDir, 'backups');
+    const dir = path.join(backupsDir, `${SNAPSHOT_PREFIX}${Date.now()}-v${version}`);
+    const files = {};
+    for (const file of DB_FILES) {
+        const src = path.join(dataDir, file);
+        files[file] = fs.existsSync(src);
+        if (!files[file])
+            continue;
+        fs.mkdirSync(path.dirname(path.join(dir, file)), { recursive: true });
+        fs.copyFileSync(src, path.join(dir, file));
+    }
+    updateEntryState((state) => ({ ...state, snapshot: { version, dir, files } }));
+    const snapshots = fs
+        .readdirSync(backupsDir)
+        .filter((name) => name.startsWith(SNAPSHOT_PREFIX))
+        .sort();
+    while (snapshots.length > SNAPSHOT_RETENTION) {
+        const oldest = snapshots.shift();
+        if (oldest)
+            fs.rmSync(path.join(backupsDir, oldest), { recursive: true, force: true });
+    }
+}
+/** 前の版が使っていたポートが空くまで待つ（上限付き） */
+export async function waitForPortsFree(ports, timeoutMs = 10_000) {
+    const isFree = (port) => new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', () => resolve(false));
+        server.listen(port, '0.0.0.0', () => server.close(() => resolve(true)));
+    });
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        const results = await Promise.all(ports.map(isFree));
+        if (results.every(Boolean))
+            return;
+        await new Promise((resolve) => setTimeout(resolve, 200));
+    }
+}
+/**
+ * 起動完了後、実行中より古いバージョンを消す（インストール済み・途中とも）。
+ * 実行中より新しいものはインストール中・再起動待ちの可能性があるため残す。
+ */
+export function removeVersionsOlderThan(version) {
+    let entries;
+    try {
+        entries = fs.readdirSync(getVersionsDir());
+    }
+    catch {
+        return;
+    }
+    for (const name of entries) {
+        if (!parseVersion(name) || compareVersions(name, version) >= 0)
+            continue;
+        fs.rmSync(path.join(getVersionsDir(), name), { recursive: true, force: true });
+    }
+}