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

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"}

package/dist/kind-coverage.js

@@ -0,0 +1,186 @@
+/** Read-only measurements over canonical documents and the already-loaded Kind registry. */
+import { isStandardDocumentSetField } from "./document-field-actions.js";
+import { freshnessHorizonMs, projectKindForAuthoring, readKindField, resolveKindFieldCoordinate } from "./kinds.js";
+import { extractMarkdownLinks, parseLinksFromDoc } from "./links.js";
+import { isManagedDocumentMetadataField } from "./managed-document-metadata.js";
+import { parseTimestamp } from "./freshness.js";
+const SENTINELS = new Set(["unknown", "n/a", "na", "none", "tbd", "null", "-", "?"]);
+const EXAMPLES = 3;
+const DOMAIN_LIMIT = 15;
+const DAY = 86400000;
+const compare = (a, b) => a < b ? -1 : a > b ? 1 : 0;
+const ratio = (n, total) => total ? Math.round(n / total * 10000) / 10000 : null;
+const empty = (value) => value == null || (typeof value === "string" && value.trim() === "") ||
+    (Array.isArray(value) ? value.length === 0 : typeof value === "object" && Object.keys(value).length === 0);
+const sentinel = (value) => typeof value === "string" && SENTINELS.has(value.trim().toLowerCase());
+const filled = (value) => !empty(value) && !sentinel(value);
+const envelope = (key) => isManagedDocumentMetadataField(key) || isStandardDocumentSetField(key, "0.2") || key === "sources" || key === "tags";
+function bodyProse(body) {
+    // Lossless line measurement, not Markdown rendering: every ATX heading is ignored;
+    // a Related heading excludes its descendants until the next same/higher-level heading.
+    let relatedLevel;
+    for (const line of body.split("\n")) {
+        const text = line.trim();
+        const heading = /^(#{1,6})[ \t]+(.+?)\s*#*\s*$/.exec(text);
+        if (heading) {
+            const level = heading[1].length;
+            if (relatedLevel !== undefined && level <= relatedLevel)
+                relatedLevel = undefined;
+            if (heading[2].trim().toLowerCase() === "related" && relatedLevel === undefined)
+                relatedLevel = level;
+            continue;
+        }
+        if (relatedLevel !== undefined)
+            continue;
+        const prose = text.replace(/^[-*] +/, "");
+        if (!prose)
+            continue;
+        const links = extractMarkdownLinks(prose);
+        if (!(links.length === 1 && prose === `[${links[0].text}](${links[0].href})`))
+            return true;
+    }
+    return false;
+}
+function fieldStats(docs, value) {
+    let present = 0, sentinels = 0, used = 0;
+    for (const doc of docs) {
+        const v = value(doc);
+        if (v !== undefined)
+            used++;
+        if (filled(v))
+            present++;
+        else if (sentinel(v))
+            sentinels++;
+    }
+    return { present: used, filled: present, sentinel: sentinels, empty: docs.length - present - sentinels, rate: ratio(present, docs.length) };
+}
+function checkedOn(kind, docs, now) {
+    const buckets = { future: 0, "0-7d": 0, "8-30d": 0, "31-90d": 0, "91-180d": 0, "181-365d": 0, ">365d": 0 };
+    let missing = 0, invalid = 0, older = 0;
+    const horizon = freshnessHorizonMs(kind);
+    for (const doc of docs) {
+        const value = doc.frontmatter.checked_on;
+        if (!filled(value)) {
+            missing++;
+            continue;
+        }
+        // checked_on is domain date metadata, not the edition's meaningful-change clock.
+        const ms = typeof value === "string" ? parseTimestamp(/^\d{4}-\d{2}-\d{2}$/.test(value) ? `${value}T00:00:00Z` : value, "0.2") : null;
+        if (ms === null) {
+            invalid++;
+            continue;
+        }
+        const ageMs = now.getTime() - ms;
+        const days = Math.floor(ageMs / DAY);
+        const bucket = days < 0 ? "future" : days <= 7 ? "0-7d" : days <= 30 ? "8-30d" : days <= 90 ? "31-90d" : days <= 180 ? "91-180d" : days <= 365 ? "181-365d" : ">365d";
+        buckets[bucket]++;
+        if (horizon !== undefined && ageMs > horizon)
+            older++;
+    }
+    return { clock: "checked_on", horizon: kind.freshnessHorizon ?? null, horizon_ms: horizon ?? null, missing, invalid, buckets, older_than_horizon: horizon === undefined ? null : older };
+}
+function sourceStats(docs) {
+    const domains = new Map();
+    const distribution = { "0": 0, "1": 0, "2": 0, "3": 0, "4": 0, "5+": 0 };
+    let total = 0, zero = 0, invalid = 0, nonUrl = 0;
+    for (const doc of docs) {
+        const raw = doc.frontmatter.sources;
+        const list = Array.isArray(raw) ? raw : raw == null ? [] : [raw];
+        let count = 0;
+        for (const item of list) {
+            const resource = typeof item === "string" ? item : item && typeof item === "object" && !Array.isArray(item) ? item.resource : undefined;
+            if (typeof resource !== "string" || !filled(resource)) {
+                invalid++;
+                continue;
+            }
+            count++;
+            try {
+                const domain = new URL(resource).hostname.toLowerCase().replace(/^www\./, "");
+                if (!domain) {
+                    nonUrl++;
+                    continue;
+                }
+                domains.set(domain, (domains.get(domain) ?? 0) + 1);
+            }
+            catch {
+                nonUrl++;
+            }
+        }
+        if (!count)
+            zero++;
+        total += count;
+        distribution[count >= 5 ? "5+" : String(count)]++;
+    }
+    const ordered = [...domains].sort((a, b) => b[1] - a[1] || compare(a[0], b[0]));
+    return { zero, total, invalid_entries: invalid, non_url_resources: nonUrl, per_record: distribution, distinct_domains: domains.size, domains_shown: Math.min(domains.size, DOMAIN_LIMIT), top_domains: ordered.slice(0, DOMAIN_LIMIT).map(([domain, sources]) => ({ domain, sources })) };
+}
+/** All records are grouped by actual type; path prefixes never infer a Kind or hide nested records. */
+export function kindCoverage(registry, documents, options) {
+    if (!Number.isFinite(options.now.getTime()))
+        throw new TypeError("Coverage now must be a valid date");
+    const docs = [...documents].sort((a, b) => compare(a.id, b.id));
+    const index = new Map(docs.map((doc) => [doc.id, doc]));
+    const edges = new Map(docs.map((doc) => [doc.id, parseLinksFromDoc(doc)]));
+    const inbound = new Set([...edges.values()].flat().map((link) => link.to));
+    const groups = new Map();
+    for (const doc of docs) {
+        const type = doc.frontmatter.type;
+        const group = groups.get(type) ?? [];
+        group.push(doc);
+        groups.set(type, group);
+    }
+    const kinds = [...registry.kinds.values()].filter((kind) => options.kind === undefined || kind.governs === options.kind).map((kind) => {
+        const records = groups.get(kind.governs) ?? [];
+        const authoring = projectKindForAuthoring(options.okfVersion, kind);
+        const fields = [...new Set([...authoring.fields.required, ...authoring.fields.optional])].sort(compare);
+        const stats = fields.map((field) => ({ field, required: authoring.fields.required.includes(field), ...fieldStats(records, (doc) => readKindField(options.okfVersion, kind, doc.frontmatter, field)) }));
+        const declaredStorage = new Set(fields.map((field) => resolveKindFieldCoordinate(options.okfVersion, kind, field)?.storageField ?? field));
+        const undeclared = new Map(), envelopes = new Map();
+        for (const doc of records)
+            for (const key of Object.keys(doc.frontmatter)) {
+                if (envelope(key)) {
+                    envelopes.set(key, (envelopes.get(key) ?? 0) + 1);
+                    continue;
+                }
+                if (!declaredStorage.has(key)) {
+                    const ids = undeclared.get(key) ?? [];
+                    ids.push(doc.id);
+                    undeclared.set(key, ids);
+                }
+            }
+        const relations = new Map();
+        let citations = 0, dangling = 0, withLinks = 0;
+        const danglingExamples = [];
+        for (const doc of records) {
+            const links = edges.get(doc.id);
+            if (links.length)
+                withLinks++;
+            for (const link of links) {
+                const target = index.get(link.to);
+                if (!target) {
+                    dangling++;
+                    if (danglingExamples.length < EXAMPLES)
+                        danglingExamples.push(doc.id);
+                }
+                if (!Object.hasOwn(kind.links ?? {}, link.text)) {
+                    citations++;
+                    continue;
+                }
+                const targetKind = target?.frontmatter.type ?? null;
+                const key = JSON.stringify([link.text, targetKind]);
+                const row = relations.get(key) ?? { relation: link.text, target_kind: targetKind, target_matches: targetKind === null ? null : targetKind === kind.links[link.text], records: new Set(), links: 0 };
+                row.records.add(doc.id);
+                row.links++;
+                relations.set(key, row);
+            }
+        }
+        const used = new Set([...relations.values()].map((row) => row.relation));
+        return { governs: kind.governs, records: records.length,
+            coverage: { fields: stats, body_prose: { filled: records.filter((doc) => bodyProse(doc.body)).length, rate: ratio(records.filter((doc) => bodyProse(doc.body)).length, records.length) } },
+            drift: { undeclared: [...undeclared].sort(([a], [b]) => compare(a, b)).map(([key, ids]) => ({ key, records: ids.length, rate: ratio(ids.length, records.length), examples: ids.slice(0, EXAMPLES), examples_total: ids.length })), declared_unused: stats.filter((row) => row.present === 0).map((row) => row.field), envelope: [...envelopes].sort(([a], [b]) => compare(a, b)).map(([key, records]) => ({ key, records })) },
+            links: { with_links: withLinks, typed: [...relations.values()].sort((a, b) => compare(a.relation, b.relation) || compare(a.target_kind ?? "", b.target_kind ?? "")).map((row) => ({ relation: row.relation, target_kind: row.target_kind, target_matches: row.target_matches, records: row.records.size, links: row.links, rate: ratio(row.records.size, records.length) })), untyped_citations: citations, declared_never_used: Object.keys(kind.links ?? {}).filter((relation) => !used.has(relation)).sort(compare), dangling, dangling_examples: danglingExamples, no_inbound: records.filter((doc) => !inbound.has(doc.id)).length },
+            freshness: checkedOn(kind, records, options.now), sources: sourceStats(records) };
+    });
+    return { now: options.now.toISOString(), documents: docs.length, undeclared_kinds: [...groups.keys()].filter((type) => !registry.kinds.has(type)).sort(compare), kinds };
+}
+//# sourceMappingURL=kind-coverage.js.map

package/dist/kind-coverage.js.map

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

package/dist/kind-deprecation.d.ts

@@ -0,0 +1,32 @@
+/** Explicit-registry declaration lifecycle policy. Reads describe usage; transitions refuse only
+ * newly authored usage. Import-like writes with an empty registry retain their existing posture. */
+import type { KindConvention, KindRegistry } from "./kinds.js";
+import type { OkfDocument } from "./types.js";
+import type { ValidationWarning } from "./validation.js";
+export interface KindDeprecation {
+    fields: string[];
+    values: Record<string, string[]>;
+    links: string[];
+    /** An invalid recognized policy stays visible and refuses admitted authoring, never skips its Kind. */
+    problems?: ValidationWarning[];
+    /** Preserve invalid author bytes through convention serialization rather than silently repairing. */
+    raw?: unknown;
+}
+export declare function parseKindDeprecation(raw: unknown, kind: KindConvention, reserved: readonly string[], claimFields: readonly string[]): KindDeprecation;
+/** Eligibility that needs the whole explicitly admitted registry, without foreign reads. */
+export declare function kindDeprecationProblems(kind: KindConvention, registry?: KindRegistry): ValidationWarning[];
+export interface DeprecatedUsage {
+    code: "KIND_DEPRECATED_FIELD" | "KIND_DEPRECATED_VALUE" | "KIND_DEPRECATED_LINK";
+    field: string;
+    /** Stable occurrence identity; qualified identities include the alias and remain distinct from local edges. */
+    identity: string;
+    count: number;
+    /** The matched enum member, when this row describes value usage. */
+    value?: string;
+    unknown?: true;
+}
+/** Stored deprecated usage is information, deliberately separate from ordinary strict conformance. */
+export declare function inspectKindDeprecatedUsage(doc: OkfDocument, kind: KindConvention): DeprecatedUsage[];
+/** One transition authority shared by every admitted mutation posture and each fresh CAS head. */
+export declare function kindDeprecationTransition(existing: OkfDocument | undefined, candidate: OkfDocument, registry: KindRegistry): ValidationWarning[];
+//# sourceMappingURL=kind-deprecation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kind-deprecation.d.ts","sourceRoot":"","sources":["../src/kind-deprecation.ts"],"names":[],"mappings":"AAAA;oGACoG;AACpG,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAOzD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,qGAAqG;IACrG,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAMD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CA6CrJ;AAED,4FAA4F;AAC5F,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,iBAAiB,EAAE,CAQ1G;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,uBAAuB,GAAG,uBAAuB,GAAG,sBAAsB,CAAC;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,+GAA+G;IAC/G,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB;AAED,sGAAsG;AACtG,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,cAAc,GAAG,eAAe,EAAE,CAwBpG;AAED,kGAAkG;AAClG,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,WAAW,GAAG,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,GAAG,iBAAiB,EAAE,CAahJ"}

package/dist/kind-deprecation.js

@@ -0,0 +1,141 @@
+import { okfValuesEqual, isOkfRecord } from "./okf-authored-values.js";
+import { isOkfStandardField } from "./okf-standard-fields.js";
+import { isManagedDocumentMetadataField } from "./managed-document-metadata.js";
+import { parseLinksFromDoc } from "./links.js";
+import { parseQualifiedLinks } from "./qualified-links.js";
+const problem = (field, message) => ({
+    code: "KIND_DEPRECATION_INVALID", field, message: `${field}: ${message}`, severity: "warning",
+});
+export function parseKindDeprecation(raw, kind, reserved, claimFields) {
+    const result = { fields: [], values: {}, links: [] };
+    const problems = [];
+    const fail = (field, message) => { problems.push(problem(field, message)); };
+    const names = (value, path) => {
+        if (!Array.isArray(value) || value.some(v => typeof v !== "string" || !v.trim() || v !== v.trim())) {
+            fail(path, "expected a list of nonempty exact names");
+            return [];
+        }
+        return [...new Set(value)];
+    };
+    const protectedField = (field) => reserved.includes(field) || isOkfStandardField(field)
+        || isManagedDocumentMetadataField(field) || claimFields.includes(field);
+    if (!isOkfRecord(raw))
+        fail("deprecated", "expected a map of fields, values and links");
+    else {
+        for (const key of Object.keys(raw))
+            if (!["fields", "values", "links"].includes(key))
+                fail(`deprecated.${key}`, "unknown policy coordinate");
+        if (Object.hasOwn(raw, "fields"))
+            result.fields = names(raw.fields, "deprecated.fields");
+        for (const field of result.fields) {
+            if (!kind.fields.optional.includes(field) || kind.fields.required.includes(field) || protectedField(field)) {
+                fail(`deprecated.fields.${field}`, "only an optional, nonstandard, nonreserved, nonclaim field can be deprecated");
+            }
+        }
+        if (Object.hasOwn(raw, "values")) {
+            if (!isOkfRecord(raw.values))
+                fail("deprecated.values", "expected a field-to-values map");
+            else
+                for (const [field, value] of Object.entries(raw.values)) {
+                    const path = `deprecated.values.${field}`;
+                    // Reuse the Kind enum's scalar-to-string membership vocabulary; structured values cannot name a member.
+                    const values = Array.isArray(value) && value.every(v => ["string", "number", "boolean"].includes(typeof v))
+                        ? [...new Set(value.map(String))] : undefined;
+                    if (!values || values.some(v => !v.trim())) {
+                        fail(path, "expected a list of enum members");
+                        continue;
+                    }
+                    Object.defineProperty(result.values, field, { value: values, enumerable: true, writable: true, configurable: true });
+                    const allowed = Object.hasOwn(kind.fields.values, field) ? kind.fields.values[field] : undefined;
+                    if (protectedField(field) || ![...kind.fields.required, ...kind.fields.optional].includes(field)
+                        || !allowed || values.some(v => !allowed.includes(v)) || kind.fields.types?.[field] === "https-url-list") {
+                        fail(path, "expected members of a declared, nonstandard, nonclaim vocabulary");
+                    }
+                    const terminal = Object.hasOwn(kind.fields.terminal, field) ? kind.fields.terminal[field] : [];
+                    if (values.some(v => terminal.includes(v)))
+                        fail(path, "terminal members require a separate migration");
+                    if (kind.fields.required.includes(field) && allowed && !allowed.some(v => !values.includes(v)))
+                        fail(path, "a required field must retain an active member");
+                }
+        }
+        if (Object.hasOwn(raw, "links"))
+            result.links = names(raw.links, "deprecated.links");
+        for (const label of result.links)
+            if (!kind.links || !Object.hasOwn(kind.links, label))
+                fail(`deprecated.links.${label}`, "expected an existing outbound label");
+    }
+    if (problems.length) {
+        result.problems = problems;
+        result.raw = structuredClone(raw);
+    }
+    return result;
+}
+/** Eligibility that needs the whole explicitly admitted registry, without foreign reads. */
+export function kindDeprecationProblems(kind, registry) {
+    const problems = [...(kind.deprecated?.problems ?? [])];
+    for (const label of kind.deprecated?.links ?? []) {
+        if ([...(registry?.kinds.values() ?? [kind])].some(k => k.expectsInbound && Object.hasOwn(k.expectsInbound, label))) {
+            problems.push(problem(`deprecated.links.${label}`, "the admitted registry still declares an inbound expectation for this label"));
+        }
+    }
+    return problems;
+}
+/** Stored deprecated usage is information, deliberately separate from ordinary strict conformance. */
+export function inspectKindDeprecatedUsage(doc, kind) {
+    if (!kind.deprecated)
+        return [];
+    const rows = new Map();
+    const add = (code, field, identity, unknown = false) => {
+        const key = JSON.stringify([code, field, ...identity]);
+        const previous = rows.get(key);
+        if (previous)
+            previous.count += 1;
+        else
+            rows.set(key, { code, field, identity: key, count: 1, ...(code === "KIND_DEPRECATED_VALUE" ? { value: String(identity[0]) } : {}), ...(unknown ? { unknown: true } : {}) });
+    };
+    for (const field of kind.deprecated.fields)
+        if (Object.hasOwn(doc.frontmatter, field))
+            add("KIND_DEPRECATED_FIELD", field, ["field"]);
+    for (const [field, values] of Object.entries(kind.deprecated.values)) {
+        if (!Object.hasOwn(doc.frontmatter, field))
+            continue;
+        const raw = doc.frontmatter[field];
+        if (raw === null || raw === undefined)
+            continue;
+        for (const value of Array.isArray(raw) ? raw : [raw])
+            if (values.includes(String(value)))
+                add("KIND_DEPRECATED_VALUE", field, [String(value)]);
+    }
+    if (kind.deprecated.links.length) {
+        for (const edge of parseLinksFromDoc(doc))
+            if (kind.deprecated.links.includes(edge.text))
+                add("KIND_DEPRECATED_LINK", edge.text, ["local", edge.to, edge.text]);
+        for (const edge of parseQualifiedLinks(doc))
+            if (kind.deprecated.links.includes(edge.text)) {
+                if (edge.ref)
+                    add("KIND_DEPRECATED_LINK", edge.text, ["qualified", edge.ref.alias, edge.ref.id, edge.text]);
+                else
+                    add("KIND_DEPRECATED_LINK", edge.text, ["malformed-qualified", edge.href, edge.text], true);
+            }
+    }
+    return [...rows.values()].sort((a, b) => a.identity < b.identity ? -1 : a.identity > b.identity ? 1 : 0);
+}
+/** One transition authority shared by every admitted mutation posture and each fresh CAS head. */
+export function kindDeprecationTransition(existing, candidate, registry) {
+    const kind = registry.kinds.get(String(candidate.frontmatter.type));
+    if (!kind?.deprecated)
+        return [];
+    const invalid = kindDeprecationProblems(kind, registry);
+    if (invalid.length)
+        return invalid;
+    const previous = existing?.id === candidate.id && existing.frontmatter.type === candidate.frontmatter.type ? existing : undefined;
+    const oldRows = new Map((previous ? inspectKindDeprecatedUsage(previous, kind) : []).map(row => [row.identity, row]));
+    return inspectKindDeprecatedUsage(candidate, kind).filter(row => {
+        if (row.code === "KIND_DEPRECATED_FIELD")
+            return !previous || !Object.hasOwn(previous.frontmatter, row.field)
+                || !okfValuesEqual(previous.frontmatter[row.field], candidate.frontmatter[row.field]);
+        return row.count > (oldRows.get(row.identity)?.count ?? 0);
+    }).map(row => ({ code: row.code, field: row.field,
+        message: `'${kind.governs}' declaration '${row.field}' is deprecated; preserve unchanged existing usage or remove it, but do not introduce or change deprecated usage (see ${kind.id}).`, severity: "warning" }));
+}
+//# sourceMappingURL=kind-deprecation.js.map

package/dist/kind-deprecation.js.map

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

package/dist/kind-field-mutation.d.ts

@@ -1,3 +1,5 @@
+/** Pure Kind schema editing. The mutation engine supplies the fresh convention. */
+import { type KindFieldType } from "./kinds.js";
 import { InvalidInputError } from "./errors.js";
 import type { OkfDocument } from "./types.js";
 import type { DocumentMutationCandidate } from "./document-mutation.js";
@@ -9,6 +11,8 @@ export interface KindFieldMutation {
     action: "add" | "remove";
     required?: boolean;
     values?: string[];
+    /** Declare the field's value type in `fields.types` (add only). Changes the declaration, never instances. */
+    type?: KindFieldType;
     okfVersion: "0.1" | "0.2";
 }
 export declare function prepareKindFieldMutation(existing: OkfDocument, input: KindFieldMutation, okfVersion: "0.1" | "0.2"): DocumentMutationCandidate;

package/dist/kind-field-mutation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kind-field-mutation.d.ts","sourceRoot":"","sources":["../src/kind-field-mutation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,qBAAa,yBAA0B,SAAQ,iBAAiB;CAAG;AACnE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,KAAK,GAAG,KAAK,CAAC;CAC3B;AA+BD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,KAAK,GAAG,KAAK,GAAG,yBAAyB,CA4G9I"}
+{"version":3,"file":"kind-field-mutation.d.ts","sourceRoot":"","sources":["../src/kind-field-mutation.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,OAAO,EAA8C,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,qBAAa,yBAA0B,SAAQ,iBAAiB;CAAG;AACnE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,6GAA6G;IAC7G,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,KAAK,GAAG,KAAK,CAAC;CAC3B;AA+BD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,KAAK,GAAG,KAAK,GAAG,yBAAyB,CAiI9I"}