@hawkeyexl/manni 2.0.1 → 2.2.0

package/dist/{chunk-QLVNSAHR.js → chunk-6JWX6JM2.js}

@@ -2,10 +2,12 @@
 import {
   DocmetaError,
   ENCRYPTION_KEY_ENV,
-  FILE_SCHEMA_KEY,
-  KEYED_PIN_PREFIX,
   LEGACY_CONFIG_NAMES,
+  LineRangeError,
+  MAX_RANGE_LINES,
   META_CONTEXT,
+  MOVE_BUDGET_BYTES,
+  MOVE_WINDOW_LINES,
   PATH_JOIN,
   STDIN_LABEL,
   STDIN_TOKEN,
@@ -15,7 +17,6 @@ import {
   classifyRef,
   committedKeyWarning,
   decryptValue,
-  deepEqual,
   encryptValue,
   ensureEncryptionKey,
   errorMessage,
@@ -28,23 +29,29 @@ import {
   findConfigFile,
   findFamilyConfigFile,
   findGitRoot,
+  findWindows,
   generateEncryptionKey,
   gitignoreOptions,
-  integrityOf,
+  hashLines,
+  hashRange,
   isEncryptedValue,
   isErrorSeverity,
   isIgnoredByGit,
+  isKeyedPin,
   isMember,
   isValidEncryptionKey,
-  keyedPin,
+  lineSpec,
   loadExternalMetadata,
   locateFrontmatter,
   memberOf,
   mergeExternalMetadata,
+  normalizeText,
   orphanEntries,
   orphanError,
   orphanJoins,
   palette,
+  parseLines,
+  pinOfLines,
   readConfigFile,
   readFamilyConfigFile,
   resolveBaselineRequest,
@@ -52,11 +59,17 @@ import {
   resolveTargetSet,
   selectCollections,
   settleBaseline,
+  sliceLines,
+  spellLines,
+  spliceManifestValue,
+  splitLines,
   supportedExtensions,
+  toBodyLines,
+  toFileLines,
   withValueAt,
   writeEncryptionKey,
   writeFileAtomic
-} from "./chunk-PDNSN5UJ.js";
+} from "./chunk-5O4FIGDJ.js";
 
 // src/meta/core/reencrypt.ts
 import { extname } from "node:path";
@@ -200,7 +213,7 @@ __export(cite_exports, {
   formatStatement: () => formatStatement,
   gitClient: () => gitClient,
   hashLines: () => hashLines,
-  hashRange: () => hashRange,
+  hashRange: () => hashRange2,
   historyOf: () => historyOf,
   insertStatementBefore: () => insertStatementBefore,
   insideFence: () => insideFence,
@@ -249,7 +262,7 @@ __export(cite_exports, {
   shortPin: () => shortPin,
   shortSrc: () => shortSrc,
   sidecarsFor: () => sidecarsFor,
-  sliceLines: () => sliceLines,
+  sliceLines: () => sliceLines2,
   sourceRange: () => sourceRange,
   spellLines: () => spellLines,
   spellSource: () => spellSource,
@@ -292,6 +305,14 @@ var CiteError = class extends ToolError {
     this.name = "CiteError";
   }
 };
+function asCiteError(call) {
+  try {
+    return call();
+  } catch (error) {
+    if (error instanceof LineRangeError) throw new CiteError(error.message);
+    throw error;
+  }
+}
 
 // src/cite/core/severity.ts
 var DEFAULT_SEVERITY = {
@@ -324,7 +345,6 @@ function resolveSeverity(overrides) {
 // src/cite/core/range.ts
 var FILE_PATTERN = /^(?:~[A-Za-z0-9_-]{82,}|(?!~)(?:(?!\.\.?(?:\/|$))[^/\\:\r\n\t]+)(?:\/(?:(?!\.\.?(?:\/|$))[^/\\:\r\n\t]+))*)$/;
 var SRC_PATTERN = /^(?:~[A-Za-z0-9_-]{82,}|(?!~)(?:(?!\.\.?(?:\/|:|$))[^/\\:\r\n\t]+)(?:\/(?:(?!\.\.?(?:\/|:|$))[^/\\:\r\n\t]+))*)(?::[1-9][0-9]*(?:-[1-9][0-9]*)?)?$/;
-var RANGE_SPEC = /^([1-9][0-9]*)(?:-([1-9][0-9]*))?$/;
 function parseSrc(src) {
   if (!SRC_PATTERN.test(src)) {
     throw new CiteError(
@@ -351,24 +371,6 @@ function formatSrc(range) {
   if (end === void 0 || end === start) return `${path}:${start}`;
   return `${path}:${start}-${end}`;
 }
-function parseLines(spec) {
-  if (typeof spec === "number") {
-    return Number.isInteger(spec) && spec >= 1 ? { start: spec, end: spec } : void 0;
-  }
-  const m = RANGE_SPEC.exec(spec);
-  const startText = m?.[1];
-  if (startText === void 0) return void 0;
-  const start = Number(startText);
-  const endText = m?.[2];
-  const end = endText === void 0 ? start : Number(endText);
-  return end < start ? void 0 : { start, end };
-}
-function lineSpec(lines) {
-  return lines.start === lines.end ? lines.start : `${String(lines.start)}-${String(lines.end)}`;
-}
-function spellLines(lines) {
-  return String(lineSpec(lines));
-}
 function sourceRange(source) {
   const range = { path: source.file, encrypted: isEncryptedValue(source.file) };
   if (source.lines === void 0) return range;
@@ -388,33 +390,11 @@ function rangeLines(range) {
 }
 
 // src/cite/core/hash.ts
-function normalizeText(text) {
-  const body = text.charCodeAt(0) === 65279 ? text.slice(1) : text;
-  return body.replace(/\r\n/g, "\n");
-}
-function splitLines(text) {
-  const parts = normalizeText(text).split("\n");
-  if (parts.length > 0 && parts[parts.length - 1] === "") parts.pop();
-  return parts;
-}
-function sliceLines(lines, range, label) {
-  const start = range?.start;
-  if (start === void 0) return lines.join("\n");
-  const end = range?.end ?? start;
-  if (start > lines.length || end > lines.length) {
-    const first = start > lines.length ? start : end;
-    throw new CiteError(`${label ?? "the source"} has ${lines.length} lines; line ${first} is out of range.`);
-  }
-  return lines.slice(start - 1, end).join("\n");
+function sliceLines2(lines, range, label) {
+  return asCiteError(() => sliceLines(lines, range, label));
 }
-function hashRange(text, range, key) {
-  return hashLines(sliceLines(splitLines(text), range), key);
-}
-function hashLines(joined, key) {
-  return key === void 0 ? integrityOf(Buffer.from(joined, "utf8")) : keyedPin(joined, key);
-}
-function isKeyedPin(pin) {
-  return pin.startsWith(KEYED_PIN_PREFIX);
+function hashRange2(text, range, key) {
+  return asCiteError(() => hashRange(text, range, key));
 }
 
 // src/cite/core/spell.ts
@@ -855,141 +835,6 @@ function offsetOfLine(content, line) {
   return pos;
 }
 
-// src/cite/core/classify.ts
-var MOVE_WINDOW_LINES = 2e3;
-var MOVE_BUDGET_BYTES = 64 * 1024 * 1024;
-var MAX_RANGE_LINES = 5e3;
-function findWindows(lines, length, pin, key, opts) {
-  const starts = [];
-  const lastStart = lines.length - length + 1;
-  if (length < 1 || lastStart < 1) return { starts, truncated: false };
-  const joined = (start) => lines.slice(start - 1, start - 1 + length).join("\n");
-  const original = opts?.original;
-  if (original !== void 0) {
-    const first = original[0];
-    for (let start = 1; start <= lastStart; start++) {
-      if (lines[start - 1] !== first) continue;
-      let same = true;
-      for (let i = 1; i < length; i++) {
-        if (lines[start - 1 + i] !== original[i]) {
-          same = false;
-          break;
-        }
-      }
-      if (same && hashLines(joined(start), key) === pin) starts.push(start);
-    }
-    return { starts, truncated: false };
-  }
-  const budget = opts?.budget ?? MOVE_BUDGET_BYTES;
-  const around = opts?.around ?? 1;
-  const bandStart = Math.max(1, around - MOVE_WINDOW_LINES);
-  const bandEnd = Math.min(lastStart, around + MOVE_WINDOW_LINES);
-  const order = [];
-  for (let start = bandStart; start <= bandEnd; start++) order.push(start);
-  for (let start = 1; start < bandStart; start++) order.push(start);
-  for (let start = bandEnd + 1; start <= lastStart; start++) order.push(start);
-  let spent = 0;
-  for (const start of order) {
-    const text = joined(start);
-    const bytes = Buffer.byteLength(text, "utf8");
-    if (spent + bytes > budget) return { starts, truncated: true };
-    spent += bytes;
-    if (hashLines(text, key) === pin) starts.push(start);
-  }
-  return { starts, truncated: false };
-}
-async function historyOf(git, commit, path, range, pin, key, budget) {
-  const shown = await git.showFile(commit, path);
-  if ("missing" in shown) {
-    return shown.missing === "commit" ? { kind: "unavailable" } : { kind: "never-true" };
-  }
-  const then = splitLines(shown.text);
-  let joined;
-  try {
-    joined = sliceLines(then, range);
-  } catch {
-    joined = void 0;
-  }
-  if (joined !== void 0 && hashLines(joined, key) === pin) {
-    return { kind: "original", lines: joined.split("\n") };
-  }
-  if (range.start === void 0) return { kind: "never-true" };
-  const length = (range.end ?? range.start) - range.start + 1;
-  const search = { around: range.start };
-  if (budget !== void 0) search.budget = budget;
-  const found = findWindows(then, length, pin, key, search);
-  const [first] = found.starts;
-  if (first !== void 0) {
-    return { kind: "original", lines: then.slice(first - 1, first - 1 + length) };
-  }
-  return found.truncated ? { kind: "unknown" } : { kind: "never-true" };
-}
-async function classifyCitation(entry, opts) {
-  const { citation } = entry;
-  const range = sourceRange(citation.source);
-  const commit = citation.source["commit-sha"];
-  const result = { src: spellSource(citation.source), status: "missing" };
-  if (commit !== void 0) result.commitSha = commit;
-  const source = await readSource(opts.root, opts.index, range, opts.key);
-  if (source.kind === "missing") {
-    result.missingReason = source.reason;
-    return result;
-  }
-  result.resolvedPath = source.resolvedPath;
-  const key = range.encrypted ? opts.key : void 0;
-  const pin = citation.source.integrity;
-  const lines = splitLines(source.text);
-  let here;
-  try {
-    here = hashLines(sliceLines(lines, range), key);
-  } catch {
-    here = void 0;
-  }
-  if (here === pin) {
-    result.status = "current";
-    return result;
-  }
-  let history = { kind: "none" };
-  if (commit !== void 0 && await opts.git.available()) {
-    history = await historyOf(opts.git, commit, source.resolvedPath, range, pin, key, opts.budget);
-  }
-  if (range.start !== void 0) {
-    const start = range.start;
-    const end = range.end ?? start;
-    const search = { around: start };
-    if (history.kind === "original") search.original = history.lines;
-    if (opts.budget !== void 0) search.budget = opts.budget;
-    const found = findWindows(lines, end - start + 1, pin, key, search);
-    if (found.truncated) result.truncatedSearch = true;
-    const spell = (at2) => formatSrc({ ...range, start: at2, end: at2 + (end - start) });
-    const [only] = found.starts;
-    if (found.starts.length === 1 && only !== void 0) {
-      result.status = "moved";
-      result.newSrc = spell(only);
-      result.newLines = String(lineSpec({ start: only, end: only + (end - start) }));
-      return result;
-    }
-    if (found.starts.length > 1) {
-      result.status = "moved-ambiguous";
-      result.candidates = found.starts.map(spell);
-      return result;
-    }
-  }
-  if (history.kind === "never-true") {
-    result.status = "never-true";
-    return result;
-  }
-  result.status = "changed";
-  if (history.kind === "unavailable") result.historyAvailable = false;
-  if (history.kind === "unknown") result.truncatedSearch = true;
-  if (history.kind === "original" && commit !== void 0) {
-    result.historyAvailable = true;
-    result.commitsSince = await opts.git.subjectsSince(commit, source.resolvedPath);
-    result.diff = await opts.git.diffSince(commit, source.resolvedPath);
-  }
-  return result;
-}
-
 // src/cite/core/claims.ts
 function normalizeWhitespace(text) {
   return text.replace(/\s+/g, " ").trim();
@@ -1002,19 +847,9 @@ function normalizeBlock(text) {
 function blockMatches(blockText, citedJoined) {
   return normalizeBlock(blockText) === normalizeBlock(citedJoined);
 }
-function toFileLines(lines, bodyLine) {
-  return { start: bodyLine + lines.start - 1, end: bodyLine + lines.end - 1 };
-}
-function toBodyLines(lines, bodyLine) {
-  return { start: lines.start - bodyLine + 1, end: lines.end - bodyLine + 1 };
-}
 function textAt(lines, range) {
   return lines.slice(range.start - 1, Math.min(range.end, lines.length));
 }
-function pinOfLines(lines, range) {
-  if (range.start < 1 || range.end > lines.length) return void 0;
-  return hashLines(lines.slice(range.start - 1, range.end).join("\n"));
-}
 function claimLine(claim) {
   const at2 = claim.fileLines === void 0 ? void 0 : parseLines(claim.fileLines);
   return at2?.start;
@@ -1188,6 +1023,99 @@ function noGit() {
   };
 }
 
+// src/cite/core/classify.ts
+async function historyOf(git, commit, path, range, pin, key, budget) {
+  const shown = await git.showFile(commit, path);
+  if ("missing" in shown) {
+    return shown.missing === "commit" ? { kind: "unavailable" } : { kind: "never-true" };
+  }
+  const then = splitLines(shown.text);
+  let joined;
+  try {
+    joined = sliceLines2(then, range);
+  } catch {
+    joined = void 0;
+  }
+  if (joined !== void 0 && hashLines(joined, key) === pin) {
+    return { kind: "original", lines: joined.split("\n") };
+  }
+  if (range.start === void 0) return { kind: "never-true" };
+  const length = (range.end ?? range.start) - range.start + 1;
+  const search = { around: range.start };
+  if (budget !== void 0) search.budget = budget;
+  const found = findWindows(then, length, pin, key, search);
+  const [first] = found.starts;
+  if (first !== void 0) {
+    return { kind: "original", lines: then.slice(first - 1, first - 1 + length) };
+  }
+  return found.truncated ? { kind: "unknown" } : { kind: "never-true" };
+}
+async function classifyCitation(entry, opts) {
+  const { citation } = entry;
+  const range = sourceRange(citation.source);
+  const commit = citation.source["commit-sha"];
+  const result = { src: spellSource(citation.source), status: "missing" };
+  if (commit !== void 0) result.commitSha = commit;
+  const source = await readSource(opts.root, opts.index, range, opts.key);
+  if (source.kind === "missing") {
+    result.missingReason = source.reason;
+    return result;
+  }
+  result.resolvedPath = source.resolvedPath;
+  const key = range.encrypted ? opts.key : void 0;
+  const pin = citation.source.integrity;
+  const lines = splitLines(source.text);
+  let here;
+  try {
+    here = hashLines(sliceLines2(lines, range), key);
+  } catch {
+    here = void 0;
+  }
+  if (here === pin) {
+    result.status = "current";
+    return result;
+  }
+  let history = { kind: "none" };
+  if (commit !== void 0 && await opts.git.available()) {
+    history = await historyOf(opts.git, commit, source.resolvedPath, range, pin, key, opts.budget);
+  }
+  if (range.start !== void 0) {
+    const start = range.start;
+    const end = range.end ?? start;
+    const search = { around: start };
+    if (history.kind === "original") search.original = history.lines;
+    if (opts.budget !== void 0) search.budget = opts.budget;
+    const found = findWindows(lines, end - start + 1, pin, key, search);
+    if (found.truncated) result.truncatedSearch = true;
+    const spell = (at2) => formatSrc({ ...range, start: at2, end: at2 + (end - start) });
+    const [only] = found.starts;
+    if (found.starts.length === 1 && only !== void 0) {
+      result.status = "moved";
+      result.newSrc = spell(only);
+      result.newLines = String(lineSpec({ start: only, end: only + (end - start) }));
+      return result;
+    }
+    if (found.starts.length > 1) {
+      result.status = "moved-ambiguous";
+      result.candidates = found.starts.map(spell);
+      return result;
+    }
+  }
+  if (history.kind === "never-true") {
+    result.status = "never-true";
+    return result;
+  }
+  result.status = "changed";
+  if (history.kind === "unavailable") result.historyAvailable = false;
+  if (history.kind === "unknown") result.truncatedSearch = true;
+  if (history.kind === "original" && commit !== void 0) {
+    result.historyAvailable = true;
+    result.commitsSince = await opts.git.subjectsSince(commit, source.resolvedPath);
+    result.diff = await opts.git.diffSince(commit, source.resolvedPath);
+  }
+  return result;
+}
+
 // src/cite/core/page.ts
 import { extname as extname2 } from "node:path";
 import * as Ajv2020Ns from "ajv/dist/2020.js";
@@ -1195,8 +1123,8 @@ import * as Ajv2020Ns from "ajv/dist/2020.js";
 // src/cite/schema/citations.json
 var citations_default = {
   $schema: "https://json-schema.org/draft/2020-12/schema",
-  $id: "manni:citations:1.0.0-proposal.3",
-  title: "manni citations vocabulary (1.0.0-proposal.3)",
+  $id: "manni:citations:1.0.0-proposal.4",
+  title: "manni citations vocabulary (1.0.0-proposal.4)",
   description: "What do this page's claims rest on? For each claim, the page lines that make it, the source lines it was written from, and a hash of each. A manni common vocabulary: any drift check can implement it, and other schemas may compose on top of it. A pin is a record of the past, not a copy of the present. It says what the lines were when the sentence was written. The check compares that record with the files as they are now. Recompute it on every run and there is nothing to compare against. `source-of-truth` (manni:stewardship) names the file a page answers to; a citation names the lines a sentence answers to. The page root stays open so sibling tools' keys pass untouched. The `citation-` prefix is reserved, so an unrecognized `citation-*` key is rejected and a typo fails loudly.",
   type: "object",
   additionalProperties: true,
@@ -1207,7 +1135,8 @@ var citations_default = {
       items: {
         $ref: "#/$defs/citationEntry"
       },
-      description: "The page's citations, one entry per claim or pin. An empty list is not a declaration; a page with no citations omits the key. Ids are unique within a page, and two entries claiming one id is an error. JSON Schema cannot say that over a list whose members may omit the id. So it is a requirement on implementations, stated here so every tool agrees."
+      description: "The page's citations, one entry per claim or pin. An empty list is not a declaration; a page with no citations omits the key. Ids are unique within a page, and two entries claiming one id is an error. JSON Schema cannot say that over a list whose members may omit the id. So it is a requirement on implementations, stated here so every tool agrees.",
+      "x-manni-location": "external"
     }
   },
   patternProperties: {
@@ -1308,326 +1237,6 @@ var citations_default = {
   }
 };
 
-// src/meta/core/external-metadata-write.ts
-import { posix } from "node:path";
-import {
-  LineCounter,
-  isMap,
-  isNode,
-  isPair,
-  isScalar,
-  isSeq,
-  parseDocument,
-  stringify
-} from "yaml";
-function spliceManifestValue(text, options) {
-  const { entry, key, value, file } = options;
-  const join4 = options.join ?? PATH_JOIN;
-  const at2 = (line2) => {
-    const name = file === void 0 ? "Manifest" : `Manifest ${file}`;
-    if (line2 === void 0) return name;
-    return file === void 0 ? `${name} line ${String(line2)}` : `${name}:${String(line2)}`;
-  };
-  if (key === FILE_SCHEMA_KEY) {
-    throw new DocmetaError(
-      `${at2()}: refusing to write "${FILE_SCHEMA_KEY}" for "${entry}"; a manifest never chooses the schema a document is judged by. Use "overrides" in the config.`
-    );
-  }
-  if (value === void 0) {
-    throw new DocmetaError(`${at2()}: refusing to write "${key}" for "${entry}" with no value.`);
-  }
-  const eol = detectEol2(text);
-  const lc = new LineCounter();
-  const doc = parseDocument(text, { lineCounter: lc, uniqueKeys: false });
-  const problem = doc.errors[0];
-  if (problem) {
-    throw new DocmetaError(`${at2()} is not valid YAML: ${problem.message}`);
-  }
-  const keyLine = (node) => {
-    const r = rangeOf(node);
-    return r ? lc.linePos(r[0]).line : void 0;
-  };
-  const same = join4 === PATH_JOIN ? (a, b) => posix.normalize(a) === posix.normalize(b) : (a, b) => a === b;
-  const root = doc.contents;
-  let spelled = entry;
-  let edit;
-  if (root === null || isScalar(root) && root.value === null && emptySource(text, root)) {
-    edit = startManifest(text, entry, key, value, eol);
-  } else if (!isMap(root)) {
-    throw new DocmetaError(
-      `${at2()}: the manifest must be a mapping from document ${join4 === PATH_JOIN ? "path" : `"${join4}"`} to owned keys.`
-    );
-  } else {
-    const style = detectStyle(text, root, eol);
-    const matches = root.items.filter((p) => same(keyString(p.key), entry));
-    const [first, second] = matches;
-    if (first && second) {
-      throw new DocmetaError(
-        `${at2(keyLine(second.key))}: "${keyString(second.key)}" is named twice (first at line ${String(keyLine(first.key) ?? "?")}). Merge the two entries into one.`
-      );
-    }
-    if (first === void 0) {
-      if (root.flow === true && root.items.length > 0) {
-        throw new DocmetaError(
-          `${at2()}: the manifest is a flow mapping ({ \u2026 }), which this writer does not add entries to. Rewrite it in block style.`
-        );
-      }
-      edit = appendEntry(text, root, entry, key, value, style);
-    } else {
-      spelled = keyString(first.key);
-      const where = at2(keyLine(first.key));
-      const v = first.value;
-      if (!isMap(v)) {
-        throw new DocmetaError(`${where}: "${spelled}" must be a mapping of owned keys to values.`);
-      }
-      const hits = v.items.filter((kv) => keyString(kv.key) === key);
-      const [hit, again] = hits;
-      if (hit && again) {
-        throw new DocmetaError(
-          `${at2(keyLine(again.key))}: "${spelled}" sets "${key}" twice (first at line ${String(keyLine(hit.key) ?? "?")}). Remove one.`
-        );
-      }
-      const flowRefusal = () => new DocmetaError(
-        `${where}: "${spelled}" is a flow mapping ({ \u2026 }), which this writer does not add keys to. Rewrite the entry in block style.`
-      );
-      const formRefusal = () => new DocmetaError(
-        `${where}: "${spelled}" writes a key in a form this writer does not edit. Write it as "${key}: \u2026".`
-      );
-      let made;
-      if (v.flow === true) {
-        if (hit) made = replaceFlowValue(text, hit, value);
-        else if (v.items.length === 0) made = fillEmptyEntry(text, first, key, value, style);
-        else throw flowRefusal();
-        if (!made) throw hit ? flowRefusal() : formRefusal();
-      } else {
-        made = hit ? replaceBlockValue(text, hit, value, style) : insertKey(text, v, key, value, style);
-        if (!made) throw formRefusal();
-      }
-      edit = made;
-    }
-  }
-  const out = text.slice(0, edit.start) + edit.insert + text.slice(edit.end);
-  const line = readBack(
-    doc,
-    out,
-    spelled,
-    key,
-    value,
-    (why) => new DocmetaError(
-      `${at2()}: writing "${key}" for "${entry}" did not read back as written, so nothing was written. ${why}`
-    )
-  );
-  return { text: out, line };
-}
-function startManifest(text, entry, key, value, eol) {
-  const style = { step: 2, indentSeq: true, eol };
-  const block = blockLines({ [entry]: { [key]: value } }, 0, style);
-  let insert;
-  if (text === "" || text.endsWith("\n")) insert = block + eol;
-  else insert = eol + block;
-  return { start: text.length, end: text.length, insert };
-}
-function appendEntry(text, root, entry, key, value, style) {
-  const body = { [entry]: { [key]: value } };
-  if (root.flow === true) {
-    const r = rangeOf(root);
-    const start = r ? r[0] : text.length;
-    const end = contentEnd(text, root) ?? start;
-    return { start, end, insert: blockLines(body, colOf(text, start), style) };
-  }
-  const firstKey = rangeOf(root.items[0]?.key);
-  const col = firstKey ? colOf(text, firstKey[0]) : 0;
-  const pos = lineEnd2(text, contentEnd(text, root) ?? text.length);
-  const last = root.items.at(-1);
-  const spaced = root.items.length > 1 && isNode(last?.key) && last.key.spaceBefore === true;
-  return {
-    start: pos,
-    end: pos,
-    insert: style.eol + (spaced ? style.eol : "") + blockLines(body, col, style)
-  };
-}
-function insertKey(text, entryMap, key, value, style) {
-  const firstKey = rangeOf(entryMap.items[0]?.key);
-  const end = contentEnd(text, entryMap);
-  if (!firstKey || end === void 0) return void 0;
-  const pos = lineEnd2(text, end);
-  return {
-    start: pos,
-    end: pos,
-    insert: style.eol + blockLines({ [key]: value }, colOf(text, firstKey[0]), style)
-  };
-}
-function fillEmptyEntry(text, entryPair, key, value, style) {
-  const start = colonEnd(text, entryPair);
-  const keyRange = rangeOf(entryPair.key);
-  const end = contentEnd(text, entryPair.value);
-  if (start === void 0 || !keyRange || end === void 0) return void 0;
-  const col = colOf(text, keyRange[0]) + style.step;
-  return { start, end, insert: style.eol + blockLines({ [key]: value }, col, style) };
-}
-function replaceBlockValue(text, pair, value, style) {
-  const colon = colonEnd(text, pair);
-  const keyRange = rangeOf(pair.key);
-  if (colon === void 0 || !keyRange) return void 0;
-  const keyCol = colOf(text, keyRange[0]);
-  let start = colon;
-  let ownLine = false;
-  let i = colon;
-  while (text.charAt(i) === " " || text.charAt(i) === "	") i++;
-  if (text.charAt(i) === "#") {
-    start = lineEnd2(text, i);
-    ownLine = true;
-  }
-  const old = pair.value;
-  const oldEnd = isScalar(old) && old.value === null && emptySource(text, old) ? start : contentEnd(text, old) ?? start;
-  const end = Math.max(start, oldEnd);
-  let insert = afterColon(value, keyCol, style);
-  if (ownLine && !insert.startsWith(style.eol)) {
-    insert = style.eol + " ".repeat(keyCol + style.step) + insert.trimStart();
-  }
-  return { start, end, insert };
-}
-function replaceFlowValue(text, pair, value) {
-  const r = rangeOf(pair.value);
-  if (!r || emptySource(text, pair.value)) return void 0;
-  const end = contentEnd(text, pair.value) ?? r[1];
-  return { start: r[0], end, insert: flowText(value) };
-}
-function readBack(before, out, spelled, key, value, fail) {
-  const lc = new LineCounter();
-  const after = parseDocument(out, { lineCounter: lc, uniqueKeys: false });
-  const problem = after.errors[0];
-  if (problem) throw fail(`The result is not valid YAML: ${problem.message}`);
-  const was = before.toJS({ maxAliasCount: 100 });
-  const now = after.toJS({ maxAliasCount: 100 });
-  const wasRoot = isRecord(was) ? was : {};
-  const wasEntry = wasRoot[spelled];
-  const expected = {
-    ...wasRoot,
-    [spelled]: { ...isRecord(wasEntry) ? wasEntry : {}, [key]: value }
-  };
-  const nowEntry = isRecord(now) ? now[spelled] : void 0;
-  if (!isRecord(nowEntry) || !deepEqual(nowEntry[key], value)) {
-    throw fail(
-      "The value reads back differently. A Date, an undefined member, or another value YAML cannot hold does not survive the trip."
-    );
-  }
-  if (!deepEqual(now, expected)) {
-    throw fail("Another value in the manifest would have changed.");
-  }
-  const root = after.contents;
-  const pair = isMap(root) ? root.items.find((p) => keyString(p.key) === spelled) : void 0;
-  const entryMap = pair?.value;
-  const kv = isMap(entryMap) ? entryMap.items.find((p) => keyString(p.key) === key) : void 0;
-  const r = rangeOf(kv?.value) ?? rangeOf(kv?.key);
-  if (!r) throw fail("The written value could not be found again.");
-  return lc.linePos(r[0]).line;
-}
-function blockLines(pair, col, style) {
-  const s = stringify(pair, { lineWidth: 0, indent: style.step, indentSeq: style.indentSeq });
-  return indentLines(s.replace(/\n$/, "").split("\n"), col, 0).join(style.eol);
-}
-function afterColon(value, col, style) {
-  const s = stringify({ k: value }, { lineWidth: 0, indent: style.step, indentSeq: style.indentSeq });
-  const lines = s.replace(/\n$/, "").slice("k:".length).split("\n");
-  return indentLines(lines, col, 1).join(style.eol);
-}
-function indentLines(lines, col, from) {
-  const pad = " ".repeat(col);
-  return lines.map((l, i) => i < from || l === "" ? l : pad + l);
-}
-function flowText(value) {
-  const s = stringify(value, { lineWidth: 0, collectionStyle: "flow" }).replace(/\n$/, "");
-  return s.includes("\n") ? JSON.stringify(value) : s;
-}
-function detectEol2(text) {
-  const i = text.indexOf("\n");
-  return i > 0 && text.charAt(i - 1) === "\r" ? "\r\n" : "\n";
-}
-function detectStyle(text, root, eol) {
-  let step = 2;
-  for (const pair of root.items) {
-    const v = pair.value;
-    const entryKey = rangeOf(pair.key);
-    const ownedKey = isMap(v) && v.flow !== true ? rangeOf(v.items[0]?.key) : void 0;
-    if (entryKey && ownedKey) {
-      const d = colOf(text, ownedKey[0]) - colOf(text, entryKey[0]);
-      if (d > 0) {
-        step = d;
-        break;
-      }
-    }
-  }
-  return { step, indentSeq: seqIndented(text, root) ?? true, eol };
-}
-function seqIndented(text, node) {
-  if (isMap(node)) {
-    for (const pair of node.items) {
-      const v = pair.value;
-      if (isSeq(v) && v.flow !== true && v.items.length > 0) {
-        const k = rangeOf(pair.key);
-        const s = rangeOf(v);
-        if (k && s) return colOf(text, s[0]) > colOf(text, k[0]);
-      }
-      const inner = seqIndented(text, v);
-      if (inner !== void 0) return inner;
-    }
-  } else if (isSeq(node)) {
-    for (const item of node.items) {
-      const inner = seqIndented(text, item);
-      if (inner !== void 0) return inner;
-    }
-  }
-  return void 0;
-}
-function contentEnd(text, node) {
-  if (isMap(node) && node.flow !== true) {
-    const last = node.items.at(-1);
-    if (last) return contentEnd(text, last.value) ?? contentEnd(text, last.key);
-  } else if (isSeq(node) && node.flow !== true) {
-    const last = node.items.at(-1);
-    if (last !== void 0) {
-      return isPair(last) ? contentEnd(text, last.value) ?? contentEnd(text, last.key) : contentEnd(text, last);
-    }
-  }
-  const r = rangeOf(node);
-  if (!r) return void 0;
-  let end = r[1];
-  while (end > r[0] && /\s/.test(text.charAt(end - 1))) end--;
-  return end;
-}
-function colonEnd(text, pair) {
-  const r = rangeOf(pair.key);
-  if (!r) return void 0;
-  let i = r[1];
-  while (text.charAt(i) === " " || text.charAt(i) === "	") i++;
-  return text.charAt(i) === ":" ? i + 1 : void 0;
-}
-function lineEnd2(text, i) {
-  const j = text.indexOf("\n", i);
-  if (j < 0) return text.length;
-  return j > 0 && text.charAt(j - 1) === "\r" ? j - 1 : j;
-}
-function colOf(text, offset) {
-  if (offset === 0) return 0;
-  let start = text.lastIndexOf("\n", offset - 1) + 1;
-  if (start === 0 && text.startsWith("\uFEFF")) start = 1;
-  return offset - start;
-}
-function rangeOf(node) {
-  return isNode(node) ? node.range ?? void 0 : void 0;
-}
-function emptySource(text, node) {
-  const r = rangeOf(node);
-  return !r || text.slice(r[0], r[1]).trim() === "";
-}
-function keyString(key) {
-  return isScalar(key) ? String(key.value) : String(key);
-}
-function isRecord(x) {
-  return typeof x === "object" && x !== null && !Array.isArray(x);
-}
-
 // src/cite/core/page.ts
 var MAX_MARKERS_PER_PAGE = 500;
 var ELEMENT_BACKED = /* @__PURE__ */ new Set(["html", "xml"]);
@@ -1653,11 +1262,11 @@ function validateEntry(entry) {
   if (!first) return "invalid entry";
   return `${first.instancePath} ${first.message ?? "is invalid"}`.trim();
 }
-function isRecord2(value) {
+function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function toCitation(entry) {
-  const source = isRecord2(entry.source) ? entry.source : {};
+  const source = isRecord(entry.source) ? entry.source : {};
   const citation = {
     source: {
       file: String(source.file),
@@ -1671,7 +1280,7 @@ function toCitation(entry) {
     citation.source["commit-sha"] = source["commit-sha"];
   }
   if (typeof entry.id === "string") citation.id = entry.id;
-  if (isRecord2(entry.claim)) {
+  if (isRecord(entry.claim)) {
     const claim = entry.claim;
     citation.claim = { integrity: String(claim.integrity) };
     if (typeof claim.lines === "number" || typeof claim.lines === "string") {
@@ -1703,9 +1312,9 @@ function named(id, text) {
 }
 function subjectOf(entry) {
   const out = {};
-  if (!isRecord2(entry)) return out;
+  if (!isRecord(entry)) return out;
   if (typeof entry.id === "string") out.id = entry.id;
-  if (isRecord2(entry.source) && typeof entry.source.file === "string") out.src = entry.source.file;
+  if (isRecord(entry.source) && typeof entry.source.file === "string") out.src = entry.source.file;
   return out;
 }
 function pickExtractor(file, format) {
@@ -1786,7 +1395,7 @@ function readPage(file, content, opts) {
     if (origin.kind === "manifest") where.file = origin.file;
     const entry = input.entry;
     const error = validateEntry(entry);
-    if (error !== void 0 || !isRecord2(entry)) {
+    if (error !== void 0 || !isRecord(entry)) {
       findings.push(finding("entry-invalid", error ?? "must be object", { ...where, ...subjectOf(entry) }));
       return;
     }
@@ -2046,8 +1655,8 @@ function sidecarsFor(run3, over = {}) {
 
 // src/cite/core/manifest.ts
 import { readFile as readFile2 } from "node:fs/promises";
-import { posix as posix2 } from "node:path";
-import { LineCounter as LineCounter2, isMap as isMap2, isNode as isNode2, isScalar as isScalar2, isSeq as isSeq2, parseDocument as parseDocument2 } from "yaml";
+import { posix } from "node:path";
+import { LineCounter, isMap, isNode, isScalar, isSeq, parseDocument } from "yaml";
 
 // src/cite/core/write.ts
 function extractorFor(format) {
@@ -2159,12 +1768,12 @@ function spliceEntryField(content, format, index, path, value) {
   const out = content.slice(0, start) + parts.lead + spelled + parts.trail + content.slice(end);
   const check = extractor.extract(out, "page").data.citations;
   const entry = Array.isArray(check) ? check[index] : void 0;
-  const block = isRecord3(entry) ? entry[which] : void 0;
-  const readBack2 = isRecord3(block) ? block[field] : void 0;
-  if (readBack2 !== value) throw refuse();
+  const block = isRecord2(entry) ? entry[which] : void 0;
+  const readBack = isRecord2(block) ? block[field] : void 0;
+  if (readBack !== value) throw refuse();
   return out;
 }
-function isRecord3(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function insertStatementBefore(content, offset, statement) {
@@ -2290,25 +1899,25 @@ function splice(text, options) {
   }
 }
 function itemLine(text, entry, index, join4) {
-  const lc = new LineCounter2();
-  const doc = parseDocument2(text, { lineCounter: lc, uniqueKeys: false });
+  const lc = new LineCounter();
+  const doc = parseDocument(text, { lineCounter: lc, uniqueKeys: false });
   if (doc.errors.length > 0) return void 0;
   const root = doc.contents;
-  if (!isMap2(root)) return void 0;
+  if (!isMap(root)) return void 0;
   const same = (key) => {
-    const spelled = isScalar2(key) ? String(key.value) : String(key);
-    return join4 === "path" ? posix2.normalize(spelled) === posix2.normalize(entry) : spelled === entry;
+    const spelled = isScalar(key) ? String(key.value) : String(key);
+    return join4 === "path" ? posix.normalize(spelled) === posix.normalize(entry) : spelled === entry;
   };
   const pair = root.items.find((p) => same(p.key));
   const value = pair?.value;
-  if (!isMap2(value)) return void 0;
+  if (!isMap(value)) return void 0;
   const kv = value.items.find(
-    (p) => (isScalar2(p.key) ? String(p.key.value) : String(p.key)) === CITATIONS_KEY2
+    (p) => (isScalar(p.key) ? String(p.key.value) : String(p.key)) === CITATIONS_KEY2
   );
   const list = kv?.value;
-  if (!isSeq2(list)) return void 0;
+  if (!isSeq(list)) return void 0;
   const item = list.items[index];
-  const range = isNode2(item) ? item.range : void 0;
+  const range = isNode(item) ? item.range : void 0;
   return range ? lc.linePos(range[0]).line : void 0;
 }
 
@@ -2509,7 +2118,7 @@ async function citedNow(input, source, entry) {
   if (read.kind === "missing") return void 0;
   const at2 = source.status === "moved" && source.newSrc !== void 0 ? parseSrc(source.newSrc) : range;
   try {
-    return sliceLines(splitLines(read.text), at2);
+    return sliceLines2(splitLines(read.text), at2);
   } catch {
     return void 0;
   }
@@ -2713,7 +2322,7 @@ async function mintCitation(opts) {
   const index = opts.sourceIndex ?? await buildSourceIndex(opts.root, { gitClient: opts.gitClient });
   const read = await readSource(opts.root, index, range, key);
   if (read.kind === "missing") throw refusalFor(read.reason, range.path, range.encrypted);
-  const joined = sliceLines(splitLines(read.text), range, range.path);
+  const joined = sliceLines2(splitLines(read.text), range, range.path);
   const pinKey = encrypt ? key : void 0;
   const file = pinKey !== void 0 && !range.encrypted ? encryptSourcePath(read.resolvedPath, pinKey) : range.path;
   const lines = rangeLines(range);
@@ -3137,7 +2746,7 @@ async function citedText(root, index, src, key) {
   if (source.kind === "missing") {
     throw new CiteError(`Source not readable: ${range.path} could not be read.`);
   }
-  return sliceLines(splitLines(source.text), range, range.path);
+  return sliceLines2(splitLines(source.text), range, range.path);
 }
 async function runAdd(opts) {
   const cwd = resolve4(opts.cwd ?? process.cwd());
@@ -3376,12 +2985,12 @@ function apply(content, format, plan) {
     }
   }
 }
-function isRecord4(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function applyToEntry(entry, plan) {
-  if (!isRecord4(entry)) return false;
-  const end = (name) => isRecord4(entry[name]) ? entry[name] : void 0;
+  if (!isRecord3(entry)) return false;
+  const end = (name) => isRecord3(entry[name]) ? entry[name] : void 0;
   switch (plan.kind) {
     case "claim-moved": {
       const claim = end("claim");
@@ -3622,7 +3231,7 @@ async function pinnedLines(ctx, citation, range, path, key) {
   const pin = citation.source.integrity;
   let joined;
   try {
-    joined = sliceLines(splitLines(source.text), range);
+    joined = sliceLines2(splitLines(source.text), range);
   } catch {
     joined = void 0;
   }
@@ -4472,6 +4081,7 @@ export {
   meetsSeverity,
   reencryptMetadata,
   CiteError,
+  asCiteError,
   spellSource,
   runAdd,
   runCheck,
@@ -4489,4 +4099,4 @@ export {
   runKeyRotate,
   runKeySet
 };
-//# sourceMappingURL=chunk-QLVNSAHR.js.map
+//# sourceMappingURL=chunk-6JWX6JM2.js.map