@unbrained/pm-cli 2026.5.10 → 2026.5.12

package/dist/sdk/cli-contracts.js

@@ -19,6 +19,30 @@ export const PM_EXTENSION_SERVICE_NAME_CONTRACTS = [
     "item_store_write",
     "item_store_delete",
 ];
+export const PM_EXTENSION_POLICY_MODE_CONTRACTS = ["off", "warn", "enforce"];
+export const PM_EXTENSION_TRUST_MODE_CONTRACTS = ["off", "warn", "enforce"];
+export const PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS = ["none", "restricted", "strict"];
+export const PM_EXTENSION_POLICY_SURFACE_CONTRACTS = [
+    "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",
+];
 function normalizeUniqueStringList(values) {
     return [...new Set(Array.from(values).filter((value) => value.trim().length > 0))];
 }
@@ -62,6 +86,10 @@ export const PM_CORE_COMMAND_NAMES = [
     "init",
     "config",
     "extension",
+    "package",
+    "packages",
+    "install",
+    "upgrade",
     "create",
     "list",
     "list-all",
@@ -122,11 +150,27 @@ export const PM_TOOL_ACTIONS = [
     "extension-uninstall",
     "extension-explore",
     "extension-manage",
+    "extension-reload",
     "extension-doctor",
     "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-adopt",
+    "package-adopt-all",
+    "package-activate",
+    "package-deactivate",
+    "package",
+    "install",
+    "upgrade",
     "create",
     "list",
     "list-all",
@@ -138,8 +182,11 @@ export const PM_TOOL_ACTIONS = [
     "list-canceled",
     "aggregate",
     "dedupe-audit",
+    "guide",
     "calendar",
+    "cal",
     "context",
+    "ctx",
     "get",
     "search",
     "reindex",
@@ -184,7 +231,22 @@ export const PM_TOOL_ACTIONS = [
     "pause-task",
     "close-task",
 ];
-export const PI_LIST_FILTER_OPTION_CONTRACTS = [
+export function isPmToolAction(value) {
+    return PM_TOOL_ACTIONS.includes(value);
+}
+export function isPmExtensionCapabilityContract(value) {
+    return PM_EXTENSION_CAPABILITY_CONTRACTS.includes(value);
+}
+export function isPmExtensionServiceNameContract(value) {
+    return PM_EXTENSION_SERVICE_NAME_CONTRACTS.includes(value);
+}
+export function isPmExtensionPolicyModeContract(value) {
+    return PM_EXTENSION_POLICY_MODE_CONTRACTS.includes(value);
+}
+export function isPmExtensionPolicySurfaceContract(value) {
+    return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value);
+}
+export const TOOL_LIST_FILTER_OPTION_CONTRACTS = [
     { param: "type", flag: "--type" },
     { param: "tag", flag: "--tag" },
     { param: "priority", flag: "--priority" },
@@ -201,7 +263,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" },
@@ -215,7 +277,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" },
@@ -231,7 +293,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" },
@@ -240,7 +302,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" },
@@ -271,7 +333,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" },
@@ -311,7 +373,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 },
@@ -352,7 +414,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" },
@@ -367,8 +429,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" },
@@ -388,7 +450,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" },
@@ -396,7 +458,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" },
@@ -414,7 +476,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" },
@@ -572,6 +634,17 @@ export const CONFIG_FLAG_CONTRACTS = [
     { flag: "--clear-criteria" },
     { flag: "--format" },
     { flag: "--policy" },
+    { flag: "--default-depth" },
+    { flag: "--activity-limit" },
+    { flag: "--stale-threshold-days" },
+    { flag: "--section-hierarchy" },
+    { flag: "--section-activity" },
+    { flag: "--section-progress" },
+    { flag: "--section-blockers" },
+    { flag: "--section-files" },
+    { flag: "--section-workload" },
+    { flag: "--section-staleness" },
+    { flag: "--section-tests" },
 ];
 export const EXTENSION_FLAG_CONTRACTS = [
     { flag: "--init" },
@@ -580,6 +653,8 @@ export const EXTENSION_FLAG_CONTRACTS = [
     { flag: "--uninstall" },
     { flag: "--explore" },
     { flag: "--manage" },
+    { flag: "--reload" },
+    { flag: "--watch" },
     { flag: "--doctor" },
     { flag: "--adopt" },
     { flag: "--adopt-all" },
@@ -598,6 +673,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" },
@@ -1080,6 +1166,10 @@ export const CONTEXT_FLAG_CONTRACTS = [
     { flag: "--release" },
     { flag: "--limit" },
     { flag: "--format" },
+    { flag: "--depth" },
+    { flag: "--section" },
+    { flag: "--activity-limit" },
+    { flag: "--stale-threshold" },
 ];
 export const GUIDE_FLAG_CONTRACTS = [
     { flag: "--list" },
@@ -1119,6 +1209,161 @@ export const CONTRACTS_FLAG_CONTRACTS = [
 export const COMPLETION_FLAG_CONTRACTS = [
     { flag: "--eager-tags" },
 ];
+function toUniqueFlagContracts(contracts) {
+    const seen = new Set();
+    const unique = [];
+    for (const contract of contracts) {
+        const aliasKey = (contract.aliases ?? []).join(",");
+        const key = `${contract.flag}|${contract.short ?? ""}|${aliasKey}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        unique.push(contract);
+    }
+    return unique;
+}
+function withSubcommandGlobalFlags(contracts) {
+    return withFlagAliasMetadata(toUniqueFlagContracts([...SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, ...contracts]));
+}
+const LIST_COMMAND_NAME_CONTRACTS = new Set([
+    "list",
+    "list-all",
+    "list-draft",
+    "list-open",
+    "list-in-progress",
+    "list-blocked",
+    "list-closed",
+    "list-canceled",
+]);
+const NO_SURFACE_COMMAND_NAME_CONTRACTS = new Set([
+    "get",
+    "stats",
+    "reindex",
+    "beads",
+    "todos",
+    "beads-import",
+    "todos-import",
+    "todos-export",
+    "help",
+]);
+function normalizeCommandNameForContracts(commandName) {
+    if (typeof commandName !== "string") {
+        return "";
+    }
+    return commandName.trim().toLowerCase();
+}
+export function resolveSubcommandFlagContractsForCommand(commandName) {
+    const normalized = normalizeCommandNameForContracts(commandName);
+    if (normalized.length === 0) {
+        return withSubcommandGlobalFlags([]);
+    }
+    if (LIST_COMMAND_NAME_CONTRACTS.has(normalized)) {
+        return withSubcommandGlobalFlags(LIST_FILTER_FLAG_CONTRACTS);
+    }
+    if (NO_SURFACE_COMMAND_NAME_CONTRACTS.has(normalized)) {
+        return withSubcommandGlobalFlags([]);
+    }
+    if (normalized === "templates") {
+        return withSubcommandGlobalFlags(CREATE_FLAG_CONTRACTS);
+    }
+    if (normalized === "cal") {
+        return withSubcommandGlobalFlags(CALENDAR_FLAG_CONTRACTS);
+    }
+    if (normalized === "ctx") {
+        return withSubcommandGlobalFlags(CONTEXT_FLAG_CONTRACTS);
+    }
+    if (normalized === "test-runs-worker") {
+        return withSubcommandGlobalFlags(TEST_RUNS_FLAG_CONTRACTS);
+    }
+    switch (normalized) {
+        case "init":
+            return withSubcommandGlobalFlags(INIT_FLAG_CONTRACTS);
+        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":
+            return withSubcommandGlobalFlags(AGGREGATE_FLAG_CONTRACTS);
+        case "dedupe-audit":
+            return withSubcommandGlobalFlags(DEDUPE_AUDIT_FLAG_CONTRACTS);
+        case "comments-audit":
+            return withSubcommandGlobalFlags(COMMENTS_AUDIT_FLAG_CONTRACTS);
+        case "calendar":
+            return withSubcommandGlobalFlags(CALENDAR_FLAG_CONTRACTS);
+        case "context":
+            return withSubcommandGlobalFlags(CONTEXT_FLAG_CONTRACTS);
+        case "search":
+            return withSubcommandGlobalFlags(SEARCH_FLAG_CONTRACTS);
+        case "history":
+            return withSubcommandGlobalFlags(HISTORY_FLAG_CONTRACTS);
+        case "activity":
+            return withSubcommandGlobalFlags(ACTIVITY_FLAG_CONTRACTS);
+        case "restore":
+            return withSubcommandGlobalFlags(RESTORE_FLAG_CONTRACTS);
+        case "update":
+            return withSubcommandGlobalFlags(UPDATE_FLAG_CONTRACTS);
+        case "update-many":
+            return withSubcommandGlobalFlags(UPDATE_MANY_FLAG_CONTRACTS);
+        case "normalize":
+            return withSubcommandGlobalFlags(NORMALIZE_FLAG_CONTRACTS);
+        case "close":
+            return withSubcommandGlobalFlags(CLOSE_FLAG_CONTRACTS);
+        case "delete":
+            return withSubcommandGlobalFlags(DELETE_FLAG_CONTRACTS);
+        case "append":
+            return withSubcommandGlobalFlags(APPEND_FLAG_CONTRACTS);
+        case "comments":
+            return withSubcommandGlobalFlags(COMMENTS_FLAG_CONTRACTS);
+        case "notes":
+            return withSubcommandGlobalFlags(NOTES_FLAG_CONTRACTS);
+        case "learnings":
+            return withSubcommandGlobalFlags(LEARNINGS_FLAG_CONTRACTS);
+        case "files":
+            return withSubcommandGlobalFlags(FILES_FLAG_CONTRACTS);
+        case "docs":
+            return withSubcommandGlobalFlags(DOCS_FLAG_CONTRACTS);
+        case "deps":
+            return withSubcommandGlobalFlags(DEPS_FLAG_CONTRACTS);
+        case "test":
+            return withSubcommandGlobalFlags(TEST_FLAG_CONTRACTS);
+        case "test-all":
+            return withSubcommandGlobalFlags(TEST_ALL_FLAG_CONTRACTS);
+        case "test-runs":
+            return withSubcommandGlobalFlags(TEST_RUNS_FLAG_CONTRACTS);
+        case "health":
+            return withSubcommandGlobalFlags(HEALTH_FLAG_CONTRACTS);
+        case "validate":
+            return withSubcommandGlobalFlags(VALIDATE_FLAG_CONTRACTS);
+        case "gc":
+            return withSubcommandGlobalFlags(GC_FLAG_CONTRACTS);
+        case "contracts":
+            return withSubcommandGlobalFlags(CONTRACTS_FLAG_CONTRACTS);
+        case "claim":
+            return withSubcommandGlobalFlags(CLAIM_FLAG_CONTRACTS);
+        case "release":
+            return withSubcommandGlobalFlags(RELEASE_FLAG_CONTRACTS);
+        case "start-task":
+            return withSubcommandGlobalFlags(START_TASK_FLAG_CONTRACTS);
+        case "pause-task":
+            return withSubcommandGlobalFlags(PAUSE_TASK_FLAG_CONTRACTS);
+        case "close-task":
+            return withSubcommandGlobalFlags(CLOSE_TASK_FLAG_CONTRACTS);
+        case "guide":
+            return withSubcommandGlobalFlags(GUIDE_FLAG_CONTRACTS);
+        case "completion":
+            return withSubcommandGlobalFlags(COMPLETION_FLAG_CONTRACTS);
+        default:
+            return withSubcommandGlobalFlags([]);
+    }
+}
 export function toCompletionFlagString(flagContracts, includeGlobal = true) {
     const aliasAwareContracts = withFlagAliasMetadata(flagContracts);
     const scoped = aliasAwareContracts
@@ -1473,6 +1718,8 @@ const PM_TOOL_PARAMETER_PROPERTIES = {
     sharedHostSafe: { type: "boolean" },
     detail: { type: "string", enum: ["summary", "deep"] },
     trace: { type: "boolean" },
+    reload: { type: "boolean" },
+    watch: { type: "boolean" },
     runtimeProbe: { type: "boolean" },
     fixManagedState: { type: "boolean" },
     pmContext: { type: "string", enum: ["schema", "tracker", "auto"] },
@@ -1514,6 +1761,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" },
@@ -1583,8 +1834,8 @@ 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([
@@ -1604,19 +1855,19 @@ const TEMPLATE_SAVE_UNSUPPORTED_PARAMETER_KEYS = new Set([
 ]);
 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",
@@ -1625,30 +1876,30 @@ const NORMALIZE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     "force",
 ]);
 const CALENDAR_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...PI_CALENDAR_OPTION_CONTRACTS.map((entry) => entry.param),
+    ...TOOL_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",
@@ -1658,7 +1909,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 = {
@@ -1675,11 +1926,85 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     "extension-uninstall": { required: ["target"], optional: ["scope"] },
     "extension-explore": { optional: ["scope"] },
     "extension-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
+    "extension-reload": { optional: ["scope", "watch"] },
     "extension-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
     "extension-adopt": { required: ["target"], optional: ["scope", "github", "ref"] },
     "extension-adopt-all": { optional: ["scope"] },
     "extension-activate": { required: ["target"], optional: ["scope"] },
     "extension-deactivate": { required: ["target"], optional: ["scope"] },
+    extension: {
+        optional: [
+            "target",
+            "scope",
+            "github",
+            "ref",
+            "init",
+            "install",
+            "uninstall",
+            "explore",
+            "manage",
+            "reload",
+            "doctor",
+            "adopt",
+            "adoptAll",
+            "activate",
+            "deactivate",
+            "runtimeProbe",
+            "fixManagedState",
+            "detail",
+            "trace",
+            "watch",
+            "strictExit",
+            "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-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",
+            "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,
@@ -1694,8 +2019,11 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     "list-canceled": { optional: LIST_CONTRACT_PARAMETER_KEYS },
     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"] },
     search: {
         optional: SEARCH_CONTRACT_PARAMETER_KEYS,
@@ -1872,6 +2200,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     "pause-task": { required: ["id"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
     "close-task": { required: ["id", "text"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
 };
+export const PM_TOOL_ACTION_PARAMETER_CONTRACTS = PM_TOOL_ACTION_SCHEMA_CONTRACTS;
 const PM_TOOL_PARAMETER_METADATA = {
     action: {
         description: "Tool action to execute.",
@@ -1891,6 +2220,12 @@ const PM_TOOL_PARAMETER_METADATA = {
     trace: {
         description: "When true for extension-doctor, include actionable registration traces in deep diagnostics.",
     },
+    reload: {
+        description: "When true for extension action payloads, trigger cache-busted extension module reload.",
+    },
+    watch: {
+        description: "When true for extension-reload/extension action payloads, enable watch mode semantics.",
+    },
     runtimeProbe: {
         description: "When true for extension-manage, run a doctor-like runtime activation probe for parity fields.",
     },
@@ -1898,17 +2233,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.",
     },
@@ -1925,7 +2277,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: {
@@ -2396,8 +2748,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)),
@@ -2422,7 +2774,7 @@ function toProviderCompatibleParameterDefinition(key, definition) {
         type: "string",
     };
 }
-function buildProviderCompatiblePiToolSchema() {
+function buildProviderCompatibleToolSchema() {
     const properties = {
         action: {
             type: "string",
@@ -2438,7 +2790,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,
@@ -2446,5 +2798,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