@victframework/runtime 0.1.0

package/dist/control-conformance.d.ts

@@ -0,0 +1,68 @@
+/** Minimal test-runner seam: the caller supplies the framework bindings. */
+export interface ConformanceRunner {
+    describe(name: string, fn: () => void): void;
+    it(name: string, fn: () => Promise<void> | void): void;
+    expect<T>(actual: T): {
+        toBe(expected: T): void;
+        toEqual(expected: unknown): void;
+        toHaveLength(n: number): void;
+        toBeDefined(): void;
+        toBeUndefined(): void;
+        toContain(expected: unknown): void;
+        not: {
+            toContain(expected: unknown): void;
+            toBe(expected: T): void;
+        };
+        resolves: {
+            toEqual(expected: unknown): Promise<void>;
+            toBeDefined(): Promise<void>;
+            toBeUndefined(): Promise<void>;
+        };
+        rejects: {
+            toThrow(pattern?: RegExp | string): Promise<void>;
+        };
+    };
+}
+import type { AgentControlStores } from './control-types.js';
+/**
+ * Stage 06B shared conformance suite for the control-plane and
+ * agent-execution stores. The SAME behavioral source runs against the
+ * in-memory reference adapter AND the durable SQLite adapter, so the two
+ * adapters cannot diverge on:
+ *
+ * - ChangeSet durability (idempotent save, collision rejection,
+ *   content-identity guard on raw updates, first-wins approval decisions);
+ * - release governance (immutable publish, monotonic selections,
+ *   rollback-as-select);
+ * - audit events (idempotent append, filtered reads);
+ * - turn state machine (forward-only, terminal fencing, cancel-intent
+ *   dedup, restart reconciliation);
+ * - tool invocations (durable-before-invocation intent, idempotency-key
+ *   dedup with digest collision detection, terminal fencing);
+ * - approval records (one pending per invocation, first decision wins,
+ *   idempotent identical decisions, expiry);
+ * - stream ledger (strictly monotonic per-stream sequences, transient
+ *   delta non-persistence, durable milestone rows, ordered replay,
+ *   reopen equivalence).
+ */
+/** A conformance factory producing a store set. */
+export interface AgentControlConformanceFactory {
+    readonly name: string;
+    create(options?: {
+        readonly path?: string;
+    }): Promise<AgentControlStores & {
+        dispose(): Promise<void> | void;
+    }>;
+    /** A fresh durable database path for one reopen scenario. */
+    freshPath?(): string;
+    /** Reopen the SAME durable state in a fresh adapter instance (SQLite). */
+    reopen?(options: {
+        readonly path: string;
+    }): Promise<AgentControlStores & {
+        dispose(): Promise<void> | void;
+    }>;
+}
+/** Build and run the conformance suite against one store factory. */
+export declare function runAgentControlConformanceSuite(factory: AgentControlConformanceFactory, runner: ConformanceRunner): void;
+/** Convenience: run the suite against the in-memory factory. */
+export declare function inMemoryAgentControlConformanceFactory(): AgentControlConformanceFactory;