@unbrained/pm-cli 2026.7.16 → 2026.7.18

package/dist/sdk/graph/traversal.js

@@ -0,0 +1,262 @@
+/** Default number of paths returned by bounded path enumeration. */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ed9f0831-6011-5ee2-abd6-72375eac0a3a")}catch(e){}}();
+const DEFAULT_MAX_PATHS = 5;
+/** Default expansion-safety bound for bounded path enumeration. */
+const DEFAULT_MAX_VISITED_PATHS = 10_000;
+/** Default depth bound applied to bounded path enumeration. */
+const DEFAULT_PATH_MAX_DEPTH = 8;
+/** Require a finite non-negative integer for one path-enumeration bound. */
+function assertPathBound(name, value) {
+    if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0)
+        throw new TypeError(`Invalid path ${name} bound: ${String(value)}`);
+}
+/** Endpoint of a hierarchy edge that represents the structural parent. */
+export function hierarchyParentEndpoint(edge, definition) {
+    // Custom hierarchy kinds may omit the direction; the registry documents the
+    // source endpoint as the default parent.
+    return definition.hierarchyDirection === "target_parent"
+        ? edge.target
+        : edge.source;
+}
+/** Endpoint of an ordering edge that must finish first. */
+export function orderingPredecessorEndpoint(edge, definition) {
+    // Ordering kinds registered without explicit precedence default to
+    // source-before-target, matching the execution-analytics interpretation.
+    return (definition.precedence ?? "source_before_target") ===
+        "target_before_source"
+        ? edge.target
+        : edge.source;
+}
+/** Validate optional kind filters against one semantic edge family. */
+function resolveFamilyKinds(graph, kinds, family) {
+    if (kinds === undefined)
+        return undefined;
+    const registry = graph.registry();
+    const resolved = new Set();
+    for (const kind of kinds) {
+        const definition = registry.require(kind);
+        if (!definition[family])
+            throw new TypeError(`Relationship kind ${definition.kind} is not a ${family} kind`);
+        resolved.add(definition.kind);
+    }
+    return resolved;
+}
+/** Expand one node into its deterministic semantic neighbors. */
+function expandSemanticNeighbors(graph, nodeId, familyKinds, family, matches) {
+    const registry = graph.registry();
+    const rows = graph.neighborEdges(nodeId, {
+        direction: "both",
+        ...(familyKinds === undefined ? {} : { kinds: [...familyKinds] }),
+    });
+    const neighbors = [];
+    const seen = new Set();
+    for (const row of rows.value) {
+        const definition = registry.require(row.edge.kind);
+        if (!definition[family])
+            continue;
+        if (!matches(row, definition, nodeId))
+            continue;
+        if (seen.has(row.id))
+            continue;
+        seen.add(row.id);
+        neighbors.push(row.id);
+    }
+    return { neighbors, inspectedEdges: rows.meta.inspectedEdges };
+}
+/** Append one semantic expansion and report whether the page limit was reached. */
+function appendSemanticExpansion(expansion, currentDepth, maxDepth, limit, after, state) {
+    if (currentDepth >= maxDepth) {
+        if (expansion.neighbors.some((neighbor) => !state.seen.has(neighbor)))
+            state.truncated = true;
+        return false;
+    }
+    for (const neighbor of expansion.neighbors) {
+        if (state.seen.has(neighbor))
+            continue;
+        state.seen.add(neighbor);
+        state.queue.push({ id: neighbor, depth: currentDepth + 1 });
+        if (!state.resumed) {
+            if (neighbor === after)
+                state.resumed = true;
+            continue;
+        }
+        if (state.value.length >= limit) {
+            state.truncated = true;
+            return true;
+        }
+        state.value.push(neighbor);
+    }
+    return false;
+}
+/** Run one deterministic bounded breadth-first semantic walk. */
+function boundedSemanticWalk(graph, start, options, family, matches) {
+    if (!graph.hasNode(start))
+        throw new TypeError(`Relationship node not found: ${start}`);
+    const familyKinds = resolveFamilyKinds(graph, options.kinds, family);
+    const limit = options.limit ?? Number.POSITIVE_INFINITY;
+    const maxDepth = options.maxDepth ?? Number.POSITIVE_INFINITY;
+    const after = options.after;
+    const state = {
+        seen: new Set([start]),
+        value: [],
+        queue: [{ id: start, depth: 0 }],
+        resumed: after === undefined,
+        truncated: false,
+    };
+    let visitedNodes = 0;
+    let inspectedEdges = 0;
+    for (let index = 0; index < state.queue.length; index += 1) {
+        options.signal?.throwIfAborted();
+        const current = state.queue[index];
+        visitedNodes += 1;
+        const expansion = expandSemanticNeighbors(graph, current.id, familyKinds, family, matches);
+        inspectedEdges += expansion.inspectedEdges;
+        if (appendSemanticExpansion(expansion, current.depth, maxDepth, limit, after, state))
+            break;
+    }
+    if (!state.resumed)
+        throw new TypeError(`Traversal cursor not found in sequence: ${after}`);
+    return {
+        value: state.value,
+        meta: {
+            visitedNodes,
+            inspectedEdges,
+            truncated: state.truncated,
+            nextCursor: state.value.at(-1),
+        },
+    };
+}
+/** Validate one path endpoint against the indexed graph. */
+function assertPathEndpoint(graph, id) {
+    if (!graph.hasNode(id))
+        throw new TypeError(`Relationship node not found: ${id}`);
+}
+/** Return eligible simple-path continuations and account for inspected edges. */
+function readPathContinuations(graph, partial, options, direction, state) {
+    const rows = graph.neighborEdges(partial.nodes.at(-1), {
+        direction,
+        ...(options.kinds === undefined ? {} : { kinds: options.kinds }),
+    });
+    state.inspectedEdges += rows.meta.inspectedEdges;
+    return rows.value.filter((row) => !partial.nodeSet.has(row.id));
+}
+/** Expand one partial simple path and report whether the probe cap was reached. */
+function expandPartialPath(graph, partial, target, options, direction, probeLimit, state) {
+    for (const row of readPathContinuations(graph, partial, options, direction, state)) {
+        const nodes = [...partial.nodes, row.id];
+        const nodeSet = new Set(partial.nodeSet).add(row.id);
+        const edges = [...partial.edges, row.edge];
+        if (row.id === target) {
+            state.value.push({ nodes, edges, length: edges.length });
+            if (state.value.length >= probeLimit)
+                return true;
+        }
+        else {
+            state.queue.push({ nodes, nodeSet, edges });
+        }
+    }
+    return false;
+}
+/**
+ * Return the bounded transitive hierarchy ancestors of one node in
+ * breadth-first discovery order, honoring each hierarchy kind's declared
+ * parent endpoint (so `parent` and inverse `child` spellings agree).
+ */
+export function hierarchyAncestors(graph, id, options = {}) {
+    return boundedSemanticWalk(graph, id, options, "hierarchy", (row, definition) => hierarchyParentEndpoint(row.edge, definition) === row.id);
+}
+/**
+ * Return the bounded transitive hierarchy descendants of one node in
+ * breadth-first discovery order, honoring each hierarchy kind's declared
+ * parent endpoint.
+ */
+export function hierarchyDescendants(graph, id, options = {}) {
+    return boundedSemanticWalk(graph, id, options, "hierarchy", (row, definition, nodeId) => hierarchyParentEndpoint(row.edge, definition) === nodeId);
+}
+/**
+ * Return the bounded transitive execution predecessors of one node — the work
+ * that must finish before it — in breadth-first discovery order, honoring each
+ * ordering kind's declared precedence (so `blocked_by` and inverse `blocks`
+ * spellings agree).
+ */
+export function orderingPredecessors(graph, id, options = {}) {
+    return boundedSemanticWalk(graph, id, options, "ordering", (row, definition) => orderingPredecessorEndpoint(row.edge, definition) === row.id);
+}
+/**
+ * Return the bounded transitive execution successors of one node — the work
+ * this node gates — in breadth-first discovery order, honoring each ordering
+ * kind's declared precedence.
+ */
+export function orderingSuccessors(graph, id, options = {}) {
+    return boundedSemanticWalk(graph, id, options, "ordering", (row, definition, nodeId) => orderingPredecessorEndpoint(row.edge, definition) === nodeId);
+}
+/** Run bounded non-zero path enumeration after public option validation. */
+function enumerateNonZeroRelationshipPaths(graph, source, target, options, maxPaths, maxVisitedPaths, maxDepth, direction) {
+    const state = {
+        value: [],
+        queue: [{ nodes: [source], nodeSet: new Set([source]), edges: [] }],
+        inspectedEdges: 0,
+    };
+    let visitedNodes = 0;
+    let truncated = false;
+    const probeLimit = maxPaths + 1;
+    for (let index = 0; index < state.queue.length; index += 1) {
+        options.signal?.throwIfAborted();
+        if (state.value.length >= probeLimit || visitedNodes >= maxVisitedPaths) {
+            truncated = true;
+            break;
+        }
+        const partial = state.queue[index];
+        visitedNodes += 1;
+        if (partial.edges.length >= maxDepth) {
+            if (readPathContinuations(graph, partial, options, direction, state)
+                .length > 0)
+                truncated = true;
+            continue;
+        }
+        if (expandPartialPath(graph, partial, target, options, direction, probeLimit, state)) {
+            truncated = true;
+            break;
+        }
+    }
+    return {
+        value: state.value.slice(0, maxPaths),
+        meta: { visitedNodes, inspectedEdges: state.inspectedEdges, truncated },
+    };
+}
+/**
+ * Enumerate bounded simple paths between two nodes, shortest first and
+ * lexicographic within equal length. Traversal honors direction and kind
+ * filters, caps returned paths, and reports truncation when depth, path-count,
+ * or the expansion-safety bound stops the search early.
+ */
+export function enumerateRelationshipPaths(graph, source, target, options = {}) {
+    assertPathEndpoint(graph, source);
+    assertPathEndpoint(graph, target);
+    const maxPaths = options.maxPaths ?? DEFAULT_MAX_PATHS;
+    const maxVisitedPaths = options.maxVisitedPaths ?? DEFAULT_MAX_VISITED_PATHS;
+    const maxDepth = options.maxDepth ?? DEFAULT_PATH_MAX_DEPTH;
+    assertPathBound("maxPaths", maxPaths);
+    assertPathBound("maxVisitedPaths", maxVisitedPaths);
+    assertPathBound("maxDepth", maxDepth);
+    const direction = options.direction ?? "outgoing";
+    options.signal?.throwIfAborted();
+    for (const kind of options.kinds ?? [])
+        graph.registry().require(kind);
+    if (source === target) {
+        if (maxPaths === 0) {
+            return {
+                value: [],
+                meta: { visitedNodes: 1, inspectedEdges: 0, truncated: true },
+            };
+        }
+        return {
+            value: [{ nodes: [source], edges: [], length: 0 }],
+            meta: { visitedNodes: 1, inspectedEdges: 0, truncated: false },
+        };
+    }
+    return enumerateNonZeroRelationshipPaths(graph, source, target, options, maxPaths, maxVisitedPaths, maxDepth, direction);
+}
+//# sourceMappingURL=traversal.js.map
+//# debugId=ed9f0831-6011-5ee2-abd6-72375eac0a3a

package/dist/sdk/graph/traversal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traversal.js","sources":["sdk/graph/traversal.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/graph/traversal\n *\n * Registry-semantics graph traversal primitives layered over the bounded\n * relationship kernel: hierarchy walks (ancestors/descendants), execution-order\n * walks (predecessors/successors), and bounded simple-path enumeration. Every\n * query is deterministic, cancellable, resumable via an explicit cursor, and\n * reports exact cost and truncation metadata so agents can budget follow-up\n * calls without re-reading the workspace.\n */\nimport {\n  RelationshipGraph,\n  type RelationshipEdge,\n  type RelationshipKindDefinition,\n  type RelationshipNeighborEdge,\n  type RelationshipQueryOptions,\n  type RelationshipQueryResult,\n} from \"../relationships.js\";\n\n/**\n * Shared bounded-traversal controls extended with deterministic resumption.\n * Semantic hierarchy and ordering orientation comes from the relationship-kind\n * registry, so callers cannot supply the generic graph `direction` option.\n */\nexport interface GraphTraversalOptions extends Omit<\n  RelationshipQueryOptions,\n  \"direction\"\n> {\n  /**\n   * Resume emission after this previously returned node identifier. The\n   * traversal re-walks the same deterministic sequence and starts emitting\n   * after the cursor node; an identifier the sequence never reaches fails fast\n   * instead of silently returning an empty page.\n   */\n  after?: string;\n}\n\n/** One enumerated simple path between two nodes. */\nexport interface RelationshipPath {\n  /** Ordered node identifiers from source to target inclusive. */\n  nodes: string[];\n  /** Edges connecting consecutive path nodes, in traversal order. */\n  edges: RelationshipEdge[];\n  /** Number of edges in the path. */\n  length: number;\n}\n\n/** Bounded-path enumeration controls. */\nexport interface GraphPathOptions extends RelationshipQueryOptions {\n  /** Maximum number of returned paths; defaults to 5. */\n  maxPaths?: number;\n  /** Safety bound on expanded partial paths before truncation; defaults to 10000. */\n  maxVisitedPaths?: number;\n}\n\n/** Default number of paths returned by bounded path enumeration. */\nconst DEFAULT_MAX_PATHS = 5;\n/** Default expansion-safety bound for bounded path enumeration. */\nconst DEFAULT_MAX_VISITED_PATHS = 10_000;\n/** Default depth bound applied to bounded path enumeration. */\nconst DEFAULT_PATH_MAX_DEPTH = 8;\n\n/** Require a finite non-negative integer for one path-enumeration bound. */\nfunction assertPathBound(name: string, value: number): void {\n  if (!Number.isFinite(value) || !Number.isInteger(value) || value < 0)\n    throw new TypeError(`Invalid path ${name} bound: ${String(value)}`);\n}\n\n/** Endpoint of a hierarchy edge that represents the structural parent. */\nexport function hierarchyParentEndpoint(\n  edge: RelationshipEdge,\n  definition: RelationshipKindDefinition,\n): string {\n  // Custom hierarchy kinds may omit the direction; the registry documents the\n  // source endpoint as the default parent.\n  return definition.hierarchyDirection === \"target_parent\"\n    ? edge.target\n    : edge.source;\n}\n\n/** Endpoint of an ordering edge that must finish first. */\nexport function orderingPredecessorEndpoint(\n  edge: RelationshipEdge,\n  definition: RelationshipKindDefinition,\n): string {\n  // Ordering kinds registered without explicit precedence default to\n  // source-before-target, matching the execution-analytics interpretation.\n  return (definition.precedence ?? \"source_before_target\") ===\n    \"target_before_source\"\n    ? edge.target\n    : edge.source;\n}\n\n/** Validate optional kind filters against one semantic edge family. */\nfunction resolveFamilyKinds(\n  graph: RelationshipGraph,\n  kinds: readonly string[] | undefined,\n  family: \"hierarchy\" | \"ordering\",\n): Set<string> | undefined {\n  if (kinds === undefined) return undefined;\n  const registry = graph.registry();\n  const resolved = new Set<string>();\n  for (const kind of kinds) {\n    const definition = registry.require(kind);\n    if (!definition[family])\n      throw new TypeError(\n        `Relationship kind ${definition.kind} is not a ${family} kind`,\n      );\n    resolved.add(definition.kind);\n  }\n  return resolved;\n}\n\n/** Predicate deciding whether a neighbor row participates in one semantic walk. */\ntype SemanticNeighborPredicate = (\n  row: RelationshipNeighborEdge,\n  definition: RelationshipKindDefinition,\n  nodeId: string,\n) => boolean;\n\n/** Mutable state for one bounded semantic breadth-first walk. */\ninterface SemanticWalkState {\n  /** Nodes already discovered during the walk. */\n  seen: Set<string>;\n  /** Nodes emitted for the current page. */\n  value: string[];\n  /** Pending breadth-first nodes and their depths. */\n  queue: { id: string; depth: number }[];\n  /** Whether the optional cursor has been reached. */\n  resumed: boolean;\n  /** Whether a configured bound omitted reachable work. */\n  truncated: boolean;\n}\n\n/** Mutable state for bounded simple-path enumeration. */\ninterface PathEnumerationState {\n  /** Completed source-to-target paths. */\n  value: RelationshipPath[];\n  /** Partial simple paths pending expansion. */\n  queue: { nodes: string[]; nodeSet: Set<string>; edges: RelationshipEdge[] }[];\n  /** Total graph edges inspected by neighbor queries. */\n  inspectedEdges: number;\n}\n\n/** Expand one node into its deterministic semantic neighbors. */\nfunction expandSemanticNeighbors(\n  graph: RelationshipGraph,\n  nodeId: string,\n  familyKinds: Set<string> | undefined,\n  family: \"hierarchy\" | \"ordering\",\n  matches: SemanticNeighborPredicate,\n): { neighbors: string[]; inspectedEdges: number } {\n  const registry = graph.registry();\n  const rows = graph.neighborEdges(nodeId, {\n    direction: \"both\",\n    ...(familyKinds === undefined ? {} : { kinds: [...familyKinds] }),\n  });\n  const neighbors: string[] = [];\n  const seen = new Set<string>();\n  for (const row of rows.value) {\n    const definition = registry.require(row.edge.kind);\n    if (!definition[family]) continue;\n    if (!matches(row, definition, nodeId)) continue;\n    if (seen.has(row.id)) continue;\n    seen.add(row.id);\n    neighbors.push(row.id);\n  }\n  return { neighbors, inspectedEdges: rows.meta.inspectedEdges };\n}\n\n/** Append one semantic expansion and report whether the page limit was reached. */\nfunction appendSemanticExpansion(\n  expansion: { neighbors: string[] },\n  currentDepth: number,\n  maxDepth: number,\n  limit: number,\n  after: string | undefined,\n  state: SemanticWalkState,\n): boolean {\n  if (currentDepth >= maxDepth) {\n    if (expansion.neighbors.some((neighbor) => !state.seen.has(neighbor)))\n      state.truncated = true;\n    return false;\n  }\n  for (const neighbor of expansion.neighbors) {\n    if (state.seen.has(neighbor)) continue;\n    state.seen.add(neighbor);\n    state.queue.push({ id: neighbor, depth: currentDepth + 1 });\n    if (!state.resumed) {\n      if (neighbor === after) state.resumed = true;\n      continue;\n    }\n    if (state.value.length >= limit) {\n      state.truncated = true;\n      return true;\n    }\n    state.value.push(neighbor);\n  }\n  return false;\n}\n\n/** Run one deterministic bounded breadth-first semantic walk. */\nfunction boundedSemanticWalk(\n  graph: RelationshipGraph,\n  start: string,\n  options: GraphTraversalOptions,\n  family: \"hierarchy\" | \"ordering\",\n  matches: SemanticNeighborPredicate,\n): RelationshipQueryResult<string[]> {\n  if (!graph.hasNode(start))\n    throw new TypeError(`Relationship node not found: ${start}`);\n  const familyKinds = resolveFamilyKinds(graph, options.kinds, family);\n  const limit = options.limit ?? Number.POSITIVE_INFINITY;\n  const maxDepth = options.maxDepth ?? Number.POSITIVE_INFINITY;\n  const after = options.after;\n  const state: SemanticWalkState = {\n    seen: new Set([start]),\n    value: [],\n    queue: [{ id: start, depth: 0 }],\n    resumed: after === undefined,\n    truncated: false,\n  };\n  let visitedNodes = 0;\n  let inspectedEdges = 0;\n  for (let index = 0; index < state.queue.length; index += 1) {\n    options.signal?.throwIfAborted();\n    const current = state.queue[index]!;\n    visitedNodes += 1;\n    const expansion = expandSemanticNeighbors(\n      graph,\n      current.id,\n      familyKinds,\n      family,\n      matches,\n    );\n    inspectedEdges += expansion.inspectedEdges;\n    if (\n      appendSemanticExpansion(\n        expansion,\n        current.depth,\n        maxDepth,\n        limit,\n        after,\n        state,\n      )\n    )\n      break;\n  }\n  if (!state.resumed)\n    throw new TypeError(`Traversal cursor not found in sequence: ${after}`);\n  return {\n    value: state.value,\n    meta: {\n      visitedNodes,\n      inspectedEdges,\n      truncated: state.truncated,\n      nextCursor: state.value.at(-1),\n    },\n  };\n}\n/** Validate one path endpoint against the indexed graph. */\nfunction assertPathEndpoint(graph: RelationshipGraph, id: string): void {\n  if (!graph.hasNode(id))\n    throw new TypeError(`Relationship node not found: ${id}`);\n}\n\n/** Return eligible simple-path continuations and account for inspected edges. */\nfunction readPathContinuations(\n  graph: RelationshipGraph,\n  partial: { nodes: string[]; nodeSet: Set<string>; edges: RelationshipEdge[] },\n  options: GraphPathOptions,\n  direction: \"outgoing\" | \"incoming\" | \"both\",\n  state: PathEnumerationState,\n): ReturnType<RelationshipGraph[\"neighborEdges\"]>[\"value\"] {\n  const rows = graph.neighborEdges(partial.nodes.at(-1)!, {\n    direction,\n    ...(options.kinds === undefined ? {} : { kinds: options.kinds }),\n  });\n  state.inspectedEdges += rows.meta.inspectedEdges;\n  return rows.value.filter((row) => !partial.nodeSet.has(row.id));\n}\n\n/** Expand one partial simple path and report whether the probe cap was reached. */\nfunction expandPartialPath(\n  graph: RelationshipGraph,\n  partial: { nodes: string[]; nodeSet: Set<string>; edges: RelationshipEdge[] },\n  target: string,\n  options: GraphPathOptions,\n  direction: \"outgoing\" | \"incoming\" | \"both\",\n  probeLimit: number,\n  state: PathEnumerationState,\n): boolean {\n  for (const row of readPathContinuations(\n    graph,\n    partial,\n    options,\n    direction,\n    state,\n  )) {\n    const nodes = [...partial.nodes, row.id];\n    const nodeSet = new Set(partial.nodeSet).add(row.id);\n    const edges = [...partial.edges, row.edge];\n    if (row.id === target) {\n      state.value.push({ nodes, edges, length: edges.length });\n      if (state.value.length >= probeLimit) return true;\n    } else {\n      state.queue.push({ nodes, nodeSet, edges });\n    }\n  }\n  return false;\n}\n\n/**\n * Return the bounded transitive hierarchy ancestors of one node in\n * breadth-first discovery order, honoring each hierarchy kind's declared\n * parent endpoint (so `parent` and inverse `child` spellings agree).\n */\nexport function hierarchyAncestors(\n  graph: RelationshipGraph,\n  id: string,\n  options: GraphTraversalOptions = {},\n): RelationshipQueryResult<string[]> {\n  return boundedSemanticWalk(\n    graph,\n    id,\n    options,\n    \"hierarchy\",\n    (row, definition) =>\n      hierarchyParentEndpoint(row.edge, definition) === row.id,\n  );\n}\n\n/**\n * Return the bounded transitive hierarchy descendants of one node in\n * breadth-first discovery order, honoring each hierarchy kind's declared\n * parent endpoint.\n */\nexport function hierarchyDescendants(\n  graph: RelationshipGraph,\n  id: string,\n  options: GraphTraversalOptions = {},\n): RelationshipQueryResult<string[]> {\n  return boundedSemanticWalk(\n    graph,\n    id,\n    options,\n    \"hierarchy\",\n    (row, definition, nodeId) =>\n      hierarchyParentEndpoint(row.edge, definition) === nodeId,\n  );\n}\n\n/**\n * Return the bounded transitive execution predecessors of one node — the work\n * that must finish before it — in breadth-first discovery order, honoring each\n * ordering kind's declared precedence (so `blocked_by` and inverse `blocks`\n * spellings agree).\n */\nexport function orderingPredecessors(\n  graph: RelationshipGraph,\n  id: string,\n  options: GraphTraversalOptions = {},\n): RelationshipQueryResult<string[]> {\n  return boundedSemanticWalk(\n    graph,\n    id,\n    options,\n    \"ordering\",\n    (row, definition) =>\n      orderingPredecessorEndpoint(row.edge, definition) === row.id,\n  );\n}\n\n/**\n * Return the bounded transitive execution successors of one node — the work\n * this node gates — in breadth-first discovery order, honoring each ordering\n * kind's declared precedence.\n */\nexport function orderingSuccessors(\n  graph: RelationshipGraph,\n  id: string,\n  options: GraphTraversalOptions = {},\n): RelationshipQueryResult<string[]> {\n  return boundedSemanticWalk(\n    graph,\n    id,\n    options,\n    \"ordering\",\n    (row, definition, nodeId) =>\n      orderingPredecessorEndpoint(row.edge, definition) === nodeId,\n  );\n}\n\n/** Run bounded non-zero path enumeration after public option validation. */\nfunction enumerateNonZeroRelationshipPaths(\n  graph: RelationshipGraph,\n  source: string,\n  target: string,\n  options: GraphPathOptions,\n  maxPaths: number,\n  maxVisitedPaths: number,\n  maxDepth: number,\n  direction: \"outgoing\" | \"incoming\" | \"both\",\n): RelationshipQueryResult<RelationshipPath[]> {\n  const state: PathEnumerationState = {\n    value: [],\n    queue: [{ nodes: [source], nodeSet: new Set([source]), edges: [] }],\n    inspectedEdges: 0,\n  };\n  let visitedNodes = 0;\n  let truncated = false;\n  const probeLimit = maxPaths + 1;\n  for (let index = 0; index < state.queue.length; index += 1) {\n    options.signal?.throwIfAborted();\n    if (state.value.length >= probeLimit || visitedNodes >= maxVisitedPaths) {\n      truncated = true;\n      break;\n    }\n    const partial = state.queue[index]!;\n    visitedNodes += 1;\n    if (partial.edges.length >= maxDepth) {\n      if (\n        readPathContinuations(graph, partial, options, direction, state)\n          .length > 0\n      )\n        truncated = true;\n      continue;\n    }\n    if (\n      expandPartialPath(\n        graph,\n        partial,\n        target,\n        options,\n        direction,\n        probeLimit,\n        state,\n      )\n    ) {\n      truncated = true;\n      break;\n    }\n  }\n  return {\n    value: state.value.slice(0, maxPaths),\n    meta: { visitedNodes, inspectedEdges: state.inspectedEdges, truncated },\n  };\n}\n\n/**\n * Enumerate bounded simple paths between two nodes, shortest first and\n * lexicographic within equal length. Traversal honors direction and kind\n * filters, caps returned paths, and reports truncation when depth, path-count,\n * or the expansion-safety bound stops the search early.\n */\nexport function enumerateRelationshipPaths(\n  graph: RelationshipGraph,\n  source: string,\n  target: string,\n  options: GraphPathOptions = {},\n): RelationshipQueryResult<RelationshipPath[]> {\n  assertPathEndpoint(graph, source);\n  assertPathEndpoint(graph, target);\n  const maxPaths = options.maxPaths ?? DEFAULT_MAX_PATHS;\n  const maxVisitedPaths = options.maxVisitedPaths ?? DEFAULT_MAX_VISITED_PATHS;\n  const maxDepth = options.maxDepth ?? DEFAULT_PATH_MAX_DEPTH;\n  assertPathBound(\"maxPaths\", maxPaths);\n  assertPathBound(\"maxVisitedPaths\", maxVisitedPaths);\n  assertPathBound(\"maxDepth\", maxDepth);\n  const direction = options.direction ?? \"outgoing\";\n  options.signal?.throwIfAborted();\n  for (const kind of options.kinds ?? []) graph.registry().require(kind);\n  if (source === target) {\n    if (maxPaths === 0) {\n      return {\n        value: [],\n        meta: { visitedNodes: 1, inspectedEdges: 0, truncated: true },\n      };\n    }\n    return {\n      value: [{ nodes: [source], edges: [], length: 0 }],\n      meta: { visitedNodes: 1, inspectedEdges: 0, truncated: false },\n    };\n  }\n  return enumerateNonZeroRelationshipPaths(\n    graph,\n    source,\n    target,\n    options,\n    maxPaths,\n    maxVisitedPaths,\n    maxDepth,\n    direction,\n  );\n}\n"],"names":[],"mappings":"AAuDA,oEAAoE;;;AACpE,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,mEAAmE;AACnE,MAAM,yBAAyB,GAAG,MAAM,CAAC;AACzC,+DAA+D;AAC/D,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAEjC,4EAA4E;AAC5E,SAAS,eAAe,CAAC,IAAY,EAAE,KAAa;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAClE,MAAM,IAAI,SAAS,CAAC,gBAAgB,IAAI,WAAW,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,uBAAuB,CACrC,IAAsB,EACtB,UAAsC;IAEtC,4EAA4E;IAC5E,yCAAyC;IACzC,OAAO,UAAU,CAAC,kBAAkB,KAAK,eAAe;QACtD,CAAC,CAAC,IAAI,CAAC,MAAM;QACb,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;AAClB,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,2BAA2B,CACzC,IAAsB,EACtB,UAAsC;IAEtC,mEAAmE;IACnE,yEAAyE;IACzE,OAAO,CAAC,UAAU,CAAC,UAAU,IAAI,sBAAsB,CAAC;QACtD,sBAAsB;QACtB,CAAC,CAAC,IAAI,CAAC,MAAM;QACb,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;AAClB,CAAC;AAED,uEAAuE;AACvE,SAAS,kBAAkB,CACzB,KAAwB,EACxB,KAAoC,EACpC,MAAgC;IAEhC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YACrB,MAAM,IAAI,SAAS,CACjB,qBAAqB,UAAU,CAAC,IAAI,aAAa,MAAM,OAAO,CAC/D,CAAC;QACJ,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAiCD,iEAAiE;AACjE,SAAS,uBAAuB,CAC9B,KAAwB,EACxB,MAAc,EACd,WAAoC,EACpC,MAAgC,EAChC,OAAkC;IAElC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,MAAM,EAAE;QACvC,SAAS,EAAE,MAAM;QACjB,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC;KAClE,CAAC,CAAC;IACH,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,SAAS;QAClC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC;YAAE,SAAS;QAChD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC/B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjB,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;AACjE,CAAC;AAED,mFAAmF;AACnF,SAAS,uBAAuB,CAC9B,SAAkC,EAClC,YAAoB,EACpB,QAAgB,EAChB,KAAa,EACb,KAAyB,EACzB,KAAwB;IAExB,IAAI,YAAY,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACnE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;QACzB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,SAAS;QACvC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,QAAQ,KAAK,KAAK;gBAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YAC7C,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YAChC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iEAAiE;AACjE,SAAS,mBAAmB,CAC1B,KAAwB,EACxB,KAAa,EACb,OAA8B,EAC9B,MAAgC,EAChC,OAAkC;IAElC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACvB,MAAM,IAAI,SAAS,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,iBAAiB,CAAC;IACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,iBAAiB,CAAC;IAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAC5B,MAAM,KAAK,GAAsB;QAC/B,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACtB,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,KAAK,KAAK,SAAS;QAC5B,SAAS,EAAE,KAAK;KACjB,CAAC;IACF,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3D,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC;QACpC,YAAY,IAAI,CAAC,CAAC;QAClB,MAAM,SAAS,GAAG,uBAAuB,CACvC,KAAK,EACL,OAAO,CAAC,EAAE,EACV,WAAW,EACX,MAAM,EACN,OAAO,CACR,CAAC;QACF,cAAc,IAAI,SAAS,CAAC,cAAc,CAAC;QAC3C,IACE,uBAAuB,CACrB,SAAS,EACT,OAAO,CAAC,KAAK,EACb,QAAQ,EACR,KAAK,EACL,KAAK,EACL,KAAK,CACN;YAED,MAAM;IACV,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO;QAChB,MAAM,IAAI,SAAS,CAAC,2CAA2C,KAAK,EAAE,CAAC,CAAC;IAC1E,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE;YACJ,YAAY;YACZ,cAAc;YACd,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SAC/B;KACF,CAAC;AACJ,CAAC;AACD,4DAA4D;AAC5D,SAAS,kBAAkB,CAAC,KAAwB,EAAE,EAAU;IAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,SAAS,CAAC,gCAAgC,EAAE,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,iFAAiF;AACjF,SAAS,qBAAqB,CAC5B,KAAwB,EACxB,OAA6E,EAC7E,OAAyB,EACzB,SAA2C,EAC3C,KAA2B;IAE3B,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE;QACtD,SAAS;QACT,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;KACjE,CAAC,CAAC;IACH,KAAK,CAAC,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC;IACjD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,mFAAmF;AACnF,SAAS,iBAAiB,CACxB,KAAwB,EACxB,OAA6E,EAC7E,MAAc,EACd,OAAyB,EACzB,SAA2C,EAC3C,UAAkB,EAClB,KAA2B;IAE3B,KAAK,MAAM,GAAG,IAAI,qBAAqB,CACrC,KAAK,EACL,OAAO,EACP,OAAO,EACP,SAAS,EACT,KAAK,CACN,EAAE,CAAC;QACF,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,GAAG,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;YACtB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACzD,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,UAAU;gBAAE,OAAO,IAAI,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAwB,EACxB,EAAU,EACV,UAAiC,EAAE;IAEnC,OAAO,mBAAmB,CACxB,KAAK,EACL,EAAE,EACF,OAAO,EACP,WAAW,EACX,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,CAClB,uBAAuB,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAC3D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAwB,EACxB,EAAU,EACV,UAAiC,EAAE;IAEnC,OAAO,mBAAmB,CACxB,KAAK,EACL,EAAE,EACF,OAAO,EACP,WAAW,EACX,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,CAC1B,uBAAuB,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,MAAM,CAC3D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAwB,EACxB,EAAU,EACV,UAAiC,EAAE;IAEnC,OAAO,mBAAmB,CACxB,KAAK,EACL,EAAE,EACF,OAAO,EACP,UAAU,EACV,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,CAClB,2BAA2B,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAC/D,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAwB,EACxB,EAAU,EACV,UAAiC,EAAE;IAEnC,OAAO,mBAAmB,CACxB,KAAK,EACL,EAAE,EACF,OAAO,EACP,UAAU,EACV,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,CAC1B,2BAA2B,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,KAAK,MAAM,CAC/D,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,SAAS,iCAAiC,CACxC,KAAwB,EACxB,MAAc,EACd,MAAc,EACd,OAAyB,EACzB,QAAgB,EAChB,eAAuB,EACvB,QAAgB,EAChB,SAA2C;IAE3C,MAAM,KAAK,GAAyB;QAClC,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACnE,cAAc,EAAE,CAAC;KAClB,CAAC;IACF,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,MAAM,UAAU,GAAG,QAAQ,GAAG,CAAC,CAAC;IAChC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3D,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,UAAU,IAAI,YAAY,IAAI,eAAe,EAAE,CAAC;YACxE,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACR,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC;QACpC,YAAY,IAAI,CAAC,CAAC;QAClB,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;YACrC,IACE,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC;iBAC7D,MAAM,GAAG,CAAC;gBAEb,SAAS,GAAG,IAAI,CAAC;YACnB,SAAS;QACX,CAAC;QACD,IACE,iBAAiB,CACf,KAAK,EACL,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,EACT,UAAU,EACV,KAAK,CACN,EACD,CAAC;YACD,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC;QACrC,IAAI,EAAE,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,EAAE,SAAS,EAAE;KACxE,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAwB,EACxB,MAAc,EACd,MAAc,EACd,UAA4B,EAAE;IAE9B,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAClC,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAC;IACvD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,yBAAyB,CAAC;IAC7E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,sBAAsB,CAAC;IAC5D,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtC,eAAe,CAAC,iBAAiB,EAAE,eAAe,CAAC,CAAC;IACpD,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC;IAClD,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,IAAI,EAAE;QAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO;gBACL,KAAK,EAAE,EAAE;gBACT,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE;aAC9D,CAAC;QACJ,CAAC;QACD,OAAO;YACL,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YAClD,IAAI,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE;SAC/D,CAAC;IACJ,CAAC;IACD,OAAO,iCAAiC,CACtC,KAAK,EACL,MAAM,EACN,MAAM,EACN,OAAO,EACP,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,SAAS,CACV,CAAC;AACJ,CAAC","debugId":"ed9f0831-6011-5ee2-abd6-72375eac0a3a"}

package/dist/sdk/index.d.ts

@@ -6,10 +6,13 @@
 export { isErrnoError, limitAnnotationEntries, parseAnnotationTextInput, readAnnotationEntries, resolveAnnotationInput, resolveAnnotationIndex, runAnnotationCommand, wrapOwnershipConflict, type AnnotationCommandConfig, type AnnotationCommandOptions, type AnnotationCommandResult, type AnnotationEntry, type AnnotationInput, type AnnotationSourceOptions, type OwnershipConflictGuidance, } from "./annotations.js";
 export { inspectHistoryAuthorStream, scanHistoryAuthorAttribution, type HistoryAuthorAttributionScan, type UnknownAuthorHistoryEvent, } from "./author-attribution.js";
 export { createPmCliProgram } from "./cli-program.js";
+export { runSearchRefreshWorkerEntrypoint } from "./search-refresh-worker.js";
+export { flushTelemetryQueue } from "./telemetry-flush.js";
+export { EXECUTABLE_COMMAND_ALIASES, applyBootstrapPagerPolicy, coalesceRepeatedListFlags, listAliasPluralKeys, mergeLinkedTestTwoTokenEntries, normalizeBootstrapInvocation, normalizeLegacyExtensionActionSyntax, parseBootstrapCommandName, parseBootstrapGlobalOptions, parseBootstrapHelpRequest, parseBootstrapTypeValue, stripGlobalBootstrapTokens, type BootstrapGlobalOptions, type BootstrapHelpRequest, type BootstrapInvocationNormalizationResult, type BootstrapNormalizationEvent, } from "./cli-bootstrap.js";
 export { quoteCommandArg, quoteWindowsCommandArg, renderPmCommand, } from "./command-line.js";
-export * from "./governance/gc.js";
-export * from "./governance/health.js";
-export * from "./governance/validate.js";
+export { runGc, type GcCheckpointsSummary, type GcLocksSummary, } from "./governance/gc.js";
+export { _testOnlyHealthCommand, runHealth, type HealthCheck, } from "./governance/health.js";
+export { _testOnlyValidateCommand, runValidate, type ValidateCheck, type ValidateFixesSummary, type ValidateMutationServices, } from "./governance/validate.js";
 export { runExtension } from "./extension.js";
 export { applyInvocationAuthorOverride } from "./invocation-author.js";
 export { _testOnly as _testOnlyTemplates, type TemplateSource, } from "./templates.js";
@@ -33,20 +36,31 @@ export * from "./history-redact.js";
 export * from "./history-repair.js";
 export * from "./item-children.js";
 export * from "./item-schedule.js";
-export { collectDanglingDependencyReferences, runDeps, type DanglingDependencyReference, type DanglingDependencyReferenceSummary, type DependencyReferenceHolder, type DepsCollapseMode, type DepsFormat, type DepsGraphEdge, type DepsGraphNode, type DepsGraphResult, type DepsTreeNode, } from "./dependencies.js";
+export { runDeps, type DepsCollapseMode, type DepsFormat, type DepsGraphEdge, type DepsGraphNode, type DepsGraphResult, type DepsTreeNode, } from "./dependencies.js";
+export * from "./graph/index.js";
 export { runDocs } from "./docs.js";
 export { runFiles, runFilesDiscover, type FilesDiscoveryCandidate, } from "./files.js";
 export { applyPathMigrations, applyStandaloneNote, artifactKey, dedupeLinkedArtifacts, ensureScope, expandAddGlobEntries, normalizeLinkedPath, parseAddEntries, parseAddGlobEntries, parseMigrateEntries, parseRemoveEntries, renameArtifactsResultKey, runLinkedArtifacts, sortLinkedArtifacts, validateLinkedPaths, type AddGlobEntry, type LinkedArtifact, type LinkedArtifactCommandOptions, type LinkedArtifactKindConfig, type LinkedArtifactResult, type LinkedPathValidation, type PathMigration, } from "./linked-artifacts.js";
 export * from "./pagination.js";
+export * from "./query/item-filter-options.js";
+export * from "./query/parsers.js";
 export * from "./output.js";
 export * from "./relationship-analytics.js";
 export * from "./relationship-context.js";
 export * from "./relationship-history.js";
 export * from "./relationships.js";
+export * from "./actionability.js";
 export type { PlanCommandOptions, PlanCommandResult, PlanDispatchInput, PlanResultPlan, PlanShowDepth, PlanStepSummary, PlanSubcommand, PlanTemplateName, } from "../cli/commands/plan.js";
 export { PLAN_SHOW_DEPTH_VALUES, PLAN_SUBCOMMANDS, PLAN_TEMPLATE_NAMES, } from "../cli/commands/plan.js";
 export * from "./define.js";
-export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, acquireLock, appendHistoryEntry, canonicalDocument, classifyItemFormatVersion, clearWorkspaceContractsCache, commitImportedItem, createHistoryEntry, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, ensureTrackerInitialized, generateItemId, getActiveExtensionRegistrations, getContracts, getHistoryPath, getItemPath, getSettingsPath, getWorkspaceContracts, isPmCliExpectedError, isTimestampLiteral, listAllItemMetadata, loadCreateTemplateOptions, locateItem, normalizeItemMetadata, normalizeItemFormatVersion, normalizeItemId, normalizeRawItemId, normalizeStatusInput, nowIso, parseTags, pathExists, readBooleanOption, readCsvListOption, readFileIfExists, readLocatedItem, readRequiredString, readSettings, readStringOption, removeFileIfExists, renderCalendarMarkdown, renderCalendarToon, renderGuideMarkdown, resolveCalendarOutputFormat, resolveGuideOutputFormat, resolveItemTypeRegistry, resolvePmRoot, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, runAction, runActiveOnReadHooks, runActiveOnWriteHooks, runCalendar, runCompletion, runGuide, runReindex, runSearch, runTemplatesList, runTemplatesSave, runTemplatesShow, runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, scanItemFormatVersions, selectImportAuthor, serializeItemDocument, splitFrontMatter, toEstimatedMinutesValue, toImportBoolean, toImportConfidence, toImportInteger, toImportLinkedDocs, toImportLinkedFiles, toImportLinkedTests, toImportLogEntries, toImportNormalizedEnum, toImportNumberMap, toImportPriority, toImportStatus, toImportStringList, toImportStringMap, toImportTags, toNonEmptyImportString, writeFileAtomic, aggregate, append, claim, claimNext, close, closeTask, comments, config, context, copy, create, deleteItem, deps, docs, extension, extensionActivate, extensionDeactivate, extensionList, files, filesDiscover, focus, gc, get, health, historyCompact, historyCompactBulk, historyRedact, historyRepair, historyRepairAll, init, learnings, list, next, notes, packageActivate, packageCatalog, packageDeactivate, packageDescribe, packageDoctor, packageInstall, packageLifecycle, packageList, packageManage, packageReload, packageUninstall, pauseTask, profile, profileApply, profileLint, profileList, profileShow, release, restore, schema, schemaAddField, schemaAddStatus, schemaAddType, schemaApplyPreset, schemaInferTypes, schemaList, schemaListFields, schemaRemoveField, schemaRemoveStatus, schemaRemoveType, schemaShow, schemaShowField, schemaShowStatus, search, startTask, stats, update, upgrade, validate, type AggregateOptions, type AggregateResult, type AggregateRow, type AppendCommandOptions, type AppendResult, type BlockerEntry, type CalendarOptions, type CalendarResult, type ClaimResult, type CloseResult, type CloseTaskResult, type CommitImportedItemParams, type CommitImportedItemResult, type CommentsCommandOptions, type CommentsResult, type ConfigCommandOptions, type ConfigResult, type CompletionResult, type CompletionShell, type ContractsCommandOptions, type ContractsResult, type ContextFocusItem, type ContextOptions, type ContextOutputFormat, type ContextResult, type CopyResult, type CreatePmCliExpectedErrorOptions, type CreateResult, type CreateTemplateOptions, type Dependency, type DeleteResult, type DepsCommandOptions, type DepsResult, type DocsCommandOptions, type DocsResult, type ExtensionCommandOptions, type ExtensionCommandResult, type FilesCommandOptions, type FilesDiscoverOptions, type FilesDiscoverResult, type FilesResult, type FocusResult, type GcCommandOptions, type GcResult, type GetContractsOptions, type GetOptions, type GetResult, type GuideDepth, type GuideOptions, type GuideOutputFormat, type GuideResult, type HealthResult, type ImportLinkedScope, type InitCommandOptions, type InitResult, type ItemFormatVersionScanEntry, type ItemFormatVersionScanResult, type ItemFormatVersionStatus, type LearningsCommandOptions, type LearningsResult, type LinkedDoc, type LinkedFile, type LinkedTest, type ListedItem, type ListCompactResult, type ListOptions, type ListResult, type ListSortField, type ListSortOrder, type ListVerboseResult, type LogNote, type NextActionableItem, type NextBlockerRef, type NextOptions, type NextOutputFormat, type NextRecommendation, type NextResult, type NotesCommandOptions, type NotesResult, type PackageCommandOptions, type PackageCommandResult, type PauseTaskResult, type PmActionInput, type PmActionName, type PmActionOptions, type PmClientFullMutationOptions, type PmClientMutationOptions, type PmClientOptions, type PmClientRunArgs, type PmCliExpectedError, type ProfileApplyCommandOptions, type ProfileApplyResult, type ProfileLintResult, type ProfileListResult, type ProfileResult, type ProfileShowResult, type ProfileSubcommand, type ReindexOptions, type ReindexResult, type ReleaseResult, type RestoreResult, type RunHealthOptions, type SchemaAddFieldCommandOptions, type SchemaAddFieldResult, type SchemaAddStatusCommandOptions, type SchemaAddStatusResult, type SchemaAddTypeCommandOptions, type SchemaAddTypeInferCommandOptions, type SchemaAddTypeInferResult, type SchemaAddTypeResult, type SchemaApplyPresetCommandOptions, type SchemaApplyPresetResult, type SchemaInspectResult, type SchemaListFieldsResult, type SchemaListResult, type SchemaRemoveFieldCommandOptions, type SchemaRemoveFieldResult, type SchemaRemoveStatusCommandOptions, type SchemaRemoveStatusResult, type SchemaRemoveTypeCommandOptions, type SchemaRemoveTypeResult, type SchemaShowFieldResult, type SchemaShowResult, type SchemaShowStatusResult, type SchemaResult, type SchemaSubcommand, type SearchCompactResult, type SearchHit, type SearchHitHighlight, type SearchMatchMode, type SearchOptions, type ClaimNextOptions, type SearchResult, type SearchResultItem, type SearchVerboseResult, type StartTaskResult, type StatsCommandOptions, type StatsResult, type TemplatesListResult, type TemplatesSaveResult, type TemplatesShowResult, type TestRunsListCommandOptions, type TestRunsLogsCommandOptions, type TestRunsResumeCommandOptions, type TestRunsStopCommandOptions, type ToImportLinkedArtifactsOptions, type ToImportLinkedTestsOptions, type ToImportLogEntriesOptions, type UpdateResult, type UpgradeCommandOptions, type UpgradeResult, type ValidateCommandOptions, type ValidateResult, type WorkspaceContracts, type WorkspaceContractsOptions, } from "./runtime.js";
+export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, acquireLock, appendHistoryEntry, canonicalDocument, classifyItemFormatVersion, clearWorkspaceContractsCache, commitImportedItem, createHistoryEntry, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, ensureTrackerInitialized, generateItemId, getActiveExtensionRegistrations, getContracts, getHistoryPath, getItemPath, getSettingsPath, getWorkspaceContracts, isPmCliExpectedError, isTimestampLiteral, listAllItemMetadata, loadCreateTemplateOptions, locateItem, normalizeItemMetadata, normalizeItemFormatVersion, normalizeItemId, normalizeRawItemId, normalizeStatusInput, nowIso, parseTags, pathExists, readBooleanOption, readCsvListOption, readFileIfExists, readLocatedItem, readRequiredString, readSettings, readStringOption, removeFileIfExists, renderCalendarMarkdown, renderCalendarToon, renderGuideMarkdown, resolveCalendarOutputFormat, resolveGuideOutputFormat, resolveItemTypeRegistry, resolvePmRoot, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, runAction, runActiveOnReadHooks, runActiveOnWriteHooks, runCalendar, runCompletion, runGuide, runList, runReindex, runSearch, runTemplatesList, runTemplatesSave, runTemplatesShow, runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, scanItemFormatVersions, selectImportAuthor, serializeItemDocument, splitFrontMatter, toEstimatedMinutesValue, toImportBoolean, toImportConfidence, toImportInteger, toImportLinkedDocs, toImportLinkedFiles, toImportLinkedTests, toImportLogEntries, toImportNormalizedEnum, toImportNumberMap, toImportPriority, toImportStatus, toImportStringList, toImportStringMap, toImportTags, toNonEmptyImportString, writeFileAtomic, aggregate, append, claim, claimNext, close, closeTask, comments, config, context, copy, create, deleteItem, deps, docs, extension, extensionActivate, extensionDeactivate, extensionList, files, filesDiscover, focus, gc, get, graph, health, historyCompact, historyCompactBulk, historyRedact, historyRepair, historyRepairAll, init, learnings, list, next, notes, packageActivate, packageCatalog, packageDeactivate, packageDescribe, packageDoctor, packageInstall, packageLifecycle, packageList, packageManage, packageReload, packageUninstall, pauseTask, profile, profileApply, profileLint, profileList, profileShow, release, restore, schema, schemaAddField, schemaAddStatus, schemaAddType, schemaApplyPreset, schemaInferTypes, schemaList, schemaListFields, schemaRemoveField, schemaRemoveStatus, schemaRemoveType, schemaShow, schemaShowField, schemaShowStatus, search, startTask, stats, update, upgrade, validate, type AggregateOptions, type AggregateResult, type AggregateRow, type AppendCommandOptions, type AppendResult, type BlockerEntry, type CalendarOptions, type CalendarResult, type ClaimResult, type CloseResult, type CloseTaskResult, type CommitImportedItemParams, type CommitImportedItemResult, type CommentsCommandOptions, type CommentsResult, type ConfigCommandOptions, type ConfigResult, type CompletionResult, type CompletionShell, type ContractsCommandOptions, type ContractsResult, type ContextFocusItem, type ContextOptions, type ContextOutputFormat, type ContextResult, type CopyResult, type CreatePmCliExpectedErrorOptions, type CreateResult, type CreateTemplateOptions, type Dependency, type DeleteResult, type DepsCommandOptions, type DepsResult, type DocsCommandOptions, type DocsResult, type ExtensionCommandOptions, type ExtensionCommandResult, type FilesCommandOptions, type FilesDiscoverOptions, type FilesDiscoverResult, type FilesResult, type FocusResult, type GcCommandOptions, type GcResult, type GetContractsOptions, type GetOptions, type GetResult, type GuideDepth, type GuideOptions, type GuideOutputFormat, type GuideResult, type HealthResult, type ImportLinkedScope, type InitCommandOptions, type InitResult, type ItemFormatVersionScanEntry, type ItemFormatVersionScanResult, type ItemFormatVersionStatus, type LearningsCommandOptions, type LearningsResult, type LinkedDoc, type LinkedFile, type LinkedTest, type ListedItem, type ListCompactResult, type ListFullResult, type ListOptions, type ListProjectedItem, type ListResult, type ListResultItem, type ListSortField, type ListSortOrder, type ListTreeItem, type ListTreeMetadata, type ListVerboseResult, type LogNote, type NextActionableItem, type NextBlockerRef, type NextOptions, type NextOutputFormat, type NextRecommendation, type NextResult, type NotesCommandOptions, type NotesResult, type PackageCommandOptions, type PackageCommandResult, type PauseTaskResult, type PmActionInput, type PmActionName, type PmActionOptions, type PmClientFullMutationOptions, type PmClientMutationOptions, type PmClientOptions, type PmClientRunArgs, type PmCliExpectedError, type ProfileApplyCommandOptions, type ProfileApplyResult, type ProfileLintResult, type ProfileListResult, type ProfileResult, type ProfileShowResult, type ProfileSubcommand, type ReindexOptions, type ReindexResult, type ReleaseResult, type RestoreResult, type RunHealthOptions, type SchemaAddFieldCommandOptions, type SchemaAddFieldResult, type SchemaAddStatusCommandOptions, type SchemaAddStatusResult, type SchemaAddTypeCommandOptions, type SchemaAddTypeInferCommandOptions, type SchemaAddTypeInferResult, type SchemaAddTypeResult, type SchemaApplyPresetCommandOptions, type SchemaApplyPresetResult, type SchemaInspectResult, type SchemaListFieldsResult, type SchemaListResult, type SchemaRemoveFieldCommandOptions, type SchemaRemoveFieldResult, type SchemaRemoveStatusCommandOptions, type SchemaRemoveStatusResult, type SchemaRemoveTypeCommandOptions, type SchemaRemoveTypeResult, type SchemaShowFieldResult, type SchemaShowResult, type SchemaShowStatusResult, type SchemaResult, type SchemaSubcommand, type SearchCompactResult, type SearchHit, type SearchHitHighlight, type SearchMatchMode, type SearchOptions, type ClaimNextOptions, type SearchResult, type SearchResultItem, type SearchVerboseResult, type StartTaskResult, type StatsCommandOptions, type StatsResult, type TemplatesListResult, type TemplatesSaveResult, type TemplatesShowResult, type TestRunsListCommandOptions, type TestRunsLogsCommandOptions, type TestRunsResumeCommandOptions, type TestRunsStopCommandOptions, type ToImportLinkedArtifactsOptions, type ToImportLinkedTestsOptions, type ToImportLogEntriesOptions, type UpdateResult, type UpgradeCommandOptions, type UpgradeResult, type ValidateCommandOptions, type ValidateResult, type WorkspaceContracts, type WorkspaceContractsOptions, } from "./runtime.js";
+export { runStats } from "./stats.js";
+export { DEFAULT_EVAL_QUERIES_RELATIVE_PATH, runEval, type EvalOptions, type EvalQueryReport, type EvalResult, } from "./eval.js";
+export { runTelemetry, TELEMETRY_SUBCOMMANDS, type TelemetryCommandOptions, type TelemetrySubcommand, } from "./telemetry.js";
+export { classifyLinkedTestFailure, countFailureCategories, extractReferencedPmItemIdsFromCommand, resolveLinkedTestFailureExitCode, runLinkedTests, runTest, summarizeContextPreflight, type LinkedTestFailureCategory, type TestCommandOptions, type TestResult, type TestRunResult, } from "./test/execution.js";
+export { runTestAll, type TestAllCommandOptions, type TestAllItemResult, type TestAllResult, } from "./test/batch.js";
+export { LINKED_TEST_ENV_NAME_PATTERN, LINKED_TEST_PM_CONTEXT_MODE_VALUES, LINKED_TEST_PROTECTED_ENV_KEYS, parseLinkedTestAssertionEqualsMap, parseLinkedTestAssertionGteMap, parseLinkedTestBoolean, parseLinkedTestContextMode, parseLinkedTestEnvClear, parseLinkedTestEnvSet, parseLinkedTestJsonEntries, parseLinkedTestMinLines, parseLinkedTestRegexList, parseLinkedTestStringList, type LinkedTestPmContextMode, } from "./test/parsers.js";
+export { runStartBackgroundRun, runTestRunsWorker, type StartBackgroundRunCommandOptions, type StartBackgroundRunResult, } from "./test/runs.js";
 export { BUILTIN_PROFILES, listProfiles, normalizeProfileName, PROFILE_NAMES, resolveProfile, type ProfileConfigEntry, type ProfileName, type ProfilePackageRecommendation, type ProfileTemplateEntry, type ProfileTemplateOptions, type ProjectProfileDefinition, type ProjectProfileRegistrationInput, } from "../core/profile/profile-presets.js";
 export { planProfileApplication, type ProfileApplicationPlan, type ProfileChangeStatus, type ProfileComponentChange, type ProfileConfigChange, type ProfileConfigPlan, type ProfileCurrentState, type ProfilePackagePlan, type ProfileSchemaPlan, type ProfileTemplateChange, type ProfileTemplatePlan, type ProfileWorkflowChange, type ProfileWorkflowPlan, } from "../core/profile/profile-plan.js";
 export { describeProfileComposition, describeProjectProfile, type ProjectProfileComposition, type ProjectProfileDescription, type ProjectProfilePackageSummary, } from "../core/profile/profile-describe.js";

package/dist/sdk/index.js

@@ -4,14 +4,17 @@
  * Defines public SDK APIs and package-author helpers for Index.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d975f914-6acc-5da2-b7c4-d696f1b339b6")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="02da6657-48e5-5fa6-84b9-8f776bd9d8b1")}catch(e){}}();
 export { isErrnoError, limitAnnotationEntries, parseAnnotationTextInput, readAnnotationEntries, resolveAnnotationInput, resolveAnnotationIndex, runAnnotationCommand, wrapOwnershipConflict, } from "./annotations.js";
 export { inspectHistoryAuthorStream, scanHistoryAuthorAttribution, } from "./author-attribution.js";
 export { createPmCliProgram } from "./cli-program.js";
+export { runSearchRefreshWorkerEntrypoint } from "./search-refresh-worker.js";
+export { flushTelemetryQueue } from "./telemetry-flush.js";
+export { EXECUTABLE_COMMAND_ALIASES, applyBootstrapPagerPolicy, coalesceRepeatedListFlags, listAliasPluralKeys, mergeLinkedTestTwoTokenEntries, normalizeBootstrapInvocation, normalizeLegacyExtensionActionSyntax, parseBootstrapCommandName, parseBootstrapGlobalOptions, parseBootstrapHelpRequest, parseBootstrapTypeValue, stripGlobalBootstrapTokens, } from "./cli-bootstrap.js";
 export { quoteCommandArg, quoteWindowsCommandArg, renderPmCommand, } from "./command-line.js";
-export * from "./governance/gc.js";
-export * from "./governance/health.js";
-export * from "./governance/validate.js";
+export { runGc, } from "./governance/gc.js";
+export { _testOnlyHealthCommand, runHealth, } from "./governance/health.js";
+export { _testOnlyValidateCommand, runValidate, } from "./governance/validate.js";
 export { runExtension } from "./extension.js";
 export { applyInvocationAuthorOverride } from "./invocation-author.js";
 export { _testOnly as _testOnlyTemplates, } from "./templates.js";
@@ -33,19 +36,30 @@ export * from "./history-redact.js";
 export * from "./history-repair.js";
 export * from "./item-children.js";
 export * from "./item-schedule.js";
-export { collectDanglingDependencyReferences, runDeps, } from "./dependencies.js";
+export { runDeps, } from "./dependencies.js";
+export * from "./graph/index.js";
 export { runDocs } from "./docs.js";
 export { runFiles, runFilesDiscover, } from "./files.js";
 export { applyPathMigrations, applyStandaloneNote, artifactKey, dedupeLinkedArtifacts, ensureScope, expandAddGlobEntries, normalizeLinkedPath, parseAddEntries, parseAddGlobEntries, parseMigrateEntries, parseRemoveEntries, renameArtifactsResultKey, runLinkedArtifacts, sortLinkedArtifacts, validateLinkedPaths, } from "./linked-artifacts.js";
 export * from "./pagination.js";
+export * from "./query/item-filter-options.js";
+export * from "./query/parsers.js";
 export * from "./output.js";
 export * from "./relationship-analytics.js";
 export * from "./relationship-context.js";
 export * from "./relationship-history.js";
 export * from "./relationships.js";
+export * from "./actionability.js";
 export { PLAN_SHOW_DEPTH_VALUES, PLAN_SUBCOMMANDS, PLAN_TEMPLATE_NAMES, } from "../cli/commands/plan.js";
 export * from "./define.js";
-export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, acquireLock, appendHistoryEntry, canonicalDocument, classifyItemFormatVersion, clearWorkspaceContractsCache, commitImportedItem, createHistoryEntry, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, ensureTrackerInitialized, generateItemId, getActiveExtensionRegistrations, getContracts, getHistoryPath, getItemPath, getSettingsPath, getWorkspaceContracts, isPmCliExpectedError, isTimestampLiteral, listAllItemMetadata, loadCreateTemplateOptions, locateItem, normalizeItemMetadata, normalizeItemFormatVersion, normalizeItemId, normalizeRawItemId, normalizeStatusInput, nowIso, parseTags, pathExists, readBooleanOption, readCsvListOption, readFileIfExists, readLocatedItem, readRequiredString, readSettings, readStringOption, removeFileIfExists, renderCalendarMarkdown, renderCalendarToon, renderGuideMarkdown, resolveCalendarOutputFormat, resolveGuideOutputFormat, resolveItemTypeRegistry, resolvePmRoot, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, runAction, runActiveOnReadHooks, runActiveOnWriteHooks, runCalendar, runCompletion, runGuide, runReindex, runSearch, runTemplatesList, runTemplatesSave, runTemplatesShow, runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, scanItemFormatVersions, selectImportAuthor, serializeItemDocument, splitFrontMatter, toEstimatedMinutesValue, toImportBoolean, toImportConfidence, toImportInteger, toImportLinkedDocs, toImportLinkedFiles, toImportLinkedTests, toImportLogEntries, toImportNormalizedEnum, toImportNumberMap, toImportPriority, toImportStatus, toImportStringList, toImportStringMap, toImportTags, toNonEmptyImportString, writeFileAtomic, aggregate, append, claim, claimNext, close, closeTask, comments, config, context, copy, create, deleteItem, deps, docs, extension, extensionActivate, extensionDeactivate, extensionList, files, filesDiscover, focus, gc, get, health, historyCompact, historyCompactBulk, historyRedact, historyRepair, historyRepairAll, init, learnings, list, next, notes, packageActivate, packageCatalog, packageDeactivate, packageDescribe, packageDoctor, packageInstall, packageLifecycle, packageList, packageManage, packageReload, packageUninstall, pauseTask, profile, profileApply, profileLint, profileList, profileShow, release, restore, schema, schemaAddField, schemaAddStatus, schemaAddType, schemaApplyPreset, schemaInferTypes, schemaList, schemaListFields, schemaRemoveField, schemaRemoveStatus, schemaRemoveType, schemaShow, schemaShowField, schemaShowStatus, search, startTask, stats, update, upgrade, validate, } from "./runtime.js";
+export { BASELINE_ITEM_FORMAT_VERSION, BUILTIN_ITEM_TYPE_VALUES, CONFIDENCE_TEXT_VALUES, CURRENT_ITEM_FORMAT_VERSION, DEPENDENCY_KIND_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, PM_CLI_EXPECTED_ERROR_NAME, PmCliError, PmClient, RISK_VALUES, STATUS_VALUES, acquireLock, appendHistoryEntry, canonicalDocument, classifyItemFormatVersion, clearWorkspaceContractsCache, commitImportedItem, createHistoryEntry, createPmCliExpectedError, effectiveItemFormatVersion, emptyImportedDocument, ensureTrackerInitialized, generateItemId, getActiveExtensionRegistrations, getContracts, getHistoryPath, getItemPath, getSettingsPath, getWorkspaceContracts, isPmCliExpectedError, isTimestampLiteral, listAllItemMetadata, loadCreateTemplateOptions, locateItem, normalizeItemMetadata, normalizeItemFormatVersion, normalizeItemId, normalizeRawItemId, normalizeStatusInput, nowIso, parseTags, pathExists, readBooleanOption, readCsvListOption, readFileIfExists, readLocatedItem, readRequiredString, readSettings, readStringOption, removeFileIfExists, renderCalendarMarkdown, renderCalendarToon, renderGuideMarkdown, resolveCalendarOutputFormat, resolveGuideOutputFormat, resolveItemTypeRegistry, resolvePmRoot, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, runAction, runActiveOnReadHooks, runActiveOnWriteHooks, runCalendar, runCompletion, runGuide, runList, runReindex, runSearch, runTemplatesList, runTemplatesSave, runTemplatesShow, runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, scanItemFormatVersions, selectImportAuthor, serializeItemDocument, splitFrontMatter, toEstimatedMinutesValue, toImportBoolean, toImportConfidence, toImportInteger, toImportLinkedDocs, toImportLinkedFiles, toImportLinkedTests, toImportLogEntries, toImportNormalizedEnum, toImportNumberMap, toImportPriority, toImportStatus, toImportStringList, toImportStringMap, toImportTags, toNonEmptyImportString, writeFileAtomic, aggregate, append, claim, claimNext, close, closeTask, comments, config, context, copy, create, deleteItem, deps, docs, extension, extensionActivate, extensionDeactivate, extensionList, files, filesDiscover, focus, gc, get, graph, health, historyCompact, historyCompactBulk, historyRedact, historyRepair, historyRepairAll, init, learnings, list, next, notes, packageActivate, packageCatalog, packageDeactivate, packageDescribe, packageDoctor, packageInstall, packageLifecycle, packageList, packageManage, packageReload, packageUninstall, pauseTask, profile, profileApply, profileLint, profileList, profileShow, release, restore, schema, schemaAddField, schemaAddStatus, schemaAddType, schemaApplyPreset, schemaInferTypes, schemaList, schemaListFields, schemaRemoveField, schemaRemoveStatus, schemaRemoveType, schemaShow, schemaShowField, schemaShowStatus, search, startTask, stats, update, upgrade, validate, } from "./runtime.js";
+export { runStats } from "./stats.js";
+export { DEFAULT_EVAL_QUERIES_RELATIVE_PATH, runEval, } from "./eval.js";
+export { runTelemetry, TELEMETRY_SUBCOMMANDS, } from "./telemetry.js";
+export { classifyLinkedTestFailure, countFailureCategories, extractReferencedPmItemIdsFromCommand, resolveLinkedTestFailureExitCode, runLinkedTests, runTest, summarizeContextPreflight, } from "./test/execution.js";
+export { runTestAll, } from "./test/batch.js";
+export { LINKED_TEST_ENV_NAME_PATTERN, LINKED_TEST_PM_CONTEXT_MODE_VALUES, LINKED_TEST_PROTECTED_ENV_KEYS, parseLinkedTestAssertionEqualsMap, parseLinkedTestAssertionGteMap, parseLinkedTestBoolean, parseLinkedTestContextMode, parseLinkedTestEnvClear, parseLinkedTestEnvSet, parseLinkedTestJsonEntries, parseLinkedTestMinLines, parseLinkedTestRegexList, parseLinkedTestStringList, } from "./test/parsers.js";
+export { runStartBackgroundRun, runTestRunsWorker, } from "./test/runs.js";
 export { BUILTIN_PROFILES, listProfiles, normalizeProfileName, PROFILE_NAMES, resolveProfile, } from "../core/profile/profile-presets.js";
 export { planProfileApplication, } from "../core/profile/profile-plan.js";
 export { describeProfileComposition, describeProjectProfile, } from "../core/profile/profile-describe.js";
@@ -78,4 +92,4 @@ export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabil
  */
 export { renderExtensionSurfaceMarkdown, } from "../core/extensions/activation-summary-markdown.js";
 //# sourceMappingURL=index.js.map
-//# debugId=d975f914-6acc-5da2-b7c4-d696f1b339b6
+//# debugId=02da6657-48e5-5fa6-84b9-8f776bd9d8b1