runcastle 1.4.4 → 1.4.7

package/index.js

@@ -44,7 +44,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 = {
@@ -263,7 +263,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()
@@ -1658,8 +1658,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) + `
@@ -2626,7 +2627,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);
@@ -2653,6 +2654,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();
@@ -3575,6 +3577,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);
@@ -4615,7 +4620,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();
@@ -4753,6 +4758,64 @@ var init_install_guard = __esm(() => {
   HEREDOC_OPENER = /(?<!<)<<(?!<)(-?)[ \t]*(?:'([^'\n]+)'|"([^"\n]+)"|\\?([\w.-]+))/g;
 });
 
+// src/launcher/skills-root.ts
+import { existsSync as existsSync7 } from "fs";
+import { dirname as dirname3, join as join7, resolve as resolve6 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
+function resolveSkillsRoot(fromDir) {
+  const override = process.env[SKILLS_DIR_ENV];
+  if (override) {
+    const root = resolve6(override);
+    if (existsSync7(join7(root, SKILLS_MARKER)))
+      return root;
+    throw new Error(`${SKILLS_DIR_ENV}=${override} is not a runcastle skills root (missing ${SKILLS_MARKER})`);
+  }
+  const searched = [];
+  let dir = fromDir;
+  for (let i = 0;i < 8; i += 1) {
+    const candidate = join7(dir, "packages", "skills");
+    searched.push(candidate);
+    if (existsSync7(join7(candidate, SKILLS_MARKER)))
+      return candidate;
+    const parent = dirname3(dir);
+    if (parent === dir)
+      break;
+    dir = parent;
+  }
+  throw new Error(`runcastle skills root not found; searched:
+  ${searched.join(`
+  `)}`);
+}
+function resolvePluginDir(fromDir = dirname3(fileURLToPath3(import.meta.url))) {
+  const rel = join7("packages", "skills", "packs", "runcastle");
+  const override = process.env[SKILLS_DIR_ENV];
+  if (override) {
+    const dir2 = join7(resolve6(override), "packs", "runcastle");
+    if (existsSync7(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 = join7(dir, rel);
+    searched.push(candidate);
+    if (existsSync7(candidate))
+      return candidate;
+    const parent = dirname3(dir);
+    if (parent === dir)
+      break;
+    dir = parent;
+  }
+  throw new Error(`runcastle plugin dir (${rel}) not found; searched:
+  ${searched.join(`
+  `)}`);
+}
+var SKILLS_DIR_ENV = "RUNCASTLE_SKILLS_DIR", SKILLS_MARKER;
+var init_skills_root = __esm(() => {
+  SKILLS_MARKER = join7("packs", "runcastle");
+});
+
 // src/launcher/runtimes/skills.ts
 function skillRef(runtime, skill) {
   return SPELLINGS[runtime](skill);
@@ -4773,6 +4836,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 {
@@ -4788,7 +4854,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}`,
@@ -4805,10 +4871,10 @@ var init_skills = __esm(() => {
 
 // src/launcher/artifacts.ts
 import { mkdirSync as mkdirSync3, writeFileSync as writeFileSync2 } from "fs";
-import { fileURLToPath as fileURLToPath3 } from "url";
-import { join as join7 } from "path";
+import { fileURLToPath as fileURLToPath4 } from "url";
+import { join as join8 } from "path";
 function hookClientPath() {
-  return resolveAsset(ASSET_ENV.hookClient, fileURLToPath3(new URL("./hook-client.ts", import.meta.url)));
+  return resolveAsset(ASSET_ENV.hookClient, fileURLToPath4(new URL("./hook-client.ts", import.meta.url)));
 }
 function serverUrlFor(config2) {
   return `http://localhost:${config2.serverPort}`;
@@ -4829,7 +4895,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);
@@ -4862,12 +4929,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 [
@@ -5237,6 +5318,10 @@ function renderProjectPrompt(brief, runtime = DEFAULT_RUNTIME) {
   ].join(`
 `);
 }
+function skillPackReadRule(packDir) {
+  const posix2 = packDir.replace(/\\/g, "/").replace(/^([A-Za-z]):/, (_, drive) => `/${drive.toLowerCase()}`).replace(/\/+$/, "");
+  return `Read(/${posix2}/**)`;
+}
 function entrySkillDenyRules(kind) {
   const allowed = new Set(entrySkillsFor(kind));
   return ENTRY_SKILLS.filter((skill) => !allowed.has(skill)).flatMap((skill) => [
@@ -5255,7 +5340,7 @@ function sessionBashAllowRules(kind) {
   }
   return SESSION_BASH_ALLOW_RULES;
 }
-function renderSettings(hookClient, kind) {
+function renderSettings(hookClient, kind, skillPackDir) {
   const cmd = (event) => ({
     type: "command",
     command: `bun run "${hookClient}" ${event}`,
@@ -5263,7 +5348,11 @@ function renderSettings(hookClient, kind) {
   });
   return {
     permissions: {
-      allow: [...RUNCASTLE_MCP_ALLOW_RULES, ...sessionBashAllowRules(kind)],
+      allow: [
+        ...RUNCASTLE_MCP_ALLOW_RULES,
+        ...sessionBashAllowRules(kind),
+        ...skillPackDir ? [skillPackReadRule(skillPackDir)] : []
+      ],
       deny: entrySkillDenyRules(kind)
     },
     hooks: {
@@ -5324,15 +5413,15 @@ function renderSessionPrompt(input) {
     return renderProjectPrompt(projectBrief, runtime);
   throw new Error(`session ${session.id} has no feature and no project-session brief`);
 }
-async function writeSessionArtifacts(input) {
+async function writeSessionArtifacts(input, pluginDir = resolvePluginDir()) {
   const { session, config: config2 } = input;
   const dir = sessionDir(session.id);
   mkdirSync3(dir, { recursive: true });
-  const systemPromptPath = join7(dir, "system-prompt.md");
-  const settingsPath = join7(dir, "settings.json");
-  const mcpConfigPath = join7(dir, "mcp.json");
+  const systemPromptPath = join8(dir, "system-prompt.md");
+  const settingsPath = join8(dir, "settings.json");
+  const mcpConfigPath = join8(dir, "mcp.json");
   writeFileSync2(systemPromptPath, renderSessionPrompt(input), "utf8");
-  writeFileSync2(settingsPath, JSON.stringify(renderSettings(hookClientPath(), session.kind), null, 2), "utf8");
+  writeFileSync2(settingsPath, JSON.stringify(renderSettings(hookClientPath(), session.kind, pluginDir), null, 2), "utf8");
   writeFileSync2(mcpConfigPath, JSON.stringify(renderMcpConfig(session, config2), null, 2), "utf8");
   return { systemPromptPath, settingsPath, mcpConfigPath };
 }
@@ -5344,6 +5433,7 @@ var init_artifacts = __esm(() => {
   init_asset_paths();
   init_edit_guard();
   init_install_guard();
+  init_skills_root();
   init_skills();
   RUNCASTLE_MCP_ALLOW_RULES = [
     "mcp__runcastle__get_feature_context",
@@ -5392,65 +5482,11 @@ var init_artifacts = __esm(() => {
   SESSION_START_SOURCES = ["startup", "resume", "clear", "compact", "fork"];
 });
 
-// src/launcher/skills-root.ts
-import { existsSync as existsSync7 } from "fs";
-import { dirname as dirname3, join as join8, resolve as resolve6 } from "path";
-import { fileURLToPath as fileURLToPath4 } from "url";
-function resolveSkillsRoot(fromDir) {
-  const override = process.env[SKILLS_DIR_ENV];
-  if (override) {
-    const root = resolve6(override);
-    if (existsSync7(join8(root, SKILLS_MARKER)))
-      return root;
-    throw new Error(`${SKILLS_DIR_ENV}=${override} is not a runcastle skills root (missing ${SKILLS_MARKER})`);
-  }
-  const searched = [];
-  let dir = fromDir;
-  for (let i = 0;i < 8; i += 1) {
-    const candidate = join8(dir, "packages", "skills");
-    searched.push(candidate);
-    if (existsSync7(join8(candidate, SKILLS_MARKER)))
-      return candidate;
-    const parent = dirname3(dir);
-    if (parent === dir)
-      break;
-    dir = parent;
-  }
-  throw new Error(`runcastle skills root not found; searched:
-  ${searched.join(`
-  `)}`);
-}
-function resolvePluginDir(fromDir = dirname3(fileURLToPath4(import.meta.url))) {
-  const rel = join8("packages", "skills", "packs", "runcastle");
-  const override = process.env[SKILLS_DIR_ENV];
-  if (override) {
-    const dir2 = join8(resolve6(override), "packs", "runcastle");
-    if (existsSync7(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 = join8(dir, rel);
-    searched.push(candidate);
-    if (existsSync7(candidate))
-      return candidate;
-    const parent = dirname3(dir);
-    if (parent === dir)
-      break;
-    dir = parent;
-  }
-  throw new Error(`runcastle plugin dir (${rel}) not found; searched:
-  ${searched.join(`
-  `)}`);
-}
-var SKILLS_DIR_ENV = "RUNCASTLE_SKILLS_DIR", SKILLS_MARKER;
-var init_skills_root = __esm(() => {
-  SKILLS_MARKER = join8("packs", "runcastle");
-});
-
 // 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}`);
@@ -5461,9 +5497,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,
@@ -5514,11 +5552,12 @@ var init_claude = __esm(() => {
       };
     },
     async writeArtifacts(input) {
-      const files = await writeSessionArtifacts({ ...input, runtime: this.id });
+      const pluginDir = resolvePluginDir();
+      const files = await writeSessionArtifacts({ ...input, runtime: this.id }, pluginDir);
       return {
         files: [files.systemPromptPath, files.settingsPath, files.mcpConfigPath],
         argv: buildClaudeArgs({
-          pluginDir: resolvePluginDir(),
+          pluginDir,
           settingsPath: files.settingsPath,
           mcpConfigPath: files.mcpConfigPath,
           systemPromptPath: files.systemPromptPath,
@@ -5526,7 +5565,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,
@@ -7136,12 +7176,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",
     "",
@@ -7155,6 +7199,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(`
 `);
@@ -7263,6 +7308,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",
@@ -7335,7 +7383,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,
@@ -7970,6 +8019,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);
@@ -8002,6 +8057,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();
@@ -57790,6 +57846,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()) {
@@ -60552,6 +60609,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;
@@ -61659,6 +61717,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)
   };
@@ -62787,6 +62846,24 @@ async function commitDocsCheckpoint(ctx, session, summary) {
   }
   await landChatCommits(ctx, project3, feature);
 }
+function checkpointDocsAfterReply(ctx, session, summary) {
+  let queue = docsCheckpointQueues.get(session.worktreePath);
+  if (!queue) {
+    queue = createSerialQueue();
+    docsCheckpointQueues.set(session.worktreePath, queue);
+  }
+  queue(() => commitDocsCheckpoint(ctx, session, summary)).catch((e) => {
+    try {
+      emit(ctx, requireFeatureId(session), {
+        type: "git.commit_pending",
+        message: `docs checkpoint failed: ${e instanceof Error ? e.message : String(e)}`,
+        data: { summary }
+      });
+    } catch (err) {
+      console.error(`docs checkpoint failed for session ${session.id}`, e, err);
+    }
+  });
+}
 function requireProject(ctx, session) {
   if (!session.projectId) {
     throw new GateError(`this tool belongs to a project-scoped session; this is a ${session.kind} session on a ` + "feature. Use get_feature_context and the pipeline tools for feature work.");
@@ -63527,7 +63604,7 @@ function buildMcpServer(audience) {
       if (!rs)
         return noSession();
       const result = toolEmitTickets(rs.ctx, rs.session, args2);
-      await commitDocsCheckpoint(rs.ctx, rs.session, `tickets emitted (${result.stored})`);
+      checkpointDocsAfterReply(rs.ctx, rs.session, `tickets emitted (${result.stored})`);
       return ok(result);
     });
   }
@@ -63549,7 +63626,7 @@ function buildMcpServer(audience) {
       if (!rs)
         return noSession();
       const result = toolUpdateTicket(rs.ctx, rs.session, args2);
-      await commitDocsCheckpoint(rs.ctx, rs.session, `ticket ${result.ticket.seq} updated`);
+      checkpointDocsAfterReply(rs.ctx, rs.session, `ticket ${result.ticket.seq} updated`);
       return ok(result);
     });
   }
@@ -63566,7 +63643,7 @@ function buildMcpServer(audience) {
       if (!rs)
         return noSession();
       const result = toolCancelTicket(rs.ctx, rs.session, args2);
-      await commitDocsCheckpoint(rs.ctx, rs.session, `ticket ${result.ticket.seq} cancelled`);
+      checkpointDocsAfterReply(rs.ctx, rs.session, `ticket ${result.ticket.seq} cancelled`);
       return ok(result);
     });
   }
@@ -63610,7 +63687,7 @@ function buildMcpServer(audience) {
         return noSession();
       const result = toolCompletePhase(rs.ctx, rs.session, args2);
       if (result.ok) {
-        await commitDocsCheckpoint(rs.ctx, rs.session, `phase '${args2.phase}' complete`);
+        checkpointDocsAfterReply(rs.ctx, rs.session, `phase '${args2.phase}' complete`);
       }
       return ok(result);
     });
@@ -63643,7 +63720,7 @@ async function readMcpBody(c) {
     return;
   }
 }
-var DOCS_NOTE, TICKETS_NOTE, REVIEW_TITLE, ResolveFindingShape, ResolveFindingInput, DRAFTING_KINDS, ADRS_NOTE, FEATURE_INDEX_NOTE, FEATURE_INDEX_SHIPPED_CAP = 50, WORK_RECORD_DIGESTS_NOTE, FEATURE_KINDS, PROJECT_KINDS, ALL_AUDIENCES, TOOL_AUDIENCES, CompletablePhase, EventType, mcp, server_default;
+var DOCS_NOTE, TICKETS_NOTE, REVIEW_TITLE, ResolveFindingShape, ResolveFindingInput, docsCheckpointQueues, DRAFTING_KINDS, ADRS_NOTE, FEATURE_INDEX_NOTE, FEATURE_INDEX_SHIPPED_CAP = 50, WORK_RECORD_DIGESTS_NOTE, FEATURE_KINDS, PROJECT_KINDS, ALL_AUDIENCES, TOOL_AUDIENCES, CompletablePhase, EventType, mcp, server_default;
 var init_server = __esm(() => {
   init_src();
   init_paths();
@@ -63662,6 +63739,7 @@ var init_server = __esm(() => {
   init_review_findings();
   init_git();
   init_knowledge();
+  init_landing_queue();
   init_planning();
   init_project_notes();
   init_repo();
@@ -63686,6 +63764,7 @@ var init_server = __esm(() => {
       });
     }
   });
+  docsCheckpointQueues = new Map;
   DRAFTING_KINDS = ["chat"];
   ADRS_NOTE = "adrs[] is an index of the project\u2019s LIVE decisions (superseded ones are already omitted), not " + "their text. Read the ones your work touches with read_adr({ relPath }) \u2014 they bind you the " + "same either way. They are also plain files in this worktree at docs/adr/.";
   FEATURE_INDEX_NOTE = "featureIndex lists every in-flight feature, then every draft, then the most recently shipped, " + "one `slug \u2014 title [state]` line each. A trailing `\xB7 waits on: a, b \u2713` lists the features it " + "must wait to merge (\u2713 = already shipped), and `[draft, waiting]` marks a draft that cannot " + "start until every unmarked one ships. A shipped feature\u2019s docs live at docs/features/<slug>/ " + "in this worktree; an in-flight or draft feature\u2019s docs live on an unmerged branch. Any " + "feature\u2019s brief is read_feature_brief({ slug }); what one actually did is " + "get_work_record({ featureSlug }).";
@@ -64724,7 +64803,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);
@@ -64737,7 +64816,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) {
@@ -64764,6 +64842,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);
@@ -64845,7 +64938,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);
@@ -64865,8 +64962,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;
@@ -64879,6 +64977,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;
@@ -64918,12 +65018,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) {
@@ -64960,7 +65061,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, {
@@ -65306,6 +65408,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),
@@ -65892,8 +66003,8 @@ var init_transcripts = __esm(() => {
 
 // src/services/conversations.ts
 function withoutKickoff(turns, kind, runtime5) {
-  const kickoff = kickoffLineFor(kind, undefined, runtime5);
-  return turns.filter((turn) => !(turn.role === "user" && promptMatchesKickoff(kickoff, turn.text)));
+  const kickoffs = [kickoffLineFor(kind, undefined, runtime5), selfPlanKickoffFor(runtime5)];
+  return turns.filter((turn) => !(turn.role === "user" && kickoffs.some((kickoff) => promptMatchesKickoff(kickoff, turn.text))));
 }
 function promptMatchesKickoff(line, prompt) {
   if (!prompt)
@@ -65987,6 +66098,7 @@ var TITLE_MAX = 60, MATCH_PREFIX = 40, INTERRUPTED = "[Request interrupted by us
 var init_conversations = __esm(() => {
   init_src();
   init_sessions();
+  init_skills();
   init_transcripts();
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcastle",
-  "version": "1.4.4",
+  "version": "1.4.7",
   "description": "Burn tickets into shipped features with Claude Code.",
   "license": "FSL-1.1-ALv2",
   "type": "module",