@unbrained/pm-cli 2026.8.9 → 2026.8.11

package/dist/sdk/cli-contracts/schemas/assurance-definition.js

@@ -0,0 +1,251 @@
+/**
+ * @module sdk/cli-contracts/schemas/assurance-definition
+ *
+ * Defines the strict JSON Schema accepted by assurance definition mutations.
+ */
+
+!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]="13e7d51c-8464-578c-8780-5ddb6e029705")}catch(e){}}();
+const ASSURANCE_VALUE_SCHEMA = {
+    oneOf: [{ type: "number" }, { type: "array", items: { type: "string" } }],
+};
+const ITEMS_FIELD_CONDITIONAL_SCHEMA = {
+    if: { required: ["field"] },
+};
+// Keep the JSON Schema keyword visible while avoiding unicorn/no-thenable,
+// which intentionally rejects object literals with a `then` property.
+Reflect.set(ITEMS_FIELD_CONDITIONAL_SCHEMA, "then", {
+    required: ["equals"],
+});
+/** JSON Schema for measurement, assertion, and gate assurance definitions. */
+export const ASSURANCE_DEFINITION_SCHEMA = {
+    oneOf: [
+        {
+            type: "object",
+            additionalProperties: false,
+            required: ["id", "source"],
+            properties: {
+                id: { type: "string", minLength: 1 },
+                description: { type: "string" },
+                max_cost: { type: "number", minimum: 0 },
+                source: {
+                    oneOf: [
+                        {
+                            type: "object",
+                            additionalProperties: false,
+                            required: ["kind"],
+                            allOf: [ITEMS_FIELD_CONDITIONAL_SCHEMA],
+                            properties: {
+                                kind: { const: "items" },
+                                statuses: { type: "array", items: { type: "string" } },
+                                types: { type: "array", items: { type: "string" } },
+                                tags: { type: "array", items: { type: "string" } },
+                                field: { type: "string" },
+                                equals: { type: ["string", "number", "boolean", "null"] },
+                            },
+                        },
+                        {
+                            type: "object",
+                            additionalProperties: false,
+                            required: ["kind", "dependency_kind"],
+                            properties: {
+                                kind: { const: "dependency_kind" },
+                                dependency_kind: { type: "string", minLength: 1 },
+                            },
+                        },
+                        {
+                            type: "object",
+                            required: ["kind", "operation", "field"],
+                            properties: {
+                                kind: { const: "graph" },
+                                operation: { type: "string", minLength: 1 },
+                                field: { type: "string", minLength: 1 },
+                                parameters: { type: "object" },
+                            },
+                            additionalProperties: false,
+                        },
+                        ...["validate", "health"].map((kind) => ({
+                            type: "object",
+                            required: ["kind", "check", "field"],
+                            properties: {
+                                kind: { const: kind },
+                                check: { type: "string", minLength: 1 },
+                                field: { type: "string", minLength: 1 },
+                            },
+                            additionalProperties: false,
+                        })),
+                        {
+                            type: "object",
+                            additionalProperties: false,
+                            required: ["kind"],
+                            properties: {
+                                kind: { const: "history" },
+                                op: { type: "string" },
+                                author: { type: "string" },
+                                harness: { type: "string" },
+                                model: { type: "string" },
+                            },
+                        },
+                        {
+                            type: "object",
+                            additionalProperties: false,
+                            required: ["kind", "link", "state"],
+                            properties: {
+                                kind: { const: "links" },
+                                link: { enum: ["files", "tests", "docs"] },
+                                state: { enum: ["present", "missing"] },
+                            },
+                        },
+                        {
+                            type: "object",
+                            additionalProperties: false,
+                            required: ["kind", "provider", "key"],
+                            properties: {
+                                kind: { const: "provider" },
+                                provider: { type: "string", minLength: 1 },
+                                key: { type: "string", minLength: 1 },
+                                parameters: { type: "object" },
+                            },
+                        },
+                        {
+                            type: "object",
+                            additionalProperties: false,
+                            required: ["kind", "expression"],
+                            properties: {
+                                kind: { const: "derived" },
+                                expression: { type: "object", minProperties: 1 },
+                            },
+                        },
+                    ],
+                },
+            },
+        },
+        {
+            type: "object",
+            additionalProperties: false,
+            required: [
+                "id",
+                "measurement_id",
+                "owner_item_id",
+                "scope",
+                "enforcement",
+                "negative_control",
+            ],
+            oneOf: [
+                { required: ["ceiling"] },
+                { required: ["floor"] },
+                { required: ["equals"] },
+                { required: ["zero"] },
+                { required: ["monotone_nondecreasing"] },
+                { required: ["monotone_nonincreasing"] },
+                { required: ["subset_of"] },
+            ],
+            allOf: [
+                {
+                    oneOf: [
+                        {
+                            not: {
+                                required: ["lifetime"],
+                                properties: { lifetime: { const: "retire" } },
+                            },
+                        },
+                        {
+                            required: ["lifetime", "retire_reason"],
+                            properties: {
+                                lifetime: { const: "retire" },
+                                retire_reason: { type: "string", minLength: 1 },
+                            },
+                        },
+                    ],
+                },
+            ],
+            properties: {
+                id: { type: "string", minLength: 1 },
+                measurement_id: { type: "string", minLength: 1 },
+                owner_item_id: { type: "string", minLength: 1 },
+                scope: {
+                    oneOf: [
+                        {
+                            type: "object",
+                            additionalProperties: false,
+                            required: ["kind"],
+                            properties: { kind: { enum: ["all", "active"] } },
+                        },
+                        {
+                            type: "object",
+                            additionalProperties: false,
+                            required: ["kind", "measurement_id"],
+                            properties: {
+                                kind: { const: "filter" },
+                                measurement_id: { type: "string", minLength: 1 },
+                            },
+                        },
+                    ],
+                },
+                ceiling: { type: "number" },
+                floor: { type: "number" },
+                equals: ASSURANCE_VALUE_SCHEMA,
+                zero: { const: true },
+                monotone_nondecreasing: { type: "number" },
+                monotone_nonincreasing: { type: "number" },
+                subset_of: { type: "array", items: { type: "string" } },
+                lifetime: { enum: ["hold", "retire"] },
+                retire_reason: { type: "string", minLength: 1 },
+                enforcement: { enum: ["block", "warn", "observe"] },
+                authorization_decision: { type: "string", minLength: 1 },
+                negative_control: {
+                    type: "object",
+                    additionalProperties: false,
+                    required: ["cases"],
+                    properties: {
+                        cases: {
+                            type: "array",
+                            minItems: 2,
+                            items: {
+                                type: "object",
+                                additionalProperties: false,
+                                required: ["observed", "expected"],
+                                properties: {
+                                    observed: ASSURANCE_VALUE_SCHEMA,
+                                    expected: { enum: ["pass", "fail"] },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        {
+            type: "object",
+            additionalProperties: false,
+            required: ["id", "assertion_ids", "triggers"],
+            properties: {
+                id: { type: "string", minLength: 1 },
+                description: { type: "string" },
+                assertion_ids: {
+                    type: "array",
+                    minItems: 1,
+                    items: { type: "string", minLength: 1 },
+                },
+                triggers: {
+                    type: "array",
+                    minItems: 1,
+                    items: {
+                        enum: [
+                            "pre-commit",
+                            "pre-push",
+                            "pre-merge",
+                            "ci",
+                            "pre-release",
+                            "post-release",
+                            "scheduled",
+                            "on-claim",
+                            "on-close",
+                        ],
+                    },
+                },
+            },
+        },
+    ],
+};
+//# sourceMappingURL=assurance-definition.js.map
+//# debugId=13e7d51c-8464-578c-8780-5ddb6e029705

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

@@ -170,6 +170,9 @@ export declare const TOOL_CREATE_OPTION_CONTRACT_SOURCE: readonly [{
 }, {
     readonly param: "allowMissingParent";
     readonly flag: "--allow-missing-parent";
+}, {
+    readonly param: "allowUnresolvedDeps";
+    readonly flag: "--allow-unresolved-deps";
 }, {
     readonly param: "allowDuplicate";
     readonly flag: "--allow-duplicate";
@@ -325,6 +328,9 @@ export declare const TOOL_UPDATE_OPTION_CONTRACT_SOURCE: readonly [{
 }, {
     readonly param: "allowMissingParent";
     readonly flag: "--allow-missing-parent";
+}, {
+    readonly param: "allowUnresolvedDeps";
+    readonly flag: "--allow-unresolved-deps";
 }, {
     readonly param: "dep";
     readonly flag: "--dep";

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

@@ -1,6 +1,6 @@
 /** Returns fresh option contract objects so exported arrays cannot share mutable entries. */
 
-!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]="13ab1164-d2b1-5954-80e8-08c6b12779da")}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]="26955ae3-1aca-503e-9492-46652285d17a")}catch(e){}}();
 function cloneOptionContracts(contracts) {
     return contracts.map((contract) => ({ ...contract }));
 }
@@ -183,6 +183,7 @@ export const TOOL_CREATE_OPTION_CONTRACT_SOURCE = [
     { param: "message", flag: "--message", allowEmpty: true },
     { param: "assignee", flag: "--assignee" },
     { param: "allowMissingParent", flag: "--allow-missing-parent" },
+    { param: "allowUnresolvedDeps", flag: "--allow-unresolved-deps" },
     { param: "allowDuplicate", flag: "--allow-duplicate", booleanish: true },
     { param: "reminder", flag: "--reminder", repeatable: true },
     { param: "event", flag: "--event", repeatable: true },
@@ -235,6 +236,7 @@ export const TOOL_UPDATE_OPTION_CONTRACT_SOURCE = [
     { param: "message", flag: "--message", allowEmpty: true },
     { param: "assignee", flag: "--assignee" },
     { param: "allowMissingParent", flag: "--allow-missing-parent" },
+    { param: "allowUnresolvedDeps", flag: "--allow-unresolved-deps" },
     { param: "dep", flag: "--dep", repeatable: true },
     { param: "depRemove", flag: "--dep-remove", repeatable: true },
     { param: "replaceDeps", flag: "--replace-deps" },
@@ -421,4 +423,4 @@ export const TOOL_GRAPH_OPTION_CONTRACTS = [
     { param: "summary", flag: "--summary" },
 ];
 //# sourceMappingURL=tool-option-contracts.js.map
-//# debugId=13ab1164-d2b1-5954-80e8-08c6b12779da
+//# debugId=26955ae3-1aca-503e-9492-46652285d17a

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

@@ -4,9 +4,10 @@
  * 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]="35c4b819-02d6-582a-a7eb-fe3f4a4903d9")}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]="28d82e94-0359-5ae8-87f1-145f412df35e")}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";
 /** Public contract for pm tool parameter properties, shared by SDK and presentation-layer consumers. */
 export const PM_TOOL_PARAMETER_PROPERTIES = {
     json: { type: "boolean", default: true },
@@ -164,6 +165,7 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     },
     idOnly: { type: "boolean" },
     allowMissingParent: { type: "boolean" },
+    allowUnresolvedDeps: { type: "boolean" },
     allowDuplicate: { type: "boolean" },
     duplicateOf: { type: "string" },
     configAction: { type: "string", enum: ["get", "set", "list", "export"] },
@@ -491,6 +493,23 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     sum: { type: "string" },
     avg: { type: "string" },
     tree: { type: "boolean" },
+    treeId: { type: "string", minLength: 1 },
+    definition: { type: "object" },
+    trigger: {
+        type: "string",
+        enum: [
+            "pre-commit",
+            "pre-push",
+            "pre-merge",
+            "ci",
+            "pre-release",
+            "post-release",
+            "scheduled",
+            "on-claim",
+            "on-close",
+        ],
+    },
+    gate: { type: "string", minLength: 1 },
     treeDepth: { anyOf: [{ type: "string" }, { type: "number" }] },
     includeUnparented: { type: "boolean" },
     gcScope: {
@@ -547,6 +566,9 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     apply: { type: "boolean" },
     discoveryNote: { type: "string" },
     lookupPath: { type: "array", items: { type: "string" } },
+    explain: { type: "boolean" },
+    lines: { type: "string", pattern: "^[1-9]\\d*:[1-9]\\d*$" },
+    decisionDepth: { type: "integer", minimum: 1, maximum: 32 },
     // GH-170 (pm-pfnx): single-string note for files/docs add batches (the shared
     // `note` key below is the array-typed create/update note seed).
     addNote: { type: "string" },
@@ -609,6 +631,18 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
 };
 /** Per-action property overrides for parameters whose transport shape differs from their shared default. */
 export const PM_TOOL_ACTION_SCOPED_PARAMETER_PROPERTIES = {
+    assurance: {
+        definition: ASSURANCE_DEFINITION_SCHEMA,
+        kind: {
+            type: "string",
+            enum: ["measurement", "assertion", "gate"],
+        },
+        subcommand: {
+            type: "string",
+            enum: ["list", "show", "put", "remove", "run", "verdicts"],
+        },
+        limit: { type: "integer", minimum: 1, maximum: 1000 },
+    },
     activity: {
         harness: {
             anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
@@ -911,6 +945,21 @@ export const PM_TOOL_PARAMETER_METADATA = {
         description: "Item identifier for read or mutation actions.",
         examples: ["pm-a1b2"],
     },
+    treeId: {
+        description: "Commit, tree, snapshot, or immutable workspace identity judged by an assurance gate.",
+        examples: ["0123456789abcdef", "release-candidate-3"],
+    },
+    definition: {
+        description: "Structured measurement, assertion, or gate declaration used by assurance put.",
+    },
+    trigger: {
+        description: "Lifecycle trigger used to evaluate an assurance gate.",
+        examples: ["ci", "pre-release"],
+    },
+    gate: {
+        description: "Stable assurance gate id used to filter durable verdict history.",
+        examples: ["release-readiness"],
+    },
     runId: {
         description: "Background test run identifier.",
         examples: ["tr-kq9x3f-93acde"],
@@ -979,6 +1028,10 @@ export const PM_TOOL_PARAMETER_METADATA = {
     allowDuplicate: {
         description: "Explicitly proceed when strict similarity governance finds likely duplicate items.",
     },
+    allowUnresolvedDeps: {
+        description: "Permit unresolved local dependency targets while returning dependency_target_unresolved warning receipts. Cross-workspace references should use source_kind=external instead.",
+        examples: [true],
+    },
     requiredTypes: {
         description: "Restrict a custom field's requirement to specific item types (schema add-field).",
         examples: [["Bug"], ["Story", "Spike"]],
@@ -1074,7 +1127,7 @@ export const PM_TOOL_PARAMETER_METADATA = {
         examples: [["error path covered by a regression test"]],
     },
     removeAc: {
-        description: "Acceptance criteria removed individually by exact text match (one criterion per entry).",
+        description: "Acceptance criteria removed individually by exact text match; the mutation fails atomically if any selector is unmatched (one criterion per entry).",
         examples: [["superseded manual QA step"]],
     },
     removeTags: {
@@ -1106,7 +1159,7 @@ export const PM_TOOL_PARAMETER_METADATA = {
         examples: [60, "120"],
     },
     acceptanceCriteria: {
-        description: "Acceptance criteria text.",
+        description: "Complete acceptance-criteria text supplied while creating or replacing an item field.",
     },
     author: {
         description: "Intentional mutation-author override. Agent harness identity is automatic when omitted.",
@@ -1159,6 +1212,17 @@ export const PM_TOOL_PARAMETER_METADATA = {
         description: "One or more source paths whose referencing pm items should be returned by files lookup.",
         examples: [["src/sdk/files.ts"], ["README.md", "docs/SDK.md"]],
     },
+    explain: {
+        description: "Include ranked linked-file, rationale, and governing-decision evidence for a files lookup.",
+    },
+    lines: {
+        description: "Inclusive start:end source-line range for Git contribution attribution; requires one lookup path.",
+        examples: ["10:24"],
+    },
+    decisionDepth: {
+        description: "Maximum typed relationship depth searched for a governing Decision during files lookup.",
+        examples: [8],
+    },
     clearComments: {
         description: "When true, clear item comments.",
     },
@@ -1764,6 +1828,34 @@ export const PM_TOOL_PARAMETER_METADATA = {
  * because its single `name` property must cover every action at once.
  */
 export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
+    assurance: {
+        subcommand: {
+            description: "Assurance operation: list, show, put, remove, run, or verdicts.",
+            examples: ["list", "run", "verdicts"],
+        },
+        kind: {
+            description: "Assurance declaration kind for registry operations: measurement, assertion, or gate.",
+            examples: ["measurement", "assertion", "gate"],
+        },
+        id: {
+            description: "Stable assurance declaration id or gate id, depending on subcommand.",
+            examples: ["active-issues", "release-readiness"],
+        },
+        limit: {
+            description: "Maximum number of newest assurance verdicts returned.",
+            examples: [10, 25],
+        },
+    },
+    update: {
+        acceptanceCriteria: {
+            description: "Complete acceptance-criteria replacement text. Use removeAc plus addAc together for an atomic one-entry repair that preserves unrelated criteria.",
+        },
+    },
+    "update-many": {
+        acceptanceCriteria: {
+            description: "Complete acceptance-criteria replacement text. Use removeAc plus addAc together for an atomic one-entry repair that preserves unrelated criteria.",
+        },
+    },
     stats: {
         since: {
             description: "Inclusive ISO 8601 timestamp or negative duration lower bound for provenance and fleet analytics.",
@@ -1907,4 +1999,4 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
     },
 };
 //# sourceMappingURL=tool-parameter-tables.js.map
-//# debugId=35c4b819-02d6-582a-a7eb-fe3f4a4903d9
+//# debugId=28d82e94-0359-5ae8-87f1-145f412df35e

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

@@ -91,14 +91,14 @@ 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 the contract tests all bind to one constant instead of re-typing the `"4.0.2"` literal (pm-r9sz). 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.4.1";
+export declare const PM_TOOL_PARAMETERS_SCHEMA_VERSION: "4.6.0";
 /**
  * Major component of {@link PM_TOOL_PARAMETERS_SCHEMA_VERSION}, used to build the
  * schema `$id` slug so a breaking version bump renames the document in lockstep.
  */
 export declare const PM_TOOL_PARAMETERS_SCHEMA_MAJOR: string;
 /** Version of the provider-compatible flat tool-parameters schema (`PM_PROVIDER_TOOL_PARAMETERS_SCHEMA`). Tracked separately from the strict schema because the flat projection evolves independently. */
-export declare const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION: "1.1.0";
+export declare const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION: "1.3.0";
 /** Public contract for pm tool parameters schema, shared by SDK and presentation-layer consumers. */
 export declare const PM_TOOL_PARAMETERS_SCHEMA: Record<string, unknown>;
 declare function toProviderCompatibleParameterDefinition(key: string, definition: unknown): Record<string, unknown>;

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]="d9f01e68-6b54-5861-a4b5-ae40613c2047")}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]="9882d78a-8742-5d50-b345-debe47322b65")}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";
@@ -82,6 +82,7 @@ const PM_TOOL_ACTION_MUTATION_PARAMETER_KEYS = {
     append: ["fullChangedFields"],
     "update-many": ["fullChangedFields"],
     "close-many": ["fullChangedFields"],
+    assurance: ["fullChangedFields", "idOnly"],
 };
 /** Create-compatible metadata parameters reused by Plan materialization and CLI registration. */
 export const PLAN_CREATE_METADATA_PARAMETER_KEYS = [
@@ -784,8 +785,21 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
         required: ["id", "target"],
         optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
     },
-    update: { required: ["id"], optional: UPDATE_CONTRACT_PARAMETER_KEYS },
-    "update-many": { optional: UPDATE_MANY_CONTRACT_PARAMETER_KEYS },
+    update: {
+        required: ["id"],
+        optional: UPDATE_CONTRACT_PARAMETER_KEYS,
+        mutuallyExclusive: [
+            ["acceptanceCriteria", "addAc"],
+            ["acceptanceCriteria", "removeAc"],
+        ],
+    },
+    "update-many": {
+        optional: UPDATE_MANY_CONTRACT_PARAMETER_KEYS,
+        mutuallyExclusive: [
+            ["acceptanceCriteria", "addAc"],
+            ["acceptanceCriteria", "removeAc"],
+        ],
+    },
     close: {
         required: ["id"],
         optional: [
@@ -876,6 +890,9 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "offset",
             "noTruncate",
             "strictRead",
+            "explain",
+            "lines",
+            "decisionDepth",
             ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
         ],
         anyOfRequired: [["id"], ["lookupPath"]],
@@ -1086,6 +1103,32 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "full",
         ],
     },
+    assurance: {
+        required: ["subcommand"],
+        optional: [
+            "kind",
+            "id",
+            "definition",
+            "trigger",
+            "treeId",
+            "gate",
+            "limit",
+            "dryRun",
+            "author",
+            "message",
+        ],
+        conditionalRequired: [
+            { property: "subcommand", value: "list", required: ["kind"] },
+            { property: "subcommand", value: "show", required: ["kind", "id"] },
+            {
+                property: "subcommand",
+                value: "put",
+                required: ["kind", "id", "definition"],
+            },
+            { property: "subcommand", value: "remove", required: ["kind", "id"] },
+            { property: "subcommand", value: "run", required: ["id", "trigger"] },
+        ],
+    },
     gc: { optional: ["dryRun", "gcScope"] },
     contracts: {
         optional: [
@@ -1430,14 +1473,14 @@ 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 the contract tests all bind to one constant instead of re-typing the `"4.0.2"` literal (pm-r9sz). 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.4.1";
+export const PM_TOOL_PARAMETERS_SCHEMA_VERSION = "4.6.0";
 /**
  * Major component of {@link PM_TOOL_PARAMETERS_SCHEMA_VERSION}, used to build the
  * schema `$id` slug so a breaking version bump renames the document in lockstep.
  */
 export const PM_TOOL_PARAMETERS_SCHEMA_MAJOR = PM_TOOL_PARAMETERS_SCHEMA_VERSION.split(".")[0];
 /** Version of the provider-compatible flat tool-parameters schema (`PM_PROVIDER_TOOL_PARAMETERS_SCHEMA`). Tracked separately from the strict schema because the flat projection evolves independently. */
-export const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION = "1.1.0";
+export const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION = "1.3.0";
 /** Public contract for pm tool parameters schema, shared by SDK and presentation-layer consumers. */
 export const PM_TOOL_PARAMETERS_SCHEMA = createLazyContractSchema(() => ({
     $schema: "https://json-schema.org/draft/2020-12/schema",
@@ -1512,4 +1555,4 @@ export const _testOnlyCliContracts = {
     withFlagAliasMetadata,
 };
 //# sourceMappingURL=tool-schema.js.map
-//# debugId=d9f01e68-6b54-5861-a4b5-ae40613c2047
+//# debugId=9882d78a-8742-5d50-b345-debe47322b65

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

@@ -19,7 +19,7 @@ export type { PmExtensionCapabilityContract, PmExtensionServiceNameContract, PmE
 export { TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_CREATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS, TOOL_CALENDAR_OPTION_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_DEPS_OPTION_CONTRACTS, TOOL_GRAPH_OPTION_CONTRACTS, TOOL_BULK_MUTATION_FILTER_OPTION_CONTRACT_SOURCE, TOOL_CREATE_OPTION_CONTRACT_SOURCE, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACT_SOURCE, TOOL_UPDATE_OPTION_CONTRACT_SOURCE, } from "./cli-contracts/tool-option-contracts.js";
 export type { OptionsFromContracts, PmBulkMutationControlOptions, PmBulkMutationFilterOptions, PmCloseActionOptions, PmCloseManyActionOptions, PmCreateActionOptions, PmMutationAttributionOptions, PmOptionScalar, PmUpdateActionOptions, PmUpdateManyActionOptions, } from "./cli-contracts/typed-action-inputs.js";
 export type { CliFlagContract, ToolOptionFlagContract, } from "./cli-contracts/flag-contracts.js";
-export { withFlagAliasMetadata, compactFlagAliasContracts, SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_SCOPE_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, REINDEX_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, EVENT_FLAG_CONTRACTS, EVENTS_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, hasSubcommandFlagContractsForCommand, resolveSubcommandFlagContractsForCommand, toCompletionFlagString, } from "./cli-contracts/flag-contracts.js";
+export { withFlagAliasMetadata, compactFlagAliasContracts, SUBCOMMAND_GLOBAL_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_SCOPE_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, REINDEX_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, EVENT_FLAG_CONTRACTS, EVENTS_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, hasSubcommandFlagContractsForCommand, resolveSubcommandFlagContractsForCommand, toCompletionFlagString, } from "./cli-contracts/flag-contracts.js";
 export type { PmActionSchemaContract } from "./cli-contracts/tool-schema.js";
 export { buildPmActionToolInputSchema, PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES, resolvePmToolCustomFieldCollision, CLOSE_ACTION_OPTION_KEYS, PLAN_CREATE_METADATA_PARAMETER_KEYS, PM_TOOL_ACTION_PARAMETER_CONTRACTS, PM_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA_MAJOR, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION, PM_TOOL_PARAMETERS_SCHEMA, PM_PROVIDER_TOOL_PARAMETERS_SCHEMA, _testOnlyCliContracts, } from "./cli-contracts/tool-schema.js";
 export type { PmActionToolInputSchemaOptions, PmToolCustomFieldCollision, } from "./cli-contracts/tool-schema.js";