@graphrefly/graphrefly 0.18.0 → 0.20.0

package/dist/{chunk-J7S54G7I.js → chunk-2L5J6RPM.js}

@@ -1,8 +1,9 @@
 import {
   DynamicNodeImpl,
+  NO_VALUE,
   NodeImpl,
   accessHintForGuard
-} from "./chunk-BV3TPSBK.js";
+} from "./chunk-XYL3GLB3.js";
 
 // src/core/meta.ts
 function resolveDescribeFields(detail, fields) {
@@ -71,6 +72,10 @@ function describeNode(node, includeFields) {
     out.name = node.name;
   }
   if (all || includeFields.has("value")) {
+    const isSentinel = node instanceof NodeImpl && node._cached === NO_VALUE || node instanceof DynamicNodeImpl && node._cached === NO_VALUE;
+    if (isSentinel) {
+      out.sentinel = true;
+    }
     try {
       out.value = node.get();
     } catch {
@@ -101,4 +106,4 @@ export {
   resolveDescribeFields,
   describeNode
 };
-//# sourceMappingURL=chunk-J7S54G7I.js.map
+//# sourceMappingURL=chunk-2L5J6RPM.js.map

package/dist/chunk-2L5J6RPM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/meta.ts"],"sourcesContent":["import type { Actor } from \"./actor.js\";\nimport { DynamicNodeImpl } from \"./dynamic-node.js\";\nimport { accessHintForGuard } from \"./guard.js\";\nimport { NO_VALUE, type Node, NodeImpl } from \"./node.js\";\n\n/** JSON-shaped slice of a node for Phase 1 `Graph.describe()` (GRAPHREFLY-SPEC §3.6, Appendix B). */\nexport type DescribeNodeOutput = {\n\ttype: \"state\" | \"derived\" | \"producer\" | \"operator\" | \"effect\";\n\tstatus?: Node[\"status\"];\n\tdeps: string[];\n\tmeta?: Record<string, unknown>;\n\tname?: string;\n\tvalue?: unknown;\n\t/** True when the node has never received or been initialized with a value (cache holds SENTINEL). */\n\tsentinel?: boolean;\n\t/** Node versioning info (GRAPHREFLY-SPEC §7). Present only when versioning is enabled. */\n\tv?: { id: string; version: number; cid?: string; prev?: string | null };\n\t/** Guard info (full detail). */\n\tguard?: string;\n\t/** Last mutation attribution (full detail). */\n\tlastMutation?: Readonly<{ actor: Actor; timestamp_ns: number }>;\n};\n\n/**\n * Detail level for `describe()` progressive disclosure (Phase 3.3b).\n * - `\"minimal\"` — type + deps only (default). LLM-friendly.\n * - `\"standard\"` — type, status, value, deps, meta, versioning (`v`).\n * - `\"full\"` — standard + guard, lastMutation.\n */\nexport type DescribeDetail = \"minimal\" | \"standard\" | \"full\";\n\n/**\n * Valid field names for `describe({ fields: [...] })` (Phase 3.3b).\n * Dotted paths like `\"meta.label\"` select specific meta keys.\n */\nexport type DescribeField =\n\t| \"type\"\n\t| \"status\"\n\t| \"value\"\n\t| \"deps\"\n\t| \"meta\"\n\t| \"v\"\n\t| \"guard\"\n\t| \"lastMutation\"\n\t| `meta.${string}`;\n\n/** Resolve which fields to include based on detail level or explicit field list. */\nexport function resolveDescribeFields(\n\tdetail?: DescribeDetail,\n\tfields?: readonly DescribeField[],\n): Set<string> | null {\n\t// Explicit fields override detail level\n\tif (fields != null && fields.length > 0) return new Set(fields);\n\tswitch (detail) {\n\t\tcase \"standard\":\n\t\t\treturn new Set([\"type\", \"status\", \"value\", \"deps\", \"meta\", \"v\"]);\n\t\tcase \"full\":\n\t\t\treturn null; // null = include everything\n\t\tdefault:\n\t\t\treturn new Set([\"type\", \"deps\"]);\n\t}\n}\n\nfunction inferDescribeType(n: NodeImpl): DescribeNodeOutput[\"type\"] {\n\tif (n._describeKind != null) return n._describeKind;\n\tif (!n._hasDeps) return n._fn != null ? \"producer\" : \"state\";\n\tif (n._fn == null) return \"derived\";\n\tif (n._manualEmitUsed) return \"operator\";\n\treturn \"derived\";\n}\n\n/**\n * Reads the current cached value of every companion meta field on a node,\n * suitable for merging into `describe()`-style JSON (GRAPHREFLY-SPEC §2.3, §3.6).\n *\n * @remarks\n * Values come from {@link Node.get}, which returns the **last settled** cache.\n * If a meta field is in `\"dirty\"` status (DIRTY received, DATA pending), the\n * snapshot contains the *previous* value — check `node.meta[key].status` when\n * freshness matters. Avoid calling mid-batch for the same reason.\n *\n * Meta nodes are **not** terminated when their parent receives COMPLETE or\n * ERROR — they remain writable so callers can record post-mortem metadata\n * (e.g. `meta.error`). They *are* torn down when the parent receives TEARDOWN.\n *\n * @param node - The node whose meta fields to snapshot.\n * @returns Plain object of `{ key: value }` pairs (empty if no meta defined).\n * Keys whose companion node's {@link Node.get} throws are omitted.\n *\n * @example\n * ```ts\n * import { core } from \"@graphrefly/graphrefly-ts\";\n *\n * const n = core.node({ initial: 0, meta: { tag: \"a\" } });\n * core.metaSnapshot(n); // { tag: \"a\" }\n * ```\n */\n/** @internal Used by {@link describeNode} — not part of the public API. */\nexport function metaSnapshot(node: Node): Record<string, unknown> {\n\tconst out: Record<string, unknown> = {};\n\tfor (const [key, child] of Object.entries(node.meta)) {\n\t\ttry {\n\t\t\tout[key] = child.get();\n\t\t} catch {\n\t\t\t/* omit key — describe tooling still gets other fields */\n\t\t}\n\t}\n\treturn out;\n}\n\n/**\n * Builds a single-node slice of `Graph.describe()` JSON (structure + `meta` snapshot).\n * Parity with graphrefly-py `describe_node`.\n *\n * `type` is inferred from factory configuration, optional `describeKind` in node options,\n * and the last `manualEmitUsed` hint (operator vs derived). {@link effect} sets\n * `describeKind: \"effect\"`. Nodes not created by {@link node} fall back to `type: \"state\"` and empty `deps`.\n *\n * @param node - Any `Node` to introspect.\n * @returns `DescribeNodeOutput` suitable for merging into graph describe maps.\n *\n * @example\n * ```ts\n * import { describeNode, state } from \"@graphrefly/graphrefly-ts\";\n *\n * describeNode(state(0));\n * ```\n */\n/**\n * Builds a single-node slice for `Graph.describe()`.\n *\n * @param node - Node to introspect.\n * @param includeFields - Set of fields to include, or `null` for all. When omitted, all fields are included (legacy behavior).\n */\n/** @internal Used by {@link Graph.describe} — not part of the public API. */\nexport function describeNode(node: Node, includeFields?: Set<string> | null): DescribeNodeOutput {\n\tconst all = includeFields == null; // null or undefined → include everything\n\n\t// Specific meta keys requested via dotted paths (e.g. \"meta.label\")\n\tconst metaKeys: string[] | null =\n\t\t!all && includeFields != null\n\t\t\t? [...includeFields].filter((f) => f.startsWith(\"meta.\")).map((f) => f.slice(5))\n\t\t\t: null;\n\tconst wantsMeta = all || includeFields!.has(\"meta\") || (metaKeys != null && metaKeys.length > 0);\n\n\tlet type: DescribeNodeOutput[\"type\"] = \"state\";\n\tlet deps: string[] = [];\n\n\tif (node instanceof NodeImpl) {\n\t\ttype = inferDescribeType(node);\n\t\tdeps = node._deps.map((d) => d.name ?? \"\");\n\t} else if (node instanceof DynamicNodeImpl) {\n\t\ttype = node._describeKind ?? \"derived\";\n\t\tdeps = [];\n\t}\n\n\tconst out: DescribeNodeOutput = { type, deps };\n\n\t// status\n\tif (all || includeFields!.has(\"status\")) {\n\t\tout.status = node.status;\n\t}\n\n\t// Resolve guard once — used by both meta.access hint and standalone guard field\n\tconst guard =\n\t\t(node instanceof NodeImpl && node._guard) ||\n\t\t(node instanceof DynamicNodeImpl && node._guard) ||\n\t\tundefined;\n\n\t// meta\n\tif (wantsMeta) {\n\t\tconst rawMeta: Record<string, unknown> = { ...metaSnapshot(node) };\n\t\tif (guard != null && rawMeta.access === undefined) {\n\t\t\trawMeta.access = accessHintForGuard(guard);\n\t\t}\n\n\t\tif (metaKeys != null && metaKeys.length > 0 && !includeFields!.has(\"meta\")) {\n\t\t\t// Only specific meta keys\n\t\t\tconst filtered: Record<string, unknown> = {};\n\t\t\tfor (const k of metaKeys) {\n\t\t\t\tif (k in rawMeta) filtered[k] = rawMeta[k];\n\t\t\t}\n\t\t\tout.meta = filtered;\n\t\t} else {\n\t\t\tout.meta = rawMeta;\n\t\t}\n\t}\n\n\t// name (always include when present — it's identity, not detail)\n\tif (node.name != null) {\n\t\tout.name = node.name;\n\t}\n\n\t// value + sentinel indicator\n\tif (all || includeFields!.has(\"value\")) {\n\t\tconst isSentinel =\n\t\t\t(node instanceof NodeImpl && node._cached === NO_VALUE) ||\n\t\t\t(node instanceof DynamicNodeImpl && node._cached === NO_VALUE);\n\t\tif (isSentinel) {\n\t\t\tout.sentinel = true;\n\t\t}\n\t\ttry {\n\t\t\tout.value = node.get();\n\t\t} catch {\n\t\t\t/* omit value */\n\t\t}\n\t}\n\n\t// Versioning (GRAPHREFLY-SPEC §7)\n\tif ((all || includeFields!.has(\"v\")) && node.v != null) {\n\t\tconst vInfo: DescribeNodeOutput[\"v\"] = { id: node.v.id, version: node.v.version };\n\t\tif (\"cid\" in node.v) {\n\t\t\tvInfo!.cid = (node.v as { cid: string }).cid;\n\t\t\tvInfo!.prev = (node.v as { prev: string | null }).prev;\n\t\t}\n\t\tout.v = vInfo;\n\t}\n\n\t// Guard info (full detail)\n\tif (all || includeFields!.has(\"guard\")) {\n\t\tif (guard != null) {\n\t\t\tout.guard = accessHintForGuard(guard);\n\t\t}\n\t}\n\n\t// Last mutation attribution (full detail)\n\tif (all || includeFields!.has(\"lastMutation\")) {\n\t\tif (node.lastMutation != null) {\n\t\t\tout.lastMutation = node.lastMutation;\n\t\t}\n\t}\n\n\treturn out;\n}\n"],"mappings":";;;;;;;;AA+CO,SAAS,sBACf,QACA,QACqB;AAErB,MAAI,UAAU,QAAQ,OAAO,SAAS,EAAG,QAAO,IAAI,IAAI,MAAM;AAC9D,UAAQ,QAAQ;AAAA,IACf,KAAK;AACJ,aAAO,oBAAI,IAAI,CAAC,QAAQ,UAAU,SAAS,QAAQ,QAAQ,GAAG,CAAC;AAAA,IAChE,KAAK;AACJ,aAAO;AAAA;AAAA,IACR;AACC,aAAO,oBAAI,IAAI,CAAC,QAAQ,MAAM,CAAC;AAAA,EACjC;AACD;AAEA,SAAS,kBAAkB,GAAyC;AACnE,MAAI,EAAE,iBAAiB,KAAM,QAAO,EAAE;AACtC,MAAI,CAAC,EAAE,SAAU,QAAO,EAAE,OAAO,OAAO,aAAa;AACrD,MAAI,EAAE,OAAO,KAAM,QAAO;AAC1B,MAAI,EAAE,gBAAiB,QAAO;AAC9B,SAAO;AACR;AA6BO,SAAS,aAAa,MAAqC;AACjE,QAAM,MAA+B,CAAC;AACtC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,IAAI,GAAG;AACrD,QAAI;AACH,UAAI,GAAG,IAAI,MAAM,IAAI;AAAA,IACtB,QAAQ;AAAA,IAER;AAAA,EACD;AACA,SAAO;AACR;AA2BO,SAAS,aAAa,MAAY,eAAwD;AAChG,QAAM,MAAM,iBAAiB;AAG7B,QAAM,WACL,CAAC,OAAO,iBAAiB,OACtB,CAAC,GAAG,aAAa,EAAE,OAAO,CAAC,MAAM,EAAE,WAAW,OAAO,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,IAC7E;AACJ,QAAM,YAAY,OAAO,cAAe,IAAI,MAAM,KAAM,YAAY,QAAQ,SAAS,SAAS;AAE9F,MAAI,OAAmC;AACvC,MAAI,OAAiB,CAAC;AAEtB,MAAI,gBAAgB,UAAU;AAC7B,WAAO,kBAAkB,IAAI;AAC7B,WAAO,KAAK,MAAM,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE;AAAA,EAC1C,WAAW,gBAAgB,iBAAiB;AAC3C,WAAO,KAAK,iBAAiB;AAC7B,WAAO,CAAC;AAAA,EACT;AAEA,QAAM,MAA0B,EAAE,MAAM,KAAK;AAG7C,MAAI,OAAO,cAAe,IAAI,QAAQ,GAAG;AACxC,QAAI,SAAS,KAAK;AAAA,EACnB;AAGA,QAAM,QACJ,gBAAgB,YAAY,KAAK,UACjC,gBAAgB,mBAAmB,KAAK,UACzC;AAGD,MAAI,WAAW;AACd,UAAM,UAAmC,EAAE,GAAG,aAAa,IAAI,EAAE;AACjE,QAAI,SAAS,QAAQ,QAAQ,WAAW,QAAW;AAClD,cAAQ,SAAS,mBAAmB,KAAK;AAAA,IAC1C;AAEA,QAAI,YAAY,QAAQ,SAAS,SAAS,KAAK,CAAC,cAAe,IAAI,MAAM,GAAG;AAE3E,YAAM,WAAoC,CAAC;AAC3C,iBAAW,KAAK,UAAU;AACzB,YAAI,KAAK,QAAS,UAAS,CAAC,IAAI,QAAQ,CAAC;AAAA,MAC1C;AACA,UAAI,OAAO;AAAA,IACZ,OAAO;AACN,UAAI,OAAO;AAAA,IACZ;AAAA,EACD;AAGA,MAAI,KAAK,QAAQ,MAAM;AACtB,QAAI,OAAO,KAAK;AAAA,EACjB;AAGA,MAAI,OAAO,cAAe,IAAI,OAAO,GAAG;AACvC,UAAM,aACJ,gBAAgB,YAAY,KAAK,YAAY,YAC7C,gBAAgB,mBAAmB,KAAK,YAAY;AACtD,QAAI,YAAY;AACf,UAAI,WAAW;AAAA,IAChB;AACA,QAAI;AACH,UAAI,QAAQ,KAAK,IAAI;AAAA,IACtB,QAAQ;AAAA,IAER;AAAA,EACD;AAGA,OAAK,OAAO,cAAe,IAAI,GAAG,MAAM,KAAK,KAAK,MAAM;AACvD,UAAM,QAAiC,EAAE,IAAI,KAAK,EAAE,IAAI,SAAS,KAAK,EAAE,QAAQ;AAChF,QAAI,SAAS,KAAK,GAAG;AACpB,YAAO,MAAO,KAAK,EAAsB;AACzC,YAAO,OAAQ,KAAK,EAA8B;AAAA,IACnD;AACA,QAAI,IAAI;AAAA,EACT;AAGA,MAAI,OAAO,cAAe,IAAI,OAAO,GAAG;AACvC,QAAI,SAAS,MAAM;AAClB,UAAI,QAAQ,mBAAmB,KAAK;AAAA,IACrC;AAAA,EACD;AAGA,MAAI,OAAO,cAAe,IAAI,cAAc,GAAG;AAC9C,QAAI,KAAK,gBAAgB,MAAM;AAC9B,UAAI,eAAe,KAAK;AAAA,IACzB;AAAA,EACD;AAEA,SAAO;AACR;","names":[]}

package/dist/{chunk-LB3RYLSC.js → chunk-3N2Y6PCR.js}

@@ -1,7 +1,7 @@
 import {
   describeNode,
   resolveDescribeFields
-} from "./chunk-J7S54G7I.js";
+} from "./chunk-2L5J6RPM.js";
 import {
   COMPLETE,
   DATA,
@@ -16,7 +16,130 @@ import {
   messageTier,
   monotonicNs,
   state
-} from "./chunk-BV3TPSBK.js";
+} from "./chunk-XYL3GLB3.js";
+
+// src/graph/sizeof.ts
+var OVERHEAD = {
+  object: 56,
+  array: 64,
+  string: 40,
+  // header; content added separately
+  number: 8,
+  boolean: 4,
+  null: 0,
+  undefined: 0,
+  symbol: 40,
+  bigint: 16,
+  function: 120,
+  map: 72,
+  set: 72,
+  mapEntry: 40,
+  setEntry: 24
+};
+function sizeof(value) {
+  const seen = /* @__PURE__ */ new WeakSet();
+  return _sizeof(value, seen);
+}
+function _sizeof(value, seen) {
+  if (value == null) return 0;
+  const t = typeof value;
+  switch (t) {
+    case "number":
+      return OVERHEAD.number;
+    case "boolean":
+      return OVERHEAD.boolean;
+    case "string":
+      return OVERHEAD.string + value.length * 2;
+    // UTF-16
+    case "bigint":
+      return OVERHEAD.bigint;
+    case "symbol":
+      return OVERHEAD.symbol;
+    case "function":
+      if (seen.has(value)) return 0;
+      seen.add(value);
+      return OVERHEAD.function;
+    case "undefined":
+      return 0;
+  }
+  const obj = value;
+  if (seen.has(obj)) return 0;
+  seen.add(obj);
+  if (obj instanceof Map) {
+    let size2 = OVERHEAD.map;
+    for (const [k, v] of obj) {
+      size2 += OVERHEAD.mapEntry + _sizeof(k, seen) + _sizeof(v, seen);
+    }
+    return size2;
+  }
+  if (obj instanceof Set) {
+    let size2 = OVERHEAD.set;
+    for (const v of obj) {
+      size2 += OVERHEAD.setEntry + _sizeof(v, seen);
+    }
+    return size2;
+  }
+  if (Array.isArray(obj)) {
+    let size2 = OVERHEAD.array + obj.length * 8;
+    for (const item of obj) {
+      size2 += _sizeof(item, seen);
+    }
+    return size2;
+  }
+  if (obj instanceof ArrayBuffer) return obj.byteLength;
+  if (ArrayBuffer.isView(obj)) return obj.byteLength;
+  let size = OVERHEAD.object;
+  const keys = Object.keys(obj);
+  for (const key of keys) {
+    size += OVERHEAD.string + key.length * 2;
+    size += _sizeof(obj[key], seen);
+  }
+  return size;
+}
+
+// src/graph/profile.ts
+function graphProfile(graph, opts) {
+  const topN = opts?.topN ?? 10;
+  const desc = graph.describe({ detail: "standard" });
+  const targets = [];
+  if (typeof graph._collectObserveTargets === "function") {
+    graph._collectObserveTargets("", targets);
+  }
+  const pathToNode = /* @__PURE__ */ new Map();
+  for (const [p, n] of targets) {
+    pathToNode.set(p, n);
+  }
+  const profiles = [];
+  for (const [path, nodeDesc] of Object.entries(desc.nodes)) {
+    const nd = pathToNode.get(path);
+    const impl = nd instanceof NodeImpl ? nd : null;
+    const valueSizeBytes = impl ? sizeof(impl.get()) : 0;
+    const subscriberCount = impl ? impl._sinkCount : 0;
+    const depCount = nodeDesc.deps?.length ?? 0;
+    const isOrphanEffect = nodeDesc.type === "effect" && subscriberCount === 0;
+    profiles.push({
+      path,
+      type: nodeDesc.type,
+      status: nodeDesc.status ?? "unknown",
+      valueSizeBytes,
+      subscriberCount,
+      depCount,
+      isOrphanEffect
+    });
+  }
+  const totalValueSizeBytes = profiles.reduce((sum, p) => sum + p.valueSizeBytes, 0);
+  const hotspots = [...profiles].sort((a, b) => b.valueSizeBytes - a.valueSizeBytes).slice(0, topN);
+  const orphanEffects = profiles.filter((p) => p.isOrphanEffect);
+  return {
+    nodeCount: profiles.length,
+    edgeCount: desc.edges.length,
+    subgraphCount: desc.subgraphs.length,
+    nodes: profiles,
+    totalValueSizeBytes,
+    hotspots,
+    orphanEffects
+  };
+}
 
 // src/graph/graph.ts
 var PATH_SEP = "::";
@@ -930,6 +1053,16 @@ var Graph = class _Graph {
     }
     return out;
   }
+  /**
+   * Snapshot-based resource profile: per-node stats, orphan effect detection,
+   * memory hotspots. Zero runtime overhead — walks nodes on demand.
+   *
+   * @param opts - Optional `topN` for hotspot limit (default 10).
+   * @returns Aggregate profile with per-node details, hotspots, and orphan effects.
+   */
+  resourceProfile(opts) {
+    return graphProfile(this, opts);
+  }
   _qualifyEdgeEndpoint(part, prefix) {
     if (part.includes(PATH_SEP)) return part;
     return prefix === "" ? part : `${prefix}${PATH_SEP}${part}`;
@@ -1031,8 +1164,8 @@ var Graph = class _Graph {
       dirtyCount: 0,
       resolvedCount: 0,
       events: [],
-      completedCleanly: false,
-      errored: false
+      anyCompletedCleanly: false,
+      anyErrored: false
     };
     let lastTriggerDepIndex;
     let lastRunDepValues;
@@ -1076,8 +1209,8 @@ var Graph = class _Graph {
         } 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 === COMPLETE && !result.anyErrored) result.anyCompletedCleanly = true;
+          else if (t === ERROR) result.anyErrored = true;
         } else if (t === DIRTY) {
           result.dirtyCount++;
           result.events.push({ type: "dirty", path, ...base });
@@ -1085,10 +1218,10 @@ var Graph = class _Graph {
           result.resolvedCount++;
           result.events.push({ type: "resolved", path, ...base, ...withCausal });
         } else if (t === COMPLETE) {
-          if (!result.errored) result.completedCleanly = true;
+          if (!result.anyErrored) result.anyCompletedCleanly = true;
           result.events.push({ type: "complete", path, ...base });
         } else if (t === ERROR) {
-          result.errored = true;
+          result.anyErrored = true;
           result.events.push({ type: "error", path, data: m[1], ...base });
         }
       }
@@ -1108,11 +1241,14 @@ var Graph = class _Graph {
       get events() {
         return result.events;
       },
-      get completedCleanly() {
-        return result.completedCleanly;
+      get anyCompletedCleanly() {
+        return result.anyCompletedCleanly;
       },
-      get errored() {
-        return result.errored;
+      get anyErrored() {
+        return result.anyErrored;
+      },
+      get completedWithoutErrors() {
+        return result.anyCompletedCleanly && !result.anyErrored;
       },
       dispose() {
         unsub();
@@ -1148,9 +1284,10 @@ var Graph = class _Graph {
       dirtyCount: 0,
       resolvedCount: 0,
       events: [],
-      completedCleanly: false,
-      errored: false
+      anyCompletedCleanly: false,
+      anyErrored: false
     };
+    const nodeErrored = /* @__PURE__ */ new Set();
     const actor = options.actor;
     const targets = [];
     this._collectObserveTargets("", targets);
@@ -1169,8 +1306,11 @@ var Graph = class _Graph {
           } 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 === COMPLETE && !nodeErrored.has(path)) result.anyCompletedCleanly = true;
+            else if (t === ERROR) {
+              result.anyErrored = true;
+              nodeErrored.add(path);
+            }
           } else if (t === DIRTY) {
             result.dirtyCount++;
             result.events.push({ type: "dirty", path, ...base });
@@ -1178,10 +1318,11 @@ var Graph = class _Graph {
             result.resolvedCount++;
             result.events.push({ type: "resolved", path, ...base });
           } else if (t === COMPLETE) {
-            if (!result.errored) result.completedCleanly = true;
+            if (!nodeErrored.has(path)) result.anyCompletedCleanly = true;
             result.events.push({ type: "complete", path, ...base });
           } else if (t === ERROR) {
-            result.errored = true;
+            result.anyErrored = true;
+            nodeErrored.add(path);
             result.events.push({ type: "error", path, data: m[1], ...base });
           }
         }
@@ -1201,11 +1342,14 @@ var Graph = class _Graph {
       get events() {
         return result.events;
       },
-      get completedCleanly() {
-        return result.completedCleanly;
+      get anyCompletedCleanly() {
+        return result.anyCompletedCleanly;
+      },
+      get anyErrored() {
+        return result.anyErrored;
       },
-      get errored() {
-        return result.errored;
+      get completedWithoutErrors() {
+        return result.anyCompletedCleanly && !result.anyErrored;
       },
       dispose() {
         for (const u of unsubs) u();
@@ -1237,8 +1381,8 @@ var Graph = class _Graph {
       dirtyCount: 0,
       resolvedCount: 0,
       events: [],
-      completedCleanly: false,
-      errored: false
+      anyCompletedCleanly: false,
+      anyErrored: false
     };
     const target = this.resolve(path);
     let batchSeq = 0;
@@ -1257,10 +1401,10 @@ var Graph = class _Graph {
           acc.resolvedCount++;
           acc.events.push({ type: "resolved", path, ...base });
         } else if (t === COMPLETE) {
-          if (!acc.errored) acc.completedCleanly = true;
+          if (!acc.anyErrored) acc.anyCompletedCleanly = true;
           acc.events.push({ type: "complete", path, ...base });
         } else if (t === ERROR) {
-          acc.errored = true;
+          acc.anyErrored = true;
           acc.events.push({ type: "error", path, data: m[1], ...base });
         }
       }
@@ -1278,11 +1422,14 @@ var Graph = class _Graph {
       get events() {
         return acc.events;
       },
-      get completedCleanly() {
-        return acc.completedCleanly;
+      get anyCompletedCleanly() {
+        return acc.anyCompletedCleanly;
       },
-      get errored() {
-        return acc.errored;
+      get anyErrored() {
+        return acc.anyErrored;
+      },
+      get completedWithoutErrors() {
+        return acc.anyCompletedCleanly && !acc.anyErrored;
       },
       dispose() {
         unsub();
@@ -1303,9 +1450,10 @@ var Graph = class _Graph {
       dirtyCount: 0,
       resolvedCount: 0,
       events: [],
-      completedCleanly: false,
-      errored: false
+      anyCompletedCleanly: false,
+      anyErrored: false
     };
+    const nodeErrored = /* @__PURE__ */ new Set();
     const targets = [];
     this._collectObserveTargets("", targets);
     targets.sort((a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0);
@@ -1327,10 +1475,11 @@ var Graph = class _Graph {
             acc.resolvedCount++;
             acc.events.push({ type: "resolved", path, ...base });
           } else if (t === COMPLETE) {
-            if (!acc.errored) acc.completedCleanly = true;
+            if (!nodeErrored.has(path)) acc.anyCompletedCleanly = true;
             acc.events.push({ type: "complete", path, ...base });
           } else if (t === ERROR) {
-            acc.errored = true;
+            acc.anyErrored = true;
+            nodeErrored.add(path);
             acc.events.push({ type: "error", path, data: m[1], ...base });
           }
         }
@@ -1349,11 +1498,14 @@ var Graph = class _Graph {
       get events() {
         return acc.events;
       },
-      get completedCleanly() {
-        return acc.completedCleanly;
+      get anyCompletedCleanly() {
+        return acc.anyCompletedCleanly;
+      },
+      get anyErrored() {
+        return acc.anyErrored;
       },
-      get errored() {
-        return acc.errored;
+      get completedWithoutErrors() {
+        return acc.anyCompletedCleanly && !acc.anyErrored;
       },
       dispose() {
         for (const u of unsubs) u();
@@ -1679,8 +1831,9 @@ var Graph = class _Graph {
   /**
    * Debounced persistence wired to graph-wide observe stream (spec §3.8 auto-checkpoint).
    *
-   * Checkpoint trigger uses {@link messageTier}: only batches containing tier >= 2 messages
-   * schedule a save (`DATA`/`RESOLVED`/terminal/destruction), never pure tier-0/1 control waves.
+   * Checkpoint trigger uses {@link messageTier}: only batches containing tier >= 3 messages
+   * schedule a save (`DATA`/`RESOLVED`/terminal/destruction), never pure tier-0/1/2 control
+   * waves (`START`/`DIRTY`/`INVALIDATE`/`PAUSE`/`RESUME`).
    */
   autoCheckpoint(adapter, options = {}) {
     const debounceMs = Math.max(0, options.debounceMs ?? 500);
@@ -1727,7 +1880,7 @@ var Graph = class _Graph {
       timer = setTimeout(flush, debounceMs);
     };
     const off = this.observe().subscribe((path, messages) => {
-      const triggeredByTier = messages.some((m) => messageTier(m[0]) >= 2);
+      const triggeredByTier = messages.some((m) => messageTier(m[0]) >= 3);
       if (!triggeredByTier) return;
       if (options.filter) {
         const nd = this.resolve(path);
@@ -1955,8 +2108,10 @@ function reachable(described, from, direction, options = {}) {
 }
 
 export {
+  sizeof,
+  graphProfile,
   GRAPH_META_SEGMENT,
   Graph,
   reachable
 };
-//# sourceMappingURL=chunk-LB3RYLSC.js.map
+//# sourceMappingURL=chunk-3N2Y6PCR.js.map