@graphrefly/graphrefly 0.19.0 → 0.21.0

package/README.md

@@ -1,13 +1,13 @@
 # GraphReFly
 
-**Describe what matters. It watches, filters, and explains — persistently.**
+**The reactive harness layer for agent workflows.** Describe in plain language, review visually, run persistently, trace every decision.
 
-You're buried under emails, alerts, feeds, and messages. You can't process it all. GraphReFly lets you describe automations in plain language, review them visually, run them persistently, and trace every decision back to its source.
+GraphReFly makes long-running human + LLM co-operation reactive, resumable, and causally explainable. State pushes downstream on change (no re-reading), nodes have lifecycles (not infinite append), and every decision has a traceable causal chain — the substrate underneath tools, agents, and personal automations.
 
 [![npm](https://img.shields.io/npm/v/@graphrefly/graphrefly?color=blue)](https://www.npmjs.com/package/@graphrefly/graphrefly)
 [![license](https://img.shields.io/github/license/graphrefly/graphrefly-ts)](./LICENSE)
 
-[Docs](https://graphrefly.dev) | [Spec](https://graphrefly.dev/spec/) | [Python API](https://graphrefly.dev/py/api/) | [API Reference](https://graphrefly.dev/api/node/)
+[Docs](https://graphrefly.dev) | [Spec](https://graphrefly.dev/spec/) | [Python API](https://graphrefly.dev/py/api/) | [TS API Reference](https://graphrefly.dev/api/node/)
 
 ---
 
@@ -46,6 +46,23 @@ count.set(3);
 
 You describe what you need — an LLM composes a reactive graph (like SQL for data flows). The graph runs persistently, checkpoints its state, and traces every decision through a causal chain. Ask "why?" at any point and get a human-readable explanation from source to conclusion.
 
+## Harness engineering coverage
+
+The eight requirements of a production agent harness cluster into a handful of composed blocks that sit on top of the reactive graph primitives:
+
+| Need | GraphReFly |
+|---|---|
+| Context & state | `persistentState()` — `autoCheckpoint` + `snapshot` / `restore` + incremental diff |
+| Agent memory | `agentMemory()` — `distill` + vectors + knowledge graph + tiers, OpenViking decay |
+| Control flow & resilience | `resilientPipeline()` — `rateLimiter → breaker → retry → timeout → fallback`, correct ordering built in |
+| Execution & policy | `guardedExecution()` — Actor / Guard ABAC + `policy()` + `budgetGate` + scoped describe |
+| Observability & causality | `graphLens()` — reactive topology, health, flow, and `why(node)` causal chains as structured data |
+| Human governance | `gate` — reactive `pending` / `isOpen` with `approve` / `reject` / `modify(fn, n)` |
+| Verification | Multi-model eval harness with regression gates |
+| Continuous improvement | Strategy model: `rootCause × intervention → successRate` |
+
+The library computes structured facts reactively; LLMs and UIs render them. Natural language is never the library's job — which keeps the whole stack model-agnostic and testable.
+
 ## Why GraphReFly?
 
 |  | Zustand / Jotai | RxJS | XState | LangGraph | TC39 Signals | **GraphReFly** |

package/dist/{chunk-JC2SN46B.js → chunk-2UDLYZHT.js}

@@ -1,7 +1,7 @@
 import {
   describeNode,
   resolveDescribeFields
-} from "./chunk-XUOY3YKN.js";
+} from "./chunk-7IGHIFTT.js";
 import {
   COMPLETE,
   DATA,
@@ -16,7 +16,7 @@ import {
   messageTier,
   monotonicNs,
   state
-} from "./chunk-YXR3WW3Q.js";
+} from "./chunk-4MQ2J6IG.js";
 
 // src/graph/sizeof.ts
 var OVERHEAD = {
@@ -2114,4 +2114,4 @@ export {
   Graph,
   reachable
 };
-//# sourceMappingURL=chunk-JC2SN46B.js.map
+//# sourceMappingURL=chunk-2UDLYZHT.js.map

package/dist/{chunk-YXR3WW3Q.js → chunk-4MQ2J6IG.js}

@@ -1072,7 +1072,7 @@ var NodeImpl = class extends NodeBase {
         try {
           const consumed = this._onMessage(msg, index, this._actions);
           if (consumed) {
-            if (t === START) {
+            if (t === START || t === DATA || t === RESOLVED) {
               this._depDirtyMask.clear(index);
               if (this._depDirtyMask.any() && this._depSettledMask.covers(this._depDirtyMask)) {
                 this._depDirtyMask.reset();
@@ -1565,8 +1565,8 @@ function producer(fn, opts) {
 function derived(deps, fn, opts) {
   return node(deps, fn, { describeKind: "derived", ...opts });
 }
-function effect(deps, fn) {
-  return node(deps, fn, { describeKind: "effect" });
+function effect(deps, fn, opts) {
+  return node(deps, fn, { describeKind: "effect", ...opts });
 }
 function pipe(source, ...ops) {
   let current = source;
@@ -1628,4 +1628,4 @@ export {
   effect,
   pipe
 };
-//# sourceMappingURL=chunk-YXR3WW3Q.js.map
+//# sourceMappingURL=chunk-4MQ2J6IG.js.map