@unbrained/pm-cli 2026.8.26 → 2026.8.27

package/packages/pm-beads/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-beads",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "First-party pm package for importing Beads JSONL records.",

package/packages/pm-calendar/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-calendar",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "First-party pm package for calendar and agenda views.",

package/packages/pm-command-kit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-command-kit",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "First-party pm exemplar package for the commands capability: registerCommand, registerFlags, and registerParser.",

package/packages/pm-digital-twin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-digital-twin",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "Beyond-PM exemplar: a temporal production-facility digital twin built entirely on public pm SDK and extension primitives.",

package/packages/pm-governance-audit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-governance-audit",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "First-party pm package for governance audit and normalization workflows.",

package/packages/pm-guide-shell/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-guide-shell",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "First-party pm package for guide and shell completion workflows.",

package/packages/pm-kanban/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-kanban",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "First-party pm archetype package: a complete Kanban continuous-flow profile built on public SDK primitives.",

package/packages/pm-lifecycle-hooks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-lifecycle-hooks",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "First-party pm package demonstrating safe lifecycle hook registration.",

package/packages/pm-linked-test-adapters/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-linked-test-adapters",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "First-party pm package for optional linked-test run management adapters and reporters.",

package/packages/pm-search-advanced/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-search-advanced",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "First-party pm package for semantic, hybrid, and reindex search workflows.",

package/packages/pm-templates/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-templates",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "First-party pm package for reusable create templates.",

package/packages/pm-todos/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-todos",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "First-party pm package for Todo markdown import and export.",

package/packages/pm-vcs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-vcs-sdk-exemplar",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "private": true,
   "type": "module",
   "description": "Beyond-PM exemplar: a VCS-style changeset workflow built entirely on public pm SDK and extension primitives.",

package/plugins/pm-claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pm-claude",
   "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents (coordinator, delivery-chain, triage, verification), hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and full git-based project management without leaving Claude Code.",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "author": {
     "name": "unbrained",
     "url": "https://github.com/unbraind/pm-cli"

package/plugins/pm-codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-codex",
-  "version": "2026.8.26",
+  "version": "2026.8.27",
   "description": "Native Codex integration for pm-cli with bundled MCP tools, skills, commands, and agent workflows.",
   "author": {
     "name": "unbrained",

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1801,
+    "covered_symbols": 1802,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1802
+    "required_symbols": 1803
   },
   "breaking_acknowledgements": [
     {
@@ -1263,6 +1263,59 @@
       ],
       "package_version": "2026.8.25",
       "reason": "Covariant return refinement: existing metadata interface remains source-compatible while the validator now exposes endpoints it already requires at runtime"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PM_MCP_APPS_SERVER_CAPABILITY",
+        "signature ./sdk:PM_MCP_SKILL_LIMITS",
+        "signature ./sdk:PmMcpSkillRegistry",
+        "signature ./sdk:PmMcpSkillResource",
+        "signature ./sdk:ReadPmMcpSkillResourceResult"
+      ],
+      "package_version": "2026.8.26",
+      "reason": "Align the new unshipped MCP Skills draft contracts with the exact SEP-2640 digest, directory-read, and resource-limit schema before first publication."
+    },
+    {
+      "changes": [
+        "signature ./sdk:ReadPmMcpSkillDirectoryResult"
+      ],
+      "package_version": "2026.8.26",
+      "reason": "Complete the unmerged Skills directory pagination contract with required hasMore metadata"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PM_CLI_GRAMMAR_CONTRACT",
+        "signature ./sdk:PM_CLI_SHARED_VERBS",
+        "signature ./sdk/contracts:PM_CLI_GRAMMAR_CONTRACT",
+        "signature ./sdk/contracts:PM_CLI_SHARED_VERBS"
+      ],
+      "package_version": "2026.8.26",
+      "reason": "pm-tnud intentionally adds the canonical package upgrade verb to the public CLI grammar contract"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmToolAction",
+        "signature ./sdk/contracts:PmToolAction"
+      ],
+      "package_version": "2026.8.26",
+      "reason": "Adds canonical package-upgrade action while retaining deprecated upgrade compatibility routing"
+    },
+    {
+      "changes": [
+        "signature ./sdk:UpgradeCommandOptions",
+        "signature ./sdk/governance:UpgradeCommandOptions",
+        "signature ./sdk/runtime:UpgradeCommandOptions"
+      ],
+      "package_version": "2026.8.26",
+      "reason": "Adds structured upgrade scope while preserving project local and global boolean compatibility"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmClosedDomainContract",
+        "signature ./sdk/contracts:PmClosedDomainContract"
+      ],
+      "package_version": "2026.8.26",
+      "reason": "Add a domain-specific package upgrade mode-conflict refusal code so SDK consumers can distinguish lifecycle validation from query projection validation."
     }
   ],
   "entrypoints": {
@@ -2109,6 +2162,12 @@
           "name": "assertParentReferenceIsNotSelf",
           "signature": "(itemId: string, parentId: string, prefix: string) => void | calls: (itemId: string, parentId: string, prefix: string) => void"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "assertPmMcpSkillsCapability",
+          "signature": "(context: PmMcpRequestContext, directoryRead?: boolean) => void | calls: (context: PmMcpRequestContext, directoryRead?: boolean) => void"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -4689,6 +4748,12 @@
           "name": "decodeReadOutputContinuationCursor",
           "signature": "(raw: string) => PmReadOutputCursorEnvelope | calls: (raw: string) => PmReadOutputCursorEnvelope"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "decoratePmMcpToolsWithApps",
+          "signature": "<Tool extends { name: string; _meta?: Record<string, unknown>; }>(tools: readonly Tool[]) => Tool[] | calls: <Tool extends { name: string; _meta?: Record<string, unknown>; }>(tools: readonly Tool[]) => Tool[]"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -6531,6 +6596,12 @@
           "name": "findInstalledNpmPackageCandidate",
           "signature": "(packageName: string, cwd?: string) => Promise<InstalledNpmPackageCandidate | null> | calls: (packageName: string, cwd?: string) => Promise<InstalledNpmPackageCandidate | null>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "findPmMcpAppByUri",
+          "signature": "(uri: string) => PmMcpAppContract | undefined | calls: (uri: string) => PmMcpAppContract | undefined"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -7233,6 +7304,12 @@
           "name": "hasMcpClientExtension",
           "signature": "(requestContext: PmMcpRequestContext, extension: string) => boolean | calls: (requestContext: PmMcpRequestContext, extension: string) => boolean"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "hasPmMcpAppsCapability",
+          "signature": "(context: PmMcpRequestContext) => boolean | calls: (context: PmMcpRequestContext) => boolean"
+        },
         {
           "classification": "contract_data",
           "kind": "function",
@@ -8607,6 +8684,18 @@
           "name": "listPmFlagSpellingInventory",
           "signature": "() => readonly PmFlagSpellingInventoryEntry[] | calls: () => readonly PmFlagSpellingInventoryEntry[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ListPmMcpSkillsOptions",
+          "signature": "export interface ListPmMcpSkillsOptions { cursor?: string; limit?: number; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ListPmMcpSkillsResult",
+          "signature": "export interface ListPmMcpSkillsResult { skills: PmMcpSkillDescriptor[]; nextCursor?: string; hasMore: boolean; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8739,6 +8828,12 @@
           "name": "loadMutationCheckpoint",
           "signature": "(pmRoot: string, subdir: string, rawCheckpointId: string, schemaVersion: number) => Promise<LoadedMutationCheckpoint> | calls: (pmRoot: string, subdir: string, rawCheckpointId: string, schemaVersion: number) => Promise<LoadedMutationCheckpoint>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "LoadPmMcpSkillsOptions",
+          "signature": "export interface LoadPmMcpSkillsOptions { packageRoot: string; workspaceRoot?: string; packageVersion: string; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -10171,7 +10266,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_CLI_GRAMMAR_CONTRACT",
-          "signature": "{ readonly nouns: readonly [\"item\", \"list\", \"context\", \"search\", \"graph\", \"history\", \"workspace\", \"package\", \"ops\", \"plan\", \"contracts\", \"help\"]; readonly shared_verbs: readonly [\"activate\", \"add\", \"adopt\", \"adopt-all\", \"catalog\", \"compact\", \"complete\", \"create\", \"deactivate\", \"delete\", \"describe\", \"doctor\", \"edit\", \"explore\", \"import\", \"init\", \"inspect\", \"install\", \"list\", \"manage\", \"migrate\", \"mutate\", \"read\", \"redact\", \"reload\", \"remove\", \"reopen\", \"repair\", \"restore\", \"run\", \"show\", \"uninstall\", \"verify\"]; readonly scope_before_verb: true; readonly visible_top_level_ceiling: 69; readonly ceiling_raise_requires_pm_item: true; readonly positional_shape_budget: 21; }"
+          "signature": "{ readonly nouns: readonly [\"item\", \"list\", \"context\", \"search\", \"graph\", \"history\", \"workspace\", \"package\", \"ops\", \"plan\", \"contracts\", \"help\"]; readonly shared_verbs: readonly [\"activate\", \"add\", \"adopt\", \"adopt-all\", \"catalog\", \"compact\", \"complete\", \"create\", \"deactivate\", \"delete\", \"describe\", \"doctor\", \"edit\", \"explore\", \"import\", \"init\", \"inspect\", \"install\", \"list\", \"manage\", \"migrate\", \"mutate\", \"read\", \"redact\", \"reload\", \"remove\", \"reopen\", \"repair\", \"restore\", \"run\", \"show\", \"uninstall\", \"upgrade\", \"verify\"]; readonly scope_before_verb: true; readonly visible_top_level_ceiling: 69; readonly ceiling_raise_requires_pm_item: true; readonly positional_shape_budget: 21; }"
         },
         {
           "classification": "contract_data",
@@ -10189,7 +10284,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_CLI_SHARED_VERBS",
-          "signature": "readonly [\"activate\", \"add\", \"adopt\", \"adopt-all\", \"catalog\", \"compact\", \"complete\", \"create\", \"deactivate\", \"delete\", \"describe\", \"doctor\", \"edit\", \"explore\", \"import\", \"init\", \"inspect\", \"install\", \"list\", \"manage\", \"migrate\", \"mutate\", \"read\", \"redact\", \"reload\", \"remove\", \"reopen\", \"repair\", \"restore\", \"run\", \"show\", \"uninstall\", \"verify\"]"
+          "signature": "readonly [\"activate\", \"add\", \"adopt\", \"adopt-all\", \"catalog\", \"compact\", \"complete\", \"create\", \"deactivate\", \"delete\", \"describe\", \"doctor\", \"edit\", \"explore\", \"import\", \"init\", \"inspect\", \"install\", \"list\", \"manage\", \"migrate\", \"mutate\", \"read\", \"redact\", \"reload\", \"remove\", \"reopen\", \"repair\", \"restore\", \"run\", \"show\", \"uninstall\", \"upgrade\", \"verify\"]"
         },
         {
           "classification": "contract_data",
@@ -10407,6 +10502,36 @@
           "name": "PM_ITEM_ACTION_SUBCOMMANDS",
           "signature": "readonly [\"reopen\"]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_MCP_APP_CONTRACTS",
+          "signature": "readonly PmMcpAppContract[]"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_MCP_APP_MIME_TYPE",
+          "signature": "\"text/html;profile=mcp-app\""
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_MCP_APPS_EXTENSION",
+          "signature": "\"io.modelcontextprotocol/ui\""
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_MCP_APPS_SERVER_CAPABILITY",
+          "signature": "Readonly<{ specVersion: \"2026-01-26\"; mimeTypes: \"text/html;profile=mcp-app\"[]; }>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_MCP_APPS_SPEC_VERSION",
+          "signature": "\"2026-01-26\""
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -10455,6 +10580,30 @@
           "name": "PM_MCP_RESOURCE_CONTRACTS",
           "signature": "readonly PmMcpResourceContract[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_MCP_SKILL_LIMITS",
+          "signature": "Readonly<{ maxFilesPerSkill: 512; maxFileBytes: number; maxSkillBytes: number; defaultPageSize: 20; maxPageSize: 100; }>"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_MCP_SKILLS_DRAFT_REVISION",
+          "signature": "\"SEP-2640@a3e147ca2710f68214247aecc729731ee1ae8d03\""
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_MCP_SKILLS_EXTENSION",
+          "signature": "\"io.modelcontextprotocol/skills\""
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "PM_MCP_SKILLS_SERVER_CAPABILITY",
+          "signature": "Readonly<{ revision: \"SEP-2640@a3e147ca2710f68214247aecc729731ee1ae8d03\"; status: \"draft\"; directoryRead: true; }>"
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -10521,6 +10670,12 @@
           "name": "PM_PACKAGE_CONVENTIONAL_RESOURCE_ROOTS",
           "signature": "Readonly<Record<\"assets\" | \"docs\" | \"examples\" | \"extensions\" | \"prompts\", readonly string[]>>"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_PACKAGE_ONLY_ACTION_SUBCOMMANDS",
+          "signature": "readonly [\"upgrade\"]"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -10831,7 +10986,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmClosedDomainContract",
-          "signature": "export interface PmClosedDomainContract { probe_id: string; command: string; flag: string; rejected_value: string; refusal_args: readonly string[]; allowed_values: readonly string[]; suggested_retry_args: readonly string[]; error_code: \"projection_options_mutually_exclusive\" | \"unknown_context_intent\" | \"unknown_field_projection\"; allowed_values_required?: boolean; }"
+          "signature": "export interface PmClosedDomainContract { probe_id: string; command: string; flag: string; rejected_value: string; refusal_args: readonly string[]; allowed_values: readonly string[]; suggested_retry_args: readonly string[]; error_code: \"package_upgrade_modes_mutually_exclusive\" | \"projection_options_mutually_exclusive\" | \"unknown_context_intent\" | \"unknown_field_projection\"; allowed_values_required?: boolean; }"
         },
         {
           "classification": "contract_data",
@@ -11241,6 +11396,12 @@
           "name": "PmMcpAccessTokenClaims",
           "signature": "export interface PmMcpAccessTokenClaims { principal: string; issuer: string; audience: string | string[]; scopes: string[]; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmMcpAppContract",
+          "signature": "export interface PmMcpAppContract { id: \"context\" | \"graph\" | \"plan\" | \"assurance\" | \"operations\"; name: string; description: string; toolName: string; uri: string; toolMeta: McpUiToolMeta; resourceMeta: McpUiResourceMeta; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "class",
@@ -11427,6 +11588,30 @@
           "name": "PmMcpServerResultMetadata",
           "signature": "export interface PmMcpServerResultMetadata { _meta: { \"io.modelcontextprotocol/serverInfo\": PmMcpImplementation; [key: string]: unknown; }; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmMcpSkillDescriptor",
+          "signature": "export interface PmMcpSkillDescriptor { uri: string; frontmatter: Record<string, unknown>; resources: PmMcpSkillResource[]; _meta: { contractVersion: 1; extensionRevision: typeof PM_MCP_SKILLS_DRAFT_REVISION; origin: PmMcpSkillOrigin; packageVersion: string; protocolVersion: typeof PM_MCP_PROTOCOL_VERSION; trust: \"untrusted\"; estimatedTokens: number; }; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "PmMcpSkillOrigin",
+          "signature": "export type PmMcpSkillOrigin = \"package\" | \"workspace\";"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "class",
+          "name": "PmMcpSkillRegistry",
+          "signature": "export declare class PmMcpSkillRegistry { #private; private constructor(); static load(options: LoadPmMcpSkillsOptions): Promise<PmMcpSkillRegistry>; list(options?: ListPmMcpSkillsOptions): ListPmMcpSkillsResult; get(uri: string): PmMcpSkillDescriptor; read(uri: string): ReadPmMcpSkillResourceResult; readDirectory(uri: string, options?: ListPmMcpSkillsOptions): ReadPmMcpSkillDirectoryResult; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "PmMcpSkillResource",
+          "signature": "export interface PmMcpSkillResource { uri: string; digest: string; size: number; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "interface",
@@ -11929,7 +12114,7 @@
           "classification": "contract_data",
           "kind": "type",
           "name": "PmToolAction",
-          "signature": "export type PmToolAction = Exclude<PmCoreCommandName, PmCliOnlyToolAction | \"item\"> | PmExtensionPackageAction | PmItemAction;"
+          "signature": "export type PmToolAction = Exclude<PmCoreCommandName, PmCliOnlyToolAction | \"item\"> | PmExtensionPackageAction | PmPackageOnlyAction | PmItemAction;"
         },
         {
           "classification": "contract_data",
@@ -12699,6 +12884,18 @@
           "name": "readOutputSessionRemainingTokens",
           "signature": "(state: PmReadOutputSessionState) => number | calls: (state: PmReadOutputSessionState) => number"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ReadPmMcpSkillDirectoryResult",
+          "signature": "export interface ReadPmMcpSkillDirectoryResult { resources: Array<{ uri: string; name: string; mimeType: \"application/octet-stream\" | \"inode/directory\" | \"text/markdown\" | \"text/plain\"; }>; nextCursor?: string; hasMore: boolean; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ReadPmMcpSkillResourceResult",
+          "signature": "export interface ReadPmMcpSkillResourceResult { contents: Array<{ uri: string; mimeType: \"text/markdown\" | \"text/plain\"; text: string; _meta: { digest: string; origin: PmMcpSkillOrigin; trust: \"untrusted\"; }; } | { uri: string; mimeType: \"application/octet-stream\"; blob: string; _meta: { digest: string; origin: PmMcpSkillOrigin; trust: \"untrusted\"; }; }>; }"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -13791,6 +13988,12 @@
           "name": "renderPmFlagLexiconMarkdown",
           "signature": "() => string | calls: () => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "renderPmMcpAppHtml",
+          "signature": "(contract: PmMcpAppContract) => string | calls: (contract: PmMcpAppContract) => string"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -14559,6 +14762,12 @@
           "name": "resolveWorkspaceRelationshipKindRegistry",
           "signature": "() => RelationshipKindRegistry | calls: () => RelationshipKindRegistry"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveWorkspaceRoot",
+          "signature": "(pmRoot: string) => string | calls: (pmRoot: string) => string"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -16605,6 +16814,12 @@
           "name": "stripGlobalBootstrapTokens",
           "signature": "(argv: string[]) => string[] | calls: (argv: string[]) => string[]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "StructuredJsonValue",
+          "signature": "export type StructuredJsonValue = null | boolean | number | string | StructuredJsonValue[] | { [key: string]: StructuredJsonValue; };"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -17395,7 +17610,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "UpgradeCommandOptions",
-          "signature": "export interface UpgradeCommandOptions { dryRun?: boolean; cliOnly?: boolean; packagesOnly?: boolean; project?: boolean; local?: boolean; global?: boolean; repair?: boolean; tag?: string; packageName?: string; commandRunner?: UpgradeCommandRunner; }"
+          "signature": "export interface UpgradeCommandOptions { scope?: ExtensionScope; dryRun?: boolean; cliOnly?: boolean; packagesOnly?: boolean; project?: boolean; local?: boolean; global?: boolean; repair?: boolean; tag?: string; packageName?: string; commandRunner?: UpgradeCommandRunner; }"
         },
         {
           "classification": "supported",
@@ -20305,7 +20520,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_CLI_GRAMMAR_CONTRACT",
-          "signature": "{ readonly nouns: readonly [\"item\", \"list\", \"context\", \"search\", \"graph\", \"history\", \"workspace\", \"package\", \"ops\", \"plan\", \"contracts\", \"help\"]; readonly shared_verbs: readonly [\"activate\", \"add\", \"adopt\", \"adopt-all\", \"catalog\", \"compact\", \"complete\", \"create\", \"deactivate\", \"delete\", \"describe\", \"doctor\", \"edit\", \"explore\", \"import\", \"init\", \"inspect\", \"install\", \"list\", \"manage\", \"migrate\", \"mutate\", \"read\", \"redact\", \"reload\", \"remove\", \"reopen\", \"repair\", \"restore\", \"run\", \"show\", \"uninstall\", \"verify\"]; readonly scope_before_verb: true; readonly visible_top_level_ceiling: 69; readonly ceiling_raise_requires_pm_item: true; readonly positional_shape_budget: 21; }"
+          "signature": "{ readonly nouns: readonly [\"item\", \"list\", \"context\", \"search\", \"graph\", \"history\", \"workspace\", \"package\", \"ops\", \"plan\", \"contracts\", \"help\"]; readonly shared_verbs: readonly [\"activate\", \"add\", \"adopt\", \"adopt-all\", \"catalog\", \"compact\", \"complete\", \"create\", \"deactivate\", \"delete\", \"describe\", \"doctor\", \"edit\", \"explore\", \"import\", \"init\", \"inspect\", \"install\", \"list\", \"manage\", \"migrate\", \"mutate\", \"read\", \"redact\", \"reload\", \"remove\", \"reopen\", \"repair\", \"restore\", \"run\", \"show\", \"uninstall\", \"upgrade\", \"verify\"]; readonly scope_before_verb: true; readonly visible_top_level_ceiling: 69; readonly ceiling_raise_requires_pm_item: true; readonly positional_shape_budget: 21; }"
         },
         {
           "classification": "contract_data",
@@ -20323,7 +20538,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_CLI_SHARED_VERBS",
-          "signature": "readonly [\"activate\", \"add\", \"adopt\", \"adopt-all\", \"catalog\", \"compact\", \"complete\", \"create\", \"deactivate\", \"delete\", \"describe\", \"doctor\", \"edit\", \"explore\", \"import\", \"init\", \"inspect\", \"install\", \"list\", \"manage\", \"migrate\", \"mutate\", \"read\", \"redact\", \"reload\", \"remove\", \"reopen\", \"repair\", \"restore\", \"run\", \"show\", \"uninstall\", \"verify\"]"
+          "signature": "readonly [\"activate\", \"add\", \"adopt\", \"adopt-all\", \"catalog\", \"compact\", \"complete\", \"create\", \"deactivate\", \"delete\", \"describe\", \"doctor\", \"edit\", \"explore\", \"import\", \"init\", \"inspect\", \"install\", \"list\", \"manage\", \"migrate\", \"mutate\", \"read\", \"redact\", \"reload\", \"remove\", \"reopen\", \"repair\", \"restore\", \"run\", \"show\", \"uninstall\", \"upgrade\", \"verify\"]"
         },
         {
           "classification": "contract_data",
@@ -20487,6 +20702,12 @@
           "name": "PM_OUTPUT_ENVELOPE_KINDS",
           "signature": "readonly [\"mutation_receipt\", \"entity\", \"collection\", \"diagnostic\", \"stream\"]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_PACKAGE_ONLY_ACTION_SUBCOMMANDS",
+          "signature": "readonly [\"upgrade\"]"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -20641,7 +20862,7 @@
           "classification": "contract_data",
           "kind": "interface",
           "name": "PmClosedDomainContract",
-          "signature": "export interface PmClosedDomainContract { probe_id: string; command: string; flag: string; rejected_value: string; refusal_args: readonly string[]; allowed_values: readonly string[]; suggested_retry_args: readonly string[]; error_code: \"projection_options_mutually_exclusive\" | \"unknown_context_intent\" | \"unknown_field_projection\"; allowed_values_required?: boolean; }"
+          "signature": "export interface PmClosedDomainContract { probe_id: string; command: string; flag: string; rejected_value: string; refusal_args: readonly string[]; allowed_values: readonly string[]; suggested_retry_args: readonly string[]; error_code: \"package_upgrade_modes_mutually_exclusive\" | \"projection_options_mutually_exclusive\" | \"unknown_context_intent\" | \"unknown_field_projection\"; allowed_values_required?: boolean; }"
         },
         {
           "classification": "contract_data",
@@ -21151,7 +21372,7 @@
           "classification": "contract_data",
           "kind": "type",
           "name": "PmToolAction",
-          "signature": "export type PmToolAction = Exclude<PmCoreCommandName, PmCliOnlyToolAction | \"item\"> | PmExtensionPackageAction | PmItemAction;"
+          "signature": "export type PmToolAction = Exclude<PmCoreCommandName, PmCliOnlyToolAction | \"item\"> | PmExtensionPackageAction | PmPackageOnlyAction | PmItemAction;"
         },
         {
           "classification": "contract_data",
@@ -24307,7 +24528,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "UpgradeCommandOptions",
-          "signature": "export interface UpgradeCommandOptions { dryRun?: boolean; cliOnly?: boolean; packagesOnly?: boolean; project?: boolean; local?: boolean; global?: boolean; repair?: boolean; tag?: string; packageName?: string; commandRunner?: UpgradeCommandRunner; }"
+          "signature": "export interface UpgradeCommandOptions { scope?: ExtensionScope; dryRun?: boolean; cliOnly?: boolean; packagesOnly?: boolean; project?: boolean; local?: boolean; global?: boolean; repair?: boolean; tag?: string; packageName?: string; commandRunner?: UpgradeCommandRunner; }"
         },
         {
           "classification": "supported",
@@ -30487,7 +30708,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "UpgradeCommandOptions",
-          "signature": "export interface UpgradeCommandOptions { dryRun?: boolean; cliOnly?: boolean; packagesOnly?: boolean; project?: boolean; local?: boolean; global?: boolean; repair?: boolean; tag?: string; packageName?: string; commandRunner?: UpgradeCommandRunner; }"
+          "signature": "export interface UpgradeCommandOptions { scope?: ExtensionScope; dryRun?: boolean; cliOnly?: boolean; packagesOnly?: boolean; project?: boolean; local?: boolean; global?: boolean; repair?: boolean; tag?: string; packageName?: string; commandRunner?: UpgradeCommandRunner; }"
         },
         {
           "classification": "supported",
@@ -31351,6 +31572,7 @@
     "ownership_dependency_bypass_restricted_options",
     "ownership_metadata_bypass_restricted_options",
     "package_spec_empty",
+    "package_upgrade_modes_mutually_exclusive",
     "positional_shape_budget_exceeded",
     "positional_signature_mismatch",
     "profile_name_empty",