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

package/dist/chunk-KN5BXMWN.js

@@ -0,0 +1,44 @@
+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 {
+  boxesOf,
+  candidatesOf,
+  settingsOf,
+  uiLinkRoutes
+} from "./chunk-LFGTYX5U.js";
+import "./chunk-C3RY6KU6.js";
+import "./chunk-S7FCV7S5.js";
+import "./chunk-T6DQR5TV.js";
+import "./chunk-SFUP7TTO.js";
+import "./chunk-7FTTA3HD.js";
+import "./chunk-ZQ3ON2VQ.js";
+import "./chunk-ISUAAMGS.js";
+import "./chunk-VOGCSYOI.js";
+import "./chunk-S4PMJU6H.js";
+import "./chunk-IDKCWSM5.js";
+import "./chunk-UUU4CLJG.js";
+import "./chunk-7IGKHZ4Z.js";
+import "./chunk-J2JAKCIW.js";
+import "./chunk-745DAZ4L.js";
+import "./chunk-CXJ6FUKN.js";
+import "./chunk-QKUJMING.js";
+import "./chunk-6ZGLAACW.js";
+import "./chunk-CQDGOPGH.js";
+import "./chunk-3NFFJL5D.js";
+import "./chunk-F3P7N7SF.js";
+import "./chunk-PKBHS4AA.js";
+import "./chunk-P32RUW3B.js";
+import "./chunk-QA4O2GGC.js";
+import "./chunk-Q2TECDIT.js";
+import "./chunk-TUULXQRW.js";
+import "./chunk-BQGDB6ZL.js";
+import "./chunk-TV45EUGM.js";
+export {
+  boxesOf,
+  candidatesOf,
+  settingsOf,
+  uiLinkRoutes
+};

package/dist/{chunk-PCVDV3UZ.js → chunk-KQGURXFU.js}

@@ -7,16 +7,16 @@ import {
   INPUTS_SOURCE,
   INPUTS_SOURCE_ID,
   inputsPages
-} from "./chunk-ABWHYWNI.js";
+} from "./chunk-D73UEXYW.js";
 import {
   judgingRuntime
-} from "./chunk-BWZ77RQT.js";
+} from "./chunk-PAQ2AS5E.js";
 import {
   table
 } from "./chunk-VOGCSYOI.js";
 import {
   readCatalog
-} from "./chunk-27NKUS3X.js";
+} from "./chunk-J2JAKCIW.js";
 import {
   checkoutGitWiki,
   coverage,
@@ -28,18 +28,20 @@ import {
   syncSources,
   toApiCoverage,
   writeSnapshots
-} from "./chunk-L24C55VN.js";
+} from "./chunk-745DAZ4L.js";
 import {
   createGit
-} from "./chunk-EFHQ3TWP.js";
+} from "./chunk-PKBHS4AA.js";
 import {
   Sources,
   fileJudgments,
   inputsDirOf,
   loadOrgPack,
-  orgPackDirOf,
+  orgPackDirOf
+} from "./chunk-Q2TECDIT.js";
+import {
   require_dist
-} from "./chunk-S2A7YC3Q.js";
+} from "./chunk-BQGDB6ZL.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";

package/dist/{chunk-WY6PP6AA.js → chunk-KXITGYLF.js}

@@ -8,10 +8,16 @@ import {
   notMetarepo
 } from "./chunk-3G4YI4ZU.js";
 import {
-  orgPackDirOf,
+  eolOf,
+  inEol,
+  orgPackDirOf
+} from "./chunk-Q2TECDIT.js";
+import {
+  writeFileIfUnchanged
+} from "./chunk-TUULXQRW.js";
+import {
   require_dist
-} from "./chunk-S2A7YC3Q.js";
-import "./chunk-D3PO4DOZ.js";
+} from "./chunk-BQGDB6ZL.js";
 import {
   __toESM
 } from "./chunk-TV45EUGM.js";
@@ -20,6 +26,32 @@ import {
 var import_yaml = __toESM(require_dist(), 1);
 import { readFile, writeFile } from "node:fs/promises";
 import { join, relative, sep } from "node:path";
+var OwnerEditError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+  }
+};
+var HANDLE = /^[A-Za-z0-9][A-Za-z0-9._@-]*$/;
+async function setOrgPackOwner(root, handle, was) {
+  const file = join(orgPackDirOf(root), "pack.yaml");
+  const rel = relative(root, file).split(sep).join("/");
+  const text = await readFile(file, "utf8").catch(() => void 0);
+  if (text === void 0)
+    throw new OwnerEditError("not-found", `${rel} isn't there: atticus upgrade writes it.`);
+  const h = handle.trim();
+  if (!HANDLE.test(h))
+    throw new OwnerEditError("invalid", "The owner is one handle, such as priya.nair or team-platform: letters, digits, dots, hyphens.");
+  const doc = (0, import_yaml.parseDocument)(text);
+  const now = doc.get("owner");
+  const current = typeof now === "string" && now !== "unassigned" ? now : "";
+  if (was !== void 0 && was !== current)
+    throw new OwnerEditError("conflict", `pack.yaml's owner changed since you opened the form (now ${current || "unassigned"}): look again, then save.`);
+  doc.set("owner", h);
+  await writeFileIfUnchanged(file, text, inEol(doc.toString({ lineWidth: 0 }), eolOf(text)));
+  return { file: rel, owner: h };
+}
 async function orgPackOwnerCli(root, handle, io) {
   if (!isMetarepo(root)) {
     io.err(notMetarepo(root));
@@ -39,15 +71,17 @@ async function orgPackOwnerCli(root, handle, io) {
     return 0;
   }
   const h = handle.trim();
-  if (!/^[A-Za-z0-9][A-Za-z0-9._@-]*$/.test(h)) {
+  if (!HANDLE.test(h)) {
     io.err("The owner is one handle, such as priya.nair or team-platform: letters, digits, dots, hyphens.");
     return 2;
   }
   doc.set("owner", h);
-  await writeFile(file, doc.toString({ lineWidth: 0 }), "utf8");
+  await writeFile(file, inEol(doc.toString({ lineWidth: 0 }), eolOf(text)), "utf8");
   io.out(`${h} now looks after the org pack. Commit ${rel} through a pull request; its owner approves changes to it.`);
   return 0;
 }
 export {
-  orgPackOwnerCli
+  OwnerEditError,
+  orgPackOwnerCli,
+  setOrgPackOwner
 };

package/dist/{chunk-66YVAGGM.js → chunk-L27SV425.js}

@@ -12,27 +12,29 @@ import {
   snowSubmit,
   storyBarCommand,
   templatesDraft
-} from "./chunk-AA6YULYB.js";
-import "./chunk-BWZ77RQT.js";
+} from "./chunk-HNM2YQT2.js";
+import "./chunk-PAQ2AS5E.js";
+import "./chunk-R7NYHMUU.js";
+import "./chunk-IVBOQAGB.js";
+import "./chunk-ISUAAMGS.js";
 import "./chunk-VOGCSYOI.js";
-import "./chunk-CKSITVS4.js";
-import "./chunk-L6SGQIR3.js";
-import "./chunk-3HI6Z55Y.js";
-import "./chunk-XY3P7JW7.js";
-import "./chunk-4AK7IBVP.js";
-import "./chunk-7JUKDRSZ.js";
-import "./chunk-27NKUS3X.js";
-import "./chunk-L24C55VN.js";
-import "./chunk-PAMPPUR6.js";
-import "./chunk-23W7VWKR.js";
-import "./chunk-7EKXJZ2Y.js";
-import "./chunk-MC3H7736.js";
-import "./chunk-T6AIP7H5.js";
-import "./chunk-EFHQ3TWP.js";
-import "./chunk-GQ4N4WKF.js";
-import "./chunk-CNUKCS2T.js";
-import "./chunk-S2A7YC3Q.js";
-import "./chunk-D3PO4DOZ.js";
+import "./chunk-S4PMJU6H.js";
+import "./chunk-IDKCWSM5.js";
+import "./chunk-UUU4CLJG.js";
+import "./chunk-7IGKHZ4Z.js";
+import "./chunk-J2JAKCIW.js";
+import "./chunk-745DAZ4L.js";
+import "./chunk-CXJ6FUKN.js";
+import "./chunk-QKUJMING.js";
+import "./chunk-6ZGLAACW.js";
+import "./chunk-CQDGOPGH.js";
+import "./chunk-3NFFJL5D.js";
+import "./chunk-PKBHS4AA.js";
+import "./chunk-P32RUW3B.js";
+import "./chunk-QA4O2GGC.js";
+import "./chunk-Q2TECDIT.js";
+import "./chunk-TUULXQRW.js";
+import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 export {
   adoSync,

package/dist/{chunk-NE2W3OO7.js → chunk-LDLL7LB3.js}

@@ -6,32 +6,34 @@ var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   renderTaskContext,
   taskContext
-} from "./chunk-CKSITVS4.js";
-import "./chunk-L6SGQIR3.js";
-import "./chunk-3HI6Z55Y.js";
+} from "./chunk-R7NYHMUU.js";
+import "./chunk-IVBOQAGB.js";
+import "./chunk-ISUAAMGS.js";
+import "./chunk-S4PMJU6H.js";
 import {
   changeFolder,
   changeStore
-} from "./chunk-XY3P7JW7.js";
-import "./chunk-4AK7IBVP.js";
-import "./chunk-7JUKDRSZ.js";
-import "./chunk-27NKUS3X.js";
-import "./chunk-L24C55VN.js";
-import "./chunk-PAMPPUR6.js";
+} from "./chunk-IDKCWSM5.js";
+import "./chunk-UUU4CLJG.js";
+import "./chunk-7IGKHZ4Z.js";
+import "./chunk-J2JAKCIW.js";
+import "./chunk-745DAZ4L.js";
+import "./chunk-CXJ6FUKN.js";
 import {
   attachToChange
-} from "./chunk-23W7VWKR.js";
-import "./chunk-7EKXJZ2Y.js";
-import "./chunk-MC3H7736.js";
-import "./chunk-T6AIP7H5.js";
-import "./chunk-EFHQ3TWP.js";
-import "./chunk-GQ4N4WKF.js";
-import "./chunk-CNUKCS2T.js";
+} from "./chunk-QKUJMING.js";
+import "./chunk-6ZGLAACW.js";
+import "./chunk-CQDGOPGH.js";
+import "./chunk-3NFFJL5D.js";
+import "./chunk-PKBHS4AA.js";
+import "./chunk-P32RUW3B.js";
+import "./chunk-QA4O2GGC.js";
 import {
   changesRelOf,
   inputsDirOf
-} from "./chunk-S2A7YC3Q.js";
-import "./chunk-D3PO4DOZ.js";
+} from "./chunk-Q2TECDIT.js";
+import "./chunk-TUULXQRW.js";
+import "./chunk-BQGDB6ZL.js";
 import "./chunk-TV45EUGM.js";
 
 // packages/cli/dist/attach-commands.js
@@ -90,7 +92,7 @@ async function promoteChangeInput(root, change, file) {
   } catch {
     throw new AttachError("not-found", `inputs/${name} isn't attached to ${c.id}: atticus change attach ${c.id} adds it.`);
   }
-  const { addToInbox } = await import("./chunk-W3BQAZ3Q.js");
+  const { addToInbox } = await import("./chunk-UWMJKX5U.js");
   const r = await addToInbox(root, [{ name, bytes }]);
   const added = r.added[0];
   if (!added)
@@ -107,11 +109,11 @@ function attachedLine(rel, a) {
 async function changeAttachCli(root, change, paths, o, io) {
   if (change && o.prototype) {
     if (paths.length) {
-      const { PROTOTYPE_CLI_WORDS } = await import("./chunk-Q4D5X7QB.js");
+      const { PROTOTYPE_CLI_WORDS } = await import("./chunk-7ASNL4Q4.js");
       io.err(PROTOTYPE_CLI_WORDS.usage(change, o.prototype));
       return 2;
     }
-    const { attachPrototype } = await import("./chunk-Q4D5X7QB.js");
+    const { attachPrototype } = await import("./chunk-7ASNL4Q4.js");
     return attachPrototype(root, change, o.prototype, { by: o.by, ...o.json ? { json: true } : {}, ...o.now ? { now: o.now } : {} }, io);
   }
   if (change && o.like) {
@@ -119,7 +121,7 @@ async function changeAttachCli(root, change, paths, o, io) {
       io.err("--like names an archived change, attached on its own: atticus change attach add-refund-window --like raise-transfer-limit");
       return 2;
     }
-    const { attachPastChange, findPastChange } = await import("./chunk-HVUPKCGJ.js");
+    const { attachPastChange, findPastChange } = await import("./chunk-W7VWI2YH.js");
     const folder = await findPastChange(root, o.like);
     if (!folder) {
       io.err(`There is no archived change ${o.like}: atticus change similar "<what it is about>" lists them.`);

package/dist/chunk-LFGTYX5U.js

@@ -0,0 +1,379 @@
+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 {
+  HttpError,
+  badRequest,
+  conflict,
+  notFound
+} from "./chunk-C3RY6KU6.js";
+import {
+  appendLines,
+  safeMessage
+} from "./chunk-S7FCV7S5.js";
+import {
+  estateJoinOnFile,
+  stampOf
+} from "./chunk-T6DQR5TV.js";
+import {
+  intakeContext
+} from "./chunk-SFUP7TTO.js";
+import {
+  estateFacts,
+  estateRepos,
+  outsideProfileSystems
+} from "./chunk-J2JAKCIW.js";
+import {
+  readVendorSpec
+} from "./chunk-QKUJMING.js";
+import {
+  FactCorrection,
+  QuestionError,
+  TARGETS_STEP_ID,
+  answerQuestion,
+  api_exports,
+  correctionLine,
+  factsDirOf,
+  factsRelOf,
+  inputsDirOf,
+  isAdopted,
+  linkCandidates,
+  listQuestions,
+  loadOrgPack,
+  orgPackDirOf,
+  parseCorrections,
+  questionsRelOf
+} from "./chunk-Q2TECDIT.js";
+import {
+  withSharedFileLock,
+  writeFileAtomic
+} from "./chunk-TUULXQRW.js";
+
+// packages/cli/dist/ui-api-links.js
+import { mkdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+var REPO = /^[A-Za-z0-9._-]{1,200}$/;
+var SPECS = /* @__PURE__ */ new Set(["openapi", "swagger"]);
+var quiet = { out: () => void 0, err: () => void 0 };
+var JOINABLE_CALL = /* @__PURE__ */ new Set(["rest", "soap", "grpc", "graphql"]);
+function settingsOf(facts) {
+  const out = {};
+  for (const f of facts)
+    if (f.kind === "config" && f.value && !(f.key in out))
+      out[f.key] = f.value;
+  return out;
+}
+async function boxApis(root, op, estate, to) {
+  if (to.repo) {
+    const known = estateRepos(op).find((r) => r.id === to.repo);
+    if (!known)
+      throw notFound(`No repo of the manifest is ${to.repo}.`);
+    const facts = estate.repos.find((r) => r.repo === to.repo)?.facts ?? [];
+    const gateway = /gateway|proxy|apigee/i.test(known.type ?? "");
+    const forwardsOf = (entry) => {
+      const f = facts.find((x) => x.kind === "call" && x.from === entry && JOINABLE_CALL.has(x.callType));
+      return f?.kind === "call" ? f.path : void 0;
+    };
+    const apis2 = facts.flatMap((f) => {
+      if (f.kind !== "entry" || !f.path)
+        return [];
+      const forwards = gateway ? forwardsOf(f.id) : void 0;
+      return [
+        {
+          id: f.id,
+          kind: gateway ? "route" : "entry",
+          ...f.method ? { method: f.method.toUpperCase() } : {},
+          path: f.path,
+          at: `${f.cite.file}:${f.cite.line}`,
+          ...forwards ? { forwards } : {}
+        }
+      ];
+    });
+    return {
+      name: to.repo,
+      apis: apis2,
+      ...apis2.length ? {} : {
+        noApis: estate.unverified?.includes(to.repo) ? { why: "unverified", command: `atticus verify ${to.repo}` } : { why: "not-read", command: `atticus map --all --repos ${to.repo}` }
+      }
+    };
+  }
+  const system = outsideProfileSystems(op).find((s) => s.id === to.system);
+  if (!system)
+    throw notFound(`No outside system of the profile is ${to.system}.`);
+  const { inputs } = await intakeContext(root, quiet);
+  const doc = inputs.documents.find((d) => d.id && !d.supersededBy && SPECS.has(d.classification) && d.systems[0] === system.id);
+  const spec = doc ? readVendorSpec(doc.path, await readFile(join(inputsDirOf(root), ...doc.path.split("/").slice(1)), "utf8"), system.id) : void 0;
+  const apis = (spec?.operations ?? []).map((o) => ({
+    id: o.id,
+    kind: "operation",
+    method: o.method.toUpperCase(),
+    path: o.fullPath ?? o.path,
+    ...o.cite ? { at: o.cite } : {},
+    ...o.operationId ? { words: o.operationId } : {}
+  }));
+  return {
+    name: system.name || system.id,
+    apis,
+    ...apis.length ? {} : {
+      noApis: {
+        why: "no-spec",
+        command: `atticus intake add <${system.id}'s OpenAPI file>`
+      }
+    }
+  };
+}
+async function context(root, from, to) {
+  if (!REPO.test(from))
+    throw badRequest(`${JSON.stringify(from)} isn't a repo name.`);
+  if (to.repo && to.repo === from)
+    throw badRequest("Pick another box: a box can't call itself here.");
+  const op = await loadOrgPack(orgPackDirOf(root));
+  if (!estateRepos(op).some((r) => r.id === from))
+    throw notFound(`No repo of the manifest is ${from}.`);
+  const stamp = await stampOf(root);
+  const estate = await estateFacts(root, op, "");
+  const join0 = await estateJoinOnFile(root, op, estate, stamp);
+  const facts = estate.repos.find((r) => r.repo === from)?.facts ?? [];
+  const b = await boxApis(root, op, estate, to);
+  return { op, estate, join: join0, facts, b, pairs: estate.pairs[from] ?? {} };
+}
+async function openRuleQuestion(root, from) {
+  const qs = (await listQuestions(root, { step: TARGETS_STEP_ID }).catch(() => ({ questions: [] }))).questions;
+  return qs.find((q) => q.repo === from && q.state === "open");
+}
+function boxesOf(query) {
+  const from = query.get("from") ?? "";
+  const to = query.get("system") ? { system: query.get("system") } : { repo: query.get("to") ?? "" };
+  if (!from || !to.repo && !to.system)
+    throw badRequest("Say both boxes: from=<repo> and to=<repo> (or system=<id>).");
+  return { from, to };
+}
+async function candidatesOf(root, from, to) {
+  const c = await context(root, from, to);
+  const cands = linkCandidates({
+    from,
+    facts: c.facts,
+    join: c.join,
+    apis: c.b.apis,
+    pairs: c.pairs,
+    to,
+    settings: settingsOf(c.facts)
+  });
+  const q = await openRuleQuestion(root, from);
+  const loose = cands.calls.filter((x) => x.status !== "paired").length;
+  const view = {
+    from,
+    to,
+    toName: c.b.name,
+    calls: cands.calls,
+    apis: cands.apis,
+    ...c.facts.some((f) => f.kind === "call") ? {} : c.estate.unverified.includes(from) ? { noCalls: { why: "unverified", command: `atticus verify ${from}` } } : { noCalls: { command: `atticus map --all --gaps --repos ${from}` } },
+    ...c.b.noApis ? { noApis: c.b.noApis } : {},
+    ...q && loose ? { rule: { question: q.id, calls: loose } } : {}
+  };
+  return { view, facts: c.facts };
+}
+function uiLinkRoutes(r, ctx, deps = {}) {
+  const now = deps.now ?? (() => /* @__PURE__ */ new Date());
+  return r.add("GET", "/api/links/candidates", async ({ query }) => {
+    const { from, to } = boxesOf(query);
+    return { status: 200, body: (await candidatesOf(ctx.root, from, to)).view };
+  }).add("POST", "/api/links/connect", async ({ body }) => {
+    const b = api_exports.ConnectLinksRequest.safeParse(body ?? {});
+    if (!b.success)
+      throw badRequest("Say from, to and the pairs: { from, to: { repo }, pairs: [{ call, api }] }.", {
+        errors: b.error.issues.map((i) => ({ path: i.path.join("."), message: i.message }))
+      });
+    const { from, to, pairs, rule, preview } = b.data;
+    if (!pairs.length && !rule)
+      throw badRequest("Pick at least one pair, or the rule for all.");
+    const c = await context(ctx.root, from, to);
+    const calls = new Map(c.facts.filter((f) => f.kind === "call").map((f) => [f.id, f]));
+    const apis = new Map(c.b.apis.map((a) => [a.id, a]));
+    const at = now().toISOString();
+    const corrections = [];
+    for (const p of pairs) {
+      const f = calls.get(p.call);
+      if (!f)
+        throw c.estate.unverified.includes(from) ? conflict(`${from}'s facts aren't all verified yet: atticus verify ${from} first.`) : notFound(`${from} has no call ${p.call} on record.`);
+      const api = apis.get(p.api);
+      if (!api)
+        throw notFound(`${c.b.name} has no API ${p.api} on record.`);
+      corrections.push(FactCorrection.parse({
+        schemaVersion: 1,
+        fact: f.id,
+        target: { kind: "call", file: f.cite.file, line: f.cite.line, value: f.cite.value },
+        action: "link",
+        link: {
+          ...to.repo ? { repo: to.repo } : { system: to.system },
+          ...api.kind !== "operation" ? { entry: api.id } : {},
+          ...api.method ? { method: api.method } : {},
+          path: api.path
+        },
+        by: ctx.user,
+        at
+      }));
+    }
+    let ruleOut;
+    const q = rule ? await openRuleQuestion(ctx.root, from) : void 0;
+    if (rule && !q)
+      throw conflict(`${from} has no open target question to answer for all its calls: pair them one by one.`);
+    const target = to.repo ?? to.system;
+    if (q)
+      ruleOut = { question: q.id, match: "/**", target };
+    const rel = `${factsRelOf(ctx.root)}/${from}.corrections.jsonl`;
+    const lines = corrections.map(correctionLine);
+    const verify = `atticus verify ${from} --write`;
+    const commit = `git add ${rel}${q ? ` ${questionsRelOf(ctx.root)}/` : ""}
+git commit -m "${safeMessage(`${from}: calls paired with ${target} on the canvas`)}"`;
+    let answer;
+    if (q) {
+      const { targetAnswerOf } = await import("./chunk-KFAVQZSX.js");
+      const t = await targetAnswerOf(ctx.root, q, target);
+      if ("problem" in t)
+        throw new HttpError(422, "Atticus can't do that yet", t.problem);
+      answer = t;
+    }
+    if (preview) {
+      const { verifyWritePreview } = await import("./chunk-XERYFDB5.js");
+      const v = await verifyWritePreview(ctx.root, from, { extra: corrections });
+      return {
+        status: 200,
+        body: {
+          written: false,
+          file: rel,
+          lines,
+          ...ruleOut ? { rule: ruleOut } : {},
+          ...v ? { preview: v } : {},
+          verify,
+          commit
+        }
+      };
+    }
+    if (lines.length) {
+      await mkdir(factsDirOf(ctx.root), { recursive: true });
+      const file = join(factsDirOf(ctx.root), `${from}.corrections.jsonl`);
+      await appendLines(file, lines);
+      ctx.events.publish({ type: "file.changed", path: rel });
+    }
+    if (q && answer) {
+      try {
+        await answerQuestion(ctx.root, q.id, {
+          text: answer.text,
+          match: "/**",
+          by: ctx.user,
+          at
+        });
+        ctx.events.publish({ type: "file.changed", path: questionsRelOf(ctx.root) });
+      } catch (e) {
+        if (e instanceof QuestionError)
+          throw new HttpError(422, "Atticus can't do that yet", e.message);
+        throw e;
+      }
+    }
+    return {
+      status: 200,
+      body: {
+        written: true,
+        file: rel,
+        lines,
+        ...ruleOut ? { rule: ruleOut } : {},
+        verify,
+        commit
+      }
+    };
+  }).add("POST", "/api/reading-rules/from-pairing", async ({ body }) => {
+    const b = api_exports.RuleFromPairingRequest.safeParse(body ?? {});
+    if (!b.success)
+      throw badRequest("Say the repo and the pairing's line: { repo, line }.");
+    if (!REPO.test(b.data.repo))
+      throw badRequest(`${JSON.stringify(b.data.repo)} isn't a repo name.`);
+    const onFile = await readFile(join(factsDirOf(ctx.root), `${b.data.repo}.corrections.jsonl`), "utf8").catch(() => "");
+    if (!onFile.split(/\r?\n/).some((l) => l.trim() === b.data.line.trim()))
+      throw notFound(`${b.data.repo}'s corrections have no such pairing.`);
+    const c = parseCorrections(b.data.line).corrections[0];
+    if (!c || c.action !== "link" || !c.link)
+      throw badRequest("That line isn't a pairing (a link correction).");
+    const op = await loadOrgPack(orgPackDirOf(ctx.root));
+    const type = estateRepos(op).find((x) => x.id === b.data.repo)?.type;
+    if (!type)
+      throw notFound(`No repo of the manifest is ${b.data.repo}.`);
+    const { ruleFromPairing } = await import("./chunk-UNAGJYET.js");
+    const { rulesAddCommand } = await import("./chunk-66PPNOON.js");
+    const rule = ruleFromPairing({
+      type,
+      to: c.link.repo ?? c.link.system ?? "it",
+      file: c.target.file,
+      line: c.target.line,
+      value: c.target.value,
+      ...c.link.method ? { method: c.link.method } : {},
+      path: c.link.path,
+      by: c.by,
+      drafter: ctx.user
+    });
+    const said = [];
+    const code = await rulesAddCommand(ctx.root, { type }, {
+      key: rule.key,
+      rule: rule.rule,
+      files: (rule.files ?? []).join(","),
+      ...rule.example ? { example: rule.example } : {},
+      draft: true,
+      ...rule.by ? { by: rule.by } : {}
+    }, { out: (l) => said.push(l), err: (l) => said.push(l) });
+    if (code !== 0)
+      throw conflict(said.join(" "));
+    const rel = `${isAdopted(ctx.root) ? ".atticus/org-pack" : "org-pack"}/reading-rules/types/${type}.yaml`;
+    ctx.events.publish({ type: "file.changed", path: rel });
+    return {
+      status: 200,
+      body: {
+        file: rel,
+        key: rule.key,
+        rule: rule.rule,
+        activate: `atticus rules activate ${rule.key} --type ${type}`
+      }
+    };
+  }).add("POST", "/api/facts/{repo}/corrections/undo", async ({ params, body }) => {
+    const repo = params.repo;
+    if (!REPO.test(repo))
+      throw badRequest(`${JSON.stringify(repo)} isn't a repo name.`);
+    const b = api_exports.UndoCorrectionRequest.safeParse(body ?? {});
+    if (!b.success)
+      throw badRequest("Say which line to remove: { line }.");
+    const file = join(factsDirOf(ctx.root), `${repo}.corrections.jsonl`);
+    const rel = `${factsRelOf(ctx.root)}/${repo}.corrections.jsonl`;
+    await withSharedFileLock(file, async () => {
+      const text = await readFile(file, "utf8").catch(() => void 0);
+      if (text === void 0)
+        throw notFound(`There is no ${rel}.`);
+      const lines = text.split(/\r?\n/);
+      if (!b.data.line.trim())
+        throw badRequest("Say which correction line to remove.");
+      const i = lines.findIndex((l) => l.trim() === b.data.line.trim());
+      if (i < 0)
+        throw notFound(`${rel} has no such line (it may be removed already).`);
+      lines.splice(i, 1);
+      await writeFileAtomic(file, lines.join(/\r\n/.test(text) ? "\r\n" : "\n"));
+    });
+    ctx.events.publish({ type: "file.changed", path: rel });
+    return {
+      status: 200,
+      body: {
+        removed: b.data.line,
+        file: rel,
+        verify: `atticus verify ${repo} --write`,
+        commit: `git add ${rel}
+git commit -m "${safeMessage(`${repo}: a correction undone`)}"`
+      }
+    };
+  });
+}
+
+export {
+  settingsOf,
+  boxesOf,
+  candidatesOf,
+  uiLinkRoutes
+};