@superbee/core 0.2.0-pre.15 → 0.2.0-pre.17

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

@@ -0,0 +1,60 @@
+/**
+ * Source Feed policy: which fields a feed owns and what each change kind may do. Reads the feed's
+ * frontmatter and decides per change, purely.
+ */
+import { type KindConvention } from "../kinds.js";
+import type { ConceptId, Frontmatter } from "../types.js";
+import type { ChangeDecision, OverlayPolicy, PolicyContext, RecordChange, Tell, TextGate } from "./types.js";
+export declare const DEFAULT_AUTO_APPLY: readonly string[];
+export declare const DEFAULT_NEEDS_REVIEW: readonly string[];
+/** Fields a feed may never own: identity, provenance and trust stay with Superbee and editors. */
+export declare const NEVER_OWNED: ReadonlySet<string>;
+/**
+ * The work state of a target Kind, which no feed may own whatever the Kind declares: both editions'
+ * progress storage fields and the Kind's resolved claim coordinates on the given editions.
+ */
+export declare function workStateFields(kind: KindConvention | undefined, editions: readonly ("0.1" | "0.2")[]): Set<string>;
+/**
+ * Read the generic keys of a Source Feed document. Every refusal is `POLICY_INVALID`. A
+ * presentation-only feed never writes documents, so names a document could never own (a
+ * Condition's `status`) are plain record fields there, and its policy carries no `target_kind`.
+ */
+export declare function readOverlayPolicy(doc: {
+    id: ConceptId;
+    frontmatter: Frontmatter;
+}, ctx?: PolicyContext): OverlayPolicy;
+/**
+ * Whether a record is editorially excluded: its title matches `exclude`, or its source id (or, for
+ * a recurrence occurrence `<series id>#<date>`, its series id) is in `exclude_ids`. Excluded records
+ * are never projected and never raise Signals.
+ */
+export declare function isExcludedRecord(policy: OverlayPolicy, externalId: string | undefined, title: unknown): boolean;
+export declare const severity: (kind: unknown) => number;
+export declare const maxPriority: <T>(a: T, b: T) => T;
+/**
+ * Decide one change. Per owned field, with B the last accepted feed value (`change.before`), N the
+ * new feed value and C the overlay document's value: C equal to N is converged (nothing to write);
+ * C equal to B writes N; anything else is `OVERLAY_DOC_CONFLICT`. Changes to fields the feed does
+ * not own are never written; on an overlay document they need judgment.
+ *
+ * A value is written as the text gate words it, and C is compared with B and N as gated too, so a
+ * document that already says the normalized value converges. A value the gate still refuses is
+ * not written: it is listed in `wording` and raises a low-priority Signal.
+ */
+export declare function decideChange(policy: OverlayPolicy, change: RecordChange, { overlay, featured, textGate }?: {
+    overlay?: {
+        frontmatter: Record<string, unknown>;
+    } | null;
+    featured?: boolean;
+    textGate?: TextGate;
+}): ChangeDecision;
+/**
+ * A feed value as an overlay document may carry it. A string goes through the text gate for its
+ * field and the overlay's Kind; any other value passes when every string inside it passes as it is.
+ */
+export declare function gateSafeValue(value: unknown, field: string, kind: string | undefined, textGate?: TextGate): {
+    value: unknown;
+    ok: boolean;
+    tells: Tell[];
+};
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/record-overlay/policy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAgD,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAChG,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE7G,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAA+B,CAAC;AAChF,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAsE,CAAC;AACzH,kGAAkG;AAClG,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,CAE1C,CAAC;AAEH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAInH;AAUD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,EAAE,GAAG,GAAE,aAAkB,GAAG,aAAa,CA4C1H;AASD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAO/G;AAGD,eAAO,MAAM,QAAQ,GAAI,MAAM,OAAO,KAAG,MAAuC,CAAC;AAEjF,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,KAAG,CAAqF,CAAC;AAElI;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,YAAY,EACpB,EAAE,OAAc,EAAE,QAAgB,EAAE,QAAQ,EAAE,GAAE;IAAE,OAAO,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAAO,GAC1J,cAAc,CA6ChB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,QAAQ,GAAE,QAAuB,GAChC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,CAiBhD"}

package/dist/record-overlay/policy.js

@@ -0,0 +1,209 @@
+/**
+ * Source Feed policy: which fields a feed owns and what each change kind may do. Reads the feed's
+ * frontmatter and decides per change, purely.
+ */
+import { claimCoordinates, progressStatusStorageField } from "../kinds.js";
+import { same } from "./canonical.js";
+import { OverlayRefusal, REFUSAL_CODES } from "./errors.js";
+export const DEFAULT_AUTO_APPLY = Object.freeze(["changed"]);
+export const DEFAULT_NEEDS_REVIEW = Object.freeze(["new", "canceled", "disappeared", "page-changed"]);
+/** Fields a feed may never own: identity, provenance and trust stay with Superbee and editors. */
+export const NEVER_OWNED = new Set([
+    "type", "sources", "verified", "generated", "status", "stale_after", "tags", "superbee_updated_by",
+]);
+/**
+ * The work state of a target Kind, which no feed may own whatever the Kind declares: both editions'
+ * progress storage fields and the Kind's resolved claim coordinates on the given editions.
+ */
+export function workStateFields(kind, editions) {
+    const fields = new Set([progressStatusStorageField("0.1"), progressStatusStorageField("0.2")]);
+    if (kind)
+        for (const edition of editions)
+            for (const field of claimCoordinates(edition, kind)?.fields ?? [])
+                fields.add(field);
+    return fields;
+}
+const list = (v) => (Array.isArray(v) ? v.map(String).filter(Boolean)
+    : typeof v === "string" && v ? v.split(",").map((s) => s.trim()).filter(Boolean)
+        : undefined);
+const identityGate = (text) => ({ text, ok: true, tells: [], changed: false });
+/**
+ * Read the generic keys of a Source Feed document. Every refusal is `POLICY_INVALID`. A
+ * presentation-only feed never writes documents, so names a document could never own (a
+ * Condition's `status`) are plain record fields there, and its policy carries no `target_kind`.
+ */
+export function readOverlayPolicy(doc, ctx = {}) {
+    const fm = (doc.frontmatter ?? {});
+    const refuse = (message, details = {}) => {
+        throw new OverlayRefusal(REFUSAL_CODES.POLICY_INVALID, `${doc.id}: ${message}`, { feed: doc.id, ...details });
+    };
+    if (ctx.targetKind !== undefined && ctx.presentationFields !== undefined)
+        refuse("a target Kind and presentation fields are mutually exclusive");
+    const presentation = ctx.presentationFields !== undefined;
+    const owned = list(fm.owned_fields);
+    if (!owned || owned.length === 0)
+        refuse("owned_fields is required");
+    const ownedFields = owned;
+    const bad = presentation ? [] : ownedFields.filter((f) => NEVER_OWNED.has(f));
+    if (bad.length)
+        refuse(`fields can never be feed-owned: ${bad.join(", ")}`, { fields: bad });
+    if (ctx.targetKind) {
+        const work = workStateFields(ctx.targetKind, ["0.1", "0.2"]);
+        const claimed = ownedFields.filter((f) => work.has(f));
+        if (claimed.length)
+            refuse(`fields hold the work state of ${ctx.targetKind.governs} and can never be feed-owned: ${claimed.join(", ")}`, { fields: claimed });
+    }
+    if (ctx.targetKind) {
+        const declared = new Set([...ctx.targetKind.fields.required, ...ctx.targetKind.fields.optional, "title"]);
+        const undeclared = ownedFields.filter((f) => !declared.has(f));
+        if (undeclared.length)
+            refuse(`owned_fields not declared by ${ctx.targetKind.governs}: ${undeclared.join(", ")}`, { fields: undeclared });
+    }
+    if (presentation) {
+        const allowed = new Set(ctx.presentationFields);
+        const undeclared = ownedFields.filter((f) => !allowed.has(f));
+        if (undeclared.length)
+            refuse(`owned_fields not part of the presentation kind: ${undeclared.join(", ")}`, { fields: undeclared });
+    }
+    const threshold = fm.missing_threshold === undefined || fm.missing_threshold === null ? undefined : Number(fm.missing_threshold);
+    if (threshold !== undefined && !(Number.isInteger(threshold) && threshold >= 1))
+        refuse("missing_threshold must be a whole number >= 1");
+    if (typeof fm.url !== "string" || !fm.url)
+        refuse("url (provider identity) is required");
+    const zone = fm.wall_time_zone === undefined || fm.wall_time_zone === null ? undefined : String(fm.wall_time_zone).trim();
+    const targetKind = !presentation && typeof fm.target_kind === "string" && fm.target_kind ? fm.target_kind : undefined;
+    return {
+        feed: doc.id,
+        provider: fm.url,
+        ...(targetKind ? { target_kind: targetKind } : {}),
+        owned_fields: ownedFields,
+        auto_apply: list(fm.auto_apply) ?? [...DEFAULT_AUTO_APPLY],
+        needs_review: list(fm.needs_review) ?? [...DEFAULT_NEEDS_REVIEW],
+        exclude: excludeOf(doc.id, fm.exclude_pattern),
+        ...(threshold !== undefined ? { missing_threshold: threshold } : {}),
+        ...(fm.completeness === "complete" || fm.completeness === "partial" ? { completeness: fm.completeness } : {}),
+        ...(zone ? { time_zone: zone } : {}),
+    };
+}
+/** Optional editorial exclusion: a case-insensitive pattern on the record title. */
+function excludeOf(feed, pattern) {
+    if (pattern === undefined || pattern === null || pattern === "")
+        return null;
+    try {
+        return new RegExp(String(pattern), "i");
+    }
+    catch {
+        throw new OverlayRefusal(REFUSAL_CODES.POLICY_INVALID, `${feed}: exclude_pattern is not a valid pattern`, { feed });
+    }
+}
+/**
+ * Whether a record is editorially excluded: its title matches `exclude`, or its source id (or, for
+ * a recurrence occurrence `<series id>#<date>`, its series id) is in `exclude_ids`. Excluded records
+ * are never projected and never raise Signals.
+ */
+export function isExcludedRecord(policy, externalId, title) {
+    if (policy.exclude && policy.exclude.test(String(title ?? "")))
+        return true;
+    if (!policy.exclude_ids || externalId === undefined || externalId === null)
+        return false;
+    const id = String(externalId);
+    if (policy.exclude_ids.has(id))
+        return true;
+    const hash = id.indexOf("#");
+    return hash > 0 && policy.exclude_ids.has(id.slice(0, hash));
+}
+const SEVERITY = { new: 1, changed: 2, "page-changed": 2, disappeared: 3, canceled: 4 };
+export const severity = (kind) => SEVERITY[kind] ?? 0;
+const PRIORITY_RANK = { low: 1, normal: 2, urgent: 3 };
+export const maxPriority = (a, b) => ((PRIORITY_RANK[a] ?? 0) >= (PRIORITY_RANK[b] ?? 0) ? a : b);
+/**
+ * Decide one change. Per owned field, with B the last accepted feed value (`change.before`), N the
+ * new feed value and C the overlay document's value: C equal to N is converged (nothing to write);
+ * C equal to B writes N; anything else is `OVERLAY_DOC_CONFLICT`. Changes to fields the feed does
+ * not own are never written; on an overlay document they need judgment.
+ *
+ * A value is written as the text gate words it, and C is compared with B and N as gated too, so a
+ * document that already says the normalized value converges. A value the gate still refuses is
+ * not written: it is listed in `wording` and raises a low-priority Signal.
+ */
+export function decideChange(policy, change, { overlay = null, featured = false, textGate } = {}) {
+    const owned = new Set(policy.owned_fields);
+    const apply = {};
+    const conflicts = [];
+    const wording = [];
+    let editorFields = [];
+    const reasons = [];
+    const autoApply = policy.auto_apply.includes(change.change_kind);
+    const kind = policy.target_kind;
+    if (overlay && change.after && change.before && autoApply) {
+        for (const f of change.changed_fields) {
+            if (!owned.has(f))
+                continue;
+            const C = overlay.frontmatter[f], B = change.before[f], N = change.after[f];
+            const n = gateSafeValue(N, f, kind, textGate), b = gateSafeValue(B, f, kind, textGate);
+            if (same(C, N) || same(C, n.value))
+                continue;
+            if (same(C, B) || same(C, b.value)) {
+                if (n.ok)
+                    apply[f] = { from: C, to: n.value };
+                else
+                    wording.push({ field: f, text: typeof N === "string" ? N : JSON.stringify(N), tells: n.tells });
+            }
+            else
+                conflicts.push({ field: f, doc_value: C, feed_before: B, feed_after: N });
+        }
+    }
+    // An editor-owned change needs judgment only when the document does not already say the new value.
+    if (overlay && change.before && change.after) {
+        const after = change.after;
+        editorFields = change.changed_fields.filter((f) => !owned.has(f) && !same(overlay.frontmatter[f], after[f]));
+    }
+    if (policy.needs_review.includes(change.change_kind))
+        reasons.push(`needs_review:${change.change_kind}`);
+    if (conflicts.length)
+        reasons.push(REFUSAL_CODES.OVERLAY_DOC_CONFLICT);
+    if (editorFields.length)
+        reasons.push("editor-owned-field-changed");
+    if (overlay && !autoApply && !policy.needs_review.includes(change.change_kind) && change.changed_fields.some((f) => owned.has(f))) {
+        reasons.push("owned-field-changed-without-auto-apply");
+    }
+    if (wording.length)
+        reasons.push("needs-human-safe-wording");
+    let signal = null;
+    if (reasons.length) {
+        // Text held back for a wording is not news: alone, it is a low-priority Signal.
+        let priority = wording.length && reasons.length === 1 ? "low" : "normal";
+        if (change.change_kind === "new" && !overlay)
+            priority = "low";
+        if (change.change_kind === "canceled" && (overlay || featured))
+            priority = "urgent";
+        signal = { priority, reasons };
+    }
+    return { apply, conflicts, editorFields, wording, signal };
+}
+/**
+ * A feed value as an overlay document may carry it. A string goes through the text gate for its
+ * field and the overlay's Kind; any other value passes when every string inside it passes as it is.
+ */
+export function gateSafeValue(value, field, kind, textGate = identityGate) {
+    if (typeof value === "string") {
+        const r = textGate(value, { field, kind });
+        return { value: r.text, ok: r.ok, tells: r.tells };
+    }
+    const strings = [];
+    const walk = (v) => {
+        if (typeof v === "string")
+            strings.push(v);
+        else if (Array.isArray(v))
+            v.forEach(walk);
+        else if (v && typeof v === "object")
+            Object.values(v).forEach(walk);
+    };
+    walk(value);
+    const tells = strings.flatMap((s) => {
+        const r = textGate(s, { field, kind });
+        return r.changed || !r.ok ? (r.tells.length ? r.tells : [{ code: "NEEDS_NORMALIZING", match: s.slice(0, 80) }]) : [];
+    });
+    return { value, ok: tells.length === 0, tells };
+}
+//# sourceMappingURL=policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../src/record-overlay/policy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAuB,MAAM,aAAa,CAAC;AAEhG,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5D,MAAM,CAAC,MAAM,kBAAkB,GAAsB,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,oBAAoB,GAAsB,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;AACzH,kGAAkG;AAClG,MAAM,CAAC,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC;IACtD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,qBAAqB;CACnG,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgC,EAAE,QAAoC;IACpG,MAAM,MAAM,GAAG,IAAI,GAAG,CAAS,CAAC,0BAA0B,CAAC,KAAK,CAAE,EAAE,0BAA0B,CAAC,KAAK,CAAE,CAAC,CAAC,CAAC;IACzG,IAAI,IAAI;QAAE,KAAK,MAAM,OAAO,IAAI,QAAQ;YAAE,KAAK,MAAM,KAAK,IAAI,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,IAAI,EAAE;gBAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/H,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,CAAU,EAAwB,EAAE,CAAC,CACjD,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;IAC9C,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAC9E,CAAC,CAAC,SAAS,CAChB,CAAC;AAEF,MAAM,YAAY,GAAa,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AAEzF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAgD,EAAE,MAAqB,EAAE;IACzG,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAuC,CAAC;IACzE,MAAM,MAAM,GAAG,CAAC,OAAe,EAAE,UAAmC,EAAE,EAAS,EAAE;QAC/E,MAAM,IAAI,cAAc,CAAC,aAAa,CAAC,cAAc,EAAE,GAAG,GAAG,CAAC,EAAE,KAAK,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAChH,CAAC,CAAC;IACF,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,GAAG,CAAC,kBAAkB,KAAK,SAAS;QAAE,MAAM,CAAC,8DAA8D,CAAC,CAAC;IACjJ,MAAM,YAAY,GAAG,GAAG,CAAC,kBAAkB,KAAK,SAAS,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,CAAC,0BAA0B,CAAC,CAAC;IACrE,MAAM,WAAW,GAAG,KAAM,CAAC;IAC3B,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,IAAI,GAAG,CAAC,MAAM;QAAE,MAAM,CAAC,mCAAmC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7F,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,OAAO,CAAC,MAAM;YAAE,MAAM,CAAC,iCAAiC,GAAG,CAAC,UAAU,CAAC,OAAO,iCAAiC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAChK,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1G,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/D,IAAI,UAAU,CAAC,MAAM;YAAE,MAAM,CAAC,gCAAgC,GAAG,CAAC,UAAU,CAAC,OAAO,KAAK,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5I,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,IAAI,UAAU,CAAC,MAAM;YAAE,MAAM,CAAC,mDAAmD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACpI,CAAC;IACD,MAAM,SAAS,GAAG,EAAE,CAAC,iBAAiB,KAAK,SAAS,IAAI,EAAE,CAAC,iBAAiB,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;IACjI,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,CAAC;QAAE,MAAM,CAAC,+CAA+C,CAAC,CAAC;IACzI,IAAI,OAAO,EAAE,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,EAAE,CAAC,GAAG;QAAE,MAAM,CAAC,qCAAqC,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,EAAE,CAAC,cAAc,KAAK,SAAS,IAAI,EAAE,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1H,MAAM,UAAU,GAAG,CAAC,YAAY,IAAI,OAAO,EAAE,CAAC,WAAW,KAAK,QAAQ,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACtH,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,EAAE;QACZ,QAAQ,EAAE,EAAE,CAAC,GAAa;QAC1B,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,YAAY,EAAE,WAAW;QACzB,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC;QAC1D,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,oBAAoB,CAAC;QAChE,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC;QAC9C,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,EAAE,CAAC,YAAY,KAAK,UAAU,IAAI,EAAE,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7G,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,SAAS,SAAS,CAAC,IAAe,EAAE,OAAgB;IAClD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7E,IAAI,CAAC;QAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;IAAC,CAAC;IAChD,MAAM,CAAC;QAAC,MAAM,IAAI,cAAc,CAAC,aAAa,CAAC,cAAc,EAAE,GAAG,IAAI,0CAA0C,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAAC,CAAC;AAChI,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAqB,EAAE,UAA8B,EAAE,KAAc;IACpG,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5E,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACzF,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9B,IAAI,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,IAAI,GAAG,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,QAAQ,GAA2B,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AAChH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAa,EAAU,EAAE,CAAC,QAAQ,CAAC,IAAc,CAAC,IAAI,CAAC,CAAC;AACjF,MAAM,aAAa,GAA2B,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAC/E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAI,CAAI,EAAE,CAAI,EAAK,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAElI;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAqB,EACrB,MAAoB,EACpB,EAAE,OAAO,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,QAAQ,KAA6G,EAAE;IAE3J,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC3C,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAgC,EAAE,CAAC;IAClD,MAAM,OAAO,GAA8B,EAAE,CAAC;IAC9C,IAAI,YAAY,GAAa,EAAE,CAAC;IAChC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC;IAEhC,IAAI,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAC1D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC5B,MAAM,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5E,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YACvF,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC7C,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,CAAC,EAAE;oBAAE,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;;oBACzC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACvG,CAAC;;gBAAM,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IACD,mGAAmG;IACnG,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/G,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IACzG,IAAI,SAAS,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACvE,IAAI,YAAY,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACpE,IAAI,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClI,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAE7D,IAAI,MAAM,GAA6B,IAAI,CAAC;IAC5C,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,gFAAgF;QAChF,IAAI,QAAQ,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;QACzE,IAAI,MAAM,CAAC,WAAW,KAAK,KAAK,IAAI,CAAC,OAAO;YAAE,QAAQ,GAAG,KAAK,CAAC;QAC/D,IAAI,MAAM,CAAC,WAAW,KAAK,UAAU,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC;YAAE,QAAQ,GAAG,QAAQ,CAAC;QACpF,MAAM,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAc,EACd,KAAa,EACb,IAAwB,EACxB,WAAqB,YAAY;IAEjC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IACrD,CAAC;IACD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,CAAC,CAAU,EAAQ,EAAE;QAChC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;aACtC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;aACtC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,CAAC;IACZ,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;QAClC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvH,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;AAClD,CAAC"}

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

@@ -0,0 +1,3 @@
+export declare function redactUrl(raw: string): string;
+export declare function redactUrl(raw: unknown): unknown;
+//# sourceMappingURL=redact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/record-overlay/redact.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;AAC/C,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC"}

package/dist/record-overlay/redact.js

@@ -0,0 +1,27 @@
+// Provider URLs may carry credentials in userinfo or query parameters; no Signal echoes them.
+const SECRET_PARAM = /^(token|access_token|api[_-]?key|key|secret|signature|sig|auth|password|pass|apikey|client_secret|session)$/i;
+export function redactUrl(raw) {
+    if (typeof raw !== "string" || raw === "")
+        return raw;
+    let u;
+    try {
+        u = new URL(raw);
+    }
+    catch {
+        return raw;
+    }
+    let changed = false;
+    if (u.username || u.password) {
+        u.username = "";
+        u.password = "";
+        changed = true;
+    }
+    for (const k of [...u.searchParams.keys()]) {
+        if (SECRET_PARAM.test(k)) {
+            u.searchParams.set(k, "REDACTED");
+            changed = true;
+        }
+    }
+    return changed ? u.toString() : raw;
+}
+//# sourceMappingURL=redact.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/record-overlay/redact.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,YAAY,GAAG,8GAA8G,CAAC;AAIpI,MAAM,UAAU,SAAS,CAAC,GAAY;IACpC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,GAAG,CAAC;IACtD,IAAI,CAAM,CAAC;IACX,IAAI,CAAC;QAAC,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,GAAG,CAAC;IAAC,CAAC;IAC/C,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;QAAC,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC;QAAC,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC;QAAC,OAAO,GAAG,IAAI,CAAC;IAAC,CAAC;IACnF,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC3C,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YAAC,OAAO,GAAG,IAAI,CAAC;QAAC,CAAC;IAClF,CAAC;IACD,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AACtC,CAAC"}

package/dist/record-overlay/signal-kind.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The attention Kind: the one Kind record-overlay may create documents of, and the only Kind whose
+ * documents it updates outside the owned-field guard. Resolved from the ops registry at plan time
+ * and again at apply time, by the same rules.
+ */
+import { type KindConvention, type KindRegistry } from "../kinds.js";
+/** Fields an attention Kind must declare: the Signal record a raise and a collapse write. */
+export declare const ATTENTION_FIELDS: readonly string[];
+export interface AttentionKind {
+    name: string;
+    kind: KindConvention;
+    /** The only id prefix a Signal create may target and a Signal update may touch. */
+    prefix: string;
+    stateField: string;
+    ownerField: string;
+}
+export type AttentionResolution = {
+    ok: true;
+    value: AttentionKind;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * The attention Kind must be declared in the ops registry, differ from the overlay target Kind,
+ * resolve both claim coordinates on this edition, and declare every {@link ATTENTION_FIELDS} member.
+ * Its declared `path` (default `signals/`) bounds where its documents may live.
+ */
+export declare function resolveAttentionKind(registry: KindRegistry, okfVersion: string, name: string, targetKind: string | undefined): AttentionResolution;
+//# sourceMappingURL=signal-kind.d.ts.map

package/dist/record-overlay/signal-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-kind.d.ts","sourceRoot":"","sources":["../../src/record-overlay/signal-kind.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAoB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvF,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAA6F,CAAC;AAE5I,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IACrB,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,mBAAmB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAErG;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EACtB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,mBAAmB,CAmBrB"}

package/dist/record-overlay/signal-kind.js

@@ -0,0 +1,38 @@
+/**
+ * The attention Kind: the one Kind record-overlay may create documents of, and the only Kind whose
+ * documents it updates outside the owned-field guard. Resolved from the ops registry at plan time
+ * and again at apply time, by the same rules.
+ */
+import { claimCoordinates } from "../kinds.js";
+/** Fields an attention Kind must declare: the Signal record a raise and a collapse write. */
+export const ATTENTION_FIELDS = Object.freeze(["change_kind", "observed_at", "provider", "external_id", "diff_summary"]);
+/**
+ * The attention Kind must be declared in the ops registry, differ from the overlay target Kind,
+ * resolve both claim coordinates on this edition, and declare every {@link ATTENTION_FIELDS} member.
+ * Its declared `path` (default `signals/`) bounds where its documents may live.
+ */
+export function resolveAttentionKind(registry, okfVersion, name, targetKind) {
+    const kind = registry.kinds.get(name);
+    if (!kind)
+        return { ok: false, reason: `the attention Kind ${name} is not declared in the ops bundle` };
+    if (targetKind !== undefined && name === targetKind)
+        return { ok: false, reason: `the attention Kind ${name} is the overlay target Kind` };
+    const claim = claimCoordinates(okfVersion, kind);
+    if (!claim?.ownerField || !claim.stateField)
+        return { ok: false, reason: `the attention Kind ${name} declares no resolvable claim owner and state fields` };
+    const declared = new Set([...kind.fields.required, ...kind.fields.optional]);
+    const missing = ATTENTION_FIELDS.filter((field) => !declared.has(field));
+    if (missing.length)
+        return { ok: false, reason: `the attention Kind ${name} does not declare ${missing.join(", ")}` };
+    return {
+        ok: true,
+        value: {
+            name,
+            kind,
+            prefix: (kind.path ?? "signals/").replace(/\/?$/, "/"),
+            stateField: claim.stateField,
+            ownerField: claim.ownerField,
+        },
+    };
+}
+//# sourceMappingURL=signal-kind.js.map

package/dist/record-overlay/signal-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-kind.js","sourceRoot":"","sources":["../../src/record-overlay/signal-kind.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAA0C,MAAM,aAAa,CAAC;AAEvF,6FAA6F;AAC7F,MAAM,CAAC,MAAM,gBAAgB,GAAsB,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;AAa5I;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAsB,EACtB,UAAkB,EAClB,IAAY,EACZ,UAA8B;IAE9B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,IAAI,oCAAoC,EAAE,CAAC;IACxG,IAAI,UAAU,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,IAAI,6BAA6B,EAAE,CAAC;IAC3I,MAAM,KAAK,GAAG,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACjD,IAAI,CAAC,KAAK,EAAE,UAAU,IAAI,CAAC,KAAK,CAAC,UAAU;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,IAAI,sDAAsD,EAAE,CAAC;IAC5J,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7E,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,IAAI,qBAAqB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;IACtH,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK,EAAE;YACL,IAAI;YACJ,IAAI;YACJ,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;YACtD,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B;KACF,CAAC;AACJ,CAAC"}

package/dist/record-overlay/signal-text.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The text of a Signal: its observation line and its body. One rendering for the planner, which
+ * writes it, and for the apply's Signal guards, which accept a Signal's text only when it is what
+ * this rendering produces from the Signal's own fields and the run, so every honest plan passes and
+ * free text does not.
+ */
+import type { KindConvention } from "../kinds.js";
+/** Text kept on one line: every line break becomes a space. */
+export declare function oneLine(text: string): string;
+export declare function isConceptId(value: unknown): value is string;
+/** The attention Kind's link vocabulary, derived from its convention, never hard-coded. */
+export declare function signalLinkTexts(signalKind: KindConvention | undefined, targetKind: string | undefined, feedKind?: string): {
+    fromFeed?: string;
+    about?: string;
+};
+export declare function observationLine(observedAt: unknown, changeKind: unknown, digest: unknown, summary: unknown): string;
+export declare const linkLine: (text: string, fromId: string, targetId: string) => string;
+export declare const overlayLine: (id: string) => string;
+export declare const relatedLine: (id: string, reason?: string) => string;
+export declare const adoptionHint: (targetKind: unknown, provider: unknown, externalId: unknown) => string;
+export declare function signalBody(links: readonly string[], hint: string | undefined, line: string): string;
+export interface SignalTextContext {
+    /** The Signal's id. */
+    target: string;
+    /** The feed its plan was made for, when the plan names one. */
+    feed: string | null | undefined;
+    /** The run's target Kind, for the adoption hint and the typed overlay link. */
+    targetKind: string | undefined;
+    links: {
+        fromFeed?: string;
+        about?: string;
+    };
+}
+/**
+ * A created Signal's body is the planner's: its link lines, the adoption hint for this record when
+ * present, and the observation line rendered from the Signal's own `observed_at`, `change_kind`,
+ * `diff_summary` and the step's digest.
+ */
+export declare function isPlannedSignalBody(body: string, frontmatter: Record<string, unknown>, digest: string, context: SignalTextContext): boolean;
+/**
+ * A collapse's observation line is the planner's: rendered from the update's own `observed_at`,
+ * `diff_summary` and the step's digest, around the change kind it records.
+ */
+export declare function isPlannedObservation(line: string, set: Record<string, unknown>, digest: string): boolean;
+//# sourceMappingURL=signal-text.d.ts.map

package/dist/record-overlay/signal-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal-text.d.ts","sourceRoot":"","sources":["../../src/record-overlay/signal-text.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AASlD,+DAA+D;AAC/D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAG3D;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,SAAgB,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAKvK;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAEnH;AAED,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,EAAE,UAAU,MAAM,KAAG,MAAwD,CAAC;AACnI,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,KAAG,MAAoC,CAAC;AAC9E,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,EAAE,SAAS,MAAM,KAAG,MAAiF,CAAC;AAC5I,eAAO,MAAM,YAAY,GAAI,YAAY,OAAO,EAAE,UAAU,OAAO,EAAE,YAAY,OAAO,KAAG,MAC2C,CAAC;AAEvI,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnG;AAeD,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChC,+EAA+E;IAC/E,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAuBD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAUT;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAOxG"}

package/dist/record-overlay/signal-text.js

@@ -0,0 +1,116 @@
+import { relativeHref } from "../links.js";
+import { assertSafeConceptId } from "../paths.js";
+const LINE_BREAKS = /\r\n|[\r\n\u0085\u2028\u2029]/g;
+const LINE_BREAK = /[\r\n\u0085\u2028\u2029]/;
+const OVERLAY_PREFIX = "Overlay document (content bundle): `";
+const RELATED_PREFIX = "Related document (content bundle): `";
+/** Text kept on one line: every line break becomes a space. */
+export function oneLine(text) {
+    return text.replace(LINE_BREAKS, " ");
+}
+export function isConceptId(value) {
+    if (typeof value !== "string")
+        return false;
+    try {
+        assertSafeConceptId(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** The attention Kind's link vocabulary, derived from its convention, never hard-coded. */
+export function signalLinkTexts(signalKind, targetKind, feedKind = "Source Feed") {
+    const links = signalKind?.links ?? {};
+    const fromFeed = Object.keys(links).find((t) => links[t] === feedKind);
+    const about = targetKind ? Object.keys(links).find((t) => links[t] === targetKind) : undefined;
+    return { fromFeed, about };
+}
+export function observationLine(observedAt, changeKind, digest, summary) {
+    return `- ${observedAt} · ${changeKind} · ${digest} · ${summary}`;
+}
+export const linkLine = (text, fromId, targetId) => `[${text}](${relativeHref(fromId, targetId)})`;
+export const overlayLine = (id) => `${OVERLAY_PREFIX}${id}\``;
+export const relatedLine = (id, reason) => `${RELATED_PREFIX}${id}\`${reason === undefined ? "" : ` (${reason})`}`;
+export const adoptionHint = (targetKind, provider, externalId) => `To overlay this record, give a document of Kind "${targetKind}" the source entry \`resource: ${provider}\`, \`id: ${externalId}\`.`;
+export function signalBody(links, hint, line) {
+    return `${links.join("\n")}\n${hint === undefined ? "" : `\n${hint}\n`}\n# Observations\n\n${line}\n`;
+}
+/** The concept id a relative link from `fromId` names, or null. */
+function linkTarget(fromId, href) {
+    const slash = fromId.lastIndexOf("/");
+    const parts = slash >= 0 ? fromId.slice(0, slash).split("/") : [];
+    for (const segment of href.split("/")) {
+        if (segment === "..") {
+            if (parts.length === 0)
+                return null;
+            parts.pop();
+        }
+        else if (segment === "" || segment === ".")
+            return null;
+        else
+            parts.push(segment);
+    }
+    const path = parts.join("/");
+    return path.endsWith(".md") ? path.slice(0, -3) : null;
+}
+function plannedLink(text, context) {
+    const { target, feed, links } = context;
+    if (links.fromFeed !== undefined && isConceptId(feed) && isConceptId(target) && text === linkLine(links.fromFeed, target, feed))
+        return true;
+    if (links.about !== undefined && text.startsWith(`[${links.about}](`) && text.endsWith(")")) {
+        const id = linkTarget(target, text.slice(links.about.length + 3, -1));
+        if (isConceptId(id) && isConceptId(target) && text === linkLine(links.about, target, id))
+            return true;
+    }
+    if (text.startsWith(OVERLAY_PREFIX) && text.endsWith("`") && isConceptId(text.slice(OVERLAY_PREFIX.length, -1)))
+        return true;
+    if (text.startsWith(RELATED_PREFIX)) {
+        const rest = text.slice(RELATED_PREFIX.length);
+        if (rest.endsWith("`") && isConceptId(rest.slice(0, -1)))
+            return true;
+        if (rest.endsWith(")")) {
+            for (let at = rest.indexOf("` ("); at > 0; at = rest.indexOf("` (", at + 1)) {
+                const reason = rest.slice(at + 3, -1);
+                if (isConceptId(rest.slice(0, at)) && reason.length <= 120 && !LINE_BREAK.test(reason))
+                    return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * A created Signal's body is the planner's: its link lines, the adoption hint for this record when
+ * present, and the observation line rendered from the Signal's own `observed_at`, `change_kind`,
+ * `diff_summary` and the step's digest.
+ */
+export function isPlannedSignalBody(body, frontmatter, digest, context) {
+    const suffix = `# Observations\n\n${observationLine(frontmatter.observed_at, frontmatter.change_kind, digest, frontmatter.diff_summary)}\n`;
+    if (!body.endsWith(suffix))
+        return false;
+    const preamble = body.slice(0, -suffix.length);
+    const hint = context.targetKind === undefined ? undefined : adoptionHint(context.targetKind, frontmatter.provider, frontmatter.external_id);
+    let links;
+    if (hint !== undefined && preamble.endsWith(`\n\n${hint}\n\n`))
+        links = preamble.slice(0, preamble.length - hint.length - 4);
+    else if (preamble.endsWith("\n\n"))
+        links = preamble.slice(0, -2);
+    else
+        return false;
+    return links === "" || links.split("\n").every((text) => plannedLink(text, context));
+}
+/**
+ * A collapse's observation line is the planner's: rendered from the update's own `observed_at`,
+ * `diff_summary` and the step's digest, around the change kind it records.
+ */
+export function isPlannedObservation(line, set, digest) {
+    if (typeof set.observed_at !== "string" || typeof set.diff_summary !== "string")
+        return false;
+    const prefix = `- ${set.observed_at} · `;
+    const suffix = ` · ${digest} · ${set.diff_summary}`;
+    if (line.length <= prefix.length + suffix.length || !line.startsWith(prefix) || !line.endsWith(suffix))
+        return false;
+    const kind = line.slice(prefix.length, line.length - suffix.length);
+    return kind === set.change_kind || !LINE_BREAK.test(kind);
+}
+//# sourceMappingURL=signal-text.js.map

package/dist/record-overlay/signal-text.js.map

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

package/dist/record-overlay/source-index.d.ts

@@ -0,0 +1,19 @@
+import type { Bundle, HeadResult, OkfDocument, QueryFilter, Version } from "../types.js";
+export declare class SourceIndex {
+    #private;
+    static fromHeads(heads: Iterable<HeadResult>): SourceIndex;
+    /**
+     * Heads whose `sources` carry `(resource, id)`, in id order. A document carrying the identity
+     * twice is returned twice, so the caller sees it as ambiguous.
+     */
+    lookup(resource: string, id: string, opts?: {
+        type?: string;
+    }): readonly HeadResult[];
+    /** Re-derive one document's entries from a write's result. */
+    replace(doc: OkfDocument, version: Version): void;
+    /** Documents carrying at least one well-formed identity. */
+    get size(): number;
+}
+/** One head read of `bundle` (optionally narrowed by type or prefix), indexed by identity. */
+export declare function buildSourceIndex(bundle: Bundle, filter?: Pick<QueryFilter, "type" | "prefix">): Promise<SourceIndex>;
+//# sourceMappingURL=source-index.d.ts.map

package/dist/record-overlay/source-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-index.d.ts","sourceRoot":"","sources":["../../src/record-overlay/source-index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAa,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAgBpG,qBAAa,WAAW;;IAItB,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,WAAW;IAO1D;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,SAAS,UAAU,EAAE;IAKzF,8DAA8D;IAC9D,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IASjD,4DAA4D;IAC5D,IAAI,IAAI,IAAI,MAAM,CAEjB;CA4BF;AAED,8FAA8F;AAC9F,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAK9H"}