@unbrained/pm-cli 2026.7.17 → 2026.7.18

package/dist/cli-bundle/chunks/{chunk-B6SH2YNN.js → chunk-7R6UIHYY.js}

@@ -11,7 +11,7 @@ import {
   readFirstStringFromCommanderOptions,
   readFirstValueFromCommanderOptions,
   readStringArrayFromCommanderOptions
-} from "./chunk-S6FF7VW6.js";
+} from "./chunk-WQXRZMFN.js";
 import {
   printError,
   writeStdout
@@ -3105,4 +3105,4 @@ export {
   normalizeNextOptions,
   invalidateSearchCachesForMutation
 };
-//# sourceMappingURL=chunk-B6SH2YNN.js.map
+//# sourceMappingURL=chunk-7R6UIHYY.js.map

package/dist/cli-bundle/chunks/{chunk-NCAFUBJX.js → chunk-7UCY6DR5.js}

@@ -1,5 +1,5 @@
 
-!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]="9decba65-3d76-51de-a780-8cac1ab5d5b7")}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]="ebed3dd6-7ac3-5ba9-81af-461fa44a9c47")}catch(e){}}();
 import {
   KNOWN_EXTENSION_CAPABILITIES,
   KNOWN_EXTENSION_POLICY_MODES,
@@ -1192,6 +1192,7 @@ var PM_CORE_COMMAND_NAMES = [
   "context",
   "ctx",
   "get",
+  "graph",
   "search",
   "eval",
   "next",
@@ -1234,6 +1235,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",
@@ -1305,6 +1320,7 @@ var PM_TOOL_ACTIONS = [
   "files",
   "docs",
   "deps",
+  "graph",
   "test",
   "test-all",
   "telemetry",
@@ -1677,7 +1693,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
@@ -2831,6 +2849,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 = [
@@ -2983,6 +3018,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],
@@ -3395,6 +3431,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" },
@@ -3710,7 +3762,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).",
@@ -4290,6 +4342,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"]
@@ -4359,6 +4435,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."
+    }
   }
 };
 
@@ -4383,6 +4496,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);
 }
@@ -4947,7 +5083,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"],
@@ -5247,18 +5410,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,
@@ -5377,6 +5546,7 @@ export {
   PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS,
   PM_EXTENSION_POLICY_SURFACE_CONTRACTS,
   PM_CORE_COMMAND_NAMES,
+  GRAPH_SUBCOMMAND_VALUES,
   PM_TOOL_ACTIONS,
   isPmToolAction,
   isPmExtensionCapabilityContract,
@@ -5466,6 +5636,7 @@ export {
   GET_FLAG_CONTRACTS,
   GUIDE_FLAG_CONTRACTS,
   DEPS_FLAG_CONTRACTS,
+  GRAPH_FLAG_CONTRACTS,
   EVAL_FLAG_CONTRACTS,
   NEXT_FLAG_CONTRACTS,
   SEARCH_FLAG_CONTRACTS,
@@ -5480,6 +5651,6 @@ export {
   PM_TOOL_PARAMETERS_SCHEMA,
   PM_PROVIDER_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-NCAFUBJX.js.map
+//# sourceMappingURL=chunk-7UCY6DR5.js.map
 
-//# debugId=9decba65-3d76-51de-a780-8cac1ab5d5b7
+//# debugId=ebed3dd6-7ac3-5ba9-81af-461fa44a9c47