@unbrained/pm-cli 2026.8.10 → 2026.8.12

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

@@ -0,0 +1,252 @@
+/**
+ * @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]="2d81fb20-890a-553b-b761-d60caf56b502")}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", {
+    oneOf: [{ required: ["equals"] }, { required: ["state"] }],
+});
+/** 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"] },
+                                state: { enum: ["present", "missing"] },
+                            },
+                        },
+                        {
+                            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=2d81fb20-890a-553b-b761-d60caf56b502

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]="26955ae3-1aca-503e-9492-46652285d17a")}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]="e2028eff-b29e-5850-87b1-4a3e06f28964")}catch(e){}}();
 function cloneOptionContracts(contracts) {
     return contracts.map((contract) => ({ ...contract }));
 }
@@ -351,6 +351,7 @@ export const TOOL_ACTIVITY_OPTION_CONTRACTS = [
     { param: "limit", flag: "--limit" },
     { param: "unbounded", flag: "--unbounded" },
     { param: "compact", flag: "--compact" },
+    { param: "raw", flag: "--raw" },
     { param: "full", flag: "--full" },
     { param: "provenance", flag: "--provenance" },
     { param: "provenanceSummary", flag: "--provenance-summary" },
@@ -423,4 +424,4 @@ export const TOOL_GRAPH_OPTION_CONTRACTS = [
     { param: "summary", flag: "--summary" },
 ];
 //# sourceMappingURL=tool-option-contracts.js.map
-//# debugId=26955ae3-1aca-503e-9492-46652285d17a
+//# debugId=e2028eff-b29e-5850-87b1-4a3e06f28964

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]="6e0b4ff7-5aca-562b-b36c-c0c53987138d")}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]="6cdf1fd1-7328-5bae-9238-d317f6efba8a")}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 },
@@ -54,6 +55,7 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
             },
         ],
     },
+    outputRowContract: { type: "boolean" },
     path: { type: "string" },
     pmExecutable: { type: "string" },
     timeoutMs: { type: "number" },
@@ -259,8 +261,10 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     semanticWeight: { anyOf: [{ type: "string" }, { type: "number" }] },
     op: { type: "string" },
     compact: { type: "boolean" },
+    raw: { type: "boolean" },
     brief: { type: "boolean" },
     full: { type: "boolean" },
+    includeEmpty: { type: "boolean" },
     view: { type: "string", enum: ["agenda", "day", "week", "month"] },
     date: { type: "string" },
     from: { type: "string" },
@@ -369,6 +373,10 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
     verboseAuthorEvents: { type: "boolean" },
     match: { type: "string" },
     onlyIndex: { anyOf: [{ type: "string" }, { type: "number" }] },
+    removeIndex: {
+        type: "array",
+        items: { anyOf: [{ type: "string" }, { type: "number" }] },
+    },
     onlyLast: { type: "boolean" },
     envSet: { type: "array", items: { type: "string" } },
     envClear: { type: "array", items: { type: "string" } },
@@ -492,6 +500,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: {
@@ -548,6 +573,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" },
@@ -610,6 +638,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" } }],
@@ -901,6 +941,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
             },
         ],
     },
+    outputRowContract: {
+        description: "Include the row selector and TOON row-encoding contract on a read result.",
+    },
     profile: {
         description: "Emit deterministic timing diagnostics to stderr.",
     },
@@ -912,6 +955,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"],
@@ -1164,6 +1222,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.",
     },
@@ -1240,6 +1309,10 @@ export const PM_TOOL_PARAMETER_METADATA = {
         description: "Run only the 1-based linked-test index from pm test <id> --list order.",
         examples: [1, "2"],
     },
+    removeIndex: {
+        description: "Remove linked tests by their 1-based positions from pm test <id> --list order; repeatable and lossless for commands containing commas or equals signs.",
+        examples: [[1], ["2", "4"]],
+    },
     onlyLast: {
         description: "Run only the most recently added linked-test entry.",
     },
@@ -1597,6 +1670,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
     compact: {
         description: "Render compact projection output for search and list-family actions.",
     },
+    raw: {
+        description: "For activity, restore the compact per-event stream instead of the default item digest.",
+    },
     brief: {
         description: "Emit compact low-token output for commands that support terse projections or health details.",
         examples: [true],
@@ -1604,6 +1680,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
     full: {
         description: "Enable command-specific full/detail output mode when supported, such as deep item reads for get or full payload mode for search/history.",
     },
+    includeEmpty: {
+        description: "For stats, restore zero-count registered type and lifecycle-status buckets.",
+    },
     fields: {
         description: "Comma-separated projection fields for get, search, list-family, or context outputs. Valid field names are command-specific (e.g. score/matched_fields apply to search; context projects focus-row fields such as priority/deadline/completion_pct).",
         examples: [
@@ -1769,6 +1848,24 @@ 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.",
@@ -1922,4 +2019,4 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
     },
 };
 //# sourceMappingURL=tool-parameter-tables.js.map
-//# debugId=6e0b4ff7-5aca-562b-b36c-c0c53987138d
+//# debugId=6cdf1fd1-7328-5bae-9238-d317f6efba8a

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

@@ -90,15 +90,15 @@ export interface PmActionToolInputSchemaOptions {
  * `PM_TOOL_PARAMETERS_SCHEMA`, eliminating a hand-maintained MCP schema table.
  */
 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";
+/** 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.7.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]="4ce3417b-2ccc-5304-8275-30f6eb749db8")}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]="5a184f36-a305-59f1-8c68-ef53cea1df1e")}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";
@@ -31,6 +31,7 @@ const PM_TOOL_READ_OUTPUT_PARAMETER_KEYS = [
     "outputBudget",
     "outputFormat",
     "outputSession",
+    "outputRowContract",
 ];
 /** Canonical top-level MCP properties that take precedence over runtime custom fields. */
 export const PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES = new Set([
@@ -82,6 +83,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 = [
@@ -889,6 +891,9 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "offset",
             "noTruncate",
             "strictRead",
+            "explain",
+            "lines",
+            "decisionDepth",
             ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
         ],
         anyOfRequired: [["id"], ["lookupPath"]],
@@ -955,6 +960,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "add",
             "addJson",
             "remove",
+            "removeIndex",
             "run",
             "match",
             "onlyIndex",
@@ -1023,6 +1029,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     },
     stats: {
         optional: [
+            "includeEmpty",
             "storage",
             "metadataCoverage",
             "fieldUtilization",
@@ -1099,6 +1106,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: [
@@ -1442,15 +1475,15 @@ 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";
+/** 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.7.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",
@@ -1525,4 +1558,4 @@ export const _testOnlyCliContracts = {
     withFlagAliasMetadata,
 };
 //# sourceMappingURL=tool-schema.js.map
-//# debugId=4ce3417b-2ccc-5304-8275-30f6eb749db8
+//# debugId=5a184f36-a305-59f1-8c68-ef53cea1df1e

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";