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

package/dist/{chunk-745DAZ4L.js → chunk-CZ75S2EZ.js}

@@ -6,11 +6,11 @@ var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
 import {
   boundedId,
   opt
-} from "./chunk-QKUJMING.js";
+} from "./chunk-GFYVVTKH.js";
 import {
   curatedAliases,
   resolveNames
-} from "./chunk-6ZGLAACW.js";
+} from "./chunk-DIYNRYXW.js";
 import {
   DATA_RULE,
   INSTRUCTION_RULES,
@@ -27,51 +27,55 @@ import {
   toRunSummary,
   verdictOf,
   wrapData
-} from "./chunk-P32RUW3B.js";
+} from "./chunk-MOWUP33K.js";
 import {
-  AgentDefinition,
-  ChecklistPack,
-  ChecklistRule,
-  IsoDateTime,
   JOINED_BY_PERSON,
-  KNOWLEDGE_KINDS,
-  KNOWLEDGE_RECORD_KIND,
-  PatternCode,
-  Profile,
-  RecordId,
-  SOURCE_KIND_SUGGESTIONS,
-  Sources,
-  authorityRank,
   deserializeRecord,
   estimateTokens,
-  external_exports,
-  gitRefProblem,
   isAdopted,
-  isAiBy,
   judgmentKey,
   knowledgeDirOf,
-  knowledgeKindOf,
   knowledgeRelOf,
   listQuestions,
-  loadOrgPack,
   makeJudgment,
   memoryJudgments,
   orgPackDirOf,
-  pageStanding,
   parseRecord,
-  platformsMatch,
   proposalsDirOf,
   proposalsRelOf,
   readParsedFiles,
   recordPath,
   serializeRecord,
-  sourceReadsPage,
   toCanonicalYaml
-} from "./chunk-Q2TECDIT.js";
+} from "./chunk-GJVCBTSO.js";
 import {
-  SCHEMA_VERSION,
   writeFileAtomic
-} from "./chunk-TUULXQRW.js";
+} from "./chunk-G3ZFEHCX.js";
+import {
+  AgentDefinition,
+  ChecklistPack,
+  ChecklistRule,
+  IsoDateTime,
+  KNOWLEDGE_KINDS,
+  KNOWLEDGE_RECORD_KIND,
+  PatternCode,
+  Profile,
+  RecordId,
+  SOURCE_KIND_SUGGESTIONS,
+  Sources,
+  authorityRank,
+  external_exports,
+  gitRefProblem,
+  isAiBy,
+  knowledgeKindOf,
+  loadOrgPack,
+  pageStanding,
+  platformsMatch,
+  sourceReadsPage
+} from "./chunk-QFDPX6C4.js";
+import {
+  SCHEMA_VERSION
+} from "./chunk-CTJHEG6A.js";
 import {
   require_dist
 } from "./chunk-BQGDB6ZL.js";
@@ -79,11 +83,6 @@ import {
   __toESM
 } from "./chunk-TV45EUGM.js";
 
-// packages/knowledge/dist/sources.js
-import { createHash as createHash2 } from "node:crypto";
-import { readdir as readdir2, readFile as readFile2 } from "node:fs/promises";
-import { isAbsolute as isAbsolute2, join as join3, relative as relative2, resolve as resolve2, sep as sep2 } from "node:path";
-
 // packages/knowledge/dist/markdown.js
 var import_yaml = __toESM(require_dist(), 1);
 var HEADING = /^ {0,3}(#{1,6})\s+(.*?)\s*#*\s*$/;
@@ -314,6 +313,11 @@ function mentionIndex(records, systems) {
   };
 }
 
+// packages/knowledge/dist/sources.js
+import { createHash as createHash2 } from "node:crypto";
+import { readdir as readdir2, readFile as readFile2 } from "node:fs/promises";
+import { isAbsolute as isAbsolute2, join as join3, relative as relative2, resolve as resolve2, sep as sep2 } from "node:path";
+
 // packages/knowledge/dist/exports.js
 var import_yaml2 = __toESM(require_dist(), 1);
 import { readdir, readFile } from "node:fs/promises";
@@ -528,6 +532,25 @@ ${(0, import_yaml2.stringify)(fm, { lineWidth: 0 })}---
 ${body}`;
 }
 var titleSegment = (t) => t.normalize("NFKD").replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "") || "page";
+function uniquePagePaths(pages, alt, keeps = () => false) {
+  const count = /* @__PURE__ */ new Map();
+  for (const p of pages)
+    count.set(p.pagePath, (count.get(p.pagePath) ?? 0) + 1);
+  const taken = new Set(pages.filter((p) => count.get(p.pagePath) === 1).map((p) => p.pagePath));
+  const out = [];
+  for (const p of pages) {
+    if (count.get(p.pagePath) === 1) {
+      out.push(p);
+      continue;
+    }
+    let path = keeps(p) && !taken.has(p.pagePath) ? p.pagePath : alt(p);
+    for (let n = 2; taken.has(path); n++)
+      path = alt(p).replace(/\.md$/, `-${n}.md`);
+    taken.add(path);
+    out.push({ ...p, pagePath: path });
+  }
+  return out;
+}
 function readCsv(text2) {
   const rows = [];
   let row = [];
@@ -686,7 +709,11 @@ var confluenceExportAdapter = {
         ...m.updated ? { updatedAt: m.updated } : {}
       });
     }
-    return out;
+    return uniquePagePaths(out, (p) => {
+      const file = p.path.split("/").pop().replace(/\.html?$/i, "");
+      const id = /(?:^|_)(\d+)$/.exec(file)?.[1] ?? titleSegment(file);
+      return p.pagePath.replace(/\.md$/, `-${id}.md`);
+    });
   }
 };
 var sharepointExportAdapter = {
@@ -726,7 +753,8 @@ var sharepointExportAdapter = {
         ...m.updated ? { updatedAt: m.updated } : {}
       });
     }
-    return out;
+    const ext = (p) => /\.([^./]+)$/.exec(p.path)?.[1]?.toLowerCase() ?? "";
+    return uniquePagePaths(out, (p) => p.pagePath.replace(/\.md$/, `.${ext(p)}.md`), (p) => ext(p) === "md");
   }
 };
 
@@ -899,6 +927,53 @@ var markdownFolderAdapter = {
     return out;
   }
 };
+function withApiMeta(body, labels, restricted) {
+  if (!labels?.length && !restricted)
+    return body;
+  const lines = body.replace(/\r\n?/g, "\n").split("\n");
+  const end = frontMatterEnd(lines);
+  let own = {};
+  let rest = body;
+  if (end > 0) {
+    const doc = readMarkdown(lines.slice(0, end + 1).join("\n"));
+    if (doc.frontMatterProblem)
+      return body;
+    own = doc.frontMatter;
+    rest = lines.slice(end + 1).join("\n");
+  }
+  const ownLabels = end > 0 && own.labels !== void 0 && own.labels !== null ? Array.isArray(own.labels) ? own.labels.map(String) : String(own.labels).split(/[;,]/).map((x) => x.trim()).filter(Boolean) : [];
+  const all = [...ownLabels, ...(labels ?? []).filter((l) => !ownLabels.includes(l))];
+  const fm = [
+    ...all.length ? [`labels: [${all.map((l) => JSON.stringify(l)).join(", ")}]`] : [],
+    ...restricted ? ["restricted: true"] : [],
+    ...Object.entries(own).filter(([k]) => k !== "labels" && !(restricted && k === "restricted")).map(([k, v]) => `${JSON.stringify(k)}: ${JSON.stringify(v ?? null)}`)
+  ];
+  return `---
+${fm.join("\n")}
+---
+${rest}`;
+}
+function wikiApiAdapter(api) {
+  return {
+    async pages(source) {
+      const out = [];
+      for (const space of source.spaces) {
+        const heads = await api.listPages(space);
+        for (const h of [...heads].sort((a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0)) {
+          const p = await api.getPage(h.id);
+          out.push({
+            pagePath: `${space}/${p.id}`,
+            path: `${source.id}:${space}/${p.id}`,
+            content: withApiMeta(p.body, p.labels, p.restricted),
+            updatedAt: p.updatedAt,
+            version: String(p.version)
+          });
+        }
+      }
+      return out;
+    }
+  };
+}
 var DEFAULT_LEVELS = ["public", "internal", "confidential", "restricted"];
 var DAY = 864e5;
 var daysBetween = (from, to) => Math.floor((Date.parse(to) - Date.parse(from)) / DAY);
@@ -1049,11 +1124,36 @@ async function syncSources(o) {
     read.push({ source, raw: reads.filter((r) => !r.skipReason) });
   }
   const owners = pageOwners(read.filter((x) => !o.adaptersById?.[x.source.id]));
+  const checked = /* @__PURE__ */ new Map();
+  const checkedPage = (source, r) => {
+    const key = `${source.id}\0${r.path}\0${r.pagePath}`;
+    const known = checked.get(key);
+    if (known)
+      return known;
+    const page = readPage({
+      source: source.id,
+      sourceType: source.type,
+      path: r.path,
+      pagePath: r.pagePath,
+      content: r.content,
+      ...r.updatedAt ? { updatedAt: r.updatedAt } : {},
+      ...r.version ? { version: r.version } : {},
+      records,
+      systems,
+      defaultClassification,
+      mentions: index
+    });
+    const level = levels.indexOf(page.classification);
+    const skip = page.doc.frontMatterProblem ? page.doc.frontMatterProblem : !source.readRestricted && pageRestricted(page.frontMatter) ? "under view restrictions, so above the limit for the metarepo's audience (readRestricted on the source says everyone who reads the metarepo may read it)" : level === -1 ? `unknown classification ${page.classification}` : level > limitLevel ? `${page.classification} is above the limit (${limit})` : void 0;
+    const out = { page, ...skip !== void 0 ? { skip } : {} };
+    checked.set(key, out);
+    return out;
+  };
   const mirrors = mirrorReaders(read.filter((x) => !o.adaptersById?.[x.source.id]).map((x) => ({
     source: x.source,
     raw: x.raw.filter((r) => {
       const owner = owners.get(r.path);
-      return !owner || owner.source === x.source.id;
+      return (!owner || owner.source === x.source.id) && !checkedPage(x.source, r).skip;
     })
   })), o.orgPack);
   for (const { source, raw: all } of read) {
@@ -1078,38 +1178,9 @@ async function syncSources(o) {
     }
     const flagged = new Map(screenDocuments(raw.map((r) => ({ path: r.path, text: r.content, format: "markdown" }))).map((f) => [f.path, f]));
     for (const r of raw) {
-      const page = readPage({
-        source: source.id,
-        sourceType: source.type,
-        path: r.path,
-        pagePath: r.pagePath,
-        content: r.content,
-        ...r.updatedAt ? { updatedAt: r.updatedAt } : {},
-        ...r.version ? { version: r.version } : {},
-        records,
-        systems,
-        defaultClassification,
-        mentions: index
-      });
-      if (page.doc.frontMatterProblem) {
-        res.skipped.push({ source: source.id, path: r.path, reason: page.doc.frontMatterProblem });
-        continue;
-      }
-      if (!source.readRestricted && pageRestricted(page.frontMatter)) {
-        res.skipped.push({
-          source: source.id,
-          path: r.path,
-          reason: "under view restrictions, so above the limit for the metarepo's audience (readRestricted on the source says everyone who reads the metarepo may read it)"
-        });
-        continue;
-      }
-      const level = levels.indexOf(page.classification);
-      if (level === -1 || level > limitLevel) {
-        res.skipped.push({
-          source: source.id,
-          path: r.path,
-          reason: level === -1 ? `unknown classification ${page.classification}` : `${page.classification} is above the limit (${limit})`
-        });
+      const { page, skip } = checkedPage(source, r);
+      if (skip !== void 0) {
+        res.skipped.push({ source: source.id, path: r.path, reason: skip });
         continue;
       }
       if (page.date) {
@@ -1138,8 +1209,41 @@ async function syncSources(o) {
       res.documents.push(sourceDocument(page));
     }
   }
+  res.documents = uniqueDocumentIds(res.pages, res.documents);
   return res;
 }
+function uniqueDocumentIds(pages, docs) {
+  const by = /* @__PURE__ */ new Map();
+  docs.forEach((d, k) => by.set(d.id, [...by.get(d.id) ?? [], k]));
+  const out = [...docs];
+  const taken = new Set(docs.map((d) => d.id));
+  const plain = (k) => {
+    const base = pages[k].pagePath.replace(/\.(md|markdown)$/i, "");
+    return slug(base) === base;
+  };
+  const byPath = (a, b) => {
+    const x = pages[a].pagePath;
+    const y = pages[b].pagePath;
+    return x < y ? -1 : x > y ? 1 : 0;
+  };
+  for (const [id, ks] of by) {
+    if (ks.length < 2)
+      continue;
+    const order = [...ks].sort((a, b) => Number(plain(b)) - Number(plain(a)) || byPath(a, b));
+    for (const k of order.slice(1)) {
+      const p = pages[k];
+      const h = createHash2("sha256").update(`${p.source}\0${p.pagePath}`).digest("hex");
+      const withHash = (n2) => `${id.slice(0, 119 - n2).replace(/[-.]+$/, "")}-${h.slice(0, n2)}`;
+      let n = 8;
+      while (taken.has(withHash(n)) && n < 32)
+        n += 4;
+      const next = withHash(n);
+      taken.add(next);
+      out[k] = { ...docs[k], id: next };
+    }
+  }
+  return out;
+}
 function pageOwners(read) {
   const by = /* @__PURE__ */ new Map();
   for (const { source, raw } of read)
@@ -1955,11 +2059,6 @@ var FlowGraph = class {
   }
 };
 
-// packages/features/dist/proposals.js
-var import_yaml4 = __toESM(require_dist(), 1);
-import { mkdir, readdir as readdir3, readFile as readFile3, writeFile } from "node:fs/promises";
-import { join as join4 } from "node:path";
-
 // packages/features/dist/detect.js
 var ENTRY_TYPES = /* @__PURE__ */ new Set(["rest", "grpc", "soap", "graphql", "webhook", "websocket", "sse"]);
 var DEFAULT_DEPTH = 8;
@@ -2402,6 +2501,9 @@ function detectFeatures(records, o = {}) {
 }
 
 // packages/features/dist/proposals.js
+var import_yaml4 = __toESM(require_dist(), 1);
+import { mkdir, readdir as readdir3, readFile as readFile3, writeFile } from "node:fs/promises";
+import { join as join4 } from "node:path";
 var NameProposalFile = external_exports.strictObject({
   schemaVersion: external_exports.literal(1),
   feature: RecordId,
@@ -3491,6 +3593,48 @@ function newestEvidence(r, commitDates = {}) {
   }
   return best;
 }
+function freshness(input) {
+  const windows = input.orgPack?.pack?.freshness ?? {};
+  const fallback = input.defaultDays ?? 365;
+  const res = { stale: [], undated: [], documents: [] };
+  const sorted2 = [...input.records].sort((a, b) => a.id < b.id ? -1 : a.id > b.id ? 1 : 0);
+  for (const r of sorted2) {
+    const maxDays = windows[r.kind] ?? fallback;
+    if (r.kind === "SourceDocument") {
+      if (r.supersededBy)
+        res.documents.push({
+          id: r.id,
+          path: r.path,
+          reason: "superseded",
+          supersededBy: r.supersededBy
+        });
+      else if (r.date) {
+        const ageDays2 = daysBetween(r.date, input.now);
+        if (ageDays2 > maxDays)
+          res.documents.push({
+            id: r.id,
+            path: r.path,
+            reason: "stale",
+            date: r.date,
+            ageDays: ageDays2,
+            maxDays
+          });
+      }
+      continue;
+    }
+    if (r.kind === "CuratedDecision")
+      continue;
+    const newest = newestEvidence(r, input.commitDates);
+    if (!newest) {
+      res.undated.push(r.id);
+      continue;
+    }
+    const ageDays = daysBetween(newest, input.now);
+    if (ageDays > maxDays)
+      res.stale.push({ id: r.id, kind: r.kind, newest, ageDays, maxDays });
+  }
+  return res;
+}
 
 // packages/knowledge/dist/gaps.js
 function governingPatterns(i, ctx) {
@@ -4160,6 +4304,150 @@ function domainProfile(records, system, o) {
   return (o.template ?? DEFAULT_DOMAIN_PROFILE).replace(/\{\{\s*([a-z]+)\s*\}\}/g, (whole, k) => values[k] ?? whole);
 }
 
+// packages/knowledge/dist/quotes.js
+var HEADING2 = /^ {0,3}(#{1,6})\s+(.*?)\s*#*\s*$/;
+var FENCE2 = /^ {0,3}(```+|~~~+)/;
+var SETEXT = /^ {0,3}(?:=+|-+)\s*$/;
+function visibleText(text2) {
+  const spans = hiddenSpans(text2);
+  if (!spans.length)
+    return text2;
+  let out = "";
+  let at = 0;
+  for (const s2 of spans) {
+    if (s2.start < at)
+      continue;
+    out += text2.slice(at, s2.start) + text2.slice(s2.start, s2.end).replace(/[^\n]/g, " ");
+    at = s2.end;
+  }
+  return out + text2.slice(at);
+}
+function pageLines(text2) {
+  const lines = visibleText(text2.replace(/\r\n?/g, "\n")).split("\n");
+  let i = 0;
+  if (lines[0]?.trim() === "---") {
+    const end = lines.findIndex((l, k) => k > 0 && (l.trim() === "---" || l.trim() === "..."));
+    if (end > 0)
+      i = end + 1;
+  }
+  const out = [];
+  let section = "";
+  let fence;
+  for (; i < lines.length; i++) {
+    const l = lines[i];
+    const f = FENCE2.exec(l);
+    if (f)
+      fence = fence ? l.trim().startsWith(fence) ? void 0 : fence : f[1];
+    const h = fence ? void 0 : HEADING2.exec(l);
+    if (h) {
+      section = h[2];
+      continue;
+    }
+    const next = lines[i + 1];
+    if (!fence && !f && l.trim() && next !== void 0 && SETEXT.test(next) && !SETEXT.test(l)) {
+      section = l.trim();
+      i++;
+      continue;
+    }
+    out.push({ line: i + 1, text: l, section });
+  }
+  return out;
+}
+var foldQuote = (s2) => s2.replace(/[‘’‛′]/g, "'").replace(/[“”‟″]/g, '"').replace(/\s+/g, " ").trim();
+var ENTITIES2 = {
+  amp: "&",
+  lt: "<",
+  gt: ">",
+  quot: '"',
+  apos: "'",
+  nbsp: " ",
+  ndash: "\u2013",
+  mdash: "\u2014",
+  hellip: "\u2026",
+  lsquo: "\u2018",
+  rsquo: "\u2019",
+  ldquo: "\u201C",
+  rdquo: "\u201D",
+  zwsp: "",
+  shy: ""
+};
+var INLINE_TAG = /<\/?(?:a|abbr|b|bdi|big|cite|code|del|dfn|em|font|i|ins|kbd|mark|q|s|samp|small|span|strike|strong|sub|sup|time|tt|u|var)(?:\s[^<>]*)?\/?>/gi;
+var ALNUM = /[\p{L}\p{N}]/u;
+function readerText(s2) {
+  return s2.replace(/&(#x[0-9a-f]{1,6}|#[0-9]{1,7}|[a-z]{2,8});/gi, (m, e) => {
+    if (e[0] !== "#")
+      return ENTITIES2[e.toLowerCase()] ?? m;
+    const n = e[1] === "x" || e[1] === "X" ? parseInt(e.slice(2), 16) : Number(e.slice(1));
+    return n > 0 && n <= 1114111 ? String.fromCodePoint(n) : m;
+  }).replace(/[\u200b-\u200d\u2060\ufeff\u00ad]/g, "").replace(/<br\s*\/?>/gi, " ").replace(INLINE_TAG, "").replace(/!?\[([^\]]*)\]\([^)\s]*(?:\s+"[^"]*")?\)/g, "$1").replace(/!?\[([^\]]+)\]\[[^\]]*\]/g, "$1").replace(/<((?:https?|mailto):[^<>\s]+)>/g, "$1").replace(/\\([!-/:-@[-`{-~])/g, "$1").replace(/`+/g, "").replace(/(^|[^\p{L}\p{N}*_~])(?:\*{1,3}|_{1,3}|~~)(?=[^\s*_~])/gu, "$1").replace(/([^\s*_~])(?:\*{1,3}|_{1,3}|~~)(?=$|[^\p{L}\p{N}*_~])/gu, "$1").replace(/([\p{L}\p{N}])\*{1,3}(?=[\p{L}\p{N}])/gu, "$1").replace(/[\u2010-\u2015\u2212]/g, "-").replace(/\u2026/g, "...");
+}
+var sameHeading = (a, b) => foldQuote(readerText(a)).replace(/^#+\s*/, "").toLowerCase() === foldQuote(readerText(b)).replace(/^#+\s*/, "").toLowerCase();
+var matchFold = (s2) => foldQuote(readerText(s2)).replace(/"/g, "'");
+var MARKERS = /^\s*(?:>\s?)*\s*(?:(?:[-*+]|\d{1,9}[.)])\s+)?/;
+var unmark = (s2) => s2.replace(MARKERS, "");
+function findIn(lines, q) {
+  let text2 = "";
+  const lineAt = [];
+  for (const l of lines) {
+    const t = matchFold(unmark(l.text));
+    if (!t)
+      continue;
+    if (text2) {
+      text2 += " ";
+      lineAt.push(l.line);
+    }
+    for (let k = 0; k < t.length; k++)
+      lineAt.push(l.line);
+    text2 += t;
+  }
+  const wordStart = ALNUM.test(q[0] ?? "");
+  const wordEnd = ALNUM.test(q.at(-1) ?? "");
+  for (let at = text2.indexOf(q); at !== -1; at = text2.indexOf(q, at + 1)) {
+    if (wordStart && at > 0 && ALNUM.test(text2[at - 1]))
+      continue;
+    const end = at + q.length;
+    if (wordEnd && end < text2.length && ALNUM.test(text2[end]))
+      continue;
+    return lineAt[at];
+  }
+  return void 0;
+}
+function checkQuote(text2, quote2, section) {
+  const q = matchFold(unmark(quote2)).replace(/[\s.,;:!?]+$/, "");
+  if (q.length < 12)
+    return { ok: false, problem: "the quote is too short to check" };
+  const lines = pageLines(text2);
+  const sections = [...new Set(lines.map((l) => l.section))];
+  if (section !== void 0 && section.trim() !== "") {
+    const wanted = sections.filter((s2) => sameHeading(s2, section));
+    for (const s2 of wanted) {
+      const line = findIn(lines.filter((l) => l.section === s2), q);
+      if (line !== void 0)
+        return { ok: true, line, section: s2 };
+    }
+    for (const s2 of sections) {
+      const line = findIn(lines.filter((l) => l.section === s2), q);
+      if (line !== void 0)
+        return {
+          ok: false,
+          problem: wanted.length ? `the quote is on the page under "${s2 || "(no heading)"}", not under "${section}"` : `the page has no heading "${section}"; the quote is under "${s2 || "(no heading)"}"`,
+          foundUnder: s2,
+          line
+        };
+    }
+    return {
+      ok: false,
+      problem: wanted.length ? `the quote is not on the page, word for word` : `the page has no heading "${section}", and the quote is not on the page, word for word`
+    };
+  }
+  for (const s2 of sections) {
+    const line = findIn(lines.filter((l) => l.section === s2), q);
+    if (line !== void 0)
+      return { ok: true, line, section: s2 };
+  }
+  return { ok: false, problem: "the quote is not on the page, word for word" };
+}
+
 // packages/knowledge/dist/grounding.js
 var UNITS = {
   zero: 0,
@@ -4354,13 +4642,109 @@ function workingDays(d) {
   return Math.ceil(d.unit === "working-days" ? n : d.unit === "calendar-days" ? n * 5 / 7 : n / 8);
 }
 
-// packages/knowledge/dist/tags.js
-var import_yaml6 = __toESM(require_dist(), 1);
-var slug3 = (s2) => s2.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
-function tagList(values) {
-  return [
-    ...new Set(values.flatMap((v) => v.split(",")).map(slug3).filter(Boolean))
-  ];
+// packages/knowledge/dist/value-claims.js
+var LEAD_TIME = "lead-time";
+var leadTimeInputs = (item, leadTime) => ({
+  v: 1,
+  item,
+  leadTime: leadTime.trim()
+});
+async function leadTimeDaysOf(store, item, leadTime) {
+  if (!leadTime?.trim())
+    return void 0;
+  const j = await store.get(LEAD_TIME, judgmentKey(LEAD_TIME, leadTimeInputs(item, leadTime)));
+  const v = j?.value;
+  return v && typeof v.min === "number" && typeof v.max === "number" && v.unit ? { min: v.min, max: v.max, unit: v.unit } : void 0;
+}
+var VALUES = (field) => field === "lead_time" || field.startsWith("dates.");
+var inputsOf = (id, c) => ({
+  v: 1,
+  item: id,
+  field: c.field,
+  value: c.value,
+  span: c.span
+});
+async function settleClaims(items, o) {
+  const at = o.now.toISOString().replace(/\.\d{3}Z$/, "Z");
+  const judging = o.runtime.kind !== "hand-off" && o.runtime.kind !== "mock";
+  const out = /* @__PURE__ */ new Map();
+  const fail = (id, p) => out.set(id, [...out.get(id) ?? [], p]);
+  const verdicts = /* @__PURE__ */ new Map();
+  const ask = [];
+  for (const c of items)
+    for (const cl of c.claims) {
+      const inputs = inputsOf(c.item.id, cl);
+      const key = judgmentKey(STATES_VALUE_SPEC.kind, inputs);
+      const stored = await o.store.get(STATES_VALUE_SPEC.kind, key);
+      if (stored && typeof stored.verdict === "string") {
+        verdicts.set(key, { verdict: stored.verdict, by: stored.confirmedBy });
+        continue;
+      }
+      if (judging)
+        ask.push({
+          inputs,
+          texts: { span: cl.span },
+          facts: [`field: ${cl.field}`, `value: ${cl.value}`]
+        });
+      else if (!VALUES(cl.field)) {
+        const by = { by: "ai", run: o.run };
+        await o.store.put(makeJudgment({
+          kind: STATES_VALUE_SPEC.kind,
+          inputs,
+          verdict: "yes",
+          quotes: [{ of: "span", text: cl.span }],
+          why: "The reading the knowledge scan gave with the words it cited.",
+          confirmedBy: by,
+          at
+        }));
+        verdicts.set(key, { verdict: "yes", by });
+      }
+    }
+  if (ask.length) {
+    const r = await judge(STATES_VALUE_SPEC, ask, {
+      runtime: o.runtime,
+      store: o.store,
+      change: "knowledge-scan",
+      now: o.now
+    });
+    for (const [k, v] of r.results)
+      verdicts.set(k, {
+        verdict: v.verdict,
+        by: v.judgment?.confirmedBy ?? { by: "check", rule: "veto" }
+      });
+  }
+  for (const c of items) {
+    let daysBy;
+    for (const cl of c.claims) {
+      const v = verdicts.get(judgmentKey(STATES_VALUE_SPEC.kind, inputsOf(c.item.id, cl)));
+      if (v?.verdict === "yes") {
+        if (cl.field === "lead_time_days")
+          daysBy = v.by;
+        continue;
+      }
+      fail(c.item.id, v === void 0 ? `${cl.field} "${cl.value}" isn't word for word in "${cl.span}": write it as the page says it` : `${cl.field} "${cl.value}": the words "${cl.span}" don't state it (a judge read them${v.verdict === "unsure" ? " and couldn't tell" : ""}); quote the words that do`);
+    }
+    const days = c.item.lead_time_days;
+    if (days && daysBy && c.item.lead_time && !out.has(c.item.id))
+      await o.store.put(makeJudgment({
+        kind: LEAD_TIME,
+        inputs: leadTimeInputs(c.item.id, c.item.lead_time),
+        verdict: "normalised",
+        value: days,
+        confirmedBy: daysBy,
+        at
+      }));
+  }
+  return out;
+}
+
+// packages/knowledge/dist/tags.js
+var import_yaml6 = __toESM(require_dist(), 1);
+var slug3 = (s2) => s2.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+function tagList(values) {
+  return [
+    ...new Set(values.flatMap((v) => v.split(",")).map(slug3).filter(Boolean))
+  ];
 }
 function setSourceTags(text2, sourceId, change) {
   const doc = (0, import_yaml6.parseDocument)(text2);
@@ -4487,8 +4871,19 @@ async function writeSnapshots(o) {
       pages: [],
       skipped: o.sync.skipped.filter((s2) => s2.source === w.id).map((s2) => ({ page: s2.path, reason: s2.reason }))
     };
+    const listed = /* @__PURE__ */ new Map();
     for (const p of pages) {
       const file = safe(fileFor(p.pagePath));
+      const first = listed.get(p.pagePath) ?? listed.get(`\0${file}`);
+      if (first !== void 0) {
+        manifest.skipped.push({
+          page: p.path,
+          reason: `another page of the source has the path ${p.pagePath} (${first}), which is kept`
+        });
+        continue;
+      }
+      listed.set(p.pagePath, p.path);
+      listed.set(`\0${file}`, p.path);
       const was = before.get(p.pagePath);
       const keep = was && was.sha256 === p.hash && was.file === file ? was.in : void 0;
       if (!keep) {
@@ -4506,7 +4901,7 @@ async function writeSnapshots(o) {
       });
     }
     await writeFileAtomic(join5(dir, SNAPSHOT_FILE), (0, import_yaml7.stringify)(manifest));
-    out.push({ source: w.id, dir: rel, pages: pages.length, copied });
+    out.push({ source: w.id, dir: rel, pages: manifest.pages.length, copied });
   }
   return out;
 }
@@ -4657,203 +5052,6 @@ function sectionAt(text2, line) {
   return lines.slice(start, end).join("\n");
 }
 
-// packages/knowledge/dist/quotes.js
-var HEADING2 = /^ {0,3}(#{1,6})\s+(.*?)\s*#*\s*$/;
-var FENCE2 = /^ {0,3}(```+|~~~+)/;
-function visibleText(text2) {
-  const spans = hiddenSpans(text2);
-  if (!spans.length)
-    return text2;
-  let out = "";
-  let at = 0;
-  for (const s2 of spans) {
-    if (s2.start < at)
-      continue;
-    out += text2.slice(at, s2.start) + text2.slice(s2.start, s2.end).replace(/[^\n]/g, " ");
-    at = s2.end;
-  }
-  return out + text2.slice(at);
-}
-function pageLines(text2) {
-  const lines = visibleText(text2.replace(/\r\n?/g, "\n")).split("\n");
-  let i = 0;
-  if (lines[0]?.trim() === "---") {
-    const end = lines.findIndex((l, k) => k > 0 && (l.trim() === "---" || l.trim() === "..."));
-    if (end > 0)
-      i = end + 1;
-  }
-  const out = [];
-  let section = "";
-  let fence;
-  for (; i < lines.length; i++) {
-    const l = lines[i];
-    const f = FENCE2.exec(l);
-    if (f)
-      fence = fence ? l.trim().startsWith(fence) ? void 0 : fence : f[1];
-    const h = fence ? void 0 : HEADING2.exec(l);
-    if (h) {
-      section = h[2];
-      continue;
-    }
-    out.push({ line: i + 1, text: l, section });
-  }
-  return out;
-}
-var foldQuote = (s2) => s2.replace(/[‘’‛′]/g, "'").replace(/[“”‟″]/g, '"').replace(/\s+/g, " ").trim();
-var sameHeading = (a, b) => foldQuote(a).replace(/^#+\s*/, "").toLowerCase() === foldQuote(b).replace(/^#+\s*/, "").toLowerCase();
-var matchFold = (s2) => foldQuote(s2).replace(/"/g, "'");
-var MARKERS = /^\s*(?:>\s?)*\s*(?:(?:[-*+]|\d{1,9}[.)])\s+)?/;
-var unmark = (s2) => s2.replace(MARKERS, "");
-function findIn(lines, q) {
-  let text2 = "";
-  const lineAt = [];
-  for (const l of lines) {
-    const t = matchFold(unmark(l.text));
-    if (!t)
-      continue;
-    if (text2) {
-      text2 += " ";
-      lineAt.push(l.line);
-    }
-    for (let k = 0; k < t.length; k++)
-      lineAt.push(l.line);
-    text2 += t;
-  }
-  const at = text2.indexOf(q);
-  return at === -1 ? void 0 : lineAt[at];
-}
-function checkQuote(text2, quote2, section) {
-  const q = matchFold(unmark(quote2)).replace(/[\s.,;:!?]+$/, "");
-  if (q.length < 12)
-    return { ok: false, problem: "the quote is too short to check" };
-  const lines = pageLines(text2);
-  const sections = [...new Set(lines.map((l) => l.section))];
-  if (section !== void 0 && section.trim() !== "") {
-    const wanted = sections.filter((s2) => sameHeading(s2, section));
-    for (const s2 of wanted) {
-      const line = findIn(lines.filter((l) => l.section === s2), q);
-      if (line !== void 0)
-        return { ok: true, line, section: s2 };
-    }
-    for (const s2 of sections) {
-      const line = findIn(lines.filter((l) => l.section === s2), q);
-      if (line !== void 0)
-        return {
-          ok: false,
-          problem: wanted.length ? `the quote is on the page under "${s2 || "(no heading)"}", not under "${section}"` : `the page has no heading "${section}"; the quote is under "${s2 || "(no heading)"}"`,
-          foundUnder: s2,
-          line
-        };
-    }
-    return {
-      ok: false,
-      problem: wanted.length ? `the quote is not on the page, word for word` : `the page has no heading "${section}", and the quote is not on the page, word for word`
-    };
-  }
-  for (const s2 of sections) {
-    const line = findIn(lines.filter((l) => l.section === s2), q);
-    if (line !== void 0)
-      return { ok: true, line, section: s2 };
-  }
-  return { ok: false, problem: "the quote is not on the page, word for word" };
-}
-
-// packages/knowledge/dist/value-claims.js
-var LEAD_TIME = "lead-time";
-var leadTimeInputs = (item, leadTime) => ({
-  v: 1,
-  item,
-  leadTime: leadTime.trim()
-});
-async function leadTimeDaysOf(store, item, leadTime) {
-  if (!leadTime?.trim())
-    return void 0;
-  const j = await store.get(LEAD_TIME, judgmentKey(LEAD_TIME, leadTimeInputs(item, leadTime)));
-  const v = j?.value;
-  return v && typeof v.min === "number" && typeof v.max === "number" && v.unit ? { min: v.min, max: v.max, unit: v.unit } : void 0;
-}
-var VALUES = (field) => field === "lead_time" || field.startsWith("dates.");
-var inputsOf = (id, c) => ({
-  v: 1,
-  item: id,
-  field: c.field,
-  value: c.value,
-  span: c.span
-});
-async function settleClaims(items, o) {
-  const at = o.now.toISOString().replace(/\.\d{3}Z$/, "Z");
-  const judging = o.runtime.kind !== "hand-off" && o.runtime.kind !== "mock";
-  const out = /* @__PURE__ */ new Map();
-  const fail = (id, p) => out.set(id, [...out.get(id) ?? [], p]);
-  const verdicts = /* @__PURE__ */ new Map();
-  const ask = [];
-  for (const c of items)
-    for (const cl of c.claims) {
-      const inputs = inputsOf(c.item.id, cl);
-      const key = judgmentKey(STATES_VALUE_SPEC.kind, inputs);
-      const stored = await o.store.get(STATES_VALUE_SPEC.kind, key);
-      if (stored && typeof stored.verdict === "string") {
-        verdicts.set(key, { verdict: stored.verdict, by: stored.confirmedBy });
-        continue;
-      }
-      if (judging)
-        ask.push({
-          inputs,
-          texts: { span: cl.span },
-          facts: [`field: ${cl.field}`, `value: ${cl.value}`]
-        });
-      else if (!VALUES(cl.field)) {
-        const by = { by: "ai", run: o.run };
-        await o.store.put(makeJudgment({
-          kind: STATES_VALUE_SPEC.kind,
-          inputs,
-          verdict: "yes",
-          quotes: [{ of: "span", text: cl.span }],
-          why: "The reading the knowledge scan gave with the words it cited.",
-          confirmedBy: by,
-          at
-        }));
-        verdicts.set(key, { verdict: "yes", by });
-      }
-    }
-  if (ask.length) {
-    const r = await judge(STATES_VALUE_SPEC, ask, {
-      runtime: o.runtime,
-      store: o.store,
-      change: "knowledge-scan",
-      now: o.now
-    });
-    for (const [k, v] of r.results)
-      verdicts.set(k, {
-        verdict: v.verdict,
-        by: v.judgment?.confirmedBy ?? { by: "check", rule: "veto" }
-      });
-  }
-  for (const c of items) {
-    let daysBy;
-    for (const cl of c.claims) {
-      const v = verdicts.get(judgmentKey(STATES_VALUE_SPEC.kind, inputsOf(c.item.id, cl)));
-      if (v?.verdict === "yes") {
-        if (cl.field === "lead_time_days")
-          daysBy = v.by;
-        continue;
-      }
-      fail(c.item.id, v === void 0 ? `${cl.field} "${cl.value}" isn't word for word in "${cl.span}": write it as the page says it` : `${cl.field} "${cl.value}": the words "${cl.span}" don't state it (a judge read them${v.verdict === "unsure" ? " and couldn't tell" : ""}); quote the words that do`);
-    }
-    const days = c.item.lead_time_days;
-    if (days && daysBy && c.item.lead_time && !out.has(c.item.id))
-      await o.store.put(makeJudgment({
-        kind: LEAD_TIME,
-        inputs: leadTimeInputs(c.item.id, c.item.lead_time),
-        verdict: "normalised",
-        value: days,
-        confirmedBy: daysBy,
-        at
-      }));
-  }
-  return out;
-}
-
 // packages/knowledge/dist/conflict-owner.js
 var dateOnly2 = (v) => {
   if (v instanceof Date)
@@ -5448,39 +5646,52 @@ function checkConflict(raw, pages, ids) {
     }
   };
 }
-function checkSuperseded(raw, pages) {
+function resolveAnyPage(pages, snapshots, ref3) {
+  const read = resolvePage(pages, ref3);
+  if (read)
+    return { source: read.page.source, page: read.page.pagePath };
+  const r = ref3.trim().replace(/^\.\//, "");
+  const all = snapshots.flatMap((s2) => s2.manifest.pages.map((p) => ({ source: s2.manifest.source, page: p.page })));
+  const exact = all.find((p) => p.page === r || `${p.source}/${p.page}` === r);
+  if (exact)
+    return exact;
+  const byName = all.filter((p) => basename(p.page) === basename(r));
+  return byName.length === 1 ? byName[0] : void 0;
+}
+function checkSuperseded(raw, pages, snapshots) {
   const p = SupersededIn.safeParse(raw);
   if (!p.success)
     return { problem: `a superseded page: ${fmt(p.error.issues).join("; ")}` };
   const s2 = p.data;
   const oldP = resolvePage(pages, s2.old);
-  const newP = resolvePage(pages, s2.new);
+  const newRef = resolveAnyPage(pages, snapshots, s2.new);
   if (!oldP)
     return { problem: `superseded: there is no page ${s2.old} in the snapshot` };
-  if (!newP)
+  if (!newRef)
     return { problem: `superseded: there is no page ${s2.new} in the snapshot` };
+  const newP = pages.find((x) => x.page.source === newRef.source && x.page.pagePath === newRef.page);
   const on = s2.page ? resolvePage(pages, s2.page, s2.quote) : void 0;
-  const candidates = on ? [on] : [newP, oldP];
+  const candidates = on ? [on] : newP ? [newP, oldP] : [oldP];
   const where = candidates.find((c) => checkQuote(c.page.text ?? "", s2.quote).ok);
   if (!where)
     return {
       problem: `superseded ${s2.old}: the quote is not on ${candidates.map((c) => c.page.pagePath).join(" or ")}, word for word`
     };
   const ref3 = (x) => ({ source: x.page.source, page: x.page.pagePath });
-  return { ok: { old: ref3(oldP), new: ref3(newP), quote: s2.quote, quotedOn: ref3(where) } };
+  return { ok: { old: ref3(oldP), new: newRef, quote: s2.quote, quotedOn: ref3(where) } };
 }
-function frontMatterSuperseded(pages) {
+function frontMatterSuperseded(pages, snapshots) {
   const out = [];
   for (const p of pages) {
     const fm = p.page.frontMatter;
     const by = fm["superseded-by"] ?? fm.superseded_by ?? fm.supersededBy;
     if (typeof by !== "string")
       continue;
-    const n = resolvePage(pages, by) ?? resolvePage(pages, `${by}.md`);
+    const n = resolveAnyPage(pages, snapshots, by) ?? resolveAnyPage(pages, snapshots, `${by}.md`);
     if (!n)
       continue;
     const ref3 = (x) => ({ source: x.page.source, page: x.page.pagePath });
-    out.push({ old: ref3(p), new: ref3(n), quote: `superseded-by: ${by}`, quotedOn: ref3(p) });
+    out.push({ old: ref3(p), new: n, quote: `superseded-by: ${by}`, quotedOn: ref3(p) });
   }
   return out;
 }
@@ -5509,6 +5720,35 @@ function checkInjection(raw, pages) {
   };
 }
 var norm = (s2) => words4(s2).join(" ");
+var recordTitle = (r) => r.kind === "Pattern" || r.kind === "Party" || r.kind === "Product" ? r.name : r.title;
+function recordConflict(x, y) {
+  if (x.kind !== y.kind || !x.quote || !y.quote)
+    return void 0;
+  if (x.quote.source === y.quote.source && x.quote.page === y.quote.page)
+    return void 0;
+  const field = (r, f) => {
+    const v = r[f];
+    return typeof v === "string" ? v : void 0;
+  };
+  const cx = field(x, "catalogueItem");
+  const sameThing = norm(recordTitle(x)) === norm(recordTitle(y)) || !!cx && norm(cx) === norm(field(y, "catalogueItem") ?? "");
+  if (!sameThing)
+    return void 0;
+  const differ = (f) => {
+    const a = field(x, f);
+    const b = field(y, f);
+    return a !== void 0 && b !== void 0 && norm(a) !== norm(b);
+  };
+  if (!differ("leadTime") && !differ("handledBy"))
+    return void 0;
+  return {
+    about: [x.id, y.id],
+    pages: [x, y].map((i) => ({ source: i.quote.source, page: i.quote.page })),
+    says: [x.quote.text, y.quote.text],
+    summary: `${recordTitle(x)}: the pages disagree on ${differ("leadTime") ? "the lead time" : "who handles it"}`,
+    foundBy: "check"
+  };
+}
 function checkConflicts(items) {
   const out = [];
   for (let a = 0; a < items.length; a++)
@@ -5783,9 +6023,10 @@ async function scanKnowledge(snapshots, o) {
     return result;
   }
   const kept = /* @__PURE__ */ new Map();
+  const takenBy = new Map((o.taken ?? []).map((r) => [r.id, r]));
   let failed = [];
   let conflicts = [];
-  const superseded = frontMatterSuperseded(pages);
+  const superseded = frontMatterSuperseded(pages, snapshots);
   const aiInjections = [];
   let feedback = [];
   let answered2 = false;
@@ -5867,7 +6108,7 @@ async function scanKnowledge(snapshots, o) {
     }
     answered2 = true;
     for (const s2 of answer.superseded) {
-      const c = checkSuperseded(s2, pages);
+      const c = checkSuperseded(s2, pages, snapshots);
       if ("problem" in c)
         problems.push(c.problem);
       else if (!superseded.some((x) => x.old.page === c.ok.old.page && x.old.source === c.ok.old.source))
@@ -5893,6 +6134,18 @@ async function scanKnowledge(snapshots, o) {
         continue;
       }
       seen.add(id);
+      const other = takenBy.get(id);
+      const at = c.ok.page.page;
+      if (other && !(other.quote?.source === at.source && other.quote.page === at.pagePath)) {
+        failed.push({
+          id,
+          kind: c.ok.item.kind,
+          title: c.ok.item.title,
+          page: at.pagePath,
+          problems: [idTaken(id, other, at.source)]
+        });
+        continue;
+      }
       kept.set(id, c.ok);
     }
     for (const [id, c] of kept) {
@@ -5966,6 +6219,10 @@ async function scanKnowledge(snapshots, o) {
     return true;
   }
 }
+var idTaken = (id, other, source) => {
+  const where = other.quote ? other.quote.source === source ? other.quote.page : `${other.quote.source}/${other.quote.page}` : "another item";
+  return `id ${id} is used by ${where}; choose another`;
+};
 var sameSet = (a, b) => a.length === b.length && [...a].sort().join("\n") === [...b].sort().join("\n");
 function checkScanAnswer(snapshots, output) {
   const pages = snapshots.flatMap((s2) => s2.pages.map((p) => preparePage(p, s2)));
@@ -5980,9 +6237,9 @@ function checkScanAnswer(snapshots, output) {
     return [`the answer isn't YAML: ${e.message.split("\n")[0]}`];
   }
   const problems = [];
-  const superseded = frontMatterSuperseded(pages);
+  const superseded = frontMatterSuperseded(pages, snapshots);
   for (const s2 of answer.superseded) {
-    const c = checkSuperseded(s2, pages);
+    const c = checkSuperseded(s2, pages, snapshots);
     if ("problem" in c)
       problems.push(c.problem);
     else
@@ -6085,6 +6342,11 @@ function copyDate(p) {
 }
 var isKnowledgeRecord = (r) => r.kind === "Pattern" || r.kind === "ProcessDefinition" || r.kind === "Decision" || r.kind === "Product" || r.kind === "Party" && !!r.quote;
 
+// packages/knowledge/dist/knowledge-store.js
+var import_yaml10 = __toESM(require_dist(), 1);
+import { readdir as readdir6, readFile as readFile6, rm as rm2 } from "node:fs/promises";
+import { join as join7, relative as relative3, sep as sep3 } from "node:path";
+
 // packages/knowledge/dist/reviews.js
 var import_yaml9 = __toESM(require_dist(), 1);
 import { createHash as createHash4 } from "node:crypto";
@@ -6174,9 +6436,19 @@ function canonical(v) {
   return v;
 }
 function itemMeaning(r) {
+  return meaningHash(r, false);
+}
+function itemMeaningBefore50(r) {
+  return meaningHash(r, true);
+}
+function meaningHash(r, flagsAndTags) {
   const strip = (q) => q ? Object.fromEntries(Object.entries(q).filter(([k]) => k !== "snapshot" && k !== "line")) : q;
   const x = { ...r };
   delete x.evidence;
+  if (!flagsAndTags) {
+    delete x.flags;
+    delete x.tags;
+  }
   x.quote = strip(x.quote);
   if (Array.isArray(x.alsoOn))
     x.alsoOn = x.alsoOn.map(strip);
@@ -6265,7 +6537,7 @@ async function readReviews(root) {
 function applyReview(item, review) {
   if (!review)
     return { item };
-  const stale = review.checked !== itemMeaning(item);
+  const stale = review.checked !== itemMeaning(item) && review.checked !== itemMeaningBefore50(item);
   const summary3 = {
     state: stale ? "stale" : review.verdict,
     verdict: review.verdict,
@@ -6274,16 +6546,13 @@ function applyReview(item, review) {
     ...review.note ? { note: review.note } : {},
     ...review.corrections ? { corrected: Object.keys(review.corrections).sort() } : {}
   };
-  if (!review.corrections)
+  if (!review.corrections || stale)
     return { item, summary: summary3 };
   const merged = parseRecord({ ...item, ...review.corrections });
   return { item: merged.ok ? merged.record : item, summary: summary3 };
 }
 
 // packages/knowledge/dist/knowledge-store.js
-var import_yaml10 = __toESM(require_dist(), 1);
-import { readdir as readdir6, readFile as readFile6, rm as rm2 } from "node:fs/promises";
-import { join as join7, relative as relative3, sep as sep3 } from "node:path";
 var KNOWLEDGE_REPORT = "scan.yaml";
 var toPosix3 = (p) => p.split(sep3).join("/");
 async function files(dir) {
@@ -6342,7 +6611,7 @@ async function readKnowledge(root, o = {}) {
       const a = applyReview(item, r.reviews.get(item.id));
       if (a.summary)
         reviews[item.id] = a.summary;
-      if (a.summary?.state === "rejected")
+      if (a.summary?.verdict === "rejected")
         rejected.push(a.item);
       else
         shown.push(a.item);
@@ -6368,15 +6637,72 @@ async function writeKnowledge(root, result, scannedAt, o = {}) {
     return !pages || page === void 0 || pages.has(page);
   };
   const before = await readKnowledge(root, { raw: true, cacheRoot: root });
-  const pageText = (source, page) => o.snapshots?.find((x) => x.manifest.source === source)?.pages.find((p) => p.pagePath === page)?.text;
+  const snapPage = (source, page) => {
+    const snap = o.snapshots?.find((x) => x.manifest.source === source);
+    const p = snap?.pages.find((x) => x.pagePath === page);
+    return snap && p ? { snap, p } : void 0;
+  };
+  const pageText = (source, page) => snapPage(source, page)?.p.text;
   const stillQuoted = (r) => {
     if (!r.flags?.some((f) => f.startsWith("found:")) || !r.quote)
       return false;
     const text2 = pageText(r.quote.source, r.quote.page);
     return text2 !== void 0 && checkQuote(text2, r.quote.text, r.quote.section).ok;
   };
-  const keep = before.items.filter((r) => !touches(sourceOf(r), r.quote?.page) || stillQuoted(r));
-  const all = [...keep, ...result.items];
+  const recheckAlsoOn = (r) => {
+    if (!r.alsoOn.some((a) => touches(a.source, a.page)))
+      return r;
+    const alsoOn = [];
+    const evidence = [...r.evidence];
+    const paired = evidence.length === r.alsoOn.length + 1;
+    const keptEvidence = paired ? [evidence[0]] : evidence;
+    r.alsoOn.forEach((a, k) => {
+      if (!touches(a.source, a.page)) {
+        alsoOn.push(a);
+        if (paired)
+          keptEvidence.push(evidence[k + 1]);
+        return;
+      }
+      const at = snapPage(a.source, a.page);
+      const c = at ? checkQuote(at.p.text ?? "", a.text, a.section) : void 0;
+      if (!at || !c?.ok)
+        return;
+      const m = at.snap.manifest.pages.find((x) => x.page === a.page);
+      const snapshot = m?.in ?? at.snap.manifest.date;
+      alsoOn.push({ ...a, section: c.section, line: c.line, snapshot });
+      if (paired)
+        keptEvidence.push({ ...evidence[k + 1], path: at.p.path, line: c.line });
+    });
+    return { ...r, alsoOn, evidence: keptEvidence };
+  };
+  const keep = before.items.filter((r) => !touches(sourceOf(r), r.quote?.page) || stillQuoted(r)).map(recheckAlsoOn);
+  const keptById = new Map(keep.map((r) => [r.id, r]));
+  const refused = [];
+  const accepted = [];
+  for (const r of result.items) {
+    const k = keptById.get(r.id);
+    if (k && !(k.quote?.source === r.quote?.source && k.quote?.page === r.quote?.page)) {
+      refused.push({
+        id: r.id,
+        kind: knowledgeKindOf(r) ?? r.kind,
+        title: itemTitle(r),
+        ...r.quote ? { page: r.quote.page, source: r.quote.source } : {},
+        problems: [idTaken(r.id, k, r.quote?.source ?? "")]
+      });
+      continue;
+    }
+    accepted.push(r);
+  }
+  const readNow = new Set(accepted.map((r) => r.id));
+  const merged = [...keep.filter((r) => !readNow.has(r.id)), ...accepted];
+  const refusedIds = new Set(refused.map((f) => f.id));
+  const found = result.conflicts.filter((c) => !c.about.some((a) => refusedIds.has(a)));
+  const conflicts = mergeConflicts(before.report?.conflicts ?? [], found, merged, {
+    readNow,
+    ...o.snapshots ? { snapshots: o.snapshots } : {},
+    superseded: result.superseded
+  });
+  const all = merged.map((r) => withConflictFlags(r, conflicts));
   const dir = join7(knowledgeDirOf(root), "items");
   const wanted = new Map(all.map((r) => [recordPath(r), serializeRecord(r)]));
   let written = 0;
@@ -6439,7 +6765,7 @@ async function writeKnowledge(root, result, scannedAt, o = {}) {
     scannedAt,
     snapshots,
     changes: { at: scannedAt, ...changes },
-    conflicts: [...other(old?.conflicts), ...result.conflicts],
+    conflicts,
     superseded: [
       ...(old?.superseded ?? []).filter((x) => !touches(x.old.source, x.old.page)),
       ...result.superseded
@@ -6450,11 +6776,62 @@ async function writeKnowledge(root, result, scannedAt, o = {}) {
       ...result.failed.map((f) => ({
         ...f,
         ...result.snapshots.length === 1 ? { source: result.snapshots[0].source } : {}
-      }))
+      })),
+      ...refused
     ]
   };
   await writeFileAtomic(join7(knowledgeDirOf(root), KNOWLEDGE_REPORT), (0, import_yaml10.stringify)(report));
-  return { written, removed, changes };
+  return { written, removed, changes, ...refused.length ? { refused } : {} };
+}
+var sameAbout = (a, b) => a.length === b.length && [...a].sort().join("\n") === [...b].sort().join("\n");
+function mergeConflicts(old, found, items, o) {
+  const byId2 = new Map(items.map((r) => [r.id, r]));
+  const out = found.filter((c) => c.about.every((a) => byId2.has(a)));
+  const has = (about) => out.some((c) => sameAbout(c.about, about));
+  for (const c of old) {
+    if (has(c.about) || !c.about.every((a) => byId2.has(a)))
+      continue;
+    const reread = c.about.filter((a) => o.readNow.has(a));
+    if (c.foundBy === "check") {
+      if (!reread.length) {
+        out.push(c);
+        continue;
+      }
+      const [x, y] = c.about.map((a) => byId2.get(a));
+      const again = x && y && c.about.length === 2 ? recordConflict(x, y) : void 0;
+      if (again)
+        out.push({ ...again, ...c.owner ? { owner: c.owner } : {} });
+    } else if (reread.length < c.about.length)
+      out.push(c);
+  }
+  const facts2 = (o.snapshots ?? []).flatMap((s2) => s2.pages.map((p) => pageFacts(p, s2.manifest)));
+  const kept = items.filter((r) => !o.readNow.has(r.id));
+  for (const x of items.filter((r) => o.readNow.has(r.id)))
+    for (const y of kept) {
+      if (has([x.id, y.id]))
+        continue;
+      const c = recordConflict(x, y);
+      if (!c)
+        continue;
+      const handledBy = [x, y].map((r) => "handledBy" in r ? r.handledBy : void 0).filter((h) => typeof h === "string");
+      const owner = facts2.length ? conflictOwner(c, facts2, {
+        ...knowledgeKindOf(x) ? { kind: knowledgeKindOf(x) } : {},
+        ...new Set(handledBy).size === 1 ? { handledBy: handledBy[0] } : {}
+      }, o.superseded) : void 0;
+      out.push(owner ? { ...c, owner } : c);
+    }
+  return out;
+}
+function withConflictFlags(r, conflicts) {
+  const mine = conflicts.filter((c) => c.about.includes(r.id)).map((c) => `conflict:${c.pages.map((p) => p.page).join("|")}`);
+  const flags = [
+    .../* @__PURE__ */ new Set([...(r.flags ?? []).filter((f) => !f.startsWith("conflict:")), ...mine.sort()])
+  ];
+  const same3 = flags.length === (r.flags ?? []).length && flags.every((f, k) => f === r.flags[k]);
+  if (same3)
+    return r;
+  const { flags: _, ...rest } = r;
+  return flags.length ? { ...rest, flags } : rest;
 }
 function filterItems(items, o) {
   const tag = o.tag?.toLowerCase();
@@ -7310,6 +7687,10 @@ function planRescan(snapshots, report, items, o = {}) {
   }
   return plan;
 }
+function keptBy(items, plan) {
+  const previous = new Set(plan.previous);
+  return items.filter((i) => !previous.has(i));
+}
 
 // packages/knowledge/dist/find.js
 var import_yaml12 = __toESM(require_dist(), 1);
@@ -7397,6 +7778,8 @@ async function findKnowledge(snapshots, phrase, o) {
     ...o.resume ? { resume: o.resume } : {},
     ...o.maxAttempts ? { maxAttempts: o.maxAttempts } : {},
     focus: { phrase, known },
+    // Review round 50: an id an item of another page has is handed back, never reused.
+    taken: o.items.filter((i) => !known.includes(i)),
     ...o.judgments ? { judgments: o.judgments } : {}
   });
   const ids = new Set(o.items.map((i) => i.id));
@@ -7426,8 +7809,8 @@ var FindFile = external_exports.object({
 var slugOf2 = (s2) => fold2(s2).replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60) || "search";
 var findsDir = (root) => join10(knowledgeDirOf(root), FINDS_DIR);
 async function saveFind(root, r, at) {
-  const slug4 = slugOf2(r.phrase);
-  await writeFileAtomic(join10(findsDir(root), `${slug4}.yaml`), `# What a search of the wikis found (ADR 0101). atticus knowledge keep <candidate> --find ${slug4} keeps one.
+  const slug5 = slugOf2(r.phrase);
+  await writeFileAtomic(join10(findsDir(root), `${slug5}.yaml`), `# What a search of the wikis found (ADR 0101). atticus knowledge keep <candidate> --find ${slug5} keeps one.
 ${(0, import_yaml12.stringify)({
     schemaVersion: 1,
     phrase: r.phrase,
@@ -7435,10 +7818,10 @@ ${(0, import_yaml12.stringify)({
     matches: r.matches,
     candidates: r.candidates
   }, { lineWidth: 0 })}`);
-  return slug4;
+  return slug5;
 }
-async function readFind(root, slug4) {
-  const text2 = await readFile8(join10(findsDir(root), `${slug4}.yaml`), "utf8").catch(() => void 0);
+async function readFind(root, slug5) {
+  const text2 = await readFile8(join10(findsDir(root), `${slug5}.yaml`), "utf8").catch(() => void 0);
   if (text2 === void 0)
     return void 0;
   const f = FindFile.safeParse((0, import_yaml12.parse)(text2));
@@ -7455,7 +7838,7 @@ async function readFind(root, slug4) {
       });
   }
   return {
-    slug: slug4,
+    slug: slug5,
     phrase: f.data.phrase,
     at: f.data.at,
     matches: f.data.matches,
@@ -7484,14 +7867,14 @@ var KIND_FIELD = {
   Party: ["partyKind", (k) => k === "vendor" ? "vendor" : "internal-team"],
   Product: ["productKind", (k) => k]
 };
-async function keepCandidate(root, slug4, id, o) {
-  const f = await readFind(root, slug4);
+async function keepCandidate(root, slug5, id, o) {
+  const f = await readFind(root, slug5);
   if (!f)
-    return { error: `There is no saved search ${slug4}. atticus knowledge finds lists them.` };
+    return { error: `There is no saved search ${slug5}. atticus knowledge finds lists them.` };
   const c = f.candidates.find((x) => x.record.id === id);
   if (!c)
     return {
-      error: `The search ${slug4} has no candidate ${id}: it has ${f.candidates.map((x) => x.record.id).join(", ")}.`
+      error: `The search ${slug5} has no candidate ${id}: it has ${f.candidates.map((x) => x.record.id).join(", ")}.`
     };
   if (c.known)
     return {
@@ -7503,7 +7886,7 @@ async function keepCandidate(root, slug4, id, o) {
   if (!allowed.includes(as))
     return { error: `${id} can be kept as ${allowed.join(" or ")}.` };
   const [field, value] = KIND_FIELD[c.record.kind];
-  const flag = `found:${slug4}`;
+  const flag = `found:${slug5}`;
   const parsed = parseRecord({
     ...c.record,
     [field]: value(as),
@@ -7525,7 +7908,7 @@ async function keepCandidate(root, slug4, id, o) {
   await writeReview(root, r.review);
   c.kept = { by: o.by, at: o.at, as };
   c.record = item;
-  await writeFileAtomic(join10(findsDir(root), `${slug4}.yaml`), `# What a search of the wikis found (ADR 0101). atticus knowledge keep <candidate> --find ${slug4} keeps one.
+  await writeFileAtomic(join10(findsDir(root), `${slug5}.yaml`), `# What a search of the wikis found (ADR 0101). atticus knowledge keep <candidate> --find ${slug5} keeps one.
 ${(0, import_yaml12.stringify)({
     schemaVersion: 1,
     phrase: f.phrase,
@@ -7945,15 +8328,149 @@ ${(0, import_yaml14.stringify)({ ...draft2, proposals: left }, { lineWidth: 0 })
   };
 }
 
+// packages/knowledge/dist/passages.js
+var MAX_TEXT = 1500;
+var clip = (s2) => s2.length > MAX_TEXT ? `${s2.slice(0, MAX_TEXT - 1).trimEnd()}\u2026` : s2;
+function visibleLines(text2) {
+  const raw = text2.replace(/\r\n?/g, "\n").split("\n");
+  const lines = visibleText(raw.join("\n")).split("\n").map((l, i) => l === raw[i] ? l : l.replace(/[ \t]{2,}/g, " ").trimEnd());
+  let from = 0;
+  if (lines[0]?.trim() === "---") {
+    const end = lines.findIndex((l, k) => k > 0 && (l.trim() === "---" || l.trim() === "..."));
+    if (end > 0) {
+      for (let k = 0; k <= end; k++)
+        lines[k] = "";
+      from = end + 1;
+    }
+  }
+  return { lines, from };
+}
+function pageSections(p) {
+  const { lines, from } = visibleLines(p.text);
+  const out = [];
+  const path = [];
+  let start = from;
+  let heading = "";
+  const flush = (end) => {
+    const body = lines.slice(start, end);
+    const text2 = body.filter((l, i) => !(i === 0 && /^#{1,6}\s/.test(l))).join("\n").trim();
+    if (text2 || heading)
+      out.push({
+        source: p.source,
+        page: p.page,
+        path: p.path,
+        heading,
+        line: start + 1,
+        text: clip(text2)
+      });
+  };
+  let inFence = false;
+  lines.forEach((l, i) => {
+    if (/^\s*(```|~~~)/.test(l))
+      inFence = !inFence;
+    const h = inFence ? null : /^(#{1,6})\s+(.*?)\s*#*\s*$/.exec(l);
+    if (!h)
+      return;
+    if (i > start || heading)
+      flush(i);
+    const level = h[1].length;
+    while (path.length && path.at(-1).level >= level)
+      path.pop();
+    path.push({ level, text: h[2] });
+    heading = path.map((x) => x.text).join(" \u203A ");
+    start = i;
+  });
+  flush(lines.length);
+  return out.filter((s2) => s2.text || s2.heading);
+}
+var slug4 = (s2) => s2.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+function sectionOf(pages, id) {
+  const hash = id.indexOf("#");
+  const where = hash < 0 ? id : id.slice(0, hash);
+  const want = hash < 0 ? "" : id.slice(hash + 1).trim();
+  const page = pages.find((p) => `${p.source}/${p.page}` === where || p.path === where || p.page === where);
+  if (!page)
+    return void 0;
+  const sections = pageSections(page);
+  if (!want)
+    return sections[0];
+  const w = want.toLowerCase();
+  const last = (h) => h.split(" \u203A ").at(-1) ?? h;
+  return sections.find((s2) => s2.heading.toLowerCase() === w || last(s2.heading).toLowerCase() === w) ?? sections.find((s2) => slug4(s2.heading) === slug4(want) || slug4(last(s2.heading)) === slug4(want)) ?? sections.find((s2) => slug4(want).endsWith(slug4(last(s2.heading))) && slug4(last(s2.heading)));
+}
+function rankPassages(question, pages, limit = 5) {
+  const q = [...new Set(termsOf(question))];
+  if (!q.length)
+    return [];
+  const all = pages.flatMap(pageSections);
+  const docs = all.map((s2) => new Set(termsOf(`${s2.heading} ${s2.text}`)));
+  const idf = new Map(q.map((t) => [t, Math.log(1 + all.length / (1 + docs.filter((d) => d.has(t)).length))]));
+  const need = q.length > 2 ? 2 : 1;
+  return all.map((s2, k) => {
+    const hits = q.filter((t) => docs[k].has(t));
+    const heading = new Set(termsOf(s2.heading));
+    const score = hits.reduce((n, t) => n + idf.get(t) * (heading.has(t) ? 1.5 : 1), 0);
+    return { s: s2, hits: hits.length, score };
+  }).filter((x) => x.hits >= need).sort((a, b) => b.score - a.score || a.s.path.localeCompare(b.s.path) || a.s.line - b.s.line).slice(0, limit).map((x) => x.s);
+}
+function knowledgeAnswer(question, o) {
+  const limit = o.limit ?? 5;
+  const q = termsOf(question);
+  const need = new Set(q).size > 2 ? 2 : 1;
+  const items = rankItems(question, [...o.items]).filter((x) => {
+    const own = new Set(termsOf(`${itemTitle(x.item)} ${x.item.quote?.text ?? ""} ${x.item.tags.join(" ")}`));
+    return [...new Set(q)].filter((t) => own.has(t)).length >= need;
+  }).slice(0, limit).map(({ item }) => ({
+    id: item.id,
+    kind: item.kind,
+    title: itemTitle(item),
+    ...item.quote ? {
+      quote: {
+        source: item.quote.source,
+        page: item.quote.page,
+        ...item.quote.section ? { section: item.quote.section } : {},
+        text: item.quote.text
+      }
+    } : {}
+  }));
+  return { items, passages: rankPassages(question, o.pages, limit) };
+}
+
 export {
+  frontMatterEnd,
+  readMarkdown,
+  sentences,
+  mentionIndex,
+  decodeEntities,
+  htmlToMarkdown,
+  elementInner,
+  exportDate,
+  exportPage,
+  titleSegment,
+  uniquePagePaths,
+  readCsv,
+  confluenceExportAdapter,
+  sharepointExportAdapter,
   readSourceSettings,
+  pageSignalsOf,
   pageStandingOf,
+  bodyKey,
+  pageRestricted,
+  authorityWords,
   scopeWords,
+  exceptionTo,
   emptyPlaces,
   scopeMatch,
+  markdownFolderAdapter,
+  wikiApiAdapter,
   daysBetween,
+  pageOwnerLine,
   readPage,
   syncSources,
+  sourceDocument,
+  reachesItem,
+  mapFacts,
+  reachesItems,
   judgeFacts,
   scanPatterns,
   diffPatterns,
@@ -7976,50 +8493,101 @@ export {
   workItemsFromTracker,
   suggestFeatureLinks,
   featureFlows,
+  FEATURE_CHECKS,
+  NAME_ABBREVIATIONS,
+  nameWords2 as nameWords,
+  abbreviates,
   namingHint,
+  glossaryTermKnown,
   newestEvidence,
+  freshness,
+  KNOWLEDGE_CHECKS,
   knowledgeGaps,
+  COVERAGE_AREAS,
   featureCoverage,
   coverage,
   toApiCoverage,
+  DEFAULT_DOMAIN_PROFILE,
   domainProfile,
+  visibleText,
+  pageLines,
+  foldQuote,
+  readerText,
   checkQuote,
+  valueTokens,
+  groundValues,
   workingDays,
+  LEAD_TIME,
+  leadTimeInputs,
   leadTimeDaysOf,
+  settleClaims,
   tagList,
   setSourceTags,
   SNAPSHOT_FILE,
   SnapshotManifest,
+  sourceTags,
   writeSnapshots,
+  readManifest,
+  snapshotCopyPath,
   snapshotDates,
   snapshotSources,
   readSnapshot,
   snapshotPages,
+  linksIn,
+  sectionAt,
   pageFacts,
+  conflictOwner,
+  KNOWLEDGE_READER,
   KNOWLEDGE_SCAN_OUTPUT,
+  knowledgeReaderAgent,
+  preparePage,
+  SCAN_ROOM_RESERVE,
   knowledgeScanRoom,
+  recordConflict,
   scanKnowledge,
+  idTaken,
   checkScanAnswer,
+  isKnowledgeRecord,
+  REVIEWS_DIR,
+  KnowledgeReview,
   correctableFields,
   fieldName,
+  itemMeaning,
+  itemMeaningBefore50,
   reviewItem,
   writeReview,
   readReviews,
+  applyReview,
+  KNOWLEDGE_REPORT,
   readKnowledge,
   writeKnowledge,
   filterItems,
   itemTitle,
+  KNOWLEDGE_ASK_OUTPUT,
+  KNOWLEDGE_ASKER,
+  knowledgeAskerAgent,
   termsOf,
+  rankItems,
   itemForAi,
   askKnowledge,
+  valuesOf,
+  codeSettles,
+  snapshotPageReader,
+  standingSuggestion,
   CONFLICT_STEP,
+  conflictKey,
+  conflictKeyOfQuestion,
   conflictDraft,
   readConflicts,
   conflictLine,
   codeText,
+  unquoteGitPath,
   checkoutGitWiki,
   gitWikiAdapter,
+  tokensOf,
   planRescan,
+  keptBy,
+  FINDS_DIR,
   searchPages,
   findKnowledge,
   saveFind,
@@ -8030,6 +8598,11 @@ export {
   draftOrgPack,
   acceptOrgPackDraft,
   estimateScan,
+  StandardCheckProposal,
   draftStandardChecks,
-  acceptStandardChecks
+  acceptStandardChecks,
+  pageSections,
+  sectionOf,
+  rankPassages,
+  knowledgeAnswer
 };