@superbee/core 0.2.0-pre.2 → 0.2.0-pre.21

package/dist/kind-authoring.js

@@ -0,0 +1,451 @@
+import { InvalidInputError } from "./errors.js";
+import { isManagedDocumentMetadataField } from "./managed-document-metadata.js";
+// Storage-neutral Kind inference and guarded authoring. Pure derivations consume already-read
+// documents; the public operations below acquire state and share mutation specifications with
+// presentation adapters. Host-specific prose, command formatting and receipts stay with callers.
+//
+// The one invariant this module exists to protect: an INFERRED draft applies with zero new
+// conformance warnings ("zero-debt by construction"). That holds only because the inference
+// predicates below are pinned to core's OWN validation predicates — presence is core's
+// `isPresent` (never bare key existence: a `title: ""` on one instance must not become a
+// required field), and enum proposal is scalar-string-only (an array-valued key would fire
+// KIND_FIELD_ARITY on every instance). The apply-then-validate property test in
+// kind-draft.test.ts pins this predicate equality; drift there fails the suite loudly.
+import { sha256HexOfUtf8 } from "./sha256.js";
+import { isPresent, RESERVED_KIND_FIELD_NAMES, SUPERBEE_PROGRESS_STATUS_FIELD, splitSections, validateAgainstKind, } from "./kinds.js";
+/** Enum inference gates: 100% presence, at least this many instances, 2-6 distinct scalar strings. */
+export const ENUM_MIN_INSTANCES = 10;
+export const ENUM_MIN_DISTINCT = 2;
+export const ENUM_MAX_DISTINCT = 6;
+/**
+ * Floor for a sub-100% H1 heading to appear as a PRICED promotion (mirrors the 60% descriptive
+ * threshold the modeling signal's status block uses). Headings below it are noise, not candidates.
+ */
+export const SECTION_PROMOTION_FLOOR = 0.6;
+/** Inference omits ownership metadata and receipts, without changing field-action policy. */
+const EXCLUDED_FIELDS = new Set([...RESERVED_KIND_FIELD_NAMES, "head_version"]);
+function excludedInferenceField(field) {
+    return EXCLUDED_FIELDS.has(field) || isManagedDocumentMetadataField(field) ||
+        (field.startsWith("superbee_") && field !== SUPERBEE_PROGRESS_STATUS_FIELD);
+}
+/**
+ * One predicate per declaring key. The `Record<DeclarationKey, ...>` type is the point: adding a
+ * key to `KindConvention` in core makes this object structurally incomplete and FAILS THE BUILD
+ * until the new key is classified. This predicate was previously a hand-written chain of `||`,
+ * and an enumeration maintained by hand goes stale silently — it omitted `path`, and then
+ * `browseCollapsed`, each found only by someone probing for it. A missing entry here is not a
+ * cosmetic gap: it makes a real convention read as a dismissal record, so a draft will overwrite
+ * the declaration it could not see.
+ */
+/**
+ * The same exhaustiveness, one level down. `fields` is a structured sub-object, and the first
+ * version of this classifier enumerated four of its six keys by hand — missing `descriptions`
+ * and `valueDescriptions`, so a convention carrying only field guidance read as declaration-free
+ * and could be drafted over. Every key of `KindFields` declares something (a dismissal record has
+ * an EMPTY fields block, not a partially-filled one), so nothing is excluded here; adding a key to
+ * `KindFields` in core fails the build until it is classified.
+ */
+const FIELDS_DECLARES = {
+    required: (f) => f.required.length > 0,
+    optional: (f) => f.optional.length > 0,
+    values: (f) => Object.keys(f.values).length > 0,
+    valueDescriptions: (f) => f.valueDescriptions !== undefined && Object.keys(f.valueDescriptions).length > 0,
+    terminal: (f) => Object.keys(f.terminal).length > 0,
+    descriptions: (f) => Object.keys(f.descriptions).length > 0,
+    types: (f) => f.types !== undefined && Object.keys(f.types).length > 0,
+};
+const DECLARES = {
+    path: (kind) => kind.path !== undefined && kind.path !== "",
+    fields: (kind) => Object.values(FIELDS_DECLARES).some((declares) => declares(kind.fields)),
+    links: (kind) => kind.links !== undefined && Object.keys(kind.links).length > 0,
+    linkDescriptions: (kind) => kind.linkDescriptions !== undefined && Object.keys(kind.linkDescriptions).length > 0,
+    expectsInbound: (kind) => kind.expectsInbound !== undefined && Object.keys(kind.expectsInbound).length > 0,
+    sections: (kind) => kind.sections !== undefined && kind.sections.length > 0,
+    freshnessHorizon: (kind) => kind.freshnessHorizon !== undefined,
+    // Core parses only a strict `true` here; a declared `false` never reaches this predicate, so the
+    // `!== undefined` form is the whole check rather than a distinction between true and false.
+    browseCollapsed: (kind) => kind.browseCollapsed !== undefined,
+    // A reading-order placement is authored on purpose; a draft must never overwrite it.
+    order: (kind) => kind.order !== undefined,
+    claim: (kind) => kind.claim !== undefined,
+};
+/**
+ * Whether `kind` declares ANY schema obligation or behavior. The ONE predicate shared by
+ * `kind draft`'s refusal (a declaration-bearing kind is never silently redrafted), `kind
+ * dismiss`'s idempotency check, and `new`'s registry-lookup guard (a declaration-free kind — a
+ * dismissal record — must leave `new`'s command surface exactly as it was before the dismissal).
+ */
+export function kindDeclaresAnything(kind) {
+    return Object.values(DECLARES).some((declares) => declares(kind));
+}
+/** `"Context Note"` -> `"context-note"` — the same slug shape the builtin conventions use. */
+export function conventionSlugForType(type) {
+    const slug = type
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "");
+    return slug === "" ? "kind" : slug;
+}
+function sortedRecord(entries) {
+    return Object.fromEntries([...entries].sort(([a], [b]) => a.localeCompare(b)));
+}
+/** Fold `instances` into the presence stats. Presence is core's `isPresent`, never key existence. */
+export function collectInstanceStats(instances) {
+    const keys = new Map();
+    const headings = new Map();
+    for (const doc of instances) {
+        for (const [key, value] of Object.entries(doc.frontmatter)) {
+            if (!isPresent(value))
+                continue;
+            keys.set(key, (keys.get(key) ?? 0) + 1);
+        }
+        for (const heading of Object.keys(splitSections(doc.body))) {
+            headings.set(heading, (headings.get(heading) ?? 0) + 1);
+        }
+    }
+    return {
+        count: instances.length,
+        keyPresence: sortedRecord(keys),
+        headingPresence: sortedRecord(headings),
+    };
+}
+/** True when every observed value for `key` across `instances` is a scalar string. */
+function everyValueScalarString(instances, key) {
+    for (const doc of instances) {
+        const value = doc.frontmatter[key];
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value !== "string")
+            return false;
+    }
+    return true;
+}
+/** Distinct observed (string) values for `key`, in first-seen order. */
+function distinctValues(instances, key) {
+    const seen = new Set();
+    for (const doc of instances) {
+        const value = doc.frontmatter[key];
+        if (typeof value === "string" && value.trim() !== "")
+            seen.add(value);
+    }
+    return [...seen];
+}
+/**
+ * Infer the candidate convention for `type` from its instances:
+ * - required  = keys `isPresent` on 100% of instances (minus reserved + attribution)
+ * - optional  = every other key `isPresent` on >=1 instance
+ * - values    = only at 100% presence, >= {@link ENUM_MIN_INSTANCES} instances, 2-6 distinct
+ *               values, every observed value a scalar string
+ * - sections  = H1 headings on 100% of instances (H1-only: core's ONE heading splitter)
+ * - path      = the common leading id segment, only when ALL instances share exactly one — a
+ *               split (`plans/` + `designs/`) is the finding; silently blessing one prefix
+ *               would orphan the rest, so no `path` is proposed there
+ */
+export function inferKindCandidate(type, instances, stats = collectInstanceStats(instances), description = `Drafted from ${stats.count} existing instances.`) {
+    const count = stats.count;
+    const required = [];
+    const optional = [];
+    const values = {};
+    for (const [key, present] of Object.entries(stats.keyPresence)) {
+        if (excludedInferenceField(key))
+            continue;
+        if (present === count && count > 0) {
+            required.push(key);
+            if (count >= ENUM_MIN_INSTANCES && everyValueScalarString(instances, key)) {
+                const distinct = distinctValues(instances, key);
+                if (distinct.length >= ENUM_MIN_DISTINCT && distinct.length <= ENUM_MAX_DISTINCT) {
+                    values[key] = distinct.sort((a, b) => a.localeCompare(b));
+                }
+            }
+        }
+        else {
+            optional.push(key);
+        }
+    }
+    const sections = Object.entries(stats.headingPresence)
+        .filter(([, present]) => present === count && count > 0)
+        .map(([heading]) => heading);
+    const prefixes = new Set();
+    let allPrefixed = instances.length > 0;
+    for (const doc of instances) {
+        const slash = doc.id.indexOf("/");
+        if (slash <= 0) {
+            allPrefixed = false;
+            break;
+        }
+        prefixes.add(doc.id.slice(0, slash));
+    }
+    const path = allPrefixed && prefixes.size === 1 ? `${[...prefixes][0]}/` : undefined;
+    return {
+        id: `conventions/${conventionSlugForType(type)}`,
+        title: type,
+        governs: type,
+        description,
+        ...(path === undefined ? {} : { path }),
+        fields: { required, optional, values, terminal: {}, descriptions: {} },
+        ...(sections.length > 0 ? { sections } : {}),
+    };
+}
+/**
+ * Price the candidate promotions: every sub-100% optional field, plus every H1 heading at or
+ * above {@link SECTION_PROMOTION_FLOOR} but below 100%. `warnings_if_added` is exactly the
+ * instances the added declaration would newly warn on.
+ */
+export function draftPromotions(kind, stats) {
+    const rows = [];
+    for (const key of kind.fields.optional) {
+        const present = stats.keyPresence[key] ?? 0;
+        rows.push({
+            declaration: `field ${key} (optional -> required)`,
+            present: `${present}/${stats.count}`,
+            warnings_if_added: stats.count - present,
+        });
+    }
+    for (const [heading, present] of Object.entries(stats.headingPresence)) {
+        if (present === stats.count)
+            continue; // already in the draft
+        if (present / stats.count < SECTION_PROMOTION_FLOOR)
+            continue;
+        rows.push({
+            declaration: `section "# ${heading}"`,
+            present: `${present}/${stats.count}`,
+            warnings_if_added: stats.count - present,
+        });
+    }
+    rows.sort((a, b) => a.warnings_if_added - b.warnings_if_added || a.declaration.localeCompare(b.declaration));
+    return rows;
+}
+/**
+ * The MEASURED post-apply warning count: run core's validator over every instance against the
+ * candidate and sum the violations. Zero by construction for an inferred candidate (see module
+ * comment); the true — possibly large — number for an adopted catalog candidate. Never assumed.
+ */
+export function warningsAfterApply(kind, instances) {
+    let total = 0;
+    for (const doc of instances)
+        total += validateAgainstKind(doc, kind).length;
+    return total;
+}
+/**
+ * The state-bound plan token `--apply` must present: sha256 of the canonical JSON of everything
+ * the human inspected — the exact candidate document, the bundle edition, and the instance stats
+ * it was inferred from. Any change to WHAT THE TOKEN BINDS between draft and apply refuses:
+ * a presence-stat change (new/removed instances, a key appearing or emptying), an edition
+ * change, or a candidate difference. It ALSO binds the measured warning count, because that count
+ * is what the human accepted: an instance edit that changes the forecast (a value leaving a
+ * declared enum) must not apply under a token issued against a different number. An edit changing
+ * neither the candidate, the presence stats, nor the warning count keeps the token valid — the
+ * written bytes are identical either way.
+ */
+export function draftPlanToken(input) {
+    return `sha256:${sha256HexOfUtf8(JSON.stringify(input))}`;
+}
+import { CONVENTION_TYPE, parseConventionDoc } from "./kinds.js";
+import { loadKinds } from "./kinds-load.js";
+import { query, readBundleOkfVersion } from "./bundle-ops.js";
+import { builtinNames, resolveBuiltinSync } from "./builtin-recipes.js";
+import { materializeRecipeForEdition } from "./recipe-lifecycle/install.js";
+import { droppedLinks } from "./body-replace-guards.js";
+import { mutateDocument } from "./document-mutation.js";
+/** Adapters render recovery commands from these typed facts, never from parsed prose. */
+export class KindAuthoringError extends Error {
+    reason;
+    type;
+    details;
+    constructor(reason, type, details = {}) {
+        super(`Kind authoring for '${type}' refused: ${reason}.`);
+        this.name = "KindAuthoringError";
+        this.reason = reason;
+        this.type = type;
+        this.details = details;
+    }
+}
+/** The builtin convention governing `type`, materialized for this bundle's edition, if any. */
+function catalogConventionForType(type, okfVersion) {
+    for (const name of builtinNames()) {
+        const recipe = resolveBuiltinSync(name);
+        if (!recipe.governs.includes(type))
+            continue;
+        const materialized = materializeRecipeForEdition(recipe, okfVersion);
+        const doc = materialized.docs.find((d) => {
+            const governs = d.frontmatter.governs;
+            return typeof governs === "string" && governs.trim() === type;
+        });
+        if (!doc)
+            continue;
+        const parsed = parseConventionDoc(doc);
+        if (!parsed.ok)
+            continue;
+        return {
+            recipeId: recipe.id,
+            doc,
+            kind: parsed.kind,
+            siblings: recipe.governs.filter((governs) => governs !== type),
+        };
+    }
+    return undefined;
+}
+/** Candidate frontmatter WITHOUT a timestamp — the engine stamps one at write time. */
+function candidateDocFor(kind, body) {
+    const fields = {};
+    if (kind.fields.required.length > 0)
+        fields.required = kind.fields.required;
+    if (kind.fields.optional.length > 0)
+        fields.optional = kind.fields.optional;
+    if (Object.keys(kind.fields.values).length > 0)
+        fields.values = kind.fields.values;
+    const frontmatter = {
+        type: CONVENTION_TYPE,
+        title: kind.title,
+        governs: kind.governs,
+    };
+    if (kind.description !== undefined)
+        frontmatter.description = kind.description;
+    if (kind.path !== undefined)
+        frontmatter.path = kind.path;
+    if (Object.keys(fields).length > 0)
+        frontmatter.fields = fields;
+    if (kind.sections !== undefined && kind.sections.length > 0)
+        frontmatter.sections = kind.sections;
+    return { id: kind.id, frontmatter, body };
+}
+/** Match convention parsing: type names are trimmed strings with nonempty content. */
+function normalizeKindAuthoringType(type) {
+    const normalized = typeof type === "string" ? type.trim() : "";
+    if (!isPresent(normalized))
+        throw new InvalidInputError("Kind authoring requires a nonempty type name.");
+    return normalized;
+}
+/** Build the whole read-only plan: registry + instances -> candidate + forecast + token. */
+export async function prepareKindDraft(bundle, type, text = {}) {
+    type = normalizeKindAuthoringType(type);
+    const [registry, okfVersionRead] = await Promise.all([loadKinds(bundle), readBundleOkfVersion(bundle)]);
+    const okfVersion = okfVersionRead ?? "0.1";
+    const existing = registry.kinds.get(type);
+    if (existing && kindDeclaresAnything(existing)) {
+        throw new KindAuthoringError("already-governed", type, { id: existing.id });
+    }
+    const instances = (await query(bundle, { type })).sort((a, b) => a.id.localeCompare(b.id));
+    if (instances.length === 0) {
+        throw new KindAuthoringError("no-instances", type);
+    }
+    const stats = collectInstanceStats(instances);
+    const catalog = catalogConventionForType(type, okfVersion);
+    let candidateKind;
+    let candidateDoc;
+    if (catalog) {
+        // Adopt the builtin definition VERBATIM — the recipe's schema is better than an inference,
+        // and landing it at its canonical id keeps the recipes surface consistent. The forecast
+        // below then reports the REAL (possibly large) warning count against existing instances —
+        // the priced route `recipe add` cannot offer when instances already exist.
+        candidateKind = catalog.kind;
+        const { timestamp: _timestamp, ...frontmatter } = catalog.doc.frontmatter;
+        candidateDoc = { id: catalog.doc.id, frontmatter, body: catalog.doc.body };
+    }
+    else {
+        candidateKind = inferKindCandidate(type, instances, stats, text.inferredDescription?.(type, stats.count));
+        candidateDoc = candidateDocFor(candidateKind, text.inferredBody?.(type, stats.count) ?? `Drafted from ${stats.count} existing '${type}' instances.\n`);
+    }
+    // A redraft upgrades the EXISTING governing record in place, wherever it lives — a
+    // hand-authored governs-only convention at a non-canonical id keeps its id (never two
+    // conventions for one kind; the slug id is only for true creates).
+    if (existing)
+        candidateDoc = { ...candidateDoc, id: existing.id };
+    const warnings = warningsAfterApply(candidateKind, instances);
+    const token = draftPlanToken({ target: candidateDoc.id, candidate: candidateDoc, okfVersion, stats, warnings });
+    return {
+        type,
+        okfVersion,
+        registry,
+        redraftOver: existing,
+        candidateDoc,
+        candidateKind,
+        catalog,
+        stats,
+        instances,
+        warnings,
+        token,
+    };
+}
+/** The one guarded mutation specification used by public apply and presentation adapters. */
+export function prepareKindDraftMutation(bundle, plan, expectedToken, options = {}) {
+    const expected = expectedToken.trim();
+    if (plan.token !== expected)
+        throw new KindAuthoringError("plan-changed", plan.type, { expected, current: plan.token });
+    const prepared = {
+        droppedLinks: [],
+        options: {
+            seedGenerationClock: false, bundle, id: plan.candidateDoc.id,
+            mode: plan.redraftOver ? "replace-document" : "create-only",
+            registry: plan.registry, strict: false, actor: options.actor, now: options.now,
+            // An accepted redraft replaces the decline prose; report any removed links explicitly.
+            bodyReplace: { replaceLinks: true },
+            buildCandidate: (existing, context) => {
+                if (context.okfVersion !== plan.okfVersion)
+                    throw new KindAuthoringError("edition-changed", plan.type);
+                if (plan.redraftOver) {
+                    const parsed = existing && parseConventionDoc(existing);
+                    if (!parsed || !parsed.ok || parsed.kind.governs !== plan.type || kindDeclaresAnything(parsed.kind)) {
+                        throw new KindAuthoringError("redraft-changed", plan.type, { id: plan.redraftOver.id });
+                    }
+                }
+                prepared.droppedLinks = existing ? droppedLinks(bundle, existing, plan.candidateDoc.body) : [];
+                return { frontmatter: structuredClone(plan.candidateDoc.frontmatter), body: plan.candidateDoc.body };
+            },
+        },
+    };
+    return prepared;
+}
+export async function appliedKindDraftWarnings(bundle, plan) {
+    const applied = (await loadKinds(bundle)).kinds.get(plan.type);
+    return applied ? warningsAfterApply(applied, plan.instances) : plan.warnings;
+}
+/** Recompute what was inspected before applying; callers never reproduce the stale-plan checks. */
+export async function applyKindDraft(bundle, type, expectedToken, options = {}) {
+    const plan = await prepareKindDraft(bundle, type, options);
+    const prepared = prepareKindDraftMutation(bundle, plan, expectedToken, options);
+    const result = await mutateDocument(prepared.options);
+    return { ...result, droppedLinks: prepared.droppedLinks, warningsAfterApply: await appliedKindDraftWarnings(bundle, plan) };
+}
+export async function prepareKindDismissal(bundle, type, options = {}) {
+    type = normalizeKindAuthoringType(type);
+    const [registry, edition] = await Promise.all([loadKinds(bundle), readBundleOkfVersion(bundle)]);
+    const existing = registry.kinds.get(type);
+    if (existing && kindDeclaresAnything(existing))
+        throw new KindAuthoringError("dismiss-governed", type, { id: existing.id });
+    if (existing)
+        return { id: existing.id };
+    const id = `conventions/${conventionSlugForType(type)}`;
+    const catalog = catalogConventionForType(type, edition ?? "0.1");
+    return {
+        id, catalog,
+        options: {
+            seedGenerationClock: false, bundle, id, mode: "create-only", registry, strict: false,
+            actor: options.actor, now: options.now,
+            buildCandidate: () => ({
+                frontmatter: { type: CONVENTION_TYPE, title: type, governs: type,
+                    description: options.description ?? `Declined: '${type}' is deliberately unconstrained.` },
+                body: options.body?.(type, catalog) ?? `A Kind for '${type}' was deliberately declined.\n`,
+            }),
+        },
+    };
+}
+export async function dismissKind(bundle, type, options = {}) {
+    const prepared = await prepareKindDismissal(bundle, type, options);
+    if (!prepared.options)
+        return { id: prepared.id, changed: false };
+    const result = await mutateDocument(prepared.options);
+    return { id: prepared.id, changed: result.changed, result, catalog: prepared.catalog };
+}
+/** Typed values are already authored by the caller; existing core validation owns their meaning.
+ * Undefined body scaffolds headings, while an explicit empty body remains deliberately empty. */
+export function kindInstanceCandidate(kind, fields, body) {
+    const frontmatter = { type: kind.governs };
+    for (const [field, value] of Object.entries(fields)) {
+        if (field !== "type")
+            Object.defineProperty(frontmatter, field, { value, writable: true, enumerable: true, configurable: true });
+    }
+    return { frontmatter, body: body ?? (kind.sections ?? []).map(heading => `# ${heading}\n`).join("\n") };
+}
+//# sourceMappingURL=kind-authoring.js.map

package/dist/kind-authoring.js.map

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

package/dist/kind-conformance-error.d.ts

@@ -0,0 +1,15 @@
+import { InvalidInputError } from "./errors.js";
+import type { ValidationWarning } from "./content-type.js";
+import type { ConceptId } from "./types.js";
+/**
+ * Typed strict-kind rejection for trusted consumers to translate at their own boundary. Its own
+ * module so field actions can refuse with it without importing the mutation service.
+ */
+export declare class KindConformanceError extends InvalidInputError {
+    readonly id: ConceptId;
+    readonly governs: string;
+    readonly violations: ValidationWarning[];
+    readonly okfVersion?: "0.1" | "0.2";
+    constructor(id: ConceptId, governs: string, violations: ValidationWarning[], okfVersion?: "0.1" | "0.2");
+}
+//# sourceMappingURL=kind-conformance-error.d.ts.map

package/dist/kind-conformance-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-conformance-error.d.ts","sourceRoot":"","sources":["../src/kind-conformance-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,EAAE,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;gBAGlC,EAAE,EAAE,SAAS,EACb,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,iBAAiB,EAAE,EAC/B,UAAU,CAAC,EAAE,KAAK,GAAG,KAAK;CAS7B"}

package/dist/kind-conformance-error.js

@@ -0,0 +1,20 @@
+import { InvalidInputError } from "./errors.js";
+/**
+ * Typed strict-kind rejection for trusted consumers to translate at their own boundary. Its own
+ * module so field actions can refuse with it without importing the mutation service.
+ */
+export class KindConformanceError extends InvalidInputError {
+    id;
+    governs;
+    violations;
+    okfVersion;
+    constructor(id, governs, violations, okfVersion) {
+        super(`'${id}' does not satisfy the '${governs}' kind: ${violations.map((warning) => warning.message).join("; ")}`);
+        this.name = "KindConformanceError";
+        this.id = id;
+        this.governs = governs;
+        this.violations = violations;
+        this.okfVersion = okfVersion;
+    }
+}
+//# sourceMappingURL=kind-conformance-error.js.map

package/dist/kind-conformance-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-conformance-error.js","sourceRoot":"","sources":["../src/kind-conformance-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIhD;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,iBAAiB;IAChD,EAAE,CAAY;IACd,OAAO,CAAS;IAChB,UAAU,CAAsB;IAChC,UAAU,CAAiB;IAEpC,YACE,EAAa,EACb,OAAe,EACf,UAA+B,EAC/B,UAA0B;QAE1B,KAAK,CAAC,IAAI,EAAE,2BAA2B,OAAO,WAAW,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpH,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF"}

package/dist/kind-coverage.d.ts

@@ -0,0 +1,99 @@
+import { type KindRegistry } from "./kinds.js";
+import type { OkfDocument } from "./types.js";
+/** All records are grouped by actual type; path prefixes never infer a Kind or hide nested records. */
+export declare function kindCoverage(registry: KindRegistry, documents: readonly OkfDocument[], options: {
+    now: Date;
+    okfVersion?: string;
+    kind?: string;
+}): {
+    now: string;
+    documents: number;
+    undeclared_kinds: string[];
+    kinds: {
+        governs: string;
+        records: number;
+        coverage: {
+            fields: {
+                present: number;
+                filled: number;
+                sentinel: number;
+                empty: number;
+                rate: number | null;
+                field: string;
+                required: boolean;
+            }[];
+            body_prose: {
+                filled: number;
+                rate: number | null;
+            };
+        };
+        drift: {
+            undeclared: {
+                key: string;
+                records: number;
+                rate: number | null;
+                examples: string[];
+                examples_total: number;
+            }[];
+            declared_unused: string[];
+            envelope: {
+                key: string;
+                records: number;
+            }[];
+        };
+        links: {
+            with_links: number;
+            typed: {
+                relation: string;
+                target_kind: string | null;
+                target_matches: boolean | null;
+                records: number;
+                links: number;
+                rate: number | null;
+            }[];
+            untyped_citations: number;
+            declared_never_used: string[];
+            dangling: number;
+            dangling_examples: string[];
+            no_inbound: number;
+        };
+        freshness: {
+            clock: string;
+            horizon: string | null;
+            horizon_ms: number | null;
+            missing: number;
+            invalid: number;
+            buckets: {
+                future: number;
+                "0-7d": number;
+                "8-30d": number;
+                "31-90d": number;
+                "91-180d": number;
+                "181-365d": number;
+                ">365d": number;
+            };
+            older_than_horizon: number | null;
+        };
+        sources: {
+            zero: number;
+            total: number;
+            invalid_entries: number;
+            non_url_resources: number;
+            per_record: {
+                "0": number;
+                "1": number;
+                "2": number;
+                "3": number;
+                "4": number;
+                "5+": number;
+            };
+            distinct_domains: number;
+            domains_shown: number;
+            top_domains: {
+                domain: string;
+                sources: number;
+            }[];
+        };
+    }[];
+};
+//# sourceMappingURL=kind-coverage.d.ts.map

package/dist/kind-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kind-coverage.d.ts","sourceRoot":"","sources":["../src/kind-coverage.ts"],"names":[],"mappings":"AAEA,OAAO,EAA+G,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAI5J,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA4F9C,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,WAAW,EAAE,EAAE,OAAO,EAAE;IAAE,GAAG,EAAE,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+CjJ"}