@graphrefly/graphrefly 0.16.0 → 0.18.0

package/dist/index.js

@@ -137,24 +137,26 @@ import {
   workerBridge,
   workerSelf,
   zip
-} from "./chunk-RLVFZDCE.js";
+} from "./chunk-76YPZQTW.js";
 import {
   cqrs_exports,
   nestjs_exports
-} from "./chunk-26A4E7J7.js";
+} from "./chunk-KJGUP35I.js";
 import {
   DEFAULT_DOWN,
   bridge,
   core_exports
-} from "./chunk-LKP7IWRV.js";
+} from "./chunk-TNKODJ6E.js";
 import {
   JsonCodec,
   createDagCborCodec,
   createDagCborZstdCodec,
+  graphProfile,
   graph_exports,
   negotiateCodec,
-  replayWAL
-} from "./chunk-SHRJH2DN.js";
+  replayWAL,
+  sizeof
+} from "./chunk-FCLROC4Q.js";
 import {
   cached,
   createWatermarkController,
@@ -175,8 +177,6 @@ import {
   matchesAnyPattern,
   matchesCron,
   never,
-  observeGraph$,
-  observeNode$,
   of,
   parseCron,
   reactiveLog,
@@ -185,9 +185,8 @@ import {
   shareReplay,
   throwError,
   toArray,
-  toMessages$,
   toObservable
-} from "./chunk-YX263TXI.js";
+} from "./chunk-F6ORUNO7.js";
 import {
   ResettableTimer
 } from "./chunk-WZ2Z2CRV.js";
@@ -195,17 +194,16 @@ import {
   analyzeAndMeasure,
   computeLineBreaks,
   reactive_layout_exports
-} from "./chunk-RZSQ7P2C.js";
+} from "./chunk-UVWEKTYC.js";
 import {
   GRAPH_META_SEGMENT,
   Graph,
   reachable
-} from "./chunk-3BLRREFM.js";
+} from "./chunk-LB3RYLSC.js";
 import {
   describeNode,
-  metaSnapshot,
   resolveDescribeFields
-} from "./chunk-ITDVOCFO.js";
+} from "./chunk-J7S54G7I.js";
 import {
   CLEANUP_RESULT,
   COMPLETE,
@@ -249,7 +247,7 @@ import {
   propagatesToMeta,
   state,
   wallClockNs
-} from "./chunk-VZY2B2LU.js";
+} from "./chunk-BV3TPSBK.js";
 
 // src/compat/index.ts
 var compat_exports = {};
@@ -1489,36 +1487,33 @@ function firstDataFromNode(resolved, opts) {
   }
   const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
   return new Promise((resolve, reject) => {
-    let timer;
-    const cleanup = () => {
-      if (timer !== void 0) clearTimeout(timer);
-    };
+    const timer = new ResettableTimer();
     const unsub = resolved.subscribe((messages) => {
       for (const msg of messages) {
         if (msg[0] === DATA) {
-          cleanup();
+          timer.cancel();
           unsub();
           resolve(msg[1]);
           return;
         }
         if (msg[0] === ERROR) {
-          cleanup();
+          timer.cancel();
           unsub();
           reject(msg[1]);
           return;
         }
         if (msg[0] === COMPLETE) {
-          cleanup();
+          timer.cancel();
           unsub();
           reject(new Error("firstDataFromNode: completed without producing a value"));
           return;
         }
       }
     });
-    timer = setTimeout(() => {
+    timer.start(timeoutMs, () => {
       unsub();
       reject(new Error(`firstDataFromNode: timed out after ${timeoutMs}ms`));
-    }, timeoutMs);
+    });
   });
 }
 async function resolveToolHandlerResult(value) {
@@ -2938,7 +2933,7 @@ function demoShell(opts) {
     ([ref, _tick]) => {
       const demo = ref;
       if (!demo) return [];
-      return demo.traceLog();
+      return demo.trace();
     },
     { name: "inspect/trace-log" }
   );
@@ -4884,9 +4879,12 @@ __export(harness_exports, {
   DEFAULT_QUEUE_CONFIGS: () => DEFAULT_QUEUE_CONFIGS,
   DEFAULT_SEVERITY_WEIGHTS: () => DEFAULT_SEVERITY_WEIGHTS,
   HarnessGraph: () => HarnessGraph,
+  QUEUE_NAMES: () => QUEUE_NAMES,
   defaultErrorClassifier: () => defaultErrorClassifier,
   evalIntakeBridge: () => evalIntakeBridge,
   harnessLoop: () => harnessLoop,
+  harnessProfile: () => harnessProfile,
+  harnessTrace: () => harnessTrace,
   priorityScore: () => priorityScore,
   strategyKey: () => strategyKey,
   strategyModel: () => strategyModel
@@ -5787,6 +5785,12 @@ function onFailure(graph, name, source, recover, opts) {
 }
 
 // src/patterns/harness/types.ts
+var QUEUE_NAMES = [
+  "auto-fix",
+  "needs-decision",
+  "investigation",
+  "backlog"
+];
 function strategyKey(rootCause, intervention) {
   return `${rootCause}\u2192${intervention}`;
 }
@@ -5887,8 +5891,8 @@ function priorityScore(item, strategy, lastInteractionNs, urgency, signals) {
 }
 
 // src/patterns/harness/loop.ts
-function baseSummary(summary) {
-  return summary.replace(/^\[RETRY \d+\/\d+\]\s*/, "");
+function trackingKey(item) {
+  return item.relatedTo?.[0] ?? item.summary;
 }
 var DEFAULT_TRIAGE_PROMPT = `You are a triage classifier for a reactive collaboration harness.
 
@@ -5934,12 +5938,6 @@ Output JSON:
   "findings": ["<finding1>", ...],
   "errorClass": "self-correctable" | "structural"  // only if verified=false
 }`;
-var QUEUE_NAMES = [
-  "auto-fix",
-  "needs-decision",
-  "investigation",
-  "backlog"
-];
 var HarnessGraph = class extends Graph {
   /** Intake topic — publish items here to enter the loop. */
   intake;
@@ -5951,19 +5949,19 @@ var HarnessGraph = class extends Graph {
   strategy;
   /** Verify results topic — subscribe to see verification outcomes. */
   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) {
+  /** Global retry count across all items (circuit breaker). Reactive — subscribable. */
+  totalRetries;
+  /** Global reingestion count across all items (circuit breaker). Reactive — subscribable. */
+  totalReingestions;
+  constructor(name, intake, queues, gates, strategy, verifyResults, totalRetries, totalReingestions) {
     super(name);
     this.intake = intake;
     this.queues = queues;
     this.gates = gates;
     this.strategy = strategy;
     this.verifyResults = verifyResults;
-    this.retryTracker = retryTracker;
-    this.reingestionTracker = reingestionTracker;
+    this.totalRetries = totalRetries;
+    this.totalReingestions = totalReingestions;
   }
 };
 function harnessLoop(name, opts) {
@@ -6005,11 +6003,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 item = triaged;
-    if (!item || !item.route) return;
-    const topic2 = queueTopics.get(item.route);
-    if (topic2) topic2.publish(item);
+  const routerInput = withLatestFrom(triageNode, triageInput);
+  const router = effect([routerInput], ([pair]) => {
+    const [classification, triagePair] = pair;
+    if (!classification || !classification.route) return;
+    const intakeItem = triagePair?.[0];
+    const merged = { ...intakeItem, ...classification };
+    const topic2 = queueTopics.get(merged.route);
+    if (topic2) topic2.publish(merged);
   });
   const routerUnsub = router.subscribe(() => {
   });
@@ -6069,8 +6070,10 @@ function harnessLoop(name, opts) {
     executeInput
   );
   const maxReingestions = opts.maxReingestions ?? 1;
-  const retryTracker = /* @__PURE__ */ new Map();
-  const reingestionTracker = /* @__PURE__ */ new Map();
+  const maxTotalRetries = Math.min(opts.maxTotalRetries ?? maxRetries * 10, 100);
+  const maxTotalReingestions = Math.min(opts.maxTotalReingestions ?? maxReingestions * 10, 100);
+  const totalRetries = state(0);
+  const totalReingestions = state(0);
   const fastRetry = effect([verifyContext], ([ctx]) => {
     const [[vo, execRaw], item] = ctx;
     if (!vo || !item) return;
@@ -6096,29 +6099,33 @@ function harnessLoop(name, opts) {
       outcome: "failure",
       detail: vr.findings.join("; ")
     });
-    const key = baseSummary(item.summary);
-    const retryCount = retryTracker.get(key) ?? 0;
-    if (errClass === "self-correctable" && retryCount < maxRetries) {
-      retryTracker.set(key, retryCount + 1);
+    const itemRetries = item._retries ?? 0;
+    if (errClass === "self-correctable" && itemRetries < maxRetries && (totalRetries.get() ?? 0) < maxTotalRetries) {
+      totalRetries.down([[DIRTY], [DATA, (totalRetries.get() ?? 0) + 1]]);
+      const key = trackingKey(item);
       const retryItem = {
         ...item,
-        summary: `[RETRY ${retryCount + 1}/${maxRetries}] ${baseSummary(item.summary)} \u2014 Previous attempt failed: ${vr.findings.join("; ")}`
+        _retries: itemRetries + 1,
+        summary: `[RETRY ${itemRetries + 1}/${maxRetries}] ${key} \u2014 Previous attempt failed: ${vr.findings.join("; ")}`,
+        relatedTo: [key]
       };
       retryTopic.publish(retryItem);
     } else {
       strategy.record(item.rootCause, item.intervention, false);
       verifyResults.publish(vr);
-      const itemReingestions = reingestionTracker.get(key) ?? 0;
-      if (itemReingestions < maxReingestions) {
-        reingestionTracker.set(key, itemReingestions + 1);
+      const key = trackingKey(item);
+      const itemReingestions = item._reingestions ?? 0;
+      if (itemReingestions < maxReingestions && (totalReingestions.get() ?? 0) < maxTotalReingestions) {
+        totalReingestions.down([[DIRTY], [DATA, (totalReingestions.get() ?? 0) + 1]]);
         intake.publish({
           source: "eval",
-          summary: `Verification failed for: ${baseSummary(item.summary)}`,
+          summary: `Verification failed for: ${key}`,
           evidence: vr.findings.join("\n"),
           affectsAreas: item.affectsAreas,
           affectsEvalTasks: item.affectsEvalTasks,
           severity: "high",
-          relatedTo: [baseSummary(item.summary)]
+          relatedTo: [key],
+          _reingestions: itemReingestions + 1
         });
       }
     }
@@ -6132,12 +6139,16 @@ function harnessLoop(name, opts) {
     gateControllers,
     strategy,
     verifyResults,
-    retryTracker,
-    reingestionTracker
+    totalRetries,
+    totalReingestions
   );
   harness.addDisposer(routerUnsub);
   harness.addDisposer(fastRetryUnsub);
   harness.addDisposer(strategy.dispose);
+  harness.add("triage", triageNode);
+  harness.add("execute", executeNode);
+  harness.add("verify", verifyNode);
+  harness.add("strategy", strategy.node);
   harness.mount("intake", intake);
   for (const [route, topic2] of queueTopics) {
     harness.mount(`queue/${route}`, topic2);
@@ -6148,6 +6159,105 @@ function harnessLoop(name, opts) {
   return harness;
 }
 
+// src/patterns/harness/profile.ts
+function harnessProfile(harness, opts) {
+  const base = graphProfile(harness, opts);
+  const queueDepths = {};
+  for (const [route, topic2] of harness.queues) {
+    queueDepths[route] = topic2.retained().length;
+  }
+  return {
+    ...base,
+    queueDepths,
+    strategyEntries: harness.strategy.node.get()?.size ?? 0,
+    totalRetries: harness.totalRetries.get() ?? 0,
+    totalReingestions: harness.totalReingestions.get() ?? 0
+  };
+}
+
+// src/patterns/harness/trace.ts
+var STAGE_LABELS = {
+  "intake::latest": "INTAKE",
+  triage: "TRIAGE",
+  execute: "EXECUTE",
+  "verify-results::latest": "VERIFY",
+  strategy: "STRATEGY"
+};
+for (const route of QUEUE_NAMES) {
+  STAGE_LABELS[`queue/${route}::latest`] = "QUEUE";
+}
+function harnessTrace(harness, opts) {
+  const logger = opts?.logger ?? console.log;
+  const startNs = monotonicNs();
+  const observations = [];
+  function elapsed() {
+    const deltaNs = monotonicNs() - startNs;
+    const secs = deltaNs / 1e9;
+    return secs.toFixed(3);
+  }
+  for (const [path, stage] of Object.entries(STAGE_LABELS)) {
+    try {
+      const obs = harness.observe(path, {
+        format: "json",
+        logger: (_line, event) => {
+          if (event.type === "data") {
+            const dataStr = event.data !== void 0 ? ` ${summarize(event.data)}` : "";
+            logger(`[${elapsed()}s] ${stage.padEnd(9)} \u2190${dataStr}`);
+          } else if (event.type === "error") {
+            const errStr = event.data !== void 0 ? ` ${summarize(event.data)}` : "";
+            logger(`[${elapsed()}s] ${stage.padEnd(9)} \u2717${errStr}`);
+          } else if (event.type === "complete") {
+            logger(`[${elapsed()}s] ${stage.padEnd(9)} \u25A0 complete`);
+          }
+        },
+        includeTypes: ["data", "error", "complete"]
+      });
+      observations.push(obs);
+    } catch {
+    }
+  }
+  for (const [gatedRoute] of harness.gates) {
+    const gatePath = `gates::${gatedRoute}/gate`;
+    try {
+      const obs = harness.observe(gatePath, {
+        format: "json",
+        logger: (_line, event) => {
+          if (event.type === "data") {
+            const dataStr = event.data !== void 0 ? ` ${summarize(event.data)}` : "";
+            logger(`[${elapsed()}s] GATE      \u25B6${dataStr}`);
+          } else if (event.type === "error") {
+            logger(`[${elapsed()}s] GATE      \u2717 ${summarize(event.data)}`);
+          }
+        },
+        includeTypes: ["data", "error", "complete"]
+      });
+      observations.push(obs);
+    } catch {
+    }
+  }
+  return {
+    dispose() {
+      for (const obs of observations) obs.dispose();
+      observations.length = 0;
+    }
+  };
+}
+function summarize(value) {
+  if (value == null) return "null";
+  if (typeof value === "string") return truncate(value, 80);
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (typeof value === "bigint") return String(value);
+  try {
+    const json = JSON.stringify(value);
+    return truncate(json, 120);
+  } catch {
+    return String(value);
+  }
+}
+function truncate(s, max) {
+  return s.length > max ? `${s.slice(0, max - 1)}\u2026` : s;
+}
+
 // src/index.ts
 var version = "0.0.0";
 export {
@@ -6215,7 +6325,6 @@ export {
   delay,
   demo_shell_exports as demoShell,
   derived,
-  describeNode,
   deserializeError,
   distill,
   distinctUntilChanged,
@@ -6270,6 +6379,7 @@ export {
   fromWebhook,
   globToRegExp,
   graph_exports as graph,
+  graphProfile,
   graphspec_exports as graphspec,
   harness_exports as harness,
   interval,
@@ -6293,7 +6403,6 @@ export {
   mergeMap,
   messageTier,
   messaging_exports as messaging,
-  metaSnapshot,
   monotonicNs,
   nameToSignal,
   nanostores_exports as nanostores,
@@ -6302,8 +6411,6 @@ export {
   never,
   node,
   normalizeActor,
-  observeGraph$,
-  observeNode$,
   of,
   orchestration_exports as orchestration,
   pairwise,
@@ -6348,6 +6455,7 @@ export {
   shareReplay,
   signalToName,
   signals_exports as signals,
+  sizeof,
   skip,
   solid_exports as solid,
   startWith,
@@ -6369,7 +6477,6 @@ export {
   toFile,
   toKafka,
   toLoki,
-  toMessages$,
   toMongo,
   toNATS,
   toObservable,