@maycombhq/atticus 2.0.0-beta.22 → 2.0.0-beta.23

package/dist/{chunk-PJSJPMJI.js → chunk-FQVSLBTV.js}

@@ -9,7 +9,7 @@ import {
   namesInCode,
   openIndex,
   workspaceRepos
-} from "./chunk-ISUAAMGS.js";
+} from "./chunk-RCG5IAAT.js";
 
 // packages/cli/dist/code-tools.js
 var offered = /* @__PURE__ */ new Map();
@@ -21,7 +21,7 @@ function codeToolOptions(root) {
     codeDir: (r) => offered.get(r) ?? defaultCodeDir(root, r),
     repos: () => [.../* @__PURE__ */ new Set([...workspaceRepos(root), ...offered.keys()])].sort(),
     // Loaded on first use: the readers are large, and most commands never outline a file.
-    outline: async (path, text) => (await import("./chunk-H5HBGNXU.js")).declarationOutline(path, text)
+    outline: async (path, text) => (await import("./chunk-J25YOUIZ.js")).declarationOutline(path, text)
   };
 }
 function metarepoToolBox(root, calls) {
@@ -31,7 +31,7 @@ function metarepoToolBox(root, calls) {
   });
 }
 async function criticCodeSearch(root, names) {
-  const x = await import("./chunk-H5HBGNXU.js");
+  const x = await import("./chunk-J25YOUIZ.js");
   const r = await namesInCode(root, names, {
     ...codeToolOptions(root),
     outlines: (path) => x.syntaxLanguageOf(path) !== void 0

package/dist/{chunk-NXJ5URP6.js → chunk-FRAEQVYN.js}

@@ -13,29 +13,30 @@ import {
   prepareAudit,
   tallyWords,
   writeAudit
-} from "./chunk-AJQ72EBM.js";
-import "./chunk-RGERPOIV.js";
-import "./chunk-OUBGGKDU.js";
-import "./chunk-XI2LCCYQ.js";
-import "./chunk-BPK5P77O.js";
-import "./chunk-WXFLMQSR.js";
-import "./chunk-TYQBFTBR.js";
-import "./chunk-2F4CYZKJ.js";
-import "./chunk-LO6P2VYG.js";
-import "./chunk-BEVTIBRH.js";
-import "./chunk-J2JAKCIW.js";
-import "./chunk-745DAZ4L.js";
-import "./chunk-CXJ6FUKN.js";
-import "./chunk-QKUJMING.js";
-import "./chunk-6ZGLAACW.js";
-import "./chunk-CQDGOPGH.js";
-import "./chunk-3NFFJL5D.js";
-import "./chunk-UPS2DGFC.js";
-import "./chunk-PKBHS4AA.js";
-import "./chunk-P32RUW3B.js";
+} from "./chunk-HUGQZQ2K.js";
+import "./chunk-T6MX7WXM.js";
+import "./chunk-EHXDB3SA.js";
+import "./chunk-IMZFOMVX.js";
+import "./chunk-VJFXQISZ.js";
+import "./chunk-CT6NINGR.js";
+import "./chunk-ZLQEQR3D.js";
+import "./chunk-OPWGPQ2N.js";
+import "./chunk-73GFVW2L.js";
+import "./chunk-XOMEQVLK.js";
+import "./chunk-J4CPHJUL.js";
+import "./chunk-IKAW2KJU.js";
+import "./chunk-CZ2ZS7AT.js";
+import "./chunk-4GAB5ZOZ.js";
+import "./chunk-A4JXVO5O.js";
+import "./chunk-TDSCKP3V.js";
+import "./chunk-G6EFXTUO.js";
+import "./chunk-PQQKZPBU.js";
+import "./chunk-RRQUQAXP.js";
+import "./chunk-3EWKO457.js";
+import "./chunk-3424TLIJ.js";
 import "./chunk-QA4O2GGC.js";
-import "./chunk-Q2TECDIT.js";
-import "./chunk-TUULXQRW.js";
+import "./chunk-FPBUTZI5.js";
+import "./chunk-B4AEL3RF.js";
 import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 export {

package/dist/{chunk-RLDGWLQ7.js → chunk-FRCOKUU4.js}

@@ -62,14 +62,14 @@ import {
   specEndpointIds,
   specFormatOf,
   vendorImpact
-} from "./chunk-QKUJMING.js";
-import "./chunk-6ZGLAACW.js";
-import "./chunk-CQDGOPGH.js";
-import "./chunk-3NFFJL5D.js";
-import "./chunk-P32RUW3B.js";
+} from "./chunk-A4JXVO5O.js";
+import "./chunk-TDSCKP3V.js";
+import "./chunk-G6EFXTUO.js";
+import "./chunk-PQQKZPBU.js";
+import "./chunk-3424TLIJ.js";
 import "./chunk-QA4O2GGC.js";
-import "./chunk-Q2TECDIT.js";
-import "./chunk-TUULXQRW.js";
+import "./chunk-FPBUTZI5.js";
+import "./chunk-B4AEL3RF.js";
 import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 export {

package/dist/{chunk-DCZWQLYT.js → chunk-FSN6JFXB.js}

@@ -5,10 +5,10 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   safeMessage
-} from "./chunk-S7FCV7S5.js";
+} from "./chunk-PXW2RZGQ.js";
 import {
   checkoutOf
-} from "./chunk-2F4CYZKJ.js";
+} from "./chunk-73GFVW2L.js";
 import {
   AI_LINE_BY,
   AnswerMatch,
@@ -47,6 +47,7 @@ import {
   parseAuditFile,
   parseCorrections,
   parseFacts,
+  personEditOfTo,
   proposalRelOf,
   questionAiProblem,
   questionBar,
@@ -56,12 +57,12 @@ import {
   ruleKindOf,
   writeBatch,
   writeQuestion
-} from "./chunk-Q2TECDIT.js";
+} from "./chunk-FPBUTZI5.js";
 import {
   FileChangedError,
   withSharedFileLock,
   writeFileAtomic
-} from "./chunk-TUULXQRW.js";
+} from "./chunk-B4AEL3RF.js";
 
 // packages/cli/dist/ai-decide.js
 import { mkdir, readdir, readFile, rm, stat } from "node:fs/promises";
@@ -136,7 +137,7 @@ async function coversCall(match, f, facts) {
   const s = subjectOfCall(f);
   if (s?.topic)
     return matchCovers(match, s);
-  const { ruleCoversCall } = await import("./chunk-IFKEI4SA.js");
+  const { ruleCoversCall } = await import("./chunk-BUUJ7N4O.js");
   return ruleCoversCall(match, f, facts, { strict: true });
 }
 async function answeredByPerson(root, repo, facts) {
@@ -144,7 +145,7 @@ async function answeredByPerson(root, repo, facts) {
   const people = questions.filter((q) => q.state === "answered" && !!q.answer && !isAiBy(q.answer.by));
   if (!people.length)
     return /* @__PURE__ */ new Set();
-  const { estateRepos, targetsFromAnswers, TARGETS_SPLIT } = await import("./chunk-IFKEI4SA.js");
+  const { estateRepos, targetsFromAnswers, TARGETS_SPLIT } = await import("./chunk-BUUJ7N4O.js");
   const byRepo = /* @__PURE__ */ new Map([[repo, facts]]);
   const out = new Set(people.filter((q) => q.repo === repo && q.options[(q.answer.option ?? 0) - 1]?.label !== TARGETS_SPLIT).flatMap((q) => callsOfQuestion(q, byRepo).map((c) => c.id)));
   const op = await loadOrgPack(orgPackDirOf(root));
@@ -337,7 +338,7 @@ async function decideLinks(root, o) {
       const byPerson = await answeredByPerson(root, o.view.from, o.facts);
       return lines.filter((l) => {
         const f = calls.get(l);
-        if (linksFor(f, now).some((c) => !c.ai))
+        if (linksFor(f, now).some((c) => !c.ai) || personEditOfTo(f, now))
           return false;
         if (byPerson.has(f.id)) {
           answered.add(l);
@@ -387,7 +388,7 @@ async function targetRuleVerdict(root, q, label, questions) {
   if (!calls.length)
     return void 0;
   const op = await loadOrgPack(orgPackDirOf(root));
-  const { estateRepos, ruledTargets } = await import("./chunk-IFKEI4SA.js");
+  const { estateRepos, ruledTargets } = await import("./chunk-BUUJ7N4O.js");
   const repoType = estateRepos(op).find((r) => r.id === q.repo)?.type;
   const ruled = ruledTargets(q.repo, facts, questions, {
     ...repoType ? { repoType } : {},
@@ -404,7 +405,7 @@ async function personLinkVerdict(root, q, label) {
   if (!calls.length)
     return void 0;
   const corrections = await correctionsOf(root, q.repo);
-  if (calls.some((c) => linksFor(c, corrections).some((l) => !l.ai)))
+  if (calls.some((c) => linksFor(c, corrections).some((l) => !l.ai) || personEditOfTo(c, corrections)))
     return "a person said where its call goes on the canvas (a pairing or none): their word stands";
   const rules = await linkRulesOf(root, q.repo);
   for (const c of calls)
@@ -457,7 +458,7 @@ async function decideAnswers(root, o) {
       continue;
     }
     const label = q.options[option - 1].label;
-    const { TARGETS_NO_EVIDENCE } = await import("./chunk-IFKEI4SA.js");
+    const { TARGETS_NO_EVIDENCE } = await import("./chunk-BUUJ7N4O.js");
     const shapesFirst = option === 1 && !q.options[0].means.includes(TARGETS_NO_EVIDENCE);
     const rule = await targetRuleVerdict(root, q, label, everyTarget);
     if (rule === "against") {
@@ -584,8 +585,8 @@ async function decisionsView(root) {
       qCounts.byPerson++;
   }
   const linkCounts = { fromCode: 0, byPerson: 0, byAi: 0 };
-  const { readCatalog } = await import("./chunk-IFKEI4SA.js");
-  const cat = await readCatalog(join(catalogDirOf(root), "generated")).catch(() => void 0);
+  const { readCatalog } = await import("./chunk-BUUJ7N4O.js");
+  const cat = await readCatalog(join(catalogDirOf(root), "generated"), { cacheRoot: root }).catch(() => void 0);
   for (const r of cat?.records ?? []) {
     if (r.kind !== "Interface")
       continue;
@@ -749,7 +750,7 @@ async function correctQuestion(root, req, o) {
   }
   const spread = plans.map((p) => p.view);
   const op = await loadOrgPack(orgPackDirOf(root));
-  const { estateRepos } = await import("./chunk-IFKEI4SA.js");
+  const { estateRepos } = await import("./chunk-BUUJ7N4O.js");
   const repoType = estateRepos(op).find((r) => r.id === q.repo)?.type;
   const shape = `question:${repoType ?? q.repo}:${rule?.match ?? calls[0]?.path ?? q.id}`;
   const n = await shapeCount(root, shape);
@@ -892,7 +893,7 @@ async function correctLink(root, req, o) {
   const appliedItems = [{ kind: "link", repo, fact: f.id, line: ownLine }];
   const revertedItems = [];
   if (rule) {
-    const { candidatesOf, settingsOf } = await import("./chunk-KN5BXMWN.js");
+    const { candidatesOf, settingsOf } = await import("./chunk-W4TNCEI4.js");
     const box = { repo: target ?? aiRepo };
     const cands = box.repo !== repo ? await candidatesOf(root, repo, box).catch(() => void 0) : void 0;
     const loose = new Set((cands?.view.calls ?? []).filter((c) => c.status !== "paired").map((c) => c.fact));
@@ -922,6 +923,8 @@ async function correctLink(root, req, o) {
       const st = linksFor(c, corrections)[0];
       if (st && !st.ai)
         continue;
+      if (personEditOfTo(c, corrections))
+        continue;
       if (byPerson.has(c.id))
         continue;
       const item = `link:${repo}:${c.id}`;
@@ -969,7 +972,7 @@ async function correctLink(root, req, o) {
     }
   }
   const op = await loadOrgPack(orgPackDirOf(root));
-  const { estateRepos } = await import("./chunk-IFKEI4SA.js");
+  const { estateRepos } = await import("./chunk-BUUJ7N4O.js");
   const repoType = estateRepos(op).find((r) => r.id === repo)?.type;
   const shape = `link:${repoType ?? repo}:${rule?.match ?? f.path}`;
   const n = await shapeCount(root, shape);

package/dist/{chunk-W7VWI2YH.js → chunk-FTLYXMHA.js}

@@ -6,13 +6,13 @@ var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   openIndex,
   searchIndex
-} from "./chunk-ISUAAMGS.js";
-import "./chunk-P32RUW3B.js";
+} from "./chunk-RCG5IAAT.js";
+import "./chunk-3424TLIJ.js";
 import "./chunk-QA4O2GGC.js";
 import {
   changesDirOf
-} from "./chunk-Q2TECDIT.js";
-import "./chunk-TUULXQRW.js";
+} from "./chunk-FPBUTZI5.js";
+import "./chunk-B4AEL3RF.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";
@@ -121,7 +121,7 @@ async function pastChangeMarkdown(root, folder) {
 `;
 }
 async function attachPastChange(root, change, folder, by, now = /* @__PURE__ */ new Date()) {
-  const { attachFiles } = await import("./chunk-LDLL7LB3.js");
+  const { attachFiles } = await import("./chunk-ISG547IS.js");
   const name = `like-${folder.replace(DATED, "$2")}.md`;
   await attachFiles(root, change, [{ name, bytes: new TextEncoder().encode(await pastChangeMarkdown(root, folder)) }], by, now);
   return name;

package/dist/{chunk-7GJS6DNX.js → chunk-FVYZ4Y52.js}

@@ -6,6 +6,7 @@ var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   GitError,
   IGNORED,
+  SAME_ID_WHY,
   WORKSPACE_DIR,
   WorkspaceFileError,
   baseClonePath,
@@ -17,6 +18,7 @@ import {
   changedFiles,
   changesSince,
   checkoutState,
+  cloneUrlKey,
   createGit,
   createWorkspace,
   ensureGitignore,
@@ -30,9 +32,11 @@ import {
   legacyBranchSlug,
   loadManifest,
   loadRepos,
+  nearRepos,
   readChangeRepos,
   remoteDefaultBranch,
   removeEditorWorkspaces,
+  repoIdKey,
   toHandle,
   toRepoRelative,
   vscodeWorkspace,
@@ -40,14 +44,15 @@ import {
   worktreePath,
   writeChangeRepos,
   writeEditorWorkspaces
-} from "./chunk-PKBHS4AA.js";
-import "./chunk-Q2TECDIT.js";
-import "./chunk-TUULXQRW.js";
+} from "./chunk-3EWKO457.js";
+import "./chunk-FPBUTZI5.js";
+import "./chunk-B4AEL3RF.js";
 import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 export {
   GitError,
   IGNORED,
+  SAME_ID_WHY,
   WORKSPACE_DIR,
   WorkspaceFileError,
   baseClonePath,
@@ -59,6 +64,7 @@ export {
   changedFiles,
   changesSince,
   checkoutState,
+  cloneUrlKey,
   createGit,
   createWorkspace,
   ensureGitignore,
@@ -72,9 +78,11 @@ export {
   legacyBranchSlug,
   loadManifest,
   loadRepos,
+  nearRepos,
   readChangeRepos,
   remoteDefaultBranch,
   removeEditorWorkspaces,
+  repoIdKey,
   toHandle,
   toRepoRelative,
   vscodeWorkspace,

package/dist/{chunk-CQDGOPGH.js → chunk-G6EFXTUO.js}

@@ -10,7 +10,7 @@ import {
   globToRegExp,
   memoryRepo,
   scanRepo
-} from "./chunk-3NFFJL5D.js";
+} from "./chunk-PQQKZPBU.js";
 import {
   Dialect,
   FrameworkModel,
@@ -26,7 +26,7 @@ import {
   readZip,
   renderExpr,
   renderTemplate
-} from "./chunk-Q2TECDIT.js";
+} from "./chunk-FPBUTZI5.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";

package/dist/{chunk-JB5LINEM.js → chunk-G7VBMOZH.js}

@@ -8,7 +8,7 @@ import {
   executorsCheck,
   inputsSha256,
   runStep
-} from "./chunk-6OJQOPUN.js";
+} from "./chunk-VKTXFFOZ.js";
 import {
   table
 } from "./chunk-VOGCSYOI.js";
@@ -17,7 +17,7 @@ import {
   exportStep,
   fileStepStore,
   recordStep
-} from "./chunk-7IGKHZ4Z.js";
+} from "./chunk-FL344WQD.js";
 
 // packages/cli/dist/todo-commands.js
 var iso = (d) => d.toISOString().replace(/\.\d{3}Z$/, "Z");
@@ -147,7 +147,7 @@ async function todoDone(root, stepRef, o, io, deps = {}) {
     });
     io.out(done.state === "skipped" ? `Skipped step ${done.id}: ${o.note}` : `Recorded step ${done.id}${Object.keys(done.recorded?.values ?? {}).length ? `: ${Object.entries(done.recorded.values).map(([k, v]) => `${k} ${Array.isArray(v) ? v.join(", ") : String(v)}`).join(", ")}` : ""}.`);
     if (deps.sync !== false) {
-      const { syncAfterManualStep } = await import("./chunk-SFSPGFCV.js");
+      const { syncAfterManualStep } = await import("./chunk-J32IPTVQ.js");
       await syncAfterManualStep(root, done, o.by, io, deps.sync ?? {});
     }
     return 0;

package/dist/{chunk-7ASNL4Q4.js → chunk-GM4EFHUX.js}

@@ -5,14 +5,14 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   intakeContext
-} from "./chunk-SFUP7TTO.js";
+} from "./chunk-C6ORPLCN.js";
 import "./chunk-VOGCSYOI.js";
 import {
   changeFolder,
   changeStore
-} from "./chunk-IDKCWSM5.js";
-import "./chunk-UUU4CLJG.js";
-import "./chunk-7IGKHZ4Z.js";
+} from "./chunk-WZYM5M4U.js";
+import "./chunk-NC755EKE.js";
+import "./chunk-FL344WQD.js";
 import {
   estateFacts,
   estateRepos,
@@ -20,19 +20,19 @@ import {
   joinReposOf,
   outsideProfileSystems,
   outsideSystems
-} from "./chunk-J2JAKCIW.js";
-import "./chunk-745DAZ4L.js";
-import "./chunk-CXJ6FUKN.js";
+} from "./chunk-IKAW2KJU.js";
+import "./chunk-CZ2ZS7AT.js";
+import "./chunk-4GAB5ZOZ.js";
 import {
   attachToChange,
   readChangeInputs,
   readVendorSpec
-} from "./chunk-QKUJMING.js";
-import "./chunk-6ZGLAACW.js";
-import "./chunk-CQDGOPGH.js";
-import "./chunk-3NFFJL5D.js";
-import "./chunk-PKBHS4AA.js";
-import "./chunk-P32RUW3B.js";
+} from "./chunk-A4JXVO5O.js";
+import "./chunk-TDSCKP3V.js";
+import "./chunk-G6EFXTUO.js";
+import "./chunk-PQQKZPBU.js";
+import "./chunk-3EWKO457.js";
+import "./chunk-3424TLIJ.js";
 import "./chunk-QA4O2GGC.js";
 import {
   PROTOTYPE_GROUPS,
@@ -43,8 +43,8 @@ import {
   joinConventions,
   parseFacts,
   prototypeArchitectureSection
-} from "./chunk-Q2TECDIT.js";
-import "./chunk-TUULXQRW.js";
+} from "./chunk-FPBUTZI5.js";
+import "./chunk-B4AEL3RF.js";
 import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 

package/dist/chunk-GOZLTLRY.js

@@ -0,0 +1,232 @@
+import { createRequire as __atticusCreateRequire } from "node:module";
+import { fileURLToPath as __atticusFileURLToPath } from "node:url";
+var require = __atticusCreateRequire(import.meta.url);
+var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
+var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
+import {
+  listRuns
+} from "./chunk-IYNCSYU4.js";
+import {
+  isHandoffStep
+} from "./chunk-4Q3NN7VF.js";
+import {
+  withFileLock
+} from "./chunk-PXW2RZGQ.js";
+import {
+  forgetUserState,
+  readUserState,
+  writeUserState
+} from "./chunk-KVVNAUIG.js";
+import {
+  runsDirOf
+} from "./chunk-FPBUTZI5.js";
+import {
+  writeFileIfUnchanged
+} from "./chunk-B4AEL3RF.js";
+
+// packages/cli/dist/handoff-resume.js
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+var STAGE_PAGES = [
+  [
+    /^atticus change feature \S+(?: --\S+(?: \S+)?)*$/,
+    "prepare the feature stage again on Feature design"
+  ],
+  [
+    /^atticus change architecture \S+(?: --\S+(?: \S+)?)*$/,
+    "prepare the architecture stage again on Architecture"
+  ],
+  [/^atticus plan stories \S+(?: --\S+(?: \S+)?)*$/, "prepare the stories stage again on Stories"],
+  [/^atticus change small \S+(?: --\S+(?: \S+)?)*$/, "prepare its one step again on At a glance"]
+];
+var againWords = (command) => STAGE_PAGES.find(([re]) => re.test(command))?.[1] ?? "prepare it again on the page you prepared it from";
+function appLines(lines, o = {}) {
+  const ready = o.next ? "The next prompt is ready in the stage's thread." : "The prompt is ready in the stage's thread: paste it into your assistant. The app checks the answer once your assistant has written the file.";
+  return lines.map((l) => l.replace(/\s*When it is done(?:, run)?: atticus handoff done \S+.*$/, ` ${ready}`).replace(/\s*(?:Next:\s*|[Rr]un:?\s*)?atticus [^\n]*?--resume run-[0-9a-z-]+(?::[^\n]*|\.)?$/, " The next prompt is ready in the stage's thread.").replace(/,? (?:and|then) run atticus handoff done \S+ again/g, ", then press Done again").replace(/\b([Rr])un atticus handoff done \S+ again/g, (_m, r) => r === "R" ? "Press Done again" : "press Done again").replace(/: pull \S+, then run atticus change learn\.$/, ": Bring in what merged on Home; the comparison with what Atticus drafted is kept the next time the drafts are measured.").replace(/^Answer each with atticus questions answer <id> .*, or with \/atticus-answer\.$/, "Answer each on Questions.").replace(/\b([Tt])hen run (atticus [^:]+?) again\b/, (_m, t, cmd) => `${t}hen ${againWords(cmd)}`).replace(/^Open the stage's pull request for a person to approve: .*$/, "Raise the stage's hand-off on the change page for a person to approve.").replace(/^No checkout of (\S+): clone it \(atticus workspace sync\) or give its folder with --dir\.$/, "No checkout of $1 on this machine: Sync the repos to clone it, then try again.").replace(/^(No repo has facts yet \([^)]*\))\. Read one first: \/atticus-map <repo> in your assistant\.$/, "$1. Read one first on Map \u203A Trust.").replace(/^(No facts for (\S+) at \S+)\. Run \/atticus-map \S+ in your assistant first \(or atticus map \S+ to read it in batches\); it writes that file\.$/, "$1. Read $2 first on Map \u203A Trust; the read writes that file.").replace(/^(There are no repo specs in \S+ yet)\. Draft them first: atticus spec draft <repo>\.$/, "$1: read a repo on Map \u203A Trust and apply it, which writes its spec.").trimStart());
+}
+var resumeFile = (runId) => {
+  if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(runId))
+    throw new Error(`${runId} isn't a run id.`);
+  return `resume/${runId}.json`;
+};
+async function hasKeptResume(root, runId) {
+  return !!await readUserState(root, resumeFile(runId)).catch(() => void 0);
+}
+function resumedRunOf(argv) {
+  const isRun = (v) => !!v && /^run-[0-9A-Za-z._-]+$/.test(v);
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--resume" && isRun(argv[i + 1]))
+      return argv[i + 1];
+    if (a.startsWith("--resume=") && isRun(a.slice("--resume=".length)))
+      return a.slice("--resume=".length);
+  }
+  return void 0;
+}
+async function forgetKeptResume(root, runId) {
+  await forgetUserState(root, resumeFile(runId)).catch(() => void 0);
+}
+var SOURCE_STEPS = /* @__PURE__ */ new Set(["knowledge scan", "knowledge find"]);
+var FORCE_STEPS = /* @__PURE__ */ new Set(["plan stories"]);
+function resumeRefusal(args, runId) {
+  if (!Array.isArray(args) || !args.every((a) => typeof a === "string" && a !== ""))
+    return "it isn't a step's words";
+  const words = args;
+  if (!isHandoffStep(words[0], words[1]))
+    return `atticus ${words.slice(0, 2).join(" ")} isn't an AI step the app prepares`;
+  let resumed = false;
+  let source = false;
+  for (let i = 2; i < words.length; i++) {
+    const a = words[i];
+    if (!a.startsWith("-"))
+      continue;
+    if (a === "--handoff")
+      continue;
+    if (a === "--resume" && !resumed && words[i + 1] === runId) {
+      resumed = true;
+      i++;
+      continue;
+    }
+    if (a === "--force" && FORCE_STEPS.has(`${words[0]} ${words[1]}`))
+      continue;
+    const value = words[i + 1];
+    if (a === "--source" && !source && SOURCE_STEPS.has(`${words[0]} ${words[1]}`) && value && !value.startsWith("-")) {
+      source = true;
+      i++;
+      continue;
+    }
+    return `it names ${a}${a === "--resume" ? " for another run" : ""}, which a step's resume never does`;
+  }
+  return resumed ? void 0 : `it doesn't resume ${runId}`;
+}
+function ownWords(args) {
+  const out = [];
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === "--handoff" || a === "--json")
+      continue;
+    if (a === "--resume") {
+      i++;
+      continue;
+    }
+    out.push(a);
+  }
+  return out;
+}
+async function keepResume(root, change, runId, args) {
+  await writeUserState(root, resumeFile(runId), { change, runId, args });
+}
+async function supersede(root, change, runId, by) {
+  const file = join(runsDirOf(root), change, runId, "run.json");
+  const was = await readFile(file, "utf8").catch(() => void 0);
+  if (was === void 0)
+    return false;
+  let rec;
+  try {
+    rec = JSON.parse(was);
+  } catch {
+    return false;
+  }
+  if (rec.state !== "waiting" && rec.state !== "prepared")
+    return false;
+  rec.state = "cancelled";
+  rec.finishedAt = (/* @__PURE__ */ new Date()).toISOString();
+  rec.errors = [
+    `Superseded by run ${by}: the step was prepared again, so this run's answer is no longer read.`
+  ];
+  await writeFileIfUnchanged(file, was, JSON.stringify(rec, null, 2) + "\n").catch(() => void 0);
+  await forgetUserState(root, resumeFile(runId)).catch(() => void 0);
+  return true;
+}
+async function prepareStep(root, runStep, args, o = {}) {
+  const res = await runStep([...args, "--handoff", "--json"]);
+  const lines = [...res.out, ...res.err];
+  const json = [...res.out].reverse().find((l) => l.trim().startsWith("{"));
+  let h = {};
+  try {
+    h = json ? JSON.parse(json) : {};
+  } catch {
+    h = {};
+  }
+  const said = appLines([
+    ...lines.filter((l) => !l.trim().startsWith("{")),
+    ...h.messages ?? [],
+    ...h.errors ?? [],
+    ...(h.questions ?? []).map((q) => `Question ${q.id}: ${q.question} (answer it on Questions)`),
+    ...h.pagesLeft ? [`${h.pagesLeft} pages are left for the next part: Prepare it again.`] : []
+  ], o);
+  if (h.state !== "handoff" || !h.runId)
+    return { code: res.code, prepared: { lines: said } };
+  const runs = await listRuns(root, { limit: 1e5 });
+  const run = runs.find((x) => x.runId === h.runId);
+  if (run && h.resumeArgs) {
+    const resume = [...ownWords(args), "--resume", run.runId];
+    if (!resumeRefusal(resume, run.runId))
+      await keepResume(root, run.change, run.runId, resume).catch(() => void 0);
+  }
+  if (run && !h.stillWaiting) {
+    const mine = JSON.stringify(ownWords(args));
+    for (const x of runs) {
+      if (x.runId === run.runId || x.change !== run.change)
+        continue;
+      if (x.state !== "waiting" && x.state !== "prepared")
+        continue;
+      const kept = await readUserState(root, resumeFile(x.runId)).catch(() => void 0);
+      if (!Array.isArray(kept?.args) || JSON.stringify(ownWords(kept.args)) !== mine)
+        continue;
+      if (await supersede(root, x.change, x.runId, run.runId))
+        said.push(`Run ${x.runId} was waiting for the same step: it is cancelled.`);
+    }
+  }
+  return {
+    code: res.code,
+    prepared: {
+      runId: h.runId,
+      lines: said,
+      ...h.stillWaiting ? { stillWaiting: true } : {}
+    }
+  };
+}
+function resumeAfterDone(root, runStep, change, runId) {
+  return withFileLock(join(runsDirOf(root), change, runId, "resume"), () => resumeOnce(root, runStep, change, runId));
+}
+async function resumeOnce(root, runStep, change, runId) {
+  const kept = await readUserState(root, resumeFile(runId));
+  if (!kept)
+    return void 0;
+  const no = kept.runId !== runId || kept.change !== change ? "it was kept for another run" : resumeRefusal(kept.args, runId);
+  if (no)
+    return {
+      lines: [
+        `The step's resume for ${runId} wasn't run: ${no}. Prepare the step again from the page you prepared it on.`
+      ]
+    };
+  await forgetUserState(root, resumeFile(runId)).catch(() => void 0);
+  const words = kept.args.filter((a) => a !== "--handoff");
+  const r = await prepareStep(root, runStep, words, { next: true });
+  if (r.prepared.runId && r.prepared.runId !== runId)
+    return { next: r.prepared.runId, lines: r.prepared.lines };
+  const repo = mapRepoOf(words);
+  if (repo && !r.prepared.runId) {
+    const v = await runStep(["verify", repo, "--write"]);
+    return { lines: [...r.prepared.lines, ...appLines([...v.out, ...v.err])], applied: repo };
+  }
+  return { lines: r.prepared.lines };
+}
+function mapRepoOf(words) {
+  return words[0] === "map" && words[1] && !words[1].startsWith("-") ? words[1] : void 0;
+}
+
+export {
+  appLines,
+  hasKeptResume,
+  resumedRunOf,
+  forgetKeptResume,
+  SOURCE_STEPS,
+  FORCE_STEPS,
+  resumeRefusal,
+  keepResume,
+  prepareStep,
+  resumeAfterDone,
+  mapRepoOf
+};