@graphrefly/graphrefly 0.33.0 → 0.35.0

package/dist/{index-C_cXlbu0.d.cts → index-CfOSES72.d.cts}

@@ -1,10 +1,11 @@
-import { a as Node } from './node-8qx0kgYt.cjs';
-import { T as TopicGraph, M as MessagingHubGraph } from './index-Ccv_61jG.cjs';
-import { L as LLMAdapter } from './types-Cp_4coR_.cjs';
-import { E as Evaluator, D as DatasetItem, a as EvalResult$1, R as RefineStrategy, b as RefineLoopOptions, c as RefineStatus } from './index-ChZvMC4M.cjs';
-import { G as Graph, s as GraphProfileResult, r as GraphProfileOptions } from './graph-DaoydJ_u.cjs';
-import { G as GateController } from './index-C2Dey3L-.cjs';
-import { J as JobQueueGraph } from './index-ClJUZAOr.cjs';
+import { NodeInput } from './extra/sources.cjs';
+import { a as Node } from './node-fSc-hCv8.cjs';
+import { L as LLMAdapter } from './types-BMSGPlpO.cjs';
+import { T as TopicGraph, M as MessagingHubGraph } from './index-B3Dfl5sS.cjs';
+import { E as Evaluator, D as DatasetItem, a as EvalResult$1, R as RefineStrategy, b as RefineLoopOptions, c as RefineStatus } from './index-DeyzuqAi.cjs';
+import { G as Graph, s as GraphProfileResult, r as GraphProfileOptions } from './graph-kTltt95s.cjs';
+import { G as GateController } from './pipeline-graph-B85HUrWg.cjs';
+import { J as JobQueueGraph } from './index-Qq-G9B6g.cjs';
 
 /**
  * Strategy model and priority scoring (roadmap §9.0).
@@ -349,6 +350,226 @@ interface HarnessLoopOptions<A = unknown> {
     retainedLimit?: number;
 }
 
+/**
+ * actuatorExecutor — bridge a side-effecting actuator into the harness EXECUTE slot.
+ *
+ * `refineExecutor` covers the artifact-typed case (refine a candidate
+ * `T` against an evaluator); `actuatorExecutor` covers the side-effecting
+ * case (write a catalog entry, mutate a template registry, edit a doc on
+ * disk). The user's `apply` callback owns the side effect; the executor
+ * wraps it in the per-item lifecycle that makes the four
+ * {@link HarnessExecutor} contract rules structurally unreachable:
+ *
+ *  1. **One DATA per actuation.** The inner producer captures the first
+ *     DATA from the bridged `apply` result, emits a single
+ *     `ExecuteOutput<R>` carrying the actuation record as `artifact`, and
+ *     completes. Subsequent inner DATAs are ignored.
+ *  2. **Cancel-on-supersede.** A new triaged item supersedes via
+ *     `switchMap`; the prior producer's cleanup fires `ac.abort()`, which
+ *     propagates into `apply`'s `signal` (and through `fromAny`'s
+ *     internal cancellation hooks) so signal-aware actuators stop
+ *     in-flight work instead of double-writing.
+ *  3. **Item via deps, not closure mirror.** The triaged item is captured
+ *     in the `switchMap` callback's lexical scope, not mirrored to a
+ *     side-state node — same shape as `refineExecutor`.
+ *  4. **Fires on result, not input.** The producer emits exactly when
+ *     `apply`'s bridged node settles (or fails). Input-arrival waves
+ *     never produce an `ExecuteOutput`.
+ *
+ * **What `apply` may return.** Anything `fromAny` accepts: a
+ * `Promise<R>`, a `Node<R>`, an `AsyncIterable<R>`, an `Iterable<R>`,
+ * or a synchronous `R`. `Promise<R>` is the typical shape (`writeFile`,
+ * `fetch`, `db.execute`); reactive composition through `Node<R>` is the
+ * escape hatch when the actuator itself wants to surface intermediate
+ * progress before settling.
+ *
+ * **Pairing with `evalVerifier`.** `ExecuteOutput.artifact` is set to
+ * the actuation record; an `evalVerifier<R>` whose `extractArtifact`
+ * returns the record (or a transform of it — typically the post-apply
+ * world state needed by the evaluator) closes the EXECUTE → VERIFY loop
+ * with consistent typing end-to-end.
+ *
+ * @module
+ */
+
+/**
+ * What an actuator's `apply` may return. Mirrors `NodeInput<R>` plus a
+ * raw `R` for synchronous side effects, so callers can write the most
+ * direct shape for their case (Promise for async I/O, raw record for
+ * pure in-memory mutation).
+ */
+type ActuatorResult<R> = NodeInput<R>;
+/** Configuration for {@link actuatorExecutor}. */
+interface ActuatorExecutorConfig<R> {
+    /**
+     * Apply the side effect for this triaged item. Receives the abort
+     * signal — actuators that own real I/O should thread `signal` into
+     * `fetch`, `fs.writeFile`, child-process kills, etc. so that
+     * `switchMap` supersede actually cancels in-flight work.
+     *
+     * The first DATA emitted by the bridged result wins; later DATAs are
+     * discarded. ERROR (or a synchronous throw) is mapped via `onError`.
+     */
+    apply: (item: TriagedItem, opts: {
+        signal: AbortSignal;
+    }) => ActuatorResult<R>;
+    /**
+     * Optional gate — when provided and returning `false`, the actuator
+     * is skipped and the executor emits an `ExecuteOutput` with
+     * `outcome: "failure"` and detail from `skipDetail` (default
+     * `"actuator skipped (shouldApply returned false)"`). Use this to
+     * route interventions the actuator can't handle (e.g. `intervention:
+     * "investigate"` items) into the failure path so the verifier sees
+     * them.
+     */
+    shouldApply?: (item: TriagedItem) => boolean;
+    /** Detail string for the skip path. Default: includes intervention name. */
+    skipDetail?: (item: TriagedItem) => string;
+    /**
+     * Map a successfully-applied actuation record into an `ExecuteOutput<R>`.
+     * Default: `outcome: "success"`, `detail` references the intervention
+     * + summary, `artifact: record`.
+     */
+    toOutput?: (record: R, item: TriagedItem) => ExecuteOutput<R>;
+    /**
+     * Map a thrown / ERROR result into an `ExecuteOutput<R>`. Default:
+     * `outcome: "failure"`, `detail` carries the error message,
+     * `artifact: undefined`.
+     */
+    onError?: (err: unknown, item: TriagedItem) => ExecuteOutput<R>;
+    /** Node name prefix for `describe()` introspection. Default `"actuator-executor"`. */
+    name?: string;
+}
+/**
+ * Build a {@link HarnessExecutor} backed by a side-effecting actuator.
+ *
+ * @example File-system actuator that writes a catalog entry and emits the diff.
+ * ```ts
+ * const harness = harnessLoop("repair", {
+ *   adapter,
+ *   executor: actuatorExecutor<CatalogPatch>({
+ *     async apply(item, { signal }) {
+ *       const patch = patchFromItem(item);
+ *       await fs.writeFile(patch.path, patch.contents, { signal });
+ *       return patch;
+ *     },
+ *     shouldApply: (item) => item.intervention === "catalog-fn",
+ *   }),
+ *   verifier: evalVerifier<CatalogPatch>({
+ *     evaluator,
+ *     datasetFor,
+ *     extractArtifact: (exec) => exec.artifact ?? null,
+ *   }),
+ * });
+ * ```
+ */
+declare function actuatorExecutor<R>(config: ActuatorExecutorConfig<R>): HarnessExecutor<R>;
+
+/**
+ * autoSolidify — promote successful VERIFY runs into a durable artifact
+ * (catalog entry, skill, template, doc edit, …).
+ *
+ * Closes the dogfood retrospective loop: when the harness's VERIFY
+ * stage reports `verified: true`, the validated intervention should
+ * become an authoring artifact the next loop run can rely on. This
+ * primitive is the generic substrate — pass a `write` callback that
+ * does the actual promotion (e.g. `overlay.upsertTemplate` for the
+ * dogfood catalog overlay; `fs.writeFile` for a doc edit; `ctx.skill`
+ * for a Hermes-style skill registry).
+ *
+ * @example Wire the catalog overlay as the solidify target.
+ * ```ts
+ * const solidified = autoSolidify({
+ *   verifyResults: harness.verifyResults.latest,
+ *   extract: (vr) => vr.execution.artifact ?? null,
+ *   write: (entry, vr) => overlay.upsertFn(`learned-${vr.item.summary}`, entry),
+ * });
+ * solidified.subscribe(() => {}); // keep alive for log
+ * ```
+ *
+ * **Why a node and not just an effect.** The returned `Node<R>` emits
+ * each promoted artifact, so callers can pipe solidifications through
+ * the standard reactive surface (`describe()`, `observe()`, replay
+ * buffers) instead of side-channel logging. An audit / dashboard that
+ * wants "what was learned this run?" subscribes to the returned node;
+ * the `write` callback owns the durable side effect.
+ *
+ * **Idempotency is the caller's responsibility.** The primitive
+ * promotes every `verified: true` wave that passes the predicate. If
+ * the harness re-verifies the same item (e.g. via reingestion), the
+ * `write` callback is invoked again. Wrap your write fn with a
+ * dedup-by-key guard if your target store would otherwise bloat. The
+ * inner `seen` set inside this factory is intentionally absent — the
+ * harness already retains via topic logs and the user may want
+ * re-promotion semantics that are domain-specific.
+ *
+ * @module
+ */
+
+/**
+ * Configuration for {@link autoSolidify}.
+ *
+ * `R` is the artifact type the upstream EXECUTE stage produced (and
+ * `evalVerifier` carries through `execution.artifact`). `T` is the
+ * promotion shape — what `write` consumes and what the returned node
+ * emits. Often `T = R`, but they diverge when the actuator's raw
+ * artifact needs a transform before storing (e.g. wrap a `CatalogPatch`
+ * into a `CatalogEntry` with effectiveness metadata).
+ */
+interface AutoSolidifyConfig<R, T = R> {
+    /** Reactive verify-result stream. Typically `harness.verifyResults.latest`. */
+    verifyResults: Node<VerifyResult<R> | null>;
+    /**
+     * Pull the value-to-promote out of a verified VerifyResult.
+     * Default: `(vr) => vr.execution.artifact as T | null`. Return `null`
+     * to skip a particular VerifyResult even when `verified: true` (e.g.
+     * an LLM-default executor produces no artifact and there's nothing to
+     * solidify).
+     */
+    extract?: (vr: VerifyResult<R>) => T | null;
+    /**
+     * Optional gate beyond `verified === true`. When provided, the
+     * primitive only promotes when this returns `true`. Default: pass
+     * everything verified.
+     *
+     * Useful predicates:
+     *  - `(vr) => vr.item.intervention === "catalog-fn"` — only catalog work.
+     *  - `(vr) => (vr.findings ?? []).every(f => !/regression/i.test(f))` —
+     *    skip even-passes that mention regressions.
+     */
+    predicate?: (vr: VerifyResult<R>) => boolean;
+    /**
+     * Promote — usually a side effect (write to overlay, fs, KG, etc.).
+     * Receives the extracted artifact AND the originating VerifyResult so
+     * the writer can use any context it needs (item summary, eval task
+     * IDs, finding text, …) when shaping the durable record.
+     */
+    write: (artifact: T, vr: VerifyResult<R>) => void;
+    /** Node name for `describe()` introspection. Default `"auto-solidify"`. */
+    name?: string;
+}
+/**
+ * Build a `Node<T>` that subscribes to `verifyResults`, filters to
+ * verified passes that produced an extractable artifact, runs `write`,
+ * and emits the artifact. Use the returned node as a subscription
+ * point for audit / dashboard / log pipelines.
+ *
+ * **Terminal-on-error semantics.** A throw from `predicate`, `extract`,
+ * or `write` surfaces as `[[ERROR]]` on the returned node and
+ * **terminates** it — the upstream subscription tears down and no
+ * further DATA is emitted. This matches the spec's terminal-frame
+ * contract for ERROR. If you want the solidify node to stay live
+ * across user-callback throws, wrap your callbacks with try/catch
+ * internally and emit a sentinel value or no-op on failure. A future
+ * non-terminal `errors: Node<unknown>` companion may surface failures
+ * without terminating the success stream — flagged as a follow-up.
+ *
+ * @returns A `Node<T>` that emits one DATA per promoted artifact.
+ *   Stays live as long as `verifyResults` is live AND no user callback
+ *   has thrown.
+ */
+declare function autoSolidify<R, T = R>(config: AutoSolidifyConfig<R, T>): Node<T>;
+
 /**
  * Harness bridge factories (roadmap §9.0).
  *
@@ -759,6 +980,26 @@ declare class HarnessGraph<A = unknown> extends Graph {
     readonly jobs: ReadonlyMap<QueueRoute, JobQueueGraph<TriagedItem>>;
     /** Per-route gate controllers (only for gated queues). */
     readonly gates: ReadonlyMap<QueueRoute, GateController<TriagedItem>>;
+    /**
+     * Per-route queue topics — typed accessor for the four
+     * {@link QUEUE_NAMES} entries (`auto-fix`, `needs-decision`,
+     * `investigation`, `backlog`). Mirrors the `gates` / `jobs` map
+     * shape so callers can iterate `[route, topic]` pairs without
+     * hand-rolling `harness.queues.topicNames()` + meta-topic exclusion.
+     *
+     * Excludes the meta topics that share the hub:
+     * `intake` (use {@link intake}), `verify-results` (use
+     * {@link verifyResults}), `retry` (use {@link retry}), `__unrouted`
+     * (use {@link unrouted}), and the internal `triage-output` fan-in.
+     *
+     * **Why this exists.** `for (const [, topic] of harness.queues)`
+     * appears to iterate via `Graph[Symbol.iterator]`, but that yields
+     * locally-registered nodes only — and `MessagingHubGraph` mounts
+     * topics as child graphs rather than registering them locally, so
+     * the loop yields nothing. This map gives a typed, working
+     * iteration path.
+     */
+    readonly queueTopics: ReadonlyMap<QueueRoute, TopicGraph<TriagedItem>>;
     /** Strategy model bundle — record outcomes, lookup effectiveness. */
     readonly strategy: StrategyModelBundle;
     /** Global retry count across all items (circuit breaker). Reactive — subscribable. */
@@ -773,7 +1014,7 @@ declare class HarnessGraph<A = unknown> extends Graph {
      * in to priority scoring.
      */
     readonly priorityScores?: ReadonlyMap<QueueRoute, Node<number>>;
-    constructor(name: string, queues: MessagingHubGraph, jobs: Map<QueueRoute, JobQueueGraph<TriagedItem>>, gates: Map<QueueRoute, GateController<TriagedItem>>, strategy: StrategyModelBundle, totalRetries: Node<number>, totalReingestions: Node<number>, priorityScores?: Map<QueueRoute, Node<number>>);
+    constructor(name: string, queues: MessagingHubGraph, queueTopics: Map<QueueRoute, TopicGraph<TriagedItem>>, jobs: Map<QueueRoute, JobQueueGraph<TriagedItem>>, gates: Map<QueueRoute, GateController<TriagedItem>>, strategy: StrategyModelBundle, totalRetries: Node<number>, totalReingestions: Node<number>, priorityScores?: Map<QueueRoute, Node<number>>);
     /** Intake topic — publish items here to enter the loop. */
     get intake(): TopicGraph<IntakeItem>;
     /** Verify results topic — subscribe to see verification outcomes. */
@@ -1011,6 +1252,9 @@ declare function harnessTrace(harness: HarnessGraph, opts?: HarnessTraceOptions)
  * @module
  */
 
+type index_ActuatorExecutorConfig<R> = ActuatorExecutorConfig<R>;
+type index_ActuatorResult<R> = ActuatorResult<R>;
+type index_AutoSolidifyConfig<R, T = R> = AutoSolidifyConfig<R, T>;
 type index_CodeChange = CodeChange;
 type index_CodeChangeBridgeOptions = CodeChangeBridgeOptions;
 declare const index_DEFAULT_DECAY_RATE: typeof DEFAULT_DECAY_RATE;
@@ -1070,7 +1314,9 @@ type index_TriagedItem = TriagedItem;
 type index_VerifyOutput = VerifyOutput;
 type index_VerifyPromptFn<A = unknown> = VerifyPromptFn<A>;
 type index_VerifyResult<A = unknown> = VerifyResult<A>;
+declare const index_actuatorExecutor: typeof actuatorExecutor;
 declare const index_affectedTaskFilter: typeof affectedTaskFilter;
+declare const index_autoSolidify: typeof autoSolidify;
 declare const index_beforeAfterCompare: typeof beforeAfterCompare;
 declare const index_codeChangeBridge: typeof codeChangeBridge;
 declare const index_createIntakeBridge: typeof createIntakeBridge;
@@ -1091,7 +1337,7 @@ declare const index_resolvePromptFn: typeof resolvePromptFn;
 declare const index_strategyKey: typeof strategyKey;
 declare const index_strategyModel: typeof strategyModel;
 declare namespace index {
-  export { type index_CodeChange as CodeChange, type index_CodeChangeBridgeOptions as CodeChangeBridgeOptions, index_DEFAULT_DECAY_RATE as DEFAULT_DECAY_RATE, index_DEFAULT_EXECUTE_PROMPT as DEFAULT_EXECUTE_PROMPT, index_DEFAULT_QUEUE_CONFIGS as DEFAULT_QUEUE_CONFIGS, index_DEFAULT_SEVERITY_WEIGHTS as DEFAULT_SEVERITY_WEIGHTS, index_DEFAULT_TRIAGE_PROMPT as DEFAULT_TRIAGE_PROMPT, index_DEFAULT_VERIFY_PROMPT as DEFAULT_VERIFY_PROMPT, type index_ErrorClass as ErrorClass, type index_ErrorClassifier as ErrorClassifier, type index_EvalDelta as EvalDelta, type index_EvalIntakeBridgeOptions as EvalIntakeBridgeOptions, type index_EvalJudgeScore as EvalJudgeScore, type index_EvalResult as EvalResult, type index_EvalTaskDelta as EvalTaskDelta, type index_EvalTaskResult as EvalTaskResult, type index_EvalVerifierConfig as EvalVerifierConfig, type index_EvalVerifierSummary as EvalVerifierSummary, type index_ExecuteOutput as ExecuteOutput, type index_ExecutePromptFn as ExecutePromptFn, type index_ExecutionResult as ExecutionResult, type index_HarnessEvalPairConfig as HarnessEvalPairConfig, type index_HarnessExecutor as HarnessExecutor, index_HarnessGraph as HarnessGraph, type index_HarnessLoopOptions as HarnessLoopOptions, type index_HarnessProfileResult as HarnessProfileResult, type index_HarnessTraceHandle as HarnessTraceHandle, type index_HarnessTraceOptions as HarnessTraceOptions, type index_HarnessVerifier as HarnessVerifier, type index_IntakeBridgeOptions as IntakeBridgeOptions, type index_IntakeItem as IntakeItem, type index_IntakeSource as IntakeSource, type index_Intervention as Intervention, type index_KnownIntakeSource as KnownIntakeSource, type index_LintError as LintError, type index_NotifyEffectOptions as NotifyEffectOptions, type index_NotifyTransport as NotifyTransport, type index_PrioritySignals as PrioritySignals, index_QUEUE_NAMES as QUEUE_NAMES, type index_QueueConfig as QueueConfig, type index_QueueRoute as QueueRoute, type index_RefineExecutorConfig as RefineExecutorConfig, type index_RefineExecutorResult as RefineExecutorResult, type index_RootCause as RootCause, type index_Severity as Severity, type index_StrategyEntry as StrategyEntry, type index_StrategyKey as StrategyKey, type index_StrategyModelBundle as StrategyModelBundle, type index_StrategySnapshot as StrategySnapshot, type index_TestFailure as TestFailure, type index_TraceDetail as TraceDetail, type index_TraceEvent as TraceEvent, type index_TraceEventType as TraceEventType, type index_TriagePromptFn as TriagePromptFn, type index_TriagedItem as TriagedItem, type index_VerifyOutput as VerifyOutput, type index_VerifyPromptFn as VerifyPromptFn, type index_VerifyResult as VerifyResult, index_affectedTaskFilter as affectedTaskFilter, index_beforeAfterCompare as beforeAfterCompare, index_codeChangeBridge as codeChangeBridge, index_createIntakeBridge as createIntakeBridge, index_defaultErrorClassifier as defaultErrorClassifier, index_defaultLlmExecutor as defaultLlmExecutor, index_defaultLlmVerifier as defaultLlmVerifier, index_evalIntakeBridge as evalIntakeBridge, index_evalSource as evalSource, index_evalVerifier as evalVerifier, index_harnessEvalPair as harnessEvalPair, index_harnessLoop as harnessLoop, index_harnessProfile as harnessProfile, index_harnessTrace as harnessTrace, index_notifyEffect as notifyEffect, index_priorityScore as priorityScore, index_refineExecutor as refineExecutor, index_resolvePromptFn as resolvePromptFn, index_strategyKey as strategyKey, index_strategyModel as strategyModel };
+  export { type index_ActuatorExecutorConfig as ActuatorExecutorConfig, type index_ActuatorResult as ActuatorResult, type index_AutoSolidifyConfig as AutoSolidifyConfig, type index_CodeChange as CodeChange, type index_CodeChangeBridgeOptions as CodeChangeBridgeOptions, index_DEFAULT_DECAY_RATE as DEFAULT_DECAY_RATE, index_DEFAULT_EXECUTE_PROMPT as DEFAULT_EXECUTE_PROMPT, index_DEFAULT_QUEUE_CONFIGS as DEFAULT_QUEUE_CONFIGS, index_DEFAULT_SEVERITY_WEIGHTS as DEFAULT_SEVERITY_WEIGHTS, index_DEFAULT_TRIAGE_PROMPT as DEFAULT_TRIAGE_PROMPT, index_DEFAULT_VERIFY_PROMPT as DEFAULT_VERIFY_PROMPT, type index_ErrorClass as ErrorClass, type index_ErrorClassifier as ErrorClassifier, type index_EvalDelta as EvalDelta, type index_EvalIntakeBridgeOptions as EvalIntakeBridgeOptions, type index_EvalJudgeScore as EvalJudgeScore, type index_EvalResult as EvalResult, type index_EvalTaskDelta as EvalTaskDelta, type index_EvalTaskResult as EvalTaskResult, type index_EvalVerifierConfig as EvalVerifierConfig, type index_EvalVerifierSummary as EvalVerifierSummary, type index_ExecuteOutput as ExecuteOutput, type index_ExecutePromptFn as ExecutePromptFn, type index_ExecutionResult as ExecutionResult, type index_HarnessEvalPairConfig as HarnessEvalPairConfig, type index_HarnessExecutor as HarnessExecutor, index_HarnessGraph as HarnessGraph, type index_HarnessLoopOptions as HarnessLoopOptions, type index_HarnessProfileResult as HarnessProfileResult, type index_HarnessTraceHandle as HarnessTraceHandle, type index_HarnessTraceOptions as HarnessTraceOptions, type index_HarnessVerifier as HarnessVerifier, type index_IntakeBridgeOptions as IntakeBridgeOptions, type index_IntakeItem as IntakeItem, type index_IntakeSource as IntakeSource, type index_Intervention as Intervention, type index_KnownIntakeSource as KnownIntakeSource, type index_LintError as LintError, type index_NotifyEffectOptions as NotifyEffectOptions, type index_NotifyTransport as NotifyTransport, type index_PrioritySignals as PrioritySignals, index_QUEUE_NAMES as QUEUE_NAMES, type index_QueueConfig as QueueConfig, type index_QueueRoute as QueueRoute, type index_RefineExecutorConfig as RefineExecutorConfig, type index_RefineExecutorResult as RefineExecutorResult, type index_RootCause as RootCause, type index_Severity as Severity, type index_StrategyEntry as StrategyEntry, type index_StrategyKey as StrategyKey, type index_StrategyModelBundle as StrategyModelBundle, type index_StrategySnapshot as StrategySnapshot, type index_TestFailure as TestFailure, type index_TraceDetail as TraceDetail, type index_TraceEvent as TraceEvent, type index_TraceEventType as TraceEventType, type index_TriagePromptFn as TriagePromptFn, type index_TriagedItem as TriagedItem, type index_VerifyOutput as VerifyOutput, type index_VerifyPromptFn as VerifyPromptFn, type index_VerifyResult as VerifyResult, index_actuatorExecutor as actuatorExecutor, index_affectedTaskFilter as affectedTaskFilter, index_autoSolidify as autoSolidify, index_beforeAfterCompare as beforeAfterCompare, index_codeChangeBridge as codeChangeBridge, index_createIntakeBridge as createIntakeBridge, index_defaultErrorClassifier as defaultErrorClassifier, index_defaultLlmExecutor as defaultLlmExecutor, index_defaultLlmVerifier as defaultLlmVerifier, index_evalIntakeBridge as evalIntakeBridge, index_evalSource as evalSource, index_evalVerifier as evalVerifier, index_harnessEvalPair as harnessEvalPair, index_harnessLoop as harnessLoop, index_harnessProfile as harnessProfile, index_harnessTrace as harnessTrace, index_notifyEffect as notifyEffect, index_priorityScore as priorityScore, index_refineExecutor as refineExecutor, index_resolvePromptFn as resolvePromptFn, index_strategyKey as strategyKey, index_strategyModel as strategyModel };
 }
 
-export { type TraceEventType as $, type IntakeItem as A, type IntakeSource as B, type CodeChange as C, DEFAULT_DECAY_RATE as D, type ErrorClass as E, type Intervention as F, type NotifyTransport as G, type HarnessEvalPairConfig as H, type IntakeBridgeOptions as I, type QueueConfig as J, type KnownIntakeSource as K, type LintError as L, type QueueRoute as M, type NotifyEffectOptions as N, type RefineExecutorResult as O, type PrioritySignals as P, QUEUE_NAMES as Q, type RefineExecutorConfig as R, type RootCause as S, type Severity as T, type StrategyEntry as U, type StrategyKey as V, type StrategyModelBundle as W, type StrategySnapshot as X, type TestFailure as Y, type TraceDetail as Z, type TraceEvent as _, type CodeChangeBridgeOptions as a, type TriagePromptFn as a0, type TriagedItem as a1, type VerifyOutput as a2, type VerifyPromptFn as a3, type VerifyResult as a4, affectedTaskFilter as a5, beforeAfterCompare as a6, codeChangeBridge as a7, createIntakeBridge as a8, defaultErrorClassifier as a9, defaultLlmExecutor as aa, defaultLlmVerifier as ab, evalIntakeBridge as ac, evalSource as ad, evalVerifier as ae, harnessEvalPair as af, harnessLoop as ag, harnessProfile as ah, harnessTrace as ai, notifyEffect as aj, priorityScore as ak, refineExecutor as al, resolvePromptFn as am, strategyKey as an, strategyModel as ao, DEFAULT_EXECUTE_PROMPT as b, DEFAULT_QUEUE_CONFIGS as c, DEFAULT_SEVERITY_WEIGHTS as d, DEFAULT_TRIAGE_PROMPT as e, DEFAULT_VERIFY_PROMPT as f, type ErrorClassifier as g, type EvalDelta as h, index as i, type EvalIntakeBridgeOptions as j, type EvalJudgeScore as k, type EvalResult as l, type EvalTaskDelta as m, type EvalTaskResult as n, type EvalVerifierConfig as o, type EvalVerifierSummary as p, type ExecuteOutput as q, type ExecutePromptFn as r, type ExecutionResult as s, type HarnessExecutor as t, HarnessGraph as u, type HarnessLoopOptions as v, type HarnessProfileResult as w, type HarnessTraceHandle as x, type HarnessTraceOptions as y, type HarnessVerifier as z };
+export { type TestFailure as $, type ActuatorExecutorConfig as A, type HarnessTraceOptions as B, type CodeChange as C, DEFAULT_DECAY_RATE as D, type ErrorClass as E, type HarnessVerifier as F, type IntakeItem as G, type HarnessEvalPairConfig as H, type IntakeBridgeOptions as I, type IntakeSource as J, type Intervention as K, type KnownIntakeSource as L, type LintError as M, type NotifyEffectOptions as N, type NotifyTransport as O, type PrioritySignals as P, QUEUE_NAMES as Q, type QueueConfig as R, type QueueRoute as S, type RefineExecutorConfig as T, type RefineExecutorResult as U, type RootCause as V, type Severity as W, type StrategyEntry as X, type StrategyKey as Y, type StrategyModelBundle as Z, type StrategySnapshot as _, type ActuatorResult as a, type TraceDetail as a0, type TraceEvent as a1, type TraceEventType as a2, type TriagePromptFn as a3, type TriagedItem as a4, type VerifyOutput as a5, type VerifyPromptFn as a6, type VerifyResult as a7, actuatorExecutor as a8, affectedTaskFilter as a9, autoSolidify as aa, beforeAfterCompare as ab, codeChangeBridge as ac, createIntakeBridge as ad, defaultErrorClassifier as ae, defaultLlmExecutor as af, defaultLlmVerifier as ag, evalIntakeBridge as ah, evalSource as ai, evalVerifier as aj, harnessEvalPair as ak, harnessLoop as al, harnessProfile as am, harnessTrace as an, notifyEffect as ao, priorityScore as ap, refineExecutor as aq, resolvePromptFn as ar, strategyKey as as, strategyModel as at, type AutoSolidifyConfig as b, type CodeChangeBridgeOptions as c, DEFAULT_EXECUTE_PROMPT as d, DEFAULT_QUEUE_CONFIGS as e, DEFAULT_SEVERITY_WEIGHTS as f, DEFAULT_TRIAGE_PROMPT as g, DEFAULT_VERIFY_PROMPT as h, index as i, type ErrorClassifier as j, type EvalDelta as k, type EvalIntakeBridgeOptions as l, type EvalJudgeScore as m, type EvalResult as n, type EvalTaskDelta as o, type EvalTaskResult as p, type EvalVerifierConfig as q, type EvalVerifierSummary as r, type ExecuteOutput as s, type ExecutePromptFn as t, type ExecutionResult as u, type HarnessExecutor as v, HarnessGraph as w, type HarnessLoopOptions as x, type HarnessProfileResult as y, type HarnessTraceHandle as z };

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-Jgl7ev9I.d.cts → index-CzC0G0C3.d.cts}

@@ -1,12 +1,12 @@
-import { i as index$2 } from './index-BVTjuKeP.cjs';
-import { i as index$3 } from './index-DhWrMTI6.cjs';
-import { i as index$4 } from './index-CoR-tOZA.cjs';
-import { i as index$5 } from './index-ClKm7CFB.cjs';
-import { a as Node } from './node-8qx0kgYt.cjs';
-import { i as index$6 } from './index-CQ1gt4rn.cjs';
-import { i as index$7 } from './index-B1hFhK1K.cjs';
-import { i as index$8 } from './index-BO6t0HjV.cjs';
-import { i as index$9 } from './index-DR3XqZlV.cjs';
+import { i as index$2 } from './index-D_QQ_dTD.cjs';
+import { i as index$3 } from './index-B3D_z0Z6.cjs';
+import { i as index$4 } from './index-BtY2QVDf.cjs';
+import { i as index$5 } from './index-BFuVcqL8.cjs';
+import { a as Node } from './node-fSc-hCv8.cjs';
+import { i as index$6 } from './index-9xhIaM-w.cjs';
+import { i as index$7 } from './index-CpZKtdMw.cjs';
+import { i as index$8 } from './index-CqSJ25A9.cjs';
+import { i as index$9 } from './index-DmtWMP0X.cjs';
 
 /**
  * Options for creating signals.

package/dist/{index-p0bkNfby.d.cts → index-D6JRP-1_.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-B3Dfl5sS.cjs';
 
 /**
  * Audit, policy enforcement, and compliance export (roadmap §9.2).

package/dist/{index-D23g00HE.d.cts → index-D7r_vd0b.d.cts}

@@ -1,7 +1,7 @@
-import { P as PolicyRuleData, a as Node, A as Actor } from './node-8qx0kgYt.cjs';
-import { G as Graph, a as GraphOptions, b as GraphDescribeOptions, c as GraphDescribeOutput, D as DescribeFilter } from './graph-DaoydJ_u.cjs';
-import { P as PolicyEnforcerGraph, a as PolicyViolation } from './index-p0bkNfby.cjs';
-import { T as TopicGraph } from './index-Ccv_61jG.cjs';
+import { P as PolicyRuleData, a as Node, A as Actor } from './node-fSc-hCv8.cjs';
+import { G as Graph, a as GraphOptions, c as GraphDescribeOptions, d as GraphDescribeOutput, D as DescribeFilter } from './graph-kTltt95s.cjs';
+import { P as PolicyEnforcerGraph, a as PolicyViolation } from './index-D6JRP-1_.cjs';
+import { T as TopicGraph } from './index-B3Dfl5sS.cjs';
 
 /**
  * Composable safety layer (roadmap §9.0b).

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).