runcastle 1.2.2 → 1.2.4

package/bin/runcastle.js

@@ -26,6 +26,7 @@ __export(exports_paths, {
   projectWorktreesDir: () => projectWorktreesDir,
   prodDataDir: () => prodDataDir,
   logsDir: () => logsDir,
+  installIdPath: () => installIdPath,
   featureDocsRel: () => featureDocsRel,
   envPath: () => envPath,
   devDataDir: () => devDataDir,
@@ -64,6 +65,9 @@ function configPath() {
 function envPath() {
   return join(dataDir(), ".env");
 }
+function installIdPath() {
+  return join(dataDir(), "install-id");
+}
 function logsDir() {
   return join(dataDir(), "logs");
 }
@@ -246,7 +250,7 @@ var init_ids = () => {};
 
 // ../core/src/schemas.ts
 import * as z2 from "zod";
-var Phase, TicketStatus, SessionKind, RunStatus, FeatureStatus, SessionStatus, TicketInput, Ticket, WaypointType, WaypointStatus, WaypointDisposition, WaypointInput, Waypoint, TestNoteStatus, TestNote, PREPARED_KEYS, PreparedKey, DRIVE_LOOP_KEYS, FindingSource, PROJECT_NAME_MAX = 80, ProjectName, Project, ProjectFinding, Feature, SessionRow, Run, SettingSource, SettingScope, SettingField, SettingsView, SettingsUpdateInput, EventRow;
+var Phase, TicketStatus, SessionKind, SessionPurpose, MergeBranchPair, RunStatus, FeatureStatus, SessionStatus, TicketInput, Ticket, WaypointType, WaypointStatus, WaypointDisposition, WaypointInput, Waypoint, TestNoteStatus, TestNote, PREPARED_KEYS, PreparedKey, DRIVE_LOOP_KEYS, FindingSource, PROJECT_NAME_MAX = 80, ProjectName, Project, ProjectFinding, Feature, SessionRow, Run, SettingSource, SettingScope, SettingField, SettingsView, SettingsUpdateInput, EventRow;
 var init_schemas = __esm(() => {
   Phase = z2.enum([
     "ideation",
@@ -266,6 +270,11 @@ var init_schemas = __esm(() => {
     "prepare",
     "project"
   ]);
+  SessionPurpose = z2.enum(["resolve-conflict"]);
+  MergeBranchPair = z2.object({
+    mergeFrom: z2.string(),
+    mergeInto: z2.string()
+  });
   RunStatus = z2.enum(["running", "succeeded", "failed", "cancelled"]);
   FeatureStatus = z2.enum(["active", "shipped", "archived"]);
   SessionStatus = z2.enum(["launching", "live", "ended"]);
@@ -382,6 +391,8 @@ var init_schemas = __esm(() => {
     featureId: z2.string().optional(),
     projectId: z2.string().optional(),
     kind: SessionKind,
+    purpose: SessionPurpose.optional(),
+    purposeData: MergeBranchPair.optional(),
     ccSessionId: z2.string().optional(),
     transcriptPath: z2.string().optional(),
     status: SessionStatus,
@@ -620,6 +631,8 @@ var init_db_schema = __esm(() => {
     projectId: text("project_id"),
     lap: integer("lap").notNull().default(1),
     kind: text("kind").notNull().$type(),
+    purpose: text("purpose").$type(),
+    purposeData: text("purpose_data", { mode: "json" }).$type(),
     ccSessionId: text("cc_session_id"),
     transcriptPath: text("transcript_path"),
     status: text("status").notNull().$type(),
@@ -914,6 +927,23 @@ var init_resolve_executable = __esm(() => {
   };
 });
 
+// src/pty/kill-tree.ts
+import { execFile } from "child_process";
+import { promisify } from "util";
+async function killProcessTree(pid) {
+  try {
+    if (process.platform === "win32") {
+      await execFileAsync("taskkill", ["/pid", String(pid), "/T", "/F"], { windowsHide: true });
+    } else {
+      process.kill(-pid, "SIGTERM");
+    }
+  } catch {}
+}
+var execFileAsync;
+var init_kill_tree = __esm(() => {
+  execFileAsync = promisify(execFile);
+});
+
 // src/pty/pty-sidecar.ts
 import { spawn } from "child_process";
 import { createRequire } from "module";
@@ -1095,6 +1125,9 @@ ${why.replace(/\n/g, `\r
         }
       }, 500);
     },
+    killTree() {
+      return killProcessTree(process.platform === "win32" ? child.pid ?? pid : pid);
+    },
     get pid() {
       return pid;
     },
@@ -1107,6 +1140,7 @@ var HOST_PATH;
 var init_pty_sidecar = __esm(() => {
   init_asset_paths();
   init_resolve_executable();
+  init_kill_tree();
   HOST_PATH = resolveAsset(ASSET_ENV.ptyHost, fileURLToPath(new URL("./pty-host.cjs", import.meta.url)));
 });
 
@@ -1193,6 +1227,9 @@ function createNativePtySession(cmd, args, opts) {
         proc.kill();
       } catch {}
     },
+    killTree() {
+      return killProcessTree(proc.pid);
+    },
     get pid() {
       return proc.pid;
     },
@@ -1204,6 +1241,7 @@ function createNativePtySession(cmd, args, opts) {
 var cached = null, BACKEND_LOGGED;
 var init_pty = __esm(() => {
   init_resolve_executable();
+  init_kill_tree();
   init_pty_sidecar();
   BACKEND_LOGGED = Symbol.for("runcastle.pty.backend.logged");
 });
@@ -1541,6 +1579,8 @@ function rowToSession(row) {
     featureId: row.featureId ?? undefined,
     projectId: row.projectId ?? undefined,
     kind: row.kind,
+    purpose: row.purpose ?? undefined,
+    purposeData: row.purposeData ?? undefined,
     ccSessionId: row.ccSessionId ?? undefined,
     transcriptPath: row.transcriptPath ?? undefined,
     status: row.status,
@@ -1796,7 +1836,6 @@ var init_waypoints = __esm(() => {
 });
 
 // src/pty/dev-pane.ts
-import { execFileSync } from "child_process";
 function drivePaneId(ownerId) {
   return `${DRIVE_PREFIX}${ownerId}`;
 }
@@ -1856,24 +1895,24 @@ function devPaneLive(paneId) {
   const entry = ptyRegistry().get(paneId);
   return !!entry && !entry.exited;
 }
-function killProcessTree(pid) {
-  try {
-    if (process.platform === "win32") {
-      execFileSync("taskkill", ["/pid", String(pid), "/T", "/F"], { stdio: "ignore" });
-    } else {
-      process.kill(-pid, "SIGTERM");
-    }
-  } catch {}
+function killTreeBounded(pty) {
+  return new Promise((resolve4) => {
+    const timer = setTimeout(resolve4, KILL_TREE_TIMEOUT_MS);
+    pty.killTree().catch(() => {}).then(() => {
+      clearTimeout(timer);
+      resolve4();
+    });
+  });
 }
-function stopDevPane(paneId) {
+async function stopDevPane(paneId) {
   const reg = ptyRegistry();
   const entry = reg.get(paneId);
   if (entry && !entry.exited)
-    killProcessTree(entry.pty.pid);
+    await killTreeBounded(entry.pty);
   reg.kill(paneId);
   reg.remove(paneId);
 }
-var DRIVE_PREFIX = "drive:", SNIFF_WINDOW = 8192;
+var DRIVE_PREFIX = "drive:", SNIFF_WINDOW = 8192, KILL_TREE_TIMEOUT_MS = 5000;
 var init_dev_pane = __esm(() => {
   init_events();
   init_registry();
@@ -2802,7 +2841,7 @@ async function testDrive(ctx, project, feature, action) {
     const detachedWorktree2 = testDriveState.detachedWorktree;
     const devPaneId = testDriveState.devPaneId;
     if (devPaneId)
-      stopDevPane(devPaneId);
+      await stopDevPane(devPaneId);
     const teardown = await runDriveHookStep(ctx, scope, project.repoPath, "teardown", project.driveStopCommand, driveEnvFor(ctx, project, { slug: feature.slug, branch }, scope).env);
     const carriedChanges = await dirtyPaths(g);
     await g.checkout(previousBranch2);
@@ -2942,7 +2981,7 @@ async function startDryRun(ctx, project) {
 async function stopDryRun(ctx, project, state) {
   const scope = { projectId: project.id };
   if (state.devPaneId)
-    stopDevPane(state.devPaneId);
+    await stopDevPane(state.devPaneId);
   const teardown = await runDriveHookStep(ctx, scope, project.repoPath, "teardown", project.driveStopCommand, state.env);
   state.observed.teardownOk = teardown?.result.ok;
   testDriveState = undefined;
@@ -3157,10 +3196,24 @@ async function conflictedFiles(g) {
     return [];
   }
 }
+async function mergeInProgressAt(worktreePath) {
+  try {
+    return await mergeInProgress(git(worktreePath));
+  } catch {
+    return false;
+  }
+}
+async function isAncestor(repoPath, ancestor, descendant) {
+  try {
+    const out = await git(repoPath).raw(["rev-list", "--count", ancestor, `^${descendant}`]);
+    return out.trim() === "0";
+  } catch {
+    return false;
+  }
+}
 async function mergeInProgress(g) {
   try {
-    await g.raw(["rev-parse", "--verify", "--quiet", "MERGE_HEAD"]);
-    return true;
+    return (await g.raw(["rev-parse", "--verify", "--quiet", "MERGE_HEAD"])).trim() !== "";
   } catch {
     return false;
   }
@@ -3190,6 +3243,8 @@ function createSessionRow(ctx, input) {
     projectId: input.projectId ?? null,
     lap: input.featureId ? getFeatureRow(ctx, input.featureId).lap : 1,
     kind: input.kind,
+    purpose: input.purpose ?? null,
+    purposeData: input.purposeData ?? null,
     ccSessionId: null,
     transcriptPath: null,
     status: "launching",
@@ -3437,7 +3492,7 @@ function landProjectSession(ctx, session) {
       data: { sessionId: session.id, branch: PROJECT_BRANCH, ...data }
     });
   };
-  landProjectBranch(project).then((res) => {
+  const landing = landProjectBranch(project).then((res) => {
     if (!res)
       return;
     if (res.landed) {
@@ -3450,6 +3505,8 @@ function landProjectSession(ctx, session) {
   }).catch((e) => {
     report("project.land_failed", `could not land the project session's work onto ${project.mainBranch}: ${e instanceof Error ? e.message : String(e)} \u2014 ${kept}`, { error: e instanceof Error ? e.message : String(e) });
   });
+  inFlightLandings.add(landing);
+  landing.finally(() => inFlightLandings.delete(landing));
 }
 function markSessionEnded(ctx, id) {
   const existing = getSessionRow(ctx, id);
@@ -3478,7 +3535,7 @@ function mostRecentLiveSession(ctx) {
   const row = ctx.db.select().from(sessions).where(eq5(sessions.status, "live")).orderBy(desc3(sql2`rowid`)).limit(1).get();
   return row ? rowToSession(row) : null;
 }
-var KICKOFF_DELAY_MS = 1500, KICKOFF_SUBMIT_DELAY_MS = 350, KICKOFF_CONFIRM_MS = 12000, KICKOFF_MAX_ATTEMPTS = 3, CLEAR_INPUT = "\x15", SESSION_READY_TIMEOUT_MS = 25000, CONVERGE_KICKOFF_LINE, KICKOFF_LINES, RESUME_KICKOFF_PREFIX, pendingKickoffOverrides, deliveries, MATCH_PREFIX = 40, landedProjectSessions;
+var KICKOFF_DELAY_MS = 1500, KICKOFF_SUBMIT_DELAY_MS = 350, KICKOFF_CONFIRM_MS = 12000, KICKOFF_MAX_ATTEMPTS = 3, CLEAR_INPUT = "\x15", SESSION_READY_TIMEOUT_MS = 25000, CONVERGE_KICKOFF_LINE, KICKOFF_LINES, RESUME_KICKOFF_PREFIX, pendingKickoffOverrides, deliveries, MATCH_PREFIX = 40, landedProjectSessions, inFlightLandings;
 var init_sessions = __esm(() => {
   init_src();
   init_schema();
@@ -3501,6 +3558,7 @@ var init_sessions = __esm(() => {
   pendingKickoffOverrides = new Map;
   deliveries = new Map;
   landedProjectSessions = new Set;
+  inFlightLandings = new Set;
 });
 
 // src/launcher/reconcile.ts
@@ -6631,6 +6689,8 @@ function guardsEdits(kind) {
 function evaluateEditGuard(input) {
   if (!guardsEdits(input.kind))
     return null;
+  if (input.purpose === "resolve-conflict" && input.mergeInProgress)
+    return null;
   if (!input.toolName || !EDIT_TOOLS.includes(input.toolName))
     return null;
   if (!input.filePath)
@@ -6807,22 +6867,40 @@ function handleUserPrompt(ctx, sessionId, feature, payload) {
     }
   };
 }
-function handleSessionEnd(ctx, sessionId, feature) {
-  markSessionEnded(ctx, sessionId);
-  releaseForSession(ctx, sessionId);
+async function handleSessionEnd(ctx, session, feature) {
+  markSessionEnded(ctx, session.id);
+  releaseForSession(ctx, session.id);
   emit(ctx, feature.id, {
     type: "session.ended",
     message: "session ended",
-    data: { sessionId }
+    data: { sessionId: session.id }
   });
+  await noteResolvedMerge(ctx, session, feature);
   return {};
 }
-function handlePreToolUse(session, feature, payload) {
+async function noteResolvedMerge(ctx, session, feature) {
+  const pair = session.purpose === "resolve-conflict" ? session.purposeData : undefined;
+  if (!pair)
+    return;
+  try {
+    if (!await isAncestor(session.worktreePath, pair.mergeFrom, pair.mergeInto))
+      return;
+    emit(ctx, feature.id, {
+      type: "merge.resolved",
+      message: `merge conflict resolved \u2014 ${pair.mergeFrom} is in ${pair.mergeInto}`,
+      data: { sessionId: session.id, ...pair }
+    });
+  } catch {}
+}
+async function handlePreToolUse(session, feature, payload) {
   const toolName = typeof payload?.tool_name === "string" ? payload.tool_name : undefined;
   const toolInput = payload?.tool_input ?? {};
   const path = typeof toolInput.file_path === "string" ? toolInput.file_path : typeof toolInput.notebook_path === "string" ? toolInput.notebook_path : undefined;
+  const mergeInProgress2 = session.purpose === "resolve-conflict" ? await mergeInProgressAt(session.worktreePath) : false;
   const denial = evaluateEditGuard({
     kind: session.kind,
+    purpose: session.purpose,
+    mergeInProgress: mergeInProgress2,
     worktreePath: session.worktreePath,
     toolName,
     filePath: path,
@@ -6851,6 +6929,7 @@ var init_hooks = __esm(() => {
   init_edit_guard();
   init_sessions();
   init_events();
+  init_git();
   init_prep();
   init_repo();
   init_tickets();
@@ -6888,7 +6967,7 @@ var init_hooks = __esm(() => {
           case "session-end":
             return c.json(handleProjectScopedSessionEnd(ctx, session));
           case "pre-tool":
-            return c.json(handlePreToolUse(session, undefined, body.payload));
+            return c.json(await handlePreToolUse(session, undefined, body.payload));
           default:
             return c.json({});
         }
@@ -6902,9 +6981,9 @@ var init_hooks = __esm(() => {
         case "user-prompt":
           return c.json(handleUserPrompt(ctx, sessionId, feature, body.payload));
         case "session-end":
-          return c.json(handleSessionEnd(ctx, sessionId, feature));
+          return c.json(await handleSessionEnd(ctx, session, feature));
         case "pre-tool":
-          return c.json(handlePreToolUse(session, feature, body.payload));
+          return c.json(await handlePreToolUse(session, feature, body.payload));
         default:
           return c.json({});
       }
@@ -7046,6 +7125,166 @@ var init_web = __esm(() => {
   };
 });
 
+// src/version.ts
+import { readFileSync as readFileSync6 } from "fs";
+import { dirname as dirname5, join as join12 } from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
+function runcastleVersion() {
+  if (cached2)
+    return cached2;
+  const here = dirname5(fileURLToPath4(import.meta.url));
+  for (const pkgPath of [join12(here, "..", "package.json"), join12(here, "package.json")]) {
+    try {
+      const pkg = JSON.parse(readFileSync6(pkgPath, "utf8"));
+      if (typeof pkg.version === "string") {
+        cached2 = pkg.version;
+        return cached2;
+      }
+    } catch {}
+  }
+  cached2 = UNKNOWN_VERSION;
+  return cached2;
+}
+var cached2, UNKNOWN_VERSION = "0.0.0";
+var init_version = () => {};
+
+// src/services/install-id.ts
+import { randomUUID } from "crypto";
+import { existsSync as existsSync13, mkdirSync as mkdirSync6, readFileSync as readFileSync7, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname6 } from "path";
+function getInstallId() {
+  const file = installIdPath();
+  try {
+    if (existsSync13(file)) {
+      const existing = readFileSync7(file, "utf8").trim();
+      if (UUID_RE.test(existing))
+        return existing;
+    }
+    const id = randomUUID();
+    mkdirSync6(dirname6(file), { recursive: true });
+    writeFileSync2(file, `${id}
+`);
+    return id;
+  } catch {
+    return randomUUID();
+  }
+}
+var UUID_RE;
+var init_install_id = __esm(() => {
+  init_paths();
+  UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+});
+
+// src/services/update-check.ts
+function parse(version) {
+  const cleaned = version.trim().replace(/^v/, "");
+  const [core = "", pre = ""] = cleaned.split("-", 2);
+  const release2 = core.split(".").map((n) => Number.parseInt(n, 10) || 0);
+  return { release: release2, pre: pre ? pre.split(".") : [] };
+}
+function compareSemver(a, b) {
+  const pa = parse(a);
+  const pb = parse(b);
+  const len = Math.max(pa.release.length, pb.release.length);
+  for (let i = 0;i < len; i++) {
+    const diff = (pa.release[i] ?? 0) - (pb.release[i] ?? 0);
+    if (diff !== 0)
+      return diff;
+  }
+  if (pa.pre.length === 0 && pb.pre.length === 0)
+    return 0;
+  if (pa.pre.length === 0)
+    return 1;
+  if (pb.pre.length === 0)
+    return -1;
+  const preLen = Math.max(pa.pre.length, pb.pre.length);
+  for (let i = 0;i < preLen; i++) {
+    const x = pa.pre[i];
+    const y = pb.pre[i];
+    if (x === undefined)
+      return -1;
+    if (y === undefined)
+      return 1;
+    const nx = Number(x);
+    const ny = Number(y);
+    const bothNumeric = !Number.isNaN(nx) && !Number.isNaN(ny);
+    const cmp = bothNumeric ? nx - ny : x < y ? -1 : x > y ? 1 : 0;
+    if (cmp !== 0)
+      return cmp;
+  }
+  return 0;
+}
+function doNotTrack(env) {
+  const raw = env.DO_NOT_TRACK;
+  return raw !== undefined && raw !== "" && raw !== "0";
+}
+async function latestFromNpm(fetchImpl) {
+  try {
+    const res = await fetchImpl(NPM_LATEST_URL);
+    if (!res.ok)
+      return null;
+    const body = await res.json();
+    return typeof body.version === "string" ? body.version : null;
+  } catch {
+    return null;
+  }
+}
+async function latestFromPing(fetchImpl, current2) {
+  try {
+    const res = await fetchImpl(PING_URL, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({
+        installId: getInstallId(),
+        version: current2,
+        platform: process.platform
+      })
+    });
+    if (!res.ok)
+      return null;
+    const body = await res.json();
+    return typeof body.latest === "string" ? body.latest : null;
+  } catch {
+    return null;
+  }
+}
+async function checkForUpdate(opts) {
+  const { current: current2 } = opts;
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  const env = opts.env ?? process.env;
+  if (current2 === UNKNOWN_VERSION)
+    return NO_UPDATE(current2);
+  const latest = doNotTrack(env) ? await latestFromNpm(fetchImpl) : await latestFromPing(fetchImpl, current2) ?? await latestFromNpm(fetchImpl);
+  if (!latest)
+    return NO_UPDATE(current2);
+  return {
+    current: current2,
+    latest,
+    updateAvailable: compareSemver(latest, current2) > 0,
+    command: UPDATE_COMMAND
+  };
+}
+async function getUpdateInfo(current2, fetchImpl) {
+  if (cache)
+    return cache;
+  const info = await checkForUpdate({ current: current2, fetchImpl });
+  if (info.latest !== null)
+    cache = info;
+  return info;
+}
+var PACKAGE_NAME = "runcastle", UPDATE_COMMAND, PING_URL = "https://ping.runcastle.dev/ping", NPM_LATEST_URL, NO_UPDATE = (current2) => ({
+  current: current2,
+  latest: null,
+  updateAvailable: false,
+  command: UPDATE_COMMAND
+}), cache;
+var init_update_check = __esm(() => {
+  init_version();
+  init_install_id();
+  UPDATE_COMMAND = `bun add -g ${PACKAGE_NAME}@latest`;
+  NPM_LATEST_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+});
+
 // src/trpc/context.ts
 import { initTRPC } from "@trpc/server";
 var t, errorMapping, router, publicProcedure, createCallerFactory;
@@ -7094,11 +7333,11 @@ var init_events2 = __esm(() => {
 });
 
 // src/launcher/artifacts.ts
-import { mkdirSync as mkdirSync6, writeFileSync as writeFileSync2 } from "fs";
-import { fileURLToPath as fileURLToPath4 } from "url";
-import { join as join12 } from "path";
+import { mkdirSync as mkdirSync7, writeFileSync as writeFileSync3 } from "fs";
+import { fileURLToPath as fileURLToPath5 } from "url";
+import { join as join13 } from "path";
 function hookClientPath() {
-  return resolveAsset(ASSET_ENV.hookClient, fileURLToPath4(new URL("./hook-client.ts", import.meta.url)));
+  return resolveAsset(ASSET_ENV.hookClient, fileURLToPath5(new URL("./hook-client.ts", import.meta.url)));
 }
 function serverUrlFor(config2) {
   return `http://localhost:${config2.serverPort}`;
@@ -7520,16 +7759,16 @@ function renderMcpConfig(session, config2) {
 async function writeSessionArtifacts(input) {
   const { session, feature, config: config2, waypoint, prepare, projectBrief, lap } = input;
   const dir = sessionDir(session.id);
-  mkdirSync6(dir, { recursive: true });
-  const systemPromptPath = join12(dir, "system-prompt.md");
-  const settingsPath = join12(dir, "settings.json");
-  const mcpConfigPath = join12(dir, "mcp.json");
+  mkdirSync7(dir, { recursive: true });
+  const systemPromptPath = join13(dir, "system-prompt.md");
+  const settingsPath = join13(dir, "settings.json");
+  const mcpConfigPath = join13(dir, "mcp.json");
   const systemPrompt = feature ? renderSystemPrompt(feature, session.kind, waypoint, lap) : prepare ? renderPreparePrompt(prepare) : projectBrief ? renderProjectPrompt(projectBrief) : (() => {
     throw new Error(`session ${session.id} has no feature and no project-session brief`);
   })();
-  writeFileSync2(systemPromptPath, systemPrompt, "utf8");
-  writeFileSync2(settingsPath, JSON.stringify(renderSettings(hookClientPath(), session.kind), null, 2), "utf8");
-  writeFileSync2(mcpConfigPath, JSON.stringify(renderMcpConfig(session, config2), null, 2), "utf8");
+  writeFileSync3(systemPromptPath, systemPrompt, "utf8");
+  writeFileSync3(settingsPath, JSON.stringify(renderSettings(hookClientPath(), session.kind), null, 2), "utf8");
+  writeFileSync3(mcpConfigPath, JSON.stringify(renderMcpConfig(session, config2), null, 2), "utf8");
   return { systemPromptPath, settingsPath, mcpConfigPath };
 }
 var RUNCASTLE_MCP_ALLOW_RULES, SESSION_BASH_READ_RULES, SESSION_BASH_WRITE_RULES, SESSION_BASH_ALLOW_RULES, SESSION_START_SOURCES;
@@ -7573,9 +7812,9 @@ var init_artifacts = __esm(() => {
 });
 
 // src/launcher/launcher.ts
-import { existsSync as existsSync13 } from "fs";
-import { dirname as dirname5, join as join13, resolve as resolve9 } from "path";
-import { fileURLToPath as fileURLToPath5 } from "url";
+import { existsSync as existsSync14 } from "fs";
+import { dirname as dirname7, join as join14, resolve as resolve9 } from "path";
+import { fileURLToPath as fileURLToPath6 } from "url";
 import { and as and9, eq as eq11 } from "drizzle-orm";
 function ptyExitMessage(exitCode) {
   const label = typeof exitCode === "number" ? String(exitCode) : "unknown";
@@ -7607,23 +7846,23 @@ function resolveClaudeExecutable() {
 function claudeSpawnTarget(claudeArgs) {
   return spawnTargetFor(resolveClaudeExecutable(), claudeArgs);
 }
-function resolvePluginDir(fromDir = dirname5(fileURLToPath5(import.meta.url))) {
-  const rel = join13("packages", "skills", "packs", "runcastle");
+function resolvePluginDir(fromDir = dirname7(fileURLToPath6(import.meta.url))) {
+  const rel = join14("packages", "skills", "packs", "runcastle");
   const override = process.env[SKILLS_DIR_ENV];
   if (override) {
-    const dir2 = join13(resolve9(override), "packs", "runcastle");
-    if (existsSync13(dir2))
+    const dir2 = join14(resolve9(override), "packs", "runcastle");
+    if (existsSync14(dir2))
       return dir2;
     throw new Error(`${SKILLS_DIR_ENV}=${override} has no plugin dir at ${dir2}`);
   }
   const searched = [];
   let dir = fromDir;
   for (let i = 0;i < 8; i += 1) {
-    const candidate = join13(dir, rel);
+    const candidate = join14(dir, rel);
     searched.push(candidate);
-    if (existsSync13(candidate))
+    if (existsSync14(candidate))
       return candidate;
-    const parent = dirname5(dir);
+    const parent = dirname7(dir);
     if (parent === dir)
       break;
     dir = parent;
@@ -7692,6 +7931,8 @@ async function launchSession(ctx, input, opts = {}) {
   const session = createSessionRow(ctx, {
     featureId: feature.id,
     kind: input.kind,
+    purpose: input.purpose,
+    purposeData: input.purposeData,
     worktreePath
   });
   const plan = planKickoff({ kind: input.kind, lap: feature.lap, kickoffLine: input.kickoffLine });
@@ -8139,7 +8380,9 @@ var init_feature = __esm(() => {
     launchSession: publicProcedure.input(z6.object({
       featureId: z6.string(),
       kind: SessionKind,
-      kickoffLine: z6.string().min(1).optional()
+      kickoffLine: z6.string().min(1).optional(),
+      purpose: SessionPurpose.optional(),
+      purposeData: MergeBranchPair.optional()
     })).mutation(({ ctx, input }) => launchSession(ctx, input)),
     workWaypoint: publicProcedure.input(z6.object({ featureId: z6.string(), waypointId: z6.string(), endLive: z6.boolean().optional() })).mutation(({ ctx, input }) => workWaypoint(ctx, input)),
     converge: publicProcedure.input(z6.object({ featureId: z6.string(), overrideReason: z6.string().min(1).optional() })).mutation(({ ctx, input }) => converge(ctx, { featureId: input.featureId, overrideReason: input.overrideReason })),
@@ -8190,9 +8433,9 @@ var init_feature = __esm(() => {
 });
 
 // src/services/fsbrowse.ts
-import { existsSync as existsSync14, readdirSync as readdirSync5, statSync as statSync2 } from "fs";
+import { existsSync as existsSync15, readdirSync as readdirSync5, statSync as statSync2 } from "fs";
 import { homedir as homedir2 } from "os";
-import { basename, dirname as dirname6, isAbsolute as isAbsolute2, join as join14, resolve as resolve10, sep as sep3 } from "path";
+import { basename, dirname as dirname8, isAbsolute as isAbsolute2, join as join15, resolve as resolve10, sep as sep3 } from "path";
 function expandPath(input, home = homedir2()) {
   const trimmed = input.trim();
   if (trimmed === "")
@@ -8201,12 +8444,12 @@ function expandPath(input, home = homedir2()) {
   if (out === "~")
     out = home;
   else if (out.startsWith("~/") || out.startsWith("~\\"))
-    out = join14(home, out.slice(2));
+    out = join15(home, out.slice(2));
   return resolve10(out);
 }
 function looksLikeRepo(dir) {
   try {
-    return existsSync14(join14(dir, ".git"));
+    return existsSync15(join15(dir, ".git"));
   } catch {
     return false;
   }
@@ -8217,20 +8460,20 @@ function listRoots(home = homedir2()) {
     for (let code = 67;code <= 90; code++) {
       const drive = `${String.fromCharCode(code)}:${sep3}`;
       try {
-        if (existsSync14(drive))
+        if (existsSync15(drive))
           roots.push({ label: drive.replace(/\\$/, ""), path: drive, kind: "drive" });
       } catch {}
     }
   } else {
     roots.push({ label: "/", path: "/", kind: "drive" });
   }
-  if (existsSync14(home))
+  if (existsSync15(home))
     roots.push({ label: "Home", path: home, kind: "home" });
   const seen = new Set(roots.map(pathKey));
   for (const name of COMMON_DIRS) {
-    const candidate = join14(home, name);
+    const candidate = join15(home, name);
     const key = pathKey({ path: candidate });
-    if (seen.has(key) || !existsSync14(candidate))
+    if (seen.has(key) || !existsSync15(candidate))
       continue;
     seen.add(key);
     roots.push({ label: name, path: candidate, kind: "common" });
@@ -8245,7 +8488,7 @@ function crumbsFor(dir) {
   let cur = dir;
   for (;; ) {
     out.unshift({ name: basename(cur) || cur, path: cur });
-    const parent = dirname6(cur);
+    const parent = dirname8(cur);
     if (parent === cur)
       break;
     cur = parent;
@@ -8253,7 +8496,7 @@ function crumbsFor(dir) {
   return out;
 }
 function parentOf(dir) {
-  const parent = dirname6(dir);
+  const parent = dirname8(dir);
   return parent === dir ? null : parent;
 }
 function browseDir(input, showHidden = false, home = homedir2()) {
@@ -8261,13 +8504,13 @@ function browseDir(input, showHidden = false, home = homedir2()) {
   if (!isAbsolute2(target)) {
     throw new InvalidInputError(`path is not absolute: ${target}`);
   }
-  if (!existsSync14(target)) {
+  if (!existsSync15(target)) {
     throw new InvalidInputError(`path does not exist: ${target}`);
   }
   let dir = target;
   try {
     if (!statSync2(target).isDirectory())
-      dir = dirname6(target);
+      dir = dirname8(target);
   } catch (e) {
     throw new InvalidInputError(`cannot read path: ${target} (${errMsg4(e)})`);
   }
@@ -8289,7 +8532,7 @@ function browseDir(input, showHidden = false, home = homedir2()) {
       continue;
     if (!showHidden && name.startsWith("."))
       continue;
-    const path = join14(dir, name);
+    const path = join15(dir, name);
     const isSymlink = dirent.isSymbolicLink();
     if (isSymlink && !showHidden)
       continue;
@@ -8326,8 +8569,8 @@ var init_fsbrowse = __esm(() => {
 });
 
 // src/services/projects.ts
-import { existsSync as existsSync15 } from "fs";
-import { basename as basename2, join as join15 } from "path";
+import { existsSync as existsSync16 } from "fs";
+import { basename as basename2, join as join16 } from "path";
 import { eq as eq12, isNull } from "drizzle-orm";
 function listProjects(ctx) {
   return ctx.db.select().from(projects).where(isNull(projects.closedAt)).all().map(rowToProject);
@@ -8408,7 +8651,7 @@ async function assertRepoTolerant(ctx, repoPath) {
   } catch (e) {
     if (!isNotImplemented(e))
       throw e;
-    if (!existsSync15(join15(repoPath, ".git"))) {
+    if (!existsSync16(join16(repoPath, ".git"))) {
       throw new InvalidInputError(`not a git repository: ${repoPath}`);
     }
   }
@@ -8481,15 +8724,15 @@ var init_run = __esm(() => {
 });
 
 // src/services/settings.ts
-import { existsSync as existsSync16, mkdirSync as mkdirSync7, readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname7 } from "path";
+import { existsSync as existsSync17, mkdirSync as mkdirSync8, readFileSync as readFileSync8, writeFileSync as writeFileSync4 } from "fs";
+import { dirname as dirname9 } from "path";
 import * as z9 from "zod";
 import { eq as eq13 } from "drizzle-orm";
 function readRawConfig(configFile) {
-  if (!existsSync16(configFile))
+  if (!existsSync17(configFile))
     return {};
   try {
-    const parsed = JSON.parse(readFileSync6(configFile, "utf8"));
+    const parsed = JSON.parse(readFileSync8(configFile, "utf8"));
     if (typeof parsed !== "object" || parsed === null)
       return {};
     return foldLegacyModelConfig(parsed);
@@ -8628,8 +8871,8 @@ function updateSettings(ctx, input, io = {}) {
 function writeGlobal(configFile, configKey, value) {
   const raw = readRawConfig(configFile);
   raw[configKey] = value;
-  mkdirSync7(dirname7(configFile), { recursive: true });
-  writeFileSync3(configFile, `${JSON.stringify(raw, null, 2)}
+  mkdirSync8(dirname9(configFile), { recursive: true });
+  writeFileSync4(configFile, `${JSON.stringify(raw, null, 2)}
 `);
 }
 function updateStepModel(ctx, input, configFile, io) {
@@ -8667,8 +8910,8 @@ function writeStepModel(configFile, step, value) {
   else
     stepModels[step] = value;
   raw.stepModels = stepModels;
-  mkdirSync7(dirname7(configFile), { recursive: true });
-  writeFileSync3(configFile, `${JSON.stringify(raw, null, 2)}
+  mkdirSync8(dirname9(configFile), { recursive: true });
+  writeFileSync4(configFile, `${JSON.stringify(raw, null, 2)}
 `);
 }
 function field(view, key) {
@@ -9045,9 +9288,9 @@ var init_system_exec = __esm(() => {
 });
 
 // src/services/setup.ts
-import { copyFileSync, existsSync as existsSync17, mkdirSync as mkdirSync8, readFileSync as readFileSync7, readdirSync as readdirSync6, writeFileSync as writeFileSync4 } from "fs";
-import { dirname as dirname8, join as join16 } from "path";
-import { fileURLToPath as fileURLToPath6 } from "url";
+import { copyFileSync, existsSync as existsSync18, mkdirSync as mkdirSync9, readFileSync as readFileSync9, readdirSync as readdirSync6, writeFileSync as writeFileSync5 } from "fs";
+import { dirname as dirname10, join as join17 } from "path";
+import { fileURLToPath as fileURLToPath7 } from "url";
 async function writeGitIdentity(exec, identity) {
   const name = identity.name.trim();
   const email = identity.email.trim();
@@ -9122,16 +9365,16 @@ async function resolveRuntime(exec, preferred) {
 function resolveSandcastleBin() {
   try {
     const mainUrl = import.meta.resolve("@ai-hero/sandcastle");
-    let dir = dirname8(fileURLToPath6(mainUrl));
+    let dir = dirname10(fileURLToPath7(mainUrl));
     for (let hops = 0;hops < 6; hops++) {
-      const manifestPath = join16(dir, "package.json");
-      if (existsSync17(manifestPath)) {
-        const manifest = JSON.parse(readFileSync7(manifestPath, "utf8"));
+      const manifestPath = join17(dir, "package.json");
+      if (existsSync18(manifestPath)) {
+        const manifest = JSON.parse(readFileSync9(manifestPath, "utf8"));
         if (manifest.name === "@ai-hero/sandcastle" && manifest.bin?.sandcastle) {
-          return join16(dir, manifest.bin.sandcastle);
+          return join17(dir, manifest.bin.sandcastle);
         }
       }
-      const parent = dirname8(dir);
+      const parent = dirname10(dir);
       if (parent === dir)
         break;
       dir = parent;
@@ -9153,21 +9396,21 @@ function terminalSpec(kind, opts) {
   };
 }
 function sandcastleTemplateDir() {
-  return resolveAsset(ASSET_ENV.sandcastleTemplate, fileURLToPath6(new URL("../assets/sandcastle", import.meta.url)));
+  return resolveAsset(ASSET_ENV.sandcastleTemplate, fileURLToPath7(new URL("../assets/sandcastle", import.meta.url)));
 }
 function scaffoldSandcastleConfig(templateDir, targetDir) {
-  const dir = join16(targetDir, ".sandcastle");
-  if (existsSync17(dir))
+  const dir = join17(targetDir, ".sandcastle");
+  if (existsSync18(dir))
     return { scaffolded: false, dir };
-  mkdirSync8(dir, { recursive: true });
+  mkdirSync9(dir, { recursive: true });
   for (const name of readdirSync6(templateDir)) {
-    copyFileSync(join16(templateDir, name), join16(dir, name));
+    copyFileSync(join17(templateDir, name), join17(dir, name));
   }
   return { scaffolded: true, dir };
 }
 function prepareSandboxBuildContext() {
   const target = sandboxBuildDir();
-  mkdirSync8(target, { recursive: true });
+  mkdirSync9(target, { recursive: true });
   scaffoldSandcastleConfig(sandcastleTemplateDir(), target);
   return target;
 }
@@ -9203,10 +9446,10 @@ function createTokenVerifier(exec) {
 function fileAfkTokenIo(exec) {
   const path = envPath();
   return {
-    read: () => existsSync17(path) ? readFileSync7(path, "utf8") : "",
+    read: () => existsSync18(path) ? readFileSync9(path, "utf8") : "",
     write: (content) => {
-      mkdirSync8(dirname8(path), { recursive: true });
-      writeFileSync4(path, content, "utf8");
+      mkdirSync9(dirname10(path), { recursive: true });
+      writeFileSync5(path, content, "utf8");
     },
     verify: createTokenVerifier(exec)
   };
@@ -9259,110 +9502,6 @@ var init_setup2 = __esm(() => {
   });
 });
 
-// src/version.ts
-import { readFileSync as readFileSync8 } from "fs";
-import { dirname as dirname9, join as join17 } from "path";
-import { fileURLToPath as fileURLToPath7 } from "url";
-function runcastleVersion() {
-  if (cached2)
-    return cached2;
-  const here = dirname9(fileURLToPath7(import.meta.url));
-  for (const pkgPath of [join17(here, "..", "package.json"), join17(here, "package.json")]) {
-    try {
-      const pkg = JSON.parse(readFileSync8(pkgPath, "utf8"));
-      if (typeof pkg.version === "string") {
-        cached2 = pkg.version;
-        return cached2;
-      }
-    } catch {}
-  }
-  cached2 = UNKNOWN_VERSION;
-  return cached2;
-}
-var cached2, UNKNOWN_VERSION = "0.0.0";
-var init_version = () => {};
-
-// src/services/update-check.ts
-function parse(version) {
-  const cleaned = version.trim().replace(/^v/, "");
-  const [core = "", pre = ""] = cleaned.split("-", 2);
-  const release2 = core.split(".").map((n) => Number.parseInt(n, 10) || 0);
-  return { release: release2, pre: pre ? pre.split(".") : [] };
-}
-function compareSemver(a, b) {
-  const pa = parse(a);
-  const pb = parse(b);
-  const len = Math.max(pa.release.length, pb.release.length);
-  for (let i = 0;i < len; i++) {
-    const diff = (pa.release[i] ?? 0) - (pb.release[i] ?? 0);
-    if (diff !== 0)
-      return diff;
-  }
-  if (pa.pre.length === 0 && pb.pre.length === 0)
-    return 0;
-  if (pa.pre.length === 0)
-    return 1;
-  if (pb.pre.length === 0)
-    return -1;
-  const preLen = Math.max(pa.pre.length, pb.pre.length);
-  for (let i = 0;i < preLen; i++) {
-    const x = pa.pre[i];
-    const y = pb.pre[i];
-    if (x === undefined)
-      return -1;
-    if (y === undefined)
-      return 1;
-    const nx = Number(x);
-    const ny = Number(y);
-    const bothNumeric = !Number.isNaN(nx) && !Number.isNaN(ny);
-    const cmp = bothNumeric ? nx - ny : x < y ? -1 : x > y ? 1 : 0;
-    if (cmp !== 0)
-      return cmp;
-  }
-  return 0;
-}
-async function checkForUpdate(opts) {
-  const { current: current2 } = opts;
-  const fetchImpl = opts.fetchImpl ?? fetch;
-  if (current2 === UNKNOWN_VERSION)
-    return NO_UPDATE(current2);
-  try {
-    const res = await fetchImpl(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`);
-    if (!res.ok)
-      return NO_UPDATE(current2);
-    const body = await res.json();
-    const latest = typeof body.version === "string" ? body.version : null;
-    if (!latest)
-      return NO_UPDATE(current2);
-    return {
-      current: current2,
-      latest,
-      updateAvailable: compareSemver(latest, current2) > 0,
-      command: UPDATE_COMMAND
-    };
-  } catch {
-    return NO_UPDATE(current2);
-  }
-}
-async function getUpdateInfo(current2, fetchImpl) {
-  if (cache)
-    return cache;
-  const info = await checkForUpdate({ current: current2, fetchImpl });
-  if (info.latest !== null)
-    cache = info;
-  return info;
-}
-var PACKAGE_NAME = "runcastle", UPDATE_COMMAND, NO_UPDATE = (current2) => ({
-  current: current2,
-  latest: null,
-  updateAvailable: false,
-  command: UPDATE_COMMAND
-}), cache;
-var init_update_check = __esm(() => {
-  init_version();
-  UPDATE_COMMAND = `bun add -g ${PACKAGE_NAME}@latest`;
-});
-
 // src/trpc/routers/system.ts
 var systemRouter;
 var init_system = __esm(() => {
@@ -9376,8 +9515,8 @@ var init_system = __esm(() => {
 });
 
 // src/services/test-notes.ts
-import { mkdirSync as mkdirSync9, writeFileSync as writeFileSync5 } from "fs";
-import { dirname as dirname10 } from "path";
+import { mkdirSync as mkdirSync10, writeFileSync as writeFileSync6 } from "fs";
+import { dirname as dirname11 } from "path";
 import { asc as asc4, eq as eq14 } from "drizzle-orm";
 function rowToNote(row) {
   return {
@@ -9522,8 +9661,8 @@ function renderTestNotes(ctx, feature) {
       lines.push(noteLine(ctx, note));
   }
   const path = featureDocPath(projectForFeature(ctx, feature), feature, "test-notes.md");
-  mkdirSync9(dirname10(path), { recursive: true });
-  writeFileSync5(path, `${lines.join(`
+  mkdirSync10(dirname11(path), { recursive: true });
+  writeFileSync6(path, `${lines.join(`
 `)}
 `, "utf8");
 }
@@ -9722,6 +9861,7 @@ async function startServer() {
     websocket: terminalWebSocket
   });
   console.log(`runcastle${process.env.RUNCASTLE_DEV ? " [dev]" : ""} server listening on ` + `http://localhost:${config2.serverPort} \u2014 data dir: ${dataDir()}`);
+  getUpdateInfo(runcastleVersion()).catch(() => {});
   const SHUTDOWN_KEY = Symbol.for("runcastle.shutdown.wired");
   const g = globalThis;
   if (!g[SHUTDOWN_KEY]) {
@@ -9747,7 +9887,9 @@ var init_src2 = __esm(() => {
   init_hooks();
   init_stream();
   init_web();
+  init_update_check();
   init_router();
+  init_version();
   init_reconcile_runs();
 });
 
@@ -9805,7 +9947,7 @@ __export(exports_cli, {
   resolveDoctorEnv: () => resolveDoctorEnv,
   parseMode: () => parseMode
 });
-import { existsSync as existsSync18, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync19, readFileSync as readFileSync10 } from "fs";
 function parseMode(argv) {
   return argv.includes("--gate") || argv.includes("--boot") ? "gate" : "diagnostic";
 }
@@ -9813,8 +9955,8 @@ function envWithToken() {
   const merged = { ...process.env };
   try {
     const path = envPath();
-    if (existsSync18(path)) {
-      const fromFile = parseEnvFile(readFileSync9(path, "utf8")).CLAUDE_CODE_OAUTH_TOKEN;
+    if (existsSync19(path)) {
+      const fromFile = parseEnvFile(readFileSync10(path, "utf8")).CLAUDE_CODE_OAUTH_TOKEN;
       if (fromFile && fromFile.length > 0)
         merged.CLAUDE_CODE_OAUTH_TOKEN = fromFile;
     }
@@ -9856,7 +9998,7 @@ var init_cli = __esm(() => {
 // src/bin/runcastle.ts
 init_asset_paths();
 init_version();
-import { dirname as dirname11, resolve as resolve11 } from "path";
+import { dirname as dirname12, resolve as resolve11 } from "path";
 import { fileURLToPath as fileURLToPath8 } from "url";
 function parseCommand(argv) {
   const [first, ...rest] = argv;
@@ -9881,7 +10023,7 @@ Usage:
   runcastle --help     Show this help
 `;
 async function main(argv) {
-  applyInstalledAssetEnv(resolve11(dirname11(fileURLToPath8(import.meta.url)), ".."));
+  applyInstalledAssetEnv(resolve11(dirname12(fileURLToPath8(import.meta.url)), ".."));
   const { command, args } = parseCommand(argv);
   switch (command) {
     case "version":