@superbee/core 0.2.0-pre.16 → 0.2.0-pre.19

package/dist/record-overlay/types.d.ts

@@ -0,0 +1,291 @@
+/** Types of `@superbee/core/record-overlay`. Step and result rows keep the record-bridge keys. */
+import type { DocumentMutationCandidate } from "../document-mutation.js";
+import type { KindConvention, KindRegistry } from "../kinds.js";
+import type { Bundle, ConceptId, Frontmatter, OkfDocument, Version } from "../types.js";
+import type { RefusalCode } from "./errors.js";
+import type { SourceIndex } from "./source-index.js";
+/** One bundle as the overlay reads and writes it. */
+export interface OverlayBundle {
+    bundle: Bundle;
+    registry: KindRegistry;
+    okfVersion: "0.1" | "0.2";
+}
+/** The generic Source Feed policy: which fields a feed owns and what each change kind may do. */
+export interface OverlayPolicy {
+    feed: ConceptId;
+    /** The provider identity (`url`), as `sources[].resource` names it. */
+    provider: string;
+    /** The Kind of the overlay documents. Absent for a record-only or presentation-only feed. */
+    target_kind?: string;
+    owned_fields: string[];
+    auto_apply: string[];
+    needs_review: string[];
+    missing_threshold?: number;
+    completeness?: "complete" | "partial";
+    /** The feed's wall-time zone, validated by whoever owns the interval hook. */
+    time_zone?: string;
+    exclude?: RegExp | null;
+    exclude_ids?: ReadonlySet<string> | null;
+    /**
+     * The target Kind's `string-list` and `https-url-list` fields, which change detection compares as
+     * sets. Present only when the reader was given a target Kind that declares one.
+     */
+    list_fields?: string[];
+}
+/** Field checks for the reader: the target Kind's declared fields, or a presentation kind's fields. */
+export type PolicyContext = {
+    targetKind?: KindConvention;
+    presentationFields?: never;
+} | {
+    presentationFields: readonly string[];
+    targetKind?: never;
+};
+/** One change the caller's diff observed for one external record. */
+export interface RecordChange {
+    external_id: string;
+    change_kind: string;
+    changed_fields: string[];
+    before: Record<string, unknown> | null;
+    after: Record<string, unknown> | null;
+    content_digest: string;
+    occurs_at?: string;
+    missing_count?: number;
+    first_missing_at?: string;
+    collapse_with?: string[];
+    signal_priority?: string;
+}
+export interface Tell {
+    code: string;
+    match: string;
+    [property: string]: unknown;
+}
+/** A publication text gate: the text as it may be written, and whether it may be written at all. */
+export type TextGate = (text: string, context: {
+    field: string;
+    kind: string | undefined;
+}) => {
+    text: string;
+    ok: boolean;
+    tells: Tell[];
+    changed?: boolean;
+};
+/** `[startMs, endMs)` of a record's last known occurrence, or null when its dates are unknown. */
+export type IntervalHook = (fields: Record<string, unknown>, timeZone: string | undefined) => readonly [number, number] | null;
+export type DisappearedPhase = "ended" | "before-start" | "ongoing" | null;
+export interface CorrelateHook {
+    kind: string;
+    match: (fields: Record<string, unknown>, frontmatter: Frontmatter, externalId: string) => null | undefined | {
+        reason: string;
+        priority?: string;
+    };
+}
+/** Runs on every fresh candidate through `mutateDocument`, after the core-owned guards. */
+export type AssertCandidate = (existing: OkfDocument | undefined, candidate: DocumentMutationCandidate) => void | Promise<void>;
+export interface OverlayHooks {
+    textGate?: TextGate;
+    interval?: IntervalHook;
+    correlate?: CorrelateHook;
+    /** Scalar properties for the `sources` entry of an applied record; none means no upsert. */
+    sourceProperties?: (change: RecordChange) => Record<string, string | number | boolean> | undefined;
+    /** Site rules, run after the core-owned guards on the same fresh read. */
+    assertCandidate?: (existing: OkfDocument | undefined, candidate: DocumentMutationCandidate, context: {
+        step: OverlayStep["op"];
+        bundle: "content" | "ops";
+    }) => void | Promise<void>;
+    /** Fields derived in the same write as the owned fields (for example `updated_at`). */
+    deriveFields?: {
+        fields: readonly string[];
+        derive: (existing: OkfDocument, next: DocumentMutationCandidate) => Record<string, unknown>;
+    };
+}
+export interface ChangeDecision {
+    apply: Record<string, {
+        from: unknown;
+        to: unknown;
+    }>;
+    conflicts: Array<{
+        field: string;
+        doc_value: unknown;
+        feed_before: unknown;
+        feed_after: unknown;
+    }>;
+    editorFields: string[];
+    wording: Array<{
+        field: string;
+        text: string;
+        tells: Tell[];
+    }>;
+    signal: null | {
+        priority: string;
+        reasons: string[];
+    };
+}
+export interface PlanInput {
+    content: OverlayBundle;
+    ops: OverlayBundle;
+    policy: OverlayPolicy;
+    changes: readonly RecordChange[];
+    observedAt: string;
+    /** Next store records, for titles. */
+    records?: Record<string, {
+        fields?: Record<string, unknown>;
+    }>;
+    observation?: {
+        baseline?: boolean;
+        replay?: boolean;
+        stats?: Record<string, unknown>;
+    };
+    /** A per-run identity index; without one the plan builds its own for this provider and Kind. */
+    overlays?: SourceIndex;
+    timeZone?: string;
+    /** Ops and content are one bundle, so typed `about` links are possible. */
+    sameBundle?: boolean;
+    /** Attention and feed Kind names; default `Signal` and `Source Feed`. */
+    signals?: {
+        kind?: string;
+        feedKind?: string;
+    };
+    hooks?: OverlayHooks;
+}
+export interface Finding {
+    key: string;
+    title: string;
+    summary?: string;
+    priority?: string;
+    about_doc?: string;
+    related?: string[];
+    facts?: unknown;
+    sources?: Array<{
+        resource: string;
+        id?: string;
+        title?: string;
+        [property: string]: unknown;
+    }>;
+    external_id?: string;
+    expires_at?: string;
+    change_kind?: string;
+}
+export interface FindingsInput {
+    ops: OverlayBundle;
+    /** Signal `provider`: a feed URL or a tool name. */
+    provider: string;
+    /** Source Feed id for the `from feed` link; absent for tool-raised findings. */
+    feed?: ConceptId;
+    /** Signal id prefix after the attention Kind's path. */
+    slug: string;
+    findings: readonly Finding[] | null | undefined;
+    observedAt: string;
+    signals?: {
+        kind?: string;
+        feedKind?: string;
+    };
+}
+export interface ApplyContext {
+    content: OverlayBundle;
+    ops: OverlayBundle;
+    policy: Pick<OverlayPolicy, "owned_fields" | "provider" | "target_kind">;
+    actor: string;
+    overlays?: SourceIndex;
+    /** Attention and feed Kind names, as the plan was made with; default `Signal` and `Source Feed`. */
+    signals?: {
+        kind?: string;
+        feedKind?: string;
+    };
+    hooks?: Pick<OverlayHooks, "assertCandidate" | "deriveFields">;
+}
+export interface ApplyOwnedFieldsStep {
+    op: "apply-owned-fields";
+    target: ConceptId;
+    expected_version: Version;
+    external_id: string;
+    change_kind: string;
+    fields: Record<string, {
+        from: unknown;
+        to: unknown;
+    }>;
+    /** Grouped shape: properties upserted on the record's `sources` entry in the same write. */
+    sources?: Record<string, string | number | boolean>;
+}
+export interface CreateSignalStep {
+    op: "create-signal";
+    target: ConceptId;
+    external_id: string;
+    content_digest: string;
+    finding?: string;
+    reasons: string[];
+    candidate: {
+        frontmatter: Frontmatter;
+        body: string;
+    };
+}
+export interface CollapseSignalStep {
+    op: "collapse-signal";
+    target: ConceptId;
+    expected_version: Version;
+    external_id: string;
+    content_digest: string;
+    finding?: string;
+    progress_field: string;
+    observation_line: string;
+    set: Record<string, unknown>;
+}
+export interface SignalDuplicateStep {
+    op: "signal-duplicate";
+    target: ConceptId;
+    external_id: string;
+    content_digest: string;
+    finding?: string;
+}
+export interface RecordOnlyStep {
+    op: "record-only";
+    target?: undefined;
+    external_id: string;
+    change_kind?: string;
+    superseded?: true;
+    ended?: true;
+    reason?: string;
+    last_known_end?: string;
+    excluded?: true;
+    collapsed_into?: ConceptId;
+}
+export type OverlayStep = ApplyOwnedFieldsStep | CreateSignalStep | CollapseSignalStep | SignalDuplicateStep | RecordOnlyStep;
+export interface RefusalRow {
+    code: RefusalCode;
+    external_id: string;
+    target?: ConceptId;
+    targets?: ConceptId[];
+    field?: string;
+    message: string;
+}
+export interface OverlayPlan {
+    feed: ConceptId | null;
+    provider: string;
+    observed_at: string;
+    baseline?: boolean;
+    replay?: boolean;
+    stats?: Record<string, unknown>;
+    steps: OverlayStep[];
+    refusals: RefusalRow[];
+    diagnostics?: unknown[];
+}
+export interface StepResult {
+    op: OverlayStep["op"];
+    target: ConceptId | null;
+    external_id: string;
+    outcome: "applied" | "unchanged" | "skipped" | "refused";
+    version?: Version;
+    code?: RefusalCode;
+    message?: string;
+    details?: Record<string, unknown>;
+    reason?: string;
+    last_known_end?: string;
+}
+export interface OverlayReceipt {
+    feed: ConceptId | null;
+    provider: string;
+    observed_at: string;
+    results: StepResult[];
+    refusals: RefusalRow[];
+    diagnostics: unknown[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/record-overlay/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/record-overlay/types.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,KAAK,GAAG,KAAK,CAAC;CAC3B;AAED,iGAAiG;AACjG,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACtC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,uGAAuG;AACvG,MAAM,MAAM,aAAa,GACrB;IAAE,UAAU,CAAC,EAAE,cAAc,CAAC;IAAC,kBAAkB,CAAC,EAAE,KAAK,CAAA;CAAE,GAC3D;IAAE,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAElE,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B;AAED,oGAAoG;AACpG,MAAM,MAAM,QAAQ,GAAG,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KACjD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAErE,kGAAkG;AAClG,MAAM,MAAM,YAAY,GAAG,CACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,KACzB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;AAEtC,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,cAAc,GAAG,SAAS,GAAG,IAAI,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CACL,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,KACf,IAAI,GAAG,SAAS,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D;AAED,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GAAG,CAC5B,QAAQ,EAAE,WAAW,GAAG,SAAS,EACjC,SAAS,EAAE,yBAAyB,KACjC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS,CAAC;IACnG,0EAA0E;IAC1E,eAAe,CAAC,EAAE,CAChB,QAAQ,EAAE,WAAW,GAAG,SAAS,EACjC,SAAS,EAAE,yBAAyB,EACpC,OAAO,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,KAAK,CAAA;KAAE,KAC5D,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,uFAAuF;IACvF,YAAY,CAAC,EAAE;QACb,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;QAC1B,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,yBAAyB,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC7F,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtD,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,WAAW,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACnG,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC,CAAC;IAC/D,MAAM,EAAE,IAAI,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACxD;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC;IAC/D,WAAW,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACxF,gGAAgG;IAChG,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,yEAAyE;IACzE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IAChG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,aAAa,CAAC;IACnB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,GAAG,UAAU,GAAG,aAAa,CAAC,CAAC;IACzE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,oGAAoG;IACpG,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,KAAK,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,iBAAiB,GAAG,cAAc,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,oBAAoB,CAAC;IACzB,MAAM,EAAE,SAAS,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACvD,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,eAAe,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE;QAAE,WAAW,EAAE,WAAW,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,iBAAiB,CAAC;IACtB,MAAM,EAAE,SAAS,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,kBAAkB,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,aAAa,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,MAAM,MAAM,WAAW,GACnB,oBAAoB,GACpB,gBAAgB,GAChB,kBAAkB,GAClB,mBAAmB,GACnB,cAAc,CAAC;AAEnB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IACtB,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,WAAW,EAAE,OAAO,EAAE,CAAC;CACxB"}

package/dist/record-overlay/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/record-overlay/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/record-overlay/types.ts"],"names":[],"mappings":""}

package/dist/remote-operations.js

@@ -83,14 +83,14 @@ function buildTransport(remote, options) {
             // Refused rather than thrown: the primitive classifies a throw as unknown, and an intent
             // that can never be sent would then stay pending as possibly delivered on every push.
             if (intent.kind !== "document.write") {
-                return { kind: "refused", code: "USAGE", message: `remote operation transport: unsupported intent kind '${intent.kind}'` };
+                return { kind: "refused", code: "USAGE", message: `remote operation transport: unsupported intent kind '${intent.kind}'`, executed: false };
             }
             let parsed;
             try {
                 parsed = parseMarkdown(intent.content, pathFromConceptId(intent.target));
             }
             catch (error) {
-                return { kind: "refused", code: "USAGE", message: error instanceof Error ? error.message : String(error) };
+                return { kind: "refused", code: "USAGE", message: error instanceof Error ? error.message : String(error), executed: false };
             }
             const { frontmatter, body } = parsed;
             const writeOptions = {
@@ -110,6 +110,9 @@ function buildTransport(remote, options) {
                     return { kind: "refused", code: "USAGE", message: error.message };
                 if (error instanceof VersionConflict)
                     return { kind: "conflict", actual: error.actual };
+                // The reference router authorizes before it claims a key: a 401 or 403 executed nothing.
+                if (error instanceof RemoteError && (error.status === 401 || error.status === 403))
+                    return { kind: "refused", code: error.code, message: error.message, executed: false };
                 if (error instanceof RemoteError && error.status < 500)
                     return { kind: "refused", code: error.code, message: error.message };
                 throw error;

package/dist/remote-operations.js.map

@@ -1 +1 @@
-{"version":3,"file":"remote-operations.js","sourceRoot":"","sources":["../src/remote-operations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"remote-operations.js","sourceRoot":"","sources":["../src/remote-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAEtE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAOzD,kFAAkF;AAClF,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAC1C,IAAI,GAAG,wBAAwB,CAAC;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,gDAAgD,OAAO,sFAAsF,CAAC,CAAC;QACrJ,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAAC,MAAqB,EAAE,UAA2C,EAAE;IACrH,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,KAAK,CAAC,eAAe,EAAE,CAAC;IAC9B,OAAO,KAAK,CAAC,SAAS,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAqB,EAAE,UAA2C,EAAE;IACjH,OAAO,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC;AAED,SAAS,cAAc,CAAC,MAAqB,EAAE,OAAwC;IACrF,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,MAAM,eAAe,GAAG,KAAK,IAAmB,EAAE;QAChD,IAAI,SAAS;YAAE,OAAO;QACtB,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACrD,IAAI,CAAC,YAAY,CAAC,UAAU;YAAE,MAAM,IAAI,0BAA0B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClF,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC,CAAC;IACF,MAAM,SAAS,GAAuB;QACpC,KAAK,CAAC,MAAM,CAAC,MAAuB;YAClC,yFAAyF;YACzF,sFAAsF;YACtF,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACrC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,wDAAwD,MAAM,CAAC,IAAI,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YAC9I,CAAC;YACD,IAAI,MAAwC,CAAC;YAC7C,IAAI,CAAC;gBACH,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YAC9H,CAAC;YACD,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;YACrC,MAAM,YAAY,GAAG;gBACnB,eAAe,EAAE,MAAM,CAAC,IAAI;gBAC5B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;aACjE,CAAC;YACF,IAAI,CAAC;gBACH,sFAAsF;gBACtF,kFAAkF;gBAClF,MAAM,eAAe,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,YAAY,CAAC,CAAC;gBAC1G,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;YACxC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,wBAAwB;oBAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;gBACjH,IAAI,KAAK,YAAY,eAAe;oBAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxF,yFAAyF;gBACzF,IAAI,KAAK,YAAY,WAAW,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAC;oBAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;gBAC1K,IAAI,KAAK,YAAY,WAAW,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;oBAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC7H,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,SAAiB;YAC5B,MAAM,eAAe,EAAE,CAAC;YACxB,OAAO,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;IACF,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AACxC,CAAC"}

package/dist/search/contract.d.ts

@@ -0,0 +1,151 @@
+/**
+ * The `documents.search.v1` contract: its constants, request and result types, and the frontmatter
+ * fields a search reads. Ranking and index limits are portal-webmcp 0.3.1's (algorithm
+ * `portal-webmcp-search/v1`, a long document indexed whole up to 65,536 body terms); the request
+ * limits are this contract's.
+ */
+export declare const SEARCH_OPERATION_ID = "documents.search.v1";
+/** The ranking algorithm, shared with portal-webmcp 0.3.1's `superbee_search_documents`. */
+export declare const SEARCH_ALGORITHM = "portal-webmcp-search/v1";
+/** Bumped whenever normalize, tokenize or searchRowText change what a document contributes to an
+ * index; the row-text golden (`test/fixtures/search-row-text-v<revision>.json`) pins it. */
+export declare const SEARCH_TEXT_REVISION = 1;
+/** Largest answer, as JSON. A page of long hits can exceed it before 50 hits: the page then ends
+ * early with a cursor at the cut. */
+export declare const SEARCH_MAX_OUTPUT_BYTES: number;
+export declare const SEARCH_LIMITS: Readonly<{
+    /** Largest query, UTF-8 bytes. */
+    readonly maxQueryBytes: 1024;
+    /** Distinct normalized query terms. */
+    readonly maxQueryTerms: 16;
+    readonly defaultRows: 10;
+    readonly maxRows: 50;
+    /** Excerpt length, UTF-8 bytes. */
+    readonly excerptBytes: 512;
+    /** Largest exact `type` or `tag` filter, UTF-8 bytes (the kernel query's filter bound). */
+    readonly maxFilterBytes: 256;
+    /** Largest id `prefix` filter, UTF-8 bytes (a document id's bound). */
+    readonly maxPrefixBytes: 512;
+    /** Largest cursor, UTF-8 bytes. */
+    readonly maxCursorBytes: 2048;
+    /** Values per facet, most frequent first. */
+    readonly maxFacetValues: 50;
+    readonly maxIndexDocuments: 20000;
+    readonly maxIndexSourceBytes: 67108864;
+    /** portal-webmcp's V1 value: a long document is indexed whole, never truncated; one over it is
+     * left out of the index and counted as skipped. */
+    readonly maxTermsPerDocument: 65536;
+    /** The default and ceiling of `searchDocuments`' `maxEvidenceInstances`: the most capped term
+     * instances a request's terms may hold across a corpus before it is refused as too broad. */
+    readonly maxEvidenceInstances: 400000;
+}>;
+/** Body occurrences of one distinct query term that can still add score. */
+export declare const BODY_OCCURRENCE_CAP = 20;
+/** Bytes an excerpt may reach behind its first body match before the match starts. */
+export declare const EXCERPT_LEAD_BYTES = 256;
+/** Documents processed between cancellation checks. */
+export declare const SIGNAL_INTERVAL = 128;
+export declare const SEARCH_MATCHES: readonly ["auto", "all", "any"];
+export type SearchMatchV1 = (typeof SEARCH_MATCHES)[number];
+export type SearchMatchModeV1 = "all" | "any";
+export declare const SEARCH_FACETS: readonly ["type", "tags"];
+export type SearchFacetV1 = (typeof SEARCH_FACETS)[number];
+export declare const SEARCH_MATCH_FIELDS: readonly ["title", "type", "tag", "description", "id", "body"];
+export type SearchMatchFieldV1 = (typeof SEARCH_MATCH_FIELDS)[number];
+export declare const SEARCH_GUIDANCE: Readonly<{
+    all: "No document contains every query term. Retry with match \"any\", fewer terms, or different exact filters.";
+    any: "No document contains any searchable query term. Try domain-specific keywords or remove exact type and tag filters.";
+    /** The refusal of a request whose terms occur too often to rank (`maxEvidenceInstances`). */
+    broad: "The query's terms occur too often in this corpus to rank. Retry with fewer or more specific terms.";
+}>;
+/** One document of a search corpus: a read model row, or a working copy's head and body. */
+export interface SearchDocumentV1 {
+    readonly id: string;
+    readonly version: string;
+    readonly frontmatter: Readonly<Record<string, unknown>>;
+    readonly body: string;
+}
+/** Cancellation for a long build or ranking: a signal, a host check that throws, or both. */
+export interface SearchStopV1 {
+    readonly signal?: AbortSignal;
+    /** Called every SIGNAL_INTERVAL documents; throws to stop (for example a deadline). */
+    readonly check?: () => void;
+}
+/** The exact filters a source applies before it answers evidence. */
+export interface SearchFiltersV1 {
+    readonly type?: string;
+    readonly tag?: string;
+    /** Leading characters of the document id. */
+    readonly prefix?: string;
+}
+export interface SearchRequestV1 {
+    /** Free text, at most 1 KiB and 16 distinct terms after normalization. */
+    readonly query: string;
+    /** `auto` (default): every term, then any term without conversational words when nothing matched. */
+    readonly match?: SearchMatchV1;
+    /** Exact frontmatter `type`. */
+    readonly type?: string;
+    /** Exact declared tag. */
+    readonly tag?: string;
+    /** Leading characters of the document id, at most 512 bytes. */
+    readonly prefix?: string;
+    /** Hits per page, 1 to 50; default 10. */
+    readonly limit?: number;
+    /** A previous answer's `nextCursor`, for the same corpus, query, match and filters. */
+    readonly cursor?: string;
+    /** Value counts over every hit (not only this page), most frequent first, at most 50 each. */
+    readonly facets?: readonly SearchFacetV1[];
+}
+export interface SearchHitV1 {
+    readonly id: string;
+    readonly version: string;
+    readonly title?: string;
+    readonly type?: string;
+    readonly tags: readonly string[];
+    readonly score: number;
+    readonly matchedTerms: readonly {
+        readonly term: string;
+        readonly fields: readonly SearchMatchFieldV1[];
+    }[];
+    /** At most SEARCH_LIMITS.excerptBytes UTF-8 bytes: the body around the first match, else the description. */
+    readonly excerpt: string;
+}
+export interface SearchFacetValueV1 {
+    readonly value: string;
+    readonly count: number;
+}
+export interface SearchResultV1 {
+    readonly hits: readonly SearchHitV1[];
+    readonly query: {
+        readonly requestedMatch: SearchMatchV1;
+        readonly effectiveMatch: SearchMatchModeV1;
+        readonly fallbackUsed: boolean;
+        /** The terms matched: normalized, deduplicated, and without ignoredTerms after a fallback. */
+        readonly terms: readonly string[];
+        /** Conversational terms the fallback left out; absent when none were. */
+        readonly ignoredTerms?: readonly string[];
+    };
+    /** Hits across every page. */
+    readonly total: number;
+    readonly facets?: {
+        readonly type?: readonly SearchFacetValueV1[];
+        readonly tags?: readonly SearchFacetValueV1[];
+    };
+    readonly nextCursor?: string;
+    /** What was searched: every document, those indexed (reindexPending included), those the index
+     * cannot hold, and indexed rows awaiting re-derivation. */
+    readonly corpus: {
+        readonly documents: number;
+        readonly indexed: number;
+        readonly skipped: number;
+        readonly reindexPending: number;
+    };
+    /** Fixed advice when nothing matched. */
+    readonly guidance?: string;
+}
+export declare function documentTitle(document: SearchDocumentV1): string | undefined;
+export declare function documentType(document: SearchDocumentV1): string | undefined;
+export declare function documentDescription(document: SearchDocumentV1): string | undefined;
+/** Declared string tags only; a non-array or non-string member contributes nothing. */
+export declare function documentTags(document: SearchDocumentV1): readonly string[];
+//# sourceMappingURL=contract.d.ts.map

package/dist/search/contract.d.ts.map

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

package/dist/search/contract.js

@@ -0,0 +1,78 @@
+/**
+ * The `documents.search.v1` contract: its constants, request and result types, and the frontmatter
+ * fields a search reads. Ranking and index limits are portal-webmcp 0.3.1's (algorithm
+ * `portal-webmcp-search/v1`, a long document indexed whole up to 65,536 body terms); the request
+ * limits are this contract's.
+ */
+export const SEARCH_OPERATION_ID = "documents.search.v1";
+/** The ranking algorithm, shared with portal-webmcp 0.3.1's `superbee_search_documents`. */
+export const SEARCH_ALGORITHM = "portal-webmcp-search/v1";
+/** Bumped whenever normalize, tokenize or searchRowText change what a document contributes to an
+ * index; the row-text golden (`test/fixtures/search-row-text-v<revision>.json`) pins it. */
+export const SEARCH_TEXT_REVISION = 1;
+/** Largest answer, as JSON. A page of long hits can exceed it before 50 hits: the page then ends
+ * early with a cursor at the cut. */
+export const SEARCH_MAX_OUTPUT_BYTES = 64 * 1024;
+export const SEARCH_LIMITS = Object.freeze({
+    /** Largest query, UTF-8 bytes. */
+    maxQueryBytes: 1_024,
+    /** Distinct normalized query terms. */
+    maxQueryTerms: 16,
+    defaultRows: 10,
+    maxRows: 50,
+    /** Excerpt length, UTF-8 bytes. */
+    excerptBytes: 512,
+    /** Largest exact `type` or `tag` filter, UTF-8 bytes (the kernel query's filter bound). */
+    maxFilterBytes: 256,
+    /** Largest id `prefix` filter, UTF-8 bytes (a document id's bound). */
+    maxPrefixBytes: 512,
+    /** Largest cursor, UTF-8 bytes. */
+    maxCursorBytes: 2_048,
+    /** Values per facet, most frequent first. */
+    maxFacetValues: 50,
+    // Index limits, enforced while an in-memory index is built.
+    maxIndexDocuments: 20_000,
+    maxIndexSourceBytes: 67_108_864,
+    /** portal-webmcp's V1 value: a long document is indexed whole, never truncated; one over it is
+     * left out of the index and counted as skipped. */
+    maxTermsPerDocument: 65_536,
+    /** The default and ceiling of `searchDocuments`' `maxEvidenceInstances`: the most capped term
+     * instances a request's terms may hold across a corpus before it is refused as too broad. */
+    maxEvidenceInstances: 400_000,
+});
+/** Body occurrences of one distinct query term that can still add score. */
+export const BODY_OCCURRENCE_CAP = 20;
+/** Bytes an excerpt may reach behind its first body match before the match starts. */
+export const EXCERPT_LEAD_BYTES = 256;
+/** Documents processed between cancellation checks. */
+export const SIGNAL_INTERVAL = 128;
+export const SEARCH_MATCHES = Object.freeze(["auto", "all", "any"]);
+export const SEARCH_FACETS = Object.freeze(["type", "tags"]);
+export const SEARCH_MATCH_FIELDS = Object.freeze(["title", "type", "tag", "description", "id", "body"]);
+export const SEARCH_GUIDANCE = Object.freeze({
+    all: 'No document contains every query term. Retry with match "any", fewer terms, or different exact filters.',
+    any: "No document contains any searchable query term. Try domain-specific keywords or remove exact type and tag filters.",
+    /** The refusal of a request whose terms occur too often to rank (`maxEvidenceInstances`). */
+    broad: "The query's terms occur too often in this corpus to rank. Retry with fewer or more specific terms.",
+});
+// The one place that decides which frontmatter members become searchable or displayable fields;
+// nothing here reinterprets Markdown or adds Kind semantics.
+function stringMember(frontmatter, key) {
+    const value = frontmatter[key];
+    return typeof value === "string" ? value : undefined;
+}
+export function documentTitle(document) {
+    return stringMember(document.frontmatter, "title");
+}
+export function documentType(document) {
+    return stringMember(document.frontmatter, "type");
+}
+export function documentDescription(document) {
+    return stringMember(document.frontmatter, "description");
+}
+/** Declared string tags only; a non-array or non-string member contributes nothing. */
+export function documentTags(document) {
+    const value = document.frontmatter["tags"];
+    return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+//# sourceMappingURL=contract.js.map

package/dist/search/contract.js.map

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

package/dist/search/errors.d.ts

@@ -0,0 +1,30 @@
+/** The corpus exceeds an index limit or a host's configured bound. A kernel answers
+ * `result_too_large`. */
+export declare class SearchLimitError extends Error {
+    readonly limit: string;
+    readonly max: number;
+    readonly actual: number;
+    constructor(limit: string, max: number, actual: number, message?: string);
+}
+/** The request's terms hold more than `maxEvidenceInstances` capped instances. Still a
+ * `SearchLimitError` (`result_too_large`), but the corpus is searchable: the message is
+ * SEARCH_GUIDANCE.broad, to retry with fewer or more specific terms. */
+export declare class SearchBroadQueryError extends SearchLimitError {
+    constructor(max: number, actual: number);
+}
+export type SearchInputReason = "request" | "query" | "empty-query" | "too-many-query-terms" | "match" | "filter" | "limit" | "facets" | "cursor";
+/** The request is outside the contract. A kernel answers `invalid_input`. */
+export declare class SearchInputError extends Error {
+    readonly reason: SearchInputReason;
+    constructor(reason: SearchInputReason);
+}
+/** A cancelled index build or ranking rejects; it never returns a partial answer. */
+export declare class SearchAbortError extends Error {
+    constructor();
+}
+/** Throws as a stop asks: a signal already aborted, or a host check that throws. */
+export declare function stopIfAsked(stop: {
+    readonly signal?: AbortSignal;
+    readonly check?: () => void;
+} | undefined): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/search/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/search/errors.ts"],"names":[],"mappings":"AAKA;yBACyB;AACzB,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,SAAkD;CAOlH;AAED;;wEAEwE;AACxE,qBAAa,qBAAsB,SAAQ,gBAAgB;gBAC7C,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIxC;AAED,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,OAAO,GACP,aAAa,GACb,sBAAsB,GACtB,OAAO,GACP,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,QAAQ,CAAC;AAEb,6EAA6E;AAC7E,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;gBAEvB,MAAM,EAAE,iBAAiB;CAKtC;AAED,qFAAqF;AACrF,qBAAa,gBAAiB,SAAQ,KAAK;;CAK1C;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,GAAG,SAAS,GAAG,IAAI,CAGlH"}