@unbrained/pm-cli 2026.7.16 → 2026.7.18

package/dist/cli-bundle/chunks/{chunk-LPYWLWDS.js → chunk-SIPOACV5.js}

@@ -1,10 +1,10 @@
 
-!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]="f89dda3b-e8c4-53c1-8d8b-b884a198a28d")}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]="038cbba4-9d1e-5b41-b501-d40eec7260cd")}catch(e){}}();
 import {
   assertHistoryRepairTarget,
   runHistoryRepair,
   runHistoryRepairAll
-} from "./chunk-7PIWCHTW.js";
+} from "./chunk-R5XTTZSJ.js";
 import {
   resolveStartTaskInProgressStatus,
   runClaim,
@@ -18,73 +18,70 @@ import {
   runTest,
   runTestAll,
   runValidate
-} from "./chunk-5ZSLZLDN.js";
+} from "./chunk-6VHUGVNP.js";
 import {
   runDocs
-} from "./chunk-IA5FKNII.js";
-import {
-  runDeps
-} from "./chunk-JFTKLTEF.js";
+} from "./chunk-X2MGQMZO.js";
 import {
   runCopy
-} from "./chunk-DM4H7FP4.js";
+} from "./chunk-633PKXLT.js";
 import {
   runFocus
-} from "./chunk-JYFOV7FC.js";
+} from "./chunk-IE5KRAKN.js";
 import {
   runDelete
-} from "./chunk-PMOSXADO.js";
+} from "./chunk-47HXN6RX.js";
 import {
   runAppend
-} from "./chunk-S6MQESFR.js";
+} from "./chunk-67RO3H4N.js";
 import {
   runProfileApply,
   runProfileLint,
   runProfileList,
   runProfileShow
-} from "./chunk-J5AOEGDC.js";
+} from "./chunk-HYTOJW2Q.js";
 import {
   runNotes
-} from "./chunk-QEHQ2GVG.js";
+} from "./chunk-FY4RLHSC.js";
 import {
   runLearnings
-} from "./chunk-RRM5JYJC.js";
+} from "./chunk-6O44IN44.js";
 import {
   runFiles,
   runFilesDiscover
-} from "./chunk-TQSZFPIS.js";
+} from "./chunk-AFGKSHAM.js";
 import {
   runCloseMany
-} from "./chunk-P74IZQ7A.js";
+} from "./chunk-EWIT5WIC.js";
 import {
   runUpdateMany
-} from "./chunk-5JLUII3O.js";
+} from "./chunk-43UMFKCK.js";
 import {
   runRestore
-} from "./chunk-HO4KXD6I.js";
+} from "./chunk-7H5NNCJ5.js";
 import {
   runUpdate
-} from "./chunk-EACOH7AU.js";
+} from "./chunk-YIIIAKCE.js";
 import {
   runPlan
-} from "./chunk-DYH63FX7.js";
+} from "./chunk-VE6ZSTQW.js";
 import {
   assertHistoryCompactTarget,
   runHistoryCompact,
   runHistoryCompactBulk
-} from "./chunk-WQPUU7XD.js";
+} from "./chunk-L337QKWJ.js";
 import {
   runComments
-} from "./chunk-3CLU2XZO.js";
+} from "./chunk-HSYV4ZYT.js";
 import {
   runConfig,
   runUpgrade
-} from "./chunk-YAROI3PD.js";
+} from "./chunk-IL5SPRMH.js";
 import {
   SCAFFOLD_CAPABILITIES,
   runExtension,
   runInit
-} from "./chunk-J6EY5V4N.js";
+} from "./chunk-QRZNCRNA.js";
 import {
   runSchemaAddField,
   runSchemaAddStatus,
@@ -99,24 +96,28 @@ import {
   runSchemaShow,
   runSchemaShowField,
   runSchemaShowStatus
-} from "./chunk-INU6DKT5.js";
+} from "./chunk-FXFCFL73.js";
 import {
   runAggregate,
   runGet,
+  runGraph,
   runSearch
-} from "./chunk-ONG5V5CI.js";
+} from "./chunk-QPGQNLPI.js";
+import {
+  runDeps
+} from "./chunk-EX7OQT3Y.js";
 import {
   runActivity,
   runContext,
   runHistory,
   runNext
-} from "./chunk-7Z4LKRS4.js";
+} from "./chunk-XPUTSGJU.js";
 import {
   runList
-} from "./chunk-UXONS674.js";
+} from "./chunk-NCVT6XEL.js";
 import {
   runHistoryRedact
-} from "./chunk-GOSLKLFE.js";
+} from "./chunk-KH6QAHME.js";
 import {
   resolveRegisteredSearchProvider,
   resolveRegisteredVectorStoreAdapter
@@ -143,7 +144,7 @@ import {
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores,
   writeVectorizationStatusLedger
-} from "./chunk-JXQUXVMI.js";
+} from "./chunk-E4FXM2XB.js";
 import {
   ACTIVITY_FLAG_CONTRACTS,
   AGGREGATE_FLAG_CONTRACTS,
@@ -160,6 +161,7 @@ import {
   FOCUS_FLAG_CONTRACTS,
   GET_FLAG_CONTRACTS,
   GLOBAL_FLAG_CONTRACTS,
+  GRAPH_FLAG_CONTRACTS,
   GUIDE_FLAG_CONTRACTS,
   HEALTH_FLAG_CONTRACTS,
   INIT_FLAG_CONTRACTS,
@@ -175,19 +177,19 @@ import {
   UPDATE_FLAG_CONTRACTS,
   UPDATE_MANY_FLAG_CONTRACTS,
   toCompletionFlagString
-} from "./chunk-3S5QVM5H.js";
+} from "./chunk-7UCY6DR5.js";
 import {
   runCreate
-} from "./chunk-EH2OPHBI.js";
+} from "./chunk-HTXXXF45.js";
 import {
   parseTags
-} from "./chunk-EJEXHTY5.js";
+} from "./chunk-FHOBCGQO.js";
 import {
   projectMutationResult
-} from "./chunk-QKXHFPYM.js";
+} from "./chunk-BIRYX32V.js";
 import {
   runClose
-} from "./chunk-UFXU44HV.js";
+} from "./chunk-35FHWD4C.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -210,7 +212,7 @@ import {
   setActiveExtensionRegistrations,
   setActiveExtensionRenderers,
   setActiveExtensionServices
-} from "./chunk-Q7A43DS4.js";
+} from "./chunk-P22HGFFI.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -238,7 +240,7 @@ import {
   resolveRuntimeStatusRegistry,
   toNonEmptyStringOrUndefined,
   writeFileAtomic
-} from "./chunk-QKECXBBG.js";
+} from "./chunk-KX62NMZC.js";
 
 // dist/sdk/runtime.js
 import path3 from "node:path";
@@ -326,16 +328,362 @@ function parseRuntimeInteger(value, label) {
     if (!Number.isInteger(value)) {
       throw new PmCliError(`${label} must be a finite integer.`, EXIT_CODE.USAGE);
     }
-    return value;
+    return value;
+  }
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed)) {
+      throw new PmCliError(`${label} must be a finite integer.`, EXIT_CODE.USAGE);
+    }
+    return parsed;
+  }
+  return void 0;
+}
+function actionGlobalOptions(args) {
+  return {
+    json: true,
+    quiet: true,
+    path: readRuntimeString(args, "path"),
+    noExtensions: args.noExtensions === true || args.no_extensions === true,
+    noPager: true
+  };
+}
+var ARRAY_TO_CSV_FIELDS = /* @__PURE__ */ new Set([
+  "tags",
+  "blockedBy",
+  "blocked_by",
+  "skills",
+  "fields"
+]);
+var SCALAR_TO_ARRAY_FIELDS = /* @__PURE__ */ new Set([
+  "comment",
+  "note",
+  "learning",
+  "reminder",
+  "event",
+  "dep",
+  "depRemove",
+  "dep_remove",
+  "file",
+  "doc",
+  "test",
+  "unset",
+  "addGlob",
+  "add_glob",
+  "migrate",
+  "envSet",
+  "env_set",
+  "envClear",
+  "env_clear"
+]);
+var ARRAY_ADD_REMOVE_ACTIONS = /* @__PURE__ */ new Set([
+  "files",
+  "files-discover",
+  "docs",
+  "test",
+  "test-all"
+]);
+var LIFECYCLE_AUTHOR_ALIAS_ACTIONS = /* @__PURE__ */ new Set([
+  "claim",
+  "release",
+  "start-task",
+  "pause-task",
+  "close-task"
+]);
+function normalizeMcpOptionsArrays(options, action) {
+  const result = {};
+  const promoteAddRemove = action !== void 0 && ARRAY_ADD_REMOVE_ACTIONS.has(action);
+  const preserveStandaloneNote = action === "files" || action === "files-discover" || action === "docs";
+  for (const [key, value] of Object.entries(options)) {
+    if (Array.isArray(value) && ARRAY_TO_CSV_FIELDS.has(key)) {
+      result[key] = value.join(",");
+      continue;
+    }
+    if (key === "note" && preserveStandaloneNote) {
+      result[key] = value;
+      continue;
+    }
+    if (typeof value === "string" && SCALAR_TO_ARRAY_FIELDS.has(key)) {
+      result[key] = [value];
+      continue;
+    }
+    if (typeof value === "string" && promoteAddRemove && (key === "add" || key === "remove")) {
+      result[key] = [value];
+      continue;
+    }
+    result[key] = value;
+  }
+  return result;
+}
+function optionsWithAuthor(args, action) {
+  const baseOptions = asRecordClone(args.options);
+  const hoistedTopLevel = {};
+  const hoistKey = (key) => {
+    if (baseOptions[key] !== void 0 || args[key] === void 0) {
+      return;
+    }
+    hoistedTopLevel[key] = args[key];
+  };
+  if (action === "list") {
+    hoistKey("status");
+    hoistKey("type");
+    hoistKey("tag");
+    hoistKey("priority");
+    hoistKey("limit");
+    hoistKey("offset");
+  } else if (action === "search") {
+    hoistKey("mode");
+    hoistKey("status");
+    hoistKey("type");
+    hoistKey("tag");
+    hoistKey("priority");
+    hoistKey("limit");
+  } else if (action === "create") {
+    hoistKey("title");
+    hoistKey("type");
+    hoistKey("status");
+    hoistKey("description");
+    hoistKey("body");
+    hoistKey("priority");
+    hoistKey("tags");
+    hoistKey("parent");
+    hoistKey("createMode");
+    hoistKey("create_mode");
+    hoistKey("allowMissingParent");
+  } else if (action === "close") {
+    hoistKey("duplicateOf");
+  } else if (action === "append") {
+    hoistKey("body");
+  }
+  const options = normalizeMcpOptionsArrays({ ...hoistedTopLevel, ...baseOptions }, action);
+  const author = readRuntimeString(args, "author");
+  const authorFromAssignee = action !== void 0 && LIFECYCLE_AUTHOR_ALIAS_ACTIONS.has(action) ? readRuntimeString(args, "assignee") ?? readRuntimeString(options, "assignee") : void 0;
+  if (author && options.author === void 0) {
+    return { ...options, author };
+  }
+  if (authorFromAssignee && options.author === void 0) {
+    return { ...options, author: authorFromAssignee };
+  }
+  return options;
+}
+function withAddNoteOption(options) {
+  if (options.addNote === void 0) {
+    return options;
+  }
+  const next2 = { ...options };
+  if (next2.note === void 0 && typeof next2.addNote === "string") {
+    next2.note = next2.addNote;
+  }
+  delete next2.addNote;
+  return next2;
+}
+function withFilesDiscoveryOptions(options) {
+  const next2 = { ...options };
+  if (next2.discoveryNote !== void 0 && next2.note === void 0 && typeof next2.discoveryNote === "string") {
+    next2.note = next2.discoveryNote;
+  }
+  delete next2.discover;
+  delete next2.discoveryNote;
+  return next2;
+}
+function normalizeActionName(value) {
+  const chunks = [];
+  let lastWasSeparator = true;
+  for (const character of value.trim().toLowerCase()) {
+    const isAlphaNumeric = character >= "a" && character <= "z" || character >= "0" && character <= "9";
+    if (isAlphaNumeric) {
+      chunks.push(character);
+      lastWasSeparator = false;
+      continue;
+    }
+    if (!lastWasSeparator) {
+      chunks.push("-");
+      lastWasSeparator = true;
+    }
+  }
+  if (chunks.at(-1) === "-") {
+    chunks.pop();
+  }
+  return chunks.join("");
+}
+function normalizeCommandPath(value) {
+  return value.trim().toLowerCase().split(/\s+/).filter(Boolean).join(" ");
+}
+function readRuntimeStringArray(value) {
+  if (!Array.isArray(value)) {
+    return [];
+  }
+  return value.map((entry) => String(entry)).filter((entry) => entry.length > 0);
+}
+function extensionOptionsFromArgs(args, options) {
+  const reserved = /* @__PURE__ */ new Set([
+    "action",
+    "args",
+    "author",
+    "cwd",
+    "fullChangedFields",
+    "id",
+    "options",
+    "path",
+    "query",
+    "reason",
+    "target"
+  ]);
+  const passthrough = {};
+  for (const [key, value] of Object.entries(args)) {
+    if (!reserved.has(key)) {
+      passthrough[key] = value;
+    }
+  }
+  const normalizedOptions = { ...passthrough, ...options };
+  delete normalizedOptions.args;
+  return normalizedOptions;
+}
+function withMutationCompaction(args, options) {
+  return {
+    changedFields: args.fullChangedFields === true ? "full" : "compact",
+    idOnly: args.idOnly === true,
+    runnerOptions: { ...options }
+  };
+}
+function mutationListOptions(options) {
+  return {
+    type: readRuntimeScalarString(options, "filterType"),
+    tag: readRuntimeScalarString(options, "filterTag"),
+    priority: readRuntimeScalarString(options, "filterPriority"),
+    deadlineBefore: readRuntimeScalarString(options, "filterDeadlineBefore"),
+    deadlineAfter: readRuntimeScalarString(options, "filterDeadlineAfter"),
+    updatedAfter: readRuntimeScalarString(options, "filterUpdatedAfter"),
+    updatedBefore: readRuntimeScalarString(options, "filterUpdatedBefore"),
+    createdAfter: readRuntimeScalarString(options, "filterCreatedAfter"),
+    createdBefore: readRuntimeScalarString(options, "filterCreatedBefore"),
+    ids: readRuntimeScalarStringAllowBlank(options, "ids"),
+    assignee: readRuntimeScalarString(options, "filterAssignee"),
+    assigneeFilter: readRuntimeScalarString(options, "filterAssigneeFilter") ?? readRuntimeScalarString(options, "filterAssignee_filter"),
+    parent: readRuntimeScalarString(options, "filterParent"),
+    sprint: readRuntimeScalarString(options, "filterSprint"),
+    release: readRuntimeScalarString(options, "filterRelease"),
+    limit: readRuntimeScalarString(options, "limit"),
+    offset: readRuntimeScalarString(options, "offset")
+  };
+}
+function readGraphIdListOption(value) {
+  if (typeof value === "string" && value.trim().length > 0)
+    return value;
+  if (Array.isArray(value))
+    return readRuntimeStringArray(value);
+  return void 0;
+}
+function readGraphBoundOption(value) {
+  if (typeof value === "number" && Number.isFinite(value))
+    return value;
+  if (typeof value === "string" && value.trim().length > 0)
+    return value;
+  return void 0;
+}
+function graphOptionsFromFlat(options) {
+  const kind = readGraphIdListOption(options.kind);
+  const exemptIsolate = readGraphIdListOption(options.exemptIsolate);
+  return {
+    ...kind === void 0 ? {} : { kind },
+    maxDepth: readGraphBoundOption(options.maxDepth),
+    limit: readGraphBoundOption(options.limit),
+    after: readRuntimeString(options, "after"),
+    direction: readRuntimeString(options, "direction"),
+    maxPaths: readGraphBoundOption(options.maxPaths),
+    sample: readGraphBoundOption(options.sample),
+    ...exemptIsolate === void 0 ? {} : { exemptIsolate },
+    summary: options.summary === true
+  };
+}
+function closeManyOptionsFromFlat(options) {
+  return {
+    status: readRuntimeString(options, "filterStatus"),
+    list: isRuntimeRecord(options.list) ? normalizeListOptions(options.list) : mutationListOptions(options),
+    reason: readRuntimeString(options, "reason"),
+    resolution: readRuntimeString(options, "resolution"),
+    expectedResult: readRuntimeString(options, "expectedResult") ?? readRuntimeString(options, "expected_result") ?? readRuntimeString(options, "expected"),
+    actualResult: readRuntimeString(options, "actualResult") ?? readRuntimeString(options, "actual_result") ?? readRuntimeString(options, "actual"),
+    validateClose: readRuntimeString(options, "validateClose") ?? readRuntimeString(options, "validate_close"),
+    author: readRuntimeString(options, "author"),
+    message: readRuntimeString(options, "message"),
+    force: options.force === true ? true : void 0,
+    dryRun: options.dryRun === true || options.dry_run === true ? true : void 0,
+    rollback: readRuntimeString(options, "rollback"),
+    checkpoint: options.checkpoint === false || options.noCheckpoint === true || options.no_checkpoint === true ? false : void 0
+  };
+}
+var UPDATE_MANY_FLAT_CONTROL_KEYS = /* @__PURE__ */ new Set([
+  "filterStatus",
+  "filterType",
+  "filterTag",
+  "filterPriority",
+  "filterDeadlineBefore",
+  "filterDeadlineAfter",
+  "filterUpdatedAfter",
+  "filterUpdatedBefore",
+  "filterCreatedAfter",
+  "filterCreatedBefore",
+  "filterAssignee",
+  "filterAssigneeFilter",
+  "filterAssignee_filter",
+  "filterParent",
+  "filterSprint",
+  "filterRelease",
+  "ids",
+  "list",
+  "update",
+  "limit",
+  "offset",
+  "dryRun",
+  "dry_run",
+  "rollback",
+  "checkpoint",
+  "noCheckpoint",
+  "no_checkpoint"
+]);
+function updateManyUpdateOptionsFromFlat(options) {
+  const update2 = {};
+  for (const [key, value] of Object.entries(options)) {
+    if (UPDATE_MANY_FLAT_CONTROL_KEYS.has(key)) {
+      continue;
+    }
+    update2[key] = value;
   }
-  if (typeof value === "string" && value.trim().length > 0) {
-    const parsed = Number(value);
-    if (!Number.isInteger(parsed)) {
-      throw new PmCliError(`${label} must be a finite integer.`, EXIT_CODE.USAGE);
+  return normalizeMcpUpdateOptions(update2);
+}
+function normalizeMcpUpdateOptions(options) {
+  const normalizedInput = normalizeMcpOptionsArrays(options, "update-many");
+  for (const contract of UPDATE_COMMANDER_STRING_OPTION_CONTRACTS) {
+    for (const key of contract.keys) {
+      const value = normalizedInput[key];
+      if (typeof value === "number" && Number.isFinite(value)) {
+        normalizedInput[key] = String(value);
+      }
     }
-    return parsed;
   }
-  return void 0;
+  return normalizeUpdateOptions(normalizedInput);
+}
+function updateManyOptionsFromFlat(options) {
+  if (isRuntimeRecord(options.list) || isRuntimeRecord(options.update)) {
+    const updateSource = isRuntimeRecord(options.update) ? options.update : updateManyUpdateOptionsFromFlat(options);
+    return {
+      status: readRuntimeScalarString(options, "filterStatus"),
+      list: isRuntimeRecord(options.list) ? normalizeListOptions(options.list) : mutationListOptions(options),
+      update: normalizeMcpUpdateOptions(updateSource),
+      dryRun: options.dryRun === true || options.dry_run === true ? true : void 0,
+      rollback: readRuntimeString(options, "rollback"),
+      checkpoint: options.checkpoint === false || options.noCheckpoint === true || options.no_checkpoint === true ? false : void 0
+    };
+  }
+  return {
+    status: readRuntimeScalarString(options, "filterStatus"),
+    list: mutationListOptions(options),
+    update: updateManyUpdateOptionsFromFlat(options),
+    dryRun: options.dryRun === true || options.dry_run === true ? true : void 0,
+    rollback: readRuntimeString(options, "rollback"),
+    checkpoint: options.checkpoint === false || options.noCheckpoint === true || options.no_checkpoint === true ? false : void 0
+  };
 }
 
 // dist/sdk/history-mcp.js
@@ -1473,6 +1821,7 @@ var CALENDAR_FLAGS = toCompletionFlagString(CALENDAR_FLAG_CONTRACTS);
 var CONTEXT_FLAGS = toCompletionFlagString(CONTEXT_FLAG_CONTRACTS);
 var NEXT_FLAGS = toCompletionFlagString(NEXT_FLAG_CONTRACTS);
 var DEPS_FLAGS = toCompletionFlagString(DEPS_FLAG_CONTRACTS);
+var GRAPH_FLAGS = toCompletionFlagString(GRAPH_FLAG_CONTRACTS);
 var GUIDE_FLAGS = toCompletionFlagString(GUIDE_FLAG_CONTRACTS);
 var SEARCH_FLAGS = toCompletionFlagString(SEARCH_FLAG_CONTRACTS);
 var HEALTH_FLAGS = toCompletionFlagString(HEALTH_FLAG_CONTRACTS);
@@ -1565,6 +1914,7 @@ var COMMAND_COMPLETION_DESCRIPTIONS = [
   ["files", "Manage linked files"],
   ["docs", "Manage linked docs"],
   ["deps", "Show dependency relationships for an item"],
+  ["graph", "Bounded graph traversal, analytics, and governance-audit queries"],
   ["test", "Manage linked tests and optionally run them"],
   ["test-all", "Run linked tests across matching items"],
   ["test-runs", "Manage background linked-test runs"],
@@ -2021,6 +2371,9 @@ function generateBashScript(itemTypes = [], tags = [], eagerTagExpansion = false
     "    deps)",
     `      COMPREPLY=(${compgen(DEPS_FLAGS)})`,
     "      ;;",
+    "    graph)",
+    `      COMPREPLY=(${compgen(`ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators plan ${GRAPH_FLAGS}`)})`,
+    "      ;;",
     "    test)",
     `      COMPREPLY=(${compgen("--add --add-json --remove --list --run --match --only-index --only-last --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
     "      ;;",
@@ -2722,10 +3075,31 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           ;;
         deps)
           _arguments \\
-            '--format[Output format]:(tree graph)' \\
+            '--format[Output format]:(tree graph context)' \\
             '--max-depth[Maximum traversal depth (0 keeps root only)]:depth' \\
             '--collapse[Collapse mode]:(none repeated)' \\
             '--summary[Return counts only without tree/graph payload]' \\
+            '--node-limit[Maximum nodes in context output]:number' \\
+            '--edge-limit[Maximum edges in context output]:number' \\
+            '--token-budget[Maximum estimated tokens in context output]:number' \\
+            '--cursor[Continue an equivalent context query]:cursor' \\
+            '--direction[Context traversal direction]:(outgoing incoming both)' \\
+            '--kind[Restrict context traversal to relationship kinds]:kind' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        graph)
+          _arguments \\
+            '1:subcommand:(ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators plan)' \\
+            '--kind[Restrict traversal to registered relationship kinds]:kind' \\
+            '--max-depth[Maximum traversal depth]:depth' \\
+            '--limit[Maximum returned rows per bounded collection]:number' \\
+            '--after[Resume a traversal after this node id]:id' \\
+            '--direction[Edge orientation for paths/impact]:(outgoing incoming both)' \\
+            '--max-paths[Maximum enumerated paths]:number' \\
+            '--sample[Maximum evidence sample entries per audit finding]:number' \\
+            '--exempt-isolate[Item ids treated as explicitly valid isolates]:id' \\
+            '--summary[Return counts-first envelopes without row collections]' \\
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
@@ -3589,10 +3963,26 @@ complete -c pm -n '__fish_seen_subcommand_from contracts' -l flags-only -d 'Retu
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l availability-only -d 'Return action availability only'
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l runtime-only -d 'Include only actions invocable in the current runtime'
 complete -c pm -n '__fish_seen_subcommand_from contracts' -l active-only -d 'Alias for --runtime-only'
-complete -c pm -n '__fish_seen_subcommand_from deps' -l format -d 'Output format' -r -a 'tree graph'
+complete -c pm -n '__fish_seen_subcommand_from deps' -l format -d 'Output format' -r -a 'tree graph context'
 complete -c pm -n '__fish_seen_subcommand_from deps' -l max-depth -d 'Maximum traversal depth (0 keeps root only)' -r
 complete -c pm -n '__fish_seen_subcommand_from deps' -l collapse -d 'Collapse mode' -r -a 'none repeated'
 complete -c pm -n '__fish_seen_subcommand_from deps' -l summary -d 'Return counts only without tree/graph payload'
+complete -c pm -n '__fish_seen_subcommand_from deps' -l node-limit -d 'Maximum nodes in context output' -r
+complete -c pm -n '__fish_seen_subcommand_from deps' -l edge-limit -d 'Maximum edges in context output' -r
+complete -c pm -n '__fish_seen_subcommand_from deps' -l token-budget -d 'Maximum estimated tokens in context output' -r
+complete -c pm -n '__fish_seen_subcommand_from deps' -l cursor -d 'Continue an equivalent context query' -r
+complete -c pm -n '__fish_seen_subcommand_from deps' -l direction -d 'Context traversal direction' -r -a 'outgoing incoming both'
+complete -c pm -n '__fish_seen_subcommand_from deps' -l kind -d 'Restrict context traversal to relationship kinds' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -a 'ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators plan' -d 'Graph query'
+complete -c pm -n '__fish_seen_subcommand_from graph' -l kind -d 'Restrict traversal to registered relationship kinds' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l max-depth -d 'Maximum traversal depth' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l limit -d 'Maximum returned rows per bounded collection' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l after -d 'Resume a traversal after this node id' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l direction -d 'Edge orientation for paths/impact' -r -a 'outgoing incoming both'
+complete -c pm -n '__fish_seen_subcommand_from graph' -l max-paths -d 'Maximum enumerated paths' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l sample -d 'Maximum evidence sample entries per audit finding' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l exempt-isolate -d 'Item ids treated as explicitly valid isolates' -r
+complete -c pm -n '__fish_seen_subcommand_from graph' -l summary -d 'Return counts-first envelopes without row collections'
 
 # comments / notes / learnings flags
 complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l add -d 'Add one entry (text=<value> or plain text)' -r
@@ -4686,6 +5076,10 @@ var PmClient = class {
   deps(id, options = {}) {
     return this.runTyped("deps", { id, options });
   }
+  /** Run bounded workspace graph traversal, analytics, or governance-audit queries. */
+  graph(subcommand, ids = {}, options = {}) {
+    return this.runTyped("graph", { subcommand, ...ids, options });
+  }
   /** Append markdown/body text to an item through the mutation pipeline. */
   append(id, body, options = {}) {
     return this.runTyped("append", {
@@ -5138,6 +5532,9 @@ function docs(id, options = {}, clientOptions = {}) {
 function deps(id, options = {}, clientOptions = {}) {
   return new PmClient(clientOptions).deps(id, options);
 }
+function graph(subcommand, ids = {}, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).graph(subcommand, ids, options);
+}
 function append(id, body, options = {}, clientOptions = {}) {
   return new PmClient(clientOptions).append(id, body, options);
 }
@@ -5277,288 +5674,88 @@ function extensionActivate(target, options = {}, clientOptions = {}) {
   return new PmClient(clientOptions).extensionActivate(target, options);
 }
 function extensionDeactivate(target, options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).extensionDeactivate(target, options);
-}
-function packageLifecycle(target, options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).package(target, options);
-}
-function packageList(options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).packageList(options);
-}
-function packageInstall(target, options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).packageInstall(target, options);
-}
-function packageUninstall(target, options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).packageUninstall(target, options);
-}
-function packageDoctor(options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).packageDoctor(options);
-}
-function packageManage(target, options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).packageManage(target, options);
-}
-function packageDescribe(target, options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).packageDescribe(target, options);
-}
-function packageReload(options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).packageReload(options);
-}
-function packageCatalog(options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).packageCatalog(options);
-}
-function packageActivate(target, options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).packageActivate(target, options);
-}
-function packageDeactivate(target, options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).packageDeactivate(target, options);
-}
-function upgrade(target, options = {}, clientOptions = {}) {
-  return new PmClient(clientOptions).upgrade(target, options);
-}
-function buildWorkspaceExtensionRegistrationsCacheKey(pmRoot, settings, cwd) {
-  return JSON.stringify([
-    path3.resolve(pmRoot),
-    path3.resolve(cwd ?? process.cwd()),
-    settings.extensions.enabled,
-    settings.extensions.disabled,
-    settings.extensions.policy
-  ]);
-}
-async function resolveWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
-  const cacheKey = buildWorkspaceExtensionRegistrationsCacheKey(pmRoot, settings, cwd);
-  return memoizeWorkspaceExtensionRegistrations(cacheKey, () => loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd));
-}
-async function getWorkspaceContracts(pmRoot, options = {}) {
-  const settings = await readSettings(pmRoot);
-  const extensionRegistrations = options.extensionRegistrations ?? (options.noExtensions === true ? null : await resolveWorkspaceExtensionRegistrations(pmRoot, settings, options.cwd));
-  const typeRegistry = resolveItemTypeRegistry(settings, extensionRegistrations);
-  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
-  return {
-    types: [...typeRegistry.types],
-    statuses: statusRegistry.definitions.map((definition) => definition.id),
-    openStatus: statusRegistry.open_status,
-    closeStatus: statusRegistry.close_status,
-    canceledStatus: statusRegistry.canceled_status
-  };
-}
-async function getContracts(pmRootOrOptions, options = {}) {
-  const resolvedOptions = typeof pmRootOrOptions === "string" ? { ...options, pmRoot: pmRootOrOptions } : pmRootOrOptions ?? options;
-  const global = {
-    json: true,
-    quiet: resolvedOptions.quiet ?? true,
-    noExtensions: resolvedOptions.noExtensions ?? false,
-    noPager: true,
-    profile: resolvedOptions.profile ?? false,
-    path: resolvedOptions.pmRoot
-  };
-  return runContracts(resolvedOptions, global);
-}
-function readRequiredString(args, key) {
-  const value = readRuntimeString(args, key);
-  if (!value) {
-    throw new PmCliError(`Missing required argument: ${key}`, 64);
-  }
-  return value;
-}
-function globalOptions(args) {
-  return {
-    json: true,
-    quiet: true,
-    path: readRuntimeString(args, "path"),
-    noExtensions: args.noExtensions === true || args.no_extensions === true,
-    noPager: true
-  };
-}
-var ARRAY_TO_CSV_FIELDS = /* @__PURE__ */ new Set([
-  "tags",
-  "blockedBy",
-  "blocked_by",
-  "skills",
-  "fields"
-]);
-var SCALAR_TO_ARRAY_FIELDS = /* @__PURE__ */ new Set([
-  "comment",
-  "note",
-  "learning",
-  "reminder",
-  "event",
-  "dep",
-  "depRemove",
-  "dep_remove",
-  "file",
-  "doc",
-  "test",
-  "unset",
-  "addGlob",
-  "add_glob",
-  "migrate",
-  "envSet",
-  "env_set",
-  "envClear",
-  "env_clear"
-]);
-var ARRAY_ADD_REMOVE_ACTIONS = /* @__PURE__ */ new Set([
-  "files",
-  "files-discover",
-  "docs",
-  "test",
-  "test-all"
-]);
-var LIFECYCLE_AUTHOR_ALIAS_ACTIONS = /* @__PURE__ */ new Set([
-  "claim",
-  "release",
-  "start-task",
-  "pause-task",
-  "close-task"
-]);
-function normalizeMcpOptionsArrays(options, action) {
-  const result = {};
-  const promoteAddRemove = action !== void 0 && ARRAY_ADD_REMOVE_ACTIONS.has(action);
-  const preserveStandaloneNote = action === "files" || action === "files-discover" || action === "docs";
-  for (const [key, value] of Object.entries(options)) {
-    if (Array.isArray(value) && ARRAY_TO_CSV_FIELDS.has(key)) {
-      result[key] = value.join(",");
-      continue;
-    }
-    if (key === "note" && preserveStandaloneNote) {
-      result[key] = value;
-      continue;
-    }
-    if (typeof value === "string" && SCALAR_TO_ARRAY_FIELDS.has(key)) {
-      result[key] = [value];
-      continue;
-    }
-    if (typeof value === "string" && promoteAddRemove && (key === "add" || key === "remove")) {
-      result[key] = [value];
-      continue;
-    }
-    result[key] = value;
-  }
-  return result;
-}
-function optionsWithAuthor(args, action) {
-  const baseOptions = asRecordClone(args.options);
-  const hoistedTopLevel = {};
-  const hoistKey = (key) => {
-    if (baseOptions[key] !== void 0 || args[key] === void 0) {
-      return;
-    }
-    hoistedTopLevel[key] = args[key];
-  };
-  if (action === "list") {
-    hoistKey("status");
-    hoistKey("type");
-    hoistKey("tag");
-    hoistKey("priority");
-    hoistKey("limit");
-    hoistKey("offset");
-  } else if (action === "search") {
-    hoistKey("mode");
-    hoistKey("status");
-    hoistKey("type");
-    hoistKey("tag");
-    hoistKey("priority");
-    hoistKey("limit");
-  } else if (action === "create") {
-    hoistKey("title");
-    hoistKey("type");
-    hoistKey("status");
-    hoistKey("description");
-    hoistKey("body");
-    hoistKey("priority");
-    hoistKey("tags");
-    hoistKey("parent");
-    hoistKey("createMode");
-    hoistKey("create_mode");
-    hoistKey("allowMissingParent");
-  } else if (action === "close") {
-    hoistKey("duplicateOf");
-  } else if (action === "append") {
-    hoistKey("body");
-  }
-  const options = normalizeMcpOptionsArrays({ ...hoistedTopLevel, ...baseOptions }, action);
-  const author = readRuntimeString(args, "author");
-  const authorFromAssignee = action !== void 0 && LIFECYCLE_AUTHOR_ALIAS_ACTIONS.has(action) ? readRuntimeString(args, "assignee") ?? readRuntimeString(options, "assignee") : void 0;
-  if (author && options.author === void 0) {
-    return { ...options, author };
-  }
-  if (authorFromAssignee && options.author === void 0) {
-    return { ...options, author: authorFromAssignee };
-  }
-  return options;
+  return new PmClient(clientOptions).extensionDeactivate(target, options);
 }
-function withAddNoteOption(options) {
-  if (options.addNote === void 0) {
-    return options;
-  }
-  const next2 = { ...options };
-  if (next2.note === void 0 && typeof next2.addNote === "string") {
-    next2.note = next2.addNote;
-  }
-  delete next2.addNote;
-  return next2;
+function packageLifecycle(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).package(target, options);
 }
-function withFilesDiscoveryOptions(options) {
-  const next2 = { ...options };
-  if (next2.discoveryNote !== void 0 && next2.note === void 0 && typeof next2.discoveryNote === "string") {
-    next2.note = next2.discoveryNote;
-  }
-  delete next2.discover;
-  delete next2.discoveryNote;
-  return next2;
+function packageList(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageList(options);
 }
-function normalizeActionName(value) {
-  const chunks = [];
-  let lastWasSeparator = true;
-  for (const character of value.trim().toLowerCase()) {
-    const isAlphaNumeric = character >= "a" && character <= "z" || character >= "0" && character <= "9";
-    if (isAlphaNumeric) {
-      chunks.push(character);
-      lastWasSeparator = false;
-      continue;
-    }
-    if (!lastWasSeparator) {
-      chunks.push("-");
-      lastWasSeparator = true;
-    }
-  }
-  if (chunks.at(-1) === "-") {
-    chunks.pop();
-  }
-  return chunks.join("");
+function packageInstall(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageInstall(target, options);
 }
-function normalizeCommandPath(value) {
-  return value.trim().toLowerCase().split(/\s+/).filter(Boolean).join(" ");
+function packageUninstall(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageUninstall(target, options);
 }
-function readStringArray(value) {
-  if (!Array.isArray(value)) {
-    return [];
-  }
-  return value.map((entry) => String(entry)).filter((entry) => entry.length > 0);
+function packageDoctor(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageDoctor(options);
 }
-function extensionOptionsFromArgs(args, options) {
-  const reserved = /* @__PURE__ */ new Set([
-    "action",
-    "args",
-    "author",
-    "cwd",
-    "fullChangedFields",
-    "id",
-    "options",
-    "path",
-    "query",
-    "reason",
-    "target"
+function packageManage(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageManage(target, options);
+}
+function packageDescribe(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageDescribe(target, options);
+}
+function packageReload(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageReload(options);
+}
+function packageCatalog(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageCatalog(options);
+}
+function packageActivate(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageActivate(target, options);
+}
+function packageDeactivate(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).packageDeactivate(target, options);
+}
+function upgrade(target, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).upgrade(target, options);
+}
+function buildWorkspaceExtensionRegistrationsCacheKey(pmRoot, settings, cwd) {
+  return JSON.stringify([
+    path3.resolve(pmRoot),
+    path3.resolve(cwd ?? process.cwd()),
+    settings.extensions.enabled,
+    settings.extensions.disabled,
+    settings.extensions.policy
   ]);
-  const passthrough = {};
-  for (const [key, value] of Object.entries(args)) {
-    if (!reserved.has(key)) {
-      passthrough[key] = value;
-    }
+}
+async function resolveWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
+  const cacheKey = buildWorkspaceExtensionRegistrationsCacheKey(pmRoot, settings, cwd);
+  return memoizeWorkspaceExtensionRegistrations(cacheKey, () => loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd));
+}
+async function getWorkspaceContracts(pmRoot, options = {}) {
+  const settings = await readSettings(pmRoot);
+  const extensionRegistrations = options.extensionRegistrations ?? (options.noExtensions === true ? null : await resolveWorkspaceExtensionRegistrations(pmRoot, settings, options.cwd));
+  const typeRegistry = resolveItemTypeRegistry(settings, extensionRegistrations);
+  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+  return {
+    types: [...typeRegistry.types],
+    statuses: statusRegistry.definitions.map((definition) => definition.id),
+    openStatus: statusRegistry.open_status,
+    closeStatus: statusRegistry.close_status,
+    canceledStatus: statusRegistry.canceled_status
+  };
+}
+async function getContracts(pmRootOrOptions, options = {}) {
+  const resolvedOptions = typeof pmRootOrOptions === "string" ? { ...options, pmRoot: pmRootOrOptions } : pmRootOrOptions ?? options;
+  const global = {
+    json: true,
+    quiet: resolvedOptions.quiet ?? true,
+    noExtensions: resolvedOptions.noExtensions ?? false,
+    noPager: true,
+    profile: resolvedOptions.profile ?? false,
+    path: resolvedOptions.pmRoot
+  };
+  return runContracts(resolvedOptions, global);
+}
+function readRequiredString(args, key) {
+  const value = readRuntimeString(args, key);
+  if (!value) {
+    throw new PmCliError(`Missing required argument: ${key}`, 64);
   }
-  const normalizedOptions = { ...passthrough, ...options };
-  delete normalizedOptions.args;
-  return normalizedOptions;
+  return value;
 }
 var extensionActivationQueue = createSerialQueue();
 function resetActiveExtensionRegistries() {
@@ -5635,7 +5832,7 @@ async function dispatchActiveExtensionAction(action, args, options, global, acti
   }
   const handlerResult = await runActiveCommandHandler({
     command: normalizeCommandPath(command),
-    args: readStringArray(options.args ?? args.args),
+    args: readRuntimeStringArray(options.args ?? args.args),
     options: extensionOptionsFromArgs(args, options),
     global,
     pm_root: active.pmRoot
@@ -5655,123 +5852,6 @@ async function withCwd(cwd, run) {
     process.chdir(previous);
   }
 }
-function withMutationCompaction(args, options) {
-  return {
-    changedFields: args.fullChangedFields === true ? "full" : "compact",
-    idOnly: args.idOnly === true,
-    runnerOptions: { ...options }
-  };
-}
-function mutationListOptions(options) {
-  return {
-    type: readRuntimeScalarString(options, "filterType"),
-    tag: readRuntimeScalarString(options, "filterTag"),
-    priority: readRuntimeScalarString(options, "filterPriority"),
-    deadlineBefore: readRuntimeScalarString(options, "filterDeadlineBefore"),
-    deadlineAfter: readRuntimeScalarString(options, "filterDeadlineAfter"),
-    updatedAfter: readRuntimeScalarString(options, "filterUpdatedAfter"),
-    updatedBefore: readRuntimeScalarString(options, "filterUpdatedBefore"),
-    createdAfter: readRuntimeScalarString(options, "filterCreatedAfter"),
-    createdBefore: readRuntimeScalarString(options, "filterCreatedBefore"),
-    ids: readRuntimeScalarStringAllowBlank(options, "ids"),
-    assignee: readRuntimeScalarString(options, "filterAssignee"),
-    assigneeFilter: readRuntimeScalarString(options, "filterAssigneeFilter") ?? readRuntimeScalarString(options, "filterAssignee_filter"),
-    parent: readRuntimeScalarString(options, "filterParent"),
-    sprint: readRuntimeScalarString(options, "filterSprint"),
-    release: readRuntimeScalarString(options, "filterRelease"),
-    limit: readRuntimeScalarString(options, "limit"),
-    offset: readRuntimeScalarString(options, "offset")
-  };
-}
-function closeManyOptionsFromFlat(options) {
-  return {
-    status: readRuntimeString(options, "filterStatus"),
-    list: isRuntimeRecord(options.list) ? normalizeListOptions(options.list) : mutationListOptions(options),
-    reason: readRuntimeString(options, "reason"),
-    resolution: readRuntimeString(options, "resolution"),
-    expectedResult: readRuntimeString(options, "expectedResult") ?? readRuntimeString(options, "expected_result") ?? readRuntimeString(options, "expected"),
-    actualResult: readRuntimeString(options, "actualResult") ?? readRuntimeString(options, "actual_result") ?? readRuntimeString(options, "actual"),
-    validateClose: readRuntimeString(options, "validateClose") ?? readRuntimeString(options, "validate_close"),
-    author: readRuntimeString(options, "author"),
-    message: readRuntimeString(options, "message"),
-    force: options.force === true ? true : void 0,
-    dryRun: options.dryRun === true || options.dry_run === true ? true : void 0,
-    rollback: readRuntimeString(options, "rollback"),
-    checkpoint: options.checkpoint === false || options.noCheckpoint === true || options.no_checkpoint === true ? false : void 0
-  };
-}
-var UPDATE_MANY_FLAT_CONTROL_KEYS = /* @__PURE__ */ new Set([
-  "filterStatus",
-  "filterType",
-  "filterTag",
-  "filterPriority",
-  "filterDeadlineBefore",
-  "filterDeadlineAfter",
-  "filterUpdatedAfter",
-  "filterUpdatedBefore",
-  "filterCreatedAfter",
-  "filterCreatedBefore",
-  "filterAssignee",
-  "filterAssigneeFilter",
-  "filterAssignee_filter",
-  "filterParent",
-  "filterSprint",
-  "filterRelease",
-  "ids",
-  "list",
-  "update",
-  "limit",
-  "offset",
-  "dryRun",
-  "dry_run",
-  "rollback",
-  "checkpoint",
-  "noCheckpoint",
-  "no_checkpoint"
-]);
-function updateManyUpdateOptionsFromFlat(options) {
-  const update2 = {};
-  for (const [key, value] of Object.entries(options)) {
-    if (UPDATE_MANY_FLAT_CONTROL_KEYS.has(key)) {
-      continue;
-    }
-    update2[key] = value;
-  }
-  return normalizeMcpUpdateOptions(update2);
-}
-function normalizeMcpUpdateOptions(options) {
-  const normalizedInput = normalizeMcpOptionsArrays(options, "update-many");
-  for (const contract of UPDATE_COMMANDER_STRING_OPTION_CONTRACTS) {
-    for (const key of contract.keys) {
-      const value = normalizedInput[key];
-      if (typeof value === "number" && Number.isFinite(value)) {
-        normalizedInput[key] = String(value);
-      }
-    }
-  }
-  return normalizeUpdateOptions(normalizedInput);
-}
-function updateManyOptionsFromFlat(options) {
-  if (isRuntimeRecord(options.list) || isRuntimeRecord(options.update)) {
-    const updateSource = isRuntimeRecord(options.update) ? options.update : updateManyUpdateOptionsFromFlat(options);
-    return {
-      status: readRuntimeScalarString(options, "filterStatus"),
-      list: isRuntimeRecord(options.list) ? normalizeListOptions(options.list) : mutationListOptions(options),
-      update: normalizeMcpUpdateOptions(updateSource),
-      dryRun: options.dryRun === true || options.dry_run === true ? true : void 0,
-      rollback: readRuntimeString(options, "rollback"),
-      checkpoint: options.checkpoint === false || options.noCheckpoint === true || options.no_checkpoint === true ? false : void 0
-    };
-  }
-  return {
-    status: readRuntimeScalarString(options, "filterStatus"),
-    list: mutationListOptions(options),
-    update: updateManyUpdateOptionsFromFlat(options),
-    dryRun: options.dryRun === true || options.dry_run === true ? true : void 0,
-    rollback: readRuntimeString(options, "rollback"),
-    checkpoint: options.checkpoint === false || options.noCheckpoint === true || options.no_checkpoint === true ? false : void 0
-  };
-}
 var WORKSPACE_CONTRACTS_CACHE_PRESERVING_ACTIONS = /* @__PURE__ */ new Set([
   "activity",
   "aggregate",
@@ -5780,6 +5860,7 @@ var WORKSPACE_CONTRACTS_CACHE_PRESERVING_ACTIONS = /* @__PURE__ */ new Set([
   "deps",
   "files-discover",
   "get",
+  "graph",
   "health",
   "history",
   "list",
@@ -5916,7 +5997,7 @@ function shouldInvalidateWorkspaceContractsCacheAfterAction(action) {
 }
 async function runAction(args) {
   const resolved = resolveSdkActionInput(args);
-  const global = globalOptions(resolved.args);
+  const global = actionGlobalOptions(resolved.args);
   const invalidateWorkspaceContractsCache = shouldInvalidateWorkspaceContractsCacheAfterAction(resolved.action);
   const explicitCwd = readRuntimeString(resolved.args, "cwd");
   const resolutionCwd = explicitCwd ?? process.cwd();
@@ -6076,7 +6157,7 @@ function createMcpSchemaContext(ctx) {
     name: readRuntimeString(ctx.args, "name") ?? readRuntimeString(ctx.options, "name"),
     author: readRuntimeString(ctx.args, "author") ?? readRuntimeString(ctx.options, "author"),
     force: ctx.args.force === true || ctx.options.force === true,
-    aliases: aliasSource === void 0 ? void 0 : readStringArray(aliasSource)
+    aliases: aliasSource === void 0 ? void 0 : readRuntimeStringArray(aliasSource)
   };
 }
 function runMcpSchemaReadOrRemoveAction(schema2) {
@@ -6101,14 +6182,14 @@ function runMcpSchemaAddFieldAction(schema2) {
   const requiredTypesSource = ctx.args.requiredTypes ?? ctx.options.requiredTypes;
   return runSchemaAddField(name, {
     type: readRuntimeString(ctx.args, "fieldType") ?? readRuntimeString(ctx.options, "fieldType"),
-    commands: commandsSource === void 0 ? void 0 : readStringArray(commandsSource),
+    commands: commandsSource === void 0 ? void 0 : readRuntimeStringArray(commandsSource),
     description: readRuntimeString(ctx.args, "description") ?? readRuntimeString(ctx.options, "description"),
     cliFlag: readRuntimeString(ctx.args, "cliFlag") ?? readRuntimeString(ctx.options, "cliFlag"),
     alias: aliases,
     required: ctx.args.required === true || ctx.options.required === true,
     requiredOnCreate: ctx.args.requiredOnCreate === true || ctx.options.requiredOnCreate === true,
     allowUnset: !(ctx.args.allowUnset === false || ctx.options.allowUnset === false),
-    requiredTypes: requiredTypesSource === void 0 ? void 0 : readStringArray(requiredTypesSource),
+    requiredTypes: requiredTypesSource === void 0 ? void 0 : readRuntimeStringArray(requiredTypesSource),
     author,
     force
   }, ctx.global);
@@ -6117,7 +6198,7 @@ function runMcpSchemaAddStatusAction(schema2) {
   const { ctx, name, author, force, aliases } = schema2;
   const roleSource = ctx.args.role ?? ctx.options.role;
   return runSchemaAddStatus(name, {
-    role: roleSource === void 0 ? void 0 : readStringArray(roleSource),
+    role: roleSource === void 0 ? void 0 : readRuntimeStringArray(roleSource),
     alias: aliases,
     description: readRuntimeString(ctx.args, "description") ?? readRuntimeString(ctx.options, "description"),
     order: parseRuntimeInteger(ctx.args.order ?? ctx.options.order, "schema add-status order"),
@@ -6267,6 +6348,10 @@ async function runMcpCloseTaskAction(ctx) {
     release: releaseResult
   };
 }
+function runMcpGraphAction(ctx) {
+  const merged = { ...ctx.args, ...ctx.options };
+  return runGraph(readRequiredString(merged, "subcommand"), readRuntimeString(merged, "id") ?? ctx.id, readRuntimeString(merged, "target"), graphOptionsFromFlat(merged), ctx.global);
+}
 var SDK_ACTION_HANDLERS = {
   init: (ctx) => runInit(readRuntimeString(ctx.args, "prefix"), ctx.global, ctx.options),
   context: (ctx) => runContext(ctx.options, ctx.global),
@@ -6307,6 +6392,7 @@ var SDK_ACTION_HANDLERS = {
   upgrade: (ctx) => runUpgrade(readMcpTarget(ctx), ctx.options, ctx.global),
   delete: (ctx) => runDelete(requireMcpItemId(ctx), ctx.options, ctx.global),
   deps: (ctx) => runDeps(requireMcpItemId(ctx), ctx.options, ctx.global),
+  graph: runMcpGraphAction,
   "files-discover": (ctx) => runFilesDiscover(requireMcpItemId(ctx), ctx.options, ctx.global),
   history: (ctx) => runHistory(requireMcpItemId(ctx), ctx.options, ctx.global),
   "history-redact": (ctx) => runHistoryRedact(requireMcpItemId(ctx), ctx.options, ctx.global),
@@ -6338,7 +6424,7 @@ async function dispatchAction(action, args, global, activeExtensions) {
 var actionRunnerTestHooks = {
   closeManyOptionsFromFlat,
   extensionOptionsFromArgs,
-  globalOptions,
+  globalOptions: actionGlobalOptions,
   mutationListOptions,
   normalizeActionName,
   normalizeCommandPath,
@@ -6348,7 +6434,7 @@ var actionRunnerTestHooks = {
   readRequiredString,
   readScalarString: readRuntimeScalarString,
   readScalarStringAllowBlank: readRuntimeScalarStringAllowBlank,
-  readStringArray,
+  readStringArray: readRuntimeStringArray,
   updateManyOptionsFromFlat,
   withAddNoteOption,
   withFilesDiscoveryOptions,
@@ -6423,6 +6509,7 @@ export {
   filesDiscover,
   docs,
   deps,
+  graph,
   append,
   init,
   config,
@@ -6487,6 +6574,6 @@ export {
   readRequiredString,
   runAction
 };
-//# sourceMappingURL=chunk-LPYWLWDS.js.map
+//# sourceMappingURL=chunk-SIPOACV5.js.map
 
-//# debugId=f89dda3b-e8c4-53c1-8d8b-b884a198a28d
+//# debugId=038cbba4-9d1e-5b41-b501-d40eec7260cd