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

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

@@ -9,17 +9,17 @@ import {
 import {
   componentTypeIds,
   componentTypesAt
-} from "./chunk-W4SMKUAK.js";
+} from "./chunk-OUGTAOGA.js";
 import {
   recordTopUpVerified
-} from "./chunk-DXLWZ3BJ.js";
+} from "./chunk-FG65LXED.js";
 import {
   notesAt
-} from "./chunk-V5FT3MZG.js";
+} from "./chunk-FKAUBC4Y.js";
 import {
   loadReadPlan,
   recordReadProgress
-} from "./chunk-P6DM2EFI.js";
+} from "./chunk-VVLWEM2Y.js";
 import {
   carryOf,
   checkoutOf,
@@ -33,29 +33,29 @@ import {
   reviewedProblemsOf,
   slipNoteLines,
   writeVerifyFiles
-} from "./chunk-XDLMQL5A.js";
+} from "./chunk-QPAANKUR.js";
 import {
   dirSource,
   frameworkFacts,
   frameworksToLearn,
   repairFormSlips,
   verifyFacts
-} from "./chunk-RK5P2DWD.js";
+} from "./chunk-YIGSUTW2.js";
 import {
   NoRoomError,
   roomGuard,
   streamFacts
-} from "./chunk-DHQXCP2X.js";
+} from "./chunk-3PBIZBWN.js";
 import {
   factsDirOf,
   factsRelOf,
   listQuestions,
   orgPackDirOf,
   stackHelpersOff
-} from "./chunk-6ZDAEUKB.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 = [];
@@ -227,6 +254,7 @@ async function verifyCommand(root, repo, o, io) {
   }));
   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,
@@ -243,10 +271,20 @@ async function verifyCommand(root, repo, o, io) {
   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-NP3PG6OI.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);
@@ -261,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;
@@ -315,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)` : ""}.`);
@@ -333,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)
@@ -366,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}).`);
@@ -403,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-NP3PG6OI.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-IDRCBMJF.js → chunk-V34N6JAN.js}

@@ -6,44 +6,44 @@ var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   FRESH_STATES,
   estateFreshness
-} from "./chunk-IL7PVMUO.js";
-import "./chunk-EUTZTJIO.js";
-import "./chunk-RBO4A7TC.js";
-import "./chunk-ET7SPOBA.js";
-import "./chunk-BD7HBZLP.js";
-import "./chunk-V5FT3MZG.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-P6DM2EFI.js";
-import "./chunk-XDLMQL5A.js";
-import "./chunk-PBDIVTFL.js";
-import "./chunk-XI3GPYP4.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-2SCZZQNQ.js";
-import "./chunk-VIQHZA53.js";
-import "./chunk-WH3ZFLXT.js";
-import "./chunk-UTZMF5CV.js";
-import "./chunk-6U65YB54.js";
-import "./chunk-SZDOBIWE.js";
+import "./chunk-U3Z2QZE3.js";
+import "./chunk-SVOGRJO6.js";
+import "./chunk-23TTURB2.js";
 import {
   componentRenames,
   estateFacts,
   isPrototypeRepo,
   joinReposOf,
   outsideSystems
-} from "./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-MTIRNHRJ.js";
-import "./chunk-ZDA72732.js";
-import "./chunk-QA4O2GGC.js";
-import "./chunk-XIJBQM45.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-6ZDAEUKB.js";
-import "./chunk-MEMEO7YO.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-EY3OVHNC.js → chunk-V3Y5P7OS.js}

@@ -19,31 +19,32 @@ import {
   handoffPublisherFor,
   parseOwners,
   syncAfterManualStep
-} from "./chunk-OXCHO2QS.js";
-import "./chunk-HNNMT5L2.js";
+} from "./chunk-7GXM45T5.js";
+import "./chunk-IF3X6FMO.js";
+import "./chunk-JL2VOYSL.js";
+import "./chunk-INCFIDCB.js";
 import "./chunk-VOGCSYOI.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 "./chunk-ZDA72732.js";
-import "./chunk-QA4O2GGC.js";
-import "./chunk-XIJBQM45.js";
-import "./chunk-6ZDAEUKB.js";
-import "./chunk-MEMEO7YO.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
+};