@unbrained/pm-cli 2026.8.22 → 2026.8.23

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

@@ -91,7 +91,7 @@ export interface PmActionToolInputSchemaOptions {
  */
 export declare function buildPmActionToolInputSchema(action: PmToolAction, options?: PmActionToolInputSchemaOptions): Record<string, unknown>;
 /** Canonical version of the action-scoped strict MCP tool-parameters schema (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the MCP server, the `pm contracts` command, SDK consumers, and contract tests bind to one version constant. Bump the patch/minor for additive, backward-compatible schema changes; bump the MAJOR for breaking changes — the major also drives the `$id` `tool-parameters-v{major}` slug, so the two never drift. */
-export declare const PM_TOOL_PARAMETERS_SCHEMA_VERSION: "4.8.0";
+export declare const PM_TOOL_PARAMETERS_SCHEMA_VERSION: "4.9.0";
 /**
  * Major component of {@link PM_TOOL_PARAMETERS_SCHEMA_VERSION}, used to build the
  * schema `$id` slug so a breaking version bump renames the document in lockstep.

package/dist/sdk/cli-contracts/tool-schema.js

@@ -7,7 +7,7 @@
  * consumers from a single source of truth.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2818ff28-e606-5413-9cc4-81e41208ba23")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b54b0565-3968-59ea-b5f9-8ae52731473a")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 import { PM_TOOL_ACTIONS } from "./enum-contracts.js";
 import { TOOL_CREATE_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, } from "./tool-option-contracts.js";
@@ -993,6 +993,10 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "sharedHostSafe",
             "pmContext",
             "overrideLinkedPmContext",
+            "workspaceContext",
+            "overrideLinkedWorkspaceContext",
+            "allowUntrustedLinkedTests",
+            "acknowledgeLinkedTests",
             "failOnContextMismatch",
             "failOnSkipped",
             "failOnEmptyTestRun",
@@ -1004,6 +1008,10 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "metricDiff",
             ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
         ],
+        mutuallyExclusive: [
+            ["acknowledgeLinkedTests", "run"],
+            ["acknowledgeLinkedTests", "background"],
+        ],
     },
     "test-all": {
         optional: [
@@ -1018,6 +1026,9 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "sharedHostSafe",
             "pmContext",
             "overrideLinkedPmContext",
+            "workspaceContext",
+            "overrideLinkedWorkspaceContext",
+            "allowUntrustedLinkedTests",
             "failOnContextMismatch",
             "failOnSkipped",
             "failOnEmptyTestRun",
@@ -1520,7 +1531,7 @@ function createLazyContractSchema(build) {
     });
 }
 /** Canonical version of the action-scoped strict MCP tool-parameters schema (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the MCP server, the `pm contracts` command, SDK consumers, and contract tests bind to one version constant. Bump the patch/minor for additive, backward-compatible schema changes; bump the MAJOR for breaking changes — the major also drives the `$id` `tool-parameters-v{major}` slug, so the two never drift. */
-export const PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.8.0";
+export const PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.9.0";
 /**
  * Major component of {@link PM_TOOL_PARAMETERS_SCHEMA_VERSION}, used to build the
  * schema `$id` slug so a breaking version bump renames the document in lockstep.
@@ -1602,4 +1613,4 @@ export const _testOnlyCliContracts = {
     withFlagAliasMetadata,
 };
 //# sourceMappingURL=tool-schema.js.map
-//# debugId=2818ff28-e606-5413-9cc4-81e41208ba23
+//# debugId=b54b0565-3968-59ea-b5f9-8ae52731473a

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

@@ -14,12 +14,12 @@ export type { CommanderOptionAliasContract, CommanderOptionRegistrationContract,
 export { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, type PmCommandAliasContract, type PmCommandAliasLifecycle, type PmCommandAliasRegistration, } from "./cli-contracts/command-aliases.js";
 export { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "./cli-contracts/commander-types.js";
 export { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, } from "./cli-contracts/commander-mutation-options.js";
-export { PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_CLI_ONLY_TOOL_ACTION_WAIVERS, PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS, PM_ITEM_ACTION_SUBCOMMANDS, PM_DEPRECATED_TOOL_ACTIONS, PM_DISCOVERABLE_TOOL_ACTIONS, PM_TOOL_ACTIONS, analyzePmToolActionParity, isPmToolAction, isPmExtensionCapabilityContract, isPmExtensionServiceNameContract, isPmExtensionPolicyModeContract, isPmExtensionPolicySurfaceContract, } from "./cli-contracts/enum-contracts.js";
-export type { PmExtensionCapabilityContract, PmExtensionServiceNameContract, PmExtensionPolicyModeContract, PmExtensionTrustModeContract, PmExtensionSandboxProfileContract, PmExtensionPolicySurfaceContract, PmToolAction, } from "./cli-contracts/enum-contracts.js";
+export { MERGE_SUBCOMMAND_VALUES, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_CLI_ONLY_TOOL_ACTION_WAIVERS, PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS, PM_ITEM_ACTION_SUBCOMMANDS, PM_DEPRECATED_TOOL_ACTIONS, PM_DISCOVERABLE_TOOL_ACTIONS, PM_TOOL_ACTIONS, analyzePmToolActionParity, isPmToolAction, isPmExtensionCapabilityContract, isPmExtensionServiceNameContract, isPmExtensionPolicyModeContract, isPmExtensionPolicySurfaceContract, } from "./cli-contracts/enum-contracts.js";
+export type { MergeSubcommand, PmExtensionCapabilityContract, PmExtensionServiceNameContract, PmExtensionPolicyModeContract, PmExtensionTrustModeContract, PmExtensionSandboxProfileContract, PmExtensionPolicySurfaceContract, PmToolAction, } from "./cli-contracts/enum-contracts.js";
 export { TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_CREATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CALENDAR_OPTION_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_DEPS_OPTION_CONTRACTS, TOOL_GRAPH_OPTION_CONTRACTS, TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE, TOOL_CREATE_OPTION_CONTRACT_SOURCE, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE, TOOL_UPDATE_OPTION_CONTRACT_SOURCE, verifyToolOptionCliParity, type ToolOptionCliParityFinding, type ToolOptionCliParityReport, } from "./cli-contracts/tool-option-contracts.js";
 export type { OptionsFromContracts, PmBulkMutationControlOptions, PmBulkMutationFilterOptions, PmCloseActionOptions, PmCloseManyActionOptions, PmCreateActionOptions, PmMutationAttributionOptions, PmOptionScalar, PmUpdateActionOptions, PmUpdateManyActionOptions, } from "./cli-contracts/typed-action-inputs.js";
 export type { CliFlagContract, ToolOptionFlagContract, } from "./cli-contracts/flag-contracts.js";
-export { PM_POSITIONAL_ACTION_CONTRACTS, type PmPositionalActionContract, } from "./cli-contracts/grammar-contracts.js";
+export { PM_COMMAND_POSITIONAL_CONTRACTS, PM_POSITIONAL_ACTION_CONTRACTS, type PmCommandPositionalContract, type PmCommandPositionalSlotContract, type PmPositionalActionContract, } from "./cli-contracts/grammar-contracts.js";
 export { withFlagAliasMetadata, compactFlagAliasContracts, resolvePmPositionalActionFlagContracts, SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_SCOPE_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, REINDEX_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, EVENT_FLAG_CONTRACTS, EVENTS_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, hasSubcommandFlagContractsForCommand, resolveSubcommandFlagContractsForCommand, toCompletionFlagString, } from "./cli-contracts/flag-contracts.js";
 export type { PmActionSchemaContract } from "./cli-contracts/tool-schema.js";
 export { buildPmActionToolInputSchema, PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES, resolvePmToolCustomFieldCollision, CLOSE_ACTION_OPTION_KEYS, PLAN_CREATE_METADATA_PARAMETER_KEYS, PM_TOOL_ACTION_PARAMETER_CONTRACTS, PM_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA_MAJOR, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA, _testOnlyCliContracts, } from "./cli-contracts/tool-schema.js";

package/dist/sdk/cli-contracts.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8f665958-197a-5f20-8904-0a59a623f30f")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c008aee5-ffe9-5da2-b1d9-6fb9fb6684c5")}catch(e){}}();
 export { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, } from "./cli-contracts/command-aliases.js";
 export { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "./cli-contracts/commander-types.js";
 export { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, } from "./cli-contracts/commander-mutation-options.js";
@@ -7,12 +7,12 @@ export { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEAT
 // tables live in sibling modules and are re-exported here so existing import
 // sites (sdk/index.ts, mcp/server.ts, commands/contracts.ts, completion.ts, …)
 // keep importing everything from "./cli-contracts.js" unchanged.
-export { PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_CLI_ONLY_TOOL_ACTION_WAIVERS, PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS, PM_ITEM_ACTION_SUBCOMMANDS, PM_DEPRECATED_TOOL_ACTIONS, PM_DISCOVERABLE_TOOL_ACTIONS, PM_TOOL_ACTIONS, analyzePmToolActionParity, isPmToolAction, isPmExtensionCapabilityContract, isPmExtensionServiceNameContract, isPmExtensionPolicyModeContract, isPmExtensionPolicySurfaceContract, } from "./cli-contracts/enum-contracts.js";
+export { MERGE_SUBCOMMAND_VALUES, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_CLI_ONLY_TOOL_ACTION_WAIVERS, PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS, PM_ITEM_ACTION_SUBCOMMANDS, PM_DEPRECATED_TOOL_ACTIONS, PM_DISCOVERABLE_TOOL_ACTIONS, PM_TOOL_ACTIONS, analyzePmToolActionParity, isPmToolAction, isPmExtensionCapabilityContract, isPmExtensionServiceNameContract, isPmExtensionPolicyModeContract, isPmExtensionPolicySurfaceContract, } from "./cli-contracts/enum-contracts.js";
 export { TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_CREATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CALENDAR_OPTION_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_DEPS_OPTION_CONTRACTS, TOOL_GRAPH_OPTION_CONTRACTS, TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE, TOOL_CREATE_OPTION_CONTRACT_SOURCE, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE, TOOL_UPDATE_OPTION_CONTRACT_SOURCE, verifyToolOptionCliParity, } from "./cli-contracts/tool-option-contracts.js";
-export { PM_POSITIONAL_ACTION_CONTRACTS, } from "./cli-contracts/grammar-contracts.js";
+export { PM_COMMAND_POSITIONAL_CONTRACTS, PM_POSITIONAL_ACTION_CONTRACTS, } from "./cli-contracts/grammar-contracts.js";
 export { withFlagAliasMetadata, compactFlagAliasContracts, resolvePmPositionalActionFlagContracts, SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_SCOPE_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, REINDEX_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, EVENT_FLAG_CONTRACTS, EVENTS_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, hasSubcommandFlagContractsForCommand, resolveSubcommandFlagContractsForCommand, toCompletionFlagString, } from "./cli-contracts/flag-contracts.js";
 export { buildPmActionToolInputSchema, PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES, resolvePmToolCustomFieldCollision, CLOSE_ACTION_OPTION_KEYS, PLAN_CREATE_METADATA_PARAMETER_KEYS, PM_TOOL_ACTION_PARAMETER_CONTRACTS, PM_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA_MAJOR, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA, _testOnlyCliContracts, } from "./cli-contracts/tool-schema.js";
 export { analyzeSdkCliParameterCompleteness, } from "./cli-contracts/completeness.js";
 export { PM_COMMAND_OUTPUT_BUDGET_CONTRACTS, PM_DIAGNOSTIC_DEGRADATION_STEPS, PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS, PM_DIAGNOSTIC_OUTPUT_CLASSES, PM_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, projectPmDiagnosticOutput, projectPmDiagnosticText, resolvePmDiagnosticOutputBudget, resolvePmCommandOutputBudget, } from "./cli-contracts/agent-output-contracts.js";
 //# sourceMappingURL=cli-contracts.js.map
-//# debugId=8f665958-197a-5f20-8904-0a59a623f30f
+//# debugId=c008aee5-ffe9-5da2-b1d9-6fb9fb6684c5

package/dist/sdk/config.d.ts

@@ -6,6 +6,7 @@
 import { type ConfigKey } from "../core/config/positional-value.js";
 import { type NestedSettingDescriptor } from "../core/config/nested-settings.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";
+import { type AgentIdentityVocabularyMutationPreview, type AgentIdentityVocabularySummary } from "./agent/identity-config.js";
 import type { GovernanceCloseValidationDefault, GovernanceCreateModeDefault, GovernanceOwnershipEnforcement, GovernancePreset, GovernanceWorkflowEnforcement, ItemFormat, ParentReferencePolicy, SprintReleaseFormatPolicy, ValidateMetadataProfile, ValidateMetadataRequiredField } from "../types/index.js";
 declare const CONFIG_SCOPE_VALUES: readonly ["project", "global"];
 type ConfigScope = (typeof CONFIG_SCOPE_VALUES)[number];
@@ -15,7 +16,7 @@ type TestResultTrackingPolicy = "enabled" | "disabled";
 type TelemetryTrackingPolicy = "enabled" | "disabled";
 type GovernanceForceRequiredForStaleLockPolicy = "enabled" | "disabled";
 type GovernanceRequireCloseReasonPolicy = "enabled" | "disabled";
-type ConfigValue = string | string[] | ItemFormat | HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | ContextConfigValue;
+type ConfigValue = string | string[] | ItemFormat | HistoryMissingStreamPolicy | SprintReleaseFormatPolicy | ParentReferencePolicy | ValidateMetadataProfile | GovernancePreset | GovernanceOwnershipEnforcement | GovernanceCreateModeDefault | GovernanceCloseValidationDefault | GovernanceRequireCloseReasonPolicy | GovernanceWorkflowEnforcement | GovernanceForceRequiredForStaleLockPolicy | TestResultTrackingPolicy | TelemetryTrackingPolicy | AgentIdentityVocabularySummary | ContextConfigValue;
 interface ContextConfigValue {
     default_depth: string;
     activity_limit: number;
@@ -110,6 +111,10 @@ export interface ConfigResult {
     count?: number;
     /** Configuration controlling context behavior. */
     context_settings?: ContextConfigValue;
+    /** Privacy-safe revision/count projection for legacy author interpretation. */
+    identity_vocabulary?: AgentIdentityVocabularySummary;
+    /** Dry-run or committed vocabulary mutation receipt without alias spellings. */
+    vocabulary_mutation?: AgentIdentityVocabularyMutationPreview;
     /** Whether explicit item format applies to this operation. */
     has_explicit_item_format?: boolean;
     /** Value that configures or reports migration for this contract. */

package/dist/sdk/config.js

@@ -4,7 +4,7 @@
  * Implements the pm config command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5918331a-46e9-5699-b85d-89f49a27d341")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2f750f85-6c55-5f0f-b5c0-396764839d2a")}catch(e){}}();
 import { resolveConfigPositionalValue, } from "../core/config/positional-value.js";
 import { NESTED_SETTING_DESCRIPTORS, parseNestedSettingValue, readNestedSettingValue, resolveNestedSettingDescriptor, writeNestedSettingValue, } from "../core/config/nested-settings.js";
 import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
@@ -16,6 +16,7 @@ import { resolveItemTypesFilePath } from "../core/schema/runtime-schema.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { createUnknownSubcommandError } from "./agent/subcommand-recovery.js";
+import { planAgentIdentityVocabularyMutation, summarizeAgentIdentityVocabulary, } from "./agent/identity-config.js";
 import { assertInitializedTracker } from "./environment/tracker-preflight.js";
 import { migrateItemFilesToFormat } from "../core/store/item-format-migration.js";
 import { getSettingsPath, resolveGlobalPmRoot, resolvePmRoot, } from "../core/store/paths.js";
@@ -99,7 +100,15 @@ const CONFIG_KEY_ALIASES = {
         "governance_force_required_for_stale_lock",
     ],
     test_result_tracking: ["test-result-tracking", "test_result_tracking"],
+    untrusted_linked_test_execution: [
+        "untrusted-linked-test-execution",
+        "untrusted_linked_test_execution",
+    ],
     telemetry_tracking: ["telemetry-tracking", "telemetry_tracking"],
+    agent_identity_vocabulary: [
+        "agent-identity-vocabulary",
+        "agent_identity_vocabulary",
+    ],
     context: ["context"],
 };
 // Canonical kebab-case forms (first alias entry per key). Used for the invalid-key
@@ -130,7 +139,9 @@ const CONFIG_KEY_SUMMARIES = {
     governance_metadata_validation_profile: "Governance metadata validation profile (core|strict|custom).",
     governance_force_required_for_stale_lock: "Governance stale-lock force policy (enabled|disabled).",
     test_result_tracking: "Item-level linked test result persistence policy.",
+    untrusted_linked_test_execution: "Permit an explicit per-run override for commands not trusted by this clone.",
     telemetry_tracking: "Telemetry usage reporting policy.",
+    agent_identity_vocabulary: "Versioned exact legacy-author interpretation vocabulary (summary only).",
     context: "Context command settings (depth, section toggles, limits).",
 };
 const LIFECYCLE_PATTERN_CONFIG_KEYS = [
@@ -145,6 +156,7 @@ const CRITERIA_CONFIG_KEYS = new Set([
 ]);
 const TRACKING_CONFIG_KEYS = new Set([
     "test_result_tracking",
+    "untrusted_linked_test_execution",
     "telemetry_tracking",
 ]);
 const GOVERNANCE_BOOLEAN_CONFIG_KEYS = new Set([
@@ -232,11 +244,14 @@ function normalizeHistoryMissingStreamPolicy(value) {
     throw new PmCliError("Config set history-missing-stream-policy requires --policy with one of: auto_create, strict_error", EXIT_CODE.USAGE);
 }
 function normalizeTestResultTrackingPolicy(value) {
+    return normalizeEnabledDisabledPolicy(value, "test-result-tracking");
+}
+function normalizeEnabledDisabledPolicy(value, key) {
     const normalized = value?.trim().toLowerCase().replaceAll("-", "_");
     if (normalized === "enabled" || normalized === "disabled") {
         return normalized;
     }
-    throw new PmCliError("Config set test-result-tracking requires --policy with one of: enabled, disabled", EXIT_CODE.USAGE);
+    throw new PmCliError(`Config set ${key} requires --policy with one of: enabled, disabled`, EXIT_CODE.USAGE);
 }
 function normalizeTelemetryTrackingPolicy(value) {
     const normalized = value?.trim().toLowerCase().replaceAll("-", "_");
@@ -320,7 +335,15 @@ function normalizeGovernanceRequireCloseReasonPolicy(value) {
     }
     throw new PmCliError("Config set governance-require-close-reason requires --policy with one of: enabled, disabled", EXIT_CODE.USAGE);
 }
+const ENABLED_DISABLED_CONFLICT_POLICY_KEYS = {
+    test_result_tracking: "test-result-tracking",
+    untrusted_linked_test_execution: "untrusted-linked-test-execution",
+};
 function normalizePolicyForConflict(key, value) {
+    const enabledDisabledKey = ENABLED_DISABLED_CONFLICT_POLICY_KEYS[key];
+    if (enabledDisabledKey) {
+        return normalizeEnabledDisabledPolicy(value, enabledDisabledKey);
+    }
     switch (key) {
         case "history_missing_stream_policy":
             return normalizeHistoryMissingStreamPolicy(value);
@@ -346,8 +369,6 @@ function normalizePolicyForConflict(key, value) {
             return normalizeGovernanceWorkflowEnforcement(value);
         case "governance_force_required_for_stale_lock":
             return normalizeGovernanceForceRequiredForStaleLockPolicy(value);
-        case "test_result_tracking":
-            return normalizeTestResultTrackingPolicy(value);
         case "telemetry_tracking":
             return normalizeTelemetryTrackingPolicy(value);
         default:
@@ -477,7 +498,9 @@ const CONFIG_VALUE_READERS = {
     governance_metadata_validation_profile: (settings) => settings.governance.metadata_profile,
     governance_force_required_for_stale_lock: (settings) => settings.governance.force_required_for_stale_lock ? "enabled" : "disabled",
     test_result_tracking: (settings) => settings.testing.record_results_to_items ? "enabled" : "disabled",
+    untrusted_linked_test_execution: (settings) => settings.testing.allow_untrusted_linked_tests ? "enabled" : "disabled",
     telemetry_tracking: (settings) => settings.telemetry.enabled ? "enabled" : "disabled",
+    agent_identity_vocabulary: (settings) => summarizeAgentIdentityVocabulary(settings.agent_identity?.identity_vocabulary),
     context: (settings) => ({
         default_depth: settings.context.default_depth,
         activity_limit: settings.context.activity_limit,
@@ -642,7 +665,7 @@ function buildConfigListResult(context) {
     const keys = Object.keys(CONFIG_KEY_ALIASES).map((candidate) => ({
         key: candidate,
         aliases: CONFIG_KEY_ALIASES[candidate],
-        value_kind: candidate === "context"
+        value_kind: candidate === "context" || candidate === "agent_identity_vocabulary"
             ? "object"
             : isCriteriaConfigKey(candidate)
                 ? "string_array"
@@ -654,11 +677,13 @@ function buildConfigListResult(context) {
                 "--stale-threshold-days",
                 "--section-<name>",
             ]
-            : isCriteriaConfigKey(candidate)
-                ? ["--criterion", "--clear-criteria"]
-                : candidate === "item_format"
-                    ? ["--format"]
-                    : ["--policy"],
+            : candidate === "agent_identity_vocabulary"
+                ? ["--policy", "--value", "--criterion"]
+                : isCriteriaConfigKey(candidate)
+                    ? ["--criterion", "--clear-criteria"]
+                    : candidate === "item_format"
+                        ? ["--format"]
+                        : ["--policy"],
         summary: CONFIG_KEY_SUMMARIES[candidate],
         value: readConfigValue(context.settings, candidate),
     }));
@@ -669,9 +694,7 @@ function buildConfigListResult(context) {
         kind: descriptor.kind,
         value: readNestedSettingValue(context.settings, descriptor),
         summary: descriptor.summary,
-        ...(descriptor.choices
-            ? { choices: [...descriptor.choices] }
-            : {}),
+        ...(descriptor.choices ? { choices: [...descriptor.choices] } : {}),
         ...(descriptor.min === undefined ? {} : { min: descriptor.min }),
         ...(descriptor.max === undefined ? {} : { max: descriptor.max }),
     }));
@@ -714,6 +737,12 @@ function buildConfigGetResult(context, key) {
     if (key === "context") {
         return withWarnings({ ...base, context_settings: value }, context.warnings);
     }
+    if (key === "agent_identity_vocabulary") {
+        return withWarnings({
+            ...base,
+            identity_vocabulary: value,
+        }, context.warnings);
+    }
     if (Array.isArray(value)) {
         return withWarnings({ ...base, criteria: value }, context.warnings);
     }
@@ -987,6 +1016,16 @@ async function setTrackingConfig(context, key, options) {
         await writeConfigSettingsIfChanged(context, changed, "config:set:test_result_tracking");
         return buildPolicyResult(context, key, context.settings.testing.record_results_to_items ? "enabled" : "disabled", changed);
     }
+    if (key === "untrusted_linked_test_execution") {
+        const nextPolicy = normalizeEnabledDisabledPolicy(options.policy, "untrusted-linked-test-execution");
+        const nextEnabled = nextPolicy === "enabled";
+        const changed = context.settings.testing.allow_untrusted_linked_tests !== nextEnabled;
+        context.settings.testing.allow_untrusted_linked_tests = nextEnabled;
+        await writeConfigSettingsIfChanged(context, changed, "config:set:untrusted_linked_test_execution");
+        return buildPolicyResult(context, key, context.settings.testing.allow_untrusted_linked_tests
+            ? "enabled"
+            : "disabled", changed);
+    }
     const nextPolicy = normalizeTelemetryTrackingPolicy(options.policy);
     const nextEnabled = nextPolicy === "enabled";
     const changed = context.settings.telemetry.enabled !== nextEnabled ||
@@ -1005,6 +1044,69 @@ async function setDefinitionOfDoneConfig(context, key, options) {
     await writeConfigSettingsIfChanged(context, changed, "config:set:definition_of_done");
     return buildCriteriaResult(context, key, [...context.settings.workflow.definition_of_done], changed);
 }
+function parseAgentIdentityVocabularyOperation(raw) {
+    const policy = raw?.trim().toLowerCase().replaceAll("_", "-");
+    const dryRun = policy?.startsWith("preview-") === true;
+    const operation = dryRun ? policy.slice("preview-".length) : policy;
+    if (operation === "add" || operation === "remove" || operation === "clear") {
+        return { operation, dryRun };
+    }
+    throw new PmCliError("Config set agent-identity-vocabulary requires --policy add|remove|clear|preview-add|preview-remove|preview-clear", EXIT_CODE.USAGE);
+}
+function parseAgentIdentityVocabularyMutationValue(operation, value) {
+    if (operation === "add") {
+        const separator = value?.lastIndexOf("=") ?? -1;
+        if (separator <= 0 || separator === value.length - 1) {
+            throw new PmCliError('Config set agent-identity-vocabulary --policy add requires --value "<legacy-author>=<canonical-harness>"', EXIT_CODE.USAGE);
+        }
+        return {
+            legacy_author: value.slice(0, separator),
+            canonical_harness: value.slice(separator + 1),
+        };
+    }
+    if (operation === "remove") {
+        if (value === undefined) {
+            throw new PmCliError("Config set agent-identity-vocabulary --policy remove requires --value <legacy-author>", EXIT_CODE.USAGE);
+        }
+        return { legacy_author: value };
+    }
+    if (value !== undefined) {
+        throw new PmCliError("Config set agent-identity-vocabulary --policy clear does not accept --value", EXIT_CODE.USAGE);
+    }
+    return {};
+}
+async function setAgentIdentityVocabularyConfig(context, options) {
+    const { operation, dryRun } = parseAgentIdentityVocabularyOperation(options.policy);
+    const mutationValue = parseAgentIdentityVocabularyMutationValue(operation, options.value);
+    let planned;
+    try {
+        planned = planAgentIdentityVocabularyMutation(context.settings.agent_identity?.identity_vocabulary, {
+            operation,
+            ...mutationValue,
+            observed_authors: options.criterion,
+        });
+    }
+    catch (error) {
+        throw new PmCliError(error.message, EXIT_CODE.USAGE);
+    }
+    if (planned.preview.changed && !dryRun) {
+        context.settings.agent_identity = {
+            ...context.settings.agent_identity,
+            identity_vocabulary: planned.vocabulary,
+        };
+        await writeConfigSettingsIfChanged(context, true, `config:set:agent_identity.identity_vocabulary:${operation}:v${planned.preview.version_after}`);
+    }
+    return withWarnings({
+        scope: context.scope,
+        key: "agent_identity_vocabulary",
+        identity_vocabulary: summarizeAgentIdentityVocabulary(dryRun
+            ? context.settings.agent_identity?.identity_vocabulary
+            : planned.vocabulary),
+        vocabulary_mutation: planned.preview,
+        settings_path: context.target.settingsPath,
+        changed: planned.preview.changed && !dryRun,
+    }, context.warnings);
+}
 async function setConfigValue(context, key, options) {
     if (options.clearCriteria === true && !isCriteriaConfigKey(key)) {
         throw new PmCliError("--clear-criteria is only supported with config set criteria-list keys", EXIT_CODE.USAGE);
@@ -1015,6 +1117,9 @@ async function setConfigValue(context, key, options) {
     if (key === "context") {
         return applyContextConfig(context.settings, options, context.target, context.scope, context.warnings);
     }
+    if (key === "agent_identity_vocabulary") {
+        return setAgentIdentityVocabularyConfig(context, options);
+    }
     if (key === "definition_of_done") {
         return setDefinitionOfDoneConfig(context, key, options);
     }
@@ -1097,4 +1202,4 @@ export const _testOnlyConfigCommand = {
     normalizeWarnings,
 };
 //# sourceMappingURL=config.js.map
-//# debugId=5918331a-46e9-5699-b85d-89f49a27d341
+//# debugId=2f750f85-6c55-5f0f-b5c0-396764839d2a

package/dist/sdk/context-intent-contracts.js

@@ -5,7 +5,7 @@
  * workspace configuration, and packages.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="86db3dad-99b9-5c48-be52-990f110ac81f")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="da15ca02-02cc-5886-8c82-610939b8581c")}catch(e){}}();
 import { AsyncLocalStorage } from "node:async_hooks";
 import { renderPmCommand } from "./command-line.js";
 import { attachOutputOmissionReceipt } from "./output-projection.js";
@@ -202,6 +202,8 @@ export function resolveContextIntentContract(command, intent, contracts = getAct
         code: "unknown_context_intent",
         reason: "unknown_intent",
         field: "for",
+        flag: "--for",
+        value: normalizedIntent,
         required: `Use a declared ${normalizedCommand} intent.`,
         why: "Intent names are command-local contracts and cannot be inferred from output section names.",
         nextSteps: [suggestedCommand],
@@ -701,4 +703,4 @@ export function attachReadOutputContracts(command, options, result) {
     return stabilizeSuppressedRowContractReceipts(Object.fromEntries(Object.entries(projected).filter(([key]) => key !== "row_contract")), options);
 }
 //# sourceMappingURL=context-intent-contracts.js.map
-//# debugId=86db3dad-99b9-5c48-be52-990f110ac81f
+//# debugId=da15ca02-02cc-5886-8c82-610939b8581c

package/dist/sdk/core-governance.d.ts

@@ -4,7 +4,7 @@
  * Defines the shared agent-provenance and CLI-completeness governance surface
  * exposed by both the focused core entrypoint and the complete SDK barrel.
  */
-export { AGENT_PROVENANCE_DIMENSIONS, BUILTIN_HARNESS_SIGNAL_DESCRIPTORS, diagnoseAgentIdentity, detectAgentIdentity, detectHarnessIdentity, readAuthorEnvironment, registerHarnessSignalDescriptors, resolveAuthorIdentity, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, type AgentClientInfo, type AgentModelSource, type AgentProvenance, type AgentProvenanceAbsenceReason, type AgentProvenanceObservation, type AgentProvenanceOutcome, type AuthorSource, type DetectedAgentIdentity, type DiagnosedAgentIdentity, type HarnessDetectionSignals, type HarnessSignalDescriptor, type ResolvedAuthorIdentity, } from "../core/shared/author.js";
+export { AGENT_PROVENANCE_DIMENSIONS, BUILTIN_AGENT_PROVENANCE_ADAPTERS, BUILTIN_HARNESS_SIGNAL_DESCRIPTORS, diagnoseAgentIdentity, detectAgentIdentity, detectHarnessIdentity, listAgentProvenanceAdapters, normalizeAgentProvenanceAdapterValue, readAuthorEnvironment, registerHarnessSignalDescriptors, registerAgentProvenanceAdapters, resolveAuthorIdentity, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, type AgentClientInfo, type AgentProvenanceAdapter, type AgentModelSource, type AgentProvenance, type AgentProvenanceAbsenceReason, type AgentProvenanceObservation, type AgentProvenanceOutcome, type NormalizedAgentProvenanceAdapterValue, type AuthorSource, type DetectedAgentIdentity, type DiagnosedAgentIdentity, type HarnessDetectionSignals, type HarnessSignalDescriptor, type ResolvedAuthorIdentity, } from "../core/shared/author.js";
 export { SEMANTIC_ATTRIBUTION_LIMITS, recordClaimSemanticAttribution, recordFocusSemanticAttribution, recordReleaseSemanticAttribution, resolveSemanticLineageIds, semanticAttributionAffinity, } from "./context/semantic-session-attribution.js";
 export { explainSourceTraceability, parseSourceLineRange, type SourceDecisionPath, type SourceLineRange, type SourceTraceabilityEvidence, type SourceTraceabilityExplanation, type SourceTraceabilityRationale, type SourceTraceabilityReceipt, } from "./traceability/source-traceability.js";
 export { analyzeAgentProvenanceDescriptorCoverage, evaluateSemanticAttributionCoverage, groupHistoryByEpisode, resolveHistoryEpisodeGroupIdentity, summarizeAgentProvenance, summarizeAgentModelProvenance, type AgentEpisodeGroup, type AgentModelProvenanceCoverage, type AgentProvenanceDimensionCoverage, type AgentProvenanceDescriptorCoverage, type AgentSemanticAttributionCoverage, type AgentSemanticAttributionCoverageGate, } from "./provenance.js";

package/dist/sdk/core-governance.js

@@ -5,11 +5,11 @@
  * exposed by both the focused core entrypoint and the complete SDK barrel.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d19cfa31-a02f-53a7-8685-5d169d6e051d")}catch(e){}}();
-export { AGENT_PROVENANCE_DIMENSIONS, BUILTIN_HARNESS_SIGNAL_DESCRIPTORS, diagnoseAgentIdentity, detectAgentIdentity, detectHarnessIdentity, readAuthorEnvironment, registerHarnessSignalDescriptors, resolveAuthorIdentity, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, } from "../core/shared/author.js";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="cea03617-5e90-5683-a9d1-289087ed4646")}catch(e){}}();
+export { AGENT_PROVENANCE_DIMENSIONS, BUILTIN_AGENT_PROVENANCE_ADAPTERS, BUILTIN_HARNESS_SIGNAL_DESCRIPTORS, diagnoseAgentIdentity, detectAgentIdentity, detectHarnessIdentity, listAgentProvenanceAdapters, normalizeAgentProvenanceAdapterValue, readAuthorEnvironment, registerHarnessSignalDescriptors, registerAgentProvenanceAdapters, resolveAuthorIdentity, runWithHarnessDetectionSignals, runWithWorkspaceHarnessSignalDescriptors, writeAuthorEnvironment, } from "../core/shared/author.js";
 export { SEMANTIC_ATTRIBUTION_LIMITS, recordClaimSemanticAttribution, recordFocusSemanticAttribution, recordReleaseSemanticAttribution, resolveSemanticLineageIds, semanticAttributionAffinity, } from "./context/semantic-session-attribution.js";
 export { explainSourceTraceability, parseSourceLineRange, } from "./traceability/source-traceability.js";
 export { analyzeAgentProvenanceDescriptorCoverage, evaluateSemanticAttributionCoverage, groupHistoryByEpisode, resolveHistoryEpisodeGroupIdentity, summarizeAgentProvenance, summarizeAgentModelProvenance, } from "./provenance.js";
 export { analyzeSdkCliParameterCompleteness, } from "./cli-contracts.js";
 //# sourceMappingURL=core-governance.js.map
-//# debugId=d19cfa31-a02f-53a7-8685-5d169d6e051d
+//# debugId=cea03617-5e90-5683-a9d1-289087ed4646

package/dist/sdk/extension/scaffold.js

@@ -4,7 +4,7 @@
  * Implements extension package-management support for Scaffold.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="30dfc6e4-27c5-56c0-981b-94e85b780f1f")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5321d574-4de4-5f94-99db-0c49639673fc")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { pathExists } from "../../core/fs/fs-utils.js";
@@ -1483,6 +1483,12 @@ function buildDeclarativeCapabilityTestBlock(extensionName, commandName, capabil
                     "",
                     "  // The starter provider reads only document title/id, so `settings` is a minimal",
                     "  // typed stub and `documents` carry just the fields it inspects.",
+                    "  const settings = {",
+                    "    testing: {",
+                    "      record_results_to_items: false,",
+                    "      allow_untrusted_linked_tests: false,",
+                    "    },",
+                    "  } as PmSettings;",
                     "  const query = await ext.runSearchProvider({",
                     `    provider: ${JSON.stringify(searchProviderName)},`,
                     '    operation: "query",',
@@ -1491,7 +1497,7 @@ function buildDeclarativeCapabilityTestBlock(extensionName, commandName, capabil
                     '      mode: "semantic",',
                     '      tokens: ["sync"],',
                     "      options: {},",
-                    "      settings: {} as PmSettings,",
+                    "      settings,",
                     "      documents: [",
                     '        { metadata: { id: "pm-1", title: "Sync external context" }, body: "" },',
                     '        { metadata: { id: "pm-2", title: "Unrelated task" }, body: "" },',
@@ -1503,14 +1509,14 @@ function buildDeclarativeCapabilityTestBlock(extensionName, commandName, capabil
                     "  const embedding = await ext.runSearchProvider({",
                     `    provider: ${JSON.stringify(searchProviderName)},`,
                     '    operation: "embed",',
-                    '    context: { input: "abc", settings: {} as PmSettings, model: "starter-model" },',
+                    '    context: { input: "abc", settings, model: "starter-model" },',
                     "  });",
                     "  assert.deepEqual(embedding, [3]);",
                     "",
                     "  const vectorHits = await ext.runVectorStoreAdapter({",
                     `    adapter: ${JSON.stringify(vectorAdapterName)},`,
                     '    operation: "query",',
-                    "    context: { vector: [0.1, 0.2], limit: 2, settings: {} as PmSettings },",
+                    "    context: { vector: [0.1, 0.2], limit: 2, settings },",
                     "  });",
                     '  assert.deepEqual(vectorHits, [{ id: "starter-vector-hit", score: 2 }]);',
                 ]),
@@ -2300,4 +2306,4 @@ export async function scaffoldExtensionProject(target, vocabulary = "extension",
     };
 }
 //# sourceMappingURL=scaffold.js.map
-//# debugId=30dfc6e4-27c5-56c0-981b-94e85b780f1f
+//# debugId=5321d574-4de4-5f94-99db-0c49639673fc

package/dist/sdk/flag-invocation-contracts.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="0f857893-8441-54ad-af99-abaae9af864d")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="32dca84c-9a21-570c-a0e0-0f0356c84c0d")}catch(e){}}();
 const FLAG_DESCRIPTIONS = Object.freeze({
     "--body": "Set the item body.",
     "--body-file": "Read the item body from a file.",
@@ -68,6 +68,7 @@ const BOOLEAN_FLAG_NAMES = new Set([
     "--all-affected-ids",
     "--all-day",
     "--all-streams",
+    "--acknowledge-linked-tests",
     "--append-stable",
     "--auto-fix",
     "--auto-pm-context",
@@ -133,6 +134,7 @@ const BOOLEAN_FLAG_NAMES = new Set([
     "--only-last",
     "--output-row-contract",
     "--override-linked-pm-context",
+    "--override-linked-workspace-context",
     "--packages-only",
     "--past",
     "--phrase-exact",
@@ -315,4 +317,4 @@ export function verifyCliFlagInvocationParity(command, declarations, observation
     };
 }
 //# sourceMappingURL=flag-invocation-contracts.js.map
-//# debugId=0f857893-8441-54ad-af99-abaae9af864d
+//# debugId=32dca84c-9a21-570c-a0e0-0f0356c84c0d

package/dist/sdk/generated/generated-error-code-catalog-part-1.js

@@ -1,6 +1,6 @@
 /** Generated partition 1 of the exhaustive error-code catalog. */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="2903ebb9-541a-5636-ae3c-e996d3f0cec4")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="30cf6de5-af9b-54a1-b376-1c9e5d543ae1")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_1 = [
     {
         code: "acceptance_criteria_mutation_conflict",
@@ -1656,6 +1656,18 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "invalid_read_output_session",
         aliases: [],
     },
+    {
+        code: "invalid_reproducible_process_environment",
+        meaning: "Invalid reproducible process environment condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/reproducibility/process.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "invalid_reproducible_process_environment",
+        aliases: [],
+    },
     {
         code: "invalid_workspace_snapshot_target",
         meaning: "Invalid workspace snapshot target condition.",
@@ -1968,6 +1980,42 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "missing_budget",
         aliases: [],
     },
+    {
+        code: "missing_cli_flag",
+        meaning: "Missing cli flag condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/cli-contracts/tool-option-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "missing_cli_flag",
+        aliases: [],
+    },
+    {
+        code: "missing_destination",
+        meaning: "Missing destination condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/cli-contracts/grammar-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "missing_destination",
+        aliases: [],
+    },
+    {
+        code: "missing_directory",
+        meaning: "Missing directory condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "missing_directory",
+        aliases: [],
+    },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-1.js.map
-//# debugId=2903ebb9-541a-5636-ae3c-e996d3f0cec4
+//# debugId=30cf6de5-af9b-54a1-b376-1c9e5d543ae1