@unbrained/pm-cli 2026.8.18 → 2026.8.19

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

@@ -14,7 +14,7 @@ import { type PmCommandVisibilityTier } from "../agent-capability-contracts.js";
 import type { PmErrorCodeContract } from "../error-code-catalog.js";
 import { type PmCommandOutputEnvelopeContract } from "../output-contracts.js";
 import { type PmCommandExitContract, type PmCommandExitOutcomeContract } from "./command-exit-contracts.js";
-import { type PmCommandDestinationContract } from "./grammar-contracts.js";
+import { type PmCommandPositionalContract, type PmCommandDestinationContract } from "./grammar-contracts.js";
 /** Documents the contracts command options payload exchanged by command, SDK, and package integrations. */
 export interface ContractsCommandOptions {
     /** Value that configures or reports action for this contract. */
@@ -39,6 +39,7 @@ interface CommandFlagSurface {
     canonical_command?: string;
     visibility?: PmCommandVisibilityTier;
     flags: CliFlagContract[];
+    positionals?: PmCommandPositionalContract["slots"];
     flag_invocations?: CliFlagInvocationContract[];
     provider?: "core" | "extension" | "mixed";
     extension_sources?: Array<{
@@ -106,6 +107,11 @@ export interface ContractsResult {
         scope_before_verb: boolean;
         visible_top_level_ceiling: number;
         ceiling_raise_requires_pm_item: boolean;
+        positional_shape_budget: number;
+        positional_shape_count: number;
+        positional_action_count: number;
+        positional_action_parents: readonly string[];
+        positional_signatures?: readonly PmCommandPositionalContract[];
         destinations?: readonly PmCommandDestinationContract[];
     };
     /** Value that configures or reports commander aliases for this contract. */
@@ -251,10 +257,12 @@ interface CommandSummarySurface {
     command: string;
     aliases?: string[];
     intent: string;
-    intent_source: "command" | "description" | "generated";
+    /** Non-default provenance in compact output; exhaustive provenance in full output. */
+    intent_source?: "command" | "description" | "generated";
     flags?: string[];
     default_max_estimated_tokens: number;
-    default_max_estimated_tokens_by_format: {
+    /** Full-projection format detail; compact summaries retain the canonical default only. */
+    default_max_estimated_tokens_by_format?: {
         toon: number;
         json: number;
     };
@@ -302,7 +310,10 @@ declare function buildRuntimeFieldFlagContracts(fieldRegistry: RuntimeFieldRegis
 export declare function buildCommandAliasSurface(commands: string[], aliasContracts?: readonly PmCommandAliasContract[]): CommandAliasSurface[];
 declare function attachCreateRequiredOptionContracts(schema: Record<string, unknown>, metadata: Record<string, unknown>): Record<string, unknown>;
 declare function readContractsSettings(pmRoot: string, readSettingsFn?: typeof readSettings): Promise<Awaited<ReturnType<typeof readSettings>>>;
-declare function buildCommandSummarySurface(commands: readonly string[], extensionContracts?: readonly ExtensionCommandContract[]): CommandSummarySurface[];
+declare function buildCommandSummarySurface(commands: readonly string[], extensionContracts?: readonly ExtensionCommandContract[], options?: {
+    includeFormatBudgets?: boolean;
+    includeIntentProvenance?: boolean;
+}): CommandSummarySurface[];
 declare function buildCommandOutputContracts(commands: readonly string[]): NonNullable<ContractsResult["command_output_contracts"]>;
 declare function buildCommandExitContractGroups(commands: readonly string[]): NonNullable<ContractsResult["command_exit_contracts"]>["command_sets"];
 /** Implements run contracts for the public runtime surface of this module. */

package/dist/sdk/cli-contracts/runtime-contracts.js

@@ -4,10 +4,11 @@
  * Implements the pm contracts 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]="9a66a2a0-94be-595b-983d-347ec95af85e")}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]="30d9b9dd-f0a1-578e-90d6-3c019e0435b5")}catch(e){}}();
 import { EXIT_CODE, SETTINGS_DEFAULTS, PmCliError, activateExtensions, getActiveExtensionRegistrations, loadExtensions, pathExists, commandOptionFlagLabel, resolveCommandOptionPolicyState, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, getSettingsPath, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
 import { buildMcpToolContracts, } from "../../mcp/tool-definitions.js";
 import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_OUTPUT_DEGRADATION_STEPS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_DEPRECATED_TOOL_ACTIONS, PM_TOOL_ACTIONS, PM_TOOL_PARAMETERS_SCHEMA, REINDEX_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, compactFlagAliasContracts, PM_COMMAND_ALIAS_CONTRACTS, resolvePmCommandOutputBudget, } from "../cli-contracts.js";
+import { PM_POSITIONAL_ACTION_FLAG_CONTRACTS } from "./flag-contracts.js";
 import { GOVERNANCE_CLOSE_VALIDATION_DEFAULT_VALUES, GOVERNANCE_CREATE_MODE_DEFAULT_VALUES, GOVERNANCE_OWNERSHIP_ENFORCEMENT_VALUES, GOVERNANCE_WORKFLOW_ENFORCEMENT_VALUES, } from "../../types.js";
 import { BRIEF_LIST_FIELDS, DEFAULT_COMPACT_LIST_FIELDS, LIST_COMMAND_DEFAULT_PROJECTIONS, } from "../query/list.js";
 import { getActiveContextIntentContracts, } from "../context-intent-contracts.js";
@@ -19,7 +20,7 @@ import { resolvePmCommandOutputEnvelope, } from "../output-contracts.js";
 import { PM_COMMAND_EXIT_OUTCOME_CONTRACTS, resolvePmCommandExitContract, } from "./command-exit-contracts.js";
 import { BUILTIN_RELATIONSHIP_KINDS } from "../relationship-kinds/contract.js";
 import { ASSURANCE_GATE_TRIGGERS, ASSURANCE_MEASUREMENT_SOURCE_KINDS, } from "../governance/assurance.js";
-import { PM_CLI_GRAMMAR_CONTRACT, PM_COMMAND_DESTINATION_CONTRACTS, } from "./grammar-contracts.js";
+import { PM_CLI_GRAMMAR_CONTRACT, PM_COMMAND_DESTINATION_CONTRACTS, PM_COMMAND_POSITIONAL_CONTRACTS, PM_POSITIONAL_ACTION_CONTRACTS, positionalShapeKey, resolvePmCommandPositionalContract, } from "./grammar-contracts.js";
 const AGENT_BOOTSTRAP_FLAGS = new Map([
     [
         "claim",
@@ -410,6 +411,7 @@ const CORE_COMMAND_FLAG_CONTRACT_ENTRIES = [
     ["validate", VALIDATE_FLAG_CONTRACTS],
     ["health", HEALTH_FLAG_CONTRACTS],
     ["assurance", ASSURANCE_FLAG_CONTRACTS],
+    ...PM_POSITIONAL_ACTION_FLAG_CONTRACTS,
     ["contracts", CONTRACTS_FLAG_CONTRACTS],
     ["completion", COMPLETION_FLAG_CONTRACTS],
     ["activity", ACTIVITY_FLAG_CONTRACTS],
@@ -460,7 +462,8 @@ function actionDescriptorMatchesSelectedCommand(descriptor, selectedCommand) {
         if (commandPath === selectedCommand) {
             return true;
         }
-        return commandPath.startsWith(`${selectedCommand} `);
+        return (commandPath.startsWith(`${selectedCommand} `) ||
+            selectedCommand.startsWith(`${commandPath} `));
     });
 }
 function splitCommandPathAliases(commandPath) {
@@ -1184,6 +1187,7 @@ function buildCommandFlagSurface(commands, extensionFlagMap, runtimeFieldFlagMap
                 ? {
                     canonical_command: canonicalSummaryCommand(command),
                     visibility: resolvePmCommandVisibilityTier(canonicalSummaryCommand(command)),
+                    positionals: resolvePmCommandPositionalContract(command)?.slots ?? [],
                     flag_invocations: enrichCliFlagInvocationContracts(command, flags),
                 }
                 : {}),
@@ -1716,7 +1720,9 @@ function summarizeCommandIntent(command, extensionContracts) {
         intent_source: "generated",
     };
 }
-function buildCommandSummarySurface(commands, extensionContracts = []) {
+function buildCommandSummarySurface(commands, extensionContracts = [], options = {}) {
+    const includeFormatBudgets = options.includeFormatBudgets ?? true;
+    const includeIntentProvenance = options.includeIntentProvenance ?? true;
     return [...new Set(commands.map(normalizeCommandPath))]
         .filter((command) => command.length > 0)
         .sort((left, right) => left.localeCompare(right))
@@ -1743,12 +1749,19 @@ function buildCommandSummarySurface(commands, extensionContracts = []) {
         const intent = summarizeCommandIntent(command, extensionContracts);
         return {
             command,
-            ...intent,
+            intent: intent.intent,
+            ...(includeIntentProvenance || intent.intent_source !== "command"
+                ? { intent_source: intent.intent_source }
+                : {}),
             ...(flags.length > 0 ? { flags } : {}),
             default_max_estimated_tokens: budget.default_max_estimated_tokens,
-            default_max_estimated_tokens_by_format: {
-                ...budget.default_max_estimated_tokens_by_format,
-            },
+            ...(includeFormatBudgets
+                ? {
+                    default_max_estimated_tokens_by_format: {
+                        ...budget.default_max_estimated_tokens_by_format,
+                    },
+                }
+                : {}),
         };
     });
 }
@@ -1927,8 +1940,11 @@ function attachCommanderAliasContractsResult(result, selection) {
         : "unfiltered_default_brief";
 }
 /** Attach the compact agent-facing command semantics shared by summary and full projections. */
-function attachAgentCommandContractsResult(result, outputCommands, extensionCommandContracts) {
-    result.command_summaries = buildCommandSummarySurface(outputCommands, extensionCommandContracts);
+function attachAgentCommandContractsResult(result, outputCommands, extensionCommandContracts, options) {
+    result.command_summaries = buildCommandSummarySurface(outputCommands, extensionCommandContracts, {
+        includeFormatBudgets: options.includeFormatBudgets,
+        includeIntentProvenance: options.includeIntentProvenance,
+    });
     result.output_policy = {
         token_estimate: "ceil(utf8_bytes / 4)",
         degradation_ladder: [...PM_OUTPUT_DEGRADATION_STEPS],
@@ -1940,6 +1956,15 @@ function attachAgentCommandContractsResult(result, outputCommands, extensionComm
         scope_before_verb: PM_CLI_GRAMMAR_CONTRACT.scope_before_verb,
         visible_top_level_ceiling: PM_CLI_GRAMMAR_CONTRACT.visible_top_level_ceiling,
         ceiling_raise_requires_pm_item: PM_CLI_GRAMMAR_CONTRACT.ceiling_raise_requires_pm_item,
+        positional_shape_budget: PM_CLI_GRAMMAR_CONTRACT.positional_shape_budget,
+        positional_shape_count: new Set(PM_COMMAND_POSITIONAL_CONTRACTS.map(({ slots }) => positionalShapeKey(slots))).size,
+        positional_action_count: PM_POSITIONAL_ACTION_CONTRACTS.length,
+        positional_action_parents: [
+            ...new Set(PM_POSITIONAL_ACTION_CONTRACTS.map(({ parent }) => parent)),
+        ].sort((left, right) => left.localeCompare(right)),
+        ...(options.includePositionalSignatures
+            ? { positional_signatures: PM_COMMAND_POSITIONAL_CONTRACTS }
+            : {}),
     };
 }
 /** Implements run contracts for the public runtime surface of this module. */
@@ -1954,8 +1979,13 @@ export async function runContracts(options, global) {
     const outputCommands = resolveOutputCommands(selection, commands);
     const result = createContractsResult(selection, schemaContext, actionContext, outputCommands);
     const extensionCommandContracts = resolveExtensionCommandContracts(selection, runtime, outputCommands);
+    const includeCommandDetails = selection.fullOutput || selection.selectedCommand !== undefined;
     if (selection.summary || selection.fullOutput) {
-        attachAgentCommandContractsResult(result, outputCommands, extensionCommandContracts);
+        attachAgentCommandContractsResult(result, outputCommands, extensionCommandContracts, {
+            includeFormatBudgets: includeCommandDetails,
+            includeIntentProvenance: includeCommandDetails,
+            includePositionalSignatures: includeCommandDetails,
+        });
     }
     if (selection.summary) {
         return result;
@@ -2030,4 +2060,4 @@ export const _testOnlyContractsCommand = {
     toRuntimeShortFlagToken,
 };
 //# sourceMappingURL=runtime-contracts.js.map
-//# debugId=9a66a2a0-94be-595b-983d-347ec95af85e
+//# debugId=30d9b9dd-f0a1-578e-90d6-3c019e0435b5

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

@@ -3,7 +3,34 @@
  *
  * Defines SDK command-contract metadata for Tool Option Contracts.
  */
-import type { ToolOptionFlagContract } from "./flag-contracts.js";
+import type { CliFlagContract, ToolOptionFlagContract } from "./flag-contracts.js";
+/** One SDK/MCP parameter spelling that cannot be executed by the matching CLI. */
+export interface ToolOptionCliParityFinding {
+    /** Stable remediation category. */
+    code: "missing_cli_flag" | "missing_parameter_alias";
+    /** SDK/MCP parameter key. */
+    parameter: string;
+    /** Canonical CLI flag selected by the tool transport. */
+    flag: string;
+    /** Executable parameter-shaped flag expected by cross-surface callers. */
+    parameter_flag: string;
+}
+/** Fail-closed receipt for one tool option table and executable CLI flag table. */
+export interface ToolOptionCliParityReport {
+    /** Whether every mapping and cross-surface spelling is executable. */
+    ok: boolean;
+    /** Number of tool parameter mappings inspected. */
+    parameter_count: number;
+    /** Number of executable CLI flag contracts inspected. */
+    cli_flag_count: number;
+    /** Missing canonical flags or direct parameter aliases. */
+    findings: ToolOptionCliParityFinding[];
+}
+/**
+ * Verify that every declared tool parameter maps to a real CLI flag and that
+ * its kebab-case spelling is accepted either canonically or as an alias.
+ */
+export declare function verifyToolOptionCliParity(toolOptions: readonly ToolOptionFlagContract[], cliFlags: readonly CliFlagContract[]): ToolOptionCliParityReport;
 /** Public contract for tool list filter option contracts, shared by SDK and presentation-layer consumers. */
 export declare const TOOL_LIST_FILTER_OPTION_CONTRACTS: ToolOptionFlagContract[];
 /** Public contract for tool aggregate option contracts, shared by SDK and presentation-layer consumers. */

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

@@ -1,6 +1,41 @@
-/** Returns fresh option contract objects so exported arrays cannot share mutable entries. */
+/**
+ * Verify that every declared tool parameter maps to a real CLI flag and that
+ * its kebab-case spelling is accepted either canonically or as an alias.
+ */
 
-!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]="e2028eff-b29e-5850-87b1-4a3e06f28964")}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]="88009976-e03f-5a67-b6fc-bf60240dde49")}catch(e){}}();
+export function verifyToolOptionCliParity(toolOptions, cliFlags) {
+    const findings = [];
+    for (const { param, flag } of toolOptions) {
+        const parameterFlag = `--${param.replace(/([a-z\d])([A-Z])/gu, "$1-$2").toLowerCase()}`;
+        const cliFlag = cliFlags.find((candidate) => candidate.flag === flag);
+        if (!cliFlag) {
+            findings.push({
+                code: "missing_cli_flag",
+                parameter: param,
+                flag,
+                parameter_flag: parameterFlag,
+            });
+            continue;
+        }
+        if (cliFlag.flag !== parameterFlag &&
+            !cliFlag.aliases?.includes(parameterFlag)) {
+            findings.push({
+                code: "missing_parameter_alias",
+                parameter: param,
+                flag,
+                parameter_flag: parameterFlag,
+            });
+        }
+    }
+    return {
+        ok: findings.length === 0,
+        parameter_count: toolOptions.length,
+        cli_flag_count: cliFlags.length,
+        findings,
+    };
+}
+/** Returns fresh option contract objects so exported arrays cannot share mutable entries. */
 function cloneOptionContracts(contracts) {
     return contracts.map((contract) => ({ ...contract }));
 }
@@ -424,4 +459,4 @@ export const TOOL_GRAPH_OPTION_CONTRACTS = [
     { param: "summary", flag: "--summary" },
 ];
 //# sourceMappingURL=tool-option-contracts.js.map
-//# debugId=e2028eff-b29e-5850-87b1-4a3e06f28964
+//# debugId=88009976-e03f-5a67-b6fc-bf60240dde49

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

@@ -16,10 +16,11 @@ export { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_COMMANDER_STRING_O
 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_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 { 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, } from "./cli-contracts/tool-option-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 { withFlagAliasMetadata, compactFlagAliasContracts, 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_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 { PM_POSITIONAL_ACTION_CONTRACTS, 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_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";
 export type { PmActionToolInputSchemaOptions, PmToolCustomFieldCollision, } 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]="75bd0f32-d93c-5737-801e-c66cdcc0f3f1")}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]="cec9e389-d3ff-57d4-9b9e-505a7dff2970")}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";
@@ -8,10 +8,11 @@ export { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEAT
 // 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_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, } from "./cli-contracts/tool-option-contracts.js";
-export { withFlagAliasMetadata, compactFlagAliasContracts, 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_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 { 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 { 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_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_OUTPUT_BUDGET_CLASSES, PM_OUTPUT_DEGRADATION_STEPS, createPmCommandOutputBudget, definePmCommandOutputBudget, estimatePmOutputTokens, inferPmOutputBudgetClass, resolvePmCommandOutputBudget, } from "./cli-contracts/agent-output-contracts.js";
 //# sourceMappingURL=cli-contracts.js.map
-//# debugId=75bd0f32-d93c-5737-801e-c66cdcc0f3f1
+//# debugId=cec9e389-d3ff-57d4-9b9e-505a7dff2970

package/dist/sdk/context-intent-contracts.d.ts

@@ -66,9 +66,9 @@ export declare function runWithContextIntentContracts<T>(layers: PmContextIntent
 /** Validate and compose core, package, and workspace intent declarations. Later layers override earlier layers by command and intent. */
 export declare function composeContextIntentContracts(workspaceContracts?: readonly PmContextIntentContract[], packageContracts?: readonly PmContextIntentContract[]): PmContextIntentContract[];
 /** Resolve one intent declaration or fail with the nearest command-local intent. */
-export declare function resolveContextIntentContract(command: string, intent: string, contracts?: readonly PmContextIntentContract[]): PmContextIntentContract | undefined;
+export declare function resolveContextIntentContract(command: string, intent: string, contracts?: readonly PmContextIntentContract[], positionalArguments?: readonly string[]): PmContextIntentContract | undefined;
 /** Apply one declared read intent's defaults while preserving explicit caller options. */
-export declare function applyContextIntentProjection(command: "context" | "get" | "list" | "next" | "search", options: Record<string, unknown>): Record<string, unknown>;
+export declare function applyContextIntentProjection(command: "context" | "get" | "list" | "next" | "search", options: Record<string, unknown>, positionalArguments?: readonly string[]): Record<string, unknown>;
 interface ContextIntentCursorEnvelope {
     fingerprint: string;
     after_index: number;

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

@@ -5,8 +5,9 @@
  * 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]="d09393aa-0253-5ad6-a2fe-245f31b9eb87")}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]="86db3dad-99b9-5c48-be52-990f110ac81f")}catch(e){}}();
 import { AsyncLocalStorage } from "node:async_hooks";
+import { renderPmCommand } from "./command-line.js";
 import { attachOutputOmissionReceipt } from "./output-projection.js";
 import { encodeQueryCursor } from "./pagination.js";
 import { applyReadOutputDimensions, stabilizeReadOutputReceiptEstimates, } from "./read-output-contracts.js";
@@ -153,7 +154,7 @@ export function composeContextIntentContracts(workspaceContracts = [], packageCo
         left.intent.localeCompare(right.intent));
 }
 /** Resolve one intent declaration or fail with the nearest command-local intent. */
-export function resolveContextIntentContract(command, intent, contracts = getActiveContextIntentContracts()) {
+export function resolveContextIntentContract(command, intent, contracts = getActiveContextIntentContracts(), positionalArguments = []) {
     const normalizedCommand = command.trim().toLowerCase();
     const normalizedIntent = intent.trim().toLowerCase();
     const exact = contracts.find((entry) => entry.command === normalizedCommand && entry.intent === normalizedIntent);
@@ -184,7 +185,19 @@ export function resolveContextIntentContract(command, intent, contracts = getAct
     })
         .sort((left, right) => left.distance - right.distance ||
         left.candidate.localeCompare(right.candidate))[0].candidate;
-    const suggestedCommand = `pm ${normalizedCommand} --for ${suggestion}`;
+    const attemptedArguments = [
+        normalizedCommand,
+        ...positionalArguments,
+        "--for",
+        normalizedIntent,
+    ];
+    const suggestedRetryArguments = [
+        normalizedCommand,
+        ...positionalArguments,
+        "--for",
+        suggestion,
+    ];
+    const suggestedCommand = renderPmCommand(suggestedRetryArguments);
     throw new PmCliError(`Unknown context intent "${normalizedIntent}" for ${normalizedCommand}. Did you mean "${suggestion}"?`, EXIT_CODE.USAGE, {
         code: "unknown_context_intent",
         reason: "unknown_intent",
@@ -194,8 +207,10 @@ export function resolveContextIntentContract(command, intent, contracts = getAct
         nextSteps: [suggestedCommand],
         recovery: {
             recovery_mode: "compact",
-            attempted_command: `pm ${normalizedCommand} --for ${normalizedIntent}`,
+            attempted_command: renderPmCommand(attemptedArguments),
+            allowed_values: [...candidates].sort(),
             suggested_retry: suggestedCommand,
+            suggested_retry_args: suggestedRetryArguments,
         },
     });
 }
@@ -266,7 +281,7 @@ const CONTEXT_INTENT_DEFAULT_APPLIERS = {
     },
 };
 /** Apply one declared read intent's defaults while preserving explicit caller options. */
-export function applyContextIntentProjection(command, options) {
+export function applyContextIntentProjection(command, options, positionalArguments = []) {
     const tokenBudget = options.tokenBudget ?? options.token_budget;
     if (typeof options.for !== "string") {
         if (tokenBudget !== undefined &&
@@ -289,7 +304,7 @@ export function applyContextIntentProjection(command, options) {
         delete projected.token_budget;
         return projected;
     }
-    const contract = resolveContextIntentContract(command, options.for);
+    const contract = resolveContextIntentContract(command, options.for, undefined, positionalArguments);
     const explicitTokenBudget = parsePositiveIntentTokenBudget(tokenBudget) !== undefined;
     const projected = { ...options };
     if (projected.tokenBudget === undefined && tokenBudget !== undefined) {
@@ -686,4 +701,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=d09393aa-0253-5ad6-a2fe-245f31b9eb87
+//# debugId=86db3dad-99b9-5c48-be52-990f110ac81f

package/dist/sdk/contracts.d.ts

@@ -10,7 +10,9 @@ export * from "./context-intent-contracts.js";
 export * from "./error-code-catalog.js";
 export * from "./generated-error-code-catalog.js";
 export * from "./flag-invocation-contracts.js";
+export * from "./cli-contracts/flag-lexicon-contracts.js";
 export * from "./output-token-accounting.js";
 export * from "./output-contracts.js";
 export * from "./read-output-contracts.js";
+export * from "./agent/refusal-closure.js";
 export type { PmReadOutputSessionReceipt, PmReadOutputSessionState, } from "./read-output-session.js";

package/dist/sdk/contracts.js

@@ -4,7 +4,7 @@
  * Exposes command and action contract data without loading SDK runtime code.
  */
 
-!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]="df504de1-de3b-55fe-baef-08c0d1dcf97f")}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]="c3e3b1f2-1898-5773-8b3f-55fa39f6c4e7")}catch(e){}}();
 export * from "./cli-contracts.js";
 export * from "./cli-contracts/grammar-contracts.js";
 export * from "./cli-contracts/command-exit-contracts.js";
@@ -12,8 +12,10 @@ export * from "./context-intent-contracts.js";
 export * from "./error-code-catalog.js";
 export * from "./generated-error-code-catalog.js";
 export * from "./flag-invocation-contracts.js";
+export * from "./cli-contracts/flag-lexicon-contracts.js";
 export * from "./output-token-accounting.js";
 export * from "./output-contracts.js";
 export * from "./read-output-contracts.js";
+export * from "./agent/refusal-closure.js";
 //# sourceMappingURL=contracts.js.map
-//# debugId=df504de1-de3b-55fe-baef-08c0d1dcf97f
+//# debugId=c3e3b1f2-1898-5773-8b3f-55fa39f6c4e7

package/dist/sdk/flag-invocation-contracts.d.ts

@@ -25,7 +25,44 @@ export interface CliFlagInvocationContract extends CliFlagContract {
     /** Sentinel that redirects the argv value to stdin. */
     stdin_token?: "-";
 }
+/** Executable option arity observed from the registered Commander program. */
+export interface CliFlagArityObservation {
+    /** Canonical command path owning the option. */
+    command: string;
+    /** Long option spelling. */
+    flag: string;
+    /** Whether the option consumes a value token. */
+    takes_value: boolean;
+    /** Whether the consumed value is mandatory. */
+    value_required: boolean;
+    /** Whether repeated values accumulate. */
+    repeatable: boolean;
+}
+/** One machine-readable mismatch between declared and executable flag arity. */
+export interface CliFlagInvocationParityFinding {
+    /** Stable finding code. */
+    code: "duplicate_observation" | "missing_observation" | "takes_value_mismatch" | "value_required_mismatch" | "repeatable_mismatch" | "undeclared_observation";
+    /** Canonical command path. */
+    command: string;
+    /** Long option spelling. */
+    flag: string;
+    /** Human-readable mismatch detail. */
+    detail: string;
+}
+/** Complete parity receipt for one command's declared and executable flags. */
+export interface CliFlagInvocationParityReport {
+    /** Whether the two surfaces agree exactly. */
+    ok: boolean;
+    /** Number of declared invocation rows. */
+    declared_count: number;
+    /** Number of executable observations. */
+    observed_count: number;
+    /** Stable mismatch list. */
+    findings: CliFlagInvocationParityFinding[];
+}
 /** Enrich one vocabulary row with deterministic invocation and input-channel metadata. */
 export declare function enrichCliFlagInvocationContract(command: string, contract: CliFlagContract): CliFlagInvocationContract;
 /** Enrich a complete command flag table without mutating package-owned rows. */
 export declare function enrichCliFlagInvocationContracts(command: string, contracts: readonly CliFlagContract[]): CliFlagInvocationContract[];
+/** Compare generated invocation rows with independently observed executable arity. */
+export declare function verifyCliFlagInvocationParity(command: string, declarations: readonly CliFlagInvocationContract[], observations: readonly CliFlagArityObservation[]): CliFlagInvocationParityReport;