@unbrained/pm-cli 2026.6.5 → 2026.6.7

package/dist/cli-bundle/chunks/{chunk-GNHVV4SY.js → chunk-CLD3XNCH.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]="daf3d4ea-d464-5fd8-974b-73fb045959e4")}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]="9ca64db1-8561-5713-ad30-d62fd6bd239c")}catch(e){}}();
 import {
   KNOWN_EXTENSION_CAPABILITIES,
   KNOWN_EXTENSION_POLICY_MODES,
@@ -11,7 +11,7 @@ import {
   PLAN_MODE_VALUES,
   PLAN_STEP_LINK_KIND_VALUES,
   PLAN_STEP_STATUS_VALUES
-} from "./chunk-4LTBNUYT.js";
+} from "./chunk-X4IZKYHP.js";
 
 // dist/sdk/cli-contracts/commander-types.js
 var LIST_COMMANDER_STRING_OPTION_CONTRACTS = [
@@ -25,6 +25,7 @@ var LIST_COMMANDER_STRING_OPTION_CONTRACTS = [
   { target: "updatedBefore", keys: ["updatedBefore"] },
   { target: "createdAfter", keys: ["createdAfter"] },
   { target: "createdBefore", keys: ["createdBefore"] },
+  { target: "ids", keys: ["ids"] },
   { target: "assignee", keys: ["assignee"] },
   { target: "assigneeFilter", keys: ["assigneeFilter", "assignee_filter"] },
   { target: "parent", keys: ["parent"] },
@@ -34,10 +35,12 @@ var LIST_COMMANDER_STRING_OPTION_CONTRACTS = [
   { target: "offset", keys: ["offset"] },
   { target: "fields", keys: ["fields"] },
   { target: "sort", keys: ["sort"] },
-  { target: "order", keys: ["order"] }
+  { target: "order", keys: ["order"] },
+  { target: "treeDepth", keys: ["treeDepth", "tree_depth"] }
 ];
 var SEARCH_COMMANDER_STRING_OPTION_CONTRACTS = [
   { target: "mode", keys: ["mode"] },
+  { target: "semanticWeight", keys: ["semanticWeight", "semantic_weight"] },
   { target: "status", keys: ["status"] },
   { target: "type", keys: ["type"] },
   { target: "tag", keys: ["tag"] },
@@ -101,6 +104,14 @@ function readFirstStringFromCommanderOptions(options, contract) {
   }
   return void 0;
 }
+function readFirstValueFromCommanderOptions(options, contract) {
+  for (const key of contract.keys) {
+    if (Object.hasOwn(options, key)) {
+      return options[key];
+    }
+  }
+  return void 0;
+}
 function readStringArrayFromCommanderOptions(options, contract) {
   for (const key of contract.keys) {
     const candidate = options[key];
@@ -651,6 +662,7 @@ var PM_CORE_COMMAND_NAMES = [
   "install",
   "upgrade",
   "create",
+  "copy",
   "list",
   "list-all",
   "list-draft",
@@ -667,6 +679,7 @@ var PM_CORE_COMMAND_NAMES = [
   "history",
   "history-redact",
   "history-repair",
+  "history-compact",
   "schema",
   "activity",
   "restore",
@@ -685,6 +698,7 @@ var PM_CORE_COMMAND_NAMES = [
   "plan",
   "test",
   "test-all",
+  "telemetry",
   "stats",
   "health",
   "validate",
@@ -729,6 +743,7 @@ var PM_TOOL_ACTIONS = [
   "install",
   "upgrade",
   "create",
+  "copy",
   "list",
   "list-all",
   "list-draft",
@@ -745,6 +760,7 @@ var PM_TOOL_ACTIONS = [
   "history",
   "history-redact",
   "history-repair",
+  "history-compact",
   "schema",
   "activity",
   "restore",
@@ -763,6 +779,7 @@ var PM_TOOL_ACTIONS = [
   "deps",
   "test",
   "test-all",
+  "telemetry",
   "stats",
   "health",
   "validate",
@@ -797,10 +814,14 @@ var TOOL_LIST_FILTER_OPTION_CONTRACTS = [
   { param: "offset", flag: "--offset" },
   { param: "fields", flag: "--fields" },
   { param: "sort", flag: "--sort" },
-  { param: "order", flag: "--order" }
+  { param: "order", flag: "--order" },
+  { param: "tree", flag: "--tree" },
+  { param: "treeDepth", flag: "--tree-depth" }
 ];
 var TOOL_AGGREGATE_OPTION_CONTRACTS = [
   { param: "groupBy", flag: "--group-by" },
+  { param: "sum", flag: "--sum" },
+  { param: "avg", flag: "--avg" },
   { param: "status", flag: "--status" },
   { param: "type", flag: "--type" },
   { param: "tag", flag: "--tag" },
@@ -830,6 +851,7 @@ var TOOL_DEDUPE_AUDIT_OPTION_CONTRACTS = [
   { param: "release", flag: "--release" }
 ];
 var TOOL_SEARCH_FILTER_OPTION_CONTRACTS = [
+  { param: "semanticWeight", flag: "--semantic-weight" },
   { param: "status", flag: "--status" },
   { param: "type", flag: "--type" },
   { param: "tag", flag: "--tag" },
@@ -1145,6 +1167,7 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
     type: "string",
     enum: ["keyword", "semantic", "hybrid", "title_exact", "title_fuzzy", "parent_scope"]
   },
+  semanticWeight: { anyOf: [{ type: "string" }, { type: "number" }] },
   op: { type: "string" },
   compact: { type: "boolean" },
   brief: { type: "boolean" },
@@ -1152,6 +1175,7 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   view: { type: "string", enum: ["agenda", "day", "week", "month"] },
   date: { type: "string" },
   from: { type: "string" },
+  before: { type: "string" },
   to: { type: "string" },
   past: { type: "boolean" },
   fullPeriod: { type: "boolean" },
@@ -1203,6 +1227,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" } },
@@ -1250,10 +1275,14 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   force: { type: "boolean" },
   run: { type: "boolean" },
   count: { type: "boolean" },
+  sum: { type: "string" },
+  avg: { type: "string" },
+  tree: { type: "boolean" },
+  treeDepth: { anyOf: [{ type: "string" }, { type: "number" }] },
   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"] },
@@ -1508,8 +1537,7 @@ var PM_TOOL_PARAMETER_METADATA = {
     examples: ["Task", "Feature"]
   },
   subcommand: {
-    description: "Subcommand for the schema action.",
-    examples: ["list", "show", "add-type", "remove-type", "add-status", "remove-status"]
+    description: "Subcommand selector for schema and telemetry actions."
   },
   name: {
     description: "Custom item type name (schema add-type/remove-type/show) or custom status id (schema add-status/remove-status).",
@@ -1661,6 +1689,10 @@ var PM_TOOL_PARAMETER_METADATA = {
     description: "Mode selector for search/reindex (keyword|semantic|hybrid) and dedupe-audit (title_exact|title_fuzzy|parent_scope).",
     examples: ["keyword", "hybrid", "title_exact"]
   },
+  semanticWeight: {
+    description: "Per-query hybrid semantic weight override in [0,1] for search action; invalid values fall back to settings.",
+    examples: [0.2, "0.7"]
+  },
   op: {
     description: "History operation filter for activity output.",
     examples: ["create", "update", "close", "update_audit"]
@@ -1714,13 +1746,20 @@ 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.",
     examples: [0, 50, "100"]
   },
+  before: {
+    description: "For history-compact, compact entries strictly before this boundary (version number or ISO timestamp).",
+    examples: ["5", "2026-06-01T00:00:00.000Z"]
+  },
   limitItems: {
     description: "Maximum number of filtered items to include in comments-audit output (alias: --limit).",
     examples: [10, "25"]
@@ -1911,6 +1950,21 @@ var PM_TOOL_PARAMETER_METADATA = {
   count: {
     description: "Enable grouped count output for aggregate action."
   },
+  sum: {
+    description: "Numeric field to sum per aggregate group (count and null_count are still returned).",
+    examples: ["estimated_minutes", "priority"]
+  },
+  avg: {
+    description: "Numeric field to average per aggregate group (count and null_count are still returned).",
+    examples: ["estimated_minutes", "priority"]
+  },
+  tree: {
+    description: "When true for list/get actions, render recursive parent/child tree ordering."
+  },
+  treeDepth: {
+    description: "Maximum recursion depth for tree output (0 keeps root rows only).",
+    examples: [0, 1, "2"]
+  },
   includeUnparented: {
     description: "Include unparented rows when aggregate grouping includes parent."
   },
@@ -2065,12 +2119,17 @@ var LIST_FILTER_FLAG_CONTRACTS = [
   { flag: "--fields", list: true },
   { flag: "--sort" },
   { flag: "--order" },
+  { flag: "--tree" },
+  { flag: "--tree-depth" },
+  { flag: "--tree_depth" },
   { flag: "--include-body" },
   { flag: "--stream" }
 ];
 var AGGREGATE_FLAG_CONTRACTS = [
   { flag: "--group-by", list: true },
   { flag: "--count" },
+  { flag: "--sum" },
+  { flag: "--avg" },
   { flag: "--include-unparented" },
   { flag: "--include_unparented" },
   { flag: "--status" },
@@ -2176,6 +2235,7 @@ var HISTORY_FLAG_CONTRACTS = [
   { flag: "--compact" },
   { flag: "--full" },
   { flag: "--diff" },
+  { flag: "--field" },
   { flag: "--verify" }
 ];
 var HISTORY_REDACT_FLAG_CONTRACTS = [
@@ -2193,6 +2253,13 @@ var HISTORY_REPAIR_FLAG_CONTRACTS = [
   { flag: "--message" },
   { flag: "--force" }
 ];
+var HISTORY_COMPACT_FLAG_CONTRACTS = [
+  { flag: "--before" },
+  { flag: "--dry-run" },
+  { flag: "--author" },
+  { flag: "--message" },
+  { flag: "--force" }
+];
 var SCHEMA_FLAG_CONTRACTS = [
   { flag: "--description" },
   { flag: "--default-status", aliases: ["--default_status"] },
@@ -2510,6 +2577,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" },
@@ -2522,6 +2592,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" },
@@ -2651,6 +2724,11 @@ var CREATE_FLAG_CONTRACTS = [
   { flag: "--clear-events" },
   { flag: "--clear-type-options" }
 ];
+var COPY_FLAG_CONTRACTS = [
+  { flag: "--title" },
+  { flag: "--author" },
+  { flag: "--message" }
+];
 var UPDATE_FLAG_CONTRACTS = [
   { short: "-t", flag: "--title" },
   { short: "-d", flag: "--description" },
@@ -2944,7 +3022,10 @@ var CONTEXT_FLAG_CONTRACTS = [
 var GET_FLAG_CONTRACTS = [
   { flag: "--depth" },
   { flag: "--full" },
-  { flag: "--fields", list: true }
+  { flag: "--fields", list: true },
+  { flag: "--tree" },
+  { flag: "--tree-depth" },
+  { flag: "--tree_depth" }
 ];
 var GUIDE_FLAG_CONTRACTS = [
   { flag: "--list" },
@@ -2961,6 +3042,7 @@ var SEARCH_FLAG_CONTRACTS = [
   { flag: "--mode" },
   { flag: "--semantic" },
   { flag: "--hybrid" },
+  { flag: "--semantic-weight" },
   { flag: "--include-linked" },
   { flag: "--title-exact" },
   { flag: "--phrase-exact" },
@@ -3016,7 +3098,6 @@ var LIST_COMMAND_NAME_CONTRACTS = /* @__PURE__ */ new Set([
   "list-canceled"
 ]);
 var NO_SURFACE_COMMAND_NAME_CONTRACTS = /* @__PURE__ */ new Set([
-  "stats",
   "reindex",
   "help"
 ]);
@@ -3095,6 +3176,8 @@ function resolveSubcommandFlagContractsForCommand(commandName) {
       return withSubcommandGlobalFlags(UPGRADE_FLAG_CONTRACTS);
     case "create":
       return withSubcommandGlobalFlags(CREATE_FLAG_CONTRACTS);
+    case "copy":
+      return withSubcommandGlobalFlags(COPY_FLAG_CONTRACTS);
     case "aggregate":
       return withSubcommandGlobalFlags(AGGREGATE_FLAG_CONTRACTS);
     case "calendar":
@@ -3111,6 +3194,8 @@ function resolveSubcommandFlagContractsForCommand(commandName) {
       return withSubcommandGlobalFlags(HISTORY_REDACT_FLAG_CONTRACTS);
     case "history-repair":
       return withSubcommandGlobalFlags(HISTORY_REPAIR_FLAG_CONTRACTS);
+    case "history-compact":
+      return withSubcommandGlobalFlags(HISTORY_COMPACT_FLAG_CONTRACTS);
     case "schema":
       return withSubcommandGlobalFlags(SCHEMA_FLAG_CONTRACTS);
     case "plan":
@@ -3147,12 +3232,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":
@@ -3350,6 +3439,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     required: ["title", "description", "type", "status", "priority", "message"],
     optional: CREATE_CONTRACT_PARAMETER_KEYS
   },
+  copy: { required: ["id"], optional: ["title", "author", "message"] },
   list: { optional: LIST_CONTRACT_PARAMETER_KEYS },
   "list-all": { optional: LIST_CONTRACT_PARAMETER_KEYS },
   "list-draft": { optional: LIST_CONTRACT_PARAMETER_KEYS },
@@ -3363,7 +3453,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   guide: { optional: ["format", "depth"] },
   context: { optional: CONTEXT_CONTRACT_PARAMETER_KEYS },
   ctx: { optional: CONTEXT_CONTRACT_PARAMETER_KEYS },
-  get: { required: ["id"], optional: ["depth", "full", "fields"] },
+  get: { required: ["id"], optional: ["depth", "full", "fields", "tree", "treeDepth"] },
   search: {
     optional: SEARCH_CONTRACT_PARAMETER_KEYS,
     anyOfRequired: [["query"], ["keywords"]]
@@ -3379,6 +3469,10 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     required: ["id"],
     optional: ["dryRun", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS]
   },
+  "history-compact": {
+    required: ["id"],
+    optional: ["before", "dryRun", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS]
+  },
   schema: {
     required: ["subcommand"],
     // No --message: schema mutations write config files, not item history.
@@ -3453,7 +3547,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   update: { required: ["id"], optional: UPDATE_CONTRACT_PARAMETER_KEYS },
   "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: { required: ["id"], optional: ["text", "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 },
@@ -3551,6 +3645,9 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
       "autoPmContext"
     ]
   },
+  telemetry: {
+    optional: ["subcommand", "limit"]
+  },
   "test-runs-list": {
     optional: ["status", "limit"]
   },
@@ -3569,7 +3666,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     required: ["runId"],
     optional: ["author"]
   },
-  stats: {},
+  stats: { optional: ["storage"] },
   health: {
     optional: [
       "strictDirectories",
@@ -3614,7 +3711,7 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   release: { required: ["id"], optional: ["allowAuditRelease", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS] },
   "start-task": { required: ["id"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
   "pause-task": { required: ["id"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
-  "close-task": { required: ["id", "text"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS }
+  "close-task": { required: ["id"], optional: ["text", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS] }
 };
 var PM_TOOL_ACTION_PARAMETER_CONTRACTS = Object.freeze(Object.fromEntries(PM_TOOL_ACTIONS.map((action) => [action, PM_TOOL_ACTION_SCHEMA_CONTRACTS[action]])));
 function fallbackToolParameterDescription(key) {
@@ -3713,11 +3810,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.2",
+  "x-schema-version": PM_TOOL_PARAMETERS_SCHEMA_VERSION,
   type: "object",
   oneOf: PM_TOOL_ACTIONS.map((action) => buildActionScopedToolSchema(action))
 }));
@@ -3758,7 +3858,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"],
@@ -3774,6 +3874,7 @@ export {
   CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,
   ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,
   readFirstStringFromCommanderOptions,
+  readFirstValueFromCommanderOptions,
   readStringArrayFromCommanderOptions,
   CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,
   CREATE_COMMANDER_STRING_OPTION_CONTRACTS,
@@ -3803,6 +3904,7 @@ export {
   HISTORY_FLAG_CONTRACTS,
   HISTORY_REDACT_FLAG_CONTRACTS,
   HISTORY_REPAIR_FLAG_CONTRACTS,
+  HISTORY_COMPACT_FLAG_CONTRACTS,
   SCHEMA_FLAG_CONTRACTS,
   PLAN_FLAG_CONTRACTS,
   INIT_FLAG_CONTRACTS,
@@ -3835,8 +3937,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,
@@ -3855,6 +3959,6 @@ export {
   resolveSubcommandFlagContractsForCommand,
   PM_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-GNHVV4SY.js.map
+//# sourceMappingURL=chunk-CLD3XNCH.js.map
 
-//# debugId=daf3d4ea-d464-5fd8-974b-73fb045959e4
+//# debugId=9ca64db1-8561-5713-ad30-d62fd6bd239c