@unbrained/pm-cli 2026.7.8 → 2026.7.10

package/dist/cli-bundle/chunks/{chunk-6ZKDMEVT.js → chunk-ECXJ7OHI.js}

@@ -8,13 +8,13 @@ import {
   deleteItem,
   readSettings,
   toItemRecord
-} from "./chunk-NTOOEVJ4.js";
+} from "./chunk-Y5Q4FEE4.js";
 import {
   EXIT_CODE,
   getSettingsPath,
   pathExists,
   resolvePmRoot
-} from "./chunk-MFLLULHU.js";
+} from "./chunk-TB2CZJAQ.js";
 
 // dist/cli/commands/delete.js
 import path from "node:path";
@@ -47,6 +47,6 @@ async function runDelete(id, options, global) {
 export {
   runDelete
 };
-//# sourceMappingURL=chunk-6ZKDMEVT.js.map
+//# sourceMappingURL=chunk-ECXJ7OHI.js.map
 
 //# debugId=89f470ce-8607-5fa5-8d82-74fd0d3bf325

package/dist/cli-bundle/chunks/{chunk-LG4N6YOK.js → chunk-ESXG6VFX.js}

@@ -3,16 +3,16 @@
 import {
   parseAnnotationTextInput,
   runAnnotationCommand
-} from "./chunk-INOWVPUD.js";
+} from "./chunk-J3ELHLOJ.js";
 import {
   createStdinTokenResolver
-} from "./chunk-3SHDAKMF.js";
+} from "./chunk-GPPWUJMR.js";
 import {
   PmCliError
-} from "./chunk-NTOOEVJ4.js";
+} from "./chunk-Y5Q4FEE4.js";
 import {
   EXIT_CODE
-} from "./chunk-MFLLULHU.js";
+} from "./chunk-TB2CZJAQ.js";
 
 // dist/cli/commands/comments.js
 import { readFile } from "node:fs/promises";
@@ -116,6 +116,6 @@ async function runComments(id, options, global) {
 export {
   runComments
 };
-//# sourceMappingURL=chunk-LG4N6YOK.js.map
+//# sourceMappingURL=chunk-ESXG6VFX.js.map
 
 //# debugId=4c35a0a0-a49f-507f-8d3e-4a06d8e54066

package/dist/cli-bundle/chunks/{chunk-TR2C6V5T.js → chunk-EXG6XTJC.js}

@@ -9,7 +9,7 @@ import {
   PLAN_MODE_VALUES,
   PLAN_STEP_LINK_KIND_VALUES,
   PLAN_STEP_STATUS_VALUES
-} from "./chunk-2BVD4ZD2.js";
+} from "./chunk-J3FDNQWM.js";
 
 // dist/sdk/cli-contracts/commander-types.js
 !(function() {
@@ -156,7 +156,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] = "767461eb-c0bf-5d67-83c1-50f5cb1dcfc1");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "f56649d3-9020-5f36-a5ba-6ff70734bb3c");
   } catch (e2) {
   }
 })();
@@ -260,7 +260,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" }]
   },
   {
@@ -512,7 +512,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" }]
   },
   {
@@ -869,7 +869,7 @@ function isPmExtensionPolicySurfaceContract(value) {
 !(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] = "e6388be4-3b86-52cb-8bd3-9fafaed43195");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "138ce721-134d-57fb-8924-85e4bbe9ed5a");
   } catch (e2) {
   }
 })();
@@ -884,12 +884,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" },
@@ -938,7 +943,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" },
@@ -973,7 +978,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),
@@ -1235,7 +1240,7 @@ function normalizeUniqueStringList(values) {
 !(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] = "d66f360a-2ee4-519e-9da9-b4e755f147ea");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "01d4c0fb-231a-52d1-be32-5af86bddec24");
   } catch (e2) {
   }
 })();
@@ -1363,6 +1368,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" },
@@ -1649,6 +1656,7 @@ var INIT_FLAG_CONTRACTS = [
   { flag: "--author" },
   { flag: "--agent-guidance" },
   { flag: "--with-packages" },
+  { flag: "--workspace" },
   { flag: "--force" },
   { flag: "--verbose" }
 ];
@@ -2411,7 +2419,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" },
@@ -2455,7 +2465,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" },
@@ -2493,6 +2505,7 @@ var SEARCH_FLAG_CONTRACTS = [
 var CONTRACTS_FLAG_CONTRACTS = [
   { flag: "--action" },
   { flag: "--command" },
+  { flag: "--summary" },
   { flag: "--schema-only" },
   { flag: "--flags-only" },
   { flag: "--availability-only" },
@@ -2649,7 +2662,7 @@ function toCompletionFlagString(flagContracts, includeGlobal = true) {
 !(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] = "7ab28986-c01e-5d4a-8d4f-ff587cc86d26");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "8dcc22f9-9c0b-5270-85de-65e94eb0fdea");
   } catch (e2) {
   }
 })();
@@ -2685,6 +2698,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" },
@@ -2793,6 +2807,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" },
@@ -2959,7 +2975,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" },
@@ -3199,6 +3214,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"]
@@ -3811,7 +3832,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.",
@@ -3883,7 +3904,7 @@ var PM_TOOL_ACTION_SCOPED_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] = "5c3e7ffe-4b6a-5348-a40d-217591182b02");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "9e5e0763-b8ec-5aed-8b8d-9acf8c2cb056");
   } catch (e2) {
   }
 })();
@@ -3967,6 +3988,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",
@@ -4080,14 +4141,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"] },
@@ -4431,7 +4492,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] },
@@ -4545,6 +4609,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) {
@@ -4788,4 +4864,4 @@ export {
   PM_TOOL_PARAMETERS_SCHEMA,
   PM_PROVIDER_TOOL_PARAMETERS_SCHEMA
 };
-//# sourceMappingURL=chunk-TR2C6V5T.js.map
+//# sourceMappingURL=chunk-EXG6XTJC.js.map