@empressaio/atom-contract 1.7.0

package/dist/encumbrances/restriction-clause.d.ts

@@ -0,0 +1,120 @@
+import { z } from "zod";
+import type { WidthedConfidence } from "../read-contract/common.js";
+import { STRUCTURED_FIELDS_SCHEMA } from "./common.js";
+export interface RestrictionClauseAtomInstance {
+    entityType: "restriction-clause";
+    clauseDid: string;
+    parentInstrumentCid: string;
+    clausePath: string;
+    bodyText: string;
+    structuredFields?: z.infer<typeof STRUCTURED_FIELDS_SCHEMA>;
+    confidence: WidthedConfidence;
+    extractedBy: string;
+    humanVerifiedAt?: string;
+    verifiedByActorDid?: string;
+    accessPolicy: "tenant-private" | "tenant-shared";
+    legalWeight: "recorded";
+    reasoningSummary?: string;
+    sourceCitation: string;
+    evaluatedAt: string;
+}
+export declare const RESTRICTION_CLAUSE_SCHEMA: z.ZodObject<{
+    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";
+    }>>;
+    evaluatedAt: z.ZodString;
+    reasoningSummary: z.ZodOptional<z.ZodString>;
+    sourceCitation: z.ZodString;
+    entityType: z.ZodLiteral<"restriction-clause">;
+    clauseDid: z.ZodString;
+    parentInstrumentCid: z.ZodString;
+    clausePath: z.ZodString;
+    bodyText: z.ZodString;
+    structuredFields: z.ZodOptional<z.ZodObject<{
+        maxHeightFt: z.ZodOptional<z.ZodNumber>;
+        prohibitedUses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        setbackFt: z.ZodOptional<z.ZodNumber>;
+        materialAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        maxHeightFt: z.ZodOptional<z.ZodNumber>;
+        prohibitedUses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        setbackFt: z.ZodOptional<z.ZodNumber>;
+        materialAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        maxHeightFt: z.ZodOptional<z.ZodNumber>;
+        prohibitedUses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        setbackFt: z.ZodOptional<z.ZodNumber>;
+        materialAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough">>>;
+    extractedBy: z.ZodString;
+    humanVerifiedAt: z.ZodOptional<z.ZodString>;
+    verifiedByActorDid: z.ZodOptional<z.ZodString>;
+    accessPolicy: z.ZodEnum<["tenant-private", "tenant-shared"]>;
+    legalWeight: z.ZodLiteral<"recorded">;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "tenant-private" | "tenant-shared";
+    entityType: "restriction-clause";
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    sourceCitation: string;
+    clauseDid: string;
+    parentInstrumentCid: string;
+    clausePath: string;
+    bodyText: string;
+    extractedBy: string;
+    legalWeight: "recorded";
+    evaluatedAt: string;
+    structuredFields?: z.objectOutputType<{
+        maxHeightFt: z.ZodOptional<z.ZodNumber>;
+        prohibitedUses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        setbackFt: z.ZodOptional<z.ZodNumber>;
+        materialAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    humanVerifiedAt?: string | undefined;
+    verifiedByActorDid?: string | undefined;
+    reasoningSummary?: string | undefined;
+}, {
+    accessPolicy: "tenant-private" | "tenant-shared";
+    entityType: "restriction-clause";
+    confidence: Readonly<{
+        estimate: number;
+        n: number;
+        intervalWidth: number;
+        provenance: "asserted" | "backtest" | "seed" | "live";
+    }>;
+    sourceCitation: string;
+    clauseDid: string;
+    parentInstrumentCid: string;
+    clausePath: string;
+    bodyText: string;
+    extractedBy: string;
+    legalWeight: "recorded";
+    evaluatedAt: string;
+    structuredFields?: z.objectInputType<{
+        maxHeightFt: z.ZodOptional<z.ZodNumber>;
+        prohibitedUses: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        setbackFt: z.ZodOptional<z.ZodNumber>;
+        materialAllowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, z.ZodTypeAny, "passthrough"> | undefined;
+    humanVerifiedAt?: string | undefined;
+    verifiedByActorDid?: string | undefined;
+    reasoningSummary?: string | undefined;
+}>;
+//# sourceMappingURL=restriction-clause.d.ts.map

package/dist/encumbrances/restriction-clause.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restriction-clause.d.ts","sourceRoot":"","sources":["../../src/encumbrances/restriction-clause.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAGL,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;IAC5D,UAAU,EAAE,iBAAiB,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,gBAAgB,GAAG,eAAe,CAAC;IACjD,WAAW,EAAE,UAAU,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAapC,CAAC"}

package/dist/encumbrances/restriction-clause.js

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import { ENCUMBRANCE_ACCESS_POLICY_SCHEMA, QUALITY_GATE_FIELDS, STRUCTURED_FIELDS_SCHEMA, } from "./common.js";
+export const RESTRICTION_CLAUSE_SCHEMA = z.object({
+    entityType: z.literal("restriction-clause"),
+    clauseDid: z.string().min(1),
+    parentInstrumentCid: z.string().min(1),
+    clausePath: z.string().min(1),
+    bodyText: z.string().min(1),
+    structuredFields: STRUCTURED_FIELDS_SCHEMA.optional(),
+    extractedBy: z.string().min(1),
+    humanVerifiedAt: z.string().min(1).optional(),
+    verifiedByActorDid: z.string().min(1).optional(),
+    accessPolicy: ENCUMBRANCE_ACCESS_POLICY_SCHEMA,
+    legalWeight: z.literal("recorded"),
+    ...QUALITY_GATE_FIELDS,
+});
+//# sourceMappingURL=restriction-clause.js.map

package/dist/encumbrances/restriction-clause.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restriction-clause.js","sourceRoot":"","sources":["../../src/encumbrances/restriction-clause.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EACL,gCAAgC,EAChC,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAoBrB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,gBAAgB,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IACrD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAChD,YAAY,EAAE,gCAAgC;IAC9C,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAClC,GAAG,mBAAmB;CACvB,CAAC,CAAC"}

package/dist/encumbrances/restriction-corpus.d.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+export interface RestrictionCorpusAtomInstance {
+    entityType: "restriction-corpus";
+    corpusDid: string;
+    displayName: string;
+    platId?: string;
+    subdivisionName: string;
+    instrumentCids: ReadonlyArray<string>;
+    coverageParcelCount?: number;
+    lastRefreshedAt?: string;
+    accessPolicy: "tenant-private" | "tenant-shared";
+}
+export declare const RESTRICTION_CORPUS_SCHEMA: z.ZodObject<{
+    entityType: z.ZodLiteral<"restriction-corpus">;
+    corpusDid: z.ZodString;
+    displayName: z.ZodString;
+    platId: z.ZodOptional<z.ZodString>;
+    subdivisionName: z.ZodString;
+    instrumentCids: z.ZodArray<z.ZodString, "many">;
+    coverageParcelCount: z.ZodOptional<z.ZodNumber>;
+    lastRefreshedAt: z.ZodOptional<z.ZodString>;
+    accessPolicy: z.ZodEnum<["tenant-private", "tenant-shared"]>;
+}, "strip", z.ZodTypeAny, {
+    accessPolicy: "tenant-private" | "tenant-shared";
+    entityType: "restriction-corpus";
+    corpusDid: string;
+    displayName: string;
+    subdivisionName: string;
+    instrumentCids: string[];
+    platId?: string | undefined;
+    coverageParcelCount?: number | undefined;
+    lastRefreshedAt?: string | undefined;
+}, {
+    accessPolicy: "tenant-private" | "tenant-shared";
+    entityType: "restriction-corpus";
+    corpusDid: string;
+    displayName: string;
+    subdivisionName: string;
+    instrumentCids: string[];
+    platId?: string | undefined;
+    coverageParcelCount?: number | undefined;
+    lastRefreshedAt?: string | undefined;
+}>;
+//# sourceMappingURL=restriction-corpus.d.ts.map

package/dist/encumbrances/restriction-corpus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restriction-corpus.d.ts","sourceRoot":"","sources":["../../src/encumbrances/restriction-corpus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,WAAW,6BAA6B;IAC5C,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACtC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,gBAAgB,GAAG,eAAe,CAAC;CAClD;AAED,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUpC,CAAC"}

package/dist/encumbrances/restriction-corpus.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import { ENCUMBRANCE_ACCESS_POLICY_SCHEMA } from "./common.js";
+export const RESTRICTION_CORPUS_SCHEMA = z.object({
+    entityType: z.literal("restriction-corpus"),
+    corpusDid: z.string().min(1),
+    displayName: z.string().min(1),
+    platId: z.string().min(1).optional(),
+    subdivisionName: z.string().min(1),
+    instrumentCids: z.array(z.string().min(1)).min(1),
+    coverageParcelCount: z.number().int().nonnegative().optional(),
+    lastRefreshedAt: z.string().min(1).optional(),
+    accessPolicy: ENCUMBRANCE_ACCESS_POLICY_SCHEMA,
+});
+//# sourceMappingURL=restriction-corpus.js.map

package/dist/encumbrances/restriction-corpus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restriction-corpus.js","sourceRoot":"","sources":["../../src/encumbrances/restriction-corpus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gCAAgC,EAAE,MAAM,aAAa,CAAC;AAc/D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC9D,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,YAAY,EAAE,gCAAgC;CAC/C,CAAC,CAAC"}

package/dist/export/downloadable-atom.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Downloadable-atom export shape (architecture homes doc 02).
+ *
+ * The portable audit unit returned by the gate atom-export tool and
+ * rendered by the operator console. Self-contained and verifiable
+ * without trusting the hosting system.
+ */
+import { z } from "zod";
+import type { ContextSummary } from "../context.js";
+import type { AtomEvent } from "../history.js";
+import type { AccessPolicy, AtomReference } from "../registration.js";
+import { ATOM_CONFORMANCE_TARGET_VERSION, type AtomTier, type VerifyChainResult } from "../conformance/index.js";
+import type { ReadContract } from "../read-contract/read-contract.js";
+export interface DownloadableAtomIdentity {
+    readonly entityType: string;
+    readonly entityId: string;
+    /** Stable content identifier (hash, edition key, or corpus row id). */
+    readonly contentId: string;
+    /** VDA reference for real-world data-level entities. */
+    readonly vdaRef?: string;
+}
+export interface DownloadableAtomCitation {
+    readonly citationDid: string;
+    readonly label?: string;
+    readonly sourceCitation?: string;
+    readonly citedAtom?: AtomReference;
+}
+export interface DownloadableAtom {
+    readonly exportVersion: typeof ATOM_CONFORMANCE_TARGET_VERSION;
+    readonly identity: DownloadableAtomIdentity;
+    readonly accessPolicy: AccessPolicy;
+    readonly contextSummary: ContextSummary;
+    readonly readContract: ReadContract;
+    readonly compositionReferences: ReadonlyArray<AtomReference>;
+    readonly citations: ReadonlyArray<DownloadableAtomCitation>;
+    readonly signedEventChain: ReadonlyArray<AtomEvent>;
+    readonly verifyChain: VerifyChainResult;
+    /** ISO-8601 when the export bundle was assembled. */
+    readonly exportedAt: string;
+}
+export declare const DOWNLOADABLE_ATOM_IDENTITY_SCHEMA: z.ZodReadonly<z.ZodObject<{
+    entityType: z.ZodString;
+    entityId: z.ZodString;
+    contentId: z.ZodString;
+    vdaRef: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    entityId: string;
+    entityType: string;
+    contentId: string;
+    vdaRef?: string | undefined;
+}, {
+    entityId: string;
+    entityType: string;
+    contentId: string;
+    vdaRef?: string | undefined;
+}>>;
+export declare const DOWNLOADABLE_ATOM_CITATION_SCHEMA: z.ZodReadonly<z.ZodObject<{
+    citationDid: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    sourceCitation: z.ZodOptional<z.ZodString>;
+    citedAtom: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodLiteral<"atom">;
+        entityType: z.ZodString;
+        entityId: z.ZodString;
+        mode: z.ZodOptional<z.ZodEnum<["inline", "compact", "card", "expanded", "focus"]>>;
+        displayLabel: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        entityId: string;
+        entityType: string;
+        kind: "atom";
+        displayLabel?: string | undefined;
+        mode?: "inline" | "compact" | "card" | "expanded" | "focus" | undefined;
+    }, {
+        entityId: string;
+        entityType: string;
+        kind: "atom";
+        displayLabel?: string | undefined;
+        mode?: "inline" | "compact" | "card" | "expanded" | "focus" | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    citationDid: string;
+    sourceCitation?: string | undefined;
+    label?: string | undefined;
+    citedAtom?: {
+        entityId: string;
+        entityType: string;
+        kind: "atom";
+        displayLabel?: string | undefined;
+        mode?: "inline" | "compact" | "card" | "expanded" | "focus" | undefined;
+    } | undefined;
+}, {
+    citationDid: string;
+    sourceCitation?: string | undefined;
+    label?: string | undefined;
+    citedAtom?: {
+        entityId: string;
+        entityType: string;
+        kind: "atom";
+        displayLabel?: string | undefined;
+        mode?: "inline" | "compact" | "card" | "expanded" | "focus" | undefined;
+    } | undefined;
+}>>;
+export interface CreateDownloadableAtomInput {
+    tier: AtomTier;
+    identity: DownloadableAtomIdentity;
+    accessPolicy: AccessPolicy;
+    contextSummary: ContextSummary;
+    readContract: ReadContract;
+    compositionReferences?: ReadonlyArray<AtomReference>;
+    citations?: ReadonlyArray<DownloadableAtomCitation>;
+    signedEventChain?: ReadonlyArray<AtomEvent>;
+    exportedAt?: string;
+}
+export interface CreateDownloadableAtomResult {
+    readonly ok: true;
+    readonly export: DownloadableAtom;
+}
+export interface CreateDownloadableAtomFailure {
+    readonly ok: false;
+    readonly errors: ReadonlyArray<{
+        path: string;
+        message: string;
+    }>;
+}
+export type CreateDownloadableAtomOutcome = CreateDownloadableAtomResult | CreateDownloadableAtomFailure;
+/**
+ * Assemble a downloadable atom export bundle and run conformance +
+ * verify-chain checks before returning.
+ */
+export declare function createDownloadableAtom(input: CreateDownloadableAtomInput): CreateDownloadableAtomOutcome;
+/** Runtime guard for wire payloads (gate export tool, console download). */
+export declare function isDownloadableAtom(value: unknown): value is DownloadableAtom;
+//# sourceMappingURL=downloadable-atom.d.ts.map

package/dist/export/downloadable-atom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"downloadable-atom.d.ts","sourceRoot":"","sources":["../../src/export/downloadable-atom.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EACL,+BAA+B,EAG/B,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGtE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,OAAO,+BAA+B,CAAC;IAC/D,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,qBAAqB,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC7D,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;IAC5D,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;GAOjC,CAAC;AAEd,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiBjC,CAAC;AAEd,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,wBAAwB,CAAC;IACnC,YAAY,EAAE,YAAY,CAAC;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,qBAAqB,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;IACpD,gBAAgB,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnE;AAED,MAAM,MAAM,6BAA6B,GACrC,4BAA4B,GAC5B,6BAA6B,CAAC;AAElC;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,2BAA2B,GACjC,6BAA6B,CAsD/B;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAgB5E"}

package/dist/export/downloadable-atom.js

@@ -0,0 +1,115 @@
+/**
+ * Downloadable-atom export shape (architecture homes doc 02).
+ *
+ * The portable audit unit returned by the gate atom-export tool and
+ * rendered by the operator console. Self-contained and verifiable
+ * without trusting the hosting system.
+ */
+import { z } from "zod";
+import { ATOM_CONFORMANCE_TARGET_VERSION, validateAtomConformance, verifyEventChain, } from "../conformance/index.js";
+import { READ_CONTRACT_SCHEMA } from "../read-contract/read-contract.js";
+import { ACCESS_POLICY_SCHEMA } from "../conformance/common.js";
+export const DOWNLOADABLE_ATOM_IDENTITY_SCHEMA = z
+    .object({
+    entityType: z.string().min(1),
+    entityId: z.string().min(1),
+    contentId: z.string().min(1),
+    vdaRef: z.string().min(1).optional(),
+})
+    .readonly();
+export const DOWNLOADABLE_ATOM_CITATION_SCHEMA = z
+    .object({
+    citationDid: z.string().min(1),
+    label: z.string().min(1).optional(),
+    sourceCitation: z.string().min(1).optional(),
+    citedAtom: z
+        .object({
+        kind: z.literal("atom"),
+        entityType: z.string().min(1),
+        entityId: z.string().min(1),
+        mode: z
+            .enum(["inline", "compact", "card", "expanded", "focus"])
+            .optional(),
+        displayLabel: z.string().optional(),
+    })
+        .optional(),
+})
+    .readonly();
+/**
+ * Assemble a downloadable atom export bundle and run conformance +
+ * verify-chain checks before returning.
+ */
+export function createDownloadableAtom(input) {
+    const errors = [];
+    const identityParsed = DOWNLOADABLE_ATOM_IDENTITY_SCHEMA.safeParse(input.identity);
+    if (!identityParsed.success) {
+        errors.push({ path: "identity", message: identityParsed.error.message });
+    }
+    const readContractParsed = READ_CONTRACT_SCHEMA.safeParse(input.readContract);
+    if (!readContractParsed.success) {
+        errors.push({ path: "readContract", message: readContractParsed.error.message });
+    }
+    const accessPolicyParsed = ACCESS_POLICY_SCHEMA.safeParse(input.accessPolicy);
+    if (!accessPolicyParsed.success) {
+        errors.push({ path: "accessPolicy", message: accessPolicyParsed.error.message });
+    }
+    const signedEventChain = input.signedEventChain ?? [];
+    const verifyChain = verifyEventChain(signedEventChain);
+    const conformance = validateAtomConformance({
+        tier: input.tier,
+        readContract: input.readContract,
+        accessPolicy: input.accessPolicy,
+        signedHistory: input.tier === "data" ? { events: signedEventChain } : undefined,
+    });
+    if (!conformance.ok) {
+        for (const err of conformance.errors) {
+            errors.push({ path: err.path, message: err.message });
+        }
+    }
+    if (errors.length > 0) {
+        return { ok: false, errors };
+    }
+    return {
+        ok: true,
+        export: {
+            exportVersion: ATOM_CONFORMANCE_TARGET_VERSION,
+            identity: identityParsed.data,
+            accessPolicy: accessPolicyParsed.data,
+            contextSummary: input.contextSummary,
+            readContract: readContractParsed.data,
+            compositionReferences: input.compositionReferences ?? [],
+            citations: input.citations ?? [],
+            signedEventChain,
+            verifyChain,
+            exportedAt: input.exportedAt ?? new Date().toISOString(),
+        },
+    };
+}
+/** Runtime guard for wire payloads (gate export tool, console download). */
+export function isDownloadableAtom(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const record = value;
+    if (record.exportVersion !== ATOM_CONFORMANCE_TARGET_VERSION)
+        return false;
+    if (!DOWNLOADABLE_ATOM_IDENTITY_SCHEMA.safeParse(record.identity).success) {
+        return false;
+    }
+    if (!READ_CONTRACT_SCHEMA.safeParse(record.readContract).success)
+        return false;
+    if (!ACCESS_POLICY_SCHEMA.safeParse(record.accessPolicy).success)
+        return false;
+    if (!Array.isArray(record.compositionReferences))
+        return false;
+    if (!Array.isArray(record.citations))
+        return false;
+    if (!Array.isArray(record.signedEventChain))
+        return false;
+    if (typeof record.exportedAt !== "string")
+        return false;
+    const verify = record.verifyChain;
+    if (verify === null || typeof verify !== "object")
+        return false;
+    return typeof verify.ok === "boolean";
+}
+//# sourceMappingURL=downloadable-atom.js.map

package/dist/export/downloadable-atom.js.map

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

package/dist/export/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Downloadable-atom export shape for gate and console portability.
+ */
+export { createDownloadableAtom, isDownloadableAtom, DOWNLOADABLE_ATOM_CITATION_SCHEMA, DOWNLOADABLE_ATOM_IDENTITY_SCHEMA, type CreateDownloadableAtomFailure, type CreateDownloadableAtomInput, type CreateDownloadableAtomOutcome, type CreateDownloadableAtomResult, type DownloadableAtom, type DownloadableAtomCitation, type DownloadableAtomIdentity, } from "./downloadable-atom.js";
+export { ATOM_CONFORMANCE_TARGET_VERSION } from "../conformance/common.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/export/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,iCAAiC,EACjC,iCAAiC,EACjC,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,GAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/export/index.js

@@ -0,0 +1,6 @@
+/**
+ * Downloadable-atom export shape for gate and console portability.
+ */
+export { createDownloadableAtom, isDownloadableAtom, DOWNLOADABLE_ATOM_CITATION_SCHEMA, DOWNLOADABLE_ATOM_IDENTITY_SCHEMA, } from "./downloadable-atom.js";
+export { ATOM_CONFORMANCE_TARGET_VERSION } from "../conformance/common.js";
+//# sourceMappingURL=index.js.map

package/dist/export/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/export/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,iCAAiC,EACjC,iCAAiC,GAQlC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/history.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Event-anchored history for atoms.
+ *
+ * The `EventAnchoringService` interface every atom mutation flows through.
+ * Ships the interface verbatim plus a Postgres-backed implementation that
+ * writes deterministic SHA-256 `chainHash` values into the `atom_events`
+ * table. Cryptographic anchoring (Merkle root, external ledger anchor)
+ * lands later without changing the consumer interface — this is the
+ * central "interface-stable / implementation-evolves" promise.
+ *
+ * TODO(M2-C): replace deterministic chainHash with cryptographic anchor.
+ */
+import type { AtomReference } from "./registration.js";
+/**
+ * Identity of the actor that produced an event. `kind` is `"agent"` for
+ * AI/bot writes and `"user"` for human writes. `id` is opaque to the
+ * framework — application code chooses its identity scheme.
+ */
+export interface EventActor {
+    kind: "user" | "agent" | "system";
+    id: string;
+}
+/**
+ * Input to {@link EventAnchoringService.appendEvent}. `payload` is the
+ * mutation payload as the atom recorded it; the framework does not
+ * interpret it and stores it verbatim as JSONB.
+ */
+export interface AppendEventInput {
+    entityType: string;
+    entityId: string;
+    eventType: string;
+    actor: EventActor;
+    payload: Record<string, unknown>;
+    /** Defaults to "now" when omitted. */
+    occurredAt?: Date;
+}
+/**
+ * Materialized event row. `chainHash` is deterministic SHA-256;
+ * `prevHash` is the previous event's `chainHash` for the same
+ * `(entityType, entityId)` pair, or `null` for the first event.
+ */
+export interface AtomEvent {
+    id: string;
+    entityType: string;
+    entityId: string;
+    eventType: string;
+    actor: EventActor;
+    payload: Record<string, unknown>;
+    prevHash: string | null;
+    chainHash: string;
+    occurredAt: Date;
+    recordedAt: Date;
+}
+/**
+ * Options accepted by {@link EventAnchoringService.readHistory}. Pagination
+ * is via `offset/limit` because the row count for a single entity is
+ * expected to be small; cursor pagination can be added later.
+ */
+export interface ReadHistoryOptions {
+    limit?: number;
+    offset?: number;
+    /** When true, return rows newest-first instead of the default oldest-first. */
+    reverse?: boolean;
+}
+/**
+ * The history contract. Implementations must guarantee:
+ * - `appendEvent` is atomic with respect to its `(entityType, entityId)`
+ *   chain — concurrent appends serialize and the resulting `chainHash`
+ *   chain is gap-free.
+ * - `readHistory` returns events in stable order.
+ * - `latestEvent` returns the same row as `readHistory({ reverse: true,
+ *   limit: 1 })[0] ?? null`.
+ */
+export interface EventAnchoringService {
+    appendEvent(input: AppendEventInput): Promise<AtomEvent>;
+    readHistory(ref: AtomReference, opts?: ReadHistoryOptions): Promise<AtomEvent[]>;
+    latestEvent(ref: AtomReference): Promise<AtomEvent | null>;
+}
+declare function generateId(): string;
+/**
+ * Compute the deterministic SHA-256 chain hash for an event. Inputs are
+ * stringified with stable key order so two callers computing the same
+ * event get the same hash. TODO(M2-C): swap for the real cryptographic
+ * anchor — same signature, no consumer change.
+ */
+declare function computeChainHash(args: {
+    prevHash: string | null;
+    payload: Record<string, unknown>;
+    occurredAt: Date;
+    eventType: string;
+    actor: EventActor;
+}): string;
+/**
+ * Drizzle/node-postgres database surface this service needs. Declared
+ * structurally so we don't require a hard dep on `drizzle-orm`'s concrete
+ * `db` type (which varies by driver). The host application passes its
+ * own `db` instance.
+ */
+export interface DrizzleLikeDb {
+    transaction: <T>(cb: (tx: DrizzleLikeDb) => Promise<T>) => Promise<T>;
+    execute: (query: unknown) => Promise<{
+        rows: Array<Record<string, unknown>>;
+    }>;
+}
+/**
+ * Postgres-backed {@link EventAnchoringService} implementation. Uses raw
+ * SQL via Drizzle's `sql` template so the boundary to the host db package
+ * stays minimal — we depend on the `atom_events` table existing but not
+ * on the driver flavor.
+ */
+export declare class PostgresEventAnchoringService implements EventAnchoringService {
+    private readonly db;
+    constructor(db: DrizzleLikeDb);
+    appendEvent(input: AppendEventInput): Promise<AtomEvent>;
+    readHistory(ref: AtomReference, opts?: ReadHistoryOptions): Promise<AtomEvent[]>;
+    latestEvent(ref: AtomReference): Promise<AtomEvent | null>;
+}
+/** Re-exported for tests that want to assert the chain-hash formula. */
+export declare const __internal: {
+    computeChainHash: typeof computeChainHash;
+    generateId: typeof generateId;
+};
+export {};
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

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