okf-kit 0.8.0 → 0.10.0

package/dist/cli.js

@@ -28,6 +28,14 @@ export function runCheck(bundleDir, options = {}) {
     if (options.requireAnchors) {
         ctx.requireAnchors = { allow: options.requireAnchorsAllow ?? [] };
     }
+    if (options.proseLineReferences) {
+        ctx.proseLineReferences = {
+            strict: Boolean(options.proseLineReferencesStrict),
+        };
+    }
+    if (options.futureSkewMinutes !== undefined) {
+        ctx.freshnessFutureSkewSeconds = Math.round(options.futureSkewMinutes * 60);
+    }
     const findings = allRules.flatMap((rule) => rule.run(ctx));
     const summary = summarize(findings);
     const exitCode = summary.errors > 0 || (Boolean(options.strict) && summary.warnings > 0)
@@ -58,14 +66,35 @@ program
     "a string anchor lands uniquely on the last line of its range (opt-in, see README)")
     .option("--require-anchors-allow <patterns...>", "citations-resolve: citedPath glob/exact patterns (e.g. README.md) exempt from " +
     "--require-anchors' anchor-required check")
+    .option("--prose-line-references", "prose-line-references: flag a drifted, unresolvable, or ambiguous prose-embedded line " +
+    'reference outside citations-resolve\'s own backtick grammar, e.g. "lines 129-132" (opt-in, see README)')
+    .option("--prose-line-references-strict", "prose-line-references: also flag every prose line reference, not only a drifted one, with " +
+    "the remedy to lift it into a backtick citation or a symbol name (ignored unless --prose-line-references is also passed)")
+    .option("--future-skew-minutes <n>", "sources-fresh-future: clock-skew allowance in minutes before a doc `timestamp` later than " +
+    "the doc's own last commit is flagged as future-dated (default 10)")
     .exitOverride()
     .action((bundleDir, opts) => {
     try {
+        let futureSkewMinutes;
+        if (opts.futureSkewMinutes !== undefined) {
+            const trimmed = opts.futureSkewMinutes.trim();
+            // `Number("")` and `Number("  ")` both resolve to 0, which would
+            // otherwise silently accept an empty/whitespace-only value as
+            // "0 minutes" instead of rejecting it as the usage error it is.
+            const n = trimmed === "" ? Number.NaN : Number(trimmed);
+            if (!Number.isFinite(n) || n < 0) {
+                throw new UsageError(`--future-skew-minutes must be a non-negative number, got \`${opts.futureSkewMinutes}\``);
+            }
+            futureSkewMinutes = n;
+        }
         const result = runCheck(bundleDir, {
             repoRoot: opts.repoRoot,
             strict: opts.strict,
             requireAnchors: opts.requireAnchors,
             requireAnchorsAllow: opts.requireAnchorsAllow,
+            proseLineReferences: opts.proseLineReferences,
+            proseLineReferencesStrict: opts.proseLineReferencesStrict,
+            futureSkewMinutes,
         });
         const output = opts.json
             ? renderJson(result.bundleDir, result.findings)

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/git.d.ts

@@ -3,8 +3,8 @@ import type { RunGit } from "./types.js";
  * Default RunGit implementation: shells out to the real `git` binary.
  * stderr is discarded (git's own "fatal: not a git repository" etc. text is
  * an expected, silent signal here, not something to surface), and any
- * failure (non-zero exit, git missing) resolves to null instead of
- * throwing.
+ * failure (non-zero exit, git missing, output past MAX_GIT_OUTPUT_BYTES)
+ * resolves to null instead of throwing.
  */
 export declare const runGit: RunGit;
 /**

package/dist/git.js

@@ -1,10 +1,23 @@
 import { execFileSync } from "node:child_process";
+/**
+ * Output cap (bytes) for a single git invocation. Node's own default for
+ * `execFileSync` is 1 MiB, and exceeding it does not throw a distinguishable
+ * error here -- it lands in the catch below and resolves to null, i.e. the
+ * caller sees "git failed" for a perfectly healthy repository. `sources-fresh`
+ * reads whole doc blobs (`git show <sha>:<path>`) to compare frontmatter
+ * timestamps, and an OKF doc larger than 1 MiB is unusual but entirely legal,
+ * so the cap is raised well past any plausible doc size. It is deliberately
+ * still a cap and not `Infinity`: a runaway git invocation should fail loudly
+ * (as null, which every caller treats as "not assessable") rather than grow
+ * the process heap without bound.
+ */
+const MAX_GIT_OUTPUT_BYTES = 16 * 1024 * 1024;
 /**
  * Default RunGit implementation: shells out to the real `git` binary.
  * stderr is discarded (git's own "fatal: not a git repository" etc. text is
  * an expected, silent signal here, not something to surface), and any
- * failure (non-zero exit, git missing) resolves to null instead of
- * throwing.
+ * failure (non-zero exit, git missing, output past MAX_GIT_OUTPUT_BYTES)
+ * resolves to null instead of throwing.
  */
 export const runGit = (args, cwd) => {
     try {
@@ -12,6 +25,7 @@ export const runGit = (args, cwd) => {
             cwd,
             encoding: "utf8",
             stdio: ["ignore", "pipe", "ignore"],
+            maxBuffer: MAX_GIT_OUTPUT_BYTES,
         }).trim();
     }
     catch {

package/dist/git.js.map

@@ -1 +1 @@
-{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;IAC1C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE;YAC/B,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,MAAc,MAAM;IAEpB,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACrC,CAAC"}
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;;;;;;;;GAWG;AACH,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;IAC1C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE;YAC/B,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,SAAS,EAAE,oBAAoB;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,MAAc,MAAM;IAEpB,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACrC,CAAC"}

package/dist/rules/citations-resolve.d.ts

@@ -1,2 +1,107 @@
 import type { Rule } from "../types.js";
+export declare const CITATION_RE: RegExp;
+/**
+ * Per-root basename index, see findByBasename. Exported so
+ * `prose-line-references` can build its own cache instance for
+ * `resolveCitation` calls, matching this rule's own scoping (fresh per
+ * `run(ctx)` invocation, never held at module scope).
+ */
+export type BasenameCache = Map<string, Map<string, string[]>>;
+export type Resolution = {
+    skip: true;
+} | {
+    path: string;
+} | {
+    ambiguous: true;
+    candidates: string[];
+};
+/**
+ * True when citedPath has a literal `..` path segment. Exported so
+ * `prose-line-references` rejects the same shape before ever calling
+ * `resolveCitation` on a file-mention token, matching this rule's own
+ * `path-traversal-rejected` posture.
+ */
+export declare function hasParentSegment(citedPath: string): boolean;
+/**
+ * Resolves a citation's path to a single real file. Returns `{ skip: true }`
+ * for a citedPath out of scope (leading `/`), `{ path }` on a definitive
+ * single resolution, `{ ambiguous: true, candidates }` when more than one
+ * plausible target exists, or `null` when nothing matches. Callers must
+ * reject a citedPath with a `..` segment (see hasParentSegment) before
+ * calling this; it is not re-checked here.
+ *
+ * Exported so `prose-line-references` (see
+ * src/rules/prose-line-references.ts) reuses this exact resolution order
+ * for binding a bare prose line reference to the file mention nearest it,
+ * rather than re-implementing (and risking drifting from) this rule's own
+ * path-resolution rules.
+ */
+export declare function resolveCitation(cache: BasenameCache, root: string, docAbsPath: string, docContent: string, docSources: string[], citedPath: string, matchIndex: number): Resolution | null;
+/**
+ * Char spans of every fenced code block in `content` (```` ``` ```` or
+ * `~~~`, optionally with a trailing language tag), each span running from
+ * the start of the opening fence line to the end of the closing fence line
+ * inclusive. An unterminated fence (no matching close before end of doc) is
+ * treated as running to the end of the content -- conservative, since an
+ * unterminated fence is itself a doc problem outside this rule's scope, not
+ * a reason to scan its contents for short-form citations. Derived from
+ * `scanFenceLines` (see there): per-line fenced/opens/closes state is
+ * converted to char-offset spans by tracking each line's `[start, end)`
+ * offset in `content` alongside it.
+ *
+ * Exported (with computeIndentedCodeSpans and computeTableRowSpans below)
+ * so `prose-line-references` can build its OWN excluded-span set for file
+ * mentions that leaves out computeInlineCodeSpans -- a bare backtick-
+ * wrapped filename (`` `src/cli.ts` ``) is the normal, encouraged way to
+ * write a file mention in prose, unlike a short-form bare number, so it
+ * must NOT be excluded from mention detection the way it is excluded from
+ * short-form citation matching here.
+ */
+export declare function computeFencedSpans(content: string): Array<[number, number]>;
+/**
+ * Char spans of every CommonMark-style indented code block in `content`: a
+ * maximal run of consecutive non-blank lines, each indented by at least
+ * four spaces or a leading tab, whose first line is preceded by a blank
+ * line or the start of the document (an indented code block cannot
+ * interrupt a paragraph). A blank line inside the run does not itself end
+ * it, matching CommonMark. Simplified relative to the full CommonMark
+ * spec (no list-item-context awareness); adequate for this mechanical,
+ * warn-only rule.
+ */
+export declare function computeIndentedCodeSpans(content: string): Array<[number, number]>;
+/**
+ * Char spans of every Markdown table row in `content`: a line whose
+ * trimmed form starts and ends with `|`. Decision (documented in the
+ * README): a short-form citation inside a table cell is never recognised,
+ * the same way one inside a code span is not -- excluded here rather than
+ * left to the plausibility gate, since a table cell's content is prose-like
+ * and can otherwise carry a range shape the gate would not reject (e.g.
+ * `| col (5-9) |`).
+ */
+export declare function computeTableRowSpans(content: string): Array<[number, number]>;
+/**
+ * All char spans short-form matching must never fire inside: fenced code,
+ * indented code, inline code spans, and Markdown table rows. Computed once
+ * per doc and combined with fullSpans (see scanDoc) via the existing
+ * isWithinAnySpan helper -- the same mechanism a full citation's own span
+ * already uses, not a second one.
+ *
+ * Exported so `prose-line-references` excludes the identical set of spans
+ * from its own extraction (a code-fenced or inline-code "line N" is a code
+ * example, not a live prose reference), rather than maintaining a second,
+ * possibly-drifting copy of "what counts as excluded prose".
+ */
+export declare function computeExcludedSpans(content: string): Array<[number, number]>;
+/**
+ * Paragraph-start offsets in `content`, ascending, always including 0. A
+ * paragraph boundary is a blank (empty or whitespace-only) line.
+ *
+ * Exported (with paragraphStartFor below) so `prose-line-references` binds
+ * against the same notion of "paragraph" this rule already uses for
+ * short-form citation binding, instead of a second, possibly-inconsistent
+ * definition.
+ */
+export declare function computeParagraphStarts(content: string): number[];
+/** The start offset of the paragraph containing `index` (see computeParagraphStarts). */
+export declare function paragraphStartFor(starts: number[], index: number): number;
 export declare const citationsResolveRule: Rule;

package/dist/rules/citations-resolve.js

@@ -101,8 +101,8 @@ const RULE_ID = "citations-resolve";
  * citation, prose habitually repeats just the line (or range) for a later
  * reference in the same sentence rather than retyping the path, in three
  * forms:
- *   - `` `:N` `` or `` `:N-M` `` -- a bare colon-prefixed line/range
- *   - `` -`M` `` / `` –`M` `` -- a hyphen- or en-dash-led bare line, the
+ *   - `` `:N` ``/`` `:N-M` `` -- a bare colon-prefixed line/range
+ *   - `` -`M` ``/`` –`M` `` -- a hyphen- or en-dash-led bare line, the
  *     tail half of a `` `path:N`-`M` `` split range
  *   - `` (`N`) `` -- a parenthesized bare line
  * Each of these resolves against `governing`: the nearest *preceding*
@@ -198,6 +198,11 @@ const RULE_ID = "citations-resolve";
  * nowhere natural to hang an anchor on one without inventing a second,
  * detached syntax; the migration this rule was built for (CHANGELOG.md
  * citations) is written as full citations throughout the corpus it targets.
+ * Under `--require-anchors`, this remains true (no second anchor syntax is
+ * added), but a continuation or short-form that chains off an in-repo full
+ * citation is instead flagged, `anchor-required-continuation`, so it does
+ * not drift silently -- see the "Anchor strictness (opt-in)" doc block
+ * below for that check.
  *
  * Rejected alternatives (see the PR/CHANGELOG for the fuller writeup):
  *   - Embedding the literal heading markup itself, e.g.
@@ -291,6 +296,30 @@ const RULE_ID = "citations-resolve";
  * `checkShortFormTarget`'s own doc comment already gives for the Markdown
  * half of the block-boundary check: a full citation into a Markdown target
  * legitimately cites a couple of arbitrary lines all the time.
+ *
+ * A fifth check, `anchor-required-continuation` (warning), closes a gap the
+ * four checks above leave open: every one of them is gated on reaching a
+ * "full" atom, so a continuation (` :N`/`:N-M` `, `` -`M` ``/`` –`M` ``,
+ * `` (`N`) ``) or a paragraph-bound short-form `:N-M` chained off an
+ * ALREADY-ANCHORED full citation was previously invisible to
+ * `--require-anchors` entirely -- it carries no path of its own
+ * (see the "Continuation citations" / "Short-form citations" doc blocks),
+ * so it was never itself an in-repo full citation `anchor-required` could
+ * reach, and the anchor on the governing citation it chains off does not
+ * (and structurally cannot) cover it: a line-shift that only affects the
+ * continuation's own start/end line is exactly the drift this rule's base
+ * checks (blank-start-line and friends) already catch when it lands on
+ * unusable content, but a shift that lands the continuation on still
+ * non-blank, in-bounds, unrelated content is invisible to any of them --
+ * see `pushAnchorRequiredContinuation` for where this is pushed, from all
+ * three places a continuation or short-form atom is processed in `scanDoc`.
+ * Unlike `anchor-required`, there is no "already carries one" escape here:
+ * a continuation is structurally anchor-less regardless of whether its
+ * governing full citation has an anchor, so this fires unconditionally
+ * once the same exemptions (reserved citing doc, `requireAnchors.allow`
+ * matched against the GOVERNING citation's citedPath) clear. The remedy is
+ * always the same: lift the continuation into its own full,
+ * `path:N-M#anchor` citation.
  */
 /**
  * True when `citedPath` (the citation's raw, as-written path text) matches
@@ -523,7 +552,10 @@ function checkAnchor(anchor, startLine, endLine, lines, requireAnchors) {
     }
     return null;
 }
-const CITATION_RE = /([\w./-]+\.(?:ts|js|mjs|md|yml|yaml|json)):(\d+)(?:-(\d+))?(?:#(\[?\w(?:[\w.-]*\w)?\]?|"[^"\n`]*"))?/g;
+// Exported so `prose-line-references` (see src/rules/prose-line-references.ts)
+// can exclude a real citations-resolve citation span from its own
+// extraction, rather than re-deriving this grammar itself.
+export const CITATION_RE = /([\w./-]+\.(?:ts|js|mjs|md|yml|yaml|json)):(\d+)(?:-(\d+))?(?:#(\[?\w(?:[\w.-]*\w)?\]?|"[^"\n`]*"))?/g;
 /**
  * Heading-section citations. A CHANGELOG.md that grows by insertion at the
  * top forces every later `path:N-M#anchor` citation to be re-pointed on
@@ -666,8 +698,13 @@ function isFile(p) {
         return false;
     }
 }
-/** True when citedPath has a literal `..` path segment. */
-function hasParentSegment(citedPath) {
+/**
+ * True when citedPath has a literal `..` path segment. Exported so
+ * `prose-line-references` rejects the same shape before ever calling
+ * `resolveCitation` on a file-mention token, matching this rule's own
+ * `path-traversal-rejected` posture.
+ */
+export function hasParentSegment(citedPath) {
     return citedPath.split("/").includes("..");
 }
 /**
@@ -770,8 +807,14 @@ function resolveViaAncestorClimb(root, docAbsPath, citedPath) {
  * plausible target exists, or `null` when nothing matches. Callers must
  * reject a citedPath with a `..` segment (see hasParentSegment) before
  * calling this; it is not re-checked here.
+ *
+ * Exported so `prose-line-references` (see
+ * src/rules/prose-line-references.ts) reuses this exact resolution order
+ * for binding a bare prose line reference to the file mention nearest it,
+ * rather than re-implementing (and risking drifting from) this rule's own
+ * path-resolution rules.
  */
-function resolveCitation(cache, root, docAbsPath, docContent, docSources, citedPath, matchIndex) {
+export function resolveCitation(cache, root, docAbsPath, docContent, docSources, citedPath, matchIndex) {
     if (citedPath.startsWith("/")) {
         return { skip: true };
     }
@@ -1368,6 +1411,7 @@ function collectContinuationAtoms(content) {
                 kind: "cont-ext",
                 index: m.index,
                 value: m[2] ? Number(m[2]) : Number(m[1]),
+                raw: m[0],
             });
         }
         else {
@@ -1376,12 +1420,18 @@ function collectContinuationAtoms(content) {
                 index: m.index,
                 startLine: Number(m[1]),
                 endLine: m[2] ? Number(m[2]) : null,
+                raw: m[0],
             });
         }
     }
     const dashRe = new RegExp(CONT_DASH_RE.source, "g");
     while ((m = dashRe.exec(content)) !== null) {
-        atoms.push({ kind: "cont-ext", index: m.index, value: Number(m[1]) });
+        atoms.push({
+            kind: "cont-ext",
+            index: m.index,
+            value: Number(m[1]),
+            raw: m[0],
+        });
     }
     const parenRe = new RegExp(CONT_PAREN_RE.source, "g");
     while ((m = parenRe.exec(content)) !== null) {
@@ -1390,6 +1440,7 @@ function collectContinuationAtoms(content) {
             index: m.index,
             startLine: Number(m[1]),
             endLine: null,
+            raw: m[0],
         });
     }
     return atoms;
@@ -1443,8 +1494,16 @@ function collectShortFormMatches(content, excludedSpans) {
  * `scanFenceLines` (see there): per-line fenced/opens/closes state is
  * converted to char-offset spans by tracking each line's `[start, end)`
  * offset in `content` alongside it.
+ *
+ * Exported (with computeIndentedCodeSpans and computeTableRowSpans below)
+ * so `prose-line-references` can build its OWN excluded-span set for file
+ * mentions that leaves out computeInlineCodeSpans -- a bare backtick-
+ * wrapped filename (`` `src/cli.ts` ``) is the normal, encouraged way to
+ * write a file mention in prose, unlike a short-form bare number, so it
+ * must NOT be excluded from mention detection the way it is excluded from
+ * short-form citation matching here.
  */
-function computeFencedSpans(content) {
+export function computeFencedSpans(content) {
     const spans = [];
     const lines = content.split("\n");
     const states = scanFenceLines(lines);
@@ -1475,7 +1534,7 @@ function computeFencedSpans(content) {
  * spec (no list-item-context awareness); adequate for this mechanical,
  * warn-only rule.
  */
-function computeIndentedCodeSpans(content) {
+export function computeIndentedCodeSpans(content) {
     const spans = [];
     const lines = content.split("\n");
     let offset = 0;
@@ -1546,7 +1605,7 @@ function computeInlineCodeSpans(content) {
  * and can otherwise carry a range shape the gate would not reject (e.g.
  * `| col (5-9) |`).
  */
-function computeTableRowSpans(content) {
+export function computeTableRowSpans(content) {
     const spans = [];
     const lines = content.split("\n");
     let offset = 0;
@@ -1567,8 +1626,13 @@ function computeTableRowSpans(content) {
  * per doc and combined with fullSpans (see scanDoc) via the existing
  * isWithinAnySpan helper -- the same mechanism a full citation's own span
  * already uses, not a second one.
+ *
+ * Exported so `prose-line-references` excludes the identical set of spans
+ * from its own extraction (a code-fenced or inline-code "line N" is a code
+ * example, not a live prose reference), rather than maintaining a second,
+ * possibly-drifting copy of "what counts as excluded prose".
  */
-function computeExcludedSpans(content) {
+export function computeExcludedSpans(content) {
     return [
         ...computeFencedSpans(content),
         ...computeIndentedCodeSpans(content),
@@ -1579,8 +1643,13 @@ function computeExcludedSpans(content) {
 /**
  * Paragraph-start offsets in `content`, ascending, always including 0. A
  * paragraph boundary is a blank (empty or whitespace-only) line.
+ *
+ * Exported (with paragraphStartFor below) so `prose-line-references` binds
+ * against the same notion of "paragraph" this rule already uses for
+ * short-form citation binding, instead of a second, possibly-inconsistent
+ * definition.
  */
-function computeParagraphStarts(content) {
+export function computeParagraphStarts(content) {
     const starts = [0];
     const re = /\n[ \t]*\n+/g;
     let m;
@@ -1590,7 +1659,7 @@ function computeParagraphStarts(content) {
     return starts;
 }
 /** The start offset of the paragraph containing `index` (see computeParagraphStarts). */
-function paragraphStartFor(starts, index) {
+export function paragraphStartFor(starts, index) {
     let result = starts[0];
     for (const s of starts) {
         if (s > index)
@@ -1641,6 +1710,40 @@ function pushUnreadable(findings, file, citation, resolvedTo, code) {
         detail: `resolvedTo: ${resolvedTo}, errorCode: ${code}`,
     });
 }
+/**
+ * `anchor-required-continuation` (opt-in, `--require-anchors`, warning):
+ * see the "Anchor strictness (opt-in)" doc block above. A continuation
+ * atom (cont-fresh or cont-ext, any of the three backtick forms, or a
+ * paragraph-bound short-form `:N-M`) is structurally anchor-less by
+ * construction -- see the "Continuation citations" doc block -- so
+ * unlike `anchor-required` there is no "already carries one" escape: this
+ * fires once its governing citation resolved in-repo, REGARDLESS of
+ * whether that governing full citation itself carries an anchor (an
+ * anchor on the full citation does not extend to a later continuation of
+ * it). Exemptions mirror `anchor-required`'s exactly: the caller already
+ * folds the reserved-citing-doc carve-out into `requireAnchorsForDoc`
+ * (undefined for a reserved doc), and `requireAnchors.allow` is matched
+ * here against `governing.citedPath` -- the path the continuation is
+ * chained to, since a continuation carries no path of its own to match
+ * against.
+ */
+function pushAnchorRequiredContinuation(findings, file, citation, raw, governing, requireAnchorsForDoc, root) {
+    if (!requireAnchorsForDoc ||
+        matchesAllowPattern(governing.citedPath, requireAnchorsForDoc.allow)) {
+        return;
+    }
+    const governingRange = `${governing.citedPath}:${governing.startLine}${governing.endLine ? "-" + governing.endLine : ""}`;
+    // "chained to" rather than "extends": for a cont-ext that itself chains
+    // off an earlier cont-fresh (not the original full citation), the range
+    // it literally extends is the cont-fresh's own range, not `governing`'s
+    // -- `governing` (see the loop above) always carries the ORIGINAL full
+    // citation's own startLine/endLine, unchanged across intervening
+    // cont-fresh atoms. Naming it "the governing citation" is honest for
+    // every caller (cont-ext, cont-fresh, and the short-form call site
+    // below) without having to thread the true immediate antecedent range
+    // through here.
+    pushDrift(findings, file, citation, "anchor-required-continuation", `continuation ${raw} is chained to the governing citation \`${governingRange}\`; a continuation cannot carry its own #anchor, lift it into a full \`path:N-M#anchor\` citation (--require-anchors is on)`, path.relative(root, governing.resolvedPath));
+}
 /**
  * True when a `CITATION_RE` match at `matchIndex` is the phantom tail of a
  * filename hard-wrapped across a line break (see the "Hard-wrapped prose"
@@ -1771,9 +1874,13 @@ function scanDoc(cache, root, bundleDir, doc, requireAnchors) {
     const atoms = [...fullAtoms, ...collectContinuationAtoms(content)].sort((a, b) => a.index - b.index);
     // `governing`: nearest preceding citation (full or continuation) that
     // resolved to a real file; see the "Continuation citations" doc block
-    // above for the reset rules. `lastStartLine`: the start line a "cont-ext"
-    // atom extends into a range; tracks the most recent full or cont-fresh
-    // atom's own startLine, scoped together with `governing`.
+    // above for the reset rules. Carries the ORIGINAL full citation's own
+    // startLine/endLine (not the extended range a later cont-ext might grow
+    // into) so `anchor-required-continuation` (see `pushAnchorRequiredContinuation`
+    // above) can name "the governing citation" the same way it was actually
+    // written. `lastStartLine`: the start line a "cont-ext" atom extends into
+    // a range; tracks the most recent full or cont-fresh atom's own
+    // startLine, scoped together with `governing`.
     let governing = null;
     let lastStartLine = null;
     for (const atom of atoms) {
@@ -1781,6 +1888,7 @@ function scanDoc(cache, root, bundleDir, doc, requireAnchors) {
             if (!governing || lastStartLine === null)
                 continue; // nothing to extend
             const citation = `${governing.citedPath}:${lastStartLine}-${atom.value} (continuation)`;
+            pushAnchorRequiredContinuation(findings, doc.relPath, citation, atom.raw, governing, requireAnchorsForDoc, root);
             const problem = checkRangeBoundOnly(lastStartLine, atom.value, governing.resolvedPath);
             if (problem?.rule === "unreadable-target") {
                 pushUnreadable(findings, doc.relPath, citation, path.relative(root, governing.resolvedPath), problem.code ?? "UNKNOWN");
@@ -1795,6 +1903,7 @@ function scanDoc(cache, root, bundleDir, doc, requireAnchors) {
                 continue; // nothing to validate a bare continuation against
             const { startLine, endLine } = atom;
             const citation = `${governing.citedPath}:${startLine}${endLine ? "-" + endLine : ""} (continuation)`;
+            pushAnchorRequiredContinuation(findings, doc.relPath, citation, atom.raw, governing, requireAnchorsForDoc, root);
             const problem = checkTarget(governing.citedPath, startLine, endLine, governing.resolvedPath);
             if (problem?.rule === "unreadable-target") {
                 pushUnreadable(findings, doc.relPath, citation, path.relative(root, governing.resolvedPath), problem.code ?? "UNKNOWN");
@@ -1869,7 +1978,12 @@ function scanDoc(cache, root, bundleDir, doc, requireAnchors) {
                 pushDrift(findings, doc.relPath, citation, problem.rule, problem.message, path.relative(root, resolution.path));
             }
         }
-        governing = { citedPath, resolvedPath: resolution.path };
+        governing = {
+            citedPath,
+            resolvedPath: resolution.path,
+            startLine,
+            endLine,
+        };
         lastStartLine = startLine;
     }
     // Heading-section citations -- see the "Heading-section citations" doc
@@ -1945,6 +2059,8 @@ function scanDoc(cache, root, bundleDir, doc, requireAnchors) {
                 namedFullAtoms.push({
                     index: a.index,
                     citedPath: a.citedPath,
+                    startLine: a.startLine,
+                    endLine: a.endLine,
                 });
             }
         }
@@ -1974,6 +2090,27 @@ function scanDoc(cache, root, bundleDir, doc, requireAnchors) {
                 pushAmbiguous(findings, doc.relPath, citation, resolution.candidates);
                 continue;
             }
+            // anchor-required-continuation (opt-in, warning) also applies to a
+            // bound short-form citation: it is just as anchor-less as a
+            // backtick continuation (see the "Short-form citations" doc block
+            // above), for the identical reason -- a bound short form cannot
+            // carry an anchor either, so it is flagged as well, rather than
+            // left as a silent gap in `--require-anchors`.
+            //
+            // `raw` here is synthesized from the parsed startLine/endLine
+            // (`:${rangeLabel}`) rather than carried from the match itself --
+            // `ShortFormMatch` (see there) does not retain the matched text.
+            // This is exact for `SHORT_FORM_COLON_RE` (`/:(\d+)-(\d+)/`) as
+            // written today, since re-stringifying the two captured numbers
+            // reproduces the source bytes; it would stop being exact if that
+            // regex ever tolerated something re-stringifying can't round-trip
+            // (e.g. a leading zero).
+            pushAnchorRequiredContinuation(findings, doc.relPath, citation, `:${rangeLabel}`, {
+                citedPath: targetPath,
+                resolvedPath: resolution.path,
+                startLine: target.startLine,
+                endLine: target.endLine,
+            }, requireAnchorsForDoc, root);
             const problem = checkShortFormTarget(targetPath, sf.startLine, sf.endLine, resolution.path);
             if (problem?.rule === "unreadable-target") {
                 pushUnreadable(findings, doc.relPath, citation, path.relative(root, resolution.path), problem.code ?? "UNKNOWN");