runcastle 1.0.2 → 1.0.6

package/index.js

@@ -1,12 +1,16 @@
 // @bun
 var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -57,6 +61,9 @@ var init_paths = () => {};
 
 // ../core/src/config.ts
 import * as z from "zod";
+function resolveSandboxImage(config) {
+  return config.sandboxImage ?? DEFAULT_SANDBOX_IMAGE;
+}
 function resolveModel(step, config, project, runOverride) {
   return runOverride ?? config.stepModels[step] ?? project?.model ?? config.model;
 }
@@ -72,7 +79,7 @@ var MODEL_STEPS, ModelStep, DEFAULT_SMOKE_MODEL = "claude-haiku-4-5-20251001", f
   }
   delete obj.smokeModel;
   return obj;
-}, RuncastleConfig;
+}, RuncastleConfig, DEFAULT_SANDBOX_IMAGE = "sandcastle:runcastle";
 var init_config = __esm(() => {
   MODEL_STEPS = [
     "ideation",
@@ -225,6 +232,7 @@ var init_schemas = __esm(() => {
     mapped: z2.boolean(),
     phase: Phase,
     branch: z2.string(),
+    baseBranch: z2.string().optional(),
     status: FeatureStatus,
     createdAt: z2.number()
   });
@@ -438,6 +446,7 @@ var init_db_schema = __esm(() => {
     mapped: integer("mapped", { mode: "boolean" }).notNull().default(false),
     phase: text("phase").notNull().$type(),
     branch: text("branch").notNull(),
+    baseBranch: text("base_branch"),
     status: text("status").notNull().$type(),
     createdAt: integer("created_at").notNull()
   });
@@ -1164,6 +1173,7 @@ function rowToFeature(row) {
     mapped: row.mapped,
     phase: row.phase,
     branch: row.branch,
+    baseBranch: row.baseBranch ?? undefined,
     status: row.status,
     createdAt: row.createdAt
   };
@@ -1900,20 +1910,59 @@ async function detectMainBranch(repoPath) {
   } catch {}
   return "main";
 }
-async function createFeatureBranch(project, slug) {
+async function createFeatureBranch(project, slug, base) {
   const branch = featureBranch(slug);
+  const from = base?.trim() || project.mainBranch;
   const g = git(project.repoPath);
   const branches = await g.branchLocal();
   if (branches.all.includes(branch))
     return branch;
-  await g.raw(["branch", branch, project.mainBranch]);
+  if (!branches.all.includes(from)) {
+    throw new Error(`base branch "${from}" does not exist in ${project.repoPath}`);
+  }
+  await g.raw(["branch", branch, from]);
   return branch;
 }
+async function listBranches(project) {
+  const g = git(project.repoPath);
+  const local = await g.branchLocal();
+  const branches = local.all.filter((name) => !name.startsWith("feature/"));
+  const localSet = new Set(local.all);
+  let remoteBranches = [];
+  try {
+    const remote = await g.branch(["-r"]);
+    remoteBranches = remote.all.filter((r) => !r.includes(" -> ") && !r.endsWith("/HEAD")).filter((r) => {
+      const short = r.replace(/^[^/]+\//, "");
+      return !short.startsWith("feature/") && !localSet.has(short);
+    });
+  } catch {}
+  return { current: local.current, mainBranch: project.mainBranch, branches, remoteBranches };
+}
+async function resolveBaseBranch(project, base) {
+  const g = git(project.repoPath);
+  const local = await g.branchLocal();
+  if (local.all.includes(base))
+    return base;
+  const remotes = (await g.getRemotes()).map((r) => r.name);
+  for (const rem of remotes) {
+    const prefix = `${rem}/`;
+    if (!base.startsWith(prefix))
+      continue;
+    const name = base.slice(prefix.length);
+    if (!name || name.endsWith("/HEAD"))
+      break;
+    if (local.all.includes(name))
+      return name;
+    await g.raw(["branch", "--track", name, base]);
+    return name;
+  }
+  throw new Error(`base branch "${base}" does not exist in ${project.repoPath}`);
+}
 async function ensureTalkWorktree(project, feature) {
   const worktreePath = worktreeDir(project.id, feature.slug);
   const branch = featureBranch(feature.slug);
   const g = git(project.repoPath);
-  await ensureBranchExists(g, branch, project.mainBranch);
+  await ensureBranchExists(g, branch, feature.baseBranch ?? project.mainBranch);
   if (await worktreeIsValid(g, worktreePath, branch))
     return worktreePath;
   mkdirSync2(dirname(worktreePath), { recursive: true });
@@ -2184,6 +2233,7 @@ async function testDrive(ctx, project, feature, action) {
   return { ok: true, branch };
 }
 async function mergeFeature(project, feature) {
+  const target = feature.baseBranch ?? project.mainBranch;
   if (testDriveState) {
     throw new GateError("Cannot merge while a test drive is active \u2014 stop it first");
   }
@@ -2192,19 +2242,33 @@ async function mergeFeature(project, feature) {
   if (porcelain !== "") {
     throw new GateError("Cannot merge \u2014 working tree has uncommitted changes");
   }
+  const branches = await g.branchLocal();
+  if (!branches.all.includes(target)) {
+    throw new GateError(`Cannot merge \u2014 base branch "${target}" no longer exists`);
+  }
+  const previous = (await g.revparse(["--abbrev-ref", "HEAD"])).trim();
   const branch = featureBranch(feature.slug);
-  await g.checkout(project.mainBranch);
+  await g.checkout(target);
   try {
     await g.merge(["--no-ff", branch]);
-    return { ok: true };
+    await restoreBranch(g, previous, target);
+    return { ok: true, target };
   } catch (e) {
     if (await mergeInProgress(g)) {
       await g.raw(["merge", "--abort"]);
-      return { ok: false, conflict: true };
+      await restoreBranch(g, previous, target);
+      return { ok: false, conflict: true, target };
     }
     throw e instanceof Error ? e : new Error(errMsg(e));
   }
 }
+async function restoreBranch(g, previous, target) {
+  if (previous === target || previous === "HEAD" || !previous)
+    return;
+  try {
+    await g.checkout(previous);
+  } catch {}
+}
 async function mergeInProgress(g) {
   try {
     await g.raw(["rev-parse", "--verify", "--quiet", "MERGE_HEAD"]);
@@ -2694,7 +2758,7 @@ function buildBurnAgent(config2, token, model) {
   return agent;
 }
 function selectSandbox(config2) {
-  const imageOpts = config2.sandboxImage ? { imageName: config2.sandboxImage } : {};
+  const imageOpts = { imageName: resolveSandboxImage(config2) };
   switch (config2.sandbox) {
     case "docker":
       return docker(imageOpts);
@@ -2886,7 +2950,7 @@ async function realExecuteResearchRun(ctx, waypoint, config2, token, model) {
   const throttle = createResearchStreamThrottle((e) => ctx.emitEvent(e));
   const runOptions = {
     agent: buildBurnAgent(config2, token, model),
-    sandbox: config2.sandbox === "docker" ? docker2(config2.sandboxImage ? { imageName: config2.sandboxImage } : {}) : noSandbox2(),
+    sandbox: config2.sandbox === "docker" ? docker2({ imageName: resolveSandboxImage(config2) }) : noSandbox2(),
     cwd: project.repoPath,
     prompt,
     branchStrategy: { type: "branch", branch: tempBranch, baseBranch: feature.branch },
@@ -3118,7 +3182,8 @@ async function createFeature(ctx, input) {
   const project = requireProjectById(ctx, input.projectId);
   const slug = uniqueSlug(ctx, project.id, input.title);
   const branch = `feature/${slug}`;
-  const { branchReady } = await ensureFeatureBranch(project, slug);
+  const requestedBase = input.baseBranch?.trim() || project.mainBranch;
+  const { branchReady, baseBranch } = await ensureFeatureBranch(project, slug, requestedBase);
   const row = {
     id: newId("feat"),
     projectId: project.id,
@@ -3129,6 +3194,7 @@ async function createFeature(ctx, input) {
     mapped: input.mapped ?? false,
     phase: "ideation",
     branch,
+    baseBranch,
     status: "active",
     createdAt: Date.now()
   };
@@ -3136,8 +3202,8 @@ async function createFeature(ctx, input) {
   const feature = rowToFeature(inserted);
   emit(ctx, feature.id, {
     type: "feature.created",
-    message: branchReady ? `feature.created (${branch})` : "feature.created (branch pending)",
-    data: { slug, branch, branchReady }
+    message: branchReady ? `feature.created (${branch} \u2190 ${baseBranch})` : "feature.created (branch pending)",
+    data: { slug, branch, baseBranch, branchReady }
   });
   scaffoldDocs(ctx, feature);
   if (branchReady) {
@@ -3147,13 +3213,14 @@ async function createFeature(ctx, input) {
   }
   return feature;
 }
-async function ensureFeatureBranch(project, slug) {
+async function ensureFeatureBranch(project, slug, requestedBase) {
   try {
-    await createFeatureBranch(project, slug);
-    return { branchReady: true };
+    const baseBranch = await resolveBaseBranch(project, requestedBase);
+    await createFeatureBranch(project, slug, baseBranch);
+    return { branchReady: true, baseBranch };
   } catch (e) {
     if (isNotImplemented(e))
-      return { branchReady: false };
+      return { branchReady: false, baseBranch: requestedBase };
     throw e;
   }
 }
@@ -4382,7 +4449,8 @@ var init_feature = __esm(() => {
       title: z6.string().min(1),
       oneLiner: z6.string(),
       size: FeatureSize,
-      mapped: z6.boolean().optional()
+      mapped: z6.boolean().optional(),
+      baseBranch: z6.string().optional()
     })).mutation(({ ctx, input }) => createFeature(ctx, input)),
     list: publicProcedure.input(z6.object({ projectId: z6.string() })).query(({ ctx, input }) => list(ctx, input.projectId)),
     get: publicProcedure.input(z6.object({ id: z6.string() })).query(({ ctx, input }) => getFeatureFull(ctx, input.id)),
@@ -4407,7 +4475,7 @@ var init_feature = __esm(() => {
       }
       const res = await mergeFeature(project, feature);
       if (res.ok) {
-        setPhase(ctx, input.featureId, "shipped", "feature.shipped", `merged to ${project.mainBranch}`);
+        setPhase(ctx, input.featureId, "shipped", "feature.shipped", `merged to ${res.target}`);
         setFeatureStatus(ctx, input.featureId, "shipped");
       } else {
         emit(ctx, input.featureId, {
@@ -4513,10 +4581,13 @@ var init_projects = __esm(() => {
 import * as z7 from "zod";
 var projectRouter;
 var init_project = __esm(() => {
+  init_git();
   init_projects();
+  init_repo();
   init_context();
   projectRouter = router({
     list: publicProcedure.query(({ ctx }) => listProjects(ctx)),
+    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)),
     rename: publicProcedure.input(z7.object({ projectId: z7.string(), name: z7.string().min(1) })).mutation(({ ctx, input }) => renameProject(ctx, input.projectId, input.name))
@@ -4927,7 +4998,7 @@ function afkTokenProbe(env) {
 async function runDoctor(env) {
   const { exec } = env;
   const processEnv = env.env ?? process.env;
-  const imageName = env.imageName ?? "sandcastle:runcastle";
+  const imageName = env.imageName ?? DEFAULT_SANDBOX_IMAGE;
   const results = [
     await bunProbe(exec),
     await nodeProbe(exec),
@@ -4949,6 +5020,9 @@ function exitCodeFor(report, mode) {
     return report.tier1Ok ? 0 : 1;
   return report.ok ? 0 : 1;
 }
+var init_doctor = __esm(() => {
+  init_src();
+});
 
 // src/doctor/system-exec.ts
 import { spawn as spawn2 } from "child_process";
@@ -5132,6 +5206,7 @@ function fileAfkTokenIo(exec) {
 var AFK_TOKEN_KEY = "CLAUDE_CODE_OAUTH_TOKEN";
 var init_setup = __esm(() => {
   init_paths();
+  init_doctor();
   init_errors();
   init_asset_paths();
 });
@@ -5141,6 +5216,7 @@ import * as z11 from "zod";
 var setupRouter;
 var init_setup2 = __esm(() => {
   init_src();
+  init_doctor();
   init_system_exec();
   init_registry();
   init_setup();
@@ -5158,7 +5234,7 @@ var init_setup2 = __esm(() => {
       const exec = createSystemExec();
       const preferred = ctx.config.sandbox === "podman" ? "podman" : "docker";
       const runtime = await resolveRuntime(exec, preferred);
-      const imageName = ctx.config.sandboxImage ?? "sandcastle:runcastle";
+      const imageName = resolveSandboxImage(ctx.config);
       const sandcastleBin = input.kind === "build-image" ? resolveSandcastleBin() ?? undefined : undefined;
       const spec = terminalSpec(input.kind, { runtime, imageName, sandcastleBin });
       const sessionId = newId("setup");

package/package.json

@@ -1,6 +1,8 @@
 {
   "name": "runcastle",
-  "version": "1.0.2",
+  "version": "1.0.6",
+  "description": "Burn tickets into shipped features with Claude Code.",
+  "license": "MIT",
   "type": "module",
   "bin": {
     "runcastle": "./bin/runcastle.js"
@@ -8,6 +10,14 @@
   "engines": {
     "bun": ">=1.3.14"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MuathZahir/runcastle.git"
+  },
+  "homepage": "https://github.com/MuathZahir/runcastle#readme",
+  "bugs": {
+    "url": "https://github.com/MuathZahir/runcastle/issues"
+  },
   "files": [
     "index.js",
     "bin",