@maycombhq/atticus 2.0.0-beta.25 → 2.0.0-beta.27

package/dist/{chunk-KGT5RIGE.js → chunk-UYYYQTPD.js}

@@ -9,17 +9,17 @@ import {
 import {
   componentTypeIds,
   componentTypesAt
-} from "./chunk-USH4VU5D.js";
+} from "./chunk-OUGTAOGA.js";
 import {
   recordTopUpVerified
-} from "./chunk-XXJSGCDO.js";
+} from "./chunk-FG65LXED.js";
 import {
   notesAt
-} from "./chunk-5WZV37WS.js";
+} from "./chunk-FKAUBC4Y.js";
 import {
   loadReadPlan,
   recordReadProgress
-} from "./chunk-DBVQEPZB.js";
+} from "./chunk-VVLWEM2Y.js";
 import {
   carryOf,
   checkoutOf,
@@ -33,29 +33,29 @@ import {
   reviewedProblemsOf,
   slipNoteLines,
   writeVerifyFiles
-} from "./chunk-XP5DF5MC.js";
+} from "./chunk-QPAANKUR.js";
 import {
   dirSource,
   frameworkFacts,
   frameworksToLearn,
   repairFormSlips,
   verifyFacts
-} from "./chunk-CGVRLQAY.js";
+} from "./chunk-YIGSUTW2.js";
 import {
   NoRoomError,
   roomGuard,
   streamFacts
-} from "./chunk-DJ4C5ELF.js";
+} from "./chunk-3PBIZBWN.js";
 import {
   factsDirOf,
   factsRelOf,
   listQuestions,
   orgPackDirOf,
   stackHelpersOff
-} from "./chunk-GLISHJ4G.js";
+} from "./chunk-WJWSB65O.js";
 import {
   loadOrgPack
-} from "./chunk-LZFKJ2BR.js";
+} from "./chunk-A3LVMCA5.js";
 
 // packages/cli/dist/verify-commands.js
 import { existsSync } from "node:fs";
@@ -66,6 +66,33 @@ async function frameworksKnownTo(root) {
   return (op?.frameworks ?? []).flatMap((f) => [f.name, ...f.artifacts]);
 }
 var SHOWN = 5;
+var listed = (lines, more, all = false) => all || lines.length <= SHOWN ? lines.map((l) => `  ${l}`) : [
+  ...lines.slice(0, SHOWN).map((l) => `  ${l}`),
+  `  ... and ${lines.length - SHOWN} more ${more}`
+];
+function skippedNoteLines(report, o) {
+  const out = [];
+  const { verifyYaml, seeAll, all } = o;
+  const skippedLines = report.skipped;
+  if (skippedLines.length)
+    out.push(`${skippedLines.length} ${skippedLines.length === 1 ? "line of the files read writes" : "lines of the files read write"} a path, URL or topic no fact cites (a note for the reader to check, not a rejection; under skipped in ${verifyYaml}; ${seeAll}):`, ...listed(skippedLines.map((x) => `${x.cite} ${x.kind} ${x.value}`), `(${seeAll})`, all));
+  const holds = report.reviewedHolds;
+  if (holds.length)
+    out.push(`${holds.length} reviewed ${holds.length === 1 ? "glob holds" : "globs hold"} lines that write a path, URL or topic (a note; under reviewedHolds in ${verifyYaml}): read them, then write their facts or say why there are none:`, ...listed(holds.map((h) => h.message), `(reviewedHolds in ${verifyYaml})`, all));
+  const ops = report.specOpsUncovered;
+  if (ops.length)
+    out.push(`${ops.length} ${ops.length === 1 ? "operation the repo's OpenAPI spec declares has" : "operations the repo's OpenAPI specs declare have"} no entry (a note, not a rejection; under specOpsUncovered in ${verifyYaml}; ${seeAll}):`, ...listed(ops.map((x) => x.message), `(${seeAll})`, all));
+  return out;
+}
+function unfollowedNoteLines(report, verifyYaml) {
+  const unfollowed = report.entriesNoFlowFollows;
+  if (!unfollowed.length)
+    return [];
+  return [
+    `${unfollowed.length} ${unfollowed.length === 1 ? "entry" : "entries"} no flow follows (a note, not a rejection; listed under entriesNoFlowFollows in ${verifyYaml}): write a flow for each that does real work.`,
+    ...listed(unfollowed.map((e) => `${e.entryType === "rest" && e.method ? e.method : e.entryType} ${e.path} (${e.id}, ${e.cite})`), `(entriesNoFlowFollows in ${verifyYaml})`)
+  ];
+}
 function questionLines(text) {
   const lines = [];
   const problems = [];
@@ -144,8 +171,8 @@ async function verifyCommand(root, repo, o, io) {
   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 n of parsed.newer.slice(0, SHOWN))
-      io.err(`  line ${n.line}: ${n.message}`);
+    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) {
@@ -225,8 +252,10 @@ 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, parsed.newer.flatMap((n) => n.raw !== void 0 ? [n.raw] : []));
   const failed = report.rejected.length + qProblems.length + badLines.length + reviewedBad.length > 0;
+  const refusedWrite = o.write === true && failed;
+  const complete = !failed && report.coverage.unknown.length === 0;
+  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,
@@ -238,13 +267,24 @@ 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;
+    let refusedBuild;
     if (o.write && !failed) {
-      const { writeFactsIntoCatalog: writeFactsIntoCatalog2 } = await import("./chunk-7X3WLAKP.js");
-      written2 = await writeFactsIntoCatalog2(root, repo, report.accepted, { dir, command: `atticus verify ${repo} --write` }, { ...io, out: () => void 0 });
-      if (!written2)
+      const { writeFactsIntoCatalog: writeFactsIntoCatalog2 } = await import("./chunk-Z65FWO6A.js");
+      written2 = await writeFactsIntoCatalog2(root, repo, report.accepted, {
+        dir,
+        command: `atticus verify ${repo} --write`,
+        ...commit ? { commit } : {},
+        ...complete ? { readComplete: true } : {},
+        ...o.allowRemovals !== void 0 ? { allowRemovals: o.allowRemovals } : {},
+        ...o.discardEdits !== void 0 ? { discardEdits: o.discardEdits } : {},
+        ...o.plan !== void 0 ? { plan: o.plan } : {},
+        onRefused: (r) => refusedBuild = r.guard.refused
+      }, { ...io, out: () => void 0 });
+      if (!written2 && !refusedBuild)
         return 1;
     } else if (o.write)
       io.err(rejectedNote);
@@ -259,9 +299,10 @@ async function verifyCommand(root, repo, o, io) {
         problems: qProblems
       },
       ...reviewedBad.length ? { reviewedProblems: reviewedBad } : {},
-      ...written2 ? { written: written2 } : {}
+      ...written2 ? { written: written2 } : {},
+      ...refusedBuild ? { refused: refusedBuild } : {}
     }, null, 2));
-    return failed ? 1 : 0;
+    return failed || refusedBuild ? 1 : 0;
   }
   const pct = Math.round(report.coverage.ratio * 100);
   const cov = report.coverage;
@@ -313,9 +354,11 @@ async function verifyCommand(root, repo, o, io) {
   show(qProblems.map((q) => `bad-question: ${q.message}`), `refused questions (all in ${rejectedFile})`);
   show(badLines.map((b) => `schema: ${b.message}`), `lines that aren't facts (all in ${rejectedFile})`);
   show(reviewedBad.map((b) => `bad-reviewed: ${b.message}`), `refused reviewed lines (all in ${rejectedFile})`);
-  if (failed)
+  if (failed) {
+    if (!refusedWrite && report.rejected.some((r) => r.code !== "wrong-commit"))
+      io.out(`The rejected facts were moved out of ${rel}/${repo}.jsonl into ${rel}/${repo}.rejected.jsonl, each with why: nothing was undone, and the facts kept stay as they are.`);
     io.out(`Fix them from ${rel}/${repo}.rejected.jsonl (read the lines again, then rewrite or drop each fact, question or reviewed line) and run atticus verify ${repo} again.`);
-  else if (cov.unknown.length)
+  } else if (cov.unknown.length)
     io.out(`Next: read the ${cov.unknown.length} unknown files (listed in ${rel}/${repo}.verify.yaml). A file you read and found nothing to record in goes in ${rel}/${repo}.reviewed.jsonl ({"path": "<file or glob>", "why": "..."} per line); generated code is excluded in org-pack/scan/${repo}.yaml.`);
   else
     io.out(`The read is complete: every source file is read (${cov.read.length})${cov.reviewed.length ? ` or reviewed with nothing to record (${cov.reviewed.length}, each with why in ${rel}/${repo}.verify.yaml)` : ""}.`);
@@ -331,30 +374,12 @@ async function verifyCommand(root, repo, o, io) {
     io.out(`${unseen.length} ${unseen.length === 1 ? "entry or call claims" : "entries or calls claim"} an HTTP method ${unseen.length === 1 ? "its" : "their"} lines don't write (a warning, not a rejection; under methodUnseen in ${verifyYaml}):`);
     show(unseen.map((m) => m.message), `(methodUnseen in ${verifyYaml})`);
   }
-  const all = o.skipped === true;
-  const list = (lines, more) => {
-    if (all)
-      for (const l of lines)
-        io.out(`  ${l}`);
-    else
-      show(lines, more);
-  };
-  const seeAll = `atticus verify ${repo} --skipped prints every one`;
-  const skippedLines = report.skipped;
-  if (skippedLines.length) {
-    io.out(`${skippedLines.length} ${skippedLines.length === 1 ? "line of the files read writes" : "lines of the files read write"} a path, URL or topic no fact cites (a note for the reader to check, not a rejection; under skipped in ${verifyYaml}; ${seeAll}):`);
-    list(skippedLines.map((x) => `${x.cite} ${x.kind} ${x.value}`), `(${seeAll})`);
-  }
-  const holds = report.reviewedHolds;
-  if (holds.length) {
-    io.out(`${holds.length} reviewed ${holds.length === 1 ? "glob holds" : "globs hold"} lines that write a path, URL or topic (a note; under reviewedHolds in ${verifyYaml}): read them, then write their facts or say why there are none:`);
-    list(holds.map((h) => h.message), `(reviewedHolds in ${verifyYaml})`);
-  }
-  const ops = report.specOpsUncovered;
-  if (ops.length) {
-    io.out(`${ops.length} ${ops.length === 1 ? "operation the repo's OpenAPI spec declares has" : "operations the repo's OpenAPI specs declare have"} no entry (a note, not a rejection; under specOpsUncovered in ${verifyYaml}; ${seeAll}):`);
-    list(ops.map((x) => x.message), `(${seeAll})`);
-  }
+  for (const l of skippedNoteLines(report, {
+    verifyYaml,
+    seeAll: `atticus verify ${repo} --skipped prints every one`,
+    all: o.skipped === true
+  }))
+    io.out(l);
   if (report.redacted)
     io.out(`${report.redacted} quotes had a secret value redacted.`);
   if (report.quotesDropped)
@@ -364,11 +389,8 @@ async function verifyCommand(root, repo, o, io) {
     io.out(`${noAuth.length} ${noAuth.length === 1 ? "entry's" : "entries'"} auth rests on no cited line (all under authUncited in ${verifyYaml}). ${noAuth.length === 1 ? "It is" : "They are"} kept in ${rel}/${repo}.jsonl, as the reader wrote ${noAuth.length === 1 ? "it" : "them"}, and left out of the catalog, so the map never says an auth nothing shows. To record ${noAuth.length === 1 ? "it" : "them"}: give each entry an authCite \u2014 the file and line that sets the auth and what it writes there \u2014 and run atticus verify ${repo} again:`);
     show(noAuth.map((a) => `${a.id} (${a.auth}, ${a.cite})`), `(authUncited in ${verifyYaml})`);
   }
-  const unfollowed = report.entriesNoFlowFollows;
-  if (unfollowed.length) {
-    io.out(`${unfollowed.length} ${unfollowed.length === 1 ? "entry" : "entries"} no flow follows (a note, not a rejection; listed under entriesNoFlowFollows in ${verifyYaml}): write a flow for each that does real work.`);
-    show(unfollowed.map((e) => `${e.entryType === "rest" && e.method ? e.method : e.entryType} ${e.path} (${e.id}, ${e.cite})`), `(entriesNoFlowFollows in ${verifyYaml})`);
-  }
+  for (const l of unfollowedNoteLines(report, verifyYaml))
+    io.out(l);
   const fws = frameworkFacts(report.accepted);
   if (fws.length)
     io.out(`Built on ${fws.map((f) => `${f.name}${f.version ? ` ${f.version}` : ""}`).join(", ")} (frameworks in ${verifyYaml}).`);
@@ -401,13 +423,24 @@ 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-7X3WLAKP.js");
-  const written = await writeFactsIntoCatalog(root, repo, report.accepted, { dir, command: `atticus verify ${repo} --write`, verbose: o.verbose === true }, io);
+  const { writeFactsIntoCatalog } = await import("./chunk-Z65FWO6A.js");
+  const written = await writeFactsIntoCatalog(root, repo, report.accepted, {
+    dir,
+    command: `atticus verify ${repo} --write`,
+    verbose: o.verbose === true,
+    ...commit ? { commit } : {},
+    ...complete ? { readComplete: true } : {},
+    ...o.allowRemovals !== void 0 ? { allowRemovals: o.allowRemovals } : {},
+    ...o.discardEdits !== void 0 ? { discardEdits: o.discardEdits } : {},
+    ...o.plan !== void 0 ? { plan: o.plan } : {}
+  }, io);
   return written ? 0 : 1;
 }
 
 export {
   SHOWN,
+  skippedNoteLines,
+  unfollowedNoteLines,
   factsRepos,
   verifyAllCommand,
   verifyInputsOf,

package/dist/{chunk-LKRMVWXB.js → chunk-V34N6JAN.js}

@@ -6,44 +6,44 @@ var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   FRESH_STATES,
   estateFreshness
-} from "./chunk-MM7YWUBB.js";
-import "./chunk-AGAFNUYZ.js";
-import "./chunk-WA644MUQ.js";
-import "./chunk-YEGGQG5E.js";
-import "./chunk-TIOYZDRB.js";
-import "./chunk-5WZV37WS.js";
+} from "./chunk-CIFR3DPV.js";
+import "./chunk-VN2VJ6BV.js";
+import "./chunk-FM3EEDS2.js";
+import "./chunk-P36PTWBM.js";
+import "./chunk-FKAUBC4Y.js";
 import {
   loadReadPlan,
   readCostOf
-} from "./chunk-DBVQEPZB.js";
-import "./chunk-XP5DF5MC.js";
-import "./chunk-G5P7F6RQ.js";
-import "./chunk-J65TN6QU.js";
+} from "./chunk-VVLWEM2Y.js";
+import "./chunk-QPAANKUR.js";
+import "./chunk-FADIWOA5.js";
+import "./chunk-YJTBE6AJ.js";
+import "./chunk-LZO3JABE.js";
 import "./chunk-3G4YI4ZU.js";
+import "./chunk-Y2TVTI4P.js";
 import "./chunk-VOGCSYOI.js";
-import "./chunk-QSKY7FE3.js";
-import "./chunk-GDGE7ZHC.js";
-import "./chunk-JQGWP3SC.js";
-import "./chunk-UTZMF5CV.js";
-import "./chunk-U7YZ3IRI.js";
-import "./chunk-DLNQ3HUM.js";
+import "./chunk-U3Z2QZE3.js";
+import "./chunk-SVOGRJO6.js";
+import "./chunk-23TTURB2.js";
 import {
   componentRenames,
   estateFacts,
   isPrototypeRepo,
   joinReposOf,
   outsideSystems
-} from "./chunk-YRKAJ42V.js";
-import "./chunk-CGVRLQAY.js";
-import "./chunk-RL7PETU6.js";
-import "./chunk-PGKCRK77.js";
-import "./chunk-M6HI36T3.js";
-import "./chunk-2VN4TLGI.js";
-import "./chunk-4U3JLIRC.js";
-import "./chunk-MXPKXCGP.js";
-import "./chunk-QQD25YNF.js";
-import "./chunk-QA4O2GGC.js";
-import "./chunk-WS7KBKP4.js";
+} from "./chunk-QC6GSNIK.js";
+import "./chunk-YIGSUTW2.js";
+import "./chunk-N5DLB74D.js";
+import "./chunk-UWBODTY7.js";
+import "./chunk-I57IH5X6.js";
+import "./chunk-LCQIRCOT.js";
+import "./chunk-X5B7KYPD.js";
+import "./chunk-IPSZDVLI.js";
+import "./chunk-2MRYL45Z.js";
+import "./chunk-ELJ5Q4J2.js";
+import "./chunk-XZY4GTCX.js";
+import "./chunk-3M3MDBOG.js";
+import "./chunk-T2MN24LZ.js";
 import {
   HOSTS_STEP,
   LINK_QUESTION_STEPS,
@@ -59,16 +59,17 @@ import {
   listQuestions,
   orgPackDirOf,
   parseFacts
-} from "./chunk-GLISHJ4G.js";
-import "./chunk-G3ZFEHCX.js";
+} from "./chunk-WJWSB65O.js";
+import "./chunk-SMFFUFMN.js";
 import {
   joinConventions,
   loadOrgPack
-} from "./chunk-LZFKJ2BR.js";
-import "./chunk-CTJHEG6A.js";
+} from "./chunk-A3LVMCA5.js";
+import "./chunk-NWMFVPEP.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";
+import "./chunk-R4TUWD4C.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";

package/dist/{chunk-RX56MZLX.js → chunk-V3Y5P7OS.js}

@@ -19,31 +19,32 @@ import {
   handoffPublisherFor,
   parseOwners,
   syncAfterManualStep
-} from "./chunk-UTYL4XVA.js";
-import "./chunk-EXCXNDTQ.js";
+} from "./chunk-7GXM45T5.js";
+import "./chunk-IF3X6FMO.js";
+import "./chunk-JL2VOYSL.js";
+import "./chunk-INCFIDCB.js";
 import "./chunk-VOGCSYOI.js";
-import "./chunk-IWQEZFVV.js";
-import "./chunk-EM7F6XEU.js";
-import "./chunk-GDGE7ZHC.js";
-import "./chunk-JQGWP3SC.js";
-import "./chunk-UTZMF5CV.js";
-import "./chunk-U7YZ3IRI.js";
-import "./chunk-DLNQ3HUM.js";
-import "./chunk-YRKAJ42V.js";
-import "./chunk-CGVRLQAY.js";
-import "./chunk-RL7PETU6.js";
-import "./chunk-PGKCRK77.js";
-import "./chunk-M6HI36T3.js";
-import "./chunk-2VN4TLGI.js";
-import "./chunk-4U3JLIRC.js";
-import "./chunk-QQD25YNF.js";
-import "./chunk-QA4O2GGC.js";
-import "./chunk-WS7KBKP4.js";
-import "./chunk-GLISHJ4G.js";
-import "./chunk-G3ZFEHCX.js";
-import "./chunk-LZFKJ2BR.js";
-import "./chunk-CTJHEG6A.js";
+import "./chunk-U3Z2QZE3.js";
+import "./chunk-SVOGRJO6.js";
+import "./chunk-23TTURB2.js";
+import "./chunk-QC6GSNIK.js";
+import "./chunk-YIGSUTW2.js";
+import "./chunk-N5DLB74D.js";
+import "./chunk-UWBODTY7.js";
+import "./chunk-I57IH5X6.js";
+import "./chunk-LCQIRCOT.js";
+import "./chunk-X5B7KYPD.js";
+import "./chunk-IPSZDVLI.js";
+import "./chunk-2MRYL45Z.js";
+import "./chunk-ELJ5Q4J2.js";
+import "./chunk-XZY4GTCX.js";
+import "./chunk-3M3MDBOG.js";
+import "./chunk-WJWSB65O.js";
+import "./chunk-SMFFUFMN.js";
+import "./chunk-A3LVMCA5.js";
+import "./chunk-NWMFVPEP.js";
 import "./chunk-BQGDB6ZL.js";
+import "./chunk-R4TUWD4C.js";
 import "./chunk-TV45EUGM.js";
 export {
   captureLine,

package/dist/chunk-V6MLVGTP.js

@@ -0,0 +1,89 @@
+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 {
+  changeFolder,
+  changeStore
+} from "./chunk-SVOGRJO6.js";
+import {
+  changesDirOf
+} from "./chunk-WJWSB65O.js";
+import {
+  RecordId
+} from "./chunk-A3LVMCA5.js";
+
+// packages/cli/dist/change-problems.js
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+var lineOf = (message) => {
+  const m = /\bat line (\d+)/.exec(message);
+  return m ? Number(m[1]) : void 0;
+};
+var UNRESOLVED = /^Unresolved alias\b[^:]*:\s*(.+)$/;
+async function aliasWords(file, message) {
+  const name = UNRESOLVED.exec(message)?.[1]?.trim();
+  if (!name)
+    return void 0;
+  const text = await readFile(file, "utf8").catch(() => "");
+  const esc = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const at = new RegExp(`(^|[\\s\\[{,:-])\\*${esc}(?=$|[\\s\\]},])`);
+  const i = text.split(/\r?\n/).findIndex((l) => at.test(l));
+  return {
+    message: `An alias (*) names an anchor (&) this file doesn't set${i >= 0 ? ` at line ${i + 1}` : ""}`,
+    ...i >= 0 ? { line: i + 1 } : {}
+  };
+}
+async function changeProblems(root) {
+  const { problems } = await changeStore(root).listWithProblems();
+  return Promise.all(problems.map(async (p) => {
+    const file = relative(root, p.file).split(sep).join("/");
+    const id = file.split("/").at(-2) ?? file;
+    const said = (p.message.startsWith(`${p.file}: `) ? p.message.slice(p.file.length + 2) : p.message).split("\n")[0].replace(/:\s*$/, "").trim();
+    const alias = await aliasWords(p.file, said.replace(/^invalid YAML:\s*/, ""));
+    const message = alias ? said.replace(/Unresolved alias.*$/, alias.message) : said;
+    const line = alias?.line ?? lineOf(message);
+    return { id, file, ...line ? { line } : {}, message };
+  }));
+}
+function distance(a, b) {
+  const d = Array.from({ length: b.length + 1 }, (_, i) => i);
+  for (let i = 1; i <= a.length; i++) {
+    let prev = d[0];
+    d[0] = i;
+    for (let j = 1; j <= b.length; j++) {
+      const t = d[j];
+      d[j] = Math.min(d[j] + 1, d[j - 1] + 1, prev + (a[i - 1] === b[j - 1] ? 0 : 1));
+      prev = t;
+    }
+  }
+  return d[b.length];
+}
+function nearIds(id, ids) {
+  const want = id.toLowerCase().slice(0, 120);
+  return ids.map((x) => ({
+    x,
+    d: x.includes(want) || want.includes(x) ? 0 : distance(want, x)
+  })).filter((c) => c.x !== id && c.d <= Math.max(2, Math.floor(want.length / 3))).sort((a, b) => a.d - b.d || a.x.localeCompare(b.x)).slice(0, 3).map((c) => c.x);
+}
+async function missingChangeWords(root, id) {
+  if (RecordId.safeParse(id).success) {
+    const broken = (await changeProblems(root).catch(() => [])).find((p) => p.id === id);
+    if (broken)
+      return `${id}'s change.yaml doesn't read (${broken.file}${broken.line ? `, line ${broken.line}` : ""}): ${broken.message.replace(/[^.!?]$/, "$&.")} Fix the file and the change comes back.`;
+  }
+  const ids = await readdir(changesDirOf(root), { withFileTypes: true }).then((es) => es.filter((e) => e.isDirectory() && e.name !== "archive").map((e) => e.name)).catch(() => []);
+  const real = [];
+  for (const x of ids)
+    if (await stat(join(changeFolder(root, x), "change.yaml")).catch(() => void 0))
+      real.push(x);
+  const near = nearIds(id, real);
+  return `There is no change ${id}.${near.length ? ` Did you mean ${near.join(", ")}?` : ""}`;
+}
+
+export {
+  changeProblems,
+  nearIds,
+  missingChangeWords
+};