runcastle 1.0.18 → 1.0.20

package/bin/runcastle.js

@@ -1516,6 +1516,9 @@ function markSessionLive(ctx, id, input = {}) {
 function kickoffLineFor(kind, override) {
   return override ?? KICKOFF_LINES[kind];
 }
+function resumeKickoffLine(kind) {
+  return RESUME_KICKOFF_PREFIX + KICKOFF_LINES[kind];
+}
 function setKickoffOverride(sessionId, line) {
   pendingKickoffOverrides.set(sessionId, line);
 }
@@ -1564,15 +1567,15 @@ function markSessionEnded(ctx, id) {
   ctx.db.update(sessions).set({ status: "ended" }).where(eq4(sessions.id, id)).run();
   return getSessionRow(ctx, id);
 }
-function mostRecentResumableSession(ctx, featureId) {
-  const row = ctx.db.select().from(sessions).where(and4(eq4(sessions.featureId, featureId), eq4(sessions.status, "ended"), isNotNull(sessions.ccSessionId))).orderBy(desc2(sql2`rowid`)).limit(1).get();
+function mostRecentResumableSession(ctx, featureId, kind) {
+  const row = ctx.db.select().from(sessions).where(and4(eq4(sessions.featureId, featureId), eq4(sessions.status, "ended"), isNotNull(sessions.ccSessionId), ...kind ? [eq4(sessions.kind, kind)] : [])).orderBy(desc2(sql2`rowid`)).limit(1).get();
   return row ? rowToSession(row) : null;
 }
 function mostRecentLiveSession(ctx) {
   const row = ctx.db.select().from(sessions).where(eq4(sessions.status, "live")).orderBy(desc2(sql2`rowid`)).limit(1).get();
   return row ? rowToSession(row) : null;
 }
-var KICKOFF_DELAY_MS = 1500, KICKOFF_SUBMIT_DELAY_MS = 350, CONVERGE_KICKOFF_LINE, KICKOFF_LINES, pendingKickoffOverrides;
+var KICKOFF_DELAY_MS = 1500, KICKOFF_SUBMIT_DELAY_MS = 350, CONVERGE_KICKOFF_LINE, KICKOFF_LINES, RESUME_KICKOFF_PREFIX, pendingKickoffOverrides;
 var init_sessions = __esm(() => {
   init_src();
   init_schema();
@@ -1588,6 +1591,7 @@ var init_sessions = __esm(() => {
     converge: CONVERGE_KICKOFF_LINE,
     revisit: "Proceed with your task: invoke the /runcastle:revisit skill and work through what the " + "human brings up."
   };
+  RESUME_KICKOFF_PREFIX = "We are picking this conversation back up \u2014 runcastle restarted and closed the terminal, " + "but this conversation is intact. Do NOT start over: tell me in one or two lines where we " + "left off and what is next, then carry on. Your original instruction was: ";
   pendingKickoffOverrides = new Map;
 });
 
@@ -5124,8 +5128,6 @@ async function launchSession(ctx, input, opts = {}) {
     kind: input.kind,
     worktreePath
   });
-  if (input.kickoffLine)
-    setKickoffOverride(session.id, input.kickoffLine);
   let waypoint;
   let resumeSessionId;
   let resumeUnavailableFrom;
@@ -5158,11 +5160,24 @@ async function launchSession(ctx, input, opts = {}) {
       resumeUnavailableFrom = "revisit";
     }
   }
+  if (input.kind !== "waypoint" && input.kind !== "revisit") {
+    resumeSessionId = mostRecentResumableSession(ctx, feature.id, input.kind)?.ccSessionId;
+  }
+  const kickoffLine = input.kickoffLine ?? (resumeSessionId ? resumeKickoffLine(input.kind) : undefined);
+  if (kickoffLine)
+    setKickoffOverride(session.id, kickoffLine);
   emit(ctx, feature.id, {
     type: "session.launching",
     message: `launching ${input.kind} session`,
     data: { sessionId: session.id, kind: input.kind, worktreePath, waypointId: waypoint?.id }
   });
+  if (resumeSessionId) {
+    emit(ctx, feature.id, {
+      type: "session.resumed",
+      message: `resuming the previous ${input.kind} conversation`,
+      data: { sessionId: session.id, kind: input.kind, resumeSessionId }
+    });
+  }
   if (input.kind === "revisit" && resumeUnavailableFrom) {
     emit(ctx, feature.id, {
       type: "session.resume_unavailable",
@@ -5431,9 +5446,143 @@ var init_feature = __esm(() => {
   });
 });
 
+// src/services/fsbrowse.ts
+import { existsSync as existsSync14, readdirSync as readdirSync5, statSync as statSync2 } from "fs";
+import { homedir as homedir2 } from "os";
+import { basename, dirname as dirname6, isAbsolute, join as join14, resolve as resolve8, sep as sep3 } from "path";
+function expandPath(input, home = homedir2()) {
+  const trimmed = input.trim();
+  if (trimmed === "")
+    return trimmed;
+  let out = trimmed;
+  if (out === "~")
+    out = home;
+  else if (out.startsWith("~/") || out.startsWith("~\\"))
+    out = join14(home, out.slice(2));
+  return resolve8(out);
+}
+function looksLikeRepo(dir) {
+  try {
+    return existsSync14(join14(dir, ".git"));
+  } catch {
+    return false;
+  }
+}
+function listRoots(home = homedir2()) {
+  const roots = [];
+  if (process.platform === "win32") {
+    for (let code = 67;code <= 90; code++) {
+      const drive = `${String.fromCharCode(code)}:${sep3}`;
+      try {
+        if (existsSync14(drive))
+          roots.push({ label: drive.replace(/\\$/, ""), path: drive, kind: "drive" });
+      } catch {}
+    }
+  } else {
+    roots.push({ label: "/", path: "/", kind: "drive" });
+  }
+  if (existsSync14(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 key = pathKey({ path: candidate });
+    if (seen.has(key) || !existsSync14(candidate))
+      continue;
+    seen.add(key);
+    roots.push({ label: name, path: candidate, kind: "common" });
+  }
+  return roots;
+}
+function pathKey(r) {
+  return process.platform === "win32" ? r.path.toLowerCase() : r.path;
+}
+function crumbsFor(dir) {
+  const out = [];
+  let cur = dir;
+  for (;; ) {
+    out.unshift({ name: basename(cur) || cur, path: cur });
+    const parent = dirname6(cur);
+    if (parent === cur)
+      break;
+    cur = parent;
+  }
+  return out;
+}
+function parentOf(dir) {
+  const parent = dirname6(dir);
+  return parent === dir ? null : parent;
+}
+function browseDir(input, showHidden = false, home = homedir2()) {
+  const target = input && input.trim() !== "" ? expandPath(input, home) : home;
+  if (!isAbsolute(target)) {
+    throw new InvalidInputError(`path is not absolute: ${target}`);
+  }
+  if (!existsSync14(target)) {
+    throw new InvalidInputError(`path does not exist: ${target}`);
+  }
+  let dir = target;
+  try {
+    if (!statSync2(target).isDirectory())
+      dir = dirname6(target);
+  } catch (e) {
+    throw new InvalidInputError(`cannot read path: ${target} (${errMsg2(e)})`);
+  }
+  let dirents;
+  try {
+    dirents = readdirSync5(dir, { withFileTypes: true, encoding: "utf8" });
+  } catch (e) {
+    throw new InvalidInputError(`cannot read directory: ${dir} (${errMsg2(e)})`);
+  }
+  const entries = [];
+  let truncated = false;
+  for (const dirent of dirents) {
+    if (entries.length >= MAX_ENTRIES) {
+      truncated = true;
+      break;
+    }
+    const name = dirent.name;
+    if (SKIP_ALWAYS.has(name))
+      continue;
+    if (!showHidden && name.startsWith("."))
+      continue;
+    const path = join14(dir, name);
+    const isSymlink = dirent.isSymbolicLink();
+    let isDirectory = dirent.isDirectory();
+    if (isSymlink) {
+      try {
+        isDirectory = statSync2(path).isDirectory();
+      } catch {
+        continue;
+      }
+    }
+    if (!isDirectory)
+      continue;
+    entries.push({ name, path, isRepo: looksLikeRepo(path), isSymlink });
+  }
+  entries.sort((a, b) => a.name.localeCompare(b.name, undefined, { sensitivity: "base" }));
+  return {
+    dir,
+    parent: parentOf(dir),
+    crumbs: crumbsFor(dir),
+    entries,
+    isRepo: looksLikeRepo(dir),
+    truncated
+  };
+}
+function errMsg2(e) {
+  return e instanceof Error ? e.message : String(e);
+}
+var SKIP_ALWAYS, MAX_ENTRIES = 1000, COMMON_DIRS;
+var init_fsbrowse = __esm(() => {
+  init_errors();
+  SKIP_ALWAYS = new Set(["node_modules", "$RECYCLE.BIN", "System Volume Information"]);
+  COMMON_DIRS = ["Projects", "projects", "code", "Code", "src", "dev", "repos", "git"];
+});
+
 // src/services/projects.ts
-import { existsSync as existsSync14 } from "fs";
-import { basename, join as join14 } from "path";
+import { existsSync as existsSync15 } from "fs";
+import { basename as basename2, join as join15 } from "path";
 import { eq as eq9, isNull } from "drizzle-orm";
 function listProjects(ctx) {
   return ctx.db.select().from(projects).where(isNull(projects.closedAt)).all().map(rowToProject);
@@ -5449,14 +5598,15 @@ function warnIfTranslatedMount(ctx, projectId, repoPath) {
     message: `${repoPath} is a Windows drive mounted into Linux (/mnt) \u2014 git and burns pay a per-file translation tax here; clone the repo into the Linux filesystem (e.g. ~/projects) for native speed`
   });
 }
-async function openProject(ctx, repoPath) {
+async function openProject(ctx, rawPath) {
+  const repoPath = expandPath(rawPath);
   await assertRepoTolerant(ctx, repoPath);
   const mainBranch = await detectMainBranchTolerant(ctx, repoPath);
-  const name = basename(repoPath) || repoPath;
-  const existing = getProjectByRepoPath(ctx, repoPath);
+  const name = basename2(repoPath) || repoPath;
+  const existing = getProjectByRepoPath(ctx, repoPath) ?? findProjectByCanonPath(ctx, repoPath);
   if (existing) {
-    ctx.db.update(projects).set({ mainBranch, closedAt: null }).where(eq9(projects.id, existing.id)).run();
-    const reopened = { ...existing, mainBranch };
+    ctx.db.update(projects).set({ mainBranch, repoPath, closedAt: null }).where(eq9(projects.id, existing.id)).run();
+    const reopened = { ...existing, mainBranch, repoPath };
     emitProject(ctx, existing.id, {
       type: "project.opened",
       message: `project ${existing.name} re-opened at ${repoPath} (${mainBranch})`
@@ -5503,13 +5653,17 @@ function renameProject(ctx, projectId, name) {
   });
   return { ...project, name };
 }
+function findProjectByCanonPath(ctx, repoPath) {
+  const key = canon(repoPath);
+  return allProjects(ctx).find((p) => canon(p.repoPath) === key) ?? null;
+}
 async function assertRepoTolerant(ctx, repoPath) {
   try {
     await assertRepo(repoPath);
   } catch (e) {
     if (!isNotImplemented(e))
       throw e;
-    if (!existsSync14(join14(repoPath, ".git"))) {
+    if (!existsSync15(join15(repoPath, ".git"))) {
       throw new InvalidInputError(`not a git repository: ${repoPath}`);
     }
   }
@@ -5528,6 +5682,7 @@ var init_projects = __esm(() => {
   init_schema();
   init_errors();
   init_events();
+  init_fsbrowse();
   init_git();
   init_repo();
 });
@@ -5536,12 +5691,15 @@ var init_projects = __esm(() => {
 import * as z7 from "zod";
 var projectRouter;
 var init_project = __esm(() => {
+  init_fsbrowse();
   init_git();
   init_projects();
   init_repo();
   init_context();
   projectRouter = router({
     list: publicProcedure.query(({ ctx }) => listProjects(ctx)),
+    roots: publicProcedure.query(() => listRoots()),
+    browse: publicProcedure.input(z7.object({ dir: z7.string().optional(), showHidden: z7.boolean().optional() }).optional()).query(({ input }) => browseDir(input?.dir, input?.showHidden ?? false)),
     branches: publicProcedure.input(z7.object({ projectId: z7.string() })).query(({ ctx, input }) => listBranches(requireProjectById(ctx, input.projectId))),
     open: publicProcedure.input(z7.object({ repoPath: z7.string().min(1) })).mutation(({ ctx, input }) => openProject(ctx, input.repoPath)),
     close: publicProcedure.input(z7.object({ projectId: z7.string() })).mutation(({ ctx, input }) => closeProject(ctx, input.projectId)),
@@ -5568,12 +5726,12 @@ var init_run = __esm(() => {
 });
 
 // src/services/settings.ts
-import { existsSync as existsSync15, mkdirSync as mkdirSync7, readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname6 } from "path";
+import { existsSync as existsSync16, mkdirSync as mkdirSync7, readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "fs";
+import { dirname as dirname7 } from "path";
 import * as z9 from "zod";
 import { eq as eq10 } from "drizzle-orm";
 function readRawConfig(configFile) {
-  if (!existsSync15(configFile))
+  if (!existsSync16(configFile))
     return {};
   try {
     const parsed = JSON.parse(readFileSync6(configFile, "utf8"));
@@ -5695,7 +5853,7 @@ function updateSettings(ctx, input, io = {}) {
 function writeGlobal(configFile, configKey, value) {
   const raw = readRawConfig(configFile);
   raw[configKey] = value;
-  mkdirSync7(dirname6(configFile), { recursive: true });
+  mkdirSync7(dirname7(configFile), { recursive: true });
   writeFileSync3(configFile, `${JSON.stringify(raw, null, 2)}
 `);
 }
@@ -5734,7 +5892,7 @@ function writeStepModel(configFile, step, value) {
   else
     stepModels[step] = value;
   raw.stepModels = stepModels;
-  mkdirSync7(dirname6(configFile), { recursive: true });
+  mkdirSync7(dirname7(configFile), { recursive: true });
   writeFileSync3(configFile, `${JSON.stringify(raw, null, 2)}
 `);
 }
@@ -6016,7 +6174,7 @@ var init_doctor = __esm(() => {
 // src/doctor/system-exec.ts
 import { spawn as spawn2 } from "child_process";
 function createSystemExec(opts = {}) {
-  return (command, args) => new Promise((resolve8) => {
+  return (command, args) => new Promise((resolve9) => {
     const resolved = resolveExecutable(command);
     const isShim = /\.(cmd|bat)$/i.test(resolved);
     const file = isShim ? process.env.ComSpec ?? "cmd.exe" : resolved;
@@ -6031,10 +6189,10 @@ function createSystemExec(opts = {}) {
       stderr += d.toString();
     });
     child.on("error", (err) => {
-      resolve8({ ok: false, code: null, stdout, stderr: stderr || String(err) });
+      resolve9({ ok: false, code: null, stdout, stderr: stderr || String(err) });
     });
     child.on("close", (code) => {
-      resolve8({ ok: true, code: code ?? 0, stdout, stderr });
+      resolve9({ ok: true, code: code ?? 0, stdout, stderr });
     });
   });
 }
@@ -6043,8 +6201,8 @@ var init_system_exec = __esm(() => {
 });
 
 // src/services/setup.ts
-import { copyFileSync, existsSync as existsSync16, mkdirSync as mkdirSync8, readFileSync as readFileSync7, readdirSync as readdirSync5, writeFileSync as writeFileSync4 } from "fs";
-import { dirname as dirname7, join as join15 } from "path";
+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";
 async function writeGitIdentity(exec, identity) {
   const name = identity.name.trim();
@@ -6120,16 +6278,16 @@ async function resolveRuntime(exec, preferred) {
 function resolveSandcastleBin() {
   try {
     const mainUrl = import.meta.resolve("@ai-hero/sandcastle");
-    let dir = dirname7(fileURLToPath6(mainUrl));
+    let dir = dirname8(fileURLToPath6(mainUrl));
     for (let hops = 0;hops < 6; hops++) {
-      const manifestPath = join15(dir, "package.json");
-      if (existsSync16(manifestPath)) {
+      const manifestPath = join16(dir, "package.json");
+      if (existsSync17(manifestPath)) {
         const manifest = JSON.parse(readFileSync7(manifestPath, "utf8"));
         if (manifest.name === "@ai-hero/sandcastle" && manifest.bin?.sandcastle) {
-          return join15(dir, manifest.bin.sandcastle);
+          return join16(dir, manifest.bin.sandcastle);
         }
       }
-      const parent = dirname7(dir);
+      const parent = dirname8(dir);
       if (parent === dir)
         break;
       dir = parent;
@@ -6154,12 +6312,12 @@ function sandcastleTemplateDir() {
   return resolveAsset(ASSET_ENV.sandcastleTemplate, fileURLToPath6(new URL("../assets/sandcastle", import.meta.url)));
 }
 function scaffoldSandcastleConfig(templateDir, targetDir) {
-  const dir = join15(targetDir, ".sandcastle");
-  if (existsSync16(dir))
+  const dir = join16(targetDir, ".sandcastle");
+  if (existsSync17(dir))
     return { scaffolded: false, dir };
   mkdirSync8(dir, { recursive: true });
-  for (const name of readdirSync5(templateDir)) {
-    copyFileSync(join15(templateDir, name), join15(dir, name));
+  for (const name of readdirSync6(templateDir)) {
+    copyFileSync(join16(templateDir, name), join16(dir, name));
   }
   return { scaffolded: true, dir };
 }
@@ -6184,9 +6342,9 @@ function createTokenVerifier(exec) {
 function fileAfkTokenIo(exec) {
   const path = envPath();
   return {
-    read: () => existsSync16(path) ? readFileSync7(path, "utf8") : "",
+    read: () => existsSync17(path) ? readFileSync7(path, "utf8") : "",
     write: (content) => {
-      mkdirSync8(dirname7(path), { recursive: true });
+      mkdirSync8(dirname8(path), { recursive: true });
       writeFileSync4(path, content, "utf8");
     },
     verify: createTokenVerifier(exec)
@@ -6323,13 +6481,13 @@ var init_update_check = __esm(() => {
 
 // src/version.ts
 import { readFileSync as readFileSync8 } from "fs";
-import { dirname as dirname8, join as join16 } from "path";
+import { dirname as dirname9, join as join17 } from "path";
 import { fileURLToPath as fileURLToPath7 } from "url";
 function runcastleVersion() {
   if (cached2)
     return cached2;
-  const here = dirname8(fileURLToPath7(import.meta.url));
-  for (const pkgPath of [join16(here, "..", "package.json"), join16(here, "package.json")]) {
+  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") {
@@ -6579,7 +6737,7 @@ __export(exports_cli, {
   resolveDoctorEnv: () => resolveDoctorEnv,
   parseMode: () => parseMode
 });
-import { existsSync as existsSync17, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync18, readFileSync as readFileSync9 } from "fs";
 function parseMode(argv) {
   return argv.includes("--gate") || argv.includes("--boot") ? "gate" : "diagnostic";
 }
@@ -6587,7 +6745,7 @@ function envWithToken() {
   const merged = { ...process.env };
   try {
     const path = envPath();
-    if (existsSync17(path)) {
+    if (existsSync18(path)) {
       const fromFile = parseEnvFile(readFileSync9(path, "utf8")).CLAUDE_CODE_OAUTH_TOKEN;
       if (fromFile && fromFile.length > 0)
         merged.CLAUDE_CODE_OAUTH_TOKEN = fromFile;
@@ -6630,7 +6788,7 @@ var init_cli = __esm(() => {
 // src/bin/runcastle.ts
 init_asset_paths();
 init_version();
-import { dirname as dirname9, resolve as resolve8 } from "path";
+import { dirname as dirname10, resolve as resolve9 } from "path";
 import { fileURLToPath as fileURLToPath8 } from "url";
 function parseCommand(argv) {
   const [first, ...rest] = argv;
@@ -6655,7 +6813,7 @@ Usage:
   runcastle --help     Show this help
 `;
 async function main(argv) {
-  applyInstalledAssetEnv(resolve8(dirname9(fileURLToPath8(import.meta.url)), ".."));
+  applyInstalledAssetEnv(resolve9(dirname10(fileURLToPath8(import.meta.url)), ".."));
   const { command, args } = parseCommand(argv);
   switch (command) {
     case "version":