@graphrefly/graphrefly 0.34.0 → 0.36.0

package/dist/{index-C5uMGVJw.d.ts → index-BwYGLgmI.d.ts}

@@ -1,7 +1,7 @@
-import { a as Node } from './node-8qx0kgYt.js';
-import { R as ReactiveMapBundle } from './reactive-map-LjwjcFaW.js';
-import { a as GraphOptions, G as Graph, C as CausalChain } from './graph-BROUZPG9.js';
-import { w as watchTopologyTree } from './topology-tree-CAFOG5S5.js';
+import { a as Node } from './node-fSc-hCv8.js';
+import { R as ReactiveMapBundle } from './reactive-map-CHyeCf4D.js';
+import { a as GraphOptions, G as Graph, C as CausalChain } from './graph-Cv-8x0ZI.js';
+import { w as watchTopologyTree } from './topology-tree-CJsT24DP.js';
 
 /** Aggregate topology stats emitted by {@link LensGraph.stats}. */
 interface TopologyStats {

package/dist/{index-p0bkNfby.d.cts → index-C4ig7whw.d.cts}

@@ -1,6 +1,6 @@
-import { A as Actor, a as Node, P as PolicyRuleData, G as GuardAction } from './node-8qx0kgYt.cjs';
-import { G as Graph, a as GraphOptions, d as GraphPersistSnapshot, C as CausalChain } from './graph-DaoydJ_u.cjs';
-import { T as TopicGraph } from './index-Ccv_61jG.cjs';
+import { A as Actor, a as Node, P as PolicyRuleData, G as GuardAction } from './node-fSc-hCv8.cjs';
+import { G as Graph, a as GraphOptions, b as GraphPersistSnapshot, C as CausalChain } from './graph-kTltt95s.cjs';
+import { T as TopicGraph } from './index-33mF4XyU.cjs';
 
 /**
  * Audit, policy enforcement, and compliance export (roadmap §9.2).

package/dist/{index-BRisOxlx.d.ts → index-CDvC1m5p.d.ts}

@@ -1,4 +1,4 @@
-import { a as Node } from './node-8qx0kgYt.js';
+import { a as Node } from './node-fSc-hCv8.js';
 
 /** Solid accessor function — returns current value when called. */
 type Accessor<T> = () => T;

package/dist/{index-ygRFoyrN.d.ts → index-CI_yjtua.d.ts}

@@ -1,5 +1,5 @@
-import { a as Node } from './node-8qx0kgYt.js';
-import { G as Graph } from './graph-BROUZPG9.js';
+import { a as Node } from './node-fSc-hCv8.js';
+import { G as Graph } from './graph-Cv-8x0ZI.js';
 
 /**
  * Memory patterns (roadmap §4.3).

package/dist/{index-DxEcY7Om.d.ts → index-CIcu6fIR.d.ts}

@@ -1,4 +1,4 @@
-import { a as Node } from './node-8qx0kgYt.js';
+import { a as Node } from './node-fSc-hCv8.js';
 
 /**
  * Subscribe to a read-only `Node<T>` as a React value. Re-renders on node value settlement.

package/dist/{index-Ced0dphF.d.ts → index-CVhBdCMf.d.ts}

@@ -1,12 +1,12 @@
-import { i as index$2 } from './index-DupIl9wI.js';
-import { i as index$3 } from './index-CI5fULSz.js';
-import { i as index$4 } from './index-BFHpNSsV.js';
-import { i as index$5 } from './index-DxEcY7Om.js';
-import { a as Node } from './node-8qx0kgYt.js';
-import { i as index$6 } from './index-BRisOxlx.js';
-import { i as index$7 } from './index-BWiX5foT.js';
-import { i as index$8 } from './index-zA1uVtk0.js';
-import { i as index$9 } from './index-nP13Qe6T.js';
+import { i as index$2 } from './index-JYtN9uqM.js';
+import { i as index$3 } from './index-8OxXae3g.js';
+import { i as index$4 } from './index-DLyQC5Ww.js';
+import { i as index$5 } from './index-CIcu6fIR.js';
+import { a as Node } from './node-fSc-hCv8.js';
+import { i as index$6 } from './index-CDvC1m5p.js';
+import { i as index$7 } from './index-BjWZARLy.js';
+import { i as index$8 } from './index-BiomL7AW.js';
+import { i as index$9 } from './index-DFe2Pk2u.js';
 
 /**
  * Options for creating signals.

package/dist/{index-b4a6Sg0R.d.ts → index-CZAixNU3.d.ts}

@@ -1,7 +1,7 @@
-import { P as PolicyRuleData, a as Node, A as Actor } from './node-8qx0kgYt.js';
-import { G as Graph, a as GraphOptions, b as GraphDescribeOptions, c as GraphDescribeOutput, D as DescribeFilter } from './graph-BROUZPG9.js';
-import { P as PolicyEnforcerGraph, a as PolicyViolation } from './index-CNxdDb2e.js';
-import { T as TopicGraph } from './index-Bi4ZP6Hc.js';
+import { P as PolicyRuleData, a as Node, A as Actor } from './node-fSc-hCv8.js';
+import { G as Graph, a as GraphOptions, c as GraphDescribeOptions, d as GraphDescribeOutput, D as DescribeFilter } from './graph-Cv-8x0ZI.js';
+import { P as PolicyEnforcerGraph, a as PolicyViolation } from './index-DSSsxS7B.js';
+import { T as TopicGraph } from './index-DxxvGTXp.js';
 
 /**
  * Composable safety layer (roadmap §9.0b).

package/dist/index-Cjrpx2Mg.d.cts

@@ -0,0 +1,171 @@
+import { a as Node } from './node-fSc-hCv8.cjs';
+import { R as ReactiveLogBundle } from './reactive-log-ScpWyqny.cjs';
+import { NodeInput } from './extra/sources.cjs';
+import { AppendLogStorageTier } from './extra/storage-tiers.cjs';
+import { G as Graph, a as GraphOptions } from './graph-kTltt95s.cjs';
+import { B as BaseAuditRecord } from './imperative-audit-ahAE65a9.cjs';
+
+/**
+ * Job queue patterns (roadmap §4.2).
+ *
+ * Queue / flow primitives modeled as graph factories:
+ * - `jobQueue()` — claim/ack/nack workflow with reactive depth.
+ * - `jobFlow()` — multi-stage queue chain.
+ *
+ * Topic / subscription / hub primitives live in `patterns/messaging`.
+ */
+
+type JobState = "queued" | "inflight";
+type JobEnvelope<T> = {
+    id: string;
+    payload: T;
+    attempts: number;
+    metadata: Readonly<Record<string, unknown>>;
+    state: JobState;
+};
+/** Audit record for a job-queue mutation (Audit 2 cross-cutting). */
+type JobEventAction = "enqueue" | "claim" | "ack" | "nack" | "remove";
+interface JobEvent<T = unknown> extends BaseAuditRecord {
+    readonly action: JobEventAction;
+    readonly id: string;
+    readonly attempts?: number;
+    readonly payload?: T;
+}
+/** Recommended `keyOf` for keyed-storage adapters (Audit 2 #7). */
+declare const jobEventKeyOf: <T>(e: JobEvent<T>) => string;
+type JobQueueOptions = {
+    graph?: GraphOptions;
+};
+declare class JobQueueGraph<T> extends Graph {
+    private readonly _pending;
+    private readonly _jobs;
+    private readonly _seqCursor;
+    readonly pending: Node<readonly string[]>;
+    readonly jobs: Node<ReadonlyMap<string, JobEnvelope<T>>>;
+    readonly depth: Node<number>;
+    /** Audit log of every queue mutation (Audit 2). */
+    readonly events: ReactiveLogBundle<JobEvent<T>>;
+    /** Alias for {@link JobQueueGraph.events} — Audit 2 `.audit` duplication. */
+    readonly audit: ReactiveLogBundle<JobEvent<T>>;
+    constructor(name: string, opts?: JobQueueOptions);
+    private _bumpSeq;
+    /**
+     * Wire append-log storage tiers (Audit 4). Returns a disposer.
+     *
+     * Named `attachEventStorage` to avoid colliding with {@link Graph.attachSnapshotStorage}.
+     */
+    attachEventStorage(tiers: readonly AppendLogStorageTier<JobEvent<T>>[]): () => void;
+    enqueue(payload: T, opts?: {
+        id?: string;
+        metadata?: Record<string, unknown>;
+    }): string;
+    claim(limit?: number): readonly JobEnvelope<T>[];
+    ack(id: string): boolean;
+    nack(id: string, opts?: {
+        requeue?: boolean;
+    }): boolean;
+    /**
+     * Remove a job by id regardless of its current state. Returns `true` if
+     * the job existed and was removed, `false` if no job has this id.
+     *
+     * `ack` only works on inflight; `nack` only works on inflight.
+     * `removeById` is the state-agnostic escape hatch — useful for
+     * audit/observability layers that enqueue but never claim, and need to
+     * finalize a job when an external decision (e.g. harness verify
+     * outcome) resolves it. Distinct name from the inherited
+     * {@link Graph.remove}, which removes a mounted child subgraph by path.
+     *
+     * When the job is in `queued` state, its id is also pulled from the
+     * `pending` list — depth + pending snapshot stay consistent.
+     */
+    removeById(id: string): boolean;
+    /**
+     * Subscribe to a Node and enqueue each DATA payload into this queue.
+     * Returns a disposer that stops consuming when called.
+     *
+     * Used internally by {@link JobFlowGraph} for stage-to-stage wiring but
+     * also useful for users wiring an external source into a job queue.
+     *
+     * @param source - Node whose DATA values are enqueued.
+     * @param opts - Optional enqueue options (id generator, metadata prefix).
+     */
+    consumeFrom(source: Node<T>, opts?: {
+        metadata?: Record<string, unknown>;
+    }): () => void;
+}
+/**
+ * Work function for a job flow stage. Receives the full job envelope,
+ * returns a `NodeInput<T>` — raw value (sync), Promise (async), or Node
+ * (composed pipeline). `fromAny` coerces any of these shapes.
+ *
+ * On error / rejection: the stage nacks the job (no requeue by default).
+ */
+type WorkFn<T> = (job: JobEnvelope<T>) => NodeInput<T>;
+/**
+ * Stage definition for {@link JobFlowGraph}. Either a bare name string
+ * (no work hook, pure pass-through) or a full definition object.
+ */
+type StageDef<T> = string | {
+    name: string;
+    work?: WorkFn<T>;
+    handlerVersion?: {
+        id: string;
+        version: string | number;
+    };
+};
+type JobFlowOptions<T = unknown> = {
+    graph?: GraphOptions;
+    /**
+     * Stage definitions. Each stage is either a bare name string (pure
+     * pass-through) or a `{ name, work?, handlerVersion? }` object.
+     *
+     * For back-compat, `string[]` values behave as stages with no work hook.
+     */
+    stages?: readonly StageDef<T>[];
+    maxPerPump?: number;
+};
+declare class JobFlowGraph<T> extends Graph {
+    private readonly _stageNames;
+    private readonly _stageWorkFns;
+    private readonly _queues;
+    private readonly _completed;
+    readonly completed: Node<readonly JobEnvelope<T>[]>;
+    readonly completedCount: Node<number>;
+    constructor(name: string, opts?: JobFlowOptions<T>);
+    stages(): readonly string[];
+    queue(stage: string): JobQueueGraph<T>;
+    enqueue(payload: T, opts?: {
+        id?: string;
+        metadata?: Record<string, unknown>;
+    }): string;
+    retainedCompleted(): readonly JobEnvelope<T>[];
+}
+/**
+ * Creates a Pulsar-inspired job queue graph with claim/ack/nack workflow.
+ */
+declare function jobQueue<T>(name: string, opts?: JobQueueOptions): JobQueueGraph<T>;
+/**
+ * Creates an autonomous multi-stage queue chain graph.
+ */
+declare function jobFlow<T>(name: string, opts?: JobFlowOptions<T>): JobFlowGraph<T>;
+
+type index_JobEnvelope<T> = JobEnvelope<T>;
+type index_JobEvent<T = unknown> = JobEvent<T>;
+type index_JobEventAction = JobEventAction;
+type index_JobFlowGraph<T> = JobFlowGraph<T>;
+declare const index_JobFlowGraph: typeof JobFlowGraph;
+type index_JobFlowOptions<T = unknown> = JobFlowOptions<T>;
+type index_JobQueueGraph<T> = JobQueueGraph<T>;
+declare const index_JobQueueGraph: typeof JobQueueGraph;
+type index_JobQueueOptions = JobQueueOptions;
+type index_JobState = JobState;
+type index_StageDef<T> = StageDef<T>;
+type index_WorkFn<T> = WorkFn<T>;
+declare const index_jobEventKeyOf: typeof jobEventKeyOf;
+declare const index_jobFlow: typeof jobFlow;
+declare const index_jobQueue: typeof jobQueue;
+declare namespace index {
+  export { type index_JobEnvelope as JobEnvelope, type index_JobEvent as JobEvent, type index_JobEventAction as JobEventAction, index_JobFlowGraph as JobFlowGraph, type index_JobFlowOptions as JobFlowOptions, index_JobQueueGraph as JobQueueGraph, type index_JobQueueOptions as JobQueueOptions, type index_JobState as JobState, type index_StageDef as StageDef, type index_WorkFn as WorkFn, index_jobEventKeyOf as jobEventKeyOf, index_jobFlow as jobFlow, index_jobQueue as jobQueue };
+}
+
+export { JobQueueGraph as J, type StageDef as S, type WorkFn as W, type JobEnvelope as a, type JobEvent as b, type JobEventAction as c, JobFlowGraph as d, type JobFlowOptions as e, type JobQueueOptions as f, type JobState as g, jobFlow as h, index as i, jobEventKeyOf as j, jobQueue as k };

package/dist/{index-Bd2AjMQY.d.ts → index-Cot94_82.d.ts}

@@ -1,6 +1,6 @@
-import { j as CompileSpecOptions, G as GraphSpec, c as GraphSpecCatalog, C as CatalogFnEntry, a as CatalogSourceEntry, b as ConfigFieldSchema, F as FnFactory, d as GraphSpecFeedbackEdge, e as GraphSpecNode, f as GraphSpecTemplate, g as GraphSpecTemplateRef, h as GraphSpecValidation, S as SourceFactory } from './index-Chi9IiHJ.js';
-import { G as Graph, o as GraphNodeFactory, m as GraphDiffResult } from './graph-BROUZPG9.js';
-import { StorageTier } from './extra/storage-core.js';
+import { j as CompileSpecOptions, G as GraphSpec, c as GraphSpecCatalog, C as CatalogFnEntry, a as CatalogSourceEntry, b as ConfigFieldSchema, F as FnFactory, d as GraphSpecFeedbackEdge, e as GraphSpecNode, f as GraphSpecTemplate, g as GraphSpecTemplateRef, h as GraphSpecValidation, S as SourceFactory } from './index-DlccEIi3.js';
+import { G as Graph, o as GraphNodeFactory, m as GraphDiffResult } from './graph-Cv-8x0ZI.js';
+import { KvStorageTier } from './extra/storage-tiers.js';
 
 /**
  * Surface: create a graph from a {@link GraphSpec} (§9.3-core).
@@ -121,15 +121,15 @@ interface ReduceOptions {
 declare function runReduction(spec: GraphSpec, input: unknown, opts?: ReduceOptions): Promise<unknown>;
 
 /**
- * Surface: snapshot save/restore/diff/list over {@link StorageTier} (§9.3-core).
+ * Surface: snapshot save/restore/diff/list over {@link KvStorageTier} (§9.3-core).
  *
  * One-shot snapshot management for stateless callers (MCP tools, CLI
  * commands) layered on the existing multi-tier auto-checkpoint substrate.
  * A saved snapshot is a `mode: "full"` {@link GraphCheckpointRecord} with
  * `seq: 0` — byte-identical to the baseline anchor
- * {@link Graph.attachStorage} writes on its first flush. An
+ * {@link Graph.attachSnapshotStorage} writes on its first flush. An
  * auto-checkpointed graph can therefore be restored through this surface,
- * and a surface-saved snapshot can be picked up by `attachStorage({
+ * and a surface-saved snapshot can be picked up by `attachSnapshotStorage({
  * autoRestore: true })`.
  *
  * The wire envelope stays at {@link SNAPSHOT_WIRE_VERSION}; no new format.
@@ -139,7 +139,7 @@ declare function runReduction(spec: GraphSpec, input: unknown, opts?: ReduceOpti
 
 /**
  * Current envelope version. Re-exported from `graph.ts` so the one-shot
- * surface path and `Graph.attachStorage` write byte-identical
+ * surface path and `Graph.attachSnapshotStorage` write byte-identical
  * `format_version` fields — no silent wire drift.
  */
 declare const SNAPSHOT_WIRE_VERSION = 1;
@@ -157,11 +157,11 @@ interface RestoreSnapshotOptions {
  * Write a graph's current state as a one-shot `mode: "full"` record.
  *
  * Uses the same {@link GraphCheckpointRecord} envelope as
- * {@link Graph.attachStorage} so the two persistence paths interoperate.
+ * {@link Graph.attachSnapshotStorage} so the two persistence paths interoperate.
  *
  * @throws {SurfaceError} `snapshot-failed` when the tier's `save` throws.
  */
-declare function saveSnapshot(graph: Graph, snapshotId: string, tier: StorageTier): Promise<SaveSnapshotResult>;
+declare function saveSnapshot(graph: Graph, snapshotId: string, tier: KvStorageTier): Promise<SaveSnapshotResult>;
 /**
  * Load a snapshot from a tier and materialize it as a new {@link Graph}.
  *
@@ -171,18 +171,18 @@ declare function saveSnapshot(graph: Graph, snapshotId: string, tier: StorageTie
  *
  * **Requires a `mode: "full"` record.** Surface-written snapshots from
  * {@link saveSnapshot} always qualify. Records written by
- * {@link Graph.attachStorage} with `compactEvery > 1` may be
+ * {@link Graph.attachSnapshotStorage} with `compactEvery > 1` may be
  * `mode: "diff"` between compacts — those throw `restore-failed` until
  * the tier's next compact flush (or until Phase 8.7 WAL replay lands).
  * If you need interop during development, either call
  * {@link saveSnapshot} explicitly (always full) or configure
- * `attachStorage({compactEvery: 1})`.
+ * `attachSnapshotStorage({compactEvery: 1})`.
  *
  * @throws {SurfaceError} `snapshot-not-found` on miss; `restore-failed`
  *   when the payload shape doesn't match, when the record is
  *   `mode: "diff"`, or when `Graph.fromSnapshot` rejects.
  */
-declare function restoreSnapshot(snapshotId: string, tier: StorageTier, opts?: RestoreSnapshotOptions): Promise<Graph>;
+declare function restoreSnapshot(snapshotId: string, tier: KvStorageTier, opts?: RestoreSnapshotOptions): Promise<Graph>;
 /**
  * Load two snapshots and compute a {@link GraphDiffResult} via static
  * {@link Graph.diff}. Returns the audit shape (structural + value diff,
@@ -190,37 +190,37 @@ declare function restoreSnapshot(snapshotId: string, tier: StorageTier, opts?: R
  *
  * @throws {SurfaceError} `snapshot-not-found` on either miss.
  */
-declare function diffSnapshots(snapshotIdA: string, snapshotIdB: string, tier: StorageTier): Promise<GraphDiffResult>;
+declare function diffSnapshots(snapshotIdA: string, snapshotIdB: string, tier: KvStorageTier): Promise<GraphDiffResult>;
 /**
  * Enumerate snapshot ids on a tier.
  *
  * Only keys written by {@link saveSnapshot} are returned. Surface-written
  * records are stored under the `"snapshot:"` key prefix and decoded back to
  * the caller-visible id before being returned — other keys on the same tier
- * (notably `attachStorage` baseline/WAL keys written under `graph.name`) are
+ * (notably `attachSnapshotStorage` baseline/WAL keys written under `graph.name`) are
  * filtered out automatically. This lets a single tier back both the surface
- * and `attachStorage` without leaking graph names through `listSnapshots`.
+ * and `attachSnapshotStorage` without leaking graph names through `listSnapshots`.
  *
  * @param tier — the storage tier to enumerate.
  * @param opts.includeUnprefixed — when `true`, also return keys that are
  *   NOT under the namespacing prefix. Off by default; set this when reading
  *   pre-namespacing snapshot sets.
  *
- *   **Caveat:** when a tier is shared with {@link Graph.attachStorage}, its
+ *   **Caveat:** when a tier is shared with {@link Graph.attachSnapshotStorage}, its
  *   auto-checkpoint baseline + WAL keys (written under `graph.name`) are
  *   unprefixed. Calling with `includeUnprefixed: true` returns those keys
  *   alongside surface snapshots — and subsequent `restoreSnapshot` /
  *   `deleteSnapshot` will operate on them via the fallback-lookup path,
  *   potentially overwriting or deleting live auto-checkpoint state. Use
  *   `includeUnprefixed` only against tiers you know are NOT shared with
- *   `attachStorage`, or follow up with a predicate filter to separate
+ *   `attachSnapshotStorage`, or follow up with a predicate filter to separate
  *   ids you own from ones owned by other subsystems.
  *
  * @throws {SurfaceError} `tier-no-list` when the tier does not implement
  *   the optional `list()` method. Check `typeof tier.list === "function"`
  *   before calling if you want to branch on capability.
  */
-declare function listSnapshots(tier: StorageTier, opts?: {
+declare function listSnapshots(tier: KvStorageTier, opts?: {
     includeUnprefixed?: boolean;
 }): Promise<readonly string[]>;
 /**
@@ -232,7 +232,7 @@ declare function listSnapshots(tier: StorageTier, opts?: {
  * @throws {SurfaceError} `snapshot-failed` when `clear` is unsupported
  *   or throws.
  */
-declare function deleteSnapshot(snapshotId: string, tier: StorageTier): Promise<void>;
+declare function deleteSnapshot(snapshotId: string, tier: KvStorageTier): Promise<void>;
 
 /**
  * Surface layer (§9.3-core) — shared, JSON-safe operations consumed by
@@ -245,8 +245,8 @@ declare function deleteSnapshot(snapshotId: string, tier: StorageTier): Promise<
  * 1. {@link createGraph} — `compileSpec` wrapped with typed surface errors.
  * 2. {@link reduce} — one-shot `input → pipeline → output`.
  *
- * Snapshot persistence reuses the {@link StorageTier} substrate introduced
- * for `Graph.attachStorage`, so one-shot snapshots and auto-checkpoints
+ * Snapshot persistence reuses the {@link KvStorageTier} substrate introduced
+ * for `Graph.attachSnapshotStorage`, so one-shot snapshots and auto-checkpoints
  * share the {@link GraphCheckpointRecord} envelope. No new wire format.
  *
  * Errors throw as {@link SurfaceError} — wrappers map to their native

package/dist/{index-B1hFhK1K.d.cts → index-CpZKtdMw.d.cts}

@@ -1,4 +1,4 @@
-import { a as Node } from './node-8qx0kgYt.cjs';
+import { a as Node } from './node-fSc-hCv8.cjs';
 
 /** Svelte store contract — implements the minimal `subscribe` method. */
 interface SvelteReadable<T> {

package/dist/{index-BO6t0HjV.d.cts → index-CqSJ25A9.d.cts}

@@ -1,5 +1,5 @@
 import { Ref, WatchSource } from 'vue';
-import { a as Node } from './node-8qx0kgYt.cjs';
+import { a as Node } from './node-fSc-hCv8.cjs';
 
 /**
  * Subscribe to a read-only `Node<T>` as a Vue `Ref<T>`. Auto-unsubscribes on scope disposal.

package/dist/{index-BUtCR0k6.d.ts → index-CsD0fqnO.d.ts}

@@ -1,7 +1,7 @@
-import { a as Node } from './node-8qx0kgYt.js';
+import { a as Node } from './node-fSc-hCv8.js';
 import { NodeInput } from './extra/sources.js';
-import { a as GraphOptions, G as Graph } from './graph-BROUZPG9.js';
-import { T as TopicGraph } from './index-Bi4ZP6Hc.js';
+import { a as GraphOptions, G as Graph } from './graph-Cv-8x0ZI.js';
+import { T as TopicGraph } from './index-DxxvGTXp.js';
 
 /**
  * refineLoop — universal prompt/artifact optimization loop as a reactive Graph.
@@ -27,7 +27,7 @@ import { T as TopicGraph } from './index-Bi4ZP6Hc.js';
  *    mirror is current when the next-iteration wave reaches the generate fn.
  *  - §19 terminal-emission: history / best emit once per iteration (settled),
  *    not on every intermediate wave.
- *  - §27 attachStorage: the whole graph is checkpointable — pause overnight,
+ *  - §27 attachSnapshotStorage: the whole graph is checkpointable — pause overnight,
  *    resume tomorrow from the exact iteration count, candidate set, strategy.
  *
  * Scope clamp (v1): core factory + `RefineStrategy<T>` + `blindVariation` and
@@ -175,7 +175,7 @@ interface RefineLoopOptions extends ConvergenceOptions {
 }
 /**
  * Return type — extends Graph so all observability tools (`describe`,
- * `explain`, `observe`, `attachStorage`, `snapshot`) Just Work.
+ * `explain`, `observe`, `attachSnapshotStorage`, `snapshot`) Just Work.
  */
 interface RefineLoopGraph<T> extends Graph {
     readonly best: Node<T | null>;
@@ -227,7 +227,7 @@ interface BlindVariationOptions<T> {
      * `ctx.reportCost` during each iteration is added to this node in the
      * strategy's `finally` block — fires on success AND on teacher throw so
      * partial spend is never lost. User owns the node; wire to `budgetGate`,
-     * `attachStorage`, telemetry, etc.
+     * `attachSnapshotStorage`, telemetry, etc.
      */
     tokens?: Node<number>;
     /**
@@ -303,7 +303,7 @@ interface ErrorCritiqueOptions<T> {
      * `ctx.reportCost` during each iteration is added to this node in the
      * strategy's `finally` block — fires on success AND on teacher throw so
      * partial spend is never lost. User owns the node; wire to `budgetGate`,
-     * `attachStorage`, telemetry, etc.
+     * `attachSnapshotStorage`, telemetry, etc.
      */
     tokens?: Node<number>;
     /**

package/dist/{index-ChZvMC4M.d.cts → index-CvUrRb4m.d.cts}

@@ -1,7 +1,7 @@
-import { a as Node } from './node-8qx0kgYt.cjs';
+import { a as Node } from './node-fSc-hCv8.cjs';
 import { NodeInput } from './extra/sources.cjs';
-import { a as GraphOptions, G as Graph } from './graph-DaoydJ_u.cjs';
-import { T as TopicGraph } from './index-Ccv_61jG.cjs';
+import { a as GraphOptions, G as Graph } from './graph-kTltt95s.cjs';
+import { T as TopicGraph } from './index-33mF4XyU.cjs';
 
 /**
  * refineLoop — universal prompt/artifact optimization loop as a reactive Graph.
@@ -27,7 +27,7 @@ import { T as TopicGraph } from './index-Ccv_61jG.cjs';
  *    mirror is current when the next-iteration wave reaches the generate fn.
  *  - §19 terminal-emission: history / best emit once per iteration (settled),
  *    not on every intermediate wave.
- *  - §27 attachStorage: the whole graph is checkpointable — pause overnight,
+ *  - §27 attachSnapshotStorage: the whole graph is checkpointable — pause overnight,
  *    resume tomorrow from the exact iteration count, candidate set, strategy.
  *
  * Scope clamp (v1): core factory + `RefineStrategy<T>` + `blindVariation` and
@@ -175,7 +175,7 @@ interface RefineLoopOptions extends ConvergenceOptions {
 }
 /**
  * Return type — extends Graph so all observability tools (`describe`,
- * `explain`, `observe`, `attachStorage`, `snapshot`) Just Work.
+ * `explain`, `observe`, `attachSnapshotStorage`, `snapshot`) Just Work.
  */
 interface RefineLoopGraph<T> extends Graph {
     readonly best: Node<T | null>;
@@ -227,7 +227,7 @@ interface BlindVariationOptions<T> {
      * `ctx.reportCost` during each iteration is added to this node in the
      * strategy's `finally` block — fires on success AND on teacher throw so
      * partial spend is never lost. User owns the node; wire to `budgetGate`,
-     * `attachStorage`, telemetry, etc.
+     * `attachSnapshotStorage`, telemetry, etc.
      */
     tokens?: Node<number>;
     /**
@@ -303,7 +303,7 @@ interface ErrorCritiqueOptions<T> {
      * `ctx.reportCost` during each iteration is added to this node in the
      * strategy's `finally` block — fires on success AND on teacher throw so
      * partial spend is never lost. User owns the node; wire to `budgetGate`,
-     * `attachStorage`, telemetry, etc.
+     * `attachSnapshotStorage`, telemetry, etc.
      */
     tokens?: Node<number>;
     /**

package/dist/{index-Cp91Sxbo.d.cts → index-D8IyqHvT.d.cts}

@@ -1,6 +1,6 @@
-import { b as Messages, A as Actor, C as COMPLETE, f as COMPLETE_MSG, g as COMPLETE_ONLY_BATCH, D as DATA, h as DEFAULT_ACTOR, i as DIRTY, j as DIRTY_MSG, k as DIRTY_ONLY_BATCH, l as DepRecord, E as ERROR, F as FnCtx, m as GlobalInspectorEvent, n as GlobalInspectorHook, o as GraphReFlyConfig, G as GuardAction, p as GuardDenied, q as GuardDeniedDetails, H as HashFn, I as INVALIDATE, r as INVALIDATE_MSG, s as INVALIDATE_ONLY_BATCH, M as Message, t as MessageContext, u as MessageTypeRegistration, v as MessageTypeRegistrationInput, a as Node, c as NodeActions, w as NodeCtx, e as NodeDescribeKind, x as NodeFn, d as NodeFnCleanup, y as NodeGuard, z as NodeImpl, B as NodeInspectorHook, J as NodeInspectorHookEvent, N as NodeOptions, K as NodeSink, L as NodeStatus, O as NodeTransportOptions, Q as NodeVersionInfo, R as OnMessageHandler, S as OnSubscribeHandler, T as PAUSE, U as PolicyAllow, W as PolicyDeny, P as PolicyRuleData, X as RESOLVED, Y as RESOLVED_MSG, Z as RESOLVED_ONLY_BATCH, _ as RESUME, $ as RigorRecorder, a0 as START, a1 as START_MSG, a2 as SubscribeContext, a3 as TEARDOWN, a4 as TEARDOWN_MSG, a5 as TEARDOWN_ONLY_BATCH, a6 as V0, a7 as V1, V as VersioningLevel, a8 as VersioningOptions, a9 as accessHintForGuard, aa as advanceVersion, ab as configure, ac as createVersioning, ad as defaultConfig, ae as defaultHash, af as isV1, ag as node, ah as normalizeActor, ai as policy, aj as policyFromRules, ak as registerBuiltins } from './node-8qx0kgYt.cjs';
-import { D as DescribeDetail, a as DescribeField, b as DescribeNodeOutput, r as resolveDescribeFields } from './meta-BdjSt8ky.cjs';
-import { A as AutoTrackOptions, D as DerivedFn, a as DynamicFn, E as EffectFn, P as PipeOperator, b as ProducerFn, T as TrackFn, c as autoTrackNode, d as derived, e as dynamicNode, f as effect, p as pipe, g as producer, s as state } from './sugar-DVEYhR7a.cjs';
+import { b as Messages, A as Actor, C as COMPLETE, g as COMPLETE_MSG, h as COMPLETE_ONLY_BATCH, D as DATA, i as DEFAULT_ACTOR, j as DIRTY, k as DIRTY_MSG, l as DIRTY_ONLY_BATCH, m as DepRecord, E as ERROR, F as FnCtx, n as GlobalInspectorEvent, o as GlobalInspectorHook, p as GraphReFlyConfig, G as GuardAction, q as GuardDenied, r as GuardDeniedDetails, H as HashFn, I as INVALIDATE, s as INVALIDATE_MSG, t as INVALIDATE_ONLY_BATCH, M as Message, u as MessageContext, v as MessageTypeRegistration, w as MessageTypeRegistrationInput, a as Node, c as NodeActions, x as NodeCtx, e as NodeDescribeKind, y as NodeFn, d as NodeFnCleanup, f as NodeGuard, z as NodeImpl, B as NodeInspectorHook, J as NodeInspectorHookEvent, N as NodeOptions, K as NodeSink, L as NodeStatus, O as NodeTransportOptions, Q as NodeVersionInfo, R as OnMessageHandler, S as OnSubscribeHandler, T as PAUSE, U as PolicyAllow, W as PolicyDeny, P as PolicyRuleData, X as RESOLVED, Y as RESOLVED_MSG, Z as RESOLVED_ONLY_BATCH, _ as RESUME, $ as RigorRecorder, a0 as START, a1 as START_MSG, a2 as SubscribeContext, a3 as TEARDOWN, a4 as TEARDOWN_MSG, a5 as TEARDOWN_ONLY_BATCH, a6 as V0, a7 as V1, V as VersioningLevel, a8 as VersioningOptions, a9 as accessHintForGuard, aa as advanceVersion, ab as configure, ac as createVersioning, ad as defaultConfig, ae as defaultHash, af as isV1, ag as node, ah as normalizeActor, ai as policy, aj as policyFromRules, ak as registerBuiltins } from './node-fSc-hCv8.cjs';
+import { D as DescribeDetail, a as DescribeField, b as DescribeNodeOutput, r as resolveDescribeFields } from './meta-BGO6C7K9.cjs';
+import { A as AutoTrackOptions, D as DerivedFn, a as DynamicFn, E as EffectFn, P as PipeOperator, b as ProducerFn, T as TrackFn, c as autoTrackNode, d as derived, e as dynamicNode, f as effect, p as pipe, g as producer, s as state } from './sugar-DgaGJcI6.cjs';
 
 /**
  * Batch deferral for tier-3+ messages, plus per-node emit coalescing inside

package/dist/{index-iKsmdnq6.d.cts → index-D9qoEOj_.d.cts}

@@ -1,5 +1,5 @@
-import { a as Node } from './node-8qx0kgYt.cjs';
-import { G as Graph } from './graph-DaoydJ_u.cjs';
+import { a as Node } from './node-fSc-hCv8.cjs';
+import { G as Graph } from './graph-kTltt95s.cjs';
 
 /**
  * Memory patterns (roadmap §4.3).

package/dist/{index-nP13Qe6T.d.ts → index-DFe2Pk2u.d.ts}

@@ -1,4 +1,4 @@
-import { G as Graph } from './graph-BROUZPG9.js';
+import { G as Graph } from './graph-Cv-8x0ZI.js';
 
 /** Zustand-compatible Store API. */
 interface StoreApi<T> {

package/dist/{index-IxinNgAH.d.cts → index-DHv2M7s8.d.cts}

@@ -1,17 +1,18 @@
-import { T as TokenUsage, L as LLMAdapter, P as PricingFn, C as ChatMessage, a as LLMInvokeOptions, d as ToolDefinition, b as LLMResponse, S as StreamDelta, c as ToolCall, e as CapabilitiesRegistry, M as ModelCapabilities, f as ModelFeatures, g as ModelLimits, h as ModelPricing, i as PriceBreakdown, j as PricingRegistry, R as Rate, k as TieredRate, l as composePricing, m as computePrice, n as createCapabilitiesRegistry, o as createPricingRegistry, p as pricingFor, r as registryPricing, z as zeroPrice } from './types-Cp_4coR_.cjs';
-import { a as CascadeExhaustionReport, A as AdapterProvider, b as AdapterTier, d as AllTiersExhaustedError, C as CascadingLlmAdapterOptions, e as CreateAdapterOptions, O as OpenAICompatAdapterOptions, f as OpenAICompatPreset, g as OpenAISdkLike, h as cascadingLlmAdapter, c as createAdapter, o as openAICompatAdapter, t as tier } from './cascading-DKIb6Pk8.cjs';
-import { a as Node, A as Actor } from './node-8qx0kgYt.cjs';
-import { R as ReactiveLogBundle } from './reactive-log-CWC7jO4J.cjs';
-import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './resilience-N_VtLf7W.cjs';
+import { T as TokenUsage, L as LLMAdapter, P as PricingFn, C as ChatMessage, a as LLMInvokeOptions, d as ToolDefinition, b as LLMResponse, S as StreamDelta, c as ToolCall, e as CapabilitiesRegistry, M as ModelCapabilities, f as ModelFeatures, g as ModelLimits, h as ModelPricing, i as PriceBreakdown, j as PricingRegistry, R as Rate, k as TieredRate, l as composePricing, m as computePrice, n as createCapabilitiesRegistry, o as createPricingRegistry, p as pricingFor, r as registryPricing, z as zeroPrice } from './types-BMSGPlpO.cjs';
+import { a as CascadeExhaustionReport, A as AdapterProvider, b as AdapterTier, d as AllTiersExhaustedError, C as CascadingLlmAdapterOptions, e as CreateAdapterOptions, O as OpenAICompatAdapterOptions, f as OpenAICompatPreset, g as OpenAISdkLike, h as cascadingLlmAdapter, c as createAdapter, o as openAICompatAdapter, t as tier } from './cascading-B25wxpRa.cjs';
+import { a as Node, A as Actor } from './node-fSc-hCv8.cjs';
+import { R as ReactiveLogBundle } from './reactive-log-ScpWyqny.cjs';
+import { a as CircuitBreakerOptions, e as CircuitBreaker, f as CircuitOpenError } from './resilience-BWP2c7Af.cjs';
 import { NodeInput } from './extra/sources.cjs';
-import { W as WithReplayCacheOptions, F as FallbackAdapterOptions, a as FallbackFixture, b as FallbackMissError, c as FallbackMissPolicy, R as ReplayCacheKeyContext, d as ReplayCacheMissError, e as ReplayCacheMode, f as canonicalJson, g as fallbackAdapter, w as withReplayCache } from './fallback-9YznPvPP.cjs';
-import { G as Graph, a as GraphOptions, h as GraphAttachStorageOptions } from './graph-DaoydJ_u.cjs';
-import { T as TopicGraph } from './index-Ccv_61jG.cjs';
-import { G as GateController, a as GateOptions } from './index-C2Dey3L-.cjs';
-import { D as DistillBundle, E as Extraction } from './composite-CmvdhTJe.cjs';
-import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-iKsmdnq6.cjs';
-import { StorageHandle, StorageTier } from './extra/storage-core.cjs';
-import { c as GraphSpecCatalog } from './index-BkfL5MXh.cjs';
+import { W as WithReplayCacheOptions, F as FallbackAdapterOptions, a as FallbackFixture, b as FallbackMissError, c as FallbackMissPolicy, R as ReplayCacheKeyContext, d as ReplayCacheMissError, e as ReplayCacheMode, f as canonicalJson, g as fallbackAdapter, w as withReplayCache } from './fallback-axI2cXwt.cjs';
+import { G as Graph, a as GraphOptions, i as GraphCheckpointRecord, h as GraphAttachStorageOptions } from './graph-kTltt95s.cjs';
+import { T as TopicGraph } from './index-33mF4XyU.cjs';
+import { G as GateController, c as GateOptions } from './pipeline-graph-BlLBWSZ2.cjs';
+import { D as DistillBundle, E as Extraction } from './composite-_XckYx2e.cjs';
+import { V as VectorSearchResult, L as LightCollectionBundle, a as VectorIndexBundle, K as KnowledgeGraphGraph } from './index-D9qoEOj_.cjs';
+import { StorageHandle } from './extra/storage-core.cjs';
+import { SnapshotStorageTier } from './extra/storage-tiers.cjs';
+import { c as GraphSpecCatalog } from './index-BWH17rK_.cjs';
 
 /**
  * Observable adapter wrapper — the "inverted statistics" surface.
@@ -1858,8 +1859,8 @@ type MemoryTiersOptions<TMem> = {
     /** Predicate: true → entry belongs in permanent tier (default: never). */
     permanentFilter?: (key: string, mem: TMem) => boolean;
     /** Storage tier for the archive. Omit to disable archiving. */
-    archiveTier?: StorageTier;
-    /** Options forwarded to `graph.attachStorage` for the archive tier. */
+    archiveTier?: SnapshotStorageTier<GraphCheckpointRecord>;
+    /** Options forwarded to `graph.attachSnapshotStorage` for the archive tier. */
     archiveStorageOptions?: GraphAttachStorageOptions;
 };
 /** @internal */

package/dist/{index-Cn3taOmp.d.cts → index-DKp1CIbG.d.cts}

@@ -1,5 +1,5 @@
-import { a as Node } from './node-8qx0kgYt.cjs';
-import { a as GraphOptions, G as Graph } from './graph-DaoydJ_u.cjs';
+import { a as Node } from './node-fSc-hCv8.cjs';
+import { a as GraphOptions, G as Graph } from './graph-kTltt95s.cjs';
 
 /**
  * Domain templates (roadmap §8.2).

package/dist/{index-CoR-tOZA.d.cts → index-DLyQC5Ww.d.ts}

@@ -1,9 +1,10 @@
-import { T as ToObservableOptions, t as toObservable } from './observable-B6Ba-TTI.cjs';
+import { T as ToObservableOptions, t as toObservable } from './observable-EAV_rNfM.js';
 import { OnModuleInit, OnModuleDestroy, ExecutionContext, CanActivate, DynamicModule } from '@nestjs/common';
 import { ModuleRef } from '@nestjs/core';
-import { G as Graph, d as GraphPersistSnapshot } from './graph-DaoydJ_u.cjs';
-import { A as Actor } from './node-8qx0kgYt.cjs';
-import { C as CqrsOptions, a as CqrsGraph, E as EventStoreAdapter } from './index-wcfc7W-f.cjs';
+import { G as Graph, b as GraphPersistSnapshot } from './graph-Cv-8x0ZI.js';
+import { A as Actor } from './node-fSc-hCv8.js';
+import { c as CqrsOptions, b as CqrsGraph, a as CqrsEvent } from './index-KeBhbNg3.js';
+import { AppendLogStorageTier } from './extra/storage-tiers.js';
 
 /** Class constructor key for decorator registries and Nest `ModuleRef.get()`. */
 type DecoratorHostConstructor = abstract new (...args: unknown[]) => unknown;
@@ -599,8 +600,8 @@ interface GraphReflyCqrsOptions {
     cqrs?: CqrsOptions;
     /** Build callback — registers commands, events, projections, sagas on the CqrsGraph. */
     build?: (graph: CqrsGraph) => void;
-    /** Event store adapter for persistence (wired via `useEventStore()`). */
-    eventStore?: EventStoreAdapter;
+    /** Append-log storage tiers for event persistence (wired via `attachEventStorage()`). */
+    eventStorage?: readonly AppendLogStorageTier<CqrsEvent>[];
     /**
      * Node paths (local to this feature) to expose as injectable providers.
      * Tokens are auto-qualified as `featureName::path`.
@@ -665,7 +666,7 @@ declare class GraphReflyModule {
      *   name: "orders",
      *   build: (g) => {
      *     g.event("orderPlaced");
-     *     g.projection("orderCount", ["orderPlaced"], (_s, evts) => evts.length, 0);
+     *     g.projection({ name: "orderCount", events: ["orderPlaced"], reducer: (_s, evts) => evts.length, initial: 0 });
      *   },
      * })
      * ```