@unbrained/pm-cli 2026.8.26 → 2026.8.28

package/dist/sdk/cli-contracts/command-aliases.js

@@ -10,7 +10,7 @@
  * are intentionally absent from default help and completion discovery.
  */
 
-!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]="9afc5057-afcd-5d6c-a4c1-c2883640fc50")}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]="3c9694bd-3635-5298-abeb-6899c94317ab")}catch(e){}}();
 export const PM_COMMAND_ALIAS_CONTRACTS = [
     ...[
         ["fetch", "get"],
@@ -70,6 +70,19 @@ export const PM_COMMAND_ALIAS_CONTRACTS = [
         registration: "commander",
         owner: "pm-pfqi",
     })),
+    ...[
+        ["extension", "package"],
+        ["install", "package install"],
+        ["upgrade", "package upgrade"],
+    ].map(([alias, canonical]) => ({
+        alias,
+        canonical,
+        canonical_argv: canonical.split(" "),
+        lifecycle: "deprecated",
+        hidden: true,
+        registration: "commander",
+        owner: "pm-tnud",
+    })),
 ];
 /** High-frequency executable aliases whose targets accept identical arguments. */
 export const EXECUTABLE_COMMAND_ALIASES = Object.fromEntries(PM_COMMAND_ALIAS_CONTRACTS.filter((contract) => contract.registration === "bootstrap").map((contract) => [contract.alias, contract.canonical]));
@@ -83,4 +96,4 @@ export function renderPmCommandAliasMigrationHint(contract) {
     return `Deprecated command \`${contract.alias}\`; use \`pm ${contract.canonical_argv.join(" ")}\`.`;
 }
 //# sourceMappingURL=command-aliases.js.map
-//# debugId=9afc5057-afcd-5d6c-a4c1-c2883640fc50
+//# debugId=3c9694bd-3635-5298-abeb-6899c94317ab

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

@@ -34,6 +34,8 @@ export declare const MERGE_SUBCOMMAND_VALUES: readonly ["install", "reconcile",
 export type MergeSubcommand = (typeof MERGE_SUBCOMMAND_VALUES)[number];
 /** Nested lifecycle verbs flattened by SDK and MCP package actions. */
 export declare const PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS: readonly ["init", "install", "uninstall", "explore", "manage", "describe", "reload", "doctor", "catalog", "adopt", "adopt-all", "activate", "deactivate"];
+/** Package-only lifecycle verbs flattened by SDK and MCP package actions. */
+export declare const PM_PACKAGE_ONLY_ACTION_SUBCOMMANDS: readonly ["upgrade"];
 /** Noun-first item lifecycle verbs flattened for SDK and MCP dispatch. */
 export declare const PM_ITEM_ACTION_SUBCOMMANDS: readonly ["reopen"];
 /** CLI-only presentation commands intentionally omitted from programmatic actions. */
@@ -44,9 +46,10 @@ export declare const PM_CLI_ONLY_TOOL_ACTION_WAIVERS: {
 type PmCoreCommandName = (typeof PM_CORE_COMMAND_NAMES)[number];
 type PmCliOnlyToolAction = keyof typeof PM_CLI_ONLY_TOOL_ACTION_WAIVERS;
 type PmExtensionPackageAction = `${"extension" | "package"}-${(typeof PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS)[number]}`;
+type PmPackageOnlyAction = `package-${(typeof PM_PACKAGE_ONLY_ACTION_SUBCOMMANDS)[number]}`;
 type PmItemAction = `item-${(typeof PM_ITEM_ACTION_SUBCOMMANDS)[number]}`;
 /** Restricts pm tool action values accepted by command, SDK, and storage contracts. */
-export type PmToolAction = Exclude<PmCoreCommandName, PmCliOnlyToolAction | "item"> | PmExtensionPackageAction | PmItemAction;
+export type PmToolAction = Exclude<PmCoreCommandName, PmCliOnlyToolAction | "item"> | PmExtensionPackageAction | PmPackageOnlyAction | PmItemAction;
 /**
  * Public pm tool actions derived from the CLI vocabulary. Nested extension and
  * package verbs are flattened for transports that expose one action string.

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

@@ -4,7 +4,7 @@
  * Defines SDK command-contract metadata for Enum 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]="3935bae8-0a40-59ea-aca6-64e238d1f318")}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]="6315a62f-6f55-5200-a5ea-ec892ff39f58")}catch(e){}}();
 import { KNOWN_EXTENSION_CAPABILITIES, KNOWN_EXTENSION_POLICY_MODES, KNOWN_EXTENSION_POLICY_SURFACES, KNOWN_EXTENSION_SANDBOX_PROFILES, KNOWN_EXTENSION_SERVICE_NAMES, KNOWN_EXTENSION_TRUST_MODES, } from "../../core/extensions/extension-types.js";
 import { PM_COMMAND_ALIAS_CONTRACTS } from "./command-aliases.js";
 /** Public contract for pm extension capability contracts, shared by SDK and presentation-layer consumers. */
@@ -147,6 +147,8 @@ export const PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS = [
     "activate",
     "deactivate",
 ];
+/** Package-only lifecycle verbs flattened by SDK and MCP package actions. */
+export const PM_PACKAGE_ONLY_ACTION_SUBCOMMANDS = ["upgrade"];
 /** Noun-first item lifecycle verbs flattened for SDK and MCP dispatch. */
 export const PM_ITEM_ACTION_SUBCOMMANDS = ["reopen"];
 /** CLI-only presentation commands intentionally omitted from programmatic actions. */
@@ -164,6 +166,9 @@ export const PM_TOOL_ACTIONS = Object.freeze(PM_CORE_COMMAND_NAMES.flatMap((comm
     if (command === "extension" || command === "package") {
         return [
             ...PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS.map((subcommand) => `${command}-${subcommand}`),
+            ...(command === "package"
+                ? PM_PACKAGE_ONLY_ACTION_SUBCOMMANDS.map((subcommand) => `package-${subcommand}`)
+                : []),
             command,
         ];
     }
@@ -215,4 +220,4 @@ export function isPmExtensionPolicySurfaceContract(value) {
     return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value);
 }
 //# sourceMappingURL=enum-contracts.js.map
-//# debugId=3935bae8-0a40-59ea-aca6-64e238d1f318
+//# debugId=6315a62f-6f55-5200-a5ea-ec892ff39f58

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

@@ -7,7 +7,7 @@
  * flag surface stays single-sourced across the CLI, SDK, and MCP boundaries.
  */
 
-!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]="6664bc8f-e5da-5593-a2df-ac45f1cef09e")}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]="bd6c497f-9fb0-5c47-a677-9dd6636dba02")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 import { RESERVED_EXTENSION_HOST_FLAGS } from "../../core/extensions/reserved-host-flags.js";
 import { PM_POSITIONAL_ACTION_CONTRACTS, } from "./grammar-contracts.js";
@@ -219,13 +219,14 @@ export const AGGREGATE_FLAG_CONTRACTS = [
 /** Public contract for comments flag contracts, shared by SDK and presentation-layer consumers. */
 export const COMMENTS_FLAG_CONTRACTS = [
     { flag: "--id", value_name: "item-id" },
-    { flag: "--add", aliases: ["--comment", "--body"] },
+    { flag: "--add", aliases: ["--comment", "--body", "--text"] },
     { flag: "--stdin" },
     { flag: "--file" },
     { flag: "--edit" },
     { flag: "--delete" },
     { flag: "--limit" },
     { flag: "--full-history" },
+    { flag: "--if-absent", value_type: "boolean" },
     { flag: "--author" },
     { flag: "--message" },
     { flag: "--force" },
@@ -238,7 +239,7 @@ function withCursorSemantics(contracts, presentationFlags) {
 /** Public contract for notes flag contracts, shared by SDK and presentation-layer consumers. */
 export const NOTES_FLAG_CONTRACTS = [
     { flag: "--id", value_name: "item-id" },
-    { flag: "--add", aliases: ["--note"] },
+    { flag: "--add", aliases: ["--note", "--text"] },
     { flag: "--add-json" },
     { flag: "--stdin" },
     { flag: "--file" },
@@ -249,6 +250,7 @@ export const NOTES_FLAG_CONTRACTS = [
     { flag: "--event-type" },
     { flag: "--include-meta" },
     { flag: "--full-history" },
+    { flag: "--if-absent", value_type: "boolean" },
     { flag: "--author" },
     { flag: "--message" },
     { flag: "--force" },
@@ -256,9 +258,10 @@ export const NOTES_FLAG_CONTRACTS = [
 /** Public contract for learnings flag contracts, shared by SDK and presentation-layer consumers. */
 export const LEARNINGS_FLAG_CONTRACTS = [
     { flag: "--id", value_name: "item-id" },
-    { flag: "--add", aliases: ["--learning"] },
+    { flag: "--add", aliases: ["--learning", "--text"] },
     { flag: "--limit" },
     { flag: "--full-history" },
+    { flag: "--if-absent", value_type: "boolean" },
     { flag: "--author" },
     { flag: "--message" },
     { flag: "--force" },
@@ -1884,6 +1887,10 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
         rootCommand === "packages") &&
         lifecycleSubcommand !== undefined &&
         extraParts.length === 0) {
+        if ((rootCommand === "package" || rootCommand === "packages") &&
+            lifecycleSubcommand === "upgrade") {
+            return withSubcommandGlobalFlags(UPGRADE_FLAG_CONTRACTS);
+        }
         return withSubcommandGlobalFlags(resolveExtensionLifecycleFlagContracts(rootCommand, lifecycleSubcommand));
     }
     const contracts = SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND.get(normalized) ?? [];
@@ -1908,4 +1915,4 @@ export function toCompletionFlagString(flagContracts, includeGlobal = true) {
     return normalizeUniqueStringList(all).join(" ");
 }
 //# sourceMappingURL=flag-contracts.js.map
-//# debugId=6664bc8f-e5da-5593-a2df-ac45f1cef09e
+//# debugId=bd6c497f-9fb0-5c47-a677-9dd6636dba02

package/dist/sdk/cli-contracts/flag-lexicon-contracts.js

@@ -5,7 +5,7 @@
  * per-command growth budgets.
  */
 
-!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]="8320177c-e95d-5d14-a914-4ac37230c0b9")}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]="3466866d-8869-5ab6-b981-d084e7330aa5")}catch(e){}}();
 import { hasSubcommandFlagContractsForCommand, resolveSubcommandFlagContractsForCommand, } from "./flag-contracts.js";
 import { PM_COMMAND_CAPABILITY_CONTRACTS, } from "../agent-capability-contracts.js";
 import { enrichCliFlagInvocationContracts } from "../flag-invocation-contracts.js";
@@ -146,9 +146,9 @@ const PM_COMMAND_FLAG_BUDGET_MAXIMUMS = Object.freeze({
     "close-many": 72,
     delete: 24,
     append: 24,
-    comments: 30,
-    notes: 34,
-    learnings: 26,
+    comments: 31,
+    notes: 35,
+    learnings: 27,
     files: 39,
     docs: 30,
     deps: 32,
@@ -337,4 +337,4 @@ export function renderPmFlagLexiconMarkdown() {
     ].join("\n");
 }
 //# sourceMappingURL=flag-lexicon-contracts.js.map
-//# debugId=8320177c-e95d-5d14-a914-4ac37230c0b9
+//# debugId=3466866d-8869-5ab6-b981-d084e7330aa5

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

@@ -6,11 +6,11 @@
  * this checked-in table in both directions so adding or removing a command
  * cannot silently bypass the architecture decision.
  */
-import type { PmCommandAliasContract } from "./command-aliases.js";
+import { type PmCommandAliasContract } from "./command-aliases.js";
 /** Canonical top-level domains an agent must retain to route pm operations. */
 export declare const PM_CLI_GRAMMAR_NOUNS: readonly ["item", "list", "context", "search", "graph", "history", "workspace", "package", "ops", "plan", "contracts", "help"];
 /** Shared verbs whose meaning transfers across domain nouns. */
-export declare const PM_CLI_SHARED_VERBS: readonly ["activate", "add", "adopt", "adopt-all", "catalog", "compact", "complete", "create", "deactivate", "delete", "describe", "doctor", "edit", "explore", "import", "init", "inspect", "install", "list", "manage", "migrate", "mutate", "read", "redact", "reload", "remove", "reopen", "repair", "restore", "run", "show", "uninstall", "verify"];
+export declare const PM_CLI_SHARED_VERBS: readonly ["activate", "add", "adopt", "adopt-all", "catalog", "compact", "complete", "create", "deactivate", "delete", "describe", "doctor", "edit", "explore", "import", "init", "inspect", "install", "list", "manage", "migrate", "mutate", "read", "redact", "reload", "remove", "reopen", "repair", "restore", "run", "show", "uninstall", "upgrade", "verify"];
 /** Why a current command is permitted while the grammar migration proceeds. */
 export type PmCommandDestinationDisposition = "target_noun" | "consolidation" | "package_owned" | "keep_as_is";
 /** Exact destination decision for one command emitted by runtime contracts. */
@@ -78,7 +78,7 @@ export declare const PM_COMMAND_POSITIONAL_CONTRACTS: readonly PmCommandPosition
 /** Immutable grammar policy used by contracts and the CI gate. */
 export declare const PM_CLI_GRAMMAR_CONTRACT: {
     readonly nouns: readonly ["item", "list", "context", "search", "graph", "history", "workspace", "package", "ops", "plan", "contracts", "help"];
-    readonly shared_verbs: readonly ["activate", "add", "adopt", "adopt-all", "catalog", "compact", "complete", "create", "deactivate", "delete", "describe", "doctor", "edit", "explore", "import", "init", "inspect", "install", "list", "manage", "migrate", "mutate", "read", "redact", "reload", "remove", "reopen", "repair", "restore", "run", "show", "uninstall", "verify"];
+    readonly shared_verbs: readonly ["activate", "add", "adopt", "adopt-all", "catalog", "compact", "complete", "create", "deactivate", "delete", "describe", "doctor", "edit", "explore", "import", "init", "inspect", "install", "list", "manage", "migrate", "mutate", "read", "redact", "reload", "remove", "reopen", "repair", "restore", "run", "show", "uninstall", "upgrade", "verify"];
     readonly scope_before_verb: true;
     readonly visible_top_level_ceiling: 69;
     readonly ceiling_raise_requires_pm_item: true;

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

@@ -1,6 +1,15 @@
-/** Canonical top-level domains an agent must retain to route pm operations. */
+/**
+ * @module sdk/cli-contracts/grammar-contracts
+ *
+ * Declares and verifies the agent-facing noun–verb grammar. The destination
+ * census is intentionally exact: live command contracts are compared with
+ * this checked-in table in both directions so adding or removing a command
+ * cannot silently bypass the architecture decision.
+ */
 
-!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]="21495fd2-6abb-5a4f-965c-e7b9c8f87dff")}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]="d0f4c030-0028-5acb-a438-210666118074")}catch(e){}}();
+import { resolvePmCommandAlias, } from "./command-aliases.js";
+/** Canonical top-level domains an agent must retain to route pm operations. */
 export const PM_CLI_GRAMMAR_NOUNS = [
     "item",
     "list",
@@ -49,6 +58,7 @@ export const PM_CLI_SHARED_VERBS = [
     "run",
     "show",
     "uninstall",
+    "upgrade",
     "verify",
 ];
 function positionalSlot(name, valueKind, required, options = {}) {
@@ -391,12 +401,6 @@ const EXPLICIT_POSITIONAL_SLOTS = new Map([
     ["deps", [ITEM_ID]],
     ["docs", [ITEM_ID]],
     ["event", [positionalSlot("title", "string", true)]],
-    [
-        "extension",
-        [positionalSlot("target", "string", false, { polymorphic: true })],
-    ],
-    ["extension list", []],
-    ["extension scaffold", [positionalSlot("target", "string", true)]],
     ["files", [ITEM_ID]],
     ["files discover", [ITEM_ID]],
     [
@@ -422,7 +426,6 @@ const EXPLICIT_POSITIONAL_SLOTS = new Map([
         "init",
         [positionalSlot("prefix-or-path", "string", false, { polymorphic: true })],
     ],
-    ["install", [positionalSlot("targets", "string", false, { variadic: true })]],
     ["item complete", [ITEM_ID, positionalSlot("reason", "string", false)]],
     ["item reopen", [ITEM_ID, positionalSlot("reason", "string", true)]],
     ["learnings", [ITEM_ID, OPTIONAL_TEXT]],
@@ -444,12 +447,14 @@ const EXPLICIT_POSITIONAL_SLOTS = new Map([
     ],
     ["package list", []],
     ["package scaffold", [positionalSlot("target", "string", true)]],
+    ["package upgrade", [positionalSlot("target", "string", false)]],
     [
         "packages",
         [positionalSlot("target", "string", false, { polymorphic: true })],
     ],
     ["packages list", []],
     ["packages scaffold", [positionalSlot("target", "string", true)]],
+    ["packages upgrade", [positionalSlot("target", "string", false)]],
     ["pause-task", [ITEM_ID]],
     [
         "plan",
@@ -494,7 +499,6 @@ const EXPLICIT_POSITIONAL_SLOTS = new Map([
     ],
     ["test", [ITEM_ID]],
     ["update", [ITEM_ID]],
-    ["upgrade", [positionalSlot("target", "string", false)]],
     [
         "workspace snapshot",
         [
@@ -528,7 +532,13 @@ function normalizePositionalCommandPath(command) {
 /** Resolve one declared signature without treating arbitrary object keys as commands. */
 export function resolvePmCommandPositionalContract(command) {
     const normalized = normalizePositionalCommandPath(command);
-    return PM_COMMAND_POSITIONAL_CONTRACTS.find((contract) => contract.command === normalized);
+    const direct = PM_COMMAND_POSITIONAL_CONTRACTS.find((contract) => contract.command === normalized);
+    if (direct)
+        return direct;
+    const canonical = resolvePmCommandAlias(normalized)?.canonical;
+    if (!canonical)
+        return undefined;
+    return PM_COMMAND_POSITIONAL_CONTRACTS.find((contract) => contract.command === canonical);
 }
 /** Resolve one action-specific help/contract view. */
 export function resolvePmPositionalActionContract(command) {
@@ -654,9 +664,9 @@ export const PM_COMMAND_DESTINATION_CONTRACTS = [
         "package reload",
         "package scaffold",
         "package uninstall",
+        "package upgrade",
     ]),
     ...destinationRows("package", "package", "consolidation", "pm-tnud", [
-        "extension",
         "extension activate",
         "extension adopt",
         "extension adopt-all",
@@ -667,13 +677,10 @@ export const PM_COMMAND_DESTINATION_CONTRACTS = [
         "extension explore",
         "extension init",
         "extension install",
-        "extension list",
         "extension manage",
         "extension migrate",
         "extension reload",
-        "extension scaffold",
         "extension uninstall",
-        "install",
         "packages",
         "packages activate",
         "packages adopt",
@@ -691,7 +698,7 @@ export const PM_COMMAND_DESTINATION_CONTRACTS = [
         "packages reload",
         "packages scaffold",
         "packages uninstall",
-        "upgrade",
+        "packages upgrade",
     ]),
     ...destinationRows("package", "package", "package_owned", "package:beads", [
         "beads import",
@@ -958,4 +965,4 @@ export function verifyPmCliGrammar(commands, aliases = [], destinations = PM_COM
     };
 }
 //# sourceMappingURL=grammar-contracts.js.map
-//# debugId=21495fd2-6abb-5a4f-965c-e7b9c8f87dff
+//# debugId=d0f4c030-0028-5acb-a438-210666118074

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

@@ -4,7 +4,7 @@
  * 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]="428a19d2-be42-548a-a328-aa0e476b8a71")}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]="a4c43fa6-9f2e-515c-ab47-d21ef5d7878e")}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, ITEM_REOPEN_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, PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS, resolvePmCommandOutputBudget, } from "../cli-contracts.js";
@@ -217,7 +217,7 @@ const CANONICAL_COMMAND_ALIASES = [
     },
     {
         canonical: "package",
-        aliases: ["extension", "packages", "install"],
+        aliases: ["extension", "packages"],
     },
 ];
 const COMMAND_ALIAS_TO_CANONICAL = new Map(CANONICAL_COMMAND_ALIASES.flatMap((entry) => entry.aliases.map((alias) => [alias, entry.canonical])));
@@ -313,11 +313,9 @@ const COMMAND_INTENTS = new Map([
     ["history-redact", "Redact sensitive history values."],
     ["history-repair", "Repair history integrity."],
 ]);
-// Lifecycle subcommand flag contracts for `pm extension`. Only `init` differs
-// between extension and package: `pm package init` / `pm packages init`
-// additionally accept the package-only `--declarative` flag, so the package
-// variant swaps in PACKAGE_INIT_FLAG_CONTRACTS while every other subcommand is
-// shared verbatim.
+// Lifecycle subcommand flag contracts for `pm extension`. Package lifecycle
+// swaps in the declarative init contract and adds the package-only upgrade
+// command; every shared extension/package subcommand remains byte-identical.
 const EXTENSION_LIFECYCLE_FLAG_CONTRACTS = [
     ["init", EXTENSION_INIT_FLAG_CONTRACTS],
     ["install", EXTENSION_INSTALL_FLAG_CONTRACTS],
@@ -334,9 +332,12 @@ const EXTENSION_LIFECYCLE_FLAG_CONTRACTS = [
     ["deactivate", EXTENSION_DEACTIVATE_FLAG_CONTRACTS],
     ["migrate", EXTENSION_MIGRATE_FLAG_CONTRACTS],
 ];
-const PACKAGE_LIFECYCLE_FLAG_CONTRACTS = EXTENSION_LIFECYCLE_FLAG_CONTRACTS.map(([subcommand, flags]) => subcommand === "init"
-    ? [subcommand, PACKAGE_INIT_FLAG_CONTRACTS]
-    : [subcommand, flags]);
+const PACKAGE_LIFECYCLE_FLAG_CONTRACTS = [
+    ...EXTENSION_LIFECYCLE_FLAG_CONTRACTS.map(([subcommand, flags]) => subcommand === "init"
+        ? [subcommand, PACKAGE_INIT_FLAG_CONTRACTS]
+        : [subcommand, flags]),
+    ["upgrade", UPGRADE_FLAG_CONTRACTS],
+];
 const CORE_COMMAND_FLAG_CONTRACT_ENTRIES = [
     ...EXTENSION_LIFECYCLE_FLAG_CONTRACTS.map(([subcommand, flags]) => [`extension ${subcommand}`, flags]),
     ...PACKAGE_LIFECYCLE_FLAG_CONTRACTS.flatMap(([subcommand, flags]) => [
@@ -1686,6 +1687,7 @@ const COMMAND_OPERATION_INTENTS = new Map([
     ["run", "Run"],
     ["snapshot", "Manage snapshots for"],
     ["uninstall", "Uninstall"],
+    ["upgrade", "Upgrade"],
 ]);
 const COMMAND_INTENT_SUBJECT_OVERRIDES = new Map([
     ["extension adopt-all", "extensions"],
@@ -2082,4 +2084,4 @@ export const _testOnlyContractsCommand = {
     toRuntimeShortFlagToken,
 };
 //# sourceMappingURL=runtime-contracts.js.map
-//# debugId=428a19d2-be42-548a-a328-aa0e476b8a71
+//# debugId=a4c43fa6-9f2e-515c-ab47-d21ef5d7878e

package/dist/sdk/cli-contracts/tool-parameter-tables.js

@@ -4,7 +4,7 @@
  * Defines SDK command-contract metadata for Tool Parameter Tables.
  */
 
-!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]="2d43e788-cb8d-59b8-a447-4d24033bb55b")}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]="6968f481-8384-5e3b-8ac0-b0972d08eeb1")}catch(e){}}();
 import { PLAN_HARNESS_VALUES, PLAN_MODE_VALUES, PLAN_STEP_LINK_KIND_VALUES, PLAN_STEP_STATUS_VALUES, } from "../../types/index.js";
 import { PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS } from "../read-output-session.js";
 import { ASSURANCE_DEFINITION_SCHEMA } from "./schemas/assurance-definition.js";
@@ -499,6 +499,7 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     noCheckpoint: { type: "boolean" },
     force: { type: "boolean" },
     ifAvailable: { type: "boolean" },
+    ifAbsent: { type: "boolean" },
     next: { type: "boolean" },
     maxAttempts: {
         anyOf: [
@@ -1266,6 +1267,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
     message: {
         description: "History message for mutation audit trail.",
     },
+    ifAbsent: {
+        description: "For annotations, append only when no existing entry has the same resolved author and exact stored text; retries return changed false without a history event.",
+    },
     assignee: {
         description: "Assignee identity.",
     },
@@ -2029,11 +2033,17 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
         full: {
             description: "Return the complete post-mutation comment history instead of the bounded mutation receipt projection.",
         },
+        ifAbsent: {
+            description: "Append a comment only when the resolved author and exact stored text are absent; a duplicate retry returns changed false without writing history.",
+        },
     },
     notes: {
         full: {
             description: "Return the complete post-mutation note history instead of the bounded mutation receipt projection.",
         },
+        ifAbsent: {
+            description: "Append a note only when the resolved author and exact stored text are absent; a duplicate retry returns changed false without writing history.",
+        },
         since: {
             description: "Inclusive ISO 8601 creation timestamp lower bound for structured note event filtering.",
             examples: ["2026-01-01T00:00:00.000Z"],
@@ -2043,6 +2053,9 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
         full: {
             description: "Return the complete post-mutation learning history instead of the bounded mutation receipt projection.",
         },
+        ifAbsent: {
+            description: "Append a learning only when the resolved author and exact stored text are absent; a duplicate retry returns changed false without writing history.",
+        },
     },
     next: {
         tag: {
@@ -2128,4 +2141,4 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
     },
 };
 //# sourceMappingURL=tool-parameter-tables.js.map
-//# debugId=2d43e788-cb8d-59b8-a447-4d24033bb55b
+//# debugId=6968f481-8384-5e3b-8ac0-b0972d08eeb1

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

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

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

@@ -7,7 +7,7 @@
  * consumers from a single source of truth.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b54b0565-3968-59ea-b5f9-8ae52731473a")}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]="91de08b8-ad0b-5c61-a272-3c18cd3f083b")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 import { PM_TOOL_ACTIONS } from "./enum-contracts.js";
 import { TOOL_CREATE_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, } from "./tool-option-contracts.js";
@@ -152,7 +152,8 @@ const PM_TOOL_ACTION_NESTED_OPTION_COMPATIBILITY_KEYS = Object.freeze({
         "no_checkpoint",
         "filterAssignee_filter",
     ],
-    ...Object.fromEntries(PM_TOOL_ACTIONS.filter((action) => action === "install" ||
+    ...Object.fromEntries(PM_TOOL_ACTIONS.filter((action) => action === "upgrade" ||
+        action === "install" ||
         action === "extension" ||
         action === "package" ||
         action.startsWith("extension-") ||
@@ -412,6 +413,18 @@ const SCHEDULING_ACTION_SCHEMA_CONTRACT = {
         "message",
     ],
 };
+const UPGRADE_ACTION_SCHEMA_CONTRACT = {
+    optional: [
+        "target",
+        "scope",
+        "dryRun",
+        "cliOnly",
+        "packagesOnly",
+        "repair",
+        "tag",
+        "packageName",
+    ],
+};
 const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     init: {
         optional: [
@@ -442,22 +455,12 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     },
     ...managedLifecycleSchemaContracts("extension"),
     ...managedLifecycleSchemaContracts("package"),
+    "package-upgrade": UPGRADE_ACTION_SCHEMA_CONTRACT,
     install: {
         optional: ["target", "github", "scope", "ref"],
         anyOfRequired: [["target"], ["github"]],
     },
-    upgrade: {
-        optional: [
-            "target",
-            "scope",
-            "dryRun",
-            "cliOnly",
-            "packagesOnly",
-            "repair",
-            "tag",
-            "packageName",
-        ],
-    },
+    upgrade: UPGRADE_ACTION_SCHEMA_CONTRACT,
     create: {
         required: [
             "title",
@@ -847,8 +850,13 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "delete",
             "limit",
             "full",
+            "ifAbsent",
             ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
         ],
+        mutuallyExclusive: [
+            ["edit", "ifAbsent"],
+            ["delete", "ifAbsent"],
+        ],
     },
     notes: {
         required: ["id"],
@@ -864,6 +872,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "eventType",
             "includeMeta",
             "full",
+            "ifAbsent",
             ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
         ],
         mutuallyExclusive: [
@@ -872,6 +881,8 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             ["addJson", "file"],
             ["addJson", "edit"],
             ["addJson", "delete"],
+            ["edit", "ifAbsent"],
+            ["delete", "ifAbsent"],
         ],
     },
     learnings: {
@@ -884,8 +895,13 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "delete",
             "limit",
             "full",
+            "ifAbsent",
             ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
         ],
+        mutuallyExclusive: [
+            ["edit", "ifAbsent"],
+            ["delete", "ifAbsent"],
+        ],
     },
     files: {
         required: [],
@@ -1531,7 +1547,7 @@ function createLazyContractSchema(build) {
     });
 }
 /** Canonical version of the action-scoped strict MCP tool-parameters schema (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the MCP server, the `pm contracts` command, SDK consumers, and contract tests bind to one version constant. Bump the patch/minor for additive, backward-compatible schema changes; bump the MAJOR for breaking changes — the major also drives the `$id` `tool-parameters-v{major}` slug, so the two never drift. */
-export const PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.9.0";
+export const PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.10.1";
 /**
  * Major component of {@link PM_TOOL_PARAMETERS_SCHEMA_VERSION}, used to build the
  * schema `$id` slug so a breaking version bump renames the document in lockstep.
@@ -1613,4 +1629,4 @@ export const _testOnlyCliContracts = {
     withFlagAliasMetadata,
 };
 //# sourceMappingURL=tool-schema.js.map
-//# debugId=b54b0565-3968-59ea-b5f9-8ae52731473a
+//# debugId=91de08b8-ad0b-5c61-a272-3c18cd3f083b

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

@@ -14,7 +14,7 @@ export type { CommanderOptionAliasContract, CommanderOptionRegistrationContract,
 export { EXECUTABLE_COMMAND_ALIASES, PM_COMMAND_ALIAS_CONTRACTS, renderPmCommandAliasMigrationHint, resolvePmCommandAlias, type PmCommandAliasContract, type PmCommandAliasLifecycle, type PmCommandAliasRegistration, } from "./cli-contracts/command-aliases.js";
 export { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "./cli-contracts/commander-types.js";
 export { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, } from "./cli-contracts/commander-mutation-options.js";
-export { MERGE_SUBCOMMAND_VALUES, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_CLI_ONLY_TOOL_ACTION_WAIVERS, PM_EXTENSION_PACKAGE_ACTION_SUBCOMMANDS, PM_ITEM_ACTION_SUBCOMMANDS, PM_DEPRECATED_TOOL_ACTIONS, PM_DISCOVERABLE_TOOL_ACTIONS, PM_TOOL_ACTIONS, analyzePmToolActionParity, isPmToolAction, isPmExtensionCapabilityContract, isPmExtensionServiceNameContract, isPmExtensionPolicyModeContract, isPmExtensionPolicySurfaceContract, } from "./cli-contracts/enum-contracts.js";
+export { 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 type { MergeSubcommand, PmExtensionCapabilityContract, PmExtensionServiceNameContract, PmExtensionPolicyModeContract, PmExtensionTrustModeContract, PmExtensionSandboxProfileContract, PmExtensionPolicySurfaceContract, PmToolAction, } from "./cli-contracts/enum-contracts.js";
 export { TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_CREATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CALENDAR_OPTION_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_DEPS_OPTION_CONTRACTS, TOOL_GRAPH_OPTION_CONTRACTS, TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE, TOOL_CREATE_OPTION_CONTRACT_SOURCE, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE, TOOL_UPDATE_OPTION_CONTRACT_SOURCE, verifyToolOptionCliParity, type ToolOptionCliParityFinding, type ToolOptionCliParityReport, } from "./cli-contracts/tool-option-contracts.js";
 export type { OptionsFromContracts, PmBulkMutationControlOptions, PmBulkMutationFilterOptions, PmCloseActionOptions, PmCloseManyActionOptions, PmCreateActionOptions, PmMutationAttributionOptions, PmOptionScalar, PmUpdateActionOptions, PmUpdateManyActionOptions, } from "./cli-contracts/typed-action-inputs.js";