@unbrained/pm-cli 2026.5.11 → 2026.5.14

package/dist/sdk/cli-contracts/commander-types.js

@@ -0,0 +1,92 @@
+export const LIST_COMMANDER_STRING_OPTION_CONTRACTS = [
+    { target: "status", keys: ["status"] },
+    { target: "type", keys: ["type"] },
+    { target: "tag", keys: ["tag"] },
+    { target: "priority", keys: ["priority"] },
+    { target: "deadlineBefore", keys: ["deadlineBefore"] },
+    { target: "deadlineAfter", keys: ["deadlineAfter"] },
+    { target: "assignee", keys: ["assignee"] },
+    { target: "assigneeFilter", keys: ["assigneeFilter", "assignee_filter"] },
+    { target: "parent", keys: ["parent"] },
+    { target: "sprint", keys: ["sprint"] },
+    { target: "release", keys: ["release"] },
+    { target: "limit", keys: ["limit"] },
+    { target: "offset", keys: ["offset"] },
+    { target: "fields", keys: ["fields"] },
+    { target: "sort", keys: ["sort"] },
+    { target: "order", keys: ["order"] },
+];
+export const SEARCH_COMMANDER_STRING_OPTION_CONTRACTS = [
+    { target: "mode", keys: ["mode"] },
+    { target: "type", keys: ["type"] },
+    { target: "tag", keys: ["tag"] },
+    { target: "priority", keys: ["priority"] },
+    { target: "deadlineBefore", keys: ["deadlineBefore"] },
+    { target: "deadlineAfter", keys: ["deadlineAfter"] },
+    { target: "fields", keys: ["fields"] },
+    { target: "limit", keys: ["limit"] },
+];
+export const CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS = [
+    { target: "view", keys: ["view"] },
+    { target: "date", keys: ["date"] },
+    { target: "from", keys: ["from"] },
+    { target: "to", keys: ["to"] },
+    { target: "limit", keys: ["limit"] },
+    { target: "type", keys: ["type"] },
+    { target: "tag", keys: ["tag"] },
+    { target: "priority", keys: ["priority"] },
+    { target: "status", keys: ["status"] },
+    { target: "assignee", keys: ["assignee"] },
+    { target: "assigneeFilter", keys: ["assigneeFilter", "assignee_filter"] },
+    { target: "sprint", keys: ["sprint"] },
+    { target: "release", keys: ["release"] },
+    { target: "include", keys: ["include"] },
+    { target: "recurrenceLookaheadDays", keys: ["recurrenceLookaheadDays", "recurrence_lookahead_days"] },
+    { target: "recurrenceLookbackDays", keys: ["recurrenceLookbackDays", "recurrence_lookback_days"] },
+    { target: "occurrenceLimit", keys: ["occurrenceLimit", "occurrence_limit"] },
+    { target: "format", keys: ["format"] },
+];
+export const CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS = [
+    { target: "date", keys: ["date"] },
+    { target: "from", keys: ["from"] },
+    { target: "to", keys: ["to"] },
+    { target: "type", keys: ["type"] },
+    { target: "tag", keys: ["tag"] },
+    { target: "priority", keys: ["priority"] },
+    { target: "assignee", keys: ["assignee"] },
+    { target: "assigneeFilter", keys: ["assigneeFilter", "assignee_filter"] },
+    { target: "sprint", keys: ["sprint"] },
+    { target: "release", keys: ["release"] },
+    { target: "limit", keys: ["limit"] },
+    { target: "format", keys: ["format"] },
+    { target: "depth", keys: ["depth"] },
+    { target: "activityLimit", keys: ["activityLimit", "activity_limit"] },
+    { target: "staleThreshold", keys: ["staleThreshold", "stale_threshold"] },
+];
+export const ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS = [
+    { target: "id", keys: ["id"] },
+    { target: "op", keys: ["op"] },
+    { target: "author", keys: ["author"] },
+    { target: "from", keys: ["from"] },
+    { target: "to", keys: ["to"] },
+    { target: "limit", keys: ["limit"] },
+];
+export function readFirstStringFromCommanderOptions(options, contract) {
+    for (const key of contract.keys) {
+        const candidate = options[key];
+        if (typeof candidate === "string") {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+export function readStringArrayFromCommanderOptions(options, contract) {
+    for (const key of contract.keys) {
+        const candidate = options[key];
+        if (Array.isArray(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=commander-types.js.map

package/dist/sdk/cli-contracts/commander-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander-types.js","sourceRoot":"/","sources":["sdk/cli-contracts/commander-types.ts"],"names":[],"mappings":"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","sourcesContent":["export interface CommanderOptionAliasContract {\n  target: string;\n  keys: readonly string[];\n}\n\nexport interface CommanderOptionRegistrationContract extends CommanderOptionAliasContract {\n  option: string;\n  description: string;\n  required?: boolean;\n  repeatable?: boolean;\n  aliasOptions?: Array<{\n    option: string;\n    description: string;\n  }>;\n}\n\nexport const LIST_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[] = [\n  { target: \"status\", keys: [\"status\"] },\n  { target: \"type\", keys: [\"type\"] },\n  { target: \"tag\", keys: [\"tag\"] },\n  { target: \"priority\", keys: [\"priority\"] },\n  { target: \"deadlineBefore\", keys: [\"deadlineBefore\"] },\n  { target: \"deadlineAfter\", keys: [\"deadlineAfter\"] },\n  { target: \"assignee\", keys: [\"assignee\"] },\n  { target: \"assigneeFilter\", keys: [\"assigneeFilter\", \"assignee_filter\"] },\n  { target: \"parent\", keys: [\"parent\"] },\n  { target: \"sprint\", keys: [\"sprint\"] },\n  { target: \"release\", keys: [\"release\"] },\n  { target: \"limit\", keys: [\"limit\"] },\n  { target: \"offset\", keys: [\"offset\"] },\n  { target: \"fields\", keys: [\"fields\"] },\n  { target: \"sort\", keys: [\"sort\"] },\n  { target: \"order\", keys: [\"order\"] },\n];\n\nexport const SEARCH_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[] = [\n  { target: \"mode\", keys: [\"mode\"] },\n  { target: \"type\", keys: [\"type\"] },\n  { target: \"tag\", keys: [\"tag\"] },\n  { target: \"priority\", keys: [\"priority\"] },\n  { target: \"deadlineBefore\", keys: [\"deadlineBefore\"] },\n  { target: \"deadlineAfter\", keys: [\"deadlineAfter\"] },\n  { target: \"fields\", keys: [\"fields\"] },\n  { target: \"limit\", keys: [\"limit\"] },\n];\n\nexport const CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[] = [\n  { target: \"view\", keys: [\"view\"] },\n  { target: \"date\", keys: [\"date\"] },\n  { target: \"from\", keys: [\"from\"] },\n  { target: \"to\", keys: [\"to\"] },\n  { target: \"limit\", keys: [\"limit\"] },\n  { target: \"type\", keys: [\"type\"] },\n  { target: \"tag\", keys: [\"tag\"] },\n  { target: \"priority\", keys: [\"priority\"] },\n  { target: \"status\", keys: [\"status\"] },\n  { target: \"assignee\", keys: [\"assignee\"] },\n  { target: \"assigneeFilter\", keys: [\"assigneeFilter\", \"assignee_filter\"] },\n  { target: \"sprint\", keys: [\"sprint\"] },\n  { target: \"release\", keys: [\"release\"] },\n  { target: \"include\", keys: [\"include\"] },\n  { target: \"recurrenceLookaheadDays\", keys: [\"recurrenceLookaheadDays\", \"recurrence_lookahead_days\"] },\n  { target: \"recurrenceLookbackDays\", keys: [\"recurrenceLookbackDays\", \"recurrence_lookback_days\"] },\n  { target: \"occurrenceLimit\", keys: [\"occurrenceLimit\", \"occurrence_limit\"] },\n  { target: \"format\", keys: [\"format\"] },\n];\n\nexport const CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[] = [\n  { target: \"date\", keys: [\"date\"] },\n  { target: \"from\", keys: [\"from\"] },\n  { target: \"to\", keys: [\"to\"] },\n  { target: \"type\", keys: [\"type\"] },\n  { target: \"tag\", keys: [\"tag\"] },\n  { target: \"priority\", keys: [\"priority\"] },\n  { target: \"assignee\", keys: [\"assignee\"] },\n  { target: \"assigneeFilter\", keys: [\"assigneeFilter\", \"assignee_filter\"] },\n  { target: \"sprint\", keys: [\"sprint\"] },\n  { target: \"release\", keys: [\"release\"] },\n  { target: \"limit\", keys: [\"limit\"] },\n  { target: \"format\", keys: [\"format\"] },\n  { target: \"depth\", keys: [\"depth\"] },\n  { target: \"activityLimit\", keys: [\"activityLimit\", \"activity_limit\"] },\n  { target: \"staleThreshold\", keys: [\"staleThreshold\", \"stale_threshold\"] },\n];\n\nexport const ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[] = [\n  { target: \"id\", keys: [\"id\"] },\n  { target: \"op\", keys: [\"op\"] },\n  { target: \"author\", keys: [\"author\"] },\n  { target: \"from\", keys: [\"from\"] },\n  { target: \"to\", keys: [\"to\"] },\n  { target: \"limit\", keys: [\"limit\"] },\n];\n\nexport function readFirstStringFromCommanderOptions(\n  options: Record<string, unknown>,\n  contract: CommanderOptionAliasContract,\n): string | undefined {\n  for (const key of contract.keys) {\n    const candidate = options[key];\n    if (typeof candidate === \"string\") {\n      return candidate;\n    }\n  }\n  return undefined;\n}\n\nexport function readStringArrayFromCommanderOptions(\n  options: Record<string, unknown>,\n  contract: CommanderOptionAliasContract,\n): string[] | undefined {\n  for (const key of contract.keys) {\n    const candidate = options[key];\n    if (Array.isArray(candidate)) {\n      return candidate as string[];\n    }\n  }\n  return undefined;\n}\n"]}

package/dist/sdk/cli-contracts.d.ts

@@ -1,13 +1,12 @@
-export interface CommanderOptionAliasContract {
-    target: string;
-    keys: string[];
-}
+export type { CommanderOptionAliasContract, CommanderOptionRegistrationContract } from "./cli-contracts/commander-types.js";
+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";
+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";
 export interface CliFlagContract {
     flag: string;
     short?: string;
     aliases?: string[];
 }
-export interface PiOptionFlagContract {
+export interface ToolOptionFlagContract {
     param: string;
     flag: string;
     allowEmpty?: boolean;
@@ -27,27 +26,28 @@ export type PmExtensionSandboxProfileContract = (typeof PM_EXTENSION_SANDBOX_PRO
 export declare const PM_EXTENSION_POLICY_SURFACE_CONTRACTS: readonly ["commands.override", "commands.handler", "hooks.beforecommand", "hooks.aftercommand", "hooks.onwrite", "hooks.onread", "hooks.onindex", "schema.flags", "schema.itemfields", "schema.itemtypes", "schema.migrations", "parser.override", "preflight.override", "services.override", "renderers.override", "importers.importer", "importers.exporter", "search.provider", "search.vectorstore"];
 export type PmExtensionPolicySurfaceContract = (typeof PM_EXTENSION_POLICY_SURFACE_CONTRACTS)[number];
 export declare function withFlagAliasMetadata(flagContracts: CliFlagContract[]): CliFlagContract[];
-export declare const PM_CORE_COMMAND_NAMES: readonly ["init", "config", "extension", "create", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "dedupe-audit", "guide", "calendar", "cal", "context", "ctx", "get", "search", "reindex", "history", "activity", "restore", "update", "update-many", "normalize", "close", "delete", "append", "comments", "comments-audit", "notes", "learnings", "files", "docs", "deps", "test", "test-all", "test-runs", "stats", "health", "validate", "gc", "contracts", "claim", "release", "start-task", "pause-task", "close-task", "templates", "completion", "help"];
-export declare const PM_TOOL_ACTIONS: readonly ["init", "config", "extension-init", "extension-install", "extension-uninstall", "extension-explore", "extension-manage", "extension-reload", "extension-doctor", "extension-adopt", "extension-adopt-all", "extension-activate", "extension-deactivate", "extension", "create", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "dedupe-audit", "guide", "calendar", "cal", "context", "ctx", "get", "search", "reindex", "history", "activity", "restore", "update", "update-many", "normalize", "close", "delete", "append", "comments", "comments-audit", "notes", "learnings", "files", "docs", "deps", "test", "test-all", "test-runs-list", "test-runs-status", "test-runs-logs", "test-runs-stop", "test-runs-resume", "stats", "health", "validate", "gc", "contracts", "completion", "templates-save", "templates-list", "templates-show", "claim", "release", "beads-import", "todos-import", "todos-export", "start-task", "pause-task", "close-task"];
+export declare function compactFlagAliasContracts(flagContracts: CliFlagContract[]): CliFlagContract[];
+export declare const PM_CORE_COMMAND_NAMES: readonly ["init", "config", "extension", "package", "packages", "install", "upgrade", "create", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "dedupe-audit", "guide", "context", "ctx", "get", "search", "reindex", "history", "activity", "restore", "update", "update-many", "normalize", "close", "delete", "append", "comments", "comments-audit", "notes", "learnings", "files", "docs", "deps", "test", "test-all", "test-runs", "stats", "health", "validate", "gc", "contracts", "claim", "release", "start-task", "pause-task", "close-task", "completion", "help"];
+export declare const PM_TOOL_ACTIONS: readonly ["init", "config", "extension-init", "extension-install", "extension-uninstall", "extension-explore", "extension-manage", "extension-reload", "extension-doctor", "extension-catalog", "extension-adopt", "extension-adopt-all", "extension-activate", "extension-deactivate", "extension", "package-init", "package-install", "package-uninstall", "package-explore", "package-manage", "package-reload", "package-doctor", "package-catalog", "package-adopt", "package-adopt-all", "package-activate", "package-deactivate", "package", "install", "upgrade", "create", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "dedupe-audit", "guide", "context", "ctx", "get", "search", "reindex", "history", "activity", "restore", "update", "update-many", "normalize", "close", "delete", "append", "comments", "comments-audit", "notes", "learnings", "files", "docs", "deps", "test", "test-all", "test-runs-list", "test-runs-status", "test-runs-logs", "test-runs-stop", "test-runs-resume", "stats", "health", "validate", "gc", "contracts", "completion", "claim", "release", "start-task", "pause-task", "close-task"];
 export type PmToolAction = (typeof PM_TOOL_ACTIONS)[number];
 export declare function isPmToolAction(value: string): value is PmToolAction;
 export declare function isPmExtensionCapabilityContract(value: string): value is PmExtensionCapabilityContract;
 export declare function isPmExtensionServiceNameContract(value: string): value is PmExtensionServiceNameContract;
 export declare function isPmExtensionPolicyModeContract(value: string): value is PmExtensionPolicyModeContract;
 export declare function isPmExtensionPolicySurfaceContract(value: string): value is PmExtensionPolicySurfaceContract;
-export declare const PI_LIST_FILTER_OPTION_CONTRACTS: PiOptionFlagContract[];
-export declare const PI_AGGREGATE_OPTION_CONTRACTS: PiOptionFlagContract[];
-export declare const PI_DEDUPE_AUDIT_OPTION_CONTRACTS: PiOptionFlagContract[];
-export declare const PI_SEARCH_FILTER_OPTION_CONTRACTS: PiOptionFlagContract[];
-export declare const PI_SHARED_CREATE_UPDATE_OPTION_CONTRACTS: PiOptionFlagContract[];
-export declare const PI_CREATE_OPTION_CONTRACTS: PiOptionFlagContract[];
-export declare const PI_UPDATE_OPTION_CONTRACTS: PiOptionFlagContract[];
-export declare const PI_UPDATE_MANY_FILTER_OPTION_CONTRACTS: PiOptionFlagContract[];
-export declare const PI_NORMALIZE_FILTER_OPTION_CONTRACTS: PiOptionFlagContract[];
-export declare const PI_CALENDAR_OPTION_CONTRACTS: PiOptionFlagContract[];
-export declare const PI_ACTIVITY_OPTION_CONTRACTS: PiOptionFlagContract[];
-export declare const PI_CONTEXT_OPTION_CONTRACTS: PiOptionFlagContract[];
-export declare const PI_DEPS_OPTION_CONTRACTS: PiOptionFlagContract[];
+export declare const TOOL_LIST_FILTER_OPTION_CONTRACTS: ToolOptionFlagContract[];
+export declare const TOOL_AGGREGATE_OPTION_CONTRACTS: ToolOptionFlagContract[];
+export declare const TOOL_DEDUPE_AUDIT_OPTION_CONTRACTS: ToolOptionFlagContract[];
+export declare const TOOL_SEARCH_FILTER_OPTION_CONTRACTS: ToolOptionFlagContract[];
+export declare const TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS: ToolOptionFlagContract[];
+export declare const TOOL_CREATE_OPTION_CONTRACTS: ToolOptionFlagContract[];
+export declare const TOOL_UPDATE_OPTION_CONTRACTS: ToolOptionFlagContract[];
+export declare const TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS: ToolOptionFlagContract[];
+export declare const TOOL_NORMALIZE_FILTER_OPTION_CONTRACTS: ToolOptionFlagContract[];
+export declare const TOOL_CALENDAR_OPTION_CONTRACTS: ToolOptionFlagContract[];
+export declare const TOOL_ACTIVITY_OPTION_CONTRACTS: ToolOptionFlagContract[];
+export declare const TOOL_CONTEXT_OPTION_CONTRACTS: ToolOptionFlagContract[];
+export declare const TOOL_DEPS_OPTION_CONTRACTS: ToolOptionFlagContract[];
 export declare const SUBCOMMAND_GLOBAL_FLAG_CONTRACTS: CliFlagContract[];
 export declare const GLOBAL_FLAG_CONTRACTS: CliFlagContract[];
 export declare const LIST_FILTER_FLAG_CONTRACTS: CliFlagContract[];
@@ -63,6 +63,7 @@ export declare const HISTORY_FLAG_CONTRACTS: CliFlagContract[];
 export declare const INIT_FLAG_CONTRACTS: CliFlagContract[];
 export declare const CONFIG_FLAG_CONTRACTS: CliFlagContract[];
 export declare const EXTENSION_FLAG_CONTRACTS: CliFlagContract[];
+export declare const UPGRADE_FLAG_CONTRACTS: CliFlagContract[];
 export declare const REINDEX_FLAG_CONTRACTS: CliFlagContract[];
 export declare const CLOSE_FLAG_CONTRACTS: CliFlagContract[];
 export declare const APPEND_FLAG_CONTRACTS: CliFlagContract[];
@@ -93,17 +94,6 @@ export declare const CONTRACTS_FLAG_CONTRACTS: CliFlagContract[];
 export declare const COMPLETION_FLAG_CONTRACTS: CliFlagContract[];
 export declare function resolveSubcommandFlagContractsForCommand(commandName: string | undefined): CliFlagContract[];
 export declare function toCompletionFlagString(flagContracts: CliFlagContract[], includeGlobal?: boolean): string;
-export declare const CREATE_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
-export declare const CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS: CommanderOptionAliasContract[];
-export declare const UPDATE_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
-export declare const UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS: CommanderOptionAliasContract[];
-export declare const LIST_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
-export declare const SEARCH_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
-export declare const CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
-export declare const CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
-export declare const ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOptionAliasContract[];
-export declare function readFirstStringFromCommanderOptions(options: Record<string, unknown>, contract: CommanderOptionAliasContract): string | undefined;
-export declare function readStringArrayFromCommanderOptions(options: Record<string, unknown>, contract: CommanderOptionAliasContract): string[] | undefined;
 export interface PmActionSchemaContract {
     required?: string[];
     optional?: string[];
@@ -111,4 +101,4 @@ export interface PmActionSchemaContract {
 }
 export declare const PM_TOOL_ACTION_PARAMETER_CONTRACTS: Readonly<Record<PmToolAction, PmActionSchemaContract>>;
 export declare const PM_TOOL_PARAMETERS_SCHEMA: Record<string, unknown>;
-export declare const PM_PI_TOOL_PARAMETERS_SCHEMA: Record<string, unknown>;
+export declare const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA: Record<string, unknown>;