@unbrained/pm-cli 2026.9.7 → 2026.9.9

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

@@ -1,1665 +1,2 @@
-/**
- * @module sdk/cli-contracts/tool-schema
- *
- * MCP tool-parameter schema contracts: the per-action required/optional key sets
- * and the lazily-built strict (action-scoped) and provider-compatible (flat)
- * JSON Schemas served to MCP clients, the `pm contracts` command, and SDK
- * 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]="e72f4ab4-5bf7-53fb-a3a3-174c4064f6a4")}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";
-import { PM_TOOL_PARAMETER_PROPERTIES, PM_TOOL_PARAMETER_METADATA, PM_TOOL_ACTION_SCOPED_PARAMETER_PROPERTIES, PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA, PLAN_ACTION_PARAMETER_PROPERTIES, PLAN_ACTION_PARAMETER_METADATA, } from "./tool-parameter-tables.js";
-import { toUniqueFlagContracts, withFlagAliasMetadata, } from "./flag-contracts.js";
-import { resolveReadOutputSurface } from "../read-output-contracts.js";
-const PM_TOOL_GLOBAL_PARAMETER_KEYS = [
-    "json",
-    "quiet",
-    "profile",
-    "noExtensions",
-    "noPager",
-    "tokenAccounting",
-    "path",
-    "pmExecutable",
-    "timeoutMs",
-];
-const PM_TOOL_READ_OUTPUT_PARAMETER_KEYS = [
-    "outputInclude",
-    "outputLimit",
-    "outputBudget",
-    "outputFormat",
-    "outputSession",
-    "outputCursor",
-    "outputRowContract",
-];
-/** Canonical top-level MCP properties that take precedence over runtime custom fields. */
-export const PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES = new Set([
-    "action",
-    "cwd",
-    "options",
-    ...Object.keys(PM_TOOL_PARAMETER_PROPERTIES).filter((property) => property !== "severity"),
-]);
-/** Resolve a runtime custom-field collision without changing dispatch semantics. */
-export function resolvePmToolCustomFieldCollision(field) {
-    const normalized = field.trim().toLowerCase();
-    let property = "";
-    for (let index = 0; index < normalized.length; index += 1) {
-        const character = normalized[index];
-        if (character !== "-" && character !== "_") {
-            property += character;
-            continue;
-        }
-        let nextIndex = index + 1;
-        while (normalized[nextIndex] === "-" || normalized[nextIndex] === "_") {
-            nextIndex += 1;
-        }
-        const nextCharacter = normalized[nextIndex];
-        if (nextCharacter !== undefined &&
-            ((nextCharacter >= "a" && nextCharacter <= "z") ||
-                (nextCharacter >= "0" && nextCharacter <= "9"))) {
-            property += nextCharacter.toUpperCase();
-            index = nextIndex;
-            continue;
-        }
-        property += normalized.slice(index, nextIndex);
-        index = nextIndex - 1;
-    }
-    return PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES.has(property)
-        ? {
-            field,
-            property,
-            owner: "mcp_tool_input",
-            nested_path: `options.${property}`,
-        }
-        : undefined;
-}
-const PM_TOOL_ACTION_MUTATION_PARAMETER_KEYS = {
-    create: ["fullChangedFields", "idOnly"],
-    copy: ["fullChangedFields", "idOnly"],
-    update: ["fullChangedFields", "idOnly"],
-    "item-reopen": ["fullChangedFields", "idOnly"],
-    close: ["fullChangedFields", "idOnly"],
-    restore: ["fullChangedFields", "idOnly"],
-    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 = [
-    "createMode",
-    "status",
-    "deadline",
-    "estimate",
-    "acceptanceCriteria",
-    "definitionOfReady",
-    "order",
-    "rank",
-    "goal",
-    "objective",
-    "value",
-    "impact",
-    "outcome",
-    "whyNow",
-    "assignee",
-    "reviewer",
-    "risk",
-    "confidence",
-    "sprint",
-    "release",
-    "blockedReason",
-    "unblockNote",
-    "reporter",
-    "severity",
-    "environment",
-    "reproSteps",
-    "resolution",
-    "expectedResult",
-    "actualResult",
-    "affectedVersion",
-    "fixedVersion",
-    "component",
-    "regression",
-    "customerImpact",
-    "comment",
-    "note",
-    "learning",
-    "reminder",
-    "event",
-    "typeOption",
-];
-/** Runtime-consumed nested compatibility keys that intentionally sit outside the canonical strict schema. */
-const PM_TOOL_ACTION_NESTED_OPTION_COMPATIBILITY_KEYS = Object.freeze({
-    "close-many": [
-        "list",
-        "expected_result",
-        "expected",
-        "actual_result",
-        "actual",
-        "validate_close",
-        "dry_run",
-        "checkpoint",
-        "no_checkpoint",
-        "filterAssignee_filter",
-    ],
-    "update-many": [
-        "list",
-        "update",
-        "dry_run",
-        "checkpoint",
-        "no_checkpoint",
-        "filterAssignee_filter",
-    ],
-    ...Object.fromEntries(PM_TOOL_ACTIONS.filter((action) => action === "upgrade" ||
-        action === "install" ||
-        action === "extension" ||
-        action === "package" ||
-        action.startsWith("extension-") ||
-        action.startsWith("package-")).map((action) => [action, ["project", "local", "global"]])),
-});
-function toSchemaKeyList(values) {
-    return normalizeUniqueStringList(values);
-}
-const CREATE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...TOOL_CREATE_OPTION_CONTRACTS.map((entry) => entry.param),
-    ...TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS.map((entry) => entry.param),
-    "assignee",
-    "closeReason",
-    "completedAt",
-]);
-const UPDATE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...TOOL_UPDATE_OPTION_CONTRACTS.map((entry) => entry.param),
-    ...TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS.map((entry) => entry.param),
-    "force",
-]);
-const UPDATE_MANY_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
-    ...UPDATE_CONTRACT_PARAMETER_KEYS.filter((key) => key !== "allowMissingParent" && key !== "completedAt"),
-    "dryRun",
-    "rollback",
-    "noCheckpoint",
-]);
-const CLOSE_MANY_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
-    "reason",
-    "completedAt",
-    "resolution",
-    "expectedResult",
-    "actualResult",
-    "validateClose",
-    "dryRun",
-    "rollback",
-    "noCheckpoint",
-    "author",
-    "message",
-    "force",
-]);
-const CONTEXT_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...TOOL_CONTEXT_OPTION_CONTRACTS.map((entry) => entry.param),
-    "past",
-    "section",
-]);
-const ACTIVITY_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...TOOL_ACTIVITY_OPTION_CONTRACTS.map((entry) => entry.param),
-    "stream",
-]);
-const LIST_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...TOOL_LIST_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
-    "all",
-    "includeBody",
-    "noTruncate",
-    "strictRead",
-    "compact",
-    "brief",
-    "full",
-]);
-const FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS = LIST_CONTRACT_PARAMETER_KEYS.filter((parameter) => parameter !== "all" && parameter !== "status");
-const LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS = [
-    [
-        { property: "today", schema: { const: true } },
-        { property: "recent", schema: { const: true } },
-    ],
-    [
-        { property: "today", schema: { const: true } },
-        { property: "updatedAfter", schema: { type: "string", pattern: "\\S" } },
-    ],
-    [
-        { property: "recent", schema: { const: true } },
-        { property: "updatedAfter", schema: { type: "string", pattern: "\\S" } },
-    ],
-];
-const CONTRACTS_PROJECTION_MUTUALLY_EXCLUSIVE_GROUPS = [
-    [
-        { property: "summary", schema: { const: true } },
-        { property: "schemaOnly", schema: { const: true } },
-    ],
-    [
-        { property: "summary", schema: { const: true } },
-        { property: "flagsOnly", schema: { const: true } },
-    ],
-    [
-        { property: "summary", schema: { const: true } },
-        { property: "availabilityOnly", schema: { const: true } },
-    ],
-    [
-        { property: "schemaOnly", schema: { const: true } },
-        { property: "flagsOnly", schema: { const: true } },
-    ],
-    [
-        { property: "schemaOnly", schema: { const: true } },
-        { property: "availabilityOnly", schema: { const: true } },
-    ],
-    [
-        { property: "flagsOnly", schema: { const: true } },
-        { property: "availabilityOnly", schema: { const: true } },
-    ],
-];
-const AGGREGATE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...TOOL_AGGREGATE_OPTION_CONTRACTS.map((entry) => entry.param),
-    "count",
-    "completion",
-    "includeUnparented",
-]);
-const SEARCH_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    "query",
-    "keywords",
-    "mode",
-    "semantic",
-    "hybrid",
-    "includeLinked",
-    "titleExact",
-    "phraseExact",
-    "highlight",
-    "compact",
-    "full",
-    ...TOOL_SEARCH_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
-]);
-const NEXT_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    "type",
-    "tag",
-    "priority",
-    "assignee",
-    "assigneeFilter",
-    "sprint",
-    "release",
-    "parent",
-    "limit",
-    "blockedLimit",
-    "readyOnly",
-    "format",
-    "includeDecisions",
-    "includeGates",
-    "includeContainers",
-    "tokenBudget",
-    "explainRanking",
-]);
-const AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS = ["author", "message", "force"];
-/** Close-action option keys shared by the strict tool schema and the typed SDK close input (pm-x29o); the author/message/force triple is appended separately by the schema contract. */
-export const CLOSE_ACTION_OPTION_KEYS = [
-    "text",
-    "reason",
-    "closeReason",
-    "completedAt",
-    "duplicateOf",
-    "validateClose",
-    "resolution",
-    "expectedResult",
-    "actualResult",
-];
-const LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS = [
-    "author",
-    "assignee",
-    "message",
-    "force",
-];
-const MANAGED_EXTENSION_PACKAGE_OPTION_KEYS = [
-    "target",
-    "scope",
-    "capability",
-    "declarative",
-    "github",
-    "ref",
-    "init",
-    "install",
-    "uninstall",
-    "explore",
-    "manage",
-    "describe",
-    "markdown",
-    "output",
-    "reload",
-    "doctor",
-    "catalog",
-    "list",
-    "adopt",
-    "adoptAll",
-    "activate",
-    "deactivate",
-    "runtimeProbe",
-    "fixManagedState",
-    "isolated",
-    "ignoreGlobal",
-    "detail",
-    "trace",
-    "watch",
-    "strictExit",
-    "failOnWarn",
-];
-function managedLifecycleSchemaContracts(prefix) {
-    return {
-        [`${prefix}-init`]: {
-            required: ["target"],
-            optional: [
-                "scope",
-                "capability",
-                ...(prefix === "package" ? ["declarative"] : []),
-            ],
-        },
-        [`${prefix}-install`]: {
-            optional: ["target", "github", "scope", "ref"],
-            anyOfRequired: [["target"], ["github"]],
-        },
-        [`${prefix}-uninstall`]: { required: ["target"], optional: ["scope"] },
-        [`${prefix}-explore`]: { optional: ["scope"] },
-        [`${prefix}-manage`]: {
-            optional: ["scope", "runtimeProbe", "fixManagedState"],
-        },
-        [`${prefix}-describe`]: {
-            optional: ["target", "scope", "markdown", "output"],
-        },
-        [`${prefix}-reload`]: { optional: ["scope", "watch"] },
-        [`${prefix}-doctor`]: {
-            optional: [
-                "scope",
-                "detail",
-                "trace",
-                "fixManagedState",
-                "isolated",
-                "ignoreGlobal",
-                "strictExit",
-                "failOnWarn",
-            ],
-        },
-        [`${prefix}-catalog`]: { optional: ["scope", "fields"] },
-        [`${prefix}-adopt`]: {
-            required: ["target"],
-            optional: ["scope", "github", "ref"],
-        },
-        [`${prefix}-adopt-all`]: { optional: ["scope"] },
-        [`${prefix}-activate`]: { required: ["target"], optional: ["scope"] },
-        [`${prefix}-deactivate`]: { required: ["target"], optional: ["scope"] },
-        [prefix]: {
-            optional: MANAGED_EXTENSION_PACKAGE_OPTION_KEYS,
-        },
-    };
-}
-const SCHEDULING_ACTION_SCHEMA_CONTRACT = {
-    required: ["title"],
-    optional: [
-        "start",
-        "duration",
-        "end",
-        "location",
-        "timezone",
-        "allDay",
-        "parent",
-        "allowMissingParent",
-        "tags",
-        "priority",
-        "body",
-        "description",
-        "author",
-        "message",
-    ],
-};
-const UPGRADE_ACTION_SCHEMA_CONTRACT = {
-    optional: [
-        "target",
-        "scope",
-        "dryRun",
-        "cliOnly",
-        "packagesOnly",
-        "repair",
-        "tag",
-        "packageName",
-    ],
-};
-const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
-    init: {
-        optional: [
-            "prefix",
-            "idPrefix",
-            "workspace",
-            "preset",
-            "typePreset",
-            "defaults",
-            "author",
-            "agentGuidance",
-            "withPackages",
-            "mergeFence",
-            "force",
-            "verbose",
-        ],
-    },
-    config: {
-        required: ["scope", "configAction"],
-        optional: [
-            "key",
-            "value",
-            "criterion",
-            "clearCriteria",
-            "format",
-            "policy",
-        ],
-    },
-    ...managedLifecycleSchemaContracts("extension"),
-    ...managedLifecycleSchemaContracts("package"),
-    "package-upgrade": UPGRADE_ACTION_SCHEMA_CONTRACT,
-    install: {
-        optional: ["target", "github", "scope", "ref"],
-        anyOfRequired: [["target"], ["github"]],
-    },
-    upgrade: UPGRADE_ACTION_SCHEMA_CONTRACT,
-    create: {
-        required: [
-            "title",
-            "description",
-            "type",
-            "status",
-            "priority",
-            "message",
-        ],
-        optional: CREATE_CONTRACT_PARAMETER_KEYS,
-    },
-    copy: {
-        required: ["id"],
-        optional: ["title", "author", "message", "allowDuplicate"],
-    },
-    focus: { optional: ["id", "clear"], mutuallyExclusive: [["id", "clear"]] },
-    list: {
-        optional: LIST_CONTRACT_PARAMETER_KEYS,
-        mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS,
-    },
-    "list-all": {
-        optional: LIST_CONTRACT_PARAMETER_KEYS,
-        mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS,
-    },
-    "list-draft": {
-        optional: FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS,
-        mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS,
-    },
-    "list-open": {
-        optional: FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS,
-        mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS,
-    },
-    "list-in-progress": {
-        optional: FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS,
-        mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS,
-    },
-    "list-blocked": {
-        optional: FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS,
-        mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS,
-    },
-    "list-closed": {
-        optional: FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS,
-        mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS,
-    },
-    "list-canceled": {
-        optional: FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS,
-        mutuallyExclusiveWhen: LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS,
-    },
-    aggregate: { optional: AGGREGATE_CONTRACT_PARAMETER_KEYS },
-    guide: { optional: ["list", "format", "depth"] },
-    context: { optional: CONTEXT_CONTRACT_PARAMETER_KEYS },
-    ctx: { optional: CONTEXT_CONTRACT_PARAMETER_KEYS },
-    get: {
-        required: ["id"],
-        optional: [
-            "for",
-            "tokenBudget",
-            "at",
-            "depth",
-            "full",
-            "fields",
-            "tree",
-            "treeDepth",
-            "format",
-        ],
-    },
-    search: {
-        optional: SEARCH_CONTRACT_PARAMETER_KEYS,
-        anyOfRequired: [["query"], ["keywords"]],
-    },
-    eval: { optional: ["mode", "k", "failUnder", "queries", "format"] },
-    events: {
-        optional: [
-            "since",
-            "type",
-            "author",
-            "item",
-            "limit",
-            "full",
-            "provenance",
-            "provenanceSummary",
-            "harness",
-            "agentInstance",
-            "provenanceFilter",
-            "cursorMode",
-        ],
-    },
-    merge: {
-        required: ["subcommand"],
-        optional: [
-            "dryRun",
-            "author",
-            "message",
-            "force",
-            "includeReconciled",
-            "artifact",
-            "basePath",
-            "oursPath",
-            "theirsPath",
-            "output",
-            "outputPath",
-            "itemPath",
-            "prefer",
-        ],
-    },
-    workspace: {
-        required: ["subcommand"],
-        optional: [
-            "snapshotAction",
-            "name",
-            "target",
-            "dryRun",
-            "force",
-            "author",
-            "message",
-            "lockTtlSeconds",
-            "lockWaitMs",
-        ],
-        conditionalRequired: [
-            {
-                property: "subcommand",
-                value: "snapshot",
-                required: ["snapshotAction"],
-            },
-        ],
-    },
-    meet: SCHEDULING_ACTION_SCHEMA_CONTRACT,
-    event: SCHEDULING_ACTION_SCHEMA_CONTRACT,
-    remind: {
-        required: ["title"],
-        optional: [
-            "at",
-            "text",
-            "parent",
-            "allowMissingParent",
-            "tags",
-            "priority",
-            "body",
-            "description",
-            "author",
-            "message",
-        ],
-    },
-    next: { optional: [...NEXT_CONTRACT_PARAMETER_KEYS, "for"] },
-    reindex: { optional: ["mode", "progress"] },
-    history: {
-        required: ["id"],
-        optional: [
-            "limit",
-            "compact",
-            "full",
-            "provenance",
-            "provenanceSummary",
-            "harness",
-            "agentInstance",
-            "provenanceFilter",
-            "diff",
-            "verify",
-            "field",
-            "strictExit",
-            "failOnWarn",
-            "format",
-        ],
-    },
-    "history-redact": {
-        required: ["id"],
-        optional: [
-            "literal",
-            "regex",
-            "replacement",
-            "dryRun",
-            ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-        anyOfRequired: [["literal"], ["regex"]],
-    },
-    "history-repair": {
-        // Exactly one of `id` (single stream) or `all` (bulk drift repair) is required.
-        optional: [
-            "id",
-            "all",
-            "dryRun",
-            "normalizeProvenance",
-            "salvageTail",
-            ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-        oneOfRequired: [["id"], ["all"]],
-        mutuallyExclusiveWhen: [
-            [
-                { property: "salvageTail", schema: { const: true } },
-                { property: "all", schema: { const: true } },
-            ],
-            [
-                { property: "salvageTail", schema: { const: true } },
-                { property: "normalizeProvenance", schema: { const: true } },
-            ],
-        ],
-    },
-    "history-author-acknowledge": {
-        optional: [
-            "historyEvent",
-            "allActionable",
-            "dryRun",
-            "planFingerprint",
-            "limit",
-            "attributedAuthor",
-            "reviewer",
-            "reason",
-        ],
-        oneOfRequired: [["historyEvent"], ["allActionable"]],
-    },
-    "history-compact": {
-        // Single-id mode (`id` + optional `before`) or bulk mode (any of `ids` /
-        // `allOver` / `closed` / `allStreams`, with optional `minEntries`). Scan
-        // selectors (`allOver` + `closed`/`allStreams`) legitimately combine, so the
-        // mode/exclusivity contract is enforced at runtime by assertHistoryCompactTarget
-        // rather than a one-of schema rule.
-        optional: [
-            "id",
-            "before",
-            "ids",
-            "allOver",
-            "closed",
-            "allStreams",
-            "minEntries",
-            "dryRun",
-            ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-    },
-    schema: {
-        required: ["subcommand"],
-        // No --message: schema mutations write config files, not item history.
-        optional: [
-            "name",
-            "description",
-            "defaultStatus",
-            "folder",
-            "alias",
-            "role",
-            "order",
-            "fieldType",
-            "commands",
-            "cliFlag",
-            "required",
-            "requiredOnCreate",
-            "allowUnset",
-            "requiredTypes",
-            "typePreset",
-            "infer",
-            "minCount",
-            "apply",
-            "to",
-            "migrationId",
-            "fieldTypeScope",
-            "dryRun",
-            "author",
-            "force",
-        ],
-        conditionalRequired: [
-            { property: "subcommand", value: "show", required: ["name"] },
-            { property: "subcommand", value: "show-status", required: ["name"] },
-            { property: "subcommand", value: "add-type", required: ["name"] },
-            { property: "subcommand", value: "remove-type", required: ["name"] },
-            // show-status/add-status/remove-status pass the status id as `name`.
-            { property: "subcommand", value: "add-status", required: ["name"] },
-            { property: "subcommand", value: "remove-status", required: ["name"] },
-            // field subcommands pass the field key as `name`.
-            { property: "subcommand", value: "add-field", required: ["name"] },
-            { property: "subcommand", value: "remove-field", required: ["name"] },
-            { property: "subcommand", value: "show-field", required: ["name"] },
-            {
-                property: "subcommand",
-                value: "rename-type",
-                required: ["name", "to"],
-            },
-            {
-                property: "subcommand",
-                value: "rename-field",
-                required: ["name", "to"],
-            },
-            {
-                property: "subcommand",
-                value: "remap-status",
-                required: ["name", "to"],
-            },
-            // apply-preset passes the preset name as `typePreset`.
-            {
-                property: "subcommand",
-                value: "apply-preset",
-                required: ["typePreset"],
-            },
-        ],
-    },
-    profile: {
-        required: ["subcommand"],
-        // No --message: profile staging writes config/schema files, not item history.
-        optional: ["name", "dryRun", "author", "force"],
-        conditionalRequired: [
-            { property: "subcommand", value: "show", required: ["name"] },
-            { property: "subcommand", value: "apply", required: ["name"] },
-            { property: "subcommand", value: "lint", required: ["name"] },
-        ],
-    },
-    plan: {
-        required: ["subcommand"],
-        optional: [
-            "id",
-            "stepRef",
-            "reorderTo",
-            "title",
-            "description",
-            "template",
-            "scope",
-            "parent",
-            "related",
-            "blocks",
-            "blockedBy",
-            "harness",
-            "mode",
-            "resumeContext",
-            "tags",
-            "priority",
-            ...PLAN_CREATE_METADATA_PARAMETER_KEYS,
-            "body",
-            "claim",
-            "fromSearch",
-            "stepTitle",
-            "step",
-            "stepBody",
-            "stepOwner",
-            "stepStatus",
-            "stepEvidence",
-            "stepBlockedReason",
-            "stepReplacement",
-            "dependsOn",
-            "link",
-            "linkKind",
-            "linkNote",
-            "promoteToItemDep",
-            "allowMultipleActive",
-            "file",
-            "test",
-            "doc",
-            "decisionText",
-            "decision",
-            "decisionRationale",
-            "decisionEvidence",
-            "discoveryText",
-            "discovery",
-            "validationText",
-            "validation",
-            "validationCommand",
-            "validationExpected",
-            "depth",
-            "fields",
-            "steps",
-            "materializeType",
-            "materializeParent",
-            "materializeTags",
-            "field",
-            ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-    },
-    activity: { optional: ACTIVITY_CONTRACT_PARAMETER_KEYS },
-    restore: {
-        required: ["id", "target"],
-        optional: AUTHOR_MESSAGE_FORCE_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: [
-            ...CLOSE_ACTION_OPTION_KEYS,
-            ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-    },
-    "close-many": { optional: CLOSE_MANY_CONTRACT_PARAMETER_KEYS },
-    delete: {
-        required: ["id"],
-        optional: ["dryRun", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],
-    },
-    append: {
-        required: ["id", "body"],
-        optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-    },
-    comments: {
-        required: ["id"],
-        optional: [
-            "text",
-            "add",
-            "stdin",
-            "edit",
-            "delete",
-            "limit",
-            "full",
-            "ifAbsent",
-            ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-        mutuallyExclusive: [
-            ["edit", "ifAbsent"],
-            ["delete", "ifAbsent"],
-        ],
-    },
-    notes: {
-        required: ["id"],
-        optional: [
-            "text",
-            "add",
-            "addJson",
-            "stdin",
-            "edit",
-            "delete",
-            "limit",
-            "since",
-            "eventType",
-            "includeMeta",
-            "full",
-            "ifAbsent",
-            ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-        mutuallyExclusive: [
-            ["addJson", "add"],
-            ["addJson", "stdin"],
-            ["addJson", "file"],
-            ["addJson", "edit"],
-            ["addJson", "delete"],
-            ["edit", "ifAbsent"],
-            ["delete", "ifAbsent"],
-        ],
-    },
-    learnings: {
-        required: ["id"],
-        optional: [
-            "text",
-            "add",
-            "stdin",
-            "edit",
-            "delete",
-            "limit",
-            "full",
-            "ifAbsent",
-            ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-        mutuallyExclusive: [
-            ["edit", "ifAbsent"],
-            ["delete", "ifAbsent"],
-        ],
-    },
-    files: {
-        required: [],
-        optional: [
-            "id",
-            "add",
-            "addGlob",
-            "remove",
-            "migrate",
-            "list",
-            // GH-170 (pm-pfnx): `addNote` is the MCP spelling of the CLI --note flag
-            // (the shared `note` parameter is the array-typed create/update note
-            // seed, so files/docs use a distinct single-string key).
-            "addNote",
-            "discover",
-            "apply",
-            "discoveryNote",
-            "appendStable",
-            "validatePaths",
-            "lookupPath",
-            "scope",
-            "limit",
-            "offset",
-            "noTruncate",
-            "strictRead",
-            "explain",
-            "lines",
-            "decisionDepth",
-            ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-        anyOfRequired: [["id"], ["lookupPath"]],
-        dependentAnyOfRequired: [
-            { property: "addNote", anyOfRequired: [["add"], ["addGlob"]] },
-        ],
-    },
-    docs: {
-        required: ["id"],
-        optional: [
-            "add",
-            "addGlob",
-            "remove",
-            "migrate",
-            "addNote",
-            "list",
-            "validatePaths",
-            ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-        dependentAnyOfRequired: [
-            { property: "addNote", anyOfRequired: [["add"], ["addGlob"]] },
-        ],
-    },
-    deps: {
-        required: ["id"],
-        optional: [
-            "format",
-            "maxDepth",
-            "collapse",
-            "summary",
-            "full",
-            "nodeLimit",
-            "edgeLimit",
-            "tokenBudget",
-            "cursor",
-            "direction",
-            "kind",
-        ],
-    },
-    graph: {
-        required: ["subcommand"],
-        optional: [
-            "id",
-            "target",
-            "kind",
-            "maxDepth",
-            "limit",
-            "after",
-            "direction",
-            "maxPaths",
-            "sample",
-            "exemptIsolate",
-            "exemptIsolateType",
-            "saveBaseline",
-            "rebuild",
-            "clear",
-            "summary",
-            "full",
-        ],
-    },
-    test: {
-        required: ["id"],
-        optional: [
-            "list",
-            "add",
-            "addJson",
-            "remove",
-            "removeIndex",
-            "run",
-            "match",
-            "onlyIndex",
-            "onlyLast",
-            "background",
-            "timeout",
-            "progress",
-            "envSet",
-            "envClear",
-            "sharedHostSafe",
-            "pmContext",
-            "overrideLinkedPmContext",
-            "workspaceContext",
-            "overrideLinkedWorkspaceContext",
-            "allowUntrustedLinkedTests",
-            "acknowledgeLinkedTests",
-            "failOnContextMismatch",
-            "failOnSkipped",
-            "failOnEmptyTestRun",
-            "requireAssertionsForPm",
-            "checkContext",
-            "autoPmContext",
-            "measure",
-            "metricBelow",
-            "metricDiff",
-            ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-        mutuallyExclusive: [
-            ["acknowledgeLinkedTests", "run"],
-            ["acknowledgeLinkedTests", "background"],
-        ],
-    },
-    "test-all": {
-        optional: [
-            "status",
-            "limit",
-            "offset",
-            "background",
-            "timeout",
-            "progress",
-            "envSet",
-            "envClear",
-            "sharedHostSafe",
-            "pmContext",
-            "overrideLinkedPmContext",
-            "workspaceContext",
-            "overrideLinkedWorkspaceContext",
-            "allowUntrustedLinkedTests",
-            "failOnContextMismatch",
-            "failOnSkipped",
-            "failOnEmptyTestRun",
-            "requireAssertionsForPm",
-            "checkContext",
-            "autoPmContext",
-        ],
-    },
-    telemetry: {
-        optional: ["subcommand", "limit"],
-    },
-    "test-runs-list": {
-        optional: ["status", "limit"],
-    },
-    "test-runs-status": {
-        required: ["runId"],
-    },
-    "test-runs-logs": {
-        required: ["runId"],
-        optional: ["stream", "tail"],
-    },
-    "test-runs-stop": {
-        required: ["runId"],
-        optional: ["force"],
-    },
-    "test-runs-resume": {
-        required: ["runId"],
-        optional: ["author"],
-    },
-    stats: {
-        optional: [
-            "includeEmpty",
-            "storage",
-            "metadataCoverage",
-            "fieldUtilization",
-            "byAssignee",
-            "byTag",
-            "byPriority",
-            "tagPrefix",
-            "measurements",
-            "metric",
-            "measurementLimit",
-            "observe",
-            "improvementDirection",
-            "measurementSource",
-            "measurementItem",
-            "measurementRevision",
-            "author",
-            "message",
-            "provenanceCoverage",
-            "fleetAttribution",
-            "since",
-            "eventLimit",
-            "minimumSample",
-        ],
-    },
-    duplicates: {
-        optional: ["status", "since", "threshold", "limit", "exhaustive"],
-    },
-    health: {
-        optional: [
-            "strictDirectories",
-            "requireMergeDrivers",
-            "strictExit",
-            "failOnWarn",
-            "checkOnly",
-            "checkTelemetry",
-            "noRefresh",
-            "refreshVectors",
-            "verboseStaleItems",
-            "verboseAuthorEvents",
-            "brief",
-            "summary",
-            "skipVectors",
-            "skipIntegrity",
-            "skipDrift",
-            "full",
-        ],
-    },
-    validate: {
-        optional: [
-            "checkStorageIntegrity",
-            "checkMetadata",
-            "metadataProfile",
-            "checkResolution",
-            "checkLifecycle",
-            "checkStaleBlockers",
-            "dependencyCycleSeverity",
-            "parentCycleSeverity",
-            "checkFiles",
-            "scanMode",
-            "includePmInternals",
-            "verboseFileLists",
-            "verboseDiagnostics",
-            "allAffectedIds",
-            "strictExit",
-            "failOnWarn",
-            "fixHints",
-            "autoFix",
-            "dryRun",
-            "fixScope",
-            "pruneMissing",
-            "checkHistoryDrift",
-            "checkCommandReferences",
-            "counts",
-            "full",
-        ],
-    },
-    assurance: {
-        required: ["subcommand"],
-        optional: [
-            "kind",
-            "id",
-            "definition",
-            "trigger",
-            "treeId",
-            "gate",
-            "limit",
-            "dryRun",
-            "author",
-            "message",
-            "preset",
-            "owner",
-            "apply",
-            "enforcement",
-        ],
-        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"] },
-            {
-                property: "subcommand",
-                value: "apply",
-                required: ["preset", "owner"],
-            },
-            { property: "subcommand", value: "derive", required: ["owner"] },
-            { property: "subcommand", value: "risk", required: ["definition"] },
-            { property: "subcommand", value: "lineages", required: ["definition"] },
-            {
-                property: "subcommand",
-                value: "promote",
-                required: ["id", "enforcement"],
-            },
-        ],
-        mutuallyExclusiveWhen: [
-            [
-                { property: "subcommand", schema: { const: "risk" } },
-                { property: "definition", schema: { not: { required: ["policy", "change"] } } },
-            ],
-            [
-                { property: "subcommand", schema: { const: "lineages" } },
-                { property: "definition", schema: { anyOf: [{ required: ["change"] }, { not: { required: ["policy"] } }] } },
-            ],
-        ],
-    },
-    gc: { optional: ["dryRun", "gcScope"] },
-    contracts: {
-        optional: [
-            "contractAction",
-            "command",
-            "summary",
-            "schemaOnly",
-            "flagsOnly",
-            "availabilityOnly",
-            "runtimeOnly",
-            "activeOnly",
-            "full",
-        ],
-        mutuallyExclusiveWhen: CONTRACTS_PROJECTION_MUTUALLY_EXCLUSIVE_GROUPS,
-    },
-    completion: { required: ["shell"], optional: ["eagerTags"] },
-    claim: {
-        optional: [
-            "id",
-            "next",
-            "ifAvailable",
-            "maxAttempts",
-            "includeDecisions",
-            ...NEXT_CONTRACT_PARAMETER_KEYS,
-            ...LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-        oneOfRequired: [["id"], ["next"]],
-    },
-    release: {
-        required: ["id"],
-        optional: LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-    },
-    "start-task": {
-        required: ["id"],
-        optional: LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-    },
-    "pause-task": {
-        required: ["id"],
-        optional: LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-    },
-    "close-task": {
-        required: ["id"],
-        optional: [
-            "text",
-            "validateClose",
-            ...LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS,
-        ],
-    },
-    "item-reopen": {
-        required: ["id", "reason"],
-        optional: ["status", "author", "message", "force"],
-    },
-};
-/** Public contract for pm tool action parameter contracts, shared by SDK and presentation-layer consumers. */
-export const PM_TOOL_ACTION_PARAMETER_CONTRACTS = Object.freeze(Object.fromEntries(PM_TOOL_ACTIONS.map((action) => [
-    action,
-    PM_TOOL_ACTION_SCHEMA_CONTRACTS[action],
-])));
-function fallbackToolParameterDescription(key) {
-    return key
-        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
-        .replace(/[_-]/g, " ")
-        .trim()
-        .replace(/^./, (value) => value.toUpperCase())
-        .concat(".");
-}
-function decorateToolParameterDefinition(key, definition) {
-    const baseDefinition = typeof definition === "object" && definition !== null
-        ? { ...definition }
-        : {};
-    const metadata = PM_TOOL_PARAMETER_METADATA[key];
-    return {
-        ...baseDefinition,
-        description: metadata?.description ?? fallbackToolParameterDescription(key),
-        ...(metadata?.examples ? { examples: metadata.examples } : {}),
-    };
-}
-function actionScopedToolParameterMetadata(action, key) {
-    if ((action === "list" || action.startsWith("list-")) && key === "all") {
-        return {
-            description: "Return items from every lifecycle status instead of the default active-status set.",
-        };
-    }
-    if (action === "plan" &&
-        Object.prototype.hasOwnProperty.call(PLAN_ACTION_PARAMETER_METADATA, key)) {
-        return PLAN_ACTION_PARAMETER_METADATA[key];
-    }
-    const actionOverrides = PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA[action];
-    if (actionOverrides &&
-        Object.prototype.hasOwnProperty.call(actionOverrides, key)) {
-        return actionOverrides[key];
-    }
-    return PM_TOOL_PARAMETER_METADATA[key];
-}
-function decorateActionScopedToolParameterDefinition(action, key, definition) {
-    const baseDefinition = typeof definition === "object" && definition !== null
-        ? { ...definition }
-        : {};
-    const metadata = actionScopedToolParameterMetadata(action, key);
-    return {
-        ...baseDefinition,
-        description: metadata?.description ?? fallbackToolParameterDescription(key),
-        ...(metadata?.examples ? { examples: metadata.examples } : {}),
-    };
-}
-function actionScopedToolParameterDefinition(action, key) {
-    const actionProperties = PM_TOOL_ACTION_SCOPED_PARAMETER_PROPERTIES[action];
-    if (actionProperties &&
-        Object.prototype.hasOwnProperty.call(actionProperties, key)) {
-        return actionProperties[key];
-    }
-    if (action === "plan" &&
-        Object.prototype.hasOwnProperty.call(PLAN_ACTION_PARAMETER_PROPERTIES, key)) {
-        return PLAN_ACTION_PARAMETER_PROPERTIES[key];
-    }
-    if ((action === "get" || action === "history" || action === "search") &&
-        key === "format") {
-        return { type: "string", enum: ["json", "toon"] };
-    }
-    return PM_TOOL_PARAMETER_PROPERTIES[key];
-}
-/** Build the `properties` map for one action-scoped schema: the fixed `action` literal followed by every allowed parameter that resolves to a concrete definition, each decorated with its action-scoped description and examples. */
-function buildActionScopedSchemaProperties(action, allowedKeys) {
-    const properties = {
-        action: {
-            const: action,
-            description: PM_TOOL_PARAMETER_METADATA.action?.description ??
-                "Tool action to execute.",
-        },
-    };
-    for (const key of allowedKeys) {
-        if (key === "action") {
-            continue;
-        }
-        const definition = actionScopedToolParameterDefinition(action, key);
-        if (definition) {
-            properties[key] = decorateActionScopedToolParameterDefinition(action, key, definition);
-        }
-    }
-    return properties;
-}
-/** Build the `oneOf` branches for an action whose contract requires exactly one of several field groups. Each branch requires its own group and — when sibling groups exist — forbids any field drawn from them, so the schema rejects the same overlapping combinations the runtime rejects; `history-repair`'s `all` branch additionally pins `all` to the literal `true`. */
-function buildOneOfSchemaEntries(action, oneOfRequiredGroups) {
-    const allOneOfFields = oneOfRequiredGroups.flat();
-    return oneOfRequiredGroups.map((requiredFields) => {
-        const otherFields = allOneOfFields.filter((field) => !requiredFields.includes(field));
-        return {
-            required: [...requiredFields],
-            ...(otherFields.length > 0
-                ? {
-                    not: { anyOf: otherFields.map((field) => ({ required: [field] })) },
-                }
-                : {}),
-            ...(action === "history-repair" && requiredFields.includes("all")
-                ? { properties: { all: { const: true } } }
-                : action === "claim" && requiredFields.includes("next")
-                    ? { properties: { next: { const: true } } }
-                    : {}),
-        };
-    });
-}
-/** Build the consolidated `allOf` constraint list for an action's contract, appending branches in a fixed order — conditional-required (`if`/`then`), then dependent any-of-required, then mutually-exclusive (`not`/`required`) — so a given contract always serializes to a byte-identical schema. Returns an empty array when the contract declares none of these constraints, letting the caller omit the `allOf` key entirely. */
-function buildActionScopedAllOf(contract) {
-    const allOf = [];
-    if (contract.conditionalRequired && contract.conditionalRequired.length > 0) {
-        for (const entry of contract.conditionalRequired) {
-            allOf.push({
-                if: {
-                    properties: {
-                        [entry.property]: { const: entry.value },
-                    },
-                    required: [entry.property],
-                },
-                // eslint-disable-next-line unicorn/no-thenable -- JSON Schema conditional keyword, not a Promise-like object.
-                then: {
-                    required: entry.required,
-                },
-            });
-        }
-    }
-    if (contract.dependentAnyOfRequired &&
-        contract.dependentAnyOfRequired.length > 0) {
-        for (const entry of contract.dependentAnyOfRequired) {
-            allOf.push({
-                if: { required: [entry.property] },
-                // eslint-disable-next-line unicorn/no-thenable -- JSON Schema conditional keyword, not a Promise-like object.
-                then: {
-                    anyOf: entry.anyOfRequired.map((requiredFields) => ({
-                        required: [...requiredFields],
-                    })),
-                },
-            });
-        }
-    }
-    if (contract.mutuallyExclusive && contract.mutuallyExclusive.length > 0) {
-        for (const group of contract.mutuallyExclusive) {
-            allOf.push({ not: { required: toSchemaKeyList(group) } });
-        }
-    }
-    if (contract.mutuallyExclusiveWhen &&
-        contract.mutuallyExclusiveWhen.length > 0) {
-        for (const group of contract.mutuallyExclusiveWhen) {
-            allOf.push({
-                not: {
-                    allOf: group.map((condition) => ({
-                        properties: { [condition.property]: condition.schema },
-                        required: [condition.property],
-                    })),
-                },
-            });
-        }
-    }
-    return allOf;
-}
-/**
- * Return the complete allowed parameter-key set for one pm action — the fixed
- * `action` selector, global transport parameters, mutation projection keys,
- * and the action contract's required and optional keys — or `undefined` for
- * an action the contract tables do not describe (extension- and package-owned
- * actions accept arbitrary passthrough keys by design). This is the single
- * source of truth shared by the strict action-scoped schema builder and the
- * MCP server's unknown-option detection.
- */
-export function pmToolActionParameterKeys(action) {
-    if (!Object.prototype.hasOwnProperty.call(PM_TOOL_ACTION_SCHEMA_CONTRACTS, action)) {
-        return undefined;
-    }
-    const contract = PM_TOOL_ACTION_SCHEMA_CONTRACTS[action];
-    const mutationParameterKeys = PM_TOOL_ACTION_MUTATION_PARAMETER_KEYS[action] ?? [];
-    return toSchemaKeyList([
-        "action",
-        ...PM_TOOL_GLOBAL_PARAMETER_KEYS,
-        ...(resolveReadOutputSurface(action) !== undefined
-            ? PM_TOOL_READ_OUTPUT_PARAMETER_KEYS
-            : []),
-        ...mutationParameterKeys,
-        ...(contract.required ?? []),
-        ...(contract.optional ?? []),
-    ]);
-}
-/**
- * Return every key the runtime consumes from a nested MCP `options` object.
- * Canonical action parameters remain the baseline; this adds only the
- * action-scoped compatibility grammar that is intentionally normalized before
- * dispatch (bulk list/update wrappers, legacy bulk aliases, and managed
- * extension/package scope aliases). Keeping these keys beside the strict
- * contracts prevents typo warnings from describing valid compatibility input
- * as a no-op without weakening detection on unrelated actions.
- */
-export function pmToolActionNestedOptionKeys(action) {
-    const parameterKeys = pmToolActionParameterKeys(action);
-    if (parameterKeys === undefined)
-        return undefined;
-    return toSchemaKeyList([
-        ...parameterKeys,
-        ...(PM_TOOL_ACTION_NESTED_OPTION_COMPATIBILITY_KEYS[action] ?? []),
-    ]);
-}
-function buildActionScopedToolSchema(action) {
-    const contract = PM_TOOL_ACTION_SCHEMA_CONTRACTS[action];
-    const required = toSchemaKeyList(contract.required ?? []);
-    const allowedKeys = pmToolActionParameterKeys(action);
-    const schema = {
-        type: "object",
-        additionalProperties: false,
-        required: ["action", ...required],
-        title: `pm action "${action}" parameters`,
-        properties: buildActionScopedSchemaProperties(action, allowedKeys),
-    };
-    if (contract.anyOfRequired && contract.anyOfRequired.length > 0) {
-        schema.anyOf = contract.anyOfRequired.map((requiredFields) => ({
-            required: [...requiredFields],
-        }));
-    }
-    if (contract.oneOfRequired && contract.oneOfRequired.length > 0) {
-        schema.oneOf = buildOneOfSchemaEntries(action, contract.oneOfRequired);
-    }
-    const allOf = buildActionScopedAllOf(contract);
-    if (allOf.length > 0) {
-        schema.allOf = allOf;
-    }
-    return schema;
-}
-/**
- * Build a narrow MCP tool schema from the canonical action contract.
- *
- * The action selector is fixed by the narrow tool and therefore removed. The
- * resulting flat camelCase properties remain the same definitions used by
- * `PM_TOOL_PARAMETERS_SCHEMA`, eliminating a hand-maintained MCP schema table.
- */
-export function buildPmActionToolInputSchema(action, options = {}) {
-    const actionSchema = buildActionScopedToolSchema(action);
-    const actionProperties = {
-        ...actionSchema.properties,
-    };
-    delete actionProperties.action;
-    const conditionalBranches = [
-        ...(actionSchema.anyOf ??
-            []),
-        ...(actionSchema.oneOf ??
-            []),
-    ];
-    const required = (options.required ?? actionSchema.required.map(String)).filter((key) => {
-        if (key === "action")
-            return false;
-        if (options.required === undefined)
-            return true;
-        return !conditionalBranches.some((branch) => branch.required?.map(String).includes(key));
-    });
-    const schema = {
-        type: "object",
-        additionalProperties: options.additionalProperties ?? true,
-        properties: {
-            ...actionProperties,
-            options: {
-                type: "object",
-                additionalProperties: true,
-                description: "Advanced command options forwarded to the selected pm action.",
-            },
-            ...options.properties,
-        },
-        required,
-    };
-    if (actionSchema.anyOf !== undefined)
-        schema.anyOf = actionSchema.anyOf;
-    if (actionSchema.oneOf !== undefined)
-        schema.oneOf = actionSchema.oneOf;
-    if (actionSchema.allOf !== undefined)
-        schema.allOf = actionSchema.allOf;
-    return schema;
-}
-// Building the full MCP tool-parameter schemas (one variant per action) is only
-// needed by the MCP server, the `pm contracts` command, and SDK consumers — never
-// on the hot CLI path that imports this module for flag contracts. Wrap them in a
-// memoized lazy Proxy so the build is deferred until first property access and the
-// object API (`.type`, `.oneOf`, spread, JSON.stringify) stays identical.
-function createLazyContractSchema(build) {
-    let value;
-    const resolve = () => (value ??= build());
-    return new Proxy({}, {
-        get: (_target, prop) => resolve()[prop],
-        has: (_target, prop) => prop in resolve(),
-        ownKeys: () => Reflect.ownKeys(resolve()),
-        getOwnPropertyDescriptor: (_target, prop) => {
-            const descriptor = Reflect.getOwnPropertyDescriptor(resolve(), prop);
-            if (descriptor) {
-                descriptor.configurable = true;
-            }
-            return descriptor;
-        },
-    });
-}
-/** 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.14.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.7.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",
-    $id: `https://schema.unbrained.dev/pm-cli/tool-parameters-v${PM_TOOL_PARAMETERS_SCHEMA_MAJOR}.schema.json`,
-    title: "pm-cli tool parameters (action-scoped strict schema)",
-    "x-schema-version": PM_TOOL_PARAMETERS_SCHEMA_VERSION,
-    type: "object",
-    oneOf: PM_TOOL_ACTIONS.map((action) => buildActionScopedToolSchema(action)),
-}));
-function toProviderCompatibleParameterDefinition(key, definition) {
-    const decorated = decorateToolParameterDefinition(key, definition);
-    if (typeof decorated.type === "string") {
-        return decorated;
-    }
-    const anyOf = Array.isArray(decorated.anyOf)
-        ? decorated.anyOf
-        : [];
-    const firstTypedVariant = anyOf.find((variant) => typeof variant.type === "string");
-    if (firstTypedVariant) {
-        const { anyOf: _anyOf, ...rest } = decorated;
-        // Spread the whole typed variant (type plus any enum/minimum/maximum/pattern
-        // constraints) so the flat provider schema keeps the variant's validation,
-        // then let the decorated top-level fields (description, examples) win.
-        return {
-            ...firstTypedVariant,
-            ...rest,
-        };
-    }
-    const { anyOf: _anyOf, ...rest } = decorated;
-    return {
-        ...rest,
-        type: "string",
-    };
-}
-function buildProviderCompatibleToolSchema() {
-    const properties = {
-        action: {
-            type: "string",
-            description: PM_TOOL_PARAMETER_METADATA.action?.description ??
-                "Tool action to execute.",
-        },
-        options: {
-            type: "object",
-            additionalProperties: true,
-            description: "Advanced command options object forwarded to the selected pm action.",
-        },
-    };
-    for (const key of Object.keys(PM_TOOL_PARAMETER_PROPERTIES).sort()) {
-        properties[key] = toProviderCompatibleParameterDefinition(key, PM_TOOL_PARAMETER_PROPERTIES[key]);
-    }
-    return {
-        title: "pm-cli tool parameters (provider-compatible flat schema)",
-        "x-schema-version": PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION,
-        type: "object",
-        additionalProperties: false,
-        required: ["action"],
-        properties,
-    };
-}
-/** Public contract for pm provider tool parameters schema, shared by SDK and presentation-layer consumers. */
-export const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = createLazyContractSchema(buildProviderCompatibleToolSchema);
-/** Public contract for test only cli contracts, shared by SDK and presentation-layer consumers. */
-export const _testOnlyCliContracts = {
-    buildActionScopedToolSchema,
-    buildProviderCompatibleToolSchema,
-    decorateActionScopedToolParameterDefinition,
-    decorateToolParameterDefinition,
-    toolActionSchemaContracts: PM_TOOL_ACTION_SCHEMA_CONTRACTS,
-    toolParameterMetadata: PM_TOOL_PARAMETER_METADATA,
-    toProviderCompatibleParameterDefinition,
-    toUniqueFlagContracts,
-    withFlagAliasMetadata,
-};
+!(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]="75c2f9b6-7145-58d8-9db0-58ba696bc6ab")}catch(e2){}})();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";import{PM_TOOL_PARAMETER_PROPERTIES,PM_TOOL_PARAMETER_METADATA,PM_TOOL_ACTION_SCOPED_PARAMETER_PROPERTIES,PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA,PLAN_ACTION_PARAMETER_PROPERTIES,PLAN_ACTION_PARAMETER_METADATA}from"./tool-parameter-tables.js";import{toUniqueFlagContracts,withFlagAliasMetadata}from"./flag-contracts.js";import{resolveReadOutputSurface}from"../read-output-contracts.js";const PM_TOOL_GLOBAL_PARAMETER_KEYS=["json","quiet","profile","noExtensions","noPager","tokenAccounting","path","pmExecutable","timeoutMs"];const PM_TOOL_READ_OUTPUT_PARAMETER_KEYS=["outputInclude","outputLimit","outputBudget","outputFormat","outputSession","outputCursor","outputRowContract"];const PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES=new Set(["action","cwd","options",...Object.keys(PM_TOOL_PARAMETER_PROPERTIES).filter(property=>property!=="severity")]);function resolvePmToolCustomFieldCollision(field){const normalized=field.trim().toLowerCase();let property="";for(let index=0;index<normalized.length;index+=1){const character=normalized[index];if(character!=="-"&&character!=="_"){property+=character;continue}let nextIndex=index+1;while(normalized[nextIndex]==="-"||normalized[nextIndex]==="_"){nextIndex+=1}const nextCharacter=normalized[nextIndex];if(nextCharacter!==void 0&&(nextCharacter>="a"&&nextCharacter<="z"||nextCharacter>="0"&&nextCharacter<="9")){property+=nextCharacter.toUpperCase();index=nextIndex;continue}property+=normalized.slice(index,nextIndex);index=nextIndex-1}return PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES.has(property)?{field,property,owner:"mcp_tool_input",nested_path:`options.${property}`}:void 0}const PM_TOOL_ACTION_MUTATION_PARAMETER_KEYS={create:["fullChangedFields","idOnly"],copy:["fullChangedFields","idOnly"],update:["fullChangedFields","idOnly"],"item-reopen":["fullChangedFields","idOnly"],close:["fullChangedFields","idOnly"],claim:["fullChangedFields","idOnly"],restore:["fullChangedFields","idOnly"],append:["fullChangedFields"],"update-many":["fullChangedFields"],"close-many":["fullChangedFields"],assurance:["fullChangedFields","idOnly"]};const PLAN_CREATE_METADATA_PARAMETER_KEYS=["createMode","status","deadline","estimate","acceptanceCriteria","definitionOfReady","order","rank","goal","objective","value","impact","outcome","whyNow","assignee","reviewer","risk","confidence","sprint","release","blockedReason","unblockNote","reporter","severity","environment","reproSteps","resolution","expectedResult","actualResult","affectedVersion","fixedVersion","component","regression","customerImpact","comment","note","learning","reminder","event","typeOption"];const PM_TOOL_ACTION_NESTED_OPTION_COMPATIBILITY_KEYS=Object.freeze({"close-many":["list","expected_result","expected","actual_result","actual","validate_close","dry_run","checkpoint","no_checkpoint","filterAssignee_filter"],"update-many":["list","update","dry_run","checkpoint","no_checkpoint","filterAssignee_filter"],...Object.fromEntries(PM_TOOL_ACTIONS.filter(action=>action==="upgrade"||action==="install"||action==="extension"||action==="package"||action.startsWith("extension-")||action.startsWith("package-")).map(action=>[action,["project","local","global"]]))});function toSchemaKeyList(values){return normalizeUniqueStringList(values)}const CREATE_CONTRACT_PARAMETER_KEYS=toSchemaKeyList([...TOOL_CREATE_OPTION_CONTRACTS.map(entry=>entry.param),...TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS.map(entry=>entry.param),"assignee","closeReason","completedAt"]);const UPDATE_CONTRACT_PARAMETER_KEYS=toSchemaKeyList([...TOOL_UPDATE_OPTION_CONTRACTS.map(entry=>entry.param),...TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS.map(entry=>entry.param),"force"]);const UPDATE_MANY_CONTRACT_PARAMETER_KEYS=toSchemaKeyList([...TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS.map(entry=>entry.param),...UPDATE_CONTRACT_PARAMETER_KEYS.filter(key=>key!=="allowMissingParent"&&key!=="completedAt"),"dryRun","rollback","noCheckpoint"]);const CLOSE_MANY_CONTRACT_PARAMETER_KEYS=toSchemaKeyList([...TOOL_CLOSE_MANY_FILTER_OPTION_CONTRACTS.map(entry=>entry.param),"reason","completedAt","resolution","expectedResult","actualResult","validateClose","dryRun","rollback","noCheckpoint","author","message","force"]);const CONTEXT_CONTRACT_PARAMETER_KEYS=toSchemaKeyList([...TOOL_CONTEXT_OPTION_CONTRACTS.map(entry=>entry.param),"past","section"]);const ACTIVITY_CONTRACT_PARAMETER_KEYS=toSchemaKeyList([...TOOL_ACTIVITY_OPTION_CONTRACTS.map(entry=>entry.param),"stream"]);const LIST_CONTRACT_PARAMETER_KEYS=toSchemaKeyList([...TOOL_LIST_FILTER_OPTION_CONTRACTS.map(entry=>entry.param),"all","includeBody","noTruncate","strictRead","compact","brief","full"]);const FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS=LIST_CONTRACT_PARAMETER_KEYS.filter(parameter=>parameter!=="all"&&parameter!=="status");const LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS=[[{property:"today",schema:{const:true}},{property:"recent",schema:{const:true}}],[{property:"today",schema:{const:true}},{property:"updatedAfter",schema:{type:"string",pattern:"\\S"}}],[{property:"recent",schema:{const:true}},{property:"updatedAfter",schema:{type:"string",pattern:"\\S"}}]];const CONTRACTS_PROJECTION_MUTUALLY_EXCLUSIVE_GROUPS=[[{property:"summary",schema:{const:true}},{property:"schemaOnly",schema:{const:true}}],[{property:"summary",schema:{const:true}},{property:"flagsOnly",schema:{const:true}}],[{property:"summary",schema:{const:true}},{property:"availabilityOnly",schema:{const:true}}],[{property:"schemaOnly",schema:{const:true}},{property:"flagsOnly",schema:{const:true}}],[{property:"schemaOnly",schema:{const:true}},{property:"availabilityOnly",schema:{const:true}}],[{property:"flagsOnly",schema:{const:true}},{property:"availabilityOnly",schema:{const:true}}]];const AGGREGATE_CONTRACT_PARAMETER_KEYS=toSchemaKeyList([...TOOL_AGGREGATE_OPTION_CONTRACTS.map(entry=>entry.param),"count","completion","includeUnparented"]);const SEARCH_CONTRACT_PARAMETER_KEYS=toSchemaKeyList(["query","keywords","mode","semantic","hybrid","includeLinked","titleExact","phraseExact","highlight","compact","full",...TOOL_SEARCH_FILTER_OPTION_CONTRACTS.map(entry=>entry.param)]);const NEXT_CONTRACT_PARAMETER_KEYS=toSchemaKeyList(["type","tag","priority","assignee","assigneeFilter","sprint","release","parent","limit","blockedLimit","readyOnly","format","includeDecisions","includeGates","includeContainers","tokenBudget","explainRanking"]);const AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS=["author","message","force"];const CLOSE_ACTION_OPTION_KEYS=["text","reason","closeReason","completedAt","duplicateOf","validateClose","resolution","expectedResult","actualResult"];const LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS=["author","assignee","message","force"];const MANAGED_EXTENSION_PACKAGE_OPTION_KEYS=["dryRun","target","scope","capability","declarative","github","ref","init","install","uninstall","explore","manage","describe","markdown","output","reload","doctor","catalog","list","adopt","adoptAll","activate","deactivate","runtimeProbe","fixManagedState","isolated","ignoreGlobal","detail","trace","watch","strictExit","failOnWarn"];function managedLifecycleSchemaContracts(prefix){return{[`${prefix}-init`]:{required:["target"],optional:["scope","capability",...prefix==="package"?["declarative"]:[]]},[`${prefix}-install`]:{optional:["target","github","scope","ref","dryRun"],anyOfRequired:[["target"],["github"]]},[`${prefix}-uninstall`]:{required:["target"],optional:["scope"]},[`${prefix}-explore`]:{optional:["scope"]},[`${prefix}-manage`]:{optional:["scope","runtimeProbe","fixManagedState"]},[`${prefix}-describe`]:{optional:["target","scope","markdown","output"]},[`${prefix}-reload`]:{optional:["scope","watch"]},[`${prefix}-doctor`]:{optional:["scope","detail","trace","fixManagedState","isolated","ignoreGlobal","strictExit","failOnWarn"]},[`${prefix}-catalog`]:{optional:["scope","fields"]},[`${prefix}-adopt`]:{required:["target"],optional:["scope","github","ref"]},[`${prefix}-adopt-all`]:{optional:["scope"]},[`${prefix}-activate`]:{required:["target"],optional:["scope"]},[`${prefix}-deactivate`]:{required:["target"],optional:["scope"]},[prefix]:{optional:MANAGED_EXTENSION_PACKAGE_OPTION_KEYS,dependentAnyOfRequired:[{property:"dryRun",value:true,anyOfRequired:[["install","target"],["install","github"]]}],mutuallyExclusiveWhen:[[{property:"dryRun",schema:{const:true}},{property:"install",schema:{const:false}}]]}}}const SCHEDULING_ACTION_SCHEMA_CONTRACT={required:["title"],optional:["start","duration","end","location","timezone","allDay","parent","allowMissingParent","tags","priority","body","description","author","message"]};const UPGRADE_ACTION_SCHEMA_CONTRACT={optional:["target","scope","dryRun","cliOnly","packagesOnly","repair","tag","packageName"]};const PM_TOOL_ACTION_SCHEMA_CONTRACTS={init:{optional:["prefix","idPrefix","workspace","preset","typePreset","defaults","author","agentGuidance","withPackages","mergeFence","force","verbose"]},config:{required:["scope","configAction"],optional:["key","value","criterion","clearCriteria","format","policy"]},...managedLifecycleSchemaContracts("extension"),...managedLifecycleSchemaContracts("package"),"package-upgrade":UPGRADE_ACTION_SCHEMA_CONTRACT,install:{optional:["target","github","scope","ref","dryRun"],anyOfRequired:[["target"],["github"]]},upgrade:UPGRADE_ACTION_SCHEMA_CONTRACT,create:{required:["title","description","type","status","priority","message"],optional:CREATE_CONTRACT_PARAMETER_KEYS},copy:{required:["id"],optional:["title","author","message","allowDuplicate"]},focus:{optional:["id","clear"],mutuallyExclusive:[["id","clear"]]},list:{optional:LIST_CONTRACT_PARAMETER_KEYS,mutuallyExclusiveWhen:LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS},"list-all":{optional:LIST_CONTRACT_PARAMETER_KEYS,mutuallyExclusiveWhen:LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS},"list-draft":{optional:FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS,mutuallyExclusiveWhen:LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS},"list-open":{optional:FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS,mutuallyExclusiveWhen:LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS},"list-in-progress":{optional:FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS,mutuallyExclusiveWhen:LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS},"list-blocked":{optional:FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS,mutuallyExclusiveWhen:LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS},"list-closed":{optional:FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS,mutuallyExclusiveWhen:LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS},"list-canceled":{optional:FIXED_STATUS_LIST_CONTRACT_PARAMETER_KEYS,mutuallyExclusiveWhen:LIST_WINDOW_MUTUALLY_EXCLUSIVE_GROUPS},aggregate:{optional:AGGREGATE_CONTRACT_PARAMETER_KEYS},guide:{optional:["list","format","depth"]},context:{optional:CONTEXT_CONTRACT_PARAMETER_KEYS},ctx:{optional:CONTEXT_CONTRACT_PARAMETER_KEYS},get:{required:["id"],optional:["for","tokenBudget","at","depth","full","fields","tree","treeDepth","format"]},search:{optional:SEARCH_CONTRACT_PARAMETER_KEYS,anyOfRequired:[["query"],["keywords"]]},eval:{optional:["mode","k","failUnder","queries","format"]},events:{optional:["since","type","author","item","limit","full","provenance","provenanceSummary","harness","agentInstance","provenanceFilter","cursorMode"]},merge:{required:["subcommand"],optional:["dryRun","author","message","force","includeReconciled","artifact","basePath","oursPath","theirsPath","output","outputPath","itemPath","prefer"]},workspace:{required:["subcommand"],optional:["snapshotAction","name","target","dryRun","force","author","message","lockTtlSeconds","lockWaitMs"],conditionalRequired:[{property:"subcommand",value:"snapshot",required:["snapshotAction"]}]},meet:SCHEDULING_ACTION_SCHEMA_CONTRACT,event:SCHEDULING_ACTION_SCHEMA_CONTRACT,remind:{required:["title"],optional:["at","text","parent","allowMissingParent","tags","priority","body","description","author","message"]},next:{optional:[...NEXT_CONTRACT_PARAMETER_KEYS,"for"]},reindex:{optional:["mode","progress"]},history:{required:["id"],optional:["limit","compact","full","provenance","provenanceSummary","harness","agentInstance","provenanceFilter","diff","verify","field","strictExit","failOnWarn","format"]},"history-redact":{required:["id"],optional:["literal","regex","replacement","dryRun",...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],anyOfRequired:[["literal"],["regex"]]},"history-repair":{optional:["id","all","dryRun","normalizeProvenance","salvageTail",...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],oneOfRequired:[["id"],["all"]],mutuallyExclusiveWhen:[[{property:"salvageTail",schema:{const:true}},{property:"all",schema:{const:true}}],[{property:"salvageTail",schema:{const:true}},{property:"normalizeProvenance",schema:{const:true}}]]},"history-author-acknowledge":{optional:["historyEvent","allActionable","dryRun","planFingerprint","limit","attributedAuthor","reviewer","reason"],oneOfRequired:[["historyEvent"],["allActionable"]]},"history-compact":{optional:["id","before","ids","allOver","closed","allStreams","minEntries","dryRun",...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS]},schema:{mutuallyExclusiveWhen:[[{property:"subcommand",schema:{const:"policy-mode"}},{property:"name",schema:{not:{enum:["advise","refuse"]}}}]],required:["subcommand"],optional:["definition","policy","message","name","description","defaultStatus","folder","alias","role","order","fieldType","commands","cliFlag","required","requiredOnCreate","allowUnset","requiredTypes","typePreset","infer","minCount","apply","to","migrationId","fieldTypeScope","dryRun","author","force"],conditionalRequired:[{property:"subcommand",value:"policy-put",required:["name","definition"]},{property:"subcommand",value:"policy-remove",required:["name"]},{property:"subcommand",value:"policy-mode",required:["name"]},{property:"subcommand",value:"policy-check",required:["name"]},{property:"subcommand",value:"policy-approve",required:["name","policy"]},{property:"subcommand",value:"show",required:["name"]},{property:"subcommand",value:"show-status",required:["name"]},{property:"subcommand",value:"add-type",required:["name"]},{property:"subcommand",value:"remove-type",required:["name"]},{property:"subcommand",value:"add-status",required:["name"]},{property:"subcommand",value:"remove-status",required:["name"]},{property:"subcommand",value:"add-field",required:["name"]},{property:"subcommand",value:"remove-field",required:["name"]},{property:"subcommand",value:"show-field",required:["name"]},{property:"subcommand",value:"rename-type",required:["name","to"]},{property:"subcommand",value:"rename-field",required:["name","to"]},{property:"subcommand",value:"remap-status",required:["name","to"]},{property:"subcommand",value:"apply-preset",required:["typePreset"]}]},profile:{required:["subcommand"],optional:["name","dryRun","author","force"],conditionalRequired:[{property:"subcommand",value:"show",required:["name"]},{property:"subcommand",value:"apply",required:["name"]},{property:"subcommand",value:"lint",required:["name"]}]},plan:{required:["subcommand"],optional:["id","stepRef","reorderTo","title","description","template","scope","parent","related","blocks","blockedBy","harness","mode","resumeContext","tags","priority",...PLAN_CREATE_METADATA_PARAMETER_KEYS,"body","claim","fromSearch","stepTitle","step","stepBody","stepOwner","stepStatus","stepEvidence","stepBlockedReason","stepReplacement","dependsOn","link","linkKind","linkNote","promoteToItemDep","allowMultipleActive","file","test","doc","decisionText","decision","decisionRationale","decisionEvidence","discoveryText","discovery","validationText","validation","validationCommand","validationExpected","depth","fields","steps","materializeType","materializeParent","materializeTags","field",...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS]},activity:{optional:ACTIVITY_CONTRACT_PARAMETER_KEYS},restore:{required:["id","target"],optional:AUTHOR_MESSAGE_FORCE_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:[...CLOSE_ACTION_OPTION_KEYS,...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS]},"close-many":{optional:CLOSE_MANY_CONTRACT_PARAMETER_KEYS},delete:{required:["id"],optional:["dryRun",...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS]},append:{required:["id","body"],optional:AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS},comments:{required:["id"],optional:["text","add","stdin","edit","delete","limit","full","ifAbsent",...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],mutuallyExclusive:[["edit","ifAbsent"],["delete","ifAbsent"]]},notes:{required:["id"],optional:["text","add","addJson","stdin","edit","delete","limit","since","eventType","includeMeta","full","ifAbsent",...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],mutuallyExclusive:[["addJson","add"],["addJson","stdin"],["addJson","file"],["addJson","edit"],["addJson","delete"],["edit","ifAbsent"],["delete","ifAbsent"]]},learnings:{required:["id"],optional:["text","add","stdin","edit","delete","limit","full","ifAbsent",...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],mutuallyExclusive:[["edit","ifAbsent"],["delete","ifAbsent"]]},files:{required:[],optional:["id","add","addGlob","remove","migrate","list","addNote","discover","apply","discoveryNote","appendStable","validatePaths","lookupPath","scope","limit","offset","noTruncate","strictRead","explain","lines","decisionDepth",...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],anyOfRequired:[["id"],["lookupPath"]],dependentAnyOfRequired:[{property:"addNote",anyOfRequired:[["add"],["addGlob"]]}]},docs:{required:["id"],optional:["add","addGlob","remove","migrate","addNote","list","validatePaths",...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],dependentAnyOfRequired:[{property:"addNote",anyOfRequired:[["add"],["addGlob"]]}]},deps:{required:["id"],optional:["format","maxDepth","collapse","summary","full","nodeLimit","edgeLimit","tokenBudget","cursor","direction","kind"]},graph:{required:["subcommand"],optional:["id","target","kind","maxDepth","limit","after","direction","maxPaths","sample","exemptIsolate","exemptIsolateType","saveBaseline","rebuild","clear","summary","full"]},test:{required:["id"],optional:["list","add","addJson","remove","removeIndex","run","match","onlyIndex","onlyLast","background","timeout","progress","envSet","envClear","sharedHostSafe","pmContext","overrideLinkedPmContext","workspaceContext","overrideLinkedWorkspaceContext","allowUntrustedLinkedTests","acknowledgeLinkedTests","failOnContextMismatch","failOnSkipped","failOnEmptyTestRun","requireAssertionsForPm","checkContext","autoPmContext","measure","metricBelow","metricDiff",...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],mutuallyExclusive:[["acknowledgeLinkedTests","run"],["acknowledgeLinkedTests","background"]]},"test-all":{optional:["status","limit","offset","background","timeout","progress","envSet","envClear","sharedHostSafe","pmContext","overrideLinkedPmContext","workspaceContext","overrideLinkedWorkspaceContext","allowUntrustedLinkedTests","failOnContextMismatch","failOnSkipped","failOnEmptyTestRun","requireAssertionsForPm","checkContext","autoPmContext"]},telemetry:{optional:["subcommand","limit"]},"test-runs-list":{optional:["status","limit"]},"test-runs-status":{required:["runId"]},"test-runs-logs":{required:["runId"],optional:["stream","tail"]},"test-runs-stop":{required:["runId"],optional:["force"]},"test-runs-resume":{required:["runId"],optional:["author"]},stats:{optional:["includeEmpty","storage","metadataCoverage","fieldUtilization","byAssignee","byTag","byPriority","tagPrefix","measurements","metric","measurementLimit","observe","improvementDirection","measurementSource","measurementItem","measurementRevision","author","message","provenanceCoverage","fleetAttribution","since","eventLimit","minimumSample"]},duplicates:{optional:["status","since","threshold","limit","exhaustive"]},health:{optional:["strictDirectories","requireMergeDrivers","strictExit","failOnWarn","checkOnly","checkTelemetry","noRefresh","refreshVectors","verboseStaleItems","verboseAuthorEvents","brief","summary","skipVectors","skipIntegrity","skipDrift","full"]},validate:{optional:["checkCompleteness","checkStorageIntegrity","checkMetadata","metadataProfile","checkResolution","checkLifecycle","checkStaleBlockers","dependencyCycleSeverity","parentCycleSeverity","checkFiles","scanMode","includePmInternals","verboseFileLists","verboseDiagnostics","allAffectedIds","strictExit","failOnWarn","fixHints","autoFix","dryRun","fixScope","pruneMissing","checkHistoryDrift","checkCommandReferences","counts","full"]},assurance:{required:["subcommand"],optional:["kind","id","definition","trigger","treeId","gate","limit","dryRun","author","message","preset","owner","apply","enforcement"],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"]},{property:"subcommand",value:"apply",required:["preset","owner"]},{property:"subcommand",value:"derive",required:["owner"]},{property:"subcommand",value:"risk",required:["definition"]},{property:"subcommand",value:"lineages",required:["definition"]},{property:"subcommand",value:"promote",required:["id","enforcement"]}],mutuallyExclusiveWhen:[[{property:"subcommand",schema:{const:"risk"}},{property:"definition",schema:{not:{required:["policy","change"]}}}],[{property:"subcommand",schema:{const:"lineages"}},{property:"definition",schema:{anyOf:[{required:["change"]},{not:{required:["policy"]}}]}}]]},gc:{optional:["dryRun","gcScope"]},contracts:{optional:["contractAction","command","summary","schemaOnly","flagsOnly","availabilityOnly","runtimeOnly","activeOnly","full"],mutuallyExclusiveWhen:CONTRACTS_PROJECTION_MUTUALLY_EXCLUSIVE_GROUPS},completion:{required:["shell"],optional:["eagerTags"]},claim:{optional:["id","next","ifAvailable","maxAttempts","includeDecisions",...NEXT_CONTRACT_PARAMETER_KEYS,...LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],oneOfRequired:[["id"],["next"]]},release:{required:["id"],optional:LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS},"start-task":{required:["id"],optional:LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS},"pause-task":{required:["id"],optional:LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS},"close-task":{required:["id"],optional:["text","validateClose",...LIFECYCLE_AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS]},"item-reopen":{required:["id","reason"],optional:["status","author","message","force"]}};const PM_TOOL_ACTION_PARAMETER_CONTRACTS=Object.freeze(Object.fromEntries(PM_TOOL_ACTIONS.map(action=>[action,PM_TOOL_ACTION_SCHEMA_CONTRACTS[action]])));function fallbackToolParameterDescription(key){return key.replace(/([a-z0-9])([A-Z])/g,"$1 $2").replace(/[_-]/g," ").trim().replace(/^./,value=>value.toUpperCase()).concat(".")}function decorateToolParameterDefinition(key,definition){const baseDefinition=typeof definition==="object"&&definition!==null?{...definition}:{};const metadata=PM_TOOL_PARAMETER_METADATA[key];return{...baseDefinition,description:metadata?.description??fallbackToolParameterDescription(key),...metadata?.examples?{examples:metadata.examples}:{}}}function actionScopedToolParameterMetadata(action,key){if((action==="list"||action.startsWith("list-"))&&key==="all"){return{description:"Return items from every lifecycle status instead of the default active-status set."}}if(action==="plan"&&Object.prototype.hasOwnProperty.call(PLAN_ACTION_PARAMETER_METADATA,key)){return PLAN_ACTION_PARAMETER_METADATA[key]}const actionOverrides=PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA[action];if(actionOverrides&&Object.prototype.hasOwnProperty.call(actionOverrides,key)){return actionOverrides[key]}return PM_TOOL_PARAMETER_METADATA[key]}function decorateActionScopedToolParameterDefinition(action,key,definition){const baseDefinition=typeof definition==="object"&&definition!==null?{...definition}:{};const metadata=actionScopedToolParameterMetadata(action,key);return{...baseDefinition,description:metadata?.description??fallbackToolParameterDescription(key),...metadata?.examples?{examples:metadata.examples}:{}}}function actionScopedToolParameterDefinition(action,key){const actionProperties=PM_TOOL_ACTION_SCOPED_PARAMETER_PROPERTIES[action];if(actionProperties&&Object.prototype.hasOwnProperty.call(actionProperties,key)){return actionProperties[key]}if(action==="plan"&&Object.prototype.hasOwnProperty.call(PLAN_ACTION_PARAMETER_PROPERTIES,key)){return PLAN_ACTION_PARAMETER_PROPERTIES[key]}if((action==="get"||action==="history"||action==="search")&&key==="format"){return{type:"string",enum:["json","toon"]}}return PM_TOOL_PARAMETER_PROPERTIES[key]}function buildActionScopedSchemaProperties(action,allowedKeys){const properties={action:{const:action,description:PM_TOOL_PARAMETER_METADATA.action?.description??"Tool action to execute."}};for(const key of allowedKeys){if(key==="action"){continue}const definition=actionScopedToolParameterDefinition(action,key);if(definition){properties[key]=decorateActionScopedToolParameterDefinition(action,key,definition)}}return properties}function buildOneOfSchemaEntries(action,oneOfRequiredGroups){const allOneOfFields=oneOfRequiredGroups.flat();return oneOfRequiredGroups.map(requiredFields=>{const otherFields=allOneOfFields.filter(field=>!requiredFields.includes(field));return{required:[...requiredFields],...otherFields.length>0?{not:{anyOf:otherFields.map(field=>({required:[field]}))}}:{},...action==="history-repair"&&requiredFields.includes("all")?{properties:{all:{const:true}}}:action==="claim"&&requiredFields.includes("next")?{properties:{next:{const:true}}}:{}}})}function schemaPropertyCondition(property,value){return{...value===void 0?{}:{properties:{[property]:{const:value}}},required:[property]}}function buildActionScopedAllOf(contract){const allOf=[];if(contract.conditionalRequired&&contract.conditionalRequired.length>0){for(const entry of contract.conditionalRequired){allOf.push({if:schemaPropertyCondition(entry.property,entry.value),then:{required:entry.required}})}}if(contract.dependentAnyOfRequired&&contract.dependentAnyOfRequired.length>0){for(const entry of contract.dependentAnyOfRequired){allOf.push({if:schemaPropertyCondition(entry.property,entry.value),then:{anyOf:entry.anyOfRequired.map(requiredFields=>({required:[...requiredFields]}))}})}}if(contract.mutuallyExclusive&&contract.mutuallyExclusive.length>0){for(const group of contract.mutuallyExclusive){allOf.push({not:{required:toSchemaKeyList(group)}})}}if(contract.mutuallyExclusiveWhen&&contract.mutuallyExclusiveWhen.length>0){for(const group of contract.mutuallyExclusiveWhen){allOf.push({not:{allOf:group.map(condition=>({properties:{[condition.property]:condition.schema},required:[condition.property]}))}})}}return allOf}function pmToolActionParameterKeys(action){if(!Object.prototype.hasOwnProperty.call(PM_TOOL_ACTION_SCHEMA_CONTRACTS,action)){return void 0}const contract=PM_TOOL_ACTION_SCHEMA_CONTRACTS[action];const mutationParameterKeys=PM_TOOL_ACTION_MUTATION_PARAMETER_KEYS[action]??[];return toSchemaKeyList(["action",...PM_TOOL_GLOBAL_PARAMETER_KEYS,...resolveReadOutputSurface(action)!==void 0?PM_TOOL_READ_OUTPUT_PARAMETER_KEYS:[],...mutationParameterKeys,...contract.required??[],...contract.optional??[]])}function pmToolActionNestedOptionKeys(action){const parameterKeys=pmToolActionParameterKeys(action);if(parameterKeys===void 0)return void 0;return toSchemaKeyList([...parameterKeys,...PM_TOOL_ACTION_NESTED_OPTION_COMPATIBILITY_KEYS[action]??[]])}function buildActionScopedToolSchema(action){const contract=PM_TOOL_ACTION_SCHEMA_CONTRACTS[action];const required=toSchemaKeyList(contract.required??[]);const allowedKeys=pmToolActionParameterKeys(action);const schema={type:"object",additionalProperties:false,required:["action",...required],title:`pm action "${action}" parameters`,properties:buildActionScopedSchemaProperties(action,allowedKeys)};if(contract.anyOfRequired&&contract.anyOfRequired.length>0){schema.anyOf=contract.anyOfRequired.map(requiredFields=>({required:[...requiredFields]}))}if(contract.oneOfRequired&&contract.oneOfRequired.length>0){schema.oneOf=buildOneOfSchemaEntries(action,contract.oneOfRequired)}const allOf=buildActionScopedAllOf(contract);if(allOf.length>0){schema.allOf=allOf}return schema}function buildPmActionToolInputSchema(action,options={}){const actionSchema=buildActionScopedToolSchema(action);const actionProperties={...actionSchema.properties};delete actionProperties.action;const conditionalBranches=[...actionSchema.anyOf??[],...actionSchema.oneOf??[]];const required=(options.required??actionSchema.required.map(String)).filter(key=>{if(key==="action")return false;if(options.required===void 0)return true;return!conditionalBranches.some(branch=>branch.required?.map(String).includes(key))});const schema={type:"object",additionalProperties:options.additionalProperties??true,properties:{...actionProperties,options:{type:"object",additionalProperties:true,description:"Advanced command options forwarded to the selected pm action."},...options.properties},required};if(actionSchema.anyOf!==void 0)schema.anyOf=actionSchema.anyOf;if(actionSchema.oneOf!==void 0)schema.oneOf=actionSchema.oneOf;if(actionSchema.allOf!==void 0)schema.allOf=actionSchema.allOf;return schema}function createLazyContractSchema(build){let value;const resolve=()=>value??=build();return new Proxy({},{get:(_target,prop)=>resolve()[prop],has:(_target,prop)=>prop in resolve(),ownKeys:()=>Reflect.ownKeys(resolve()),getOwnPropertyDescriptor:(_target,prop)=>{const descriptor=Reflect.getOwnPropertyDescriptor(resolve(),prop);if(descriptor){descriptor.configurable=true}return descriptor}})}const PM_TOOL_PARAMETERS_SCHEMA_VERSION="4.16.0";const PM_TOOL_PARAMETERS_SCHEMA_MAJOR=PM_TOOL_PARAMETERS_SCHEMA_VERSION.split(".")[0];const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION="1.7.0";const PM_TOOL_PARAMETERS_SCHEMA=createLazyContractSchema(()=>({$schema:"https://json-schema.org/draft/2020-12/schema",$id:`https://schema.unbrained.dev/pm-cli/tool-parameters-v${PM_TOOL_PARAMETERS_SCHEMA_MAJOR}.schema.json`,title:"pm-cli tool parameters (action-scoped strict schema)","x-schema-version":PM_TOOL_PARAMETERS_SCHEMA_VERSION,type:"object",oneOf:PM_TOOL_ACTIONS.map(action=>buildActionScopedToolSchema(action))}));function toProviderCompatibleParameterDefinition(key,definition){const decorated=decorateToolParameterDefinition(key,definition);if(typeof decorated.type==="string"){return decorated}const anyOf=Array.isArray(decorated.anyOf)?decorated.anyOf:[];const firstTypedVariant=anyOf.find(variant=>typeof variant.type==="string");if(firstTypedVariant){const{anyOf:_anyOf2,...rest2}=decorated;return{...firstTypedVariant,...rest2}}const{anyOf:_anyOf,...rest}=decorated;return{...rest,type:"string"}}function buildProviderCompatibleToolSchema(){const properties={action:{type:"string",description:PM_TOOL_PARAMETER_METADATA.action?.description??"Tool action to execute."},options:{type:"object",additionalProperties:true,description:"Advanced command options object forwarded to the selected pm action."}};for(const key of Object.keys(PM_TOOL_PARAMETER_PROPERTIES).sort()){properties[key]=toProviderCompatibleParameterDefinition(key,PM_TOOL_PARAMETER_PROPERTIES[key])}return{title:"pm-cli tool parameters (provider-compatible flat schema)","x-schema-version":PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION,type:"object",additionalProperties:false,required:["action"],properties}}const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA=createLazyContractSchema(buildProviderCompatibleToolSchema);const _testOnlyCliContracts={buildActionScopedToolSchema,buildProviderCompatibleToolSchema,decorateActionScopedToolParameterDefinition,decorateToolParameterDefinition,toolActionSchemaContracts:PM_TOOL_ACTION_SCHEMA_CONTRACTS,toolParameterMetadata:PM_TOOL_PARAMETER_METADATA,toProviderCompatibleParameterDefinition,toUniqueFlagContracts,withFlagAliasMetadata};export{CLOSE_ACTION_OPTION_KEYS,PLAN_CREATE_METADATA_PARAMETER_KEYS,PM_PROVIDER_TOOL_PARAMETERS_SCHEMA,PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION,PM_TOOL_ACTION_PARAMETER_CONTRACTS,PM_TOOL_PARAMETERS_SCHEMA,PM_TOOL_PARAMETERS_SCHEMA_MAJOR,PM_TOOL_PARAMETERS_SCHEMA_VERSION,PM_TOOL_RESERVED_CUSTOM_FIELD_PROPERTIES,_testOnlyCliContracts,buildPmActionToolInputSchema,pmToolActionNestedOptionKeys,pmToolActionParameterKeys,resolvePmToolCustomFieldCollision};
 //# sourceMappingURL=tool-schema.js.map
-//# debugId=e72f4ab4-5bf7-53fb-a3a3-174c4064f6a4