@unbrained/pm-cli 2026.6.21 → 2026.6.23

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

@@ -29,7 +29,7 @@ export declare const PM_EXTENSION_POLICY_SURFACE_CONTRACTS: readonly ["commands.
  */
 export type PmExtensionPolicySurfaceContract = (typeof PM_EXTENSION_POLICY_SURFACE_CONTRACTS)[number];
 export declare const PM_CORE_COMMAND_NAMES: readonly ["init", "config", "extension", "package", "packages", "install", "upgrade", "create", "copy", "focus", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "context", "ctx", "get", "search", "eval", "history", "history-redact", "history-repair", "history-compact", "schema", "activity", "restore", "update", "update-many", "close", "close-many", "delete", "append", "comments", "notes", "learnings", "files", "docs", "deps", "plan", "test", "test-all", "telemetry", "stats", "health", "validate", "gc", "contracts", "claim", "release", "start-task", "pause-task", "close-task", "meet", "event", "remind", "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", "copy", "focus", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "context", "ctx", "get", "search", "history", "history-redact", "history-repair", "history-compact", "schema", "activity", "restore", "update", "update-many", "close", "close-many", "delete", "append", "comments", "plan", "notes", "learnings", "files", "docs", "deps", "test", "test-all", "telemetry", "stats", "health", "validate", "gc", "contracts", "claim", "release", "start-task", "pause-task", "close-task"];
+export declare const PM_TOOL_ACTIONS: readonly ["init", "config", "extension-init", "extension-install", "extension-uninstall", "extension-explore", "extension-manage", "extension-describe", "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-describe", "package-reload", "package-doctor", "package-catalog", "package-adopt", "package-adopt-all", "package-activate", "package-deactivate", "package", "install", "upgrade", "create", "copy", "focus", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "context", "ctx", "get", "search", "history", "history-redact", "history-repair", "history-compact", "schema", "activity", "restore", "update", "update-many", "close", "close-many", "delete", "append", "comments", "plan", "notes", "learnings", "files", "docs", "deps", "test", "test-all", "telemetry", "stats", "health", "validate", "gc", "contracts", "claim", "release", "start-task", "pause-task", "close-task"];
 /**
  * Restricts pm tool action values accepted by command, SDK, and storage contracts.
  */

package/dist/sdk/cli-contracts/enum-contracts.js

@@ -4,7 +4,7 @@
  * Defines SDK command-contract metadata for Enum Contracts.
  */
 
-!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]="6e9dcc75-46f7-5c23-acca-091787a413df")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="7cc4ad23-817c-5a14-9ed1-ab73f91718bf")}catch(e){}}();
 import { KNOWN_EXTENSION_CAPABILITIES, KNOWN_EXTENSION_POLICY_MODES, KNOWN_EXTENSION_POLICY_SURFACES, KNOWN_EXTENSION_SANDBOX_PROFILES, KNOWN_EXTENSION_SERVICE_NAMES, KNOWN_EXTENSION_TRUST_MODES, } from "../../core/extensions/extension-types.js";
 export const PM_EXTENSION_CAPABILITY_CONTRACTS = [...KNOWN_EXTENSION_CAPABILITIES];
 export const PM_EXTENSION_SERVICE_NAME_CONTRACTS = [...KNOWN_EXTENSION_SERVICE_NAMES];
@@ -83,6 +83,7 @@ export const PM_TOOL_ACTIONS = [
     "extension-uninstall",
     "extension-explore",
     "extension-manage",
+    "extension-describe",
     "extension-reload",
     "extension-doctor",
     "extension-catalog",
@@ -96,6 +97,7 @@ export const PM_TOOL_ACTIONS = [
     "package-uninstall",
     "package-explore",
     "package-manage",
+    "package-describe",
     "package-reload",
     "package-doctor",
     "package-catalog",
@@ -187,4 +189,4 @@ export function isPmExtensionPolicySurfaceContract(value) {
     return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value);
 }
 //# sourceMappingURL=enum-contracts.js.map
-//# debugId=6e9dcc75-46f7-5c23-acca-091787a413df
+//# debugId=7cc4ad23-817c-5a14-9ed1-ab73f91718bf

package/dist/sdk/cli-contracts/enum-contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"enum-contracts.js","sources":["sdk/cli-contracts/enum-contracts.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/cli-contracts/enum-contracts\n *\n * Defines SDK command-contract metadata for Enum Contracts.\n */\nimport {\n  KNOWN_EXTENSION_CAPABILITIES,\n  KNOWN_EXTENSION_POLICY_MODES,\n  KNOWN_EXTENSION_POLICY_SURFACES,\n  KNOWN_EXTENSION_SANDBOX_PROFILES,\n  KNOWN_EXTENSION_SERVICE_NAMES,\n  KNOWN_EXTENSION_TRUST_MODES,\n} from \"../../core/extensions/extension-types.js\";\n\nexport const PM_EXTENSION_CAPABILITY_CONTRACTS = [...KNOWN_EXTENSION_CAPABILITIES] as const;\n\n/**\n * Restricts pm extension capability contract values accepted by command, SDK, and storage contracts.\n */\nexport type PmExtensionCapabilityContract = (typeof PM_EXTENSION_CAPABILITY_CONTRACTS)[number];\n\nexport const PM_EXTENSION_SERVICE_NAME_CONTRACTS = [...KNOWN_EXTENSION_SERVICE_NAMES] as const;\n\n/**\n * Restricts pm extension service name contract values accepted by command, SDK, and storage contracts.\n */\nexport type PmExtensionServiceNameContract = (typeof PM_EXTENSION_SERVICE_NAME_CONTRACTS)[number];\n\nexport const PM_EXTENSION_POLICY_MODE_CONTRACTS = [...KNOWN_EXTENSION_POLICY_MODES] as const;\n/**\n * Restricts pm extension policy mode contract values accepted by command, SDK, and storage contracts.\n */\nexport type PmExtensionPolicyModeContract = (typeof PM_EXTENSION_POLICY_MODE_CONTRACTS)[number];\nexport const PM_EXTENSION_TRUST_MODE_CONTRACTS = [...KNOWN_EXTENSION_TRUST_MODES] as const;\n/**\n * Restricts pm extension trust mode contract values accepted by command, SDK, and storage contracts.\n */\nexport type PmExtensionTrustModeContract = (typeof PM_EXTENSION_TRUST_MODE_CONTRACTS)[number];\nexport const PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS = [...KNOWN_EXTENSION_SANDBOX_PROFILES] as const;\n/**\n * Restricts pm extension sandbox profile contract values accepted by command, SDK, and storage contracts.\n */\nexport type PmExtensionSandboxProfileContract = (typeof PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS)[number];\n\nexport const PM_EXTENSION_POLICY_SURFACE_CONTRACTS = [...KNOWN_EXTENSION_POLICY_SURFACES] as const;\n/**\n * Restricts pm extension policy surface contract values accepted by command, SDK, and storage contracts.\n */\nexport type PmExtensionPolicySurfaceContract = (typeof PM_EXTENSION_POLICY_SURFACE_CONTRACTS)[number];\n\nexport const PM_CORE_COMMAND_NAMES = [\n  \"init\",\n  \"config\",\n  \"extension\",\n  \"package\",\n  \"packages\",\n  \"install\",\n  \"upgrade\",\n  \"create\",\n  \"copy\",\n  \"focus\",\n  \"list\",\n  \"list-all\",\n  \"list-draft\",\n  \"list-open\",\n  \"list-in-progress\",\n  \"list-blocked\",\n  \"list-closed\",\n  \"list-canceled\",\n  \"aggregate\",\n  \"context\",\n  \"ctx\",\n  \"get\",\n  \"search\",\n  \"eval\",\n  \"history\",\n  \"history-redact\",\n  \"history-repair\",\n  \"history-compact\",\n  \"schema\",\n  \"activity\",\n  \"restore\",\n  \"update\",\n  \"update-many\",\n  \"close\",\n  \"close-many\",\n  \"delete\",\n  \"append\",\n  \"comments\",\n  \"notes\",\n  \"learnings\",\n  \"files\",\n  \"docs\",\n  \"deps\",\n  \"plan\",\n  \"test\",\n  \"test-all\",\n  \"telemetry\",\n  \"stats\",\n  \"health\",\n  \"validate\",\n  \"gc\",\n  \"contracts\",\n  \"claim\",\n  \"release\",\n  \"start-task\",\n  \"pause-task\",\n  \"close-task\",\n  \"meet\",\n  \"event\",\n  \"remind\",\n  \"help\",\n] as const;\n\nexport const PM_TOOL_ACTIONS = [\n  \"init\",\n  \"config\",\n  \"extension-init\",\n  \"extension-install\",\n  \"extension-uninstall\",\n  \"extension-explore\",\n  \"extension-manage\",\n  \"extension-reload\",\n  \"extension-doctor\",\n  \"extension-catalog\",\n  \"extension-adopt\",\n  \"extension-adopt-all\",\n  \"extension-activate\",\n  \"extension-deactivate\",\n  \"extension\",\n  \"package-init\",\n  \"package-install\",\n  \"package-uninstall\",\n  \"package-explore\",\n  \"package-manage\",\n  \"package-reload\",\n  \"package-doctor\",\n  \"package-catalog\",\n  \"package-adopt\",\n  \"package-adopt-all\",\n  \"package-activate\",\n  \"package-deactivate\",\n  \"package\",\n  \"install\",\n  \"upgrade\",\n  \"create\",\n  \"copy\",\n  \"focus\",\n  \"list\",\n  \"list-all\",\n  \"list-draft\",\n  \"list-open\",\n  \"list-in-progress\",\n  \"list-blocked\",\n  \"list-closed\",\n  \"list-canceled\",\n  \"aggregate\",\n  \"context\",\n  \"ctx\",\n  \"get\",\n  \"search\",\n  \"history\",\n  \"history-redact\",\n  \"history-repair\",\n  \"history-compact\",\n  \"schema\",\n  \"activity\",\n  \"restore\",\n  \"update\",\n  \"update-many\",\n  \"close\",\n  \"close-many\",\n  \"delete\",\n  \"append\",\n  \"comments\",\n  \"plan\",\n  \"notes\",\n  \"learnings\",\n  \"files\",\n  \"docs\",\n  \"deps\",\n  \"test\",\n  \"test-all\",\n  \"telemetry\",\n  \"stats\",\n  \"health\",\n  \"validate\",\n  \"gc\",\n  \"contracts\",\n  \"claim\",\n  \"release\",\n  \"start-task\",\n  \"pause-task\",\n  \"close-task\",\n] as const;\n\n/**\n * Restricts pm tool action values accepted by command, SDK, and storage contracts.\n */\nexport type PmToolAction = (typeof PM_TOOL_ACTIONS)[number];\n\n/**\n * Implements check whether pm tool action for the public runtime surface of this module.\n */\nexport function isPmToolAction(value: string): value is PmToolAction {\n  return PM_TOOL_ACTIONS.includes(value as PmToolAction);\n}\n\n/**\n * Implements check whether pm extension capability contract for the public runtime surface of this module.\n */\nexport function isPmExtensionCapabilityContract(value: string): value is PmExtensionCapabilityContract {\n  return PM_EXTENSION_CAPABILITY_CONTRACTS.includes(value as PmExtensionCapabilityContract);\n}\n\n/**\n * Implements check whether pm extension service name contract for the public runtime surface of this module.\n */\nexport function isPmExtensionServiceNameContract(value: string): value is PmExtensionServiceNameContract {\n  return PM_EXTENSION_SERVICE_NAME_CONTRACTS.includes(value as PmExtensionServiceNameContract);\n}\n\n/**\n * Implements check whether pm extension policy mode contract for the public runtime surface of this module.\n */\nexport function isPmExtensionPolicyModeContract(value: string): value is PmExtensionPolicyModeContract {\n  return PM_EXTENSION_POLICY_MODE_CONTRACTS.includes(value as PmExtensionPolicyModeContract);\n}\n\n/**\n * Implements check whether pm extension policy surface contract for the public runtime surface of this module.\n */\nexport function isPmExtensionPolicySurfaceContract(value: string): value is PmExtensionPolicySurfaceContract {\n  return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value as PmExtensionPolicySurfaceContract);\n}\n"],"names":[],"mappings":"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","debugId":"6e9dcc75-46f7-5c23-acca-091787a413df"}
+{"version":3,"file":"enum-contracts.js","sources":["sdk/cli-contracts/enum-contracts.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/cli-contracts/enum-contracts\n *\n * Defines SDK command-contract metadata for Enum Contracts.\n */\nimport {\n  KNOWN_EXTENSION_CAPABILITIES,\n  KNOWN_EXTENSION_POLICY_MODES,\n  KNOWN_EXTENSION_POLICY_SURFACES,\n  KNOWN_EXTENSION_SANDBOX_PROFILES,\n  KNOWN_EXTENSION_SERVICE_NAMES,\n  KNOWN_EXTENSION_TRUST_MODES,\n} from \"../../core/extensions/extension-types.js\";\n\nexport const PM_EXTENSION_CAPABILITY_CONTRACTS = [...KNOWN_EXTENSION_CAPABILITIES] as const;\n\n/**\n * Restricts pm extension capability contract values accepted by command, SDK, and storage contracts.\n */\nexport type PmExtensionCapabilityContract = (typeof PM_EXTENSION_CAPABILITY_CONTRACTS)[number];\n\nexport const PM_EXTENSION_SERVICE_NAME_CONTRACTS = [...KNOWN_EXTENSION_SERVICE_NAMES] as const;\n\n/**\n * Restricts pm extension service name contract values accepted by command, SDK, and storage contracts.\n */\nexport type PmExtensionServiceNameContract = (typeof PM_EXTENSION_SERVICE_NAME_CONTRACTS)[number];\n\nexport const PM_EXTENSION_POLICY_MODE_CONTRACTS = [...KNOWN_EXTENSION_POLICY_MODES] as const;\n/**\n * Restricts pm extension policy mode contract values accepted by command, SDK, and storage contracts.\n */\nexport type PmExtensionPolicyModeContract = (typeof PM_EXTENSION_POLICY_MODE_CONTRACTS)[number];\nexport const PM_EXTENSION_TRUST_MODE_CONTRACTS = [...KNOWN_EXTENSION_TRUST_MODES] as const;\n/**\n * Restricts pm extension trust mode contract values accepted by command, SDK, and storage contracts.\n */\nexport type PmExtensionTrustModeContract = (typeof PM_EXTENSION_TRUST_MODE_CONTRACTS)[number];\nexport const PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS = [...KNOWN_EXTENSION_SANDBOX_PROFILES] as const;\n/**\n * Restricts pm extension sandbox profile contract values accepted by command, SDK, and storage contracts.\n */\nexport type PmExtensionSandboxProfileContract = (typeof PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS)[number];\n\nexport const PM_EXTENSION_POLICY_SURFACE_CONTRACTS = [...KNOWN_EXTENSION_POLICY_SURFACES] as const;\n/**\n * Restricts pm extension policy surface contract values accepted by command, SDK, and storage contracts.\n */\nexport type PmExtensionPolicySurfaceContract = (typeof PM_EXTENSION_POLICY_SURFACE_CONTRACTS)[number];\n\nexport const PM_CORE_COMMAND_NAMES = [\n  \"init\",\n  \"config\",\n  \"extension\",\n  \"package\",\n  \"packages\",\n  \"install\",\n  \"upgrade\",\n  \"create\",\n  \"copy\",\n  \"focus\",\n  \"list\",\n  \"list-all\",\n  \"list-draft\",\n  \"list-open\",\n  \"list-in-progress\",\n  \"list-blocked\",\n  \"list-closed\",\n  \"list-canceled\",\n  \"aggregate\",\n  \"context\",\n  \"ctx\",\n  \"get\",\n  \"search\",\n  \"eval\",\n  \"history\",\n  \"history-redact\",\n  \"history-repair\",\n  \"history-compact\",\n  \"schema\",\n  \"activity\",\n  \"restore\",\n  \"update\",\n  \"update-many\",\n  \"close\",\n  \"close-many\",\n  \"delete\",\n  \"append\",\n  \"comments\",\n  \"notes\",\n  \"learnings\",\n  \"files\",\n  \"docs\",\n  \"deps\",\n  \"plan\",\n  \"test\",\n  \"test-all\",\n  \"telemetry\",\n  \"stats\",\n  \"health\",\n  \"validate\",\n  \"gc\",\n  \"contracts\",\n  \"claim\",\n  \"release\",\n  \"start-task\",\n  \"pause-task\",\n  \"close-task\",\n  \"meet\",\n  \"event\",\n  \"remind\",\n  \"help\",\n] as const;\n\nexport const PM_TOOL_ACTIONS = [\n  \"init\",\n  \"config\",\n  \"extension-init\",\n  \"extension-install\",\n  \"extension-uninstall\",\n  \"extension-explore\",\n  \"extension-manage\",\n  \"extension-describe\",\n  \"extension-reload\",\n  \"extension-doctor\",\n  \"extension-catalog\",\n  \"extension-adopt\",\n  \"extension-adopt-all\",\n  \"extension-activate\",\n  \"extension-deactivate\",\n  \"extension\",\n  \"package-init\",\n  \"package-install\",\n  \"package-uninstall\",\n  \"package-explore\",\n  \"package-manage\",\n  \"package-describe\",\n  \"package-reload\",\n  \"package-doctor\",\n  \"package-catalog\",\n  \"package-adopt\",\n  \"package-adopt-all\",\n  \"package-activate\",\n  \"package-deactivate\",\n  \"package\",\n  \"install\",\n  \"upgrade\",\n  \"create\",\n  \"copy\",\n  \"focus\",\n  \"list\",\n  \"list-all\",\n  \"list-draft\",\n  \"list-open\",\n  \"list-in-progress\",\n  \"list-blocked\",\n  \"list-closed\",\n  \"list-canceled\",\n  \"aggregate\",\n  \"context\",\n  \"ctx\",\n  \"get\",\n  \"search\",\n  \"history\",\n  \"history-redact\",\n  \"history-repair\",\n  \"history-compact\",\n  \"schema\",\n  \"activity\",\n  \"restore\",\n  \"update\",\n  \"update-many\",\n  \"close\",\n  \"close-many\",\n  \"delete\",\n  \"append\",\n  \"comments\",\n  \"plan\",\n  \"notes\",\n  \"learnings\",\n  \"files\",\n  \"docs\",\n  \"deps\",\n  \"test\",\n  \"test-all\",\n  \"telemetry\",\n  \"stats\",\n  \"health\",\n  \"validate\",\n  \"gc\",\n  \"contracts\",\n  \"claim\",\n  \"release\",\n  \"start-task\",\n  \"pause-task\",\n  \"close-task\",\n] as const;\n\n/**\n * Restricts pm tool action values accepted by command, SDK, and storage contracts.\n */\nexport type PmToolAction = (typeof PM_TOOL_ACTIONS)[number];\n\n/**\n * Implements check whether pm tool action for the public runtime surface of this module.\n */\nexport function isPmToolAction(value: string): value is PmToolAction {\n  return PM_TOOL_ACTIONS.includes(value as PmToolAction);\n}\n\n/**\n * Implements check whether pm extension capability contract for the public runtime surface of this module.\n */\nexport function isPmExtensionCapabilityContract(value: string): value is PmExtensionCapabilityContract {\n  return PM_EXTENSION_CAPABILITY_CONTRACTS.includes(value as PmExtensionCapabilityContract);\n}\n\n/**\n * Implements check whether pm extension service name contract for the public runtime surface of this module.\n */\nexport function isPmExtensionServiceNameContract(value: string): value is PmExtensionServiceNameContract {\n  return PM_EXTENSION_SERVICE_NAME_CONTRACTS.includes(value as PmExtensionServiceNameContract);\n}\n\n/**\n * Implements check whether pm extension policy mode contract for the public runtime surface of this module.\n */\nexport function isPmExtensionPolicyModeContract(value: string): value is PmExtensionPolicyModeContract {\n  return PM_EXTENSION_POLICY_MODE_CONTRACTS.includes(value as PmExtensionPolicyModeContract);\n}\n\n/**\n * Implements check whether pm extension policy surface contract for the public runtime surface of this module.\n */\nexport function isPmExtensionPolicySurfaceContract(value: string): value is PmExtensionPolicySurfaceContract {\n  return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value as PmExtensionPolicySurfaceContract);\n}\n"],"names":[],"mappings":"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","debugId":"7cc4ad23-817c-5a14-9ed1-ab73f91718bf"}

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

@@ -69,10 +69,12 @@ export declare const PLAN_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 EXTENSION_SCOPE_FLAG_CONTRACTS: CliFlagContract[];
 export declare const EXTENSION_INIT_FLAG_CONTRACTS: CliFlagContract[];
 export declare const EXTENSION_INSTALL_FLAG_CONTRACTS: CliFlagContract[];
 export declare const EXTENSION_UNINSTALL_FLAG_CONTRACTS: CliFlagContract[];
 export declare const EXTENSION_EXPLORE_FLAG_CONTRACTS: CliFlagContract[];
+export declare const EXTENSION_DESCRIBE_FLAG_CONTRACTS: CliFlagContract[];
 export declare const EXTENSION_ADOPT_ALL_FLAG_CONTRACTS: CliFlagContract[];
 export declare const EXTENSION_ACTIVATE_FLAG_CONTRACTS: CliFlagContract[];
 export declare const EXTENSION_DEACTIVATE_FLAG_CONTRACTS: CliFlagContract[];

package/dist/sdk/cli-contracts.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1ada9f25-a3a6-5209-acb9-f814c9c8c447")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9a1b19ca-247e-5b4a-a916-b17be9b5c95d")}catch(e){}}();
 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, readFirstValueFromCommanderOptions, 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";
 // PM_* enum/guard contracts and the bulk tool-parameter property/metadata data
@@ -415,11 +415,13 @@ export const CONFIG_FLAG_CONTRACTS = [
 export const EXTENSION_FLAG_CONTRACTS = [
     { flag: "--init" },
     { flag: "--scaffold" },
+    { flag: "--capability" },
     { flag: "--install" },
     { flag: "--uninstall" },
     { flag: "--explore" },
     { flag: "--list" },
     { flag: "--manage" },
+    { flag: "--describe" },
     { flag: "--reload" },
     { flag: "--watch" },
     { flag: "--doctor" },
@@ -441,11 +443,15 @@ export const EXTENSION_FLAG_CONTRACTS = [
     { flag: "--strict-exit" },
     { flag: "--fail-on-warn" },
 ];
-export const EXTENSION_INIT_FLAG_CONTRACTS = [
+export const EXTENSION_SCOPE_FLAG_CONTRACTS = [
     { flag: "--project" },
     { flag: "--local" },
     { flag: "--global" },
 ];
+export const EXTENSION_INIT_FLAG_CONTRACTS = [
+    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
+    { flag: "--capability" },
+];
 export const EXTENSION_INSTALL_FLAG_CONTRACTS = [
     { flag: "--project" },
     { flag: "--local" },
@@ -454,22 +460,23 @@ export const EXTENSION_INSTALL_FLAG_CONTRACTS = [
     { flag: "--github" },
     { flag: "--ref" },
 ];
-export const EXTENSION_UNINSTALL_FLAG_CONTRACTS = EXTENSION_INIT_FLAG_CONTRACTS;
-export const EXTENSION_EXPLORE_FLAG_CONTRACTS = EXTENSION_INIT_FLAG_CONTRACTS;
-export const EXTENSION_ADOPT_ALL_FLAG_CONTRACTS = EXTENSION_INIT_FLAG_CONTRACTS;
-export const EXTENSION_ACTIVATE_FLAG_CONTRACTS = EXTENSION_INIT_FLAG_CONTRACTS;
-export const EXTENSION_DEACTIVATE_FLAG_CONTRACTS = EXTENSION_INIT_FLAG_CONTRACTS;
+export const EXTENSION_UNINSTALL_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
+export const EXTENSION_EXPLORE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
+export const EXTENSION_DESCRIBE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
+export const EXTENSION_ADOPT_ALL_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
+export const EXTENSION_ACTIVATE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
+export const EXTENSION_DEACTIVATE_FLAG_CONTRACTS = EXTENSION_SCOPE_FLAG_CONTRACTS;
 export const EXTENSION_MANAGE_FLAG_CONTRACTS = [
-    ...EXTENSION_INIT_FLAG_CONTRACTS,
+    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
     { flag: "--runtime-probe" },
     { flag: "--fix-managed-state" },
 ];
 export const EXTENSION_RELOAD_FLAG_CONTRACTS = [
-    ...EXTENSION_INIT_FLAG_CONTRACTS,
+    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
     { flag: "--watch" },
 ];
 export const EXTENSION_DOCTOR_FLAG_CONTRACTS = [
-    ...EXTENSION_INIT_FLAG_CONTRACTS,
+    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
     { flag: "--detail" },
     { flag: "--trace" },
     { flag: "--fix-managed-state" },
@@ -477,11 +484,11 @@ export const EXTENSION_DOCTOR_FLAG_CONTRACTS = [
     { flag: "--fail-on-warn" },
 ];
 export const EXTENSION_CATALOG_FLAG_CONTRACTS = [
-    ...EXTENSION_INIT_FLAG_CONTRACTS,
+    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
     { flag: "--fields", list: true },
 ];
 export const EXTENSION_ADOPT_FLAG_CONTRACTS = [
-    ...EXTENSION_INIT_FLAG_CONTRACTS,
+    ...EXTENSION_SCOPE_FLAG_CONTRACTS,
     { flag: "--gh" },
     { flag: "--github" },
     { flag: "--ref" },
@@ -1363,6 +1370,8 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
                 return withSubcommandGlobalFlags(EXTENSION_EXPLORE_FLAG_CONTRACTS);
             case "manage":
                 return withSubcommandGlobalFlags(EXTENSION_MANAGE_FLAG_CONTRACTS);
+            case "describe":
+                return withSubcommandGlobalFlags(EXTENSION_DESCRIBE_FLAG_CONTRACTS);
             case "reload":
                 return withSubcommandGlobalFlags(EXTENSION_RELOAD_FLAG_CONTRACTS);
             case "doctor":
@@ -1619,6 +1628,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     "extension-uninstall": { required: ["target"], optional: ["scope"] },
     "extension-explore": { optional: ["scope"] },
     "extension-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
+    "extension-describe": { optional: ["target", "scope"] },
     "extension-reload": { optional: ["scope", "watch"] },
     "extension-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
     "extension-catalog": { optional: ["scope", "fields"] },
@@ -1637,6 +1647,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "uninstall",
             "explore",
             "manage",
+            "describe",
             "reload",
             "doctor",
             "catalog",
@@ -1661,6 +1672,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     "package-uninstall": { required: ["target"], optional: ["scope"] },
     "package-explore": { optional: ["scope"] },
     "package-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
+    "package-describe": { optional: ["target", "scope"] },
     "package-reload": { optional: ["scope", "watch"] },
     "package-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
     "package-catalog": { optional: ["scope", "fields"] },
@@ -1679,6 +1691,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "uninstall",
             "explore",
             "manage",
+            "describe",
             "reload",
             "doctor",
             "catalog",
@@ -2270,4 +2283,4 @@ export const _testOnlyCliContracts = {
     withFlagAliasMetadata,
 };
 //# sourceMappingURL=cli-contracts.js.map
-//# debugId=1ada9f25-a3a6-5209-acb9-f814c9c8c447
+//# debugId=9a1b19ca-247e-5b4a-a916-b17be9b5c95d