@unbrained/pm-cli 2026.5.11 → 2026.5.14

package/dist/sdk/cli-contracts.js

@@ -1,3 +1,5 @@
+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 const PM_EXTENSION_CAPABILITY_CONTRACTS = [
     "commands",
     "renderers",
@@ -82,10 +84,22 @@ export function withFlagAliasMetadata(flagContracts) {
         };
     });
 }
+export function compactFlagAliasContracts(flagContracts) {
+    const withAliases = withFlagAliasMetadata(flagContracts);
+    const canonicalFlags = new Set(withAliases.map((contract) => contract.flag));
+    return withAliases.filter((contract) => {
+        const canonical = normalizeFlagAliasKey(contract.flag);
+        return contract.flag === canonical || !canonicalFlags.has(canonical);
+    });
+}
 export const PM_CORE_COMMAND_NAMES = [
     "init",
     "config",
     "extension",
+    "package",
+    "packages",
+    "install",
+    "upgrade",
     "create",
     "list",
     "list-all",
@@ -98,8 +112,6 @@ export const PM_CORE_COMMAND_NAMES = [
     "aggregate",
     "dedupe-audit",
     "guide",
-    "calendar",
-    "cal",
     "context",
     "ctx",
     "get",
@@ -134,7 +146,6 @@ export const PM_CORE_COMMAND_NAMES = [
     "start-task",
     "pause-task",
     "close-task",
-    "templates",
     "completion",
     "help",
 ];
@@ -148,11 +159,27 @@ export const PM_TOOL_ACTIONS = [
     "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",
@@ -165,8 +192,6 @@ export const PM_TOOL_ACTIONS = [
     "aggregate",
     "dedupe-audit",
     "guide",
-    "calendar",
-    "cal",
     "context",
     "ctx",
     "get",
@@ -201,14 +226,8 @@ export const PM_TOOL_ACTIONS = [
     "gc",
     "contracts",
     "completion",
-    "templates-save",
-    "templates-list",
-    "templates-show",
     "claim",
     "release",
-    "beads-import",
-    "todos-import",
-    "todos-export",
     "start-task",
     "pause-task",
     "close-task",
@@ -228,7 +247,7 @@ export function isPmExtensionPolicyModeContract(value) {
 export function isPmExtensionPolicySurfaceContract(value) {
     return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value);
 }
-export const PI_LIST_FILTER_OPTION_CONTRACTS = [
+export const TOOL_LIST_FILTER_OPTION_CONTRACTS = [
     { param: "type", flag: "--type" },
     { param: "tag", flag: "--tag" },
     { param: "priority", flag: "--priority" },
@@ -245,7 +264,7 @@ export const PI_LIST_FILTER_OPTION_CONTRACTS = [
     { param: "sort", flag: "--sort" },
     { param: "order", flag: "--order" },
 ];
-export const PI_AGGREGATE_OPTION_CONTRACTS = [
+export const TOOL_AGGREGATE_OPTION_CONTRACTS = [
     { param: "groupBy", flag: "--group-by" },
     { param: "status", flag: "--status" },
     { param: "type", flag: "--type" },
@@ -259,7 +278,7 @@ export const PI_AGGREGATE_OPTION_CONTRACTS = [
     { param: "sprint", flag: "--sprint" },
     { param: "release", flag: "--release" },
 ];
-export const PI_DEDUPE_AUDIT_OPTION_CONTRACTS = [
+export const TOOL_DEDUPE_AUDIT_OPTION_CONTRACTS = [
     { param: "mode", flag: "--mode" },
     { param: "limit", flag: "--limit" },
     { param: "threshold", flag: "--threshold" },
@@ -275,7 +294,7 @@ export const PI_DEDUPE_AUDIT_OPTION_CONTRACTS = [
     { param: "sprint", flag: "--sprint" },
     { param: "release", flag: "--release" },
 ];
-export const PI_SEARCH_FILTER_OPTION_CONTRACTS = [
+export const TOOL_SEARCH_FILTER_OPTION_CONTRACTS = [
     { param: "type", flag: "--type" },
     { param: "tag", flag: "--tag" },
     { param: "priority", flag: "--priority" },
@@ -284,7 +303,7 @@ export const PI_SEARCH_FILTER_OPTION_CONTRACTS = [
     { param: "fields", flag: "--fields" },
     { param: "limit", flag: "--limit" },
 ];
-export const PI_SHARED_CREATE_UPDATE_OPTION_CONTRACTS = [
+export const TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS = [
     { param: "parent", flag: "--parent" },
     { param: "reviewer", flag: "--reviewer" },
     { param: "risk", flag: "--risk" },
@@ -315,7 +334,7 @@ export const PI_SHARED_CREATE_UPDATE_OPTION_CONTRACTS = [
     { param: "outcome", flag: "--outcome" },
     { param: "whyNow", flag: "--why-now" },
 ];
-export const PI_CREATE_OPTION_CONTRACTS = [
+export const TOOL_CREATE_OPTION_CONTRACTS = [
     { param: "title", flag: "--title" },
     { param: "description", flag: "--description", allowEmpty: true },
     { param: "type", flag: "--type" },
@@ -355,7 +374,7 @@ export const PI_CREATE_OPTION_CONTRACTS = [
     { param: "clearTypeOptions", flag: "--clear-type-options" },
     { param: "allowAuditUpdate", flag: "--allow-audit-update" },
 ];
-export const PI_UPDATE_OPTION_CONTRACTS = [
+export const TOOL_UPDATE_OPTION_CONTRACTS = [
     { param: "title", flag: "--title" },
     { param: "description", flag: "--description", allowEmpty: true },
     { param: "body", flag: "--body", allowEmpty: true },
@@ -396,7 +415,7 @@ export const PI_UPDATE_OPTION_CONTRACTS = [
     { param: "clearTypeOptions", flag: "--clear-type-options" },
     { param: "allowAuditDepUpdate", flag: "--allow-audit-dep-update" },
 ];
-export const PI_UPDATE_MANY_FILTER_OPTION_CONTRACTS = [
+export const TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS = [
     { param: "filterStatus", flag: "--filter-status" },
     { param: "filterType", flag: "--filter-type" },
     { param: "filterTag", flag: "--filter-tag" },
@@ -411,8 +430,8 @@ export const PI_UPDATE_MANY_FILTER_OPTION_CONTRACTS = [
     { param: "limit", flag: "--limit" },
     { param: "offset", flag: "--offset" },
 ];
-export const PI_NORMALIZE_FILTER_OPTION_CONTRACTS = [...PI_UPDATE_MANY_FILTER_OPTION_CONTRACTS];
-export const PI_CALENDAR_OPTION_CONTRACTS = [
+export const TOOL_NORMALIZE_FILTER_OPTION_CONTRACTS = [...TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS];
+export const TOOL_CALENDAR_OPTION_CONTRACTS = [
     { param: "view", flag: "--view" },
     { param: "date", flag: "--date" },
     { param: "from", flag: "--from" },
@@ -432,7 +451,7 @@ export const PI_CALENDAR_OPTION_CONTRACTS = [
     { param: "limit", flag: "--limit" },
     { param: "format", flag: "--format" },
 ];
-export const PI_ACTIVITY_OPTION_CONTRACTS = [
+export const TOOL_ACTIVITY_OPTION_CONTRACTS = [
     { param: "id", flag: "--id" },
     { param: "op", flag: "--op" },
     { param: "author", flag: "--author" },
@@ -440,7 +459,7 @@ export const PI_ACTIVITY_OPTION_CONTRACTS = [
     { param: "to", flag: "--to" },
     { param: "limit", flag: "--limit" },
 ];
-export const PI_CONTEXT_OPTION_CONTRACTS = [
+export const TOOL_CONTEXT_OPTION_CONTRACTS = [
     { param: "date", flag: "--date" },
     { param: "from", flag: "--from" },
     { param: "to", flag: "--to" },
@@ -458,7 +477,7 @@ export const PI_CONTEXT_OPTION_CONTRACTS = [
     { param: "activityLimit", flag: "--activity-limit" },
     { param: "staleThreshold", flag: "--stale-threshold" },
 ];
-export const PI_DEPS_OPTION_CONTRACTS = [
+export const TOOL_DEPS_OPTION_CONTRACTS = [
     { param: "format", flag: "--format" },
     { param: "maxDepth", flag: "--max-depth" },
     { param: "collapse", flag: "--collapse" },
@@ -638,6 +657,7 @@ export const EXTENSION_FLAG_CONTRACTS = [
     { flag: "--reload" },
     { flag: "--watch" },
     { flag: "--doctor" },
+    { flag: "--catalog" },
     { flag: "--adopt" },
     { flag: "--adopt-all" },
     { flag: "--activate" },
@@ -655,6 +675,17 @@ export const EXTENSION_FLAG_CONTRACTS = [
     { flag: "--strict-exit" },
     { flag: "--fail-on-warn" },
 ];
+export const UPGRADE_FLAG_CONTRACTS = [
+    { flag: "--dry-run" },
+    { flag: "--cli-only" },
+    { flag: "--packages-only" },
+    { flag: "--project" },
+    { flag: "--local" },
+    { flag: "--global" },
+    { flag: "--repair" },
+    { flag: "--tag" },
+    { flag: "--package-name" },
+];
 export const REINDEX_FLAG_CONTRACTS = [
     { flag: "--mode" },
     { flag: "--progress" },
@@ -1211,11 +1242,6 @@ const NO_SURFACE_COMMAND_NAME_CONTRACTS = new Set([
     "get",
     "stats",
     "reindex",
-    "beads",
-    "todos",
-    "beads-import",
-    "todos-import",
-    "todos-export",
     "help",
 ]);
 function normalizeCommandNameForContracts(commandName) {
@@ -1253,7 +1279,12 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
         case "config":
             return withSubcommandGlobalFlags(CONFIG_FLAG_CONTRACTS);
         case "extension":
+        case "package":
+        case "packages":
+        case "install":
             return withSubcommandGlobalFlags(EXTENSION_FLAG_CONTRACTS);
+        case "upgrade":
+            return withSubcommandGlobalFlags(UPGRADE_FLAG_CONTRACTS);
         case "create":
             return withSubcommandGlobalFlags(CREATE_FLAG_CONTRACTS);
         case "aggregate":
@@ -1343,218 +1374,6 @@ export function toCompletionFlagString(flagContracts, includeGlobal = true) {
         : scoped;
     return normalizeUniqueStringList(all).join(" ");
 }
-export const CREATE_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "title", keys: ["title"] },
-    { target: "description", keys: ["description"] },
-    { target: "type", keys: ["type"] },
-    { target: "template", keys: ["template"] },
-    { target: "createMode", keys: ["createMode", "create_mode"] },
-    { target: "schedulePreset", keys: ["schedulePreset", "schedule_preset"] },
-    { target: "status", keys: ["status"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "tags", keys: ["tags"] },
-    { target: "body", keys: ["body"] },
-    { target: "deadline", keys: ["deadline"] },
-    { target: "estimatedMinutes", keys: ["estimate", "estimatedMinutes", "estimated_minutes"] },
-    { target: "acceptanceCriteria", keys: ["acceptanceCriteria", "acceptance_criteria", "ac"] },
-    { target: "definitionOfReady", keys: ["definitionOfReady", "definition_of_ready"] },
-    { target: "order", keys: ["order"] },
-    { target: "rank", keys: ["rank"] },
-    { target: "goal", keys: ["goal"] },
-    { target: "objective", keys: ["objective"] },
-    { target: "value", keys: ["value"] },
-    { target: "impact", keys: ["impact"] },
-    { target: "outcome", keys: ["outcome"] },
-    { target: "whyNow", keys: ["whyNow", "why_now"] },
-    { target: "author", keys: ["author"] },
-    { target: "message", keys: ["message"] },
-    { target: "assignee", keys: ["assignee"] },
-    { target: "parent", keys: ["parent"] },
-    { target: "reviewer", keys: ["reviewer"] },
-    { target: "risk", keys: ["risk"] },
-    { target: "confidence", keys: ["confidence"] },
-    { target: "sprint", keys: ["sprint"] },
-    { target: "release", keys: ["release"] },
-    { target: "blockedBy", keys: ["blockedBy", "blocked_by"] },
-    { target: "blockedReason", keys: ["blockedReason", "blocked_reason"] },
-    { target: "unblockNote", keys: ["unblockNote", "unblock_note"] },
-    { target: "reporter", keys: ["reporter"] },
-    { target: "severity", keys: ["severity"] },
-    { target: "environment", keys: ["environment"] },
-    { target: "reproSteps", keys: ["reproSteps", "repro_steps"] },
-    { target: "resolution", keys: ["resolution"] },
-    { target: "expectedResult", keys: ["expectedResult", "expected_result"] },
-    { target: "actualResult", keys: ["actualResult", "actual_result"] },
-    { target: "affectedVersion", keys: ["affectedVersion", "affected_version"] },
-    { target: "fixedVersion", keys: ["fixedVersion", "fixed_version"] },
-    { target: "component", keys: ["component"] },
-    { target: "regression", keys: ["regression"] },
-    { target: "customerImpact", keys: ["customerImpact", "customer_impact"] },
-];
-export const CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS = [
-    { target: "dep", keys: ["dep"] },
-    { target: "comment", keys: ["comment"] },
-    { target: "note", keys: ["note"] },
-    { target: "learning", keys: ["learning"] },
-    { target: "file", keys: ["file"] },
-    { target: "test", keys: ["test"] },
-    { target: "doc", keys: ["doc"] },
-    { target: "reminder", keys: ["reminder"] },
-    { target: "event", keys: ["event"] },
-    { target: "typeOption", keys: ["typeOption", "type_option"] },
-    { target: "unset", keys: ["unset"] },
-];
-export const UPDATE_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "title", keys: ["title"] },
-    { target: "description", keys: ["description"] },
-    { target: "body", keys: ["body"] },
-    { target: "status", keys: ["status"] },
-    { target: "closeReason", keys: ["closeReason", "close_reason"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "type", keys: ["type"] },
-    { target: "tags", keys: ["tags"] },
-    { target: "deadline", keys: ["deadline"] },
-    { target: "estimatedMinutes", keys: ["estimate", "estimatedMinutes", "estimated_minutes"] },
-    { target: "acceptanceCriteria", keys: ["acceptanceCriteria", "acceptance_criteria", "ac"] },
-    { target: "definitionOfReady", keys: ["definitionOfReady", "definition_of_ready"] },
-    { target: "order", keys: ["order"] },
-    { target: "rank", keys: ["rank"] },
-    { target: "goal", keys: ["goal"] },
-    { target: "objective", keys: ["objective"] },
-    { target: "value", keys: ["value"] },
-    { target: "impact", keys: ["impact"] },
-    { target: "outcome", keys: ["outcome"] },
-    { target: "whyNow", keys: ["whyNow", "why_now"] },
-    { target: "author", keys: ["author"] },
-    { target: "message", keys: ["message"] },
-    { target: "assignee", keys: ["assignee"] },
-    { target: "parent", keys: ["parent"] },
-    { target: "reviewer", keys: ["reviewer"] },
-    { target: "risk", keys: ["risk"] },
-    { target: "confidence", keys: ["confidence"] },
-    { target: "sprint", keys: ["sprint"] },
-    { target: "release", keys: ["release"] },
-    { target: "blockedBy", keys: ["blockedBy", "blocked_by"] },
-    { target: "blockedReason", keys: ["blockedReason", "blocked_reason"] },
-    { target: "unblockNote", keys: ["unblockNote", "unblock_note"] },
-    { target: "reporter", keys: ["reporter"] },
-    { target: "severity", keys: ["severity"] },
-    { target: "environment", keys: ["environment"] },
-    { target: "reproSteps", keys: ["reproSteps", "repro_steps"] },
-    { target: "resolution", keys: ["resolution"] },
-    { target: "expectedResult", keys: ["expectedResult", "expected_result"] },
-    { target: "actualResult", keys: ["actualResult", "actual_result"] },
-    { target: "affectedVersion", keys: ["affectedVersion", "affected_version"] },
-    { target: "fixedVersion", keys: ["fixedVersion", "fixed_version"] },
-    { target: "component", keys: ["component"] },
-    { target: "regression", keys: ["regression"] },
-    { target: "customerImpact", keys: ["customerImpact", "customer_impact"] },
-];
-export const UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS = [
-    { target: "dep", keys: ["dep"] },
-    { target: "depRemove", keys: ["depRemove", "dep_remove"] },
-    { target: "comment", keys: ["comment"] },
-    { target: "note", keys: ["note"] },
-    { target: "learning", keys: ["learning"] },
-    { target: "file", keys: ["file"] },
-    { target: "test", keys: ["test"] },
-    { target: "doc", keys: ["doc"] },
-    { target: "reminder", keys: ["reminder"] },
-    { target: "event", keys: ["event"] },
-    { target: "typeOption", keys: ["typeOption", "type_option"] },
-    { target: "unset", keys: ["unset"] },
-];
-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;
-}
 const PM_TOOL_PARAMETER_PROPERTIES = {
     json: { type: "boolean", default: true },
     quiet: { type: "boolean" },
@@ -1727,6 +1546,10 @@ const PM_TOOL_PARAMETER_PROPERTIES = {
     allowAuditDepUpdate: { type: "boolean" },
     allowAuditRelease: { type: "boolean" },
     dryRun: { type: "boolean" },
+    cliOnly: { type: "boolean" },
+    packagesOnly: { type: "boolean" },
+    repair: { type: "boolean" },
+    packageName: { type: "string" },
     rollback: { type: "string" },
     noCheckpoint: { type: "boolean" },
     force: { type: "boolean" },
@@ -1796,40 +1619,24 @@ function toSchemaKeyList(values) {
     return normalizeUniqueStringList(values);
 }
 const CREATE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...PI_CREATE_OPTION_CONTRACTS.map((entry) => entry.param),
-    ...PI_SHARED_CREATE_UPDATE_OPTION_CONTRACTS.map((entry) => entry.param),
+    ...TOOL_CREATE_OPTION_CONTRACTS.map((entry) => entry.param),
+    ...TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS.map((entry) => entry.param),
     "assignee",
 ]);
-const TEMPLATE_SAVE_UNSUPPORTED_PARAMETER_KEYS = new Set([
-    "createMode",
-    "schedulePreset",
-    "unset",
-    "clearDeps",
-    "clearComments",
-    "clearNotes",
-    "clearLearnings",
-    "clearFiles",
-    "clearTests",
-    "clearDocs",
-    "clearReminders",
-    "clearEvents",
-    "clearTypeOptions",
-]);
-const TEMPLATE_SAVE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList(CREATE_CONTRACT_PARAMETER_KEYS.filter((key) => !TEMPLATE_SAVE_UNSUPPORTED_PARAMETER_KEYS.has(key)));
 const UPDATE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...PI_UPDATE_OPTION_CONTRACTS.map((entry) => entry.param),
-    ...PI_SHARED_CREATE_UPDATE_OPTION_CONTRACTS.map((entry) => entry.param),
+    ...TOOL_UPDATE_OPTION_CONTRACTS.map((entry) => entry.param),
+    ...TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS.map((entry) => entry.param),
     "force",
 ]);
 const UPDATE_MANY_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...PI_UPDATE_MANY_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
+    ...TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
     ...UPDATE_CONTRACT_PARAMETER_KEYS,
     "dryRun",
     "rollback",
     "noCheckpoint",
 ]);
 const NORMALIZE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...PI_NORMALIZE_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
+    ...TOOL_NORMALIZE_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
     "dryRun",
     "apply",
     "author",
@@ -1837,31 +1644,26 @@ const NORMALIZE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     "allowAuditUpdate",
     "force",
 ]);
-const CALENDAR_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...PI_CALENDAR_OPTION_CONTRACTS.map((entry) => entry.param),
-    "past",
-    "fullPeriod",
-]);
 const CONTEXT_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...PI_CONTEXT_OPTION_CONTRACTS.map((entry) => entry.param),
+    ...TOOL_CONTEXT_OPTION_CONTRACTS.map((entry) => entry.param),
     "past",
     "section",
 ]);
 const ACTIVITY_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...PI_ACTIVITY_OPTION_CONTRACTS.map((entry) => entry.param),
+    ...TOOL_ACTIVITY_OPTION_CONTRACTS.map((entry) => entry.param),
     "stream",
 ]);
 const LIST_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...PI_LIST_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
+    ...TOOL_LIST_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
     "includeBody",
     "compact",
 ]);
 const AGGREGATE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...PI_AGGREGATE_OPTION_CONTRACTS.map((entry) => entry.param),
+    ...TOOL_AGGREGATE_OPTION_CONTRACTS.map((entry) => entry.param),
     "count",
     "includeUnparented",
 ]);
-const DEDUPE_AUDIT_CONTRACT_PARAMETER_KEYS = toSchemaKeyList(PI_DEDUPE_AUDIT_OPTION_CONTRACTS.map((entry) => entry.param));
+const DEDUPE_AUDIT_CONTRACT_PARAMETER_KEYS = toSchemaKeyList(TOOL_DEDUPE_AUDIT_OPTION_CONTRACTS.map((entry) => entry.param));
 const SEARCH_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     "query",
     "keywords",
@@ -1871,7 +1673,7 @@ const SEARCH_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     "phraseExact",
     "compact",
     "full",
-    ...PI_SEARCH_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
+    ...TOOL_SEARCH_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
 ]);
 const AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS = ["author", "message", "force"];
 const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
@@ -1890,6 +1692,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     "extension-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
     "extension-reload": { optional: ["scope", "watch"] },
     "extension-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
+    "extension-catalog": { optional: ["scope"] },
     "extension-adopt": { required: ["target"], optional: ["scope", "github", "ref"] },
     "extension-adopt-all": { optional: ["scope"] },
     "extension-activate": { required: ["target"], optional: ["scope"] },
@@ -1907,6 +1710,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "manage",
             "reload",
             "doctor",
+            "catalog",
             "adopt",
             "adoptAll",
             "activate",
@@ -1920,6 +1724,55 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "failOnWarn",
         ],
     },
+    "package-init": { required: ["target"], optional: ["scope"] },
+    "package-install": {
+        optional: ["target", "github", "scope", "ref"],
+        anyOfRequired: [["target"], ["github"]],
+    },
+    "package-uninstall": { required: ["target"], optional: ["scope"] },
+    "package-explore": { optional: ["scope"] },
+    "package-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
+    "package-reload": { optional: ["scope", "watch"] },
+    "package-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
+    "package-catalog": { optional: ["scope"] },
+    "package-adopt": { required: ["target"], optional: ["scope", "github", "ref"] },
+    "package-adopt-all": { optional: ["scope"] },
+    "package-activate": { required: ["target"], optional: ["scope"] },
+    "package-deactivate": { required: ["target"], optional: ["scope"] },
+    package: {
+        optional: [
+            "target",
+            "scope",
+            "github",
+            "ref",
+            "init",
+            "install",
+            "uninstall",
+            "explore",
+            "manage",
+            "reload",
+            "doctor",
+            "catalog",
+            "adopt",
+            "adoptAll",
+            "activate",
+            "deactivate",
+            "runtimeProbe",
+            "fixManagedState",
+            "detail",
+            "trace",
+            "watch",
+            "strictExit",
+            "failOnWarn",
+        ],
+    },
+    install: {
+        optional: ["target", "github", "scope", "ref"],
+        anyOfRequired: [["target"], ["github"]],
+    },
+    upgrade: {
+        optional: ["target", "scope", "dryRun", "cliOnly", "packagesOnly", "repair", "tag", "packageName"],
+    },
     create: {
         required: ["title", "description", "type", "status", "priority", "message"],
         optional: CREATE_CONTRACT_PARAMETER_KEYS,
@@ -1935,8 +1788,6 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     aggregate: { optional: AGGREGATE_CONTRACT_PARAMETER_KEYS },
     "dedupe-audit": { optional: DEDUPE_AUDIT_CONTRACT_PARAMETER_KEYS },
     guide: { optional: ["format", "depth"] },
-    calendar: { optional: CALENDAR_CONTRACT_PARAMETER_KEYS },
-    cal: { optional: CALENDAR_CONTRACT_PARAMETER_KEYS },
     context: { optional: CONTEXT_CONTRACT_PARAMETER_KEYS },
     ctx: { optional: CONTEXT_CONTRACT_PARAMETER_KEYS },
     get: { required: ["id"] },
@@ -2100,17 +1951,8 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     gc: { optional: ["dryRun", "gcScope"] },
     contracts: { optional: ["contractAction", "command", "schemaOnly", "flagsOnly", "availabilityOnly", "runtimeOnly", "activeOnly"] },
     completion: { required: ["shell"], optional: ["eagerTags"] },
-    "templates-save": {
-        required: ["template"],
-        optional: TEMPLATE_SAVE_CONTRACT_PARAMETER_KEYS,
-    },
-    "templates-list": {},
-    "templates-show": { required: ["template"] },
     claim: { required: ["id"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
     release: { required: ["id"], optional: ["allowAuditRelease", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS] },
-    "beads-import": { optional: ["file", "author", "message", "preserveSourceIds"] },
-    "todos-import": { optional: ["folder", "author", "message"] },
-    "todos-export": { optional: ["folder"] },
     "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 },
@@ -2148,17 +1990,34 @@ const PM_TOOL_PARAMETER_METADATA = {
         description: "When true for extension-manage/extension-doctor, adopt unmanaged extensions before diagnostics/update checks.",
     },
     target: {
-        description: "Positional target argument for the selected action (ID, source, or extension name).",
+        description: "Positional target argument for the selected action (ID, source, package source, or extension name).",
         examples: ["pm-a1b2", ".agents/pm/extensions/sample", "sample-extension"],
     },
     github: {
-        description: "GitHub shorthand owner/repo[/path] source for extension install actions.",
-        examples: ["unbraind/pm-cli/pi"],
+        description: "GitHub shorthand owner/repo[/path] source for package/extension install actions.",
+        examples: ["org/repo/extensions/sample"],
     },
     ref: {
         description: "Git ref/branch/tag used when installing from GitHub shorthand/URL sources.",
         examples: ["main", "v1.0.0"],
     },
+    cliOnly: {
+        description: "Restrict upgrade to the pm CLI/SDK npm package.",
+    },
+    packagesOnly: {
+        description: "Restrict upgrade to managed installable pm packages.",
+    },
+    repair: {
+        description: "Force npm global reinstall semantics when upgrading the pm CLI/SDK.",
+    },
+    tag: {
+        description: "npm version or dist-tag used for CLI and registry package upgrades.",
+        examples: ["latest", "next", "2026.5.11"],
+    },
+    packageName: {
+        description: "Override the pm CLI package name for self-upgrade automation and tests.",
+        examples: ["@unbrained/pm-cli"],
+    },
     json: {
         description: "Emit machine-readable JSON output.",
     },
@@ -2175,7 +2034,7 @@ const PM_TOOL_PARAMETER_METADATA = {
         description: "Emit deterministic timing diagnostics to stderr.",
     },
     timeoutMs: {
-        description: "Pi wrapper execution timeout in milliseconds.",
+        description: "Tool execution timeout in milliseconds.",
         examples: [120000],
     },
     id: {
@@ -2456,8 +2315,8 @@ const PM_TOOL_PARAMETER_METADATA = {
         description: "When true for comments action, read comment text from piped stdin (supports multiline markdown).",
     },
     file: {
-        description: "Path to input file for actions that read payload text (for example comments --file or beads-import --file).",
-        examples: ["notes/comment.md", "import.json"],
+        description: "Path to input file for actions that read payload text, such as comments --file.",
+        examples: ["notes/comment.md"],
     },
     allowAuditUpdate: {
         description: "Allow non-owner metadata-only update audits without requiring --force.",
@@ -2646,8 +2505,8 @@ function buildActionScopedToolSchema(action) {
 }
 export const PM_TOOL_PARAMETERS_SCHEMA = {
     $schema: "https://json-schema.org/draft/2020-12/schema",
-    $id: "https://unbrained.dev/schemas/pm-cli/tool-parameters-v4.schema.json",
-    title: "pm-cli Pi wrapper parameters (action-scoped strict schema)",
+    $id: "https://schema.unbrained.dev/pm-cli/tool-parameters-v4.schema.json",
+    title: "pm-cli tool parameters (action-scoped strict schema)",
     "x-schema-version": "4.0.1",
     type: "object",
     oneOf: PM_TOOL_ACTIONS.map((action) => buildActionScopedToolSchema(action)),
@@ -2672,7 +2531,7 @@ function toProviderCompatibleParameterDefinition(key, definition) {
         type: "string",
     };
 }
-function buildProviderCompatiblePiToolSchema() {
+function buildProviderCompatibleToolSchema() {
     const properties = {
         action: {
             type: "string",
@@ -2688,7 +2547,7 @@ function buildProviderCompatiblePiToolSchema() {
         properties[key] = toProviderCompatibleParameterDefinition(key, PM_TOOL_PARAMETER_PROPERTIES[key]);
     }
     return {
-        title: "pm-cli Pi tool parameters (provider-compatible flat schema)",
+        title: "pm-cli tool parameters (provider-compatible flat schema)",
         "x-schema-version": "1.0.0",
         type: "object",
         additionalProperties: false,
@@ -2696,5 +2555,5 @@ function buildProviderCompatiblePiToolSchema() {
         properties,
     };
 }
-export const PM_PI_TOOL_PARAMETERS_SCHEMA = buildProviderCompatiblePiToolSchema();
+export const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = buildProviderCompatibleToolSchema();
 //# sourceMappingURL=cli-contracts.js.map