@empressaio/atom-contract 1.7.0

package/dist/og/fixtures.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Sample fixtures for O&G atom types per ADR-025.
+ * Used in conformance tests and as documentation examples.
+ */
+import type { WellAtomInstance } from "./well.js";
+import type { WellboreAtomInstance } from "./wellbore.js";
+import type { CompletionAtomInstance } from "./completion.js";
+import type { ZoneAtomInstance } from "./zone.js";
+import type { PadAtomInstance } from "./pad.js";
+import type { ProductionTimeseriesAtomInstance } from "./production-timeseries.js";
+import type { EquipmentStateAtomInstance } from "./equipment-state.js";
+import type { MineralLeaseAtomInstance } from "./mineral-lease.js";
+import type { RrcLeaseAtomInstance } from "./rrc-lease.js";
+import type { TractAtomInstance } from "./tract.js";
+import type { OwnershipInterestAtomInstance } from "./ownership-interest.js";
+import type { RevenueAllocationUnitAtomInstance } from "./revenue-allocation-unit.js";
+export declare const SAMPLE_WELL: WellAtomInstance;
+export declare const SAMPLE_WELLBORE: WellboreAtomInstance;
+export declare const SAMPLE_COMPLETION: CompletionAtomInstance;
+export declare const SAMPLE_ZONE: ZoneAtomInstance;
+export declare const SAMPLE_PAD: PadAtomInstance;
+export declare const SAMPLE_PRODUCTION_TIMESERIES: ProductionTimeseriesAtomInstance;
+export declare const SAMPLE_EQUIPMENT_STATE: EquipmentStateAtomInstance;
+export declare const SAMPLE_MINERAL_LEASE: MineralLeaseAtomInstance;
+export declare const SAMPLE_RRC_LEASE: RrcLeaseAtomInstance;
+export declare const SAMPLE_TRACT: TractAtomInstance;
+export declare const SAMPLE_OWNERSHIP_INTEREST: OwnershipInterestAtomInstance;
+/**
+ * Sample pooled-unit sourced from recorded instruments with ratifications.
+ * Per ADR-025 Herbert review: unit-designation + ratifications from ≥65% in
+ * interest per tract (Opiela evidentiary pattern).
+ */
+export declare const SAMPLE_POOLED_UNIT: RevenueAllocationUnitAtomInstance;
+/**
+ * Sample allocation-well sourced from RRC plat with per-tract take points and
+ * productive lateral footage. Per ADR-025: no county pooling instrument exists
+ * for allocation wells; absence is a signal, never "missing data."
+ */
+export declare const SAMPLE_ALLOCATION_WELL_UNIT: RevenueAllocationUnitAtomInstance;
+//# sourceMappingURL=fixtures.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/og/fixtures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,8BAA8B,CAAC;AAEtF,eAAO,MAAM,WAAW,EAAE,gBAmBzB,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,oBAa7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,sBAa/B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,gBASzB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,eAWxB,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,gCAa1C,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,0BAWpC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,wBA0BlC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,oBAe9B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,iBAa1B,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,6BAgBvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,iCAmChC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,EAAE,iCAgCzC,CAAC"}

package/dist/og/fixtures.js

@@ -0,0 +1,255 @@
+/**
+ * Sample fixtures for O&G atom types per ADR-025.
+ * Used in conformance tests and as documentation examples.
+ */
+import { createOgAssertedConfidence } from "./common.js";
+export const SAMPLE_WELL = {
+    entityType: "well",
+    wellDid: "well_42001300010000",
+    apiNumber14: "42-001-30001-0000",
+    wellName: "Sample Well #1",
+    wellNumber: "1",
+    wellType: "oil",
+    status: "active",
+    spudDate: "2024-01-15",
+    completionDate: "2024-02-20",
+    totalDepth: 8500,
+    surfaceLocation: { latitude: 31.5, longitude: -102.1, datum: "WGS84" },
+    bottomholeLocation: { latitude: 31.49, longitude: -102.08, datum: "WGS84" },
+    fieldRef: { fieldName: "Sample Field", fieldNumber: "12345" },
+    district: "08",
+    sourceCitation: "RRC PDQ 2024-Q1",
+    extractedAt: "2024-03-01T12:00:00Z",
+    asOf: "2024-02-20",
+    accessPolicy: "public-free",
+};
+export const SAMPLE_WELLBORE = {
+    entityType: "wellbore",
+    wellboreDid: "wbore_a1b2c3d4e5f6a7b8",
+    wellDid: "well_42001300010000",
+    sidetrackSequence: 0,
+    directionalSurveyCid: "bafyk1234567890abcdef",
+    lateralPathRef: "bafyk0987654321fedcba",
+    kickoffDepth: 7200,
+    measuredDepth: 12500,
+    sourceCitation: "RRC W-2 2024-001",
+    extractedAt: "2024-03-01T12:00:00Z",
+    asOf: "2024-02-20",
+    accessPolicy: "public-free",
+};
+export const SAMPLE_COMPLETION = {
+    entityType: "completion",
+    completionDid: "cmpl_1a2b3c4d5e6f7a8b",
+    wellboreDid: "wbore_a1b2c3d4e5f6a7b8",
+    completionDate: "2024-02-20",
+    perforatedIntervals: [
+        { topDepth: 8200, bottomDepth: 8300, zoneDid: "zone_0123456789abcdef" },
+        { topDepth: 8400, bottomDepth: 8500, zoneDid: "zone_fedcba9876543210" },
+    ],
+    sourceCitation: "RRC W-2 2024-001",
+    extractedAt: "2024-03-01T12:00:00Z",
+    asOf: "2024-02-20",
+    accessPolicy: "public-free",
+};
+export const SAMPLE_ZONE = {
+    entityType: "zone",
+    zoneDid: "zone_0123456789abcdef",
+    formationName: "Wolfcamp A",
+    tops: 8150,
+    sourceCitation: "Texas Geological Survey 2023",
+    extractedAt: "2024-01-01T00:00:00Z",
+    asOf: "2023-12-31",
+    accessPolicy: "public-free",
+};
+export const SAMPLE_PAD = {
+    entityType: "pad",
+    padDid: "pad_0123456789abcdef",
+    wellDids: ["well_42001300010000", "well_42001300020000"],
+    surfaceLocation: { latitude: 31.5, longitude: -102.1, datum: "WGS84" },
+    derivationMethod: "proximity-clustering-100m",
+    confidence: createOgAssertedConfidence(0.95),
+    sourceCitation: "Derived from RRC well locations",
+    extractedAt: "2024-03-01T12:00:00Z",
+    asOf: "2024-02-20",
+    accessPolicy: "public-free",
+};
+export const SAMPLE_PRODUCTION_TIMESERIES = {
+    entityType: "production-timeseries",
+    streamDid: "prodts_0123456789abcdef",
+    streamKind: "reported",
+    anchorKind: "rrc-lease",
+    anchorDid: "rrclease_08-12345",
+    product: "oil",
+    granularity: "monthly",
+    sourceAdapter: "RRC-PDQ-EBCDIC",
+    sourceCitation: "RRC PDQ 2024-Q1",
+    extractedAt: "2024-03-01T12:00:00Z",
+    asOf: "2024-02-29",
+    accessPolicy: "public-free",
+};
+export const SAMPLE_EQUIPMENT_STATE = {
+    entityType: "equipment-state",
+    equipmentDid: "equip_0123456789abcdef",
+    wellDid: "well_42001300010000",
+    equipmentKind: "rod-pump",
+    stateSnapshot: { strokesPerMinute: 12, fillage: 0.85, runtime: "active" },
+    telemetryStreamRefs: ["stream_scada_001"],
+    sourceCitation: "SCADA historian",
+    extractedAt: "2024-03-15T08:00:00Z",
+    asOf: "2024-03-15T08:00:00Z",
+    accessPolicy: "tenant-private",
+};
+export const SAMPLE_MINERAL_LEASE = {
+    entityType: "mineral-lease",
+    leaseDid: "mlease_0123456789abcdef",
+    lessorActorDids: ["actor_lessor_001"],
+    lesseeActorDid: "actor_lessee_001",
+    evidencedByInstrumentDids: ["instr_recorded_001"],
+    primaryTerm: "3 years",
+    effectiveDate: "2022-01-01",
+    royaltyFraction: 0.25,
+    bonusPerAcre: 500,
+    clauseExtracts: [
+        {
+            clauseType: "shut-in",
+            extractedText: "Lessee may pay shut-in royalty...",
+            confidence: createOgAssertedConfidence(0.9),
+            sourceCitation: "Instrument page 3",
+            sourceInstrumentDid: "instr_recorded_001",
+            pageRef: "3",
+        },
+    ],
+    tractDids: ["tract_Reeves-123"],
+    status: "hbp",
+    sourceCitation: "County records + landman book",
+    extractedAt: "2024-03-01T12:00:00Z",
+    asOf: "2024-02-20",
+    accessPolicy: "tenant-private",
+};
+export const SAMPLE_RRC_LEASE = {
+    entityType: "rrc-lease",
+    rrcLeaseDid: "rrclease_08-12345",
+    leaseNumber: "12345",
+    leaseName: "Sample Lease",
+    district: "08",
+    fieldRef: { fieldName: "Sample Field", fieldNumber: "12345" },
+    operatorActorDid: "actor_operator_001",
+    wellCount: 5,
+    status: "active",
+    acreage: 640,
+    sourceCitation: "RRC Public Query 2024-Q1",
+    extractedAt: "2024-03-01T12:00:00Z",
+    asOf: "2024-02-29",
+    accessPolicy: "public-free",
+};
+export const SAMPLE_TRACT = {
+    entityType: "tract",
+    tractDid: "tract_Reeves-123",
+    legalDescription: "Section 12, Block 50, Township 5 South",
+    plssOrSurveyRef: "TTRR Survey",
+    abstractNumber: "123",
+    county: "Reeves",
+    state: "TX",
+    acreage: 640,
+    sourceCitation: "County records",
+    extractedAt: "2024-03-01T12:00:00Z",
+    asOf: "2024-02-20",
+    accessPolicy: "public-free",
+};
+export const SAMPLE_OWNERSHIP_INTEREST = {
+    entityType: "ownership-interest",
+    interestDid: "intr_0123456789abcdef",
+    interestType: "mineral",
+    ownerActorDid: "actor_owner_001",
+    anchorTractDid: "tract_Reeves-123",
+    decimalInterest: 0.125,
+    fraction: "1/8",
+    effectiveFrom: "2020-01-01",
+    derivedFromInstrumentDids: ["instr_deed_001", "instr_deed_002"],
+    gaps: ["Missing link between 1995 and 2000"],
+    confidence: createOgAssertedConfidence(0.85),
+    sourceCitation: "Run sheet analysis",
+    extractedAt: "2024-03-01T12:00:00Z",
+    asOf: "2024-02-20",
+    accessPolicy: "tenant-private",
+};
+/**
+ * Sample pooled-unit sourced from recorded instruments with ratifications.
+ * Per ADR-025 Herbert review: unit-designation + ratifications from ≥65% in
+ * interest per tract (Opiela evidentiary pattern).
+ */
+export const SAMPLE_POOLED_UNIT = {
+    entityType: "revenue-allocation-unit",
+    unitDid: "unit_0123456789abcdef",
+    basis: "pooled-unit",
+    wellDids: ["well_42001300010000", "well_42001300020000"],
+    operatorActorDid: "actor_operator_001",
+    effectiveFrom: "2023-01-01",
+    tractParticipations: [
+        {
+            tractDid: "tract_Reeves-123",
+            factor: 0.65,
+            allocationMethod: "stated-fraction",
+            source: "Unit Designation 2023-001",
+            confidence: createOgAssertedConfidence(0.9),
+        },
+        {
+            tractDid: "tract_Reeves-124",
+            factor: 0.35,
+            allocationMethod: "acreage",
+            source: "Unit Designation 2023-001",
+            confidence: createOgAssertedConfidence(0.9),
+        },
+    ],
+    sourceInstrumentDids: ["instr_unit_designation_001"],
+    ratificationInstrumentDids: ["instr_ratification_001", "instr_ratification_002"],
+    ratificationGaps: [
+        {
+            tractDid: "tract_Reeves-124",
+            gapDescription: "Ratification pending for 15% interest holder",
+        },
+    ],
+    sourceCitation: "Reeves County Records, Book 500 Page 123",
+    extractedAt: "2024-03-01T12:00:00Z",
+    asOf: "2024-02-20",
+    accessPolicy: "public-free",
+};
+/**
+ * Sample allocation-well sourced from RRC plat with per-tract take points and
+ * productive lateral footage. Per ADR-025: no county pooling instrument exists
+ * for allocation wells; absence is a signal, never "missing data."
+ */
+export const SAMPLE_ALLOCATION_WELL_UNIT = {
+    entityType: "revenue-allocation-unit",
+    unitDid: "unit_fedcba9876543210",
+    basis: "allocation-well",
+    wellDids: ["well_42001300030000"],
+    operatorActorDid: "actor_operator_001",
+    effectiveFrom: "2024-02-01",
+    tractParticipations: [
+        {
+            tractDid: "tract_Reeves-123",
+            factor: 0.58,
+            allocationMethod: "lateral-length",
+            source: "RRC W-1 allocation attachment, plat 2024-03-001",
+            confidence: createOgAssertedConfidence(0.95),
+            takePoints: 2,
+            productiveLateralFootage: 4850,
+        },
+        {
+            tractDid: "tract_Reeves-125",
+            factor: 0.42,
+            allocationMethod: "lateral-length",
+            source: "RRC W-1 allocation attachment, plat 2024-03-001",
+            confidence: createOgAssertedConfidence(0.95),
+            takePoints: 1,
+            productiveLateralFootage: 3510,
+        },
+    ],
+    sourcePlatCid: "bafyk_allocation_plat_2024_03_001",
+    sourceCitation: "RRC W-1 allocation attachment + as-drilled plat",
+    extractedAt: "2024-03-10T12:00:00Z",
+    asOf: "2024-03-01",
+    accessPolicy: "public-free",
+};
+//# sourceMappingURL=fixtures.js.map

package/dist/og/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/og/fixtures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAczD,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,qBAAqB;IAC9B,WAAW,EAAE,mBAAmB;IAChC,QAAQ,EAAE,gBAAgB;IAC1B,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,YAAY;IACtB,cAAc,EAAE,YAAY;IAC5B,UAAU,EAAE,IAAI;IAChB,eAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE;IACtE,kBAAkB,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE;IAC3E,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE;IAC7D,QAAQ,EAAE,IAAI;IACd,cAAc,EAAE,iBAAiB;IACjC,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,aAAa;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAyB;IACnD,UAAU,EAAE,UAAU;IACtB,WAAW,EAAE,wBAAwB;IACrC,OAAO,EAAE,qBAAqB;IAC9B,iBAAiB,EAAE,CAAC;IACpB,oBAAoB,EAAE,uBAAuB;IAC7C,cAAc,EAAE,uBAAuB;IACvC,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,KAAK;IACpB,cAAc,EAAE,kBAAkB;IAClC,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,aAAa;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,uBAAuB;IACtC,WAAW,EAAE,wBAAwB;IACrC,cAAc,EAAE,YAAY;IAC5B,mBAAmB,EAAE;QACnB,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,uBAAuB,EAAE;QACvE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,uBAAuB,EAAE;KACxE;IACD,cAAc,EAAE,kBAAkB;IAClC,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,aAAa;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,UAAU,EAAE,MAAM;IAClB,OAAO,EAAE,uBAAuB;IAChC,aAAa,EAAE,YAAY;IAC3B,IAAI,EAAE,IAAI;IACV,cAAc,EAAE,8BAA8B;IAC9C,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,aAAa;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAoB;IACzC,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,sBAAsB;IAC9B,QAAQ,EAAE,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;IACxD,eAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE;IACtE,gBAAgB,EAAE,2BAA2B;IAC7C,UAAU,EAAE,0BAA0B,CAAC,IAAI,CAAC;IAC5C,cAAc,EAAE,iCAAiC;IACjD,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,aAAa;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAqC;IAC5E,UAAU,EAAE,uBAAuB;IACnC,SAAS,EAAE,yBAAyB;IACpC,UAAU,EAAE,UAAU;IACtB,UAAU,EAAE,WAAW;IACvB,SAAS,EAAE,mBAAmB;IAC9B,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,gBAAgB;IAC/B,cAAc,EAAE,iBAAiB;IACjC,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,aAAa;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAA+B;IAChE,UAAU,EAAE,iBAAiB;IAC7B,YAAY,EAAE,wBAAwB;IACtC,OAAO,EAAE,qBAAqB;IAC9B,aAAa,EAAE,UAAU;IACzB,aAAa,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE;IACzE,mBAAmB,EAAE,CAAC,kBAAkB,CAAC;IACzC,cAAc,EAAE,iBAAiB;IACjC,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,sBAAsB;IAC5B,YAAY,EAAE,gBAAgB;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAA6B;IAC5D,UAAU,EAAE,eAAe;IAC3B,QAAQ,EAAE,yBAAyB;IACnC,eAAe,EAAE,CAAC,kBAAkB,CAAC;IACrC,cAAc,EAAE,kBAAkB;IAClC,yBAAyB,EAAE,CAAC,oBAAoB,CAAC;IACjD,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,YAAY;IAC3B,eAAe,EAAE,IAAI;IACrB,YAAY,EAAE,GAAG;IACjB,cAAc,EAAE;QACd;YACE,UAAU,EAAE,SAAS;YACrB,aAAa,EAAE,mCAAmC;YAClD,UAAU,EAAE,0BAA0B,CAAC,GAAG,CAAC;YAC3C,cAAc,EAAE,mBAAmB;YACnC,mBAAmB,EAAE,oBAAoB;YACzC,OAAO,EAAE,GAAG;SACb;KACF;IACD,SAAS,EAAE,CAAC,kBAAkB,CAAC;IAC/B,MAAM,EAAE,KAAK;IACb,cAAc,EAAE,+BAA+B;IAC/C,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,gBAAgB;CAC/B,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAyB;IACpD,UAAU,EAAE,WAAW;IACvB,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,OAAO;IACpB,SAAS,EAAE,cAAc;IACzB,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE;IAC7D,gBAAgB,EAAE,oBAAoB;IACtC,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,GAAG;IACZ,cAAc,EAAE,0BAA0B;IAC1C,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,aAAa;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAsB;IAC7C,UAAU,EAAE,OAAO;IACnB,QAAQ,EAAE,kBAAkB;IAC5B,gBAAgB,EAAE,wCAAwC;IAC1D,eAAe,EAAE,aAAa;IAC9B,cAAc,EAAE,KAAK;IACrB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,GAAG;IACZ,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,aAAa;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAkC;IACtE,UAAU,EAAE,oBAAoB;IAChC,WAAW,EAAE,uBAAuB;IACpC,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,iBAAiB;IAChC,cAAc,EAAE,kBAAkB;IAClC,eAAe,EAAE,KAAK;IACtB,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,YAAY;IAC3B,yBAAyB,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC/D,IAAI,EAAE,CAAC,oCAAoC,CAAC;IAC5C,UAAU,EAAE,0BAA0B,CAAC,IAAI,CAAC;IAC5C,cAAc,EAAE,oBAAoB;IACpC,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,gBAAgB;CAC/B,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsC;IACnE,UAAU,EAAE,yBAAyB;IACrC,OAAO,EAAE,uBAAuB;IAChC,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;IACxD,gBAAgB,EAAE,oBAAoB;IACtC,aAAa,EAAE,YAAY;IAC3B,mBAAmB,EAAE;QACnB;YACE,QAAQ,EAAE,kBAAkB;YAC5B,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,iBAAiB;YACnC,MAAM,EAAE,2BAA2B;YACnC,UAAU,EAAE,0BAA0B,CAAC,GAAG,CAAC;SAC5C;QACD;YACE,QAAQ,EAAE,kBAAkB;YAC5B,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,SAAS;YAC3B,MAAM,EAAE,2BAA2B;YACnC,UAAU,EAAE,0BAA0B,CAAC,GAAG,CAAC;SAC5C;KACF;IACD,oBAAoB,EAAE,CAAC,4BAA4B,CAAC;IACpD,0BAA0B,EAAE,CAAC,wBAAwB,EAAE,wBAAwB,CAAC;IAChF,gBAAgB,EAAE;QAChB;YACE,QAAQ,EAAE,kBAAkB;YAC5B,cAAc,EAAE,8CAA8C;SAC/D;KACF;IACD,cAAc,EAAE,0CAA0C;IAC1D,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,aAAa;CAC5B,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAsC;IAC5E,UAAU,EAAE,yBAAyB;IACrC,OAAO,EAAE,uBAAuB;IAChC,KAAK,EAAE,iBAAiB;IACxB,QAAQ,EAAE,CAAC,qBAAqB,CAAC;IACjC,gBAAgB,EAAE,oBAAoB;IACtC,aAAa,EAAE,YAAY;IAC3B,mBAAmB,EAAE;QACnB;YACE,QAAQ,EAAE,kBAAkB;YAC5B,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,gBAAgB;YAClC,MAAM,EAAE,iDAAiD;YACzD,UAAU,EAAE,0BAA0B,CAAC,IAAI,CAAC;YAC5C,UAAU,EAAE,CAAC;YACb,wBAAwB,EAAE,IAAI;SAC/B;QACD;YACE,QAAQ,EAAE,kBAAkB;YAC5B,MAAM,EAAE,IAAI;YACZ,gBAAgB,EAAE,gBAAgB;YAClC,MAAM,EAAE,iDAAiD;YACzD,UAAU,EAAE,0BAA0B,CAAC,IAAI,CAAC;YAC5C,UAAU,EAAE,CAAC;YACb,wBAAwB,EAAE,IAAI;SAC/B;KACF;IACD,aAAa,EAAE,mCAAmC;IAClD,cAAc,EAAE,iDAAiD;IACjE,WAAW,EAAE,sBAAsB;IACnC,IAAI,EAAE,YAAY;IAClB,YAAY,EAAE,aAAa;CAC5B,CAAC"}

package/dist/og/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ADR-025 O&G ontology atom type definitions.
+ *
+ * Import from `@empressaio/atom-contract/og`. obligation is core (ships in
+ * the main contract module, domain-neutral), but ./og re-exports it for
+ * convenience.
+ */
+export * from "./common.js";
+export * from "./well.js";
+export * from "./wellbore.js";
+export * from "./completion.js";
+export * from "./zone.js";
+export * from "./pad.js";
+export * from "./production-timeseries.js";
+export * from "./equipment-state.js";
+export * from "./mineral-lease.js";
+export * from "./rrc-lease.js";
+export * from "./tract.js";
+export * from "./ownership-interest.js";
+export * from "./revenue-allocation-unit.js";
+export * from "./fixtures.js";
+export { OBLIGATION_SCHEMA, OBLIGATION_STATUSES, OBLIGATION_TYPES, type ObligationAtomInstance, type ObligationStatus, type ObligationType, } from "../obligation.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/og/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC"}

package/dist/og/index.js

@@ -0,0 +1,23 @@
+/**
+ * ADR-025 O&G ontology atom type definitions.
+ *
+ * Import from `@empressaio/atom-contract/og`. obligation is core (ships in
+ * the main contract module, domain-neutral), but ./og re-exports it for
+ * convenience.
+ */
+export * from "./common.js";
+export * from "./well.js";
+export * from "./wellbore.js";
+export * from "./completion.js";
+export * from "./zone.js";
+export * from "./pad.js";
+export * from "./production-timeseries.js";
+export * from "./equipment-state.js";
+export * from "./mineral-lease.js";
+export * from "./rrc-lease.js";
+export * from "./tract.js";
+export * from "./ownership-interest.js";
+export * from "./revenue-allocation-unit.js";
+export * from "./fixtures.js";
+export { OBLIGATION_SCHEMA, OBLIGATION_STATUSES, OBLIGATION_TYPES, } from "../obligation.js";
+//# sourceMappingURL=index.js.map

package/dist/og/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/og/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,eAAe,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GAIjB,MAAM,kBAAkB,CAAC"}

package/dist/og/mineral-lease.d.ts

@@ -0,0 +1,150 @@
+import { z } from "zod";
+import type { AccessPolicy } from "../registration.js";
+import { type ClauseExtract, type MineralLeaseStatus } from "./common.js";
+/**
+ * Mineral-lease atom instance per ADR-025 — the title-instrument lease a
+ * landman manages. Reconciles with recorded-instrument (ADR-020):
+ * evidencedByInstrumentDids link to recorded-instrument atoms.
+ * DID format: mlease_<hash> (hashed derivation from source, externalId).
+ */
+export interface MineralLeaseAtomInstance {
+    entityType: "mineral-lease";
+    leaseDid: string;
+    lessorActorDids: ReadonlyArray<string>;
+    lesseeActorDid: string;
+    evidencedByInstrumentDids: ReadonlyArray<string>;
+    primaryTerm: string;
+    effectiveDate: string;
+    royaltyFraction: number;
+    bonusPerAcre?: number;
+    clauseExtracts?: ReadonlyArray<ClauseExtract>;
+    tractDids: ReadonlyArray<string>;
+    status: MineralLeaseStatus;
+    sourceCitation: string;
+    extractedAt: string;
+    asOf?: string;
+    accessPolicy: AccessPolicy;
+}
+export declare const MINERAL_LEASE_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<"mineral-lease">;
+    leaseDid: z.ZodEffects<z.ZodString, string, string>;
+    lessorActorDids: z.ZodArray<z.ZodString, "many">;
+    lesseeActorDid: z.ZodString;
+    evidencedByInstrumentDids: z.ZodArray<z.ZodString, "many">;
+    primaryTerm: z.ZodString;
+    effectiveDate: z.ZodString;
+    royaltyFraction: z.ZodNumber;
+    bonusPerAcre: z.ZodOptional<z.ZodNumber>;
+    clauseExtracts: z.ZodOptional<z.ZodArray<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;
+    }>, "many">>;
+    tractDids: z.ZodArray<z.ZodString, "many">;
+    status: z.ZodEnum<[MineralLeaseStatus, ...MineralLeaseStatus[]]>;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "mineral-lease";
+    status: MineralLeaseStatus;
+    sourceCitation: string;
+    extractedAt: string;
+    leaseDid: string;
+    lessorActorDids: string[];
+    lesseeActorDid: string;
+    evidencedByInstrumentDids: string[];
+    primaryTerm: string;
+    effectiveDate: string;
+    royaltyFraction: number;
+    tractDids: string[];
+    asOf?: string | undefined;
+    bonusPerAcre?: number | undefined;
+    clauseExtracts?: {
+        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;
+    }[] | undefined;
+}, {
+    accessPolicy: "public-free" | "public-paid" | "platform-internal" | "tenant-private" | "tenant-shared";
+    entityType: "mineral-lease";
+    status: MineralLeaseStatus;
+    sourceCitation: string;
+    extractedAt: string;
+    leaseDid: string;
+    lessorActorDids: string[];
+    lesseeActorDid: string;
+    evidencedByInstrumentDids: string[];
+    primaryTerm: string;
+    effectiveDate: string;
+    royaltyFraction: number;
+    tractDids: string[];
+    asOf?: string | undefined;
+    bonusPerAcre?: number | undefined;
+    clauseExtracts?: {
+        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;
+    }[] | undefined;
+}>;
+//# sourceMappingURL=mineral-lease.d.ts.map

package/dist/og/mineral-lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mineral-lease.d.ts","sourceRoot":"","sources":["../../src/og/mineral-lease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC9C,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsB/B,CAAC"}

package/dist/og/mineral-lease.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { CLAUSE_EXTRACT_SCHEMA, MINERAL_LEASE_STATUSES, OG_ACCESS_POLICY_SCHEMA, OG_QUALITY_GATE_FIELDS, } from "./common.js";
+export const MINERAL_LEASE_SCHEMA = z.object({
+    entityType: z.literal("mineral-lease"),
+    leaseDid: z
+        .string()
+        .min(1)
+        .refine((val) => /^mlease_[0-9a-f]{16}$/.test(val), {
+        message: "leaseDid must be in format mlease_<16-hex-chars>",
+    }),
+    lessorActorDids: z.array(z.string().min(1)).min(1),
+    lesseeActorDid: z.string().min(1),
+    evidencedByInstrumentDids: z.array(z.string().min(1)).min(1),
+    primaryTerm: z.string().min(1),
+    effectiveDate: z.string().min(1),
+    royaltyFraction: z.number(),
+    bonusPerAcre: z.number().optional(),
+    clauseExtracts: z.array(CLAUSE_EXTRACT_SCHEMA).optional(),
+    tractDids: z.array(z.string().min(1)),
+    status: z.enum(MINERAL_LEASE_STATUSES),
+    ...OG_QUALITY_GATE_FIELDS,
+    accessPolicy: OG_ACCESS_POLICY_SCHEMA,
+});
+//# sourceMappingURL=mineral-lease.js.map

package/dist/og/mineral-lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mineral-lease.js","sourceRoot":"","sources":["../../src/og/mineral-lease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,GAGvB,MAAM,aAAa,CAAC;AA2BrB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IACtC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAClD,OAAO,EAAE,kDAAkD;KAC5D,CAAC;IACJ,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,yBAAyB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;IACzD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,IAAI,CACZ,sBAAuE,CACxE;IACD,GAAG,sBAAsB;IACzB,YAAY,EAAE,uBAAuB;CACtC,CAAC,CAAC"}