@maycombhq/atticus 2.0.0-beta.24 → 2.0.0-beta.26

package/dist/{chunk-MQFSEGTU.js → chunk-B7KGNEFI.js}

@@ -5,12 +5,13 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   targetFlowsOf
-} from "./chunk-L6Z6TMIK.js";
+} from "./chunk-IEIHVMM6.js";
 import {
   withFileLock
-} from "./chunk-QOC3Q4UU.js";
-import "./chunk-RSHVSXPJ.js";
+} from "./chunk-BSZII65X.js";
+import "./chunk-HSJKYDHI.js";
 import {
+  Stroke,
   TARGET_DIR,
   applyStroke,
   endpointKey,
@@ -18,40 +19,45 @@ import {
   planSketchWrite,
   readDeltas,
   writeSketch
-} from "./chunk-WECCLSYY.js";
-import "./chunk-5FUFVNXB.js";
-import "./chunk-A6ZG3UOS.js";
+} from "./chunk-CSHJZFOE.js";
+import "./chunk-5A4RHEEL.js";
+import "./chunk-VIQHZA53.js";
 import {
   changeFolder
-} from "./chunk-U2JTTRKS.js";
-import "./chunk-5MKV4TV6.js";
-import "./chunk-ESJALLOK.js";
-import "./chunk-MCE74XMF.js";
-import "./chunk-25CUJJTP.js";
-import "./chunk-HNPKCRCE.js";
-import "./chunk-CZ75S2EZ.js";
-import "./chunk-GFYVVTKH.js";
+} from "./chunk-WH3ZFLXT.js";
+import "./chunk-UTZMF5CV.js";
+import "./chunk-6U65YB54.js";
+import "./chunk-SZDOBIWE.js";
+import "./chunk-2HDNOUJU.js";
+import "./chunk-RK5P2DWD.js";
+import "./chunk-K3QKOVZN.js";
+import "./chunk-QAFQLILX.js";
 import {
   labelText,
   readDrawio
-} from "./chunk-DIYNRYXW.js";
-import "./chunk-5FPAKAGE.js";
-import "./chunk-IJQHBK76.js";
-import "./chunk-MOWUP33K.js";
+} from "./chunk-HQMLY2R6.js";
+import "./chunk-I2EWY3MG.js";
+import "./chunk-UFIQ5FWY.js";
+import "./chunk-ZDA72732.js";
 import "./chunk-QA4O2GGC.js";
-import "./chunk-OSZTENIA.js";
+import "./chunk-XIJBQM45.js";
 import {
   changesRelOf
-} from "./chunk-GJVCBTSO.js";
-import "./chunk-G3ZFEHCX.js";
-import "./chunk-QFDPX6C4.js";
+} from "./chunk-6ZDAEUKB.js";
+import "./chunk-MEMEO7YO.js";
+import "./chunk-LZFKJ2BR.js";
 import "./chunk-CTJHEG6A.js";
-import "./chunk-BQGDB6ZL.js";
-import "./chunk-TV45EUGM.js";
+import {
+  require_dist
+} from "./chunk-BQGDB6ZL.js";
+import {
+  __toESM
+} from "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/change-sketch.js
 import { readFile } from "node:fs/promises";
 import { basename, extname, join } from "node:path";
+var import_yaml = __toESM(require_dist(), 1);
 var METHODS = /* @__PURE__ */ new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
 function lineParts(text) {
   const toks = text.trim().split(/\s+/).filter(Boolean);
@@ -123,6 +129,91 @@ function readMermaidSketch(text) {
   }
   return { lines, problems };
 }
+function readStrokesFile(text, name) {
+  let doc;
+  try {
+    doc = /\.json$/i.test(name) ? JSON.parse(text) : (0, import_yaml.parse)(text);
+  } catch (e) {
+    return {
+      strokes: [],
+      problems: [`${name} doesn't read: ${e.message.split("\n")[0]}`]
+    };
+  }
+  const list = Array.isArray(doc) ? doc : doc && typeof doc === "object" && Array.isArray(doc.strokes) ? doc.strokes : void 0;
+  if (!list)
+    return {
+      strokes: [],
+      problems: [`${name} has no strokes: write a list of strokes, or strokes: [ ... ].`]
+    };
+  const strokes = [];
+  const problems = [];
+  list.forEach((raw, i) => {
+    const s = Stroke.safeParse(raw);
+    if (s.success)
+      strokes.push({ stroke: s.data, at: `stroke ${i + 1}` });
+    else
+      problems.push(`stroke ${i + 1}: isn't a stroke Atticus draws: ${s.error.issues.map((x) => `${x.path.join(".") || "kind"}: ${x.message}`).join("; ")}`);
+  });
+  return { strokes, problems };
+}
+function distance(a, b) {
+  const row = Array.from({ length: b.length + 1 }, (_, j) => j);
+  for (let i = 1; i <= a.length; i++) {
+    let prev = row[0];
+    row[0] = i;
+    for (let j = 1; j <= b.length; j++) {
+      const cur = row[j];
+      row[j] = Math.min(row[j] + 1, row[j - 1] + 1, prev + (a[i - 1] === b[j - 1] ? 0 : 1));
+      prev = cur;
+    }
+  }
+  return row[b.length];
+}
+function suggestComponents(id, components) {
+  const words = new Set(id.split(/[^a-z0-9]+/).filter((w) => w.length > 2));
+  return [...new Set(components)].map((c) => {
+    const shared = c.split(/[^a-z0-9]+/).filter((w) => words.has(w)).length;
+    return {
+      c,
+      d: distance(id, c) - shared * 2,
+      ok: distance(id, c) <= Math.max(3, id.length / 3) || shared > 0
+    };
+  }).filter((x) => x.ok).sort((x, y) => x.d - y.d || x.c.localeCompare(y.c)).slice(0, 3).map((x) => x.c);
+}
+var componentsOf = (estate) => [
+  ...estate.flows.map((f) => f.flow.component),
+  ...estate.records.filter((r) => r.kind === "Component").map((r) => r.id)
+];
+function describeStroke(s) {
+  switch (s.kind) {
+    case "absorb":
+      return { from: s.component, to: s.into.component, label: "absorb" };
+    case "retire":
+      return { from: s.component, to: "", label: "retire" };
+    case "call":
+      return { from: s.from.component, to: s.to.component, label: s.to.entry };
+    case "topic":
+      return { from: s.from.component, to: s.listener?.component ?? "", label: s.topic };
+    case "table":
+      return { from: s.from.component, to: s.table, label: s.op };
+    case "remove":
+      return { from: s.flow, to: "", label: `remove step ${s.step}` };
+    case "retarget":
+      return { from: s.flow, to: s.to.component, label: s.to.entry };
+    case "undo":
+      return { from: s.flow, to: "", label: `undo ${s.index}` };
+  }
+}
+var strokeText = (l) => l.label === "absorb" ? `absorb ${l.from} into ${l.to}` : l.label === "retire" ? `retire ${l.from}` : `${l.from}${l.to ? ` \u2192 ${l.to}` : ""} ${l.label}`;
+function withSuggestions(problem, s, estate) {
+  const named = [
+    ...s.kind === "absorb" || s.kind === "retire" ? [s.component] : [],
+    ..."from" in s ? [s.from.component] : []
+  ];
+  const known = new Set(componentsOf(estate));
+  const hints = named.filter((c) => !known.has(c) && !estate.ids.has(c)).map((c) => ({ c, near: suggestComponents(c, [...known]) })).filter((x) => x.near.length).map((x) => ` Did you mean ${x.near.join(", ")}${x.near.length > 1 ? " (nearest first)" : ""}?`);
+  return problem + hints.join("");
+}
 function readDrawioSketch(xml) {
   const d = readDrawio(xml);
   const lines = d.edges.map((e) => ({
@@ -221,7 +312,7 @@ function strokesOfLines(lines, estate, drawnAlready = []) {
 }
 async function changeSketchCommand(root, change, o, io) {
   if (!change || !o.from) {
-    io.err("Usage: atticus change sketch <change> --from <file.drawio|.mmd> [--save]");
+    io.err("Usage: atticus change sketch <change> --from <file.drawio|.mmd|strokes.yaml|.json> [--save]");
     return 2;
   }
   const t = await targetFlowsOf(root, change);
@@ -235,10 +326,18 @@ async function changeSketchCommand(root, change, o, io) {
     return 2;
   }
   const ext = extname(o.from).toLowerCase();
-  const read = ext === ".drawio" || ext === ".xml" || text.trimStart().startsWith("<") ? readDrawioSketch(text) : readMermaidSketch(text);
   const estate = await loadEstate(root, t.records);
   const dir = changeFolder(root, change);
-  const plan = strokesOfLines(read.lines, estate, (await readDeltas(dir)).deltas);
+  const strokesFile = ext === ".yaml" || ext === ".yml" || ext === ".json";
+  const sf = strokesFile ? readStrokesFile(text, basename(o.from)) : void 0;
+  const read = sf ? { lines: [], problems: sf.problems } : ext === ".drawio" || ext === ".xml" || text.trimStart().startsWith("<") ? readDrawioSketch(text) : readMermaidSketch(text);
+  const plan = sf ? {
+    strokes: sf.strokes.map((x) => ({
+      stroke: x.stroke,
+      line: { ...describeStroke(x.stroke), at: x.at }
+    })),
+    skipped: []
+  } : strokesOfLines(read.lines, estate, (await readDeltas(dir)).deltas);
   const by = `${o.by ?? "a person"} from ${basename(o.from)}`;
   const problems = [...read.problems];
   const drawn = [];
@@ -253,12 +352,15 @@ async function changeSketchCommand(root, change, o, io) {
     for (const s of plan.strokes) {
       const r = applyStroke(deltas, s.stroke, estate, by);
       if (r.problem) {
-        plan.skipped.push({ line: s.line, why: r.problem });
+        plan.skipped.push({
+          line: s.line,
+          why: sf ? withSuggestions(r.problem, s.stroke, estate) : r.problem
+        });
         continue;
       }
       deltas = r.deltas;
       changed.push(...r.changed);
-      drawn.push(`${s.line.from} \u2192 ${s.line.to} ${s.line.label} (${s.line.at})`);
+      drawn.push(sf ? `${strokeText(s.line)} (${s.line.at})` : `${s.line.from} \u2192 ${s.line.to} ${s.line.label} (${s.line.at})`);
     }
     if (o.save && drawn.length)
       await writeSketch(dir, await planSketchWrite(dir, deltas, changed, estate, by));
@@ -276,7 +378,7 @@ async function changeSketchCommand(root, change, o, io) {
   for (const d of drawn)
     io.out(`${o.save ? "Drawn" : "Would draw"}: ${d}`);
   for (const s of plan.skipped)
-    io.out(`Left out: ${s.line.from} \u2192 ${s.line.to} ${s.line.label} (${s.line.at}): ${s.why}`);
+    io.out(sf ? `Left out: ${strokeText(s.line)} (${s.line.at}): ${s.why}` : `Left out: ${s.line.from} \u2192 ${s.line.to} ${s.line.label} (${s.line.at}): ${s.why}`);
   for (const p of problems)
     io.out(`Didn't read: ${p}`);
   if (!drawn.length) {
@@ -292,5 +394,7 @@ export {
   lineParts,
   readDrawioSketch,
   readMermaidSketch,
-  strokesOfLines
+  readStrokesFile,
+  strokesOfLines,
+  suggestComponents
 };

package/dist/{chunk-2ITYURTR.js → chunk-BABRMZET.js}

@@ -5,14 +5,14 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   originOf
-} from "./chunk-QOC3Q4UU.js";
+} from "./chunk-BSZII65X.js";
 import {
   isAdopted,
   orgPackDirOf
-} from "./chunk-GJVCBTSO.js";
+} from "./chunk-6ZDAEUKB.js";
 import {
   writeFileAtomic
-} from "./chunk-G3ZFEHCX.js";
+} from "./chunk-MEMEO7YO.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";

package/dist/{chunk-OYTSRNSZ.js → chunk-BD7HBZLP.js}

@@ -6,10 +6,10 @@ var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   aggregateTraffic,
   readContractFiles
-} from "./chunk-GFYVVTKH.js";
+} from "./chunk-QAFQLILX.js";
 import {
   TRAFFIC_SOURCES
-} from "./chunk-DIYNRYXW.js";
+} from "./chunk-HQMLY2R6.js";
 import {
   ContractsFile,
   evidenceDirOf,
@@ -19,13 +19,13 @@ import {
   orgPackDirOf,
   readTrafficFile,
   trafficFileName
-} from "./chunk-GJVCBTSO.js";
+} from "./chunk-6ZDAEUKB.js";
 import {
   writeFileAtomic
-} from "./chunk-G3ZFEHCX.js";
+} from "./chunk-MEMEO7YO.js";
 import {
   loadOrgPack
-} from "./chunk-QFDPX6C4.js";
+} from "./chunk-LZFKJ2BR.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";
@@ -198,7 +198,7 @@ async function intakeTraffic(root, file, o, io) {
   return 0;
 }
 async function estateNames(root) {
-  const { estateFacts, estateRepos } = await import("./chunk-UI6KNLSO.js");
+  const { estateFacts, estateRepos } = await import("./chunk-NHFMLMLN.js");
   const apps = /* @__PURE__ */ new Set();
   const tDir = join(evidenceDirOf(root), "traffic");
   for (const n of (await readdir(tDir).catch(() => [])).sort()) {

package/dist/{chunk-CCQZN6W3.js → chunk-BEEHCL5O.js}

@@ -5,48 +5,48 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   describeRun
-} from "./chunk-ASFRT33J.js";
+} from "./chunk-CFK6CFXM.js";
 import {
   RunLevel,
   readyTasksOf,
   runReadyTasks
-} from "./chunk-R6CJOMPC.js";
-import "./chunk-CU7ZK7KP.js";
-import "./chunk-HI7ADE4E.js";
-import "./chunk-BYKWWSXL.js";
-import "./chunk-BWYW533C.js";
-import "./chunk-J4K4C4T5.js";
-import "./chunk-PB3NCPRF.js";
-import "./chunk-G67GOK4S.js";
-import "./chunk-775FMPUB.js";
-import "./chunk-YF6N45QN.js";
-import "./chunk-5QF5W5P2.js";
-import "./chunk-QIDSEHJA.js";
+} from "./chunk-LY7DOYX2.js";
+import "./chunk-HWPX3T55.js";
+import "./chunk-HNNMT5L2.js";
+import "./chunk-7AEB74KW.js";
+import "./chunk-DPH4BS3F.js";
+import "./chunk-IBIIKUC7.js";
+import "./chunk-KZH5YV6J.js";
+import "./chunk-H5BIVULF.js";
+import "./chunk-IZIGZ7KY.js";
+import "./chunk-RQM5Y3HJ.js";
+import "./chunk-JLTJAOO4.js";
+import "./chunk-SAPX3PVK.js";
 import "./chunk-MUWDB4R4.js";
 import "./chunk-VOGCSYOI.js";
-import "./chunk-LELM7X5H.js";
-import "./chunk-WECCLSYY.js";
-import "./chunk-5FUFVNXB.js";
-import "./chunk-A6ZG3UOS.js";
-import "./chunk-U2JTTRKS.js";
-import "./chunk-5MKV4TV6.js";
-import "./chunk-ESJALLOK.js";
-import "./chunk-MCE74XMF.js";
-import "./chunk-25CUJJTP.js";
-import "./chunk-HNPKCRCE.js";
-import "./chunk-CZ75S2EZ.js";
-import "./chunk-GFYVVTKH.js";
-import "./chunk-DIYNRYXW.js";
-import "./chunk-5FPAKAGE.js";
-import "./chunk-IJQHBK76.js";
+import "./chunk-YEHSJY6B.js";
+import "./chunk-CSHJZFOE.js";
+import "./chunk-5A4RHEEL.js";
+import "./chunk-VIQHZA53.js";
+import "./chunk-WH3ZFLXT.js";
+import "./chunk-UTZMF5CV.js";
+import "./chunk-6U65YB54.js";
+import "./chunk-SZDOBIWE.js";
+import "./chunk-2HDNOUJU.js";
+import "./chunk-RK5P2DWD.js";
+import "./chunk-K3QKOVZN.js";
+import "./chunk-QAFQLILX.js";
+import "./chunk-HQMLY2R6.js";
+import "./chunk-I2EWY3MG.js";
+import "./chunk-UFIQ5FWY.js";
 import {
   RUNTIME_MODES
-} from "./chunk-MOWUP33K.js";
+} from "./chunk-ZDA72732.js";
 import "./chunk-QA4O2GGC.js";
-import "./chunk-OSZTENIA.js";
-import "./chunk-GJVCBTSO.js";
-import "./chunk-G3ZFEHCX.js";
-import "./chunk-QFDPX6C4.js";
+import "./chunk-XIJBQM45.js";
+import "./chunk-6ZDAEUKB.js";
+import "./chunk-MEMEO7YO.js";
+import "./chunk-LZFKJ2BR.js";
 import "./chunk-CTJHEG6A.js";
 import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
@@ -54,7 +54,7 @@ import "./chunk-TV45EUGM.js";
 // packages/cli/dist/run-ready-commands.js
 async function deployOrderOf(root, change) {
   try {
-    const { loadRelease, deploymentPlan } = await import("./chunk-YHWX5LPT.js");
+    const { loadRelease, deploymentPlan } = await import("./chunk-F6GRBF5L.js");
     const plan = await deploymentPlan(await loadRelease(root, change));
     const out = [];
     for (const s of [...plan.steps].sort((a, b) => a.n - b.n))

package/dist/{chunk-JCG2EBNB.js → chunk-BGOAJFPB.js}

@@ -10,7 +10,7 @@ function draftCheckTool(root, request) {
   if (!request.selfCheck || !/^(feature|architecture|stories|small)-answer\.yaml$/.test(request.outputPath))
     return void 0;
   let box;
-  const planner = () => box ??= import("./chunk-YUJTOALL.js").then((p) => p.draftCheckBox(root, request));
+  const planner = () => box ??= import("./chunk-ANFBBJEV.js").then((p) => p.draftCheckBox(root, request));
   return {
     definitions: [
       {

package/dist/{chunk-MVXMISNA.js → chunk-BIAQ6NQS.js}

@@ -7,20 +7,20 @@ import {
   readRound,
   reviewedGates,
   roundsOf
-} from "./chunk-A6ZG3UOS.js";
+} from "./chunk-VIQHZA53.js";
 import {
   changeStore,
   liveHandoff
-} from "./chunk-U2JTTRKS.js";
+} from "./chunk-WH3ZFLXT.js";
 import {
   createAdapters
-} from "./chunk-ESJALLOK.js";
+} from "./chunk-6U65YB54.js";
 import {
   orgPackDirOf
-} from "./chunk-GJVCBTSO.js";
+} from "./chunk-6ZDAEUKB.js";
 import {
   loadOrgPack
-} from "./chunk-QFDPX6C4.js";
+} from "./chunk-LZFKJ2BR.js";
 
 // packages/cli/dist/digest-commands.js
 var norm = (s) => s.toLowerCase().replace(/^@/, "");
@@ -70,8 +70,8 @@ async function buildDigest(root, user) {
   }
   if (!lines.length)
     lines.push("Nothing waits on you.");
-  const { readMe } = await import("./chunk-D5ZC7IMC.js");
-  const { watchLine } = await import("./chunk-ABDE5IRC.js");
+  const { readMe } = await import("./chunk-IFQJ3YQE.js");
+  const { watchLine } = await import("./chunk-IERXBWQU.js");
   const watching = [];
   for (const c of (await readMe(root)).watch)
     watching.push(await watchLine(root, c));

package/dist/{chunk-GS7N3RFG.js → chunk-BIKMME4S.js}

@@ -5,33 +5,34 @@ var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
 var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   termNoteOffer
-} from "./chunk-4CS3PMIM.js";
+} from "./chunk-EVKDWJ5Y.js";
 import {
   routeQuestions
-} from "./chunk-SLGUSFOD.js";
-import "./chunk-DF6DPCW2.js";
-import "./chunk-RSHVSXPJ.js";
-import "./chunk-HWNFFCGB.js";
-import "./chunk-BYKWWSXL.js";
-import "./chunk-ENZ3PI7L.js";
+} from "./chunk-HV6PXXK7.js";
+import "./chunk-CG6MG7SE.js";
+import "./chunk-HSJKYDHI.js";
+import "./chunk-PBDIVTFL.js";
+import "./chunk-7AEB74KW.js";
+import "./chunk-ZFEOIYK5.js";
 import {
   waitingQuestions
-} from "./chunk-5FUFVNXB.js";
-import "./chunk-MCE74XMF.js";
-import "./chunk-25CUJJTP.js";
-import "./chunk-HNPKCRCE.js";
-import "./chunk-CZ75S2EZ.js";
-import "./chunk-GFYVVTKH.js";
-import "./chunk-DIYNRYXW.js";
-import "./chunk-5FPAKAGE.js";
-import "./chunk-IJQHBK76.js";
-import "./chunk-MOWUP33K.js";
+} from "./chunk-5A4RHEEL.js";
+import "./chunk-SZDOBIWE.js";
+import "./chunk-2HDNOUJU.js";
+import "./chunk-RK5P2DWD.js";
+import "./chunk-K3QKOVZN.js";
+import "./chunk-QAFQLILX.js";
+import "./chunk-HQMLY2R6.js";
+import "./chunk-I2EWY3MG.js";
+import "./chunk-UFIQ5FWY.js";
+import "./chunk-ZDA72732.js";
 import "./chunk-QA4O2GGC.js";
 import {
   gitUser
-} from "./chunk-OSZTENIA.js";
+} from "./chunk-XIJBQM45.js";
 import {
   HOSTS_STEP,
+  IGNORE_REASON_MAX,
   QuestionError,
   TARGETS_STEP_ID,
   TOPICS_STEP_ID,
@@ -46,16 +47,16 @@ import {
   questionsRelOf,
   readQuestion,
   topicOfQuestion
-} from "./chunk-GJVCBTSO.js";
+} from "./chunk-6ZDAEUKB.js";
 import {
   writeFileAtomic
-} from "./chunk-G3ZFEHCX.js";
+} from "./chunk-MEMEO7YO.js";
 import {
   QuestionScopeLevel,
   QuestionState,
   answerByWords,
   external_exports
-} from "./chunk-QFDPX6C4.js";
+} from "./chunk-LZFKJ2BR.js";
 import "./chunk-CTJHEG6A.js";
 import {
   require_dist
@@ -361,7 +362,7 @@ async function questionsFiles(root, argv, io, deps = {}) {
     const p = q.state === "open" ? await proposalOf(root, q.id) : void 0;
     const proposal = p?.ok && p.proposal ? { ...p.proposal, file: p.file } : void 0;
     if (values.json === true) {
-      const picks = q.state === "open" && (q.askedBy.step === TARGETS_STEP_ID || q.askedBy.step === TOPICS_STEP_ID) ? await (await import("./chunk-B63NWU3P.js")).pickerOf(root) : void 0;
+      const picks = q.state === "open" && (q.askedBy.step === TARGETS_STEP_ID || q.askedBy.step === TOPICS_STEP_ID) ? await (await import("./chunk-HVWPN2RY.js")).pickerOf(root) : void 0;
       const rule = q.state === "open" && q.askedBy.step === TARGETS_STEP_ID ? (await routeQuestions(root, [q])).about[q.id]?.rule : void 0;
       io.out(JSON.stringify({
         ...q,
@@ -475,6 +476,10 @@ async function questionsFiles(root, argv, io, deps = {}) {
       io.err("--reason goes with --ignore.");
       return 2;
     }
+    if (reason && reason.length > IGNORE_REASON_MAX) {
+      io.err(`--reason is at most ${IGNORE_REASON_MAX} characters (this is ${reason.length}): say it in fewer words.`);
+      return 2;
+    }
     if (ignore && (opt !== void 0 || text !== void 0 || accept || target)) {
       io.err("--ignore is the answer: give it alone (with --reason), not with another answer.");
       return 2;
@@ -484,8 +489,8 @@ async function questionsFiles(root, argv, io, deps = {}) {
         io.err("--target names the answer: give it alone, not with --option, --text or --accept-proposal.");
         return 2;
       }
-      const { readQuestion: readQuestion2 } = await import("./chunk-6OZAQPU5.js");
-      const { targetAnswerOf, pickerOf, pickerText, offerLine } = await import("./chunk-B63NWU3P.js");
+      const { readQuestion: readQuestion2 } = await import("./chunk-UXVKFOMC.js");
+      const { targetAnswerOf, pickerOf, pickerText, offerLine } = await import("./chunk-HVWPN2RY.js");
       const q0 = await readQuestion2(root, id).catch(() => void 0);
       if (!q0) {
         io.err(`There is no question ${id}.`);
@@ -580,7 +585,7 @@ async function questionsFiles(root, argv, io, deps = {}) {
         throw e;
       io.err(e.message);
       if (/opens the list of every repo/.test(e.message)) {
-        const { pickerOf, pickerText } = await import("./chunk-B63NWU3P.js");
+        const { pickerOf, pickerText } = await import("./chunk-HVWPN2RY.js");
         for (const l of pickerText(await pickerOf(root)))
           io.err(`  ${l}`);
       }

package/dist/{chunk-4DCIUKIE.js → chunk-BIWNRS5I.js}

@@ -9,17 +9,17 @@ import {
 import {
   componentTypeIds,
   componentTypesAt
-} from "./chunk-HGDBM3A5.js";
+} from "./chunk-W4SMKUAK.js";
 import {
   recordTopUpVerified
-} from "./chunk-HXFZX2BI.js";
+} from "./chunk-DXLWZ3BJ.js";
 import {
   notesAt
-} from "./chunk-DCRZ3OQ7.js";
+} from "./chunk-V5FT3MZG.js";
 import {
   loadReadPlan,
   recordReadProgress
-} from "./chunk-LKUTBQ2Y.js";
+} from "./chunk-P6DM2EFI.js";
 import {
   carryOf,
   checkoutOf,
@@ -33,29 +33,29 @@ import {
   reviewedProblemsOf,
   slipNoteLines,
   writeVerifyFiles
-} from "./chunk-GCMDDVIE.js";
+} from "./chunk-XDLMQL5A.js";
 import {
   dirSource,
   frameworkFacts,
   frameworksToLearn,
   repairFormSlips,
   verifyFacts
-} from "./chunk-HNPKCRCE.js";
+} from "./chunk-RK5P2DWD.js";
 import {
   NoRoomError,
   roomGuard,
   streamFacts
-} from "./chunk-FL53R4SW.js";
+} from "./chunk-DHQXCP2X.js";
 import {
   factsDirOf,
   factsRelOf,
   listQuestions,
   orgPackDirOf,
   stackHelpersOff
-} from "./chunk-GJVCBTSO.js";
+} from "./chunk-6ZDAEUKB.js";
 import {
   loadOrgPack
-} from "./chunk-QFDPX6C4.js";
+} from "./chunk-LZFKJ2BR.js";
 
 // packages/cli/dist/verify-commands.js
 import { existsSync } from "node:fs";
@@ -141,7 +141,12 @@ async function verifyCommand(root, repo, o, io) {
     return 2;
   }
   const repaired = repairFormSlips(parsed.facts, parsed.bad);
-  parsed = { facts: repaired.facts, bad: repaired.bad };
+  parsed = { facts: repaired.facts, bad: repaired.bad, newer: parsed.newer };
+  if (parsed.newer.length) {
+    io.err(`${parsed.newer.length} ${parsed.newer.length === 1 ? "fact" : "facts"} of ${rel}/${repo}.jsonl ${parsed.newer.length === 1 ? "is" : "are"} written by a newer Atticus: kept in the file as written, not read here. Install that version (a team upgrades together):`);
+    for (const n2 of parsed.newer.slice(0, SHOWN))
+      io.err(`  line ${n2.line}: ${n2.message}`);
+  }
   const slips = repaired.slips;
   if (!parsed.facts.length && parsed.bad.length) {
     io.err(`${rel}/${repo}.jsonl does not read as facts:`);
@@ -220,8 +225,9 @@ async function verifyCommand(root, repo, o, io) {
     raw: b.raw,
     message: `line ${b.line} isn't a fact: ${b.issues.map((i) => i.message).join("; ")}`
   }));
-  const summary = await writeVerifyFiles(root, repo, report, commit, qProblems, badLines, reviewedBad, slips);
   const failed = report.rejected.length + qProblems.length + badLines.length + reviewedBad.length > 0;
+  const refusedWrite = o.write === true && failed;
+  const summary = await writeVerifyFiles(root, repo, report, commit, qProblems, badLines, reviewedBad, slips, parsed.newer.flatMap((n2) => n2.raw !== void 0 ? [n2.raw] : []), { keepFacts: refusedWrite });
   await recordReadProgress(root, repo, {
     commit,
     kept: report.accepted.length,
@@ -233,11 +239,12 @@ async function verifyCommand(root, repo, o, io) {
   });
   if (!failed)
     await recordTopUpVerified(root, repo, { commit });
-  const rejectedNote = `Nothing written to the catalog: ${report.rejected.length} facts were rejected. Fix them and run atticus verify ${repo} --write again.`;
+  const n = report.rejected.length;
+  const rejectedNote = `Nothing written: ${n ? `${n} ${n === 1 ? "fact was" : "facts were"} rejected` : "some lines of the read were refused"}, so ${rel}/${repo}.jsonl and the catalog are left as they were. Fix them from ${rel}/${repo}.rejected.jsonl and run atticus verify ${repo} --write again.`;
   if (o.json) {
     let written2;
     if (o.write && !failed) {
-      const { writeFactsIntoCatalog: writeFactsIntoCatalog2 } = await import("./chunk-BTS56NV7.js");
+      const { writeFactsIntoCatalog: writeFactsIntoCatalog2 } = await import("./chunk-NP3PG6OI.js");
       written2 = await writeFactsIntoCatalog2(root, repo, report.accepted, { dir, command: `atticus verify ${repo} --write` }, { ...io, out: () => void 0 });
       if (!written2)
         return 1;
@@ -377,6 +384,11 @@ async function verifyCommand(root, repo, o, io) {
     io.out(`${unrecorded.length} ${unrecorded.length === 1 ? "coordinate or dependency" : "coordinates and dependencies"} a build file read writes ${unrecorded.length === 1 ? "has" : "have"} no fact (a note, not a rejection; under buildUnrecorded in ${verifyYaml}): record each as an artifact or dependency fact, so a library of the estate's own is drawn as what its services build on:`);
     show(unrecorded.map((u) => `${u.kind} ${u.coordinates} (${u.cite})`), `(buildUnrecorded in ${verifyYaml})`);
   }
+  const placed = report.componentsPlaced ?? [];
+  if (placed.length) {
+    io.out(`${placed.length} ${placed.length === 1 ? "fact names a component" : "facts name components"} the manifest doesn't list, in a repo whose manifest lists no modules (a note, not a rejection; under componentsPlaced in ${verifyYaml}): each is placed in the repo's component. List the modules in repos.manifest.yaml if they ship apart:`);
+    show(placed.map((p) => `${p.id}: ${p.named} is ${p.component} (${p.cite})`), `(componentsPlaced in ${verifyYaml})`);
+  }
   const learn = off.has("framework-models") ? [] : frameworksToLearn(report.accepted, await frameworksKnownTo(root), (await conventionsAt(root)).frameworks);
   if (learn.length) {
     io.out(`${learn.length} ${learn.length === 1 ? "framework" : "frameworks"} of the house nothing here can read yet: teach ${learn.length === 1 ? "it" : "them"} once, rather than having each repo's annotations read as ordinary code.`);
@@ -391,7 +403,7 @@ async function verifyCommand(root, repo, o, io) {
     io.out(`When the read is complete: atticus verify ${repo} --write puts the facts in the catalog, the flows in specs/${repo}/, and renders the map.`);
     return 0;
   }
-  const { writeFactsIntoCatalog } = await import("./chunk-BTS56NV7.js");
+  const { writeFactsIntoCatalog } = await import("./chunk-NP3PG6OI.js");
   const written = await writeFactsIntoCatalog(root, repo, report.accepted, { dir, command: `atticus verify ${repo} --write`, verbose: o.verbose === true }, io);
   return written ? 0 : 1;
 }