@unbrained/pm-cli 2026.5.31 → 2026.6.6

package/dist/cli-bundle/chunks/{chunk-GN7IJPCD.js → chunk-PROOHX4K.js}

@@ -9,13 +9,13 @@ import {
   PLAN_MODE_VALUES,
   PLAN_STEP_LINK_KIND_VALUES,
   PLAN_STEP_STATUS_VALUES
-} from "./chunk-LSXGH6NE.js";
+} from "./chunk-U5SXYXSY.js";
 
 // dist/sdk/cli-contracts/commander-types.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] = "5b919cb4-d842-52b2-92f8-d07fb6637a19");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "e7a15f1b-ed03-5de1-9743-961b8c82c57f");
   } catch (e2) {
   }
 })();
@@ -26,6 +26,10 @@ var LIST_COMMANDER_STRING_OPTION_CONTRACTS = [
   { target: "priority", keys: ["priority"] },
   { target: "deadlineBefore", keys: ["deadlineBefore"] },
   { target: "deadlineAfter", keys: ["deadlineAfter"] },
+  { target: "updatedAfter", keys: ["updatedAfter"] },
+  { target: "updatedBefore", keys: ["updatedBefore"] },
+  { target: "createdAfter", keys: ["createdAfter"] },
+  { target: "createdBefore", keys: ["createdBefore"] },
   { target: "assignee", keys: ["assignee"] },
   { target: "assigneeFilter", keys: ["assigneeFilter", "assignee_filter"] },
   { target: "parent", keys: ["parent"] },
@@ -39,6 +43,7 @@ var LIST_COMMANDER_STRING_OPTION_CONTRACTS = [
 ];
 var SEARCH_COMMANDER_STRING_OPTION_CONTRACTS = [
   { target: "mode", keys: ["mode"] },
+  { target: "status", keys: ["status"] },
   { target: "type", keys: ["type"] },
   { target: "tag", keys: ["tag"] },
   { target: "priority", keys: ["priority"] },
@@ -115,7 +120,7 @@ function readStringArrayFromCommanderOptions(options, contract) {
 !(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] = "8f0d6f98-ad14-5cd7-aea8-a43737f51032");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "826f5099-2a30-5563-8904-489eb023a732");
   } catch (e2) {
   }
 })();
@@ -308,6 +313,13 @@ var CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS = [
     repeatable: true,
     aliasOptions: [{ option: "--type_option <value>", description: "Alias for --type-option" }]
   },
+  {
+    target: "field",
+    keys: ["field"],
+    option: "--field <name=value>",
+    description: "Set a field declared by an active extension registerItemFields registration (repeatable)",
+    repeatable: true
+  },
   {
     target: "unset",
     keys: ["unset"],
@@ -617,6 +629,13 @@ var UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS = [
     repeatable: true,
     aliasOptions: [{ option: "--type_option <value>", description: "Alias for --type-option" }]
   },
+  {
+    target: "field",
+    keys: ["field"],
+    option: "--field <name=value>",
+    description: "Set a field declared by an active extension registerItemFields registration (repeatable)",
+    repeatable: true
+  },
   {
     target: "unset",
     keys: ["unset"],
@@ -632,7 +651,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] = "e93f5c1f-0703-5c95-b7b8-84264cf9ed1f");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "d9e809b9-499e-5f9a-8dba-3eb82a74e2cc");
   } catch (e2) {
   }
 })();
@@ -673,6 +692,7 @@ var PM_CORE_COMMAND_NAMES = [
   "update",
   "update-many",
   "close",
+  "close-many",
   "delete",
   "append",
   "comments",
@@ -684,6 +704,7 @@ var PM_CORE_COMMAND_NAMES = [
   "plan",
   "test",
   "test-all",
+  "telemetry",
   "stats",
   "health",
   "validate",
@@ -750,6 +771,7 @@ var PM_TOOL_ACTIONS = [
   "update",
   "update-many",
   "close",
+  "close-many",
   "delete",
   "append",
   "comments",
@@ -761,6 +783,7 @@ var PM_TOOL_ACTIONS = [
   "deps",
   "test",
   "test-all",
+  "telemetry",
   "stats",
   "health",
   "validate",
@@ -777,7 +800,7 @@ var PM_TOOL_ACTIONS = [
 !(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] = "f77c9493-e7b2-5549-a205-1b67dc69700e");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "eddcd201-0f60-58a6-be51-11224e317119");
   } catch (e2) {
   }
 })();
@@ -788,6 +811,11 @@ var TOOL_LIST_FILTER_OPTION_CONTRACTS = [
   { param: "priority", flag: "--priority" },
   { param: "deadlineBefore", flag: "--deadline-before" },
   { param: "deadlineAfter", flag: "--deadline-after" },
+  { param: "updatedAfter", flag: "--updated-after" },
+  { param: "updatedBefore", flag: "--updated-before" },
+  { param: "createdAfter", flag: "--created-after" },
+  { param: "createdBefore", flag: "--created-before" },
+  { param: "ids", flag: "--ids" },
   { param: "assignee", flag: "--assignee" },
   { param: "assigneeFilter", flag: "--assignee-filter" },
   { param: "parent", flag: "--parent" },
@@ -830,6 +858,7 @@ var TOOL_DEDUPE_AUDIT_OPTION_CONTRACTS = [
   { param: "release", flag: "--release" }
 ];
 var TOOL_SEARCH_FILTER_OPTION_CONTRACTS = [
+  { param: "status", flag: "--status" },
   { param: "type", flag: "--type" },
   { param: "tag", flag: "--tag" },
   { param: "priority", flag: "--priority" },
@@ -890,6 +919,7 @@ var TOOL_CREATE_OPTION_CONTRACTS = [
   { param: "reminder", flag: "--reminder", repeatable: true },
   { param: "event", flag: "--event", repeatable: true },
   { param: "typeOption", flag: "--type-option", repeatable: true },
+  { param: "field", flag: "--field", repeatable: true },
   { param: "dep", flag: "--dep", repeatable: true },
   { param: "comment", flag: "--comment", repeatable: true },
   { param: "note", flag: "--note", repeatable: true },
@@ -939,6 +969,7 @@ var TOOL_UPDATE_OPTION_CONTRACTS = [
   { param: "reminder", flag: "--reminder", repeatable: true },
   { param: "event", flag: "--event", repeatable: true },
   { param: "typeOption", flag: "--type-option", repeatable: true },
+  { param: "field", flag: "--field", repeatable: true },
   { param: "unset", flag: "--unset", repeatable: true },
   { param: "clearDeps", flag: "--clear-deps" },
   { param: "clearComments", flag: "--clear-comments" },
@@ -954,6 +985,26 @@ var TOOL_UPDATE_OPTION_CONTRACTS = [
   { param: "allowAuditDepUpdate", flag: "--allow-audit-dep-update" }
 ];
 var TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS = [
+  { param: "filterStatus", flag: "--filter-status" },
+  { param: "filterType", flag: "--filter-type" },
+  { param: "filterTag", flag: "--filter-tag" },
+  { param: "filterPriority", flag: "--filter-priority" },
+  { param: "filterDeadlineBefore", flag: "--filter-deadline-before" },
+  { param: "filterDeadlineAfter", flag: "--filter-deadline-after" },
+  { param: "filterUpdatedAfter", flag: "--filter-updated-after" },
+  { param: "filterUpdatedBefore", flag: "--filter-updated-before" },
+  { param: "filterCreatedAfter", flag: "--filter-created-after" },
+  { param: "filterCreatedBefore", flag: "--filter-created-before" },
+  { param: "filterAssignee", flag: "--filter-assignee" },
+  { param: "filterAssigneeFilter", flag: "--filter-assignee-filter" },
+  { param: "filterParent", flag: "--filter-parent" },
+  { param: "filterSprint", flag: "--filter-sprint" },
+  { param: "filterRelease", flag: "--filter-release" },
+  { param: "ids", flag: "--ids" },
+  { param: "limit", flag: "--limit" },
+  { param: "offset", flag: "--offset" }
+];
+var TOOL_NORMALIZE_FILTER_OPTION_CONTRACTS = [
   { param: "filterStatus", flag: "--filter-status" },
   { param: "filterType", flag: "--filter-type" },
   { param: "filterTag", flag: "--filter-tag" },
@@ -968,7 +1019,26 @@ var TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS = [
   { param: "limit", flag: "--limit" },
   { param: "offset", flag: "--offset" }
 ];
-var TOOL_NORMALIZE_FILTER_OPTION_CONTRACTS = [...TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS];
+var TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS = [
+  { param: "filterStatus", flag: "--filter-status" },
+  { param: "filterType", flag: "--filter-type" },
+  { param: "filterTag", flag: "--filter-tag" },
+  { param: "filterPriority", flag: "--filter-priority" },
+  { param: "filterDeadlineBefore", flag: "--filter-deadline-before" },
+  { param: "filterDeadlineAfter", flag: "--filter-deadline-after" },
+  { param: "filterUpdatedAfter", flag: "--filter-updated-after" },
+  { param: "filterUpdatedBefore", flag: "--filter-updated-before" },
+  { param: "filterCreatedAfter", flag: "--filter-created-after" },
+  { param: "filterCreatedBefore", flag: "--filter-created-before" },
+  { param: "filterAssignee", flag: "--filter-assignee" },
+  { param: "filterAssigneeFilter", flag: "--filter-assignee-filter" },
+  { param: "filterParent", flag: "--filter-parent" },
+  { param: "filterSprint", flag: "--filter-sprint" },
+  { param: "filterRelease", flag: "--filter-release" },
+  { param: "ids", flag: "--ids" },
+  { param: "limit", flag: "--limit" },
+  { param: "offset", flag: "--offset" }
+];
 var TOOL_ACTIVITY_OPTION_CONTRACTS = [
   { param: "id", flag: "--id" },
   { param: "op", flag: "--op" },
@@ -1002,7 +1072,7 @@ var TOOL_CONTEXT_OPTION_CONTRACTS = [
 !(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] = "09eef83c-817b-5d26-8f58-016e2c7c39ad");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "a89d0b2a-cf33-59eb-bc80-b06b935b63e2");
   } catch (e2) {
   }
 })();
@@ -1025,7 +1095,9 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   sort: { type: "string", enum: ["priority", "deadline", "updated_at", "created_at", "title", "parent"] },
   prefix: { type: "string" },
   preset: { type: "string", enum: ["minimal", "default", "strict", "custom"] },
+  typePreset: { type: "string", enum: ["agile", "ops", "research"] },
   defaults: { type: "boolean" },
+  verbose: { type: "boolean" },
   agentGuidance: { type: "string", enum: ["ask", "add", "skip", "status"] },
   withPackages: { type: "boolean" },
   scope: { type: "string", enum: ["project", "global"] },
@@ -1052,12 +1124,17 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   filterPriority: { anyOf: [{ type: "string" }, { type: "number" }] },
   filterDeadlineBefore: { type: "string" },
   filterDeadlineAfter: { type: "string" },
+  filterUpdatedAfter: { type: "string" },
+  filterUpdatedBefore: { type: "string" },
+  filterCreatedAfter: { type: "string" },
+  filterCreatedBefore: { type: "string" },
   filterAssignee: { type: "string" },
   filterAssigneeFilter: { type: "string", enum: ["assigned", "unassigned"] },
   filterParent: { type: "string" },
   filterSprint: { type: "string" },
   filterRelease: { type: "string" },
   closeReason: { type: "string" },
+  reason: { type: "string" },
   priority: { anyOf: [{ type: "string" }, { type: "number" }] },
   tags: { type: "string" },
   addTags: { type: "array", items: { type: "string" } },
@@ -1126,6 +1203,11 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   tag: { type: "string" },
   deadlineBefore: { type: "string" },
   deadlineAfter: { type: "string" },
+  updatedAfter: { type: "string" },
+  updatedBefore: { type: "string" },
+  createdAfter: { type: "string" },
+  createdBefore: { type: "string" },
+  ids: { type: "string" },
   limit: { anyOf: [{ type: "string" }, { type: "number" }] },
   limitItems: { anyOf: [{ type: "string" }, { type: "number" }] },
   fullHistory: { type: "boolean" },
@@ -1156,6 +1238,7 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   checkContext: { type: "boolean" },
   autoPmContext: { type: "boolean" },
   diff: { type: "boolean" },
+  storage: { type: "boolean" },
   verify: { type: "boolean" },
   literal: { type: "array", items: { type: "string" } },
   regex: { type: "array", items: { type: "string" } },
@@ -1184,6 +1267,7 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   verboseFileLists: { type: "boolean" },
   strictExit: { type: "boolean" },
   failOnWarn: { type: "boolean" },
+  fixHints: { type: "boolean" },
   checkHistoryDrift: { type: "boolean" },
   checkCommandReferences: { type: "boolean" },
   allowAuditNote: { type: "boolean" },
@@ -1205,7 +1289,7 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   includeUnparented: { type: "boolean" },
   gcScope: {
     type: "array",
-    items: { type: "string", enum: ["index", "embeddings", "runtime"] }
+    items: { type: "string", enum: ["index", "embeddings", "runtime", "locks"] }
   },
   maxDepth: { anyOf: [{ type: "string" }, { type: "number" }] },
   collapse: { type: "string", enum: ["none", "repeated"] },
@@ -1219,6 +1303,7 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   name: { type: "string" },
   defaultStatus: { type: "string" },
   alias: { type: "array", items: { type: "string" } },
+  role: { type: "array", items: { type: "string" } },
   text: { type: "string" },
   add: { type: "array", items: { type: "string" } },
   addGlob: { type: "array", items: { type: "string" } },
@@ -1243,6 +1328,7 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   reminder: { type: "array", items: { type: "string" } },
   event: { type: "array", items: { type: "string" } },
   typeOption: { type: "array", items: { type: "string" } },
+  field: { type: "array", items: { type: "string" } },
   unset: { type: "array", items: { type: "string" } },
   clearDeps: { type: "boolean" },
   clearComments: { type: "boolean" },
@@ -1458,28 +1544,38 @@ var PM_TOOL_PARAMETER_METADATA = {
     examples: ["Task", "Feature"]
   },
   subcommand: {
-    description: "Subcommand for the schema action.",
-    examples: ["add-type"]
+    description: "Subcommand selector for schema and telemetry actions."
   },
   name: {
-    description: "Custom item type name to register (for schema add-type).",
-    examples: ["Spike"]
+    description: "Custom item type name (schema add-type/remove-type/show) or custom status id (schema add-status/remove-status).",
+    examples: ["Spike", "review"]
   },
   defaultStatus: {
     description: "Default status hint recorded for a custom item type.",
     examples: ["open"]
   },
   alias: {
-    description: "Aliases for the custom item type (repeatable).",
+    description: "Aliases for the custom item type or status (repeatable).",
     examples: [["spike", "research"]]
   },
+  role: {
+    description: "Lifecycle roles for a custom status (schema add-status): draft, active, blocked, terminal, terminal_done, terminal_canceled, default_open, default_close, default_cancel.",
+    examples: [["active"], ["terminal", "terminal_done"]]
+  },
   preset: {
     description: "Governance preset for initialization flows.",
     examples: ["minimal", "default", "strict"]
   },
+  typePreset: {
+    description: "Domain item-type preset registered during initialization.",
+    examples: ["agile", "ops", "research"]
+  },
   defaults: {
     description: "Use non-interactive setup defaults during initialization."
   },
+  verbose: {
+    description: "Include the full resolved settings tree in init output."
+  },
   agentGuidance: {
     description: "Control AGENTS.md/CLAUDE.md guidance behavior during init: ask, add, skip, or status.",
     examples: ["ask", "add", "skip", "status"]
@@ -1653,8 +1749,11 @@ var PM_TOOL_PARAMETER_METADATA = {
     description: "Preview command effects without mutating storage artifacts."
   },
   gcScope: {
-    description: "Repeatable gc scope selector values (index, embeddings, runtime).",
-    examples: [["index", "embeddings"], ["runtime"]]
+    description: "Repeatable gc scope selector values (index, embeddings, runtime, locks).",
+    examples: [["index", "embeddings"], ["runtime"], ["locks"]]
+  },
+  storage: {
+    description: "For stats action: include aggregate history-stream storage metrics (total streams/lines/bytes, largest + deepest streams, oldest/newest entries) for compaction and storage planning."
   },
   offset: {
     description: "Number of matching rows to skip before limit is applied.",
@@ -1756,6 +1855,9 @@ var PM_TOOL_PARAMETER_METADATA = {
   failOnWarn: {
     description: "Alias for strictExit in health/validate/extension-doctor action payloads."
   },
+  fixHints: {
+    description: "For validate action, add a machine-executable fix_hints[] of pm commands to each failing check's details."
+  },
   checkHistoryDrift: {
     description: "Run item/history hash drift checks."
   },
@@ -1917,7 +2019,7 @@ var PM_TOOL_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] = "b98193ee-1196-5e27-b732-d15db107a7e4");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "ed7e453d-9d75-5c91-8de4-990f9ddf155d");
   } catch (e2) {
   }
 })();
@@ -1989,6 +2091,11 @@ var LIST_FILTER_FLAG_CONTRACTS = [
   { flag: "--priority" },
   { flag: "--deadline-before" },
   { flag: "--deadline-after" },
+  { flag: "--updated-after" },
+  { flag: "--updated-before" },
+  { flag: "--created-after" },
+  { flag: "--created-before" },
+  { flag: "--ids", list: true },
   { flag: "--assignee" },
   { flag: "--assignee-filter" },
   { flag: "--assignee_filter" },
@@ -2114,6 +2221,7 @@ var HISTORY_FLAG_CONTRACTS = [
   { flag: "--compact" },
   { flag: "--full" },
   { flag: "--diff" },
+  { flag: "--field" },
   { flag: "--verify" }
 ];
 var HISTORY_REDACT_FLAG_CONTRACTS = [
@@ -2136,6 +2244,11 @@ var SCHEMA_FLAG_CONTRACTS = [
   { flag: "--default-status", aliases: ["--default_status"] },
   { flag: "--folder" },
   { flag: "--alias" },
+  // --role is a repeatable Commander collect flag (NOT a comma-list contract),
+  // mirroring --alias; list:false keeps the bootstrap coalescer from corrupting
+  // values.
+  { flag: "--role" },
+  { flag: "--order" },
   { flag: "--author" },
   { flag: "--force" }
 ];
@@ -2150,7 +2263,7 @@ var PLAN_FLAG_CONTRACTS = [
   { flag: "--harness" },
   { flag: "--mode" },
   { flag: "--resume-context", aliases: ["--resume_context"] },
-  { flag: "--tags", list: true },
+  { flag: "--tags", aliases: ["--tag"], list: true },
   { flag: "--priority" },
   { flag: "--body" },
   { flag: "--claim" },
@@ -2190,6 +2303,7 @@ var PLAN_FLAG_CONTRACTS = [
 ];
 var INIT_FLAG_CONTRACTS = [
   { flag: "--preset" },
+  { flag: "--type-preset" },
   { flag: "--defaults", short: "-y", aliases: ["--yes"] },
   { flag: "--author" },
   { flag: "--agent-guidance" },
@@ -2242,6 +2356,51 @@ var EXTENSION_FLAG_CONTRACTS = [
   { flag: "--strict-exit" },
   { flag: "--fail-on-warn" }
 ];
+var EXTENSION_INIT_FLAG_CONTRACTS = [
+  { flag: "--project" },
+  { flag: "--local" },
+  { flag: "--global" }
+];
+var EXTENSION_INSTALL_FLAG_CONTRACTS = [
+  { flag: "--project" },
+  { flag: "--local" },
+  { flag: "--global" },
+  { flag: "--gh" },
+  { flag: "--github" },
+  { flag: "--ref" }
+];
+var EXTENSION_UNINSTALL_FLAG_CONTRACTS = EXTENSION_INIT_FLAG_CONTRACTS;
+var EXTENSION_EXPLORE_FLAG_CONTRACTS = EXTENSION_INIT_FLAG_CONTRACTS;
+var EXTENSION_ADOPT_ALL_FLAG_CONTRACTS = EXTENSION_INIT_FLAG_CONTRACTS;
+var EXTENSION_ACTIVATE_FLAG_CONTRACTS = EXTENSION_INIT_FLAG_CONTRACTS;
+var EXTENSION_DEACTIVATE_FLAG_CONTRACTS = EXTENSION_INIT_FLAG_CONTRACTS;
+var EXTENSION_MANAGE_FLAG_CONTRACTS = [
+  ...EXTENSION_INIT_FLAG_CONTRACTS,
+  { flag: "--runtime-probe" },
+  { flag: "--fix-managed-state" }
+];
+var EXTENSION_RELOAD_FLAG_CONTRACTS = [
+  ...EXTENSION_INIT_FLAG_CONTRACTS,
+  { flag: "--watch" }
+];
+var EXTENSION_DOCTOR_FLAG_CONTRACTS = [
+  ...EXTENSION_INIT_FLAG_CONTRACTS,
+  { flag: "--detail" },
+  { flag: "--trace" },
+  { flag: "--fix-managed-state" },
+  { flag: "--strict-exit" },
+  { flag: "--fail-on-warn" }
+];
+var EXTENSION_CATALOG_FLAG_CONTRACTS = [
+  ...EXTENSION_INIT_FLAG_CONTRACTS,
+  { flag: "--fields", list: true }
+];
+var EXTENSION_ADOPT_FLAG_CONTRACTS = [
+  ...EXTENSION_INIT_FLAG_CONTRACTS,
+  { flag: "--gh" },
+  { flag: "--github" },
+  { flag: "--ref" }
+];
 var INSTALL_FLAG_CONTRACTS = [
   { flag: "--project" },
   { flag: "--local" },
@@ -2280,6 +2439,38 @@ var CLOSE_FLAG_CONTRACTS = [
   { flag: "--actual-result", aliases: ["--actual_result", "--actual"] },
   { flag: "--force" }
 ];
+var CLOSE_MANY_FLAG_CONTRACTS = [
+  { flag: "--filter-status", list: true },
+  { flag: "--filter-type" },
+  { flag: "--filter-tag" },
+  { flag: "--filter-priority" },
+  { flag: "--filter-deadline-before" },
+  { flag: "--filter-deadline-after" },
+  { flag: "--filter-updated-after" },
+  { flag: "--filter-updated-before" },
+  { flag: "--filter-created-after" },
+  { flag: "--filter-created-before" },
+  { flag: "--filter-assignee" },
+  { flag: "--filter-assignee-filter" },
+  { flag: "--filter-assignee_filter" },
+  { flag: "--filter-parent" },
+  { flag: "--filter-sprint" },
+  { flag: "--filter-release" },
+  { flag: "--ids", list: true },
+  { flag: "--limit" },
+  { flag: "--offset" },
+  { flag: "--reason" },
+  { flag: "--resolution" },
+  { flag: "--expected-result", aliases: ["--expected_result", "--expected"] },
+  { flag: "--actual-result", aliases: ["--actual_result", "--actual"] },
+  { flag: "--validate-close" },
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--force" },
+  { flag: "--dry-run" },
+  { flag: "--rollback" },
+  { flag: "--no-checkpoint" }
+];
 var APPEND_FLAG_CONTRACTS = [
   { flag: "--body", short: "-b" },
   { flag: "--author" },
@@ -2365,6 +2556,9 @@ var TEST_ALL_FLAG_CONTRACTS = [
   { flag: "--check-context" },
   { flag: "--auto-pm-context" }
 ];
+var TELEMETRY_FLAG_CONTRACTS = [
+  { flag: "--limit" }
+];
 var TEST_RUNS_FLAG_CONTRACTS = [
   { flag: "--status" },
   { flag: "--limit" },
@@ -2377,6 +2571,9 @@ var GC_FLAG_CONTRACTS = [
   { flag: "--dry-run" },
   { flag: "--scope" }
 ];
+var STATS_FLAG_CONTRACTS = [
+  { flag: "--storage" }
+];
 var HEALTH_FLAG_CONTRACTS = [
   { flag: "--strict-directories" },
   { flag: "--strict-exit" },
@@ -2407,6 +2604,7 @@ var VALIDATE_FLAG_CONTRACTS = [
   { flag: "--verbose-diagnostics" },
   { flag: "--strict-exit" },
   { flag: "--fail-on-warn" },
+  { flag: "--fix-hints" },
   { flag: "--check-history-drift" },
   { flag: "--check-command-references" }
 ];
@@ -2421,7 +2619,7 @@ var CREATE_FLAG_CONTRACTS = [
   { flag: "--schedule_preset" },
   { short: "-s", flag: "--status" },
   { short: "-p", flag: "--priority" },
-  { flag: "--tags", list: true },
+  { flag: "--tags", aliases: ["--tag"], list: true },
   // NOT list:true — these use Commander's repeatable collector. Marking them
   // list:true would make the bootstrap coalescer comma-join repeated
   // occurrences (`--add-tags '["a","b"]' --add-tags c` -> `["a","b"],c`),
@@ -2484,6 +2682,7 @@ var CREATE_FLAG_CONTRACTS = [
   { flag: "--dep" },
   { flag: "--type-option" },
   { flag: "--type_option" },
+  { flag: "--field" },
   { flag: "--reminder" },
   { flag: "--event" },
   { flag: "--comment" },
@@ -2513,7 +2712,7 @@ var UPDATE_FLAG_CONTRACTS = [
   { flag: "--close_reason" },
   { short: "-p", flag: "--priority" },
   { flag: "--type" },
-  { flag: "--tags", list: true },
+  { flag: "--tags", aliases: ["--tag"], list: true },
   // NOT list:true — Commander's repeatable collector accumulates these, so
   // bootstrap coalescing must not comma-join repeated occurrences (it would
   // corrupt JSON-array values like `--add-tags '["a","b"]' --add-tags c`).
@@ -2587,6 +2786,7 @@ var UPDATE_FLAG_CONTRACTS = [
   { flag: "--event" },
   { flag: "--type-option" },
   { flag: "--type_option" },
+  { flag: "--field" },
   { flag: "--unset" },
   { flag: "--clear-deps" },
   { flag: "--clear-comments" },
@@ -2611,12 +2811,17 @@ var UPDATE_MANY_FLAG_CONTRACTS = [
   { flag: "--filter-priority" },
   { flag: "--filter-deadline-before" },
   { flag: "--filter-deadline-after" },
+  { flag: "--filter-updated-after" },
+  { flag: "--filter-updated-before" },
+  { flag: "--filter-created-after" },
+  { flag: "--filter-created-before" },
   { flag: "--filter-assignee" },
   { flag: "--filter-assignee-filter" },
   { flag: "--filter-assignee_filter" },
   { flag: "--filter-parent" },
   { flag: "--filter-sprint" },
   { flag: "--filter-release" },
+  { flag: "--ids", list: true },
   { flag: "--limit" },
   { flag: "--offset" },
   { flag: "--dry-run" },
@@ -2627,7 +2832,7 @@ var UPDATE_MANY_FLAG_CONTRACTS = [
   { short: "-b", flag: "--body" },
   { short: "-p", flag: "--priority" },
   { flag: "--type" },
-  { flag: "--tags", list: true },
+  { flag: "--tags", aliases: ["--tag"], list: true },
   // NOT list:true — Commander's repeatable collector accumulates these, so
   // bootstrap coalescing must not comma-join repeated occurrences (it would
   // corrupt JSON-array values like `--add-tags '["a","b"]' --add-tags c`).
@@ -2815,6 +3020,7 @@ var SEARCH_FLAG_CONTRACTS = [
   { flag: "--full" },
   { flag: "--fields", list: true },
   { flag: "--limit" },
+  { flag: "--status", list: true },
   { flag: "--type" },
   { flag: "--tag" },
   { flag: "--priority" },
@@ -2862,7 +3068,6 @@ var LIST_COMMAND_NAME_CONTRACTS = /* @__PURE__ */ new Set([
   "list-canceled"
 ]);
 var NO_SURFACE_COMMAND_NAME_CONTRACTS = /* @__PURE__ */ new Set([
-  "stats",
   "reindex",
   "help"
 ]);
@@ -2895,6 +3100,37 @@ function resolveSubcommandFlagContractsForCommand(commandName) {
   if (normalized === "test-runs-worker") {
     return withSubcommandGlobalFlags(TEST_RUNS_FLAG_CONTRACTS);
   }
+  const [rootCommand, lifecycleSubcommand, ...extraParts] = normalized.split(/\s+/);
+  if ((rootCommand === "extension" || rootCommand === "package" || rootCommand === "packages") && lifecycleSubcommand && extraParts.length === 0) {
+    switch (lifecycleSubcommand) {
+      case "init":
+        return withSubcommandGlobalFlags(EXTENSION_INIT_FLAG_CONTRACTS);
+      case "install":
+        return withSubcommandGlobalFlags(EXTENSION_INSTALL_FLAG_CONTRACTS);
+      case "uninstall":
+        return withSubcommandGlobalFlags(EXTENSION_UNINSTALL_FLAG_CONTRACTS);
+      case "explore":
+        return withSubcommandGlobalFlags(EXTENSION_EXPLORE_FLAG_CONTRACTS);
+      case "manage":
+        return withSubcommandGlobalFlags(EXTENSION_MANAGE_FLAG_CONTRACTS);
+      case "reload":
+        return withSubcommandGlobalFlags(EXTENSION_RELOAD_FLAG_CONTRACTS);
+      case "doctor":
+        return withSubcommandGlobalFlags(EXTENSION_DOCTOR_FLAG_CONTRACTS);
+      case "catalog":
+        return withSubcommandGlobalFlags(EXTENSION_CATALOG_FLAG_CONTRACTS);
+      case "adopt":
+        return withSubcommandGlobalFlags(EXTENSION_ADOPT_FLAG_CONTRACTS);
+      case "adopt-all":
+        return withSubcommandGlobalFlags(EXTENSION_ADOPT_ALL_FLAG_CONTRACTS);
+      case "activate":
+        return withSubcommandGlobalFlags(EXTENSION_ACTIVATE_FLAG_CONTRACTS);
+      case "deactivate":
+        return withSubcommandGlobalFlags(EXTENSION_DEACTIVATE_FLAG_CONTRACTS);
+      default:
+        return withSubcommandGlobalFlags([]);
+    }
+  }
   switch (normalized) {
     case "init":
       return withSubcommandGlobalFlags(INIT_FLAG_CONTRACTS);
@@ -2940,6 +3176,8 @@ function resolveSubcommandFlagContractsForCommand(commandName) {
       return withSubcommandGlobalFlags(UPDATE_MANY_FLAG_CONTRACTS);
     case "close":
       return withSubcommandGlobalFlags(CLOSE_FLAG_CONTRACTS);
+    case "close-many":
+      return withSubcommandGlobalFlags(CLOSE_MANY_FLAG_CONTRACTS);
     case "delete":
       return withSubcommandGlobalFlags(DELETE_FLAG_CONTRACTS);
     case "append":
@@ -2960,12 +3198,16 @@ function resolveSubcommandFlagContractsForCommand(commandName) {
       return withSubcommandGlobalFlags(TEST_FLAG_CONTRACTS);
     case "test-all":
       return withSubcommandGlobalFlags(TEST_ALL_FLAG_CONTRACTS);
+    case "telemetry":
+      return withSubcommandGlobalFlags(TELEMETRY_FLAG_CONTRACTS);
     case "health":
       return withSubcommandGlobalFlags(HEALTH_FLAG_CONTRACTS);
     case "validate":
       return withSubcommandGlobalFlags(VALIDATE_FLAG_CONTRACTS);
     case "gc":
       return withSubcommandGlobalFlags(GC_FLAG_CONTRACTS);
+    case "stats":
+      return withSubcommandGlobalFlags(STATS_FLAG_CONTRACTS);
     case "contracts":
       return withSubcommandGlobalFlags(CONTRACTS_FLAG_CONTRACTS);
     case "claim":
@@ -3012,6 +3254,20 @@ var NORMALIZE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
   "allowAuditUpdate",
   "force"
 ]);
+var CLOSE_MANY_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
+  ...TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
+  "reason",
+  "resolution",
+  "expectedResult",
+  "actualResult",
+  "validateClose",
+  "dryRun",
+  "rollback",
+  "noCheckpoint",
+  "author",
+  "message",
+  "force"
+]);
 var CONTEXT_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
   ...TOOL_CONTEXT_OPTION_CONTRACTS.map((entry) => entry.param),
   "past",
@@ -3049,7 +3305,7 @@ var SEARCH_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
 ]);
 var AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS = ["author", "message", "force"];
 var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
-  init: { optional: ["prefix", "preset", "defaults", "author", "agentGuidance", "withPackages"] },
+  init: { optional: ["prefix", "preset", "typePreset", "defaults", "author", "agentGuidance", "withPackages", "verbose"] },
   config: {
     required: ["scope", "configAction"],
     optional: ["key", "value", "criterion", "clearCriteria", "format", "policy"]
@@ -3064,7 +3320,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   "extension-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
   "extension-reload": { optional: ["scope", "watch"] },
   "extension-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
-  "extension-catalog": { optional: ["scope"] },
+  "extension-catalog": { optional: ["scope", "fields"] },
   "extension-adopt": { required: ["target"], optional: ["scope", "github", "ref"] },
   "extension-adopt-all": { optional: ["scope"] },
   "extension-activate": { required: ["target"], optional: ["scope"] },
@@ -3106,7 +3362,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   "package-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
   "package-reload": { optional: ["scope", "watch"] },
   "package-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
-  "package-catalog": { optional: ["scope"] },
+  "package-catalog": { optional: ["scope", "fields"] },
   "package-adopt": { required: ["target"], optional: ["scope", "github", "ref"] },
   "package-adopt-all": { optional: ["scope"] },
   "package-activate": { required: ["target"], optional: ["scope"] },
@@ -3179,9 +3435,17 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     optional: ["dryRun", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS]
   },
   schema: {
-    required: ["subcommand", "name"],
-    // No --message: schema add-type writes a config file, not item history.
-    optional: ["description", "defaultStatus", "folder", "alias", "author", "force"]
+    required: ["subcommand"],
+    // No --message: schema mutations write config files, not item history.
+    optional: ["name", "description", "defaultStatus", "folder", "alias", "role", "order", "author", "force"],
+    conditionalRequired: [
+      { property: "subcommand", value: "show", required: ["name"] },
+      { property: "subcommand", value: "add-type", required: ["name"] },
+      { property: "subcommand", value: "remove-type", required: ["name"] },
+      // add-status/remove-status pass the status id as `name`.
+      { property: "subcommand", value: "add-status", required: ["name"] },
+      { property: "subcommand", value: "remove-status", required: ["name"] }
+    ]
   },
   plan: {
     required: ["subcommand"],
@@ -3245,6 +3509,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   "update-many": { optional: UPDATE_MANY_CONTRACT_PARAMETER_KEYS },
   normalize: { optional: NORMALIZE_CONTRACT_PARAMETER_KEYS },
   close: { required: ["id", "text"], optional: ["validateClose", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS] },
+  "close-many": { optional: CLOSE_MANY_CONTRACT_PARAMETER_KEYS },
   delete: { required: ["id"], optional: ["dryRun", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS] },
   append: { required: ["id", "body"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
   comments: {
@@ -3341,6 +3606,9 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
       "autoPmContext"
     ]
   },
+  telemetry: {
+    optional: ["subcommand", "limit"]
+  },
   "test-runs-list": {
     optional: ["status", "limit"]
   },
@@ -3359,7 +3627,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     required: ["runId"],
     optional: ["author"]
   },
-  stats: {},
+  stats: { optional: ["storage"] },
   health: {
     optional: [
       "strictDirectories",
@@ -3392,6 +3660,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
       "verboseDiagnostics",
       "strictExit",
       "failOnWarn",
+      "fixHints",
       "checkHistoryDrift",
       "checkCommandReferences"
     ]
@@ -3471,6 +3740,19 @@ function buildActionScopedToolSchema(action) {
       required: [...requiredFields]
     }));
   }
+  if (contract.conditionalRequired && contract.conditionalRequired.length > 0) {
+    schema.allOf = contract.conditionalRequired.map((entry) => ({
+      if: {
+        properties: {
+          [entry.property]: { const: entry.value }
+        },
+        required: [entry.property]
+      },
+      then: {
+        required: entry.required
+      }
+    }));
+  }
   return schema;
 }
 function createLazyContractSchema(build) {
@@ -3489,11 +3771,14 @@ function createLazyContractSchema(build) {
     }
   });
 }
+var PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.0.2";
+var PM_TOOL_PARAMETERS_SCHEMA_MAJOR = PM_TOOL_PARAMETERS_SCHEMA_VERSION.split(".")[0];
+var PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION = "1.0.0";
 var PM_TOOL_PARAMETERS_SCHEMA = createLazyContractSchema(() => ({
   $schema: "https://json-schema.org/draft/2020-12/schema",
-  $id: "https://schema.unbrained.dev/pm-cli/tool-parameters-v4.schema.json",
+  $id: `https://schema.unbrained.dev/pm-cli/tool-parameters-v${PM_TOOL_PARAMETERS_SCHEMA_MAJOR}.schema.json`,
   title: "pm-cli tool parameters (action-scoped strict schema)",
-  "x-schema-version": "4.0.1",
+  "x-schema-version": PM_TOOL_PARAMETERS_SCHEMA_VERSION,
   type: "object",
   oneOf: PM_TOOL_ACTIONS.map((action) => buildActionScopedToolSchema(action))
 }));
@@ -3534,7 +3819,7 @@ function buildProviderCompatibleToolSchema() {
   }
   return {
     title: "pm-cli tool parameters (provider-compatible flat schema)",
-    "x-schema-version": "1.0.0",
+    "x-schema-version": PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION,
     type: "object",
     additionalProperties: false,
     required: ["action"],
@@ -3584,10 +3869,23 @@ export {
   INIT_FLAG_CONTRACTS,
   CONFIG_FLAG_CONTRACTS,
   EXTENSION_FLAG_CONTRACTS,
+  EXTENSION_INIT_FLAG_CONTRACTS,
+  EXTENSION_INSTALL_FLAG_CONTRACTS,
+  EXTENSION_UNINSTALL_FLAG_CONTRACTS,
+  EXTENSION_EXPLORE_FLAG_CONTRACTS,
+  EXTENSION_ADOPT_ALL_FLAG_CONTRACTS,
+  EXTENSION_ACTIVATE_FLAG_CONTRACTS,
+  EXTENSION_DEACTIVATE_FLAG_CONTRACTS,
+  EXTENSION_MANAGE_FLAG_CONTRACTS,
+  EXTENSION_RELOAD_FLAG_CONTRACTS,
+  EXTENSION_DOCTOR_FLAG_CONTRACTS,
+  EXTENSION_CATALOG_FLAG_CONTRACTS,
+  EXTENSION_ADOPT_FLAG_CONTRACTS,
   INSTALL_FLAG_CONTRACTS,
   UPGRADE_FLAG_CONTRACTS,
   REINDEX_FLAG_CONTRACTS,
   CLOSE_FLAG_CONTRACTS,
+  CLOSE_MANY_FLAG_CONTRACTS,
   APPEND_FLAG_CONTRACTS,
   CLAIM_FLAG_CONTRACTS,
   RESTORE_FLAG_CONTRACTS,
@@ -3598,8 +3896,10 @@ export {
   CLOSE_TASK_FLAG_CONTRACTS,
   TEST_FLAG_CONTRACTS,
   TEST_ALL_FLAG_CONTRACTS,
+  TELEMETRY_FLAG_CONTRACTS,
   TEST_RUNS_FLAG_CONTRACTS,
   GC_FLAG_CONTRACTS,
+  STATS_FLAG_CONTRACTS,
   HEALTH_FLAG_CONTRACTS,
   VALIDATE_FLAG_CONTRACTS,
   CREATE_FLAG_CONTRACTS,
@@ -3618,4 +3918,4 @@ export {
   resolveSubcommandFlagContractsForCommand,
   PM_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-GN7IJPCD.js.map
+//# sourceMappingURL=chunk-PROOHX4K.js.map