@sentropic/h2a 0.96.1 → 0.97.0

package/dist/runtime/memory/port-v2-adapter.d.ts

@@ -0,0 +1,117 @@
+/**
+ * V1→V2 adapter (path V) — pure request BUILDERS + outcome MAPPERS between the
+ * h2a memory clients' internal V1 shapes and graphify's `MemoryPortV2`
+ * (vendored, types-only, in `./graphify-contracts-v2.vendored.ts`). See
+ * docs/specs/2026-09-05-SPEC_v1v2-adapter... for the full mapping + the 6 gaps.
+ *
+ * SCOPE of THIS module (additive, correctness-critical): the pure functions that
+ * turn an h2a input (a `MemoryNoteInput`, a `PromotionEvidence`, a
+ * `TombstoneTarget`, a `MemoryRecallQuery`) into the corresponding V2 request,
+ * and the V2 responses back into the h2a outcome shapes. It imports ZERO
+ * graphify runtime — only the vendored V2 TYPES — so the anti-cycle holds.
+ *
+ * The 6 GAPS (G1..G6 in the spec) are NOT resolved here: they are INJECTED as a
+ * `V2GapResolvers` bundle — exactly like the port itself was injected. Their
+ * real implementations (tenancy → opaque scope/purpose refs, a per-call
+ * principal credential, the closed component/type vocabularies, the D11-evidence
+ * → authorization binding, valid_time) are go-live wiring (graphify/h-arch);
+ * here they are one interface a caller supplies, and a test stubs.
+ *
+ * The client CUTOVER (wiring admit/recall/promote/tombstone-client + the
+ * fixtures onto these builders + the V2 port) is deliberately NOT in this file —
+ * it is the mechanical, high-volume step deferred to codex (the fixture rewrite
+ * touches ~1385 lines). This module is the de-risked, tested foundation that
+ * cutover builds on: if the field mapping is wrong, THESE tests go red first.
+ */
+import type { MemoryContext, MemoryNoteInput, MemoryRecallQuery, PromotionEvidence, TombstoneTarget, TombstoneAuthorization, AdmissionOutcome, PromotionOutcome, TombstoneOutcome } from "./port-v1.js";
+import type { AdmissionOutcomeV1, AdmissionRequestV1, AuthorizationContextV1, CaptureAcknowledgementV1, CaptureRequestV2, CitationV1, Cursor, EvidenceBundleV1, IdempotencyKey, Instant, LifecycleCommandV1, LifecycleEventAnchorV1, LifecycleReceiptV1, MemoryComponentV2, OpaqueRef, RecallCapabilityPolicyV1, RecallRequestV2, ReconciliationConsentV1, RetentionV1, ValidIntervalV1 } from "./graphify-contracts-v2.vendored.js";
+/**
+ * The injected resolvers for the 6 gaps. Every field the V2 contract requires
+ * that the h2a V1 note does NOT already carry in the right shape is produced
+ * here — never fabricated inline in a builder. A test supplies canned values;
+ * the real wiring (tenancy/identity/policy) lands at go-live.
+ */
+export interface V2GapResolvers {
+    /** G1: {principal_owner, scope} → an opaque scope reference (tenancy). */
+    scopeRef(input: {
+        readonly principal_owner: string;
+        readonly scope: string;
+    }): OpaqueRef;
+    /** G1: purpose → an opaque purpose reference; required for EVERY capture (default for non-human). */
+    purposeRef(input: {
+        readonly subject: string;
+        readonly purpose?: string;
+    }): OpaqueRef;
+    /** G3: an event-kind label → an opaque type reference. */
+    typeRef(kind: string): OpaqueRef;
+    /** G3: the note's content → V2 components + which one is primary. */
+    components(note: MemoryNoteInput): {
+        readonly components: ReadonlyArray<MemoryComponentV2>;
+        readonly primary_component_id: string;
+    };
+    /** G3: the note's provenance → V2 citations (the primary event's citation is one of these). */
+    citations(note: MemoryNoteInput): {
+        readonly citations: ReadonlyArray<CitationV1>;
+        readonly primary_citation_id: string;
+    };
+    /** G6: the note's temporal anchor → a bi-temporal valid interval. */
+    validTime(note: MemoryNoteInput): ValidIntervalV1;
+    /** retention/TTL → V2 retention (default "retain" for non-human). */
+    retention(note: MemoryNoteInput): RetentionV1;
+    /** reconciliation consent (co-spec C1). */
+    reconciliation(note: MemoryNoteInput): ReconciliationConsentV1;
+    /** the evidence a note carries; the verifier derives the trust class from it (earned-not-asserted). */
+    evidenceBundle(note: MemoryNoteInput): EvidenceBundleV1;
+    /** G2: ctx → a per-call authorization credential (dynamic principal, never static). */
+    authorization(ctx: MemoryContext): AuthorizationContextV1;
+    /**
+     * G4: the D11 evidence + ctx → the admission authorization. The two verdict
+     * refs + attestation ref are recorded h2a-side and carried by
+     * `AuthorizationContextV1.context_ref` (an opaque ref to the ceremony
+     * receipt) — graphify applies on a valid authorization; h2a holds the
+     * auditable D11 artifact. See spec G4/G5 (single admission authority).
+     */
+    admissionAuthorization(input: {
+        readonly ctx: MemoryContext;
+        readonly evidence: PromotionEvidence;
+    }): AuthorizationContextV1;
+    /** a fresh idempotency key for a capture. */
+    idempotencyKey(): IdempotencyKey;
+    /** a deadline for a request. */
+    deadlineAt(): Instant;
+    /** capture source-order: which source, what sequence. */
+    sourceOrder(note: MemoryNoteInput): {
+        readonly source_ref: OpaqueRef;
+        readonly sequence: Cursor;
+    };
+    /** a cancellation ref for a capture. */
+    cancellationRef(): OpaqueRef;
+    /** RecallRequestV2 budgets + capability policy (new surface, no V1 analogue). */
+    recallBudgets(): RecallRequestV2["budgets"];
+    recallCapabilityPolicy(): RecallCapabilityPolicyV1;
+    recallPurposeRef(query: MemoryRecallQuery, ctx: MemoryContext): OpaqueRef;
+    /** a lifecycle command's fresh event id. */
+    lifecycleEventId(): IdempotencyKey;
+    /** a lifecycle command's reason ref. */
+    reasonRef(input: {
+        readonly ctx: MemoryContext;
+        readonly auth: TombstoneAuthorization;
+    }): OpaqueRef;
+    /** a lifecycle command's event anchor. */
+    lifecycleEventAnchor(): LifecycleEventAnchorV1;
+}
+/** `admitMemoryNote(note)` → `capture(CaptureRequestV2)`. `committed_pending` = the V1 `pending`. */
+export declare function buildCaptureRequest(note: MemoryNoteInput, ctx: MemoryContext, r: V2GapResolvers): CaptureRequestV2;
+/** `promoteNote(noteId, evidence)` → `requestAdmission(AdmissionRequestV1)` — the D11 verdict APPLIES here. */
+export declare function buildAdmissionRequest(noteId: string, evidence: PromotionEvidence, ctx: MemoryContext, r: V2GapResolvers): AdmissionRequestV1;
+/** `requestTombstone(target)` → `transition({operation:"tombstone", record_id})`. Node targets only; an edge target refuses fail-closed (NB-01). */
+export declare function buildTombstoneCommand(target: TombstoneTarget, auth: TombstoneAuthorization, ctx: MemoryContext, r: V2GapResolvers): LifecycleCommandV1;
+/** `recallMemory(query)` → `recall(RecallRequestV2)`. `asOf`/`window` → `as_of`; budgets/policy are new. */
+export declare function buildRecallRequest(query: MemoryRecallQuery, ctx: MemoryContext, r: V2GapResolvers): RecallRequestV2;
+/** `CaptureAcknowledgementV1` → `AdmissionOutcome`. `committed_pending`/`duplicate_exact` = admitted; else refused. */
+export declare function mapCaptureAcknowledgement(ack: CaptureAcknowledgementV1): AdmissionOutcome;
+/** `AdmissionOutcomeV1` → `PromotionOutcome`. `accepted` (with a record_id) = promoted; else refused. */
+export declare function mapAdmissionOutcome(outcome: AdmissionOutcomeV1): PromotionOutcome;
+/** `LifecycleReceiptV1` → `TombstoneOutcome`. Applied iff the transition reached the `tombstoned` state. */
+export declare function mapLifecycleReceipt(receipt: LifecycleReceiptV1): TombstoneOutcome;
+//# sourceMappingURL=port-v2-adapter.d.ts.map

package/dist/runtime/memory/port-v2-adapter.d.ts.map

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

package/dist/runtime/memory/port-v2-adapter.js

@@ -0,0 +1,140 @@
+/**
+ * V1→V2 adapter (path V) — pure request BUILDERS + outcome MAPPERS between the
+ * h2a memory clients' internal V1 shapes and graphify's `MemoryPortV2`
+ * (vendored, types-only, in `./graphify-contracts-v2.vendored.ts`). See
+ * docs/specs/2026-09-05-SPEC_v1v2-adapter... for the full mapping + the 6 gaps.
+ *
+ * SCOPE of THIS module (additive, correctness-critical): the pure functions that
+ * turn an h2a input (a `MemoryNoteInput`, a `PromotionEvidence`, a
+ * `TombstoneTarget`, a `MemoryRecallQuery`) into the corresponding V2 request,
+ * and the V2 responses back into the h2a outcome shapes. It imports ZERO
+ * graphify runtime — only the vendored V2 TYPES — so the anti-cycle holds.
+ *
+ * The 6 GAPS (G1..G6 in the spec) are NOT resolved here: they are INJECTED as a
+ * `V2GapResolvers` bundle — exactly like the port itself was injected. Their
+ * real implementations (tenancy → opaque scope/purpose refs, a per-call
+ * principal credential, the closed component/type vocabularies, the D11-evidence
+ * → authorization binding, valid_time) are go-live wiring (graphify/h-arch);
+ * here they are one interface a caller supplies, and a test stubs.
+ *
+ * The client CUTOVER (wiring admit/recall/promote/tombstone-client + the
+ * fixtures onto these builders + the V2 port) is deliberately NOT in this file —
+ * it is the mechanical, high-volume step deferred to codex (the fixture rewrite
+ * touches ~1385 lines). This module is the de-risked, tested foundation that
+ * cutover builds on: if the field mapping is wrong, THESE tests go red first.
+ */
+// ---------------------------------------------------------------------------
+// WRITE-side builders: h2a input → V2 request. Pure; every gap comes from `r`.
+// ---------------------------------------------------------------------------
+/** `admitMemoryNote(note)` → `capture(CaptureRequestV2)`. `committed_pending` = the V1 `pending`. */
+export function buildCaptureRequest(note, ctx, r) {
+    const { components, primary_component_id } = r.components(note);
+    const { citations, primary_citation_id } = r.citations(note);
+    const payload = {
+        schema_version: 2,
+        scope_ref: r.scopeRef({ principal_owner: note.principal_owner, scope: note.scope }),
+        purpose_ref: r.purposeRef({ subject: note.subject, purpose: note.purpose }),
+        valid_time: r.validTime(note),
+        components,
+        primary_component_id,
+        primary_event: { at: note.event.at, type_ref: r.typeRef(note.event.kind), citation_id: primary_citation_id },
+        citations,
+        retention: r.retention(note),
+        reconciliation: r.reconciliation(note)
+    };
+    return {
+        schema_version: 2,
+        idempotency_key: r.idempotencyKey(),
+        payload,
+        evidence: r.evidenceBundle(note),
+        authorization: r.authorization(ctx),
+        source_order: r.sourceOrder(note),
+        deadline_at: r.deadlineAt(),
+        cancellation_ref: r.cancellationRef()
+    };
+}
+/** `promoteNote(noteId, evidence)` → `requestAdmission(AdmissionRequestV1)` — the D11 verdict APPLIES here. */
+export function buildAdmissionRequest(noteId, evidence, ctx, r) {
+    return {
+        candidate_id: noteId,
+        authorization: r.admissionAuthorization({ ctx, evidence }),
+        deadline_at: r.deadlineAt()
+    };
+}
+/** `requestTombstone(target)` → `transition({operation:"tombstone", record_id})`. Node targets only; an edge target refuses fail-closed (NB-01). */
+export function buildTombstoneCommand(target, auth, ctx, r) {
+    // NB-01: only a node target carries a single record_id, which is what the V2
+    // lifecycle surface transitions. An edge target's own record/projection id must
+    // be resolved from the edge triple (the edge-tombstone sub-gap, a go-live
+    // concern). Mapping an edge to `target.source` — as an earlier revision did —
+    // would transition the WHOLE source node (and every other edge on it), not the
+    // single edge A→B: a destructive mis-target. Refuse fail-closed here rather than
+    // invent a record_id; the compat port turns this throw into an {applied:false}
+    // outcome, so no edge tombstone can silently destroy a shared node.
+    if (target.kind !== "node") {
+        throw new Error("edge tombstone is not supported by the V1→V2 adapter yet — needs edge→record_id resolution (NB-01); refusing rather than tombstoning the source node");
+    }
+    return {
+        event_id: r.lifecycleEventId(),
+        reason_ref: r.reasonRef({ ctx, auth }),
+        event_anchor: r.lifecycleEventAnchor(),
+        authorization: r.authorization(ctx),
+        deadline_at: r.deadlineAt(),
+        operation: "tombstone",
+        record_id: target.id
+    };
+}
+/** `recallMemory(query)` → `recall(RecallRequestV2)`. `asOf`/`window` → `as_of`; budgets/policy are new. */
+export function buildRecallRequest(query, ctx, r) {
+    const as_of = typeof query.asOf === "number"
+        ? { valid_time: query.asOf }
+        : query.window && query.window.untilMs !== null
+            ? { valid_time: query.window.untilMs }
+            : undefined;
+    return {
+        // The V1 query carried no free-text; the wake-recall query string is the
+        // caller's — the cutover threads it. Empty string is a valid "recall all
+        // live for this principal/purpose" under the budgets below.
+        query: "",
+        purpose_ref: r.recallPurposeRef(query, ctx),
+        ...(as_of ? { as_of } : {}),
+        authorization: r.authorization(ctx),
+        capability_policy: r.recallCapabilityPolicy(),
+        budgets: r.recallBudgets()
+    };
+}
+// ---------------------------------------------------------------------------
+// READ-side / outcome MAPPERS: V2 response → h2a outcome. Fail-closed on refusal.
+// ---------------------------------------------------------------------------
+/** `CaptureAcknowledgementV1` → `AdmissionOutcome`. `committed_pending`/`duplicate_exact` = admitted; else refused. */
+export function mapCaptureAcknowledgement(ack) {
+    // A fresh commit must return its candidate_id.
+    if (ack.status === "committed_pending" && typeof ack.candidate_id === "string") {
+        return { admitted: true, id: ack.candidate_id };
+    }
+    // NB-02: `duplicate_exact` is an idempotent success — the store already holds
+    // this exact payload. `candidate_id` is OPTIONAL on CaptureAcknowledgementV1, so
+    // fall back to the `record_digest` as the stable id when it is omitted: refusing
+    // a recognized duplicate merely because candidate_id is absent would break dedup
+    // idempotency on a retried admission. Still fail closed if the store returned
+    // neither identifier.
+    if (ack.status === "duplicate_exact") {
+        const id = ack.candidate_id ?? ack.record_digest;
+        if (typeof id === "string")
+            return { admitted: true, id };
+    }
+    return { admitted: false, reason: `capture not committed — status "${ack.status}"` };
+}
+/** `AdmissionOutcomeV1` → `PromotionOutcome`. `accepted` (with a record_id) = promoted; else refused. */
+export function mapAdmissionOutcome(outcome) {
+    if (outcome.status === "accepted" && typeof outcome.record_id === "string") {
+        return { promoted: true, id: outcome.record_id };
+    }
+    return { promoted: false, reason: `admission not accepted — status "${outcome.status}"` };
+}
+/** `LifecycleReceiptV1` → `TombstoneOutcome`. Applied iff the transition reached the `tombstoned` state. */
+export function mapLifecycleReceipt(receipt) {
+    const applied = receipt.to_state === "tombstoned";
+    return applied ? { applied: true } : { applied: false, reason: `transition landed in "${receipt.to_state}", not tombstoned` };
+}
+//# sourceMappingURL=port-v2-adapter.js.map

package/dist/runtime/memory/port-v2-adapter.js.map

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

package/dist/runtime/memory/port-v2-compat.d.ts

@@ -0,0 +1,50 @@
+/**
+ * V1→V2 anti-corruption port (path V, the cutover). `createV1CompatPort` wraps a
+ * real `MemoryPortV2` (+ the injected `V2GapResolvers`) and EXPOSES the V1
+ * `MemoryProducerPort & MemoryRecallPort` the h2a clients already consume — so
+ * admit-client / promote-client / tombstone-client / recall-client + all their
+ * fixtures (including the 1656-line D11 ceremony suite) stay UNCHANGED, and their
+ * anti-fabrication coverage is preserved by construction (nothing rewritten).
+ *
+ * This is the ACL between h2a's stable V1-facing internal API and graphify's V2
+ * contract: the clients speak V1; this port maps each call to V2 via the proven
+ * builders (`./port-v2-adapter.ts`) and maps the V2 responses back. At go-live,
+ * h2a constructs `createV1CompatPort(realGraphifyV2Port, realResolvers, realReverse)`
+ * and hands it to the clients — that IS the V2 wiring. Imports ZERO graphify
+ * runtime (only vendored types) — anti-cycle holds.
+ *
+ * The 6 gaps stay injected (`V2GapResolvers`); the recall RESPONSE reverse-mapping
+ * needs the fields V2 does not carry back flat (subject, scope, principal_owner,
+ * review_status), supplied by an injected `V2RecallReverseResolvers` — the same
+ * go-live wiring point.
+ */
+import type { MemoryProducerPort, MemoryRecallPort, MemoryRecallResultView, MemoryScope, RecalledMemoryNoteView } from "./port-v1.js";
+import type { MemoryPortV2, MemoryRecordV2, RecallPacketV2 } from "./graphify-contracts-v2.vendored.js";
+import { type V2GapResolvers } from "./port-v2-adapter.js";
+/**
+ * Recover the V1 view fields a `MemoryRecordV2` does not carry back in the flat
+ * V1 shape (V2 dropped a top-level `subject`, and encodes tenancy as opaque
+ * refs). Injected — the real resolution (scope_ref → {principal_owner, scope},
+ * the record's state → review_status) is graphify/go-live wiring.
+ */
+export interface V2RecallReverseResolvers {
+    subject(record: MemoryRecordV2): string;
+    scope(record: MemoryRecordV2): MemoryScope;
+    principalOwner(record: MemoryRecordV2): string;
+    reviewStatus(record: MemoryRecordV2): string;
+    /** An event-kind label recovered from the primary event's opaque `type_ref`. */
+    eventKind(record: MemoryRecordV2): string;
+}
+/** Map one V2 record to the V1 projected view. Pure; the recovered fields come from `rev`. */
+export declare function mapRecordToView(record: MemoryRecordV2, rev: V2RecallReverseResolvers): RecalledMemoryNoteView;
+/** Map a `RecallPacketV2` to the V1 recall result view (notes-only). */
+export declare function mapRecallPacket(packet: RecallPacketV2, rev: V2RecallReverseResolvers, requestingPrincipal: string): MemoryRecallResultView;
+/**
+ * Build a V1 `MemoryProducerPort & MemoryRecallPort` backed by a V2 port. Each V1
+ * call maps to V2 via the proven builders; a V2 `Result` error becomes the V1
+ * fail-closed refusal shape the clients already handle (a producer error → an
+ * `{admitted/promoted/applied:false, reason}`; a recall error THROWS, which
+ * `recall-client` catches into its own refusal, matching the V1 recall contract).
+ */
+export declare function createV1CompatPort(v2: MemoryPortV2, resolvers: V2GapResolvers, recallReverse: V2RecallReverseResolvers): MemoryProducerPort & MemoryRecallPort;
+//# sourceMappingURL=port-v2-compat.d.ts.map

package/dist/runtime/memory/port-v2-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-v2-compat.d.ts","sourceRoot":"","sources":["../../../src/runtime/memory/port-v2-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAKV,kBAAkB,EAClB,gBAAgB,EAEhB,sBAAsB,EACtB,WAAW,EAGX,sBAAsB,EAKvB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAsB,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAC5H,OAAO,EAQL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC;IACxC,KAAK,CAAC,MAAM,EAAE,cAAc,GAAG,WAAW,CAAC;IAC3C,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC;IAC/C,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC;IAC7C,gFAAgF;IAChF,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC;CAC3C;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,wBAAwB,GAAG,sBAAsB,CAsB7G;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,cAAc,EACtB,GAAG,EAAE,wBAAwB,EAC7B,mBAAmB,EAAE,MAAM,GAC1B,sBAAsB,CASxB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,cAAc,EACzB,aAAa,EAAE,wBAAwB,GACtC,kBAAkB,GAAG,gBAAgB,CAmCvC"}

package/dist/runtime/memory/port-v2-compat.js

@@ -0,0 +1,102 @@
+/**
+ * V1→V2 anti-corruption port (path V, the cutover). `createV1CompatPort` wraps a
+ * real `MemoryPortV2` (+ the injected `V2GapResolvers`) and EXPOSES the V1
+ * `MemoryProducerPort & MemoryRecallPort` the h2a clients already consume — so
+ * admit-client / promote-client / tombstone-client / recall-client + all their
+ * fixtures (including the 1656-line D11 ceremony suite) stay UNCHANGED, and their
+ * anti-fabrication coverage is preserved by construction (nothing rewritten).
+ *
+ * This is the ACL between h2a's stable V1-facing internal API and graphify's V2
+ * contract: the clients speak V1; this port maps each call to V2 via the proven
+ * builders (`./port-v2-adapter.ts`) and maps the V2 responses back. At go-live,
+ * h2a constructs `createV1CompatPort(realGraphifyV2Port, realResolvers, realReverse)`
+ * and hands it to the clients — that IS the V2 wiring. Imports ZERO graphify
+ * runtime (only vendored types) — anti-cycle holds.
+ *
+ * The 6 gaps stay injected (`V2GapResolvers`); the recall RESPONSE reverse-mapping
+ * needs the fields V2 does not carry back flat (subject, scope, principal_owner,
+ * review_status), supplied by an injected `V2RecallReverseResolvers` — the same
+ * go-live wiring point.
+ */
+import { buildAdmissionRequest, buildCaptureRequest, buildRecallRequest, buildTombstoneCommand, mapAdmissionOutcome, mapCaptureAcknowledgement, mapLifecycleReceipt } from "./port-v2-adapter.js";
+/** Map one V2 record to the V1 projected view. Pure; the recovered fields come from `rev`. */
+export function mapRecordToView(record, rev) {
+    const primary = record.components.find((c) => c.component_id === record.primary_component_id) ?? record.components[0];
+    const primaryCitation = record.citations.find((c) => c.citation_id === record.primary_event.citation_id);
+    const view = {
+        id: record.record_id,
+        node_type: "MemoryNote",
+        memory_kind: (primary?.kind ?? "context"),
+        subject: rev.subject(record),
+        t: record.valid_time.t,
+        trust: record.trust.class,
+        review_status: rev.reviewStatus(record),
+        scope: rev.scope(record),
+        principal_owner: rev.principalOwner(record),
+        provenance: { cited: primary?.text ?? "", source: primaryCitation?.locator.value ?? "" },
+        event: {
+            at: record.primary_event.at,
+            kind: rev.eventKind(record),
+            ref: primaryCitation?.locator.value ?? ""
+        }
+    };
+    if (record.valid_time.t_end !== undefined)
+        view.t_end = record.valid_time.t_end;
+    return view;
+}
+/** Map a `RecallPacketV2` to the V1 recall result view (notes-only). */
+export function mapRecallPacket(packet, rev, requestingPrincipal) {
+    return {
+        schema: "memory-recall/v2-compat",
+        notes: packet.records.map((r) => mapRecordToView(r.record, rev)),
+        projection: "notes-only",
+        requestingPrincipal,
+        freshness: "unverified",
+        unpaged: true
+    };
+}
+/**
+ * Build a V1 `MemoryProducerPort & MemoryRecallPort` backed by a V2 port. Each V1
+ * call maps to V2 via the proven builders; a V2 `Result` error becomes the V1
+ * fail-closed refusal shape the clients already handle (a producer error → an
+ * `{admitted/promoted/applied:false, reason}`; a recall error THROWS, which
+ * `recall-client` catches into its own refusal, matching the V1 recall contract).
+ */
+export function createV1CompatPort(v2, resolvers, recallReverse) {
+    return {
+        async admitMemoryNote(note, ctx) {
+            const res = await v2.capture(buildCaptureRequest(note, ctx, resolvers));
+            if (!res.ok)
+                return { admitted: false, reason: `${res.error.code}: ${res.error.message}` };
+            return mapCaptureAcknowledgement(res.value);
+        },
+        async promoteNote(noteId, evidence, ctx) {
+            const res = await v2.requestAdmission(buildAdmissionRequest(noteId, evidence, ctx, resolvers));
+            if (!res.ok)
+                return { promoted: false, reason: `${res.error.code}: ${res.error.message}` };
+            return mapAdmissionOutcome(res.value);
+        },
+        async requestTombstone(target, auth, ctx) {
+            let command;
+            try {
+                command = buildTombstoneCommand(target, auth, ctx, resolvers);
+            }
+            catch (err) {
+                // NB-01: an unbuildable command (e.g. an edge target with no resolvable
+                // record_id) fails closed rather than mis-targeting a node.
+                return { applied: false, reason: err instanceof Error ? err.message : String(err) };
+            }
+            const res = await v2.transition(command);
+            if (!res.ok)
+                return { applied: false, reason: `${res.error.code}: ${res.error.message}` };
+            return mapLifecycleReceipt(res.value);
+        },
+        async recallMemory(query, ctx) {
+            const res = await v2.recall(buildRecallRequest(query, ctx, resolvers));
+            if (!res.ok)
+                throw new Error(`recall refused by V2 port — ${res.error.code}: ${res.error.message}`);
+            return mapRecallPacket(res.value, recallReverse, ctx.principal_owner);
+        }
+    };
+}
+//# sourceMappingURL=port-v2-compat.js.map

package/dist/runtime/memory/port-v2-compat.js.map

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

package/dist/runtime/memory/preflight.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Local pre-flight — WP11 slice 3 (build brief). Runs the VENDORED
+ * `validateMemoryNoteShape` (see `./port-v1.ts`) BEFORE a note is dispatched, so
+ * a malformed note never reaches the wire. This module does not reimplement the
+ * check: it calls the shared predicate the port publishes, so h2a's local reject
+ * stays byte-for-byte the same rule the graphify gate re-checks on admission
+ * (minus `verifyVerbatim`, the citation check, which needs source resolution and
+ * therefore stays gate-side — see the port's own doc comment).
+ */
+import { type MemoryNoteInput, type ShapeCheck } from "./port-v1.js";
+export type PreflightResult = ShapeCheck;
+/**
+ * Cheap, local, structural rejection of a malformed note. NOT the admission
+ * decision — the gate remains authoritative and re-checks on receipt.
+ */
+export declare function preflightMemoryNote(note: MemoryNoteInput): PreflightResult;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/runtime/memory/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../src/runtime/memory/preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAA2B,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE9F,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,CAE1E"}

package/dist/runtime/memory/preflight.js

@@ -0,0 +1,18 @@
+/**
+ * Local pre-flight — WP11 slice 3 (build brief). Runs the VENDORED
+ * `validateMemoryNoteShape` (see `./port-v1.ts`) BEFORE a note is dispatched, so
+ * a malformed note never reaches the wire. This module does not reimplement the
+ * check: it calls the shared predicate the port publishes, so h2a's local reject
+ * stays byte-for-byte the same rule the graphify gate re-checks on admission
+ * (minus `verifyVerbatim`, the citation check, which needs source resolution and
+ * therefore stays gate-side — see the port's own doc comment).
+ */
+import { validateMemoryNoteShape } from "./port-v1.js";
+/**
+ * Cheap, local, structural rejection of a malformed note. NOT the admission
+ * decision — the gate remains authoritative and re-checks on receipt.
+ */
+export function preflightMemoryNote(note) {
+    return validateMemoryNoteShape(note);
+}
+//# sourceMappingURL=preflight.js.map

package/dist/runtime/memory/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../../src/runtime/memory/preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,uBAAuB,EAAyC,MAAM,cAAc,CAAC;AAI9F;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAqB;IACvD,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC"}