@unbrained/pm-cli 2026.8.27 → 2026.8.29

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1802,
+    "covered_symbols": 1811,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1803
+    "required_symbols": 1812
   },
   "breaking_acknowledgements": [
     {
@@ -1316,6 +1316,96 @@
       ],
       "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"
+    },
+    {
+      "changes": [
+        "signature ./sdk:CURRENT_HISTORY_ITEM_HASH_VERSION",
+        "signature ./sdk:MergeReceiptProofResult",
+        "signature ./sdk:NextBlockerRef",
+        "signature ./sdk:ResolvedBlocker",
+        "signature ./sdk:SUPPORTED_HISTORY_ITEM_HASH_VERSIONS",
+        "signature ./sdk/graph:ResolvedBlocker",
+        "signature ./sdk/query:NextBlockerRef",
+        "signature ./sdk/runtime:NextBlockerRef"
+      ],
+      "package_version": "2026.8.28",
+      "reason": "Adopt history hash epoch v3, proof-source-neutral merge receipts, and first-class external blocker projections."
+    },
+    {
+      "changes": [
+        "error code merge_reconcile_discards_require_acceptance removed"
+      ],
+      "package_version": "2026.8.28",
+      "reason": "Replace force-only merge decision acceptance with exact receipt proof and add structured bare-comma refusal diagnostics."
+    },
+    {
+      "changes": [
+        "signature ./sdk:resolveItemBlockers",
+        "signature ./sdk/graph:resolveItemBlockers"
+      ],
+      "package_version": "2026.8.28",
+      "reason": "Broaden resolveItemBlockers input to accept optional id and updated_at context already consumed by blocker projection"
     }
   ],
   "entrypoints": {
@@ -1836,13 +1926,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",
@@ -1866,7 +1956,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",
@@ -3738,13 +3828,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",
@@ -4668,7 +4758,7 @@
           "classification": "advanced_export",
           "kind": "value",
           "name": "CURRENT_HISTORY_ITEM_HASH_VERSION",
-          "signature": "2"
+          "signature": "3"
         },
         {
           "classification": "supported",
@@ -6452,6 +6542,12 @@
           "name": "ExtensionTrustMode",
           "signature": "export type ExtensionTrustMode = (typeof EXTENSION_TRUST_MODES)[number];"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "value",
+          "name": "EXTERNAL_DEPENDENCY_RESOLUTION_STATUSES",
+          "signature": "readonly [\"open\", \"closed\", \"unknown\"]"
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -6464,6 +6560,36 @@
           "name": "EXTERNAL_DEPENDENCY_SOURCE_KIND_ALIAS",
           "signature": "\"external\""
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ExternalDependencyResolution",
+          "signature": "export interface ExternalDependencyResolution { id: string; status: ExternalDependencyResolutionStatus; resolved: boolean; title: string | null; source: string; checked_at: string; resolver: string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ExternalDependencyResolutionOptions",
+          "signature": "export interface ExternalDependencyResolutionOptions { now?: () => string; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "type",
+          "name": "ExternalDependencyResolutionStatus",
+          "signature": "export type ExternalDependencyResolutionStatus = (typeof EXTERNAL_DEPENDENCY_RESOLUTION_STATUSES)[number];"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ExternalDependencyResolver",
+          "signature": "export interface ExternalDependencyResolver { name: string; supports(reference: string): boolean; resolve(reference: string): Promise<ExternalDependencyResolverResult | null>; }"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ExternalDependencyResolverResult",
+          "signature": "export interface ExternalDependencyResolverResult { status: ExternalDependencyResolutionStatus; title?: string; source?: string; checkedAt?: string; }"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -7976,6 +8102,12 @@
           "name": "isErrnoError",
           "signature": "(error: unknown) => error is { code?: unknown; } | calls: (error: unknown) => error is { code?: unknown; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "isExternalDependencyReference",
+          "signature": "(target: string | undefined) => boolean | calls: (target: string | undefined) => boolean"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -8328,13 +8460,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",
@@ -9054,7 +9186,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "MergeReceiptProofResult",
-          "signature": "export interface MergeReceiptProofResult { trusted: boolean; reason: \"trusted_clone_local_driver_evidence\" | \"git_workspace_unavailable\" | \"item_path_unavailable\" | \"no_item_receipts\" | \"no_receipt_set_proves_snapshot\"; receipt_ids: string[]; }"
+          "signature": "export interface MergeReceiptProofResult { trusted: boolean; reason: \"trusted_merge_driver_hash_evidence\" | \"git_workspace_unavailable\" | \"item_path_unavailable\" | \"no_item_receipts\" | \"no_receipt_set_proves_snapshot\"; receipt_ids: string[]; }"
         },
         {
           "classification": "supported",
@@ -9216,7 +9348,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "NextBlockerRef",
-          "signature": "export interface NextBlockerRef { id: string; title: string | null; status: ItemStatus | null; }"
+          "signature": "export interface NextBlockerRef { id: string; title: string | null; status: ItemStatus | null; external?: boolean; blocked_since?: string; resolver?: string | null; }"
         },
         {
           "classification": "supported",
@@ -9432,13 +9564,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",
@@ -9962,6 +10094,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",
@@ -10256,6 +10394,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",
@@ -10836,7 +10986,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.9.0\""
+          "signature": "\"4.10.1\""
         },
         {
           "classification": "contract_data",
@@ -10880,6 +11030,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",
@@ -13286,6 +13472,12 @@
           "name": "RegisteredVectorStoreAdapterExpectation",
           "signature": "export type RegisteredVectorStoreAdapterExpectation = NamedRegistrationExpectation<\"adapter\", string, { extensionName?: string; }>;"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "registerExternalDependencyResolver",
+          "signature": "(resolver: ExternalDependencyResolver) => () => void | calls: (resolver: ExternalDependencyResolver) => () => void"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -14232,7 +14424,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ResolvedBlocker",
-          "signature": "export interface ResolvedBlocker { id: string; title: string | null; status: ItemStatus | null; resolved: boolean; }"
+          "signature": "export interface ResolvedBlocker { id: string; title: string | null; status: ItemStatus | null; resolved: boolean; external?: boolean; blocked_since?: string; resolver?: string | null; }"
         },
         {
           "classification": "advanced_export",
@@ -14288,6 +14480,12 @@
           "name": "resolveExtensionRoots",
           "signature": "(pmRoot: string, cwd?: string) => { global: string; project: string; } | calls: (pmRoot: string, cwd?: string) => { global: string; project: string; }"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveExternalDependencyReference",
+          "signature": "(reference: string, options?: ExternalDependencyResolutionOptions) => Promise<ExternalDependencyResolution | null> | calls: (reference: string, options?: ExternalDependencyResolutionOptions) => Promise<ExternalDependencyResolution | null>"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -14346,7 +14544,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "resolveItemBlockers",
-          "signature": "(item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\">, itemsById: Map<string, ItemMetadata>, statusRegistry: RuntimeStatusRegistry) => ResolvedBlocker[] | calls: (item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\">, itemsById: Map<string, ItemMetadata>, statusRegistry: RuntimeStatusRegistry) => ResolvedBlocker[]"
+          "signature": "(item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\"> & Partial<Pick<ItemMetadata, \"id\" | \"updated_at\">>, itemsById: Map<string, ItemMetadata>, statusRegistry: RuntimeStatusRegistry) => ResolvedBlocker[] | calls: (item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\"> & Partial<Pick<ItemMetadata, \"id\" | \"updated_at\">>, itemsById: Map<string, ItemMetadata>, statusRegistry: RuntimeStatusRegistry) => ResolvedBlocker[]"
         },
         {
           "classification": "advanced_export",
@@ -16896,7 +17094,7 @@
           "classification": "advanced_export",
           "kind": "value",
           "name": "SUPPORTED_HISTORY_ITEM_HASH_VERSIONS",
-          "signature": "readonly [1, 2]"
+          "signature": "readonly [1, 2, 3]"
         },
         {
           "classification": "advanced_export",
@@ -20498,6 +20696,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",
@@ -20516,6 +20720,18 @@
           "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",
@@ -20796,7 +21012,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "PM_TOOL_PARAMETERS_SCHEMA_VERSION",
-          "signature": "\"4.9.0\""
+          "signature": "\"4.10.1\""
         },
         {
           "classification": "contract_data",
@@ -20816,6 +21032,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",
@@ -22254,13 +22506,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",
@@ -22626,13 +22878,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",
@@ -22722,13 +22974,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",
@@ -25932,13 +26184,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ResolvedBlocker",
-          "signature": "export interface ResolvedBlocker { id: string; title: string | null; status: ItemStatus | null; resolved: boolean; }"
+          "signature": "export interface ResolvedBlocker { id: string; title: string | null; status: ItemStatus | null; resolved: boolean; external?: boolean; blocked_since?: string; resolver?: string | null; }"
         },
         {
           "classification": "supported",
           "kind": "function",
           "name": "resolveItemBlockers",
-          "signature": "(item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\">, itemsById: Map<string, ItemMetadata>, statusRegistry: RuntimeStatusRegistry) => ResolvedBlocker[] | calls: (item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\">, itemsById: Map<string, ItemMetadata>, statusRegistry: RuntimeStatusRegistry) => ResolvedBlocker[]"
+          "signature": "(item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\"> & Partial<Pick<ItemMetadata, \"id\" | \"updated_at\">>, itemsById: Map<string, ItemMetadata>, statusRegistry: RuntimeStatusRegistry) => ResolvedBlocker[] | calls: (item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\"> & Partial<Pick<ItemMetadata, \"id\" | \"updated_at\">>, itemsById: Map<string, ItemMetadata>, statusRegistry: RuntimeStatusRegistry) => ResolvedBlocker[]"
         },
         {
           "classification": "supported",
@@ -27246,7 +27498,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "NextBlockerRef",
-          "signature": "export interface NextBlockerRef { id: string; title: string | null; status: ItemStatus | null; }"
+          "signature": "export interface NextBlockerRef { id: string; title: string | null; status: ItemStatus | null; external?: boolean; blocked_since?: string; resolver?: string | null; }"
         },
         {
           "classification": "supported",
@@ -28188,13 +28440,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",
@@ -28944,13 +29196,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",
@@ -29112,7 +29364,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "NextBlockerRef",
-          "signature": "export interface NextBlockerRef { id: string; title: string | null; status: ItemStatus | null; }"
+          "signature": "export interface NextBlockerRef { id: string; title: string | null; status: ItemStatus | null; external?: boolean; blocked_since?: string; resolver?: string | null; }"
         },
         {
           "classification": "supported",
@@ -29184,13 +29436,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",
@@ -31379,10 +31631,12 @@
     "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",
     "assurance_registry_invalid",
+    "bare_comma_entry_ambiguous",
     "body_file_conflicts_with_body",
     "body_file_missing_path",
     "body_file_unreadable",
@@ -31468,6 +31722,7 @@
     "history_drift_merge_receipt",
     "history_drift_missing_stream",
     "history_drift_unreadable_stream",
+    "history_drift_version_skew",
     "history_merge_conflict_markers_detected",
     "history_stream_over_compact_threshold",
     "history_target_out_of_range",
@@ -31538,7 +31793,6 @@
     "merge_git_config_unwritable",
     "merge_receipt_evidence_invalid",
     "merge_receipts_pending",
-    "merge_reconcile_discards_require_acceptance",
     "merge_reconcile_receipt_evidence_untrusted",
     "merge_root_not_found",
     "missing_allowed_values",
@@ -31551,6 +31805,7 @@
     "missing_observation",
     "missing_observed_signature",
     "missing_parameter_alias",
+    "missing_positive_execution_receipt",
     "missing_probe",
     "missing_required_argument",
     "missing_required_option",
@@ -31567,6 +31822,9 @@
     "no_update_fields",
     "no_version_bounds_declared",
     "non_refusal_exit",
+    "npm_pack_json_shape_unsupported",
+    "npm_package_archive_missing",
+    "npm_package_archive_unsafe",
     "npm_package_not_found",
     "ownership_conflict",
     "ownership_dependency_bypass_restricted_options",
@@ -31600,6 +31858,8 @@
     "reopen_reason_required",
     "reopen_receipt_missing",
     "reopen_target_status_invalid",
+    "reported_zero_passes",
+    "reported_zero_tests",
     "reserved_item_field",
     "retry_failed",
     "schema_migration_input_required",
@@ -31668,6 +31928,7 @@
     "validate_history_drift_hash_mismatches",
     "validate_history_drift_missing_streams",
     "validate_history_drift_unreadable_streams",
+    "validate_history_drift_version_skews",
     "validate_history_unknown_author_events",
     "validate_lifecycle_active_closure_like_metadata",
     "validate_lifecycle_active_terminal_parent",