@unbrained/pm-cli 2026.7.8 → 2026.7.10

package/dist/cli-bundle/chunks/{chunk-ML27MHNM.js → chunk-2RW5DWHQ.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]="2b6edeca-2494-5d6a-ab67-da2b14e0b208")}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]="faf08df7-0a77-51eb-85eb-04c9847040a3")}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-MFLLULHU.js";
+} from "./chunk-TB2CZJAQ.js";
 
 // dist/sdk/cli-contracts/commander-types.js
 var LIST_COMMANDER_STRING_OPTION_CONTRACTS = [
@@ -248,7 +248,7 @@ var CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS = [
     target: "blockedBy",
     keys: ["blockedBy", "blocked_by"],
     option: "--blocked-by <value>",
-    description: "Blocked-by item ID or reason",
+    description: "Set latest blocked-by item ID or reason; resolved item IDs append a blocked_by dependency edge",
     aliasOptions: [{ option: "--blocked_by <value>", description: "Alias for --blocked-by" }]
   },
   {
@@ -500,7 +500,7 @@ var UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS = [
     target: "blockedBy",
     keys: ["blockedBy", "blocked_by"],
     option: "--blocked-by <value>",
-    description: "Set blocked-by item ID or reason",
+    description: "Set latest blocked-by item ID or reason; resolved item IDs append a blocked_by dependency edge",
     aliasOptions: [{ option: "--blocked_by <value>", description: "Alias for --blocked-by" }]
   },
   {
@@ -858,12 +858,17 @@ var TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS = [
   { param: "deadlineBefore", flag: "--deadline-before" },
   { param: "deadlineAfter", flag: "--deadline-after" }
 ];
-var TOOL_ITEM_WINDOW_FILTER_OPTION_CONTRACTS = [
+var TOOL_ITEM_DATE_FILTER_OPTION_CONTRACTS = [
   { param: "updatedAfter", flag: "--updated-after" },
   { param: "updatedBefore", flag: "--updated-before" },
   { param: "createdAfter", flag: "--created-after" },
   { param: "createdBefore", flag: "--created-before" }
 ];
+var TOOL_LIST_WINDOW_FILTER_OPTION_CONTRACTS = [
+  { param: "today", flag: "--today", booleanish: true },
+  { param: "recent", flag: "--recent", booleanish: true },
+  ...TOOL_ITEM_DATE_FILTER_OPTION_CONTRACTS
+];
 var TOOL_ITEM_RELATION_FILTER_OPTION_CONTRACTS = [
   { param: "assignee", flag: "--assignee" },
   { param: "assigneeFilter", flag: "--assignee-filter" },
@@ -912,7 +917,7 @@ var TOOL_CONTENT_PRESENCE_OPTION_CONTRACTS = [
 ];
 var TOOL_LIST_FILTER_OPTION_CONTRACTS = [
   ...cloneOptionContracts(TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS),
-  ...cloneOptionContracts(TOOL_ITEM_WINDOW_FILTER_OPTION_CONTRACTS),
+  ...cloneOptionContracts(TOOL_LIST_WINDOW_FILTER_OPTION_CONTRACTS),
   { param: "ids", flag: "--ids" },
   ...cloneOptionContracts(TOOL_ITEM_RELATION_FILTER_OPTION_CONTRACTS),
   { param: "filterAcMissing", flag: "--filter-ac-missing" },
@@ -947,7 +952,7 @@ var TOOL_SEARCH_FILTER_OPTION_CONTRACTS = [
   { param: "count", flag: "--count", booleanish: true },
   { param: "semanticWeight", flag: "--semantic-weight" },
   ...cloneOptionContracts(TOOL_ITEM_BASE_FILTER_OPTION_CONTRACTS),
-  ...cloneOptionContracts(TOOL_ITEM_WINDOW_FILTER_OPTION_CONTRACTS),
+  ...cloneOptionContracts(TOOL_ITEM_DATE_FILTER_OPTION_CONTRACTS),
   ...cloneOptionContracts(TOOL_SEARCH_RELATION_FILTER_OPTION_CONTRACTS),
   ...cloneOptionContracts(TOOL_GOVERNANCE_MISSING_OPTION_CONTRACTS),
   ...cloneOptionContracts(TOOL_CONTENT_PRESENCE_OPTION_CONTRACTS),
@@ -1323,6 +1328,8 @@ var LIST_FILTER_FLAG_CONTRACTS = [
   { flag: "--priority" },
   { flag: "--deadline-before" },
   { flag: "--deadline-after" },
+  { flag: "--today" },
+  { flag: "--recent" },
   { flag: "--updated-after" },
   { flag: "--updated-before" },
   { flag: "--created-after" },
@@ -1609,6 +1616,7 @@ var INIT_FLAG_CONTRACTS = [
   { flag: "--author" },
   { flag: "--agent-guidance" },
   { flag: "--with-packages" },
+  { flag: "--workspace" },
   { flag: "--force" },
   { flag: "--verbose" }
 ];
@@ -2371,7 +2379,9 @@ var CONTEXT_FLAG_CONTRACTS = [
   { flag: "--fields", list: true },
   { flag: "--section" },
   { flag: "--activity-limit" },
-  { flag: "--stale-threshold" }
+  { flag: "--stale-threshold" },
+  { flag: "--explain-ranking" },
+  { flag: "--explain_ranking" }
 ];
 var GET_FLAG_CONTRACTS = [
   { flag: "--depth" },
@@ -2415,7 +2425,9 @@ var NEXT_FLAG_CONTRACTS = [
   { flag: "--blocked_limit" },
   { flag: "--ready-only" },
   { flag: "--ready_only" },
-  { flag: "--format" }
+  { flag: "--format" },
+  { flag: "--explain-ranking" },
+  { flag: "--explain_ranking" }
 ];
 var SEARCH_FLAG_CONTRACTS = [
   { flag: "--mode" },
@@ -2453,6 +2465,7 @@ var SEARCH_FLAG_CONTRACTS = [
 var CONTRACTS_FLAG_CONTRACTS = [
   { flag: "--action" },
   { flag: "--command" },
+  { flag: "--summary" },
   { flag: "--schema-only" },
   { flag: "--flags-only" },
   { flag: "--availability-only" },
@@ -2638,6 +2651,7 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   allStreams: { type: "boolean" },
   contractAction: { type: "string" },
   command: { type: "string" },
+  summary: { type: "boolean" },
   schemaOnly: { type: "boolean" },
   flagsOnly: { type: "boolean" },
   availabilityOnly: { type: "boolean" },
@@ -2746,6 +2760,8 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   tag: { type: "string" },
   deadlineBefore: { type: "string" },
   deadlineAfter: { type: "string" },
+  today: { type: "boolean" },
+  recent: { type: "boolean" },
   updatedAfter: { type: "string" },
   updatedBefore: { type: "string" },
   createdAfter: { type: "string" },
@@ -2912,7 +2928,6 @@ var PM_TOOL_PARAMETER_PROPERTIES = {
   },
   maxDepth: { anyOf: [{ type: "string" }, { type: "number" }] },
   collapse: { type: "string", enum: ["none", "repeated"] },
-  summary: { type: "boolean" },
   shell: { type: "string", enum: ["bash", "zsh", "fish"] },
   stdin: { type: "boolean" },
   file: { type: "string" },
@@ -3152,6 +3167,12 @@ var PM_TOOL_PARAMETER_METADATA = {
     description: "npm version or dist-tag used for CLI and registry package upgrades.",
     examples: ["latest", "next", "2026.5.11"]
   },
+  today: {
+    description: "When true for list actions, include only items updated since local midnight today."
+  },
+  recent: {
+    description: "When true for list actions, include only items updated in the last seven days."
+  },
   packageName: {
     description: "Override the pm CLI package name for self-upgrade automation and tests.",
     examples: ["@unbrained/pm-cli"]
@@ -3764,7 +3785,7 @@ var PM_TOOL_PARAMETER_METADATA = {
     examples: ["none", "repeated"]
   },
   summary: {
-    description: "When true for deps action, return counts only without full tree/graph payloads."
+    description: "When true, return the command's compact summary projection (deps counts, health rollup, or contracts command intents)."
   },
   threshold: {
     description: "Dedupe-audit fuzzy title similarity threshold between 0 and 1.",
@@ -3913,6 +3934,46 @@ var LIST_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
   "brief",
   "full"
 ]);
+var LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS = [
+  [
+    { property: "today", schema: { const: true } },
+    { property: "recent", schema: { const: true } }
+  ],
+  [
+    { property: "today", schema: { const: true } },
+    { property: "updatedAfter", schema: { type: "string", pattern: "\\S" } }
+  ],
+  [
+    { property: "recent", schema: { const: true } },
+    { property: "updatedAfter", schema: { type: "string", pattern: "\\S" } }
+  ]
+];
+var CONTRACTS_PROJECTION_MUTUALLY_EXCLUSIVE_GROUPS = [
+  [
+    { property: "summary", schema: { const: true } },
+    { property: "schemaOnly", schema: { const: true } }
+  ],
+  [
+    { property: "summary", schema: { const: true } },
+    { property: "flagsOnly", schema: { const: true } }
+  ],
+  [
+    { property: "summary", schema: { const: true } },
+    { property: "availabilityOnly", schema: { const: true } }
+  ],
+  [
+    { property: "schemaOnly", schema: { const: true } },
+    { property: "flagsOnly", schema: { const: true } }
+  ],
+  [
+    { property: "schemaOnly", schema: { const: true } },
+    { property: "availabilityOnly", schema: { const: true } }
+  ],
+  [
+    { property: "flagsOnly", schema: { const: true } },
+    { property: "availabilityOnly", schema: { const: true } }
+  ]
+];
 var AGGREGATE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
   ...TOOL_AGGREGATE_OPTION_CONTRACTS.map((entry) => entry.param),
   "count",
@@ -4026,14 +4087,14 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
   },
   copy: { required: ["id"], optional: ["title", "author", "message"] },
   focus: { optional: ["id", "clear"], mutuallyExclusive: [["id", "clear"]] },
-  list: { optional: LIST_CONTRACT_PARAMETER_KEYS },
-  "list-all": { optional: LIST_CONTRACT_PARAMETER_KEYS },
-  "list-draft": { optional: LIST_CONTRACT_PARAMETER_KEYS },
-  "list-open": { optional: LIST_CONTRACT_PARAMETER_KEYS },
-  "list-in-progress": { optional: LIST_CONTRACT_PARAMETER_KEYS },
-  "list-blocked": { optional: LIST_CONTRACT_PARAMETER_KEYS },
-  "list-closed": { optional: LIST_CONTRACT_PARAMETER_KEYS },
-  "list-canceled": { optional: LIST_CONTRACT_PARAMETER_KEYS },
+  list: { optional: LIST_CONTRACT_PARAMETER_KEYS, mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS },
+  "list-all": { optional: LIST_CONTRACT_PARAMETER_KEYS, mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS },
+  "list-draft": { optional: LIST_CONTRACT_PARAMETER_KEYS, mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS },
+  "list-open": { optional: LIST_CONTRACT_PARAMETER_KEYS, mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS },
+  "list-in-progress": { optional: LIST_CONTRACT_PARAMETER_KEYS, mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS },
+  "list-blocked": { optional: LIST_CONTRACT_PARAMETER_KEYS, mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS },
+  "list-closed": { optional: LIST_CONTRACT_PARAMETER_KEYS, mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS },
+  "list-canceled": { optional: LIST_CONTRACT_PARAMETER_KEYS, mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS },
   aggregate: { optional: AGGREGATE_CONTRACT_PARAMETER_KEYS },
   "dedupe-audit": { optional: DEDUPE_AUDIT_CONTRACT_PARAMETER_KEYS },
   guide: { optional: ["list", "format", "depth"] },
@@ -4377,7 +4438,10 @@ var PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     ]
   },
   gc: { optional: ["dryRun", "gcScope"] },
-  contracts: { optional: ["contractAction", "command", "schemaOnly", "flagsOnly", "availabilityOnly", "runtimeOnly", "activeOnly", "full"] },
+  contracts: {
+    optional: ["contractAction", "command", "summary", "schemaOnly", "flagsOnly", "availabilityOnly", "runtimeOnly", "activeOnly", "full"],
+    mutuallyExclusiveWhen: CONTRACTS_PROJECTION_MUTUALLY_EXCLUSIVE_GROUPS
+  },
   completion: { required: ["shell"], optional: ["eagerTags"] },
   claim: { required: ["id"], optional: LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
   release: { required: ["id"], optional: ["allowAuditRelease", ...LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS] },
@@ -4491,6 +4555,18 @@ function buildActionScopedAllOf(contract) {
       allOf.push({ not: { required: toSchemaKeyList(group) } });
     }
   }
+  if (contract.mutuallyExclusiveWhen && contract.mutuallyExclusiveWhen.length > 0) {
+    for (const group of contract.mutuallyExclusiveWhen) {
+      allOf.push({
+        not: {
+          allOf: group.map((condition) => ({
+            properties: { [condition.property]: condition.schema },
+            required: [condition.property]
+          }))
+        }
+      });
+    }
+  }
   return allOf;
 }
 function buildActionScopedToolSchema(action) {
@@ -4725,6 +4801,6 @@ export {
   PM_TOOL_PARAMETERS_SCHEMA,
   PM_PROVIDER_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-ML27MHNM.js.map
+//# sourceMappingURL=chunk-2RW5DWHQ.js.map
 
-//# debugId=2b6edeca-2494-5d6a-ab67-da2b14e0b208
+//# debugId=faf08df7-0a77-51eb-85eb-04c9847040a3