@unbrained/pm-cli 2026.7.16 → 2026.7.18

package/dist/cli-bundle/chunks/{chunk-UOHFKBUV.js → chunk-WL3SS45P.js}

@@ -1,13 +1,13 @@
 import {
   nowIso
-} from "./chunk-XSJUSQAE.js";
+} from "./chunk-646MQXFW.js";
 import {
   EXIT_CODE,
   PmCliError,
   pathExists,
   toErrorMessage,
   writeFileAtomic
-} from "./chunk-BSEQUTQP.js";
+} from "./chunk-WACRQ26A.js";
 
 // dist/core/checkpoint/mutation-checkpoint.js
 import { mkdir, readFile } from "node:fs/promises";
@@ -135,4 +135,4 @@ export {
   loadMutationCheckpoint,
   restoreCheckpointItems
 };
-//# sourceMappingURL=chunk-UOHFKBUV.js.map
+//# sourceMappingURL=chunk-WL3SS45P.js.map

package/dist/cli-bundle/chunks/{chunk-H5APFTHZ.js → chunk-WQXRZMFN.js}

@@ -9,7 +9,23 @@ import {
   PLAN_MODE_VALUES,
   PLAN_STEP_LINK_KIND_VALUES,
   PLAN_STEP_STATUS_VALUES
-} from "./chunk-BSEQUTQP.js";
+} from "./chunk-WACRQ26A.js";
+
+// dist/sdk/cli-contracts/command-aliases.js
+!(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] = "e5081784-d3d0-5fd3-9f6a-294a621995ef");
+  } catch (e2) {
+  }
+})();
+var EXECUTABLE_COMMAND_ALIASES = {
+  show: "get",
+  view: "get",
+  comment: "comments",
+  note: "notes",
+  learning: "learnings"
+};
 
 // dist/sdk/cli-contracts/commander-types.js
 !(function() {
@@ -1157,7 +1173,7 @@ var UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS = UPDATE_COMMANDER_OPTION_REGIS
 !(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] = "2f7d8ae8-4fb8-5ec4-a440-d42f8499589f");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "a665adfd-c6a7-544c-a3f9-55a6d5fa4472");
   } catch (e2) {
   }
 })();
@@ -1202,6 +1218,7 @@ var PM_CORE_COMMAND_NAMES = [
   "context",
   "ctx",
   "get",
+  "graph",
   "search",
   "eval",
   "next",
@@ -1244,6 +1261,20 @@ var PM_CORE_COMMAND_NAMES = [
   "remind",
   "help"
 ];
+var GRAPH_SUBCOMMAND_VALUES = [
+  "ancestors",
+  "descendants",
+  "predecessors",
+  "successors",
+  "paths",
+  "impact",
+  "analyze",
+  "audit",
+  "communities",
+  "redundancy",
+  "dominators",
+  "plan"
+];
 var PM_TOOL_ACTIONS = [
   "init",
   "config",
@@ -1315,6 +1346,7 @@ var PM_TOOL_ACTIONS = [
   "files",
   "docs",
   "deps",
+  "graph",
   "test",
   "test-all",
   "telemetry",
@@ -1349,7 +1381,7 @@ function isPmExtensionPolicySurfaceContract(value) {
 !(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] = "737c225c-aa32-5277-b169-faedbb057f39");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "bbb41f64-eaab-546b-b21e-9535853ee1f9");
   } catch (e2) {
   }
 })();
@@ -1694,7 +1726,9 @@ var TOOL_DEPS_OPTION_CONTRACTS = [
   { param: "nodeLimit", flag: "--node-limit" },
   { param: "edgeLimit", flag: "--edge-limit" },
   { param: "tokenBudget", flag: "--token-budget" },
-  { param: "cursor", flag: "--cursor" }
+  { param: "cursor", flag: "--cursor" },
+  { param: "direction", flag: "--direction" },
+  { param: "kind", flag: "--kind", repeatable: true }
 ];
 
 // dist/sdk/cli-contracts/string-lists.js
@@ -1715,7 +1749,7 @@ function normalizeUniqueStringList(values) {
 !(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] = "cb1e2010-bf9f-5eb9-a77d-70e31f5463ac");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c5e59d37-0b45-54cc-93a0-4e52a78d6dd0");
   } catch (e2) {
   }
 })();
@@ -2862,6 +2896,23 @@ var DEPS_FLAG_CONTRACTS = [
   { flag: "--format" },
   { flag: "--max-depth" },
   { flag: "--collapse" },
+  { flag: "--summary" },
+  { flag: "--node-limit" },
+  { flag: "--edge-limit" },
+  { flag: "--token-budget" },
+  { flag: "--cursor" },
+  { flag: "--direction" },
+  { flag: "--kind", list: true }
+];
+var GRAPH_FLAG_CONTRACTS = [
+  { flag: "--kind", list: true },
+  { flag: "--max-depth" },
+  { flag: "--limit" },
+  { flag: "--after" },
+  { flag: "--direction" },
+  { flag: "--max-paths" },
+  { flag: "--sample" },
+  { flag: "--exempt-isolate", list: true },
   { flag: "--summary" }
 ];
 var EVAL_FLAG_CONTRACTS = [
@@ -3014,6 +3065,7 @@ var SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND = new Map([
   ["files", FILES_FLAG_CONTRACTS],
   ["docs", DOCS_FLAG_CONTRACTS],
   ["deps", DEPS_FLAG_CONTRACTS],
+  ["graph", GRAPH_FLAG_CONTRACTS],
   ["test", TEST_FLAG_CONTRACTS],
   ["test-all", TEST_ALL_FLAG_CONTRACTS],
   ["telemetry", TELEMETRY_FLAG_CONTRACTS],
@@ -3087,7 +3139,7 @@ function toCompletionFlagString(flagContracts, includeGlobal = true) {
 !(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] = "ced0a4db-9b0d-50c6-9de1-1d08dcf39c93");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "d9640c02-2d99-5ec4-b954-c6f5800d3af4");
   } catch (e2) {
   }
 })();
@@ -3433,6 +3485,22 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   edgeLimit: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
   tokenBudget: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
   cursor: { type: "string" },
+  direction: { type: "string", enum: ["outgoing", "incoming", "both"] },
+  kind: {
+    anyOf: [
+      { type: "string" },
+      { type: "array", items: { type: "string" } }
+    ]
+  },
+  after: { type: "string" },
+  maxPaths: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
+  sample: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
+  exemptIsolate: {
+    anyOf: [
+      { type: "string" },
+      { type: "array", items: { type: "string" } }
+    ]
+  },
   collapse: { type: "string", enum: ["none", "repeated"] },
   shell: { type: "string", enum: ["bash", "zsh", "fish"] },
   stdin: { type: "boolean" },
@@ -3748,7 +3816,7 @@ var PM_TOOL_PARAMETER_METADATA = {
     examples: ["Task", "Feature"]
   },
   subcommand: {
-    description: "Subcommand selector for schema, profile, and telemetry actions."
+    description: "Subcommand selector for schema, profile, telemetry, and graph actions."
   },
   name: {
     description: "Custom item type name (schema add-type/remove-type/show), custom status id (schema show-status/add-status/remove-status), custom field key (schema add-field/remove-field/show-field), or profile name (profile show/apply/lint).",
@@ -4328,6 +4396,30 @@ var PM_TOOL_PARAMETER_METADATA = {
   cursor: {
     description: "Opaque continuation cursor returned by deps --format context."
   },
+  direction: {
+    description: 'Graph-context traversal direction for deps action ("outgoing", "incoming", or "both").',
+    examples: ["both", "incoming"]
+  },
+  kind: {
+    description: "Registered relationship kinds narrowing deps --format context traversal (string, comma-separated, or array).",
+    examples: ["blocked_by", ["parent", "related"]]
+  },
+  after: {
+    description: "Continuation cursor resuming a bounded listing or traversal after this previously returned id.",
+    examples: ["pm-x1y2"]
+  },
+  maxPaths: {
+    description: "Maximum enumerated paths for graph paths queries.",
+    examples: [5, "10"]
+  },
+  sample: {
+    description: "Maximum evidence sample entries per graph audit finding.",
+    examples: [10, "25"]
+  },
+  exemptIsolate: {
+    description: "Item ids the graph audit treats as explicitly valid isolates (string, comma-separated, or array).",
+    examples: ["pm-x1y2", ["pm-x1y2", "pm-a3b4"]]
+  },
   collapse: {
     description: 'Dependency tree collapse mode for deps action ("none" or "repeated").',
     examples: ["none", "repeated"]
@@ -4397,6 +4489,43 @@ var PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
       description: "Profile name for show/apply/lint. Built-in profiles are agile, ops, and research; an active extension can contribute additional archetype names that resolve here too.",
       examples: ["agile", "ops", "research"]
     }
+  },
+  graph: {
+    subcommand: {
+      description: "Graph query selector: ancestors|descendants|predecessors|successors|paths|impact|analyze|audit|communities|redundancy|dominators|plan. Traversals, paths, impact, and dominators require id; paths also requires target; plan derives dry-run remediation proposals from the governance audit.",
+      examples: ["successors", "audit"]
+    },
+    id: {
+      description: "Root item id for traversal, paths, impact, and dominators graph queries.",
+      examples: ["pm-x1y2"]
+    },
+    target: {
+      description: "Target item id for graph paths queries.",
+      examples: ["pm-a3b4"]
+    },
+    direction: {
+      description: 'Edge orientation for graph paths/impact/dominators queries ("outgoing", "incoming", or "both"; default "both").',
+      examples: ["incoming"]
+    },
+    kind: {
+      description: "Registered relationship kinds narrowing the graph query (string, comma-separated, or array).",
+      examples: ["blocked_by", ["parent", "related"]]
+    },
+    maxDepth: {
+      description: "Maximum graph traversal depth (non-negative integer).",
+      examples: [2, "4"]
+    },
+    after: {
+      description: "Resume a hierarchy/ordering graph traversal after this previously returned node id.",
+      examples: ["pm-x1y2"]
+    },
+    limit: {
+      description: "Maximum returned rows per bounded graph collection (traversal ids, impact rows, analyze/communities samples, redundancy rows, dominator bottlenecks).",
+      examples: [10, "25"]
+    },
+    summary: {
+      description: "When true, return counts-first graph envelopes without row collections."
+    }
   }
 };
 
@@ -4404,7 +4533,7 @@ var PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
 !(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] = "15ef6d3d-a3e4-50ab-a3d8-ac9cfa57c110");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "b2640e2f-8ec1-5746-a121-018b7de82393");
   } catch (e2) {
   }
 })();
@@ -4428,6 +4557,29 @@ var PM_TOOL_ACTION_MUTATION_PARAMETER_KEYS = {
   "update-many": ["fullChangedFields"],
   "close-many": ["fullChangedFields"]
 };
+var PM_TOOL_ACTION_NESTED_OPTION_COMPATIBILITY_KEYS = Object.freeze({
+  "close-many": [
+    "list",
+    "expected_result",
+    "expected",
+    "actual_result",
+    "actual",
+    "validate_close",
+    "dry_run",
+    "checkpoint",
+    "no_checkpoint",
+    "filterAssignee_filter"
+  ],
+  "update-many": [
+    "list",
+    "update",
+    "dry_run",
+    "checkpoint",
+    "no_checkpoint",
+    "filterAssignee_filter"
+  ],
+  ...Object.fromEntries(PM_TOOL_ACTIONS.filter((action) => action === "install" || action === "extension" || action === "package" || action.startsWith("extension-") || action.startsWith("package-")).map((action) => [action, ["project", "local", "global"]]))
+});
 function toSchemaKeyList(values) {
   return normalizeUniqueStringList(values);
 }
@@ -4992,7 +5144,34 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   },
   deps: {
     required: ["id"],
-    optional: ["format", "maxDepth", "collapse", "summary", "nodeLimit", "edgeLimit", "tokenBudget", "cursor"]
+    optional: [
+      "format",
+      "maxDepth",
+      "collapse",
+      "summary",
+      "nodeLimit",
+      "edgeLimit",
+      "tokenBudget",
+      "cursor",
+      "direction",
+      "kind"
+    ]
+  },
+  graph: {
+    required: ["subcommand"],
+    optional: [
+      "id",
+      "target",
+      "kind",
+      "maxDepth",
+      "limit",
+      "after",
+      "direction",
+      "maxPaths",
+      "sample",
+      "exemptIsolate",
+      "summary"
+    ]
   },
   test: {
     required: ["id"],
@@ -5292,18 +5471,24 @@ function buildActionScopedAllOf(contract) {
   }
   return allOf;
 }
-function buildActionScopedToolSchema(action) {
+function pmToolActionParameterKeys(action) {
+  if (!Object.prototype.hasOwnProperty.call(PM_TOOL_ACTION_SCHEMA_CONTRACTS, action)) {
+    return void 0;
+  }
   const contract = PM_TOOL_ACTION_SCHEMA_CONTRACTS[action];
-  const required = toSchemaKeyList(contract.required ?? []);
-  const optional = toSchemaKeyList(contract.optional ?? []);
   const mutationParameterKeys = PM_TOOL_ACTION_MUTATION_PARAMETER_KEYS[action] ?? [];
-  const allowedKeys = toSchemaKeyList([
+  return toSchemaKeyList([
     "action",
     ...PM_TOOL_GLOBAL_PARAMETER_KEYS,
     ...mutationParameterKeys,
-    ...required,
-    ...optional
+    ...contract.required ?? [],
+    ...contract.optional ?? []
   ]);
+}
+function buildActionScopedToolSchema(action) {
+  const contract = PM_TOOL_ACTION_SCHEMA_CONTRACTS[action];
+  const required = toSchemaKeyList(contract.required ?? []);
+  const allowedKeys = pmToolActionParameterKeys(action);
   const schema = {
     type: "object",
     additionalProperties: false,
@@ -5398,27 +5583,11 @@ function buildProviderCompatibleToolSchema() {
 }
 var PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = createLazyContractSchema(buildProviderCompatibleToolSchema);
 
-// dist/sdk/cli-contracts/command-aliases.js
-!(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] = "e5081784-d3d0-5fd3-9f6a-294a621995ef");
-  } catch (e2) {
-  }
-})();
-var EXECUTABLE_COMMAND_ALIASES = {
-  show: "get",
-  view: "get",
-  comment: "comments",
-  note: "notes",
-  learning: "learnings"
-};
-
 // dist/sdk/cli-contracts.js
 !(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] = "03628345-205e-5ae0-9a16-1f47628ea7af");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "04a1cf17-7ffe-56c2-bf4d-73e4368161f5");
   } catch (e2) {
   }
 })();
@@ -5447,6 +5616,7 @@ export {
   PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS,
   PM_EXTENSION_POLICY_SURFACE_CONTRACTS,
   PM_CORE_COMMAND_NAMES,
+  GRAPH_SUBCOMMAND_VALUES,
   PM_TOOL_ACTIONS,
   isPmToolAction,
   isPmExtensionCapabilityContract,
@@ -5536,6 +5706,7 @@ export {
   GET_FLAG_CONTRACTS,
   GUIDE_FLAG_CONTRACTS,
   DEPS_FLAG_CONTRACTS,
+  GRAPH_FLAG_CONTRACTS,
   EVAL_FLAG_CONTRACTS,
   NEXT_FLAG_CONTRACTS,
   SEARCH_FLAG_CONTRACTS,
@@ -5550,4 +5721,4 @@ export {
   PM_TOOL_PARAMETERS_SCHEMA,
   PM_PROVIDER_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-H5APFTHZ.js.map
+//# sourceMappingURL=chunk-WQXRZMFN.js.map