@superbee/core 0.2.0-pre.4 → 0.2.0-pre.40

package/dist/remote-operations.js

@@ -1,3 +1,4 @@
+import { captureBodyReplacePosture } from "./body-replace-guards.js";
 /**
  * The uncertain-write transport over a wire authority: one {@link OperationTransport} that
  * delivers a `document.write` intent as an identified `PUT` through {@link RemoteBackend} and
@@ -13,8 +14,9 @@
  * or the authority's own runtime failure, says nothing about whether the write was applied, so
  * the primitive classifies it as unknown and resolves it by lookup, which is the whole reason
  * the identity exists. A 4xx is final because the authority answered and declined. A local
- * metadata encoding refusal is also final because no PUT was sent, not because the authority
- * recorded an outcome.
+ * refusal is also final because no PUT was sent, not because the authority recorded an outcome:
+ * an intent kind other than `document.write`, content that does not parse, or metadata the wire
+ * cannot encode is refused `USAGE` without a PUT.
  *
  * The transport is only sound against an authority that implements identity. A host that
  * predates it ignores the header, applies every retry as a fresh write, and answers the lookup
@@ -32,8 +34,8 @@
  * the verdict visible uses {@link openRemoteOperationTransport} or reads `wireCapabilities()`
  * itself. And the check is memoized on success: a host downgraded afterwards is not detected,
  * so one unidentified resubmission can reach it. Because every identified write is guarded by
- * its base, that exposure is bounded to a spurious conflict at a moved head, never a double
- * application.
+ * its base, that exposure is bounded to a spurious conflict at a moved head, or a second
+ * application when the head has returned to the base's exact content.
  *
  * This module imports nothing from Node so a browser working copy and a Node consumer share
  * one transport over one client adapter.
@@ -79,13 +81,28 @@ function buildTransport(remote, options) {
     };
     const transport = {
         async submit(intent) {
+            // 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") {
-                throw new Error(`remote operation transport: unsupported intent kind '${intent.kind}'`);
+                return { kind: "refused", code: "USAGE", message: `remote operation transport: unsupported intent kind '${intent.kind}'`, executed: false };
             }
-            const { frontmatter, body } = parseMarkdown(intent.content, pathFromConceptId(intent.target));
+            let parsed;
+            let posture;
+            try {
+                const descriptor = Object.getOwnPropertyDescriptor(intent, "bodyReplace");
+                if (descriptor && !("value" in descriptor))
+                    throw new Error("bodyReplace must be an explicit data field.");
+                posture = captureBodyReplacePosture(descriptor?.value);
+                parsed = parseMarkdown(intent.content, pathFromConceptId(intent.target));
+            }
+            catch (error) {
+                return { kind: "refused", code: "USAGE", message: error instanceof Error ? error.message : String(error), executed: false };
+            }
+            const { frontmatter, body } = parsed;
             const writeOptions = {
                 expectedVersion: intent.base,
                 requestId: intent.requestId,
+                ...(posture === undefined ? {} : { bodyReplace: posture }),
                 ...(options.actor === undefined ? {} : { actor: options.actor }),
             };
             try {
@@ -100,6 +117,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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;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,IAAI,MAAM,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACrC,MAAM,IAAI,KAAK,CAAC,wDAAwD,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;YAC1F,CAAC;YACD,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC9F,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,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"}
+{"version":3,"file":"remote-operations.js","sourceRoot":"","sources":["../src/remote-operations.ts"],"names":[],"mappings":"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"}

package/dist/remote-parsers.d.ts

@@ -66,7 +66,7 @@ export interface ReadSnapshotStreamOptions {
  * The `200` body of `GET /heads`, admitted or refused as one: a well-formed digest, a `heads`
  * array of `{ id, version }` rows, a `count` equal to the number of rows, and rows that digest
  * by the documented recipe to the digest served. Anything else rejects as malformed (a
- * {@link RemoteError} with code `RUNTIME` and status `502`) rather than being trusted. The
+ * {@link MalformedAnswer}, code `MALFORMED_ANSWER`) rather than being trusted. The
  * recomputation is what stops a listing that is whole by its own count but not the state its
  * digest names (a shortened listing under the real digest) from being diffed as a mass
  * deletion. Rows keep the order served: the recipe sorts for itself, so order does not decide

package/dist/remote-parsers.js

@@ -31,7 +31,7 @@ function isDocumentHead(value) {
  * The `200` body of `GET /heads`, admitted or refused as one: a well-formed digest, a `heads`
  * array of `{ id, version }` rows, a `count` equal to the number of rows, and rows that digest
  * by the documented recipe to the digest served. Anything else rejects as malformed (a
- * {@link RemoteError} with code `RUNTIME` and status `502`) rather than being trusted. The
+ * {@link MalformedAnswer}, code `MALFORMED_ANSWER`) rather than being trusted. The
  * recomputation is what stops a listing that is whole by its own count but not the state its
  * digest names (a shortened listing under the real digest) from being diffed as a mass
  * deletion. Rows keep the order served: the recipe sorts for itself, so order does not decide

package/dist/search/backend-source.d.ts

@@ -0,0 +1,6 @@
+import type { StorageBackend } from "../types.js";
+import { type MemorySearchSourceOptionsV1, type MemorySearchSourceV1 } from "./memory-source.js";
+/** Read a complete backend corpus in bounded batches. Failed reads refuse the whole search;
+ * the cursor key describes the versions actually read, including unsent working-copy edits. */
+export declare function searchSourceFromBackend(backend: StorageBackend, options?: Omit<MemorySearchSourceOptionsV1, "key">): Promise<MemorySearchSourceV1>;
+//# sourceMappingURL=backend-source.d.ts.map

package/dist/search/backend-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-source.d.ts","sourceRoot":"","sources":["../../src/search/backend-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,OAAO,EAA0C,KAAK,2BAA2B,EAAE,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAKzI;+FAC+F;AAC/F,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,IAAI,CAAC,2BAA2B,EAAE,KAAK,CAAM,GACrD,OAAO,CAAC,oBAAoB,CAAC,CAqB/B"}

package/dist/search/backend-source.js

@@ -0,0 +1,33 @@
+import { headsDigest } from "../heads-digest.js";
+import { memorySearchSource, memorySearchBounds } from "./memory-source.js";
+import { SearchLimitError, stopIfAsked } from "./errors.js";
+import { documentSourceBytes } from "./row-text.js";
+/** Read a complete backend corpus in bounded batches. Failed reads refuse the whole search;
+ * the cursor key describes the versions actually read, including unsent working-copy edits. */
+export async function searchSourceFromBackend(backend, options = {}) {
+    const { maxDocuments, maxSourceBytes } = memorySearchBounds(options);
+    stopIfAsked(options.stop);
+    const ids = await backend.list();
+    if (ids.length > maxDocuments.max)
+        throw new SearchLimitError(maxDocuments.name, maxDocuments.max, ids.length);
+    const documents = [];
+    let sourceBytes = 0;
+    for (let start = 0; start < ids.length; start += 128) {
+        stopIfAsked(options.stop);
+        const batch = ids.slice(start, start + 128);
+        const results = await backend.readMany(batch);
+        if (results.length !== batch.length)
+            throw new TypeError("Search backend returned an incomplete batch.");
+        for (const [index, { doc, version }] of results.entries()) {
+            if (doc.id !== batch[index])
+                throw new TypeError("Search backend returned a different document identity.");
+            const document = { ...doc, version };
+            sourceBytes += documentSourceBytes(document);
+            if (sourceBytes > maxSourceBytes.max)
+                throw new SearchLimitError(maxSourceBytes.name, maxSourceBytes.max, sourceBytes);
+            documents.push(document);
+        }
+    }
+    return memorySearchSource(documents, { ...options, key: headsDigest(documents) });
+}
+//# sourceMappingURL=backend-source.js.map

package/dist/search/backend-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-source.js","sourceRoot":"","sources":["../../src/search/backend-source.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAA+D,MAAM,oBAAoB,CAAC;AACzI,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD;+FAC+F;AAC/F,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAuB,EACvB,UAAoD,EAAE;IAEtD,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,GAAG;QAAE,MAAM,IAAI,gBAAgB,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/G,MAAM,SAAS,GAAuB,EAAE,CAAC;IACzC,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,IAAI,GAAG,EAAE,CAAC;QACrD,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;YAAE,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;QACzG,KAAK,MAAM,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC1D,IAAI,GAAG,CAAC,EAAE,KAAK,KAAK,CAAC,KAAK,CAAC;gBAAE,MAAM,IAAI,SAAS,CAAC,wDAAwD,CAAC,CAAC;YAC3G,MAAM,QAAQ,GAAG,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,CAAC;YACrC,WAAW,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAC7C,IAAI,WAAW,GAAG,cAAc,CAAC,GAAG;gBAAE,MAAM,IAAI,gBAAgB,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YACvH,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,kBAAkB,CAAC,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AACpF,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"}

package/dist/search/errors.js

@@ -0,0 +1,50 @@
+// The ways a search refuses: a corpus over an index limit (or a host's configured bound), a request
+// whose terms occur too often to rank, a request outside the contract, and a cancellation. Messages
+// are fixed text; none repeats the caller's input.
+import { SEARCH_GUIDANCE } from "./contract.js";
+/** The corpus exceeds an index limit or a host's configured bound. A kernel answers
+ * `result_too_large`. */
+export class SearchLimitError extends Error {
+    limit;
+    max;
+    actual;
+    constructor(limit, max, actual, message = `The search corpus exceeds its ${limit} limit.`) {
+        super(message);
+        this.name = "SearchLimitError";
+        this.limit = limit;
+        this.max = max;
+        this.actual = actual;
+    }
+}
+/** 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 class SearchBroadQueryError extends SearchLimitError {
+    constructor(max, actual) {
+        super("maxEvidenceInstances", max, actual, SEARCH_GUIDANCE.broad);
+        this.name = "SearchBroadQueryError";
+    }
+}
+/** The request is outside the contract. A kernel answers `invalid_input`. */
+export class SearchInputError extends Error {
+    reason;
+    constructor(reason) {
+        super(`The search request is invalid (${reason}).`);
+        this.name = "SearchInputError";
+        this.reason = reason;
+    }
+}
+/** A cancelled index build or ranking rejects; it never returns a partial answer. */
+export class SearchAbortError extends Error {
+    constructor() {
+        super("The search was cancelled.");
+        this.name = "AbortError";
+    }
+}
+/** Throws as a stop asks: a signal already aborted, or a host check that throws. */
+export function stopIfAsked(stop) {
+    if (stop?.signal?.aborted)
+        throw new SearchAbortError();
+    stop?.check?.();
+}
+//# sourceMappingURL=errors.js.map

package/dist/search/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/search/errors.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,oGAAoG;AACpG,mDAAmD;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;yBACyB;AACzB,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,KAAK,CAAS;IACd,GAAG,CAAS;IACZ,MAAM,CAAS;IAExB,YAAY,KAAa,EAAE,GAAW,EAAE,MAAc,EAAE,OAAO,GAAG,iCAAiC,KAAK,SAAS;QAC/G,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;wEAEwE;AACxE,MAAM,OAAO,qBAAsB,SAAQ,gBAAgB;IACzD,YAAY,GAAW,EAAE,MAAc;QACrC,KAAK,CAAC,sBAAsB,EAAE,GAAG,EAAE,MAAM,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAaD,6EAA6E;AAC7E,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,MAAM,CAAoB;IAEnC,YAAY,MAAyB;QACnC,KAAK,CAAC,kCAAkC,MAAM,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,qFAAqF;AACrF,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC;QACE,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,IAAgF;IAC1G,IAAI,IAAI,EAAE,MAAM,EAAE,OAAO;QAAE,MAAM,IAAI,gBAAgB,EAAE,CAAC;IACxD,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;AAClB,CAAC"}

package/dist/search/identity.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Canonical JSON for identity digests, cursor bodies, and byte measurement.
+ * Keys sort by UTF-16 code unit, `undefined` members are dropped, and anything
+ * outside plain JSON is rejected so a digest can never depend on host ordering.
+ */
+export declare function canonicalJson(value: unknown): string;
+/** Locale-independent UTF-16 code-unit ordering; canonical order never uses host collation. */
+export declare function codeUnitCompare(a: string, b: string): number;
+export declare function base64UrlEncode(bytes: Uint8Array): string;
+/** Strict unpadded base64url decoding; any stray character rejects the input. */
+export declare function base64UrlDecode(value: string): Uint8Array | undefined;
+//# sourceMappingURL=identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/search/identity.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAIpD;AAwBD,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5D;AAID,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAazD;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAwBrE"}

package/dist/search/identity.js

@@ -0,0 +1,90 @@
+// Canonical JSON, code-unit order and strict base64url for the index identity and cursors. Moved from
+// portal-webmcp 0.3.1 (`identity.ts`); private to the subpath. SHA-256 is core's (`../sha256.ts`).
+/**
+ * Canonical JSON for identity digests, cursor bodies, and byte measurement.
+ * Keys sort by UTF-16 code unit, `undefined` members are dropped, and anything
+ * outside plain JSON is rejected so a digest can never depend on host ordering.
+ */
+export function canonicalJson(value) {
+    const rendered = serialize(value);
+    if (rendered === undefined)
+        throw new TypeError("canonical JSON received an undefined root");
+    return rendered;
+}
+function serialize(value) {
+    if (value === undefined)
+        return undefined;
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return JSON.stringify(value);
+    if (typeof value === "number") {
+        if (!Number.isFinite(value))
+            throw new TypeError("canonical JSON received a non-finite number");
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value))
+        return `[${value.map((item) => serialize(item) ?? "null").join(",")}]`;
+    if (typeof value === "object") {
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null)
+            throw new TypeError("canonical JSON received a non-plain object");
+        const members = [];
+        for (const key of Object.keys(value).sort(codeUnitCompare)) {
+            const rendered = serialize(value[key]);
+            if (rendered !== undefined)
+                members.push(`${JSON.stringify(key)}:${rendered}`);
+        }
+        return `{${members.join(",")}}`;
+    }
+    throw new TypeError("canonical JSON received a non-JSON value");
+}
+/** Locale-independent UTF-16 code-unit ordering; canonical order never uses host collation. */
+export function codeUnitCompare(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+const BASE64URL = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
+export function base64UrlEncode(bytes) {
+    let out = "";
+    for (let index = 0; index < bytes.byteLength; index += 3) {
+        const a = bytes[index];
+        const b = bytes[index + 1];
+        const c = bytes[index + 2];
+        out += BASE64URL[a >> 2] + BASE64URL[((a & 0b11) << 4) | ((b ?? 0) >> 4)];
+        if (b === undefined)
+            break;
+        out += BASE64URL[((b & 0b1111) << 2) | ((c ?? 0) >> 6)];
+        if (c === undefined)
+            break;
+        out += BASE64URL[c & 0b111111];
+    }
+    return out;
+}
+/** Strict unpadded base64url decoding; any stray character rejects the input. */
+export function base64UrlDecode(value) {
+    if (value.length % 4 === 1)
+        return undefined;
+    const bits = [];
+    for (const character of value) {
+        const index = BASE64URL.indexOf(character);
+        if (index < 0)
+            return undefined;
+        bits.push(index);
+    }
+    const bytes = new Uint8Array(Math.floor((bits.length * 6) / 8));
+    let accumulator = 0;
+    let width = 0;
+    let cursor = 0;
+    for (const sextet of bits) {
+        accumulator = (accumulator << 6) | sextet;
+        width += 6;
+        if (width >= 8) {
+            width -= 8;
+            bytes[cursor] = (accumulator >> width) & 0xff;
+            cursor += 1;
+        }
+    }
+    // Reject non-canonical trailing bits so one byte string has exactly one encoding.
+    if (width > 0 && (accumulator & ((1 << width) - 1)) !== 0)
+        return undefined;
+    return bytes;
+}
+//# sourceMappingURL=identity.js.map

package/dist/search/identity.js.map

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

package/dist/search/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `@superbee/core/search`: the one `documents.search.v1` engine. The contract, query rules,
+ * ranking, the any-term fallback, facets, cursors and page budgets live here; a backend supplies
+ * what it searches through the `SearchSource` seam, and `memorySearchSource` indexes a complete
+ * corpus in memory. Pure ECMAScript with no dependency, so a Worker, a browser page and the CLI run
+ * the same code. Ranking is portal-webmcp 0.3.1's (`portal-webmcp-search/v1`).
+ */
+export { BODY_OCCURRENCE_CAP, SEARCH_ALGORITHM, SEARCH_FACETS, SEARCH_GUIDANCE, SEARCH_LIMITS, SEARCH_MATCHES, SEARCH_MATCH_FIELDS, SEARCH_MAX_OUTPUT_BYTES, SEARCH_OPERATION_ID, SEARCH_TEXT_REVISION, type SearchDocumentV1, type SearchFacetV1, type SearchFacetValueV1, type SearchFiltersV1, type SearchHitV1, type SearchMatchFieldV1, type SearchMatchModeV1, type SearchMatchV1, type SearchRequestV1, type SearchResultV1, type SearchStopV1, } from "./contract.js";
+export { SearchAbortError, SearchBroadQueryError, SearchInputError, SearchLimitError, type SearchInputReason, } from "./errors.js";
+export { normalize, normalizeQuery, phrase, relaxQuery, tokenize, type NormalizedQueryV1, type RelaxedQueryV1, } from "./text.js";
+export { documentSourceBytes, normalizerFingerprint, searchRowText, textVersion, type SearchRowTextV1, } from "./row-text.js";
+export type { SearchCorpusSizeV1, SearchEvidenceBatchV1, SearchEvidenceBoundsV1, SearchEvidenceV1, SearchSource, SearchTextV1, } from "./source.js";
+export { memorySearchSource, type MemorySearchSourceOptionsV1, type MemorySearchSourceV1 } from "./memory-source.js";
+export { searchDocuments, validateSearchRequest, type SearchOptionsV1, type SearchScopeV1 } from "./search.js";
+export { searchSourceFromBackend } from "./backend-source.js";
+//# sourceMappingURL=index.d.ts.map