@empressaio/atom-contract 1.7.0

package/dist/history.js

@@ -0,0 +1,170 @@
+/**
+ * Event-anchored history for atoms.
+ *
+ * The `EventAnchoringService` interface every atom mutation flows through.
+ * Ships the interface verbatim plus a Postgres-backed implementation that
+ * writes deterministic SHA-256 `chainHash` values into the `atom_events`
+ * table. Cryptographic anchoring (Merkle root, external ledger anchor)
+ * lands later without changing the consumer interface — this is the
+ * central "interface-stable / implementation-evolves" promise.
+ *
+ * TODO(M2-C): replace deterministic chainHash with cryptographic anchor.
+ */
+import { createHash } from "node:crypto";
+import { sql } from "drizzle-orm";
+/**
+ * Name of the host application's atom-events table. The host project owns
+ * the schema; this library is decoupled from it at runtime — we issue raw
+ * SQL against the agreed table name only. Keeping the table name in one
+ * constant makes the contract explicit and lets future versions of the
+ * framework move to a host-injected name without touching call sites.
+ */
+const ATOM_EVENTS_TABLE = sql.identifier("atom_events");
+/**
+ * Generate a ULID-like monotonic id. Time prefix (10 chars Crockford32)
+ * keeps ids time-sortable; random suffix makes them unique. We don't use
+ * the `ulid` package to avoid a runtime dep for one ~30-line helper.
+ */
+const CROCKFORD = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+function generateId() {
+    let time = Date.now();
+    let timeChars = "";
+    for (let i = 0; i < 10; i++) {
+        timeChars = (CROCKFORD[time % 32] ?? "0") + timeChars;
+        time = Math.floor(time / 32);
+    }
+    let rand = "";
+    for (let i = 0; i < 16; i++) {
+        rand += CROCKFORD[Math.floor(Math.random() * 32)] ?? "0";
+    }
+    return timeChars + rand;
+}
+/**
+ * Compute the deterministic SHA-256 chain hash for an event. Inputs are
+ * stringified with stable key order so two callers computing the same
+ * event get the same hash. TODO(M2-C): swap for the real cryptographic
+ * anchor — same signature, no consumer change.
+ */
+function computeChainHash(args) {
+    // JSON.stringify with sorted keys is stable enough; we don't worry
+    // about deeply-nested object key ordering yet.
+    const stable = JSON.stringify({
+        prevHash: args.prevHash,
+        payload: args.payload,
+        occurredAt: args.occurredAt.toISOString(),
+        eventType: args.eventType,
+        actor: args.actor,
+    });
+    return createHash("sha256").update(stable).digest("hex");
+}
+/**
+ * Postgres-backed {@link EventAnchoringService} implementation. Uses raw
+ * SQL via Drizzle's `sql` template so the boundary to the host db package
+ * stays minimal — we depend on the `atom_events` table existing but not
+ * on the driver flavor.
+ */
+export class PostgresEventAnchoringService {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async appendEvent(input) {
+        const occurredAt = input.occurredAt ?? new Date();
+        return await this.db.transaction(async (tx) => {
+            // Per-entity serialization: appendEvent is atomic with respect to
+            // its (entityType, entityId) chain — the resulting hash chain
+            // must be gap-free even under concurrent appends.
+            //
+            // We use a transaction-scoped Postgres advisory lock keyed on a
+            // 64-bit hash of `${entityType}:${entityId}`. Concurrent
+            // transactions touching the same chain serialize on the lock;
+            // transactions on different chains run in parallel. The lock
+            // releases automatically at COMMIT/ROLLBACK.
+            const lockKey = `${input.entityType}:${input.entityId}`;
+            await tx.execute(sql `SELECT pg_advisory_xact_lock(hashtextextended(${lockKey}, 0))`);
+            // Find the chain tail by structure, not by timestamp. Postgres'
+            // `now()` (used by `recorded_at` defaults) returns transaction-
+            // start time, not statement time, so under concurrent appends two
+            // rows can have equal/out-of-order recorded_at values and a
+            // timestamp-based ORDER BY cannot reliably identify the most-
+            // recently-inserted row. The tail is well-defined: it's the only
+            // row whose `chain_hash` is not any other row's `prev_hash`. The
+            // advisory lock above guarantees there is at most one such row.
+            const latestRows = await tx.execute(sql `SELECT chain_hash FROM ${ATOM_EVENTS_TABLE} e1
+            WHERE entity_type = ${input.entityType}
+              AND entity_id = ${input.entityId}
+              AND NOT EXISTS (
+                SELECT 1 FROM ${ATOM_EVENTS_TABLE} e2
+                WHERE e2.entity_type = e1.entity_type
+                  AND e2.entity_id = e1.entity_id
+                  AND e2.prev_hash = e1.chain_hash
+              )
+            LIMIT 1`);
+            const prevHash = latestRows.rows.length > 0
+                ? (latestRows.rows[0]?.chain_hash ?? null)
+                : null;
+            const id = generateId();
+            const chainHash = computeChainHash({
+                prevHash,
+                payload: input.payload,
+                occurredAt,
+                eventType: input.eventType,
+                actor: input.actor,
+            });
+            const inserted = await tx.execute(sql `INSERT INTO ${ATOM_EVENTS_TABLE}
+              (id, entity_type, entity_id, event_type, actor, payload,
+               prev_hash, chain_hash, occurred_at)
+            VALUES
+              (${id}, ${input.entityType}, ${input.entityId},
+               ${input.eventType}, ${JSON.stringify(input.actor)}::jsonb,
+               ${JSON.stringify(input.payload)}::jsonb,
+               ${prevHash}, ${chainHash}, ${occurredAt.toISOString()})
+            RETURNING id, entity_type, entity_id, event_type, actor,
+                      payload, prev_hash, chain_hash, occurred_at,
+                      recorded_at`);
+            const row = inserted.rows[0];
+            if (!row)
+                throw new Error("appendEvent: insert returned no rows");
+            // `chain_hash` carries a UNIQUE constraint at the schema level —
+            // if the lock failed for any reason, the duplicate insert would
+            // surface here instead of silently forking the chain.
+            return rowToEvent(row);
+        });
+    }
+    async readHistory(ref, opts = {}) {
+        const limit = Math.max(1, Math.min(opts.limit ?? 1000, 10_000));
+        const offset = Math.max(0, opts.offset ?? 0);
+        const direction = opts.reverse ? sql `DESC` : sql `ASC`;
+        const result = await this.db.execute(sql `SELECT id, entity_type, entity_id, event_type, actor, payload,
+                 prev_hash, chain_hash, occurred_at, recorded_at
+          FROM ${ATOM_EVENTS_TABLE}
+          WHERE entity_type = ${ref.entityType}
+            AND entity_id = ${ref.entityId}
+          ORDER BY occurred_at ${direction}, recorded_at ${direction}, id ${direction}
+          LIMIT ${limit} OFFSET ${offset}`);
+        return result.rows.map(rowToEvent);
+    }
+    async latestEvent(ref) {
+        const rows = await this.readHistory(ref, { limit: 1, reverse: true });
+        return rows[0] ?? null;
+    }
+}
+function rowToEvent(row) {
+    const actor = row.actor;
+    const payload = row.payload;
+    return {
+        id: row.id,
+        entityType: row.entity_type,
+        entityId: row.entity_id,
+        eventType: row.event_type,
+        actor,
+        payload,
+        prevHash: row.prev_hash ?? null,
+        chainHash: row.chain_hash,
+        occurredAt: new Date(row.occurred_at),
+        recordedAt: new Date(row.recorded_at),
+    };
+}
+/** Re-exported for tests that want to assert the chain-hash formula. */
+export const __internal = { computeChainHash, generateId };
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Public surface of `@empressaio/atom-contract`.
+ *
+ * The barrel re-exports every primitive but never anything from
+ * `src/testing/` — testing utilities live behind the `./testing` subpath
+ * so production bundles never pull them in.
+ *
+ * See `README.md` for the contract walk-through and the
+ * "What this package does NOT ship" deferred-surface list.
+ */
+export type { AccessPolicy, AtomMode, AtomReference, AtomProps, ChipAction, AtomRegistration, AnyAtomRegistration, DefaultModeOf, } from "./registration.js";
+export type { Scope } from "./scope.js";
+export { defaultScope } from "./scope.js";
+export type { ContextSummary, KeyMetric, HistoryProvenance, HttpContextSummaryOptions, HttpContextSummaryHandle, } from "./context.js";
+export { httpContextSummary } from "./context.js";
+export type { AtomComposition, ResolvedChild, CompositionRegistryView, } from "./composition.js";
+export { resolveComposition } from "./composition.js";
+export { FALLBACK_ORDER, resolveMode, } from "./render.js";
+export type { ParsedSegment, ParsedTextSegment, ParsedAtomSegment, } from "./inline-reference.js";
+export { INLINE_ATOM_REGEX, parseInlineReferences, serializeInlineReference, } from "./inline-reference.js";
+export type { EventActor, AppendEventInput, AtomEvent, ReadHistoryOptions, EventAnchoringService, DrizzleLikeDb, } from "./history.js";
+export { PostgresEventAnchoringService } from "./history.js";
+export type { VdaEnvelope, WrappedValue } from "./vda.js";
+export { wrapForStorage, unwrapFromStorage } from "./vda.js";
+export type { AtomRegistry, ResolveResult, ValidateResult, DanglingCompositionRef, AtomPromptDescription, } from "./registry.js";
+export { createAtomRegistry, AtomNotRegisteredError } from "./registry.js";
+export type { ObligationAtomInstance, ObligationType, ObligationStatus, } from "./obligation.js";
+export { OBLIGATION_SCHEMA, OBLIGATION_TYPES, OBLIGATION_STATUSES, } from "./obligation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,YAAY,EACV,eAAe,EACf,aAAa,EACb,uBAAuB,GACxB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EACL,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,qBAAqB,EACrB,aAAa,GACd,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAE7D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE3E,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * Public surface of `@empressaio/atom-contract`.
+ *
+ * The barrel re-exports every primitive but never anything from
+ * `src/testing/` — testing utilities live behind the `./testing` subpath
+ * so production bundles never pull them in.
+ *
+ * See `README.md` for the contract walk-through and the
+ * "What this package does NOT ship" deferred-surface list.
+ */
+export { defaultScope } from "./scope.js";
+export { httpContextSummary } from "./context.js";
+export { resolveComposition } from "./composition.js";
+export { FALLBACK_ORDER, resolveMode, } from "./render.js";
+export { INLINE_ATOM_REGEX, parseInlineReferences, serializeInlineReference, } from "./inline-reference.js";
+export { PostgresEventAnchoringService } from "./history.js";
+export { wrapForStorage, unwrapFromStorage } from "./vda.js";
+export { createAtomRegistry, AtomNotRegisteredError } from "./registry.js";
+export { OBLIGATION_SCHEMA, OBLIGATION_TYPES, OBLIGATION_STATUSES, } from "./obligation.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAcH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAOlD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EACL,cAAc,EACd,WAAW,GACZ,MAAM,aAAa,CAAC;AAOrB,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAU/B,OAAO,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAS7D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAO3E,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}

package/dist/inline-reference.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Inline atom reference syntax.
+ *
+ * The chat layer embeds atom references in prose using the syntax
+ * `{{atom|type|id|label}}`. This module ships a pure parser/serializer
+ * pair that operates on strings only — no dependency on the registry.
+ *
+ * Delimiter is `|`. The previous shape used `:` as the delimiter, which
+ * collided with entityId patterns that themselves contain `:` (e.g.
+ * `parcel-briefing:{parcelId}:{intentHash}`). `|` is collision-free
+ * against every registered entityType, every idResolver-produced id, and
+ * every displayLabel produced today. Backward compatibility with the old
+ * shape is intentionally NOT supported — see the "old-shape ... no
+ * dual-parse contract" test in inline-reference.test.ts.
+ */
+import type { AtomMode, AtomReference } from "./registration.js";
+/**
+ * Source-of-truth regex. Captures: entityType (no `|`), entityId (no `|`),
+ * displayLabel (no `}`). Greedy on the third group so labels with `|` or
+ * `:` are accepted (e.g. "Decision: pick HVAC vendor").
+ */
+export declare const INLINE_ATOM_REGEX: RegExp;
+/** A single text run between (or surrounding) inline atom references. */
+export interface ParsedTextSegment {
+    kind: "text";
+    text: string;
+}
+/** A single parsed atom reference. */
+export interface ParsedAtomSegment {
+    kind: "atom";
+    reference: AtomReference;
+    /** The exact source text that produced this segment (for round-trip). */
+    raw: string;
+}
+export type ParsedSegment = ParsedTextSegment | ParsedAtomSegment;
+/**
+ * Parse `text` into an alternating sequence of text and atom segments.
+ * Empty text segments at the start, between atoms, or at the end are
+ * preserved as zero-length text runs so a caller iterating segments can
+ * always render in order.
+ *
+ * Malformed markers (missing fields, stray `{{`) are left as plain text.
+ */
+export declare function parseInlineReferences(text: string): ParsedSegment[];
+/**
+ * Serialize an {@link AtomReference} back to its `{{atom|type|id|label}}`
+ * form. Round-trips with {@link parseInlineReferences}.
+ *
+ * If `mode` is set, it is intentionally **not** serialized — the inline
+ * syntax has only three slots and the render binding decides on the mode
+ * from chip-vs-expand UX context. If `displayLabel` is missing,
+ * `entityId` is used so the syntax stays valid.
+ */
+export declare function serializeInlineReference(ref: AtomReference): string;
+/**
+ * Re-export {@link AtomMode} so consumers parsing inline references can
+ * narrow without a separate import — convenience only.
+ */
+export type { AtomMode };
+//# sourceMappingURL=inline-reference.d.ts.map

package/dist/inline-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-reference.d.ts","sourceRoot":"","sources":["../src/inline-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAmD,CAAC;AAEpF,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,CAAC;IACzB,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;AAElE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,EAAE,CA4BnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAGnE;AAED;;;GAGG;AACH,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/inline-reference.js

@@ -0,0 +1,73 @@
+/**
+ * Inline atom reference syntax.
+ *
+ * The chat layer embeds atom references in prose using the syntax
+ * `{{atom|type|id|label}}`. This module ships a pure parser/serializer
+ * pair that operates on strings only — no dependency on the registry.
+ *
+ * Delimiter is `|`. The previous shape used `:` as the delimiter, which
+ * collided with entityId patterns that themselves contain `:` (e.g.
+ * `parcel-briefing:{parcelId}:{intentHash}`). `|` is collision-free
+ * against every registered entityType, every idResolver-produced id, and
+ * every displayLabel produced today. Backward compatibility with the old
+ * shape is intentionally NOT supported — see the "old-shape ... no
+ * dual-parse contract" test in inline-reference.test.ts.
+ */
+/**
+ * Source-of-truth regex. Captures: entityType (no `|`), entityId (no `|`),
+ * displayLabel (no `}`). Greedy on the third group so labels with `|` or
+ * `:` are accepted (e.g. "Decision: pick HVAC vendor").
+ */
+export const INLINE_ATOM_REGEX = /\{\{atom\|([^|]+)\|([^|]+)\|([^}]+)\}\}/g;
+/**
+ * Parse `text` into an alternating sequence of text and atom segments.
+ * Empty text segments at the start, between atoms, or at the end are
+ * preserved as zero-length text runs so a caller iterating segments can
+ * always render in order.
+ *
+ * Malformed markers (missing fields, stray `{{`) are left as plain text.
+ */
+export function parseInlineReferences(text) {
+    const segments = [];
+    // Reset state because the regex is `g`-flagged and module-scoped.
+    INLINE_ATOM_REGEX.lastIndex = 0;
+    let cursor = 0;
+    let match;
+    while ((match = INLINE_ATOM_REGEX.exec(text)) !== null) {
+        const [raw, entityType, entityId, displayLabel] = match;
+        if (entityType === undefined || entityId === undefined)
+            continue;
+        if (match.index > cursor) {
+            segments.push({ kind: "text", text: text.slice(cursor, match.index) });
+        }
+        segments.push({
+            kind: "atom",
+            raw,
+            reference: {
+                kind: "atom",
+                entityType,
+                entityId,
+                displayLabel,
+            },
+        });
+        cursor = match.index + raw.length;
+    }
+    if (cursor < text.length) {
+        segments.push({ kind: "text", text: text.slice(cursor) });
+    }
+    return segments;
+}
+/**
+ * Serialize an {@link AtomReference} back to its `{{atom|type|id|label}}`
+ * form. Round-trips with {@link parseInlineReferences}.
+ *
+ * If `mode` is set, it is intentionally **not** serialized — the inline
+ * syntax has only three slots and the render binding decides on the mode
+ * from chip-vs-expand UX context. If `displayLabel` is missing,
+ * `entityId` is used so the syntax stays valid.
+ */
+export function serializeInlineReference(ref) {
+    const label = ref.displayLabel ?? ref.entityId;
+    return `{{atom|${ref.entityType}|${ref.entityId}|${label}}}`;
+}
+//# sourceMappingURL=inline-reference.js.map

package/dist/inline-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-reference.js","sourceRoot":"","sources":["../src/inline-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAW,0CAA0C,CAAC;AAkBpF;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,kEAAkE;IAClE,iBAAiB,CAAC,SAAS,GAAG,CAAC,CAAC;IAChC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACvD,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC;QACxD,IAAI,UAAU,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAS;QACjE,IAAI,KAAK,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,MAAM;YACZ,GAAG;YACH,SAAS,EAAE;gBACT,IAAI,EAAE,MAAM;gBACZ,UAAU;gBACV,QAAQ;gBACR,YAAY;aACb;SACF,CAAC,CAAC;QACH,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC;IACpC,CAAC;IACD,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAkB;IACzD,MAAM,KAAK,GAAG,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,QAAQ,CAAC;IAC/C,OAAO,UAAU,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,QAAQ,IAAI,KAAK,IAAI,CAAC;AAC/D,CAAC"}

package/dist/obligation.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Obligation atom type per ADR-025 — domain-neutral from birth.
+ * Shipped in the core contract module (not ./og), consumed by Mox and O&G.
+ * The oblg_ prefix registers with the core prefix set.
+ *
+ * What keeps a lease alive; the first job the product does. Status is
+ * engine-derived, never hand-asserted. Each status derivation is a
+ * procedure-execution atom (ADR-013) audit trail.
+ */
+import { z } from "zod";
+import type { AccessPolicy } from "./registration.js";
+import { type WidthedConfidence } from "./read-contract/common.js";
+/**
+ * Obligation type discriminator. ADR-025 specifies O&G obligation types;
+ * additively extensible for other verticals (Mox facility obligations, etc.).
+ */
+export type ObligationType = "delay-rental" | "shut-in-royalty" | "minimum-royalty" | "bonus" | "rental" | "lease-expiration" | "continuous-development" | "pugh-release" | "other";
+export declare const OBLIGATION_TYPES: ReadonlyArray<ObligationType>;
+/**
+ * Obligation status. Derived, never hand-asserted. Each status derivation is
+ * recorded as a procedure-execution atom (ADR-013).
+ */
+export type ObligationStatus = "upcoming" | "due" | "satisfied" | "delinquent" | "released";
+export declare const OBLIGATION_STATUSES: ReadonlyArray<ObligationStatus>;
+/**
+ * Obligation atom instance. Domain-neutral from birth (ADR-025 operator ruling
+ * 2): O&G anchors to mineral-lease DIDs (anchorKind: 'mineral-lease'), Mox
+ * anchors to facility DIDs (anchorKind: 'facility'). The core type must not
+ * freeze a lease-specific field name.
+ * DID format: oblg_<hash> (hashed derivation from source, externalId).
+ */
+export interface ObligationAtomInstance {
+    entityType: "obligation";
+    obligationDid: string;
+    obligationType: ObligationType;
+    anchorDid: string;
+    anchorKind?: string;
+    owedToActorDid?: string;
+    owedToInterestDid?: string;
+    dueDate: string;
+    recurrence?: string;
+    amount?: number;
+    graceTerms?: string;
+    status: ObligationStatus;
+    confidence: WidthedConfidence;
+    sourceCitation: string;
+    extractedAt: string;
+    asOf?: string;
+    accessPolicy: AccessPolicy;
+}
+export declare const OBLIGATION_SCHEMA: z.ZodObject<{
+    entityType: z.ZodLiteral<"obligation">;
+    obligationDid: z.ZodEffects<z.ZodString, string, string>;
+    obligationType: z.ZodEnum<[ObligationType, ...ObligationType[]]>;
+    anchorDid: z.ZodString;
+    anchorKind: z.ZodOptional<z.ZodString>;
+    owedToActorDid: z.ZodOptional<z.ZodString>;
+    owedToInterestDid: z.ZodOptional<z.ZodString>;
+    dueDate: z.ZodString;
+    recurrence: z.ZodOptional<z.ZodString>;
+    amount: z.ZodOptional<z.ZodNumber>;
+    graceTerms: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<[ObligationStatus, ...ObligationStatus[]]>;
+    confidence: z.ZodReadonly<z.ZodObject<{
+        readonly estimate: z.ZodNumber;
+        readonly n: z.ZodNumber;
+        readonly intervalWidth: z.ZodNumber;
+        readonly provenance: z.ZodEnum<["asserted", "backtest", "seed", "live"]>;
+    }, "strip", z.ZodTypeAny, {
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }, {
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>>;
+    sourceCitation: z.ZodString;
+    extractedAt: z.ZodString;
+    asOf: z.ZodOptional<z.ZodString>;
+    accessPolicy: z.ZodEnum<["public-free", "public-paid", "platform-internal", "tenant-private", "tenant-shared"]>;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "obligation";
+    status: ObligationStatus;
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    sourceCitation: string;
+    obligationDid: string;
+    obligationType: ObligationType;
+    anchorDid: string;
+    dueDate: string;
+    extractedAt: string;
+    anchorKind?: string | undefined;
+    owedToActorDid?: string | undefined;
+    owedToInterestDid?: string | undefined;
+    recurrence?: string | undefined;
+    amount?: number | undefined;
+    graceTerms?: string | undefined;
+    asOf?: string | undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "obligation";
+    status: ObligationStatus;
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    sourceCitation: string;
+    obligationDid: string;
+    obligationType: ObligationType;
+    anchorDid: string;
+    dueDate: string;
+    extractedAt: string;
+    anchorKind?: string | undefined;
+    owedToActorDid?: string | undefined;
+    owedToInterestDid?: string | undefined;
+    recurrence?: string | undefined;
+    amount?: number | undefined;
+    graceTerms?: string | undefined;
+    asOf?: string | undefined;
+}>;
+//# sourceMappingURL=obligation.d.ts.map

package/dist/obligation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obligation.d.ts","sourceRoot":"","sources":["../src/obligation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9F;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,iBAAiB,GACjB,iBAAiB,GACjB,OAAO,GACP,QAAQ,GACR,kBAAkB,GAClB,wBAAwB,GACxB,cAAc,GACd,OAAO,CAAC;AAEZ,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,cAAc,CAU1D,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,KAAK,GACL,WAAW,GACX,YAAY,GACZ,UAAU,CAAC;AAEf,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,gBAAgB,CAM/D,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,YAAY,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuB5B,CAAC"}

package/dist/obligation.js

@@ -0,0 +1,55 @@
+/**
+ * Obligation atom type per ADR-025 — domain-neutral from birth.
+ * Shipped in the core contract module (not ./og), consumed by Mox and O&G.
+ * The oblg_ prefix registers with the core prefix set.
+ *
+ * What keeps a lease alive; the first job the product does. Status is
+ * engine-derived, never hand-asserted. Each status derivation is a
+ * procedure-execution atom (ADR-013) audit trail.
+ */
+import { z } from "zod";
+import { WIDTHED_CONFIDENCE_SCHEMA } from "./read-contract/common.js";
+import { OG_ACCESS_POLICY_SCHEMA } from "./og/common.js";
+export const OBLIGATION_TYPES = [
+    "delay-rental",
+    "shut-in-royalty",
+    "minimum-royalty",
+    "bonus",
+    "rental",
+    "lease-expiration",
+    "continuous-development",
+    "pugh-release",
+    "other",
+];
+export const OBLIGATION_STATUSES = [
+    "upcoming",
+    "due",
+    "satisfied",
+    "delinquent",
+    "released",
+];
+export const OBLIGATION_SCHEMA = z.object({
+    entityType: z.literal("obligation"),
+    obligationDid: z
+        .string()
+        .min(1)
+        .refine((val) => /^oblg_[0-9a-f]{16}$/.test(val), {
+        message: "obligationDid must be in format oblg_<16-hex-chars>",
+    }),
+    obligationType: z.enum(OBLIGATION_TYPES),
+    anchorDid: z.string().min(1),
+    anchorKind: z.string().min(1).optional(),
+    owedToActorDid: z.string().min(1).optional(),
+    owedToInterestDid: z.string().min(1).optional(),
+    dueDate: z.string().min(1),
+    recurrence: z.string().min(1).optional(),
+    amount: z.number().optional(),
+    graceTerms: z.string().min(1).optional(),
+    status: z.enum(OBLIGATION_STATUSES),
+    confidence: WIDTHED_CONFIDENCE_SCHEMA,
+    sourceCitation: z.string().min(1),
+    extractedAt: z.string().min(1),
+    asOf: z.string().min(1).optional(),
+    accessPolicy: OG_ACCESS_POLICY_SCHEMA,
+});
+//# sourceMappingURL=obligation.js.map

package/dist/obligation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obligation.js","sourceRoot":"","sources":["../src/obligation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,yBAAyB,EAA0B,MAAM,2BAA2B,CAAC;AAC9F,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAiBzD,MAAM,CAAC,MAAM,gBAAgB,GAAkC;IAC7D,cAAc;IACd,iBAAiB;IACjB,iBAAiB;IACjB,OAAO;IACP,QAAQ;IACR,kBAAkB;IAClB,wBAAwB;IACxB,cAAc;IACd,OAAO;CACR,CAAC;AAaF,MAAM,CAAC,MAAM,mBAAmB,GAAoC;IAClE,UAAU;IACV,KAAK;IACL,WAAW;IACX,YAAY;IACZ,UAAU;CACX,CAAC;AA6BF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IACnC,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAChD,OAAO,EAAE,qDAAqD;KAC/D,CAAC;IACJ,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAyD,CAAC;IACjF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAgE,CAAC;IAChF,UAAU,EAAE,yBAAyB;IACrC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,uBAAuB;CACtC,CAAC,CAAC"}