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

package/dist/source-engine/target-descriptor.js

@@ -0,0 +1,26 @@
+/** Validation of the immutable, JSON-persisted establishment boundary. */
+import { assertSafeConceptId } from "../paths.js";
+import { isRequestIdentity } from "../uncertain-write.js";
+import { sha256Hex } from "../versioning.js";
+const object = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
+export function isSourceEstablishment(v) {
+    if (!object(v) || v.contract !== 1 || ![v.generation, v.group, v.target, v.observed_at].every(x => typeof x === "string" && x.length > 0))
+        return false;
+    try {
+        assertSafeConceptId(v.target);
+    }
+    catch {
+        return false;
+    }
+    if (v.kind === "adopt")
+        return typeof v.expectedVersion === "string" && v.expectedVersion.length > 0 && v.intent === undefined;
+    if (v.kind !== "create" || v.expectedVersion !== null || !object(v.intent))
+        return false;
+    const i = v.intent;
+    return typeof i.requestId === "string" && isRequestIdentity(i.requestId) && i.kind === "document.write"
+        && i.target === v.target && i.base === null && i.recreates === undefined && typeof i.content === "string"
+        && new TextEncoder().encode(JSON.stringify(i)).length <= 262144
+        && i.local === `sha256:${sha256Hex(i.content)}` && i.createdAt === v.observed_at
+        && i.attempts === 0 && i.state === "pending";
+}
+//# sourceMappingURL=target-descriptor.js.map

package/dist/source-engine/target-descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-descriptor.js","sourceRoot":"","sources":["../../src/source-engine/target-descriptor.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,MAAM,MAAM,GAAG,CAAC,CAAU,EAAgC,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACtH,MAAM,UAAU,qBAAqB,CAAC,CAAU;IAC9C,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACxJ,IAAI,CAAC;QAAC,mBAAmB,CAAC,CAAC,CAAC,MAAgB,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;IACxE,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC,CAAC,eAAe,KAAK,QAAQ,IAAI,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC;IAC/H,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,eAAe,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACzF,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,OAAO,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB;WAClG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;WACtG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,MAAM;WAC5D,CAAC,CAAC,KAAK,KAAK,UAAU,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,WAAW;WAC7E,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC;AACjD,CAAC"}

package/dist/source-engine/target.d.ts

@@ -0,0 +1,82 @@
+/** Explicit target establishment around the existing mutation and tuple-acceptance owners. */
+import type { BoundFeed } from "../connectors.js";
+import type { Finding, OverlayReceipt } from "../record-overlay/types.js";
+import type { ConceptId, Version } from "../types.js";
+import { type OperationIntent, type Outcome } from "../uncertain-write.js";
+import { type SourceOverlayOptions, type SourceOverlayResult } from "./overlay.js";
+import type { SourceState } from "./machine-state.js";
+import type { PageCommit } from "./types.js";
+export interface SourceTargetNamespace {
+    contract: 1;
+    authority: string;
+    bundle: string;
+}
+/** Factory-local bounds. MachineState owns smaller host caps and the combined acceptance envelope on every write. */
+export interface SourceTargetLimits {
+    inventory: number;
+    establishmentsPerPage: number;
+    intentBytes: number;
+}
+export type SourceTargetAdmission = {
+    kind: "admitted";
+} | {
+    kind: "held";
+    code: "adoption_required" | "ownership_unproven" | "overlap_unsupported" | "scope_changed";
+};
+/** The durable owner grants fresh exclusive send claims internally; recovery is lookup only. */
+export interface SourceTargetDelivery {
+    contract: 1;
+    acceptsRequestId(requestId: string): boolean;
+    deliver(intent: Readonly<OperationIntent>, input: Readonly<{
+        phase: "initial" | "recovery";
+        signal?: AbortSignal;
+    }>): Promise<Outcome>;
+}
+export interface SourceTargetAdapterOptions {
+    overlay: SourceOverlayOptions;
+    bound: BoundFeed;
+    namespace: SourceTargetNamespace;
+    generation: string;
+    intentScope: string;
+    limits: SourceTargetLimits;
+    mintRequestId?: () => string;
+    creation: SourceTargetDelivery;
+    admit(input: Readonly<{
+        action: "create" | "adopt";
+        external_id: string;
+        target: string;
+        expectedVersion: Version | null;
+        generation: string;
+    }>): Promise<SourceTargetAdmission>;
+}
+export interface SourceEstablishment {
+    contract: 1;
+    generation: string;
+    group: string;
+    target: ConceptId;
+    kind: "create" | "adopt";
+    expectedVersion: Version | null;
+    observed_at: string;
+    intent?: OperationIntent;
+}
+export interface SourceCommitPreparation {
+    establishments: Readonly<Record<string, SourceEstablishment>>;
+}
+export declare function sourceTargetId(input: {
+    namespace: SourceTargetNamespace;
+    targetKind: string;
+    prefix: string;
+    resource: string;
+    externalId: string;
+}): ConceptId;
+export declare function createSourceTargetAdapter(input: SourceTargetAdapterOptions): {
+    prepareCommit: (page: PageCommit) => Promise<SourceCommitPreparation>;
+    commit: (page: PageCommit) => Promise<SourceOverlayResult>;
+    snapshot: () => import("./overlay.js").SourceOverlaySnapshot;
+    stagedSnapshot: () => import("./overlay.js").SourceOverlaySnapshot | null;
+    consume: () => void;
+    discard: () => void;
+    reconcile(state: SourceState, at: string): Promise<SourceOverlayResult>;
+    applyFindings: (findings: readonly Finding[], at: string) => Promise<OverlayReceipt>;
+};
+//# sourceMappingURL=target.d.ts.map

package/dist/source-engine/target.d.ts.map

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

package/dist/source-engine/target.js

@@ -0,0 +1,213 @@
+import { readDocVersioned } from "../bundle-ops.js";
+import { prepareDocumentMutationCandidate } from "../document-mutation.js";
+import { stringifyDoc, parseMarkdown } from "../document-codec.js";
+import { assertSafeConceptId } from "../paths.js";
+import { isExcludedRecord, NEVER_OWNED, workStateFields } from "../record-overlay/policy.js";
+import { overlayCanonicalJson } from "../record-overlay/canonical.js";
+import { isRequestIdentity, mintRequestId } from "../uncertain-write.js";
+import { sha256Hex } from "../versioning.js";
+import { createSourceOverlayAdapter } from "./overlay.js";
+import { registerSourceTargetConsumer } from "./target-consumer.js";
+import { isSourceEstablishment } from "./target-descriptor.js";
+const bytes = (s) => new TextEncoder().encode(s).length;
+function scalar(s) {
+    if (typeof s !== "string" || !s.length || /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/u.test(s))
+        throw new Error("source target identity must be nonempty Unicode scalar text");
+}
+export function sourceTargetId(input) {
+    const { namespace, targetKind, prefix, resource, externalId } = input;
+    if (namespace.contract !== 1)
+        throw new Error("unsupported source target namespace");
+    for (const s of [namespace.authority, namespace.bundle]) {
+        scalar(s);
+        if (bytes(s) > 512)
+            throw new Error("source target namespace limit");
+    }
+    if (externalId.length > 2048)
+        throw new Error("source external identity limit");
+    const parts = ["superbee/source-target/v1", namespace.authority, namespace.bundle, targetKind, resource, externalId];
+    parts.forEach(scalar);
+    // Prefix is pinned placement, deliberately outside the identity digest.
+    if (!prefix.endsWith("/"))
+        throw new Error("source target Convention requires a directory prefix");
+    assertSafeConceptId(`${prefix}source-placeholder`);
+    const id = `${prefix}source-${sha256Hex(parts.map(s => `${bytes(s)}:${s}`).join(""))}`;
+    assertSafeConceptId(id);
+    return id;
+}
+const ceilings = { inventory: 10000, establishmentsPerPage: 100, intentBytes: 262144 };
+const protectedFields = new Set(["type", "sources", "body", "tags", "claims", "generated", "timestamp", "actor", "updated_by", "verification", "links"]);
+export function createSourceTargetAdapter(input) {
+    const options = { ...input, bound: structuredClone(input.bound), namespace: structuredClone(input.namespace), limits: structuredClone(input.limits),
+        overlay: { ...input.overlay, content: { ...input.overlay.content, registry: structuredClone(input.overlay.content.registry) }, policy: structuredClone(input.overlay.policy), accepted: input.overlay.accepted === undefined ? undefined : structuredClone(input.overlay.accepted) } };
+    const { bound, overlay: cfg, limits, generation, intentScope } = options;
+    const kind = structuredClone(cfg.content.registry.kinds.get(bound.kind.governs));
+    if (!kind || overlayCanonicalJson(kind) !== overlayCanonicalJson(bound.kind) || cfg.content.okfVersion !== "0.2"
+        || !kind.path || !kind.path.endsWith("/") || kind.sections?.length || !generation || !intentScope
+        || cfg.policy.provider !== bound.resource || bound.policy.provider !== bound.resource
+        || bound.source.target_kind !== kind.governs || cfg.policy.target_kind !== kind.governs
+        || overlayCanonicalJson(cfg.policy) !== overlayCanonicalJson(bound.policy) || options.creation.contract !== 1)
+        throw new Error("source target binding/Kind/edition mismatch");
+    for (const k of Object.keys(ceilings))
+        if (!Number.isSafeInteger(limits[k]) || limits[k] < 1 || limits[k] > ceilings[k])
+            throw new Error("source target limit invalid");
+    if (cfg.overlays.size > limits.inventory)
+        throw new Error("source target inventory limit");
+    for (const field of cfg.policy.owned_fields)
+        if (NEVER_OWNED.has(field) || workStateFields(kind, ["0.1", "0.2"]).has(field) || protectedFields.has(field) || ![...kind.fields.required, ...kind.fields.optional, "title"].includes(field))
+            throw new Error("source target ownership invalid");
+    if (!cfg.policy.owned_fields.includes("title"))
+        throw new Error("source target title ownership required");
+    const overlay = createSourceOverlayAdapter(cfg);
+    const canonical = (id) => sourceTargetId({ namespace: options.namespace, targetKind: kind.governs, prefix: kind.path, resource: bound.resource, externalId: id });
+    const accepted = (id, target) => overlay.snapshot().entries.some(e => e.feed === cfg.policy.feed && e.resource === bound.resource && e.external_id === id && e.target === target);
+    async function read(id) {
+        try {
+            return await readDocVersioned(cfg.content.bundle, id);
+        }
+        catch (error) {
+            if (error?.code === "ENOENT")
+                return null;
+            throw error;
+        }
+    }
+    function identity(row, id) {
+        const fm = row.doc.frontmatter;
+        const sources = Array.isArray(fm.sources) ? fm.sources : [];
+        if (fm.type !== kind.governs || !row.doc.id.startsWith(kind.path)
+            || sources.filter(s => s && typeof s === "object" && s.resource === bound.resource && s.id === id).length !== 1)
+            throw new Error("source target identity mismatch");
+    }
+    async function admit(action, id, target, version) {
+        const decision = await options.admit(Object.freeze({ action, external_id: id, target, expectedVersion: version, generation }));
+        if (decision.kind !== "admitted")
+            throw new Error(`source target ${decision.code}`);
+    }
+    function projection(change) {
+        const fields = { type: kind.governs, sources: [{ resource: bound.resource, id: change.external_id }] };
+        for (const f of cfg.policy.owned_fields)
+            if (Object.hasOwn(change.after, f))
+                fields[f] = structuredClone(change.after[f]);
+        for (const f of kind.fields.required)
+            if (f !== "type" && f !== "sources" && (!cfg.policy.owned_fields.includes(f) || !Object.hasOwn(fields, f)))
+                throw new Error("source target required field unavailable");
+        return fields;
+    }
+    async function prepareCommit(page) {
+        if (page.replay || page.establishments !== undefined || page.feed !== cfg.policy.feed || page.provider !== bound.resource)
+            throw new Error("source target preparation scope");
+        const group = `sha256:${sha256Hex(overlayCanonicalJson([intentScope, page.feed, generation, page.observed_at, page.page, page.changes]))}`;
+        const establishments = Object.create(null);
+        for (const change of page.changes) {
+            if (!change.after || change.change_kind === "disappeared" || isExcludedRecord(cfg.policy, change.external_id, change.after.title))
+                continue;
+            const id = change.external_id;
+            const matches = cfg.overlays.lookup(bound.resource, id, { type: kind.governs });
+            if (matches.length > 1)
+                throw new Error("source target ambiguous identity");
+            let target = matches[0]?.id ?? canonical(id);
+            let row = await read(target);
+            if (matches.length && !row)
+                throw new Error("source target disappeared");
+            if (row) {
+                identity(row, id);
+                if (accepted(id, target))
+                    continue;
+                await admit("adopt", id, target, row.version);
+                establishments[id] = { contract: 1, generation, group, target, kind: "adopt", expectedVersion: row.version, observed_at: page.observed_at };
+            }
+            else {
+                await admit("create", id, target, null);
+                const { candidate } = prepareDocumentMutationCandidate(undefined, { frontmatter: projection(change), body: "" }, {
+                    mode: "create-only", id: target, registry: cfg.content.registry, strict: true, okfVersion: "0.2", actor: cfg.actor, now: () => page.observed_at,
+                });
+                const content = stringifyDoc(candidate.frontmatter, candidate.body);
+                const requestId = (options.mintRequestId ?? mintRequestId)();
+                if (!isRequestIdentity(requestId) || !options.creation.acceptsRequestId(requestId))
+                    throw new Error("source target request identity refused");
+                const intent = { requestId, kind: "document.write", target, base: null, local: `sha256:${sha256Hex(content)}`, content, createdAt: page.observed_at, attempts: 0, state: "pending" };
+                if (bytes(JSON.stringify(intent)) > limits.intentBytes)
+                    throw new Error("source target intent limit");
+                establishments[id] = { contract: 1, generation, group, target, kind: "create", expectedVersion: null, observed_at: page.observed_at, intent };
+            }
+        }
+        if (Object.keys(establishments).length > limits.establishmentsPerPage)
+            throw new Error("source target page limit");
+        return { establishments };
+    }
+    async function commit(page) {
+        if (page.feed !== cfg.policy.feed || page.provider !== bound.resource)
+            throw new Error("source target commit scope");
+        for (const change of page.changes) {
+            if (!change.after || change.change_kind === "disappeared")
+                continue;
+            const id = change.external_id, e = page.establishments && Object.hasOwn(page.establishments, id) ? page.establishments[id] : undefined;
+            if (!e) {
+                if (isExcludedRecord(cfg.policy, id, change.after.title))
+                    continue;
+                const matches = cfg.overlays.lookup(bound.resource, id, { type: kind.governs });
+                if (matches.length !== 1 || !accepted(id, matches[0].id))
+                    throw new Error("source target establishment required");
+                continue;
+            }
+            if (!isSourceEstablishment(e) || e.generation !== generation)
+                throw new Error("source target scope_changed");
+            if (e.kind === "create") {
+                if (e.target !== canonical(id) || !options.creation.acceptsRequestId(e.intent.requestId))
+                    throw new Error("source target intent scope");
+                const parsed = parseMarkdown(e.intent.content, e.target);
+                const expected = prepareDocumentMutationCandidate(undefined, { frontmatter: projection(change), body: "" }, { mode: "create-only", id: e.target, registry: cfg.content.registry, strict: true, okfVersion: "0.2", actor: cfg.actor, now: () => e.observed_at }).candidate;
+                if (stringifyDoc(expected.frontmatter, expected.body) !== e.intent.content || parsed.body.trim() !== "")
+                    throw new Error("source target scope_changed");
+                const outcome = await options.creation.deliver(structuredClone(e.intent), { phase: page.replay ? "recovery" : "initial" });
+                if (outcome.kind !== "committed" && outcome.kind !== "conflict")
+                    throw new Error("source target outcome unsettled");
+                if (outcome.kind === "conflict" && (outcome.actual === null || outcome.tombstone !== undefined))
+                    throw new Error("source target tombstone/conflict");
+                const row = await read(e.target);
+                if (!row)
+                    throw new Error("source target missing after settlement");
+                identity(row, id);
+                if (outcome.kind === "conflict")
+                    await admit("adopt", id, e.target, row.version);
+                cfg.overlays.replace(row.doc, row.version);
+            }
+            else {
+                const row = await read(e.target);
+                if (!row || row.version !== e.expectedVersion)
+                    throw new Error("source target adoption changed");
+                identity(row, id);
+                await admit("adopt", id, e.target, row.version);
+                cfg.overlays.replace(row.doc, row.version);
+            }
+        }
+        const result = await overlay.commit(page);
+        if (Object.keys(page.establishments ?? {}).some(id => result.hold?.includes(id) || result.retry?.includes(id))) {
+            overlay.discard();
+            throw new Error("source target overlay held");
+        }
+        return result;
+    }
+    registerSourceTargetConsumer(prepareCommit, commit, overlay.discard);
+    return { prepareCommit, commit, snapshot: overlay.snapshot, stagedSnapshot: overlay.stagedSnapshot, consume: overlay.consume, discard: overlay.discard,
+        async reconcile(state, at) {
+            for (const [id, entry] of Object.entries(state.records)) {
+                if (entry.gone || Object.hasOwn(state.pending ?? {}, id) || isExcludedRecord(cfg.policy, id, entry.after.title))
+                    continue;
+                const matches = cfg.overlays.lookup(bound.resource, id, { type: kind.governs });
+                if (matches.length > 1)
+                    throw new Error("source target ambiguous identity");
+                if (matches.length === 1 && !accepted(id, matches[0].id)) {
+                    const row = await read(matches[0].id);
+                    if (!row)
+                        throw new Error("source target missing");
+                    identity(row, id);
+                    await admit("adopt", id, row.doc.id, row.version);
+                }
+            }
+            return overlay.reconcile(state, at);
+        },
+        applyFindings: (findings, at) => overlay.applyFindings(findings, at),
+    };
+}
+//# sourceMappingURL=target.js.map

package/dist/source-engine/target.js.map

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

package/dist/source-engine/types.d.ts

@@ -2,6 +2,7 @@
 import type { BoundFeed, Connector, MappingDiagnostic } from "../connectors.js";
 import type { Finding, RecordChange } from "../record-overlay/types.js";
 import type { ConceptId } from "../types.js";
+import type { SourceCommitPreparation, SourceEstablishment } from "./target.js";
 import type { MachineState } from "./machine-state.js";
 import type { FetchIdentity } from "./robots.js";
 export type HttpMethod = "GET" | "POST";
@@ -192,10 +193,11 @@ export interface SourceRequestRow {
 }
 /** What the caller writes for one page: the record-overlay changes, and whether the pass ended complete. */
 export interface PageCommit {
+    establishments?: Readonly<Record<string, SourceEstablishment>>;
     feed: ConceptId;
     provider: string;
     observed_at: string;
-    /** 1-based within the run; 0 for the replay of pending changes before the first request. */
+    /** Original 1-based page for protected replay; legacy pending replay uses 0. */
     page: number;
     /** The changes were held by an earlier commit and are planned again. */
     replay: boolean;
@@ -287,6 +289,8 @@ export interface ObserveSourceOptions<Spec = unknown, Cursor = unknown> {
     rules?: RequestRules;
     statuses?: Partial<StatusRules>;
     /** Write one page's changes; the cursor and record state are stored only after this resolves. */
+    /** Establishment recovery requires the original paired callbacks from createSourceTargetAdapter. */
+    prepareCommit?(page: PageCommit): Promise<SourceCommitPreparation>;
     commit(page: PageCommit): Promise<CommitResult | void>;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/source-engine/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/source-engine/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/source-engine/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;AAExC,yGAAyG;AACzG,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEjE,MAAM,MAAM,UAAU,CAAC,IAAI,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAE1H,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CAAC;AAExC;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC5D;AAED,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,mHAAmH;AACnH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc,CAAC,IAAI,EAAE,MAAM;IAC1C,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,gFAAgF;IAChF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sFAAsF;IACtF,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,aAAa,GAAG,UAAU,CAAC;IACjC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,kEAAkE;IAClE,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,GAAG,EAAE,IAAI,CAAC;IACV,+EAA+E;IAC/E,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;CACrD;AAED,0BAA0B;AAC1B,MAAM,WAAW,WAAW,CAAC,MAAM;IACjC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,kFAAkF;IAClF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,yCAAyC;IACzC,IAAI,EAAE,OAAO,CAAC;IACd,iGAAiG;IACjG,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC3C,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC/C;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,IAAI,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO;IAC7D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,WAAW,CAAC;IACvC,8BAA8B;IAC9B,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9C,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,SAAS,MAAM,EAAE,CAAC;IAC1D,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;CAC1E;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3C;;;OAGG;IACH,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC;IACzC,sEAAsE;IACtE,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACnD,yFAAyF;IACzF,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;CACzE;AAED,oHAAoH;AACpH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,uGAAuG;IACvG,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,aAAa;AACvB,4CAA4C;AAC1C,UAAU;AACZ,mFAAmF;GACjF,UAAU;AACZ,sEAAsE;GACpE,oBAAoB;AACtB,6CAA6C;GAC3C,sBAAsB,GACtB,WAAW,GACX,qBAAqB,GACrB,WAAW;AACb,+DAA+D;GAC7D,SAAS;AACX,kEAAkE;GAChE,QAAQ,CAAC;AAEb,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,CAAC;IACnB,gBAAgB;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,4GAA4G;AAC5G,MAAM,WAAW,UAAU;IACzB,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC/D,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,sDAAsD;IACtD,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAC,CAAC;IACvE,yDAAyD;IACzD,QAAQ,EAAE,OAAO,CAAC;IAClB,oFAAoF;IACpF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,IAAI,EAAE,aAAa,GAAG,UAAU,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gGAAgG;IAChG,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9D,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,4CAA4C;IAC5C,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;IACzC,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB,CAAC,IAAI,GAAG,OAAO,EAAE,MAAM,GAAG,OAAO;IACpE,6FAA6F;IAC7F,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/C,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,CAAC,EAAE,aAAa,GAAG,UAAU,CAAC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B;;;;OAIG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,kGAAkG;IAClG,kBAAkB,CAAC,EAAE;QAAC,QAAQ,EAAE,CAAC,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;IACnD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAChC,iGAAiG;IACjG,oGAAoG;IACpG,aAAa,CAAC,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACnE,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CACxD"}

package/dist/source-profiles/index.d.ts

@@ -14,7 +14,7 @@ export interface RestJsonCursor {
 }
 export declare const restJsonProfile: SourceProfile<ConnectorSource, RestJsonCursor>;
 /** Contract-1 composition helpers for explicitly trusted standalone source plugins. */
-export declare const SOURCE_PLUGIN_CORE_VERSION = "0.2.0-pre.40";
+export declare const SOURCE_PLUGIN_CORE_VERSION = "0.2.0-pre.42";
 export interface SourcePluginHelpers {
     readonly restJsonProfile: typeof restJsonProfile;
     readonly nextLinkTarget: typeof nextLinkTarget;

package/dist/source-profiles/index.js

@@ -196,7 +196,7 @@ export const restJsonProfile = Object.freeze({
     },
 });
 /** Contract-1 composition helpers for explicitly trusted standalone source plugins. */
-export const SOURCE_PLUGIN_CORE_VERSION = "0.2.0-pre.40";
+export const SOURCE_PLUGIN_CORE_VERSION = "0.2.0-pre.42";
 export { nextLinkTarget };
 export const SOURCE_PROFILES = Object.freeze([restJsonProfile].map(profile => Object.freeze({ id: profile.id, version: profile.version, kind: profile.kind })));
 /** Inert lookup. Extensions are explicit caller imports, never discovered or executed here. */

package/dist/string-identity-agreement.d.ts

@@ -12,7 +12,7 @@ export interface PathFoldRow {
     /** What the row exercises. */
     readonly note: string;
     readonly input: string;
-    /** `input` under NFC, lower, upper, lower, NFC. */
+    /** `input` under NFD, lower, upper, lower, NFC. */
     readonly fold: string;
 }
 export declare const PATH_FOLD_ROWS: readonly PathFoldRow[];

package/dist/string-identity-agreement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string-identity-agreement.d.ts","sourceRoot":"","sources":["../src/string-identity-agreement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,WAAW,EA0B/C,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAWzD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAiB3C,CAAC"}
+{"version":3,"file":"string-identity-agreement.d.ts","sourceRoot":"","sources":["../src/string-identity-agreement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,WAAW,EA6B/C,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAczD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAiB3C,CAAC"}

package/dist/string-identity-agreement.js

@@ -31,6 +31,9 @@ export const PATH_FOLD_ROWS = Object.freeze([
     { note: "capital sharp s", input: "\u1E9E", fold: "ss" },
     { note: "sharp s", input: "\u00DF", fold: "ss" },
     { note: "fullwidth r is not compatibility folded", input: "\uFF52", fold: "\uFF52" },
+    { note: "circled one is not compatibility folded", input: "\u2460", fold: "\u2460" },
+    { note: "fi ligature uppercases to FI", input: "\uFB01", fold: "fi" },
+    { note: "a mark after an iota subscript stays before the iota", input: "\u1FA9\u034D", fold: "\u1F61\u034D\u03B9" },
     { note: "emoji has no case", input: "\u{1F41D}", fold: "\u{1F41D}" },
     { note: "astral capital Deseret long I", input: "\u{10400}", fold: "\u{10428}" },
     { note: "slash is untouched across segments", input: "Notes/Reference\u017F/A-B", fold: "notes/references/a-b" },
@@ -46,6 +49,9 @@ export const PATH_COLLISION_ROWS = Object.freeze([
     { a: "a-b", b: "a_b", collide: false },
     { a: "a.b", b: "ab", collide: false },
     { a: "\uFF52", b: "r", collide: false },
+    { a: "\u2460", b: "1", collide: false },
+    { a: "\u1FA9\u034D", b: "\u1F61\u034D\u03B9", collide: true },
+    { a: "\u1FA9\u034D", b: "\u1F61\u03B9\u034D", collide: false },
 ]);
 /**
  * Strings in UTF-16 code unit order. The emoji (lead surrogate U+D83D) sorts before U+E000, which

package/dist/string-identity-agreement.js.map

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

package/dist/system-documents.d.ts

@@ -0,0 +1,13 @@
+import type { ConceptId, Frontmatter } from "./types.js";
+type DocumentIdentity = {
+    id: ConceptId;
+    frontmatter: Frontmatter;
+};
+/** A document that defines the bundle's operating model or identity rather than being a concept. */
+export declare function isGraphDefinitionDocument(doc: DocumentIdentity): boolean;
+/** A graph definition, or a document of another type Superbee or OKF owns. */
+export declare function isSystemDocument(doc: DocumentIdentity): boolean;
+/** @internal The literal owned type names, for the pinning test. */
+export declare const OWNED_INSTANCE_TYPE_NAMES: readonly string[];
+export {};
+//# sourceMappingURL=system-documents.d.ts.map

package/dist/system-documents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-documents.d.ts","sourceRoot":"","sources":["../src/system-documents.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAWzD,KAAK,gBAAgB,GAAG;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,CAAC;AAMpE,oGAAoG;AACpG,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAQxE;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAE/D;AAED,oEAAoE;AACpE,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAA8B,CAAC"}

package/dist/system-documents.js

@@ -0,0 +1,44 @@
+/**
+ * The one answer to "is this a document Superbee itself defines?", as opposed to a concept
+ * instance a bundle Kind would govern. Two questions share it:
+ *
+ *   - {@link isGraphDefinitionDocument}: documents that define the bundle's operating model or
+ *     identity. Their lack of inbound links is intentional, so `status` never calls them orphans.
+ *   - {@link isSystemDocument}: those, plus the other document types Superbee or OKF owns. No
+ *     bundle Kind governs them, so writing one never suggests a missing or misspelled Kind.
+ *
+ * Literal type names below are pinned to their owning constants by tests; importing those owners
+ * here would pull large modules into this small one.
+ */
+import { isLegacyPageDoc } from "./bundle-health/legacy-page.js";
+import { BUNDLE_NAME_DOC_ID, BUNDLE_NAME_DOC_TYPE, DEPENDENCIES_DOC_ID, DEPENDENCIES_DOC_TYPE } from "./dependencies.js";
+import { CONVENTION_TYPE } from "./kinds.js";
+import { isPageTypeName } from "./page.js";
+/** Document types Superbee or OKF owns that are not graph definitions. */
+const OWNED_INSTANCE_TYPES = new Set([
+    "Connector",
+    "Site",
+    "Promotion",
+    // An OKF standard type, validated by `okf-standard-fields.ts`.
+    "Attested Computation",
+]);
+function typeOf(doc) {
+    return typeof doc.frontmatter.type === "string" ? doc.frontmatter.type : "";
+}
+/** A document that defines the bundle's operating model or identity rather than being a concept. */
+export function isGraphDefinitionDocument(doc) {
+    const type = typeOf(doc);
+    return type === CONVENTION_TYPE ||
+        isPageTypeName(type) ||
+        isLegacyPageDoc(doc.frontmatter) ||
+        (type === "Reference" && doc.id.startsWith("references/")) ||
+        (type === BUNDLE_NAME_DOC_TYPE && doc.id === BUNDLE_NAME_DOC_ID) ||
+        (type === DEPENDENCIES_DOC_TYPE && doc.id === DEPENDENCIES_DOC_ID);
+}
+/** A graph definition, or a document of another type Superbee or OKF owns. */
+export function isSystemDocument(doc) {
+    return isGraphDefinitionDocument(doc) || OWNED_INSTANCE_TYPES.has(typeOf(doc));
+}
+/** @internal The literal owned type names, for the pinning test. */
+export const OWNED_INSTANCE_TYPE_NAMES = [...OWNED_INSTANCE_TYPES];
+//# sourceMappingURL=system-documents.js.map

package/dist/system-documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-documents.js","sourceRoot":"","sources":["../src/system-documents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACzH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,0EAA0E;AAC1E,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IACxD,WAAW;IACX,MAAM;IACN,WAAW;IACX,+DAA+D;IAC/D,sBAAsB;CACvB,CAAC,CAAC;AAIH,SAAS,MAAM,CAAC,GAAqB;IACnC,OAAO,OAAO,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,yBAAyB,CAAC,GAAqB;IAC7D,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,IAAI,KAAK,eAAe;QAC7B,cAAc,CAAC,IAAI,CAAC;QACpB,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC;QAChC,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;QAC1D,CAAC,IAAI,KAAK,oBAAoB,IAAI,GAAG,CAAC,EAAE,KAAK,kBAAkB,CAAC;QAChE,CAAC,IAAI,KAAK,qBAAqB,IAAI,GAAG,CAAC,EAAE,KAAK,mBAAmB,CAAC,CAAC;AACvE,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,GAAqB;IACpD,OAAO,yBAAyB,CAAC,GAAG,CAAC,IAAI,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,oEAAoE;AACpE,MAAM,CAAC,MAAM,yBAAyB,GAAsB,CAAC,GAAG,oBAAoB,CAAC,CAAC"}

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { BodyReplacePosture } from "./body-replace-guards.js";
+import type { WalkPathClass } from "./paths.js";
 /**
  * Shared type shapes for the OKF store engine.
  *
@@ -337,6 +338,12 @@ export interface StorageBackend {
     existsBlob(key: BlobKey): Promise<boolean>;
     /** Blob keys, optionally restricted to a bundle-relative `prefix`, sorted. Never includes concept documents or reserved files. */
     listBlobs(prefix?: string): Promise<BlobKey[]>;
+    /**
+     * Optional: where a root-relative path reported by a native directory watcher sits relative to
+     * what this backend reads. A backend with no walkable file layout omits it, and a watcher then
+     * treats every notification as relevant.
+     */
+    classifyChangedPath?(relPath: string): WalkPathClass;
     /**
      * Hard-delete the blob at `key` (no tombstone, no history to purge — blobs never
      * carried one). Returns `true` when a blob existed and was removed, `false` when it