@empressaio/atom-contract 1.7.0

package/dist/encumbrances/constraint-resolution.d.ts

@@ -0,0 +1,169 @@
+import { z } from "zod";
+import { type WidthedConfidence } from "../read-contract/common.js";
+import { type LegalWeight } from "./common.js";
+/** Basis atom cited in a resolved rule entry (ADR-021). */
+export type ResolutionBasis = "code-section" | "code-amendment" | "constraint-overlay" | "restriction-clause" | "administrative-rule";
+export declare const RESOLUTION_BASES: ReadonlyArray<ResolutionBasis>;
+export type ConflictStatus = "unresolved" | "resolved";
+export declare const CONFLICT_STATUSES: ReadonlyArray<ConflictStatus>;
+export interface ResolvedRuleEntry {
+    basis: ResolutionBasis;
+    basisCid: string;
+    ruleSummary: string;
+    precedenceRank: number;
+    confidence: WidthedConfidence;
+    legalWeight: LegalWeight;
+    precedenceReason: string;
+    evaluatedAt: string;
+}
+export interface ConstraintConflictEntry {
+    topic: string;
+    competingBasisCids: ReadonlyArray<string>;
+    status: ConflictStatus;
+    resolutionNote?: string;
+}
+export interface ConstraintResolutionAtomInstance {
+    entityType: "constraint-resolution";
+    /** Stable id for this resolution run (ADR-011 pattern). */
+    resolutionDid: string;
+    parcelDid: string;
+    resolvedAt: string;
+    rules: ReadonlyArray<ResolvedRuleEntry>;
+    conflicts: ReadonlyArray<ConstraintConflictEntry>;
+    procedureExecutionCid?: string;
+    accessPolicy?: "tenant-private" | "tenant-shared";
+}
+export declare const CONSTRAINT_RESOLUTION_SCHEMA: z.ZodObject<{
+    entityType: z.ZodLiteral<"constraint-resolution">;
+    resolutionDid: z.ZodString;
+    parcelDid: z.ZodString;
+    resolvedAt: z.ZodString;
+    rules: z.ZodArray<z.ZodObject<{
+        basis: z.ZodEnum<[ResolutionBasis, ...ResolutionBasis[]]>;
+        basisCid: z.ZodString;
+        ruleSummary: z.ZodString;
+        precedenceRank: z.ZodNumber;
+        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";
+        }>>;
+        legalWeight: z.ZodEnum<["recorded", "advisory"]>;
+        precedenceReason: z.ZodString;
+        evaluatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        legalWeight: "recorded" | "advisory";
+        evaluatedAt: string;
+        basis: ResolutionBasis;
+        basisCid: string;
+        ruleSummary: string;
+        precedenceRank: number;
+        precedenceReason: string;
+    }, {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        legalWeight: "recorded" | "advisory";
+        evaluatedAt: string;
+        basis: ResolutionBasis;
+        basisCid: string;
+        ruleSummary: string;
+        precedenceRank: number;
+        precedenceReason: string;
+    }>, "many">;
+    conflicts: z.ZodArray<z.ZodObject<{
+        topic: z.ZodString;
+        competingBasisCids: z.ZodArray<z.ZodString, "many">;
+        status: z.ZodEnum<[ConflictStatus, ...ConflictStatus[]]>;
+        resolutionNote: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: ConflictStatus;
+        topic: string;
+        competingBasisCids: string[];
+        resolutionNote?: string | undefined;
+    }, {
+        status: ConflictStatus;
+        topic: string;
+        competingBasisCids: string[];
+        resolutionNote?: string | undefined;
+    }>, "many">;
+    procedureExecutionCid: z.ZodOptional<z.ZodString>;
+    accessPolicy: z.ZodOptional<z.ZodEnum<["tenant-private", "tenant-shared"]>>;
+}, "strip", z.ZodTypeAny, {
+    entityType: "constraint-resolution";
+    resolutionDid: string;
+    parcelDid: string;
+    resolvedAt: string;
+    rules: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        legalWeight: "recorded" | "advisory";
+        evaluatedAt: string;
+        basis: ResolutionBasis;
+        basisCid: string;
+        ruleSummary: string;
+        precedenceRank: number;
+        precedenceReason: string;
+    }[];
+    conflicts: {
+        status: ConflictStatus;
+        topic: string;
+        competingBasisCids: string[];
+        resolutionNote?: string | undefined;
+    }[];
+    accessPolicy?: "tenant-private" | "tenant-shared" | undefined;
+    procedureExecutionCid?: string | undefined;
+}, {
+    entityType: "constraint-resolution";
+    resolutionDid: string;
+    parcelDid: string;
+    resolvedAt: string;
+    rules: {
+        confidence: Readonly<{
+            estimate: number;
+            n: number;
+            intervalWidth: number;
+            provenance: "asserted" | "backtest" | "seed" | "live";
+        }>;
+        legalWeight: "recorded" | "advisory";
+        evaluatedAt: string;
+        basis: ResolutionBasis;
+        basisCid: string;
+        ruleSummary: string;
+        precedenceRank: number;
+        precedenceReason: string;
+    }[];
+    conflicts: {
+        status: ConflictStatus;
+        topic: string;
+        competingBasisCids: string[];
+        resolutionNote?: string | undefined;
+    }[];
+    accessPolicy?: "tenant-private" | "tenant-shared" | undefined;
+    procedureExecutionCid?: string | undefined;
+}>;
+//# sourceMappingURL=constraint-resolution.d.ts.map

package/dist/encumbrances/constraint-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint-resolution.d.ts","sourceRoot":"","sources":["../../src/encumbrances/constraint-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAoC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAEjF,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,gBAAgB,GAChB,oBAAoB,GACpB,oBAAoB,GACpB,qBAAqB,CAAC;AAE1B,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,eAAe,CAM3D,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC;AAEvD,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,cAAc,CAG3D,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gCAAgC;IAC/C,UAAU,EAAE,uBAAuB,CAAC;IACpC,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACxC,SAAS,EAAE,aAAa,CAAC,uBAAuB,CAAC,CAAC;IAClD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,YAAY,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAAC;CACnD;AAsBD,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EASvC,CAAC"}

package/dist/encumbrances/constraint-resolution.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { WIDTHED_CONFIDENCE_SCHEMA, } from "../read-contract/common.js";
+import { ENCUMBRANCE_ACCESS_POLICY_SCHEMA } from "./common.js";
+export const RESOLUTION_BASES = [
+    "code-section",
+    "code-amendment",
+    "constraint-overlay",
+    "restriction-clause",
+    "administrative-rule",
+];
+export const CONFLICT_STATUSES = [
+    "unresolved",
+    "resolved",
+];
+const RESOLVED_RULE_SCHEMA = z.object({
+    basis: z.enum(RESOLUTION_BASES),
+    basisCid: z.string().min(1),
+    ruleSummary: z.string().min(1),
+    precedenceRank: z.number().int(),
+    confidence: WIDTHED_CONFIDENCE_SCHEMA,
+    legalWeight: z.enum(["recorded", "advisory"]),
+    precedenceReason: z.string().min(1),
+    evaluatedAt: z.string().min(1),
+});
+const CONFLICT_SCHEMA = z.object({
+    topic: z.string().min(1),
+    competingBasisCids: z.array(z.string().min(1)).min(1),
+    status: z.enum(CONFLICT_STATUSES),
+    resolutionNote: z.string().min(1).optional(),
+});
+export const CONSTRAINT_RESOLUTION_SCHEMA = z.object({
+    entityType: z.literal("constraint-resolution"),
+    resolutionDid: z.string().min(1),
+    parcelDid: z.string().min(1),
+    resolvedAt: z.string().min(1),
+    rules: z.array(RESOLVED_RULE_SCHEMA),
+    conflicts: z.array(CONFLICT_SCHEMA),
+    procedureExecutionCid: z.string().min(1).optional(),
+    accessPolicy: ENCUMBRANCE_ACCESS_POLICY_SCHEMA.optional(),
+});
+//# sourceMappingURL=constraint-resolution.js.map

package/dist/encumbrances/constraint-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constraint-resolution.js","sourceRoot":"","sources":["../../src/encumbrances/constraint-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,yBAAyB,GAE1B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,gCAAgC,EAAoB,MAAM,aAAa,CAAC;AAUjF,MAAM,CAAC,MAAM,gBAAgB,GAAmC;IAC9D,cAAc;IACd,gBAAgB;IAChB,oBAAoB;IACpB,oBAAoB;IACpB,qBAAqB;CACtB,CAAC;AAIF,MAAM,CAAC,MAAM,iBAAiB,GAAkC;IAC9D,YAAY;IACZ,UAAU;CACX,CAAC;AAgCF,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,KAAK,EAAE,CAAC,CAAC,IAAI,CACX,gBAA2D,CAC5D;IACD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAChC,UAAU,EAAE,yBAAyB;IACrC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAC7C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,iBAA0D,CAAC;IAC1E,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;IACnC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnD,YAAY,EAAE,gCAAgC,CAAC,QAAQ,EAAE;CAC1D,CAAC,CAAC"}

package/dist/encumbrances/fixtures.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Sample encumbrance payloads for contract tests and consumer scaffolding.
+ * Phase 1 R4 upload (Cortex) should validate against these shapes.
+ */
+import type { AdministrativeRuleAtomInstance } from "./administrative-rule.js";
+import type { ConstraintResolutionAtomInstance } from "./constraint-resolution.js";
+import type { RecordedInstrumentAtomInstance } from "./recorded-instrument.js";
+import type { RestrictionClauseAtomInstance } from "./restriction-clause.js";
+import type { RestrictionCorpusAtomInstance } from "./restriction-corpus.js";
+export declare const SAMPLE_RECORDED_INSTRUMENT: RecordedInstrumentAtomInstance;
+export declare const SAMPLE_UPLOAD_ONLY_INSTRUMENT: RecordedInstrumentAtomInstance;
+export declare const SAMPLE_RESTRICTION_CLAUSE: RestrictionClauseAtomInstance;
+export declare const SAMPLE_RESTRICTION_CORPUS: RestrictionCorpusAtomInstance;
+export declare const SAMPLE_ADMINISTRATIVE_RULE: AdministrativeRuleAtomInstance;
+export declare const SAMPLE_CONSTRAINT_RESOLUTION: ConstraintResolutionAtomInstance;
+//# sourceMappingURL=fixtures.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/encumbrances/fixtures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAE/E,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AACnF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAE7E,eAAO,MAAM,0BAA0B,EAAE,8BAqBxC,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,8BAU3C,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,6BAgBvC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,6BAUvC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,8BAWxC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,gCA+B1C,CAAC"}

package/dist/encumbrances/fixtures.js

@@ -0,0 +1,107 @@
+/**
+ * Sample encumbrance payloads for contract tests and consumer scaffolding.
+ * Phase 1 R4 upload (Cortex) should validate against these shapes.
+ */
+import { createEncumbranceQualityConfidence } from "./common.js";
+export const SAMPLE_RECORDED_INSTRUMENT = {
+    entityType: "recorded-instrument",
+    instrumentDid: "did:hauska:instrument:bastrop-lot-12-ccr-2019",
+    instrumentType: "cc-r-declaration",
+    recording: {
+        county: "Bastrop",
+        state: "TX",
+        instrumentNumber: "2019-001234",
+        recordedAt: "2019-03-15T00:00:00Z",
+    },
+    issuerActorDid: "did:hauska:actor:hoa-oak-hollow",
+    sourceDocumentCid: "bafySampleInstrumentPdf",
+    appliesTo: {
+        platId: "plat-oak-hollow-phase-2",
+        parcelDids: ["did:hauska:parcel:bastrop-lot-12"],
+    },
+    accessPolicy: "tenant-private",
+    legalWeight: "recorded",
+    verificationStatus: "machine",
+    extractedAt: "2026-05-26T12:00:00Z",
+    sourceAdapter: "R4",
+};
+export const SAMPLE_UPLOAD_ONLY_INSTRUMENT = {
+    ...SAMPLE_RECORDED_INSTRUMENT,
+    instrumentDid: "did:hauska:instrument:engagement-upload-deed-001",
+    instrumentType: "deed-restriction",
+    recording: null,
+    sourceAdapter: "R4",
+    appliesTo: {
+        parcelDids: ["did:hauska:parcel:cedar-hill-lot-7"],
+        legalDescription: "Lot 7, Block C, Cedar Hill Estates",
+    },
+};
+export const SAMPLE_RESTRICTION_CLAUSE = {
+    entityType: "restriction-clause",
+    clauseDid: "did:hauska:clause:oak-hollow-height-7-4-2",
+    parentInstrumentCid: "bafySampleInstrumentPdf",
+    clausePath: "Article VII § 4.2",
+    bodyText: "No structure shall exceed thirty-five (35) feet in height above finished grade.",
+    structuredFields: { maxHeightFt: 35 },
+    confidence: createEncumbranceQualityConfidence(0.92),
+    extractedBy: "encumbrance-extract-v1",
+    accessPolicy: "tenant-private",
+    legalWeight: "recorded",
+    sourceCitation: "CC&R Oak Hollow Phase 2, p. 14",
+    evaluatedAt: "2026-05-26T12:05:00Z",
+    reasoningSummary: "Height cap extracted from Article VII; matches plat elevation note.",
+};
+export const SAMPLE_RESTRICTION_CORPUS = {
+    entityType: "restriction-corpus",
+    corpusDid: "did:hauska:corpus:oak-hollow-phase-2",
+    displayName: "Oak Hollow Phase 2 CC&Rs",
+    platId: "plat-oak-hollow-phase-2",
+    subdivisionName: "Oak Hollow Phase 2",
+    instrumentCids: ["bafySampleInstrumentPdf", "bafyPlatRestrictionsPdf"],
+    coverageParcelCount: 142,
+    lastRefreshedAt: "2026-05-26T12:00:00Z",
+    accessPolicy: "tenant-shared",
+};
+export const SAMPLE_ADMINISTRATIVE_RULE = {
+    entityType: "administrative-rule",
+    clauseDid: "did:hauska:rule:oak-hollow-fence-guideline",
+    clausePath: "Design Guidelines § 3.1",
+    bodyText: "Front-yard fences shall use wrought iron or masonry only.",
+    confidence: createEncumbranceQualityConfidence(0.88),
+    extractedBy: "encumbrance-extract-v1",
+    accessPolicy: "tenant-private",
+    legalWeight: "advisory",
+    sourceCitation: "HOA design guidelines packet, p. 8",
+    evaluatedAt: "2026-05-26T12:10:00Z",
+};
+export const SAMPLE_CONSTRAINT_RESOLUTION = {
+    entityType: "constraint-resolution",
+    resolutionDid: "did:hauska:resolution:bastrop-lot-12-2026-05-26",
+    parcelDid: "did:hauska:parcel:bastrop-lot-12",
+    resolvedAt: "2026-05-26T12:15:00Z",
+    rules: [
+        {
+            basis: "code-section",
+            basisCid: "bafyZoningSetbackSection",
+            ruleSummary: "Front setback 25 ft minimum (zoning).",
+            precedenceRank: 1,
+            confidence: createEncumbranceQualityConfidence(0.99),
+            legalWeight: "recorded",
+            precedenceReason: "Adopted municipal code sets the public minimum; private covenant may be stricter.",
+            evaluatedAt: "2026-05-26T12:15:00Z",
+        },
+        {
+            basis: "restriction-clause",
+            basisCid: "bafyClauseHeightLimit",
+            ruleSummary: "Maximum structure height 35 ft (CC&R).",
+            precedenceRank: 2,
+            confidence: createEncumbranceQualityConfidence(0.92),
+            legalWeight: "recorded",
+            precedenceReason: "Recorded covenant is stricter than zoning height allowance on the same topic.",
+            evaluatedAt: "2026-05-26T12:15:00Z",
+        },
+    ],
+    conflicts: [],
+    accessPolicy: "tenant-private",
+};
+//# sourceMappingURL=fixtures.js.map

package/dist/encumbrances/fixtures.js.map

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

package/dist/encumbrances/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ADR-020 / ADR-021 encumbrance atom type definitions.
+ *
+ * Import from `@empressaio/atom-contract/encumbrances`. Engine registry
+ * bindings and ingest producers register against these schemas in
+ * `hauska-engine/packages/atoms/` (cc-agent-E follow-on).
+ */
+export * from "./common.js";
+export * from "./recorded-instrument.js";
+export * from "./restriction-clause.js";
+export * from "./restriction-corpus.js";
+export * from "./administrative-rule.js";
+export * from "./constraint-resolution.js";
+export * from "./fixtures.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/encumbrances/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC"}

package/dist/encumbrances/index.js

@@ -0,0 +1,15 @@
+/**
+ * ADR-020 / ADR-021 encumbrance atom type definitions.
+ *
+ * Import from `@empressaio/atom-contract/encumbrances`. Engine registry
+ * bindings and ingest producers register against these schemas in
+ * `hauska-engine/packages/atoms/` (cc-agent-E follow-on).
+ */
+export * from "./common.js";
+export * from "./recorded-instrument.js";
+export * from "./restriction-clause.js";
+export * from "./restriction-corpus.js";
+export * from "./administrative-rule.js";
+export * from "./constraint-resolution.js";
+export * from "./fixtures.js";
+//# sourceMappingURL=index.js.map

package/dist/encumbrances/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/encumbrances/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,eAAe,CAAC"}

package/dist/encumbrances/recorded-instrument.d.ts

@@ -0,0 +1,131 @@
+import { z } from "zod";
+import { type AppliesTo, type EncumbranceAccessPolicy, type EncumbranceSourceAdapter, type InstrumentType, type RecordingInfo, type VerificationStatus } from "./common.js";
+export interface RecordedInstrumentAtomInstance {
+    entityType: "recorded-instrument";
+    /** Per ADR-011. */
+    instrumentDid: string;
+    instrumentType: InstrumentType;
+    /** Null when source is upload-only (R4/R5). */
+    recording: RecordingInfo | null;
+    issuerActorDid: string;
+    sourceDocumentCid: string;
+    appliesTo: AppliesTo;
+    accessPolicy: EncumbranceAccessPolicy;
+    /** Fixed for this type. */
+    legalWeight: "recorded";
+    verificationStatus: VerificationStatus;
+    extractedAt: string;
+    sourceAdapter: EncumbranceSourceAdapter;
+    supersedesInstrumentDid?: string;
+    amendedByInstrumentDid?: ReadonlyArray<string>;
+}
+export declare const RECORDED_INSTRUMENT_SCHEMA: z.ZodObject<{
+    entityType: z.ZodLiteral<"recorded-instrument">;
+    instrumentDid: z.ZodString;
+    instrumentType: z.ZodEnum<[InstrumentType, ...InstrumentType[]]>;
+    recording: z.ZodNullable<z.ZodObject<{
+        county: z.ZodString;
+        state: z.ZodString;
+        book: z.ZodOptional<z.ZodString>;
+        page: z.ZodOptional<z.ZodString>;
+        instrumentNumber: z.ZodOptional<z.ZodString>;
+        recordedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        county: string;
+        state: string;
+        recordedAt?: string | undefined;
+        book?: string | undefined;
+        page?: string | undefined;
+        instrumentNumber?: string | undefined;
+    }, {
+        county: string;
+        state: string;
+        recordedAt?: string | undefined;
+        book?: string | undefined;
+        page?: string | undefined;
+        instrumentNumber?: string | undefined;
+    }>>;
+    issuerActorDid: z.ZodString;
+    sourceDocumentCid: z.ZodString;
+    appliesTo: z.ZodEffects<z.ZodObject<{
+        parcelDids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        platId: z.ZodOptional<z.ZodString>;
+        legalDescription: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        parcelDids?: string[] | undefined;
+        platId?: string | undefined;
+        legalDescription?: string | undefined;
+    }, {
+        parcelDids?: string[] | undefined;
+        platId?: string | undefined;
+        legalDescription?: string | undefined;
+    }>, {
+        parcelDids?: string[] | undefined;
+        platId?: string | undefined;
+        legalDescription?: string | undefined;
+    }, {
+        parcelDids?: string[] | undefined;
+        platId?: string | undefined;
+        legalDescription?: string | undefined;
+    }>;
+    accessPolicy: z.ZodEnum<["tenant-private", "tenant-shared"]>;
+    legalWeight: z.ZodLiteral<"recorded">;
+    verificationStatus: z.ZodEnum<[VerificationStatus, ...VerificationStatus[]]>;
+    extractedAt: z.ZodString;
+    sourceAdapter: z.ZodEnum<[EncumbranceSourceAdapter, ...EncumbranceSourceAdapter[]]>;
+    supersedesInstrumentDid: z.ZodOptional<z.ZodString>;
+    amendedByInstrumentDid: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "tenant-private" | "tenant-shared";
+    entityType: "recorded-instrument";
+    extractedAt: string;
+    sourceDocumentCid: string;
+    legalWeight: "recorded";
+    instrumentDid: string;
+    instrumentType: InstrumentType;
+    recording: {
+        county: string;
+        state: string;
+        recordedAt?: string | undefined;
+        book?: string | undefined;
+        page?: string | undefined;
+        instrumentNumber?: string | undefined;
+    } | null;
+    issuerActorDid: string;
+    appliesTo: {
+        parcelDids?: string[] | undefined;
+        platId?: string | undefined;
+        legalDescription?: string | undefined;
+    };
+    verificationStatus: VerificationStatus;
+    sourceAdapter: EncumbranceSourceAdapter;
+    supersedesInstrumentDid?: string | undefined;
+    amendedByInstrumentDid?: string[] | undefined;
+}, {
+    accessPolicy: "tenant-private" | "tenant-shared";
+    entityType: "recorded-instrument";
+    extractedAt: string;
+    sourceDocumentCid: string;
+    legalWeight: "recorded";
+    instrumentDid: string;
+    instrumentType: InstrumentType;
+    recording: {
+        county: string;
+        state: string;
+        recordedAt?: string | undefined;
+        book?: string | undefined;
+        page?: string | undefined;
+        instrumentNumber?: string | undefined;
+    } | null;
+    issuerActorDid: string;
+    appliesTo: {
+        parcelDids?: string[] | undefined;
+        platId?: string | undefined;
+        legalDescription?: string | undefined;
+    };
+    verificationStatus: VerificationStatus;
+    sourceAdapter: EncumbranceSourceAdapter;
+    supersedesInstrumentDid?: string | undefined;
+    amendedByInstrumentDid?: string[] | undefined;
+}>;
+//# sourceMappingURL=recorded-instrument.d.ts.map

package/dist/encumbrances/recorded-instrument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorded-instrument.d.ts","sourceRoot":"","sources":["../../src/encumbrances/recorded-instrument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAOL,KAAK,SAAS,EACd,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,8BAA8B;IAC7C,UAAU,EAAE,qBAAqB,CAAC;IAClC,mBAAmB;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,cAAc,CAAC;IAC/B,+CAA+C;IAC/C,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,uBAAuB,CAAC;IACtC,2BAA2B;IAC3B,WAAW,EAAE,UAAU,CAAC;IACxB,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,wBAAwB,CAAC;IACxC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,sBAAsB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChD;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsBrC,CAAC"}

package/dist/encumbrances/recorded-instrument.js

@@ -0,0 +1,19 @@
+import { z } from "zod";
+import { APPLIES_TO_SCHEMA, ENCUMBRANCE_ACCESS_POLICY_SCHEMA, ENCUMBRANCE_SOURCE_ADAPTERS, INSTRUMENT_TYPES, RECORDING_SCHEMA, VERIFICATION_STATUSES, } from "./common.js";
+export const RECORDED_INSTRUMENT_SCHEMA = z.object({
+    entityType: z.literal("recorded-instrument"),
+    instrumentDid: z.string().min(1),
+    instrumentType: z.enum(INSTRUMENT_TYPES),
+    recording: RECORDING_SCHEMA.nullable(),
+    issuerActorDid: z.string().min(1),
+    sourceDocumentCid: z.string().min(1),
+    appliesTo: APPLIES_TO_SCHEMA,
+    accessPolicy: ENCUMBRANCE_ACCESS_POLICY_SCHEMA,
+    legalWeight: z.literal("recorded"),
+    verificationStatus: z.enum(VERIFICATION_STATUSES),
+    extractedAt: z.string().min(1),
+    sourceAdapter: z.enum(ENCUMBRANCE_SOURCE_ADAPTERS),
+    supersedesInstrumentDid: z.string().min(1).optional(),
+    amendedByInstrumentDid: z.array(z.string().min(1)).optional(),
+});
+//# sourceMappingURL=recorded-instrument.js.map

package/dist/encumbrances/recorded-instrument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorded-instrument.js","sourceRoot":"","sources":["../../src/encumbrances/recorded-instrument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,gCAAgC,EAChC,2BAA2B,EAC3B,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,GAOtB,MAAM,aAAa,CAAC;AAsBrB,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC;IAC5C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAyD,CAAC;IACjF,SAAS,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IACtC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,SAAS,EAAE,iBAAiB;IAC5B,YAAY,EAAE,gCAAgC;IAC9C,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAClC,kBAAkB,EAAE,CAAC,CAAC,IAAI,CACxB,qBAAsE,CACvE;IACD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,aAAa,EAAE,CAAC,CAAC,IAAI,CACnB,2BAGC,CACF;IACD,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrD,sBAAsB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC9D,CAAC,CAAC"}