@unbrained/pm-cli 2026.5.14 → 2026.5.24

package/dist/sdk/cli-contracts.js

@@ -1,5 +1,8 @@
+
+!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]="b7c80b7e-7951-5ab0-ab77-8e309cf59f0d")}catch(e){}}();
 export { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "./cli-contracts/commander-types.js";
 export { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, } from "./cli-contracts/commander-mutation-options.js";
+import { PLAN_HARNESS_VALUES, PLAN_MODE_VALUES, PLAN_STEP_LINK_KIND_VALUES, PLAN_STEP_STATUS_VALUES, } from "../types/index.js";
 export const PM_EXTENSION_CAPABILITY_CONTRACTS = [
     "commands",
     "renderers",
@@ -118,6 +121,9 @@ export const PM_CORE_COMMAND_NAMES = [
     "search",
     "reindex",
     "history",
+    "history-redact",
+    "history-repair",
+    "schema",
     "activity",
     "restore",
     "update",
@@ -133,6 +139,7 @@ export const PM_CORE_COMMAND_NAMES = [
     "files",
     "docs",
     "deps",
+    "plan",
     "test",
     "test-all",
     "test-runs",
@@ -190,24 +197,23 @@ export const PM_TOOL_ACTIONS = [
     "list-closed",
     "list-canceled",
     "aggregate",
-    "dedupe-audit",
-    "guide",
     "context",
     "ctx",
     "get",
     "search",
-    "reindex",
     "history",
+    "history-redact",
+    "history-repair",
+    "schema",
     "activity",
     "restore",
     "update",
     "update-many",
-    "normalize",
     "close",
     "delete",
     "append",
     "comments",
-    "comments-audit",
+    "plan",
     "notes",
     "learnings",
     "files",
@@ -215,17 +221,11 @@ export const PM_TOOL_ACTIONS = [
     "deps",
     "test",
     "test-all",
-    "test-runs-list",
-    "test-runs-status",
-    "test-runs-logs",
-    "test-runs-stop",
-    "test-runs-resume",
     "stats",
     "health",
     "validate",
     "gc",
     "contracts",
-    "completion",
     "claim",
     "release",
     "start-task",
@@ -248,6 +248,7 @@ export function isPmExtensionPolicySurfaceContract(value) {
     return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value);
 }
 export const TOOL_LIST_FILTER_OPTION_CONTRACTS = [
+    { param: "status", flag: "--status" },
     { param: "type", flag: "--type" },
     { param: "tag", flag: "--tag" },
     { param: "priority", flag: "--priority" },
@@ -458,6 +459,8 @@ export const TOOL_ACTIVITY_OPTION_CONTRACTS = [
     { param: "from", flag: "--from" },
     { param: "to", flag: "--to" },
     { param: "limit", flag: "--limit" },
+    { param: "compact", flag: "--compact" },
+    { param: "full", flag: "--full" },
 ];
 export const TOOL_CONTEXT_OPTION_CONTRACTS = [
     { param: "date", flag: "--date" },
@@ -497,6 +500,7 @@ export const GLOBAL_FLAG_CONTRACTS = [
     { flag: "--version" },
 ];
 export const LIST_FILTER_FLAG_CONTRACTS = [
+    { flag: "--status" },
     { flag: "--type" },
     { flag: "--tag" },
     { flag: "--priority" },
@@ -511,6 +515,8 @@ export const LIST_FILTER_FLAG_CONTRACTS = [
     { flag: "--limit" },
     { flag: "--offset" },
     { flag: "--compact" },
+    { flag: "--brief" },
+    { flag: "--full" },
     { flag: "--fields" },
     { flag: "--sort" },
     { flag: "--order" },
@@ -624,11 +630,90 @@ export const DOCS_FLAG_CONTRACTS = [
 ];
 export const HISTORY_FLAG_CONTRACTS = [
     { flag: "--limit" },
+    { flag: "--compact" },
+    { flag: "--full" },
     { flag: "--diff" },
     { flag: "--verify" },
 ];
+export const HISTORY_REDACT_FLAG_CONTRACTS = [
+    { flag: "--literal" },
+    { flag: "--regex" },
+    { flag: "--replacement" },
+    { flag: "--dry-run" },
+    { flag: "--author" },
+    { flag: "--message" },
+    { flag: "--force" },
+];
+export const HISTORY_REPAIR_FLAG_CONTRACTS = [
+    { flag: "--dry-run" },
+    { flag: "--author" },
+    { flag: "--message" },
+    { flag: "--force" },
+];
+export const SCHEMA_FLAG_CONTRACTS = [
+    { flag: "--description" },
+    { flag: "--default-status", aliases: ["--default_status"] },
+    { flag: "--folder" },
+    { flag: "--alias" },
+    { flag: "--author" },
+    { flag: "--force" },
+];
+export const PLAN_FLAG_CONTRACTS = [
+    { flag: "--title" },
+    { flag: "--description" },
+    { flag: "--scope" },
+    { flag: "--parent" },
+    { flag: "--related" },
+    { flag: "--blocks" },
+    { flag: "--blocked-by", aliases: ["--blocked_by"] },
+    { flag: "--harness" },
+    { flag: "--mode" },
+    { flag: "--resume-context", aliases: ["--resume_context"] },
+    { flag: "--tags" },
+    { flag: "--priority" },
+    { flag: "--body" },
+    { flag: "--claim" },
+    { flag: "--from-search", aliases: ["--from_search"] },
+    { flag: "--step-title", aliases: ["--step", "--step_title"] },
+    { flag: "--step-body", aliases: ["--step_body"] },
+    { flag: "--step-owner", aliases: ["--step_owner"] },
+    { flag: "--step-status", aliases: ["--step_status"] },
+    { flag: "--step-evidence", aliases: ["--step_evidence"] },
+    { flag: "--step-blocked-reason", aliases: ["--step_blocked_reason"] },
+    { flag: "--step-replacement", aliases: ["--step_replacement"] },
+    { flag: "--depends-on", aliases: ["--depends_on"] },
+    { flag: "--link" },
+    { flag: "--link-kind", aliases: ["--link_kind"] },
+    { flag: "--link-note", aliases: ["--link_note"] },
+    { flag: "--promote-to-item-dep", aliases: ["--promote_to_item_dep"] },
+    { flag: "--allow-multiple-active", aliases: ["--allow_multiple_active"] },
+    { flag: "--file" },
+    { flag: "--test" },
+    { flag: "--doc" },
+    { flag: "--decision-text", aliases: ["--decision_text", "--decision"] },
+    { flag: "--decision-rationale", aliases: ["--decision_rationale"] },
+    { flag: "--decision-evidence", aliases: ["--decision_evidence"] },
+    { flag: "--discovery-text", aliases: ["--discovery_text", "--discovery"] },
+    { flag: "--validation-text", aliases: ["--validation_text", "--validation"] },
+    { flag: "--validation-command", aliases: ["--validation_command"] },
+    { flag: "--validation-expected", aliases: ["--validation_expected"] },
+    { flag: "--depth" },
+    { flag: "--fields" },
+    { flag: "--steps" },
+    { flag: "--materialize-type", aliases: ["--materialize_type"] },
+    { flag: "--materialize-parent", aliases: ["--materialize_parent"] },
+    { flag: "--materialize-tags", aliases: ["--materialize_tags"] },
+    { flag: "--author" },
+    { flag: "--message" },
+    { flag: "--force" },
+];
 export const INIT_FLAG_CONTRACTS = [
     { flag: "--preset" },
+    { flag: "--defaults", short: "-y", aliases: ["--yes"] },
+    { flag: "--author" },
+    { flag: "--agent-guidance" },
+    { flag: "--with-packages" },
+    { flag: "--verbose" },
 ];
 export const CONFIG_FLAG_CONTRACTS = [
     { flag: "--criterion" },
@@ -653,6 +738,7 @@ export const EXTENSION_FLAG_CONTRACTS = [
     { flag: "--install" },
     { flag: "--uninstall" },
     { flag: "--explore" },
+    { flag: "--list" },
     { flag: "--manage" },
     { flag: "--reload" },
     { flag: "--watch" },
@@ -675,6 +761,14 @@ export const EXTENSION_FLAG_CONTRACTS = [
     { flag: "--strict-exit" },
     { flag: "--fail-on-warn" },
 ];
+export const INSTALL_FLAG_CONTRACTS = [
+    { flag: "--project" },
+    { flag: "--local" },
+    { flag: "--global" },
+    { flag: "--gh" },
+    { flag: "--github" },
+    { flag: "--ref" },
+];
 export const UPGRADE_FLAG_CONTRACTS = [
     { flag: "--dry-run" },
     { flag: "--cli-only" },
@@ -691,6 +785,8 @@ export const REINDEX_FLAG_CONTRACTS = [
     { flag: "--progress" },
 ];
 export const CLOSE_FLAG_CONTRACTS = [
+    { flag: "--reason" },
+    { flag: "--close-reason" },
     { flag: "--author" },
     { flag: "--message" },
     { flag: "--validate-close" },
@@ -713,6 +809,7 @@ export const RESTORE_FLAG_CONTRACTS = [
     { flag: "--force" },
 ];
 export const DELETE_FLAG_CONTRACTS = [
+    { flag: "--dry-run" },
     { flag: "--author" },
     { flag: "--message" },
     { flag: "--force" },
@@ -801,6 +898,12 @@ export const HEALTH_FLAG_CONTRACTS = [
     { flag: "--no-refresh" },
     { flag: "--refresh-vectors" },
     { flag: "--verbose-stale-items" },
+    { flag: "--brief" },
+    { flag: "--summary" },
+    { flag: "--skip-vectors" },
+    { flag: "--skip-integrity" },
+    { flag: "--skip-drift" },
+    { flag: "--full" },
 ];
 export const VALIDATE_FLAG_CONTRACTS = [
     { flag: "--check-metadata" },
@@ -813,6 +916,7 @@ export const VALIDATE_FLAG_CONTRACTS = [
     { flag: "--scan-mode" },
     { flag: "--include-pm-internals" },
     { flag: "--verbose-file-lists" },
+    { flag: "--verbose-diagnostics" },
     { flag: "--strict-exit" },
     { flag: "--fail-on-warn" },
     { flag: "--check-history-drift" },
@@ -1151,6 +1255,8 @@ export const ACTIVITY_FLAG_CONTRACTS = [
     { flag: "--from" },
     { flag: "--to" },
     { flag: "--limit" },
+    { flag: "--compact" },
+    { flag: "--full" },
     { flag: "--stream" },
 ];
 export const CONTEXT_FLAG_CONTRACTS = [
@@ -1173,6 +1279,11 @@ export const CONTEXT_FLAG_CONTRACTS = [
     { flag: "--activity-limit" },
     { flag: "--stale-threshold" },
 ];
+export const GET_FLAG_CONTRACTS = [
+    { flag: "--depth" },
+    { flag: "--full" },
+    { flag: "--fields" },
+];
 export const GUIDE_FLAG_CONTRACTS = [
     { flag: "--list" },
     { flag: "--format" },
@@ -1186,6 +1297,8 @@ export const DEPS_FLAG_CONTRACTS = [
 ];
 export const SEARCH_FLAG_CONTRACTS = [
     { flag: "--mode" },
+    { flag: "--semantic" },
+    { flag: "--hybrid" },
     { flag: "--include-linked" },
     { flag: "--title-exact" },
     { flag: "--phrase-exact" },
@@ -1207,6 +1320,7 @@ export const CONTRACTS_FLAG_CONTRACTS = [
     { flag: "--availability-only" },
     { flag: "--runtime-only" },
     { flag: "--active-only" },
+    { flag: "--full" },
 ];
 export const COMPLETION_FLAG_CONTRACTS = [
     { flag: "--eager-tags" },
@@ -1239,7 +1353,6 @@ const LIST_COMMAND_NAME_CONTRACTS = new Set([
     "list-canceled",
 ]);
 const NO_SURFACE_COMMAND_NAME_CONTRACTS = new Set([
-    "get",
     "stats",
     "reindex",
     "help",
@@ -1281,8 +1394,9 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
         case "extension":
         case "package":
         case "packages":
-        case "install":
             return withSubcommandGlobalFlags(EXTENSION_FLAG_CONTRACTS);
+        case "install":
+            return withSubcommandGlobalFlags(INSTALL_FLAG_CONTRACTS);
         case "upgrade":
             return withSubcommandGlobalFlags(UPGRADE_FLAG_CONTRACTS);
         case "create":
@@ -1297,10 +1411,20 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
             return withSubcommandGlobalFlags(CALENDAR_FLAG_CONTRACTS);
         case "context":
             return withSubcommandGlobalFlags(CONTEXT_FLAG_CONTRACTS);
+        case "get":
+            return withSubcommandGlobalFlags(GET_FLAG_CONTRACTS);
         case "search":
             return withSubcommandGlobalFlags(SEARCH_FLAG_CONTRACTS);
         case "history":
             return withSubcommandGlobalFlags(HISTORY_FLAG_CONTRACTS);
+        case "history-redact":
+            return withSubcommandGlobalFlags(HISTORY_REDACT_FLAG_CONTRACTS);
+        case "history-repair":
+            return withSubcommandGlobalFlags(HISTORY_REPAIR_FLAG_CONTRACTS);
+        case "schema":
+            return withSubcommandGlobalFlags(SCHEMA_FLAG_CONTRACTS);
+        case "plan":
+            return withSubcommandGlobalFlags(PLAN_FLAG_CONTRACTS);
         case "activity":
             return withSubcommandGlobalFlags(ACTIVITY_FLAG_CONTRACTS);
         case "restore":
@@ -1393,6 +1517,9 @@ const PM_TOOL_PARAMETER_PROPERTIES = {
     sort: { type: "string", enum: ["priority", "deadline", "updated_at", "created_at", "title", "parent"] },
     prefix: { type: "string" },
     preset: { type: "string", enum: ["minimal", "default", "strict", "custom"] },
+    defaults: { type: "boolean" },
+    agentGuidance: { type: "string", enum: ["ask", "add", "skip", "status"] },
+    withPackages: { type: "boolean" },
     scope: { type: "string", enum: ["project", "global"] },
     contractAction: { type: "string" },
     command: { type: "string" },
@@ -1468,6 +1595,7 @@ const PM_TOOL_PARAMETER_PROPERTIES = {
     },
     op: { type: "string" },
     compact: { type: "boolean" },
+    brief: { type: "boolean" },
     full: { type: "boolean" },
     view: { type: "string", enum: ["agenda", "day", "week", "month"] },
     date: { type: "string" },
@@ -1480,6 +1608,8 @@ const PM_TOOL_PARAMETER_PROPERTIES = {
     recurrenceLookbackDays: { anyOf: [{ type: "string" }, { type: "number" }] },
     occurrenceLimit: { anyOf: [{ type: "string" }, { type: "number" }] },
     includeLinked: { type: "boolean" },
+    semantic: { type: "boolean" },
+    hybrid: { type: "boolean" },
     titleExact: { type: "boolean" },
     phraseExact: { type: "boolean" },
     includeBody: { type: "boolean" },
@@ -1517,6 +1647,9 @@ const PM_TOOL_PARAMETER_PROPERTIES = {
     autoPmContext: { type: "boolean" },
     diff: { type: "boolean" },
     verify: { type: "boolean" },
+    literal: { type: "array", items: { type: "string" } },
+    regex: { type: "array", items: { type: "string" } },
+    replacement: { type: "string" },
     timeout: { anyOf: [{ type: "string" }, { type: "number" }] },
     validateClose: { type: "string", enum: ["off", "warn", "strict"] },
     checkMetadata: { type: "boolean" },
@@ -1568,6 +1701,10 @@ const PM_TOOL_PARAMETER_PROPERTIES = {
     file: { type: "string" },
     preserveSourceIds: { type: "boolean" },
     folder: { type: "string" },
+    subcommand: { type: "string" },
+    name: { type: "string" },
+    defaultStatus: { type: "string" },
+    alias: { type: "array", items: { type: "string" } },
     text: { type: "string" },
     add: { type: "array", items: { type: "string" } },
     addGlob: { type: "array", items: { type: "string" } },
@@ -1614,6 +1751,101 @@ const PM_TOOL_PARAMETER_PROPERTIES = {
     staleThreshold: { type: "string" },
     policy: { type: "string" },
 };
+const PLAN_SUBCOMMAND_VALUES = [
+    "create",
+    "show",
+    "add-step",
+    "update-step",
+    "complete-step",
+    "block-step",
+    "reorder-step",
+    "remove-step",
+    "link",
+    "unlink",
+    "decision",
+    "discovery",
+    "validation",
+    "resume",
+    "approve",
+    "materialize",
+];
+const PLAN_ACTION_PARAMETER_PROPERTIES = {
+    subcommand: { type: "string", enum: [...PLAN_SUBCOMMAND_VALUES] },
+    stepRef: { type: "string" },
+    reorderTo: { anyOf: [{ type: "string" }, { type: "number" }] },
+    scope: { type: "string" },
+    harness: { type: "string", enum: [...PLAN_HARNESS_VALUES] },
+    mode: { type: "string", enum: [...PLAN_MODE_VALUES] },
+    resumeContext: { type: "string" },
+    related: { type: "string" },
+    blocks: { type: "string" },
+    claim: { type: "boolean" },
+    fromSearch: { type: "string" },
+    stepTitle: { type: "string" },
+    stepBody: { type: "string" },
+    stepOwner: { type: "string" },
+    stepStatus: { type: "string", enum: [...PLAN_STEP_STATUS_VALUES] },
+    stepEvidence: { type: "string" },
+    stepBlockedReason: { type: "string" },
+    stepReplacement: { type: "string" },
+    dependsOn: { type: "string" },
+    link: { type: "string" },
+    linkKind: { type: "string", enum: [...PLAN_STEP_LINK_KIND_VALUES] },
+    linkNote: { type: "string" },
+    promoteToItemDep: { type: "boolean" },
+    allowMultipleActive: { type: "boolean" },
+    file: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }] },
+    test: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }] },
+    doc: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }] },
+    decisionText: { type: "string" },
+    decision: { type: "string" },
+    decisionRationale: { type: "string" },
+    decisionEvidence: { type: "string" },
+    discoveryText: { type: "string" },
+    discovery: { type: "string" },
+    validationText: { type: "string" },
+    validation: { type: "string" },
+    validationCommand: { type: "string" },
+    validationExpected: { type: "string" },
+    steps: { type: "array", items: { type: "string" } },
+    materializeType: { type: "string" },
+    materializeParent: { type: "string" },
+    materializeTags: { type: "string" },
+};
+const PLAN_ACTION_PARAMETER_METADATA = {
+    subcommand: {
+        description: "Plan workflow operation to run.",
+        examples: ["create", "show", "add-step", "approve"],
+    },
+    stepRef: {
+        description: "Plan step id or order for step lifecycle subcommands.",
+        examples: ["plan-step-001", "1"],
+    },
+    reorderTo: {
+        description: "New integer order for reorder-step.",
+        examples: [1, "2"],
+    },
+    scope: {
+        description: "Short free-text scope statement describing what the Plan covers.",
+        examples: ["Release readiness audit", "Search package migration"],
+    },
+    mode: {
+        description: "Plan lifecycle mode.",
+        examples: ["draft", "research", "approved"],
+    },
+    file: {
+        description: "File link to attach while creating or materializing a Plan.",
+        examples: ["path=src/cli.ts,note=implementation surface"],
+    },
+    test: {
+        description: "Test command link to attach while creating or materializing a Plan.",
+        examples: ["command=pnpm build,timeout_seconds=300"],
+    },
+    doc: {
+        description: "Documentation link to attach while creating or materializing a Plan.",
+        examples: ["path=docs/SDK.md,note=public API reference"],
+    },
+};
 const PM_TOOL_GLOBAL_PARAMETER_KEYS = ["json", "quiet", "profile", "noExtensions", "noPager", "path", "pmExecutable", "timeoutMs"];
 function toSchemaKeyList(values) {
     return normalizeUniqueStringList(values);
@@ -1657,6 +1889,8 @@ const LIST_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     ...TOOL_LIST_FILTER_OPTION_CONTRACTS.map((entry) => entry.param),
     "includeBody",
     "compact",
+    "brief",
+    "full",
 ]);
 const AGGREGATE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     ...TOOL_AGGREGATE_OPTION_CONTRACTS.map((entry) => entry.param),
@@ -1668,6 +1902,8 @@ const SEARCH_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     "query",
     "keywords",
     "mode",
+    "semantic",
+    "hybrid",
     "includeLinked",
     "titleExact",
     "phraseExact",
@@ -1677,7 +1913,7 @@ const SEARCH_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
 ]);
 const AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS = ["author", "message", "force"];
 const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
-    init: { optional: ["prefix", "preset"] },
+    init: { optional: ["prefix", "preset", "defaults", "author", "agentGuidance", "withPackages"] },
     config: {
         required: ["scope", "configAction"],
         optional: ["key", "criterion", "clearCriteria", "format", "policy"],
@@ -1790,20 +2026,90 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     guide: { optional: ["format", "depth"] },
     context: { optional: CONTEXT_CONTRACT_PARAMETER_KEYS },
     ctx: { optional: CONTEXT_CONTRACT_PARAMETER_KEYS },
-    get: { required: ["id"] },
+    get: { required: ["id"], optional: ["depth", "full", "fields"] },
     search: {
         optional: SEARCH_CONTRACT_PARAMETER_KEYS,
         anyOfRequired: [["query"], ["keywords"]],
     },
     reindex: { optional: ["mode", "progress"] },
-    history: { required: ["id"], optional: ["limit", "diff", "verify"] },
+    history: { required: ["id"], optional: ["limit", "compact", "full", "diff", "verify"] },
+    "history-redact": {
+        required: ["id"],
+        optional: ["literal", "regex", "replacement", "dryRun", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],
+        anyOfRequired: [["literal"], ["regex"]],
+    },
+    "history-repair": {
+        required: ["id"],
+        optional: ["dryRun", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],
+    },
+    schema: {
+        required: ["subcommand", "name"],
+        // No --message: schema add-type writes a config file, not item history.
+        optional: ["description", "defaultStatus", "folder", "alias", "author", "force"],
+    },
+    plan: {
+        required: ["subcommand"],
+        optional: [
+            "id",
+            "stepRef",
+            "reorderTo",
+            "title",
+            "description",
+            "scope",
+            "parent",
+            "related",
+            "blocks",
+            "blockedBy",
+            "harness",
+            "mode",
+            "resumeContext",
+            "tags",
+            "priority",
+            "body",
+            "claim",
+            "fromSearch",
+            "stepTitle",
+            "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",
+            ...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 },
     "update-many": { optional: UPDATE_MANY_CONTRACT_PARAMETER_KEYS },
     normalize: { optional: NORMALIZE_CONTRACT_PARAMETER_KEYS },
     close: { required: ["id", "text"], optional: ["validateClose", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS] },
-    delete: { required: ["id"], optional: AUTHOR_MESSAGE_FORCE_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"],
@@ -1928,6 +2234,11 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "noRefresh",
             "refreshVectors",
             "verboseStaleItems",
+            "summary",
+            "skipVectors",
+            "skipIntegrity",
+            "skipDrift",
+            "full",
         ],
     },
     validate: {
@@ -1942,6 +2253,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "scanMode",
             "includePmInternals",
             "verboseFileLists",
+            "verboseDiagnostics",
             "strictExit",
             "failOnWarn",
             "checkHistoryDrift",
@@ -1957,7 +2269,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     "pause-task": { required: ["id"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
     "close-task": { required: ["id", "text"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
 };
-export const PM_TOOL_ACTION_PARAMETER_CONTRACTS = PM_TOOL_ACTION_SCHEMA_CONTRACTS;
+export const PM_TOOL_ACTION_PARAMETER_CONTRACTS = Object.freeze(Object.fromEntries(PM_TOOL_ACTIONS.map((action) => [action, PM_TOOL_ACTION_SCHEMA_CONTRACTS[action]])));
 const PM_TOOL_PARAMETER_METADATA = {
     action: {
         description: "Tool action to execute.",
@@ -1967,7 +2279,7 @@ const PM_TOOL_PARAMETER_METADATA = {
         examples: [".agents/pm"],
     },
     scope: {
-        description: "Scope selector for commands that operate on project or global state.",
+        description: "Scope selector for commands that operate on project or global state. Linked files, docs, and tests default to project scope when omitted.",
         examples: ["project", "global"],
     },
     detail: {
@@ -2055,10 +2367,36 @@ const PM_TOOL_PARAMETER_METADATA = {
         description: "Item type name from the active runtime type registry.",
         examples: ["Task", "Feature"],
     },
+    subcommand: {
+        description: "Subcommand for the schema action.",
+        examples: ["add-type"],
+    },
+    name: {
+        description: "Custom item type name to register (for schema add-type).",
+        examples: ["Spike"],
+    },
+    defaultStatus: {
+        description: "Default status hint recorded for a custom item type.",
+        examples: ["open"],
+    },
+    alias: {
+        description: "Aliases for the custom item type (repeatable).",
+        examples: [["spike", "research"]],
+    },
     preset: {
         description: "Governance preset for initialization flows.",
         examples: ["minimal", "default", "strict"],
     },
+    defaults: {
+        description: "Use non-interactive setup defaults during initialization.",
+    },
+    agentGuidance: {
+        description: "Control AGENTS.md/CLAUDE.md guidance behavior during init: ask, add, skip, or status.",
+        examples: ["ask", "add", "skip", "status"],
+    },
+    withPackages: {
+        description: "Install all bundled first-party pm packages during initialization.",
+    },
     createMode: {
         description: "Create required-option policy mode.",
         examples: ["strict", "progressive"],
@@ -2235,6 +2573,18 @@ const PM_TOOL_PARAMETER_METADATA = {
         description: "Number of most recent comments to include per item in comments-audit output (use 0 for summary-only item rows).",
         examples: [0, 1, "3"],
     },
+    literal: {
+        description: "Repeatable literal matcher used by history-redact to scrub exact string values.",
+        examples: ["[redacted_path_prefix]/private/path"],
+    },
+    regex: {
+        description: "Repeatable regex matcher used by history-redact. Accepts either /pattern/flags or a raw pattern (global mode is auto-enabled).",
+        examples: ["/192\\\\.168\\\\.[0-9.]+/g", "token=[A-Za-z0-9_-]+"],
+    },
+    replacement: {
+        description: 'Replacement text used by history-redact (defaults to "[redacted]").',
+        examples: ["[scrubbed_path]"],
+    },
     validateClose: {
         description: 'Close-time metadata validation mode ("off", "warn", or "strict").',
         examples: ["off", "warn", "strict"],
@@ -2280,6 +2630,15 @@ const PM_TOOL_PARAMETER_METADATA = {
     verboseStaleItems: {
         description: "For health action, include full stale-item arrays in vectorization details.",
     },
+    skipVectors: {
+        description: "For health action, skip vectorization checks for a faster diagnostic run.",
+    },
+    skipIntegrity: {
+        description: "For health action, skip item/history file integrity checks for a faster diagnostic run.",
+    },
+    skipDrift: {
+        description: "For health action, skip history drift hash checks for a faster diagnostic run.",
+    },
     scanMode: {
         description: "Select file candidate scan mode for --check-files.",
         examples: ["default", "tracked-all", "tracked-all-strict"],
@@ -2290,8 +2649,11 @@ const PM_TOOL_PARAMETER_METADATA = {
     verboseFileLists: {
         description: "For validate action, include full file-path lists for --check-files details.",
     },
+    verboseDiagnostics: {
+        description: "For validate action, include full diagnostic ID lists instead of compact summaries.",
+    },
     strictExit: {
-        description: "Return non-zero exit when health/validate/extension-doctor warnings are present (ok=false).",
+        description: "Return non-zero exit when health/validate/extension-doctor warnings are present.",
     },
     failOnWarn: {
         description: "Alias for strictExit in health/validate/extension-doctor action payloads.",
@@ -2374,11 +2736,11 @@ const PM_TOOL_PARAMETER_METADATA = {
         description: "Render compact projection output for search and list-family actions.",
     },
     full: {
-        description: "Render full nested search hit payload output.",
+        description: "Enable command-specific full/detail output mode when supported, such as deep item reads for get or full payload mode for search/history.",
     },
     fields: {
-        description: "Comma-separated projection fields for search or list-family outputs.",
-        examples: ["id,title,score,matched_fields", "id,title,parent,type"],
+        description: "Comma-separated projection fields for get, search, or list-family outputs.",
+        examples: ["id,title,status,parent,type", "id,title,score,matched_fields"],
     },
     groupBy: {
         description: "Comma-separated aggregate grouping fields (supported: parent,type,priority,status,assignee,tags,sprint,release).",
@@ -2469,6 +2831,27 @@ function decorateToolParameterDefinition(key, definition) {
         ...(metadata?.examples ? { examples: metadata.examples } : {}),
     };
 }
+function actionScopedToolParameterMetadata(action, key) {
+    if (action === "plan" && Object.prototype.hasOwnProperty.call(PLAN_ACTION_PARAMETER_METADATA, key)) {
+        return PLAN_ACTION_PARAMETER_METADATA[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) {
+    if (action === "plan" && Object.prototype.hasOwnProperty.call(PLAN_ACTION_PARAMETER_PROPERTIES, key)) {
+        return PLAN_ACTION_PARAMETER_PROPERTIES[key];
+    }
+    return PM_TOOL_PARAMETER_PROPERTIES[key];
+}
 function buildActionScopedToolSchema(action) {
     const contract = PM_TOOL_ACTION_SCHEMA_CONTRACTS[action];
     const required = toSchemaKeyList(contract.required ?? []);
@@ -2484,9 +2867,9 @@ function buildActionScopedToolSchema(action) {
         if (key === "action") {
             continue;
         }
-        const definition = PM_TOOL_PARAMETER_PROPERTIES[key];
+        const definition = actionScopedToolParameterDefinition(action, key);
         if (definition) {
-            properties[key] = decorateToolParameterDefinition(key, definition);
+            properties[key] = decorateActionScopedToolParameterDefinition(action, key, definition);
         }
     }
     const schema = {
@@ -2556,4 +2939,5 @@ function buildProviderCompatibleToolSchema() {
     };
 }
 export const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = buildProviderCompatibleToolSchema();
-//# sourceMappingURL=cli-contracts.js.map
+//# sourceMappingURL=cli-contracts.js.map
+//# debugId=b7c80b7e-7951-5ab0-ab77-8e309cf59f0d