@unbrained/pm-cli 2026.8.26 → 2026.8.28

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1801,
+    "covered_symbols": 1811,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1802
+    "required_symbols": 1812
   },
   "breaking_acknowledgements": [
     {
@@ -1263,6 +1263,120 @@
       ],
       "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."
+    },
+    {
+      "changes": [
+        "signature ./sdk:AnnotationCommandOptions",
+        "signature ./sdk:AnnotationCommandResult",
+        "signature ./sdk:AnnotationMutationReceipt",
+        "signature ./sdk:CommentsCommandOptions",
+        "signature ./sdk:CommentsResult",
+        "signature ./sdk/core:CommentsCommandOptions",
+        "signature ./sdk/core:CommentsResult",
+        "signature ./sdk/runtime:CommentsCommandOptions",
+        "signature ./sdk/runtime:CommentsResult"
+      ],
+      "package_version": "2026.8.27",
+      "reason": "Add the opt-in comment ifAbsent mutation and changed receipt contract for retry-safe agents; default append behavior remains compatible and the next date-based release documents the new surface."
+    },
+    {
+      "changes": [
+        "signature ./sdk:LearningsCommandOptions",
+        "signature ./sdk:LearningsResult",
+        "signature ./sdk:NotesCommandOptions",
+        "signature ./sdk:NotesResult",
+        "signature ./sdk/core:LearningsCommandOptions",
+        "signature ./sdk/core:LearningsResult",
+        "signature ./sdk/core:NotesCommandOptions",
+        "signature ./sdk/core:NotesResult",
+        "signature ./sdk/runtime:LearningsCommandOptions",
+        "signature ./sdk/runtime:LearningsResult",
+        "signature ./sdk/runtime:NotesCommandOptions",
+        "signature ./sdk/runtime:NotesResult"
+      ],
+      "package_version": "2026.8.27",
+      "reason": "Additive optional ifAbsent and changed fields extend every public annotation mutation contract; policy classifies exported signature growth as breaking and the next date release carries it."
+    },
+    {
+      "changes": [
+        "signature ./sdk:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/contracts:PM_TOOL_PARAMETERS_SCHEMA_VERSION"
+      ],
+      "package_version": "2026.8.27",
+      "reason": "Advance the strict tool-parameter schema version for the additive annotation ifAbsent contract"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PM_AGENT_TASK_TRANSCRIPT_VERSION",
+        "signature ./sdk:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk:PmAgentTaskTranscriptStep",
+        "signature ./sdk/contracts:PM_AGENT_TASK_TRANSCRIPT_VERSION",
+        "signature ./sdk/contracts:PM_TOOL_PARAMETERS_SCHEMA_VERSION",
+        "signature ./sdk/contracts:PmAgentTaskTranscriptStep"
+      ],
+      "package_version": "2026.8.27",
+      "reason": "Finalize unreleased transcript v2 accounting-mode contract and strict annotation schema correction"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmAgentTaskTranscriptStep",
+        "signature ./sdk/contracts:PmAgentTaskTranscriptStep"
+      ],
+      "package_version": "2026.8.27",
+      "reason": "Add optional transcript terminal-value assertions while preserving version-two parser compatibility"
     }
   ],
   "entrypoints": {
@@ -1783,13 +1897,13 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "AnnotationCommandOptions",
-          "signature": "export interface AnnotationCommandOptions { limit?: string; author?: string; message?: string; force?: boolean; includeMeta?: boolean; fullHistory?: boolean; }"
+          "signature": "export interface AnnotationCommandOptions { limit?: string; author?: string; message?: string; force?: boolean; includeMeta?: boolean; fullHistory?: boolean; ifAbsent?: boolean; }"
         },
         {
           "classification": "advanced_export",
           "kind": "type",
           "name": "AnnotationCommandResult",
-          "signature": "export type AnnotationCommandResult<TKey extends string, TEntry extends AnnotationEntry> = { id: string; count: number; } & Record<TKey, TEntry[]> & { total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; };"
+          "signature": "export type AnnotationCommandResult<TKey extends string, TEntry extends AnnotationEntry> = { id: string; count: number; } & Record<TKey, TEntry[]> & { total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; changed?: boolean; };"
         },
         {
           "classification": "advanced_export",
@@ -1813,7 +1927,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "AnnotationMutationReceipt",
-          "signature": "export interface AnnotationMutationReceipt { action: \"add\" | \"edit\" | \"delete\"; entry_index: number; changed_count: 1; full_history_included: boolean; }"
+          "signature": "export interface AnnotationMutationReceipt { action: \"add\" | \"edit\" | \"delete\"; entry_index: number; changed_count: 0 | 1; full_history_included: boolean; }"
         },
         {
           "classification": "advanced_export",
@@ -2109,6 +2223,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",
@@ -3679,13 +3799,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "CommentsCommandOptions",
-          "signature": "export interface CommentsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; includeMeta?: boolean; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface CommentsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; includeMeta?: boolean; fullHistory?: boolean; ifAbsent?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "CommentsResult",
-          "signature": "export interface CommentsResult { id: string; comments: Comment[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
+          "signature": "export interface CommentsResult { id: string; comments: Comment[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; changed?: boolean; }"
         },
         {
           "classification": "advanced_export",
@@ -4689,6 +4809,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 +6657,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 +7365,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",
@@ -8251,13 +8389,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "LearningsCommandOptions",
-          "signature": "export interface LearningsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface LearningsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; fullHistory?: boolean; ifAbsent?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "LearningsResult",
-          "signature": "export interface LearningsResult { id: string; learnings: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
+          "signature": "export interface LearningsResult { id: string; learnings: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; changed?: boolean; }"
         },
         {
           "classification": "advanced_export",
@@ -8607,6 +8745,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 +8889,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",
@@ -9337,13 +9493,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "NotesCommandOptions",
-          "signature": "export interface NotesCommandOptions { add?: string; addJson?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; since?: string; eventType?: string; includeMeta?: boolean; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface NotesCommandOptions { add?: string; addJson?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; since?: string; eventType?: string; includeMeta?: boolean; fullHistory?: boolean; ifAbsent?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "NotesResult",
-          "signature": "export interface NotesResult { id: string; notes: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; structured_event_count?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
+          "signature": "export interface NotesResult { id: string; notes: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; structured_event_count?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; changed?: boolean; }"
         },
         {
           "classification": "supported",
@@ -9867,6 +10023,12 @@
           "name": "parseOptionalNumber",
           "signature": "(raw: string, optionName: string) => number | calls: (raw: string, optionName: string) => number"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "parsePmAgentTaskTranscriptCorpus",
+          "signature": "(value: unknown) => PmAgentTaskTranscriptCorpus | calls: (value: unknown) => PmAgentTaskTranscriptCorpus"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -10161,6 +10323,18 @@
           "name": "planWorkspaceSnapshotRestore",
           "signature": "(pmRoot: string, target: string) => Promise<WorkspaceSnapshotRestorePlan> | calls: (pmRoot: string, target: string) => Promise<WorkspaceSnapshotRestorePlan>"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_AGENT_TASK_ACCOUNTING_MODES",
+          "signature": "readonly [\"self_reported\", \"independent_transport\"]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_AGENT_TASK_TRANSCRIPT_VERSION",
+          "signature": "2"
+        },
         {
           "classification": "supported",
           "kind": "value",
@@ -10171,7 +10345,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 +10363,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 +10581,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 +10659,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 +10749,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",
@@ -10681,7 +10915,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.9.0\""
+          "signature": "\"4.10.1\""
         },
         {
           "classification": "contract_data",
@@ -10725,6 +10959,42 @@
           "name": "PmActionToolInputSchemaOptions",
           "signature": "export interface PmActionToolInputSchemaOptions { properties?: Record<string, unknown>; required?: string[]; additionalProperties?: boolean; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmAgentTaskAccountingMode",
+          "signature": "export type PmAgentTaskAccountingMode = (typeof PM_AGENT_TASK_ACCOUNTING_MODES)[number];"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmAgentTaskExpectedFieldValue",
+          "signature": "export type PmAgentTaskExpectedFieldValue = string | number | boolean | null;"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmAgentTaskStepOutputKind",
+          "signature": "export type PmAgentTaskStepOutputKind = PmOutputEnvelopeKind | \"refusal\";"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmAgentTaskTranscript",
+          "signature": "export interface PmAgentTaskTranscript { id: string; description: string; steps: readonly PmAgentTaskTranscriptStep[]; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmAgentTaskTranscriptCorpus",
+          "signature": "export interface PmAgentTaskTranscriptCorpus { version: typeof PM_AGENT_TASK_TRANSCRIPT_VERSION; tasks: readonly PmAgentTaskTranscript[]; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmAgentTaskTranscriptStep",
+          "signature": "export interface PmAgentTaskTranscriptStep { id: string; args: readonly string[]; expected_exit_code: number; expected_output_kind: PmAgentTaskStepOutputKind; expected_accounting_mode: PmAgentTaskAccountingMode; required_fields: readonly string[]; expected_field_values?: Readonly<Record<string, PmAgentTaskExpectedFieldValue>>; expected_error_code?: string; expected_refusal_surface?: string; recovery_for?: string; }"
+        },
         {
           "classification": "contract_data",
           "kind": "type",
@@ -10831,7 +11101,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 +11511,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 +11703,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 +12229,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 +12999,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 +14103,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 +14877,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 +16929,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 +17725,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",
@@ -20283,6 +20613,12 @@
           "name": "parseMutationReceipt",
           "signature": "{ (json: string): PmMutationReceipt; (value: unknown): PmMutationReceipt; } | calls: (json: string) => PmMutationReceipt ; (value: unknown) => PmMutationReceipt"
         },
+        {
+          "classification": "contract_data",
+          "kind": "function",
+          "name": "parsePmAgentTaskTranscriptCorpus",
+          "signature": "(value: unknown) => PmAgentTaskTranscriptCorpus | calls: (value: unknown) => PmAgentTaskTranscriptCorpus"
+        },
         {
           "classification": "contract_data",
           "kind": "value",
@@ -20301,11 +20637,23 @@
           "name": "PLAN_FLAG_CONTRACTS",
           "signature": "CliFlagContract[]"
         },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_AGENT_TASK_ACCOUNTING_MODES",
+          "signature": "readonly [\"self_reported\", \"independent_transport\"]"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "value",
+          "name": "PM_AGENT_TASK_TRANSCRIPT_VERSION",
+          "signature": "2"
+        },
         {
           "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 +20671,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 +20835,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",
@@ -20575,7 +20929,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.9.0\""
+          "signature": "\"4.10.1\""
         },
         {
           "classification": "contract_data",
@@ -20595,6 +20949,42 @@
           "name": "PmActionToolInputSchemaOptions",
           "signature": "export interface PmActionToolInputSchemaOptions { properties?: Record<string, unknown>; required?: string[]; additionalProperties?: boolean; }"
         },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmAgentTaskAccountingMode",
+          "signature": "export type PmAgentTaskAccountingMode = (typeof PM_AGENT_TASK_ACCOUNTING_MODES)[number];"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmAgentTaskExpectedFieldValue",
+          "signature": "export type PmAgentTaskExpectedFieldValue = string | number | boolean | null;"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "type",
+          "name": "PmAgentTaskStepOutputKind",
+          "signature": "export type PmAgentTaskStepOutputKind = PmOutputEnvelopeKind | \"refusal\";"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmAgentTaskTranscript",
+          "signature": "export interface PmAgentTaskTranscript { id: string; description: string; steps: readonly PmAgentTaskTranscriptStep[]; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmAgentTaskTranscriptCorpus",
+          "signature": "export interface PmAgentTaskTranscriptCorpus { version: typeof PM_AGENT_TASK_TRANSCRIPT_VERSION; tasks: readonly PmAgentTaskTranscript[]; }"
+        },
+        {
+          "classification": "contract_data",
+          "kind": "interface",
+          "name": "PmAgentTaskTranscriptStep",
+          "signature": "export interface PmAgentTaskTranscriptStep { id: string; args: readonly string[]; expected_exit_code: number; expected_output_kind: PmAgentTaskStepOutputKind; expected_accounting_mode: PmAgentTaskAccountingMode; required_fields: readonly string[]; expected_field_values?: Readonly<Record<string, PmAgentTaskExpectedFieldValue>>; expected_error_code?: string; expected_refusal_surface?: string; recovery_for?: string; }"
+        },
         {
           "classification": "contract_data",
           "kind": "type",
@@ -20641,7 +21031,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 +21541,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",
@@ -22033,13 +22423,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "CommentsCommandOptions",
-          "signature": "export interface CommentsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; includeMeta?: boolean; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface CommentsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; includeMeta?: boolean; fullHistory?: boolean; ifAbsent?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "CommentsResult",
-          "signature": "export interface CommentsResult { id: string; comments: Comment[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
+          "signature": "export interface CommentsResult { id: string; comments: Comment[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; changed?: boolean; }"
         },
         {
           "classification": "supported",
@@ -22405,13 +22795,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "LearningsCommandOptions",
-          "signature": "export interface LearningsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface LearningsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; fullHistory?: boolean; ifAbsent?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "LearningsResult",
-          "signature": "export interface LearningsResult { id: string; learnings: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
+          "signature": "export interface LearningsResult { id: string; learnings: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; changed?: boolean; }"
         },
         {
           "classification": "supported",
@@ -22501,13 +22891,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "NotesCommandOptions",
-          "signature": "export interface NotesCommandOptions { add?: string; addJson?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; since?: string; eventType?: string; includeMeta?: boolean; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface NotesCommandOptions { add?: string; addJson?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; since?: string; eventType?: string; includeMeta?: boolean; fullHistory?: boolean; ifAbsent?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "NotesResult",
-          "signature": "export interface NotesResult { id: string; notes: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; structured_event_count?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
+          "signature": "export interface NotesResult { id: string; notes: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; structured_event_count?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; changed?: boolean; }"
         },
         {
           "classification": "supported",
@@ -24307,7 +24697,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",
@@ -27967,13 +28357,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "CommentsCommandOptions",
-          "signature": "export interface CommentsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; includeMeta?: boolean; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface CommentsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; includeMeta?: boolean; fullHistory?: boolean; ifAbsent?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "CommentsResult",
-          "signature": "export interface CommentsResult { id: string; comments: Comment[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
+          "signature": "export interface CommentsResult { id: string; comments: Comment[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; changed?: boolean; }"
         },
         {
           "classification": "advanced_export",
@@ -28723,13 +29113,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "LearningsCommandOptions",
-          "signature": "export interface LearningsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface LearningsCommandOptions { add?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; fullHistory?: boolean; ifAbsent?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "LearningsResult",
-          "signature": "export interface LearningsResult { id: string; learnings: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
+          "signature": "export interface LearningsResult { id: string; learnings: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; changed?: boolean; }"
         },
         {
           "classification": "advanced_export",
@@ -28963,13 +29353,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "NotesCommandOptions",
-          "signature": "export interface NotesCommandOptions { add?: string; addJson?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; since?: string; eventType?: string; includeMeta?: boolean; fullHistory?: boolean; author?: string; message?: string; force?: boolean; }"
+          "signature": "export interface NotesCommandOptions { add?: string; addJson?: string; stdin?: boolean; file?: string; edit?: number; delete?: number; limit?: string; since?: string; eventType?: string; includeMeta?: boolean; fullHistory?: boolean; ifAbsent?: boolean; author?: string; message?: string; force?: boolean; }"
         },
         {
           "classification": "supported",
           "kind": "interface",
           "name": "NotesResult",
-          "signature": "export interface NotesResult { id: string; notes: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; structured_event_count?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; }"
+          "signature": "export interface NotesResult { id: string; notes: LogNote[]; count: number; total_count?: number; returned_count?: number; has_more?: boolean; limit?: number; structured_event_count?: number; mutation_receipt?: AnnotationMutationReceipt; omission_receipt?: AnnotationOmissionReceipt; changed?: boolean; }"
         },
         {
           "classification": "supported",
@@ -30487,7 +30877,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",
@@ -31158,6 +31548,7 @@
     "ambiguous_option_combination",
     "annotation_alias_conflict",
     "annotation_flag_like_value",
+    "annotation_if_absent_without_append",
     "annotation_message_without_text",
     "annotation_transposed_subcommand",
     "append_empty_body",
@@ -31346,11 +31737,14 @@
     "no_update_fields",
     "no_version_bounds_declared",
     "non_refusal_exit",
+    "npm_package_archive_missing",
+    "npm_package_archive_unsafe",
     "npm_package_not_found",
     "ownership_conflict",
     "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",