@graphrefly/graphrefly 0.5.0 → 0.7.0

package/dist/{meta-BsF6Sag9.d.cts → meta-BJEU8fYz.d.cts}

@@ -544,9 +544,9 @@ declare function node<T = unknown>(depsOrFn?: readonly Node[] | NodeFn<T> | Node
 /** JSON-shaped slice of a node for Phase 1 `Graph.describe()` (GRAPHREFLY-SPEC §3.6, Appendix B). */
 type DescribeNodeOutput = {
     type: "state" | "derived" | "producer" | "operator" | "effect";
-    status: Node["status"];
+    status?: Node["status"];
     deps: string[];
-    meta: Record<string, unknown>;
+    meta?: Record<string, unknown>;
     name?: string;
     value?: unknown;
     /** Node versioning info (GRAPHREFLY-SPEC §7). Present only when versioning is enabled. */
@@ -556,7 +556,28 @@ type DescribeNodeOutput = {
         cid?: string;
         prev?: string | null;
     };
+    /** Guard info (full detail). */
+    guard?: string;
+    /** Last mutation attribution (full detail). */
+    lastMutation?: Readonly<{
+        actor: Actor;
+        timestamp_ns: number;
+    }>;
 };
+/**
+ * Detail level for `describe()` progressive disclosure (Phase 3.3b).
+ * - `"minimal"` — type + deps only (default). LLM-friendly.
+ * - `"standard"` — type, status, value, deps, meta, versioning (`v`).
+ * - `"full"` — standard + guard, lastMutation.
+ */
+type DescribeDetail = "minimal" | "standard" | "full";
+/**
+ * Valid field names for `describe({ fields: [...] })` (Phase 3.3b).
+ * Dotted paths like `"meta.label"` select specific meta keys.
+ */
+type DescribeField = "type" | "status" | "value" | "deps" | "meta" | "v" | "guard" | "lastMutation" | `meta.${string}`;
+/** Resolve which fields to include based on detail level or explicit field list. */
+declare function resolveDescribeFields(detail?: DescribeDetail, fields?: readonly DescribeField[]): Set<string> | null;
 /**
  * Reads the current cached value of every companion meta field on a node,
  * suitable for merging into `describe()`-style JSON (GRAPHREFLY-SPEC §2.3, §3.6).
@@ -602,6 +623,12 @@ declare function metaSnapshot(node: Node): Record<string, unknown>;
  * describeNode(state(0));
  * ```
  */
-declare function describeNode(node: Node): DescribeNodeOutput;
+/**
+ * Builds a single-node slice for `Graph.describe()`.
+ *
+ * @param node - Node to introspect.
+ * @param includeFields - Set of fields to include, or `null` for all. When omitted, all fields are included (legacy behavior).
+ */
+declare function describeNode(node: Node, includeFields?: Set<string> | null): DescribeNodeOutput;
 
-export { propagatesToMeta as $, type Actor as A, describeNode as B, COMPLETE as C, DATA as D, ERROR as E, isKnownMessageType as F, type GuardAction as G, type HashFn as H, INVALIDATE as I, isPhase2Message as J, isTerminalMessage as K, isV1 as L, type Message as M, type Node as N, type OnMessageHandler as O, PAUSE as P, knownMessageTypes as Q, RESOLVED as R, type SubscribeHints as S, TEARDOWN as T, messageTier as U, type V0 as V, metaSnapshot as W, node as X, normalizeActor as Y, policy as Z, policyFromRules as _, type NodeOptions as a, type NodeInspectorHook as a0, type NodeActions as b, type NodeFn as c, DEFAULT_ACTOR as d, DIRTY as e, type DescribeNodeOutput as f, GuardDenied as g, type GuardDeniedDetails as h, type Messages as i, type NodeDescribeKind as j, type NodeGuard as k, type NodeSink as l, type NodeStatus as m, type NodeTransportOptions as n, type NodeVersionInfo as o, type PolicyAllow as p, type PolicyDeny as q, type PolicyRuleData as r, RESUME as s, type V1 as t, type VersioningLevel as u, type VersioningOptions as v, accessHintForGuard as w, advanceVersion as x, createVersioning as y, defaultHash as z };
+export { policy as $, type Actor as A, createVersioning as B, COMPLETE as C, DATA as D, ERROR as E, defaultHash as F, type GuardAction as G, type HashFn as H, INVALIDATE as I, describeNode as J, isKnownMessageType as K, isPhase2Message as L, type Message as M, type Node as N, type OnMessageHandler as O, PAUSE as P, isTerminalMessage as Q, RESOLVED as R, type SubscribeHints as S, TEARDOWN as T, isV1 as U, type V0 as V, knownMessageTypes as W, messageTier as X, metaSnapshot as Y, node as Z, normalizeActor as _, type NodeOptions as a, policyFromRules as a0, propagatesToMeta as a1, resolveDescribeFields as a2, type NodeInspectorHook as a3, type NodeActions as b, type NodeFn as c, DEFAULT_ACTOR as d, DIRTY as e, type DescribeDetail as f, type DescribeField as g, type DescribeNodeOutput as h, GuardDenied as i, type GuardDeniedDetails as j, type Messages as k, type NodeDescribeKind as l, type NodeGuard as m, type NodeSink as n, type NodeStatus as o, type NodeTransportOptions as p, type NodeVersionInfo as q, type PolicyAllow as r, type PolicyDeny as s, type PolicyRuleData as t, RESUME as u, type V1 as v, type VersioningLevel as w, type VersioningOptions as x, accessHintForGuard as y, advanceVersion as z };

package/dist/{meta-BsF6Sag9.d.ts → meta-BJEU8fYz.d.ts}

@@ -544,9 +544,9 @@ declare function node<T = unknown>(depsOrFn?: readonly Node[] | NodeFn<T> | Node
 /** JSON-shaped slice of a node for Phase 1 `Graph.describe()` (GRAPHREFLY-SPEC §3.6, Appendix B). */
 type DescribeNodeOutput = {
     type: "state" | "derived" | "producer" | "operator" | "effect";
-    status: Node["status"];
+    status?: Node["status"];
     deps: string[];
-    meta: Record<string, unknown>;
+    meta?: Record<string, unknown>;
     name?: string;
     value?: unknown;
     /** Node versioning info (GRAPHREFLY-SPEC §7). Present only when versioning is enabled. */
@@ -556,7 +556,28 @@ type DescribeNodeOutput = {
         cid?: string;
         prev?: string | null;
     };
+    /** Guard info (full detail). */
+    guard?: string;
+    /** Last mutation attribution (full detail). */
+    lastMutation?: Readonly<{
+        actor: Actor;
+        timestamp_ns: number;
+    }>;
 };
+/**
+ * Detail level for `describe()` progressive disclosure (Phase 3.3b).
+ * - `"minimal"` — type + deps only (default). LLM-friendly.
+ * - `"standard"` — type, status, value, deps, meta, versioning (`v`).
+ * - `"full"` — standard + guard, lastMutation.
+ */
+type DescribeDetail = "minimal" | "standard" | "full";
+/**
+ * Valid field names for `describe({ fields: [...] })` (Phase 3.3b).
+ * Dotted paths like `"meta.label"` select specific meta keys.
+ */
+type DescribeField = "type" | "status" | "value" | "deps" | "meta" | "v" | "guard" | "lastMutation" | `meta.${string}`;
+/** Resolve which fields to include based on detail level or explicit field list. */
+declare function resolveDescribeFields(detail?: DescribeDetail, fields?: readonly DescribeField[]): Set<string> | null;
 /**
  * Reads the current cached value of every companion meta field on a node,
  * suitable for merging into `describe()`-style JSON (GRAPHREFLY-SPEC §2.3, §3.6).
@@ -602,6 +623,12 @@ declare function metaSnapshot(node: Node): Record<string, unknown>;
  * describeNode(state(0));
  * ```
  */
-declare function describeNode(node: Node): DescribeNodeOutput;
+/**
+ * Builds a single-node slice for `Graph.describe()`.
+ *
+ * @param node - Node to introspect.
+ * @param includeFields - Set of fields to include, or `null` for all. When omitted, all fields are included (legacy behavior).
+ */
+declare function describeNode(node: Node, includeFields?: Set<string> | null): DescribeNodeOutput;
 
-export { propagatesToMeta as $, type Actor as A, describeNode as B, COMPLETE as C, DATA as D, ERROR as E, isKnownMessageType as F, type GuardAction as G, type HashFn as H, INVALIDATE as I, isPhase2Message as J, isTerminalMessage as K, isV1 as L, type Message as M, type Node as N, type OnMessageHandler as O, PAUSE as P, knownMessageTypes as Q, RESOLVED as R, type SubscribeHints as S, TEARDOWN as T, messageTier as U, type V0 as V, metaSnapshot as W, node as X, normalizeActor as Y, policy as Z, policyFromRules as _, type NodeOptions as a, type NodeInspectorHook as a0, type NodeActions as b, type NodeFn as c, DEFAULT_ACTOR as d, DIRTY as e, type DescribeNodeOutput as f, GuardDenied as g, type GuardDeniedDetails as h, type Messages as i, type NodeDescribeKind as j, type NodeGuard as k, type NodeSink as l, type NodeStatus as m, type NodeTransportOptions as n, type NodeVersionInfo as o, type PolicyAllow as p, type PolicyDeny as q, type PolicyRuleData as r, RESUME as s, type V1 as t, type VersioningLevel as u, type VersioningOptions as v, accessHintForGuard as w, advanceVersion as x, createVersioning as y, defaultHash as z };
+export { policy as $, type Actor as A, createVersioning as B, COMPLETE as C, DATA as D, ERROR as E, defaultHash as F, type GuardAction as G, type HashFn as H, INVALIDATE as I, describeNode as J, isKnownMessageType as K, isPhase2Message as L, type Message as M, type Node as N, type OnMessageHandler as O, PAUSE as P, isTerminalMessage as Q, RESOLVED as R, type SubscribeHints as S, TEARDOWN as T, isV1 as U, type V0 as V, knownMessageTypes as W, messageTier as X, metaSnapshot as Y, node as Z, normalizeActor as _, type NodeOptions as a, policyFromRules as a0, propagatesToMeta as a1, resolveDescribeFields as a2, type NodeInspectorHook as a3, type NodeActions as b, type NodeFn as c, DEFAULT_ACTOR as d, DIRTY as e, type DescribeDetail as f, type DescribeField as g, type DescribeNodeOutput as h, GuardDenied as i, type GuardDeniedDetails as j, type Messages as k, type NodeDescribeKind as l, type NodeGuard as m, type NodeSink as n, type NodeStatus as o, type NodeTransportOptions as p, type NodeVersionInfo as q, type PolicyAllow as r, type PolicyDeny as s, type PolicyRuleData as t, RESUME as u, type V1 as v, type VersioningLevel as w, type VersioningOptions as x, accessHintForGuard as y, advanceVersion as z };

package/dist/patterns/reactive-layout/index.cjs

@@ -368,10 +368,14 @@ function partitionForBatch(messages) {
   }
   return { immediate, deferred, terminal };
 }
-function emitWithBatch(emit, messages, phase = 2) {
+function emitWithBatch(emit, messages, phase = 2, options) {
   if (messages.length === 0) {
     return;
   }
+  if (options?.strategy === "sequential") {
+    _emitSequential(emit, messages, phase);
+    return;
+  }
   const queue = phase === 3 ? pendingPhase3 : pendingPhase2;
   if (messages.length === 1) {
     const t = messages[0][0];
@@ -412,6 +416,29 @@ function emitWithBatch(emit, messages, phase = 2) {
     }
   }
 }
+function _emitSequential(emit, messages, phase = 2) {
+  const dataQueue = phase === 3 ? pendingPhase3 : pendingPhase2;
+  for (const msg of messages) {
+    const tier = messageTier(msg[0]);
+    if (tier === 2) {
+      if (isBatching()) {
+        const m = msg;
+        dataQueue.push(() => emit([m]));
+      } else {
+        emit([msg]);
+      }
+    } else if (tier >= 3) {
+      if (isBatching()) {
+        const m = msg;
+        pendingPhase3.push(() => emit([m]));
+      } else {
+        emit([msg]);
+      }
+    } else {
+      emit([msg]);
+    }
+  }
+}
 
 // src/core/clock.ts
 function monotonicNs() {
@@ -620,6 +647,7 @@ var NodeImpl = class {
   _producerStarted = false;
   _connecting = false;
   _manualEmitUsed = false;
+  _hasEmittedData = false;
   _sinkCount = 0;
   _singleDepSinkCount = 0;
   // --- Object/collection state ---
@@ -906,6 +934,7 @@ var NodeImpl = class {
         this._cleanup = void 0;
         cleanupFn?.();
         this._cached = void 0;
+        this._hasEmittedData = false;
         this._lastDepValues = void 0;
       }
       this._status = statusAfterMessage(this._status, m);
@@ -915,6 +944,7 @@ var NodeImpl = class {
       if (t === TEARDOWN) {
         if (this._opts.resetOnTeardown) {
           this._cached = void 0;
+          this._hasEmittedData = false;
         }
         const teardownCleanup = this._cleanup;
         this._cleanup = void 0;
@@ -945,7 +975,16 @@ var NodeImpl = class {
   }
   _emitAutoValue(value) {
     const wasDirty = this._status === "dirty";
-    const unchanged = this._equals(this._cached, value);
+    let unchanged;
+    try {
+      unchanged = this._hasEmittedData && this._equals(this._cached, value);
+    } catch (eqErr) {
+      const eqMsg = eqErr instanceof Error ? eqErr.message : String(eqErr);
+      const wrapped = new Error(`Node "${this.name}": equals threw: ${eqMsg}`, { cause: eqErr });
+      this._downInternal([[ERROR, wrapped]]);
+      return;
+    }
+    this._hasEmittedData = true;
     if (unchanged) {
       this._downInternal(wasDirty ? [[RESOLVED]] : [[DIRTY], [RESOLVED]]);
       return;
@@ -992,7 +1031,9 @@ var NodeImpl = class {
       if (out === void 0) return;
       this._emitAutoValue(out);
     } catch (err) {
-      this._downInternal([[ERROR, err]]);
+      const errMsg = err instanceof Error ? err.message : String(err);
+      const wrapped = new Error(`Node "${this.name}": fn threw: ${errMsg}`, { cause: err });
+      this._downInternal([[ERROR, wrapped]]);
     }
   }
   _onDepDirty(index) {
@@ -1027,7 +1068,11 @@ var NodeImpl = class {
         try {
           if (this._onMessage(msg, index, this._actions)) continue;
         } catch (err) {
-          this._downInternal([[ERROR, err]]);
+          const errMsg = err instanceof Error ? err.message : String(err);
+          const wrapped = new Error(`Node "${this.name}": onMessage threw: ${errMsg}`, {
+            cause: err
+          });
+          this._downInternal([[ERROR, wrapped]]);
           return;
         }
       }
@@ -1600,6 +1645,19 @@ var DynamicNodeImpl = class {
 };
 
 // src/core/meta.ts
+function resolveDescribeFields(detail, fields) {
+  if (fields != null && fields.length > 0) return new Set(fields);
+  switch (detail) {
+    case "standard":
+      return /* @__PURE__ */ new Set(["type", "status", "value", "deps", "meta", "v"]);
+    case "full":
+      return null;
+    // null = include everything
+    case "minimal":
+    default:
+      return /* @__PURE__ */ new Set(["type", "deps"]);
+  }
+}
 function inferDescribeType(n) {
   if (n._describeKind != null) return n._describeKind;
   if (!n._hasDeps) return n._fn != null ? "producer" : "state";
@@ -1617,12 +1675,10 @@ function metaSnapshot(node2) {
   }
   return out;
 }
-function describeNode(node2) {
-  const meta = { ...metaSnapshot(node2) };
-  const guard = node2 instanceof NodeImpl && node2._guard || node2 instanceof DynamicNodeImpl && node2._guard || void 0;
-  if (guard != null && meta.access === void 0) {
-    meta.access = accessHintForGuard(guard);
-  }
+function describeNode(node2, includeFields) {
+  const all = includeFields == null;
+  const metaKeys = !all && includeFields != null ? [...includeFields].filter((f) => f.startsWith("meta.")).map((f) => f.slice(5)) : null;
+  const wantsMeta = all || includeFields.has("meta") || metaKeys != null && metaKeys.length > 0;
   let type = "state";
   let deps = [];
   if (node2 instanceof NodeImpl) {
@@ -1632,20 +1688,36 @@ function describeNode(node2) {
     type = node2._describeKind ?? "derived";
     deps = [];
   }
-  const out = {
-    type,
-    status: node2.status,
-    deps,
-    meta
-  };
+  const out = { type, deps };
+  if (all || includeFields.has("status")) {
+    out.status = node2.status;
+  }
+  const guard = node2 instanceof NodeImpl && node2._guard || node2 instanceof DynamicNodeImpl && node2._guard || void 0;
+  if (wantsMeta) {
+    const rawMeta = { ...metaSnapshot(node2) };
+    if (guard != null && rawMeta.access === void 0) {
+      rawMeta.access = accessHintForGuard(guard);
+    }
+    if (metaKeys != null && metaKeys.length > 0 && !includeFields.has("meta")) {
+      const filtered = {};
+      for (const k of metaKeys) {
+        if (k in rawMeta) filtered[k] = rawMeta[k];
+      }
+      out.meta = filtered;
+    } else {
+      out.meta = rawMeta;
+    }
+  }
   if (node2.name != null) {
     out.name = node2.name;
   }
-  try {
-    out.value = node2.get();
-  } catch {
+  if (all || includeFields.has("value")) {
+    try {
+      out.value = node2.get();
+    } catch {
+    }
   }
-  if (node2.v != null) {
+  if ((all || includeFields.has("v")) && node2.v != null) {
     const vInfo = { id: node2.v.id, version: node2.v.version };
     if ("cid" in node2.v) {
       vInfo.cid = node2.v.cid;
@@ -1653,6 +1725,16 @@ function describeNode(node2) {
     }
     out.v = vInfo;
   }
+  if (all || includeFields.has("guard")) {
+    if (guard != null) {
+      out.guard = accessHintForGuard(guard);
+    }
+  }
+  if (all || includeFields.has("lastMutation")) {
+    if (node2.lastMutation != null) {
+      out.lastMutation = node2.lastMutation;
+    }
+  }
   return out;
 }
 
@@ -1842,6 +1924,23 @@ function resolveSpyTheme(theme) {
     reset: theme.reset ?? ""
   };
 }
+function resolveObserveDetail(opts) {
+  if (opts == null) return {};
+  const detail = opts.detail;
+  if (detail === "full") {
+    return {
+      ...opts,
+      structured: opts.structured ?? true,
+      timeline: opts.timeline ?? true,
+      causal: opts.causal ?? true,
+      derived: opts.derived ?? true
+    };
+  }
+  if (detail === "minimal") {
+    return { ...opts, structured: opts.structured ?? true };
+  }
+  return opts;
+}
 function assertLocalName(name, graphName, label) {
   if (name === "") {
     throw new Error(`Graph "${graphName}": ${label} name must be non-empty`);
@@ -2039,6 +2138,22 @@ var Graph = class _Graph {
       if (this._defaultVersioningLevel != null) {
         node2._applyVersioning(this._defaultVersioningLevel);
       }
+      if (node2._deps.length > 0) {
+        for (const dep of node2._deps) {
+          for (const [depName, depNode] of this._nodes) {
+            if (depNode === dep) {
+              this._edges.add(edgeKey(depName, name));
+              break;
+            }
+          }
+        }
+      }
+      for (const [otherName, otherNode] of this._nodes) {
+        if (otherName === name) continue;
+        if (otherNode instanceof NodeImpl && otherNode._deps.includes(node2)) {
+          this._edges.add(edgeKey(name, otherName));
+        }
+      }
     }
   }
   /**
@@ -2425,6 +2540,9 @@ var Graph = class _Graph {
   describe(options) {
     const actor = options?.actor;
     const filter = options?.filter;
+    const includeFields = resolveDescribeFields(options?.detail, options?.fields);
+    const isSpec = options?.format === "spec";
+    const effectiveFields = isSpec ? resolveDescribeFields("minimal") : includeFields;
     const targets = [];
     this._collectObserveTargets("", targets);
     const nodeToPath = /* @__PURE__ */ new Map();
@@ -2434,7 +2552,7 @@ var Graph = class _Graph {
     const nodes = {};
     for (const [p, n] of targets) {
       if (actor != null && !n.allowsObserve(actor)) continue;
-      const raw = describeNode(n);
+      const raw = describeNode(n, effectiveFields);
       const deps = n instanceof NodeImpl ? n._deps.map((d) => nodeToPath.get(d) ?? d.name ?? "") : [];
       const { name: _name, ...rest } = raw;
       const entry = { ...rest, deps };
@@ -2455,7 +2573,7 @@ var Graph = class _Graph {
               continue;
             }
             if (normalizedKey === "metaHas") {
-              if (!Object.hasOwn(entry.meta, String(fv))) {
+              if (!Object.hasOwn(entry.meta ?? {}, String(fv))) {
                 match = false;
                 break;
               }
@@ -2488,11 +2606,24 @@ var Graph = class _Graph {
       const prefix = `${sg}${PATH_SEP}`;
       return [...nodeKeys].some((k) => k === sg || k.startsWith(prefix));
     }) : allSubgraphs;
+    const graph = this;
+    const baseOpts = options;
     return {
       name: this.name,
       nodes,
       edges,
-      subgraphs
+      subgraphs,
+      expand(detailOrFields) {
+        const merged = { ...baseOpts, format: void 0 };
+        if (Array.isArray(detailOrFields)) {
+          merged.fields = detailOrFields;
+          merged.detail = void 0;
+        } else {
+          merged.detail = detailOrFields;
+          merged.fields = void 0;
+        }
+        return graph.describe(merged);
+      }
     };
   }
   _collectSubgraphs(prefix) {
@@ -2545,14 +2676,15 @@ var Graph = class _Graph {
   observe(pathOrOpts, options) {
     if (typeof pathOrOpts === "string") {
       const path = pathOrOpts;
-      const actor2 = options?.actor;
+      const resolved = resolveObserveDetail(options);
+      const actor2 = resolved.actor;
       const target = this.resolve(path);
       if (actor2 != null && !target.allowsObserve(actor2)) {
         throw new GuardDenied({ actor: actor2, action: "observe", nodeName: path });
       }
-      const wantsStructured2 = options?.structured === true || options?.timeline === true || options?.causal === true || options?.derived === true;
+      const wantsStructured2 = resolved.structured === true || resolved.timeline === true || resolved.causal === true || resolved.derived === true || resolved.detail === "minimal" || resolved.detail === "full";
       if (wantsStructured2 && _Graph.inspectorEnabled) {
-        return this._createObserveResult(path, target, options);
+        return this._createObserveResult(path, target, resolved);
       }
       return {
         subscribe(sink) {
@@ -2568,11 +2700,11 @@ var Graph = class _Graph {
         }
       };
     }
-    const opts = pathOrOpts;
-    const actor = opts?.actor;
-    const wantsStructured = opts?.structured === true || opts?.timeline === true || opts?.causal === true || opts?.derived === true;
+    const opts = resolveObserveDetail(pathOrOpts);
+    const actor = opts.actor;
+    const wantsStructured = opts.structured === true || opts.timeline === true || opts.causal === true || opts.derived === true || opts.detail === "minimal" || opts.detail === "full";
     if (wantsStructured && _Graph.inspectorEnabled) {
-      return this._createObserveResultForAll(opts ?? {});
+      return this._createObserveResultForAll(opts);
     }
     return {
       subscribe: (sink) => {
@@ -2604,6 +2736,7 @@ var Graph = class _Graph {
     const timeline = options.timeline === true;
     const causal = options.causal === true;
     const derived2 = options.derived === true;
+    const minimal = options.detail === "minimal";
     const result = {
       values: {},
       dirtyCount: 0,
@@ -2649,6 +2782,11 @@ var Graph = class _Graph {
         if (t === DATA) {
           result.values[path] = m[1];
           result.events.push({ type: "data", path, data: m[1], ...base, ...withCausal });
+        } else if (minimal) {
+          if (t === DIRTY) result.dirtyCount++;
+          else if (t === RESOLVED) result.resolvedCount++;
+          else if (t === COMPLETE && !result.errored) result.completedCleanly = true;
+          else if (t === ERROR) result.errored = true;
         } else if (t === DIRTY) {
           result.dirtyCount++;
           result.events.push({ type: "dirty", path, ...base });
@@ -2664,6 +2802,8 @@ var Graph = class _Graph {
         }
       }
     });
+    const graph = this;
+    const basePath = path;
     return {
       get values() {
         return result.values;
@@ -2686,11 +2826,28 @@ var Graph = class _Graph {
       dispose() {
         unsub();
         detachInspectorHook?.();
+      },
+      expand(extra) {
+        unsub();
+        detachInspectorHook?.();
+        const merged = { ...options };
+        if (typeof extra === "string") {
+          merged.detail = extra;
+        } else {
+          Object.assign(merged, extra);
+        }
+        const resolvedTarget = graph.resolve(basePath);
+        return graph._createObserveResult(
+          basePath,
+          resolvedTarget,
+          resolveObserveDetail(merged)
+        );
       }
     };
   }
   _createObserveResultForAll(options) {
     const timeline = options.timeline === true;
+    const minimal = options.detail === "minimal";
     const result = {
       values: {},
       dirtyCount: 0,
@@ -2712,6 +2869,11 @@ var Graph = class _Graph {
           if (t === DATA) {
             result.values[path] = m[1];
             result.events.push({ type: "data", path, data: m[1], ...base });
+          } else if (minimal) {
+            if (t === DIRTY) result.dirtyCount++;
+            else if (t === RESOLVED) result.resolvedCount++;
+            else if (t === COMPLETE && !result.errored) result.completedCleanly = true;
+            else if (t === ERROR) result.errored = true;
           } else if (t === DIRTY) {
             result.dirtyCount++;
             result.events.push({ type: "dirty", path, ...base });
@@ -2728,6 +2890,7 @@ var Graph = class _Graph {
         }
       })
     );
+    const graph = this;
     return {
       get values() {
         return result.values;
@@ -2749,6 +2912,16 @@ var Graph = class _Graph {
       },
       dispose() {
         for (const u of unsubs) u();
+      },
+      expand(extra) {
+        for (const u of unsubs) u();
+        const merged = { ...options };
+        if (typeof extra === "string") {
+          merged.detail = extra;
+        } else {
+          Object.assign(merged, extra);
+        }
+        return graph._createObserveResultForAll(resolveObserveDetail(merged));
       }
     };
   }
@@ -2824,6 +2997,9 @@ var Graph = class _Graph {
         },
         dispose() {
           stop2();
+        },
+        expand() {
+          throw new Error("expand() requires inspector mode (Graph.inspectorEnabled = true)");
         }
       };
       const pushEvent = (path, message) => {
@@ -2924,16 +3100,16 @@ var Graph = class _Graph {
    * @returns Rendered graph text.
    */
   dumpGraph(options = {}) {
-    const described = this.describe({
+    const { expand: _, ...described } = this.describe({
       actor: options.actor,
-      filter: options.filter
+      filter: options.filter,
+      detail: "standard"
     });
     const includeEdges = options.includeEdges ?? true;
     const includeSubgraphs = options.includeSubgraphs ?? true;
     if (options.format === "json") {
       const payload = {
-        name: described.name,
-        nodes: described.nodes,
+        ...described,
         edges: includeEdges ? described.edges : [],
         subgraphs: includeSubgraphs ? described.subgraphs : []
       };
@@ -3003,10 +3179,11 @@ var Graph = class _Graph {
    * @returns Persistable snapshot with sorted keys.
    */
   snapshot() {
-    const d = this.describe();
+    const { expand: _, ...d } = this.describe({ detail: "full" });
     const sortedNodes = {};
     for (const key of Object.keys(d.nodes).sort()) {
-      sortedNodes[key] = d.nodes[key];
+      const { lastMutation: _lm, guard: _g, ...node2 } = d.nodes[key];
+      sortedNodes[key] = node2;
     }
     const sortedSubgraphs = [...d.subgraphs].sort();
     return { ...d, version: 1, nodes: sortedNodes, subgraphs: sortedSubgraphs };
@@ -3160,16 +3337,22 @@ var Graph = class _Graph {
       if (!pending) return;
       pending = false;
       try {
-        const described = this.describe();
+        const { expand: _expand, ...raw } = this.describe({ detail: "full" });
+        const cleanNodes = {};
+        for (const [p, n] of Object.entries(raw.nodes)) {
+          const { lastMutation: _lm, guard: _g, ...node2 } = n;
+          cleanNodes[p] = node2;
+        }
+        const described = { ...raw, nodes: cleanNodes };
         const snapshot = { ...described, version: SNAPSHOT_VERSION };
         seq += 1;
         const shouldCompact = lastDescribe == null || seq % compactEvery === 0;
         if (shouldCompact) {
-          adapter.save({ mode: "full", snapshot, seq });
+          adapter.save(this.name, { mode: "full", snapshot, seq });
         } else {
           const previous = lastDescribe;
           if (previous == null) return;
-          adapter.save({
+          adapter.save(this.name, {
             mode: "diff",
             diff: _Graph.diff(previous, described),
             snapshot,
@@ -3190,8 +3373,10 @@ var Graph = class _Graph {
       const triggeredByTier = messages.some((m) => messageTier(m[0]) >= 2);
       if (!triggeredByTier) return;
       if (options.filter) {
-        const described = this.describe().nodes[path];
-        if (described == null || !options.filter(path, described)) return;
+        const nd = this.resolve(path);
+        if (nd == null) return;
+        const described = describeNode(nd, resolveDescribeFields("standard"));
+        if (!options.filter(path, described)) return;
       }
       schedule();
     });