runcastle 1.4.4 → 1.4.6

package/bin/runcastle.js

@@ -45,7 +45,7 @@ function agentDigestFillRank(relPath) {
   const i = AGENT_DIGEST_FILL_ORDER.indexOf(relPath.toLowerCase());
   return i === -1 ? AGENT_DIGEST_FILL_ORDER.length : i;
 }
-var AGENT_DIGEST_DOCS, WITHHELD_FEATURE_DOCS, AGENT_DIGEST_FILL_ORDER;
+var AGENT_DIGEST_DOCS, PREVIEW_FILE = "preview.html", WITHHELD_FEATURE_DOCS, AGENT_DIGEST_FILL_ORDER;
 var init_docs = __esm(() => {
   AGENT_DIGEST_DOCS = ["brief.md", "decisions.md", "spec.md"];
   WITHHELD_FEATURE_DOCS = {
@@ -264,7 +264,7 @@ var init_schemas = __esm(() => {
     "drive-fix"
   ]);
   PROJECT_SESSION_KINDS = ["prepare", "project"];
-  SessionPurpose = z3.enum(["resolve-conflict", "start-lap"]);
+  SessionPurpose = z3.enum(["resolve-conflict", "start-lap", "self-plan"]);
   MergeBranchPair = z3.object({
     mergeFrom: z3.string(),
     mergeInto: z3.string()
@@ -1659,8 +1659,9 @@ ${why.replace(/\n/g, `\r
     containment?.kill();
     fireExit(code ?? 0, signal ? 1 : undefined);
   });
+  child.stdin?.on("error", () => {});
   function sendToHost(obj) {
-    if (!child.stdin || child.stdin.destroyed)
+    if (exitFired || !child.stdin || child.stdin.destroyed)
       return;
     try {
       child.stdin.write(JSON.stringify(obj) + `
@@ -2627,7 +2628,7 @@ function noteDocsChange(ctx, featureId, filename) {
   const entry = watches.get(featureId);
   if (!entry)
     return;
-  if (filename !== null && !filename.endsWith(".md"))
+  if (filename !== null && !filename.endsWith(".md") && filename !== PREVIEW_FILE)
     return;
   if (filename)
     entry.changed.add(filename);
@@ -2654,6 +2655,7 @@ function emitDocsChanged(ctx, featureId) {
 }
 var DOCS_WATCH_DEBOUNCE_MS = 300, watches;
 var init_docs_watch = __esm(() => {
+  init_src();
   init_events();
   init_feature_docs();
   init_repo();
@@ -3576,6 +3578,9 @@ function chatBranchName(slug, unique) {
 function burnWorktreePath(repoPath, branch) {
   return join6(repoPath, ".sandcastle", "worktrees", branch.replace(/\//g, "-"));
 }
+async function excludeBurnWorktrees(repoPath) {
+  await excludePath(repoPath, BURN_WORKTREES_PATTERN);
+}
 async function excludeFilePath(repoPath) {
   const raw = (await git(repoPath).raw(["rev-parse", "--git-path", "info/exclude"])).trim();
   return resolve3(repoPath, raw);
@@ -4616,7 +4621,7 @@ async function mergeInProgress(g) {
     return false;
   }
 }
-var DOCS_PATHSPEC = "docs/features", MIGRATION_DIR_RE, DRIZZLE_SQL_RE, DENY_DIRTY = "Working tree has uncommitted changes \u2014 commit or stash first", DENY_ACTIVE = "A test drive is already active \u2014 stop it first", DENY_ACTIVE_RUN = "Feature has an active run \u2014 wait for it to finish", DENY_NONE_ACTIVE = "No test drive is active", DENY_DRY_RUN_ACTIVE = "A preparation dry-run is in progress \u2014 stop it first", DENY_NO_DRY_RUN = "No preparation dry-run is in progress", DENY_NO_REVIEW_DRIVE = "No review drive is in progress for this feature", INITIAL_COMMIT_SUBJECT = "runcastle: initial commit", TICKET_BRANCH_PREFIX = "runcastle/ticket/", CHAT_BRANCH_PREFIX = "runcastle/chat/", PROJECT_BRANCH = "runcastle/project", TEMP_BRANCH_PREFIXES, TEMP_BRANCH_SLUG_MAX = 16, testDriveState, reviewDriveRelease, readinessTiming, DRY_RUN_SLUG = "prep-dry-run", PROJECT_DRIVE_SLUG = "project-drive", DENY_NO_PROJECT_DRIVE = "No project drive is running for this project";
+var DOCS_PATHSPEC = "docs/features", MIGRATION_DIR_RE, DRIZZLE_SQL_RE, DENY_DIRTY = "Working tree has uncommitted changes \u2014 commit or stash first", DENY_ACTIVE = "A test drive is already active \u2014 stop it first", DENY_ACTIVE_RUN = "Feature has an active run \u2014 wait for it to finish", DENY_NONE_ACTIVE = "No test drive is active", DENY_DRY_RUN_ACTIVE = "A preparation dry-run is in progress \u2014 stop it first", DENY_NO_DRY_RUN = "No preparation dry-run is in progress", DENY_NO_REVIEW_DRIVE = "No review drive is in progress for this feature", INITIAL_COMMIT_SUBJECT = "runcastle: initial commit", TICKET_BRANCH_PREFIX = "runcastle/ticket/", CHAT_BRANCH_PREFIX = "runcastle/chat/", PROJECT_BRANCH = "runcastle/project", TEMP_BRANCH_PREFIXES, TEMP_BRANCH_SLUG_MAX = 16, BURN_WORKTREES_PATTERN = ".sandcastle/worktrees/", testDriveState, reviewDriveRelease, readinessTiming, DRY_RUN_SLUG = "prep-dry-run", PROJECT_DRIVE_SLUG = "project-drive", DENY_NO_PROJECT_DRIVE = "No project drive is running for this project";
 var init_git = __esm(() => {
   init_src();
   init_paths();
@@ -4774,6 +4779,9 @@ function entrySkillsFor(kind) {
 function chatKickoffFor(runtime, opening) {
   return opening === "ideate" ? `Proceed with your task: invoke the ${skillRef(runtime, "ideate")} skill and drive this ` + "feature's ideation to completion." : `Proceed with your task: invoke the ${skillRef(runtime, "revisit")} skill and continue this ` + "feature's conversation.";
 }
+function selfPlanKickoffFor(runtime) {
+  return "Proceed with your task: no human is present and nobody will reply to you. Invoke the " + `${skillRef(runtime, "ideate")} skill and follow its "${PLANNING_WITHOUT_A_HUMAN}" section ` + "to plan this feature by yourself, through the preview, the spec and the tickets, in this one run.";
+}
 function kickoffLinesFor(runtime) {
   const skill = (name) => skillRef(runtime, name);
   return {
@@ -4789,7 +4797,7 @@ function projectTriageKickoffFor(runtime) {
 function prepareConfirmKickoffFor(runtime) {
   return `Proceed with your task: invoke the ${skillRef(runtime, "prepare")} skill. Every prepared field already ` + "has a value, so this is a confirmation, not a preparation \u2014 tell me what is recorded and " + "how stale it is, ask whether it still holds, and stop. Do not re-derive a settled value.";
 }
-var PACK = "runcastle", SPELLINGS, ENTRY_SKILLS;
+var PACK = "runcastle", SPELLINGS, ENTRY_SKILLS, PLANNING_WITHOUT_A_HUMAN = "Planning without a human";
 var init_skills = __esm(() => {
   SPELLINGS = {
     "claude-code": (skill) => `/${PACK}:${skill}`,
@@ -4830,7 +4838,8 @@ function chatOpening(feature, planning) {
 function renderSystemPrompt(feature, kind, lap, purpose, runtime = DEFAULT_RUNTIME, carried, planning) {
   if (lap !== undefined)
     return renderRevisitPrompt(feature, lap, purpose, runtime, carried);
-  if (kind === "chat" && chatOpening(feature, planning) === "revisit") {
+  const selfPlan = purpose === "self-plan";
+  if (kind === "chat" && !selfPlan && chatOpening(feature, planning) === "revisit") {
     return renderRevisitPrompt(feature, lap, purpose, runtime, carried);
   }
   const docs2 = featureDocsRel(feature.slug);
@@ -4863,12 +4872,26 @@ function renderSystemPrompt(feature, kind, lap, purpose, runtime = DEFAULT_RUNTI
     noCodeRule(docs2),
     otherEntrySkillsRule(),
     "",
+    ...selfPlan ? [selfPlanRule(), ""] : [],
     "## Your task",
     `Begin by invoking the \`${skillRef(runtime, "ideate")}\` skill and drive the ideation session to completion.`,
     ""
   ].join(`
 `);
 }
+function selfPlanRule() {
+  return [
+    "## No human is present",
+    "This is a self-planning run: nobody is watching and nobody will reply.",
+    "- Never end your turn to ask a question \u2014 ending the turn ends the run. Ask your design",
+    "  questions of yourself, as the skill describes, and answer them.",
+    "- A refused tool is not a wait: do not retry it or wait for approval. Decide on what you",
+    "  know and treat that decision as a candidate to check first.",
+    `- Follow the ideation skill's "${PLANNING_WITHOUT_A_HUMAN}" section through the preview, the`,
+    "  spec and the tickets, in this one run."
+  ].join(`
+`);
+}
 function reviewEvidenceSection(lap, docs2, carried) {
   const evidence = carried?.reviewEvidence ?? [];
   return [
@@ -5452,6 +5475,10 @@ var init_skills_root = __esm(() => {
 });
 
 // src/launcher/runtimes/types.ts
+function assertHeadlessKickoff(headless, line) {
+  if (headless && !line)
+    throw new Error("a headless launch needs a kickoff line as its prompt");
+}
 function assertKickoffArgv(line) {
   if (line !== undefined && line.length > MAX_KICKOFF_ARGV) {
     throw new Error(`kickoff line is ${line.length} characters; maximum is ${MAX_KICKOFF_ARGV}`);
@@ -5462,9 +5489,11 @@ var MAX_KICKOFF_ARGV = 30000;
 // src/launcher/runtimes/claude.ts
 function buildClaudeArgs(input) {
   assertKickoffArgv(input.kickoffLine);
+  assertHeadlessKickoff(input.headless, input.kickoffLine);
   const permissionMode = input.permissionMode ?? "acceptEdits";
-  const resume = input.resumeSessionId ? ["--resume", input.resumeSessionId] : [];
+  const resume = input.resumeSessionId && !input.headless ? ["--resume", input.resumeSessionId] : [];
   return [
+    ...input.headless ? ["-p"] : [],
     ...resume,
     "--settings",
     input.settingsPath,
@@ -5527,7 +5556,8 @@ var init_claude = __esm(() => {
           model: input.model,
           ...input.resumeSessionId ? { resumeSessionId: input.resumeSessionId } : {},
           ...input.kickoffLine ? { kickoffLine: input.kickoffLine } : {},
-          strictMcp: input.config.sessionMcp === "runcastleOnly"
+          strictMcp: input.config.sessionMcp === "runcastleOnly",
+          ...input.headless ? { headless: true } : {}
         }),
         env: {
           RUNCASTLE_SESSION_ID: input.session.id,
@@ -7137,12 +7167,16 @@ function toml(value) {
 function approvalPolicyFor(permissionMode) {
   return permissionMode === undefined || permissionMode === "acceptEdits" ? "never" : "on-request";
 }
+function sandboxModeFor(permissionMode, platform) {
+  return platform === "win32" && approvalPolicyFor(permissionMode) === "never" ? "danger-full-access" : "workspace-write";
+}
 function renderCodexConfig(input) {
   const { session, config: config2, model, worktreePath, inheritedMcpServers, permissionMode } = input;
+  const platform = input.platform ?? process.platform;
   return [
     `# Generated by runcastle for session ${session.id} \u2014 rewritten at every launch.`,
     `model = ${toml(model)}`,
-    'sandbox_mode = "workspace-write"',
+    `sandbox_mode = ${toml(sandboxModeFor(permissionMode, platform))}`,
     `approval_policy = ${toml(approvalPolicyFor(permissionMode))}`,
     "check_for_update_on_startup = false",
     "",
@@ -7156,6 +7190,7 @@ function renderCodexConfig(input) {
     "[mcp_servers.runcastle]",
     `url = ${toml(`${serverUrlFor(config2)}/mcp`)}`,
     `http_headers = { "X-Runcastle-Session" = ${toml(session.id)} }`,
+    'default_tools_approval_mode = "approve"',
     ""
   ].join(`
 `);
@@ -7264,6 +7299,9 @@ function gitInfoDir(worktreePath) {
 }
 function buildCodexArgs(input) {
   assertKickoffArgv(input.kickoffLine);
+  assertHeadlessKickoff(input.headless, input.kickoffLine);
+  if (input.headless)
+    return ["exec", "--dangerously-bypass-hook-trust", input.kickoffLine];
   return [
     ...input.resumeSessionId ? ["resume", input.resumeSessionId] : [],
     "--dangerously-bypass-hook-trust",
@@ -7336,7 +7374,8 @@ var init_codex = __esm(() => {
         files,
         argv: buildCodexArgs({
           ...input.resumeSessionId ? { resumeSessionId: input.resumeSessionId } : {},
-          ...input.kickoffLine ? { kickoffLine: input.kickoffLine } : {}
+          ...input.kickoffLine ? { kickoffLine: input.kickoffLine } : {},
+          ...input.headless ? { headless: true } : {}
         }),
         env: {
           CODEX_HOME: home,
@@ -7971,6 +8010,12 @@ function listDocs(ctx, feature) {
     return { relPath: e.name, title: readTitle(path, e.name), ...writtenAt(path) };
   }).sort((a, b) => a.relPath.localeCompare(b.relPath));
 }
+function previewSummary(ctx, feature) {
+  const path = featureDocPath(projectForFeature(ctx, feature), feature, PREVIEW_FILE);
+  if (!existsSync12(path))
+    return null;
+  return { relPath: PREVIEW_FILE, ...writtenAt(path) };
+}
 function readDoc(ctx, feature, relPath) {
   const project = projectForFeature(ctx, feature);
   const dir = featureDocsDir(project, feature);
@@ -8003,6 +8048,7 @@ function readTitle(path, fallback) {
 }
 var CHARTER_FILE = "CONTEXT.md", ADR_DIR_REL = "docs/adr", SUPERSEDED_RE;
 var init_knowledge = __esm(() => {
+  init_src();
   init_errors();
   init_events();
   init_feature_docs();
@@ -57791,6 +57837,7 @@ async function runReviewGates(input) {
     mkdirSync10(reviewGateLogDir(ticketId), { recursive: true });
     await discardBranch();
     await pinBranchAt(project3.repoPath, branch, sha);
+    await excludeBurnWorktrees(project3.repoPath);
     while (results.length < commands.length) {
       await withSandbox(branch, async (sandbox3) => {
         for (const [i, command] of commands.entries()) {
@@ -60553,6 +60600,7 @@ async function burnTicket(ctx, ticket, config2, token, model, hostAgentVersions,
       await clearAttachments(burnWorktreePath(project3.repoPath, branch), project3.repoPath);
     }
   };
+  await excludeBurnWorktrees(project3.repoPath);
   const ticketJson = buildTicketJson(ticket);
   const featureBrief = buildFeatureBrief(feature);
   const docsDigest = blocks.docsDigest;
@@ -61660,6 +61708,7 @@ function getFeatureFull(ctx, id3) {
     sessions: listSessionsByFeature(ctx, id3).map((session) => session.kind === "chat" && session.status === "ended" && !session.ccSessionId ? { ...session, title: null, transcriptMissing: true } : session),
     runs: listRunsByFeature(ctx, id3),
     docs: listDocs(ctx, feature),
+    preview: previewSummary(ctx, feature),
     dependsOn: dependsOnOf(ctx, id3),
     blocks: blocksOf(ctx, id3)
   };
@@ -64725,7 +64774,7 @@ function ptyExitMessage(exitCode) {
   const label = typeof exitCode === "number" ? String(exitCode) : "unknown";
   return `terminal exited (code ${label})`;
 }
-function chatKickoffHeader(ctx, feature, runtime5 = DEFAULT_RUNTIME) {
+function chatKickoffHeader(ctx, feature, runtime5 = DEFAULT_RUNTIME, opening = chatKickoffFor(runtime5, chatOpening(feature, planningFacts(ctx, feature)))) {
   const counts = new Map;
   for (const ticket of listByFeature(ctx, feature.id)) {
     counts.set(ticket.status, (counts.get(ticket.status) ?? 0) + 1);
@@ -64738,7 +64787,6 @@ function chatKickoffHeader(ctx, feature, runtime5 = DEFAULT_RUNTIME) {
     const outcome = !latestRun ? "never driven" : latestReview?.status === "done" ? "passed" : latestReview?.status === "failed" ? "failed" : "unverified";
     review = ` Drive outcome: ${outcome}; see the review evidence in get_feature_context.`;
   }
-  const opening = chatKickoffFor(runtime5, chatOpening(feature, planningFacts(ctx, feature)));
   return `${opening} Feature state: ${feature.phase}; lap ${feature.lap}; tickets: ${ticketSummary}; latest run: ${latestRun?.status ?? "none"}.${review} Call get_feature_context for the full picture.`;
 }
 function assertRuntimeReady(runtime5, opts) {
@@ -64765,6 +64813,21 @@ function assertSpawnable(ctx, feature, excludeSessionId) {
     throw new GateError(`a ${live[0].kind} session is already live for ${feature.slug} \u2014 only one terminal per feature; end or resume it first`);
   }
 }
+function isSelfPlan(input) {
+  return input.kind === "chat" && input.purpose === "self-plan";
+}
+function assertSelfPlannable(ctx, feature) {
+  if (feature.phase !== "planning") {
+    throw new GateError(`${feature.slug} is past planning, so there is nothing for it to plan by itself \u2014 open the chat to change it`);
+  }
+  if (chatOpening(feature, planningFacts(ctx, feature)) !== "ideate") {
+    throw new GateError(`${feature.slug} already has planning on record (decisions, a spec or tickets), so it cannot plan itself from scratch \u2014 open the chat to carry on`);
+  }
+  assertSpawnable(ctx, feature);
+}
+function selfPlanRunningError(feature) {
+  return new GateError(`${feature.slug} is planning itself \u2014 stop the run first, then open the chat to pick up where it got to`);
+}
 async function ensureWorktree(ctx, project3, feature) {
   const running3 = activeRunFor(ctx, feature.id);
   const besideRun = !!running3 && workflowClaimsFeatureBranch(running3.workflow);
@@ -64846,7 +64909,11 @@ async function launchSession(ctx, input, opts = {}) {
   requireNotDraft(feature);
   if (input.kind === "chat") {
     const liveChat = activeSessionsForFeature(ctx, feature.id).find((s) => s.kind === "chat");
-    if (liveChat && isStartLap(feature, input))
+    if (liveChat?.purpose === "self-plan")
+      throw selfPlanRunningError(feature);
+    if (isSelfPlan(input))
+      assertSelfPlannable(ctx, feature);
+    else if (liveChat && isStartLap(feature, input))
       endSession(ctx, liveChat.id);
     else if (liveChat)
       return briefLiveChat(ctx, feature, liveChat, input);
@@ -64866,8 +64933,9 @@ async function launchSession(ctx, input, opts = {}) {
   });
   const carried = startLapCarriedWork(ctx, feature.id);
   const plan = planLaunchKickoff(feature, input, carried);
+  const selfPlan = isSelfPlan(input);
   if (input.kind === "chat") {
-    const header = chatKickoffHeader(ctx, feature, runtime5.id);
+    const header = chatKickoffHeader(ctx, feature, runtime5.id, selfPlan ? selfPlanKickoffFor(runtime5.id) : undefined);
     plan.line = plan.line ? `${plan.line} ${header}` : header;
   }
   let resumeSessionId;
@@ -64880,6 +64948,8 @@ async function launchSession(ctx, input, opts = {}) {
       markSessionEnded(ctx, session.id);
       throw e;
     }
+  }
+  if (input.kind === "chat" && !selfPlan) {
     const prior = mostRecentResumableSession(ctx, feature.id, "chat");
     if (prior?.ccSessionId) {
       resumedFrom = prior;
@@ -64919,12 +64989,13 @@ async function launchSession(ctx, input, opts = {}) {
   const kickoffLine = resumeSessionId && input.kind !== "chat" ? undefined : kickoffLineFor(input.kind, plan.line, runtime5.id);
   emit(ctx, feature.id, {
     type: "session.launching",
-    message: `launching ${input.kind} session`,
+    message: selfPlan ? "launching a self-planning run" : `launching ${input.kind} session`,
     data: {
       sessionId: session.id,
       kind: input.kind,
       worktreePath,
-      ...modelStamp(model)
+      ...modelStamp(model),
+      ...input.purpose ? { purpose: input.purpose } : {}
     }
   });
   if (resumeSessionId) {
@@ -64961,7 +65032,8 @@ async function launchSession(ctx, input, opts = {}) {
     model: model.id,
     resumeSessionId,
     resumeSourceSessionId: resumedFrom?.id,
-    kickoffLine
+    kickoffLine,
+    ...selfPlan ? { headless: true } : {}
   });
   if (opts.spawn === false) {
     emit(ctx, feature.id, {
@@ -65307,6 +65379,15 @@ function handlePtyExit(ctx, feature, session, meta, exitCode) {
       }
     });
   }
+  if (session.purpose === "self-plan" && feature) {
+    const current2 = getFeatureRow(ctx, feature.id);
+    const complete4 = current2.ticketsReadyLap === current2.lap;
+    emitForSession(ctx, session, {
+      type: "session.self_plan_ended",
+      message: complete4 ? "planning finished" : "planning stopped before the plan was complete",
+      data: { sessionId: session.id, complete: complete4, exitCode: exitCode ?? null }
+    });
+  }
   emitForSession(ctx, session, {
     type: "session.pty_exited",
     message: ptyExitMessage(exitCode),