@sixb/core 0.0.1

package/dist/logging/types.d.ts

@@ -0,0 +1,82 @@
+import { type JsonValue } from "../json";
+/** Log severity, ordered `debug < info < warn < error`. */
+export declare const LOG_LEVELS: readonly ["debug", "info", "warn", "error"];
+export type LogLevel = (typeof LOG_LEVELS)[number];
+/** Structured, JSON-serializable fields attached by project code. */
+export type LogFields = Record<string, JsonValue>;
+/**
+ * The logger surface exposed to project handlers.
+ *
+ * Calls are deliberately fire-and-forget: logging must never fail a handler.
+ * `child()` only binds user fields; framework-owned context stays immutable.
+ */
+export interface Logger {
+    debug(message: string, fields?: LogFields): void;
+    info(message: string, fields?: LogFields): void;
+    warn(message: string, fields?: LogFields): void;
+    error(message: string | Error, fields?: LogFields): void;
+    child(bindings: LogFields): Logger;
+}
+/**
+ * Every kind of run Sixb records on a project's behalf.
+ *
+ * This is the one list: log lines, failed-run reports, and log stream selectors all name their
+ * producer from here. A kind is listed as soon as the run record exists, even when nothing writes logs
+ * for it yet — adding a writer later is additive, widening this union is not.
+ *
+ * The test is whether the thing has a run with an id. Rules do not: they are evaluated live, per
+ * subject, and Sixb keeps no record of an evaluation, which is why they are absent here and report
+ * through `SixbRuleEvaluationFailedContext` instead.
+ */
+export declare const SIXB_RUN_KINDS: readonly ["action", "agent", "pipeline", "projection", "sync", "webhook", "workflow"];
+export type SixbRunKind = (typeof SIXB_RUN_KINDS)[number];
+/** Points a log line back at the run that produced it. */
+export interface LogRunRef {
+    readonly kind: SixbRunKind;
+    readonly id: string;
+}
+/** Framework-owned metadata. It cannot be overwritten through `Logger.child()`. */
+export interface LogContext {
+    readonly run: LogRunRef;
+    readonly stepId?: string;
+    readonly phase?: string;
+    readonly attempt?: number;
+}
+/** One complete entry sent to the configured output provider. */
+export interface LogEntry {
+    readonly level: LogLevel;
+    readonly message: string;
+    readonly fields?: LogFields;
+    /** ISO-8601 emission timestamp. */
+    readonly at: string;
+    readonly context: LogContext;
+}
+/** One sanitized, bounded log line stored in the `__logs` broker stream. */
+export type LogRecord = LogEntry;
+/** A broker-backed log line tagged with its opaque stream cursor. */
+export type StoredLogLine = LogRecord & {
+    readonly cursor: string;
+};
+/**
+ * Process-level output destination. Providers own their lifecycle; handlers
+ * only receive the narrower {@link Logger} façade.
+ */
+export interface LoggerProvider {
+    write(entry: LogEntry): void;
+    flush?(): void | Promise<void>;
+    close?(): void | Promise<void>;
+}
+/** True when `level` meets or exceeds the `threshold`. */
+export declare function isLevelEnabled(level: LogLevel, threshold: LogLevel): boolean;
+/** Every log level at or above the threshold, in ascending severity order. */
+export declare function logLevelsAtOrAbove(threshold: LogLevel): readonly LogLevel[];
+export declare function isLogLevel(value: unknown): value is LogLevel;
+export declare function isSixbRunKind(value: unknown): value is SixbRunKind;
+export declare function isLogRecord(value: unknown): value is LogRecord;
+export declare function isStoredLogLine(value: unknown): value is StoredLogLine;
+/** Normalize an `error(message | Error)` call into a string message + fields. */
+export declare function normalizeLogError(message: string | Error, fields?: LogFields): {
+    message: string;
+    fields?: LogFields;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/logging/types.d.ts.map

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

package/dist/logging/types.js

@@ -0,0 +1,27 @@
+// @bun
+import {
+  LOG_LEVELS,
+  SIXB_RUN_KINDS,
+  isLevelEnabled,
+  isLogLevel,
+  isLogRecord,
+  isSixbRunKind,
+  isStoredLogLine,
+  logLevelsAtOrAbove,
+  normalizeLogError
+} from "../chunk-5yny9z0e.js";
+import"../chunk-1vffvydj.js";
+import"../chunk-y64skrwp.js";
+export {
+  normalizeLogError,
+  logLevelsAtOrAbove,
+  isStoredLogLine,
+  isSixbRunKind,
+  isLogRecord,
+  isLogLevel,
+  isLevelEnabled,
+  SIXB_RUN_KINDS,
+  LOG_LEVELS
+};
+
+//# debugId=D289D8C8B2B206A964756E2164756E21

package/dist/logging/types.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "D289D8C8B2B206A964756E2164756E21",
+  "names": []
+}

package/dist/maintenance/index.d.ts

@@ -0,0 +1,3 @@
+export { OntologyMaintenance } from "./ontology-maintenance";
+export type { OntologyMaintenanceCleanupSnapshot, OntologyMaintenanceHandle, OntologyMaintenanceOptions, OntologyMaintenanceSnapshot, OntologyOperationalStatus, SixbReadiness, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/maintenance/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/maintenance/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAC5D,YAAY,EACV,kCAAkC,EAClC,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,aAAa,GACd,MAAM,SAAS,CAAA"}

package/dist/maintenance/ontology-maintenance.d.ts

@@ -0,0 +1,48 @@
+import type { OntologyOutboxDispatcher } from "../events";
+import type { Storage } from "../storage";
+import type { OntologyMaintenanceHandle, OntologyMaintenanceOptions, OntologyMaintenanceSnapshot, OntologyOperationalStatus } from "./types";
+interface OntologyMaintenanceDependencies {
+    readonly projectId: string;
+    readonly storage: Storage;
+    readonly dispatcher: OntologyOutboxDispatcher;
+    readonly options?: OntologyMaintenanceOptions;
+    readonly now?: () => Date;
+    readonly onError?: (error: unknown) => void;
+}
+/** API-owned catch-up, retention, and operational snapshot lifecycle. */
+export declare class OntologyMaintenance {
+    private readonly projectId;
+    private readonly storage;
+    private readonly dispatcher;
+    private readonly intervalMs;
+    private readonly publishedOutboxRetentionMs;
+    private readonly terminalSourceRetentionMs;
+    private readonly cleanupLimit;
+    private readonly shutdownTimeoutMs;
+    private readonly now;
+    private readonly onError;
+    private readonly owners;
+    private timer;
+    private pass;
+    private stopping;
+    private snapshot;
+    constructor(dependencies: OntologyMaintenanceDependencies);
+    /** Acquires maintenance ownership and starts catch-up without blocking the host from listening. */
+    start(): Promise<OntologyMaintenanceHandle>;
+    /** Runs one coalesced pass. Exposed for deterministic hosting and tests. */
+    runNow(): Promise<void>;
+    /** Force-stops every owner; used during provider shutdown. */
+    stop(): Promise<void>;
+    getSnapshot(): OntologyMaintenanceSnapshot;
+    getOperationalStatus(): OntologyOperationalStatus;
+    private startHostedPass;
+    private runPass;
+    private cleanupExpiredRows;
+    private readOperationalSummaries;
+    private completePass;
+    private scheduleNextPass;
+    private stopLoop;
+    private reportError;
+}
+export {};
+//# sourceMappingURL=ontology-maintenance.d.ts.map

package/dist/maintenance/ontology-maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ontology-maintenance.d.ts","sourceRoot":"","sources":["../../src/maintenance/ontology-maintenance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAA;AACzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAEV,yBAAyB,EACzB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EAC1B,MAAM,SAAS,CAAA;AAShB,UAAU,+BAA+B;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAA;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B,CAAA;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CAC5C;AAED,yEAAyE;AACzE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IACnC,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAQ;IACnD,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAQ;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAQ;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,IAAI,CAA6B;IACzC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,QAAQ,CAA6B;gBAEjC,YAAY,EAAE,+BAA+B;IA8BzD,mGAAmG;IAC7F,KAAK,IAAI,OAAO,CAAC,yBAAyB,CAAC;IAkBjD,4EAA4E;IAC5E,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvB,8DAA8D;IACxD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,WAAW,IAAI,2BAA2B;IAI1C,oBAAoB,IAAI,yBAAyB;IAmBjD,OAAO,CAAC,eAAe;YAMT,OAAO;YAWP,kBAAkB;YAoClB,wBAAwB;IAiBtC,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,QAAQ;IAoBhB,OAAO,CAAC,WAAW;CAOpB"}

package/dist/maintenance/types.d.ts

@@ -0,0 +1,53 @@
+export interface OntologyMaintenanceOptions {
+    /** Delay between completed passes. Defaults to 60 seconds. */
+    readonly intervalMs?: number;
+    /** Published outbox retention. Defaults to 24 hours. */
+    readonly publishedOutboxRetentionMs?: number;
+    /** Superseded/abandoned source retention. Defaults to 24 hours. */
+    readonly terminalSourceRetentionMs?: number;
+    /** Maximum deletions attempted per cleanup domain and pass. Defaults to 1,000. */
+    readonly cleanupLimit?: number;
+    /** Maximum time to wait for an active pass during shutdown. Defaults to 30 seconds. */
+    readonly shutdownTimeoutMs?: number;
+}
+export interface OntologyMaintenanceCleanupSnapshot {
+    readonly publishedOutboxRowsDeleted: number;
+    readonly terminalSourceRowsDeleted: number;
+    readonly terminalSourceMaterializationsDeleted: number;
+}
+export interface OntologyMaintenanceSnapshot {
+    readonly running: boolean;
+    readonly intervalMs: number;
+    readonly lastStartedAt: string | null;
+    readonly lastCompletedAt: string | null;
+    readonly lastDurationMs: number | null;
+    readonly consecutiveFailures: number;
+    readonly lastError: string | null;
+    readonly outbox: {
+        readonly pendingCount: number;
+        readonly oldestPendingAt: string | null;
+        readonly retryingCount: number;
+        readonly maxAttempts: number;
+    } | null;
+    readonly terminalSources: {
+        readonly count: number;
+        readonly oldestTerminalAt: string | null;
+    } | null;
+    readonly cleanup: OntologyMaintenanceCleanupSnapshot | null;
+}
+export interface OntologyMaintenanceHandle {
+    stop(): Promise<void>;
+}
+export interface OntologyOperationalStatus {
+    readonly status: "ok" | "degraded";
+    readonly maintenance: OntologyMaintenanceSnapshot;
+}
+export interface SixbReadiness {
+    readonly status: "ready" | "unready";
+    readonly storage: {
+        readonly reachable: boolean;
+        readonly schemaValid: boolean;
+    };
+    readonly reason?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/maintenance/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/maintenance/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,0BAA0B,CAAC,EAAE,MAAM,CAAA;IAC5C,mEAAmE;IACnE,QAAQ,CAAC,yBAAyB,CAAC,EAAE,MAAM,CAAA;IAC3C,kFAAkF;IAClF,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CACpC;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAA;IAC3C,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAA;IAC1C,QAAQ,CAAC,qCAAqC,EAAE,MAAM,CAAA;CACvD;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;QAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;QACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;QAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAC7B,GAAG,IAAI,CAAA;IACR,QAAQ,CAAC,eAAe,EAAE;QACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;QACtB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;KACzC,GAAG,IAAI,CAAA;IACR,QAAQ,CAAC,OAAO,EAAE,kCAAkC,GAAG,IAAI,CAAA;CAC5D;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,UAAU,CAAA;IAClC,QAAQ,CAAC,WAAW,EAAE,2BAA2B,CAAA;CAClD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;QAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;KAC9B,CAAA;IACD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB"}

package/dist/materialization/dataset-watermark.d.ts

@@ -0,0 +1,5 @@
+import type { PinnedDatasetVersion } from "./model";
+export type PinnedDatasetWatermarkConflict = "dataset-mismatch" | "version-metadata-mismatch" | "older-version" | "ambiguous-version";
+export declare function comparePinnedDatasetWatermarks(active: PinnedDatasetVersion, next: PinnedDatasetVersion): PinnedDatasetWatermarkConflict | null;
+export declare function assertPinnedDatasetWatermark(active: PinnedDatasetVersion, next: PinnedDatasetVersion, subject: string): void;
+//# sourceMappingURL=dataset-watermark.d.ts.map

package/dist/materialization/dataset-watermark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-watermark.d.ts","sourceRoot":"","sources":["../../src/materialization/dataset-watermark.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAEnD,MAAM,MAAM,8BAA8B,GACtC,kBAAkB,GAClB,2BAA2B,GAC3B,eAAe,GACf,mBAAmB,CAAA;AAEvB,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,oBAAoB,GACzB,8BAA8B,GAAG,IAAI,CAWvC;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,GACd,IAAI,CAMN"}

package/dist/materialization/errors.d.ts

@@ -0,0 +1,37 @@
+import { OntologyValidationError } from "../ontology/errors";
+export type MaterializationConflictKind = "idempotency" | "projection-fence" | "source-materialization" | "execution-lost" | "run-correlation" | "effective-state" | "timeseries-point" | "outbox-lease";
+/**
+ * A validation failure raised inside the Materializer.
+ *
+ * Extends `OntologyValidationError` because it is the same class of failure a caller already
+ * handles: batch writes surface it rewrapped as one, so a single write must not require a second
+ * `instanceof` branch to catch the identical error.
+ */
+export declare class MaterializationValidationError extends OntologyValidationError {
+    readonly name: string;
+    constructor(message: string);
+}
+/** Structured missing-object failure raised by Materializer telemetry validation. */
+export declare class MaterializationObjectNotFoundError extends MaterializationValidationError {
+    readonly objectTypeId: string;
+    readonly primaryId: string;
+    readonly name = "MaterializationObjectNotFoundError";
+    constructor(objectTypeId: string, primaryId: string);
+}
+/**
+ * Abort reason for an explicit, terminal cancellation of a materialization.
+ *
+ * Generic aborts (worker shutdown, delivery loss, timeout) remain retryable and preserve staged
+ * source state. Passing this error as an AbortSignal reason authorizes that state to be abandoned.
+ */
+export declare class MaterializationCancellationError extends Error {
+    readonly name = "AbortError";
+    constructor(message?: string, options?: ErrorOptions);
+}
+export declare class MaterializationConflictError extends Error {
+    readonly kind: MaterializationConflictKind;
+    readonly name: string;
+    constructor(kind: MaterializationConflictKind, message: string);
+}
+export declare function isMaterializationConflictError(error: unknown): error is MaterializationConflictError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/materialization/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/materialization/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAE5D,MAAM,MAAM,2BAA2B,GACnC,aAAa,GACb,kBAAkB,GAClB,wBAAwB,GACxB,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,GACjB,kBAAkB,GAClB,cAAc,CAAA;AAMlB;;;;;;GAMG;AACH,qBAAa,8BAA+B,SAAQ,uBAAuB;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAmC;gBAE5C,OAAO,EAAE,MAAM;CAG5B;AAED,qFAAqF;AACrF,qBAAa,kCAAmC,SAAQ,8BAA8B;IAIlF,QAAQ,CAAC,YAAY,EAAE,MAAM;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM;IAJ5B,SAAkB,IAAI,wCAAuC;gBAGlD,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM;CAI7B;AAED;;;;;GAKG;AACH,qBAAa,gCAAiC,SAAQ,KAAK;IACzD,QAAQ,CAAC,IAAI,gBAAe;gBAEhB,OAAO,SAA0C,EAAE,OAAO,CAAC,EAAE,YAAY;CAGtF;AAED,qBAAa,4BAA6B,SAAQ,KAAK;IAInD,QAAQ,CAAC,IAAI,EAAE,2BAA2B;IAH5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAiC;gBAG3C,IAAI,EAAE,2BAA2B,EAC1C,OAAO,EAAE,MAAM;CAIlB;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,4BAA4B,CAEvC"}

package/dist/materialization/events.d.ts

@@ -0,0 +1,57 @@
+import type { EventActor } from "../events/envelope";
+import type { LinkDeletedEventPayload, LinkMutationEventPayload } from "../events/types/links";
+import type { ObjectDeletedEventPayload, ObjectMutationEventPayload } from "../events/types/objects";
+import type { TelemetryAppendedEventPayload } from "../events/types/telemetry";
+import type { JsonValue } from "../json";
+import type { OntologyMaterializationOrigin, OntologyMaterializationPropertyChangeMap } from "./model";
+interface OntologyMaterializationEventBase {
+    readonly id: string;
+    readonly schemaVersion: 1;
+    readonly projectId: string;
+    readonly occurredAt: string;
+    readonly actor?: EventActor;
+    readonly origin: OntologyMaterializationOrigin;
+    readonly commitId: string;
+    readonly commitOrdinal: number;
+    readonly partitionKey: string;
+}
+interface ReadonlyMaterializationPropertyChanges {
+    readonly propertyChanges: OntologyMaterializationPropertyChangeMap;
+}
+type ReadonlyDeletedMaterializationPayload<TPayload> = Readonly<Omit<TPayload, "propertyChanges"> & ReadonlyMaterializationPropertyChanges>;
+type ReadonlyObjectMutationMaterializationPayload = Readonly<Omit<ObjectMutationEventPayload<JsonValue>, "properties" | "propertyChanges"> & ReadonlyMaterializationPropertyChanges & {
+    readonly properties: Readonly<Record<string, JsonValue>>;
+}>;
+type ReadonlyLinkMutationMaterializationPayload = Readonly<Omit<LinkMutationEventPayload<JsonValue>, "properties" | "propertyChanges"> & ReadonlyMaterializationPropertyChanges & {
+    readonly properties?: Readonly<Record<string, JsonValue>>;
+}>;
+type OntologyObjectMaterializationEvent = OntologyMaterializationEventBase & ({
+    readonly type: "object.created" | "object.updated";
+    readonly topic: "objects";
+    readonly payload: ReadonlyObjectMutationMaterializationPayload;
+} | {
+    readonly type: "object.deleted";
+    readonly topic: "objects";
+    readonly payload: ReadonlyDeletedMaterializationPayload<ObjectDeletedEventPayload<JsonValue>>;
+});
+type OntologyLinkMaterializationEvent = OntologyMaterializationEventBase & ({
+    readonly type: "link.created" | "link.updated";
+    readonly topic: "links";
+    readonly payload: ReadonlyLinkMutationMaterializationPayload;
+} | {
+    readonly type: "link.deleted";
+    readonly topic: "links";
+    readonly payload: ReadonlyDeletedMaterializationPayload<LinkDeletedEventPayload<JsonValue>>;
+});
+type OntologyTelemetryMaterializationEvent = OntologyMaterializationEventBase & {
+    readonly type: "telemetry.appended";
+    readonly topic: "telemetry";
+    readonly payload: Readonly<TelemetryAppendedEventPayload<JsonValue>>;
+};
+/** Exact JSON-safe domain event stored transactionally before broker publication. */
+export type OntologyMaterializationEvent = OntologyObjectMaterializationEvent | OntologyLinkMaterializationEvent | OntologyTelemetryMaterializationEvent;
+type WithoutEventSequence<T> = T extends OntologyMaterializationEvent ? Omit<T, "id" | "commitOrdinal"> : never;
+/** Complete core-authored event fact before contiguous commit sequencing is assigned. */
+export type OntologyMaterializationEventDraft = WithoutEventSequence<OntologyMaterializationEvent>;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/dist/materialization/events.d.ts.map

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

package/dist/materialization/identity.d.ts

@@ -0,0 +1,8 @@
+export declare const ONTOLOGY_MATERIALIZATION_EVENT_KIND_ORDER: readonly ["object.created", "object.updated", "object.deleted", "link.created", "link.updated", "link.deleted", "telemetry.appended"];
+export type OntologyMaterializationEventKind = (typeof ONTOLOGY_MATERIALIZATION_EVENT_KIND_ORDER)[number];
+export declare function materializationEventKindOrdinal(kind: OntologyMaterializationEventKind): number;
+export declare function sha256Canonical(value: unknown): string;
+export declare function createRequestHash(normalizedCallerIntent: unknown): string;
+export declare function createCommitId(projectId: string, idempotencyKey: string): string;
+export declare function createEventId(projectId: string, commitId: string, ordinal: number): string;
+//# sourceMappingURL=identity.d.ts.map

package/dist/materialization/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/materialization/identity.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,yCAAyC,uIAQ3C,CAAA;AAEX,MAAM,MAAM,gCAAgC,GAC1C,CAAC,OAAO,yCAAyC,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,gCAAgC,GAAG,MAAM,CAE9F;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGtD;AAED,wBAAgB,iBAAiB,CAAC,sBAAsB,EAAE,OAAO,GAAG,MAAM,CAEzE;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1F"}

package/dist/materialization/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Provider-neutral ontology materialization contracts.
+ *
+ * @internal Repository packages only. Application orchestration belongs to `materializer`; storage
+ * adapters may depend on this module without depending on that application layer.
+ */
+export { assertPinnedDatasetWatermark, comparePinnedDatasetWatermarks, } from "./dataset-watermark";
+export type { MaterializationConflictKind } from "./errors";
+export { isMaterializationConflictError, MaterializationCancellationError, MaterializationConflictError, MaterializationObjectNotFoundError, MaterializationValidationError, } from "./errors";
+export type { OntologyMaterializationEvent, OntologyMaterializationEventDraft } from "./events";
+export type { BaseCommitResult, EditCommitResult, EffectiveChangeCounts, EffectiveLinkChange, EffectiveLinkSnapshot, EffectiveObjectChange, EffectiveObjectSnapshot, ExpectedLinkRevision, ExpectedLinkScopeRevision, ExpectedObjectRevision, LinkOverride, MaterializationItemError, ObjectOverride, OntologyEditCommit, OntologyEditOperation, OntologyLinkRef, OntologyMaterializationOrigin, OntologyMaterializationPropertyChange, OntologyMaterializationPropertyChangeMap, OntologyObjectRef, OntologyOperationOutcome, PinnedDatasetVersion, ProjectionCommitResult, ProjectionEntityRef, ProjectionExecution, ProjectionMaterializationIdentity, ProjectionProtocolIdentity, ProjectionRunFinishInput, ProjectionRunTerminalDecision, ProjectionSourceAssertion, ProjectionSourceEntry, ProjectionSourceRef, ProjectionSourceReplacement, TelemetryAppend, TelemetryCommitResult, TelemetryPointWrite, TelemetrySeriesRef, } from "./model";
+export { canonicalIdentitySortKey, compareLinkRefs, compareObjectRefs, linkRefKey, linkRefSortKey, linkScopeSortKey, normalizeLinkRef, normalizeObjectRef, objectRefKey, objectRefSortKey, projectionEntityKey, telemetryPointKey, telemetryPointSortKey, telemetrySeriesKey, } from "./refs";
+//# sourceMappingURL=index.d.ts.map

package/dist/materialization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/materialization/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAA;AAC3D,OAAO,EACL,8BAA8B,EAC9B,gCAAgC,EAChC,4BAA4B,EAC5B,kCAAkC,EAClC,8BAA8B,GAC/B,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,4BAA4B,EAAE,iCAAiC,EAAE,MAAM,UAAU,CAAA;AAC/F,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,YAAY,EACZ,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,6BAA6B,EAC7B,qCAAqC,EACrC,wCAAwC,EACxC,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,iCAAiC,EACjC,0BAA0B,EAC1B,wBAAwB,EACxB,6BAA6B,EAC7B,yBAAyB,EACzB,qBAAqB,EACrB,mBAAmB,EACnB,2BAA2B,EAC3B,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,QAAQ,CAAA"}

package/dist/materialization/index.js

@@ -0,0 +1,56 @@
+// @bun
+import {
+  assertPinnedDatasetWatermark,
+  comparePinnedDatasetWatermarks
+} from "../chunk-9dzba0f2.js";
+import {
+  canonicalIdentitySortKey,
+  compareLinkRefs,
+  compareObjectRefs,
+  linkRefKey,
+  linkRefSortKey,
+  linkScopeSortKey,
+  normalizeLinkRef,
+  normalizeObjectRef,
+  objectRefKey,
+  objectRefSortKey,
+  projectionEntityKey,
+  telemetryPointKey,
+  telemetryPointSortKey,
+  telemetrySeriesKey
+} from "../chunk-p6r5g77m.js";
+import {
+  MaterializationCancellationError,
+  MaterializationConflictError,
+  MaterializationObjectNotFoundError,
+  MaterializationValidationError,
+  isMaterializationConflictError
+} from "../chunk-ry24jbr1.js";
+import"../chunk-dktq02ne.js";
+import"../chunk-1vffvydj.js";
+import"../chunk-y64skrwp.js";
+export {
+  telemetrySeriesKey,
+  telemetryPointSortKey,
+  telemetryPointKey,
+  projectionEntityKey,
+  objectRefSortKey,
+  objectRefKey,
+  normalizeObjectRef,
+  normalizeLinkRef,
+  linkScopeSortKey,
+  linkRefSortKey,
+  linkRefKey,
+  isMaterializationConflictError,
+  comparePinnedDatasetWatermarks,
+  compareObjectRefs,
+  compareLinkRefs,
+  canonicalIdentitySortKey,
+  assertPinnedDatasetWatermark,
+  MaterializationValidationError,
+  MaterializationObjectNotFoundError,
+  MaterializationConflictError,
+  MaterializationCancellationError
+};
+
+//# debugId=24B1097CFBE59B2E64756E2164756E21

package/dist/materialization/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "24B1097CFBE59B2E64756E2164756E21",
+  "names": []
+}