@maycombhq/atticus 2.0.0-beta.11 → 2.0.0-beta.12

package/dist/{chunk-OR5VRULZ.js → chunk-6ENDKY52.js}

@@ -6,17 +6,17 @@ var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   forgetCatalogs,
   readCatalog
-} from "./chunk-IILZ7J3L.js";
-import "./chunk-TEBBD4XH.js";
-import "./chunk-XPWSNKF3.js";
-import "./chunk-WIMOJMAK.js";
-import "./chunk-5V5BJACL.js";
-import "./chunk-GVFUEGGM.js";
+} from "./chunk-22GLUHGE.js";
+import "./chunk-QR65C3DV.js";
+import "./chunk-MLAACAES.js";
+import "./chunk-HY2VVVFZ.js";
+import "./chunk-PJRMMWU4.js";
+import "./chunk-34NWVIBC.js";
 import {
   loadRepos
-} from "./chunk-XZJE6WIT.js";
-import "./chunk-FMRMTI7W.js";
-import "./chunk-BKFGGJKA.js";
+} from "./chunk-RA64IK43.js";
+import "./chunk-MRLCNXXR.js";
+import "./chunk-CQD26SMZ.js";
 import {
   FACTS_COMPANIONS,
   ManifestEditError,
@@ -34,7 +34,7 @@ import {
   serializeRecord,
   specRelOf,
   writeQuestion
-} from "./chunk-JMOLB347.js";
+} from "./chunk-U25OX22K.js";
 import {
   LockHeldError,
   acquireLock,

package/dist/{chunk-6V3DTQWK.js → chunk-6FG7QKJC.js}

@@ -5,7 +5,7 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   upgradeCommand
-} from "./chunk-LUPW4WLK.js";
+} from "./chunk-4G56W6H7.js";
 import {
   AdoptError,
   absorb,
@@ -18,33 +18,33 @@ import {
   reposDiscover,
   unadopt,
   zeroInstallFiles
-} from "./chunk-NG5R2WIY.js";
+} from "./chunk-DDZZXVQ5.js";
 import {
   assistantTier,
   readProbes,
   tierLine
-} from "./chunk-6RGIM2ZH.js";
-import "./chunk-EV4TEFOD.js";
-import "./chunk-6N2GUZMZ.js";
-import "./chunk-T6ESD5KM.js";
-import "./chunk-3LU6YCSQ.js";
-import "./chunk-L7I5PKGD.js";
-import "./chunk-CAN3EBE5.js";
-import "./chunk-IILZ7J3L.js";
-import "./chunk-TEBBD4XH.js";
-import "./chunk-XPWSNKF3.js";
-import "./chunk-WIMOJMAK.js";
-import "./chunk-5V5BJACL.js";
-import "./chunk-GVFUEGGM.js";
-import "./chunk-XNRPCI23.js";
-import "./chunk-7RUMD56V.js";
-import "./chunk-XZJE6WIT.js";
-import "./chunk-FMRMTI7W.js";
-import "./chunk-BKFGGJKA.js";
+} from "./chunk-GHSVJNVL.js";
+import "./chunk-DWYPYVPJ.js";
+import "./chunk-ISXNWUG7.js";
+import "./chunk-GMDOXWIS.js";
+import "./chunk-U5T4A2QV.js";
+import "./chunk-JQG4VO47.js";
+import "./chunk-DW4BM73R.js";
+import "./chunk-22GLUHGE.js";
+import "./chunk-QR65C3DV.js";
+import "./chunk-MLAACAES.js";
+import "./chunk-HY2VVVFZ.js";
+import "./chunk-PJRMMWU4.js";
+import "./chunk-34NWVIBC.js";
+import "./chunk-77UOXZVM.js";
+import "./chunk-TWHZU36X.js";
+import "./chunk-RA64IK43.js";
+import "./chunk-MRLCNXXR.js";
+import "./chunk-CQD26SMZ.js";
 import {
   loadOrgPack,
   orgPackDirOf
-} from "./chunk-JMOLB347.js";
+} from "./chunk-U25OX22K.js";
 import "./chunk-MMB2OHUY.js";
 import "./chunk-TV45EUGM.js";
 

package/dist/{chunk-SH7AZZDA.js → chunk-6JV3YHRR.js}

@@ -7,25 +7,25 @@ import {
   PlannerError,
   draftedStories,
   workItemsOf
-} from "./chunk-EV4TEFOD.js";
-import "./chunk-6N2GUZMZ.js";
-import "./chunk-T6ESD5KM.js";
-import "./chunk-3LU6YCSQ.js";
-import "./chunk-L7I5PKGD.js";
+} from "./chunk-DWYPYVPJ.js";
+import "./chunk-ISXNWUG7.js";
+import "./chunk-GMDOXWIS.js";
+import "./chunk-U5T4A2QV.js";
+import "./chunk-JQG4VO47.js";
 import {
   workItemsCsv
-} from "./chunk-CAN3EBE5.js";
-import "./chunk-IILZ7J3L.js";
-import "./chunk-TEBBD4XH.js";
-import "./chunk-XPWSNKF3.js";
-import "./chunk-WIMOJMAK.js";
-import "./chunk-5V5BJACL.js";
-import "./chunk-GVFUEGGM.js";
-import "./chunk-XNRPCI23.js";
-import "./chunk-XZJE6WIT.js";
-import "./chunk-FMRMTI7W.js";
-import "./chunk-BKFGGJKA.js";
-import "./chunk-JMOLB347.js";
+} from "./chunk-DW4BM73R.js";
+import "./chunk-22GLUHGE.js";
+import "./chunk-QR65C3DV.js";
+import "./chunk-MLAACAES.js";
+import "./chunk-HY2VVVFZ.js";
+import "./chunk-PJRMMWU4.js";
+import "./chunk-34NWVIBC.js";
+import "./chunk-77UOXZVM.js";
+import "./chunk-RA64IK43.js";
+import "./chunk-MRLCNXXR.js";
+import "./chunk-CQD26SMZ.js";
+import "./chunk-U25OX22K.js";
 import "./chunk-MMB2OHUY.js";
 import "./chunk-TV45EUGM.js";
 

package/dist/{chunk-GWSWS264.js → chunk-6ROZRBWH.js}

@@ -5,17 +5,17 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   metarepoToolBox
-} from "./chunk-YVCOQ5TZ.js";
+} from "./chunk-TEHH47TG.js";
 import {
   CONTEXT_TOOLS
-} from "./chunk-XNRPCI23.js";
+} from "./chunk-77UOXZVM.js";
 import {
   TOOL_LIMITS,
   ToolSession,
   readToolCalls,
   recordToolCalls
-} from "./chunk-BKFGGJKA.js";
-import "./chunk-JMOLB347.js";
+} from "./chunk-CQD26SMZ.js";
+import "./chunk-U25OX22K.js";
 import "./chunk-MMB2OHUY.js";
 import "./chunk-TV45EUGM.js";
 

package/dist/{chunk-MYKQVS5W.js → chunk-6S27MUQQ.js}

@@ -8,24 +8,24 @@ import {
 } from "./chunk-VOGCSYOI.js";
 import {
   readCatalog
-} from "./chunk-IILZ7J3L.js";
+} from "./chunk-22GLUHGE.js";
 import {
   TriageError,
   buildTriage,
   classify,
   scanInputs
-} from "./chunk-WIMOJMAK.js";
+} from "./chunk-HY2VVVFZ.js";
 import {
   readDrawio,
   reconcile
-} from "./chunk-5V5BJACL.js";
+} from "./chunk-PJRMMWU4.js";
 import {
   inputsDirOf,
   loadOrgPack,
   orgPackDirOf,
   recordPath,
   serializeRecord
-} from "./chunk-JMOLB347.js";
+} from "./chunk-U25OX22K.js";
 
 // packages/cli/dist/intake-commands.js
 import { createHash } from "node:crypto";
@@ -152,7 +152,8 @@ var STATUS_WORDS = [
   ["unresolved", (n) => `${n} waiting for a system name`],
   ["duplicate", (n) => `${n} duplicate${n === 1 ? "" : "s"}`],
   ["superseded", (n) => `${n} older version${n === 1 ? "" : "s"}`],
-  ["failed", (n) => `${n} failed`]
+  ["failed", (n) => `${n} failed`],
+  ["unreadable", (n) => `${n} unreadable`]
 ];
 function chains(docs) {
   const byId = new Map(docs.filter((d) => d.id).map((d) => [d.id, d]));
@@ -186,7 +187,7 @@ async function intakeList(root, io, o) {
   for (const l of table(["PATH", "TYPE", "STATUS", "SYSTEMS"], documents.map((d) => [
     d.path,
     d.classification,
-    d.duplicateOf ? `duplicate of ${d.duplicateOf}` : d.status,
+    d.duplicateOf ? `duplicate of ${d.duplicateOf}` : d.status === "unreadable" && d.reason ? `unreadable: ${d.reason}` : d.status,
     d.systems.join(", ")
   ])))
     io.out(l);
@@ -201,6 +202,9 @@ async function intakeList(root, io, o) {
     return n > 0 ? words(n) : "";
   }).filter(Boolean);
   io.out(`${documents.length} file${documents.length === 1 ? "" : "s"}: ${counts.join(", ")}.`);
+  for (const d of documents)
+    for (const n of d.notes ?? [])
+      io.out(`  ~ ${d.path}: ${n}`);
   for (const p of problems)
     io.out(`  ! ${p.path}: ${p.message}`);
   return problems.length > 0 ? 1 : 0;

package/dist/{chunk-TZXHUDI6.js → chunk-72DY5NCN.js}

@@ -8,7 +8,7 @@ import {
   executorsCheck,
   inputsSha256,
   runStep
-} from "./chunk-7J7UY46S.js";
+} from "./chunk-ZTIMXVV5.js";
 import {
   table
 } from "./chunk-VOGCSYOI.js";
@@ -17,7 +17,7 @@ import {
   exportStep,
   fileStepStore,
   recordStep
-} from "./chunk-CAN3EBE5.js";
+} from "./chunk-DW4BM73R.js";
 
 // packages/cli/dist/todo-commands.js
 var iso = (d) => d.toISOString().replace(/\.\d{3}Z$/, "Z");

package/dist/chunk-76QVBNEM.js

@@ -0,0 +1,37 @@
+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 {
+  changeMapBody,
+  changeMapCommand,
+  changeMapOf,
+  targetFlowsOf
+} from "./chunk-BSVTNNUK.js";
+import "./chunk-ZPT4QX3J.js";
+import "./chunk-DWYPYVPJ.js";
+import "./chunk-ISXNWUG7.js";
+import "./chunk-GMDOXWIS.js";
+import "./chunk-U5T4A2QV.js";
+import "./chunk-JQG4VO47.js";
+import "./chunk-DW4BM73R.js";
+import "./chunk-22GLUHGE.js";
+import "./chunk-QR65C3DV.js";
+import "./chunk-MLAACAES.js";
+import "./chunk-HY2VVVFZ.js";
+import "./chunk-PJRMMWU4.js";
+import "./chunk-34NWVIBC.js";
+import "./chunk-77UOXZVM.js";
+import "./chunk-RA64IK43.js";
+import "./chunk-MRLCNXXR.js";
+import "./chunk-CQD26SMZ.js";
+import "./chunk-U25OX22K.js";
+import "./chunk-MMB2OHUY.js";
+import "./chunk-TV45EUGM.js";
+export {
+  changeMapBody,
+  changeMapCommand,
+  changeMapOf,
+  targetFlowsOf
+};

package/dist/{chunk-XNRPCI23.js → chunk-77UOXZVM.js}

@@ -6,7 +6,7 @@ var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   dotInt8,
   textSha
-} from "./chunk-BKFGGJKA.js";
+} from "./chunk-CQD26SMZ.js";
 import {
   Question,
   RECORD_KINDS,
@@ -28,7 +28,7 @@ import {
   splitForms,
   stateDirOf,
   toCanonicalYaml
-} from "./chunk-JMOLB347.js";
+} from "./chunk-U25OX22K.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";
@@ -1004,8 +1004,8 @@ var DOCUMENT_EXTENSIONS = /\.(docx|pptx|xlsx|pdf|md|markdown|html?|txt)$/i;
 async function documentNodes(path, bytes) {
   const out = { nodes: [], names: [], links: [] };
   const [{ readDocument }, { screenFile }] = await Promise.all([
-    import("./chunk-7VFVQX5K.js"),
-    import("./chunk-QWHTTA2X.js")
+    import("./chunk-CIIRPLI6.js"),
+    import("./chunk-3M7QBKKG.js")
   ]);
   const screen = screenFile(path, bytes);
   if (screen.problem)
@@ -2284,7 +2284,7 @@ function openDb(file) {
 // packages/index/dist/catalog-index.js
 var vectorsFileOf = (file) => join3(dirname2(file), "vectors.sqlite");
 var notInstalled = (e, pkg) => e.code === "ERR_MODULE_NOT_FOUND" && String(e.message).includes(pkg);
-async function embedderOf(root, setting, load = () => import("./chunk-EZSZFI54.js")) {
+async function embedderOf(root, setting, load = () => import("./chunk-OMH3I5BH.js")) {
   if (setting === "off")
     return { why: "turned off for this command" };
   if (setting && setting !== "auto")

package/dist/{chunk-EHUYLNLC.js → chunk-7AXMUE2U.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-MYKQVS5W.js";
+} from "./chunk-6S27MUQQ.js";
 import "./chunk-VOGCSYOI.js";
 import {
   changeFolder,
   changeStore
-} from "./chunk-3LU6YCSQ.js";
-import "./chunk-L7I5PKGD.js";
-import "./chunk-CAN3EBE5.js";
+} from "./chunk-U5T4A2QV.js";
+import "./chunk-JQG4VO47.js";
+import "./chunk-DW4BM73R.js";
 import {
   estateFacts,
   estateRepos,
@@ -20,19 +20,19 @@ import {
   joinReposOf,
   outsideProfileSystems,
   outsideSystems
-} from "./chunk-IILZ7J3L.js";
-import "./chunk-TEBBD4XH.js";
-import "./chunk-XPWSNKF3.js";
+} from "./chunk-22GLUHGE.js";
+import "./chunk-QR65C3DV.js";
+import "./chunk-MLAACAES.js";
 import {
   attachToChange,
   readChangeInputs,
   readVendorSpec
-} from "./chunk-WIMOJMAK.js";
-import "./chunk-5V5BJACL.js";
-import "./chunk-GVFUEGGM.js";
-import "./chunk-XZJE6WIT.js";
-import "./chunk-FMRMTI7W.js";
-import "./chunk-BKFGGJKA.js";
+} from "./chunk-HY2VVVFZ.js";
+import "./chunk-PJRMMWU4.js";
+import "./chunk-34NWVIBC.js";
+import "./chunk-RA64IK43.js";
+import "./chunk-MRLCNXXR.js";
+import "./chunk-CQD26SMZ.js";
 import {
   PROTOTYPE_GROUPS,
   comparePrototype,
@@ -42,7 +42,7 @@ import {
   joinConventions,
   parseFacts,
   prototypeArchitectureSection
-} from "./chunk-JMOLB347.js";
+} from "./chunk-U25OX22K.js";
 import "./chunk-MMB2OHUY.js";
 import "./chunk-TV45EUGM.js";
 

package/dist/{chunk-LS3WR2RF.js → chunk-7TEQF64E.js}

@@ -5,19 +5,11 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   notesAt
-} from "./chunk-52WCHTVZ.js";
+} from "./chunk-ZS47PQ3O.js";
 import {
   houseUntaughtLines,
   houseUntaughtOf
-} from "./chunk-B3QOYE74.js";
-import {
-  loadReadPlan,
-  partOfWords,
-  readPlanProgress,
-  readPlanRelOf,
-  saveReadPlan,
-  writeReadPlan
-} from "./chunk-LVBPY2M6.js";
+} from "./chunk-3CFBU2O6.js";
 import {
   carryOf,
   checkoutOf,
@@ -25,22 +17,29 @@ import {
   estateComponentsOf,
   excludesOf,
   headOf,
+  loadReadPlan,
+  partOfWords,
   raiseReadQuestions,
   readCorrections,
+  readPlanProgress,
+  readPlanRelOf,
   readReviewed,
   reviewedProblemsOf,
+  saveReadPlan,
   slipNoteLines,
+  writeReadPlan,
   writeVerifyFiles
-} from "./chunk-ASKDCMW5.js";
+} from "./chunk-P76AW3PA.js";
 import {
   ABOUT_RULE,
   assistantTier,
   mapBatchInstructions,
   readProbes,
+  rulesNow,
   taughtFrameworksText,
   tierSource,
   tierWords
-} from "./chunk-6RGIM2ZH.js";
+} from "./chunk-GHSVJNVL.js";
 import {
   FILE_KINDS,
   SHOWN_PROPOSALS,
@@ -62,10 +61,10 @@ import {
   sliceText,
   staleMessage,
   verifyFacts
-} from "./chunk-XPWSNKF3.js";
+} from "./chunk-MLAACAES.js";
 import {
   loadRepos
-} from "./chunk-XZJE6WIT.js";
+} from "./chunk-RA64IK43.js";
 import {
   DATA_RULE,
   HandoffRuntime,
@@ -75,7 +74,7 @@ import {
   estimateTokens,
   promptBudget,
   wrapData
-} from "./chunk-BKFGGJKA.js";
+} from "./chunk-CQD26SMZ.js";
 import {
   AgentDefinition,
   Fact,
@@ -95,7 +94,7 @@ import {
   runsDirOf,
   saysNotProduct,
   stackHelpersOff
-} from "./chunk-JMOLB347.js";
+} from "./chunk-U25OX22K.js";
 import {
   writeFileAtomic
 } from "./chunk-MMB2OHUY.js";
@@ -419,7 +418,9 @@ async function packFor(root, s, batch, source, op, now, notes) {
         // build files are read first, so from the second batch on this is what the code says.
         frameworks: await frameworksFor(root, s.repo, facts),
         // Nothing says what this repo is: ask for one line, cited, for a person to confirm.
-        ...about ? {} : { askAbout: true },
+        ...about || s.sets ? {} : { askAbout: true },
+        // ADR 0167: a top-up carries only the rule sets the read lacked.
+        ...s.sets ? { sets: s.sets } : {},
         // A-taught: how to read the wrapper calls and annotations of the frameworks it is built on.
         ...taughtOption(taughtIn(source, op)),
         // ADR 0163: what the organisation's terms mean here and what must hold, as data.
@@ -551,7 +552,7 @@ async function mapCommand(root, repo, o, io, deps = {}) {
   const repoNotes = await notesAt(root, repo, dir, op);
   const notesPrompt = notesText(repoNotes.notes, repoNotes.type);
   if (o.gaps) {
-    const { mapGaps } = await import("./chunk-S7ZWCMDO.js");
+    const { mapGaps } = await import("./chunk-4Q2PGM5T.js");
     const tier = await tierHere(root, op);
     let part;
     if (o.part !== void 0) {
@@ -573,6 +574,19 @@ async function mapCommand(root, repo, o, io, deps = {}) {
       ...part ? { part } : {}
     }, io);
   }
+  if (o.rules && !deps.runtime) {
+    const { mapRules } = await import("./chunk-2Q2YBAR5.js");
+    const tier = await tierHere(root, op);
+    return mapRules(root, repo, {
+      commit,
+      source,
+      exclude,
+      conventions,
+      session: sessionTokensFor(limitOf(o, op, tier).limit),
+      notes: notesPrompt,
+      ...o.json ? { json: true } : {}
+    }, io);
+  }
   if (o.estimate)
     return estimate(root, repo, { o, op, dir, commit, source, exclude, factsFile, ...deps.git ? { git: deps.git } : {} }, io);
   const runtime = deps.runtime;
@@ -645,44 +659,86 @@ async function mapCommand(root, repo, o, io, deps = {}) {
     if (room < MIN_ROOM)
       return tooSmall(0);
     const frameworks = await frameworksFor(root, repo, existing);
-    const re = await rereadOf(dir, existing, commit, source, exclude, deps.git, conventions);
-    const reread = re.plan && !re.plan.unknown.length ? re.plan : void 0;
-    const since = reread?.from.map((x) => x.commit.slice(0, 12)).join(", ");
-    if (reread && !reread.files.length && !reread.reread.length) {
-      io.out(`Nothing ${repo}'s facts cite changed since ${since}, and no source file did: atticus verify ${repo} carries its ${plural(reread.carried, "fact")} to ${commit.slice(0, 12)}.`);
-      return 0;
-    }
-    const plan = planBatches(reread ? onlyFiles(source, reread.files.map((f) => f.path)) : source, { room, exclude, overhead: overheadOf(repo, commit, frameworks), conventions });
-    if (plan.leastRoom < MIN_ROOM)
-      return tooSmall(room - plan.leastRoom);
-    if (!plan.batches.length && !reread) {
-      io.out(`${repo} has no source files to read${plan.excluded.length ? ` (${plural(plan.excluded.length, "file")} excluded)` : ""}.`);
-      return 0;
+    if (o.rules) {
+      const { topUpOf, recordRulesNow, ruleSetsOfFiles } = await import("./chunk-2Q2YBAR5.js");
+      const t = await topUpOf(root, repo, {
+        commit,
+        facts: existing,
+        source,
+        exclude,
+        conventions
+      });
+      if ("error" in t) {
+        io.err(t.error);
+        return 2;
+      }
+      if (!t.lacking.length) {
+        io.out(`${repo} was read under the reading rules there are now: nothing to top up.`);
+        return 0;
+      }
+      if (!t.files.length) {
+        await recordRulesNow(root, repo, commit);
+        io.out(`No file of ${repo} is one the reading rules added since it was read apply to (${t.lacking.join(", ")}): its read is recorded as under the rules there are now.`);
+        return 0;
+      }
+      const sets = ruleSetsOfFiles(t.files);
+      const plan = planBatches(onlyFiles(source, t.files.map((f) => f.path)), { room, exclude, overhead: overheadOf(repo, commit, frameworks), conventions });
+      if (plan.leastRoom < MIN_ROOM)
+        return tooSmall(room - plan.leastRoom);
+      s = {
+        schemaVersion: 1,
+        repo,
+        commit,
+        ...limit ? { maxTokens: limit } : {},
+        room,
+        batches: plan.batches,
+        next: 0,
+        rejected: [],
+        problems: [],
+        sets
+      };
+      await saveState(root, s);
+      io.out(`Topping up ${repo} at ${commit.slice(0, 12)} for the reading rules added since it was read (${sets.join(", ")}): ${plural(plan.files, "source file")} in ${batches(plan.batches.length)}; facts go to ${factsFile}.`);
+    } else {
+      const re = await rereadOf(dir, existing, commit, source, exclude, deps.git, conventions);
+      const reread = re.plan && !re.plan.unknown.length ? re.plan : void 0;
+      const since = reread?.from.map((x) => x.commit.slice(0, 12)).join(", ");
+      if (reread && !reread.files.length && !reread.reread.length) {
+        io.out(`Nothing ${repo}'s facts cite changed since ${since}, and no source file did: atticus verify ${repo} carries its ${plural(reread.carried, "fact")} to ${commit.slice(0, 12)}.`);
+        return 0;
+      }
+      const plan = planBatches(reread ? onlyFiles(source, reread.files.map((f) => f.path)) : source, { room, exclude, overhead: overheadOf(repo, commit, frameworks), conventions });
+      if (plan.leastRoom < MIN_ROOM)
+        return tooSmall(room - plan.leastRoom);
+      if (!plan.batches.length && !reread) {
+        io.out(`${repo} has no source files to read${plan.excluded.length ? ` (${plural(plan.excluded.length, "file")} excluded)` : ""}.`);
+        return 0;
+      }
+      const byId = new Map(existing.map((f) => [f.id, f]));
+      s = {
+        schemaVersion: 1,
+        repo,
+        commit,
+        ...limit ? { maxTokens: limit } : {},
+        room,
+        batches: plan.batches,
+        next: 0,
+        rejected: (reread?.reread ?? []).map((r) => {
+          const fact = byId.get(r.id);
+          return { id: r.id, code: "cite-changed", message: staleMessage(fact, r, commit), fact };
+        }),
+        problems: [],
+        ...reread ? {
+          reread: {
+            from: reread.from.map((x) => x.commit),
+            carried: reread.carried,
+            facts: reread.reread.length
+          }
+        } : {}
+      };
+      await saveState(root, s);
+      io.out(reread ? `Re-reading ${repo} at ${commit.slice(0, 12)}: ${plural(plan.files, "source file")} changed since ${since}, in ${batches(plan.batches.length)}${plan.batches.length ? ` (about ${plan.tokens} tokens${limit ? `, each prompt within ${limit} tokens` : ""})` : ""}; ${plural(reread.reread.length, "fact")} to rewrite, ${reread.carried} carried as they are; facts go to ${factsFile}.` : `Reading ${repo} at ${commit.slice(0, 12)} in ${batches(plan.batches.length)} (${plural(plan.files, "source file")}, about ${plan.tokens} tokens${limit ? `, each prompt within ${limit} tokens` : ""}); facts go to ${factsFile}.`);
     }
-    const byId = new Map(existing.map((f) => [f.id, f]));
-    s = {
-      schemaVersion: 1,
-      repo,
-      commit,
-      ...limit ? { maxTokens: limit } : {},
-      room,
-      batches: plan.batches,
-      next: 0,
-      rejected: (reread?.reread ?? []).map((r) => {
-        const fact = byId.get(r.id);
-        return { id: r.id, code: "cite-changed", message: staleMessage(fact, r, commit), fact };
-      }),
-      problems: [],
-      ...reread ? {
-        reread: {
-          from: reread.from.map((x) => x.commit),
-          carried: reread.carried,
-          facts: reread.reread.length
-        }
-      } : {}
-    };
-    await saveState(root, s);
-    io.out(reread ? `Re-reading ${repo} at ${commit.slice(0, 12)}: ${plural(plan.files, "source file")} changed since ${since}, in ${batches(plan.batches.length)}${plan.batches.length ? ` (about ${plan.tokens} tokens${limit ? `, each prompt within ${limit} tokens` : ""})` : ""}; ${plural(reread.reread.length, "fact")} to rewrite, ${reread.carried} carried as they are; facts go to ${factsFile}.` : `Reading ${repo} at ${commit.slice(0, 12)} in ${batches(plan.batches.length)} (${plural(plan.files, "source file")}, about ${plan.tokens} tokens${limit ? `, each prompt within ${limit} tokens` : ""}); facts go to ${factsFile}.`);
   }
   if (!s)
     return 2;
@@ -783,7 +839,7 @@ async function takeAnswer(root, s, run, batch, source, exclude, now, io, at) {
   });
   const summary = await writeVerifyFiles(root, s.repo, report, s.commit, q.problems, [], reviewedProblemsOf(reviewed.bad, report), answer.slips);
   if (answer.about) {
-    const { keepDraftedDescription } = await import("./chunk-ZKUDS7JG.js");
+    const { keepDraftedDescription } = await import("./chunk-ZYASEL7K.js");
     const d = await keepDraftedDescription(root, s.repo, answer.about, now());
     if (d.kept)
       io.out(`Your assistant says ${s.repo} is: "${answer.about.text}" \u2014 written to the manifest as a draft, unconfirmed. Confirm it (atticus repo describe ${s.repo} --accept), change it (--description "...") or drop it (--reject).`);
@@ -816,6 +872,10 @@ async function finish(root, s, io, o) {
   s.done = true;
   await saveState(root, s);
   const last = s.last;
+  if (last && !last.rejected && !s.reread) {
+    const { recordRulesNow } = await import("./chunk-2Q2YBAR5.js");
+    await recordRulesNow(root, s.repo, s.commit);
+  }
   const rel = factsRelOf(root);
   if (o.json) {
     io.out(JSON.stringify({ state: "done", repo: s.repo, batches: s.batches.length, ...last }, null, 2));
@@ -902,6 +962,8 @@ async function estimate(root, repo, c, io) {
     ...reread ? { reread: true } : {}
   };
   const sameEstimate = plan0?.estimate !== void 0 && plan0.estimate.files === estimate2.files && plan0.estimate.tokens === estimate2.tokens && plan0.estimate.sessions === estimate2.sessions && plan0.estimate.reread === estimate2.reread;
+  const firstRead = typeof existing !== "string" && existing.length === 0 && !reread;
+  const readRules = firstRead ? rulesNow() : plan0?.rules;
   if (!same)
     await writeReadPlan(root, repo, {
       commit: c.commit,
@@ -909,10 +971,11 @@ async function estimate(root, repo, c, io) {
       parts,
       estimate: estimate2,
       // What the reader reported of an earlier plan stays, under the commit it was of.
-      ...plan0?.reported ? { reported: plan0.reported } : {}
+      ...plan0?.reported ? { reported: plan0.reported } : {},
+      ...readRules ? { rules: readRules } : {}
     });
-  else if (!sameEstimate)
-    await saveReadPlan(root, { ...plan0, estimate: estimate2 });
+  else if (!sameEstimate || firstRead && plan0.rules?.hash !== readRules?.hash)
+    await saveReadPlan(root, { ...plan0, estimate: estimate2, ...readRules ? { rules: readRules } : {} });
   const progress = parts.length ? await readPlanProgress(root, repo, { commit: c.commit }) : void 0;
   const questions = (await listQuestions(root, { repo })).questions.filter((q) => q.state !== "retired");
   const notes = await notesAt(root, repo, c.dir, c.op);