@unbrained/pm-cli 2026.7.20 → 2026.7.21

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

@@ -1 +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":"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","debugId":"ed9f0831-6011-5ee2-abd6-72375eac0a3a"}
+{"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/**\n * Orient one ordering edge into its execution direction — the predecessor that\n * must finish first and the successor it gates — honoring the kind's declared\n * precedence so inverse spellings (`blocked_by`/`blocks`) agree. This is the\n * single ordering-orientation primitive shared by scheduling and degree\n * analytics.\n */\nexport function orientOrderingEdge(\n  edge: RelationshipEdge,\n  definition: RelationshipKindDefinition,\n): { predecessor: string; successor: string } {\n  const predecessor = orderingPredecessorEndpoint(edge, definition);\n  return {\n    predecessor,\n    successor: predecessor === edge.source ? edge.target : edge.source,\n  };\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;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAsB,EACtB,UAAsC;IAEtC,MAAM,WAAW,GAAG,2BAA2B,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAClE,OAAO;QACL,WAAW;QACX,SAAS,EAAE,WAAW,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM;KACnE,CAAC;AACJ,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":"8b7a0e24-8ead-5b79-a83b-6d2bb32f807f"}

package/dist/sdk/index.d.ts

@@ -14,6 +14,7 @@ export { runGc, type GcCheckpointsSummary, type GcLocksSummary, } from "./govern
 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 { runWithActiveExtensions, type ActiveExtensionScopeOptions, } from "./runtime.js";
 export { applyInvocationAuthorOverride } from "./invocation-author.js";
 export { describeItemOwnershipConflict } from "./ownership-source.js";
 export { discoverNearbyPmRoot } from "./tracker-root-discovery.js";
@@ -54,6 +55,9 @@ export * from "./relationship-history.js";
 export * from "./workspace-transaction.js";
 export * from "./workspace-transaction-gc.js";
 export * from "./item-transaction.js";
+export * from "./structured-mutations.js";
+export * from "./runtime-primitives.js";
+export * from "./error-runtime.js";
 export * from "./relationships.js";
 export * from "./actionability.js";
 export type { PlanCommandOptions, PlanCommandResult, PlanDispatchInput, PlanResultPlan, PlanShowDepth, PlanStepSummary, PlanSubcommand, PlanTemplateName, } from "../cli/commands/plan.js";

package/dist/sdk/index.js

@@ -4,7 +4,7 @@
  * 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]="b7a14a6b-ce17-5650-a2a7-38c07f718633")}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]="42f4193d-7f0c-50b4-b12c-a5b8add83520")}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";
@@ -16,6 +16,7 @@ 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 { runWithActiveExtensions, } from "./runtime.js";
 export { applyInvocationAuthorOverride } from "./invocation-author.js";
 export { describeItemOwnershipConflict } from "./ownership-source.js";
 export { discoverNearbyPmRoot } from "./tracker-root-discovery.js";
@@ -54,6 +55,9 @@ export * from "./relationship-history.js";
 export * from "./workspace-transaction.js";
 export * from "./workspace-transaction-gc.js";
 export * from "./item-transaction.js";
+export * from "./structured-mutations.js";
+export * from "./runtime-primitives.js";
+export * from "./error-runtime.js";
 export * from "./relationships.js";
 export * from "./actionability.js";
 export { PLAN_SHOW_DEPTH_VALUES, PLAN_SUBCOMMANDS, PLAN_TEMPLATE_NAMES, } from "../cli/commands/plan.js";
@@ -98,4 +102,4 @@ export { EXTENSION_CAPABILITY_REGISTRATION_SURFACES, collectUsedExtensionCapabil
  */
 export { renderExtensionSurfaceMarkdown, } from "../core/extensions/activation-summary-markdown.js";
 //# sourceMappingURL=index.js.map
-//# debugId=b7a14a6b-ce17-5650-a2a7-38c07f718633
+//# debugId=42f4193d-7f0c-50b4-b12c-a5b8add83520

package/dist/sdk/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["sdk/index.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/index\n *\n * Defines public SDK APIs and package-author helpers for Index.\n */\nexport {\n  isErrnoError,\n  limitAnnotationEntries,\n  parseAnnotationTextInput,\n  readAnnotationEntries,\n  resolveAnnotationInput,\n  resolveAnnotationIndex,\n  runAnnotationCommand,\n  wrapOwnershipConflict,\n  type AnnotationCommandConfig,\n  type AnnotationCommandOptions,\n  type AnnotationCommandResult,\n  type AnnotationEntry,\n  type AnnotationInput,\n  type AnnotationSourceOptions,\n  type OwnershipConflictGuidance,\n} from \"./annotations.js\";\nexport {\n  inspectHistoryAuthorStream,\n  scanHistoryAuthorAttribution,\n  type HistoryAuthorAttributionScan,\n  type UnknownAuthorHistoryEvent,\n} from \"./author-attribution.js\";\nexport { createPmCliProgram } from \"./cli-program.js\";\nexport { runSearchRefreshWorkerEntrypoint } from \"./search-refresh-worker.js\";\nexport { flushTelemetryQueue } from \"./telemetry-flush.js\";\nexport {\n  EXECUTABLE_COMMAND_ALIASES,\n  applyBootstrapPagerPolicy,\n  coalesceRepeatedListFlags,\n  listAliasPluralKeys,\n  mergeLinkedTestTwoTokenEntries,\n  normalizeBootstrapInvocation,\n  normalizeLegacyExtensionActionSyntax,\n  parseBootstrapCommandName,\n  parseBootstrapGlobalOptions,\n  parseBootstrapHelpRequest,\n  parseBootstrapTypeValue,\n  stripGlobalBootstrapTokens,\n  type BootstrapGlobalOptions,\n  type BootstrapHelpRequest,\n  type BootstrapInvocationNormalizationResult,\n  type BootstrapNormalizationEvent,\n} from \"./cli-bootstrap.js\";\nexport {\n  quoteCommandArg,\n  quoteWindowsCommandArg,\n  renderPmCommand,\n} from \"./command-line.js\";\nexport {\n  runGc,\n  type GcCheckpointsSummary,\n  type GcLocksSummary,\n} from \"./governance/gc.js\";\nexport {\n  _testOnlyHealthCommand,\n  runHealth,\n  type HealthCheck,\n} from \"./governance/health.js\";\nexport {\n  _testOnlyValidateCommand,\n  runValidate,\n  type ValidateCheck,\n  type ValidateFixesSummary,\n  type ValidateMutationServices,\n} from \"./governance/validate.js\";\nexport { runExtension } from \"./extension.js\";\nexport { applyInvocationAuthorOverride } from \"./invocation-author.js\";\nexport { describeItemOwnershipConflict } from \"./ownership-source.js\";\nexport { discoverNearbyPmRoot } from \"./tracker-root-discovery.js\";\nexport {\n  _testOnly as _testOnlyTemplates,\n  type TemplateSource,\n} from \"./templates.js\";\nexport {\n  runConfig,\n  _testOnlyConfigCommand,\n  type NestedSettingResultValue,\n} from \"./config.js\";\nexport {\n  INIT_AGENT_GUIDANCE_MODE_VALUES,\n  runInitAgentGuidance,\n  _testOnly as _testOnlyInitAgentGuidance,\n  type InitAgentGuidanceMode,\n  type InitAgentGuidanceSummary,\n  type RunInitAgentGuidanceOptions,\n  type RunInitAgentGuidanceResult,\n} from \"./init-agent-guidance.js\";\nexport {\n  runInit,\n  summarizeInitResult,\n  _testOnly as _testOnlyInit,\n  type InitAgentGuidanceResult,\n  type InitConciseResult,\n  type InitInstalledPackagesSummary,\n  type InitRegisteredTypePresetSummary,\n  type InitTargetResolution,\n  type InitTypePresetName,\n} from \"./init.js\";\nexport {\n  PROFILE_SUBCOMMANDS,\n  formatProfileApplyHuman,\n  formatProfileLintHuman,\n  formatProfileListHuman,\n  formatProfileShowHuman,\n  runProfileApply,\n  runProfileLint,\n  runProfileList,\n  runProfileShow,\n  type ProfileApplyDimension,\n  type ProfileComposition,\n  type ProfileListEntry,\n} from \"./profile.js\";\nimport {\n  EXTENSION_CAPABILITY_CONTRACT,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n  KNOWN_EXTENSION_CAPABILITIES,\n  KNOWN_EXTENSION_POLICY_MODES,\n  KNOWN_EXTENSION_POLICY_SURFACES,\n  KNOWN_EXTENSION_SANDBOX_PROFILES,\n  KNOWN_EXTENSION_TRUST_MODES,\n} from \"../core/extensions/loader.js\";\nexport { RESERVED_ITEM_FIELD_NAMES } from \"../core/extensions/item-fields.js\";\nexport {\n  PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,\n  PM_PACKAGE_RESOURCE_KINDS,\n  collectPackageExtensionDirectories,\n  readPmPackageManifest,\n  type PmPackageCatalogLinkMap,\n  type PmPackageCatalogMediaMap,\n  type PmPackageCatalogMetadata,\n  type PmPackageManifest,\n  type PmPackageResourceKind,\n  type PmPackageResourceMap,\n} from \"../core/packages/manifest.js\";\nexport type {\n  CommanderOptionAliasContract,\n  CommanderOptionRegistrationContract,\n} from \"./cli-contracts.js\";\nexport {\n  ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,\n  APPEND_FLAG_CONTRACTS,\n  CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS,\n  CALENDAR_FLAG_CONTRACTS,\n  CLAIM_FLAG_CONTRACTS,\n  CLOSE_FLAG_CONTRACTS,\n  CLOSE_MANY_FLAG_CONTRACTS,\n  CLOSE_TASK_FLAG_CONTRACTS,\n  COMMENTS_FLAG_CONTRACTS,\n  COMPLETION_FLAG_CONTRACTS,\n  CONFIG_FLAG_CONTRACTS,\n  CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,\n  CONTEXT_FLAG_CONTRACTS,\n  CONTRACTS_FLAG_CONTRACTS,\n  COPY_FLAG_CONTRACTS,\n  CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,\n  CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,\n  CREATE_COMMANDER_STRING_OPTION_CONTRACTS,\n  CREATE_FLAG_CONTRACTS,\n  DELETE_FLAG_CONTRACTS,\n  DEPS_FLAG_CONTRACTS,\n  DOCS_FLAG_CONTRACTS,\n  EVAL_FLAG_CONTRACTS,\n  EXTENSION_ACTIVATE_FLAG_CONTRACTS,\n  EXTENSION_ADOPT_ALL_FLAG_CONTRACTS,\n  EXTENSION_ADOPT_FLAG_CONTRACTS,\n  EXTENSION_CATALOG_FLAG_CONTRACTS,\n  EXTENSION_DEACTIVATE_FLAG_CONTRACTS,\n  EXTENSION_DESCRIBE_FLAG_CONTRACTS,\n  EXTENSION_DOCTOR_FLAG_CONTRACTS,\n  EXTENSION_EXPLORE_FLAG_CONTRACTS,\n  EXTENSION_FLAG_CONTRACTS,\n  EXTENSION_INIT_FLAG_CONTRACTS,\n  EXTENSION_INSTALL_FLAG_CONTRACTS,\n  EXTENSION_MANAGE_FLAG_CONTRACTS,\n  EXTENSION_RELOAD_FLAG_CONTRACTS,\n  EXTENSION_SCOPE_FLAG_CONTRACTS,\n  EXTENSION_UNINSTALL_FLAG_CONTRACTS,\n  FILES_FLAG_CONTRACTS,\n  FOCUS_FLAG_CONTRACTS,\n  GC_FLAG_CONTRACTS,\n  GET_FLAG_CONTRACTS,\n  GLOBAL_FLAG_CONTRACTS,\n  GUIDE_FLAG_CONTRACTS,\n  HEALTH_FLAG_CONTRACTS,\n  HISTORY_COMPACT_FLAG_CONTRACTS,\n  HISTORY_FLAG_CONTRACTS,\n  HISTORY_REDACT_FLAG_CONTRACTS,\n  HISTORY_REPAIR_FLAG_CONTRACTS,\n  INIT_FLAG_CONTRACTS,\n  INSTALL_FLAG_CONTRACTS,\n  LEARNINGS_FLAG_CONTRACTS,\n  LIST_COMMANDER_STRING_OPTION_CONTRACTS,\n  LIST_FILTER_FLAG_CONTRACTS,\n  MEET_FLAG_CONTRACTS,\n  NEXT_COMMANDER_STRING_OPTION_CONTRACTS,\n  NEXT_FLAG_CONTRACTS,\n  NOTES_FLAG_CONTRACTS,\n  PACKAGE_FLAG_CONTRACTS,\n  PACKAGE_INIT_FLAG_CONTRACTS,\n  PAUSE_TASK_FLAG_CONTRACTS,\n  PLAN_FLAG_CONTRACTS,\n  PM_CORE_COMMAND_NAMES,\n  PM_EXTENSION_CAPABILITY_CONTRACTS,\n  PM_EXTENSION_POLICY_MODE_CONTRACTS,\n  PM_EXTENSION_POLICY_SURFACE_CONTRACTS,\n  PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS,\n  PM_EXTENSION_SERVICE_NAME_CONTRACTS,\n  PM_EXTENSION_TRUST_MODE_CONTRACTS,\n  PM_PROVIDER_TOOL_PARAMETERS_SCHEMA,\n  PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION,\n  PM_TOOL_ACTIONS,\n  PM_TOOL_ACTION_PARAMETER_CONTRACTS,\n  PM_TOOL_PARAMETERS_SCHEMA,\n  PM_TOOL_PARAMETERS_SCHEMA_MAJOR,\n  PM_TOOL_PARAMETERS_SCHEMA_VERSION,\n  PROFILE_FLAG_CONTRACTS,\n  REINDEX_FLAG_CONTRACTS,\n  RELEASE_FLAG_CONTRACTS,\n  REMIND_FLAG_CONTRACTS,\n  RESTORE_FLAG_CONTRACTS,\n  SCHEMA_FLAG_CONTRACTS,\n  SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,\n  SEARCH_FLAG_CONTRACTS,\n  START_TASK_FLAG_CONTRACTS,\n  STATS_FLAG_CONTRACTS,\n  SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,\n  TELEMETRY_FLAG_CONTRACTS,\n  TEST_ALL_FLAG_CONTRACTS,\n  TEST_FLAG_CONTRACTS,\n  TEST_RUNS_FLAG_CONTRACTS,\n  TOOL_ACTIVITY_OPTION_CONTRACTS,\n  TOOL_AGGREGATE_OPTION_CONTRACTS,\n  TOOL_CALENDAR_OPTION_CONTRACTS,\n  TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS,\n  TOOL_CONTEXT_OPTION_CONTRACTS,\n  TOOL_CREATE_OPTION_CONTRACTS,\n  TOOL_DEPS_OPTION_CONTRACTS,\n  TOOL_LIST_FILTER_OPTION_CONTRACTS,\n  TOOL_SEARCH_FILTER_OPTION_CONTRACTS,\n  TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS,\n  TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS,\n  TOOL_UPDATE_OPTION_CONTRACTS,\n  UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,\n  UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,\n  UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,\n  UPDATE_FLAG_CONTRACTS,\n  UPDATE_MANY_FLAG_CONTRACTS,\n  UPGRADE_FLAG_CONTRACTS,\n  compactFlagAliasContracts,\n  isPmExtensionCapabilityContract,\n  isPmExtensionPolicyModeContract,\n  isPmExtensionPolicySurfaceContract,\n  isPmExtensionServiceNameContract,\n  isPmToolAction,\n  readFirstStringFromCommanderOptions,\n  readFirstValueFromCommanderOptions,\n  readStringArrayFromCommanderOptions,\n  resolveSubcommandFlagContractsForCommand,\n  toCompletionFlagString,\n  withFlagAliasMetadata,\n} from \"./cli-contracts.js\";\nexport type {\n  CliFlagContract,\n  OptionsFromContracts,\n  PmActionSchemaContract,\n  PmBulkMutationControlOptions,\n  PmBulkMutationFilterOptions,\n  PmCloseActionOptions,\n  PmCloseManyActionOptions,\n  PmCreateActionOptions,\n  PmMutationAttributionOptions,\n  PmOptionScalar,\n  PmUpdateActionOptions,\n  PmUpdateManyActionOptions,\n  PmExtensionCapabilityContract,\n  PmExtensionPolicyModeContract,\n  PmExtensionPolicySurfaceContract,\n  PmExtensionSandboxProfileContract,\n  PmExtensionServiceNameContract,\n  PmExtensionTrustModeContract,\n  PmToolAction,\n  ToolOptionFlagContract,\n} from \"./cli-contracts.js\";\nexport * from \"./compose.js\";\nexport * from \"./context-relevance.js\";\nexport * from \"./context-packing.js\";\nexport * from \"./context-usage.js\";\nexport * from \"./history-compact.js\";\nexport * from \"./history-read.js\";\nexport * from \"./history-redact.js\";\nexport * from \"./history-repair.js\";\nexport * from \"./item-children.js\";\nexport * from \"./item-schedule.js\";\nexport * from \"./merge/index.js\";\nexport {\n  runDeps,\n  type DepsCollapseMode,\n  type DepsFormat,\n  type DepsGraphEdge,\n  type DepsGraphNode,\n  type DepsGraphResult,\n  type DepsTreeNode,\n} from \"./dependencies.js\";\nexport * from \"./graph/index.js\";\nexport { runDocs } from \"./docs.js\";\nexport {\n  runFiles,\n  runFilesDiscover,\n  type FilesDiscoveryCandidate,\n} from \"./files.js\";\nexport {\n  applyPathMigrations,\n  applyStandaloneNote,\n  artifactKey,\n  dedupeLinkedArtifacts,\n  ensureScope,\n  expandAddGlobEntries,\n  normalizeLinkedPath,\n  parseAddEntries,\n  parseAddGlobEntries,\n  parseMigrateEntries,\n  parseRemoveEntries,\n  renameArtifactsResultKey,\n  runLinkedArtifacts,\n  sortLinkedArtifacts,\n  validateLinkedPaths,\n  type AddGlobEntry,\n  type LinkedArtifact,\n  type LinkedArtifactCommandOptions,\n  type LinkedArtifactKindConfig,\n  type LinkedArtifactResult,\n  type LinkedPathValidation,\n  type PathMigration,\n} from \"./linked-artifacts.js\";\nexport * from \"./pagination.js\";\nexport * from \"./query/item-filter-options.js\";\nexport * from \"./query/parsers.js\";\nexport * from \"./output.js\";\nexport * from \"./relationship-analytics.js\";\nexport * from \"./relationship-context.js\";\nexport * from \"./relationship-history.js\";\nexport * from \"./workspace-transaction.js\";\nexport * from \"./workspace-transaction-gc.js\";\nexport * from \"./item-transaction.js\";\nexport * from \"./relationships.js\";\nexport * from \"./actionability.js\";\nexport type {\n  PlanCommandOptions,\n  PlanCommandResult,\n  PlanDispatchInput,\n  PlanResultPlan,\n  PlanShowDepth,\n  PlanStepSummary,\n  PlanSubcommand,\n  PlanTemplateName,\n} from \"../cli/commands/plan.js\";\nexport {\n  PLAN_SHOW_DEPTH_VALUES,\n  PLAN_SUBCOMMANDS,\n  PLAN_TEMPLATE_NAMES,\n} from \"../cli/commands/plan.js\";\nexport * from \"./define.js\";\nexport {\n  BASELINE_ITEM_FORMAT_VERSION,\n  BUILTIN_ITEM_TYPE_VALUES,\n  CONFIDENCE_TEXT_VALUES,\n  CURRENT_ITEM_FORMAT_VERSION,\n  DEPENDENCY_KIND_VALUES,\n  EXIT_CODE,\n  ISSUE_SEVERITY_VALUES,\n  ITEM_TYPE_VALUES,\n  PM_CLI_EXPECTED_ERROR_NAME,\n  PmCliError,\n  PmClient,\n  RISK_VALUES,\n  STATUS_VALUES,\n  acquireLock,\n  appendHistoryEntry,\n  canonicalDocument,\n  classifyItemFormatVersion,\n  clearWorkspaceContractsCache,\n  commitImportedItem,\n  createHistoryEntry,\n  createPmCliExpectedError,\n  effectiveItemFormatVersion,\n  emptyImportedDocument,\n  ensureTrackerInitialized,\n  generateItemId,\n  getActiveExtensionRegistrations,\n  getContracts,\n  getHistoryPath,\n  getItemPath,\n  getSettingsPath,\n  getWorkspaceContracts,\n  isPmCliExpectedError,\n  isTimestampLiteral,\n  listAllItemMetadata,\n  loadCreateTemplateOptions,\n  locateItem,\n  normalizeItemMetadata,\n  normalizeItemFormatVersion,\n  normalizeItemId,\n  normalizeRawItemId,\n  normalizeStatusInput,\n  nowIso,\n  parseTags,\n  pathExists,\n  readBooleanOption,\n  readCsvListOption,\n  readFileIfExists,\n  readLocatedItem,\n  readRequiredString,\n  readSettings,\n  readStringOption,\n  removeFileIfExists,\n  renderCalendarMarkdown,\n  renderCalendarToon,\n  renderGuideMarkdown,\n  resolveCalendarOutputFormat,\n  resolveGuideOutputFormat,\n  resolveItemTypeRegistry,\n  resolvePmRoot,\n  resolveRuntimeFieldRegistry,\n  resolveRuntimeStatusRegistry,\n  runAction,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n  runCalendar,\n  runCompletion,\n  runGuide,\n  runList,\n  runReindex,\n  runSearch,\n  runTemplatesList,\n  runTemplatesSave,\n  runTemplatesShow,\n  runTestRunsList,\n  runTestRunsLogs,\n  runTestRunsResume,\n  runTestRunsStatus,\n  runTestRunsStop,\n  scanItemFormatVersions,\n  selectImportAuthor,\n  serializeItemDocument,\n  splitFrontMatter,\n  toEstimatedMinutesValue,\n  toImportBoolean,\n  toImportConfidence,\n  toImportInteger,\n  toImportLinkedDocs,\n  toImportLinkedFiles,\n  toImportLinkedTests,\n  toImportLogEntries,\n  toImportNormalizedEnum,\n  toImportNumberMap,\n  toImportPriority,\n  toImportStatus,\n  toImportStringList,\n  toImportStringMap,\n  toImportTags,\n  toNonEmptyImportString,\n  writeFileAtomic,\n  aggregate,\n  append,\n  claim,\n  claimNext,\n  close,\n  closeTask,\n  comments,\n  config,\n  context,\n  copy,\n  create,\n  deleteItem,\n  deps,\n  docs,\n  extension,\n  extensionActivate,\n  extensionDeactivate,\n  extensionList,\n  files,\n  filesDiscover,\n  focus,\n  gc,\n  get,\n  graph,\n  health,\n  historyCompact,\n  historyCompactBulk,\n  historyRedact,\n  historyRepair,\n  historyRepairAll,\n  init,\n  learnings,\n  list,\n  next,\n  notes,\n  packageActivate,\n  packageCatalog,\n  packageDeactivate,\n  packageDescribe,\n  packageDoctor,\n  packageInstall,\n  packageLifecycle,\n  packageList,\n  packageManage,\n  packageReload,\n  packageUninstall,\n  pauseTask,\n  profile,\n  profileApply,\n  profileLint,\n  profileList,\n  profileShow,\n  release,\n  restore,\n  schema,\n  schemaAddField,\n  schemaAddStatus,\n  schemaAddType,\n  schemaApplyPreset,\n  schemaInferTypes,\n  schemaList,\n  schemaListFields,\n  schemaRemoveField,\n  schemaRemoveStatus,\n  schemaRemoveType,\n  schemaShow,\n  schemaShowField,\n  schemaShowStatus,\n  search,\n  startTask,\n  stats,\n  update,\n  upgrade,\n  validate,\n  type AggregateOptions,\n  type AggregateResult,\n  type AggregateRow,\n  type AppendCommandOptions,\n  type AppendResult,\n  type BlockerEntry,\n  type CalendarOptions,\n  type CalendarResult,\n  type ClaimResult,\n  type CloseResult,\n  type CloseTaskResult,\n  type CommitImportedItemParams,\n  type CommitImportedItemResult,\n  type CommentsCommandOptions,\n  type CommentsResult,\n  type ConfigCommandOptions,\n  type ConfigResult,\n  type CompletionResult,\n  type CompletionShell,\n  type ContractsCommandOptions,\n  type ContractsResult,\n  type ContextFocusItem,\n  type ContextOptions,\n  type ContextOutputFormat,\n  type ContextResult,\n  type CopyResult,\n  type CreatePmCliExpectedErrorOptions,\n  type CreateResult,\n  type CreateTemplateOptions,\n  type Dependency,\n  type DeleteResult,\n  type DepsCommandOptions,\n  type DepsResult,\n  type DocsCommandOptions,\n  type DocsResult,\n  type ExtensionCommandOptions,\n  type ExtensionCommandResult,\n  type FilesCommandOptions,\n  type FilesDiscoverOptions,\n  type FilesDiscoverResult,\n  type FilesResult,\n  type FocusResult,\n  type GcCommandOptions,\n  type GcResult,\n  type GetContractsOptions,\n  type GetOptions,\n  type GetResult,\n  type GuideDepth,\n  type GuideOptions,\n  type GuideOutputFormat,\n  type GuideResult,\n  type HealthResult,\n  type ImportLinkedScope,\n  type InitCommandOptions,\n  type InitResult,\n  type ItemFormatVersionScanEntry,\n  type ItemFormatVersionScanResult,\n  type ItemFormatVersionStatus,\n  type LearningsCommandOptions,\n  type LearningsResult,\n  type LinkedDoc,\n  type LinkedFile,\n  type LinkedTest,\n  type ListedItem,\n  type ListCompactResult,\n  type ListFullResult,\n  type ListOptions,\n  type ListProjectedItem,\n  type ListProjectedItemCore,\n  type ListResult,\n  type ListResultItem,\n  type ListSortField,\n  type ListSortOrder,\n  type ListTreeItem,\n  type ListTreeMetadata,\n  type ListVerboseResult,\n  type LogNote,\n  type NextActionableItem,\n  type NextBlockerRef,\n  type NextOptions,\n  type NextOutputFormat,\n  type NextRecommendation,\n  type NextResult,\n  type NotesCommandOptions,\n  type NotesResult,\n  type PackageCommandOptions,\n  type PackageCommandResult,\n  type PauseTaskResult,\n  type PmActionInput,\n  type PmActionName,\n  type PmActionOptions,\n  type PmClientCloseActionOptions,\n  type PmClientFullMutationOptions,\n  type PmClientMutationOptions,\n  type PmClientOptions,\n  type PmClientRunArgs,\n  type PmCliExpectedError,\n  type ProfileApplyCommandOptions,\n  type ProfileApplyResult,\n  type ProfileLintResult,\n  type ProfileListResult,\n  type ProfileResult,\n  type ProfileShowResult,\n  type ProfileSubcommand,\n  type ReindexOptions,\n  type ReindexResult,\n  type ReleaseResult,\n  type RestoreResult,\n  type RunHealthOptions,\n  type SchemaAddFieldCommandOptions,\n  type SchemaAddFieldResult,\n  type SchemaAddStatusCommandOptions,\n  type SchemaAddStatusResult,\n  type SchemaAddTypeCommandOptions,\n  type SchemaAddTypeInferCommandOptions,\n  type SchemaAddTypeInferResult,\n  type SchemaAddTypeResult,\n  type SchemaApplyPresetCommandOptions,\n  type SchemaApplyPresetResult,\n  type SchemaInspectResult,\n  type SchemaListFieldsResult,\n  type SchemaListResult,\n  type SchemaRemoveFieldCommandOptions,\n  type SchemaRemoveFieldResult,\n  type SchemaRemoveStatusCommandOptions,\n  type SchemaRemoveStatusResult,\n  type SchemaRemoveTypeCommandOptions,\n  type SchemaRemoveTypeResult,\n  type SchemaShowFieldResult,\n  type SchemaShowResult,\n  type SchemaShowStatusResult,\n  type SchemaResult,\n  type SchemaSubcommand,\n  type SearchCompactResult,\n  type SearchHit,\n  type SearchHitHighlight,\n  type SearchMatchMode,\n  type SearchOptions,\n  type ClaimNextOptions,\n  type SearchResult,\n  type SearchResultItem,\n  type SearchVerboseResult,\n  type StartTaskResult,\n  type StatsCommandOptions,\n  type StatsResult,\n  type TemplatesListResult,\n  type TemplatesSaveResult,\n  type TemplatesShowResult,\n  type TestRunsListCommandOptions,\n  type TestRunsLogsCommandOptions,\n  type TestRunsResumeCommandOptions,\n  type TestRunsStopCommandOptions,\n  type ToImportLinkedArtifactsOptions,\n  type ToImportLinkedTestsOptions,\n  type ToImportLogEntriesOptions,\n  type UpdateResult,\n  type UpgradeCommandOptions,\n  type UpgradeResult,\n  type ValidateCommandOptions,\n  type ValidateResult,\n  type WorkspaceContracts,\n  type WorkspaceContractsOptions,\n} from \"./runtime.js\";\nexport { runStats } from \"./stats.js\";\nexport {\n  DEFAULT_EVAL_QUERIES_RELATIVE_PATH,\n  runEval,\n  type EvalOptions,\n  type EvalQueryReport,\n  type EvalResult,\n} from \"./eval.js\";\nexport {\n  runTelemetry,\n  TELEMETRY_SUBCOMMANDS,\n  type TelemetryCommandOptions,\n  type TelemetrySubcommand,\n} from \"./telemetry.js\";\nexport {\n  classifyLinkedTestFailure,\n  countFailureCategories,\n  extractReferencedPmItemIdsFromCommand,\n  resolveLinkedTestFailureExitCode,\n  runLinkedTests,\n  runTest,\n  summarizeContextPreflight,\n  type LinkedTestFailureCategory,\n  type TestCommandOptions,\n  type TestResult,\n  type TestRunResult,\n} from \"./test/execution.js\";\nexport {\n  runTestAll,\n  type TestAllCommandOptions,\n  type TestAllItemResult,\n  type TestAllResult,\n} from \"./test/batch.js\";\nexport {\n  LINKED_TEST_ENV_NAME_PATTERN,\n  LINKED_TEST_PM_CONTEXT_MODE_VALUES,\n  LINKED_TEST_PROTECTED_ENV_KEYS,\n  parseLinkedTestAssertionEqualsMap,\n  parseLinkedTestAssertionGteMap,\n  parseLinkedTestBoolean,\n  parseLinkedTestContextMode,\n  parseLinkedTestEnvClear,\n  parseLinkedTestEnvSet,\n  parseLinkedTestJsonEntries,\n  parseLinkedTestMinLines,\n  parseLinkedTestRegexList,\n  parseLinkedTestStringList,\n  type LinkedTestPmContextMode,\n} from \"./test/parsers.js\";\nexport {\n  runStartBackgroundRun,\n  runTestRunsWorker,\n  type StartBackgroundRunCommandOptions,\n  type StartBackgroundRunResult,\n} from \"./test/runs.js\";\nexport {\n  BUILTIN_PROFILES,\n  listProfiles,\n  normalizeProfileName,\n  PROFILE_NAMES,\n  resolveProfile,\n  type ProfileConfigEntry,\n  type ProfileName,\n  type ProfilePackageRecommendation,\n  type ProfileTemplateEntry,\n  type ProfileTemplateOptions,\n  type ProjectProfileDefinition,\n  type ProjectProfileRegistrationInput,\n} from \"../core/profile/profile-presets.js\";\nexport {\n  planProfileApplication,\n  type ProfileApplicationPlan,\n  type ProfileChangeStatus,\n  type ProfileComponentChange,\n  type ProfileConfigChange,\n  type ProfileConfigPlan,\n  type ProfileCurrentState,\n  type ProfilePackagePlan,\n  type ProfileSchemaPlan,\n  type ProfileTemplateChange,\n  type ProfileTemplatePlan,\n  type ProfileWorkflowChange,\n  type ProfileWorkflowPlan,\n} from \"../core/profile/profile-plan.js\";\nexport {\n  describeProfileComposition,\n  describeProjectProfile,\n  type ProjectProfileComposition,\n  type ProjectProfileDescription,\n  type ProjectProfilePackageSummary,\n} from \"../core/profile/profile-describe.js\";\nexport {\n  lintProjectProfile,\n  PROFILE_LINT_CODES,\n  PROFILE_LINT_DIMENSIONS,\n  type ProfileLintCode,\n  type ProfileLintDimension,\n  type ProfileLintSeverity,\n  type ProjectProfileLintFinding,\n  type ProjectProfileLintReport,\n} from \"../core/profile/profile-lint.js\";\nexport {\n  assertExtensionBlueprint,\n  assertExtensionCapabilityUsage,\n  assertExtensionDeactivated,\n  assertExtensionManifestCompatible,\n  assertExtensionManifestMatchesBlueprint,\n  assertExtensionPreflight,\n  assertPackageManifest,\n  assertProjectProfile,\n  assertRegisteredCommandContract,\n  assertRegisteredCommandOverride,\n  assertRegisteredExporter,\n  assertRegisteredFlags,\n  assertRegisteredHook,\n  assertRegisteredImporter,\n  assertRegisteredItemField,\n  assertRegisteredItemType,\n  assertRegisteredMigration,\n  assertRegisteredParserOverride,\n  assertRegisteredPreflightOverride,\n  assertRegisteredProfile,\n  assertRegisteredRendererOverride,\n  assertRegisteredSearchProvider,\n  assertRegisteredServiceOverride,\n  assertRegisteredVectorStoreAdapter,\n  activateExtensionForTest,\n  createExtensionTestHarness,\n  deactivateExtensionForTest,\n  describeExtensionActivation,\n  runRegisteredCommandForTest,\n  runRegisteredCommandOverrideForTest,\n  runRegisteredExporterForTest,\n  runRegisteredHookForTest,\n  runRegisteredImporterForTest,\n  runRegisteredMigrationForTest,\n  runRegisteredParserOverrideForTest,\n  runRegisteredPreflightOverrideForTest,\n  runRegisteredRendererOverrideForTest,\n  runRegisteredSearchProviderForTest,\n  runRegisteredServiceOverrideForTest,\n  runRegisteredVectorStoreAdapterForTest,\n  type ActivateExtensionForTestOptions,\n  type AssertProjectProfileOptions,\n  type DeactivateExtensionForTestOptions,\n  type DescribeExtensionActivationOptions,\n  type ExtensionActivationSummary,\n  type RenderExtensionHarnessMarkdownOptions,\n  type RunRegisteredCommandForTestOptions,\n  type RunRegisteredExporterForTestOptions,\n  type RunRegisteredHookForTestOptions,\n  type RunRegisteredImporterForTestOptions,\n  type RunRegisteredMigrationForTestOptions,\n  type RunRegisteredSearchProviderForTestOptions,\n  type RunRegisteredVectorStoreAdapterForTestOptions,\n  type SearchProviderOperationContexts,\n  type SearchProviderOperationResults,\n  type VectorStoreAdapterOperationContexts,\n  type VectorStoreAdapterOperationResults,\n  type ExtensionCapabilityUsageAssertion,\n  type ExtensionCapabilityUsageExpectation,\n  type ExtensionDeactivationExpectation,\n  type ExtensionManifestBlueprintMatch,\n  type ExtensionTestHarness,\n  type PackageManifestExpectation,\n  type PackageManifestResourceExpectation,\n  type RegisteredCommandContractAssertion,\n  type RegisteredCommandContractExpectation,\n  type RegisteredCommandOverrideExpectation,\n  type RegisteredExporterExpectation,\n  type RegisteredFlagsExpectation,\n  type RegisteredHookExpectation,\n  type RegisteredHookKind,\n  type RegisteredImporterExpectation,\n  type RegisteredItemFieldAssertion,\n  type RegisteredItemFieldExpectation,\n  type RegisteredItemTypeAssertion,\n  type RegisteredItemTypeExpectation,\n  type RegisteredMigrationExpectation,\n  type RegisteredParserOverrideExpectation,\n  type RegisteredPreflightOverrideExpectation,\n  type RegisteredProfileAssertion,\n  type RegisteredProfileExpectation,\n  type RegisteredRendererOverrideExpectation,\n  type RegisteredSearchProviderExpectation,\n  type RegisteredServiceOverrideExpectation,\n  type RegisteredVectorStoreAdapterExpectation,\n} from \"./testing.js\";\n\n/**\n * Canonical extension capability names accepted by pm.\n *\n * Extension manifests should declare one or more of these values in\n * `capabilities`.\n */\nexport const EXTENSION_CAPABILITIES = KNOWN_EXTENSION_CAPABILITIES;\n/** Restricts extension capability values accepted by command, SDK, and storage contracts. */\nexport type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];\n\n/** Canonical extension governance policy modes and registration surfaces. */\nexport const EXTENSION_POLICY_MODES = KNOWN_EXTENSION_POLICY_MODES;\n/** Public contract for extension policy surfaces, shared by SDK and presentation-layer consumers. */\nexport const EXTENSION_POLICY_SURFACES = KNOWN_EXTENSION_POLICY_SURFACES;\n/** Public contract for extension trust modes, shared by SDK and presentation-layer consumers. */\nexport const EXTENSION_TRUST_MODES = KNOWN_EXTENSION_TRUST_MODES;\n/** Public contract for extension sandbox profiles, shared by SDK and presentation-layer consumers. */\nexport const EXTENSION_SANDBOX_PROFILES = KNOWN_EXTENSION_SANDBOX_PROFILES;\n/** Restricts extension policy mode values accepted by command, SDK, and storage contracts. */\nexport type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];\n/** Restricts extension policy surface values accepted by command, SDK, and storage contracts. */\nexport type ExtensionPolicySurface = (typeof EXTENSION_POLICY_SURFACES)[number];\n/** Restricts extension trust mode values accepted by command, SDK, and storage contracts. */\nexport type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];\n/** Restricts extension sandbox profile values accepted by command, SDK, and storage contracts. */\nexport type ExtensionSandboxProfile =\n  (typeof EXTENSION_SANDBOX_PROFILES)[number];\n\n/** Versioned capability contract metadata emitted by runtime diagnostics. */\nexport {\n  EXTENSION_CAPABILITY_CONTRACT,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n};\n\n/** Least-privilege capability reconciliation helpers: map declared capabilities against the registration surfaces a package actually exercises at activation. */\nexport {\n  EXTENSION_CAPABILITY_REGISTRATION_SURFACES,\n  collectUsedExtensionCapabilities,\n  reconcileExtensionCapabilityUsage,\n  type CollectUsedExtensionCapabilitiesOptions,\n  type ExtensionCapabilityUsageReconciliation,\n} from \"../core/extensions/capability-usage.js\";\n\n/**\n * Render an extension/package activation summary\n * ({@link describeExtensionActivation} / {@link describeExtensionBlueprint}) to a\n * deterministic Markdown reference document — the author-facing *render* leg of\n * the describe verb, for drift-free package READMEs.\n */\nexport {\n  renderExtensionSurfaceMarkdown,\n  type ExtensionSurfaceMarkdownOptions,\n} from \"../core/extensions/activation-summary-markdown.js\";\n\nexport type {\n  AfterCommandAffectedItem,\n  AfterCommandHook,\n  AfterCommandHookContext,\n  BeforeCommandHook,\n  BeforeCommandHookContext,\n  CommandDefinition,\n  ExtensionCommandArgumentDefinition,\n  CommandHandler,\n  CommandHandlerContext,\n  CommandHandlerResult,\n  CommandOverride,\n  CommandOverrideContext,\n  ExtensionServiceName,\n  Exporter,\n  ExtensionActivationResult,\n  ExtensionApi,\n  ExtensionCommandRegistry,\n  ExtensionDeactivationFailure,\n  ExtensionDeactivationOptions,\n  ExtensionDeactivationResult,\n  ExtensionDiagnostic,\n  ExtensionDiscoveryResult,\n  ExtensionHookRegistry,\n  ExtensionSelfIdentity,\n  ExtensionLoadResult,\n  ExtensionManifest,\n  ExtensionManifestEngines,\n  ExtensionGovernancePolicy,\n  ExtensionPolicyOverride,\n  ExtensionProvenanceMetadata,\n  ExtensionRuntimePermissionDeclaration,\n  ExtensionSearchMode,\n  ExtensionParserRegistry,\n  ExtensionPreflightRegistry,\n  ExtensionRegistrationRegistry,\n  ExtensionRendererRegistry,\n  ExtensionServiceRegistry,\n  FlagValueType,\n  FlagDefinition,\n  ImportExportContext,\n  ImportExportRegistrationOptions,\n  Importer,\n  OnIndexHook,\n  OnIndexHookContext,\n  OnReadHook,\n  OnReadHookContext,\n  OnWriteHook,\n  OnWriteHookContext,\n  OutputRendererFormat,\n  ParserOverride,\n  ParserOverrideContext,\n  ParserOverrideDelta,\n  PreflightOverride,\n  PreflightOverrideContext,\n  PreflightOverrideDelta,\n  PreflightRuntimeDecision,\n  RegisteredExtensionExporter,\n  RegisteredExtensionFlagDefinitions,\n  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionProjectProfile,\n  RegisteredExtensionSchemaMigrationDefinition,\n  RegisteredExtensionSearchProvider,\n  RegisteredExtensionServiceOverride,\n  RegisteredExtensionVectorStoreAdapter,\n  RendererOverride,\n  RendererOverrideContext,\n  SchemaFieldDefinition,\n  SchemaItemTypeCommandOptionPolicyDefinition,\n  SchemaItemTypeOptionDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationDefinition,\n  SchemaMigrationRunContext,\n  SchemaMigrationRunner,\n  SearchProviderEmbedBatchContext,\n  SearchProviderEmbedContext,\n  SearchProviderDefinition,\n  SearchProviderHit,\n  SearchProviderQueryContext,\n  SearchProviderQueryResult,\n  ServiceOverride,\n  ServiceOverrideContext,\n  VectorStoreAdapterDefinition,\n  VectorStoreDeleteContext,\n  VectorStoreQueryContext,\n  VectorStoreQueryHit,\n  VectorStoreUpsertContext,\n  VectorStoreUpsertPoint,\n} from \"../core/extensions/loader.js\";\n\nexport type { GlobalOptions } from \"../core/shared/command-types.js\";\nexport type {\n  ItemDocument,\n  ItemMetadata,\n  ItemStatus,\n  ItemType,\n  PmSettings,\n} from \"../types/index.js\";\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,GAQtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,GAG7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,8BAA8B,EAC9B,4BAA4B,EAC5B,oCAAoC,EACpC,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,0BAA0B,GAK3B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,GAGN,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,sBAAsB,EACtB,SAAS,GAEV,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,wBAAwB,EACxB,WAAW,GAIZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EACL,SAAS,IAAI,kBAAkB,GAEhC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EACT,sBAAsB,GAEvB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,SAAS,IAAI,0BAA0B,GAKxC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,SAAS,IAAI,aAAa,GAO3B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,GAIf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,6BAA6B,EAC7B,qCAAqC,EACrC,mCAAmC,EACnC,4BAA4B,EAC5B,4BAA4B,EAC5B,+BAA+B,EAC/B,gCAAgC,EAChC,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EACL,sCAAsC,EACtC,yBAAyB,EACzB,kCAAkC,EAClC,qBAAqB,GAOtB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,EACL,0CAA0C,EAC1C,qBAAqB,EACrB,0CAA0C,EAC1C,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,yBAAyB,EACzB,qBAAqB,EACrB,yCAAyC,EACzC,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACnB,8CAA8C,EAC9C,4CAA4C,EAC5C,wCAAwC,EACxC,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,iCAAiC,EACjC,kCAAkC,EAClC,8BAA8B,EAC9B,gCAAgC,EAChC,mCAAmC,EACnC,iCAAiC,EACjC,+BAA+B,EAC/B,gCAAgC,EAChC,wBAAwB,EACxB,6BAA6B,EAC7B,gCAAgC,EAChC,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,EAC9B,kCAAkC,EAClC,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,8BAA8B,EAC9B,sBAAsB,EACtB,6BAA6B,EAC7B,6BAA6B,EAC7B,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,sCAAsC,EACtC,0BAA0B,EAC1B,mBAAmB,EACnB,sCAAsC,EACtC,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,iCAAiC,EACjC,kCAAkC,EAClC,qCAAqC,EACrC,sCAAsC,EACtC,mCAAmC,EACnC,iCAAiC,EACjC,kCAAkC,EAClC,0CAA0C,EAC1C,eAAe,EACf,kCAAkC,EAClC,yBAAyB,EACzB,+BAA+B,EAC/B,iCAAiC,EACjC,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,wCAAwC,EACxC,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,gCAAgC,EAChC,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,8BAA8B,EAC9B,+BAA+B,EAC/B,8BAA8B,EAC9B,uCAAuC,EACvC,6BAA6B,EAC7B,4BAA4B,EAC5B,0BAA0B,EAC1B,iCAAiC,EACjC,mCAAmC,EACnC,0CAA0C,EAC1C,wCAAwC,EACxC,4BAA4B,EAC5B,8CAA8C,EAC9C,4CAA4C,EAC5C,wCAAwC,EACxC,qBAAqB,EACrB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,+BAA+B,EAC/B,+BAA+B,EAC/B,kCAAkC,EAClC,gCAAgC,EAChC,cAAc,EACd,mCAAmC,EACnC,kCAAkC,EAClC,mCAAmC,EACnC,wCAAwC,EACxC,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAuB5B,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,OAAO,GAOR,MAAM,mBAAmB,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,QAAQ,EACR,gBAAgB,GAEjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GAQpB,MAAM,uBAAuB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AAWnC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,SAAS,EACT,qBAAqB,EACrB,gBAAgB,EAChB,0BAA0B,EAC1B,UAAU,EACV,QAAQ,EACR,WAAW,EACX,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,4BAA4B,EAC5B,kBAAkB,EAClB,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,+BAA+B,EAC/B,YAAY,EACZ,cAAc,EACd,WAAW,EACX,eAAe,EACf,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,UAAU,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,MAAM,EACN,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,EAC3B,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,2BAA2B,EAC3B,4BAA4B,EAC5B,SAAS,EACT,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,OAAO,EACP,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,eAAe,EACf,SAAS,EACT,MAAM,EACN,KAAK,EACL,SAAS,EACT,KAAK,EACL,SAAS,EACT,QAAQ,EACR,MAAM,EACN,OAAO,EACP,IAAI,EACJ,MAAM,EACN,UAAU,EACV,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,KAAK,EACL,aAAa,EACb,KAAK,EACL,EAAE,EACF,GAAG,EACH,KAAK,EACL,MAAM,EACN,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,OAAO,EACP,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,OAAO,EACP,OAAO,EACP,MAAM,EACN,cAAc,EACd,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,SAAS,EACT,KAAK,EACL,MAAM,EACN,OAAO,EACP,QAAQ,GAmKT,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EACL,kCAAkC,EAClC,OAAO,GAIR,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,YAAY,EACZ,qBAAqB,GAGtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,qCAAqC,EACrC,gCAAgC,EAChC,cAAc,EACd,OAAO,EACP,yBAAyB,GAK1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,UAAU,GAIX,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,4BAA4B,EAC5B,kCAAkC,EAClC,8BAA8B,EAC9B,iCAAiC,EACjC,8BAA8B,EAC9B,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,yBAAyB,GAE1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,iBAAiB,GAGlB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,cAAc,GAQf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,sBAAsB,GAavB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,GAIvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,GAMxB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,wBAAwB,EACxB,8BAA8B,EAC9B,0BAA0B,EAC1B,iCAAiC,EACjC,uCAAuC,EACvC,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,+BAA+B,EAC/B,+BAA+B,EAC/B,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,8BAA8B,EAC9B,iCAAiC,EACjC,uBAAuB,EACvB,gCAAgC,EAChC,8BAA8B,EAC9B,+BAA+B,EAC/B,kCAAkC,EAClC,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC3B,2BAA2B,EAC3B,mCAAmC,EACnC,4BAA4B,EAC5B,wBAAwB,EACxB,4BAA4B,EAC5B,6BAA6B,EAC7B,kCAAkC,EAClC,qCAAqC,EACrC,oCAAoC,EACpC,kCAAkC,EAClC,mCAAmC,EACnC,sCAAsC,GA8CvC,MAAM,cAAc,CAAC;AAEtB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AAInE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,sBAAsB,GAAG,4BAA4B,CAAC;AACnE,qGAAqG;AACrG,MAAM,CAAC,MAAM,yBAAyB,GAAG,+BAA+B,CAAC;AACzE,iGAAiG;AACjG,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAC;AACjE,sGAAsG;AACtG,MAAM,CAAC,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;AAW3E,6EAA6E;AAC7E,OAAO,EACL,6BAA6B,EAC7B,qCAAqC,EACrC,mCAAmC,GACpC,CAAC;AAEF,iKAAiK;AACjK,OAAO,EACL,0CAA0C,EAC1C,gCAAgC,EAChC,iCAAiC,GAGlC,MAAM,wCAAwC,CAAC;AAEhD;;;;;GAKG;AACH,OAAO,EACL,8BAA8B,GAE/B,MAAM,mDAAmD,CAAC","debugId":"b7a14a6b-ce17-5650-a2a7-38c07f718633"}
+{"version":3,"file":"index.js","sources":["sdk/index.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/index\n *\n * Defines public SDK APIs and package-author helpers for Index.\n */\nexport {\n  isErrnoError,\n  limitAnnotationEntries,\n  parseAnnotationTextInput,\n  readAnnotationEntries,\n  resolveAnnotationInput,\n  resolveAnnotationIndex,\n  runAnnotationCommand,\n  wrapOwnershipConflict,\n  type AnnotationCommandConfig,\n  type AnnotationCommandOptions,\n  type AnnotationCommandResult,\n  type AnnotationEntry,\n  type AnnotationInput,\n  type AnnotationSourceOptions,\n  type OwnershipConflictGuidance,\n} from \"./annotations.js\";\nexport {\n  inspectHistoryAuthorStream,\n  scanHistoryAuthorAttribution,\n  type HistoryAuthorAttributionScan,\n  type UnknownAuthorHistoryEvent,\n} from \"./author-attribution.js\";\nexport { createPmCliProgram } from \"./cli-program.js\";\nexport { runSearchRefreshWorkerEntrypoint } from \"./search-refresh-worker.js\";\nexport { flushTelemetryQueue } from \"./telemetry-flush.js\";\nexport {\n  EXECUTABLE_COMMAND_ALIASES,\n  applyBootstrapPagerPolicy,\n  coalesceRepeatedListFlags,\n  listAliasPluralKeys,\n  mergeLinkedTestTwoTokenEntries,\n  normalizeBootstrapInvocation,\n  normalizeLegacyExtensionActionSyntax,\n  parseBootstrapCommandName,\n  parseBootstrapGlobalOptions,\n  parseBootstrapHelpRequest,\n  parseBootstrapTypeValue,\n  stripGlobalBootstrapTokens,\n  type BootstrapGlobalOptions,\n  type BootstrapHelpRequest,\n  type BootstrapInvocationNormalizationResult,\n  type BootstrapNormalizationEvent,\n} from \"./cli-bootstrap.js\";\nexport {\n  quoteCommandArg,\n  quoteWindowsCommandArg,\n  renderPmCommand,\n} from \"./command-line.js\";\nexport {\n  runGc,\n  type GcCheckpointsSummary,\n  type GcLocksSummary,\n} from \"./governance/gc.js\";\nexport {\n  _testOnlyHealthCommand,\n  runHealth,\n  type HealthCheck,\n} from \"./governance/health.js\";\nexport {\n  _testOnlyValidateCommand,\n  runValidate,\n  type ValidateCheck,\n  type ValidateFixesSummary,\n  type ValidateMutationServices,\n} from \"./governance/validate.js\";\nexport { runExtension } from \"./extension.js\";\nexport {\n  runWithActiveExtensions,\n  type ActiveExtensionScopeOptions,\n} from \"./runtime.js\";\nexport { applyInvocationAuthorOverride } from \"./invocation-author.js\";\nexport { describeItemOwnershipConflict } from \"./ownership-source.js\";\nexport { discoverNearbyPmRoot } from \"./tracker-root-discovery.js\";\nexport {\n  _testOnly as _testOnlyTemplates,\n  type TemplateSource,\n} from \"./templates.js\";\nexport {\n  runConfig,\n  _testOnlyConfigCommand,\n  type NestedSettingResultValue,\n} from \"./config.js\";\nexport {\n  INIT_AGENT_GUIDANCE_MODE_VALUES,\n  runInitAgentGuidance,\n  _testOnly as _testOnlyInitAgentGuidance,\n  type InitAgentGuidanceMode,\n  type InitAgentGuidanceSummary,\n  type RunInitAgentGuidanceOptions,\n  type RunInitAgentGuidanceResult,\n} from \"./init-agent-guidance.js\";\nexport {\n  runInit,\n  summarizeInitResult,\n  _testOnly as _testOnlyInit,\n  type InitAgentGuidanceResult,\n  type InitConciseResult,\n  type InitInstalledPackagesSummary,\n  type InitRegisteredTypePresetSummary,\n  type InitTargetResolution,\n  type InitTypePresetName,\n} from \"./init.js\";\nexport {\n  PROFILE_SUBCOMMANDS,\n  formatProfileApplyHuman,\n  formatProfileLintHuman,\n  formatProfileListHuman,\n  formatProfileShowHuman,\n  runProfileApply,\n  runProfileLint,\n  runProfileList,\n  runProfileShow,\n  type ProfileApplyDimension,\n  type ProfileComposition,\n  type ProfileListEntry,\n} from \"./profile.js\";\nimport {\n  EXTENSION_CAPABILITY_CONTRACT,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n  KNOWN_EXTENSION_CAPABILITIES,\n  KNOWN_EXTENSION_POLICY_MODES,\n  KNOWN_EXTENSION_POLICY_SURFACES,\n  KNOWN_EXTENSION_SANDBOX_PROFILES,\n  KNOWN_EXTENSION_TRUST_MODES,\n} from \"../core/extensions/loader.js\";\nexport { RESERVED_ITEM_FIELD_NAMES } from \"../core/extensions/item-fields.js\";\nexport {\n  PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS,\n  PM_PACKAGE_RESOURCE_KINDS,\n  collectPackageExtensionDirectories,\n  readPmPackageManifest,\n  type PmPackageCatalogLinkMap,\n  type PmPackageCatalogMediaMap,\n  type PmPackageCatalogMetadata,\n  type PmPackageManifest,\n  type PmPackageResourceKind,\n  type PmPackageResourceMap,\n} from \"../core/packages/manifest.js\";\nexport type {\n  CommanderOptionAliasContract,\n  CommanderOptionRegistrationContract,\n} from \"./cli-contracts.js\";\nexport {\n  ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,\n  APPEND_FLAG_CONTRACTS,\n  CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS,\n  CALENDAR_FLAG_CONTRACTS,\n  CLAIM_FLAG_CONTRACTS,\n  CLOSE_FLAG_CONTRACTS,\n  CLOSE_MANY_FLAG_CONTRACTS,\n  CLOSE_TASK_FLAG_CONTRACTS,\n  COMMENTS_FLAG_CONTRACTS,\n  COMPLETION_FLAG_CONTRACTS,\n  CONFIG_FLAG_CONTRACTS,\n  CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,\n  CONTEXT_FLAG_CONTRACTS,\n  CONTRACTS_FLAG_CONTRACTS,\n  COPY_FLAG_CONTRACTS,\n  CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,\n  CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,\n  CREATE_COMMANDER_STRING_OPTION_CONTRACTS,\n  CREATE_FLAG_CONTRACTS,\n  DELETE_FLAG_CONTRACTS,\n  DEPS_FLAG_CONTRACTS,\n  DOCS_FLAG_CONTRACTS,\n  EVAL_FLAG_CONTRACTS,\n  EXTENSION_ACTIVATE_FLAG_CONTRACTS,\n  EXTENSION_ADOPT_ALL_FLAG_CONTRACTS,\n  EXTENSION_ADOPT_FLAG_CONTRACTS,\n  EXTENSION_CATALOG_FLAG_CONTRACTS,\n  EXTENSION_DEACTIVATE_FLAG_CONTRACTS,\n  EXTENSION_DESCRIBE_FLAG_CONTRACTS,\n  EXTENSION_DOCTOR_FLAG_CONTRACTS,\n  EXTENSION_EXPLORE_FLAG_CONTRACTS,\n  EXTENSION_FLAG_CONTRACTS,\n  EXTENSION_INIT_FLAG_CONTRACTS,\n  EXTENSION_INSTALL_FLAG_CONTRACTS,\n  EXTENSION_MANAGE_FLAG_CONTRACTS,\n  EXTENSION_RELOAD_FLAG_CONTRACTS,\n  EXTENSION_SCOPE_FLAG_CONTRACTS,\n  EXTENSION_UNINSTALL_FLAG_CONTRACTS,\n  FILES_FLAG_CONTRACTS,\n  FOCUS_FLAG_CONTRACTS,\n  GC_FLAG_CONTRACTS,\n  GET_FLAG_CONTRACTS,\n  GLOBAL_FLAG_CONTRACTS,\n  GUIDE_FLAG_CONTRACTS,\n  HEALTH_FLAG_CONTRACTS,\n  HISTORY_COMPACT_FLAG_CONTRACTS,\n  HISTORY_FLAG_CONTRACTS,\n  HISTORY_REDACT_FLAG_CONTRACTS,\n  HISTORY_REPAIR_FLAG_CONTRACTS,\n  INIT_FLAG_CONTRACTS,\n  INSTALL_FLAG_CONTRACTS,\n  LEARNINGS_FLAG_CONTRACTS,\n  LIST_COMMANDER_STRING_OPTION_CONTRACTS,\n  LIST_FILTER_FLAG_CONTRACTS,\n  MEET_FLAG_CONTRACTS,\n  NEXT_COMMANDER_STRING_OPTION_CONTRACTS,\n  NEXT_FLAG_CONTRACTS,\n  NOTES_FLAG_CONTRACTS,\n  PACKAGE_FLAG_CONTRACTS,\n  PACKAGE_INIT_FLAG_CONTRACTS,\n  PAUSE_TASK_FLAG_CONTRACTS,\n  PLAN_FLAG_CONTRACTS,\n  PM_CORE_COMMAND_NAMES,\n  PM_EXTENSION_CAPABILITY_CONTRACTS,\n  PM_EXTENSION_POLICY_MODE_CONTRACTS,\n  PM_EXTENSION_POLICY_SURFACE_CONTRACTS,\n  PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS,\n  PM_EXTENSION_SERVICE_NAME_CONTRACTS,\n  PM_EXTENSION_TRUST_MODE_CONTRACTS,\n  PM_PROVIDER_TOOL_PARAMETERS_SCHEMA,\n  PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION,\n  PM_TOOL_ACTIONS,\n  PM_TOOL_ACTION_PARAMETER_CONTRACTS,\n  PM_TOOL_PARAMETERS_SCHEMA,\n  PM_TOOL_PARAMETERS_SCHEMA_MAJOR,\n  PM_TOOL_PARAMETERS_SCHEMA_VERSION,\n  PROFILE_FLAG_CONTRACTS,\n  REINDEX_FLAG_CONTRACTS,\n  RELEASE_FLAG_CONTRACTS,\n  REMIND_FLAG_CONTRACTS,\n  RESTORE_FLAG_CONTRACTS,\n  SCHEMA_FLAG_CONTRACTS,\n  SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,\n  SEARCH_FLAG_CONTRACTS,\n  START_TASK_FLAG_CONTRACTS,\n  STATS_FLAG_CONTRACTS,\n  SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,\n  TELEMETRY_FLAG_CONTRACTS,\n  TEST_ALL_FLAG_CONTRACTS,\n  TEST_FLAG_CONTRACTS,\n  TEST_RUNS_FLAG_CONTRACTS,\n  TOOL_ACTIVITY_OPTION_CONTRACTS,\n  TOOL_AGGREGATE_OPTION_CONTRACTS,\n  TOOL_CALENDAR_OPTION_CONTRACTS,\n  TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS,\n  TOOL_CONTEXT_OPTION_CONTRACTS,\n  TOOL_CREATE_OPTION_CONTRACTS,\n  TOOL_DEPS_OPTION_CONTRACTS,\n  TOOL_LIST_FILTER_OPTION_CONTRACTS,\n  TOOL_SEARCH_FILTER_OPTION_CONTRACTS,\n  TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS,\n  TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS,\n  TOOL_UPDATE_OPTION_CONTRACTS,\n  UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,\n  UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,\n  UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,\n  UPDATE_FLAG_CONTRACTS,\n  UPDATE_MANY_FLAG_CONTRACTS,\n  UPGRADE_FLAG_CONTRACTS,\n  compactFlagAliasContracts,\n  isPmExtensionCapabilityContract,\n  isPmExtensionPolicyModeContract,\n  isPmExtensionPolicySurfaceContract,\n  isPmExtensionServiceNameContract,\n  isPmToolAction,\n  readFirstStringFromCommanderOptions,\n  readFirstValueFromCommanderOptions,\n  readStringArrayFromCommanderOptions,\n  resolveSubcommandFlagContractsForCommand,\n  toCompletionFlagString,\n  withFlagAliasMetadata,\n} from \"./cli-contracts.js\";\nexport type {\n  CliFlagContract,\n  OptionsFromContracts,\n  PmActionSchemaContract,\n  PmBulkMutationControlOptions,\n  PmBulkMutationFilterOptions,\n  PmCloseActionOptions,\n  PmCloseManyActionOptions,\n  PmCreateActionOptions,\n  PmMutationAttributionOptions,\n  PmOptionScalar,\n  PmUpdateActionOptions,\n  PmUpdateManyActionOptions,\n  PmExtensionCapabilityContract,\n  PmExtensionPolicyModeContract,\n  PmExtensionPolicySurfaceContract,\n  PmExtensionSandboxProfileContract,\n  PmExtensionServiceNameContract,\n  PmExtensionTrustModeContract,\n  PmToolAction,\n  ToolOptionFlagContract,\n} from \"./cli-contracts.js\";\nexport * from \"./compose.js\";\nexport * from \"./context-relevance.js\";\nexport * from \"./context-packing.js\";\nexport * from \"./context-usage.js\";\nexport * from \"./history-compact.js\";\nexport * from \"./history-read.js\";\nexport * from \"./history-redact.js\";\nexport * from \"./history-repair.js\";\nexport * from \"./item-children.js\";\nexport * from \"./item-schedule.js\";\nexport * from \"./merge/index.js\";\nexport {\n  runDeps,\n  type DepsCollapseMode,\n  type DepsFormat,\n  type DepsGraphEdge,\n  type DepsGraphNode,\n  type DepsGraphResult,\n  type DepsTreeNode,\n} from \"./dependencies.js\";\nexport * from \"./graph/index.js\";\nexport { runDocs } from \"./docs.js\";\nexport {\n  runFiles,\n  runFilesDiscover,\n  type FilesDiscoveryCandidate,\n} from \"./files.js\";\nexport {\n  applyPathMigrations,\n  applyStandaloneNote,\n  artifactKey,\n  dedupeLinkedArtifacts,\n  ensureScope,\n  expandAddGlobEntries,\n  normalizeLinkedPath,\n  parseAddEntries,\n  parseAddGlobEntries,\n  parseMigrateEntries,\n  parseRemoveEntries,\n  renameArtifactsResultKey,\n  runLinkedArtifacts,\n  sortLinkedArtifacts,\n  validateLinkedPaths,\n  type AddGlobEntry,\n  type LinkedArtifact,\n  type LinkedArtifactCommandOptions,\n  type LinkedArtifactKindConfig,\n  type LinkedArtifactResult,\n  type LinkedPathValidation,\n  type PathMigration,\n} from \"./linked-artifacts.js\";\nexport * from \"./pagination.js\";\nexport * from \"./query/item-filter-options.js\";\nexport * from \"./query/parsers.js\";\nexport * from \"./output.js\";\nexport * from \"./relationship-analytics.js\";\nexport * from \"./relationship-context.js\";\nexport * from \"./relationship-history.js\";\nexport * from \"./workspace-transaction.js\";\nexport * from \"./workspace-transaction-gc.js\";\nexport * from \"./item-transaction.js\";\nexport * from \"./structured-mutations.js\";\nexport * from \"./runtime-primitives.js\";\nexport * from \"./error-runtime.js\";\nexport * from \"./relationships.js\";\nexport * from \"./actionability.js\";\nexport type {\n  PlanCommandOptions,\n  PlanCommandResult,\n  PlanDispatchInput,\n  PlanResultPlan,\n  PlanShowDepth,\n  PlanStepSummary,\n  PlanSubcommand,\n  PlanTemplateName,\n} from \"../cli/commands/plan.js\";\nexport {\n  PLAN_SHOW_DEPTH_VALUES,\n  PLAN_SUBCOMMANDS,\n  PLAN_TEMPLATE_NAMES,\n} from \"../cli/commands/plan.js\";\nexport * from \"./define.js\";\nexport {\n  BASELINE_ITEM_FORMAT_VERSION,\n  BUILTIN_ITEM_TYPE_VALUES,\n  CONFIDENCE_TEXT_VALUES,\n  CURRENT_ITEM_FORMAT_VERSION,\n  DEPENDENCY_KIND_VALUES,\n  EXIT_CODE,\n  ISSUE_SEVERITY_VALUES,\n  ITEM_TYPE_VALUES,\n  PM_CLI_EXPECTED_ERROR_NAME,\n  PmCliError,\n  PmClient,\n  RISK_VALUES,\n  STATUS_VALUES,\n  acquireLock,\n  appendHistoryEntry,\n  canonicalDocument,\n  classifyItemFormatVersion,\n  clearWorkspaceContractsCache,\n  commitImportedItem,\n  createHistoryEntry,\n  createPmCliExpectedError,\n  effectiveItemFormatVersion,\n  emptyImportedDocument,\n  ensureTrackerInitialized,\n  generateItemId,\n  getActiveExtensionRegistrations,\n  getContracts,\n  getHistoryPath,\n  getItemPath,\n  getSettingsPath,\n  getWorkspaceContracts,\n  isPmCliExpectedError,\n  isTimestampLiteral,\n  listAllItemMetadata,\n  loadCreateTemplateOptions,\n  locateItem,\n  normalizeItemMetadata,\n  normalizeItemFormatVersion,\n  normalizeItemId,\n  normalizeRawItemId,\n  normalizeStatusInput,\n  nowIso,\n  parseTags,\n  pathExists,\n  readBooleanOption,\n  readCsvListOption,\n  readFileIfExists,\n  readLocatedItem,\n  readRequiredString,\n  readSettings,\n  readStringOption,\n  removeFileIfExists,\n  renderCalendarMarkdown,\n  renderCalendarToon,\n  renderGuideMarkdown,\n  resolveCalendarOutputFormat,\n  resolveGuideOutputFormat,\n  resolveItemTypeRegistry,\n  resolvePmRoot,\n  resolveRuntimeFieldRegistry,\n  resolveRuntimeStatusRegistry,\n  runAction,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n  runCalendar,\n  runCompletion,\n  runGuide,\n  runList,\n  runReindex,\n  runSearch,\n  runTemplatesList,\n  runTemplatesSave,\n  runTemplatesShow,\n  runTestRunsList,\n  runTestRunsLogs,\n  runTestRunsResume,\n  runTestRunsStatus,\n  runTestRunsStop,\n  scanItemFormatVersions,\n  selectImportAuthor,\n  serializeItemDocument,\n  splitFrontMatter,\n  toEstimatedMinutesValue,\n  toImportBoolean,\n  toImportConfidence,\n  toImportInteger,\n  toImportLinkedDocs,\n  toImportLinkedFiles,\n  toImportLinkedTests,\n  toImportLogEntries,\n  toImportNormalizedEnum,\n  toImportNumberMap,\n  toImportPriority,\n  toImportStatus,\n  toImportStringList,\n  toImportStringMap,\n  toImportTags,\n  toNonEmptyImportString,\n  writeFileAtomic,\n  aggregate,\n  append,\n  claim,\n  claimNext,\n  close,\n  closeTask,\n  comments,\n  config,\n  context,\n  copy,\n  create,\n  deleteItem,\n  deps,\n  docs,\n  extension,\n  extensionActivate,\n  extensionDeactivate,\n  extensionList,\n  files,\n  filesDiscover,\n  focus,\n  gc,\n  get,\n  graph,\n  health,\n  historyCompact,\n  historyCompactBulk,\n  historyRedact,\n  historyRepair,\n  historyRepairAll,\n  init,\n  learnings,\n  list,\n  next,\n  notes,\n  packageActivate,\n  packageCatalog,\n  packageDeactivate,\n  packageDescribe,\n  packageDoctor,\n  packageInstall,\n  packageLifecycle,\n  packageList,\n  packageManage,\n  packageReload,\n  packageUninstall,\n  pauseTask,\n  profile,\n  profileApply,\n  profileLint,\n  profileList,\n  profileShow,\n  release,\n  restore,\n  schema,\n  schemaAddField,\n  schemaAddStatus,\n  schemaAddType,\n  schemaApplyPreset,\n  schemaInferTypes,\n  schemaList,\n  schemaListFields,\n  schemaRemoveField,\n  schemaRemoveStatus,\n  schemaRemoveType,\n  schemaShow,\n  schemaShowField,\n  schemaShowStatus,\n  search,\n  startTask,\n  stats,\n  update,\n  upgrade,\n  validate,\n  type AggregateOptions,\n  type AggregateResult,\n  type AggregateRow,\n  type AppendCommandOptions,\n  type AppendResult,\n  type BlockerEntry,\n  type CalendarOptions,\n  type CalendarResult,\n  type ClaimResult,\n  type CloseResult,\n  type CloseTaskResult,\n  type CommitImportedItemParams,\n  type CommitImportedItemResult,\n  type CommentsCommandOptions,\n  type CommentsResult,\n  type ConfigCommandOptions,\n  type ConfigResult,\n  type CompletionResult,\n  type CompletionShell,\n  type ContractsCommandOptions,\n  type ContractsResult,\n  type ContextFocusItem,\n  type ContextOptions,\n  type ContextOutputFormat,\n  type ContextResult,\n  type CopyResult,\n  type CreatePmCliExpectedErrorOptions,\n  type CreateResult,\n  type CreateTemplateOptions,\n  type Dependency,\n  type DeleteResult,\n  type DepsCommandOptions,\n  type DepsResult,\n  type DocsCommandOptions,\n  type DocsResult,\n  type ExtensionCommandOptions,\n  type ExtensionCommandResult,\n  type FilesCommandOptions,\n  type FilesDiscoverOptions,\n  type FilesDiscoverResult,\n  type FilesResult,\n  type FocusResult,\n  type GcCommandOptions,\n  type GcResult,\n  type GetContractsOptions,\n  type GetOptions,\n  type GetResult,\n  type GuideDepth,\n  type GuideOptions,\n  type GuideOutputFormat,\n  type GuideResult,\n  type HealthResult,\n  type ImportLinkedScope,\n  type InitCommandOptions,\n  type InitResult,\n  type ItemFormatVersionScanEntry,\n  type ItemFormatVersionScanResult,\n  type ItemFormatVersionStatus,\n  type LearningsCommandOptions,\n  type LearningsResult,\n  type LinkedDoc,\n  type LinkedFile,\n  type LinkedTest,\n  type ListedItem,\n  type ListCompactResult,\n  type ListFullResult,\n  type ListOptions,\n  type ListProjectedItem,\n  type ListProjectedItemCore,\n  type ListResult,\n  type ListResultItem,\n  type ListSortField,\n  type ListSortOrder,\n  type ListTreeItem,\n  type ListTreeMetadata,\n  type ListVerboseResult,\n  type LogNote,\n  type NextActionableItem,\n  type NextBlockerRef,\n  type NextOptions,\n  type NextOutputFormat,\n  type NextRecommendation,\n  type NextResult,\n  type NotesCommandOptions,\n  type NotesResult,\n  type PackageCommandOptions,\n  type PackageCommandResult,\n  type PauseTaskResult,\n  type PmActionInput,\n  type PmActionName,\n  type PmActionOptions,\n  type PmClientCloseActionOptions,\n  type PmClientFullMutationOptions,\n  type PmClientMutationOptions,\n  type PmClientOptions,\n  type PmClientRunArgs,\n  type PmCliExpectedError,\n  type ProfileApplyCommandOptions,\n  type ProfileApplyResult,\n  type ProfileLintResult,\n  type ProfileListResult,\n  type ProfileResult,\n  type ProfileShowResult,\n  type ProfileSubcommand,\n  type ReindexOptions,\n  type ReindexResult,\n  type ReleaseResult,\n  type RestoreResult,\n  type RunHealthOptions,\n  type SchemaAddFieldCommandOptions,\n  type SchemaAddFieldResult,\n  type SchemaAddStatusCommandOptions,\n  type SchemaAddStatusResult,\n  type SchemaAddTypeCommandOptions,\n  type SchemaAddTypeInferCommandOptions,\n  type SchemaAddTypeInferResult,\n  type SchemaAddTypeResult,\n  type SchemaApplyPresetCommandOptions,\n  type SchemaApplyPresetResult,\n  type SchemaInspectResult,\n  type SchemaListFieldsResult,\n  type SchemaListResult,\n  type SchemaRemoveFieldCommandOptions,\n  type SchemaRemoveFieldResult,\n  type SchemaRemoveStatusCommandOptions,\n  type SchemaRemoveStatusResult,\n  type SchemaRemoveTypeCommandOptions,\n  type SchemaRemoveTypeResult,\n  type SchemaShowFieldResult,\n  type SchemaShowResult,\n  type SchemaShowStatusResult,\n  type SchemaResult,\n  type SchemaSubcommand,\n  type SearchCompactResult,\n  type SearchHit,\n  type SearchHitHighlight,\n  type SearchMatchMode,\n  type SearchOptions,\n  type ClaimNextOptions,\n  type SearchResult,\n  type SearchResultItem,\n  type SearchVerboseResult,\n  type StartTaskResult,\n  type StatsCommandOptions,\n  type StatsResult,\n  type TemplatesListResult,\n  type TemplatesSaveResult,\n  type TemplatesShowResult,\n  type TestRunsListCommandOptions,\n  type TestRunsLogsCommandOptions,\n  type TestRunsResumeCommandOptions,\n  type TestRunsStopCommandOptions,\n  type ToImportLinkedArtifactsOptions,\n  type ToImportLinkedTestsOptions,\n  type ToImportLogEntriesOptions,\n  type UpdateResult,\n  type UpgradeCommandOptions,\n  type UpgradeResult,\n  type ValidateCommandOptions,\n  type ValidateResult,\n  type WorkspaceContracts,\n  type WorkspaceContractsOptions,\n} from \"./runtime.js\";\nexport { runStats } from \"./stats.js\";\nexport {\n  DEFAULT_EVAL_QUERIES_RELATIVE_PATH,\n  runEval,\n  type EvalOptions,\n  type EvalQueryReport,\n  type EvalResult,\n} from \"./eval.js\";\nexport {\n  runTelemetry,\n  TELEMETRY_SUBCOMMANDS,\n  type TelemetryCommandOptions,\n  type TelemetrySubcommand,\n} from \"./telemetry.js\";\nexport {\n  classifyLinkedTestFailure,\n  countFailureCategories,\n  extractReferencedPmItemIdsFromCommand,\n  resolveLinkedTestFailureExitCode,\n  runLinkedTests,\n  runTest,\n  summarizeContextPreflight,\n  type LinkedTestFailureCategory,\n  type TestCommandOptions,\n  type TestResult,\n  type TestRunResult,\n} from \"./test/execution.js\";\nexport {\n  runTestAll,\n  type TestAllCommandOptions,\n  type TestAllItemResult,\n  type TestAllResult,\n} from \"./test/batch.js\";\nexport {\n  LINKED_TEST_ENV_NAME_PATTERN,\n  LINKED_TEST_PM_CONTEXT_MODE_VALUES,\n  LINKED_TEST_PROTECTED_ENV_KEYS,\n  parseLinkedTestAssertionEqualsMap,\n  parseLinkedTestAssertionGteMap,\n  parseLinkedTestBoolean,\n  parseLinkedTestContextMode,\n  parseLinkedTestEnvClear,\n  parseLinkedTestEnvSet,\n  parseLinkedTestJsonEntries,\n  parseLinkedTestMinLines,\n  parseLinkedTestRegexList,\n  parseLinkedTestStringList,\n  type LinkedTestPmContextMode,\n} from \"./test/parsers.js\";\nexport {\n  runStartBackgroundRun,\n  runTestRunsWorker,\n  type StartBackgroundRunCommandOptions,\n  type StartBackgroundRunResult,\n} from \"./test/runs.js\";\nexport {\n  BUILTIN_PROFILES,\n  listProfiles,\n  normalizeProfileName,\n  PROFILE_NAMES,\n  resolveProfile,\n  type ProfileConfigEntry,\n  type ProfileName,\n  type ProfilePackageRecommendation,\n  type ProfileTemplateEntry,\n  type ProfileTemplateOptions,\n  type ProjectProfileDefinition,\n  type ProjectProfileRegistrationInput,\n} from \"../core/profile/profile-presets.js\";\nexport {\n  planProfileApplication,\n  type ProfileApplicationPlan,\n  type ProfileChangeStatus,\n  type ProfileComponentChange,\n  type ProfileConfigChange,\n  type ProfileConfigPlan,\n  type ProfileCurrentState,\n  type ProfilePackagePlan,\n  type ProfileSchemaPlan,\n  type ProfileTemplateChange,\n  type ProfileTemplatePlan,\n  type ProfileWorkflowChange,\n  type ProfileWorkflowPlan,\n} from \"../core/profile/profile-plan.js\";\nexport {\n  describeProfileComposition,\n  describeProjectProfile,\n  type ProjectProfileComposition,\n  type ProjectProfileDescription,\n  type ProjectProfilePackageSummary,\n} from \"../core/profile/profile-describe.js\";\nexport {\n  lintProjectProfile,\n  PROFILE_LINT_CODES,\n  PROFILE_LINT_DIMENSIONS,\n  type ProfileLintCode,\n  type ProfileLintDimension,\n  type ProfileLintSeverity,\n  type ProjectProfileLintFinding,\n  type ProjectProfileLintReport,\n} from \"../core/profile/profile-lint.js\";\nexport {\n  assertExtensionBlueprint,\n  assertExtensionCapabilityUsage,\n  assertExtensionDeactivated,\n  assertExtensionManifestCompatible,\n  assertExtensionManifestMatchesBlueprint,\n  assertExtensionPreflight,\n  assertPackageManifest,\n  assertProjectProfile,\n  assertRegisteredCommandContract,\n  assertRegisteredCommandOverride,\n  assertRegisteredExporter,\n  assertRegisteredFlags,\n  assertRegisteredHook,\n  assertRegisteredImporter,\n  assertRegisteredItemField,\n  assertRegisteredItemType,\n  assertRegisteredMigration,\n  assertRegisteredParserOverride,\n  assertRegisteredPreflightOverride,\n  assertRegisteredProfile,\n  assertRegisteredRendererOverride,\n  assertRegisteredSearchProvider,\n  assertRegisteredServiceOverride,\n  assertRegisteredVectorStoreAdapter,\n  activateExtensionForTest,\n  createExtensionTestHarness,\n  deactivateExtensionForTest,\n  describeExtensionActivation,\n  runRegisteredCommandForTest,\n  runRegisteredCommandOverrideForTest,\n  runRegisteredExporterForTest,\n  runRegisteredHookForTest,\n  runRegisteredImporterForTest,\n  runRegisteredMigrationForTest,\n  runRegisteredParserOverrideForTest,\n  runRegisteredPreflightOverrideForTest,\n  runRegisteredRendererOverrideForTest,\n  runRegisteredSearchProviderForTest,\n  runRegisteredServiceOverrideForTest,\n  runRegisteredVectorStoreAdapterForTest,\n  type ActivateExtensionForTestOptions,\n  type AssertProjectProfileOptions,\n  type DeactivateExtensionForTestOptions,\n  type DescribeExtensionActivationOptions,\n  type ExtensionActivationSummary,\n  type RenderExtensionHarnessMarkdownOptions,\n  type RunRegisteredCommandForTestOptions,\n  type RunRegisteredExporterForTestOptions,\n  type RunRegisteredHookForTestOptions,\n  type RunRegisteredImporterForTestOptions,\n  type RunRegisteredMigrationForTestOptions,\n  type RunRegisteredSearchProviderForTestOptions,\n  type RunRegisteredVectorStoreAdapterForTestOptions,\n  type SearchProviderOperationContexts,\n  type SearchProviderOperationResults,\n  type VectorStoreAdapterOperationContexts,\n  type VectorStoreAdapterOperationResults,\n  type ExtensionCapabilityUsageAssertion,\n  type ExtensionCapabilityUsageExpectation,\n  type ExtensionDeactivationExpectation,\n  type ExtensionManifestBlueprintMatch,\n  type ExtensionTestHarness,\n  type PackageManifestExpectation,\n  type PackageManifestResourceExpectation,\n  type RegisteredCommandContractAssertion,\n  type RegisteredCommandContractExpectation,\n  type RegisteredCommandOverrideExpectation,\n  type RegisteredExporterExpectation,\n  type RegisteredFlagsExpectation,\n  type RegisteredHookExpectation,\n  type RegisteredHookKind,\n  type RegisteredImporterExpectation,\n  type RegisteredItemFieldAssertion,\n  type RegisteredItemFieldExpectation,\n  type RegisteredItemTypeAssertion,\n  type RegisteredItemTypeExpectation,\n  type RegisteredMigrationExpectation,\n  type RegisteredParserOverrideExpectation,\n  type RegisteredPreflightOverrideExpectation,\n  type RegisteredProfileAssertion,\n  type RegisteredProfileExpectation,\n  type RegisteredRendererOverrideExpectation,\n  type RegisteredSearchProviderExpectation,\n  type RegisteredServiceOverrideExpectation,\n  type RegisteredVectorStoreAdapterExpectation,\n} from \"./testing.js\";\n\n/**\n * Canonical extension capability names accepted by pm.\n *\n * Extension manifests should declare one or more of these values in\n * `capabilities`.\n */\nexport const EXTENSION_CAPABILITIES = KNOWN_EXTENSION_CAPABILITIES;\n/** Restricts extension capability values accepted by command, SDK, and storage contracts. */\nexport type ExtensionCapability = (typeof EXTENSION_CAPABILITIES)[number];\n\n/** Canonical extension governance policy modes and registration surfaces. */\nexport const EXTENSION_POLICY_MODES = KNOWN_EXTENSION_POLICY_MODES;\n/** Public contract for extension policy surfaces, shared by SDK and presentation-layer consumers. */\nexport const EXTENSION_POLICY_SURFACES = KNOWN_EXTENSION_POLICY_SURFACES;\n/** Public contract for extension trust modes, shared by SDK and presentation-layer consumers. */\nexport const EXTENSION_TRUST_MODES = KNOWN_EXTENSION_TRUST_MODES;\n/** Public contract for extension sandbox profiles, shared by SDK and presentation-layer consumers. */\nexport const EXTENSION_SANDBOX_PROFILES = KNOWN_EXTENSION_SANDBOX_PROFILES;\n/** Restricts extension policy mode values accepted by command, SDK, and storage contracts. */\nexport type ExtensionPolicyMode = (typeof EXTENSION_POLICY_MODES)[number];\n/** Restricts extension policy surface values accepted by command, SDK, and storage contracts. */\nexport type ExtensionPolicySurface = (typeof EXTENSION_POLICY_SURFACES)[number];\n/** Restricts extension trust mode values accepted by command, SDK, and storage contracts. */\nexport type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];\n/** Restricts extension sandbox profile values accepted by command, SDK, and storage contracts. */\nexport type ExtensionSandboxProfile =\n  (typeof EXTENSION_SANDBOX_PROFILES)[number];\n\n/** Versioned capability contract metadata emitted by runtime diagnostics. */\nexport {\n  EXTENSION_CAPABILITY_CONTRACT,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n};\n\n/** Least-privilege capability reconciliation helpers: map declared capabilities against the registration surfaces a package actually exercises at activation. */\nexport {\n  EXTENSION_CAPABILITY_REGISTRATION_SURFACES,\n  collectUsedExtensionCapabilities,\n  reconcileExtensionCapabilityUsage,\n  type CollectUsedExtensionCapabilitiesOptions,\n  type ExtensionCapabilityUsageReconciliation,\n} from \"../core/extensions/capability-usage.js\";\n\n/**\n * Render an extension/package activation summary\n * ({@link describeExtensionActivation} / {@link describeExtensionBlueprint}) to a\n * deterministic Markdown reference document — the author-facing *render* leg of\n * the describe verb, for drift-free package READMEs.\n */\nexport {\n  renderExtensionSurfaceMarkdown,\n  type ExtensionSurfaceMarkdownOptions,\n} from \"../core/extensions/activation-summary-markdown.js\";\n\nexport type {\n  AfterCommandAffectedItem,\n  AfterCommandHook,\n  AfterCommandHookContext,\n  BeforeCommandHook,\n  BeforeCommandHookContext,\n  CommandDefinition,\n  ExtensionCommandArgumentDefinition,\n  CommandHandler,\n  CommandHandlerContext,\n  CommandHandlerResult,\n  CommandOverride,\n  CommandOverrideContext,\n  ExtensionServiceName,\n  Exporter,\n  ExtensionActivationResult,\n  ExtensionApi,\n  ExtensionCommandRegistry,\n  ExtensionDeactivationFailure,\n  ExtensionDeactivationOptions,\n  ExtensionDeactivationResult,\n  ExtensionDiagnostic,\n  ExtensionDiscoveryResult,\n  ExtensionHookRegistry,\n  ExtensionSelfIdentity,\n  ExtensionLoadResult,\n  ExtensionManifest,\n  ExtensionManifestEngines,\n  ExtensionGovernancePolicy,\n  ExtensionPolicyOverride,\n  ExtensionProvenanceMetadata,\n  ExtensionRuntimePermissionDeclaration,\n  ExtensionSearchMode,\n  ExtensionParserRegistry,\n  ExtensionPreflightRegistry,\n  ExtensionRegistrationRegistry,\n  ExtensionRendererRegistry,\n  ExtensionServiceRegistry,\n  FlagValueType,\n  FlagDefinition,\n  ImportExportContext,\n  ImportExportRegistrationOptions,\n  Importer,\n  OnIndexHook,\n  OnIndexHookContext,\n  OnReadHook,\n  OnReadHookContext,\n  OnWriteHook,\n  OnWriteHookContext,\n  OutputRendererFormat,\n  ParserOverride,\n  ParserOverrideContext,\n  ParserOverrideDelta,\n  PreflightOverride,\n  PreflightOverrideContext,\n  PreflightOverrideDelta,\n  PreflightRuntimeDecision,\n  RegisteredExtensionExporter,\n  RegisteredExtensionFlagDefinitions,\n  RegisteredExtensionHook,\n  RegisteredExtensionImporter,\n  RegisteredExtensionProjectProfile,\n  RegisteredExtensionSchemaMigrationDefinition,\n  RegisteredExtensionSearchProvider,\n  RegisteredExtensionServiceOverride,\n  RegisteredExtensionVectorStoreAdapter,\n  RendererOverride,\n  RendererOverrideContext,\n  SchemaFieldDefinition,\n  SchemaItemTypeCommandOptionPolicyDefinition,\n  SchemaItemTypeOptionDefinition,\n  SchemaItemTypeDefinition,\n  SchemaMigrationDefinition,\n  SchemaMigrationRunContext,\n  SchemaMigrationRunner,\n  SearchProviderEmbedBatchContext,\n  SearchProviderEmbedContext,\n  SearchProviderDefinition,\n  SearchProviderHit,\n  SearchProviderQueryContext,\n  SearchProviderQueryResult,\n  ServiceOverride,\n  ServiceOverrideContext,\n  VectorStoreAdapterDefinition,\n  VectorStoreDeleteContext,\n  VectorStoreQueryContext,\n  VectorStoreQueryHit,\n  VectorStoreUpsertContext,\n  VectorStoreUpsertPoint,\n} from \"../core/extensions/loader.js\";\n\nexport type { GlobalOptions } from \"../core/shared/command-types.js\";\nexport type {\n  ItemDocument,\n  ItemMetadata,\n  ItemStatus,\n  ItemType,\n  PmSettings,\n} from \"../types/index.js\";\n"],"names":[],"mappings":"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","debugId":"42f4193d-7f0c-50b4-b12c-a5b8add83520"}

package/dist/sdk/runtime-input.js

@@ -5,7 +5,7 @@
  * primitives are shared by native action dispatchers and MCP-specific adapters.
  */
 
-!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]="9c53751c-01db-59ad-a024-b761d4b08030")}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]="d6daa01a-e405-5f34-b647-c467cc11ee15")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { asRecordClone } from "../core/shared/primitives.js";
@@ -348,6 +348,7 @@ function readGraphBoundOption(value) {
 export function graphOptionsFromFlat(options) {
     const kind = readGraphIdListOption(options.kind);
     const exemptIsolate = readGraphIdListOption(options.exemptIsolate);
+    const exemptIsolateType = readGraphIdListOption(options.exemptIsolateType);
     return {
         ...(kind === undefined ? {} : { kind }),
         maxDepth: readGraphBoundOption(options.maxDepth),
@@ -357,6 +358,10 @@ export function graphOptionsFromFlat(options) {
         maxPaths: readGraphBoundOption(options.maxPaths),
         sample: readGraphBoundOption(options.sample),
         ...(exemptIsolate === undefined ? {} : { exemptIsolate }),
+        ...(exemptIsolateType === undefined ? {} : { exemptIsolateType }),
+        saveBaseline: options.saveBaseline === true,
+        rebuild: options.rebuild === true,
+        clear: options.clear === true,
         summary: options.summary === true,
     };
 }
@@ -478,4 +483,4 @@ export function updateManyOptionsFromFlat(options) {
     };
 }
 //# sourceMappingURL=runtime-input.js.map
-//# debugId=9c53751c-01db-59ad-a024-b761d4b08030
+//# debugId=d6daa01a-e405-5f34-b647-c467cc11ee15

package/dist/sdk/runtime-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-input.js","sources":["sdk/runtime-input.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/runtime-input\n *\n * Normalizes untyped action payload values at the SDK runtime boundary. These\n * primitives are shared by native action dispatchers and MCP-specific adapters.\n */\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { asRecordClone } from \"../core/shared/primitives.js\";\nimport {\n  normalizeListOptions,\n  normalizeUpdateOptions,\n} from \"../cli/registration-helpers.js\";\nimport type { CloseManyCommandOptions } from \"../cli/commands/close-many.js\";\nimport type { UpdateManyCommandOptions } from \"../cli/commands/update-many.js\";\nimport { UPDATE_COMMANDER_STRING_OPTION_CONTRACTS } from \"./cli-contracts/commander-mutation-options.js\";\nimport type { GraphCommandOptions } from \"./graph/run.js\";\nimport type { ListOptions } from \"./query/list.js\";\n\n/** Read a non-empty string without altering its caller-provided whitespace. */\nexport function readRuntimeString(\n  args: Record<string, unknown>,\n  key: string,\n): string | undefined {\n  const value = args[key];\n  return typeof value === \"string\" && value.trim().length > 0\n    ? value\n    : undefined;\n}\n\n/** Normalize a non-empty string or finite number into a scalar string. */\nexport function readRuntimeScalarString(\n  args: Record<string, unknown>,\n  key: string,\n): string | undefined {\n  const value = args[key];\n  if (typeof value === \"string\") {\n    return value.trim().length > 0 ? value : undefined;\n  }\n  return typeof value === \"number\" && Number.isFinite(value)\n    ? String(value)\n    : undefined;\n}\n\n/** Normalize a string, including blank text, or a finite number into text. */\nexport function readRuntimeScalarStringAllowBlank(\n  args: Record<string, unknown>,\n  key: string,\n): string | undefined {\n  const value = args[key];\n  if (typeof value === \"string\") {\n    return value;\n  }\n  return typeof value === \"number\" && Number.isFinite(value)\n    ? String(value)\n    : undefined;\n}\n\n/** Narrow unknown values to plain record-shaped action payloads. */\nexport function isRuntimeRecord(\n  value: unknown,\n): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\n/** Parse an integer-valued MCP option while retaining a caller-specific label. */\nexport function parseRuntimeInteger(\n  value: unknown,\n  label: string,\n): number | undefined {\n  if (typeof value === \"number\") {\n    if (!Number.isInteger(value)) {\n      throw new PmCliError(\n        `${label} must be a finite integer.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return value;\n  }\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    const parsed = Number(value);\n    if (!Number.isInteger(parsed)) {\n      throw new PmCliError(\n        `${label} must be a finite integer.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return parsed;\n  }\n  return undefined;\n}\n\n/** Fixed SDK-runtime global options derived from one untyped action payload. */\nexport function actionGlobalOptions(\n  args: Record<string, unknown>,\n): GlobalOptions {\n  return {\n    json: true,\n    quiet: true,\n    author: readRuntimeString(args, \"author\"),\n    path: readRuntimeString(args, \"path\"),\n    noExtensions: args.noExtensions === true || args.no_extensions === true,\n    noPager: true,\n  };\n}\n\n/** Fields whose MCP array values collapse into the CLI's CSV spelling. */\nconst ARRAY_TO_CSV_FIELDS = new Set([\n  \"tags\",\n  \"blockedBy\",\n  \"blocked_by\",\n  \"skills\",\n  \"fields\",\n]);\n\n/** Fields whose scalar MCP values promote into the CLI's repeatable arrays. */\nconst SCALAR_TO_ARRAY_FIELDS = new Set([\n  \"comment\",\n  \"note\",\n  \"learning\",\n  \"reminder\",\n  \"event\",\n  \"dep\",\n  \"depRemove\",\n  \"dep_remove\",\n  \"file\",\n  \"doc\",\n  \"test\",\n  \"unset\",\n  \"addGlob\",\n  \"add_glob\",\n  \"migrate\",\n  \"envSet\",\n  \"env_set\",\n  \"envClear\",\n  \"env_clear\",\n]);\n\n// Actions where the linked-resource fields `add` and `remove` are string[] arrays.\n// For other actions (comments/notes/learnings) `add` and `remove` are scalar strings\n// and must NOT be auto-promoted.\nconst ARRAY_ADD_REMOVE_ACTIONS = new Set([\n  \"files\",\n  \"files-discover\",\n  \"docs\",\n  \"test\",\n  \"test-all\",\n]);\n\n/** Lifecycle actions where a top-level assignee argument aliases the author. */\nconst LIFECYCLE_AUTHOR_ALIAS_ACTIONS = new Set([\n  \"claim\",\n  \"release\",\n  \"start-task\",\n  \"pause-task\",\n  \"close-task\",\n]);\n\n/** Reconcile MCP array/scalar option spellings with CLI flag expectations. */\nexport function normalizeMcpOptionsArrays(\n  options: Record<string, unknown>,\n  action?: string,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  const promoteAddRemove =\n    action !== undefined && ARRAY_ADD_REMOVE_ACTIONS.has(action);\n  const preserveStandaloneNote =\n    action === \"files\" || action === \"files-discover\" || action === \"docs\";\n  for (const [key, value] of Object.entries(options)) {\n    if (Array.isArray(value) && ARRAY_TO_CSV_FIELDS.has(key)) {\n      result[key] = value.join(\",\");\n      continue;\n    }\n    if (key === \"note\" && preserveStandaloneNote) {\n      result[key] = value;\n      continue;\n    }\n    if (typeof value === \"string\" && SCALAR_TO_ARRAY_FIELDS.has(key)) {\n      result[key] = [value];\n      continue;\n    }\n    if (\n      typeof value === \"string\" &&\n      promoteAddRemove &&\n      (key === \"add\" || key === \"remove\")\n    ) {\n      result[key] = [value];\n      continue;\n    }\n    result[key] = value;\n  }\n  return result;\n}\n\n/** Merge hoisted top-level action arguments and author aliases into options. */\nexport function optionsWithAuthor(\n  args: Record<string, unknown>,\n  action?: string,\n): Record<string, unknown> {\n  const baseOptions = asRecordClone(args.options);\n  const hoistedTopLevel: Record<string, unknown> = {};\n  const hoistKey = (key: string): void => {\n    if (baseOptions[key] !== undefined || args[key] === undefined) {\n      return;\n    }\n    hoistedTopLevel[key] = args[key];\n  };\n  if (action === \"list\") {\n    hoistKey(\"status\");\n    hoistKey(\"type\");\n    hoistKey(\"tag\");\n    hoistKey(\"priority\");\n    hoistKey(\"limit\");\n    hoistKey(\"offset\");\n  } else if (action === \"search\") {\n    hoistKey(\"mode\");\n    hoistKey(\"status\");\n    hoistKey(\"type\");\n    hoistKey(\"tag\");\n    hoistKey(\"priority\");\n    hoistKey(\"limit\");\n  } else if (action === \"create\") {\n    hoistKey(\"title\");\n    hoistKey(\"type\");\n    hoistKey(\"status\");\n    hoistKey(\"description\");\n    hoistKey(\"body\");\n    hoistKey(\"priority\");\n    hoistKey(\"tags\");\n    hoistKey(\"parent\");\n    hoistKey(\"createMode\");\n    hoistKey(\"create_mode\");\n    hoistKey(\"allowMissingParent\");\n  } else if (action === \"close\") {\n    hoistKey(\"duplicateOf\");\n  } else if (action === \"append\") {\n    // pm-7u9j: the narrow pm_append tool declares `body` top-level; runAppend\n    // reads it from options, so hoist unless options.body already wins.\n    // (pm_schema/pm_config top-level args are consumed directly by runAction's\n    // schema/config cases, which read args before options — no hoist needed.)\n    hoistKey(\"body\");\n  }\n  const options = normalizeMcpOptionsArrays(\n    { ...hoistedTopLevel, ...baseOptions },\n    action,\n  );\n  const author = readRuntimeString(args, \"author\");\n  const authorFromAssignee =\n    action !== undefined && LIFECYCLE_AUTHOR_ALIAS_ACTIONS.has(action)\n      ? (readRuntimeString(args, \"assignee\") ??\n        readRuntimeString(options, \"assignee\"))\n      : undefined;\n  if (author && options.author === undefined) {\n    return { ...options, author };\n  }\n  if (authorFromAssignee && options.author === undefined) {\n    return { ...options, author: authorFromAssignee };\n  }\n  return options;\n}\n\n// GH-170 (pm-pfnx): the narrow pm_files/pm_docs tools spell the CLI --note flag\n// as `addNote` (the shared `note` parameter is the array-typed create/update\n// note seed). Translate it onto the runner's `note` option; an explicit\n// options.note (pm_run callers) wins.\n/** Translate the MCP-only addNote spelling onto the runner note option. */\nexport function withAddNoteOption(\n  options: Record<string, unknown>,\n): Record<string, unknown> {\n  if (options.addNote === undefined) {\n    return options;\n  }\n  const next: Record<string, unknown> = { ...options };\n  if (next.note === undefined && typeof next.addNote === \"string\") {\n    next.note = next.addNote;\n  }\n  delete next.addNote;\n  return next;\n}\n\n/** Map files-discover MCP controls onto the files runner's option shape. */\nexport function withFilesDiscoveryOptions(\n  options: Record<string, unknown>,\n): Record<string, unknown> {\n  const next: Record<string, unknown> = { ...options };\n  if (\n    next.discoveryNote !== undefined &&\n    next.note === undefined &&\n    typeof next.discoveryNote === \"string\"\n  ) {\n    next.note = next.discoveryNote;\n  }\n  delete next.discover;\n  delete next.discoveryNote;\n  return next;\n}\n\n/** Canonicalize one action name into lower-kebab-case tokens. */\nexport function normalizeActionName(value: string): string {\n  const chunks: string[] = [];\n  let lastWasSeparator = true;\n  for (const character of value.trim().toLowerCase()) {\n    const isAlphaNumeric =\n      (character >= \"a\" && character <= \"z\") ||\n      (character >= \"0\" && character <= \"9\");\n    if (isAlphaNumeric) {\n      chunks.push(character);\n      lastWasSeparator = false;\n      continue;\n    }\n    if (!lastWasSeparator) {\n      chunks.push(\"-\");\n      lastWasSeparator = true;\n    }\n  }\n  if (chunks.at(-1) === \"-\") {\n    chunks.pop();\n  }\n  return chunks.join(\"\");\n}\n\n/** Canonicalize one space-separated command path for lookup comparisons. */\nexport function normalizeCommandPath(value: string): string {\n  return value.trim().toLowerCase().split(/\\s+/).filter(Boolean).join(\" \");\n}\n\n/** Coerce an unknown payload value into a non-empty string array. */\nexport function readRuntimeStringArray(value: unknown): string[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  return value\n    .map((entry) => String(entry))\n    .filter((entry) => entry.length > 0);\n}\n\n/** Merge non-reserved top-level extension arguments into the options record. */\nexport function extensionOptionsFromArgs(\n  args: Record<string, unknown>,\n  options: Record<string, unknown>,\n): Record<string, unknown> {\n  const reserved = new Set([\n    \"action\",\n    \"args\",\n    \"author\",\n    \"cwd\",\n    \"fullChangedFields\",\n    \"id\",\n    \"options\",\n    \"path\",\n    \"query\",\n    \"reason\",\n    \"target\",\n  ]);\n  const passthrough: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(args)) {\n    if (!reserved.has(key)) {\n      passthrough[key] = value;\n    }\n  }\n  const normalizedOptions = { ...passthrough, ...options };\n  delete normalizedOptions.args;\n  return normalizedOptions;\n}\n\n/** Mutation tools (create/update/close/append/update-many) return a verbose `changed_fields` array. On the agent path we drop it to a `changed_field_count` by default for token efficiency, restoring the full array only when the caller explicitly passes the MCP-level fullChangedFields=true control. Mutation options are forwarded unchanged so runtime fields named `full` remain valid user data. */\nexport function withMutationCompaction(\n  args: Record<string, unknown>,\n  options?: Record<string, unknown> | null,\n): {\n  changedFields: \"full\" | \"compact\";\n  idOnly: boolean;\n  runnerOptions: Record<string, unknown>;\n} {\n  return {\n    changedFields: args.fullChangedFields === true ? \"full\" : \"compact\",\n    idOnly: args.idOnly === true,\n    runnerOptions: { ...options },\n  };\n}\n\n/** Translate flat MCP filter parameters into the shared list-option shape. */\nexport function mutationListOptions(\n  options: Record<string, unknown>,\n): ListOptions {\n  return {\n    type: readRuntimeScalarString(options, \"filterType\"),\n    tag: readRuntimeScalarString(options, \"filterTag\"),\n    priority: readRuntimeScalarString(options, \"filterPriority\"),\n    deadlineBefore: readRuntimeScalarString(options, \"filterDeadlineBefore\"),\n    deadlineAfter: readRuntimeScalarString(options, \"filterDeadlineAfter\"),\n    updatedAfter: readRuntimeScalarString(options, \"filterUpdatedAfter\"),\n    updatedBefore: readRuntimeScalarString(options, \"filterUpdatedBefore\"),\n    createdAfter: readRuntimeScalarString(options, \"filterCreatedAfter\"),\n    createdBefore: readRuntimeScalarString(options, \"filterCreatedBefore\"),\n    ids: readRuntimeScalarStringAllowBlank(options, \"ids\"),\n    assignee: readRuntimeScalarString(options, \"filterAssignee\"),\n    assigneeFilter:\n      readRuntimeScalarString(options, \"filterAssigneeFilter\") ??\n      readRuntimeScalarString(options, \"filterAssignee_filter\"),\n    parent: readRuntimeScalarString(options, \"filterParent\"),\n    sprint: readRuntimeScalarString(options, \"filterSprint\"),\n    release: readRuntimeScalarString(options, \"filterRelease\"),\n    limit: readRuntimeScalarString(options, \"limit\"),\n    offset: readRuntimeScalarString(options, \"offset\"),\n  };\n}\n\n/** Read one graph option that accepts scalar strings or repeatable arrays. */\nfunction readGraphIdListOption(value: unknown): string | string[] | undefined {\n  if (typeof value === \"string\" && value.trim().length > 0) return value;\n  if (Array.isArray(value)) return readRuntimeStringArray(value);\n  return undefined;\n}\n\n/** Read one graph bound that accepts integer numbers or numeric strings. */\nfunction readGraphBoundOption(value: unknown): string | number | undefined {\n  if (typeof value === \"number\" && Number.isFinite(value)) return value;\n  if (typeof value === \"string\" && value.trim().length > 0) return value;\n  return undefined;\n}\n\n/** Build graph command options from one flat MCP parameter payload. */\nexport function graphOptionsFromFlat(\n  options: Record<string, unknown>,\n): GraphCommandOptions {\n  const kind = readGraphIdListOption(options.kind);\n  const exemptIsolate = readGraphIdListOption(options.exemptIsolate);\n  return {\n    ...(kind === undefined ? {} : { kind }),\n    maxDepth: readGraphBoundOption(options.maxDepth),\n    limit: readGraphBoundOption(options.limit),\n    after: readRuntimeString(options, \"after\"),\n    direction: readRuntimeString(options, \"direction\"),\n    maxPaths: readGraphBoundOption(options.maxPaths),\n    sample: readGraphBoundOption(options.sample),\n    ...(exemptIsolate === undefined ? {} : { exemptIsolate }),\n    summary: options.summary === true,\n  };\n}\n\n/** Build close-many command options from one flat MCP parameter payload. */\nexport function closeManyOptionsFromFlat(\n  options: Record<string, unknown>,\n): CloseManyCommandOptions {\n  return {\n    status: readRuntimeString(options, \"filterStatus\"),\n    list: isRuntimeRecord(options.list)\n      ? normalizeListOptions(options.list)\n      : mutationListOptions(options),\n    reason: readRuntimeString(options, \"reason\"),\n    resolution: readRuntimeString(options, \"resolution\"),\n    expectedResult:\n      readRuntimeString(options, \"expectedResult\") ??\n      readRuntimeString(options, \"expected_result\") ??\n      readRuntimeString(options, \"expected\"),\n    actualResult:\n      readRuntimeString(options, \"actualResult\") ??\n      readRuntimeString(options, \"actual_result\") ??\n      readRuntimeString(options, \"actual\"),\n    validateClose:\n      readRuntimeString(options, \"validateClose\") ??\n      readRuntimeString(options, \"validate_close\"),\n    author: readRuntimeString(options, \"author\"),\n    message: readRuntimeString(options, \"message\"),\n    force: options.force === true ? true : undefined,\n    dryRun:\n      options.dryRun === true || options.dry_run === true ? true : undefined,\n    rollback: readRuntimeString(options, \"rollback\"),\n    checkpoint:\n      options.checkpoint === false ||\n      options.noCheckpoint === true ||\n      options.no_checkpoint === true\n        ? false\n        : undefined,\n  };\n}\n\n/** Flat update-many parameters that steer batching instead of item fields. */\nconst UPDATE_MANY_FLAT_CONTROL_KEYS = new Set([\n  \"filterStatus\",\n  \"filterType\",\n  \"filterTag\",\n  \"filterPriority\",\n  \"filterDeadlineBefore\",\n  \"filterDeadlineAfter\",\n  \"filterUpdatedAfter\",\n  \"filterUpdatedBefore\",\n  \"filterCreatedAfter\",\n  \"filterCreatedBefore\",\n  \"filterAssignee\",\n  \"filterAssigneeFilter\",\n  \"filterAssignee_filter\",\n  \"filterParent\",\n  \"filterSprint\",\n  \"filterRelease\",\n  \"ids\",\n  \"list\",\n  \"update\",\n  \"limit\",\n  \"offset\",\n  \"dryRun\",\n  \"dry_run\",\n  \"rollback\",\n  \"checkpoint\",\n  \"noCheckpoint\",\n  \"no_checkpoint\",\n]);\n\n/** Extract per-item update fields from one flat update-many payload. */\nexport function updateManyUpdateOptionsFromFlat(\n  options: Record<string, unknown>,\n): Record<string, unknown> {\n  const update: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(options)) {\n    if (UPDATE_MANY_FLAT_CONTROL_KEYS.has(key)) {\n      continue;\n    }\n    update[key] = value;\n  }\n  return normalizeMcpUpdateOptions(update);\n}\n\n/** Normalize MCP update fields onto the CLI update option contract. */\nexport function normalizeMcpUpdateOptions(\n  options: Record<string, unknown>,\n): Record<string, unknown> {\n  const normalizedInput: Record<string, unknown> = normalizeMcpOptionsArrays(\n    options,\n    \"update-many\",\n  );\n  for (const contract of UPDATE_COMMANDER_STRING_OPTION_CONTRACTS) {\n    for (const key of contract.keys) {\n      const value = normalizedInput[key];\n      if (typeof value === \"number\" && Number.isFinite(value)) {\n        normalizedInput[key] = String(value);\n      }\n    }\n  }\n  return normalizeUpdateOptions(normalizedInput);\n}\n\n/** Build update-many command options from one flat MCP parameter payload. */\nexport function updateManyOptionsFromFlat(\n  options: Record<string, unknown>,\n): UpdateManyCommandOptions {\n  if (isRuntimeRecord(options.list) || isRuntimeRecord(options.update)) {\n    const updateSource = isRuntimeRecord(options.update)\n      ? options.update\n      : updateManyUpdateOptionsFromFlat(options);\n    return {\n      status: readRuntimeScalarString(options, \"filterStatus\"),\n      list: isRuntimeRecord(options.list)\n        ? normalizeListOptions(options.list)\n        : mutationListOptions(options),\n      update: normalizeMcpUpdateOptions(updateSource) as never,\n      dryRun:\n        options.dryRun === true || options.dry_run === true ? true : undefined,\n      rollback: readRuntimeString(options, \"rollback\"),\n      checkpoint:\n        options.checkpoint === false ||\n        options.noCheckpoint === true ||\n        options.no_checkpoint === true\n          ? false\n          : undefined,\n    };\n  }\n  return {\n    status: readRuntimeScalarString(options, \"filterStatus\"),\n    list: mutationListOptions(options),\n    update: updateManyUpdateOptionsFromFlat(options) as never,\n    dryRun:\n      options.dryRun === true || options.dry_run === true ? true : undefined,\n    rollback: readRuntimeString(options, \"rollback\"),\n    checkpoint:\n      options.checkpoint === false ||\n      options.noCheckpoint === true ||\n      options.no_checkpoint === true\n        ? false\n        : undefined,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"9c53751c-01db-59ad-a024-b761d4b08030"}
+{"version":3,"file":"runtime-input.js","sources":["sdk/runtime-input.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/runtime-input\n *\n * Normalizes untyped action payload values at the SDK runtime boundary. These\n * primitives are shared by native action dispatchers and MCP-specific adapters.\n */\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { asRecordClone } from \"../core/shared/primitives.js\";\nimport {\n  normalizeListOptions,\n  normalizeUpdateOptions,\n} from \"../cli/registration-helpers.js\";\nimport type { CloseManyCommandOptions } from \"../cli/commands/close-many.js\";\nimport type { UpdateManyCommandOptions } from \"../cli/commands/update-many.js\";\nimport { UPDATE_COMMANDER_STRING_OPTION_CONTRACTS } from \"./cli-contracts/commander-mutation-options.js\";\nimport type { GraphCommandOptions } from \"./graph/run.js\";\nimport type { ListOptions } from \"./query/list.js\";\n\n/** Read a non-empty string without altering its caller-provided whitespace. */\nexport function readRuntimeString(\n  args: Record<string, unknown>,\n  key: string,\n): string | undefined {\n  const value = args[key];\n  return typeof value === \"string\" && value.trim().length > 0\n    ? value\n    : undefined;\n}\n\n/** Normalize a non-empty string or finite number into a scalar string. */\nexport function readRuntimeScalarString(\n  args: Record<string, unknown>,\n  key: string,\n): string | undefined {\n  const value = args[key];\n  if (typeof value === \"string\") {\n    return value.trim().length > 0 ? value : undefined;\n  }\n  return typeof value === \"number\" && Number.isFinite(value)\n    ? String(value)\n    : undefined;\n}\n\n/** Normalize a string, including blank text, or a finite number into text. */\nexport function readRuntimeScalarStringAllowBlank(\n  args: Record<string, unknown>,\n  key: string,\n): string | undefined {\n  const value = args[key];\n  if (typeof value === \"string\") {\n    return value;\n  }\n  return typeof value === \"number\" && Number.isFinite(value)\n    ? String(value)\n    : undefined;\n}\n\n/** Narrow unknown values to plain record-shaped action payloads. */\nexport function isRuntimeRecord(\n  value: unknown,\n): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\n/** Parse an integer-valued MCP option while retaining a caller-specific label. */\nexport function parseRuntimeInteger(\n  value: unknown,\n  label: string,\n): number | undefined {\n  if (typeof value === \"number\") {\n    if (!Number.isInteger(value)) {\n      throw new PmCliError(\n        `${label} must be a finite integer.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return value;\n  }\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    const parsed = Number(value);\n    if (!Number.isInteger(parsed)) {\n      throw new PmCliError(\n        `${label} must be a finite integer.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return parsed;\n  }\n  return undefined;\n}\n\n/** Fixed SDK-runtime global options derived from one untyped action payload. */\nexport function actionGlobalOptions(\n  args: Record<string, unknown>,\n): GlobalOptions {\n  return {\n    json: true,\n    quiet: true,\n    author: readRuntimeString(args, \"author\"),\n    path: readRuntimeString(args, \"path\"),\n    noExtensions: args.noExtensions === true || args.no_extensions === true,\n    noPager: true,\n  };\n}\n\n/** Fields whose MCP array values collapse into the CLI's CSV spelling. */\nconst ARRAY_TO_CSV_FIELDS = new Set([\n  \"tags\",\n  \"blockedBy\",\n  \"blocked_by\",\n  \"skills\",\n  \"fields\",\n]);\n\n/** Fields whose scalar MCP values promote into the CLI's repeatable arrays. */\nconst SCALAR_TO_ARRAY_FIELDS = new Set([\n  \"comment\",\n  \"note\",\n  \"learning\",\n  \"reminder\",\n  \"event\",\n  \"dep\",\n  \"depRemove\",\n  \"dep_remove\",\n  \"file\",\n  \"doc\",\n  \"test\",\n  \"unset\",\n  \"addGlob\",\n  \"add_glob\",\n  \"migrate\",\n  \"envSet\",\n  \"env_set\",\n  \"envClear\",\n  \"env_clear\",\n]);\n\n// Actions where the linked-resource fields `add` and `remove` are string[] arrays.\n// For other actions (comments/notes/learnings) `add` and `remove` are scalar strings\n// and must NOT be auto-promoted.\nconst ARRAY_ADD_REMOVE_ACTIONS = new Set([\n  \"files\",\n  \"files-discover\",\n  \"docs\",\n  \"test\",\n  \"test-all\",\n]);\n\n/** Lifecycle actions where a top-level assignee argument aliases the author. */\nconst LIFECYCLE_AUTHOR_ALIAS_ACTIONS = new Set([\n  \"claim\",\n  \"release\",\n  \"start-task\",\n  \"pause-task\",\n  \"close-task\",\n]);\n\n/** Reconcile MCP array/scalar option spellings with CLI flag expectations. */\nexport function normalizeMcpOptionsArrays(\n  options: Record<string, unknown>,\n  action?: string,\n): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n  const promoteAddRemove =\n    action !== undefined && ARRAY_ADD_REMOVE_ACTIONS.has(action);\n  const preserveStandaloneNote =\n    action === \"files\" || action === \"files-discover\" || action === \"docs\";\n  for (const [key, value] of Object.entries(options)) {\n    if (Array.isArray(value) && ARRAY_TO_CSV_FIELDS.has(key)) {\n      result[key] = value.join(\",\");\n      continue;\n    }\n    if (key === \"note\" && preserveStandaloneNote) {\n      result[key] = value;\n      continue;\n    }\n    if (typeof value === \"string\" && SCALAR_TO_ARRAY_FIELDS.has(key)) {\n      result[key] = [value];\n      continue;\n    }\n    if (\n      typeof value === \"string\" &&\n      promoteAddRemove &&\n      (key === \"add\" || key === \"remove\")\n    ) {\n      result[key] = [value];\n      continue;\n    }\n    result[key] = value;\n  }\n  return result;\n}\n\n/** Merge hoisted top-level action arguments and author aliases into options. */\nexport function optionsWithAuthor(\n  args: Record<string, unknown>,\n  action?: string,\n): Record<string, unknown> {\n  const baseOptions = asRecordClone(args.options);\n  const hoistedTopLevel: Record<string, unknown> = {};\n  const hoistKey = (key: string): void => {\n    if (baseOptions[key] !== undefined || args[key] === undefined) {\n      return;\n    }\n    hoistedTopLevel[key] = args[key];\n  };\n  if (action === \"list\") {\n    hoistKey(\"status\");\n    hoistKey(\"type\");\n    hoistKey(\"tag\");\n    hoistKey(\"priority\");\n    hoistKey(\"limit\");\n    hoistKey(\"offset\");\n  } else if (action === \"search\") {\n    hoistKey(\"mode\");\n    hoistKey(\"status\");\n    hoistKey(\"type\");\n    hoistKey(\"tag\");\n    hoistKey(\"priority\");\n    hoistKey(\"limit\");\n  } else if (action === \"create\") {\n    hoistKey(\"title\");\n    hoistKey(\"type\");\n    hoistKey(\"status\");\n    hoistKey(\"description\");\n    hoistKey(\"body\");\n    hoistKey(\"priority\");\n    hoistKey(\"tags\");\n    hoistKey(\"parent\");\n    hoistKey(\"createMode\");\n    hoistKey(\"create_mode\");\n    hoistKey(\"allowMissingParent\");\n  } else if (action === \"close\") {\n    hoistKey(\"duplicateOf\");\n  } else if (action === \"append\") {\n    // pm-7u9j: the narrow pm_append tool declares `body` top-level; runAppend\n    // reads it from options, so hoist unless options.body already wins.\n    // (pm_schema/pm_config top-level args are consumed directly by runAction's\n    // schema/config cases, which read args before options — no hoist needed.)\n    hoistKey(\"body\");\n  }\n  const options = normalizeMcpOptionsArrays(\n    { ...hoistedTopLevel, ...baseOptions },\n    action,\n  );\n  const author = readRuntimeString(args, \"author\");\n  const authorFromAssignee =\n    action !== undefined && LIFECYCLE_AUTHOR_ALIAS_ACTIONS.has(action)\n      ? (readRuntimeString(args, \"assignee\") ??\n        readRuntimeString(options, \"assignee\"))\n      : undefined;\n  if (author && options.author === undefined) {\n    return { ...options, author };\n  }\n  if (authorFromAssignee && options.author === undefined) {\n    return { ...options, author: authorFromAssignee };\n  }\n  return options;\n}\n\n// GH-170 (pm-pfnx): the narrow pm_files/pm_docs tools spell the CLI --note flag\n// as `addNote` (the shared `note` parameter is the array-typed create/update\n// note seed). Translate it onto the runner's `note` option; an explicit\n// options.note (pm_run callers) wins.\n/** Translate the MCP-only addNote spelling onto the runner note option. */\nexport function withAddNoteOption(\n  options: Record<string, unknown>,\n): Record<string, unknown> {\n  if (options.addNote === undefined) {\n    return options;\n  }\n  const next: Record<string, unknown> = { ...options };\n  if (next.note === undefined && typeof next.addNote === \"string\") {\n    next.note = next.addNote;\n  }\n  delete next.addNote;\n  return next;\n}\n\n/** Map files-discover MCP controls onto the files runner's option shape. */\nexport function withFilesDiscoveryOptions(\n  options: Record<string, unknown>,\n): Record<string, unknown> {\n  const next: Record<string, unknown> = { ...options };\n  if (\n    next.discoveryNote !== undefined &&\n    next.note === undefined &&\n    typeof next.discoveryNote === \"string\"\n  ) {\n    next.note = next.discoveryNote;\n  }\n  delete next.discover;\n  delete next.discoveryNote;\n  return next;\n}\n\n/** Canonicalize one action name into lower-kebab-case tokens. */\nexport function normalizeActionName(value: string): string {\n  const chunks: string[] = [];\n  let lastWasSeparator = true;\n  for (const character of value.trim().toLowerCase()) {\n    const isAlphaNumeric =\n      (character >= \"a\" && character <= \"z\") ||\n      (character >= \"0\" && character <= \"9\");\n    if (isAlphaNumeric) {\n      chunks.push(character);\n      lastWasSeparator = false;\n      continue;\n    }\n    if (!lastWasSeparator) {\n      chunks.push(\"-\");\n      lastWasSeparator = true;\n    }\n  }\n  if (chunks.at(-1) === \"-\") {\n    chunks.pop();\n  }\n  return chunks.join(\"\");\n}\n\n/** Canonicalize one space-separated command path for lookup comparisons. */\nexport function normalizeCommandPath(value: string): string {\n  return value.trim().toLowerCase().split(/\\s+/).filter(Boolean).join(\" \");\n}\n\n/** Coerce an unknown payload value into a non-empty string array. */\nexport function readRuntimeStringArray(value: unknown): string[] {\n  if (!Array.isArray(value)) {\n    return [];\n  }\n  return value\n    .map((entry) => String(entry))\n    .filter((entry) => entry.length > 0);\n}\n\n/** Merge non-reserved top-level extension arguments into the options record. */\nexport function extensionOptionsFromArgs(\n  args: Record<string, unknown>,\n  options: Record<string, unknown>,\n): Record<string, unknown> {\n  const reserved = new Set([\n    \"action\",\n    \"args\",\n    \"author\",\n    \"cwd\",\n    \"fullChangedFields\",\n    \"id\",\n    \"options\",\n    \"path\",\n    \"query\",\n    \"reason\",\n    \"target\",\n  ]);\n  const passthrough: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(args)) {\n    if (!reserved.has(key)) {\n      passthrough[key] = value;\n    }\n  }\n  const normalizedOptions = { ...passthrough, ...options };\n  delete normalizedOptions.args;\n  return normalizedOptions;\n}\n\n/** Mutation tools (create/update/close/append/update-many) return a verbose `changed_fields` array. On the agent path we drop it to a `changed_field_count` by default for token efficiency, restoring the full array only when the caller explicitly passes the MCP-level fullChangedFields=true control. Mutation options are forwarded unchanged so runtime fields named `full` remain valid user data. */\nexport function withMutationCompaction(\n  args: Record<string, unknown>,\n  options?: Record<string, unknown> | null,\n): {\n  changedFields: \"full\" | \"compact\";\n  idOnly: boolean;\n  runnerOptions: Record<string, unknown>;\n} {\n  return {\n    changedFields: args.fullChangedFields === true ? \"full\" : \"compact\",\n    idOnly: args.idOnly === true,\n    runnerOptions: { ...options },\n  };\n}\n\n/** Translate flat MCP filter parameters into the shared list-option shape. */\nexport function mutationListOptions(\n  options: Record<string, unknown>,\n): ListOptions {\n  return {\n    type: readRuntimeScalarString(options, \"filterType\"),\n    tag: readRuntimeScalarString(options, \"filterTag\"),\n    priority: readRuntimeScalarString(options, \"filterPriority\"),\n    deadlineBefore: readRuntimeScalarString(options, \"filterDeadlineBefore\"),\n    deadlineAfter: readRuntimeScalarString(options, \"filterDeadlineAfter\"),\n    updatedAfter: readRuntimeScalarString(options, \"filterUpdatedAfter\"),\n    updatedBefore: readRuntimeScalarString(options, \"filterUpdatedBefore\"),\n    createdAfter: readRuntimeScalarString(options, \"filterCreatedAfter\"),\n    createdBefore: readRuntimeScalarString(options, \"filterCreatedBefore\"),\n    ids: readRuntimeScalarStringAllowBlank(options, \"ids\"),\n    assignee: readRuntimeScalarString(options, \"filterAssignee\"),\n    assigneeFilter:\n      readRuntimeScalarString(options, \"filterAssigneeFilter\") ??\n      readRuntimeScalarString(options, \"filterAssignee_filter\"),\n    parent: readRuntimeScalarString(options, \"filterParent\"),\n    sprint: readRuntimeScalarString(options, \"filterSprint\"),\n    release: readRuntimeScalarString(options, \"filterRelease\"),\n    limit: readRuntimeScalarString(options, \"limit\"),\n    offset: readRuntimeScalarString(options, \"offset\"),\n  };\n}\n\n/** Read one graph option that accepts scalar strings or repeatable arrays. */\nfunction readGraphIdListOption(value: unknown): string | string[] | undefined {\n  if (typeof value === \"string\" && value.trim().length > 0) return value;\n  if (Array.isArray(value)) return readRuntimeStringArray(value);\n  return undefined;\n}\n\n/** Read one graph bound that accepts integer numbers or numeric strings. */\nfunction readGraphBoundOption(value: unknown): string | number | undefined {\n  if (typeof value === \"number\" && Number.isFinite(value)) return value;\n  if (typeof value === \"string\" && value.trim().length > 0) return value;\n  return undefined;\n}\n\n/** Build graph command options from one flat MCP parameter payload. */\nexport function graphOptionsFromFlat(\n  options: Record<string, unknown>,\n): GraphCommandOptions {\n  const kind = readGraphIdListOption(options.kind);\n  const exemptIsolate = readGraphIdListOption(options.exemptIsolate);\n  const exemptIsolateType = readGraphIdListOption(options.exemptIsolateType);\n  return {\n    ...(kind === undefined ? {} : { kind }),\n    maxDepth: readGraphBoundOption(options.maxDepth),\n    limit: readGraphBoundOption(options.limit),\n    after: readRuntimeString(options, \"after\"),\n    direction: readRuntimeString(options, \"direction\"),\n    maxPaths: readGraphBoundOption(options.maxPaths),\n    sample: readGraphBoundOption(options.sample),\n    ...(exemptIsolate === undefined ? {} : { exemptIsolate }),\n    ...(exemptIsolateType === undefined ? {} : { exemptIsolateType }),\n    saveBaseline: options.saveBaseline === true,\n    rebuild: options.rebuild === true,\n    clear: options.clear === true,\n    summary: options.summary === true,\n  };\n}\n\n/** Build close-many command options from one flat MCP parameter payload. */\nexport function closeManyOptionsFromFlat(\n  options: Record<string, unknown>,\n): CloseManyCommandOptions {\n  return {\n    status: readRuntimeString(options, \"filterStatus\"),\n    list: isRuntimeRecord(options.list)\n      ? normalizeListOptions(options.list)\n      : mutationListOptions(options),\n    reason: readRuntimeString(options, \"reason\"),\n    resolution: readRuntimeString(options, \"resolution\"),\n    expectedResult:\n      readRuntimeString(options, \"expectedResult\") ??\n      readRuntimeString(options, \"expected_result\") ??\n      readRuntimeString(options, \"expected\"),\n    actualResult:\n      readRuntimeString(options, \"actualResult\") ??\n      readRuntimeString(options, \"actual_result\") ??\n      readRuntimeString(options, \"actual\"),\n    validateClose:\n      readRuntimeString(options, \"validateClose\") ??\n      readRuntimeString(options, \"validate_close\"),\n    author: readRuntimeString(options, \"author\"),\n    message: readRuntimeString(options, \"message\"),\n    force: options.force === true ? true : undefined,\n    dryRun:\n      options.dryRun === true || options.dry_run === true ? true : undefined,\n    rollback: readRuntimeString(options, \"rollback\"),\n    checkpoint:\n      options.checkpoint === false ||\n      options.noCheckpoint === true ||\n      options.no_checkpoint === true\n        ? false\n        : undefined,\n  };\n}\n\n/** Flat update-many parameters that steer batching instead of item fields. */\nconst UPDATE_MANY_FLAT_CONTROL_KEYS = new Set([\n  \"filterStatus\",\n  \"filterType\",\n  \"filterTag\",\n  \"filterPriority\",\n  \"filterDeadlineBefore\",\n  \"filterDeadlineAfter\",\n  \"filterUpdatedAfter\",\n  \"filterUpdatedBefore\",\n  \"filterCreatedAfter\",\n  \"filterCreatedBefore\",\n  \"filterAssignee\",\n  \"filterAssigneeFilter\",\n  \"filterAssignee_filter\",\n  \"filterParent\",\n  \"filterSprint\",\n  \"filterRelease\",\n  \"ids\",\n  \"list\",\n  \"update\",\n  \"limit\",\n  \"offset\",\n  \"dryRun\",\n  \"dry_run\",\n  \"rollback\",\n  \"checkpoint\",\n  \"noCheckpoint\",\n  \"no_checkpoint\",\n]);\n\n/** Extract per-item update fields from one flat update-many payload. */\nexport function updateManyUpdateOptionsFromFlat(\n  options: Record<string, unknown>,\n): Record<string, unknown> {\n  const update: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(options)) {\n    if (UPDATE_MANY_FLAT_CONTROL_KEYS.has(key)) {\n      continue;\n    }\n    update[key] = value;\n  }\n  return normalizeMcpUpdateOptions(update);\n}\n\n/** Normalize MCP update fields onto the CLI update option contract. */\nexport function normalizeMcpUpdateOptions(\n  options: Record<string, unknown>,\n): Record<string, unknown> {\n  const normalizedInput: Record<string, unknown> = normalizeMcpOptionsArrays(\n    options,\n    \"update-many\",\n  );\n  for (const contract of UPDATE_COMMANDER_STRING_OPTION_CONTRACTS) {\n    for (const key of contract.keys) {\n      const value = normalizedInput[key];\n      if (typeof value === \"number\" && Number.isFinite(value)) {\n        normalizedInput[key] = String(value);\n      }\n    }\n  }\n  return normalizeUpdateOptions(normalizedInput);\n}\n\n/** Build update-many command options from one flat MCP parameter payload. */\nexport function updateManyOptionsFromFlat(\n  options: Record<string, unknown>,\n): UpdateManyCommandOptions {\n  if (isRuntimeRecord(options.list) || isRuntimeRecord(options.update)) {\n    const updateSource = isRuntimeRecord(options.update)\n      ? options.update\n      : updateManyUpdateOptionsFromFlat(options);\n    return {\n      status: readRuntimeScalarString(options, \"filterStatus\"),\n      list: isRuntimeRecord(options.list)\n        ? normalizeListOptions(options.list)\n        : mutationListOptions(options),\n      update: normalizeMcpUpdateOptions(updateSource) as never,\n      dryRun:\n        options.dryRun === true || options.dry_run === true ? true : undefined,\n      rollback: readRuntimeString(options, \"rollback\"),\n      checkpoint:\n        options.checkpoint === false ||\n        options.noCheckpoint === true ||\n        options.no_checkpoint === true\n          ? false\n          : undefined,\n    };\n  }\n  return {\n    status: readRuntimeScalarString(options, \"filterStatus\"),\n    list: mutationListOptions(options),\n    update: updateManyUpdateOptionsFromFlat(options) as never,\n    dryRun:\n      options.dryRun === true || options.dry_run === true ? true : undefined,\n    rollback: readRuntimeString(options, \"rollback\"),\n    checkpoint:\n      options.checkpoint === false ||\n      options.noCheckpoint === true ||\n      options.no_checkpoint === true\n        ? false\n        : undefined,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"d6daa01a-e405-5f34-b647-c467cc11ee15"}

package/dist/sdk/runtime-primitives.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @module sdk/runtime-primitives
+ *
+ * Exposes shared runtime primitives needed by CLI, MCP, and package adapters without private core imports.
+ */
+export { createStdinTokenResolver, type StdinTokenResolver, } from "../core/item/parse.js";
+export { resolveAuthor } from "../core/shared/author.js";
+export { EXIT_CODE } from "../core/shared/constants.js";
+export { PmCliError } from "../core/shared/errors.js";
+export { resolvePmRoot } from "../core/store/paths.js";