@unbrained/pm-cli 2026.8.9 → 2026.8.10

package/sdk/public-surface.json

@@ -1,6 +1,6 @@
 {
   "aggregate_completeness": {
-    "covered_symbols": 1477,
+    "covered_symbols": 1483,
     "excluded": [
       {
         "name": "_testOnlyCliContracts",
@@ -8,7 +8,7 @@
       }
     ],
     "missing": [],
-    "required_symbols": 1478
+    "required_symbols": 1484
   },
   "breaking_acknowledgements": [
     {
@@ -139,6 +139,48 @@
       ],
       "package_version": "2026.8.8",
       "reason": "Make the newly introduced legacyAliasCounts assembly field total so all public consumers receive a stable empty object instead of an impossible undefined state"
+    },
+    {
+      "changes": [
+        "signature ./sdk:ContextResult",
+        "signature ./sdk:ContextSignalStoreReadResult",
+        "signature ./sdk:PmClient",
+        "signature ./sdk/core:ContextResult",
+        "signature ./sdk/core:PmClient",
+        "signature ./sdk/query:ContextResult",
+        "signature ./sdk/query:ContextSignalStoreReadResult",
+        "signature ./sdk/runtime:ContextResult",
+        "signature ./sdk/runtime:PmClient"
+      ],
+      "package_version": "2026.8.9",
+      "reason": "Additive PmClient lightweight metadata method and optional actionable context diagnostics change structural signatures without removing or narrowing existing SDK members."
+    },
+    {
+      "changes": [
+        "signature ./sdk:AgentProvenanceOutcome",
+        "signature ./sdk:listMergeReceipts",
+        "signature ./sdk:MergeDecisionReceipt",
+        "signature ./sdk:ProvenanceResolverHealthScan",
+        "signature ./sdk/core:AgentProvenanceOutcome",
+        "signature ./sdk/governance:ProvenanceResolverHealthScan",
+        "signature ./sdk/merge:listMergeReceipts",
+        "signature ./sdk/merge:MergeDecisionReceipt"
+      ],
+      "package_version": "2026.8.9",
+      "reason": "Intentional additive context-integrity contract: explicit not_configured provenance state, durable receipt availability, and optional tracker-root discovery"
+    },
+    {
+      "changes": [
+        "signature ./sdk:PmCliErrorContext",
+        "signature ./sdk:TOOL_CREATE_OPTION_CONTRACT_SOURCE",
+        "signature ./sdk:TOOL_UPDATE_OPTION_CONTRACT_SOURCE",
+        "signature ./sdk:UpdateCommandOptions",
+        "signature ./sdk/contracts:TOOL_CREATE_OPTION_CONTRACT_SOURCE",
+        "signature ./sdk/contracts:TOOL_UPDATE_OPTION_CONTRACT_SOURCE",
+        "signature ./sdk/runtime:UpdateCommandOptions"
+      ],
+      "package_version": "2026.8.9",
+      "reason": "Adds fail-fast dependency targets, lossless acceptance-criteria errors, and explicit unresolved dependency options across typed SDK contracts."
     }
   ],
   "entrypoints": {
@@ -443,7 +485,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AgentProvenanceOutcome",
-          "signature": "export interface AgentProvenanceOutcome { status: \"resolved\" | \"unavailable\" | \"failed\"; reason?: AgentProvenanceAbsenceReason; resolver?: AgentProvenanceResolver; rule_version: \"v1\"; }"
+          "signature": "export interface AgentProvenanceOutcome { status: \"resolved\" | \"unavailable\" | \"not_configured\" | \"failed\"; reason?: AgentProvenanceAbsenceReason; resolver?: AgentProvenanceResolver; rule_version: \"v1\"; }"
         },
         {
           "classification": "supported",
@@ -2095,6 +2137,12 @@
           "name": "CONTEXT_SIGNAL_STORE_FORMAT_VERSION",
           "signature": "1"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "CONTEXT_SIGNAL_STORE_WARNING_DETAILS",
+          "signature": "{ readonly context_signal_store_invalid: { readonly code: \"context_signal_store_invalid\"; readonly meaning: \"The persisted context-signal snapshot was unreadable or invalid and was rebuilt from authoritative items.\"; readonly recovery_command: \"pm context\"; readonly recovery_effect: \"Re-read context and confirm the rebuilt snapshot can be loaded without the warning.\"; }; readonly context_signal_store_stale: { readonly code: \"context_signal_store_stale\"; readonly meaning: \"The persisted context-signal snapshot did not match the authoritative cursor or item corpus and was rebuilt.\"; readonly recovery_command: \"pm context\"; readonly recovery_effect: \"Re-read context and confirm the rebuilt snapshot is now fresh.\"; }; readonly context_signal_store_write_failed: { readonly code: \"context_signal_store_write_failed\"; readonly meaning: \"Context signals were rebuilt in memory, but the derived snapshot could not be persisted.\"; readonly recovery_command: \"pm context\"; readonly recovery_effect: \"Retry the derived snapshot write and confirm the warning clears after storage access is restored.\"; }; }"
+        },
         {
           "classification": "supported",
           "kind": "type",
@@ -2303,7 +2351,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ContextResult",
-          "signature": "export interface ContextResult { output_default: \"toon\"; now: string; depth: ContextDepth; sections_included: ContextSectionName[]; window: { anchor: string; start: string | null; end: string | null; past: boolean; from: string | null; to: string | null; }; filters: { type: string | null; tag: string | null; priority: string | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; limit: string | null; parent: string | null; token_budget: number; runtime_filters?: Record<string, unknown>; }; summary: ContextSummary; high_level: ContextFocusItem[]; low_level: ContextFocusItem[]; blocked_fallback: ContextFocusItem[]; agenda: { summary: ContextAgendaSummary; events: ContextAgendaEvent[]; }; hierarchy?: HierarchyNode[]; activity?: CompactActivityEntry[]; progress?: ProgressEntry[]; blockers?: BlockerEntry[]; recently_created?: RecentContextItem[]; unparented?: ContextFocusItem[]; files?: HotFile[]; workload?: WorkloadEntry[]; staleness?: StaleEntry[]; tests?: TestHealthSummary; extension_health?: ContextExtensionHealth; workspace_memory?: { cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; rollups: WorkspaceMemoryRollup[]; }; suggestions?: string[]; focus_fields?: string[]; warnings?: string[]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; has_more?: boolean; next_cursor?: string; applied_limit?: number; truncated?: true; }"
+          "signature": "export interface ContextResult { output_default: \"toon\"; now: string; depth: ContextDepth; sections_included: ContextSectionName[]; window: { anchor: string; start: string | null; end: string | null; past: boolean; from: string | null; to: string | null; }; filters: { type: string | null; tag: string | null; priority: string | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; limit: string | null; parent: string | null; token_budget: number; runtime_filters?: Record<string, unknown>; }; summary: ContextSummary; high_level: ContextFocusItem[]; low_level: ContextFocusItem[]; blocked_fallback: ContextFocusItem[]; agenda: { summary: ContextAgendaSummary; events: ContextAgendaEvent[]; }; hierarchy?: HierarchyNode[]; activity?: CompactActivityEntry[]; progress?: ProgressEntry[]; blockers?: BlockerEntry[]; recently_created?: RecentContextItem[]; unparented?: ContextFocusItem[]; files?: HotFile[]; workload?: WorkloadEntry[]; staleness?: StaleEntry[]; tests?: TestHealthSummary; extension_health?: ContextExtensionHealth; workspace_memory?: { cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; rollups: WorkspaceMemoryRollup[]; }; suggestions?: string[]; focus_fields?: string[]; warnings?: string[]; warning_details?: ContextSignalStoreReadResult[\"warning_details\"]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; has_more?: boolean; next_cursor?: string; applied_limit?: number; truncated?: true; }"
         },
         {
           "classification": "supported",
@@ -2339,7 +2387,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ContextSignalStoreReadResult",
-          "signature": "export interface ContextSignalStoreReadResult { snapshot: ContextSignalSnapshot; candidates: ContextRelevanceCandidate<ItemMetadata>[]; cache_status: \"fresh\" | \"rebuilt\"; warnings: readonly string[]; }"
+          "signature": "export interface ContextSignalStoreReadResult { snapshot: ContextSignalSnapshot; candidates: ContextRelevanceCandidate<ItemMetadata>[]; cache_status: \"fresh\" | \"rebuilt\"; warnings: readonly string[]; warning_details?: readonly ContextSignalStoreWarningDetail[]; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ContextSignalStoreWarningDetail",
+          "signature": "export interface ContextSignalStoreWarningDetail { code: \"context_signal_store_invalid\" | \"context_signal_store_stale\" | \"context_signal_store_write_failed\"; meaning: string; recovery_command: \"pm context\"; recovery_effect: string; }"
         },
         {
           "classification": "supported",
@@ -5707,6 +5761,12 @@
           "name": "ITEM_UNION_COLLECTION_FIELDS",
           "signature": "readonly [\"tags\", \"dependencies\", \"comments\", \"notes\", \"learnings\", \"files\", \"tests\", \"test_runs\", \"docs\", \"reminders\", \"events\"]"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "interface",
+          "name": "ItemAddressInvocationResult",
+          "signature": "export interface ItemAddressInvocationResult { argv: string[]; changed: boolean; conflict: boolean; itemId?: string; }"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -6083,7 +6143,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "listMergeReceipts",
-          "signature": "(cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; }) => Promise<MergeDecisionReceipt[]> | calls: (cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; }) => Promise<MergeDecisionReceipt[]>"
+          "signature": "(cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; pmRoot?: string; }) => Promise<MergeDecisionReceipt[]> | calls: (cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; pmRoot?: string; }) => Promise<MergeDecisionReceipt[]>"
         },
         {
           "classification": "supported",
@@ -6341,7 +6401,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceipt",
-          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; }"
+          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; }"
         },
         {
           "classification": "supported",
@@ -6649,6 +6709,12 @@
           "name": "normalizeExtensionContributionInventory",
           "signature": "(value: unknown) => ExtensionContributionInventory | null | undefined | calls: (value: unknown) => ExtensionContributionInventory | null | undefined"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "normalizeItemAddressInvocation",
+          "signature": "(argv: string[]) => ItemAddressInvocationResult | calls: (argv: string[]) => ItemAddressInvocationResult"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -7621,6 +7687,18 @@
           "name": "PM_GITATTRIBUTES_START",
           "signature": "\"# pm-cli:merge-drivers:start\""
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "PM_GITATTRIBUTES_V2_END",
+          "signature": "\"# pm-cli:merge-drivers:v2:end\""
+        },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "PM_GITATTRIBUTES_V2_START",
+          "signature": "\"# pm-cli:merge-drivers:v2:start\""
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -7859,7 +7937,7 @@
           "classification": "supported",
           "kind": "class",
           "name": "PmClient",
-          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
+          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
         },
         {
           "classification": "advanced_export",
@@ -7901,7 +7979,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "PmCliErrorContext",
-          "signature": "export interface PmCliErrorContext { code?: string; reason?: string; field?: string; format?: string; format_version?: number; type?: string; required?: string; why?: string; resolved_path?: string; requested_path?: string; suggested_path?: string; examples?: string[]; nextSteps?: string[]; valid_range?: { first_version: number | null; last_version: number | null; first_timestamp: string | null; last_timestamp: string | null; }; recovery?: PmCliErrorRecoveryPayload; }"
+          "signature": "export interface PmCliErrorContext { code?: string; reason?: string; field?: string; format?: string; format_version?: number; type?: string; required?: string; why?: string; resolved_path?: string; requested_path?: string; suggested_path?: string; examples?: string[]; nextSteps?: string[]; unmatched?: string[]; unresolved_targets?: string[]; valid_range?: { first_version: number | null; last_version: number | null; first_timestamp: string | null; last_timestamp: string | null; }; recovery?: PmCliErrorRecoveryPayload; }"
         },
         {
           "classification": "advanced_export",
@@ -8777,7 +8855,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ProvenanceResolverHealthScan",
-          "signature": "export interface ProvenanceResolverHealthScan { outcomes: ProvenanceResolverHealthOutcome[]; warnings: string[]; events_read: number; truncated: boolean; }"
+          "signature": "export interface ProvenanceResolverHealthScan { outcomes: ProvenanceResolverHealthOutcome[]; invalid_values: ProvenanceValueHealthFinding[]; warnings: string[]; events_read: number; truncated: boolean; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ProvenanceValueHealthFinding",
+          "signature": "export interface ProvenanceValueHealthFinding { harness: string; dimension: string; kind: \"boolean\" | \"single_digit\"; count: number; }"
         },
         {
           "classification": "advanced_export",
@@ -8839,6 +8923,12 @@
           "name": "quoteWindowsCommandArg",
           "signature": "(arg: string) => string | calls: (arg: string) => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "rankCommandPaths",
+          "signature": "(commandPaths: string[], queryToken: string) => string[] | calls: (commandPaths: string[], queryToken: string) => string[]"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -9925,6 +10015,12 @@
           "name": "renderGuideMarkdown",
           "signature": "(result: GuideResult) => string | calls: (result: GuideResult) => string"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "renderMissingOptionRetry",
+          "signature": "(invocationArgv: string[], commandName: string, missingLabels: string[]) => string | undefined | calls: (invocationArgv: string[], commandName: string, missingLabels: string[]) => string | undefined"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -10117,6 +10213,12 @@
           "name": "resolveContextTokenBudget",
           "signature": "(raw: string | number | undefined, fallback: number) => number | calls: (raw: string | number | undefined, fallback: number) => number"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveCreateExplicitEmptyFlag",
+          "signature": "(optionKey: string) => string | undefined | calls: (optionKey: string) => string | undefined"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -10285,6 +10387,12 @@
           "name": "resolveMissingMetadataFilters",
           "signature": "(options: { filterAcMissing?: boolean; filterEstimatesMissing?: boolean; filterResolutionMissing?: boolean; filterMetadataMissing?: boolean; filterReviewerMissing?: boolean; filterRiskMissing?: boolean; filterConfidenceMissing?: boolean; filterSprintMissing?: boolean; filterReleaseMissing?: boolean; }) => MissingMetadataFilters | calls: (options: { filterAcMissing?: boolean; filterEstimatesMissing?: boolean; filterResolutionMissing?: boolean; filterMetadataMissing?: boolean; filterReviewerMissing?: boolean; filterRiskMissing?: boolean; filterConfidenceMissing?: boolean; filterSprintMissing?: boolean; filterReleaseMissing?: boolean; }) => MissingMetadataFilters"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "resolveMissingOptionPlaceholder",
+          "signature": "(commandName: string, missingLabel: string) => string | null | undefined | calls: (commandName: string, missingLabel: string) => string | null | undefined"
+        },
         {
           "classification": "advanced_export",
           "kind": "function",
@@ -11785,6 +11893,12 @@
           "name": "SchemaSubcommand",
           "signature": "export type SchemaSubcommand = (typeof SCHEMA_SUBCOMMANDS)[number];"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "scoreCommandPathMatch",
+          "signature": "(commandPath: string, queryToken: string) => number | calls: (commandPath: string, queryToken: string) => number"
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -12469,6 +12583,18 @@
           "name": "summarizeMergeReceipt",
           "signature": "(receipt: MergeDecisionReceipt) => MergeDecisionReceiptSummary | calls: (receipt: MergeDecisionReceipt) => MergeDecisionReceiptSummary"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "supportsCreateExplicitEmpty",
+          "signature": "(optionKey: string) => boolean | calls: (optionKey: string) => boolean"
+        },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "supportsItemIdAlias",
+          "signature": "(commandName: string | undefined) => boolean | calls: (commandName: string | undefined) => boolean"
+        },
         {
           "classification": "advanced_export",
           "kind": "value",
@@ -12929,7 +13055,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "TOOL_CREATE_OPTION_CONTRACT_SOURCE",
-          "signature": "readonly [{ readonly param: \"id\"; readonly flag: \"--id\"; }, { readonly param: \"title\"; readonly flag: \"--title\"; }, { readonly param: \"description\"; readonly flag: \"--description\"; readonly allowEmpty: true; }, { readonly param: \"type\"; readonly flag: \"--type\"; }, { readonly param: \"template\"; readonly flag: \"--template\"; }, { readonly param: \"createMode\"; readonly flag: \"--create-mode\"; }, { readonly param: \"schedulePreset\"; readonly flag: \"--schedule-preset\"; }, { readonly param: \"status\"; readonly flag: \"--status\"; }, { readonly param: \"priority\"; readonly flag: \"--priority\"; }, { readonly param: \"tags\"; readonly flag: \"--tags\"; readonly allowEmpty: true; }, { readonly param: \"addTags\"; readonly flag: \"--add-tags\"; readonly repeatable: true; }, { readonly param: \"body\"; readonly flag: \"--body\"; readonly allowEmpty: true; }, { readonly param: \"deadline\"; readonly flag: \"--deadline\"; }, { readonly param: \"estimate\"; readonly flag: \"--estimate\"; }, { readonly param: \"acceptanceCriteria\"; readonly flag: \"--acceptance-criteria\"; readonly allowEmpty: true; }, { readonly param: \"author\"; readonly flag: \"--author\"; }, { readonly param: \"message\"; readonly flag: \"--message\"; readonly allowEmpty: true; }, { readonly param: \"assignee\"; readonly flag: \"--assignee\"; }, { readonly param: \"allowMissingParent\"; readonly flag: \"--allow-missing-parent\"; }, { readonly param: \"allowDuplicate\"; readonly flag: \"--allow-duplicate\"; readonly booleanish: true; }, { readonly param: \"reminder\"; readonly flag: \"--reminder\"; readonly repeatable: true; }, { readonly param: \"event\"; readonly flag: \"--event\"; readonly repeatable: true; }, { readonly param: \"typeOption\"; readonly flag: \"--type-option\"; readonly repeatable: true; }, { readonly param: \"field\"; readonly flag: \"--field\"; readonly repeatable: true; }, { readonly param: \"dep\"; readonly flag: \"--dep\"; readonly repeatable: true; }, { readonly param: \"comment\"; readonly flag: \"--comment\"; readonly repeatable: true; }, { readonly param: \"note\"; readonly flag: \"--note\"; readonly repeatable: true; }, { readonly param: \"learning\"; readonly flag: \"--learning\"; readonly repeatable: true; }, { readonly param: \"linkedFile\"; readonly flag: \"--file\"; readonly repeatable: true; }, { readonly param: \"linkedTest\"; readonly flag: \"--test\"; readonly repeatable: true; }, { readonly param: \"doc\"; readonly flag: \"--doc\"; readonly repeatable: true; }, { readonly param: \"unset\"; readonly flag: \"--unset\"; readonly repeatable: true; }, { readonly param: \"clearDeps\"; readonly flag: \"--clear-deps\"; }, { readonly param: \"clearComments\"; readonly flag: \"--clear-comments\"; }, { readonly param: \"clearNotes\"; readonly flag: \"--clear-notes\"; }, { readonly param: \"clearLearnings\"; readonly flag: \"--clear-learnings\"; }, { readonly param: \"clearFiles\"; readonly flag: \"--clear-files\"; }, { readonly param: \"clearTests\"; readonly flag: \"--clear-tests\"; }, { readonly param: \"clearDocs\"; readonly flag: \"--clear-docs\"; }, { readonly param: \"clearReminders\"; readonly flag: \"--clear-reminders\"; }, { readonly param: \"clearEvents\"; readonly flag: \"--clear-events\"; }, { readonly param: \"clearTypeOptions\"; readonly flag: \"--clear-type-options\"; }]"
+          "signature": "readonly [{ readonly param: \"id\"; readonly flag: \"--id\"; }, { readonly param: \"title\"; readonly flag: \"--title\"; }, { readonly param: \"description\"; readonly flag: \"--description\"; readonly allowEmpty: true; }, { readonly param: \"type\"; readonly flag: \"--type\"; }, { readonly param: \"template\"; readonly flag: \"--template\"; }, { readonly param: \"createMode\"; readonly flag: \"--create-mode\"; }, { readonly param: \"schedulePreset\"; readonly flag: \"--schedule-preset\"; }, { readonly param: \"status\"; readonly flag: \"--status\"; }, { readonly param: \"priority\"; readonly flag: \"--priority\"; }, { readonly param: \"tags\"; readonly flag: \"--tags\"; readonly allowEmpty: true; }, { readonly param: \"addTags\"; readonly flag: \"--add-tags\"; readonly repeatable: true; }, { readonly param: \"body\"; readonly flag: \"--body\"; readonly allowEmpty: true; }, { readonly param: \"deadline\"; readonly flag: \"--deadline\"; }, { readonly param: \"estimate\"; readonly flag: \"--estimate\"; }, { readonly param: \"acceptanceCriteria\"; readonly flag: \"--acceptance-criteria\"; readonly allowEmpty: true; }, { readonly param: \"author\"; readonly flag: \"--author\"; }, { readonly param: \"message\"; readonly flag: \"--message\"; readonly allowEmpty: true; }, { readonly param: \"assignee\"; readonly flag: \"--assignee\"; }, { readonly param: \"allowMissingParent\"; readonly flag: \"--allow-missing-parent\"; }, { readonly param: \"allowUnresolvedDeps\"; readonly flag: \"--allow-unresolved-deps\"; }, { readonly param: \"allowDuplicate\"; readonly flag: \"--allow-duplicate\"; readonly booleanish: true; }, { readonly param: \"reminder\"; readonly flag: \"--reminder\"; readonly repeatable: true; }, { readonly param: \"event\"; readonly flag: \"--event\"; readonly repeatable: true; }, { readonly param: \"typeOption\"; readonly flag: \"--type-option\"; readonly repeatable: true; }, { readonly param: \"field\"; readonly flag: \"--field\"; readonly repeatable: true; }, { readonly param: \"dep\"; readonly flag: \"--dep\"; readonly repeatable: true; }, { readonly param: \"comment\"; readonly flag: \"--comment\"; readonly repeatable: true; }, { readonly param: \"note\"; readonly flag: \"--note\"; readonly repeatable: true; }, { readonly param: \"learning\"; readonly flag: \"--learning\"; readonly repeatable: true; }, { readonly param: \"linkedFile\"; readonly flag: \"--file\"; readonly repeatable: true; }, { readonly param: \"linkedTest\"; readonly flag: \"--test\"; readonly repeatable: true; }, { readonly param: \"doc\"; readonly flag: \"--doc\"; readonly repeatable: true; }, { readonly param: \"unset\"; readonly flag: \"--unset\"; readonly repeatable: true; }, { readonly param: \"clearDeps\"; readonly flag: \"--clear-deps\"; }, { readonly param: \"clearComments\"; readonly flag: \"--clear-comments\"; }, { readonly param: \"clearNotes\"; readonly flag: \"--clear-notes\"; }, { readonly param: \"clearLearnings\"; readonly flag: \"--clear-learnings\"; }, { readonly param: \"clearFiles\"; readonly flag: \"--clear-files\"; }, { readonly param: \"clearTests\"; readonly flag: \"--clear-tests\"; }, { readonly param: \"clearDocs\"; readonly flag: \"--clear-docs\"; }, { readonly param: \"clearReminders\"; readonly flag: \"--clear-reminders\"; }, { readonly param: \"clearEvents\"; readonly flag: \"--clear-events\"; }, { readonly param: \"clearTypeOptions\"; readonly flag: \"--clear-type-options\"; }]"
         },
         {
           "classification": "contract_data",
@@ -12983,7 +13109,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "TOOL_UPDATE_OPTION_CONTRACT_SOURCE",
-          "signature": "readonly [{ readonly param: \"title\"; readonly flag: \"--title\"; }, { readonly param: \"description\"; readonly flag: \"--description\"; readonly allowEmpty: true; }, { readonly param: \"body\"; readonly flag: \"--body\"; readonly allowEmpty: true; }, { readonly param: \"status\"; readonly flag: \"--status\"; }, { readonly param: \"closeReason\"; readonly flag: \"--close-reason\"; }, { readonly param: \"completedAt\"; readonly flag: \"--completed-at\"; }, { readonly param: \"priority\"; readonly flag: \"--priority\"; }, { readonly param: \"type\"; readonly flag: \"--type\"; }, { readonly param: \"tags\"; readonly flag: \"--tags\"; readonly allowEmpty: true; }, { readonly param: \"addTags\"; readonly flag: \"--add-tags\"; readonly repeatable: true; }, { readonly param: \"removeTags\"; readonly flag: \"--remove-tags\"; readonly repeatable: true; }, { readonly param: \"deadline\"; readonly flag: \"--deadline\"; }, { readonly param: \"estimate\"; readonly flag: \"--estimate\"; }, { readonly param: \"acceptanceCriteria\"; readonly flag: \"--acceptance-criteria\"; readonly allowEmpty: true; }, { readonly param: \"addAc\"; readonly flag: \"--add-ac\"; readonly repeatable: true; }, { readonly param: \"removeAc\"; readonly flag: \"--remove-ac\"; readonly repeatable: true; }, { readonly param: \"author\"; readonly flag: \"--author\"; }, { readonly param: \"message\"; readonly flag: \"--message\"; readonly allowEmpty: true; }, { readonly param: \"assignee\"; readonly flag: \"--assignee\"; }, { readonly param: \"allowMissingParent\"; readonly flag: \"--allow-missing-parent\"; }, { readonly param: \"dep\"; readonly flag: \"--dep\"; readonly repeatable: true; }, { readonly param: \"depRemove\"; readonly flag: \"--dep-remove\"; readonly repeatable: true; }, { readonly param: \"replaceDeps\"; readonly flag: \"--replace-deps\"; }, { readonly param: \"replaceTests\"; readonly flag: \"--replace-tests\"; }, { readonly param: \"replaceFiles\"; readonly flag: \"--replace-files\"; }, { readonly param: \"replaceDocs\"; readonly flag: \"--replace-docs\"; }, { readonly param: \"comment\"; readonly flag: \"--comment\"; readonly repeatable: true; }, { readonly param: \"note\"; readonly flag: \"--note\"; readonly repeatable: true; }, { readonly param: \"learning\"; readonly flag: \"--learning\"; readonly repeatable: true; }, { readonly param: \"linkedFile\"; readonly flag: \"--file\"; readonly repeatable: true; }, { readonly param: \"linkedTest\"; readonly flag: \"--test\"; readonly repeatable: true; }, { readonly param: \"doc\"; readonly flag: \"--doc\"; readonly repeatable: true; }, { readonly param: \"reminder\"; readonly flag: \"--reminder\"; readonly repeatable: true; }, { readonly param: \"event\"; readonly flag: \"--event\"; readonly repeatable: true; }, { readonly param: \"typeOption\"; readonly flag: \"--type-option\"; readonly repeatable: true; }, { readonly param: \"field\"; readonly flag: \"--field\"; readonly repeatable: true; }, { readonly param: \"unset\"; readonly flag: \"--unset\"; readonly repeatable: true; }, { readonly param: \"clearDeps\"; readonly flag: \"--clear-deps\"; }, { readonly param: \"clearComments\"; readonly flag: \"--clear-comments\"; }, { readonly param: \"clearNotes\"; readonly flag: \"--clear-notes\"; }, { readonly param: \"clearLearnings\"; readonly flag: \"--clear-learnings\"; }, { readonly param: \"clearFiles\"; readonly flag: \"--clear-files\"; }, { readonly param: \"clearTests\"; readonly flag: \"--clear-tests\"; }, { readonly param: \"clearDocs\"; readonly flag: \"--clear-docs\"; }, { readonly param: \"clearReminders\"; readonly flag: \"--clear-reminders\"; }, { readonly param: \"clearEvents\"; readonly flag: \"--clear-events\"; }, { readonly param: \"clearTypeOptions\"; readonly flag: \"--clear-type-options\"; }]"
+          "signature": "readonly [{ readonly param: \"title\"; readonly flag: \"--title\"; }, { readonly param: \"description\"; readonly flag: \"--description\"; readonly allowEmpty: true; }, { readonly param: \"body\"; readonly flag: \"--body\"; readonly allowEmpty: true; }, { readonly param: \"status\"; readonly flag: \"--status\"; }, { readonly param: \"closeReason\"; readonly flag: \"--close-reason\"; }, { readonly param: \"completedAt\"; readonly flag: \"--completed-at\"; }, { readonly param: \"priority\"; readonly flag: \"--priority\"; }, { readonly param: \"type\"; readonly flag: \"--type\"; }, { readonly param: \"tags\"; readonly flag: \"--tags\"; readonly allowEmpty: true; }, { readonly param: \"addTags\"; readonly flag: \"--add-tags\"; readonly repeatable: true; }, { readonly param: \"removeTags\"; readonly flag: \"--remove-tags\"; readonly repeatable: true; }, { readonly param: \"deadline\"; readonly flag: \"--deadline\"; }, { readonly param: \"estimate\"; readonly flag: \"--estimate\"; }, { readonly param: \"acceptanceCriteria\"; readonly flag: \"--acceptance-criteria\"; readonly allowEmpty: true; }, { readonly param: \"addAc\"; readonly flag: \"--add-ac\"; readonly repeatable: true; }, { readonly param: \"removeAc\"; readonly flag: \"--remove-ac\"; readonly repeatable: true; }, { readonly param: \"author\"; readonly flag: \"--author\"; }, { readonly param: \"message\"; readonly flag: \"--message\"; readonly allowEmpty: true; }, { readonly param: \"assignee\"; readonly flag: \"--assignee\"; }, { readonly param: \"allowMissingParent\"; readonly flag: \"--allow-missing-parent\"; }, { readonly param: \"allowUnresolvedDeps\"; readonly flag: \"--allow-unresolved-deps\"; }, { readonly param: \"dep\"; readonly flag: \"--dep\"; readonly repeatable: true; }, { readonly param: \"depRemove\"; readonly flag: \"--dep-remove\"; readonly repeatable: true; }, { readonly param: \"replaceDeps\"; readonly flag: \"--replace-deps\"; }, { readonly param: \"replaceTests\"; readonly flag: \"--replace-tests\"; }, { readonly param: \"replaceFiles\"; readonly flag: \"--replace-files\"; }, { readonly param: \"replaceDocs\"; readonly flag: \"--replace-docs\"; }, { readonly param: \"comment\"; readonly flag: \"--comment\"; readonly repeatable: true; }, { readonly param: \"note\"; readonly flag: \"--note\"; readonly repeatable: true; }, { readonly param: \"learning\"; readonly flag: \"--learning\"; readonly repeatable: true; }, { readonly param: \"linkedFile\"; readonly flag: \"--file\"; readonly repeatable: true; }, { readonly param: \"linkedTest\"; readonly flag: \"--test\"; readonly repeatable: true; }, { readonly param: \"doc\"; readonly flag: \"--doc\"; readonly repeatable: true; }, { readonly param: \"reminder\"; readonly flag: \"--reminder\"; readonly repeatable: true; }, { readonly param: \"event\"; readonly flag: \"--event\"; readonly repeatable: true; }, { readonly param: \"typeOption\"; readonly flag: \"--type-option\"; readonly repeatable: true; }, { readonly param: \"field\"; readonly flag: \"--field\"; readonly repeatable: true; }, { readonly param: \"unset\"; readonly flag: \"--unset\"; readonly repeatable: true; }, { readonly param: \"clearDeps\"; readonly flag: \"--clear-deps\"; }, { readonly param: \"clearComments\"; readonly flag: \"--clear-comments\"; }, { readonly param: \"clearNotes\"; readonly flag: \"--clear-notes\"; }, { readonly param: \"clearLearnings\"; readonly flag: \"--clear-learnings\"; }, { readonly param: \"clearFiles\"; readonly flag: \"--clear-files\"; }, { readonly param: \"clearTests\"; readonly flag: \"--clear-tests\"; }, { readonly param: \"clearDocs\"; readonly flag: \"--clear-docs\"; }, { readonly param: \"clearReminders\"; readonly flag: \"--clear-reminders\"; }, { readonly param: \"clearEvents\"; readonly flag: \"--clear-events\"; }, { readonly param: \"clearTypeOptions\"; readonly flag: \"--clear-type-options\"; }]"
         },
         {
           "classification": "contract_data",
@@ -13079,7 +13205,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "UpdateCommandOptions",
-          "signature": "export interface UpdateCommandOptions extends MutationMetadataCommandOptions, SharedLinkedResourceOptions, SharedLinkedResourceClearOptions { title?: string; description?: string; body?: string; status?: string; closeReason?: string; completedAt?: string; priority?: string | number; type?: string; tags?: string; addTags?: string[]; removeTags?: string[]; addAc?: string[]; removeAc?: string[]; force?: boolean; allowMissingParent?: boolean; depRemove?: string[]; replaceDeps?: boolean; replaceTests?: boolean; replaceFiles?: boolean; replaceDocs?: boolean; runtimeFieldCommands?: Array<\"update\" | \"update_many\">; [key: string]: unknown; }"
+          "signature": "export interface UpdateCommandOptions extends MutationMetadataCommandOptions, SharedLinkedResourceOptions, SharedLinkedResourceClearOptions { title?: string; description?: string; body?: string; status?: string; closeReason?: string; completedAt?: string; priority?: string | number; type?: string; tags?: string; addTags?: string[]; removeTags?: string[]; addAc?: string[]; removeAc?: string[]; force?: boolean; allowMissingParent?: boolean; allowUnresolvedDeps?: boolean; depRemove?: string[]; replaceDeps?: boolean; replaceTests?: boolean; replaceFiles?: boolean; replaceDocs?: boolean; runtimeFieldCommands?: Array<\"update\" | \"update_many\">; [key: string]: unknown; }"
         },
         {
           "classification": "advanced_export",
@@ -16517,7 +16643,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "TOOL_CREATE_OPTION_CONTRACT_SOURCE",
-          "signature": "readonly [{ readonly param: \"id\"; readonly flag: \"--id\"; }, { readonly param: \"title\"; readonly flag: \"--title\"; }, { readonly param: \"description\"; readonly flag: \"--description\"; readonly allowEmpty: true; }, { readonly param: \"type\"; readonly flag: \"--type\"; }, { readonly param: \"template\"; readonly flag: \"--template\"; }, { readonly param: \"createMode\"; readonly flag: \"--create-mode\"; }, { readonly param: \"schedulePreset\"; readonly flag: \"--schedule-preset\"; }, { readonly param: \"status\"; readonly flag: \"--status\"; }, { readonly param: \"priority\"; readonly flag: \"--priority\"; }, { readonly param: \"tags\"; readonly flag: \"--tags\"; readonly allowEmpty: true; }, { readonly param: \"addTags\"; readonly flag: \"--add-tags\"; readonly repeatable: true; }, { readonly param: \"body\"; readonly flag: \"--body\"; readonly allowEmpty: true; }, { readonly param: \"deadline\"; readonly flag: \"--deadline\"; }, { readonly param: \"estimate\"; readonly flag: \"--estimate\"; }, { readonly param: \"acceptanceCriteria\"; readonly flag: \"--acceptance-criteria\"; readonly allowEmpty: true; }, { readonly param: \"author\"; readonly flag: \"--author\"; }, { readonly param: \"message\"; readonly flag: \"--message\"; readonly allowEmpty: true; }, { readonly param: \"assignee\"; readonly flag: \"--assignee\"; }, { readonly param: \"allowMissingParent\"; readonly flag: \"--allow-missing-parent\"; }, { readonly param: \"allowDuplicate\"; readonly flag: \"--allow-duplicate\"; readonly booleanish: true; }, { readonly param: \"reminder\"; readonly flag: \"--reminder\"; readonly repeatable: true; }, { readonly param: \"event\"; readonly flag: \"--event\"; readonly repeatable: true; }, { readonly param: \"typeOption\"; readonly flag: \"--type-option\"; readonly repeatable: true; }, { readonly param: \"field\"; readonly flag: \"--field\"; readonly repeatable: true; }, { readonly param: \"dep\"; readonly flag: \"--dep\"; readonly repeatable: true; }, { readonly param: \"comment\"; readonly flag: \"--comment\"; readonly repeatable: true; }, { readonly param: \"note\"; readonly flag: \"--note\"; readonly repeatable: true; }, { readonly param: \"learning\"; readonly flag: \"--learning\"; readonly repeatable: true; }, { readonly param: \"linkedFile\"; readonly flag: \"--file\"; readonly repeatable: true; }, { readonly param: \"linkedTest\"; readonly flag: \"--test\"; readonly repeatable: true; }, { readonly param: \"doc\"; readonly flag: \"--doc\"; readonly repeatable: true; }, { readonly param: \"unset\"; readonly flag: \"--unset\"; readonly repeatable: true; }, { readonly param: \"clearDeps\"; readonly flag: \"--clear-deps\"; }, { readonly param: \"clearComments\"; readonly flag: \"--clear-comments\"; }, { readonly param: \"clearNotes\"; readonly flag: \"--clear-notes\"; }, { readonly param: \"clearLearnings\"; readonly flag: \"--clear-learnings\"; }, { readonly param: \"clearFiles\"; readonly flag: \"--clear-files\"; }, { readonly param: \"clearTests\"; readonly flag: \"--clear-tests\"; }, { readonly param: \"clearDocs\"; readonly flag: \"--clear-docs\"; }, { readonly param: \"clearReminders\"; readonly flag: \"--clear-reminders\"; }, { readonly param: \"clearEvents\"; readonly flag: \"--clear-events\"; }, { readonly param: \"clearTypeOptions\"; readonly flag: \"--clear-type-options\"; }]"
+          "signature": "readonly [{ readonly param: \"id\"; readonly flag: \"--id\"; }, { readonly param: \"title\"; readonly flag: \"--title\"; }, { readonly param: \"description\"; readonly flag: \"--description\"; readonly allowEmpty: true; }, { readonly param: \"type\"; readonly flag: \"--type\"; }, { readonly param: \"template\"; readonly flag: \"--template\"; }, { readonly param: \"createMode\"; readonly flag: \"--create-mode\"; }, { readonly param: \"schedulePreset\"; readonly flag: \"--schedule-preset\"; }, { readonly param: \"status\"; readonly flag: \"--status\"; }, { readonly param: \"priority\"; readonly flag: \"--priority\"; }, { readonly param: \"tags\"; readonly flag: \"--tags\"; readonly allowEmpty: true; }, { readonly param: \"addTags\"; readonly flag: \"--add-tags\"; readonly repeatable: true; }, { readonly param: \"body\"; readonly flag: \"--body\"; readonly allowEmpty: true; }, { readonly param: \"deadline\"; readonly flag: \"--deadline\"; }, { readonly param: \"estimate\"; readonly flag: \"--estimate\"; }, { readonly param: \"acceptanceCriteria\"; readonly flag: \"--acceptance-criteria\"; readonly allowEmpty: true; }, { readonly param: \"author\"; readonly flag: \"--author\"; }, { readonly param: \"message\"; readonly flag: \"--message\"; readonly allowEmpty: true; }, { readonly param: \"assignee\"; readonly flag: \"--assignee\"; }, { readonly param: \"allowMissingParent\"; readonly flag: \"--allow-missing-parent\"; }, { readonly param: \"allowUnresolvedDeps\"; readonly flag: \"--allow-unresolved-deps\"; }, { readonly param: \"allowDuplicate\"; readonly flag: \"--allow-duplicate\"; readonly booleanish: true; }, { readonly param: \"reminder\"; readonly flag: \"--reminder\"; readonly repeatable: true; }, { readonly param: \"event\"; readonly flag: \"--event\"; readonly repeatable: true; }, { readonly param: \"typeOption\"; readonly flag: \"--type-option\"; readonly repeatable: true; }, { readonly param: \"field\"; readonly flag: \"--field\"; readonly repeatable: true; }, { readonly param: \"dep\"; readonly flag: \"--dep\"; readonly repeatable: true; }, { readonly param: \"comment\"; readonly flag: \"--comment\"; readonly repeatable: true; }, { readonly param: \"note\"; readonly flag: \"--note\"; readonly repeatable: true; }, { readonly param: \"learning\"; readonly flag: \"--learning\"; readonly repeatable: true; }, { readonly param: \"linkedFile\"; readonly flag: \"--file\"; readonly repeatable: true; }, { readonly param: \"linkedTest\"; readonly flag: \"--test\"; readonly repeatable: true; }, { readonly param: \"doc\"; readonly flag: \"--doc\"; readonly repeatable: true; }, { readonly param: \"unset\"; readonly flag: \"--unset\"; readonly repeatable: true; }, { readonly param: \"clearDeps\"; readonly flag: \"--clear-deps\"; }, { readonly param: \"clearComments\"; readonly flag: \"--clear-comments\"; }, { readonly param: \"clearNotes\"; readonly flag: \"--clear-notes\"; }, { readonly param: \"clearLearnings\"; readonly flag: \"--clear-learnings\"; }, { readonly param: \"clearFiles\"; readonly flag: \"--clear-files\"; }, { readonly param: \"clearTests\"; readonly flag: \"--clear-tests\"; }, { readonly param: \"clearDocs\"; readonly flag: \"--clear-docs\"; }, { readonly param: \"clearReminders\"; readonly flag: \"--clear-reminders\"; }, { readonly param: \"clearEvents\"; readonly flag: \"--clear-events\"; }, { readonly param: \"clearTypeOptions\"; readonly flag: \"--clear-type-options\"; }]"
         },
         {
           "classification": "contract_data",
@@ -16571,7 +16697,7 @@
           "classification": "contract_data",
           "kind": "value",
           "name": "TOOL_UPDATE_OPTION_CONTRACT_SOURCE",
-          "signature": "readonly [{ readonly param: \"title\"; readonly flag: \"--title\"; }, { readonly param: \"description\"; readonly flag: \"--description\"; readonly allowEmpty: true; }, { readonly param: \"body\"; readonly flag: \"--body\"; readonly allowEmpty: true; }, { readonly param: \"status\"; readonly flag: \"--status\"; }, { readonly param: \"closeReason\"; readonly flag: \"--close-reason\"; }, { readonly param: \"completedAt\"; readonly flag: \"--completed-at\"; }, { readonly param: \"priority\"; readonly flag: \"--priority\"; }, { readonly param: \"type\"; readonly flag: \"--type\"; }, { readonly param: \"tags\"; readonly flag: \"--tags\"; readonly allowEmpty: true; }, { readonly param: \"addTags\"; readonly flag: \"--add-tags\"; readonly repeatable: true; }, { readonly param: \"removeTags\"; readonly flag: \"--remove-tags\"; readonly repeatable: true; }, { readonly param: \"deadline\"; readonly flag: \"--deadline\"; }, { readonly param: \"estimate\"; readonly flag: \"--estimate\"; }, { readonly param: \"acceptanceCriteria\"; readonly flag: \"--acceptance-criteria\"; readonly allowEmpty: true; }, { readonly param: \"addAc\"; readonly flag: \"--add-ac\"; readonly repeatable: true; }, { readonly param: \"removeAc\"; readonly flag: \"--remove-ac\"; readonly repeatable: true; }, { readonly param: \"author\"; readonly flag: \"--author\"; }, { readonly param: \"message\"; readonly flag: \"--message\"; readonly allowEmpty: true; }, { readonly param: \"assignee\"; readonly flag: \"--assignee\"; }, { readonly param: \"allowMissingParent\"; readonly flag: \"--allow-missing-parent\"; }, { readonly param: \"dep\"; readonly flag: \"--dep\"; readonly repeatable: true; }, { readonly param: \"depRemove\"; readonly flag: \"--dep-remove\"; readonly repeatable: true; }, { readonly param: \"replaceDeps\"; readonly flag: \"--replace-deps\"; }, { readonly param: \"replaceTests\"; readonly flag: \"--replace-tests\"; }, { readonly param: \"replaceFiles\"; readonly flag: \"--replace-files\"; }, { readonly param: \"replaceDocs\"; readonly flag: \"--replace-docs\"; }, { readonly param: \"comment\"; readonly flag: \"--comment\"; readonly repeatable: true; }, { readonly param: \"note\"; readonly flag: \"--note\"; readonly repeatable: true; }, { readonly param: \"learning\"; readonly flag: \"--learning\"; readonly repeatable: true; }, { readonly param: \"linkedFile\"; readonly flag: \"--file\"; readonly repeatable: true; }, { readonly param: \"linkedTest\"; readonly flag: \"--test\"; readonly repeatable: true; }, { readonly param: \"doc\"; readonly flag: \"--doc\"; readonly repeatable: true; }, { readonly param: \"reminder\"; readonly flag: \"--reminder\"; readonly repeatable: true; }, { readonly param: \"event\"; readonly flag: \"--event\"; readonly repeatable: true; }, { readonly param: \"typeOption\"; readonly flag: \"--type-option\"; readonly repeatable: true; }, { readonly param: \"field\"; readonly flag: \"--field\"; readonly repeatable: true; }, { readonly param: \"unset\"; readonly flag: \"--unset\"; readonly repeatable: true; }, { readonly param: \"clearDeps\"; readonly flag: \"--clear-deps\"; }, { readonly param: \"clearComments\"; readonly flag: \"--clear-comments\"; }, { readonly param: \"clearNotes\"; readonly flag: \"--clear-notes\"; }, { readonly param: \"clearLearnings\"; readonly flag: \"--clear-learnings\"; }, { readonly param: \"clearFiles\"; readonly flag: \"--clear-files\"; }, { readonly param: \"clearTests\"; readonly flag: \"--clear-tests\"; }, { readonly param: \"clearDocs\"; readonly flag: \"--clear-docs\"; }, { readonly param: \"clearReminders\"; readonly flag: \"--clear-reminders\"; }, { readonly param: \"clearEvents\"; readonly flag: \"--clear-events\"; }, { readonly param: \"clearTypeOptions\"; readonly flag: \"--clear-type-options\"; }]"
+          "signature": "readonly [{ readonly param: \"title\"; readonly flag: \"--title\"; }, { readonly param: \"description\"; readonly flag: \"--description\"; readonly allowEmpty: true; }, { readonly param: \"body\"; readonly flag: \"--body\"; readonly allowEmpty: true; }, { readonly param: \"status\"; readonly flag: \"--status\"; }, { readonly param: \"closeReason\"; readonly flag: \"--close-reason\"; }, { readonly param: \"completedAt\"; readonly flag: \"--completed-at\"; }, { readonly param: \"priority\"; readonly flag: \"--priority\"; }, { readonly param: \"type\"; readonly flag: \"--type\"; }, { readonly param: \"tags\"; readonly flag: \"--tags\"; readonly allowEmpty: true; }, { readonly param: \"addTags\"; readonly flag: \"--add-tags\"; readonly repeatable: true; }, { readonly param: \"removeTags\"; readonly flag: \"--remove-tags\"; readonly repeatable: true; }, { readonly param: \"deadline\"; readonly flag: \"--deadline\"; }, { readonly param: \"estimate\"; readonly flag: \"--estimate\"; }, { readonly param: \"acceptanceCriteria\"; readonly flag: \"--acceptance-criteria\"; readonly allowEmpty: true; }, { readonly param: \"addAc\"; readonly flag: \"--add-ac\"; readonly repeatable: true; }, { readonly param: \"removeAc\"; readonly flag: \"--remove-ac\"; readonly repeatable: true; }, { readonly param: \"author\"; readonly flag: \"--author\"; }, { readonly param: \"message\"; readonly flag: \"--message\"; readonly allowEmpty: true; }, { readonly param: \"assignee\"; readonly flag: \"--assignee\"; }, { readonly param: \"allowMissingParent\"; readonly flag: \"--allow-missing-parent\"; }, { readonly param: \"allowUnresolvedDeps\"; readonly flag: \"--allow-unresolved-deps\"; }, { readonly param: \"dep\"; readonly flag: \"--dep\"; readonly repeatable: true; }, { readonly param: \"depRemove\"; readonly flag: \"--dep-remove\"; readonly repeatable: true; }, { readonly param: \"replaceDeps\"; readonly flag: \"--replace-deps\"; }, { readonly param: \"replaceTests\"; readonly flag: \"--replace-tests\"; }, { readonly param: \"replaceFiles\"; readonly flag: \"--replace-files\"; }, { readonly param: \"replaceDocs\"; readonly flag: \"--replace-docs\"; }, { readonly param: \"comment\"; readonly flag: \"--comment\"; readonly repeatable: true; }, { readonly param: \"note\"; readonly flag: \"--note\"; readonly repeatable: true; }, { readonly param: \"learning\"; readonly flag: \"--learning\"; readonly repeatable: true; }, { readonly param: \"linkedFile\"; readonly flag: \"--file\"; readonly repeatable: true; }, { readonly param: \"linkedTest\"; readonly flag: \"--test\"; readonly repeatable: true; }, { readonly param: \"doc\"; readonly flag: \"--doc\"; readonly repeatable: true; }, { readonly param: \"reminder\"; readonly flag: \"--reminder\"; readonly repeatable: true; }, { readonly param: \"event\"; readonly flag: \"--event\"; readonly repeatable: true; }, { readonly param: \"typeOption\"; readonly flag: \"--type-option\"; readonly repeatable: true; }, { readonly param: \"field\"; readonly flag: \"--field\"; readonly repeatable: true; }, { readonly param: \"unset\"; readonly flag: \"--unset\"; readonly repeatable: true; }, { readonly param: \"clearDeps\"; readonly flag: \"--clear-deps\"; }, { readonly param: \"clearComments\"; readonly flag: \"--clear-comments\"; }, { readonly param: \"clearNotes\"; readonly flag: \"--clear-notes\"; }, { readonly param: \"clearLearnings\"; readonly flag: \"--clear-learnings\"; }, { readonly param: \"clearFiles\"; readonly flag: \"--clear-files\"; }, { readonly param: \"clearTests\"; readonly flag: \"--clear-tests\"; }, { readonly param: \"clearDocs\"; readonly flag: \"--clear-docs\"; }, { readonly param: \"clearReminders\"; readonly flag: \"--clear-reminders\"; }, { readonly param: \"clearEvents\"; readonly flag: \"--clear-events\"; }, { readonly param: \"clearTypeOptions\"; readonly flag: \"--clear-type-options\"; }]"
         },
         {
           "classification": "contract_data",
@@ -16721,7 +16847,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "AgentProvenanceOutcome",
-          "signature": "export interface AgentProvenanceOutcome { status: \"resolved\" | \"unavailable\" | \"failed\"; reason?: AgentProvenanceAbsenceReason; resolver?: AgentProvenanceResolver; rule_version: \"v1\"; }"
+          "signature": "export interface AgentProvenanceOutcome { status: \"resolved\" | \"unavailable\" | \"not_configured\" | \"failed\"; reason?: AgentProvenanceAbsenceReason; resolver?: AgentProvenanceResolver; rule_version: \"v1\"; }"
         },
         {
           "classification": "supported",
@@ -16925,7 +17051,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ContextResult",
-          "signature": "export interface ContextResult { output_default: \"toon\"; now: string; depth: ContextDepth; sections_included: ContextSectionName[]; window: { anchor: string; start: string | null; end: string | null; past: boolean; from: string | null; to: string | null; }; filters: { type: string | null; tag: string | null; priority: string | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; limit: string | null; parent: string | null; token_budget: number; runtime_filters?: Record<string, unknown>; }; summary: ContextSummary; high_level: ContextFocusItem[]; low_level: ContextFocusItem[]; blocked_fallback: ContextFocusItem[]; agenda: { summary: ContextAgendaSummary; events: ContextAgendaEvent[]; }; hierarchy?: HierarchyNode[]; activity?: CompactActivityEntry[]; progress?: ProgressEntry[]; blockers?: BlockerEntry[]; recently_created?: RecentContextItem[]; unparented?: ContextFocusItem[]; files?: HotFile[]; workload?: WorkloadEntry[]; staleness?: StaleEntry[]; tests?: TestHealthSummary; extension_health?: ContextExtensionHealth; workspace_memory?: { cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; rollups: WorkspaceMemoryRollup[]; }; suggestions?: string[]; focus_fields?: string[]; warnings?: string[]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; has_more?: boolean; next_cursor?: string; applied_limit?: number; truncated?: true; }"
+          "signature": "export interface ContextResult { output_default: \"toon\"; now: string; depth: ContextDepth; sections_included: ContextSectionName[]; window: { anchor: string; start: string | null; end: string | null; past: boolean; from: string | null; to: string | null; }; filters: { type: string | null; tag: string | null; priority: string | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; limit: string | null; parent: string | null; token_budget: number; runtime_filters?: Record<string, unknown>; }; summary: ContextSummary; high_level: ContextFocusItem[]; low_level: ContextFocusItem[]; blocked_fallback: ContextFocusItem[]; agenda: { summary: ContextAgendaSummary; events: ContextAgendaEvent[]; }; hierarchy?: HierarchyNode[]; activity?: CompactActivityEntry[]; progress?: ProgressEntry[]; blockers?: BlockerEntry[]; recently_created?: RecentContextItem[]; unparented?: ContextFocusItem[]; files?: HotFile[]; workload?: WorkloadEntry[]; staleness?: StaleEntry[]; tests?: TestHealthSummary; extension_health?: ContextExtensionHealth; workspace_memory?: { cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; rollups: WorkspaceMemoryRollup[]; }; suggestions?: string[]; focus_fields?: string[]; warnings?: string[]; warning_details?: ContextSignalStoreReadResult[\"warning_details\"]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; has_more?: boolean; next_cursor?: string; applied_limit?: number; truncated?: true; }"
         },
         {
           "classification": "supported",
@@ -17381,7 +17507,7 @@
           "classification": "supported",
           "kind": "class",
           "name": "PmClient",
-          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
+          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
         },
         {
           "classification": "supported",
@@ -17969,7 +18095,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ProvenanceResolverHealthScan",
-          "signature": "export interface ProvenanceResolverHealthScan { outcomes: ProvenanceResolverHealthOutcome[]; warnings: string[]; events_read: number; truncated: boolean; }"
+          "signature": "export interface ProvenanceResolverHealthScan { outcomes: ProvenanceResolverHealthOutcome[]; invalid_values: ProvenanceValueHealthFinding[]; warnings: string[]; events_read: number; truncated: boolean; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ProvenanceValueHealthFinding",
+          "signature": "export interface ProvenanceValueHealthFinding { harness: string; dimension: string; kind: \"boolean\" | \"single_digit\"; count: number; }"
         },
         {
           "classification": "supported",
@@ -19583,7 +19715,7 @@
           "classification": "supported",
           "kind": "function",
           "name": "listMergeReceipts",
-          "signature": "(cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; }) => Promise<MergeDecisionReceipt[]> | calls: (cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; }) => Promise<MergeDecisionReceipt[]>"
+          "signature": "(cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; pmRoot?: string; }) => Promise<MergeDecisionReceipt[]> | calls: (cwd: string, options?: { includeReconciled?: boolean; includeLossless?: boolean; pmRoot?: string; }) => Promise<MergeDecisionReceipt[]>"
         },
         {
           "classification": "supported",
@@ -19601,7 +19733,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "MergeDecisionReceipt",
-          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; }"
+          "signature": "export interface MergeDecisionReceipt { version: 1; id: string; item_path: string; item_id: string; preferred: MergePreferredSide; conflict_resolution: \"preferred_side\" | \"stable_value_order\"; fields_from_theirs: string[]; union_fields: string[]; decisions: ItemMergeConflictDecision[]; state: \"pending\" | \"reconciled\"; created_at: string; reconciled_at?: string; value_availability?: \"clone_local\" | \"hash_only\"; }"
         },
         {
           "classification": "supported",
@@ -19723,6 +19855,18 @@
           "name": "PM_GITATTRIBUTES_START",
           "signature": "\"# pm-cli:merge-drivers:start\""
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "PM_GITATTRIBUTES_V2_END",
+          "signature": "\"# pm-cli:merge-drivers:v2:end\""
+        },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "PM_GITATTRIBUTES_V2_START",
+          "signature": "\"# pm-cli:merge-drivers:v2:start\""
+        },
         {
           "classification": "supported",
           "kind": "function",
@@ -20071,6 +20215,12 @@
           "name": "CONTEXT_SIGNAL_STORE_FORMAT_VERSION",
           "signature": "1"
         },
+        {
+          "classification": "supported",
+          "kind": "value",
+          "name": "CONTEXT_SIGNAL_STORE_WARNING_DETAILS",
+          "signature": "{ readonly context_signal_store_invalid: { readonly code: \"context_signal_store_invalid\"; readonly meaning: \"The persisted context-signal snapshot was unreadable or invalid and was rebuilt from authoritative items.\"; readonly recovery_command: \"pm context\"; readonly recovery_effect: \"Re-read context and confirm the rebuilt snapshot can be loaded without the warning.\"; }; readonly context_signal_store_stale: { readonly code: \"context_signal_store_stale\"; readonly meaning: \"The persisted context-signal snapshot did not match the authoritative cursor or item corpus and was rebuilt.\"; readonly recovery_command: \"pm context\"; readonly recovery_effect: \"Re-read context and confirm the rebuilt snapshot is now fresh.\"; }; readonly context_signal_store_write_failed: { readonly code: \"context_signal_store_write_failed\"; readonly meaning: \"Context signals were rebuilt in memory, but the derived snapshot could not be persisted.\"; readonly recovery_command: \"pm context\"; readonly recovery_effect: \"Retry the derived snapshot write and confirm the warning clears after storage access is restored.\"; }; }"
+        },
         {
           "classification": "supported",
           "kind": "type",
@@ -20273,7 +20423,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ContextResult",
-          "signature": "export interface ContextResult { output_default: \"toon\"; now: string; depth: ContextDepth; sections_included: ContextSectionName[]; window: { anchor: string; start: string | null; end: string | null; past: boolean; from: string | null; to: string | null; }; filters: { type: string | null; tag: string | null; priority: string | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; limit: string | null; parent: string | null; token_budget: number; runtime_filters?: Record<string, unknown>; }; summary: ContextSummary; high_level: ContextFocusItem[]; low_level: ContextFocusItem[]; blocked_fallback: ContextFocusItem[]; agenda: { summary: ContextAgendaSummary; events: ContextAgendaEvent[]; }; hierarchy?: HierarchyNode[]; activity?: CompactActivityEntry[]; progress?: ProgressEntry[]; blockers?: BlockerEntry[]; recently_created?: RecentContextItem[]; unparented?: ContextFocusItem[]; files?: HotFile[]; workload?: WorkloadEntry[]; staleness?: StaleEntry[]; tests?: TestHealthSummary; extension_health?: ContextExtensionHealth; workspace_memory?: { cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; rollups: WorkspaceMemoryRollup[]; }; suggestions?: string[]; focus_fields?: string[]; warnings?: string[]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; has_more?: boolean; next_cursor?: string; applied_limit?: number; truncated?: true; }"
+          "signature": "export interface ContextResult { output_default: \"toon\"; now: string; depth: ContextDepth; sections_included: ContextSectionName[]; window: { anchor: string; start: string | null; end: string | null; past: boolean; from: string | null; to: string | null; }; filters: { type: string | null; tag: string | null; priority: string | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; limit: string | null; parent: string | null; token_budget: number; runtime_filters?: Record<string, unknown>; }; summary: ContextSummary; high_level: ContextFocusItem[]; low_level: ContextFocusItem[]; blocked_fallback: ContextFocusItem[]; agenda: { summary: ContextAgendaSummary; events: ContextAgendaEvent[]; }; hierarchy?: HierarchyNode[]; activity?: CompactActivityEntry[]; progress?: ProgressEntry[]; blockers?: BlockerEntry[]; recently_created?: RecentContextItem[]; unparented?: ContextFocusItem[]; files?: HotFile[]; workload?: WorkloadEntry[]; staleness?: StaleEntry[]; tests?: TestHealthSummary; extension_health?: ContextExtensionHealth; workspace_memory?: { cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; rollups: WorkspaceMemoryRollup[]; }; suggestions?: string[]; focus_fields?: string[]; warnings?: string[]; warning_details?: ContextSignalStoreReadResult[\"warning_details\"]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; has_more?: boolean; next_cursor?: string; applied_limit?: number; truncated?: true; }"
         },
         {
           "classification": "supported",
@@ -20309,7 +20459,13 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ContextSignalStoreReadResult",
-          "signature": "export interface ContextSignalStoreReadResult { snapshot: ContextSignalSnapshot; candidates: ContextRelevanceCandidate<ItemMetadata>[]; cache_status: \"fresh\" | \"rebuilt\"; warnings: readonly string[]; }"
+          "signature": "export interface ContextSignalStoreReadResult { snapshot: ContextSignalSnapshot; candidates: ContextRelevanceCandidate<ItemMetadata>[]; cache_status: \"fresh\" | \"rebuilt\"; warnings: readonly string[]; warning_details?: readonly ContextSignalStoreWarningDetail[]; }"
+        },
+        {
+          "classification": "supported",
+          "kind": "interface",
+          "name": "ContextSignalStoreWarningDetail",
+          "signature": "export interface ContextSignalStoreWarningDetail { code: \"context_signal_store_invalid\" | \"context_signal_store_stale\" | \"context_signal_store_write_failed\"; meaning: string; recovery_command: \"pm context\"; recovery_effect: string; }"
         },
         {
           "classification": "supported",
@@ -21611,7 +21767,7 @@
           "classification": "supported",
           "kind": "interface",
           "name": "ContextResult",
-          "signature": "export interface ContextResult { output_default: \"toon\"; now: string; depth: ContextDepth; sections_included: ContextSectionName[]; window: { anchor: string; start: string | null; end: string | null; past: boolean; from: string | null; to: string | null; }; filters: { type: string | null; tag: string | null; priority: string | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; limit: string | null; parent: string | null; token_budget: number; runtime_filters?: Record<string, unknown>; }; summary: ContextSummary; high_level: ContextFocusItem[]; low_level: ContextFocusItem[]; blocked_fallback: ContextFocusItem[]; agenda: { summary: ContextAgendaSummary; events: ContextAgendaEvent[]; }; hierarchy?: HierarchyNode[]; activity?: CompactActivityEntry[]; progress?: ProgressEntry[]; blockers?: BlockerEntry[]; recently_created?: RecentContextItem[]; unparented?: ContextFocusItem[]; files?: HotFile[]; workload?: WorkloadEntry[]; staleness?: StaleEntry[]; tests?: TestHealthSummary; extension_health?: ContextExtensionHealth; workspace_memory?: { cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; rollups: WorkspaceMemoryRollup[]; }; suggestions?: string[]; focus_fields?: string[]; warnings?: string[]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; has_more?: boolean; next_cursor?: string; applied_limit?: number; truncated?: true; }"
+          "signature": "export interface ContextResult { output_default: \"toon\"; now: string; depth: ContextDepth; sections_included: ContextSectionName[]; window: { anchor: string; start: string | null; end: string | null; past: boolean; from: string | null; to: string | null; }; filters: { type: string | null; tag: string | null; priority: string | null; assignee: string | null; assignee_filter: string | null; sprint: string | null; release: string | null; limit: string | null; parent: string | null; token_budget: number; runtime_filters?: Record<string, unknown>; }; summary: ContextSummary; high_level: ContextFocusItem[]; low_level: ContextFocusItem[]; blocked_fallback: ContextFocusItem[]; agenda: { summary: ContextAgendaSummary; events: ContextAgendaEvent[]; }; hierarchy?: HierarchyNode[]; activity?: CompactActivityEntry[]; progress?: ProgressEntry[]; blockers?: BlockerEntry[]; recently_created?: RecentContextItem[]; unparented?: ContextFocusItem[]; files?: HotFile[]; workload?: WorkloadEntry[]; staleness?: StaleEntry[]; tests?: TestHealthSummary; extension_health?: ContextExtensionHealth; workspace_memory?: { cache_status: \"fresh\" | \"rebuilt\"; source_cursor: string; rollups: WorkspaceMemoryRollup[]; }; suggestions?: string[]; focus_fields?: string[]; warnings?: string[]; warning_details?: ContextSignalStoreReadResult[\"warning_details\"]; ranking?: ContextRankingSummary; packing?: ContextPackingSummary; has_more?: boolean; next_cursor?: string; applied_limit?: number; truncated?: true; }"
         },
         {
           "classification": "advanced_export",
@@ -22273,6 +22429,12 @@
           "name": "listAllItemMetadata",
           "signature": "(pmRoot: string, preferredFormat?: ItemFormat, typeToFolder?: Record<string, string>, warnings?: string[], schema?: RuntimeSchemaSettings) => Promise<ItemMetadata[]> | calls: (pmRoot: string, preferredFormat?: ItemFormat, typeToFolder?: Record<string, string>, warnings?: string[], schema?: RuntimeSchemaSettings) => Promise<ItemMetadata[]>"
         },
+        {
+          "classification": "advanced_export",
+          "kind": "function",
+          "name": "listAllItemMetadataLight",
+          "signature": "(pmRoot: string, preferredFormat?: ItemFormat, typeToFolder?: Record<string, string>, warnings?: string[], schema?: RuntimeSchemaSettings) => Promise<ItemMetadata[]> | calls: (pmRoot: string, preferredFormat?: ItemFormat, typeToFolder?: Record<string, string>, warnings?: string[], schema?: RuntimeSchemaSettings) => Promise<ItemMetadata[]>"
+        },
         {
           "classification": "supported",
           "kind": "interface",
@@ -22619,7 +22781,7 @@
           "classification": "supported",
           "kind": "class",
           "name": "PmClient",
-          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
+          "signature": "export declare class PmClient { private readonly defaults; constructor(options?: PmClientOptions); static forActiveExtensionHost(options: PmClientOptions): PmClient; run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>; private runTyped; context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>; listAllItemMetadataLight(): Promise<ItemMetadata[]>; list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>; search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>; get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>; next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>; aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>; stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>; duplicates(options?: DuplicatesCommandOptions): Promise<DuplicatesResult>; comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>; notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>; learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>; files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>; filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>; filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>; docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>; deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>; graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: { id?: string; target?: string; }, options?: Options): ReadPromise<GraphResult, Options>; append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>; init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>; config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>; schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>; schemaList(): Promise<SchemaListResult>; schemaShow(name: string): Promise<SchemaShowResult>; schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>; schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>; schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>; schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>; schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>; schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>; schemaListFields(): Promise<SchemaListFieldsResult>; schemaShowField(name: string): Promise<SchemaShowFieldResult>; schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>; schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>; schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>; schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>; schemaShowStatus(name: string): Promise<SchemaShowStatusResult>; profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>; profileList(): Promise<ProfileListResult>; profileShow(name: string): Promise<ProfileShowResult>; profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>; profileLint(name: string): Promise<ProfileLintResult>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts: true; }>(options: Options): ReadPromise<ValidateCountsResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions> & { counts?: false; } = ValidateCommandOptions & { counts?: false; }>(options?: Options): ReadPromise<ValidateResult, Options>; validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>; health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>; gc(options?: GcCommandOptions): Promise<GcResult>; historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>; historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>; historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>; historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>; historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>; historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<{ acknowledged: number; history_path: string; }>; plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>; planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>; planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>; planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>; planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>; create(options?: PmCreateActionOptions): Promise<CreateResult>; update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>; close(id: string, reason: string, options?: PmClientCloseActionOptions): Promise<CloseResult>; claim(id: string, options?: PmClientFullMutationOptions): Promise<ClaimResult>; claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>; release(id: string, options?: PmClientFullMutationOptions): Promise<ReleaseResult>; copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>; delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>; restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>; focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>; startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>; pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>; closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>; extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>; package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageCatalog(options?: PackageCommandOptions): Promise<PackageCommandResult>; packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>; packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>; upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>; }"
         },
         {
           "classification": "advanced_export",
@@ -23771,7 +23933,7 @@
           "classification": "advanced_export",
           "kind": "interface",
           "name": "UpdateCommandOptions",
-          "signature": "export interface UpdateCommandOptions extends MutationMetadataCommandOptions, SharedLinkedResourceOptions, SharedLinkedResourceClearOptions { title?: string; description?: string; body?: string; status?: string; closeReason?: string; completedAt?: string; priority?: string | number; type?: string; tags?: string; addTags?: string[]; removeTags?: string[]; addAc?: string[]; removeAc?: string[]; force?: boolean; allowMissingParent?: boolean; depRemove?: string[]; replaceDeps?: boolean; replaceTests?: boolean; replaceFiles?: boolean; replaceDocs?: boolean; runtimeFieldCommands?: Array<\"update\" | \"update_many\">; [key: string]: unknown; }"
+          "signature": "export interface UpdateCommandOptions extends MutationMetadataCommandOptions, SharedLinkedResourceOptions, SharedLinkedResourceClearOptions { title?: string; description?: string; body?: string; status?: string; closeReason?: string; completedAt?: string; priority?: string | number; type?: string; tags?: string; addTags?: string[]; removeTags?: string[]; addAc?: string[]; removeAc?: string[]; force?: boolean; allowMissingParent?: boolean; allowUnresolvedDeps?: boolean; depRemove?: string[]; replaceDeps?: boolean; replaceTests?: boolean; replaceFiles?: boolean; replaceDocs?: boolean; runtimeFieldCommands?: Array<\"update\" | \"update_many\">; [key: string]: unknown; }"
         },
         {
           "classification": "supported",
@@ -24450,6 +24612,8 @@
     }
   },
   "error_codes": [
+    "acceptance_criteria_mutation_conflict",
+    "acceptance_criteria_remove_unmatched",
     "acceptance_criteria_semicolon_forbidden",
     "already_claimed_by",
     "ambiguous_list_all",
@@ -24475,10 +24639,14 @@
     "config_key_unknown",
     "config_value_invalid",
     "conflicting_lifecycle_owner",
+    "context_signal_store_invalid",
+    "context_signal_store_stale",
+    "context_signal_store_write_failed",
     "context_takes_no_item_argument",
     "core_item_field_requires_dedicated_flag",
     "create_positional_type_without_title",
     "dependency_edge_not_allowed",
+    "dependency_target_not_found",
     "duplicate_command",
     "duplicate_edge",
     "duplicate_sweep_cost_limit",