@hawkeyexl/manni 2.3.9 → 2.4.0

package/dist/{chunk-YSI2VNKE.js → chunk-P4KR3XFD.js}

@@ -55,6 +55,7 @@ import {
   pinOfLines,
   readConfigFile,
   readFamilyConfigFile,
+  removeManifestKey,
   resolveBaselineRequest,
   resolveEncryptionKey,
   resolveTargetSet,
@@ -70,7 +71,7 @@ import {
   withValueAt,
   writeEncryptionKey,
   writeFileAtomic
-} from "./chunk-LC4H35XX.js";
+} from "./chunk-LYLNOJ32.js";
 
 // src/meta/core/reencrypt.ts
 import { extname } from "node:path";
@@ -196,6 +197,7 @@ __export(cite_exports, {
   bodyLineOf: () => bodyLineOf,
   buildSourceIndex: () => buildSourceIndex,
   checkCitations: () => checkCitations,
+  citationInputs: () => citationInputs,
   claimEnd: () => claimEnd,
   claimLine: () => claimLine,
   claimMessageFor: () => claimMessageFor,
@@ -247,9 +249,14 @@ __export(cite_exports, {
   readSource: () => readSource,
   reencryptCitationEntries: () => reencryptCitationEntries,
   reencryptCitations: () => reencryptCitations,
+  removalLine: () => removalLine,
+  removeFrontmatterCitations: () => removeFrontmatterCitations,
+  removeLine: () => removeLine,
   renderCheckGithub: () => renderCheckGithub,
   renderCheckJson: () => renderCheckJson,
   renderCheckPretty: () => renderCheckPretty,
+  renderRemoveJson: () => renderRemoveJson,
+  renderRemovePretty: () => renderRemovePretty,
   renderUpdateJson: () => renderUpdateJson,
   renderUpdatePretty: () => renderUpdatePretty,
   resolveCiteRun: () => resolveCiteRun,
@@ -258,13 +265,17 @@ __export(cite_exports, {
   ruleId: () => ruleId,
   runAdd: () => runAdd,
   runCheck: () => runCheck,
+  runRemove: () => runRemove,
   runUpdate: () => runUpdate,
+  shiftedEntries: () => shiftedEntries,
   shortCommit: () => shortCommit,
+  shortLine: () => shortLine,
   shortPin: () => shortPin,
   shortSrc: () => shortSrc,
   sidecarsFor: () => sidecarsFor,
   sliceLines: () => sliceLines2,
   sourceRange: () => sourceRange,
+  spellAt: () => spellAt,
   spellLines: () => spellLines,
   spellSource: () => spellSource,
   splice: () => splice,
@@ -278,7 +289,8 @@ __export(cite_exports, {
   unifiedDiff: () => unifiedDiff,
   unitAt: () => unitAt,
   urlManifestRefusal: () => urlManifestRefusal,
-  validateEntry: () => validateEntry
+  validateEntry: () => validateEntry,
+  withClaimLines: () => withClaimLines
 });
 
 // src/cite/types.ts
@@ -420,6 +432,11 @@ function shortSrc(src) {
   const lines = colon === -1 ? "" : src.slice(colon);
   return token.length <= 5 ? src : `${token.slice(0, 5)}\u2026${lines}`;
 }
+var LINE_WIDTH = 60;
+function shortLine(text) {
+  const one = text.replace(/\s+/g, " ").trim();
+  return one.length <= LINE_WIDTH ? one : `${one.slice(0, LINE_WIDTH)}\u2026`;
+}
 
 // src/cite/core/sources.ts
 import fg from "fast-glob";
@@ -1050,7 +1067,7 @@ var MAX_BUFFER = 32 * 1024 * 1024;
 var NO_COMMIT = /invalid object name|bad revision|unknown revision|bad object/i;
 var NO_PATH = /does not exist in|exists on disk, but not in|path .* does not exist/i;
 function run2(root, args) {
-  return new Promise((resolve8) => {
+  return new Promise((resolve9) => {
     execFile(
       "git",
       ["-c", "core.quotepath=false", ...args],
@@ -1059,8 +1076,8 @@ function run2(root, args) {
         if (error) {
           const failure = { ok: false, stderr, message: error.message };
           if (typeof error.code === "number") failure.code = error.code;
-          resolve8(failure);
-        } else resolve8({ ok: true, stdout });
+          resolve9(failure);
+        } else resolve9({ ok: true, stdout });
       }
     );
   });
@@ -1451,6 +1468,17 @@ function bodyLineOf(content, bodyOffset) {
   const line = lineAt(content, bodyOffset);
   return content.charCodeAt(bodyOffset - 1) === 10 ? line : line + 1;
 }
+function citationInputs(file, extracted, injected) {
+  if (injected !== void 0) return [...injected];
+  const raw = extracted.data.citations;
+  const list = Array.isArray(raw) ? raw : [];
+  return list.map((entry, index) => {
+    const origin = { kind: "frontmatter", file };
+    const line = extracted.lineFor(`/citations/${String(index)}`);
+    if (line !== void 0) origin.line = line;
+    return { entry, origin };
+  });
+}
 function readPage(file, content, opts) {
   const extractor = pickExtractor(file, opts?.format);
   const format = extractor.name;
@@ -1494,12 +1522,7 @@ function readPage(file, content, opts) {
       })
     );
   }
-  const inputs = injected !== void 0 ? [...injected] : (Array.isArray(rawCitations) ? rawCitations : []).map((entry, index) => {
-    const origin = { kind: "frontmatter", file };
-    const line = extracted.lineFor(`/citations/${String(index)}`);
-    if (line !== void 0) origin.line = line;
-    return { entry, origin };
-  });
+  const inputs = citationInputs(file, extracted, injected);
   inputs.forEach((input, index) => {
     const origin = { ...input.origin, index };
     const where = { index };
@@ -1655,6 +1678,45 @@ function readPage(file, content, opts) {
   };
 }
 
+// src/cite/core/shift.ts
+function spellAt(lines) {
+  return lines.start === lines.end ? `line ${String(lines.start)}` : `lines ${String(lines.start)}-${String(lines.end)}`;
+}
+function shiftedEntries(opts) {
+  const { citations, at: at2, delta, bodyLine, label } = opts;
+  const out = { frontmatter: [], manifest: /* @__PURE__ */ new Map() };
+  if (at2.length === 0) return out;
+  for (const { citation, origin } of citations) {
+    const spec = citation.claim?.lines;
+    const recorded = spec === void 0 ? void 0 : parseLines(spec);
+    if (recorded === void 0) continue;
+    const file = toFileLines(recorded, bodyLine);
+    const inside = at2.find(
+      (line) => delta === 1 ? line > file.start && line <= file.end : line >= file.start && line <= file.end
+    );
+    if (inside !== void 0) {
+      const whose = citation.id === void 0 ? `the claim at ${spellAt(file)}` : `the claim of ${citation.id} (${spellAt(file)})`;
+      const why = delta === 1 ? "A marker there would change its pin." : "Removing the marker there would change its pin.";
+      throw new CiteError(`${label}:${String(inside)} is inside ${whose}. ${why}`);
+    }
+    const lines = at2.filter((line) => delta === 1 ? line <= file.start : line < file.start).length;
+    if (lines === 0) continue;
+    const moved = lineSpec({
+      start: recorded.start + lines * delta,
+      end: recorded.end + lines * delta
+    });
+    if (origin.kind === "manifest") out.manifest.set(origin.index, moved);
+    else out.frontmatter.push({ index: origin.index, lines: moved });
+  }
+  return out;
+}
+function withClaimLines(entry, lines) {
+  if (typeof entry !== "object" || entry === null || Array.isArray(entry)) return entry;
+  const claim = entry.claim;
+  if (typeof claim !== "object" || claim === null || Array.isArray(claim)) return entry;
+  return { ...entry, claim: { ...claim, lines } };
+}
+
 // src/cite/core/sidecar.ts
 import { isAbsolute, relative, resolve, sep as sep2 } from "node:path";
 var CITATIONS_KEY2 = "citations";
@@ -1816,6 +1878,42 @@ function appendFrontmatterCitation(content, format, citation, filePath) {
     throw e;
   }
 }
+function removeFrontmatterCitations(content, format, drop, filePath) {
+  const label = filePath ?? "the page";
+  const extractor = extractorFor(format);
+  if (!extractor.apply || !readsFencedFrontmatter(extractor, label)) {
+    throw new CiteError(
+      `${label} has no frontmatter to write to; keep its citations in a manifest instead.`
+    );
+  }
+  if (locateFrontmatter(content)?.flavor === "toml") {
+    throw new CiteError(
+      `${label} has TOML frontmatter; manni cannot rewrite a citations table without re-emitting the whole block, which would drop its comments. Remove the entry by hand.`
+    );
+  }
+  const raw = extractor.extract(content, label).data.citations ?? [];
+  if (!Array.isArray(raw)) {
+    throw new CiteError(`${label}: \`citations\` is not a list; edit it by hand.`);
+  }
+  const existing = raw;
+  const kept = existing.filter((_entry, index) => !drop.has(index));
+  try {
+    return kept.length === 0 ? extractor.apply(content, {}, { deletions: ["citations"] }) : extractor.apply(content, { citations: kept });
+  } catch (e) {
+    if (e instanceof DocmetaError) throw new CiteError(`${label}: ${e.message}`);
+    throw e;
+  }
+}
+function removeLine(content, line) {
+  const start = offsetOfLine(content, line);
+  const nl = content.indexOf("\n", start);
+  if (nl === -1) {
+    let above = start > 0 ? content.lastIndexOf("\n", start - 1) : -1;
+    if (above > 0 && content.charAt(above - 1) === "\r") above--;
+    return content.slice(0, above === -1 ? 0 : above);
+  }
+  return content.slice(0, start) + content.slice(nl + 1);
+}
 function entryObject(citation) {
   const source = { file: citation.source.file };
   if (citation.source.lines !== void 0) source.lines = citation.source.lines;
@@ -2007,6 +2105,25 @@ var ManifestSet = class {
     held.text = spliced.text;
     return { file: manifest.file, line: itemLine(spliced.text, entry, index, manifest.join) ?? spliced.line };
   }
+  /**
+   * Take a page's `citations` key out of the manifest, for the removal that
+   * leaves it with no entries. The entry itself goes when that key was all it
+   * had, so a manifest never keeps a document nothing is recorded about.
+   */
+  async remove(manifest, entry) {
+    const held = await this.hold(manifest);
+    try {
+      held.text = removeManifestKey(held.text, {
+        entry,
+        key: CITATIONS_KEY2,
+        join: manifest.join,
+        file: manifest.file
+      }).text;
+    } catch (error) {
+      if (error instanceof DocmetaError) throw new CiteError(error.message);
+      throw error;
+    }
+  }
   /** The manifests this run rewrote, with the diff of each. */
   changed() {
     return [...this.held.values()].filter((m) => m.text !== m.before).map((m) => ({ ...m, diff: unifiedDiff(m.file, m.before, m.text) }));
@@ -2623,7 +2740,9 @@ async function resolveCiteRun(opts) {
       root = gitRoot;
     } else {
       root = cwd;
-      opts.onNotice?.(`No git root found; resolving src: paths from ${cwd}`);
+      if (opts.resolvesSources !== false) {
+        opts.onNotice?.(`No git root found; resolving src: paths from ${cwd}`);
+      }
     }
   }
   const { key, source: keySource } = resolveEncryptionKey({
@@ -2672,7 +2791,8 @@ function joinHits() {
     }
   };
 }
-async function prepareRun(opts, action, verb, requireSources = false) {
+async function prepareRun(opts, action, verb, sources = {}) {
+  const requireSources = sources.require === true;
   const cwd = resolve3(opts.cwd ?? process.cwd());
   const run3 = await resolveCiteRun({
     cwd,
@@ -2683,7 +2803,8 @@ async function prepareRun(opts, action, verb, requireSources = false) {
     root: opts.root,
     onConfigLoaded: opts.onConfigLoaded,
     onNotice: opts.onNotice,
-    env: opts.env
+    env: opts.env,
+    ...sources.resolve === false ? { resolvesSources: false } : {}
   });
   const { config, inputs, base } = run3;
   const checkSources = opts.checkSources ?? config?.checkSources ?? true;
@@ -2863,34 +2984,49 @@ async function citedText(root, index, src, key) {
   }
   return sliceLines2(splitLines(source.text), range, range.path);
 }
-function spellAt(lines) {
-  return lines.start === lines.end ? `line ${String(lines.start)}` : `lines ${String(lines.start)}-${String(lines.end)}`;
+function entryName(entry) {
+  return entry.citation.id ?? `/citations/${String(entry.origin.index)}`;
 }
-function shiftedEntries(citations, insertLine, bodyLine, label) {
-  const out = { frontmatter: [], manifest: /* @__PURE__ */ new Map() };
-  for (const { citation, origin } of citations) {
+function duplicateOf(page, src, pageLines) {
+  const wanted = formatSrc(parseSrc(src));
+  return page.citations.find((entry) => {
+    const { citation } = entry;
+    if (spellSource(citation.source) !== wanted) return false;
+    if (pageLines === void 0) return citation.claim === void 0;
     const spec = citation.claim?.lines;
-    const recorded = spec === void 0 ? void 0 : parseLines(spec);
-    if (recorded === void 0) continue;
-    const file = toFileLines(recorded, bodyLine);
-    if (file.start < insertLine) {
-      if (file.end < insertLine) continue;
-      const whose = citation.id === void 0 ? `the claim at ${spellAt(file)}` : `the claim of ${citation.id} (${spellAt(file)})`;
-      throw new CiteError(
-        `${label}:${String(insertLine)} is inside ${whose}. A marker there would change its pin.`
-      );
-    }
-    const moved = lineSpec({ start: recorded.start + 1, end: recorded.end + 1 });
-    if (origin.kind === "manifest") out.manifest.set(origin.index, moved);
-    else out.frontmatter.push({ index: origin.index, lines: moved });
-  }
-  return out;
+    if (spec === void 0) return false;
+    const recorded = parseLines(spec);
+    if (recorded === void 0) return false;
+    const file = toFileLines(recorded, page.bodyLine);
+    return file.start === pageLines.start && file.end === pageLines.end;
+  });
 }
-function withClaimLines(entry, lines) {
-  if (typeof entry !== "object" || entry === null || Array.isArray(entry)) return entry;
-  const claim = entry.claim;
-  if (typeof claim !== "object" || claim === null || Array.isArray(claim)) return entry;
-  return { ...entry, claim: { ...claim, lines } };
+function holdsNoText(text) {
+  return text.trim() === "" || ANY_FENCE.test(text);
+}
+function emptyClaimRefusal(lines, pageLines, at2) {
+  const span = lines.slice(pageLines.start - 1, pageLines.end);
+  if (span.some((text) => !holdsNoText(text))) return void 0;
+  if (pageLines.start !== pageLines.end) return `${at2} holds no claim text.`;
+  const only = span[0] ?? "";
+  return only.trim() === "" ? `${at2} is blank.` : `${at2} is a fence line, not claim text.`;
+}
+function otherClaimSpans(lines, pageLines, pin, bodyLine) {
+  const width = pageLines.end - pageLines.start + 1;
+  const found = findWindows(lines.slice(bodyLine - 1), width, pin, void 0, {
+    around: toBodyLines(pageLines, bodyLine).start
+  });
+  return found.starts.map((start) => toFileLines({ start, end: start + width - 1 }, bodyLine)).filter((span) => span.start !== pageLines.start);
+}
+var NAMED_SPANS = 3;
+function spellElsewhere(spans) {
+  const first = spans[0];
+  const noun = spans.length === 1 && first !== void 0 && first.start === first.end ? "line" : "lines";
+  const named3 = spans.slice(0, NAMED_SPANS).map((span) => spellLines(span));
+  const rest = spans.length - named3.length;
+  if (rest > 0) return `${noun} ${named3.join(", ")} and ${String(rest)} more`;
+  const last = named3.pop() ?? "";
+  return named3.length === 0 ? `${noun} ${last}` : `${noun} ${named3.join(", ")} and ${last}`;
 }
 async function runAdd(opts) {
   const cwd = resolve4(opts.cwd ?? process.cwd());
@@ -2964,6 +3100,12 @@ async function runAdd(opts) {
       );
     }
   }
+  const duplicate = marker ? void 0 : duplicateOf(page, opts.src, pageLines);
+  if (duplicate !== void 0) {
+    const src = shortSrc(spellSource(duplicate.citation.source));
+    const what = pageLines === void 0 ? `a bare pin for ${src}` : `an entry for ${spellAt(pageLines)} and ${src}`;
+    throw new CiteError(`${label} already has ${what} (${entryName(duplicate)}).`);
+  }
   const lines = splitLines(content);
   if (pageLines !== void 0) {
     if (pageLines.end > lines.length) {
@@ -2977,6 +3119,9 @@ async function runAdd(opts) {
       if (span === void 0 || span.end !== pageLines.end) {
         throw new CiteError(`${at2} is not a fenced block, so it cannot be a quote.`);
       }
+    } else if (!marker) {
+      const empty = emptyClaimRefusal(lines, pageLines, at2);
+      if (empty !== void 0) throw new CiteError(empty);
     }
   }
   const client = opts.gitClient ?? gitClient(root);
@@ -2985,6 +3130,7 @@ async function runAdd(opts) {
   let markerAt;
   let claimSpan;
   let claim;
+  let elsewhere = [];
   let shifted = { frontmatter: [], manifest: /* @__PURE__ */ new Map() };
   if (marker && pageLines !== void 0) {
     const holding = unitHolding(content, pageLines.start, format, {
@@ -3005,7 +3151,13 @@ async function runAdd(opts) {
         `${at2} is in a ${holding.kind} at ${spellAt(holding)} that ${unitWide}. A marker anchors the whole ${holding.kind}.`
       );
     }
-    shifted = shiftedEntries(page.citations, holding.start, page.bodyLine, label);
+    shifted = shiftedEntries({
+      citations: page.citations,
+      at: [holding.start],
+      delta: 1,
+      bodyLine: page.bodyLine,
+      label
+    });
     const statement = markerIndent(content, holding.start, format, page.bodyLine) + formatStatement(format, { kind: "ref", id: opts.id ?? "" });
     const insertAt = offsetOfLine(content, holding.start);
     body = insertStatementBefore(content, insertAt, statement);
@@ -3027,6 +3179,7 @@ async function runAdd(opts) {
     }
     claimSpan = pageLines;
     claim = { lines: lineSpec(toBodyLines(pageLines, page.bodyLine)), integrity: pin };
+    elsewhere = otherClaimSpans(lines, pageLines, pin, page.bodyLine);
   }
   const mint = (key, encrypt) => mintCitation({
     root,
@@ -3063,6 +3216,12 @@ async function runAdd(opts) {
     });
     citation = await mint(key, true);
   }
+  const srcRange = parseSrc(opts.src);
+  let sourceLine;
+  if (srcRange.start !== void 0 && !isEncryptedValue(citation.source.file)) {
+    const read = await readSource(root, sourceIndex, srcRange, void 0);
+    if (read.kind === "ok") sourceLine = splitLines(read.text)[srcRange.start - 1];
+  }
   const manifests = new ManifestSet();
   let placed;
   if (owner !== void 0) {
@@ -3095,6 +3254,7 @@ async function runAdd(opts) {
     content: after,
     diff: unifiedDiff(label, content, after),
     written: false,
+    ...sourceLine === void 0 ? {} : { sourceLine },
     ...placed === void 0 ? {} : { manifest: placed }
   };
   if (markerAt !== void 0) result.markerLine = markerAt + shift;
@@ -3107,14 +3267,188 @@ async function runAdd(opts) {
     for (const changed of manifests.changed()) await writeFileAtomic(changed.path, changed.text);
     result.manifest.written = true;
   }
+  if (elsewhere.length > 0) {
+    const named3 = elsewhere.map((span) => ({ start: span.start + shift, end: span.end + shift }));
+    const who = citation.id === void 0 ? "" : `${citation.id}: `;
+    opts.onNotice?.(
+      `${who}the claim's text also appears at ${spellElsewhere(named3)}, so a move would be ambiguous. Use --marker, or pin more lines.`
+    );
+  }
   if (opts.commitSha !== false && !await client.available()) {
     opts.onNotice?.(GIT_UNAVAILABLE_COMMIT);
   }
   return result;
 }
 
-// src/cite/commands/update.ts
+// src/cite/commands/remove.ts
 import { resolve as resolve5 } from "node:path";
+var POINTER = /^\/citations\/(0|[1-9][0-9]*)$/;
+function entryCount(n) {
+  return `${String(n)} ${n === 1 ? "entry" : "entries"}`;
+}
+function idOf(entry) {
+  if (typeof entry !== "object" || entry === null || Array.isArray(entry)) return void 0;
+  const id = entry.id;
+  return typeof id === "string" ? id : void 0;
+}
+async function runRemove(opts) {
+  const only = [...new Set(opts.only)];
+  if (only.length === 0) {
+    throw new CiteError("remove needs --only <id>; it never removes every citation on a page.");
+  }
+  const prepared = await prepareRun({ ...opts, checkSources: false }, "removed", "remove", {
+    resolve: false
+  });
+  const { run: run3, files, usingStdin, forced } = prepared;
+  assertNoOrphans(prepared);
+  const hits = joinHits();
+  const manifests = new ManifestSet();
+  const matched = /* @__PURE__ */ new Set();
+  const pageCount = files.length + (usingStdin ? 1 : 0);
+  const planned = [];
+  const removeOne = async (label, content, path) => {
+    const setup = prepared.setupFor(label, content);
+    if (setup.sidecar !== void 0) hits.record(setup.sidecar, label);
+    const owner = setup.sidecar?.owner;
+    const page = readPage(label, content, {
+      ...forced === void 0 ? {} : { format: forced.name },
+      ...setup.options.citations === void 0 ? {} : { citations: setup.options.citations },
+      ...owner === void 0 ? {} : { owned: { file: owner.file, collection: owner.collection } }
+    });
+    const { format } = page;
+    const extractor = pickExtractor(label, forced?.name);
+    const inputs = citationInputs(
+      label,
+      extractor.extract(content, label),
+      setup.sidecar?.citations
+    );
+    const lines = splitLines(content);
+    const entriesFor = (value) => {
+      const [, digits] = POINTER.exec(value) ?? [];
+      if (digits === void 0) {
+        return inputs.flatMap((input, index2) => idOf(input.entry) === value ? [index2] : []);
+      }
+      const index = Number(digits);
+      if (index < inputs.length) return [index];
+      if (pageCount === 1) {
+        throw new CiteError(
+          `"${value}" is past the last entry of ${label} (${entryCount(inputs.length)}).`
+        );
+      }
+      return [];
+    };
+    const markersFor = (id) => id === void 0 ? [] : page.statements.filter((s) => s.payload.kind === "ref" && s.payload.id === id).map((s) => s.line);
+    const removed = [];
+    const indices = /* @__PURE__ */ new Set();
+    const markerLines = [];
+    for (const value of only) {
+      const found = entriesFor(value);
+      for (const index of found) {
+        const input = inputs[index];
+        const id = idOf(input?.entry);
+        const markers2 = markersFor(id);
+        indices.add(index);
+        markerLines.push(...markers2);
+        removed.push({
+          ...id === void 0 ? {} : { id },
+          index,
+          ...input === void 0 ? {} : { origin: input.origin },
+          markerLines: markers2
+        });
+        matched.add(value);
+      }
+      if (found.length > 0) continue;
+      const markers = markersFor(value);
+      if (markers.length === 0) continue;
+      markerLines.push(...markers);
+      removed.push({ id: value, markerLines: markers });
+      matched.add(value);
+    }
+    const nothing = { file: label, removed: [], diff: "", written: false };
+    if (removed.length === 0) {
+      if (path === void 0) nothing.content = content;
+      planned.push({ page: nothing, ...path === void 0 ? {} : { path } });
+      return;
+    }
+    const ordered = [...new Set(markerLines)].sort((a, b) => a - b);
+    for (const line of ordered) {
+      if (!isMarkerLine(lines[line - 1] ?? "", format)) {
+        const id = page.statements.find((s) => s.line === line)?.payload;
+        const named3 = id?.kind === "ref" ? ` ${id.id}` : "";
+        throw new CiteError(
+          `the marker${named3} at ${label}:${String(line)} shares its line with text; remove it by hand.`
+        );
+      }
+    }
+    const survivors = page.citations.filter((c) => !indices.has(c.origin.index));
+    const shifted = shiftedEntries({
+      citations: survivors,
+      at: ordered,
+      delta: -1,
+      bodyLine: page.bodyLine,
+      label
+    });
+    let after = content;
+    for (const { index, lines: moved } of shifted.frontmatter) {
+      after = spliceEntryField(after, format, index, ["claim", "lines"], moved);
+    }
+    for (const line of [...ordered].sort((a, b) => b - a)) after = removeLine(after, line);
+    if (owner === void 0) {
+      after = removeFrontmatterCitations(after, format, indices, label);
+    } else {
+      if (setup.sidecar?.entry === void 0) {
+        throw new CiteError(
+          `${label} carries no ${owner.join}: value, so its citations cannot be keyed in ${owner.file}.`
+        );
+      }
+      const kept = inputs.map((input, index) => {
+        const moved = shifted.manifest.get(index);
+        return moved === void 0 ? input.entry : withClaimLines(input.entry, moved);
+      }).filter((_entry, index) => !indices.has(index));
+      if (kept.length === 0) await manifests.remove(owner, setup.sidecar.entry);
+      else void await manifests.write(owner, setup.sidecar.entry, kept, 0);
+    }
+    const out = {
+      file: label,
+      removed,
+      diff: after === content ? "" : unifiedDiff(label, content, after),
+      written: false
+    };
+    if (path === void 0) out.content = after;
+    planned.push({ page: out, ...after === content ? {} : { content: after }, ...path === void 0 ? {} : { path } });
+  };
+  if (usingStdin) await removeOne(STDIN_LABEL, opts.stdinContent ?? "");
+  for (const file of files) {
+    await removeOne(file, await readTarget(run3, file), resolve5(run3.base, file));
+  }
+  assertNoOrphanJoins(prepared, hits);
+  const missing = only.find((value) => !matched.has(value));
+  if (missing !== void 0) {
+    const where = pageCount === 1 ? `${planned[0]?.page.file ?? "the page"} has no` : `none of ${String(pageCount)} pages has an`;
+    const what = POINTER.test(missing) ? `entry ${missing}` : `entry or marker ${missing}`;
+    throw new CiteError(`${where} ${what}.`);
+  }
+  const write = opts.dryRun !== true;
+  for (const item of planned) {
+    if (item.content === void 0 || item.path === void 0) continue;
+    if (write) await writeFileAtomic(item.path, item.content);
+    item.page.written = write;
+  }
+  const rewritten = [];
+  for (const changed of manifests.changed()) {
+    if (write) await writeFileAtomic(changed.path, changed.text);
+    rewritten.push({ file: changed.file, diff: changed.diff, written: write });
+  }
+  const pages = planned.map((item) => item.page);
+  return {
+    pages,
+    removed: pages.reduce((n, page) => n + page.removed.length, 0),
+    ...rewritten.length > 0 ? { manifests: rewritten } : {}
+  };
+}
+
+// src/cite/commands/update.ts
+import { resolve as resolve6 } from "node:path";
 function settles(plan) {
   switch (plan.kind) {
     case "claim-moved":
@@ -3243,7 +3577,7 @@ function rewriteOf(plan) {
   }
 }
 async function runUpdate(opts) {
-  const prepared = await prepareRun(opts, "updated", "update", true);
+  const prepared = await prepareRun(opts, "updated", "update", { require: true });
   const { run: run3, files, usingStdin, forced, pageOptions, git } = prepared;
   assertNoOrphans(prepared);
   const hits = joinHits();
@@ -3371,7 +3705,7 @@ async function runUpdate(opts) {
   const reports = [];
   if (usingStdin) reports.push(await updateOne(STDIN_LABEL, opts.stdinContent ?? ""));
   for (const file of files) {
-    reports.push(await updateOne(file, await readTarget(run3, file), resolve5(run3.base, file)));
+    reports.push(await updateOne(file, await readTarget(run3, file), resolve6(run3.base, file)));
   }
   assertNoOrphanJoins(prepared, hits);
   const changedManifests = manifests.changed();
@@ -3774,6 +4108,50 @@ function renderUpdatePretty(run3, opts) {
   lines.push(run3.exitCode === 0 ? c.green(summary) : c.red(summary));
   return lines.join("\n");
 }
+function spellLineList(at2, noun) {
+  if (at2.length === 0) return noun;
+  const spelled = at2.map((line) => String(line));
+  if (spelled.length === 1) return `${noun} ${spelled[0] ?? ""}`;
+  const last = spelled[spelled.length - 1] ?? "";
+  return `${noun}s ${spelled.slice(0, -1).join(", ")} and ${last}`;
+}
+function removalLine(removal, c) {
+  const markers = spellLineList(removal.markerLines, "line");
+  if (removal.origin === void 0) {
+    const named3 = removal.markerLines.length === 1 ? "the marker" : "the markers";
+    return `removed ${named3} ${c.cyan(removal.id ?? "")} at ${markers}, which named no entry`;
+  }
+  const name = removal.id ?? `/citations/${String(removal.index ?? 0)}`;
+  const where = removal.origin.kind === "manifest" ? `${removal.origin.file}${removal.origin.line === void 0 ? "" : `:${String(removal.origin.line)}`}` : "frontmatter";
+  const also = removal.markerLines.length === 0 ? "" : `, and ${removal.markerLines.length === 1 ? "its marker" : "its markers"} at ${markers}`;
+  return `removed ${c.cyan(name)} from ${where}${also}`;
+}
+function renderRemovePretty(run3, opts) {
+  const c = palette(opts.color);
+  const lines = [];
+  let files = 0;
+  for (const page of run3.pages) {
+    if (page.removed.length > 0) files += 1;
+    if (opts.showDiff && page.diff !== "") {
+      for (const line of page.diff.split(/\r?\n/)) {
+        if (line !== "") lines.push(c.dim(line));
+      }
+    }
+    for (const removal of page.removed) {
+      lines.push(`${page.file}: ${removalLine(removal, c)}`);
+    }
+  }
+  if (opts.showDiff) {
+    for (const manifest of run3.manifests ?? []) {
+      for (const line of manifest.diff.split(/\r?\n/)) {
+        if (line !== "") lines.push(c.dim(line));
+      }
+    }
+  }
+  const verb = opts.dryRun === true ? "would be removed" : "removed";
+  lines.push(c.green(`${plural2(run3.removed, "citation")} ${verb} from ${plural2(files, "file")}`));
+  return lines.join("\n");
+}
 
 // src/cite/reporters/json.ts
 function publicCitation(result) {
@@ -3815,6 +4193,9 @@ function publicPage(page) {
 function renderCheckJson(run3) {
   return JSON.stringify({ summary: run3.summary, pages: run3.pages.map(publicPage) }, null, 2);
 }
+function renderRemoveJson(run3) {
+  return JSON.stringify(run3, null, 2);
+}
 function renderUpdateJson(run3) {
   const pages = run3.pages.map((page) => ({
     ...page,
@@ -3869,7 +4250,7 @@ var KeyError = class extends ToolError {
 // src/key/commands/rotate.ts
 import { existsSync as existsSync2 } from "node:fs";
 import { readFile as readFile5 } from "node:fs/promises";
-import { isAbsolute as isAbsolute3, join as join2, relative as relative3, resolve as resolve6, sep as sep3 } from "node:path";
+import { isAbsolute as isAbsolute3, join as join2, relative as relative3, resolve as resolve7, sep as sep3 } from "node:path";
 import { parse as parseYaml } from "yaml";
 
 // src/key/core/config.ts
@@ -3905,9 +4286,9 @@ function citeSection(file) {
   return parseCiteConfig(doc.cite, file.source);
 }
 function rootFor(flag, cite, file, cwd) {
-  if (flag !== void 0) return { root: resolve6(cwd, flag), fellBack: false };
+  if (flag !== void 0) return { root: resolve7(cwd, flag), fellBack: false };
   if (file !== null && cite.root !== void 0) {
-    return { root: resolve6(file.dir, cite.root), fellBack: false };
+    return { root: resolve7(file.dir, cite.root), fellBack: false };
   }
   const gitRoot = findGitRoot(cwd);
   return gitRoot === null ? { root: cwd, fellBack: true } : { root: gitRoot, fellBack: false };
@@ -3969,7 +4350,7 @@ function reportedPath2(abs, base) {
 function manifestCollections(collections, opts) {
   if (opts.fromCollections) return [...collections];
   const rels = opts.files.map(
-    (rel) => reportedPath2(resolve6(opts.base, rel), opts.configDir)
+    (rel) => reportedPath2(resolve7(opts.base, rel), opts.configDir)
   );
   return collections.filter((c) => rels.some((rel) => isMember(c, rel)));
 }
@@ -3998,7 +4379,7 @@ async function planManifests(opts) {
   for (const c of local) {
     for (const m of c.externalMetadata) {
       const join4 = externalMetadataJoin(m);
-      const abs = isAbsolute3(m.file) ? m.file : resolve6(opts.configDir, m.file);
+      const abs = isAbsolute3(m.file) ? m.file : resolve7(opts.configDir, m.file);
       const file = reportedPath2(abs, opts.base);
       located.set(`${c.name}\0${file}\0${join4}`, abs);
       if (plans.has(abs)) continue;
@@ -4043,7 +4424,7 @@ async function planManifests(opts) {
   );
 }
 async function runKeyRotate(opts) {
-  const cwd = resolve6(opts.cwd ?? process.cwd());
+  const cwd = resolve7(opts.cwd ?? process.cwd());
   const env = opts.env ?? process.env;
   if (opts.to !== void 0 && !isValidEncryptionKey(opts.to)) throw new KeyError(BAD_TO);
   if (opts.inputs.includes(STDIN_TOKEN)) throw new KeyError(NO_STDIN);
@@ -4127,7 +4508,7 @@ async function runKeyRotate(opts) {
   const planned = [];
   let wantsHistory = false;
   for (const rel of files) {
-    const path = resolve6(base, rel);
+    const path = resolve7(base, rel);
     const before = await readFile5(path, "utf8");
     const page = { file: rel, content: before, ...format === void 0 ? {} : { format } };
     const sidecarWork = await rotateManifestCitations(sidecars2, manifests, page, {
@@ -4218,7 +4599,7 @@ async function runKeyRotate(opts) {
     else outcome = previous === void 0 ? "written" : "finished";
   }
   const wrote = outcome !== "skipped" && outcome !== "dry-run";
-  const baseline = file !== null && cite.baseline !== void 0 ? resolve6(file.dir, cite.baseline) : join2(file?.dir ?? cwd, DEFAULT_CITE_BASELINE_PATH);
+  const baseline = file !== null && cite.baseline !== void 0 ? resolve7(file.dir, cite.baseline) : join2(file?.dir ?? cwd, DEFAULT_CITE_BASELINE_PATH);
   return {
     pages: planned.map((p) => p.page),
     manifests: valueManifests.map((m) => m.manifest),
@@ -4234,7 +4615,7 @@ async function runKeyRotate(opts) {
 
 // src/key/commands/set.ts
 import { existsSync as existsSync3 } from "node:fs";
-import { basename, dirname, join as join3, relative as relative4, resolve as resolve7 } from "node:path";
+import { basename, dirname, join as join3, relative as relative4, resolve as resolve8 } from "node:path";
 var BAD_VALUE = "The key must be at least 32 hex or base64url characters. Run `manni key set` with no value to generate one.";
 var ENV_SET = `${ENCRYPTION_KEY_ENV} is set, so a key written to config would never be read. Unset it, or keep the key in the secret.`;
 var alreadyConfigured = (source) => `An encryption key is already configured in ${source}. Run \`manni key rotate\` to replace it and re-encrypt every value.`;
@@ -4251,7 +4632,7 @@ function refuseBesideLegacy(path, cwd) {
   }
 }
 async function runKeySet(opts) {
-  const cwd = resolve7(opts.cwd ?? process.cwd());
+  const cwd = resolve8(opts.cwd ?? process.cwd());
   const env = opts.env ?? process.env;
   if (opts.value !== void 0 && !isValidEncryptionKey(opts.value)) {
     throw new KeyError(BAD_VALUE);
@@ -4290,22 +4671,26 @@ export {
   RULE_ID_PREFIX,
   isCiteRule,
   spellSource,
+  shortPin,
+  shortCommit,
+  shortSrc,
+  shortLine,
   runAdd,
   errorSite,
   runCheck,
+  runRemove,
   runUpdate,
-  shortPin,
-  shortCommit,
-  shortSrc,
   renderCheckPretty,
   renderUpdatePretty,
+  renderRemovePretty,
   findingMessage,
   renderCheckGithub,
   renderCheckJson,
+  renderRemoveJson,
   renderUpdateJson,
   cite_exports,
   KeyError,
   runKeyRotate,
   runKeySet
 };
-//# sourceMappingURL=chunk-YSI2VNKE.js.map
+//# sourceMappingURL=chunk-P4KR3XFD.js.map