@unbrained/pm-cli 2026.6.5 → 2026.6.7

package/dist/sdk/cli-contracts.js

@@ -1,6 +1,6 @@
 
-!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]="0d3966dd-1676-5097-a2d1-112c171ec38b")}catch(e){}}();
-export { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "./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]="4792e304-62bb-5ad3-8fa9-995d55a86497")}catch(e){}}();
+export { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "./cli-contracts/commander-types.js";
 export { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, } from "./cli-contracts/commander-mutation-options.js";
 // PM_* enum/guard contracts and the bulk tool-parameter property/metadata data
 // tables live in sibling modules and are re-exported here so existing import
@@ -98,12 +98,17 @@ export const 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" },
 ];
 export const AGGREGATE_FLAG_CONTRACTS = [
     { flag: "--group-by", list: true },
     { flag: "--count" },
+    { flag: "--sum" },
+    { flag: "--avg" },
     { flag: "--include-unparented" },
     { flag: "--include_unparented" },
     { flag: "--status" },
@@ -209,6 +214,7 @@ export const HISTORY_FLAG_CONTRACTS = [
     { flag: "--compact" },
     { flag: "--full" },
     { flag: "--diff" },
+    { flag: "--field" },
     { flag: "--verify" },
 ];
 export const HISTORY_REDACT_FLAG_CONTRACTS = [
@@ -226,6 +232,13 @@ export const HISTORY_REPAIR_FLAG_CONTRACTS = [
     { flag: "--message" },
     { flag: "--force" },
 ];
+export const HISTORY_COMPACT_FLAG_CONTRACTS = [
+    { flag: "--before" },
+    { flag: "--dry-run" },
+    { flag: "--author" },
+    { flag: "--message" },
+    { flag: "--force" },
+];
 export const SCHEMA_FLAG_CONTRACTS = [
     { flag: "--description" },
     { flag: "--default-status", aliases: ["--default_status"] },
@@ -546,6 +559,9 @@ export const TEST_ALL_FLAG_CONTRACTS = [
     { flag: "--check-context" },
     { flag: "--auto-pm-context" },
 ];
+export const TELEMETRY_FLAG_CONTRACTS = [
+    { flag: "--limit" },
+];
 export const TEST_RUNS_FLAG_CONTRACTS = [
     { flag: "--status" },
     { flag: "--limit" },
@@ -558,6 +574,9 @@ export const GC_FLAG_CONTRACTS = [
     { flag: "--dry-run" },
     { flag: "--scope" },
 ];
+export const STATS_FLAG_CONTRACTS = [
+    { flag: "--storage" },
+];
 export const HEALTH_FLAG_CONTRACTS = [
     { flag: "--strict-directories" },
     { flag: "--strict-exit" },
@@ -687,6 +706,11 @@ export const CREATE_FLAG_CONTRACTS = [
     { flag: "--clear-events" },
     { flag: "--clear-type-options" },
 ];
+export const COPY_FLAG_CONTRACTS = [
+    { flag: "--title" },
+    { flag: "--author" },
+    { flag: "--message" },
+];
 export const UPDATE_FLAG_CONTRACTS = [
     { short: "-t", flag: "--title" },
     { short: "-d", flag: "--description" },
@@ -981,6 +1005,9 @@ export const GET_FLAG_CONTRACTS = [
     { flag: "--depth" },
     { flag: "--full" },
     { flag: "--fields", list: true },
+    { flag: "--tree" },
+    { flag: "--tree-depth" },
+    { flag: "--tree_depth" },
 ];
 export const GUIDE_FLAG_CONTRACTS = [
     { flag: "--list" },
@@ -997,6 +1024,7 @@ export const SEARCH_FLAG_CONTRACTS = [
     { flag: "--mode" },
     { flag: "--semantic" },
     { flag: "--hybrid" },
+    { flag: "--semantic-weight" },
     { flag: "--include-linked" },
     { flag: "--title-exact" },
     { flag: "--phrase-exact" },
@@ -1052,7 +1080,6 @@ const LIST_COMMAND_NAME_CONTRACTS = new Set([
     "list-canceled",
 ]);
 const NO_SURFACE_COMMAND_NAME_CONTRACTS = new Set([
-    "stats",
     "reindex",
     "help",
 ]);
@@ -1133,6 +1160,8 @@ export 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":
@@ -1149,6 +1178,8 @@ export 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":
@@ -1185,12 +1216,16 @@ export 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":
@@ -1401,6 +1436,7 @@ const 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 },
@@ -1414,7 +1450,7 @@ const 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"]],
@@ -1430,6 +1466,10 @@ const 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.
@@ -1504,7 +1544,7 @@ const 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 },
@@ -1602,6 +1642,9 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "autoPmContext",
         ],
     },
+    telemetry: {
+        optional: ["subcommand", "limit"],
+    },
     "test-runs-list": {
         optional: ["status", "limit"],
     },
@@ -1620,7 +1663,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
         required: ["runId"],
         optional: ["author"],
     },
-    stats: {},
+    stats: { optional: ["storage"] },
     health: {
         optional: [
             "strictDirectories",
@@ -1665,7 +1708,7 @@ const 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] },
 };
 export const PM_TOOL_ACTION_PARAMETER_CONTRACTS = Object.freeze(Object.fromEntries(PM_TOOL_ACTIONS.map((action) => [action, PM_TOOL_ACTION_SCHEMA_CONTRACTS[action]])));
 function fallbackToolParameterDescription(key) {
@@ -1774,11 +1817,32 @@ function createLazyContractSchema(build) {
         },
     });
 }
+/**
+ * Canonical version of the action-scoped strict MCP tool-parameters schema
+ * (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the
+ * MCP server, the `pm contracts` command, SDK consumers, and the contract tests
+ * all bind to one constant instead of re-typing the `"4.0.2"` literal (pm-r9sz).
+ * Bump the patch/minor for additive, backward-compatible schema changes; bump
+ * the MAJOR for breaking changes — the major also drives the `$id`
+ * `tool-parameters-v{major}` slug, so the two never drift.
+ */
+export const PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.0.2";
+/**
+ * Major component of {@link PM_TOOL_PARAMETERS_SCHEMA_VERSION}, used to build the
+ * schema `$id` slug so a breaking version bump renames the document in lockstep.
+ */
+export const PM_TOOL_PARAMETERS_SCHEMA_MAJOR = PM_TOOL_PARAMETERS_SCHEMA_VERSION.split(".")[0];
+/**
+ * Version of the provider-compatible flat tool-parameters schema
+ * (`PM_PROVIDER_TOOL_PARAMETERS_SCHEMA`). Tracked separately from the strict
+ * schema because the flat projection evolves independently.
+ */
+export const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION = "1.0.0";
 export const 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)),
 }));
@@ -1819,7 +1883,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"],
@@ -1828,4 +1892,4 @@ function buildProviderCompatibleToolSchema() {
 }
 export const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = createLazyContractSchema(buildProviderCompatibleToolSchema);
 //# sourceMappingURL=cli-contracts.js.map
-//# debugId=0d3966dd-1676-5097-a2d1-112c171ec38b
+//# debugId=4792e304-62bb-5ad3-8fa9-995d55a86497