@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/cli-contracts/typed-action-inputs.js

@@ -1,5 +1,2 @@
-
-!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]="52969f17-1b8d-535e-93b6-b99d4e5b9917")}catch(e){}}();
-export {};
+!(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]="5d8c9815-609b-547a-89e6-5018bfeb5aa0")}catch(e2){}})();
 //# sourceMappingURL=typed-action-inputs.js.map
-//# debugId=52969f17-1b8d-535e-93b6-b99d4e5b9917

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

@@ -11,7 +11,7 @@
  * here.)
  */
 export type { CommanderOptionAliasContract, CommanderOptionRegistrationContract, } from "./cli-contracts/commander-types.js";
-export { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, type PmCommandAliasContract, type PmCommandAliasLifecycle, type PmCommandAliasRegistration, } from "./cli-contracts/command-aliases.js";
+export { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, PM_HISTORY_COMMAND_ALIASES, resolvePmHistoryOperation, 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 { 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_PACKAGE_ONLY_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";

package/dist/sdk/cli-contracts.js

@@ -1,18 +1,2 @@
-
-!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]="167b98d4-a5b5-581d-ac0a-17e8e3bfc490")}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";
-// PM_* enum/guard contracts and the bulk tool-parameter property/metadata data
-// 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 { 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_PACKAGE_ONLY_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_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";
+!(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]="9b159080-61be-5bf3-87b8-d46a2697e2e1")}catch(e2){}})();import{EXECUTABLE_COMMAND_ALIASES,PM_COMMAND_ALIAS_CONTRACTS,PM_HISTORY_COMMAND_ALIASES,resolvePmHistoryOperation,renderPmCommandAliasMigrationHint,resolvePmCommandAlias}from"./cli-contracts/command-aliases.js";import{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";import{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";import{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_PACKAGE_ONLY_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";import{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";import{PM_COMMAND_POSITIONAL_CONTRACTS,PM_POSITIONAL_ACTION_CONTRACTS}from"./cli-contracts/grammar-contracts.js";import{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";import{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";import{analyzeSdkCliParameterCompleteness}from"./cli-contracts/completeness.js";import{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";export{ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,ACTIVITY_FLAG_CONTRACTS,AGGREGATE_FLAG_CONTRACTS,APPEND_FLAG_CONTRACTS,ASSURANCE_FLAG_CONTRACTS,CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS,CALENDAR_FLAG_CONTRACTS,CLAIM_FLAG_CONTRACTS,CLOSE_ACTION_OPTION_KEYS,CLOSE_FLAG_CONTRACTS,CLOSE_MANY_FLAG_CONTRACTS,CLOSE_TASK_FLAG_CONTRACTS,COMMENTS_FLAG_CONTRACTS,COMPLETION_FLAG_CONTRACTS,CONFIG_FLAG_CONTRACTS,CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,CONTEXT_FLAG_CONTRACTS,CONTRACTS_FLAG_CONTRACTS,COPY_FLAG_CONTRACTS,CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,CREATE_COMMANDER_STRING_OPTION_CONTRACTS,CREATE_FLAG_CONTRACTS,DELETE_FLAG_CONTRACTS,DEPS_FLAG_CONTRACTS,DOCS_FLAG_CONTRACTS,DUPLICATES_FLAG_CONTRACTS,EVAL_FLAG_CONTRACTS,EVENTS_FLAG_CONTRACTS,EVENT_FLAG_CONTRACTS,EXECUTABLE_COMMAND_ALIASES,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_SCOPE_FLAG_CONTRACTS,EXTENSION_UNINSTALL_FLAG_CONTRACTS,FILES_FLAG_CONTRACTS,FOCUS_FLAG_CONTRACTS,GC_FLAG_CONTRACTS,GET_FLAG_CONTRACTS,GLOBAL_FLAG_CONTRACTS,GRAPH_FLAG_CONTRACTS,GUIDE_FLAG_CONTRACTS,HEALTH_FLAG_CONTRACTS,HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS,HISTORY_COMPACT_FLAG_CONTRACTS,HISTORY_FLAG_CONTRACTS,HISTORY_REDACT_FLAG_CONTRACTS,HISTORY_REPAIR_FLAG_CONTRACTS,INIT_FLAG_CONTRACTS,INSTALL_FLAG_CONTRACTS,ITEM_COMPLETE_FLAG_CONTRACTS,ITEM_MUTATE_FLAG_CONTRACTS,ITEM_REOPEN_FLAG_CONTRACTS,LEARNINGS_FLAG_CONTRACTS,LIST_COMMANDER_STRING_OPTION_CONTRACTS,LIST_FILTER_FLAG_CONTRACTS,MEET_FLAG_CONTRACTS,MERGE_FLAG_CONTRACTS,MERGE_SUBCOMMAND_VALUES,NEXT_COMMANDER_STRING_OPTION_CONTRACTS,NEXT_FLAG_CONTRACTS,NOTES_FLAG_CONTRACTS,PACKAGE_FLAG_CONTRACTS,PACKAGE_INIT_FLAG_CONTRACTS,PAUSE_TASK_FLAG_CONTRACTS,PLAN_CREATE_METADATA_PARAMETER_KEYS,PLAN_FLAG_CONTRACTS,PM_CLI_ONLY_TOOL_ACTION_WAIVERS,PM_COMMAND_ALIAS_CONTRACTS,PM_COMMAND_OUTPUT_BUDGET_CONTRACTS,PM_COMMAND_POSITIONAL_CONTRACTS,PM_CORE_COMMAND_NAMES,PM_DEPRECATED_TOOL_ACTIONS,PM_DIAGNOSTIC_DEGRADATION_STEPS,PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS,PM_DIAGNOSTIC_OUTPUT_CLASSES,PM_DISCOVERABLE_TOOL_ACTIONS,PM_EXTENSION_CAPABILITY_CONTRACTS,PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS,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_HISTORY_COMMAND_ALIASES,PM_ITEM_ACTION_SUBCOMMANDS,PM_OUTPUT_BUDGET_CLASSES,PM_OUTPUT_DEGRADATION_STEPS,PM_PACKAGE_ONLY_ACTION_SUBCOMMANDS,PM_POSITIONAL_ACTION_CONTRACTS,PM_PROVIDER_TOOL_PARAMETERS_SCHEMA,PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION,PM_TOOL_ACTIONS,PM_TOOL_ACTION_PARAMETER_CONTRACTS,PM_TOOL_PARAMETERS_SCHEMA,PM_TOOL_PARAMETERS_SCHEMA_MAJOR,PM_TOOL_PARAMETERS_SCHEMA_VERSION,PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES,PROFILE_FLAG_CONTRACTS,REINDEX_FLAG_CONTRACTS,RELEASE_FLAG_CONTRACTS,REMIND_FLAG_CONTRACTS,RESTORE_FLAG_CONTRACTS,SCHEMA_FLAG_CONTRACTS,SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,SEARCH_FLAG_CONTRACTS,START_TASK_FLAG_CONTRACTS,STATS_FLAG_CONTRACTS,SUBCOMMAND_GLOBAL_FLAG_CONTRACTS,TELEMETRY_FLAG_CONTRACTS,TEST_ALL_FLAG_CONTRACTS,TEST_FLAG_CONTRACTS,TEST_RUNS_FLAG_CONTRACTS,TOOL_ACTIVITY_OPTION_CONTRACTS,TOOL_AGGREGATE_OPTION_CONTRACTS,TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE,TOOL_CALENDAR_OPTION_CONTRACTS,TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS,TOOL_CONTEXT_OPTION_CONTRACTS,TOOL_CREATE_OPTION_CONTRACTS,TOOL_CREATE_OPTION_CONTRACT_SOURCE,TOOL_DEPS_OPTION_CONTRACTS,TOOL_GRAPH_OPTION_CONTRACTS,TOOL_LIST_FILTER_OPTION_CONTRACTS,TOOL_SEARCH_FILTER_OPTION_CONTRACTS,TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS,TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE,TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS,TOOL_UPDATE_OPTION_CONTRACTS,TOOL_UPDATE_OPTION_CONTRACT_SOURCE,UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS,UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,UPDATE_FLAG_CONTRACTS,UPDATE_MANY_FLAG_CONTRACTS,UPGRADE_FLAG_CONTRACTS,VALIDATE_FLAG_CONTRACTS,WORKSPACE_FLAG_CONTRACTS,_testOnlyCliContracts,analyzePmToolActionParity,analyzeSdkCliParameterCompleteness,buildPmActionToolInputSchema,compactFlagAliasContracts,createPmCommandOutputBudget,definePmCommandOutputBudget,estimatePmOutputTokens,hasSubcommandFlagContractsForCommand,inferPmOutputBudgetClass,isPmExtensionCapabilityContract,isPmExtensionPolicyModeContract,isPmExtensionPolicySurfaceContract,isPmExtensionServiceNameContract,isPmToolAction,projectPmDiagnosticOutput,projectPmDiagnosticText,readFirstStringFromCommanderOptions,readFirstValueFromCommanderOptions,readStringArrayFromCommanderOptions,renderPmCommandAliasMigrationHint,resolvePmCommandAlias,resolvePmCommandOutputBudget,resolvePmDiagnosticOutputBudget,resolvePmHistoryOperation,resolvePmPositionalActionFlagContracts,resolvePmToolCustomFieldCollision,resolveSubcommandFlagContractsForCommand,toCompletionFlagString,verifyToolOptionCliParity,withFlagAliasMetadata};
 //# sourceMappingURL=cli-contracts.js.map
-//# debugId=167b98d4-a5b5-581d-ac0a-17e8e3bfc490

package/dist/sdk/cli-program.js

@@ -1,50 +1,2 @@
-/**
- * @module sdk/cli-program
- *
- * Builds the reusable Commander root that embeds pm's universal global contracts.
- */
-
-!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]="31e820a7-aa60-5e37-846d-c62b81b47587")}catch(e){}}();
-import { Command } from "commander";
-import { writeStdout } from "../core/output/output.js";
-/** Create a fresh pm root program suitable for one-shot CLI or embedded hosts. */
-export function createPmCliProgram(version) {
-    return new Command()
-        .name("pm")
-        .description("Universal, flexible, extensible, agent-optimized project management CLI for any project or programming language.")
-        .version(version)
-        .showHelpAfterError(false)
-        .allowExcessArguments(false)
-        .allowUnknownOption(false)
-        .configureOutput({
-        writeOut: (value) => {
-            writeStdout(value);
-        },
-        writeErr: () => { },
-    })
-        .option("--json", "Output JSON instead of TOON; mutations emit a flat receipt with top-level id/status/changed_field_count while reads use documented entity or collection envelopes")
-        .option("--lean", "Omit null and empty containers from JSON output")
-        .option("--token-accounting", "Attach a bounded per-section token-cost receipt to command output")
-        .option("--output-include <fields>", "Retain comma-separated fields or sections in read output")
-        .option("--output-limit <count>", "Bound rows in read output")
-        .option("--output-budget <tokens|unbounded>", "Bound estimated tokens in read output or explicitly disable the default ceiling")
-        .option("--output-format <toon|json>", "Select the read-output encoding")
-        .option("--output-session <state>", "Carry a JSON session budget and served-item ledger across read calls")
-        .option("--output-cursor <cursor>", "Resume a budget-compacted declared row collection")
-        .option("--output-row-contract", "Include the machine-readable row selector and TOON encoding contract")
-        .option("--quiet", "Suppress stdout output")
-        .option("--no-changed-fields", "Omit the changed_fields array from mutation output (keeps changed_field_count)")
-        .option("--full-changed-fields", "Restore the legacy full mutation envelope and changed_fields array")
-        .option("--id-only", "Print only id and status for single-item mutation output")
-        .option("--pm-path <dir>", "Explicit tracker storage path for this command (preferred over --path)")
-        .option("--path <dir>", "Backward-compatible alias for --pm-path; this is the tracker storage path, not a workspace cwd")
-        .option("--no-extensions", "Disable extension loading")
-        .option("--no-pager", "Disable pager integration for help and long output")
-        .option("--explain", "Render extended rationale and examples in help output")
-        .option("--all", "Reveal every public command and compatibility alias")
-        .option("--profile", "Print deterministic timing diagnostics")
-        .option("--author <id>", "Override mutation author for this invocation")
-        .exitOverride();
-}
+!(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]="a8da6368-489f-579a-8a64-a9bb025f95e7")}catch(e2){}})();import{Command}from"commander";import{writeStdout}from"../core/output/output.js";function createPmCliProgram(version){return new Command().name("pm").description("Universal, flexible, extensible, agent-optimized project management CLI for any project or programming language.").version(version).showHelpAfterError(false).allowExcessArguments(false).allowUnknownOption(false).configureOutput({writeOut:value=>{writeStdout(value)},writeErr:()=>{}}).option("--json","Output JSON instead of TOON; mutations emit a flat receipt with top-level id/status/changed_field_count while reads use documented entity or collection envelopes").option("--lean","Omit null and empty containers from JSON output").option("--token-accounting","Attach a bounded per-section token-cost receipt to command output").option("--output-include <fields>","Retain comma-separated fields or sections in read output").option("--output-limit <count>","Bound rows in read output").option("--output-budget <tokens|unbounded>","Bound estimated tokens in read output or explicitly disable the default ceiling").option("--output-format <toon|json>","Select the read-output encoding").option("--output-session <state>","Carry a JSON session budget and served-item ledger across read calls").option("--output-cursor <cursor>","Resume a budget-compacted declared row collection").option("--output-row-contract","Include the machine-readable row selector and TOON encoding contract").option("--quiet","Suppress stdout output").option("--no-changed-fields","Omit the changed_fields array from mutation output (keeps changed_field_count)").option("--full-changed-fields","Restore the legacy full mutation envelope and changed_fields array").option("--id-only","Print only id and status for single-item mutation output").option("--pm-path <dir>","Explicit tracker storage path for this command (preferred over --path)").option("--path <dir>","Backward-compatible alias for --pm-path; this is the tracker storage path, not a workspace cwd").option("--no-extensions","Disable extension loading").option("--no-pager","Disable pager integration for help and long output").option("--explain","Render extended rationale and examples in help output").option("--all","Reveal every public command and compatibility alias").option("--profile","Print deterministic timing diagnostics").option("--author <id>","Override mutation author for this invocation").exitOverride()}export{createPmCliProgram};
 //# sourceMappingURL=cli-program.js.map
-//# debugId=31e820a7-aa60-5e37-846d-c62b81b47587

package/dist/sdk/command-line.d.ts

@@ -1,14 +1,11 @@
-/**
- * @module sdk/command-line
- *
- * Renders copy-safe pm command suggestions for SDK and CLI diagnostics.
- */
 /** Quote one Windows argument with the linear CommandLineToArgvW escaping algorithm. */
 export declare const quoteWindowsCommandArg: (arg: string) => string;
 /** Quote one command argument only when platform shell-significant characters require it. */
 export declare const quoteCommandArg: (arg: string, platform?: NodeJS.Platform) => string;
 /** Render a complete pm command from already-tokenized arguments. */
 export declare const renderPmCommand: (argv: string[], platform?: NodeJS.Platform) => string;
+/** Recognize the leading redaction command after global options, even before flag validation succeeds. */
+export declare function isHistoryRedactInvocation(argv: readonly string[]): boolean;
 /**
  * Replace history-redaction matcher and replacement values before an argv
  * vector is copied into diagnostics or recovery guidance. The values are

package/dist/sdk/command-line.js

@@ -1,79 +1,2 @@
-/**
- * @module sdk/command-line
- *
- * Renders copy-safe pm command suggestions for SDK and CLI diagnostics.
- */
-/** Quote one Windows argument with the linear CommandLineToArgvW escaping algorithm. */
-
-!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]="288a7da9-888b-527d-88fb-4711917cec5b")}catch(e){}}();
-export const quoteWindowsCommandArg = (arg) => {
-    let escaped = '"';
-    let pendingBackslashes = 0;
-    for (const character of arg) {
-        if (character === "\\") {
-            pendingBackslashes += 1;
-            continue;
-        }
-        escaped += "\\".repeat(character === '"' ? pendingBackslashes * 2 + 1 : pendingBackslashes);
-        escaped += character;
-        pendingBackslashes = 0;
-    }
-    return `${escaped}${"\\".repeat(pendingBackslashes * 2)}"`;
-};
-/** Quote one command argument only when platform shell-significant characters require it. */
-export const quoteCommandArg = (arg, platform = process.platform) => {
-    const safePattern = platform === "win32" ? /^[A-Za-z0-9._:/\\@=-]+$/ : /^[A-Za-z0-9._:/@=-]+$/;
-    if (safePattern.test(arg)) {
-        return arg;
-    }
-    if (platform === "win32") {
-        return quoteWindowsCommandArg(arg);
-    }
-    return `"${arg.replace(/(["\\$`])/g, "\\$1")}"`;
-};
-/** Render a complete pm command from already-tokenized arguments. */
-export const renderPmCommand = (argv, platform = process.platform) => {
-    const args = argv.map((token) => quoteCommandArg(token, platform)).join(" ");
-    return args.length > 0 ? `pm ${args}` : "pm";
-};
-const HISTORY_REDACT_SENSITIVE_FLAGS = new Set([
-    "--literal",
-    "--regex",
-    "--replacement",
-]);
-/**
- * Replace history-redaction matcher and replacement values before an argv
- * vector is copied into diagnostics or recovery guidance. The values are
- * inputs to a disclosure-removal operation and therefore remain sensitive
- * even when they do not resemble a conventional credential.
- */
-export function redactSensitiveCommandArgs(argv) {
-    if (!argv.includes("history-redact")) {
-        return [...argv];
-    }
-    const redacted = [];
-    let redactNext = false;
-    for (const token of argv) {
-        if (redactNext && !token.startsWith("-")) {
-            redacted.push("[redacted]");
-            redactNext = false;
-            continue;
-        }
-        redactNext = false;
-        const equalsIndex = token.indexOf("=");
-        const flag = equalsIndex >= 0 ? token.slice(0, equalsIndex) : token;
-        if (!HISTORY_REDACT_SENSITIVE_FLAGS.has(flag)) {
-            redacted.push(token);
-            continue;
-        }
-        if (equalsIndex >= 0) {
-            redacted.push(`${flag}=[redacted]`);
-            continue;
-        }
-        redacted.push(flag);
-        redactNext = true;
-    }
-    return redacted;
-}
+!(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]="4ed3e8a4-97a1-5082-afd3-5942d47bc054")}catch(e2){}})();import{findBootstrapCommandTokenIndex}from"./cli-contracts/bootstrap-command-scanner.js";const quoteWindowsCommandArg=arg=>{let escaped='"';let pendingBackslashes=0;for(const character of arg){if(character==="\\"){pendingBackslashes+=1;continue}escaped+="\\".repeat(character==='"'?pendingBackslashes*2+1:pendingBackslashes);escaped+=character;pendingBackslashes=0}return`${escaped}${"\\".repeat(pendingBackslashes*2)}"`};const quoteCommandArg=(arg,platform=process.platform)=>{const safePattern=platform==="win32"?/^[A-Za-z0-9._:/\\@=-]+$/:/^[A-Za-z0-9._:/@=-]+$/;if(safePattern.test(arg)){return arg}if(platform==="win32"){return quoteWindowsCommandArg(arg)}return`"${arg.replace(/(["\\$`])/g,"\\$1")}"`};const renderPmCommand=(argv,platform=process.platform)=>{const args=argv.map(token=>quoteCommandArg(token,platform)).join(" ");return args.length>0?`pm ${args}`:"pm"};const HISTORY_REDACT_SENSITIVE_FLAGS=new Set(["--literal","--regex","--replacement"]);function isHistoryRedactInvocation(argv){const rootIndex=findBootstrapCommandTokenIndex(argv);if(rootIndex===void 0)return false;if(argv[rootIndex]==="history-redact")return true;if(argv[rootIndex]!=="history")return false;const operationArgs=argv.slice(rootIndex+1);const operationIndex=findBootstrapCommandTokenIndex(operationArgs);return operationIndex!==void 0&&operationArgs[operationIndex]==="redact"}function redactSensitiveCommandArgs(argv){if(!isHistoryRedactInvocation(argv)){return[...argv]}const redacted=[];let redactNext=false;for(const token of argv){if(redactNext){redacted.push("[redacted]");redactNext=false;continue}redactNext=false;const equalsIndex=token.indexOf("=");const flag=equalsIndex>=0?token.slice(0,equalsIndex):token;if(!HISTORY_REDACT_SENSITIVE_FLAGS.has(flag)){redacted.push(token);continue}if(equalsIndex>=0){redacted.push(`${flag}=[redacted]`);continue}redacted.push(flag);redactNext=true}return redacted}export{isHistoryRedactInvocation,quoteCommandArg,quoteWindowsCommandArg,redactSensitiveCommandArgs,renderPmCommand};
 //# sourceMappingURL=command-line.js.map
-//# debugId=288a7da9-888b-527d-88fb-4711917cec5b

package/dist/sdk/comments.js

@@ -1,134 +1,2 @@
-/**
- * @module cli/commands/comments
- *
- * Implements the pm comments 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]="f761d37b-28df-5176-9e25-762f57aa0abf")}catch(e){}}();
-import { isFileAbsentError } from "../core/fs/fs-utils.js";
-import { readFile } from "node:fs/promises";
-import { EXIT_CODE, PmCliError, createStdinTokenResolver, shouldResolveMutationStdinTokens, } from "./runtime-primitives.js";
-import { assertAnnotationStdinTransportAvailable, isErrnoError, parseAnnotationTextInput, runAnnotationCommand, } from "./annotations.js";
-async function resolveCommentTextSource(options, stdinResolver) {
-    const hasAdd = options.add !== undefined;
-    const hasStdin = options.stdin === true;
-    const hasFile = typeof options.file === "string";
-    const sourceCount = Number(hasAdd) + Number(hasStdin) + Number(hasFile);
-    if (sourceCount === 0) {
-        return undefined;
-    }
-    if (sourceCount > 1) {
-        throw new PmCliError("Specify comment text using only one input source: --add, --stdin, or --file", EXIT_CODE.USAGE);
-    }
-    if (hasAdd) {
-        const addInput = await stdinResolver.resolveValue(options.add, "--add", shouldResolveMutationStdinTokens(options));
-        return { value: addInput ?? "", emptyFlag: "--add" };
-    }
-    if (hasStdin) {
-        assertAnnotationStdinTransportAvailable(options, "--stdin");
-        const stdinInput = await stdinResolver.resolveValue("-", "--stdin");
-        return { value: stdinInput ?? "", emptyFlag: "--stdin" };
-    }
-    const filePath = options.file.trim();
-    if (!filePath) {
-        throw new PmCliError("--file path cannot be empty", EXIT_CODE.USAGE);
-    }
-    if (filePath === "-") {
-        assertAnnotationStdinTransportAvailable(options, "--file -");
-        return {
-            value: (await stdinResolver.resolveValue("-", "--file")) ?? "",
-            emptyFlag: "--file",
-        };
-    }
-    try {
-        const fileInput = await readFile(filePath, "utf8");
-        return { value: fileInput, emptyFlag: "--file" };
-    }
-    catch (error) {
-        if (isErrnoError(error) && isFileAbsentError(error)) {
-            throw new PmCliError(`--file path not found: ${filePath}. Use --file - to read stdin.`, EXIT_CODE.USAGE);
-        }
-        const detail = error instanceof Error ? error.message : String(error);
-        throw new PmCliError(`Failed to read --file path "${filePath}": ${detail}. Use --file - to read stdin.`, EXIT_CODE.USAGE);
-    }
-}
-async function resolveCommentInput(options, stdinResolver) {
-    const editIndex = options.edit;
-    const deleteIndex = options.delete;
-    const hasEdit = editIndex !== undefined;
-    const hasDelete = deleteIndex !== undefined;
-    if (hasEdit && hasDelete) {
-        throw new PmCliError("Specify only one of --edit or --delete", EXIT_CODE.USAGE);
-    }
-    if (editIndex !== undefined && (!Number.isInteger(editIndex) || editIndex < 1)) {
-        throw new PmCliError("--edit must be a positive integer", EXIT_CODE.USAGE);
-    }
-    if (deleteIndex !== undefined && (!Number.isInteger(deleteIndex) || deleteIndex < 1)) {
-        throw new PmCliError("--delete must be a positive integer", EXIT_CODE.USAGE);
-    }
-    if (hasDelete) {
-        const textSource = await resolveCommentTextSource(options, stdinResolver);
-        if (textSource !== undefined) {
-            throw new PmCliError("--delete does not take comment text", EXIT_CODE.USAGE);
-        }
-        return { mode: "delete", index: deleteIndex };
-    }
-    if (hasEdit) {
-        const textSource = await resolveCommentTextSource(options, stdinResolver);
-        if (textSource === undefined) {
-            throw new PmCliError("--edit requires replacement text via positional [text], --add, --stdin, or --file", EXIT_CODE.USAGE);
-        }
-        return {
-            mode: "edit",
-            index: editIndex,
-            value: textSource.value,
-            emptyFlag: textSource.emptyFlag,
-        };
-    }
-    const textSource = await resolveCommentTextSource(options, stdinResolver);
-    if (textSource === undefined) {
-        return { mode: "list" };
-    }
-    // Map the single resolved input source back to its add/stdin/file mode so the
-    // caller still knows whether to run plain-text markdown parsing (add-only).
-    const mode = textSource.emptyFlag === "--add"
-        ? "add"
-        : textSource.emptyFlag === "--stdin"
-            ? "stdin"
-            : "file";
-    return { mode, value: textSource.value, emptyFlag: textSource.emptyFlag };
-}
-/** Implements run comments for the public runtime surface of this module. */
-export async function runComments(id, options, global) {
-    const stdinResolver = createStdinTokenResolver();
-    const commentInput = await resolveCommentInput(options, stdinResolver);
-    const shouldParseText = commentInput.mode === "add" || commentInput.mode === "edit";
-    const rawValue = commentInput.value ?? "";
-    return runAnnotationCommand(id, options, global, {
-        input: {
-            ...commentInput,
-            rawValue: options.add ?? rawValue,
-            value: shouldParseText
-                ? parseAnnotationTextInput(rawValue, { stripPlainTextPrefix: true })
-                : rawValue,
-        },
-        collectionKey: "comments",
-        op: "comment_add",
-        editOp: "comment_edit",
-        deleteOp: "comment_delete",
-        parseText: (raw) => raw,
-        createEntry: (entry) => entry,
-        bypassOwnershipConflict: Boolean(commentInput.mode === "add" &&
-            options.ownershipAppendBypass),
-        conflictGuidance: {
-            required: "For an approved append-only handoff on another owner's item, use the package-provided ownership bypass before considering --force.",
-            examples: ['pm comments pm-a1b2 --add "review note" --author "reviewer" --force'],
-            nextSteps: [
-                "Use an installed package's narrow append-only ownership bypass when available.",
-                "Use --force only when an ownership override is explicitly approved.",
-            ],
-        },
-    });
-}
+!(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]="29e1738e-026c-5714-b279-30e45951d256")}catch(e2){}})();import{isFileAbsentError}from"../core/fs/fs-utils.js";import{readFile}from"node:fs/promises";import{EXIT_CODE,PmCliError,createStdinTokenResolver,shouldResolveMutationStdinTokens}from"./runtime-primitives.js";import{assertAnnotationStdinTransportAvailable,isErrnoError,parseAnnotationTextInput,runAnnotationCommand}from"./annotations.js";async function resolveCommentTextSource(options,stdinResolver){const hasAdd=options.add!==void 0;const hasStdin=options.stdin===true;const hasFile=typeof options.file==="string";const sourceCount=Number(hasAdd)+Number(hasStdin)+Number(hasFile);if(sourceCount===0){return void 0}if(sourceCount>1){throw new PmCliError("Specify comment text using only one input source: --add, --stdin, or --file",EXIT_CODE.USAGE)}if(hasAdd){const addInput=await stdinResolver.resolveValue(options.add,"--add",shouldResolveMutationStdinTokens(options));return{value:addInput??"",emptyFlag:"--add"}}if(hasStdin){assertAnnotationStdinTransportAvailable(options,"--stdin");const stdinInput=await stdinResolver.resolveValue("-","--stdin");return{value:stdinInput??"",emptyFlag:"--stdin"}}const filePath=options.file.trim();if(!filePath){throw new PmCliError("--file path cannot be empty",EXIT_CODE.USAGE)}if(filePath==="-"){assertAnnotationStdinTransportAvailable(options,"--file -");return{value:await stdinResolver.resolveValue("-","--file")??"",emptyFlag:"--file"}}try{const fileInput=await readFile(filePath,"utf8");return{value:fileInput,emptyFlag:"--file"}}catch(error){if(isErrnoError(error)&&isFileAbsentError(error)){throw new PmCliError(`--file path not found: ${filePath}. Use --file - to read stdin.`,EXIT_CODE.USAGE)}const detail=error instanceof Error?error.message:String(error);throw new PmCliError(`Failed to read --file path "${filePath}": ${detail}. Use --file - to read stdin.`,EXIT_CODE.USAGE)}}async function resolveCommentInput(options,stdinResolver){const editIndex=options.edit;const deleteIndex=options.delete;const hasEdit=editIndex!==void 0;const hasDelete=deleteIndex!==void 0;if(hasEdit&&hasDelete){throw new PmCliError("Specify only one of --edit or --delete",EXIT_CODE.USAGE)}if(editIndex!==void 0&&(!Number.isInteger(editIndex)||editIndex<1)){throw new PmCliError("--edit must be a positive integer",EXIT_CODE.USAGE)}if(deleteIndex!==void 0&&(!Number.isInteger(deleteIndex)||deleteIndex<1)){throw new PmCliError("--delete must be a positive integer",EXIT_CODE.USAGE)}if(hasDelete){const textSource2=await resolveCommentTextSource(options,stdinResolver);if(textSource2!==void 0){throw new PmCliError("--delete does not take comment text",EXIT_CODE.USAGE)}return{mode:"delete",index:deleteIndex}}if(hasEdit){const textSource2=await resolveCommentTextSource(options,stdinResolver);if(textSource2===void 0){throw new PmCliError("--edit requires replacement text via positional [text], --add, --stdin, or --file",EXIT_CODE.USAGE)}return{mode:"edit",index:editIndex,value:textSource2.value,emptyFlag:textSource2.emptyFlag}}const textSource=await resolveCommentTextSource(options,stdinResolver);if(textSource===void 0){return{mode:"list"}}const mode=textSource.emptyFlag==="--add"?"add":textSource.emptyFlag==="--stdin"?"stdin":"file";return{mode,value:textSource.value,emptyFlag:textSource.emptyFlag}}async function runComments(id,options,global2){const stdinResolver=createStdinTokenResolver();const commentInput=await resolveCommentInput(options,stdinResolver);const shouldParseText=commentInput.mode==="add"||commentInput.mode==="edit";const rawValue=commentInput.value??"";return runAnnotationCommand(id,options,global2,{input:{...commentInput,rawValue:options.add??rawValue,value:shouldParseText?parseAnnotationTextInput(rawValue,{stripPlainTextPrefix:true}):rawValue},collectionKey:"comments",op:"comment_add",editOp:"comment_edit",deleteOp:"comment_delete",parseText:raw=>raw,createEntry:entry=>entry,bypassOwnershipConflict:Boolean(commentInput.mode==="add"&&options.ownershipAppendBypass),conflictGuidance:{required:"For an approved append-only handoff on another owner's item, use the package-provided ownership bypass before considering --force.",examples:['pm comments pm-a1b2 --add "review note" --author "reviewer" --force'],nextSteps:["Use an installed package's narrow append-only ownership bypass when available.","Use --force only when an ownership override is explicitly approved."]}})}export{runComments};
 //# sourceMappingURL=comments.js.map
-//# debugId=f761d37b-28df-5176-9e25-762f57aa0abf

package/dist/sdk/compile-cache.js

@@ -1,74 +1,2 @@
-/**
- * @module sdk/compile-cache
- *
- * Provides a bounded, host-reusable lifecycle primitive for pm-owned Node
- * compile-cache generations.
- */
-
-!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]="611e9aba-d08e-5c1a-89c9-c7fda0cc9bc9")}catch(e){}}();
-import { isFileMissingError } from "../core/fs/fs-utils.js";
-import fs from "node:fs";
-import path from "node:path";
-const COMPILE_CACHE_CONCURRENT_GRACE_MS = 5 * 60 * 1000;
-const COMPILE_CACHE_MAX_GENERATIONS = 3;
-/** Convert an optional package version into a safe compile-cache generation key. */
-export function resolveCompileCacheGeneration(packageVersion) {
-    return (packageVersion?.trim() || "development")
-        .replace(/[^a-zA-Z0-9._-]/g, "_")
-        .replace(/^\./, "_");
-}
-/**
- * Retain the current and recently active generations in an exclusively
- * pm-owned compile-cache root, then remove stale entries beyond the bounded
- * generation budget. A short freshness grace protects concurrently starting
- * pm versions from deleting one another's active cache directories.
- */
-export function pruneCompileCacheGenerations(cacheRoot, currentGeneration) {
-    const normalizedGeneration = currentGeneration.trim();
-    if (!/^[a-zA-Z0-9_-][a-zA-Z0-9._-]*$/.test(normalizedGeneration)) {
-        throw new TypeError("Compile-cache generation must be a safe non-empty filename token.");
-    }
-    fs.mkdirSync(cacheRoot, { recursive: true });
-    const currentPath = path.join(cacheRoot, normalizedGeneration);
-    fs.mkdirSync(currentPath, { recursive: true });
-    const touchedAt = new Date();
-    fs.utimesSync(currentPath, touchedAt, touchedAt);
-    const candidates = fs
-        .readdirSync(cacheRoot)
-        .filter((name) => name !== normalizedGeneration)
-        .flatMap((name) => {
-        try {
-            return [
-                { name, mtimeMs: fs.statSync(path.join(cacheRoot, name)).mtimeMs },
-            ];
-        }
-        catch (error) {
-            if (error instanceof Error &&
-                "code" in error &&
-                isFileMissingError(error)) {
-                return [];
-            }
-            throw error;
-        }
-    })
-        .sort((left, right) => right.mtimeMs - left.mtimeMs || left.name.localeCompare(right.name));
-    const fresh = candidates.filter((entry) => touchedAt.getTime() - entry.mtimeMs <
-        COMPILE_CACHE_CONCURRENT_GRACE_MS);
-    const staleRetention = Math.max(0, COMPILE_CACHE_MAX_GENERATIONS - 1 - fresh.length);
-    const removed = candidates
-        .filter((entry) => touchedAt.getTime() - entry.mtimeMs >= COMPILE_CACHE_CONCURRENT_GRACE_MS)
-        .slice(staleRetention)
-        .map((entry) => entry.name)
-        .sort((left, right) => left.localeCompare(right));
-    for (const name of removed) {
-        fs.rmSync(path.join(cacheRoot, name), {
-            recursive: true,
-            force: true,
-            maxRetries: 3,
-            retryDelay: 50,
-        });
-    }
-    return { retained: normalizedGeneration, removed };
-}
+!(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]="9c9e4ac4-51b2-5920-bb27-a4f239f6b429")}catch(e2){}})();import{isFileMissingError}from"../core/fs/fs-utils.js";import fs from"node:fs";import path from"node:path";const COMPILE_CACHE_CONCURRENT_GRACE_MS=5*60*1e3;const COMPILE_CACHE_MAX_GENERATIONS=3;function resolveCompileCacheGeneration(packageVersion){return(packageVersion?.trim()||"development").replace(/[^a-zA-Z0-9._-]/g,"_").replace(/^\./,"_")}function pruneCompileCacheGenerations(cacheRoot,currentGeneration){const normalizedGeneration=currentGeneration.trim();if(!/^[a-zA-Z0-9_-][a-zA-Z0-9._-]*$/.test(normalizedGeneration)){throw new TypeError("Compile-cache generation must be a safe non-empty filename token.")}fs.mkdirSync(cacheRoot,{recursive:true});const currentPath=path.join(cacheRoot,normalizedGeneration);fs.mkdirSync(currentPath,{recursive:true});const touchedAt=new Date;fs.utimesSync(currentPath,touchedAt,touchedAt);const candidates=fs.readdirSync(cacheRoot).filter(name=>name!==normalizedGeneration).flatMap(name=>{try{return[{name,mtimeMs:fs.statSync(path.join(cacheRoot,name)).mtimeMs}]}catch(error){if(error instanceof Error&&"code"in error&&isFileMissingError(error)){return[]}throw error}}).sort((left,right)=>right.mtimeMs-left.mtimeMs||left.name.localeCompare(right.name));const fresh=candidates.filter(entry=>touchedAt.getTime()-entry.mtimeMs<COMPILE_CACHE_CONCURRENT_GRACE_MS);const staleRetention=Math.max(0,COMPILE_CACHE_MAX_GENERATIONS-1-fresh.length);const removed=candidates.filter(entry=>touchedAt.getTime()-entry.mtimeMs>=COMPILE_CACHE_CONCURRENT_GRACE_MS).slice(staleRetention).map(entry=>entry.name).sort((left,right)=>left.localeCompare(right));for(const name of removed){fs.rmSync(path.join(cacheRoot,name),{recursive:true,force:true,maxRetries:3,retryDelay:50})}return{retained:normalizedGeneration,removed}}export{pruneCompileCacheGenerations,resolveCompileCacheGeneration};
 //# sourceMappingURL=compile-cache.js.map
-//# debugId=611e9aba-d08e-5c1a-89c9-c7fda0cc9bc9