@unbrained/pm-cli 2026.8.9 → 2026.8.11

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

@@ -7,7 +7,7 @@
  * a hand-picked test list.
  */
 
-!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]="0fd4d2b0-725f-53ed-8b2b-2eeb19406cb7")}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]="11dade38-a681-599f-b3b7-8d121418366d")}catch(e){}}();
 import { PM_TOOL_ACTIONS } from "./enum-contracts.js";
 import { resolveSubcommandFlagContractsForCommand, } from "./flag-contracts.js";
 import { pmToolActionParameterKeys } from "./tool-schema.js";
@@ -76,6 +76,11 @@ const CLI_POSITIONAL_PARAMETERS = new Set([
     "text",
 ]);
 const ACTION_POSITIONAL_PARAMETERS = {
+    assurance: {
+        id: "<id>",
+        kind: "<kind>",
+        subcommand: "<action>",
+    },
     event: { title: "<title>" },
     files: { lookupPath: "lookup <path...>" },
     meet: { title: "<title>" },
@@ -89,6 +94,7 @@ const ACTION_POSITIONAL_PARAMETERS = {
     },
 };
 const ACTION_FLAG_PARAMETER_OVERRIDES = {
+    assurance: { "--tree": "treeId" },
     init: {
         "--id-prefix": "idPrefix",
         "--no-merge-fence": "mergeFence",
@@ -143,6 +149,9 @@ const ACTION_FLAG_PARAMETER_OVERRIDES = {
     package: { "--gh": "github", "--scaffold": "init" },
     install: { "--gh": "github" },
 };
+const GLOBAL_FLAG_PARAMETER_OVERRIDES = {
+    "--pm-path": "path",
+};
 const ACTION_STRUCTURED_FLAG_PARAMETERS = {
     stats: {
         "--analytics": [
@@ -174,7 +183,8 @@ function actionCommand(action) {
     return action;
 }
 function parameterForFlag(action, flag) {
-    const override = ACTION_FLAG_PARAMETER_OVERRIDES[action]?.[flag];
+    const override = ACTION_FLAG_PARAMETER_OVERRIDES[action]?.[flag] ??
+        GLOBAL_FLAG_PARAMETER_OVERRIDES[flag];
     if (override !== undefined)
         return override;
     return flag
@@ -366,4 +376,4 @@ export function analyzeSdkCliParameterCompleteness(source = {}) {
     });
 }
 //# sourceMappingURL=completeness.js.map
-//# debugId=0fd4d2b0-725f-53ed-8b2b-2eeb19406cb7
+//# debugId=11dade38-a681-599f-b3b7-8d121418366d

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

@@ -23,7 +23,7 @@ export declare const PM_EXTENSION_POLICY_SURFACE_CONTRACTS: readonly ["commands.
 /** Restricts pm extension policy surface contract values accepted by command, SDK, and storage contracts. */
 export type PmExtensionPolicySurfaceContract = (typeof PM_EXTENSION_POLICY_SURFACE_CONTRACTS)[number];
 /** Public contract for pm core command names, shared by SDK and presentation-layer consumers. */
-export declare const PM_CORE_COMMAND_NAMES: readonly ["init", "config", "extension", "package", "packages", "install", "upgrade", "create", "item", "copy", "focus", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "context", "ctx", "get", "graph", "search", "duplicates", "eval", "next", "history", "events", "history-redact", "history-repair", "history-compact", "history-author-acknowledge", "merge", "schema", "profile", "activity", "restore", "update", "update-many", "close", "close-many", "delete", "append", "comments", "notes", "learnings", "files", "docs", "deps", "plan", "test", "test-all", "telemetry", "stats", "health", "validate", "gc", "workspace", "contracts", "claim", "release", "start-task", "pause-task", "close-task", "meet", "event", "remind", "help"];
+export declare const PM_CORE_COMMAND_NAMES: readonly ["init", "config", "extension", "package", "packages", "install", "upgrade", "create", "item", "copy", "focus", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "context", "ctx", "get", "graph", "search", "duplicates", "eval", "next", "history", "events", "history-redact", "history-repair", "history-compact", "history-author-acknowledge", "merge", "schema", "profile", "activity", "restore", "update", "update-many", "close", "close-many", "delete", "append", "comments", "notes", "learnings", "files", "docs", "deps", "plan", "test", "test-all", "telemetry", "stats", "health", "validate", "assurance", "gc", "workspace", "contracts", "claim", "release", "start-task", "pause-task", "close-task", "meet", "event", "remind", "help"];
 /** Supported values accepted by the graph subcommand contract across CLI, SDK, and MCP surfaces. */
 export declare const GRAPH_SUBCOMMAND_VALUES: readonly ["ancestors", "descendants", "predecessors", "successors", "paths", "impact", "analyze", "audit", "communities", "redundancy", "dominators", "slack", "centrality", "articulation", "plan", "index"];
 /** Restricts graph subcommand values accepted by command, SDK, and MCP contracts. */

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]="15daa637-4d30-5794-bdb5-87585d443cd3")}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]="818ca284-2aaa-5d35-b280-8c963d443b0c")}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";
 /** Public contract for pm extension capability contracts, shared by SDK and presentation-layer consumers. */
 export const PM_EXTENSION_CAPABILITY_CONTRACTS = [
@@ -90,6 +90,7 @@ export const PM_CORE_COMMAND_NAMES = [
     "stats",
     "health",
     "validate",
+    "assurance",
     "gc",
     "workspace",
     "contracts",
@@ -190,4 +191,4 @@ export function isPmExtensionPolicySurfaceContract(value) {
     return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value);
 }
 //# sourceMappingURL=enum-contracts.js.map
-//# debugId=15daa637-4d30-5794-bdb5-87585d443cd3
+//# debugId=818ca284-2aaa-5d35-b280-8c963d443b0c

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

@@ -168,6 +168,8 @@ export declare const DUPLICATES_FLAG_CONTRACTS: CliFlagContract[];
 export declare const HEALTH_FLAG_CONTRACTS: CliFlagContract[];
 /** Public contract for validate flag contracts, shared by SDK and presentation-layer consumers. */
 export declare const VALIDATE_FLAG_CONTRACTS: CliFlagContract[];
+/** Public assurance registry and gate-evaluation flag contracts. */
+export declare const ASSURANCE_FLAG_CONTRACTS: CliFlagContract[];
 /** Creates flag contracts using the validated operation inputs. */
 export declare const CREATE_FLAG_CONTRACTS: CliFlagContract[];
 /** Atomic item-batch flags shared by contracts, help, and completions. */

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]="932a6144-c4b4-5153-b8ff-0ef29e308bd0")}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]="48d9a5c7-f747-5fac-a534-01a4b3b7af2c")}catch(e){}}();
 import { normalizeUniqueStringList } from "./string-lists.js";
 import { RESERVED_EXTENSION_HOST_FLAGS } from "../../core/extensions/reserved-host-flags.js";
 function normalizeFlagAliasKey(flag) {
@@ -216,6 +216,7 @@ 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: "--stdin" },
     { flag: "--file" },
@@ -234,6 +235,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-json" },
     { flag: "--stdin" },
@@ -251,6 +253,7 @@ 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: "--limit" },
     { flag: "--full-history" },
@@ -260,6 +263,7 @@ export const LEARNINGS_FLAG_CONTRACTS = [
 ];
 /** Public contract for files flag contracts, shared by SDK and presentation-layer consumers. */
 export const FILES_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--add" },
     { flag: "--add-glob" },
     { flag: "--remove" },
@@ -275,12 +279,16 @@ export const FILES_FLAG_CONTRACTS = [
     { flag: "--offset" },
     { flag: "--no-truncate" },
     { flag: "--strict-read" },
+    { flag: "--explain" },
+    { flag: "--lines", value_name: "start:end" },
+    { flag: "--decision-depth", value_name: "n", value_type: "number" },
     { flag: "--author" },
     { flag: "--message" },
     { flag: "--force" },
 ];
 /** Public contract for docs flag contracts, shared by SDK and presentation-layer consumers. */
 export const DOCS_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--add" },
     { flag: "--add-glob" },
     { flag: "--remove" },
@@ -295,6 +303,7 @@ export const DOCS_FLAG_CONTRACTS = [
 ];
 /** Public contract for history flag contracts, shared by SDK and presentation-layer consumers. */
 export const HISTORY_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--limit" },
     { flag: "--compact" },
     { flag: "--full" },
@@ -319,6 +328,7 @@ export const MERGE_FLAG_CONTRACTS = [
 ];
 /** Public contract for history redact flag contracts, shared by SDK and presentation-layer consumers. */
 export const HISTORY_REDACT_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--literal" },
     { flag: "--regex" },
     { flag: "--replacement" },
@@ -329,6 +339,7 @@ export const HISTORY_REDACT_FLAG_CONTRACTS = [
 ];
 /** Public contract for history repair flag contracts, shared by SDK and presentation-layer consumers. */
 export const HISTORY_REPAIR_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--all" },
     { flag: "--dry-run" },
     { flag: "--author" },
@@ -345,6 +356,7 @@ export const HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS = [
 ];
 /** Public contract for history compact flag contracts, shared by SDK and presentation-layer consumers. */
 export const HISTORY_COMPACT_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--before" },
     { flag: "--ids", list: true },
     { flag: "--all-over", value_type: "number" },
@@ -693,21 +705,33 @@ export const REINDEX_FLAG_CONTRACTS = [
 ];
 /** Public contract for close flag contracts, shared by SDK and presentation-layer consumers. */
 export const CLOSE_FLAG_CONTRACTS = [
-    { flag: "--reason" },
-    { flag: "--close-reason" },
-    { flag: "--completed-at" },
-    { flag: "--duplicate-of" },
-    { flag: "--author" },
-    { flag: "--message" },
-    { flag: "--validate-close" },
+    { flag: "--id", value_name: "item-id" },
+    { flag: "--reason", value_name: "value" },
+    { flag: "--close-reason", value_name: "value" },
+    { flag: "--completed-at", value_name: "value" },
+    { flag: "--duplicate-of", value_name: "value" },
+    { flag: "--author", value_name: "value" },
+    { flag: "--message", value_name: "value" },
+    {
+        flag: "--validate-close",
+        value_name: "off|warn|strict",
+    },
     // pm-fl0c #11 (2026-05-28) + Codex P2 follow-up: inline closure-validation
     // fields. Surface them through the contract so `pm contracts --command
     // close`, the JSON help payload, and bootstrap flag normalization /
     // suggestions all stay consistent with the commander registration.
-    { flag: "--resolution" },
-    { flag: "--expected-result", aliases: ["--expected_result", "--expected"] },
-    { flag: "--actual-result", aliases: ["--actual_result", "--actual"] },
-    { flag: "--force" },
+    { flag: "--resolution", value_name: "value" },
+    {
+        flag: "--expected-result",
+        aliases: ["--expected_result", "--expected"],
+        value_name: "value",
+    },
+    {
+        flag: "--actual-result",
+        aliases: ["--actual_result", "--actual"],
+        value_name: "value",
+    },
+    { flag: "--force", value_type: "boolean" },
 ];
 // close-many shares update-many's `--filter-*` scoping family and close's
 // inline closure-validation fields. The shared close reason is required for the
@@ -746,6 +770,7 @@ export const CLOSE_MANY_FLAG_CONTRACTS = [
 ];
 /** Public contract for append flag contracts, shared by SDK and presentation-layer consumers. */
 export const APPEND_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--body", short: "-b" },
     { flag: "--author" },
     { flag: "--message" },
@@ -753,6 +778,7 @@ export const APPEND_FLAG_CONTRACTS = [
 ];
 /** Public contract for claim flag contracts, shared by SDK and presentation-layer consumers. */
 export const CLAIM_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--author", aliases: ["--assignee"] },
     { flag: "--message" },
     { flag: "--force" },
@@ -772,12 +798,14 @@ export const CLAIM_FLAG_CONTRACTS = [
 ];
 /** Public contract for restore flag contracts, shared by SDK and presentation-layer consumers. */
 export const RESTORE_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--author" },
     { flag: "--message" },
     { flag: "--force" },
 ];
 /** Public contract for delete flag contracts, shared by SDK and presentation-layer consumers. */
 export const DELETE_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--dry-run" },
     { flag: "--author" },
     { flag: "--message" },
@@ -785,27 +813,31 @@ export const DELETE_FLAG_CONTRACTS = [
 ];
 /** Public contract for release flag contracts, shared by SDK and presentation-layer consumers. */
 export const RELEASE_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--author", aliases: ["--assignee"] },
     { flag: "--message" },
     { flag: "--force" },
 ];
 /** Public contract for start task flag contracts, shared by SDK and presentation-layer consumers. */
 export const START_TASK_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--author", aliases: ["--assignee"] },
     { flag: "--message" },
     { flag: "--force" },
 ];
 /** Public contract for pause task flag contracts, shared by SDK and presentation-layer consumers. */
 export const PAUSE_TASK_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--author", aliases: ["--assignee"] },
     { flag: "--message" },
     { flag: "--force" },
 ];
 /** Public contract for close task flag contracts, shared by SDK and presentation-layer consumers. */
 export const CLOSE_TASK_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--author", aliases: ["--assignee"] },
     { flag: "--message" },
-    { flag: "--validate-close" },
+    { flag: "--validate-close", value_name: "off|warn|strict" },
     { flag: "--force" },
 ];
 /** Shared create-passthrough flags for every scheduling shortcut (GH-217). */
@@ -839,6 +871,7 @@ export const REMIND_FLAG_CONTRACTS = [
 ];
 /** Public contract for test flag contracts, shared by SDK and presentation-layer consumers. */
 export const TEST_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--add" },
     { flag: "--add-json" },
     { flag: "--remove" },
@@ -973,10 +1006,22 @@ export const VALIDATE_FLAG_CONTRACTS = [
     { flag: "--counts" },
     { flag: "--full" },
 ];
+/** Public assurance registry and gate-evaluation flag contracts. */
+export const ASSURANCE_FLAG_CONTRACTS = [
+    { flag: "--definition", value_name: "json" },
+    { flag: "--trigger", value_name: "value" },
+    { flag: "--tree", value_name: "value" },
+    { flag: "--gate", value_name: "id" },
+    { flag: "--limit", value_name: "number" },
+    { flag: "--dry-run" },
+    { flag: "--author", value_name: "value" },
+    { flag: "--message", value_name: "value" },
+];
 const ITEM_OWNERSHIP_AND_ISSUE_FLAG_CONTRACTS = [
     { flag: "--assignee" },
     { flag: "--parent" },
     { flag: "--allow-missing-parent" },
+    { flag: "--allow-unresolved-deps" },
     { flag: "--reviewer" },
     { flag: "--risk" },
     { flag: "--confidence" },
@@ -1112,6 +1157,7 @@ export const ITEM_MUTATE_FLAG_CONTRACTS = [
 ];
 /** Atomic item-completion flags shared by contracts, help, and completions. */
 export const ITEM_COMPLETE_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--transaction-id", value_name: "value", required: true },
     { flag: "--reason", value_name: "value" },
     { flag: "--file", value_name: "value", repeatable: true },
@@ -1124,7 +1170,7 @@ export const ITEM_COMPLETE_FLAG_CONTRACTS = [
     { flag: "--expected-result", value_name: "value" },
     { flag: "--actual-result", value_name: "value" },
     { flag: "--completed-at", value_name: "value" },
-    { flag: "--validate-close", value_name: "mode" },
+    { flag: "--validate-close", value_name: "off|warn|strict" },
     { flag: "--lock-ttl-seconds", value_name: "n" },
     { flag: "--lock-wait-ms", value_name: "n" },
     { flag: "--dry-run" },
@@ -1133,15 +1179,20 @@ export const ITEM_COMPLETE_FLAG_CONTRACTS = [
 ];
 /** Public contract for copy flag contracts, shared by SDK and presentation-layer consumers. */
 export const COPY_FLAG_CONTRACTS = [
-    { flag: "--title" },
-    { flag: "--author" },
-    { flag: "--message" },
+    { flag: "--id", value_name: "item-id" },
+    { flag: "--title", value_name: "value" },
+    { flag: "--author", value_name: "value" },
+    { flag: "--message", value_name: "value" },
     { flag: "--allow-duplicate", value_type: "boolean" },
 ];
 /** Public contract for focus flag contracts, shared by SDK and presentation-layer consumers. */
-export const FOCUS_FLAG_CONTRACTS = [{ flag: "--clear" }];
+export const FOCUS_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
+    { flag: "--clear" },
+];
 /** Public contract for update flag contracts, shared by SDK and presentation-layer consumers. */
 export const UPDATE_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--stdin-json" },
     { short: "-t", flag: "--title" },
     { short: "-d", flag: "--description" },
@@ -1272,6 +1323,7 @@ export const UPDATE_MANY_FLAG_CONTRACTS = [
     { flag: "--regression" },
     { flag: "--customer-impact" },
     { flag: "--customer_impact" },
+    { flag: "--allow-unresolved-deps" },
     { flag: "--dep" },
     { flag: "--dep-remove" },
     { flag: "--dep_remove" },
@@ -1407,10 +1459,11 @@ export const CONTEXT_FLAG_CONTRACTS = withCursorSemantics([
 ]));
 /** Public contract for get flag contracts, shared by SDK and presentation-layer consumers. */
 export const GET_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--for", value_name: "intent" },
     { flag: "--token-budget", aliases: ["--token_budget"] },
     { flag: "--depth" },
-    { flag: "--full" },
+    { flag: "--full", value_type: "boolean" },
     { flag: "--fields", list: true },
     { flag: "--at" },
     { flag: "--tree" },
@@ -1426,6 +1479,7 @@ export const GUIDE_FLAG_CONTRACTS = [
 ];
 /** Public contract for deps flag contracts, shared by SDK and presentation-layer consumers. */
 export const DEPS_FLAG_CONTRACTS = [
+    { flag: "--id", value_name: "item-id" },
     { flag: "--format" },
     { flag: "--max-depth" },
     { flag: "--collapse" },
@@ -1654,6 +1708,7 @@ const SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND = new Map([
     ["test-all", TEST_ALL_FLAG_CONTRACTS],
     ["telemetry", TELEMETRY_FLAG_CONTRACTS],
     ["health", HEALTH_FLAG_CONTRACTS],
+    ["assurance", ASSURANCE_FLAG_CONTRACTS],
     ["validate", VALIDATE_FLAG_CONTRACTS],
     ["gc", GC_FLAG_CONTRACTS],
     ["stats", STATS_FLAG_CONTRACTS],
@@ -1734,7 +1789,8 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
         extraParts.length === 0) {
         return withSubcommandGlobalFlags(resolveExtensionLifecycleFlagContracts(rootCommand, lifecycleSubcommand));
     }
-    return withSubcommandGlobalFlags(SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND.get(normalized) ?? []);
+    const contracts = SUBCOMMAND_FLAG_CONTRACTS_BY_COMMAND.get(normalized) ?? [];
+    return withSubcommandGlobalFlags(contracts);
 }
 /** Renders a space-separated, de-duplicated list of every flag spelling (short, canonical, and aliases) for shell-completion candidate generation, optionally appending the shared subcommand-global flags. */
 export function toCompletionFlagString(flagContracts, includeGlobal = true) {
@@ -1755,4 +1811,4 @@ export function toCompletionFlagString(flagContracts, includeGlobal = true) {
     return normalizeUniqueStringList(all).join(" ");
 }
 //# sourceMappingURL=flag-contracts.js.map
-//# debugId=932a6144-c4b4-5153-b8ff-0ef29e308bd0
+//# debugId=48d9a5c7-f747-5fac-a534-01a4b3b7af2c

package/dist/sdk/cli-contracts/registration-helpers.js

@@ -4,7 +4,7 @@
  * Provides CLI runtime support for Registration Helpers.
  */
 
-!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]="d44229ca-8c70-5d55-a168-32bfe66711e6")}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]="5f92dd0d-4eb1-5a7b-8891-931dd15deb81")}catch(e){}}();
 import { Option } from "commander";
 import { pathExists, refreshSearchArtifactsForMutation, shouldRunSearchRefreshInForeground, EXIT_CODE, PmCliError, printError, printResult, writeStdout, getSettingsPath, resolvePmRoot, readSettings, runActiveServiceOverride, setActiveCommandResult, } from "../runtime-primitives.js";
 import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "../cli-contracts.js";
@@ -320,6 +320,10 @@ export function normalizeCreateOptions(commandOptions, options = {}) {
             "allowMissingParent",
             "allow_missing_parent",
         ]) === true,
+        allowUnresolvedDeps: anyOptionTrue(commandOptions, [
+            "allowUnresolvedDeps",
+            "allow_unresolved_deps",
+        ]) === true,
         allowDuplicate: optionTrue(commandOptions, "allowDuplicate") === true,
         reviewer: readCreateString("reviewer"),
         risk: readCreateString("risk"),
@@ -405,6 +409,10 @@ export function normalizeUpdateOptions(commandOptions) {
         ownershipDependencyBypass: commandOptions.ownershipDependencyBypass === true ? true : undefined,
         assignee: readUpdateString("assignee"),
         parent: readUpdateString("parent"),
+        allowUnresolvedDeps: anyOptionTrue(commandOptions, [
+            "allowUnresolvedDeps",
+            "allow_unresolved_deps",
+        ]) === true,
         reviewer: readUpdateString("reviewer"),
         risk: readUpdateString("risk"),
         confidence: readUpdateString("confidence"),
@@ -970,4 +978,4 @@ export const _testOnly = {
     collectMutationItemIds,
 };
 //# sourceMappingURL=registration-helpers.js.map
-//# debugId=d44229ca-8c70-5d55-a168-32bfe66711e6
+//# debugId=5f92dd0d-4eb1-5a7b-8891-931dd15deb81

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

@@ -4,10 +4,10 @@
  * 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]="fc28e3a8-c827-5ccc-918a-12d6bf1a1592")}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]="651d4904-cae5-503b-8418-93bc44a413ad")}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, 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, 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, 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_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, resolvePmCommandOutputBudget, } from "../cli-contracts.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_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, resolvePmCommandOutputBudget, } from "../cli-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";
@@ -308,6 +308,8 @@ const CORE_COMMAND_FLAG_CONTRACT_ENTRIES = [
     ["create", CREATE_FLAG_CONTRACTS],
     ["item mutate", ITEM_MUTATE_FLAG_CONTRACTS],
     ["item complete", ITEM_COMPLETE_FLAG_CONTRACTS],
+    ["copy", COPY_FLAG_CONTRACTS],
+    ["focus", FOCUS_FLAG_CONTRACTS],
     ["update", UPDATE_FLAG_CONTRACTS],
     ["update-many", UPDATE_MANY_FLAG_CONTRACTS],
     ["upgrade", UPGRADE_FLAG_CONTRACTS],
@@ -364,6 +366,7 @@ const CORE_COMMAND_FLAG_CONTRACT_ENTRIES = [
     ["duplicates", DUPLICATES_FLAG_CONTRACTS],
     ["validate", VALIDATE_FLAG_CONTRACTS],
     ["health", HEALTH_FLAG_CONTRACTS],
+    ["assurance", ASSURANCE_FLAG_CONTRACTS],
     ["contracts", CONTRACTS_FLAG_CONTRACTS],
     ["completion", COMPLETION_FLAG_CONTRACTS],
     ["activity", ACTIVITY_FLAG_CONTRACTS],
@@ -1869,4 +1872,4 @@ export const _testOnlyContractsCommand = {
     toRuntimeShortFlagToken,
 };
 //# sourceMappingURL=runtime-contracts.js.map
-//# debugId=fc28e3a8-c827-5ccc-918a-12d6bf1a1592
+//# debugId=651d4904-cae5-503b-8418-93bc44a413ad