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

package/dist/record-overlay/plan.js

@@ -0,0 +1,285 @@
+/**
+ * The multi-document plan: read, classify or refuse, and emit steps that carry the exact version
+ * they were decided against. Pure apart from bundle reads.
+ *
+ * Two bundles: ops holds Source Feeds and Signals, content holds the overlay documents. They may be
+ * the same bundle.
+ */
+import { queryHeads, readDocVersioned } from "../bundle-ops.js";
+import { parseIsoInstant } from "../verification.js";
+import { shortHash } from "./digest.js";
+import { OverlayRefusal, REFUSAL_CODES } from "./errors.js";
+import { decideChange, isExcludedRecord, maxPriority, severity } from "./policy.js";
+import { redactUrl } from "./redact.js";
+import { resolveAttentionKind } from "./signal-kind.js";
+import { adoptionHint, linkLine, observationLine, oneLine, overlayLine, relatedLine, signalBody, signalLinkTexts } from "./signal-text.js";
+import { buildSourceIndex } from "./source-index.js";
+const LABEL = { new: "New", changed: "Changed", canceled: "Canceled", disappeared: "Disappeared", "page-changed": "Page changed" };
+const PRIORITIES = new Set(["low", "normal", "urgent"]);
+const short = (v) => {
+    if (v === undefined)
+        return "∅";
+    const s = typeof v === "string" ? v : JSON.stringify(v);
+    return s.length > 80 ? s.slice(0, 79) + "…" : s;
+};
+function lastKnownInterval(fields, timeZone, interval) {
+    return interval && fields && typeof fields === "object" ? interval(fields, timeZone) : null;
+}
+/**
+ * Where a disappeared record stood at `observedAt`: `ended` (its last known end has passed),
+ * `before-start` (it vanished before it began: possibly canceled), `ongoing`, or null when its
+ * dates are unknown. Without an interval hook the phase is always unknown, so the record is raised.
+ */
+export function disappearedPhase(fields, observedAt, timeZone, interval) {
+    const span = lastKnownInterval(fields, timeZone, interval);
+    const at = parseIsoInstant(observedAt);
+    if (!span || at === null)
+        return null;
+    return at >= span[1] ? "ended" : at < span[0] ? "before-start" : "ongoing";
+}
+export function summarizeChange(change, decision, ownedFields = [], { phase = null } = {}) {
+    const parts = [];
+    if (change.change_kind === "new") {
+        parts.push(`new record${change.after?.start ? ` @ ${change.after.start}` : ""}`);
+        // The values the feed would own, so the claimant can judge without opening the store.
+        for (const f of ownedFields.filter((k) => k !== "start" && change.after?.[k] !== undefined).slice(0, 6))
+            parts.push(`${f}: ${short(change.after[f])}`);
+    }
+    else if (change.change_kind === "disappeared") {
+        parts.push(`missing from ${change.missing_count} consecutive complete observations`);
+        if (phase === "before-start")
+            parts.push("vanished before its start: possibly canceled, check the organizer's page");
+        else if (phase === "ended")
+            parts.push("ended: gone after its last known end");
+        // The last known facts, so triage needs no store or history.
+        for (const f of ["title", "start", "end"])
+            parts.push(`last ${f}: ${short(change.before?.[f])}`);
+    }
+    else
+        for (const f of change.changed_fields)
+            parts.push(`${f}: ${short(change.before?.[f])} → ${short(change.after?.[f])}`);
+    for (const c of decision?.conflicts ?? [])
+        parts.push(`CONFLICT ${c.field}: doc has ${short(c.doc_value)}, feed was ${short(c.feed_before)}`);
+    if (decision?.editorFields?.length)
+        parts.push(`not applied (editor-owned): ${decision.editorFields.join(", ")}`);
+    // Feed text the publication gate would refuse even normalized: not written, named for a person.
+    for (const w of decision?.wording ?? [])
+        parts.push(`not applied, needs a human-safe wording: ${w.field}: ${short(w.text)} (${[...new Set(w.tells.map((t) => `${t.code} "${t.match}"`))].join(", ")})`);
+    const s = parts.join("; ");
+    return s.length > 600 ? s.slice(0, 599) + "…" : s;
+}
+/** Scalar `sources` properties from the hook, refused when they would name the identity or hold a list. */
+function sourcePropertiesOf(hook, change) {
+    const props = hook?.sourceProperties?.(change);
+    if (props === undefined)
+        return undefined;
+    if (props === null || typeof props !== "object" || Array.isArray(props)) {
+        throw new OverlayRefusal(REFUSAL_CODES.INVALID_INPUT, "sourceProperties must return a mapping of scalar properties", { external_id: change.external_id });
+    }
+    for (const [key, value] of Object.entries(props)) {
+        if (key === "resource" || key === "id") {
+            throw new OverlayRefusal(REFUSAL_CODES.INVALID_INPUT, `sourceProperties may not set the identity property ${key}`, { external_id: change.external_id, field: key });
+        }
+        if (typeof value !== "string" && typeof value !== "boolean" && !(typeof value === "number" && Number.isFinite(value) && !Object.is(value, -0))) {
+            throw new OverlayRefusal(REFUSAL_CODES.INVALID_INPUT, `sourceProperties property ${key} must be a string, finite number or boolean`, { external_id: change.external_id, field: key });
+        }
+    }
+    return Object.keys(props).length ? { ...props } : undefined;
+}
+export async function planRecordOverlay(input) {
+    const { ops, content, policy, changes, observedAt, records = {}, observation = {}, sameBundle = false, hooks = {} } = input;
+    const timeZone = input.timeZone ?? policy.time_zone;
+    const steps = [];
+    const refusals = [];
+    const provider = policy.provider;
+    const providerOut = redactUrl(provider);
+    const attention = resolveAttentionKind(ops.registry, ops.okfVersion, input.signals?.kind ?? "Signal", policy.target_kind);
+    if (!attention.ok)
+        throw new OverlayRefusal(REFUSAL_CODES.POLICY_INVALID, attention.reason, { feed: policy.feed });
+    const { name: signalName, kind: signalKind, prefix: signalPrefix, stateField: progressField, ownerField } = attention.value;
+    const { fromFeed, about } = signalLinkTexts(signalKind, policy.target_kind, input.signals?.feedKind ?? "Source Feed");
+    const feedSlug = policy.feed.split("/").pop().replace(/[^a-z0-9-]+/gi, "-").toLowerCase();
+    const overlays = policy.target_kind
+        ? input.overlays ?? await buildSourceIndex(content.bundle, { type: policy.target_kind })
+        : null;
+    const existingSignals = (await queryHeads(ops.bundle, { type: signalName }))
+        .filter((h) => h.frontmatter.provider === providerOut);
+    // Records superseded by a record of this same observation (`collapse_with`): their successor
+    // carries the news, so their own disappearance needs no Signal activity.
+    const related = await correlationIndex(content.bundle, hooks.correlate);
+    const supersededNow = new Set(changes.filter((c) => c.after).flatMap((c) => c.collapse_with ?? []));
+    const touchedSignals = new Set();
+    const isOpen = (h) => h.frontmatter[progressField] === "todo" && !h.frontmatter[ownerField];
+    for (const change of changes) {
+        if (change.change_kind === "disappeared" && supersededNow.has(change.external_id)) {
+            steps.push({ op: "record-only", external_id: change.external_id, change_kind: change.change_kind, superseded: true });
+            continue;
+        }
+        // A record that drops out after its last known end has ended: no Signal. One that vanishes
+        // before its start may be canceled and is still raised. The phase is judged when it first went
+        // missing; without that time the phase is unknown and the record is raised.
+        const phase = change.change_kind === "disappeared" && change.first_missing_at ? disappearedPhase(change.before, change.first_missing_at, timeZone, hooks.interval) : null;
+        // A record with an open, unclaimed Signal is not retired quietly: that Signal is told it ended.
+        const hasOpen = existingSignals.some((h) => h.frontmatter.external_id === change.external_id && isOpen(h));
+        if (phase === "ended" && !hasOpen) {
+            const [, endMs] = lastKnownInterval(change.before, timeZone, hooks.interval);
+            steps.push({ op: "record-only", external_id: change.external_id, change_kind: change.change_kind, ended: true, reason: "ended", last_known_end: new Date(endMs).toISOString() });
+            continue;
+        }
+        const matches = overlays ? overlays.lookup(provider, change.external_id, { type: policy.target_kind }) : [];
+        const recTitle = change.after?.title ?? change.before?.title ?? records[change.external_id]?.fields?.title;
+        if (matches.length > 1) {
+            refusals.push({ code: REFUSAL_CODES.OVERLAY_IDENTITY_AMBIGUOUS, external_id: change.external_id, targets: matches.map((m) => m.id), message: "more than one document claims this provider identity; merge or rebind needs review" });
+        }
+        const overlay = matches.length === 1 ? matches[0] : null;
+        // Editorially excluded records are observed and stored but never presented, so they never need judgment either.
+        if (isExcludedRecord(policy, change.external_id, recTitle)) {
+            steps.push({ op: "record-only", external_id: change.external_id, change_kind: change.change_kind, excluded: true });
+            continue;
+        }
+        const decision = decideChange(policy, change, { overlay, textGate: hooks.textGate });
+        // An ended record with an open Signal only tells that Signal so: it keeps its kind, title and
+        // priority (expiry is not news), with a low-priority observation line.
+        const endedOpen = phase === "ended" && hasOpen;
+        if (endedOpen)
+            decision.signal = { priority: "low", reasons: ["update-open-signal", "ended"] };
+        if (matches.length > 1)
+            decision.signal ??= { priority: "normal", reasons: [REFUSAL_CODES.OVERLAY_IDENTITY_AMBIGUOUS] };
+        if (Object.keys(decision.apply).length) {
+            const fields = decision.apply;
+            const props = sourcePropertiesOf(hooks, change);
+            // A step that removes a field never carries the upsert: the grouped write refuses removals,
+            // so such a step is written as a patch, or as field actions when it writes a declared list.
+            const removes = Object.values(fields).some((v) => v.to === undefined);
+            steps.push({
+                op: "apply-owned-fields", target: overlay.id, expected_version: overlay.version, external_id: change.external_id, change_kind: change.change_kind, fields,
+                ...(props && !removes ? { sources: props } : {}),
+            });
+        }
+        for (const c of decision.conflicts) {
+            refusals.push({ code: REFUSAL_CODES.OVERLAY_DOC_CONFLICT, external_id: change.external_id, target: overlay.id, field: c.field, message: "owned field was edited in the document since the last accepted feed value" });
+        }
+        const mine = existingSignals.filter((h) => h.frontmatter.external_id === change.external_id);
+        // A record that supersedes another (`collapse_with`) joins that record's open Signal.
+        const predecessors = new Set(change.collapse_with ?? []);
+        const open = mine.find(isOpen) ?? existingSignals.find((h) => predecessors.has(h.frontmatter.external_id) && isOpen(h));
+        // A record with an open, unclaimed Signal keeps that Signal current even for changes that
+        // would otherwise be record-only, so the eventual claimant sees the latest facts.
+        if (!decision.signal && open)
+            decision.signal = { priority: "low", reasons: ["update-open-signal"] };
+        if (!decision.signal) {
+            if (!Object.keys(decision.apply).length)
+                steps.push({ op: "record-only", external_id: change.external_id, change_kind: change.change_kind });
+            continue;
+        }
+        const signal = decision.signal;
+        if (change.signal_priority !== undefined && PRIORITIES.has(change.signal_priority))
+            signal.priority = maxPriority(signal.priority, change.signal_priority);
+        const links = related(change.after ?? change.before ?? records[change.external_id]?.fields ?? {}, change.external_id);
+        for (const r of links) {
+            signal.priority = maxPriority(signal.priority, r.priority !== undefined && PRIORITIES.has(r.priority) ? r.priority : "normal");
+            signal.reasons.push(`related:${r.id}`);
+        }
+        const aboutDoc = links.length === 1 ? { about_doc: links[0].id } : {};
+        const summary = withRelated(summarizeChange(change, decision, policy.owned_fields, { phase }), links);
+        const line = observationLine(observedAt, change.change_kind, change.content_digest, summary);
+        // Dedupe on (feed, external_id, change_kind, content_digest): any Signal whose observation log
+        // names that change of that digest. The kind matters: a disappearance carries the digest of the
+        // record's last presence, which a `new` Signal may already have logged.
+        let duplicate = null;
+        for (const h of mine) {
+            const { doc } = await readDocVersioned(ops.bundle, h.id);
+            if (doc.body.includes(` · ${change.change_kind} · ${change.content_digest} · `)) {
+                duplicate = h;
+                break;
+            }
+        }
+        if (duplicate) {
+            steps.push({ op: "signal-duplicate", target: duplicate.id, external_id: change.external_id, content_digest: change.content_digest });
+            continue;
+        }
+        if (open && touchedSignals.has(open.id)) {
+            // One CAS write per Signal per run: a second change for the same open Signal is recorded
+            // but not logged on the Signal, rather than losing the first write to STALE_VERSION.
+            steps.push({ op: "record-only", external_id: change.external_id, change_kind: change.change_kind, collapsed_into: open.id });
+            continue;
+        }
+        if (open) {
+            touchedSignals.add(open.id);
+            const prevKind = open.frontmatter.change_kind;
+            const kind = endedOpen ? prevKind : severity(change.change_kind) >= severity(prevKind) ? change.change_kind : prevKind;
+            steps.push({
+                op: "collapse-signal", target: open.id, expected_version: open.version, external_id: change.external_id, content_digest: change.content_digest,
+                progress_field: progressField, observation_line: line,
+                set: { change_kind: kind, priority: maxPriority(open.frontmatter.priority, signal.priority), observed_at: observedAt, diff_summary: summary, title: signalTitle(kind, recTitle, change.external_id), external_id: change.external_id, ...aboutDoc },
+            });
+            continue;
+        }
+        // A disappearance reuses the last digest, so its Signal id also names the kind.
+        const id = `${signalPrefix}${feedSlug}-${change.change_kind === "disappeared" ? shortHash(policy.feed, change.external_id, change.content_digest, "disappeared") : shortHash(policy.feed, change.external_id, change.content_digest)}`;
+        const linkLines = [];
+        if (fromFeed)
+            linkLines.push(linkLine(fromFeed, id, policy.feed));
+        if (overlay && about && sameBundle)
+            linkLines.push(linkLine(about, id, overlay.id));
+        else if (overlay)
+            linkLines.push(overlayLine(overlay.id));
+        for (const r of links)
+            linkLines.push(relatedLine(r.id, r.reason));
+        // Record-only feeds have nothing to overlay; the claimant decides what to author from the record.
+        const hint = overlay || !policy.target_kind ? undefined : adoptionHint(policy.target_kind, providerOut, change.external_id);
+        const frontmatter = {
+            type: signalName,
+            title: signalTitle(change.change_kind, recTitle, change.external_id),
+            [progressField]: "todo",
+            change_kind: change.change_kind,
+            observed_at: observedAt,
+            provider: providerOut,
+            external_id: change.external_id,
+            diff_summary: summary,
+            priority: signal.priority,
+            ...aboutDoc,
+            // A source entry's title is text on OKF v0.2; a numeric or boolean record title is written as its text.
+            sources: [{ resource: providerOut, id: change.external_id, ...(recTitle ? { title: typeof recTitle === "number" || typeof recTitle === "boolean" ? String(recTitle) : recTitle } : {}) }],
+        };
+        const body = signalBody(linkLines, hint, line);
+        steps.push({ op: "create-signal", target: id, external_id: change.external_id, content_digest: change.content_digest, reasons: signal.reasons, candidate: { frontmatter, body } });
+    }
+    return {
+        feed: policy.feed,
+        provider: providerOut,
+        observed_at: observedAt,
+        baseline: observation.baseline,
+        replay: observation.replay,
+        stats: observation.stats,
+        steps,
+        refusals,
+    };
+}
+/** Build the correlation lookup once per plan: (fields, externalId) -> related documents. */
+async function correlationIndex(contentBundle, correlate) {
+    if (!correlate || typeof correlate.match !== "function" || typeof correlate.kind !== "string")
+        return () => [];
+    const heads = await queryHeads(contentBundle, { type: correlate.kind });
+    return (fields, externalId) => {
+        const out = [];
+        for (const h of heads) {
+            const m = correlate.match(fields, h.frontmatter, externalId);
+            // The reason sits on the related line of a Signal body, so it is kept to one line.
+            if (m && m.reason)
+                out.push({ id: h.id, reason: oneLine(String(m.reason).slice(0, 120)), priority: m.priority });
+        }
+        return out.sort((a, b) => a.id.localeCompare(b.id)).slice(0, 5);
+    };
+}
+function withRelated(summary, links) {
+    if (!links.length)
+        return summary;
+    const s = `${summary}; related: ${links.map((r) => `${r.id} (${r.reason})`).join(", ")}`;
+    return s.length > 600 ? s.slice(0, 599) + "…" : s;
+}
+function signalTitle(kind, title, externalId) {
+    const t = `${LABEL[kind] ?? kind}: ${title ?? externalId}`;
+    return t.length > 140 ? t.slice(0, 139) + "…" : t;
+}
+//# sourceMappingURL=plan.js.map

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

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

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

@@ -0,0 +1,74 @@
+/**
+ * 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>;
+/**
+ * The fields a target Kind declares as `string-list` or `https-url-list`. An owning feed treats each
+ * as a set: change detection compares members, and the apply writes the whole list.
+ */
+export declare function declaredListFields(kind: Pick<KindConvention, "fields"> | undefined): string[];
+/**
+ * Read the generic keys of a Source Feed document. Every refusal is `POLICY_INVALID`, its details
+ * naming the feed and, for a feed key, that `key`. 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;
+/** Read the same field policy at an explicit identity coordinate, without a transport URL. */
+export declare function readOverlayPolicyForResource(doc: {
+    id: ConceptId;
+    frontmatter: Frontmatter;
+}, resource: string, 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.
+ *
+ * A field in `policy.list_fields` compares as a set ({@link sameSet}), so a document holding the
+ * same members in another order converges; every other field compares whole values.
+ */
+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,EAAiE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AACjH,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;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,GAAG,SAAS,GAAG,MAAM,EAAE,CAI7F;AAUD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,EAAE,GAAG,GAAE,aAAkB,GAAG,aAAa,CAE1H;AAED,8FAA8F;AAC9F,wBAAgB,4BAA4B,CAAC,GAAG,EAAE;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,WAAW,CAAA;CAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAE,aAAkB,GAAG,aAAa,CAEvJ;AAyDD;;;;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;;;;;;;;;;;;GAYG;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,CAgDhB;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,235 @@
+/**
+ * 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, isKindListField, progressStatusStorageField } from "../kinds.js";
+import { same, sameSet } 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;
+}
+/**
+ * The fields a target Kind declares as `string-list` or `https-url-list`. An owning feed treats each
+ * as a set: change detection compares members, and the apply writes the whole list.
+ */
+export function declaredListFields(kind) {
+    if (!kind)
+        return [];
+    const declared = new Set([...kind.fields.required, ...kind.fields.optional]);
+    return [...declared].filter((field) => isKindListField(kind, field)).sort();
+}
+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`, its details
+ * naming the feed and, for a feed key, that `key`. 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 = {}) {
+    return policyAt(doc, doc.frontmatter?.url, ctx, "url");
+}
+/** Read the same field policy at an explicit identity coordinate, without a transport URL. */
+export function readOverlayPolicyForResource(doc, resource, ctx = {}) {
+    return policyAt(doc, resource, ctx, "resource");
+}
+function policyAt(doc, resource, ctx, coordinateKey) {
+    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", { key: "owned_fields" });
+    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(", ")}`, { key: "owned_fields", 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(", ")}`, { key: "owned_fields", 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(", ")}`, { key: "owned_fields", 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(", ")}`, { key: "owned_fields", 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", { key: "missing_threshold" });
+    if (typeof resource !== "string" || !resource)
+        refuse(`${coordinateKey} (provider identity) is required`, { key: coordinateKey });
+    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;
+    const listFields = declaredListFields(ctx.targetKind);
+    return {
+        feed: doc.id,
+        provider: resource,
+        ...(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 } : {}),
+        ...(listFields.length ? { list_fields: listFields } : {}),
+    };
+}
+/** 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, key: "exclude_pattern" });
+    }
+}
+/**
+ * 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.
+ *
+ * A field in `policy.list_fields` compares as a set ({@link sameSet}), so a document holding the
+ * same members in another order converges; every other field compares whole values.
+ */
+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;
+    const lists = new Set(policy.list_fields ?? []);
+    const equal = (f) => (lists.has(f) ? sameSet : same);
+    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);
+            const eq = equal(f);
+            if (eq(C, N) || eq(C, n.value))
+                continue;
+            if (eq(C, B) || eq(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) && !equal(f)(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