@graphrefly/graphrefly 0.14.0 → 0.15.0

package/dist/index.d.cts

@@ -2105,12 +2105,16 @@ interface StrategyEntry {
 /** Key format: `${rootCause}→${intervention}`. */
 type StrategyKey = `${RootCause}→${Intervention}`;
 declare function strategyKey(rootCause: RootCause, intervention: Intervention): StrategyKey;
-/** Result of the EXECUTE stage. */
+/** LLM output shape from the EXECUTE stage (partial — lacks `item`). */
+type ExecuteOutput = {
+    outcome: "success" | "failure" | "partial";
+    detail: string;
+};
+/** Full execution result assembled downstream (LLM output + context). */
 interface ExecutionResult {
     item: TriagedItem;
     outcome: "success" | "failure" | "partial";
     detail: string;
-    retryCount: number;
 }
 /** Whether an error is self-correctable (fast-retry) or structural (full loop). */
 type ErrorClass = "self-correctable" | "structural";
@@ -2442,7 +2446,11 @@ declare class HarnessGraph extends Graph {
     readonly strategy: StrategyModelBundle;
     /** Verify results topic — subscribe to see verification outcomes. */
     readonly verifyResults: TopicGraph<VerifyResult>;
-    constructor(name: string, intake: TopicGraph<IntakeItem>, queues: Map<QueueRoute, TopicGraph<TriagedItem>>, gates: Map<QueueRoute, GateController<TriagedItem>>, strategy: StrategyModelBundle, verifyResults: TopicGraph<VerifyResult>);
+    /** Per-item fast-retry counts (keyed by base summary). */
+    readonly retryTracker: ReadonlyMap<string, number>;
+    /** Per-item reingestion counts (keyed by base summary). */
+    readonly reingestionTracker: ReadonlyMap<string, number>;
+    constructor(name: string, intake: TopicGraph<IntakeItem>, queues: Map<QueueRoute, TopicGraph<TriagedItem>>, gates: Map<QueueRoute, GateController<TriagedItem>>, strategy: StrategyModelBundle, verifyResults: TopicGraph<VerifyResult>, retryTracker: Map<string, number>, reingestionTracker: Map<string, number>);
 }
 /**
  * Wire the reactive collaboration loop as a static-topology graph.
@@ -2481,6 +2489,7 @@ type index$1_EvalIntakeBridgeOptions = EvalIntakeBridgeOptions;
 type index$1_EvalJudgeScore = EvalJudgeScore;
 type index$1_EvalResult = EvalResult;
 type index$1_EvalTaskResult = EvalTaskResult;
+type index$1_ExecuteOutput = ExecuteOutput;
 type index$1_ExecutionResult = ExecutionResult;
 type index$1_HarnessGraph = HarnessGraph;
 declare const index$1_HarnessGraph: typeof HarnessGraph;
@@ -2506,7 +2515,7 @@ declare const index$1_priorityScore: typeof priorityScore;
 declare const index$1_strategyKey: typeof strategyKey;
 declare const index$1_strategyModel: typeof strategyModel;
 declare namespace index$1 {
-  export { index$1_DEFAULT_DECAY_RATE as DEFAULT_DECAY_RATE, index$1_DEFAULT_QUEUE_CONFIGS as DEFAULT_QUEUE_CONFIGS, index$1_DEFAULT_SEVERITY_WEIGHTS as DEFAULT_SEVERITY_WEIGHTS, type index$1_ErrorClass as ErrorClass, type index$1_ErrorClassifier as ErrorClassifier, type index$1_EvalIntakeBridgeOptions as EvalIntakeBridgeOptions, type index$1_EvalJudgeScore as EvalJudgeScore, type index$1_EvalResult as EvalResult, type index$1_EvalTaskResult as EvalTaskResult, type index$1_ExecutionResult as ExecutionResult, index$1_HarnessGraph as HarnessGraph, type index$1_HarnessLoopOptions as HarnessLoopOptions, type index$1_IntakeItem as IntakeItem, type index$1_IntakeSource as IntakeSource, type index$1_Intervention as Intervention, type index$1_PrioritySignals as PrioritySignals, type index$1_QueueConfig as QueueConfig, type index$1_QueueRoute as QueueRoute, type index$1_RootCause as RootCause, type index$1_Severity as Severity, type index$1_StrategyEntry as StrategyEntry, type index$1_StrategyKey as StrategyKey, type index$1_StrategyModelBundle as StrategyModelBundle, type index$1_StrategySnapshot as StrategySnapshot, type index$1_TriagedItem as TriagedItem, type index$1_VerifyResult as VerifyResult, index$1_defaultErrorClassifier as defaultErrorClassifier, index$1_evalIntakeBridge as evalIntakeBridge, index$1_harnessLoop as harnessLoop, index$1_priorityScore as priorityScore, index$1_strategyKey as strategyKey, index$1_strategyModel as strategyModel };
+  export { index$1_DEFAULT_DECAY_RATE as DEFAULT_DECAY_RATE, index$1_DEFAULT_QUEUE_CONFIGS as DEFAULT_QUEUE_CONFIGS, index$1_DEFAULT_SEVERITY_WEIGHTS as DEFAULT_SEVERITY_WEIGHTS, type index$1_ErrorClass as ErrorClass, type index$1_ErrorClassifier as ErrorClassifier, type index$1_EvalIntakeBridgeOptions as EvalIntakeBridgeOptions, type index$1_EvalJudgeScore as EvalJudgeScore, type index$1_EvalResult as EvalResult, type index$1_EvalTaskResult as EvalTaskResult, type index$1_ExecuteOutput as ExecuteOutput, type index$1_ExecutionResult as ExecutionResult, index$1_HarnessGraph as HarnessGraph, type index$1_HarnessLoopOptions as HarnessLoopOptions, type index$1_IntakeItem as IntakeItem, type index$1_IntakeSource as IntakeSource, type index$1_Intervention as Intervention, type index$1_PrioritySignals as PrioritySignals, type index$1_QueueConfig as QueueConfig, type index$1_QueueRoute as QueueRoute, type index$1_RootCause as RootCause, type index$1_Severity as Severity, type index$1_StrategyEntry as StrategyEntry, type index$1_StrategyKey as StrategyKey, type index$1_StrategyModelBundle as StrategyModelBundle, type index$1_StrategySnapshot as StrategySnapshot, type index$1_TriagedItem as TriagedItem, type index$1_VerifyResult as VerifyResult, index$1_defaultErrorClassifier as defaultErrorClassifier, index$1_evalIntakeBridge as evalIntakeBridge, index$1_harnessLoop as harnessLoop, index$1_priorityScore as priorityScore, index$1_strategyKey as strategyKey, index$1_strategyModel as strategyModel };
 }
 
 /**

package/dist/index.d.ts

@@ -2105,12 +2105,16 @@ interface StrategyEntry {
 /** Key format: `${rootCause}→${intervention}`. */
 type StrategyKey = `${RootCause}→${Intervention}`;
 declare function strategyKey(rootCause: RootCause, intervention: Intervention): StrategyKey;
-/** Result of the EXECUTE stage. */
+/** LLM output shape from the EXECUTE stage (partial — lacks `item`). */
+type ExecuteOutput = {
+    outcome: "success" | "failure" | "partial";
+    detail: string;
+};
+/** Full execution result assembled downstream (LLM output + context). */
 interface ExecutionResult {
     item: TriagedItem;
     outcome: "success" | "failure" | "partial";
     detail: string;
-    retryCount: number;
 }
 /** Whether an error is self-correctable (fast-retry) or structural (full loop). */
 type ErrorClass = "self-correctable" | "structural";
@@ -2442,7 +2446,11 @@ declare class HarnessGraph extends Graph {
     readonly strategy: StrategyModelBundle;
     /** Verify results topic — subscribe to see verification outcomes. */
     readonly verifyResults: TopicGraph<VerifyResult>;
-    constructor(name: string, intake: TopicGraph<IntakeItem>, queues: Map<QueueRoute, TopicGraph<TriagedItem>>, gates: Map<QueueRoute, GateController<TriagedItem>>, strategy: StrategyModelBundle, verifyResults: TopicGraph<VerifyResult>);
+    /** Per-item fast-retry counts (keyed by base summary). */
+    readonly retryTracker: ReadonlyMap<string, number>;
+    /** Per-item reingestion counts (keyed by base summary). */
+    readonly reingestionTracker: ReadonlyMap<string, number>;
+    constructor(name: string, intake: TopicGraph<IntakeItem>, queues: Map<QueueRoute, TopicGraph<TriagedItem>>, gates: Map<QueueRoute, GateController<TriagedItem>>, strategy: StrategyModelBundle, verifyResults: TopicGraph<VerifyResult>, retryTracker: Map<string, number>, reingestionTracker: Map<string, number>);
 }
 /**
  * Wire the reactive collaboration loop as a static-topology graph.
@@ -2481,6 +2489,7 @@ type index$1_EvalIntakeBridgeOptions = EvalIntakeBridgeOptions;
 type index$1_EvalJudgeScore = EvalJudgeScore;
 type index$1_EvalResult = EvalResult;
 type index$1_EvalTaskResult = EvalTaskResult;
+type index$1_ExecuteOutput = ExecuteOutput;
 type index$1_ExecutionResult = ExecutionResult;
 type index$1_HarnessGraph = HarnessGraph;
 declare const index$1_HarnessGraph: typeof HarnessGraph;
@@ -2506,7 +2515,7 @@ declare const index$1_priorityScore: typeof priorityScore;
 declare const index$1_strategyKey: typeof strategyKey;
 declare const index$1_strategyModel: typeof strategyModel;
 declare namespace index$1 {
-  export { index$1_DEFAULT_DECAY_RATE as DEFAULT_DECAY_RATE, index$1_DEFAULT_QUEUE_CONFIGS as DEFAULT_QUEUE_CONFIGS, index$1_DEFAULT_SEVERITY_WEIGHTS as DEFAULT_SEVERITY_WEIGHTS, type index$1_ErrorClass as ErrorClass, type index$1_ErrorClassifier as ErrorClassifier, type index$1_EvalIntakeBridgeOptions as EvalIntakeBridgeOptions, type index$1_EvalJudgeScore as EvalJudgeScore, type index$1_EvalResult as EvalResult, type index$1_EvalTaskResult as EvalTaskResult, type index$1_ExecutionResult as ExecutionResult, index$1_HarnessGraph as HarnessGraph, type index$1_HarnessLoopOptions as HarnessLoopOptions, type index$1_IntakeItem as IntakeItem, type index$1_IntakeSource as IntakeSource, type index$1_Intervention as Intervention, type index$1_PrioritySignals as PrioritySignals, type index$1_QueueConfig as QueueConfig, type index$1_QueueRoute as QueueRoute, type index$1_RootCause as RootCause, type index$1_Severity as Severity, type index$1_StrategyEntry as StrategyEntry, type index$1_StrategyKey as StrategyKey, type index$1_StrategyModelBundle as StrategyModelBundle, type index$1_StrategySnapshot as StrategySnapshot, type index$1_TriagedItem as TriagedItem, type index$1_VerifyResult as VerifyResult, index$1_defaultErrorClassifier as defaultErrorClassifier, index$1_evalIntakeBridge as evalIntakeBridge, index$1_harnessLoop as harnessLoop, index$1_priorityScore as priorityScore, index$1_strategyKey as strategyKey, index$1_strategyModel as strategyModel };
+  export { index$1_DEFAULT_DECAY_RATE as DEFAULT_DECAY_RATE, index$1_DEFAULT_QUEUE_CONFIGS as DEFAULT_QUEUE_CONFIGS, index$1_DEFAULT_SEVERITY_WEIGHTS as DEFAULT_SEVERITY_WEIGHTS, type index$1_ErrorClass as ErrorClass, type index$1_ErrorClassifier as ErrorClassifier, type index$1_EvalIntakeBridgeOptions as EvalIntakeBridgeOptions, type index$1_EvalJudgeScore as EvalJudgeScore, type index$1_EvalResult as EvalResult, type index$1_EvalTaskResult as EvalTaskResult, type index$1_ExecuteOutput as ExecuteOutput, type index$1_ExecutionResult as ExecutionResult, index$1_HarnessGraph as HarnessGraph, type index$1_HarnessLoopOptions as HarnessLoopOptions, type index$1_IntakeItem as IntakeItem, type index$1_IntakeSource as IntakeSource, type index$1_Intervention as Intervention, type index$1_PrioritySignals as PrioritySignals, type index$1_QueueConfig as QueueConfig, type index$1_QueueRoute as QueueRoute, type index$1_RootCause as RootCause, type index$1_Severity as Severity, type index$1_StrategyEntry as StrategyEntry, type index$1_StrategyKey as StrategyKey, type index$1_StrategyModelBundle as StrategyModelBundle, type index$1_StrategySnapshot as StrategySnapshot, type index$1_TriagedItem as TriagedItem, type index$1_VerifyResult as VerifyResult, index$1_defaultErrorClassifier as defaultErrorClassifier, index$1_evalIntakeBridge as evalIntakeBridge, index$1_harnessLoop as harnessLoop, index$1_priorityScore as priorityScore, index$1_strategyKey as strategyKey, index$1_strategyModel as strategyModel };
 }
 
 /**

package/dist/index.js

@@ -142,6 +142,19 @@ import {
   cqrs_exports,
   nestjs_exports
 } from "./chunk-2ZICUAUJ.js";
+import {
+  JsonCodec,
+  createDagCborCodec,
+  createDagCborZstdCodec,
+  graph_exports,
+  negotiateCodec,
+  replayWAL
+} from "./chunk-ZHTHUX5D.js";
+import {
+  DEFAULT_DOWN,
+  bridge,
+  core_exports
+} from "./chunk-YW6LFCFS.js";
 import {
   cached,
   createWatermarkController,
@@ -175,19 +188,6 @@ import {
   toMessages$,
   toObservable
 } from "./chunk-QVYZD65U.js";
-import {
-  JsonCodec,
-  createDagCborCodec,
-  createDagCborZstdCodec,
-  graph_exports,
-  negotiateCodec,
-  replayWAL
-} from "./chunk-ZHTHUX5D.js";
-import {
-  DEFAULT_DOWN,
-  bridge,
-  core_exports
-} from "./chunk-YW6LFCFS.js";
 import {
   ResettableTimer
 } from "./chunk-WZ2Z2CRV.js";
@@ -1607,7 +1607,9 @@ function promptNode(adapter, deps, prompt, opts) {
   const messagesNode = derived(
     deps,
     (values) => {
+      if (values.some((v) => v == null)) return [];
       const text = typeof prompt === "string" ? prompt : prompt(...values);
+      if (!text) return [];
       const msgs = [];
       if (opts?.systemPrompt) msgs.push({ role: "system", content: opts.systemPrompt });
       msgs.push({ role: "user", content: text });
@@ -5936,6 +5938,9 @@ function priorityScore(item, strategy, lastInteractionNs, urgency, signals) {
 }
 
 // src/patterns/harness/loop.ts
+function baseSummary(summary) {
+  return summary.replace(/^\[RETRY \d+\/\d+\]\s*/, "");
+}
 var DEFAULT_TRIAGE_PROMPT = `You are a triage classifier for a reactive collaboration harness.
 
 Given an intake item, classify it and output JSON:
@@ -5997,13 +6002,19 @@ var HarnessGraph = class extends Graph {
   strategy;
   /** Verify results topic — subscribe to see verification outcomes. */
   verifyResults;
-  constructor(name, intake, queues, gates, strategy, verifyResults) {
+  /** Per-item fast-retry counts (keyed by base summary). */
+  retryTracker;
+  /** Per-item reingestion counts (keyed by base summary). */
+  reingestionTracker;
+  constructor(name, intake, queues, gates, strategy, verifyResults, retryTracker, reingestionTracker) {
     super(name);
     this.intake = intake;
     this.queues = queues;
     this.gates = gates;
     this.strategy = strategy;
     this.verifyResults = verifyResults;
+    this.retryTracker = retryTracker;
+    this.reingestionTracker = reingestionTracker;
   }
 };
 function harnessLoop(name, opts) {
@@ -6020,14 +6031,20 @@ function harnessLoop(name, opts) {
   }
   const intake = new TopicGraph("intake", { retainedLimit });
   const strategy = strategyModel();
+  const triageInput = withLatestFrom(
+    intake.latest,
+    strategy.node
+  );
   const triageNode = promptNode(
     adapter,
-    [intake.latest, strategy.node],
-    opts.triagePrompt ?? ((item, strat) => {
-      return DEFAULT_TRIAGE_PROMPT.replace("{{strategy}}", JSON.stringify(strat)).replace(
-        "{{item}}",
-        JSON.stringify(item)
-      );
+    [triageInput],
+    opts.triagePrompt ?? ((pair) => {
+      const [item, strat] = pair;
+      if (!item) return "";
+      return DEFAULT_TRIAGE_PROMPT.replace(
+        "{{strategy}}",
+        JSON.stringify(Array.from(strat.entries()))
+      ).replace("{{item}}", JSON.stringify(item));
     }),
     {
       name: "triage",
@@ -6039,12 +6056,14 @@ function harnessLoop(name, opts) {
   for (const route of QUEUE_NAMES) {
     queueTopics.set(route, new TopicGraph(`queue/${route}`, { retainedLimit }));
   }
-  const _router = effect([triageNode], ([triaged]) => {
+  const router = effect([triageNode], ([triaged]) => {
     const item = triaged;
     if (!item || !item.route) return;
     const topic2 = queueTopics.get(item.route);
     if (topic2) topic2.publish(item);
   });
+  router.subscribe(() => {
+  });
   const gateGraph = new Graph("gates");
   const gateControllers = /* @__PURE__ */ new Map();
   for (const route of QUEUE_NAMES) {
@@ -6074,9 +6093,7 @@ function harnessLoop(name, opts) {
   const executeNode = promptNode(
     adapter,
     [executeInput],
-    opts.executePrompt ?? ((item) => {
-      return DEFAULT_EXECUTE_PROMPT.replace("{{item}}", JSON.stringify(item));
-    }),
+    opts.executePrompt ?? ((item) => DEFAULT_EXECUTE_PROMPT.replace("{{item}}", JSON.stringify(item))),
     {
       name: "execute",
       format: "json",
@@ -6087,66 +6104,87 @@ function harnessLoop(name, opts) {
   const verifyNode = promptNode(
     adapter,
     [executeNode, executeInput],
-    opts.verifyPrompt ?? ((execution, item) => {
-      return DEFAULT_VERIFY_PROMPT.replace("{{execution}}", JSON.stringify(execution)).replace(
-        "{{item}}",
-        JSON.stringify(item)
-      );
-    }),
+    opts.verifyPrompt ?? ((execution, item) => DEFAULT_VERIFY_PROMPT.replace("{{execution}}", JSON.stringify(execution)).replace(
+      "{{item}}",
+      JSON.stringify(item)
+    )),
     {
       name: "verify",
       format: "json",
       retries: 1
     }
   );
+  const verifyWithExec = withLatestFrom(verifyNode, executeNode);
+  const verifyContext = withLatestFrom(
+    verifyWithExec,
+    executeInput
+  );
   const maxReingestions = opts.maxReingestions ?? 1;
-  let reingestionCount = 0;
-  const _fastRetry = effect([verifyNode], ([result]) => {
-    const vr = result;
-    if (!vr) return;
+  const retryTracker = /* @__PURE__ */ new Map();
+  const reingestionTracker = /* @__PURE__ */ new Map();
+  const fastRetry = effect([verifyContext], ([ctx]) => {
+    const [[vo, execRaw], item] = ctx;
+    if (!vo || !item) return;
+    const exec = {
+      item,
+      outcome: execRaw?.outcome ?? "failure",
+      detail: execRaw?.detail ?? "unknown"
+    };
+    const vr = {
+      item,
+      execution: exec,
+      verified: vo.verified,
+      findings: vo.findings ?? [],
+      errorClass: vo.errorClass
+    };
     if (vr.verified) {
-      strategy.record(vr.item.rootCause, vr.item.intervention, true);
+      strategy.record(item.rootCause, item.intervention, true);
       verifyResults.publish(vr);
       return;
     }
     const errClass = vr.errorClass ?? errorClassifier({
-      item: vr.item,
+      item,
       outcome: "failure",
-      detail: vr.findings.join("; "),
-      retryCount: 0
+      detail: vr.findings.join("; ")
     });
-    const exec = vr.execution;
-    const retryCount = exec?.retryCount ?? 0;
+    const key = baseSummary(item.summary);
+    const retryCount = retryTracker.get(key) ?? 0;
     if (errClass === "self-correctable" && retryCount < maxRetries) {
+      retryTracker.set(key, retryCount + 1);
       const retryItem = {
-        ...vr.item,
-        summary: `[RETRY ${retryCount + 1}/${maxRetries}] ${vr.item.summary} \u2014 Previous attempt failed: ${vr.findings.join("; ")}`
+        ...item,
+        summary: `[RETRY ${retryCount + 1}/${maxRetries}] ${baseSummary(item.summary)} \u2014 Previous attempt failed: ${vr.findings.join("; ")}`
       };
       retryTopic.publish(retryItem);
     } else {
-      strategy.record(vr.item.rootCause, vr.item.intervention, false);
+      strategy.record(item.rootCause, item.intervention, false);
       verifyResults.publish(vr);
-      if (reingestionCount < maxReingestions) {
-        reingestionCount++;
+      const itemReingestions = reingestionTracker.get(key) ?? 0;
+      if (itemReingestions < maxReingestions) {
+        reingestionTracker.set(key, itemReingestions + 1);
         intake.publish({
           source: "eval",
-          summary: `Verification failed for: ${vr.item.summary}`,
+          summary: `Verification failed for: ${baseSummary(item.summary)}`,
           evidence: vr.findings.join("\n"),
-          affectsAreas: vr.item.affectsAreas,
-          affectsEvalTasks: vr.item.affectsEvalTasks,
+          affectsAreas: item.affectsAreas,
+          affectsEvalTasks: item.affectsEvalTasks,
           severity: "high",
-          relatedTo: [vr.item.summary]
+          relatedTo: [baseSummary(item.summary)]
         });
       }
     }
   });
+  fastRetry.subscribe(() => {
+  });
   const harness = new HarnessGraph(
     name,
     intake,
     queueTopics,
     gateControllers,
     strategy,
-    verifyResults
+    verifyResults,
+    retryTracker,
+    reingestionTracker
   );
   harness.mount("intake", intake);
   for (const [route, topic2] of queueTopics) {