arkgate 2.8.0 → 2.8.1

package/dist/{types-CP3KkwZt.d.cts → types-CSJhEOk2.d.cts}

@@ -412,17 +412,29 @@ interface AuditQuery {
     until?: string;
     limit?: number;
 }
+/**
+ * Pluggable persistence for audit records.
+ *
+ * **Durability stance (R9):** Default is `InMemoryAuditStore` — reference only, not
+ * production durability (lost on restart). Implement this interface for durable audit.
+ * See `docs/production-hardening.md`.
+ */
 interface AuditStore {
     append(record: AuditRecord): MaybePromise<void>;
     query(query?: AuditQuery): MaybePromise<AuditRecord[]>;
     clear(): MaybePromise<void>;
 }
+/**
+ * High-level audit API used by the event bus / kernel.
+ * Durability is that of the injected `AuditStore` (default in-memory).
+ */
 interface AuditTrail {
     record(input: AuditRecordInput): Promise<AuditRecord>;
     query(query?: AuditQuery): Promise<AuditRecord[]>;
     clear(): Promise<void>;
 }
 interface CreateAuditTrailOptions {
+    /** Durable store when provided; otherwise `InMemoryAuditStore` (not production durability). */
     store?: AuditStore;
     maxRecords?: number;
 }
@@ -512,6 +524,14 @@ interface OutboxRecord {
     updatedAt: string;
     error?: string;
 }
+/**
+ * Pluggable outbox for publish handoff.
+ *
+ * **Durability stance (R9):** ArkGate ships only a reference in-process store
+ * (`InMemoryOutboxStore`) for tests, demos, and single-process development — it does
+ * not survive process restarts and is **not production durability**. Inject your own
+ * `OutboxStore` (DB, queue, etc.) for real systems. See `docs/production-hardening.md`.
+ */
 interface OutboxStore {
     enqueue(event: DomainEvent): Promise<OutboxRecord>;
     markDispatched(id: string): Promise<void>;
@@ -807,6 +827,13 @@ interface ProjectionCheckpoint {
     lastCorrelationId?: string;
     updatedAt?: string;
 }
+/**
+ * Pluggable projection/read-model state.
+ *
+ * **Durability stance (R9):** Default `InMemoryReadModelStore` is reference-only (not
+ * production durability). Inject a durable store for production. See
+ * `docs/production-hardening.md`.
+ */
 interface ReadModelStore {
     load<State = unknown>(name: string): MaybePromise<State | undefined>;
     save<State = unknown>(name: string, state: State): MaybePromise<void>;
@@ -933,6 +960,13 @@ interface WorkflowSnapshot<P extends SagaContext = SagaContext> {
     completedAt?: string;
     error?: string;
 }
+/**
+ * Pluggable saga/workflow snapshot store.
+ *
+ * **Durability stance (R9):** Default `InMemoryWorkflowStore` is reference-only (not
+ * production durability). Inject a durable store for production. See
+ * `docs/production-hardening.md`.
+ */
 interface WorkflowStore {
     save<P extends SagaContext>(snapshot: WorkflowSnapshot<P>): MaybePromise<void>;
     get<P extends SagaContext = SagaContext>(id: string): MaybePromise<WorkflowSnapshot<P> | undefined>;

package/dist/{types-CP3KkwZt.d.ts → types-CSJhEOk2.d.ts}

@@ -412,17 +412,29 @@ interface AuditQuery {
     until?: string;
     limit?: number;
 }
+/**
+ * Pluggable persistence for audit records.
+ *
+ * **Durability stance (R9):** Default is `InMemoryAuditStore` — reference only, not
+ * production durability (lost on restart). Implement this interface for durable audit.
+ * See `docs/production-hardening.md`.
+ */
 interface AuditStore {
     append(record: AuditRecord): MaybePromise<void>;
     query(query?: AuditQuery): MaybePromise<AuditRecord[]>;
     clear(): MaybePromise<void>;
 }
+/**
+ * High-level audit API used by the event bus / kernel.
+ * Durability is that of the injected `AuditStore` (default in-memory).
+ */
 interface AuditTrail {
     record(input: AuditRecordInput): Promise<AuditRecord>;
     query(query?: AuditQuery): Promise<AuditRecord[]>;
     clear(): Promise<void>;
 }
 interface CreateAuditTrailOptions {
+    /** Durable store when provided; otherwise `InMemoryAuditStore` (not production durability). */
     store?: AuditStore;
     maxRecords?: number;
 }
@@ -512,6 +524,14 @@ interface OutboxRecord {
     updatedAt: string;
     error?: string;
 }
+/**
+ * Pluggable outbox for publish handoff.
+ *
+ * **Durability stance (R9):** ArkGate ships only a reference in-process store
+ * (`InMemoryOutboxStore`) for tests, demos, and single-process development — it does
+ * not survive process restarts and is **not production durability**. Inject your own
+ * `OutboxStore` (DB, queue, etc.) for real systems. See `docs/production-hardening.md`.
+ */
 interface OutboxStore {
     enqueue(event: DomainEvent): Promise<OutboxRecord>;
     markDispatched(id: string): Promise<void>;
@@ -807,6 +827,13 @@ interface ProjectionCheckpoint {
     lastCorrelationId?: string;
     updatedAt?: string;
 }
+/**
+ * Pluggable projection/read-model state.
+ *
+ * **Durability stance (R9):** Default `InMemoryReadModelStore` is reference-only (not
+ * production durability). Inject a durable store for production. See
+ * `docs/production-hardening.md`.
+ */
 interface ReadModelStore {
     load<State = unknown>(name: string): MaybePromise<State | undefined>;
     save<State = unknown>(name: string, state: State): MaybePromise<void>;
@@ -933,6 +960,13 @@ interface WorkflowSnapshot<P extends SagaContext = SagaContext> {
     completedAt?: string;
     error?: string;
 }
+/**
+ * Pluggable saga/workflow snapshot store.
+ *
+ * **Durability stance (R9):** Default `InMemoryWorkflowStore` is reference-only (not
+ * production durability). Inject a durable store for production. See
+ * `docs/production-hardening.md`.
+ */
 interface WorkflowStore {
     save<P extends SagaContext>(snapshot: WorkflowSnapshot<P>): MaybePromise<void>;
     get<P extends SagaContext = SagaContext>(id: string): MaybePromise<WorkflowSnapshot<P> | undefined>;

package/docs/package-surface.md

@@ -26,7 +26,7 @@ Gates need **no application code imports**. Most projects only use the CLI + MCP
 
 | Surface | Import path | Notes |
 |---------|-------------|--------|
-| **Runtime kernel** | **`arkgate/runtime`** (preferred) | Event bus, intents, policies, sagas, outbox, projections, `createArkKernel` / strict helpers. Optional. Not required for architecture enforcement. |
+| **Runtime kernel** | **`arkgate/runtime`** (preferred) | Event bus, intents, policies, sagas, outbox, projections, `createArkKernel` / strict helpers. Optional. Not required for architecture enforcement. Built-in stores are **InMemory reference only** (not production durability) — see [production-hardening.md](./production-hardening.md). |
 | **Root package barrel** | `arkgate` | Still re-exports the runtime kernel for **compatibility**. Prefer `arkgate/runtime` for new code. Root may be thinned in a future **major**. |
 | **NestJS adapter** | `arkgate/nestjs` | Optional peer `@nestjs/common`. Wires a kernel into Nest DI. |
 

package/docs/production-hardening.md

@@ -3,11 +3,17 @@
 The optional runtime kernel is imported from **`arkgate/runtime`** (preferred). See
 [package-surface.md](package-surface.md).
 
-Ark's built-in stores are intentionally in-memory defaults. They are appropriate for tests,
-local development, examples, and single-process demos. Production systems should provide
+## Durability stance (R9)
+
+**ArkGate does not ship production-durable adapters.** Built-in stores are **reference
+InMemory-only** — appropriate for tests, local development, examples, and single-process
+demos. They lose all state on process restart. Production systems **must** inject their
+own implementations of the store interfaces (or accept that data is ephemeral).
+
+Ark's built-in stores are intentionally in-memory defaults. Production systems should provide
 stores that match their durability, ordering, retention, and operational requirements.
 
-## In-Memory Defaults
+## In-Memory Defaults (reference only — not production durability)
 
 These defaults do not survive process restarts:
 
@@ -16,7 +22,8 @@ These defaults do not survive process restarts:
 - `InMemoryReadModelStore`
 - `InMemoryWorkflowStore`
 
-Use them only when losing state is acceptable.
+Use them only when losing state is acceptable. JSDoc on `OutboxStore`, `AuditStore`,
+`ReadModelStore`, and `WorkflowStore` restates this stance at the type level.
 
 ## Production Store Checklist
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkgate",
-  "version": "2.8.0",
+  "version": "2.8.1",
   "description": "ArkGate — architecture co-pilot for AI TypeScript (write gate, CI gate, plan/loop)",
   "type": "module",
   "main": "./dist/index.cjs",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/pedroknigge/arkgate",
     "source": "github"
   },
-  "version": "2.8.0",
+  "version": "2.8.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "arkgate",
-      "version": "2.8.0",
+      "version": "2.8.1",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"