ark-runtime-kernel 1.1.0 → 1.3.0

package/docs/production-hardening.md

@@ -0,0 +1,59 @@
+# Production Hardening
+
+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
+stores that match their durability, ordering, retention, and operational requirements.
+
+## In-Memory Defaults
+
+These defaults do not survive process restarts:
+
+- `InMemoryAuditStore`
+- `InMemoryOutboxStore`
+- `InMemoryReadModelStore`
+- `InMemoryWorkflowStore`
+
+Use them only when losing state is acceptable.
+
+## Production Store Checklist
+
+When implementing Ark store interfaces in production, cover these guarantees explicitly:
+
+- Durability: records survive process restarts and deploys.
+- Idempotency: repeated writes or dispatch attempts do not corrupt state.
+- Ordering: event/outbox ordering is defined where consumers depend on it.
+- Concurrency: simultaneous publishers/workers cannot race checkpoints or workflow state.
+- Retention: audit and trace records have an explicit retention policy.
+- Observability: failed writes and dispatches are visible to operators.
+- Migration: schema changes for stored records are versioned.
+
+## Interface Targets
+
+| Concern | Interface |
+|---------|-----------|
+| Audit records | `AuditStore` |
+| Outbox dispatch handoff | `OutboxStore` |
+| Projection state | `ReadModelStore` |
+| Workflow snapshots | `WorkflowStore` |
+
+## Example Shape
+
+```ts
+class DurableAuditStore implements AuditStore {
+  async append(record: AuditRecord): Promise<void> {
+    // Insert into your database with an idempotent key.
+  }
+
+  async query(query: AuditQuery = {}): Promise<AuditRecord[]> {
+    // Apply query filters and retention-aware ordering.
+    return [];
+  }
+
+  async clear(): Promise<void> {
+    // Usually only enabled in tests or isolated maintenance jobs.
+  }
+}
+```
+
+Ark does not ship a database adapter in core because storage choice is operationally
+specific. Keep those adapters in the application or a separate integration package.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ark-runtime-kernel",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "Architectural Runtime Kernel — governance for Hexagonal + Event-Driven + DDD systems",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -24,6 +24,7 @@
     }
   },
   "bin": {
+    "ark": "bin/ark.mjs",
     "ark-check": "bin/ark-check.mjs",
     "ark-mcp": "bin/ark-mcp.mjs"
   },
@@ -31,6 +32,7 @@
   "files": [
     "bin",
     "dist",
+    "docs",
     "server.json",
     "README.md",
     "LICENSE"
@@ -43,6 +45,7 @@
     "typecheck": "tsc --noEmit",
     "check:architecture": "node bin/ark-check.mjs --root . --config ark.config.json --strict-config",
     "clean": "rm -rf dist",
+    "postinstall": "node bin/ark-postinstall.mjs",
     "release:npm": "node scripts/release-npm.mjs",
     "prepack": "npm run build"
   },

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/pedroknigge/ark-runtime-kernel",
     "source": "github"
   },
-  "version": "1.1.0",
+  "version": "1.3.0",
   "packages": [
     {
       "registry_type": "npm",
       "identifier": "ark-runtime-kernel",
-      "version": "1.1.0",
+      "version": "1.3.0",
       "transport": {
         "type": "stdio"
       },