@empressaio/atom-contract 1.7.0

package/dist/og/common.d.ts

@@ -0,0 +1,253 @@
+/**
+ * Shared O&G ontology substrate types per ADR-025.
+ *
+ * O&G atoms carry structured confidence, source citation, and access policy
+ * per the existing quality-gate discipline. Every confidence field is
+ * WidthedConfidence; bare scalars are unrepresentable.
+ *
+ * Link vocabulary (semantic edges between atoms):
+ * - `evidenced-by`: mineral-lease → recorded-instrument (the wet-document trail)
+ * - `regulatory-expression-of`: rrc-lease → mineral-lease (many-to-many mapping)
+ * - `derives-from`: derived stream → source stream; ownership-interest → instruments
+ * - `located-on`: well → tract
+ * - `assigned-to`: well → rrc-lease (oil wells; the reporting split)
+ * - `produces-from`: completion → zone
+ * - `subject-to`: tract → recorded-instrument
+ * - `reconciles-with`: computed DOI → obtained operator DOI / signed division order
+ *   (added 1.7.0, C1b; external assertion reconciled against computed value;
+ *   discrepancies surface as disputes, never silent overwrites)
+ *
+ * Links are semantic relationships described in ADR-025 and consumed by the
+ * graph traversal layer (ADR-010). This contract module defines atom types
+ * and schemas; link resolution is handled by downstream graph engines.
+ */
+import { z } from "zod";
+import type { NodeTypePrefix } from "../temporal/common.js";
+import { type WidthedConfidence } from "../read-contract/common.js";
+/**
+ * O&G access policy schema, derived from the canonical ACCESS_POLICY_SCHEMA.
+ * Per ADR-025, all O&G atoms use the same five-value access policy enum.
+ */
+export declare const OG_ACCESS_POLICY_SCHEMA: z.ZodEnum<["public-free", "public-paid", "platform-internal", "tenant-private", "tenant-shared"]>;
+/**
+ * Node-type prefixes registered additively for O&G atoms (ADR-025).
+ * well_, wbore_, cmpl_, zone_, pad_, mlease_, rrclease_, tract_, intr_,
+ * prodts_, equip_, unit_. (oblg_ is core, not ./og-specific.)
+ * Re-exported from the core registry to avoid parallel source of truth.
+ */
+export type OgNodeTypePrefix = Extract<NodeTypePrefix, "well_" | "wbore_" | "cmpl_" | "zone_" | "pad_" | "mlease_" | "rrclease_" | "tract_" | "intr_" | "prodts_" | "equip_" | "unit_">;
+export declare const OG_NODE_TYPE_PREFIXES: ReadonlyArray<OgNodeTypePrefix>;
+/**
+ * Well type classification per ADR-025 asset spine.
+ */
+export type WellType = "oil" | "gas" | "injection" | "disposal" | "dry" | "plugged";
+export declare const WELL_TYPES: ReadonlyArray<WellType>;
+/**
+ * Product classification for production-timeseries.
+ */
+export type ProductType = "oil" | "gas" | "water" | "injection";
+export declare const PRODUCT_TYPES: ReadonlyArray<ProductType>;
+/**
+ * Production stream anchor kind (lease vs well), modeling the reporting split
+ * per ADR-025: Texas oil production is reported at RRC lease level; gas is
+ * reported at well level.
+ */
+export type AnchorKind = "rrc-lease" | "well";
+export declare const ANCHOR_KINDS: ReadonlyArray<AnchorKind>;
+/**
+ * Production timeseries granularity.
+ */
+export type Granularity = "monthly" | "daily";
+export declare const GRANULARITIES: ReadonlyArray<Granularity>;
+/**
+ * Equipment kind for equipment-state atoms.
+ */
+export type EquipmentKind = "rod-pump" | "esp" | "gas-lift" | "plunger-lift" | "surface-facility" | "other";
+export declare const EQUIPMENT_KINDS: ReadonlyArray<EquipmentKind>;
+/**
+ * Mineral lease status per ADR-025. Status is engine-derived from obligation
+ * determinations.
+ */
+export type MineralLeaseStatus = "active" | "expired" | "released" | "hbp" | "disputed";
+export declare const MINERAL_LEASE_STATUSES: ReadonlyArray<MineralLeaseStatus>;
+/**
+ * Ownership interest type discriminator (ADR-025, single discriminated type).
+ */
+export type InterestType = "mineral" | "royalty" | "overriding-royalty" | "working" | "surface" | "npri";
+export declare const INTEREST_TYPES: ReadonlyArray<InterestType>;
+/**
+ * Geolocation with datum per ADR-025 (well surface/bottomhole locations).
+ */
+export declare const GEO_LOCATION_SCHEMA: z.ZodObject<{
+    latitude: z.ZodNumber;
+    longitude: z.ZodNumber;
+    datum: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    latitude: number;
+    longitude: number;
+    datum: string;
+}, {
+    latitude: number;
+    longitude: number;
+    datum: string;
+}>;
+export type GeoLocation = z.infer<typeof GEO_LOCATION_SCHEMA>;
+/**
+ * RRC field reference (field name and number).
+ */
+export declare const FIELD_REF_SCHEMA: z.ZodObject<{
+    fieldName: z.ZodString;
+    fieldNumber: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    fieldName: string;
+    fieldNumber: string;
+}, {
+    fieldName: string;
+    fieldNumber: string;
+}>;
+export type FieldRef = z.infer<typeof FIELD_REF_SCHEMA>;
+/**
+ * Perforated interval on a completion.
+ */
+export declare const PERFORATED_INTERVAL_SCHEMA: z.ZodObject<{
+    topDepth: z.ZodNumber;
+    bottomDepth: z.ZodNumber;
+    zoneDid: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    topDepth: number;
+    bottomDepth: number;
+    zoneDid?: string | undefined;
+}, {
+    topDepth: number;
+    bottomDepth: number;
+    zoneDid?: string | undefined;
+}>;
+export type PerforatedInterval = z.infer<typeof PERFORATED_INTERVAL_SCHEMA>;
+/**
+ * Clause extract bucket on mineral-lease (typed: shut-in, Pugh, continuous
+ * development, depth severance). Each extract carries confidence +
+ * sourceCitation into the instrument and page.
+ */
+export interface ClauseExtract {
+    clauseType: "shut-in" | "pugh" | "continuous-development" | "depth-severance";
+    extractedText: string;
+    confidence: WidthedConfidence;
+    sourceCitation: string;
+    sourceInstrumentDid: string;
+    pageRef?: string;
+}
+export declare const CLAUSE_EXTRACT_SCHEMA: z.ZodObject<{
+    clauseType: z.ZodEnum<["shut-in", "pugh", "continuous-development", "depth-severance"]>;
+    extractedText: z.ZodString;
+    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;
+    sourceInstrumentDid: z.ZodString;
+    pageRef: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    clauseType: "shut-in" | "pugh" | "continuous-development" | "depth-severance";
+    extractedText: string;
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    sourceCitation: string;
+    sourceInstrumentDid: string;
+    pageRef?: string | undefined;
+}, {
+    clauseType: "shut-in" | "pugh" | "continuous-development" | "depth-severance";
+    extractedText: string;
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    sourceCitation: string;
+    sourceInstrumentDid: string;
+    pageRef?: string | undefined;
+}>;
+/**
+ * Quality gate fields: sourceCitation, extractedAt/asOf per ADR-025.
+ * Every O&G atom carries these fields. Confidence is included separately
+ * on types that reason from other atoms (ownership-interest, obligation).
+ */
+export declare const OG_QUALITY_GATE_FIELDS: {
+    readonly sourceCitation: z.ZodString;
+    readonly extractedAt: z.ZodString;
+    readonly asOf: z.ZodOptional<z.ZodString>;
+};
+/**
+ * Asserted confidence for O&G extracts at activation. Per ADR-025, the entire
+ * domain is uncalibrated at launch; every confidence ships
+ * `provenance: "asserted"` with its source named.
+ */
+export declare function createOgAssertedConfidence(estimate: number): WidthedConfidence;
+/**
+ * Recommended render modes for O&G atom registrations.
+ */
+export declare const OG_RENDER_MODES: {
+    well: readonly ["card", "compact", "expanded"];
+    wellbore: readonly ["card", "compact", "expanded"];
+    completion: readonly ["card", "compact", "expanded"];
+    zone: readonly ["card", "compact"];
+    pad: readonly ["card", "compact", "expanded"];
+    "production-timeseries": readonly ["card", "compact", "expanded"];
+    "equipment-state": readonly ["card", "compact", "expanded"];
+    "mineral-lease": readonly ["card", "compact", "expanded", "focus"];
+    "rrc-lease": readonly ["card", "compact", "expanded"];
+    tract: readonly ["card", "compact", "expanded"];
+    "ownership-interest": readonly ["card", "compact", "expanded", "focus"];
+    "revenue-allocation-unit": readonly ["card", "compact", "expanded", "focus"];
+};
+export declare const OG_DEFAULT_RENDER_MODE: {
+    readonly well: "card";
+    readonly wellbore: "card";
+    readonly completion: "card";
+    readonly zone: "card";
+    readonly pad: "card";
+    readonly "production-timeseries": "card";
+    readonly "equipment-state": "card";
+    readonly "mineral-lease": "focus";
+    readonly "rrc-lease": "card";
+    readonly tract: "card";
+    readonly "ownership-interest": "focus";
+    readonly "revenue-allocation-unit": "card";
+};
+/**
+ * Default access policies per ADR-025. Public regulatory data is public-free;
+ * operator telemetry and land books are tenant-private. Obligation (core type,
+ * domain-neutral) defaults to tenant-private per operator ruling 3.
+ */
+export declare const OG_DEFAULT_ACCESS_POLICY: {
+    readonly well: "public-free";
+    readonly wellbore: "public-free";
+    readonly completion: "public-free";
+    readonly zone: "public-free";
+    readonly pad: "public-free";
+    readonly "production-timeseries": "public-free";
+    readonly "equipment-state": "tenant-private";
+    readonly "mineral-lease": "tenant-private";
+    readonly "rrc-lease": "public-free";
+    readonly tract: "public-free";
+    readonly "ownership-interest": "tenant-private";
+    readonly "revenue-allocation-unit": "public-free";
+    readonly obligation: "tenant-private";
+};
+//# sourceMappingURL=common.d.ts.map

package/dist/og/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/og/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AAGpC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,mGAAuB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CACpC,cAAc,EACZ,OAAO,GACP,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,SAAS,GACT,WAAW,GACX,QAAQ,GACR,OAAO,GACP,SAAS,GACT,QAAQ,GACR,OAAO,CACV,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,gBAAgB,CAajE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,KAAK,GACL,KAAK,GACL,WAAW,GACX,UAAU,GACV,KAAK,GACL,SAAS,CAAC;AAEd,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,QAAQ,CAO9C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,CAAC;AAEhE,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,WAAW,CAKpD,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAE9C,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,UAAU,CAAyB,CAAC;AAE7E;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9C,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,WAAW,CAAwB,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,KAAK,GACL,UAAU,GACV,cAAc,GACd,kBAAkB,GAClB,OAAO,CAAC;AAEZ,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,aAAa,CAOxD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,UAAU,CAAC;AAExF,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,kBAAkB,CAMpE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,oBAAoB,GACpB,SAAS,GACT,SAAS,GACT,MAAM,CAAC;AAEX,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,YAAY,CAOtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAI9B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;EAG3B,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAIrC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,SAAS,GAAG,MAAM,GAAG,wBAAwB,GAAG,iBAAiB,CAAC;IAC9E,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYhC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAO9E;AAED;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAauB,CAAC;AAEpD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAaU,CAAC;AAE9C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;CAcY,CAAC"}

package/dist/og/common.js

@@ -0,0 +1,195 @@
+/**
+ * Shared O&G ontology substrate types per ADR-025.
+ *
+ * O&G atoms carry structured confidence, source citation, and access policy
+ * per the existing quality-gate discipline. Every confidence field is
+ * WidthedConfidence; bare scalars are unrepresentable.
+ *
+ * Link vocabulary (semantic edges between atoms):
+ * - `evidenced-by`: mineral-lease → recorded-instrument (the wet-document trail)
+ * - `regulatory-expression-of`: rrc-lease → mineral-lease (many-to-many mapping)
+ * - `derives-from`: derived stream → source stream; ownership-interest → instruments
+ * - `located-on`: well → tract
+ * - `assigned-to`: well → rrc-lease (oil wells; the reporting split)
+ * - `produces-from`: completion → zone
+ * - `subject-to`: tract → recorded-instrument
+ * - `reconciles-with`: computed DOI → obtained operator DOI / signed division order
+ *   (added 1.7.0, C1b; external assertion reconciled against computed value;
+ *   discrepancies surface as disputes, never silent overwrites)
+ *
+ * Links are semantic relationships described in ADR-025 and consumed by the
+ * graph traversal layer (ADR-010). This contract module defines atom types
+ * and schemas; link resolution is handled by downstream graph engines.
+ */
+import { z } from "zod";
+import { createWidthedConfidence, WIDTHED_CONFIDENCE_SCHEMA, } from "../read-contract/common.js";
+import { ACCESS_POLICY_SCHEMA } from "../conformance/common.js";
+/**
+ * O&G access policy schema, derived from the canonical ACCESS_POLICY_SCHEMA.
+ * Per ADR-025, all O&G atoms use the same five-value access policy enum.
+ */
+export const OG_ACCESS_POLICY_SCHEMA = ACCESS_POLICY_SCHEMA;
+export const OG_NODE_TYPE_PREFIXES = [
+    "well_",
+    "wbore_",
+    "cmpl_",
+    "zone_",
+    "pad_",
+    "mlease_",
+    "rrclease_",
+    "tract_",
+    "intr_",
+    "prodts_",
+    "equip_",
+    "unit_",
+];
+export const WELL_TYPES = [
+    "oil",
+    "gas",
+    "injection",
+    "disposal",
+    "dry",
+    "plugged",
+];
+export const PRODUCT_TYPES = [
+    "oil",
+    "gas",
+    "water",
+    "injection",
+];
+export const ANCHOR_KINDS = ["rrc-lease", "well"];
+export const GRANULARITIES = ["monthly", "daily"];
+export const EQUIPMENT_KINDS = [
+    "rod-pump",
+    "esp",
+    "gas-lift",
+    "plunger-lift",
+    "surface-facility",
+    "other",
+];
+export const MINERAL_LEASE_STATUSES = [
+    "active",
+    "expired",
+    "released",
+    "hbp",
+    "disputed",
+];
+export const INTEREST_TYPES = [
+    "mineral",
+    "royalty",
+    "overriding-royalty",
+    "working",
+    "surface",
+    "npri",
+];
+/**
+ * Geolocation with datum per ADR-025 (well surface/bottomhole locations).
+ */
+export const GEO_LOCATION_SCHEMA = z.object({
+    latitude: z.number(),
+    longitude: z.number(),
+    datum: z.string().min(1),
+});
+/**
+ * RRC field reference (field name and number).
+ */
+export const FIELD_REF_SCHEMA = z.object({
+    fieldName: z.string().min(1),
+    fieldNumber: z.string().min(1),
+});
+/**
+ * Perforated interval on a completion.
+ */
+export const PERFORATED_INTERVAL_SCHEMA = z.object({
+    topDepth: z.number(),
+    bottomDepth: z.number(),
+    zoneDid: z.string().min(1).optional(),
+});
+export const CLAUSE_EXTRACT_SCHEMA = z.object({
+    clauseType: z.enum([
+        "shut-in",
+        "pugh",
+        "continuous-development",
+        "depth-severance",
+    ]),
+    extractedText: z.string().min(1),
+    confidence: WIDTHED_CONFIDENCE_SCHEMA,
+    sourceCitation: z.string().min(1),
+    sourceInstrumentDid: z.string().min(1),
+    pageRef: z.string().min(1).optional(),
+});
+/**
+ * Quality gate fields: sourceCitation, extractedAt/asOf per ADR-025.
+ * Every O&G atom carries these fields. Confidence is included separately
+ * on types that reason from other atoms (ownership-interest, obligation).
+ */
+export const OG_QUALITY_GATE_FIELDS = {
+    sourceCitation: z.string().min(1),
+    extractedAt: z.string().min(1),
+    asOf: z.string().min(1).optional(),
+};
+/**
+ * Asserted confidence for O&G extracts at activation. Per ADR-025, the entire
+ * domain is uncalibrated at launch; every confidence ships
+ * `provenance: "asserted"` with its source named.
+ */
+export function createOgAssertedConfidence(estimate) {
+    return createWidthedConfidence({
+        estimate,
+        n: 0,
+        intervalWidth: 1,
+        provenance: "asserted",
+    });
+}
+/**
+ * Recommended render modes for O&G atom registrations.
+ */
+export const OG_RENDER_MODES = {
+    well: ["card", "compact", "expanded"],
+    wellbore: ["card", "compact", "expanded"],
+    completion: ["card", "compact", "expanded"],
+    zone: ["card", "compact"],
+    pad: ["card", "compact", "expanded"],
+    "production-timeseries": ["card", "compact", "expanded"],
+    "equipment-state": ["card", "compact", "expanded"],
+    "mineral-lease": ["card", "compact", "expanded", "focus"],
+    "rrc-lease": ["card", "compact", "expanded"],
+    tract: ["card", "compact", "expanded"],
+    "ownership-interest": ["card", "compact", "expanded", "focus"],
+    "revenue-allocation-unit": ["card", "compact", "expanded", "focus"],
+};
+export const OG_DEFAULT_RENDER_MODE = {
+    well: "card",
+    wellbore: "card",
+    completion: "card",
+    zone: "card",
+    pad: "card",
+    "production-timeseries": "card",
+    "equipment-state": "card",
+    "mineral-lease": "focus",
+    "rrc-lease": "card",
+    tract: "card",
+    "ownership-interest": "focus",
+    "revenue-allocation-unit": "card",
+};
+/**
+ * Default access policies per ADR-025. Public regulatory data is public-free;
+ * operator telemetry and land books are tenant-private. Obligation (core type,
+ * domain-neutral) defaults to tenant-private per operator ruling 3.
+ */
+export const OG_DEFAULT_ACCESS_POLICY = {
+    well: "public-free",
+    wellbore: "public-free",
+    completion: "public-free",
+    zone: "public-free",
+    pad: "public-free",
+    "production-timeseries": "public-free",
+    "equipment-state": "tenant-private",
+    "mineral-lease": "tenant-private",
+    "rrc-lease": "public-free",
+    tract: "public-free",
+    "ownership-interest": "tenant-private",
+    "revenue-allocation-unit": "public-free",
+    obligation: "tenant-private",
+};
+//# sourceMappingURL=common.js.map

package/dist/og/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/og/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAE1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAwB5D,MAAM,CAAC,MAAM,qBAAqB,GAAoC;IACpE,OAAO;IACP,QAAQ;IACR,OAAO;IACP,OAAO;IACP,MAAM;IACN,SAAS;IACT,WAAW;IACX,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,OAAO;CACR,CAAC;AAaF,MAAM,CAAC,MAAM,UAAU,GAA4B;IACjD,KAAK;IACL,KAAK;IACL,WAAW;IACX,UAAU;IACV,KAAK;IACL,SAAS;CACV,CAAC;AAOF,MAAM,CAAC,MAAM,aAAa,GAA+B;IACvD,KAAK;IACL,KAAK;IACL,OAAO;IACP,WAAW;CACZ,CAAC;AASF,MAAM,CAAC,MAAM,YAAY,GAA8B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAO7E,MAAM,CAAC,MAAM,aAAa,GAA+B,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AAa9E,MAAM,CAAC,MAAM,eAAe,GAAiC;IAC3D,UAAU;IACV,KAAK;IACL,UAAU;IACV,cAAc;IACd,kBAAkB;IAClB,OAAO;CACR,CAAC;AAQF,MAAM,CAAC,MAAM,sBAAsB,GAAsC;IACvE,QAAQ;IACR,SAAS;IACT,UAAU;IACV,KAAK;IACL,UAAU;CACX,CAAC;AAaF,MAAM,CAAC,MAAM,cAAc,GAAgC;IACzD,SAAS;IACT,SAAS;IACT,oBAAoB;IACpB,SAAS;IACT,SAAS;IACT,MAAM;CACP,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/B,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAkBH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC;QACjB,SAAS;QACT,MAAM;QACN,wBAAwB;QACxB,iBAAiB;KAClB,CAAC;IACF,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,UAAU,EAAE,yBAAyB;IACrC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,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;CAC1B,CAAC;AAEX;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,QAAgB;IACzD,OAAO,uBAAuB,CAAC;QAC7B,QAAQ;QACR,CAAC,EAAE,CAAC;QACJ,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,UAAU;KACvB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU;IAC9C,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU;IAClD,UAAU,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU;IACpD,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,CAAU;IAClC,GAAG,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU;IAC7C,uBAAuB,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU;IACjE,iBAAiB,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU;IAC3D,eAAe,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAU;IAClE,WAAW,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU;IACrD,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAU;IAC/C,oBAAoB,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAU;IACvE,yBAAyB,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,CAAU;CAC3B,CAAC;AAEpD,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,MAAM;IAClB,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,MAAM;IACX,uBAAuB,EAAE,MAAM;IAC/B,iBAAiB,EAAE,MAAM;IACzB,eAAe,EAAE,OAAO;IACxB,WAAW,EAAE,MAAM;IACnB,KAAK,EAAE,MAAM;IACb,oBAAoB,EAAE,OAAO;IAC7B,yBAAyB,EAAE,MAAM;CACU,CAAC;AAE9C;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE,aAAa;IACvB,UAAU,EAAE,aAAa;IACzB,IAAI,EAAE,aAAa;IACnB,GAAG,EAAE,aAAa;IAClB,uBAAuB,EAAE,aAAa;IACtC,iBAAiB,EAAE,gBAAgB;IACnC,eAAe,EAAE,gBAAgB;IACjC,WAAW,EAAE,aAAa;IAC1B,KAAK,EAAE,aAAa;IACpB,oBAAoB,EAAE,gBAAgB;IACtC,yBAAyB,EAAE,aAAa;IACxC,UAAU,EAAE,gBAAgB;CACmB,CAAC"}

package/dist/og/completion.d.ts

@@ -0,0 +1,70 @@
+import { z } from "zod";
+import type { AccessPolicy } from "../registration.js";
+import { type PerforatedInterval } from "./common.js";
+/**
+ * Completion atom instance per ADR-025 — perforated and completed intervals.
+ * DID format: cmpl_<hash> (hashed derivation from source, externalId).
+ */
+export interface CompletionAtomInstance {
+    entityType: "completion";
+    completionDid: string;
+    wellboreDid: string;
+    completionDate: string;
+    perforatedIntervals: ReadonlyArray<PerforatedInterval>;
+    sourceCitation: string;
+    extractedAt: string;
+    asOf?: string;
+    accessPolicy: AccessPolicy;
+}
+export declare const COMPLETION_SCHEMA: z.ZodObject<{
+    accessPolicy: z.ZodEnum<["public-free", "public-paid", "platform-internal", "tenant-private", "tenant-shared"]>;
+    sourceCitation: z.ZodString;
+    extractedAt: z.ZodString;
+    asOf: z.ZodOptional<z.ZodString>;
+    entityType: z.ZodLiteral<"completion">;
+    completionDid: z.ZodEffects<z.ZodString, string, string>;
+    wellboreDid: z.ZodEffects<z.ZodString, string, string>;
+    completionDate: z.ZodString;
+    perforatedIntervals: z.ZodArray<z.ZodObject<{
+        topDepth: z.ZodNumber;
+        bottomDepth: z.ZodNumber;
+        zoneDid: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        topDepth: number;
+        bottomDepth: number;
+        zoneDid?: string | undefined;
+    }, {
+        topDepth: number;
+        bottomDepth: number;
+        zoneDid?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "completion";
+    sourceCitation: string;
+    extractedAt: string;
+    completionDid: string;
+    wellboreDid: string;
+    completionDate: string;
+    perforatedIntervals: {
+        topDepth: number;
+        bottomDepth: number;
+        zoneDid?: string | undefined;
+    }[];
+    asOf?: string | undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "completion";
+    sourceCitation: string;
+    extractedAt: string;
+    completionDid: string;
+    wellboreDid: string;
+    completionDate: string;
+    perforatedIntervals: {
+        topDepth: number;
+        bottomDepth: number;
+        zoneDid?: string | undefined;
+    }[];
+    asOf?: string | undefined;
+}>;
+//# sourceMappingURL=completion.d.ts.map

package/dist/og/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/og/completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAIL,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,YAAY,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACvD,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB5B,CAAC"}

package/dist/og/completion.js

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { OG_ACCESS_POLICY_SCHEMA, OG_QUALITY_GATE_FIELDS, PERFORATED_INTERVAL_SCHEMA, } from "./common.js";
+export const COMPLETION_SCHEMA = z.object({
+    entityType: z.literal("completion"),
+    completionDid: z
+        .string()
+        .min(1)
+        .refine((val) => /^cmpl_[0-9a-f]{16}$/.test(val), {
+        message: "completionDid must be in format cmpl_<16-hex-chars>",
+    }),
+    wellboreDid: z
+        .string()
+        .min(1)
+        .refine((val) => /^wbore_[0-9a-f]{16}$/.test(val), {
+        message: "wellboreDid must be in format wbore_<16-hex-chars>",
+    }),
+    completionDate: z.string().min(1),
+    perforatedIntervals: z.array(PERFORATED_INTERVAL_SCHEMA),
+    ...OG_QUALITY_GATE_FIELDS,
+    accessPolicy: OG_ACCESS_POLICY_SCHEMA,
+});
+//# sourceMappingURL=completion.js.map

package/dist/og/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/og/completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,aAAa,CAAC;AAkBrB,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,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACjD,OAAO,EAAE,oDAAoD;KAC9D,CAAC;IACJ,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC;IACxD,GAAG,sBAAsB;IACzB,YAAY,EAAE,uBAAuB;CACtC,CAAC,CAAC"}

package/dist/og/equipment-state.d.ts

@@ -0,0 +1,55 @@
+import { z } from "zod";
+import type { AccessPolicy } from "../registration.js";
+import { type EquipmentKind } from "./common.js";
+/**
+ * Equipment-state atom instance per ADR-025 — artificial lift and surface
+ * equipment condition (operations lens, operator-overlay data).
+ * DID format: equip_<hash> (hashed derivation from source, externalId).
+ */
+export interface EquipmentStateAtomInstance {
+    entityType: "equipment-state";
+    equipmentDid: string;
+    wellDid: string;
+    equipmentKind: EquipmentKind;
+    stateSnapshot: Record<string, unknown>;
+    telemetryStreamRefs: ReadonlyArray<string>;
+    sourceCitation: string;
+    extractedAt: string;
+    asOf: string;
+    accessPolicy: AccessPolicy;
+}
+export declare const EQUIPMENT_STATE_SCHEMA: z.ZodObject<{
+    entityType: z.ZodLiteral<"equipment-state">;
+    equipmentDid: z.ZodEffects<z.ZodString, string, string>;
+    wellDid: z.ZodEffects<z.ZodString, string, string>;
+    equipmentKind: z.ZodEnum<[EquipmentKind, ...EquipmentKind[]]>;
+    stateSnapshot: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    telemetryStreamRefs: z.ZodArray<z.ZodString, "many">;
+    sourceCitation: z.ZodString;
+    extractedAt: z.ZodString;
+    asOf: 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: "equipment-state";
+    sourceCitation: string;
+    extractedAt: string;
+    asOf: string;
+    equipmentDid: string;
+    wellDid: string;
+    equipmentKind: EquipmentKind;
+    stateSnapshot: Record<string, unknown>;
+    telemetryStreamRefs: string[];
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "equipment-state";
+    sourceCitation: string;
+    extractedAt: string;
+    asOf: string;
+    equipmentDid: string;
+    wellDid: string;
+    equipmentKind: EquipmentKind;
+    stateSnapshot: Record<string, unknown>;
+    telemetryStreamRefs: string[];
+}>;
+//# sourceMappingURL=equipment-state.d.ts.map

package/dist/og/equipment-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equipment-state.d.ts","sourceRoot":"","sources":["../../src/og/equipment-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,mBAAmB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqBjC,CAAC"}

package/dist/og/equipment-state.js

@@ -0,0 +1,25 @@
+import { z } from "zod";
+import { EQUIPMENT_KINDS, OG_ACCESS_POLICY_SCHEMA, } from "./common.js";
+export const EQUIPMENT_STATE_SCHEMA = z.object({
+    entityType: z.literal("equipment-state"),
+    equipmentDid: z
+        .string()
+        .min(1)
+        .refine((val) => /^equip_[0-9a-f]{16}$/.test(val), {
+        message: "equipmentDid must be in format equip_<16-hex-chars>",
+    }),
+    wellDid: z
+        .string()
+        .min(1)
+        .refine((val) => val.startsWith("well_"), {
+        message: "wellDid must start with well_ prefix",
+    }),
+    equipmentKind: z.enum(EQUIPMENT_KINDS),
+    stateSnapshot: z.record(z.unknown()),
+    telemetryStreamRefs: z.array(z.string().min(1)),
+    sourceCitation: z.string().min(1),
+    extractedAt: z.string().min(1),
+    asOf: z.string().min(1),
+    accessPolicy: OG_ACCESS_POLICY_SCHEMA,
+});
+//# sourceMappingURL=equipment-state.js.map

package/dist/og/equipment-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"equipment-state.js","sourceRoot":"","sources":["../../src/og/equipment-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,eAAe,EACf,uBAAuB,GAExB,MAAM,aAAa,CAAC;AAoBrB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC;IACxC,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QACjD,OAAO,EAAE,qDAAqD;KAC/D,CAAC;IACJ,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE;QACxC,OAAO,EAAE,sCAAsC;KAChD,CAAC;IACJ,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,eAAsD,CAAC;IAC7E,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACpC,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/C,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;IACvB,YAAY,EAAE,uBAAuB;CACtC,CAAC,CAAC"}