@graphrefly/graphrefly 0.6.0 → 0.8.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 };