@sixb/core 0.0.1

package/dist/storage/migrations/types.d.ts

@@ -0,0 +1,115 @@
+import type { Storage } from "../types";
+export interface MigrationStepInfo {
+    readonly id: string;
+    readonly version: number;
+    readonly name: string;
+    readonly checksum?: string;
+}
+/** One forward-only schema change owned by a durable adapter. */
+export interface MigrationStep<TContext> extends MigrationStepInfo {
+    up(context: TContext): void | Promise<void>;
+}
+export interface MigrationStepOptions {
+    readonly checksum?: string;
+}
+export interface MigrationSet<TContext> {
+    readonly adapterId: string;
+    readonly latestVersion: number;
+    readonly steps: readonly MigrationStep<TContext>[];
+}
+export interface DefineMigrationsOptions<TContext> {
+    readonly adapterId: string;
+    readonly steps: readonly MigrationStep<TContext>[];
+}
+export interface MigrationRecord {
+    readonly adapterId: string;
+    readonly version: number;
+    readonly id: string;
+    readonly checksum?: string;
+    readonly status: "started" | "applied";
+    readonly startedAt: string;
+    readonly finishedAt?: string;
+}
+export interface MigrationHistoryStore {
+    ensure(): void | Promise<void>;
+    readHistory(adapterId: string): readonly MigrationRecord[] | Promise<readonly MigrationRecord[]>;
+    markStarted(adapterId: string, step: MigrationStepInfo, at: string): void | Promise<void>;
+    markApplied(adapterId: string, step: MigrationStepInfo, at: string): void | Promise<void>;
+    transaction<T>(run: () => Promise<T>): Promise<T>;
+}
+export interface MigrationPlan<TContext> {
+    readonly adapterId: string;
+    readonly latestVersion: number;
+    readonly applied: readonly MigrationRecord[];
+    readonly pending: readonly MigrationStep<TContext>[];
+}
+export interface MigrationReport {
+    readonly adapterId: string;
+    readonly latestVersion: number;
+    readonly status: "current" | "migrated";
+    readonly applied: readonly string[];
+    readonly skipped: readonly string[];
+}
+/**
+ * Grouped by what an operator has to do about it: nothing (`current`), run
+ * `sixb db migrate` (`uninitialized`, `pending`), or intervene by hand (the rest).
+ *
+ * There is no state for "the history could not be read": an unreachable database, a missing
+ * grant or a corrupt table all throw out of the read, and the probe reports that reason.
+ */
+export type MigrationState = 
+/** Every known migration is applied. The only state a host should serve traffic in. */
+"current"
+/** No migration history exists yet: an empty database, or one never migrated. */
+ | "uninitialized"
+/** History is a valid prefix of this build's migrations, but incomplete. */
+ | "pending"
+/** The database has versions this build does not know — usually an app rolled back without its schema. */
+ | "ahead"
+/** A migration recorded a start and never an end. */
+ | "dirty"
+/** History contradicts the declared migrations: changed checksum, mismatched id, duplicate version, foreign adapter. */
+ | "incompatible";
+interface MigrationStatusBase {
+    readonly adapterId: string;
+    readonly latestVersion: number;
+    /** Highest applied version; 0 when no history exists. */
+    readonly appliedVersion: number;
+}
+/**
+ * A state, and the reason for it when there is one to give.
+ *
+ * A union rather than an optional field, which accepted `current` with a reason and `dirty`
+ * without one. Every state but `current` exists because an operator has to act.
+ */
+export type MigrationStatus = (MigrationStatusBase & {
+    readonly state: "current";
+    readonly reason?: never;
+}) | (MigrationStatusBase & {
+    readonly state: Exclude<MigrationState, "current">;
+    /** What an operator has to do about it. */
+    readonly reason: string;
+});
+export interface StorageMigrator {
+    readonly adapterId: string;
+    readonly latestVersion: number;
+    /**
+     * Reports the schema state without touching it.
+     *
+     * Strictly read-only, unlike `migrate()`, which calls `ensure()` first and so runs DDL.
+     * `/ready` is unauthenticated, and a least-privilege deployment has no DDL grant to spend on
+     * a health check. Reports the dangerous states (`ahead`, `dirty`) rather than throwing.
+     */
+    status(): Promise<MigrationStatus>;
+    migrate(): Promise<MigrationReport>;
+}
+/** Optional storage capability for startup/CLI-driven schema migration. */
+export interface MigrationCapableStorage extends Storage {
+    readonly migrators: readonly StorageMigrator[];
+}
+export interface StorageMigrationResult {
+    readonly status: "migrated" | "current" | "skipped";
+    readonly reports: readonly MigrationReport[];
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/storage/migrations/types.d.ts.map

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

package/dist/storage/objects/in-memory.d.ts

@@ -0,0 +1,126 @@
+import type { EffectiveLinkSnapshot, EffectiveObjectSnapshot } from "../../materialization/model";
+import type { CountObjectsInput, CountObjectsResult, ExistsObjectsInput, ExistsObjectsResult, FacetObjectsInput, FacetObjectsResult, LinkDirection, ObjectLinkRow, ObjectQueryCapabilities, ObjectRow, ObjectStorage, QueryObjectsInput, QueryObjectsResult } from "./types";
+export interface InMemoryObjectStorageSnapshot {
+    readonly rows: Map<string, Map<string, ObjectRow>>;
+    readonly links: Map<string, Map<string, ObjectLinkRow>>;
+}
+interface InMemoryObjectMaterializerAdapter {
+    getExactObjectRow(projectId: string, objectTypeId: string, primaryId: string): ObjectRow | null;
+    getExactLinkRow(projectId: string, ref: {
+        readonly sourceTypeId: string;
+        readonly sourceId: string;
+        readonly linkId: string;
+        readonly targetTypeId: string;
+        readonly targetId: string;
+    }): ObjectLinkRow | null;
+    applyExactObject(row: EffectiveObjectSnapshot, projectId: string): void;
+    deleteExactObject(projectId: string, objectTypeId: string, primaryId: string): void;
+    applyExactLink(row: EffectiveLinkSnapshot, projectId: string): void;
+    deleteExactLink(row: {
+        projectId: string;
+        sourceTypeId: string;
+        sourceId: string;
+        linkId: string;
+        targetTypeId: string;
+        targetId: string;
+    }): void;
+    visitExactLinks(projectId: string, visit: (row: ObjectLinkRow) => void): void;
+    visitExactScopeLinks(projectId: string, sourceTypeId: string, sourceId: string, linkId: string, visit: (row: ObjectLinkRow) => void): void;
+}
+/** @internal Exact access for the in-memory ontology provider; not exported from package barrels. */
+export declare function getInMemoryObjectMaterializerAdapter(storage: InMemoryObjectStorage): InMemoryObjectMaterializerAdapter;
+export declare class InMemoryObjectStorage implements ObjectStorage {
+    private readonly rows;
+    private readonly links;
+    constructor();
+    snapshot(): InMemoryObjectStorageSnapshot;
+    restore(snapshot: InMemoryObjectStorageSnapshot): void;
+    private getExactObjectRow;
+    private getExactLinkRow;
+    private applyExactObject;
+    private deleteExactObject;
+    private applyExactLink;
+    private deleteExactLink;
+    queryCapabilities(): ObjectQueryCapabilities;
+    queryObjects(params: QueryObjectsInput): Promise<QueryObjectsResult>;
+    countObjects(params: CountObjectsInput): Promise<CountObjectsResult>;
+    existsObjects(params: ExistsObjectsInput): Promise<ExistsObjectsResult>;
+    facetObjects(params: FacetObjectsInput): Promise<FacetObjectsResult>;
+    private evaluateObjectQuery;
+    private evaluateStart;
+    private evaluateSet;
+    private traverseOutgoing;
+    private traverseIncoming;
+    /**
+     * Reads return the *live* stored row by reference (the SQL providers detach a copy via JSON
+     * round-trip). Callers must treat read results as immutable: mutating a returned row mutates the
+     * store in place — including after the transaction that read it has completed, which escapes the
+     * transaction guard. Internal call sites (e.g. the EditBatch planner) already copy before
+     * mutating; external callers must do the same.
+     */
+    getByPrimaryId(params: {
+        projectId: string;
+        objectTypeId: string;
+        primaryId: string;
+    }): Promise<ObjectRow | null>;
+    listLinks(params: {
+        projectId: string;
+        objectTypeId: string;
+        objectId: string;
+        linkId?: string;
+        direction?: LinkDirection;
+    }): Promise<readonly ObjectLinkRow[]>;
+    getByPrimaryIdBatch(params: {
+        projectId: string;
+        items: readonly {
+            objectTypeId: string;
+            primaryId: string;
+        }[];
+    }): Promise<Map<string, ObjectRow>>;
+    listLinksBatch(params: {
+        projectId: string;
+        items: readonly {
+            objectTypeId: string;
+            objectId: string;
+            linkId: string;
+        }[];
+    }): Promise<Map<string, ObjectLinkRow[]>>;
+    listIncidentLinksBatch(params: {
+        projectId: string;
+        items: readonly {
+            objectTypeId: string;
+            objectId: string;
+        }[];
+    }): Promise<readonly ObjectLinkRow[]>;
+    listByPrimaryIdPage(params: {
+        projectId: string;
+        objectTypeId: string;
+        afterPrimaryId?: string;
+        limit: number;
+    }): Promise<{
+        objects: readonly ObjectRow[];
+        nextPrimaryId?: string;
+    }>;
+    list(params: {
+        projectId: string;
+        objectTypeId?: string | readonly string[];
+        primaryIdPrefix?: string;
+        primaryIdSuffix?: string;
+        updatedAfter?: Date;
+        updatedBefore?: Date;
+        createdAfter?: Date;
+        createdBefore?: Date;
+        limit?: number;
+        offset?: number;
+        orderBy?: "createdAt" | "updatedAt" | "primaryId";
+        order?: "asc" | "desc";
+    }): Promise<{
+        objects: readonly ObjectRow[];
+        hasMore: boolean;
+        total: number;
+    }>;
+    private deleteObjectRow;
+    private deleteLinkRow;
+}
+export {};
+//# sourceMappingURL=in-memory.d.ts.map

package/dist/storage/objects/in-memory.d.ts.map

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

package/dist/storage/objects/index.d.ts

@@ -0,0 +1,2 @@
+export type { CountObjectsInput, CountObjectsResult, ExistsObjectsInput, ExistsObjectsResult, ExpandedLinkValue, ExpandedObjectRow, FacetObjectsInput, FacetObjectsResult, LinkDirection, ObjectFacetBucket, ObjectFacetRequest, ObjectFacetResult, ObjectLinkRow, ObjectQueryCapabilities, ObjectQueryCapabilityMap, ObjectQueryScalarOperation, ObjectQueryScalarOperations, ObjectRow, ObjectRowLinks, ObjectStorage, QueryObjectsInput, QueryObjectsResult, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/objects/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/objects/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,2BAA2B,EAC3B,SAAS,EACT,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAA"}

package/dist/storage/objects/types.d.ts

@@ -0,0 +1,222 @@
+import type { ObjectQuery, ObjectQueryDirection, ObjectQueryPredicate, ObjectQuerySetOperation, ObjectQuerySortField, QueryScalarKind } from "../../objects/query";
+/**
+ * Latest-state projection storage for objects and links.
+ */
+export interface ObjectRow {
+    projectId: string;
+    objectTypeId: string;
+    primaryId: string;
+    properties: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+    version: number;
+    /** Commit that produced the current effective row. */
+    lastCommitId: string;
+    /**
+     * Linked objects attached by an `expand` query node, keyed by link id.
+     *
+     * Populated by the core executor during graph-aware reads; storage providers
+     * never read or write it. The wire response schema and the client `TwinObject`
+     * `.links` typing are layered on top of this runtime shape.
+     */
+    links?: ObjectRowLinks;
+}
+/** Per-link expansion result keyed by link id (see {@link ObjectQueryExpand}). */
+export type ObjectRowLinks = Record<string, ExpandedLinkValue>;
+/**
+ * The value attached under one expanded link.
+ *
+ * Cardinality drives the shape: a `"one"` link yields a single object (or
+ * `null` when the link is absent), a `"many"` link yields an array.
+ */
+export type ExpandedLinkValue = ExpandedObjectRow | readonly ExpandedObjectRow[] | null;
+/** A hydrated linked object, plus any properties carried on the link edge itself. */
+export interface ExpandedObjectRow extends ObjectRow {
+    /** Relationship metadata stored on the link instance, when present. */
+    linkProperties?: Record<string, unknown>;
+}
+export interface ObjectLinkRow {
+    projectId: string;
+    sourceTypeId: string;
+    sourceId: string;
+    linkId: string;
+    targetTypeId: string;
+    targetId: string;
+    properties?: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+    /** Commit that produced the current effective row. */
+    lastCommitId: string;
+}
+export type LinkDirection = "outgoing" | "incoming" | "both";
+export type ObjectQueryCapabilityMap<T extends string> = Readonly<Partial<Record<T, boolean>>>;
+export type ObjectQueryScalarOperation = "equality" | "ordering";
+export type ObjectQueryScalarOperations = Readonly<Partial<Record<QueryScalarKind, ObjectQueryCapabilityMap<ObjectQueryScalarOperation>>>>;
+/**
+ * Provider-declared object query support.
+ *
+ * Missing nested flags are treated as unsupported. The planner can use this
+ * as a pushdown boundary and decide separately whether bounded fallback is
+ * allowed for unsupported nodes.
+ */
+export interface ObjectQueryCapabilities {
+    /** True only when `queryObjects` is implemented and should be called. */
+    queryObjects: boolean;
+    /** True only when `countObjects` is implemented and should be called. */
+    countObjects?: boolean;
+    /** True only when `existsObjects` is implemented and should be called. */
+    existsObjects?: boolean;
+    /** True only when `facetObjects` is implemented and should be called. */
+    facetObjects?: boolean;
+    nodes?: ObjectQueryCapabilityMap<ObjectQuery["kind"]>;
+    predicateOps?: ObjectQueryCapabilityMap<ObjectQueryPredicate["op"]>;
+    sortKinds?: ObjectQueryCapabilityMap<ObjectQuerySortField["kind"]>;
+    traversalDirections?: ObjectQueryCapabilityMap<ObjectQueryDirection>;
+    setOps?: ObjectQueryCapabilityMap<ObjectQuerySetOperation>;
+    /** Scalar operations whose semantics the provider can preserve exactly. */
+    scalarOperations?: ObjectQueryScalarOperations;
+    features?: {
+        /**
+         * True only when the provider can expand `start.includeSubtypes` itself.
+         * Storage-only providers usually cannot, because subtype expansion requires
+         * the ontology registry and should fall back to the core executor.
+         */
+        includeSubtypes?: boolean;
+    };
+    limits?: {
+        maxLimit?: number;
+        maxPageSize?: number;
+        totalCount?: boolean;
+        stablePageTokens?: boolean;
+    };
+    notes?: readonly string[];
+}
+export interface QueryObjectsInput {
+    projectId: string;
+    query: ObjectQuery;
+    includeTotal?: boolean;
+}
+export interface QueryObjectsResult {
+    objects: readonly ObjectRow[];
+    hasMore: boolean;
+    total?: number;
+    nextPageToken?: string;
+}
+export interface CountObjectsInput {
+    projectId: string;
+    query: ObjectQuery;
+}
+export interface CountObjectsResult {
+    count: number;
+}
+export interface ExistsObjectsInput {
+    projectId: string;
+    query: ObjectQuery;
+}
+export interface ExistsObjectsResult {
+    exists: boolean;
+}
+export interface ObjectFacetRequest {
+    propertyId: string;
+    limit: number;
+}
+export interface ObjectFacetBucket {
+    value: unknown;
+    count: number;
+}
+export interface ObjectFacetResult {
+    propertyId: string;
+    buckets: readonly ObjectFacetBucket[];
+}
+export interface FacetObjectsInput {
+    projectId: string;
+    query: ObjectQuery;
+    facets: readonly ObjectFacetRequest[];
+}
+export interface FacetObjectsResult {
+    facets: readonly ObjectFacetResult[];
+}
+export interface ObjectStorage {
+    queryCapabilities(): ObjectQueryCapabilities;
+    queryObjects?(params: QueryObjectsInput): Promise<QueryObjectsResult>;
+    countObjects?(params: CountObjectsInput): Promise<CountObjectsResult>;
+    existsObjects?(params: ExistsObjectsInput): Promise<ExistsObjectsResult>;
+    facetObjects?(params: FacetObjectsInput): Promise<FacetObjectsResult>;
+    getByPrimaryId(params: {
+        projectId: string;
+        objectTypeId: string;
+        primaryId: string;
+    }): Promise<ObjectRow | null>;
+    listLinks(params: {
+        projectId: string;
+        objectTypeId: string;
+        objectId: string;
+        linkId?: string;
+        direction?: LinkDirection;
+    }): Promise<readonly ObjectLinkRow[]>;
+    /**
+     * Batch fetch objects by (objectTypeId, primaryId) pairs.
+     * Returns a Map keyed by "objectTypeId:primaryId". Missing items are absent.
+     */
+    getByPrimaryIdBatch(params: {
+        projectId: string;
+        items: readonly {
+            objectTypeId: string;
+            primaryId: string;
+        }[];
+    }): Promise<Map<string, ObjectRow>>;
+    /**
+     * Batch fetch outgoing links by (objectTypeId, objectId, linkId) tuples.
+     * Returns a Map keyed by "objectTypeId:objectId:linkId". Missing entries are absent.
+     */
+    listLinksBatch(params: {
+        projectId: string;
+        items: readonly {
+            objectTypeId: string;
+            objectId: string;
+            linkId: string;
+        }[];
+    }): Promise<Map<string, ObjectLinkRow[]>>;
+    /**
+     * Batch fetch every link incident to any of the given objects, in BOTH directions (the object as
+     * link source or target). Returns a flat, de-duplicated list: a physical link incident to two
+     * listed objects appears once. Used to load cascade-delete state for `object.delete` operations,
+     * which {@link listLinksBatch} cannot express because it keys on a specific linkId.
+     */
+    listIncidentLinksBatch(params: {
+        projectId: string;
+        items: readonly {
+            objectTypeId: string;
+            objectId: string;
+        }[];
+    }): Promise<readonly ObjectLinkRow[]>;
+    /** Stable keyset page used by background reconciliation without a total-count scan. */
+    listByPrimaryIdPage(params: {
+        projectId: string;
+        objectTypeId: string;
+        afterPrimaryId?: string;
+        limit: number;
+    }): Promise<{
+        objects: readonly ObjectRow[];
+        nextPrimaryId?: string;
+    }>;
+    list(params: {
+        projectId: string;
+        objectTypeId?: string | readonly string[];
+        primaryIdPrefix?: string;
+        primaryIdSuffix?: string;
+        updatedAfter?: Date;
+        updatedBefore?: Date;
+        createdAfter?: Date;
+        createdBefore?: Date;
+        limit?: number;
+        offset?: number;
+        orderBy?: "createdAt" | "updatedAt" | "primaryId";
+        order?: "asc" | "desc";
+    }): Promise<{
+        objects: readonly ObjectRow[];
+        hasMore: boolean;
+        total: number;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/storage/objects/types.d.ts.map

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

package/dist/storage/ontology/commits.d.ts

@@ -0,0 +1,117 @@
+import type { EventActor } from "../../events/envelope";
+import type { EditCommitResult, OntologyMaterializationOrigin, PinnedDatasetVersion, ProjectionCommitResult, ProjectionSourceRef, TelemetryCommitResult } from "../../materialization/model";
+export interface GetOntologyCommitByIdempotencyKeyInput {
+    readonly projectId: string;
+    readonly idempotencyKey: string;
+}
+export interface GetOntologyCommitByIdInput {
+    readonly projectId: string;
+    readonly id: string;
+}
+export type OntologyCommitOriginSelector = {
+    readonly kind: "action";
+    readonly actionRunId: string;
+} | {
+    readonly kind: "projection";
+    readonly projectionRunId: string;
+} | {
+    readonly kind: "telemetry";
+    readonly projectionRunId: string;
+    readonly batchOrdinal: number;
+};
+export interface GetOntologyCommitByOriginInput {
+    readonly projectId: string;
+    readonly origin: OntologyCommitOriginSelector;
+}
+export type OntologyCommitRunSelector = {
+    readonly kind: "action";
+    readonly id: string;
+} | {
+    readonly kind: "projection";
+    readonly id: string;
+};
+export interface ListOntologyCommitsInput {
+    readonly projectId: string;
+    readonly run?: OntologyCommitRunSelector;
+    readonly limit?: number;
+    readonly offset?: number;
+    readonly order?: "asc" | "desc";
+}
+export interface ListOntologyCommitsResult {
+    readonly commits: readonly OntologyCommitRecord[];
+    readonly total: number;
+    readonly hasMore: boolean;
+}
+interface OntologyCommitFields {
+    readonly projectId: string;
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly requestHash: string;
+    readonly origin: OntologyMaterializationOrigin;
+    readonly actor?: EventActor;
+    readonly ontologyRevision: string;
+    readonly projectionRevision?: string;
+    readonly ownershipHash?: string;
+    readonly committedAt: string;
+}
+export interface EditOntologyCommitIntent {
+    readonly kind: "edit";
+    readonly mode: "atomic" | "continue";
+    readonly operationCount: number;
+}
+export interface ProjectionOntologyCommitIntent {
+    readonly kind: "projection";
+    readonly source: ProjectionSourceRef;
+    readonly datasetVersion: PinnedDatasetVersion;
+}
+interface TelemetryOntologyCommitIntentBase {
+    readonly kind: "telemetry";
+    /** Canonical unique points that enter semantic materialization. */
+    readonly pointCount: number;
+    /** Caller-supplied points before equal-duplicate normalization. */
+    readonly inputPointCount: number;
+}
+export type TelemetryOntologyCommitIntent = (TelemetryOntologyCommitIntentBase & {
+    readonly source: {
+        readonly kind: "runtime";
+    };
+}) | (TelemetryOntologyCommitIntentBase & {
+    readonly source: {
+        readonly kind: "projection";
+        readonly projection: ProjectionSourceRef;
+        readonly datasetVersion: PinnedDatasetVersion;
+        readonly batchOrdinal: number;
+        readonly sourceRowCount: number;
+        readonly sourceRowsSkipped: number;
+        readonly inputExhausted: boolean;
+    };
+});
+/** Commit metadata and intent supplied before the transaction is finalized. */
+export type OntologyCommitWrite = (OntologyCommitFields & {
+    readonly intent: EditOntologyCommitIntent;
+}) | (OntologyCommitFields & {
+    readonly intent: ProjectionOntologyCommitIntent;
+}) | (OntologyCommitFields & {
+    readonly intent: TelemetryOntologyCommitIntent;
+});
+/** Read-only finalized commit with an intent-correlated authoritative result. */
+export type OntologyCommitRecord = (OntologyCommitFields & {
+    readonly intent: EditOntologyCommitIntent;
+    readonly result: EditCommitResult;
+}) | (OntologyCommitFields & {
+    readonly intent: ProjectionOntologyCommitIntent;
+    readonly result: ProjectionCommitResult;
+}) | (OntologyCommitFields & {
+    readonly intent: TelemetryOntologyCommitIntent;
+    readonly result: TelemetryCommitResult;
+});
+export interface OntologyCommitStorage {
+    getByIdempotencyKey(input: GetOntologyCommitByIdempotencyKeyInput): Promise<OntologyCommitRecord | null>;
+    getById(input: GetOntologyCommitByIdInput): Promise<OntologyCommitRecord | null>;
+    /** Exact authoritative lookup used by Action/projection lifecycle coordination. */
+    getByOrigin(input: GetOntologyCommitByOriginInput): Promise<OntologyCommitRecord | null>;
+    /** Reads authoritative commit history, optionally correlated to an Action or projection run. */
+    list(input: ListOntologyCommitsInput): Promise<ListOntologyCommitsResult>;
+}
+export {};
+//# sourceMappingURL=commits.d.ts.map

package/dist/storage/ontology/commits.d.ts.map

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

package/dist/storage/ontology/in-memory/commits.d.ts

@@ -0,0 +1,12 @@
+import type { GetOntologyCommitByIdempotencyKeyInput, GetOntologyCommitByIdInput, GetOntologyCommitByOriginInput, ListOntologyCommitsInput, ListOntologyCommitsResult, OntologyCommitRecord, OntologyCommitStorage } from "../commits";
+import { type InMemoryOntologyState } from "./shared-state";
+export declare class InMemoryOntologyCommitStorage implements OntologyCommitStorage {
+    private readonly state;
+    private readonly runRootOperation;
+    constructor(state: InMemoryOntologyState, runRootOperation: <T>(run: () => Promise<T> | T) => Promise<T>);
+    getByIdempotencyKey(input: GetOntologyCommitByIdempotencyKeyInput): Promise<OntologyCommitRecord | null>;
+    getById(input: GetOntologyCommitByIdInput): Promise<OntologyCommitRecord | null>;
+    getByOrigin(input: GetOntologyCommitByOriginInput): Promise<OntologyCommitRecord | null>;
+    list(input: ListOntologyCommitsInput): Promise<ListOntologyCommitsResult>;
+}
+//# sourceMappingURL=commits.d.ts.map

package/dist/storage/ontology/in-memory/commits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commits.d.ts","sourceRoot":"","sources":["../../../../src/storage/ontology/in-memory/commits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sCAAsC,EACtC,0BAA0B,EAC1B,8BAA8B,EAC9B,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EAEpB,qBAAqB,EACtB,MAAM,YAAY,CAAA;AACnB,OAAO,EAGL,KAAK,qBAAqB,EAE3B,MAAM,gBAAgB,CAAA;AAEvB,qBAAa,6BAA8B,YAAW,qBAAqB;IAEvE,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBADhB,KAAK,EAAE,qBAAqB,EAC5B,gBAAgB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;IAG3E,mBAAmB,CACvB,KAAK,EAAE,sCAAsC,GAC5C,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAUjC,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAMhF,WAAW,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IASxF,IAAI,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAmChF"}