@graphrefly/graphrefly 0.47.1 → 0.48.0

package/dist/presets/harness/index.d.cts

@@ -3,8 +3,8 @@ import { ReactiveLogBundle, OwnershipChange, NodeInput } from '@graphrefly/pure-
 import { Graph, GraphProfileResult, GraphProfileOptions } from '@graphrefly/pure-ts/graph';
 import { R as RenderedEntry, b as ContextEntry, c as ContextView, e as TaggedContextPoolBundle } from '../../index-DLAxYaN5.cjs';
 import { b as ExecuteOutput, p as TriagedItem, V as VerifyOutput, g as HarnessVerifier, H as HarnessExecutor, k as QueueRoute } from '../../types-vCq7ShIm.cjs';
-import { f as Evaluator, D as DatasetItem, d as EvalResult, i as RefineStrategy, g as RefineLoopOptions, H as HarnessGraph, h as RefineStatus } from '../../spawnable-5mDY501F.cjs';
-export { A as AnalyzeEvent, B as BlindVariationContext, a as BlindVariationOptions, C as ConvergenceOptions, b as DecideEvent, E as ErrorCritiqueContext, c as ErrorCritiqueOptions, e as EvaluateEvent, F as Feedback, G as GenerateEvent, I as Iteration, R as RefineLoopGraph, S as SpawnPayload, j as SpawnRejection, k as SpawnableBundle, l as SpawnableGraph, m as SpawnableOpts, n as blindVariation, o as defaultLlmExecutor, p as defaultLlmVerifier, q as errorCritique, r as harnessLoop, s as refineLoop, t as spawnable } from '../../spawnable-5mDY501F.cjs';
+import { f as Evaluator, D as DatasetItem, d as EvalResult, i as RefineStrategy, g as RefineLoopOptions, H as HarnessGraph, h as RefineStatus } from '../../spawnable-B2IlW60f.cjs';
+export { A as AnalyzeEvent, B as BlindVariationContext, a as BlindVariationOptions, C as ConvergenceOptions, b as DecideEvent, E as ErrorCritiqueContext, c as ErrorCritiqueOptions, e as EvaluateEvent, F as Feedback, G as GenerateEvent, I as Iteration, R as RefineLoopGraph, S as SpawnPayload, j as SpawnRejection, k as SpawnableBundle, l as SpawnableGraph, m as SpawnableOpts, n as blindVariation, o as defaultLlmExecutor, p as defaultLlmVerifier, q as errorCritique, r as harnessLoop, s as refineLoop, t as spawnable } from '../../spawnable-B2IlW60f.cjs';
 import { TopicGraph } from '../../utils/messaging/index.cjs';
 import '../../types-BB5Lw-pB.cjs';
 import '../../utils/job-queue/index.cjs';
@@ -73,7 +73,12 @@ interface ActorHandle<T> {
 }
 interface ActorPoolOptions<T> {
     readonly name?: string;
-    /** Max recursion depth; `attachActor` with `depth > depthCap` throws. */
+    /**
+     * Max recursion depth; `attachActor` with `depth > depthCap` throws.
+     * Default: `8` (F-ACTOR, 2026-05-18 smell sweep — a finite default bounds
+     * runaway recursive fan-out; previously silently `Infinity`). Pass an
+     * explicit `Number.POSITIVE_INFINITY` to opt in to unbounded recursion.
+     */
     readonly depthCap?: number;
     /** Forwarded to the backing context pool. */
     readonly contextTopic?: string;
@@ -444,8 +449,13 @@ declare function harnessProfile(harness: HarnessGraph, opts?: GraphProfileOption
 
 /** Terminal-run snapshot passed to a custom `toOutput` mapper. */
 interface RefineExecutorResult<T> {
-    /** Best candidate the inner loop converged on. `null` if no candidates were scored. */
-    readonly best: T | null;
+    /**
+     * Best candidate the inner loop converged on. `undefined` (SENTINEL) if the
+     * inner loop never produced a best — e.g. it `errored` before any iteration
+     * settled. (`loop.best` is a SENTINEL `Node<T>` post the 2026-05-18
+     * anti-pattern sweep — no `null` placeholder.)
+     */
+    readonly best: T | undefined;
     /** Aggregate score at termination. `-Infinity` if the batch was empty. */
     readonly score: number;
     /** Reason the loop terminated. */

package/dist/presets/harness/index.d.ts

@@ -3,8 +3,8 @@ import { ReactiveLogBundle, OwnershipChange, NodeInput } from '@graphrefly/pure-
 import { Graph, GraphProfileResult, GraphProfileOptions } from '@graphrefly/pure-ts/graph';
 import { R as RenderedEntry, b as ContextEntry, c as ContextView, e as TaggedContextPoolBundle } from '../../index-DLAxYaN5.js';
 import { b as ExecuteOutput, p as TriagedItem, V as VerifyOutput, g as HarnessVerifier, H as HarnessExecutor, k as QueueRoute } from '../../types-CJWIMJiZ.js';
-import { f as Evaluator, D as DatasetItem, d as EvalResult, i as RefineStrategy, g as RefineLoopOptions, H as HarnessGraph, h as RefineStatus } from '../../spawnable-D3lR0oQu.js';
-export { A as AnalyzeEvent, B as BlindVariationContext, a as BlindVariationOptions, C as ConvergenceOptions, b as DecideEvent, E as ErrorCritiqueContext, c as ErrorCritiqueOptions, e as EvaluateEvent, F as Feedback, G as GenerateEvent, I as Iteration, R as RefineLoopGraph, S as SpawnPayload, j as SpawnRejection, k as SpawnableBundle, l as SpawnableGraph, m as SpawnableOpts, n as blindVariation, o as defaultLlmExecutor, p as defaultLlmVerifier, q as errorCritique, r as harnessLoop, s as refineLoop, t as spawnable } from '../../spawnable-D3lR0oQu.js';
+import { f as Evaluator, D as DatasetItem, d as EvalResult, i as RefineStrategy, g as RefineLoopOptions, H as HarnessGraph, h as RefineStatus } from '../../spawnable-tttFz2Nh.js';
+export { A as AnalyzeEvent, B as BlindVariationContext, a as BlindVariationOptions, C as ConvergenceOptions, b as DecideEvent, E as ErrorCritiqueContext, c as ErrorCritiqueOptions, e as EvaluateEvent, F as Feedback, G as GenerateEvent, I as Iteration, R as RefineLoopGraph, S as SpawnPayload, j as SpawnRejection, k as SpawnableBundle, l as SpawnableGraph, m as SpawnableOpts, n as blindVariation, o as defaultLlmExecutor, p as defaultLlmVerifier, q as errorCritique, r as harnessLoop, s as refineLoop, t as spawnable } from '../../spawnable-tttFz2Nh.js';
 import { TopicGraph } from '../../utils/messaging/index.js';
 import '../../types-BB5Lw-pB.js';
 import '../../utils/job-queue/index.js';
@@ -73,7 +73,12 @@ interface ActorHandle<T> {
 }
 interface ActorPoolOptions<T> {
     readonly name?: string;
-    /** Max recursion depth; `attachActor` with `depth > depthCap` throws. */
+    /**
+     * Max recursion depth; `attachActor` with `depth > depthCap` throws.
+     * Default: `8` (F-ACTOR, 2026-05-18 smell sweep — a finite default bounds
+     * runaway recursive fan-out; previously silently `Infinity`). Pass an
+     * explicit `Number.POSITIVE_INFINITY` to opt in to unbounded recursion.
+     */
     readonly depthCap?: number;
     /** Forwarded to the backing context pool. */
     readonly contextTopic?: string;
@@ -444,8 +449,13 @@ declare function harnessProfile(harness: HarnessGraph, opts?: GraphProfileOption
 
 /** Terminal-run snapshot passed to a custom `toOutput` mapper. */
 interface RefineExecutorResult<T> {
-    /** Best candidate the inner loop converged on. `null` if no candidates were scored. */
-    readonly best: T | null;
+    /**
+     * Best candidate the inner loop converged on. `undefined` (SENTINEL) if the
+     * inner loop never produced a best — e.g. it `errored` before any iteration
+     * settled. (`loop.best` is a SENTINEL `Node<T>` post the 2026-05-18
+     * anti-pattern sweep — no `null` placeholder.)
+     */
+    readonly best: T | undefined;
     /** Aggregate score at termination. `-Infinity` if the batch was empty. */
     readonly score: number;
     /** Reason the loop terminated. */

package/dist/presets/harness/index.js

@@ -7,8 +7,8 @@ import {
   harnessTrace,
   ownershipController,
   refineExecutor
-} from "../../chunk-B4AKFXGE.js";
-import "../../chunk-MTTRCEJT.js";
+} from "../../chunk-TPTZZV25.js";
+import "../../chunk-DVTDF5OI.js";
 import {
   HarnessGraph,
   RefineLoopGraph,
@@ -20,33 +20,33 @@ import {
   harnessLoop,
   refineLoop,
   spawnable
-} from "../../chunk-V4Y3TM7U.js";
-import "../../chunk-RGMTUZCL.js";
+} from "../../chunk-YBJVKMTM.js";
+import "../../chunk-65OM4XLQ.js";
 import "../../chunk-OIWU3NYV.js";
-import "../../chunk-PKPO3JTZ.js";
-import "../../chunk-K7PDZYQE.js";
-import "../../chunk-2OB3CEJS.js";
-import "../../chunk-7ADWWI2T.js";
-import "../../chunk-4GYMCUDZ.js";
-import "../../chunk-RJOG4IJU.js";
-import "../../chunk-RAGGHLCV.js";
-import "../../chunk-CXANAIZU.js";
-import "../../chunk-IHTWQEDR.js";
-import "../../chunk-YXCPV26R.js";
-import "../../chunk-U225SKB4.js";
-import "../../chunk-NPRP3MCV.js";
-import "../../chunk-QMBYUVRL.js";
-import "../../chunk-FMPF42Q4.js";
-import "../../chunk-BXGZFGZ4.js";
-import "../../chunk-BU3SEFA5.js";
-import "../../chunk-A7KV5UK4.js";
-import "../../chunk-DKNHAICT.js";
-import "../../chunk-O3MT7DYI.js";
-import "../../chunk-SOOKUYVM.js";
-import "../../chunk-Y52CS6YA.js";
-import "../../chunk-Z4YXAUDN.js";
+import "../../chunk-AQAKDE7F.js";
+import "../../chunk-MQMTRKY3.js";
+import "../../chunk-B5Y5GPD5.js";
+import "../../chunk-LTSI7ULC.js";
+import "../../chunk-ZW32BPXV.js";
+import "../../chunk-T2U6N3FV.js";
+import "../../chunk-T5URUIIY.js";
+import "../../chunk-GUNIRPEJ.js";
+import "../../chunk-XEWV254I.js";
+import "../../chunk-3REMCHSS.js";
+import "../../chunk-K4ZYJ4EM.js";
+import "../../chunk-DHDCOOJU.js";
+import "../../chunk-F7EKHR32.js";
+import "../../chunk-JA67ZQG2.js";
+import "../../chunk-KUFXLAEY.js";
 import "../../chunk-TSBFTJKM.js";
 import "../../chunk-P5LBT622.js";
+import "../../chunk-QMBYUVRL.js";
+import "../../chunk-FMPF42Q4.js";
+import "../../chunk-C5QD5DQX.js";
+import "../../chunk-V46JWFGV.js";
+import "../../chunk-G7H6PN7P.js";
+import "../../chunk-MMHGYX44.js";
+import "../../chunk-N6MNJNHB.js";
 import "../../chunk-AZDQPQ3V.js";
 export {
   HarnessGraph,