@hawkeyexl/manni 2.12.0 → 3.0.0

package/dist/index.d.ts

@@ -311,7 +311,12 @@ interface FingerprintContext {
 /** One external-metadata manifest (proposals 0037, 0038, 0039) joined to a collection. */
 interface ExternalMetadataConfig {
     file: string;
-    keys: string[];
+    /**
+     * The top-level keys the manifest owns. Absent (proposal 0068), it owns
+     * what each page's schemas mark `x-manni-location: external`, as `ownsKey`
+     * decides.
+     */
+    keys?: string[];
     tokenEnv?: string;
     join?: string;
 }
@@ -411,6 +416,158 @@ interface ConfigFile {
     encryptionKeyPrevious?: string;
 }
 
+interface BuiltinInfo {
+    id: string;
+    title: string;
+    description: string;
+}
+/**
+ * A schema `meta.register` loaded from a local file (proposal 0070), named
+ * everywhere by its own `$id`, as a built-in is named by its id.
+ */
+interface RegisteredSchema {
+    /** The schema's `$id`: `vendor:name:version`, or an `https://` URL. */
+    id: string;
+    /** The file, relative to the config file's directory, with forward slashes. */
+    file: string;
+    /** The file's absolute path. */
+    path: string;
+    /** The parsed schema: the object every lookup of `id` returns. */
+    schema: Record<string, unknown>;
+}
+/** The registered schemas of one config, keyed by `$id`. */
+type RegisteredSchemas = ReadonlyMap<string, RegisteredSchema>;
+declare function listBuiltins(): BuiltinInfo[];
+type RefKind = "builtin" | "file" | "url";
+declare function classifyRef(ref: string): {
+    kind: RefKind;
+    ref: string;
+};
+/**
+ * What a config recorded about one reference beyond the reference itself.
+ *
+ * Kept out of the ref string deliberately: the ref appears in every report,
+ * every baseline fingerprint, and `Validator`'s compile cache key, so it has to
+ * stay exactly the string the user wrote.
+ */
+interface SchemaPin {
+    /** Where the reference was vendored from — a URL, or a local path. */
+    source?: string;
+    /** `sha256-<64 hex>` the file's bytes must hash to. */
+    integrity?: string;
+}
+interface LoadSchemaOptions {
+    /**
+     * Directory a **relative local-file** ref is resolved against.
+     *
+     * Omitted means `process.cwd()`, which is what the CLI wants and what this
+     * always did. A library caller passing `cwd` to a command core needs the
+     * ref measured from *that* directory instead: `rebaseConfigSchemaRefs`
+     * deliberately leaves refs untouched when the config already sits in the
+     * run's `cwd`, so `./schema/house.json` arrives here exactly as written and
+     * was then read against the wrong directory.
+     *
+     * Resolved at read time rather than by rewriting the ref, and that choice is
+     * load-bearing: the ref string is what reports name, what `Validator` keys
+     * its compile cache on, and what every baseline fingerprint is taken over.
+     * Rewriting it to an absolute path would silently move every recorded
+     * baseline. `canonicalSchemaRef` in `baseline.ts` already measures a relative
+     * ref from the run's `cwd`, so this makes loading agree with fingerprinting
+     * rather than introducing a new convention.
+     */
+    fileBase?: string;
+    /** Abort a remote fetch after this many ms (default 10_000). */
+    timeoutMs?: number;
+    /** Reject a remote schema whose body exceeds this many bytes (default 5 MB). */
+    maxBytes?: number;
+    /**
+     * Directory for the cross-run schema cache. Omitted means **no disk cache**:
+     * the registry never guesses a project root, so a library caller gets the
+     * in-process behavior until it opts in. The command cores pass
+     * `schemaCacheDir(configDir ?? cwd)`.
+     */
+    cacheDir?: string;
+    /** Hours a cached entry stays fresh; `0` disables the cache (default 24). */
+    ttlHours?: number;
+    /**
+     * Never touch the network. A URL ref resolves from the disk cache — ignoring
+     * the TTL, since there is no re-fetch to fall back on — and an uncached one
+     * fails naming the URL. Built-ins and local files are unaffected.
+     *
+     * This is a *durability* control, not a trust boundary, and it never was:
+     * whether a document may name a URL at all is decided upstream by
+     * `schemaTrust` in `resolveSchemaSet`, which is the last place that still
+     * knows a ref came from a document rather than from an operator (proposal
+     * 0015). `offline` used to block that case by accident and was the only thing
+     * standing there; it is now free to mean only what it says.
+     */
+    offline?: boolean;
+    /**
+     * Provenance and integrity pins, keyed on the reference exactly as it is
+     * passed to `loadSchema`. Built by `collectSchemaPins` from the **rebased**
+     * config, so both sides spell a local path the same way; a config with no
+     * mapping-form `schemas:` entries produces an empty map and none of this
+     * runs.
+     */
+    pins?: ReadonlyMap<string, SchemaPin>;
+    /**
+     * The schemas `meta.register` loaded (proposal 0070), keyed by `$id`. A ref
+     * naming one resolves to its file's schema before anything else is
+     * consulted, so a registered `https://` id is never fetched.
+     */
+    registered?: RegisteredSchemas;
+}
+/** A fetched schema, with the bytes it arrived as. */
+interface FetchedSchema {
+    /** Exactly what the server sent, undecoded. */
+    bytes: Buffer;
+    /** The same payload, parsed and guarded. */
+    schema: Record<string, unknown>;
+}
+/**
+ * Fetch, size-cap, parse, and guard a remote schema. At most two requests.
+ *
+ * Exported for `schemas vendor`, which needs the raw bytes to write and to
+ * hash. Sharing this path rather than fetching separately is what keeps
+ * vendoring subject to the same size cap, retry policy, and payload guard as
+ * validation — a vendored error envelope would otherwise be committed to the
+ * repository and pass every document from then on.
+ *
+ * Deliberately **not** routed through the disk cache or `offline`: vendoring is
+ * an explicit request to download, and the cache stores a parsed schema rather
+ * than the bytes a pin has to be taken over.
+ */
+declare function fetchSchemaBytes(ref: string, options?: LoadSchemaOptions): Promise<FetchedSchema>;
+/**
+ * Settle the remote-schema options for one run, from the config and the flag.
+ *
+ * Lives here rather than in a command core because all three commands need the
+ * same answer, and because "where does the cache live" is a property of schema
+ * loading, not of `validate`. `root` is the config's directory when a config
+ * governs the run, so a developer running from `docs/` shares the cache with
+ * CI running from the repo root instead of quietly keeping a second one.
+ */
+declare function schemaLoadOptions(args: {
+    root: string;
+    /**
+     * Where a relative local-file schema ref is measured from — the run's `cwd`,
+     * not `root`. The two differ when a config was discovered in an ancestor, and
+     * a `--schema ./x.json` typed on the command line belongs to the directory
+     * the user was standing in, not to the config's.
+     */
+    fileBase?: string;
+    /** Config `schemaCache.ttlHours`. */
+    ttlHours?: number;
+    /** `--offline`, else config `offline:`. */
+    offline?: boolean;
+    /** From `collectSchemaPins(config)`; omitted when the config pins nothing. */
+    pins?: ReadonlyMap<string, SchemaPin>;
+    /** The config's registered schemas (`config.registered`), when it has any. */
+    registered?: RegisteredSchemas;
+}): LoadSchemaOptions;
+/** Load and return the JSON Schema object for a reference. */
+declare function loadSchema(ref: string, options?: LoadSchemaOptions): Promise<Record<string, unknown>>;
+
 /** Lines as an entry writes them: an integer for one line, `"L1-L2"` for several. */
 type LineSpec = number | string;
 /** Page lines as an editor numbers them, 1-based and inclusive. */
@@ -557,6 +714,16 @@ interface RangeResult {
 /** The seven built-in fields, in the order messages list them. */
 declare const DERIVABLE_FIELDS: readonly ["created", "last-updated", "authors", "owner", "reviewed-by", "last-reviewed", "provenance"];
 type BuiltinDerivableField = (typeof DERIVABLE_FIELDS)[number];
+/**
+ * The merge-safe fields (proposal 0069), in the order messages list them:
+ * the ones whose stamp, written in a pull request, still reads current after
+ * a squash merge. `derive.fields` absent manages these, and on each page only
+ * the ones its schemas claim.
+ */
+declare const MERGE_SAFE_FIELDS: readonly ["owner", "created", "last-updated", "provenance"];
+/** The dated fields the git source reads from the stamp a fact commit carries. */
+declare const STAMPED_DATE_FIELDS: readonly ["created", "last-updated"];
+type StampedDateField = (typeof STAMPED_DATE_FIELDS)[number];
 /**
  * A managed field name: one of the seven built-ins, or a key with an entry in
  * `derive.commands`. The config parser guarantees one or the other.
@@ -644,7 +811,14 @@ interface DeriveInput {
      * (proposal 0046), so evidence rule 2 reads the manifest's blob at each
      * commit rather than the page's frontmatter. Absent: the page's own.
      */
-    provenanceManifest?: ProvenanceManifestRef;
+    provenanceManifest?: ManifestRef;
+    /**
+     * Where the page's `created` and `last-updated` live when a manifest owns
+     * them (proposal 0069, rule 1), so the git source reads the stamp a fact
+     * commit carries from the manifest's blob at that commit as well as from
+     * the page's. A field with no entry: the page's own.
+     */
+    stampManifests?: Partial<Readonly<Record<StampedDateField, ManifestRef>>>;
     /**
      * `manni meta derive <path>:L1-L2 --generated-by <name>`: the file lines
      * each target names go to `generatedBy`, committed or not, unless evidence
@@ -657,8 +831,8 @@ interface DeriveInput {
         generatedBy: string;
     };
 }
-/** A manifest that holds one page's `provenance`, as the git source reads it at a commit. */
-interface ProvenanceManifestRef {
+/** A manifest that holds one page's managed field, as the git source reads it at a commit. */
+interface ManifestRef {
     /** The manifest file, absolute. */
     absPath: string;
     /** The page's key there: its path relative to the config directory, or its join value. */
@@ -801,6 +975,17 @@ interface SchemaOverride {
      * trap.
      */
     elements?: string[];
+    /**
+     * Put the default set first, then this entry's `schemas` (proposal 0070).
+     * Absent or `false` means the entry's `schemas` replace the set, as an
+     * override always did. An override never inherits the top-level `schemas`.
+     */
+    defaults?: boolean;
+    /**
+     * Stack the strict version of each default or registered schema in the
+     * entry's set right after its base, where one exists.
+     */
+    strict?: boolean;
 }
 /**
  * A `schemas:` entry in its long form: a reference plus where it came from and
@@ -886,8 +1071,12 @@ interface DeriveConfig {
      * The managed fields. Each is one of `DERIVABLE_FIELDS` or a key of
      * `commands`, never `$schema`, and never a key a manifest owns: a value
      * with two authorities has none.
+     *
+     * Absent means the merge-safe fields (`MERGE_SAFE_FIELDS`, proposal 0069),
+     * each managed only on a page whose schemas claim it as a top-level
+     * property. `[]` manages nothing. Read it through `managedFields`.
      */
-    fields: DerivableField[];
+    fields?: DerivableField[];
     /** Which sources to consult; absent means all of `DERIVE_SOURCES`. */
     sources?: DeriveSource[];
     /**
@@ -909,6 +1098,12 @@ interface DeriveConfig {
      * through `machinesOf`.
      */
     machines?: string[];
+    /**
+     * The collections whose members derive manages (proposal 0070). A file in
+     * none of them is neither stamped nor compared. Absent means every
+     * validated file. Read it through `deriveCovers`.
+     */
+    collections?: string[];
 }
 /** Defaults for the `fill` command; every key is overridable by a CLI flag. */
 interface FillConfig {
@@ -932,10 +1127,33 @@ interface SchemaCacheConfig {
 }
 interface DocmetaConfig {
     /**
-     * The default schema set. Each entry is either a reference string or a
-     * `{ ref, source?, integrity? }` mapping — see `SchemaEntry`.
+     * The schemas every file no override matches is judged by. Each entry is
+     * either a reference string or a `{ ref, source?, integrity? }` mapping —
+     * see `SchemaEntry`. They join the default set unless `defaults` is false.
      */
     schemas?: SchemaEntry[];
+    /**
+     * Put the default set first, then `schemas`, for the files no override
+     * matches (proposal 0070). Absent means `true`; `false` makes `schemas`
+     * replace the default set.
+     */
+    defaults?: boolean;
+    /**
+     * For those files, stack the strict version of each default or registered
+     * schema in the set right after its base, where one exists. Absent means
+     * `false`.
+     */
+    strict?: boolean;
+    /**
+     * JSON Schema files, or directories of them (`*.json`, recursively),
+     * relative to the config file. Each is loaded once and named by its `$id`.
+     */
+    register?: string[];
+    /**
+     * The schemas `register` names, loaded by `loadConfig` and keyed by `$id`.
+     * Not a key of the file: it is what the file's `register` produced.
+     */
+    registered?: RegisteredSchemas;
     overrides?: SchemaOverride[];
     /**
      * Named corpus checks `validate` runs after the per-file schemas, when the
@@ -1592,7 +1810,21 @@ declare function loadExternalMetadata(collections: readonly CollectionConfig[],
  */
 declare function mergeExternalMetadata(label: string, extracted: ExtractedMetadata, index: ExternalMetadataIndex | null, memberOf: readonly string[], base: string, options?: {
     encryptionKey?: () => string | undefined;
+    /**
+     * The top-level keys the document's schemas mark `x-manni-location:
+     * external` (proposal 0068), which is what a manifest with no `keys`
+     * owns. Absent, such a manifest owns nothing for this document.
+     */
+    marked?: ReadonlySet<string>;
 }): MergedMetadata;
+/**
+ * The top-level keys one document's schemas mark `x-manni-location:
+ * external`, read over `probe`: the document's metadata with everything its
+ * keyless manifests supply for it (proposal 0068). `undefined` when the
+ * document's schemas cannot be resolved or loaded, so the caller reports that
+ * the way it always has and a keyless manifest owns nothing for it.
+ */
+type PageMarks = (label: string, probe: Readonly<Record<string, unknown>>, memberOf: readonly string[]) => Promise<ReadonlySet<string> | undefined>;
 /** The `/key` pointer for an external-metadata finding, RFC 6901 escaped. */
 declare function externalMetadataPointer(key: string): string;
 /**
@@ -1622,134 +1854,6 @@ declare function orphanJoins(index: ExternalMetadataIndex | null, matched: Reado
 /** The operational error an orphan check raises, naming the first entry. */
 declare function orphanError(orphans: readonly ExternalMetadataEntry[]): DocmetaError;
 
-interface BuiltinInfo {
-    id: string;
-    title: string;
-    description: string;
-}
-declare function listBuiltins(): BuiltinInfo[];
-type RefKind = "builtin" | "file" | "url";
-declare function classifyRef(ref: string): {
-    kind: RefKind;
-    ref: string;
-};
-/**
- * What a config recorded about one reference beyond the reference itself.
- *
- * Kept out of the ref string deliberately: the ref appears in every report,
- * every baseline fingerprint, and `Validator`'s compile cache key, so it has to
- * stay exactly the string the user wrote.
- */
-interface SchemaPin {
-    /** Where the reference was vendored from — a URL, or a local path. */
-    source?: string;
-    /** `sha256-<64 hex>` the file's bytes must hash to. */
-    integrity?: string;
-}
-interface LoadSchemaOptions {
-    /**
-     * Directory a **relative local-file** ref is resolved against.
-     *
-     * Omitted means `process.cwd()`, which is what the CLI wants and what this
-     * always did. A library caller passing `cwd` to a command core needs the
-     * ref measured from *that* directory instead: `rebaseConfigSchemaRefs`
-     * deliberately leaves refs untouched when the config already sits in the
-     * run's `cwd`, so `./schema/house.json` arrives here exactly as written and
-     * was then read against the wrong directory.
-     *
-     * Resolved at read time rather than by rewriting the ref, and that choice is
-     * load-bearing: the ref string is what reports name, what `Validator` keys
-     * its compile cache on, and what every baseline fingerprint is taken over.
-     * Rewriting it to an absolute path would silently move every recorded
-     * baseline. `canonicalSchemaRef` in `baseline.ts` already measures a relative
-     * ref from the run's `cwd`, so this makes loading agree with fingerprinting
-     * rather than introducing a new convention.
-     */
-    fileBase?: string;
-    /** Abort a remote fetch after this many ms (default 10_000). */
-    timeoutMs?: number;
-    /** Reject a remote schema whose body exceeds this many bytes (default 5 MB). */
-    maxBytes?: number;
-    /**
-     * Directory for the cross-run schema cache. Omitted means **no disk cache**:
-     * the registry never guesses a project root, so a library caller gets the
-     * in-process behavior until it opts in. The command cores pass
-     * `schemaCacheDir(configDir ?? cwd)`.
-     */
-    cacheDir?: string;
-    /** Hours a cached entry stays fresh; `0` disables the cache (default 24). */
-    ttlHours?: number;
-    /**
-     * Never touch the network. A URL ref resolves from the disk cache — ignoring
-     * the TTL, since there is no re-fetch to fall back on — and an uncached one
-     * fails naming the URL. Built-ins and local files are unaffected.
-     *
-     * This is a *durability* control, not a trust boundary, and it never was:
-     * whether a document may name a URL at all is decided upstream by
-     * `schemaTrust` in `resolveSchemaSet`, which is the last place that still
-     * knows a ref came from a document rather than from an operator (proposal
-     * 0015). `offline` used to block that case by accident and was the only thing
-     * standing there; it is now free to mean only what it says.
-     */
-    offline?: boolean;
-    /**
-     * Provenance and integrity pins, keyed on the reference exactly as it is
-     * passed to `loadSchema`. Built by `collectSchemaPins` from the **rebased**
-     * config, so both sides spell a local path the same way; a config with no
-     * mapping-form `schemas:` entries produces an empty map and none of this
-     * runs.
-     */
-    pins?: ReadonlyMap<string, SchemaPin>;
-}
-/** A fetched schema, with the bytes it arrived as. */
-interface FetchedSchema {
-    /** Exactly what the server sent, undecoded. */
-    bytes: Buffer;
-    /** The same payload, parsed and guarded. */
-    schema: Record<string, unknown>;
-}
-/**
- * Fetch, size-cap, parse, and guard a remote schema. At most two requests.
- *
- * Exported for `schemas vendor`, which needs the raw bytes to write and to
- * hash. Sharing this path rather than fetching separately is what keeps
- * vendoring subject to the same size cap, retry policy, and payload guard as
- * validation — a vendored error envelope would otherwise be committed to the
- * repository and pass every document from then on.
- *
- * Deliberately **not** routed through the disk cache or `offline`: vendoring is
- * an explicit request to download, and the cache stores a parsed schema rather
- * than the bytes a pin has to be taken over.
- */
-declare function fetchSchemaBytes(ref: string, options?: LoadSchemaOptions): Promise<FetchedSchema>;
-/**
- * Settle the remote-schema options for one run, from the config and the flag.
- *
- * Lives here rather than in a command core because all three commands need the
- * same answer, and because "where does the cache live" is a property of schema
- * loading, not of `validate`. `root` is the config's directory when a config
- * governs the run, so a developer running from `docs/` shares the cache with
- * CI running from the repo root instead of quietly keeping a second one.
- */
-declare function schemaLoadOptions(args: {
-    root: string;
-    /**
-     * Where a relative local-file schema ref is measured from — the run's `cwd`,
-     * not `root`. The two differ when a config was discovered in an ancestor, and
-     * a `--schema ./x.json` typed on the command line belongs to the directory
-     * the user was standing in, not to the config's.
-     */
-    fileBase?: string;
-    /** Config `schemaCache.ttlHours`. */
-    ttlHours?: number;
-    /** `--offline`, else config `offline:`. */
-    offline?: boolean;
-    /** From `collectSchemaPins(config)`; omitted when the config pins nothing. */
-    pins?: ReadonlyMap<string, SchemaPin>;
-}): LoadSchemaOptions;
-/** Load and return the JSON Schema object for a reference. */
-declare function loadSchema(ref: string, options?: LoadSchemaOptions): Promise<Record<string, unknown>>;
-
 /**
  * `x-manni-location` (proposal 0047): where a schema would like a top-level
  * key's value stored, on the page or in external metadata.
@@ -1843,6 +1947,16 @@ declare class Validator {
      * whose evaluated branches say both gives that key no preference.
      */
     locationPreferences(data: Record<string, unknown>, refs: string[]): Promise<Map<string, LocationPreference>>;
+    /**
+     * The top-level property names the schemas in `refs` claim: the keys of
+     * each schema's own `properties`, each once. What a page's schema set
+     * claims decides which merge-safe fields a `derive:` block with no `fields`
+     * manages on it (proposal 0069). A property reached only through `allOf`,
+     * `$ref` or a conditional is not counted, so a schema that should manage a
+     * field names it in its root `properties`. A schema that fails to load or
+     * compile throws, as it would for `validate`.
+     */
+    claimedProperties(refs: readonly string[]): Promise<Set<string>>;
     /**
      * Validate `data` against every schema in `refs`. Returns all violations,
      * each tagged with the schema that produced it and a source line via
@@ -2129,8 +2243,16 @@ interface QueryRun {
 }
 declare function runQuery(opts: QueryOptions): Promise<QueryRun>;
 
+/** One schema `meta.register` loaded: its `$id` and its file. */
+interface RegisteredInfo {
+    id: string;
+    /** Relative to the config file, with forward slashes. */
+    file: string;
+}
 interface SchemasInfo {
     builtins: BuiltinInfo[];
+    /** The governing config's registered schemas (proposal 0070). */
+    registered: RegisteredInfo[];
     formats: {
         name: string;
         extensions: string[];
@@ -2138,7 +2260,7 @@ interface SchemasInfo {
         writable: boolean;
     }[];
 }
-declare function getSchemasInfo(): SchemasInfo;
+declare function getSchemasInfo(registered?: RegisteredSchemas): SchemasInfo;
 /**
  * Where a vendored schema lands by default.
  *
@@ -2381,6 +2503,17 @@ interface FillOptions {
     concurrency?: number;
     /** Include the filled document on each result (used for stdin and tests). */
     includeContent?: boolean;
+    /**
+     * The glossary term labels offered for the fields that name a term. When
+     * given, they are used instead of the registered term label source (see
+     * `src/shared/term-labels.ts`). When absent, that source is used, if any.
+     *
+     * Labels only. The registered source also knows each term's id, which a
+     * term relation (`broader`, `narrower`, `related-terms`, `see`) accepts as
+     * `term check` does. With `termLabels`, no ids are known, so a relation
+     * value must be a label; an id is retried and then skipped.
+     */
+    termLabels?: readonly string[];
     /** Test seam: bypasses `makeProvider`, so no API key is needed. */
     inferenceProvider?: InferenceProvider;
     /**
@@ -2606,11 +2739,15 @@ declare function reencryptMetadata(page: {
 }): ReencryptMetadataResult;
 
 /**
- * Applied when nothing else resolves. Seven-Action is safe to include here
- * because it constrains `action` — a key documents don't otherwise carry — and
- * does not require it, so adding it fails nothing that passed before.
- * Diataxis is deliberately absent: it both requires and constrains `type`, so
- * defaulting it would fail every repo not already on Diataxis.
+ * The default set (proposal 0070): what a file is judged by when nothing
+ * replaces it, and what `schemas:` joins unless `defaults: false`.
+ *
+ * Seven-Action constrains `action`, a key documents don't otherwise carry,
+ * and requires nothing. Diataxis is deliberately absent: it both requires and
+ * constrains `type`, so defaulting it would fail every repo not already on
+ * Diataxis. The manni vocabularies follow; core requires `title` and
+ * `description`, and nothing else in the set requires anything.
+ * Terminology, artifact-evals and every `-strict` overlay stay opt-in.
  */
 declare const DEFAULT_SCHEMAS: readonly string[];
 /**
@@ -3542,7 +3679,7 @@ interface CitationSource {
     /** The git commit hash the pin was taken at: 7 to 64 lowercase hex. */
     "commit-sha"?: string;
 }
-/** One entry of `citations`, as the schema (`manni:citations:1.0.0-proposal.4`) spells it. */
+/** One entry of `citations`, as the schema (`manni:citations:1.0.0`) spells it. */
 interface Citation {
     id?: string;
     claim?: CitationClaim;
@@ -3782,6 +3919,17 @@ interface GitClient {
      * is `changed` with no baseline.
      */
     pageCommits?(path: string, cap: number): Promise<PageHistory>;
+    /**
+     * Whether the clone is shallow, so a commit it lacks may still be in the
+     * history. A client without it, or without `isAncestor`, never re-records
+     * a commit for being outside the history.
+     */
+    shallow?(): Promise<boolean>;
+    /**
+     * Whether `commit` is `of` or one of its ancestors. A commit the clone does
+     * not have is not.
+     */
+    isAncestor?(commit: string, of: string): Promise<boolean>;
 }
 /**
  * The files a source may resolve to. Built from `git ls-files` when git is
@@ -4072,6 +4220,8 @@ interface UpdateOptions extends Omit<CheckOptions, "baseline" | "writeBaseline">
  * for pins. `from` and `to` carry the same values, but which of the two a row
  * holds depends on the row, so they are easy to misuse.
  */
+/** Why `--recommit` re-recorded a commit. */
+type RecommitReason = "not-contained" | "not-in-history";
 interface UpdateRewrite {
     id?: string;
     /** Index in the page's `citations`. */
@@ -4106,6 +4256,12 @@ interface UpdateRewrite {
     /** A re-committed source: the commit it recorded, and the one it records now. */
     fromCommit?: string;
     toCommit?: string;
+    /**
+     * A re-committed source: why the recorded commit could not stand.
+     * `not-contained`: it does not hold the pinned lines. `not-in-history`: it
+     * holds them, but is not in the history of HEAD.
+     */
+    because?: RecommitReason;
     /** A re-anchored claim: the span that held, in file lines. */
     lines?: string;
     /** A re-anchored claim: the span now pinned, in file lines. */
@@ -4973,6 +5129,45 @@ declare function shiftedEntries(opts: ShiftOptions): Shifted;
 /** A copy of a manifest entry with its `claim.lines` replaced. */
 declare function withClaimLines(entry: unknown, lines: LineSpec): unknown;
 
+interface SpliceManifestOptions {
+    /**
+     * The document entry: its path relative to the config's directory, or its
+     * value of the join field when `join` names one. A path entry matches
+     * however the manifest spells it (`./docs/a.md` is `docs/a.md`); a join
+     * value matches exactly.
+     */
+    entry: string;
+    /** The owned key to write. */
+    key: string;
+    /** The value to write. Mappings and lists are written in block style. */
+    value: unknown;
+    /** `path` (the default) or the frontmatter field the manifest joins on. */
+    join?: string;
+    /** The manifest as the run reports it, for error messages. */
+    file?: string;
+}
+interface SplicedManifest {
+    /** The whole manifest, with the one value rewritten. */
+    text: string;
+    /** 1-based line where the written value now starts. */
+    line: number;
+}
+/**
+ * Rewrite `options.key` of `options.entry` in the manifest `text` to
+ * `options.value`, and return the new text and the line the value starts on.
+ *
+ * Throws `DocmetaError`, and never returns a partial result, when:
+ *  - the text is not valid YAML, or its top level is not a mapping;
+ *  - the entry is named twice, or is not a mapping;
+ *  - the key is set twice in the entry, or is `$schema`;
+ *  - the value is `undefined`;
+ *  - the key or entry is absent and would go into a flow mapping that has
+ *    members (`{ jira: A }`), which this writer does not add to;
+ *  - the key is written as an explicit `? key`;
+ *  - the result does not read back as written.
+ */
+declare function spliceManifestValue(text: string, options: SpliceManifestOptions): SplicedManifest;
+
 /** The one key cite keeps in a manifest. */
 declare const CITATIONS_KEY = "citations";
 /** A manifest that owns `citations` for one collection. */
@@ -4992,6 +5187,15 @@ interface CitationManifest {
      * created by the first write.
      */
     pattern?: string;
+    /**
+     * The manifest names no `keys` (proposal 0068), so it keeps a page's
+     * citations only when the page's schemas mark `citations` external. The
+     * declaration, for `ownsKey`.
+     */
+    implied?: {
+        collection: CollectionConfig;
+        manifest: ExternalMetadataConfig;
+    };
 }
 /** Where one page's citations are kept, and what the manifest already holds. */
 interface PageSidecar {
@@ -5016,7 +5220,7 @@ interface CitationSidecars {
     configDir: string;
     /** Directory the run's file labels are relative to. */
     base: string;
-    forPage(label: string, content: string, format?: string): PageSidecar;
+    forPage(label: string, content: string, format?: string): Promise<PageSidecar>;
     /**
      * Manifest entries naming a page this run did not load, under meta's own
      * corpus invariant. `covered` names the collections a `--collection` run
@@ -5050,6 +5254,11 @@ interface LoadSidecarOptions {
     key?: string;
     /** The tool's error class; `CiteError` unless a sibling command says otherwise. */
     toError?: (message: string) => Error;
+    /**
+     * What a page's schemas mark external (proposal 0068), asked only for a
+     * page a manifest with no `keys` may keep citations for.
+     */
+    marks?: () => Promise<PageMarks | undefined>;
 }
 /** `collection <name>: citations cannot come from a URL manifest, because cite writes them.` */
 declare function urlManifestRefusal(source: string, collection: string): string;
@@ -5087,45 +5296,6 @@ declare function sidecarsFor(run: CiteRun, over?: {
     pages?: readonly string[];
 }): Promise<CitationSidecars | null>;
 
-interface SpliceManifestOptions {
-    /**
-     * The document entry: its path relative to the config's directory, or its
-     * value of the join field when `join` names one. A path entry matches
-     * however the manifest spells it (`./docs/a.md` is `docs/a.md`); a join
-     * value matches exactly.
-     */
-    entry: string;
-    /** The owned key to write. */
-    key: string;
-    /** The value to write. Mappings and lists are written in block style. */
-    value: unknown;
-    /** `path` (the default) or the frontmatter field the manifest joins on. */
-    join?: string;
-    /** The manifest as the run reports it, for error messages. */
-    file?: string;
-}
-interface SplicedManifest {
-    /** The whole manifest, with the one value rewritten. */
-    text: string;
-    /** 1-based line where the written value now starts. */
-    line: number;
-}
-/**
- * Rewrite `options.key` of `options.entry` in the manifest `text` to
- * `options.value`, and return the new text and the line the value starts on.
- *
- * Throws `DocmetaError`, and never returns a partial result, when:
- *  - the text is not valid YAML, or its top level is not a mapping;
- *  - the entry is named twice, or is not a mapping;
- *  - the key is set twice in the entry, or is `$schema`;
- *  - the value is `undefined`;
- *  - the key or entry is absent and would go into a flow mapping that has
- *    members (`{ jira: A }`), which this writer does not add to;
- *  - the key is written as an explicit `? key`;
- *  - the result does not read back as written.
- */
-declare function spliceManifestValue(text: string, options: SpliceManifestOptions): SplicedManifest;
-
 /** One entry's one key: what an edit rewrites, and what a conflict is about. */
 interface ManifestKey {
     /** The entry, as the manifest spells it. */
@@ -5629,6 +5799,7 @@ type index$1_PrettyOptions = PrettyOptions;
 declare const index$1_RULE_ID_PREFIX: typeof RULE_ID_PREFIX;
 type index$1_ReadPageOptions = ReadPageOptions;
 type index$1_ReadSourceResult = ReadSourceResult;
+type index$1_RecommitReason = RecommitReason;
 type index$1_ReencryptCitationsResult = ReencryptCitationsResult;
 type index$1_ReencryptEntriesResult = ReencryptEntriesResult;
 type index$1_ReencryptOptions = ReencryptOptions;
@@ -5776,7 +5947,7 @@ declare const index$1_urlManifestRefusal: typeof urlManifestRefusal;
 declare const index$1_validateEntry: typeof validateEntry;
 declare const index$1_withClaimLines: typeof withClaimLines;
 declare namespace index$1 {
-  export { type index$1_AddOptions as AddOptions, type index$1_AddResult as AddResult, type index$1_BuildIndexOptions as BuildIndexOptions, index$1_CITATIONS_KEY as CITATIONS_KEY, index$1_CITE_RULES as CITE_RULES, index$1_CITE_SECTION as CITE_SECTION, type index$1_CheckOptions as CheckOptions, type index$1_CheckPageOptions as CheckPageOptions, type index$1_CheckRun as CheckRun, type index$1_Citation as Citation, type index$1_CitationAnchor as CitationAnchor, type index$1_CitationClaim as CitationClaim, type index$1_CitationFinding as CitationFinding, type index$1_CitationInput as CitationInput, type index$1_CitationManifest as CitationManifest, type index$1_CitationOrigin as CitationOrigin, type index$1_CitationResult as CitationResult, type index$1_CitationSidecars as CitationSidecars, type index$1_CitationSource as CitationSource, type index$1_CiteConfig as CiteConfig, index$1_CiteError as CiteError, type index$1_CiteRule as CiteRule, type index$1_CiteRun as CiteRun, type index$1_CiteRunOptions as CiteRunOptions, type index$1_CiteSeverity as CiteSeverity, type index$1_ClaimEnd as ClaimEnd, type index$1_ClaimHistory as ClaimHistory, type index$1_ClaimHistoryInput as ClaimHistoryInput, type index$1_ClaimStatus as ClaimStatus, type index$1_ClaimUnit as ClaimUnit, type index$1_ClassifyOptions as ClassifyOptions, index$1_DEFAULT_CITE_BASELINE_PATH as DEFAULT_CITE_BASELINE_PATH, index$1_DEFAULT_SEVERITY as DEFAULT_SEVERITY, type index$1_EntryPath as EntryPath, index$1_FILE_PATTERN as FILE_PATTERN, type index$1_FindWindowsOptions as FindWindowsOptions, index$1_GIT_UNAVAILABLE_COMMIT as GIT_UNAVAILABLE_COMMIT, index$1_GIT_UNAVAILABLE_HISTORY as GIT_UNAVAILABLE_HISTORY, type index$1_GitClient as GitClient, type index$1_HeldManifest as HeldManifest, type index$1_History as History, type index$1_InlineStatement as InlineStatement, type index$1_LineSpec as LineSpec, type index$1_LoadSidecarOptions as LoadSidecarOptions, type index$1_LoadedCiteConfig as LoadedCiteConfig, index$1_MARKER_JSON as MARKER_JSON, index$1_MAX_MARKERS_PER_PAGE as MAX_MARKERS_PER_PAGE, index$1_MAX_PAGE_COMMITS as MAX_PAGE_COMMITS, index$1_MAX_RANGE_LINES as MAX_RANGE_LINES, index$1_MOVE_BUDGET_BYTES as MOVE_BUDGET_BYTES, index$1_MOVE_WINDOW_LINES as MOVE_WINDOW_LINES, type ManifestChange$1 as ManifestChange, index$1_ManifestSet as ManifestSet, type index$1_ManifestWrite as ManifestWrite, type index$1_MarkerEnd as MarkerEnd, type index$1_MintOptions as MintOptions, type index$1_MisplacedMarker as MisplacedMarker, type index$1_MisplacedMarkerReport as MisplacedMarkerReport, type index$1_MissingReason as MissingReason, type index$1_NoUnit as NoUnit, type index$1_OriginKind as OriginKind, index$1_PAGE_HISTORY_UNAVAILABLE as PAGE_HISTORY_UNAVAILABLE, type index$1_PageCitation as PageCitation, type index$1_PageCitationReport as PageCitationReport, type index$1_PageCitations as PageCitations, type index$1_PageCommit as PageCommit, type index$1_PageHistory as PageHistory, type index$1_PageLines as PageLines, type index$1_PageSidecar as PageSidecar, type index$1_PrettyOptions as PrettyOptions, index$1_RULE_ID_PREFIX as RULE_ID_PREFIX, type index$1_ReadPageOptions as ReadPageOptions, type index$1_ReadSourceResult as ReadSourceResult, type index$1_ReencryptCitationsResult as ReencryptCitationsResult, type index$1_ReencryptEntriesResult as ReencryptEntriesResult, type index$1_ReencryptOptions as ReencryptOptions, type index$1_ReencryptedCitation as ReencryptedCitation, type index$1_RefineClaimInput as RefineClaimInput, type index$1_Removal as Removal, type index$1_RemoveOptions as RemoveOptions, type index$1_RemovePage as RemovePage, type index$1_RemoveRun as RemoveRun, index$1_SRC_PATTERN as SRC_PATTERN, type index$1_ShiftOptions as ShiftOptions, type index$1_Shifted as Shifted, type index$1_ShownFile as ShownFile, type index$1_SourceEnd as SourceEnd, type index$1_SourceIndex as SourceIndex, type index$1_SourceRange as SourceRange, type index$1_SourceStatus as SourceStatus, type index$1_StatementForm as StatementForm, type index$1_TextEdit as TextEdit, type index$1_UpdateOptions as UpdateOptions, type index$1_UpdatePage as UpdatePage, type index$1_UpdateRewrite as UpdateRewrite, type index$1_UpdateRun as UpdateRun, index$1_anchoredLines as anchoredLines, index$1_appendFrontmatterCitation as appendFrontmatterCitation, index$1_blockMatches as blockMatches, index$1_bodyLineOf as bodyLineOf, index$1_buildSourceIndex as buildSourceIndex, index$1_checkCitations as checkCitations, index$1_citationInputs as citationInputs, index$1_claimDiff as claimDiff, index$1_claimEnd as claimEnd, index$1_claimHistory as claimHistory, index$1_claimLine as claimLine, index$1_claimMessageFor as claimMessageFor, index$1_claimWords as claimWords, index$1_classifyCitation as classifyCitation, index$1_detectEol as detectEol, index$1_duplicateJoinRefusal as duplicateJoinRefusal, index$1_entryObject as entryObject, index$1_errorSite as errorSite, index$1_fenceSpanAt as fenceSpanAt, index$1_fencedBlockAfter as fencedBlockAfter, index$1_fencedBlockAt as fencedBlockAt, index$1_fencedBlocks as fencedBlocks, index$1_findWindows as findWindows, index$1_findingsFor as findingsFor, index$1_formatSrc as formatSrc, index$1_formatStatement as formatStatement, index$1_gitClient as gitClient, index$1_hashLines as hashLines, index$1_hashRange as hashRange, index$1_historyOf as historyOf, index$1_holdsWords as holdsWords, index$1_insertStatementBefore as insertStatementBefore, index$1_insideFence as insideFence, index$1_isBoundLine as isBoundLine, index$1_isCiteRule as isCiteRule, index$1_isKeyedPin as isKeyedPin, index$1_isTableRow as isTableRow, index$1_isUnitText as isUnitText, index$1_itemLine as itemLine, index$1_lineAt as lineAt, index$1_lineSpec as lineSpec, index$1_loadCitationSidecars as loadCitationSidecars, index$1_loadCiteConfig as loadCiteConfig, index$1_markerClaimEnd as markerClaimEnd, index$1_markerRunAt as markerRunAt, index$1_markerUnit as markerUnit, index$1_messageFor as messageFor, index$1_mintCitation as mintCitation, index$1_misplacedMarkerAt as misplacedMarkerAt, index$1_misplacedMarkers as misplacedMarkers, index$1_misplacedMessageFor as misplacedMessageFor, index$1_movedUnit as movedUnit, index$1_noGit as noGit, index$1_noUnitAt as noUnitAt, index$1_normalizeText as normalizeText, index$1_normalizeWhitespace as normalizeWhitespace, index$1_offsetOfLine as offsetOfLine, index$1_orphanRefusal as orphanRefusal, index$1_ownedMessage as ownedMessage, index$1_paragraphAfter as paragraphAfter, index$1_parseCiteConfig as parseCiteConfig, index$1_parseLines as parseLines, index$1_parseSrc as parseSrc, index$1_parseStatements as parseStatements, index$1_pickExtractor as pickExtractor, index$1_pinOfLines as pinOfLines, index$1_pre43Span as pre43Span, index$1_rangeLines as rangeLines, index$1_readCiteConfigFile as readCiteConfigFile, index$1_readPage as readPage, index$1_readSource as readSource, index$1_reencryptCitationEntries as reencryptCitationEntries, index$1_reencryptCitations as reencryptCitations, index$1_refineClaim as refineClaim, index$1_refusalLine as refusalLine, index$1_removalLine as removalLine, index$1_removeFrontmatterCitations as removeFrontmatterCitations, index$1_removeLine as removeLine, index$1_renderCheckGithub as renderCheckGithub, index$1_renderCheckJson as renderCheckJson, index$1_renderCheckPretty as renderCheckPretty, index$1_renderRemoveJson as renderRemoveJson, index$1_renderRemovePretty as renderRemovePretty, index$1_renderUpdateJson as renderUpdateJson, index$1_renderUpdatePretty as renderUpdatePretty, index$1_resolveCiteRun as resolveCiteRun, index$1_resolveSeverity as resolveSeverity, index$1_rewriteLine as rewriteLine, index$1_ruleId as ruleId, index$1_runAdd as runAdd, index$1_runCheck as runCheck, index$1_runRemove as runRemove, index$1_runUpdate as runUpdate, index$1_runsHolding as runsHolding, index$1_sentencesOf as sentencesOf, index$1_sharesSentence as sharesSentence, index$1_shiftedEntries as shiftedEntries, index$1_shortCommit as shortCommit, index$1_shortLine as shortLine, index$1_shortPin as shortPin, index$1_shortSrc as shortSrc, index$1_sidecarsFor as sidecarsFor, index$1_sliceLines as sliceLines, index$1_sourceRange as sourceRange, index$1_spellAt as spellAt, index$1_spellLines as spellLines, index$1_spellSource as spellSource, index$1_splice as splice, index$1_spliceEntryField as spliceEntryField, index$1_splitLines as splitLines, index$1_splitUnit as splitUnit, index$1_statementForms as statementForms, index$1_stripMarkers as stripMarkers, index$1_toBodyLines as toBodyLines, index$1_toFileLines as toFileLines, index$1_toValidationResult as toValidationResult, index$1_twoManifestsRefusal as twoManifestsRefusal, index$1_unifiedDiff as unifiedDiff, index$1_unitAt as unitAt, index$1_unitText as unitText, index$1_urlManifestRefusal as urlManifestRefusal, index$1_validateEntry as validateEntry, index$1_withClaimLines as withClaimLines };
+  export { type index$1_AddOptions as AddOptions, type index$1_AddResult as AddResult, type index$1_BuildIndexOptions as BuildIndexOptions, index$1_CITATIONS_KEY as CITATIONS_KEY, index$1_CITE_RULES as CITE_RULES, index$1_CITE_SECTION as CITE_SECTION, type index$1_CheckOptions as CheckOptions, type index$1_CheckPageOptions as CheckPageOptions, type index$1_CheckRun as CheckRun, type index$1_Citation as Citation, type index$1_CitationAnchor as CitationAnchor, type index$1_CitationClaim as CitationClaim, type index$1_CitationFinding as CitationFinding, type index$1_CitationInput as CitationInput, type index$1_CitationManifest as CitationManifest, type index$1_CitationOrigin as CitationOrigin, type index$1_CitationResult as CitationResult, type index$1_CitationSidecars as CitationSidecars, type index$1_CitationSource as CitationSource, type index$1_CiteConfig as CiteConfig, index$1_CiteError as CiteError, type index$1_CiteRule as CiteRule, type index$1_CiteRun as CiteRun, type index$1_CiteRunOptions as CiteRunOptions, type index$1_CiteSeverity as CiteSeverity, type index$1_ClaimEnd as ClaimEnd, type index$1_ClaimHistory as ClaimHistory, type index$1_ClaimHistoryInput as ClaimHistoryInput, type index$1_ClaimStatus as ClaimStatus, type index$1_ClaimUnit as ClaimUnit, type index$1_ClassifyOptions as ClassifyOptions, index$1_DEFAULT_CITE_BASELINE_PATH as DEFAULT_CITE_BASELINE_PATH, index$1_DEFAULT_SEVERITY as DEFAULT_SEVERITY, type index$1_EntryPath as EntryPath, index$1_FILE_PATTERN as FILE_PATTERN, type index$1_FindWindowsOptions as FindWindowsOptions, index$1_GIT_UNAVAILABLE_COMMIT as GIT_UNAVAILABLE_COMMIT, index$1_GIT_UNAVAILABLE_HISTORY as GIT_UNAVAILABLE_HISTORY, type index$1_GitClient as GitClient, type index$1_HeldManifest as HeldManifest, type index$1_History as History, type index$1_InlineStatement as InlineStatement, type index$1_LineSpec as LineSpec, type index$1_LoadSidecarOptions as LoadSidecarOptions, type index$1_LoadedCiteConfig as LoadedCiteConfig, index$1_MARKER_JSON as MARKER_JSON, index$1_MAX_MARKERS_PER_PAGE as MAX_MARKERS_PER_PAGE, index$1_MAX_PAGE_COMMITS as MAX_PAGE_COMMITS, index$1_MAX_RANGE_LINES as MAX_RANGE_LINES, index$1_MOVE_BUDGET_BYTES as MOVE_BUDGET_BYTES, index$1_MOVE_WINDOW_LINES as MOVE_WINDOW_LINES, type ManifestChange$1 as ManifestChange, index$1_ManifestSet as ManifestSet, type index$1_ManifestWrite as ManifestWrite, type index$1_MarkerEnd as MarkerEnd, type index$1_MintOptions as MintOptions, type index$1_MisplacedMarker as MisplacedMarker, type index$1_MisplacedMarkerReport as MisplacedMarkerReport, type index$1_MissingReason as MissingReason, type index$1_NoUnit as NoUnit, type index$1_OriginKind as OriginKind, index$1_PAGE_HISTORY_UNAVAILABLE as PAGE_HISTORY_UNAVAILABLE, type index$1_PageCitation as PageCitation, type index$1_PageCitationReport as PageCitationReport, type index$1_PageCitations as PageCitations, type index$1_PageCommit as PageCommit, type index$1_PageHistory as PageHistory, type index$1_PageLines as PageLines, type index$1_PageSidecar as PageSidecar, type index$1_PrettyOptions as PrettyOptions, index$1_RULE_ID_PREFIX as RULE_ID_PREFIX, type index$1_ReadPageOptions as ReadPageOptions, type index$1_ReadSourceResult as ReadSourceResult, type index$1_RecommitReason as RecommitReason, type index$1_ReencryptCitationsResult as ReencryptCitationsResult, type index$1_ReencryptEntriesResult as ReencryptEntriesResult, type index$1_ReencryptOptions as ReencryptOptions, type index$1_ReencryptedCitation as ReencryptedCitation, type index$1_RefineClaimInput as RefineClaimInput, type index$1_Removal as Removal, type index$1_RemoveOptions as RemoveOptions, type index$1_RemovePage as RemovePage, type index$1_RemoveRun as RemoveRun, index$1_SRC_PATTERN as SRC_PATTERN, type index$1_ShiftOptions as ShiftOptions, type index$1_Shifted as Shifted, type index$1_ShownFile as ShownFile, type index$1_SourceEnd as SourceEnd, type index$1_SourceIndex as SourceIndex, type index$1_SourceRange as SourceRange, type index$1_SourceStatus as SourceStatus, type index$1_StatementForm as StatementForm, type index$1_TextEdit as TextEdit, type index$1_UpdateOptions as UpdateOptions, type index$1_UpdatePage as UpdatePage, type index$1_UpdateRewrite as UpdateRewrite, type index$1_UpdateRun as UpdateRun, index$1_anchoredLines as anchoredLines, index$1_appendFrontmatterCitation as appendFrontmatterCitation, index$1_blockMatches as blockMatches, index$1_bodyLineOf as bodyLineOf, index$1_buildSourceIndex as buildSourceIndex, index$1_checkCitations as checkCitations, index$1_citationInputs as citationInputs, index$1_claimDiff as claimDiff, index$1_claimEnd as claimEnd, index$1_claimHistory as claimHistory, index$1_claimLine as claimLine, index$1_claimMessageFor as claimMessageFor, index$1_claimWords as claimWords, index$1_classifyCitation as classifyCitation, index$1_detectEol as detectEol, index$1_duplicateJoinRefusal as duplicateJoinRefusal, index$1_entryObject as entryObject, index$1_errorSite as errorSite, index$1_fenceSpanAt as fenceSpanAt, index$1_fencedBlockAfter as fencedBlockAfter, index$1_fencedBlockAt as fencedBlockAt, index$1_fencedBlocks as fencedBlocks, index$1_findWindows as findWindows, index$1_findingsFor as findingsFor, index$1_formatSrc as formatSrc, index$1_formatStatement as formatStatement, index$1_gitClient as gitClient, index$1_hashLines as hashLines, index$1_hashRange as hashRange, index$1_historyOf as historyOf, index$1_holdsWords as holdsWords, index$1_insertStatementBefore as insertStatementBefore, index$1_insideFence as insideFence, index$1_isBoundLine as isBoundLine, index$1_isCiteRule as isCiteRule, index$1_isKeyedPin as isKeyedPin, index$1_isTableRow as isTableRow, index$1_isUnitText as isUnitText, index$1_itemLine as itemLine, index$1_lineAt as lineAt, index$1_lineSpec as lineSpec, index$1_loadCitationSidecars as loadCitationSidecars, index$1_loadCiteConfig as loadCiteConfig, index$1_markerClaimEnd as markerClaimEnd, index$1_markerRunAt as markerRunAt, index$1_markerUnit as markerUnit, index$1_messageFor as messageFor, index$1_mintCitation as mintCitation, index$1_misplacedMarkerAt as misplacedMarkerAt, index$1_misplacedMarkers as misplacedMarkers, index$1_misplacedMessageFor as misplacedMessageFor, index$1_movedUnit as movedUnit, index$1_noGit as noGit, index$1_noUnitAt as noUnitAt, index$1_normalizeText as normalizeText, index$1_normalizeWhitespace as normalizeWhitespace, index$1_offsetOfLine as offsetOfLine, index$1_orphanRefusal as orphanRefusal, index$1_ownedMessage as ownedMessage, index$1_paragraphAfter as paragraphAfter, index$1_parseCiteConfig as parseCiteConfig, index$1_parseLines as parseLines, index$1_parseSrc as parseSrc, index$1_parseStatements as parseStatements, index$1_pickExtractor as pickExtractor, index$1_pinOfLines as pinOfLines, index$1_pre43Span as pre43Span, index$1_rangeLines as rangeLines, index$1_readCiteConfigFile as readCiteConfigFile, index$1_readPage as readPage, index$1_readSource as readSource, index$1_reencryptCitationEntries as reencryptCitationEntries, index$1_reencryptCitations as reencryptCitations, index$1_refineClaim as refineClaim, index$1_refusalLine as refusalLine, index$1_removalLine as removalLine, index$1_removeFrontmatterCitations as removeFrontmatterCitations, index$1_removeLine as removeLine, index$1_renderCheckGithub as renderCheckGithub, index$1_renderCheckJson as renderCheckJson, index$1_renderCheckPretty as renderCheckPretty, index$1_renderRemoveJson as renderRemoveJson, index$1_renderRemovePretty as renderRemovePretty, index$1_renderUpdateJson as renderUpdateJson, index$1_renderUpdatePretty as renderUpdatePretty, index$1_resolveCiteRun as resolveCiteRun, index$1_resolveSeverity as resolveSeverity, index$1_rewriteLine as rewriteLine, index$1_ruleId as ruleId, index$1_runAdd as runAdd, index$1_runCheck as runCheck, index$1_runRemove as runRemove, index$1_runUpdate as runUpdate, index$1_runsHolding as runsHolding, index$1_sentencesOf as sentencesOf, index$1_sharesSentence as sharesSentence, index$1_shiftedEntries as shiftedEntries, index$1_shortCommit as shortCommit, index$1_shortLine as shortLine, index$1_shortPin as shortPin, index$1_shortSrc as shortSrc, index$1_sidecarsFor as sidecarsFor, index$1_sliceLines as sliceLines, index$1_sourceRange as sourceRange, index$1_spellAt as spellAt, index$1_spellLines as spellLines, index$1_spellSource as spellSource, index$1_splice as splice, index$1_spliceEntryField as spliceEntryField, index$1_splitLines as splitLines, index$1_splitUnit as splitUnit, index$1_statementForms as statementForms, index$1_stripMarkers as stripMarkers, index$1_toBodyLines as toBodyLines, index$1_toFileLines as toFileLines, index$1_toValidationResult as toValidationResult, index$1_twoManifestsRefusal as twoManifestsRefusal, index$1_unifiedDiff as unifiedDiff, index$1_unitAt as unitAt, index$1_unitText as unitText, index$1_urlManifestRefusal as urlManifestRefusal, index$1_validateEntry as validateEntry, index$1_withClaimLines as withClaimLines };
 }
 
 /**
@@ -6030,4 +6201,4 @@ declare namespace index {
   export { type index_EncryptionContext as EncryptionContext, index_KeyError as KeyError, type index_KeyRotateOptions as KeyRotateOptions, type index_KeyRotateResult as KeyRotateResult, type index_KeySetOptions as KeySetOptions, type index_KeySetResult as KeySetResult, type index_KeySource as KeySource, type index_ResolvedKey as ResolvedKey, type index_RotateManifest as RotateManifest, type index_RotateOutcome as RotateOutcome, type index_RotatePage as RotatePage, type index_RotatedCitation as RotatedCitation, type index_RotatedManifestValue as RotatedManifestValue, type index_RotatedMetadata as RotatedMetadata, type index_RotatedValue as RotatedValue, type index_SkippedCitation as SkippedCitation, type index_SkippedManifestValue as SkippedManifestValue, type index_SkippedMetadata as SkippedMetadata, type index_SkippedValue as SkippedValue, index_decryptValue as decryptValue, index_encryptValue as encryptValue, index_isEncryptedValue as isEncryptedValue, index_resolveEncryptionKey as resolveEncryptionKey, index_runKeyRotate as runKeyRotate, index_runKeySet as runKeySet };
 }
 
-export { type ApplyOptions, type Approval, type BaselineSummary, BinMissing, type BuiltinDerivableField, COMMON_FORMATS, type CheckConfig, type CollectionConfig, type CommandSourceOptions, type CommandSourceResult, type CommonFormat, type ConfigNotice, DEFAULT_SCHEMAS, DEFAULT_TTL_HOURS, DEFAULT_VENDOR_DIR, DERIVABLE_FIELDS, DERIVED_KEYWORD, DERIVED_STALE_SCHEMA, DERIVE_FORMATS, DERIVE_SOURCES, type DerivableField, type DeriveCommand, type DeriveCommandConfig, type DeriveConfig, type DeriveContext, type DeriveFileResult, type DeriveInput, type DeriveOptions, type DeriveReportFormat, type DeriveReportOptions, type DeriveResult, type DeriveRun, type DeriveSource, type DeriveSummary, type DerivedField, type DerivedRecord, type DerivedStatus, type DerivedValue, type DocmetaConfig, DocmetaError, type DocumentRefTrust, EXTERNAL_DUPLICATE_SCHEMA, EXTERNAL_KEYWORD, EXTERNAL_METADATA_FETCH_MAX_BYTES, EXTERNAL_METADATA_FETCH_TIMEOUT_MS, EXTERNAL_OWNED_SCHEMA, type ExternalMetadataCollision, type ExternalMetadataConfig, type ExternalMetadataEntry, type ExternalMetadataFetchOptions, type ExternalMetadataIndex, type ExternalMetadataJoin, type ExternalMetadataValue, type ExtractOptions, type ExtractedMetadata, FIELD_SOURCES, FILL_FORMATS, type FetchedSchema, type FieldError, type FieldLocation, type FillConfig, type FillFileResult, type FillOptions, type FillReportFormat, type FillReportOptions, type FillRun, type FillSummary, type FilledField, type FingerprintContext, type FrontmatterFlavor, type FrontmatterLocation, type GetFileResult, type GetOptions, type GetReportOptions, GitHubClient, GitLabClient, INTEGRITY_SHAPE, type JunitOptions, LOCATION_KEYWORD, type LoadExternalMetadataOptions, type LoadSchemaOptions, type LoadedConfig, type LocationPreference, type MergedChange, type MergedMetadata, type MetadataExtractor, type MetadataPatch, PATH_JOIN, PATH_PLACEHOLDER, QUERY_FORMATS, type QueryChange, type QueryFormat, type QueryOptions, type QueryReportOptions, type QueryRun, REPORT_FORMATS, RESOLVED_VIEW, REVIEW_CACHE_DIR, REVIEW_CACHE_VERSION, type ReadOptions, type ReencryptMetadataResult, type ReencryptedValue, type RelocateOptions, type RelocateResult, type RemoteIdentity, type ReportFormat, type ReportOptions, ReviewCache, type ReviewClient, type ReviewFacts, type ReviewSourceInput, type ReviewSourceResult, type Run, type RunConfig, type RunConfigOptions, type RunSummary, SCHEMA_CACHE_DIR, SCHEMA_CACHE_VERSION, type SarifOptions, SchemaCache, type SchemaCacheConfig, type SchemaCacheEntry, type SchemaEntry, type SchemaPin, type SchemaRefEntry, type SchemaTrustConfig, type SkipReason, type SourceLocation, type SourceStatus$1 as SourceStatus, type SpawnOptions, type ValidateOptions, type ValidateRun, type ValidationResult, Validator, type VendorOptions, type VendorResult, applyFrontmatter, argvFor, assertSourcesAvailable, cachedClient, index$1 as cite, classifyRef, collectSchemaPins, compareDerived, consultedSources, createResolvedView, createReviewClient, deriveFromCommands, deriveFromReviews, deriveMetadata, externalMetadataJoin, externalMetadataPointer, externalMetadataUrlProblem, extractFrontmatter, extractorForExtension, fetchExternalMetadata, fetchSchemaBytes, frontmatterInnerText, getSchemasInfo, identityFromOrigin, integrityOf, isBuiltinField, isCommonFormat, isDeriveFormat, isDeriveSource, isErrorSeverity, isFillFormat, isIntegrity, isMember, isPerFile, isQueryFormat, isReportFormat, index as key, listBuiltins, loadConfig, loadExternalMetadata, loadSchema, locateFrontmatter, memberOf, mentionsResolved, mergeExternalMetadata, orphanEntries, orphanError, orphanJoins, parseCollections, parseConfig, parseOriginUrl, rebaseConfigSchemaRefs, reencryptMetadata, render, renderDerive, renderFill, renderFillGithub, renderGet, renderJunit, renderQuery, renderQueryCsv, renderSarif, resolveRunConfig, resolveSchemaSet, resolvedColumns, run, runDerive, runFill, runGet, runQuery, runRelocate, runValidate, runVendorSchema, schemaCacheDir, schemaEntryRef, schemaLoadOptions, selectCollections, sourcesFor, staleFindings, stringifyValue, supportedExtensions, valueOf, vendorFileName, writeFileAtomic };
+export { type ApplyOptions, type Approval, type BaselineSummary, BinMissing, type BuiltinDerivableField, COMMON_FORMATS, type CheckConfig, type CollectionConfig, type CommandSourceOptions, type CommandSourceResult, type CommonFormat, type ConfigNotice, DEFAULT_SCHEMAS, DEFAULT_TTL_HOURS, DEFAULT_VENDOR_DIR, DERIVABLE_FIELDS, DERIVED_KEYWORD, DERIVED_STALE_SCHEMA, DERIVE_FORMATS, DERIVE_SOURCES, type DerivableField, type DeriveCommand, type DeriveCommandConfig, type DeriveConfig, type DeriveContext, type DeriveFileResult, type DeriveInput, type DeriveOptions, type DeriveReportFormat, type DeriveReportOptions, type DeriveResult, type DeriveRun, type DeriveSource, type DeriveSummary, type DerivedField, type DerivedRecord, type DerivedStatus, type DerivedValue, type DocmetaConfig, DocmetaError, type DocumentRefTrust, EXTERNAL_DUPLICATE_SCHEMA, EXTERNAL_KEYWORD, EXTERNAL_METADATA_FETCH_MAX_BYTES, EXTERNAL_METADATA_FETCH_TIMEOUT_MS, EXTERNAL_OWNED_SCHEMA, type ExternalMetadataCollision, type ExternalMetadataConfig, type ExternalMetadataEntry, type ExternalMetadataFetchOptions, type ExternalMetadataIndex, type ExternalMetadataJoin, type ExternalMetadataValue, type ExtractOptions, type ExtractedMetadata, FIELD_SOURCES, FILL_FORMATS, type FetchedSchema, type FieldError, type FieldLocation, type FillConfig, type FillFileResult, type FillOptions, type FillReportFormat, type FillReportOptions, type FillRun, type FillSummary, type FilledField, type FingerprintContext, type FrontmatterFlavor, type FrontmatterLocation, type GetFileResult, type GetOptions, type GetReportOptions, GitHubClient, GitLabClient, INTEGRITY_SHAPE, type JunitOptions, LOCATION_KEYWORD, type LoadExternalMetadataOptions, type LoadSchemaOptions, type LoadedConfig, type LocationPreference, MERGE_SAFE_FIELDS, type MergedChange, type MergedMetadata, type MetadataExtractor, type MetadataPatch, PATH_JOIN, PATH_PLACEHOLDER, QUERY_FORMATS, type QueryChange, type QueryFormat, type QueryOptions, type QueryReportOptions, type QueryRun, REPORT_FORMATS, RESOLVED_VIEW, REVIEW_CACHE_DIR, REVIEW_CACHE_VERSION, type ReadOptions, type ReencryptMetadataResult, type ReencryptedValue, type RegisteredSchema, type RegisteredSchemas, type RelocateOptions, type RelocateResult, type RemoteIdentity, type ReportFormat, type ReportOptions, ReviewCache, type ReviewClient, type ReviewFacts, type ReviewSourceInput, type ReviewSourceResult, type Run, type RunConfig, type RunConfigOptions, type RunSummary, SCHEMA_CACHE_DIR, SCHEMA_CACHE_VERSION, type SarifOptions, SchemaCache, type SchemaCacheConfig, type SchemaCacheEntry, type SchemaEntry, type SchemaPin, type SchemaRefEntry, type SchemaTrustConfig, type SkipReason, type SourceLocation, type SourceStatus$1 as SourceStatus, type SpawnOptions, type ValidateOptions, type ValidateRun, type ValidationResult, Validator, type VendorOptions, type VendorResult, applyFrontmatter, argvFor, assertSourcesAvailable, cachedClient, index$1 as cite, classifyRef, collectSchemaPins, compareDerived, consultedSources, createResolvedView, createReviewClient, deriveFromCommands, deriveFromReviews, deriveMetadata, externalMetadataJoin, externalMetadataPointer, externalMetadataUrlProblem, extractFrontmatter, extractorForExtension, fetchExternalMetadata, fetchSchemaBytes, frontmatterInnerText, getSchemasInfo, identityFromOrigin, integrityOf, isBuiltinField, isCommonFormat, isDeriveFormat, isDeriveSource, isErrorSeverity, isFillFormat, isIntegrity, isMember, isPerFile, isQueryFormat, isReportFormat, index as key, listBuiltins, loadConfig, loadExternalMetadata, loadSchema, locateFrontmatter, memberOf, mentionsResolved, mergeExternalMetadata, orphanEntries, orphanError, orphanJoins, parseCollections, parseConfig, parseOriginUrl, rebaseConfigSchemaRefs, reencryptMetadata, render, renderDerive, renderFill, renderFillGithub, renderGet, renderJunit, renderQuery, renderQueryCsv, renderSarif, resolveRunConfig, resolveSchemaSet, resolvedColumns, run, runDerive, runFill, runGet, runQuery, runRelocate, runValidate, runVendorSchema, schemaCacheDir, schemaEntryRef, schemaLoadOptions, selectCollections, sourcesFor, staleFindings, stringifyValue, supportedExtensions, valueOf, vendorFileName, writeFileAtomic };