@unbrained/pm-cli 2026.5.18 → 2026.5.27

package/dist/sdk/cli-contracts.js

@@ -1,52 +1,16 @@
 
-!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]="4e7e9e79-ece5-54e2-883e-5ef16db5152b")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b61aadc4-20d4-50e8-83f0-095c541132f2")}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";
-export const PM_EXTENSION_CAPABILITY_CONTRACTS = [
-    "commands",
-    "renderers",
-    "hooks",
-    "schema",
-    "importers",
-    "search",
-    "parser",
-    "preflight",
-    "services",
-];
-export const PM_EXTENSION_SERVICE_NAME_CONTRACTS = [
-    "output_format",
-    "error_format",
-    "help_format",
-    "lock_acquire",
-    "lock_release",
-    "history_append",
-    "item_store_write",
-    "item_store_delete",
-];
-export const PM_EXTENSION_POLICY_MODE_CONTRACTS = ["off", "warn", "enforce"];
-export const PM_EXTENSION_TRUST_MODE_CONTRACTS = ["off", "warn", "enforce"];
-export const PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS = ["none", "restricted", "strict"];
-export const PM_EXTENSION_POLICY_SURFACE_CONTRACTS = [
-    "commands.override",
-    "commands.handler",
-    "hooks.beforecommand",
-    "hooks.aftercommand",
-    "hooks.onwrite",
-    "hooks.onread",
-    "hooks.onindex",
-    "schema.flags",
-    "schema.itemfields",
-    "schema.itemtypes",
-    "schema.migrations",
-    "parser.override",
-    "preflight.override",
-    "services.override",
-    "renderers.override",
-    "importers.importer",
-    "importers.exporter",
-    "search.provider",
-    "search.vectorstore",
-];
+// PM_* enum/guard contracts and the bulk tool-parameter property/metadata data
+// tables live in sibling modules and are re-exported here so existing import
+// sites (sdk/index.ts, mcp/server.ts, commands/contracts.ts, completion.ts, …)
+// keep importing everything from "./cli-contracts.js" unchanged.
+export { PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_TOOL_ACTIONS, isPmToolAction, isPmExtensionCapabilityContract, isPmExtensionServiceNameContract, isPmExtensionPolicyModeContract, isPmExtensionPolicySurfaceContract, } from "./cli-contracts/enum-contracts.js";
+export { TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_DEDUPE_AUDIT_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS, TOOL_CREATE_OPTION_CONTRACTS, TOOL_UPDATE_OPTION_CONTRACTS, TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS, TOOL_NORMALIZE_FILTER_OPTION_CONTRACTS, TOOL_CALENDAR_OPTION_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_DEPS_OPTION_CONTRACTS, } from "./cli-contracts/tool-option-contracts.js";
+import { PM_TOOL_ACTIONS } from "./cli-contracts/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_NORMALIZE_FILTER_OPTION_CONTRACTS, TOOL_CONTEXT_OPTION_CONTRACTS, TOOL_ACTIVITY_OPTION_CONTRACTS, TOOL_LIST_FILTER_OPTION_CONTRACTS, TOOL_AGGREGATE_OPTION_CONTRACTS, TOOL_DEDUPE_AUDIT_OPTION_CONTRACTS, TOOL_SEARCH_FILTER_OPTION_CONTRACTS, } from "./cli-contracts/tool-option-contracts.js";
+import { PM_TOOL_PARAMETER_PROPERTIES, PM_TOOL_PARAMETER_METADATA, PLAN_ACTION_PARAMETER_PROPERTIES, PLAN_ACTION_PARAMETER_METADATA, } from "./cli-contracts/tool-parameter-tables.js";
 function normalizeUniqueStringList(values) {
     return [...new Set(Array.from(values).filter((value) => value.trim().length > 0))];
 }
@@ -94,393 +58,10 @@ export function compactFlagAliasContracts(flagContracts) {
         return contract.flag === canonical || !canonicalFlags.has(canonical);
     });
 }
-export const PM_CORE_COMMAND_NAMES = [
-    "init",
-    "config",
-    "extension",
-    "package",
-    "packages",
-    "install",
-    "upgrade",
-    "create",
-    "list",
-    "list-all",
-    "list-draft",
-    "list-open",
-    "list-in-progress",
-    "list-blocked",
-    "list-closed",
-    "list-canceled",
-    "aggregate",
-    "dedupe-audit",
-    "guide",
-    "context",
-    "ctx",
-    "get",
-    "search",
-    "reindex",
-    "history",
-    "history-redact",
-    "activity",
-    "restore",
-    "update",
-    "update-many",
-    "normalize",
-    "close",
-    "delete",
-    "append",
-    "comments",
-    "comments-audit",
-    "notes",
-    "learnings",
-    "files",
-    "docs",
-    "deps",
-    "plan",
-    "test",
-    "test-all",
-    "test-runs",
-    "stats",
-    "health",
-    "validate",
-    "gc",
-    "contracts",
-    "claim",
-    "release",
-    "start-task",
-    "pause-task",
-    "close-task",
-    "completion",
-    "help",
-];
-export const PM_TOOL_ACTIONS = [
-    "init",
-    "config",
-    "extension-init",
-    "extension-install",
-    "extension-uninstall",
-    "extension-explore",
-    "extension-manage",
-    "extension-reload",
-    "extension-doctor",
-    "extension-catalog",
-    "extension-adopt",
-    "extension-adopt-all",
-    "extension-activate",
-    "extension-deactivate",
-    "extension",
-    "package-init",
-    "package-install",
-    "package-uninstall",
-    "package-explore",
-    "package-manage",
-    "package-reload",
-    "package-doctor",
-    "package-catalog",
-    "package-adopt",
-    "package-adopt-all",
-    "package-activate",
-    "package-deactivate",
-    "package",
-    "install",
-    "upgrade",
-    "create",
-    "list",
-    "list-all",
-    "list-draft",
-    "list-open",
-    "list-in-progress",
-    "list-blocked",
-    "list-closed",
-    "list-canceled",
-    "aggregate",
-    "context",
-    "ctx",
-    "get",
-    "search",
-    "history",
-    "history-redact",
-    "activity",
-    "restore",
-    "update",
-    "update-many",
-    "close",
-    "delete",
-    "append",
-    "comments",
-    "plan",
-    "notes",
-    "learnings",
-    "files",
-    "docs",
-    "deps",
-    "test",
-    "test-all",
-    "stats",
-    "health",
-    "validate",
-    "gc",
-    "contracts",
-    "claim",
-    "release",
-    "start-task",
-    "pause-task",
-    "close-task",
-];
-export function isPmToolAction(value) {
-    return PM_TOOL_ACTIONS.includes(value);
-}
-export function isPmExtensionCapabilityContract(value) {
-    return PM_EXTENSION_CAPABILITY_CONTRACTS.includes(value);
-}
-export function isPmExtensionServiceNameContract(value) {
-    return PM_EXTENSION_SERVICE_NAME_CONTRACTS.includes(value);
-}
-export function isPmExtensionPolicyModeContract(value) {
-    return PM_EXTENSION_POLICY_MODE_CONTRACTS.includes(value);
-}
-export function isPmExtensionPolicySurfaceContract(value) {
-    return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value);
-}
-export const TOOL_LIST_FILTER_OPTION_CONTRACTS = [
-    { param: "type", flag: "--type" },
-    { param: "tag", flag: "--tag" },
-    { param: "priority", flag: "--priority" },
-    { param: "deadlineBefore", flag: "--deadline-before" },
-    { param: "deadlineAfter", flag: "--deadline-after" },
-    { param: "assignee", flag: "--assignee" },
-    { param: "assigneeFilter", flag: "--assignee-filter" },
-    { param: "parent", flag: "--parent" },
-    { param: "sprint", flag: "--sprint" },
-    { param: "release", flag: "--release" },
-    { param: "limit", flag: "--limit" },
-    { param: "offset", flag: "--offset" },
-    { param: "fields", flag: "--fields" },
-    { param: "sort", flag: "--sort" },
-    { param: "order", flag: "--order" },
-];
-export const TOOL_AGGREGATE_OPTION_CONTRACTS = [
-    { param: "groupBy", flag: "--group-by" },
-    { param: "status", flag: "--status" },
-    { param: "type", flag: "--type" },
-    { param: "tag", flag: "--tag" },
-    { param: "priority", flag: "--priority" },
-    { param: "deadlineBefore", flag: "--deadline-before" },
-    { param: "deadlineAfter", flag: "--deadline-after" },
-    { param: "assignee", flag: "--assignee" },
-    { param: "assigneeFilter", flag: "--assignee-filter" },
-    { param: "parent", flag: "--parent" },
-    { param: "sprint", flag: "--sprint" },
-    { param: "release", flag: "--release" },
-];
-export const TOOL_DEDUPE_AUDIT_OPTION_CONTRACTS = [
-    { param: "mode", flag: "--mode" },
-    { param: "limit", flag: "--limit" },
-    { param: "threshold", flag: "--threshold" },
-    { param: "status", flag: "--status" },
-    { param: "type", flag: "--type" },
-    { param: "tag", flag: "--tag" },
-    { param: "priority", flag: "--priority" },
-    { param: "deadlineBefore", flag: "--deadline-before" },
-    { param: "deadlineAfter", flag: "--deadline-after" },
-    { param: "assignee", flag: "--assignee" },
-    { param: "assigneeFilter", flag: "--assignee-filter" },
-    { param: "parent", flag: "--parent" },
-    { param: "sprint", flag: "--sprint" },
-    { param: "release", flag: "--release" },
-];
-export const TOOL_SEARCH_FILTER_OPTION_CONTRACTS = [
-    { param: "type", flag: "--type" },
-    { param: "tag", flag: "--tag" },
-    { param: "priority", flag: "--priority" },
-    { param: "deadlineBefore", flag: "--deadline-before" },
-    { param: "deadlineAfter", flag: "--deadline-after" },
-    { param: "fields", flag: "--fields" },
-    { param: "limit", flag: "--limit" },
-];
-export const TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS = [
-    { param: "parent", flag: "--parent" },
-    { param: "reviewer", flag: "--reviewer" },
-    { param: "risk", flag: "--risk" },
-    { param: "confidence", flag: "--confidence" },
-    { param: "sprint", flag: "--sprint" },
-    { param: "release", flag: "--release" },
-    { param: "blockedBy", flag: "--blocked-by" },
-    { param: "blockedReason", flag: "--blocked-reason" },
-    { param: "unblockNote", flag: "--unblock-note" },
-    { param: "reporter", flag: "--reporter" },
-    { param: "severity", flag: "--severity" },
-    { param: "environment", flag: "--environment" },
-    { param: "reproSteps", flag: "--repro-steps" },
-    { param: "resolution", flag: "--resolution" },
-    { param: "expectedResult", flag: "--expected-result" },
-    { param: "actualResult", flag: "--actual-result" },
-    { param: "affectedVersion", flag: "--affected-version" },
-    { param: "fixedVersion", flag: "--fixed-version" },
-    { param: "component", flag: "--component" },
-    { param: "regression", flag: "--regression", booleanish: true },
-    { param: "customerImpact", flag: "--customer-impact" },
-    { param: "definitionOfReady", flag: "--definition-of-ready", allowEmpty: true },
-    { param: "order", flag: "--order" },
-    { param: "goal", flag: "--goal" },
-    { param: "objective", flag: "--objective" },
-    { param: "value", flag: "--value" },
-    { param: "impact", flag: "--impact" },
-    { param: "outcome", flag: "--outcome" },
-    { param: "whyNow", flag: "--why-now" },
-];
-export const TOOL_CREATE_OPTION_CONTRACTS = [
-    { param: "title", flag: "--title" },
-    { param: "description", flag: "--description", allowEmpty: true },
-    { param: "type", flag: "--type" },
-    { param: "template", flag: "--template" },
-    { param: "createMode", flag: "--create-mode" },
-    { param: "schedulePreset", flag: "--schedule-preset" },
-    { param: "status", flag: "--status" },
-    { param: "priority", flag: "--priority" },
-    { param: "tags", flag: "--tags", allowEmpty: true },
-    { param: "body", flag: "--body", allowEmpty: true },
-    { param: "deadline", flag: "--deadline" },
-    { param: "estimate", flag: "--estimate" },
-    { param: "acceptanceCriteria", flag: "--acceptance-criteria", allowEmpty: true },
-    { param: "author", flag: "--author" },
-    { param: "message", flag: "--message", allowEmpty: true },
-    { param: "assignee", flag: "--assignee" },
-    { param: "reminder", flag: "--reminder", repeatable: true },
-    { param: "event", flag: "--event", repeatable: true },
-    { param: "typeOption", flag: "--type-option", repeatable: true },
-    { param: "dep", flag: "--dep", repeatable: true },
-    { param: "comment", flag: "--comment", repeatable: true },
-    { param: "note", flag: "--note", repeatable: true },
-    { param: "learning", flag: "--learning", repeatable: true },
-    { param: "linkedFile", flag: "--file", repeatable: true },
-    { param: "linkedTest", flag: "--test", repeatable: true },
-    { param: "doc", flag: "--doc", repeatable: true },
-    { param: "unset", flag: "--unset", repeatable: true },
-    { param: "clearDeps", flag: "--clear-deps" },
-    { param: "clearComments", flag: "--clear-comments" },
-    { param: "clearNotes", flag: "--clear-notes" },
-    { param: "clearLearnings", flag: "--clear-learnings" },
-    { param: "clearFiles", flag: "--clear-files" },
-    { param: "clearTests", flag: "--clear-tests" },
-    { param: "clearDocs", flag: "--clear-docs" },
-    { param: "clearReminders", flag: "--clear-reminders" },
-    { param: "clearEvents", flag: "--clear-events" },
-    { param: "clearTypeOptions", flag: "--clear-type-options" },
-    { param: "allowAuditUpdate", flag: "--allow-audit-update" },
-];
-export const TOOL_UPDATE_OPTION_CONTRACTS = [
-    { param: "title", flag: "--title" },
-    { param: "description", flag: "--description", allowEmpty: true },
-    { param: "body", flag: "--body", allowEmpty: true },
-    { param: "status", flag: "--status" },
-    { param: "closeReason", flag: "--close-reason" },
-    { param: "priority", flag: "--priority" },
-    { param: "type", flag: "--type" },
-    { param: "tags", flag: "--tags", allowEmpty: true },
-    { param: "deadline", flag: "--deadline" },
-    { param: "estimate", flag: "--estimate" },
-    { param: "acceptanceCriteria", flag: "--acceptance-criteria", allowEmpty: true },
-    { param: "author", flag: "--author" },
-    { param: "message", flag: "--message", allowEmpty: true },
-    { param: "assignee", flag: "--assignee" },
-    { param: "dep", flag: "--dep", repeatable: true },
-    { param: "depRemove", flag: "--dep-remove", repeatable: true },
-    { param: "replaceDeps", flag: "--replace-deps" },
-    { param: "replaceTests", flag: "--replace-tests" },
-    { param: "comment", flag: "--comment", repeatable: true },
-    { param: "note", flag: "--note", repeatable: true },
-    { param: "learning", flag: "--learning", repeatable: true },
-    { param: "linkedFile", flag: "--file", repeatable: true },
-    { param: "linkedTest", flag: "--test", repeatable: true },
-    { param: "doc", flag: "--doc", repeatable: true },
-    { param: "reminder", flag: "--reminder", repeatable: true },
-    { param: "event", flag: "--event", repeatable: true },
-    { param: "typeOption", flag: "--type-option", repeatable: true },
-    { param: "unset", flag: "--unset", repeatable: true },
-    { param: "clearDeps", flag: "--clear-deps" },
-    { param: "clearComments", flag: "--clear-comments" },
-    { param: "clearNotes", flag: "--clear-notes" },
-    { param: "clearLearnings", flag: "--clear-learnings" },
-    { param: "clearFiles", flag: "--clear-files" },
-    { param: "clearTests", flag: "--clear-tests" },
-    { param: "clearDocs", flag: "--clear-docs" },
-    { param: "clearReminders", flag: "--clear-reminders" },
-    { param: "clearEvents", flag: "--clear-events" },
-    { param: "clearTypeOptions", flag: "--clear-type-options" },
-    { param: "allowAuditDepUpdate", flag: "--allow-audit-dep-update" },
-];
-export const TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS = [
-    { param: "filterStatus", flag: "--filter-status" },
-    { param: "filterType", flag: "--filter-type" },
-    { param: "filterTag", flag: "--filter-tag" },
-    { param: "filterPriority", flag: "--filter-priority" },
-    { param: "filterDeadlineBefore", flag: "--filter-deadline-before" },
-    { param: "filterDeadlineAfter", flag: "--filter-deadline-after" },
-    { param: "filterAssignee", flag: "--filter-assignee" },
-    { param: "filterAssigneeFilter", flag: "--filter-assignee-filter" },
-    { param: "filterParent", flag: "--filter-parent" },
-    { param: "filterSprint", flag: "--filter-sprint" },
-    { param: "filterRelease", flag: "--filter-release" },
-    { param: "limit", flag: "--limit" },
-    { param: "offset", flag: "--offset" },
-];
-export const TOOL_NORMALIZE_FILTER_OPTION_CONTRACTS = [...TOOL_UPDATE_MANY_FILTER_OPTION_CONTRACTS];
-export const TOOL_CALENDAR_OPTION_CONTRACTS = [
-    { param: "view", flag: "--view" },
-    { param: "date", flag: "--date" },
-    { param: "from", flag: "--from" },
-    { param: "to", flag: "--to" },
-    { param: "type", flag: "--type" },
-    { param: "tag", flag: "--tag" },
-    { param: "priority", flag: "--priority" },
-    { param: "status", flag: "--status" },
-    { param: "assignee", flag: "--assignee" },
-    { param: "assigneeFilter", flag: "--assignee-filter" },
-    { param: "sprint", flag: "--sprint" },
-    { param: "release", flag: "--release" },
-    { param: "include", flag: "--include" },
-    { param: "recurrenceLookaheadDays", flag: "--recurrence-lookahead-days" },
-    { param: "recurrenceLookbackDays", flag: "--recurrence-lookback-days" },
-    { param: "occurrenceLimit", flag: "--occurrence-limit" },
-    { param: "limit", flag: "--limit" },
-    { param: "format", flag: "--format" },
-];
-export const TOOL_ACTIVITY_OPTION_CONTRACTS = [
-    { param: "id", flag: "--id" },
-    { param: "op", flag: "--op" },
-    { param: "author", flag: "--author" },
-    { param: "from", flag: "--from" },
-    { param: "to", flag: "--to" },
-    { param: "limit", flag: "--limit" },
-];
-export const TOOL_CONTEXT_OPTION_CONTRACTS = [
-    { param: "date", flag: "--date" },
-    { param: "from", flag: "--from" },
-    { param: "to", flag: "--to" },
-    { param: "type", flag: "--type" },
-    { param: "tag", flag: "--tag" },
-    { param: "priority", flag: "--priority" },
-    { param: "assignee", flag: "--assignee" },
-    { param: "assigneeFilter", flag: "--assignee-filter" },
-    { param: "sprint", flag: "--sprint" },
-    { param: "release", flag: "--release" },
-    { param: "limit", flag: "--limit" },
-    { param: "format", flag: "--format" },
-    { param: "depth", flag: "--depth" },
-    { param: "section", flag: "--section", repeatable: true },
-    { param: "activityLimit", flag: "--activity-limit" },
-    { param: "staleThreshold", flag: "--stale-threshold" },
-];
-export const TOOL_DEPS_OPTION_CONTRACTS = [
-    { param: "format", flag: "--format" },
-    { param: "maxDepth", flag: "--max-depth" },
-    { param: "collapse", flag: "--collapse" },
-    { param: "summary", flag: "--summary" },
-];
 export const SUBCOMMAND_GLOBAL_FLAG_CONTRACTS = [
     { flag: "--json" },
     { flag: "--quiet" },
+    { flag: "--no-changed-fields" },
     { flag: "--path" },
     { flag: "--no-extensions" },
     { flag: "--no-pager" },
@@ -492,6 +73,7 @@ export const GLOBAL_FLAG_CONTRACTS = [
     { flag: "--version" },
 ];
 export const LIST_FILTER_FLAG_CONTRACTS = [
+    { flag: "--status", list: true },
     { flag: "--type" },
     { flag: "--tag" },
     { flag: "--priority" },
@@ -508,14 +90,14 @@ export const LIST_FILTER_FLAG_CONTRACTS = [
     { flag: "--compact" },
     { flag: "--brief" },
     { flag: "--full" },
-    { flag: "--fields" },
+    { flag: "--fields", list: true },
     { flag: "--sort" },
     { flag: "--order" },
     { flag: "--include-body" },
     { flag: "--stream" },
 ];
 export const AGGREGATE_FLAG_CONTRACTS = [
-    { flag: "--group-by" },
+    { flag: "--group-by", list: true },
     { flag: "--count" },
     { flag: "--include-unparented" },
     { flag: "--include_unparented" },
@@ -599,8 +181,6 @@ export const FILES_FLAG_CONTRACTS = [
     { flag: "--remove" },
     { flag: "--migrate" },
     { flag: "--list" },
-    { flag: "--apply" },
-    { flag: "--note" },
     { flag: "--append-stable" },
     { flag: "--validate-paths" },
     { flag: "--audit" },
@@ -621,6 +201,8 @@ export const DOCS_FLAG_CONTRACTS = [
 ];
 export const HISTORY_FLAG_CONTRACTS = [
     { flag: "--limit" },
+    { flag: "--compact" },
+    { flag: "--full" },
     { flag: "--diff" },
     { flag: "--verify" },
 ];
@@ -633,6 +215,20 @@ export const HISTORY_REDACT_FLAG_CONTRACTS = [
     { 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" },
@@ -644,12 +240,12 @@ export const PLAN_FLAG_CONTRACTS = [
     { flag: "--harness" },
     { flag: "--mode" },
     { flag: "--resume-context", aliases: ["--resume_context"] },
-    { flag: "--tags" },
+    { flag: "--tags", list: true },
     { flag: "--priority" },
     { flag: "--body" },
     { flag: "--claim" },
     { flag: "--from-search", aliases: ["--from_search"] },
-    { flag: "--step-title", aliases: ["--step_title"] },
+    { 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"] },
@@ -665,15 +261,15 @@ export const PLAN_FLAG_CONTRACTS = [
     { flag: "--file" },
     { flag: "--test" },
     { flag: "--doc" },
-    { flag: "--decision-text", aliases: ["--decision_text"] },
+    { 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"] },
-    { flag: "--validation-text", aliases: ["--validation_text"] },
+    { 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: "--fields", list: true },
     { flag: "--steps" },
     { flag: "--materialize-type", aliases: ["--materialize_type"] },
     { flag: "--materialize-parent", aliases: ["--materialize_parent"] },
@@ -688,6 +284,7 @@ export const INIT_FLAG_CONTRACTS = [
     { flag: "--author" },
     { flag: "--agent-guidance" },
     { flag: "--with-packages" },
+    { flag: "--verbose" },
 ];
 export const CONFIG_FLAG_CONTRACTS = [
     { flag: "--criterion" },
@@ -712,6 +309,7 @@ export const EXTENSION_FLAG_CONTRACTS = [
     { flag: "--install" },
     { flag: "--uninstall" },
     { flag: "--explore" },
+    { flag: "--list" },
     { flag: "--manage" },
     { flag: "--reload" },
     { flag: "--watch" },
@@ -782,6 +380,7 @@ export const RESTORE_FLAG_CONTRACTS = [
     { flag: "--force" },
 ];
 export const DELETE_FLAG_CONTRACTS = [
+    { flag: "--dry-run" },
     { flag: "--author" },
     { flag: "--message" },
     { flag: "--force" },
@@ -870,6 +469,8 @@ 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" },
@@ -886,6 +487,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" },
@@ -902,7 +504,7 @@ export const CREATE_FLAG_CONTRACTS = [
     { flag: "--schedule_preset" },
     { short: "-s", flag: "--status" },
     { short: "-p", flag: "--priority" },
-    { flag: "--tags" },
+    { flag: "--tags", list: true },
     { short: "-b", flag: "--body" },
     { flag: "--deadline" },
     { flag: "--estimate" },
@@ -987,7 +589,7 @@ export const UPDATE_FLAG_CONTRACTS = [
     { flag: "--close_reason" },
     { short: "-p", flag: "--priority" },
     { flag: "--type" },
-    { flag: "--tags" },
+    { flag: "--tags", list: true },
     { flag: "--deadline" },
     { flag: "--estimate" },
     { flag: "--estimated-minutes" },
@@ -1094,7 +696,7 @@ export const UPDATE_MANY_FLAG_CONTRACTS = [
     { short: "-b", flag: "--body" },
     { short: "-p", flag: "--priority" },
     { flag: "--type" },
-    { flag: "--tags" },
+    { flag: "--tags", list: true },
     { flag: "--deadline" },
     { flag: "--estimate" },
     { flag: "--estimated-minutes" },
@@ -1224,6 +826,8 @@ export const ACTIVITY_FLAG_CONTRACTS = [
     { flag: "--from" },
     { flag: "--to" },
     { flag: "--limit" },
+    { flag: "--compact" },
+    { flag: "--full" },
     { flag: "--stream" },
 ];
 export const CONTEXT_FLAG_CONTRACTS = [
@@ -1248,7 +852,8 @@ export const CONTEXT_FLAG_CONTRACTS = [
 ];
 export const GET_FLAG_CONTRACTS = [
     { flag: "--depth" },
-    { flag: "--fields" },
+    { flag: "--full" },
+    { flag: "--fields", list: true },
 ];
 export const GUIDE_FLAG_CONTRACTS = [
     { flag: "--list" },
@@ -1270,7 +875,7 @@ export const SEARCH_FLAG_CONTRACTS = [
     { flag: "--phrase-exact" },
     { flag: "--compact" },
     { flag: "--full" },
-    { flag: "--fields" },
+    { flag: "--fields", list: true },
     { flag: "--limit" },
     { flag: "--type" },
     { flag: "--tag" },
@@ -1369,10 +974,6 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
             return withSubcommandGlobalFlags(CREATE_FLAG_CONTRACTS);
         case "aggregate":
             return withSubcommandGlobalFlags(AGGREGATE_FLAG_CONTRACTS);
-        case "dedupe-audit":
-            return withSubcommandGlobalFlags(DEDUPE_AUDIT_FLAG_CONTRACTS);
-        case "comments-audit":
-            return withSubcommandGlobalFlags(COMMENTS_AUDIT_FLAG_CONTRACTS);
         case "calendar":
             return withSubcommandGlobalFlags(CALENDAR_FLAG_CONTRACTS);
         case "context":
@@ -1385,6 +986,10 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
             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":
@@ -1395,8 +1000,6 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
             return withSubcommandGlobalFlags(UPDATE_FLAG_CONTRACTS);
         case "update-many":
             return withSubcommandGlobalFlags(UPDATE_MANY_FLAG_CONTRACTS);
-        case "normalize":
-            return withSubcommandGlobalFlags(NORMALIZE_FLAG_CONTRACTS);
         case "close":
             return withSubcommandGlobalFlags(CLOSE_FLAG_CONTRACTS);
         case "delete":
@@ -1419,8 +1022,6 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
             return withSubcommandGlobalFlags(TEST_FLAG_CONTRACTS);
         case "test-all":
             return withSubcommandGlobalFlags(TEST_ALL_FLAG_CONTRACTS);
-        case "test-runs":
-            return withSubcommandGlobalFlags(TEST_RUNS_FLAG_CONTRACTS);
         case "health":
             return withSubcommandGlobalFlags(HEALTH_FLAG_CONTRACTS);
         case "validate":
@@ -1439,10 +1040,6 @@ export function resolveSubcommandFlagContractsForCommand(commandName) {
             return withSubcommandGlobalFlags(PAUSE_TASK_FLAG_CONTRACTS);
         case "close-task":
             return withSubcommandGlobalFlags(CLOSE_TASK_FLAG_CONTRACTS);
-        case "guide":
-            return withSubcommandGlobalFlags(GUIDE_FLAG_CONTRACTS);
-        case "completion":
-            return withSubcommandGlobalFlags(COMPLETION_FLAG_CONTRACTS);
         default:
             return withSubcommandGlobalFlags([]);
     }
@@ -1460,255 +1057,6 @@ export function toCompletionFlagString(flagContracts, includeGlobal = true) {
         : scoped;
     return normalizeUniqueStringList(all).join(" ");
 }
-const PM_TOOL_PARAMETER_PROPERTIES = {
-    json: { type: "boolean", default: true },
-    quiet: { type: "boolean" },
-    profile: { type: "boolean" },
-    noExtensions: { type: "boolean" },
-    noPager: { type: "boolean" },
-    path: { type: "string" },
-    pmExecutable: { type: "string" },
-    timeoutMs: { type: "number" },
-    id: { type: "string" },
-    target: { type: "string" },
-    github: { type: "string" },
-    ref: { type: "string" },
-    query: { type: "string" },
-    keywords: { type: "string" },
-    fields: { type: "string" },
-    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" },
-    schemaOnly: { type: "boolean" },
-    flagsOnly: { type: "boolean" },
-    availabilityOnly: { type: "boolean" },
-    runtimeOnly: { type: "boolean" },
-    activeOnly: { type: "boolean" },
-    eagerTags: { type: "boolean" },
-    configAction: { type: "string", enum: ["get", "set", "list", "export"] },
-    key: { type: "string" },
-    title: { type: "string" },
-    description: { type: "string" },
-    type: { type: "string" },
-    template: { type: "string" },
-    createMode: { type: "string", enum: ["strict", "progressive"] },
-    schedulePreset: { type: "string", enum: ["lightweight"] },
-    status: { type: "string", enum: ["draft", "open", "in_progress", "blocked", "closed", "canceled", "in-progress"] },
-    filterStatus: { type: "string" },
-    filterType: { type: "string" },
-    filterTag: { type: "string" },
-    filterPriority: { anyOf: [{ type: "string" }, { type: "number" }] },
-    filterDeadlineBefore: { type: "string" },
-    filterDeadlineAfter: { type: "string" },
-    filterAssignee: { type: "string" },
-    filterAssigneeFilter: { type: "string", enum: ["assigned", "unassigned"] },
-    filterParent: { type: "string" },
-    filterSprint: { type: "string" },
-    filterRelease: { type: "string" },
-    closeReason: { type: "string" },
-    priority: { anyOf: [{ type: "string" }, { type: "number" }] },
-    tags: { type: "string" },
-    body: { type: "string" },
-    deadline: { type: "string" },
-    estimate: { anyOf: [{ type: "string" }, { type: "number" }] },
-    acceptanceCriteria: { type: "string" },
-    author: { type: "string" },
-    message: { type: "string" },
-    assignee: { type: "string" },
-    assigneeFilter: { type: "string", enum: ["assigned", "unassigned"] },
-    parent: { type: "string" },
-    reviewer: { type: "string" },
-    risk: { type: "string" },
-    confidence: { anyOf: [{ type: "string" }, { type: "number" }] },
-    sprint: { type: "string" },
-    release: { type: "string" },
-    blockedBy: { type: "string" },
-    blockedReason: { type: "string" },
-    unblockNote: { type: "string" },
-    reporter: { type: "string" },
-    severity: { type: "string" },
-    environment: { type: "string" },
-    reproSteps: { type: "string" },
-    resolution: { type: "string" },
-    expectedResult: { type: "string" },
-    actualResult: { type: "string" },
-    affectedVersion: { type: "string" },
-    fixedVersion: { type: "string" },
-    component: { type: "string" },
-    regression: { anyOf: [{ type: "boolean" }, { type: "string" }, { type: "number" }] },
-    customerImpact: { type: "string" },
-    definitionOfReady: { type: "string" },
-    order: { anyOf: [{ type: "string" }, { type: "number" }] },
-    goal: { type: "string" },
-    objective: { type: "string" },
-    value: { type: "string" },
-    impact: { type: "string" },
-    outcome: { type: "string" },
-    whyNow: { type: "string" },
-    mode: {
-        type: "string",
-        enum: ["keyword", "semantic", "hybrid", "title_exact", "title_fuzzy", "parent_scope"],
-    },
-    op: { type: "string" },
-    compact: { type: "boolean" },
-    brief: { type: "boolean" },
-    full: { type: "boolean" },
-    view: { type: "string", enum: ["agenda", "day", "week", "month"] },
-    date: { type: "string" },
-    from: { type: "string" },
-    to: { type: "string" },
-    past: { type: "boolean" },
-    fullPeriod: { type: "boolean" },
-    include: { type: "string" },
-    recurrenceLookaheadDays: { anyOf: [{ type: "string" }, { type: "number" }] },
-    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" },
-    tag: { type: "string" },
-    deadlineBefore: { type: "string" },
-    deadlineAfter: { type: "string" },
-    limit: { anyOf: [{ type: "string" }, { type: "number" }] },
-    limitItems: { anyOf: [{ type: "string" }, { type: "number" }] },
-    fullHistory: { type: "boolean" },
-    latest: { anyOf: [{ type: "string" }, { type: "number" }] },
-    offset: { anyOf: [{ type: "string" }, { type: "number" }] },
-    progress: { type: "boolean" },
-    background: { type: "boolean" },
-    runId: { type: "string" },
-    stream: {
-        anyOf: [{ type: "boolean" }, { type: "string", enum: ["stdout", "stderr", "both", "rows", "ndjson", "jsonl"] }],
-    },
-    tail: { anyOf: [{ type: "string" }, { type: "number" }] },
-    envSet: { type: "array", items: { type: "string" } },
-    envClear: { type: "array", items: { type: "string" } },
-    sharedHostSafe: { type: "boolean" },
-    detail: { type: "string", enum: ["summary", "deep"] },
-    trace: { type: "boolean" },
-    reload: { type: "boolean" },
-    watch: { type: "boolean" },
-    runtimeProbe: { type: "boolean" },
-    fixManagedState: { type: "boolean" },
-    pmContext: { type: "string", enum: ["schema", "tracker", "auto"] },
-    overrideLinkedPmContext: { type: "boolean" },
-    failOnContextMismatch: { type: "boolean" },
-    failOnSkipped: { type: "boolean" },
-    failOnEmptyTestRun: { type: "boolean" },
-    requireAssertionsForPm: { type: "boolean" },
-    checkContext: { type: "boolean" },
-    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" },
-    metadataProfile: { type: "string", enum: ["core", "strict", "custom"] },
-    checkResolution: { type: "boolean" },
-    checkLifecycle: { type: "boolean" },
-    checkStaleBlockers: { type: "boolean" },
-    dependencyCycleSeverity: { type: "string", enum: ["off", "warn", "error"] },
-    checkFiles: { type: "boolean" },
-    strictDirectories: { type: "boolean" },
-    checkOnly: { type: "boolean" },
-    checkTelemetry: { type: "boolean" },
-    noRefresh: { type: "boolean" },
-    refreshVectors: { type: "boolean" },
-    verboseStaleItems: { type: "boolean" },
-    scanMode: { type: "string", enum: ["default", "tracked-all", "tracked-all-strict"] },
-    includePmInternals: { type: "boolean" },
-    verboseFileLists: { type: "boolean" },
-    strictExit: { type: "boolean" },
-    failOnWarn: { type: "boolean" },
-    checkHistoryDrift: { type: "boolean" },
-    checkCommandReferences: { type: "boolean" },
-    allowAuditNote: { type: "boolean" },
-    allowAuditLearning: { type: "boolean" },
-    allowAuditComment: { type: "boolean" },
-    allowAuditUpdate: { type: "boolean" },
-    allowAuditDepUpdate: { type: "boolean" },
-    allowAuditRelease: { type: "boolean" },
-    dryRun: { type: "boolean" },
-    cliOnly: { type: "boolean" },
-    packagesOnly: { type: "boolean" },
-    repair: { type: "boolean" },
-    packageName: { type: "string" },
-    rollback: { type: "string" },
-    noCheckpoint: { type: "boolean" },
-    force: { type: "boolean" },
-    run: { type: "boolean" },
-    count: { type: "boolean" },
-    includeUnparented: { type: "boolean" },
-    gcScope: {
-        type: "array",
-        items: { type: "string", enum: ["index", "embeddings", "runtime"] },
-    },
-    maxDepth: { anyOf: [{ type: "string" }, { type: "number" }] },
-    collapse: { type: "string", enum: ["none", "repeated"] },
-    summary: { type: "boolean" },
-    shell: { type: "string", enum: ["bash", "zsh", "fish"] },
-    stdin: { type: "boolean" },
-    file: { type: "string" },
-    preserveSourceIds: { type: "boolean" },
-    folder: { type: "string" },
-    text: { type: "string" },
-    add: { type: "array", items: { type: "string" } },
-    addGlob: { type: "array", items: { type: "string" } },
-    remove: { type: "array", items: { type: "string" } },
-    migrate: { type: "array", items: { type: "string" } },
-    discover: { type: "boolean" },
-    apply: { type: "boolean" },
-    discoveryNote: { type: "string" },
-    appendStable: { type: "boolean" },
-    validatePaths: { type: "boolean" },
-    audit: { type: "boolean" },
-    dep: { type: "array", items: { type: "string" } },
-    depRemove: { type: "array", items: { type: "string" } },
-    replaceDeps: { type: "boolean" },
-    replaceTests: { type: "boolean" },
-    comment: { type: "array", items: { type: "string" } },
-    note: { type: "array", items: { type: "string" } },
-    learning: { type: "array", items: { type: "string" } },
-    linkedFile: { type: "array", items: { type: "string" } },
-    linkedTest: { type: "array", items: { type: "string" } },
-    doc: { type: "array", items: { type: "string" } },
-    reminder: { type: "array", items: { type: "string" } },
-    event: { type: "array", items: { type: "string" } },
-    typeOption: { type: "array", items: { type: "string" } },
-    unset: { type: "array", items: { type: "string" } },
-    clearDeps: { type: "boolean" },
-    clearComments: { type: "boolean" },
-    clearNotes: { type: "boolean" },
-    clearLearnings: { type: "boolean" },
-    clearFiles: { type: "boolean" },
-    clearTests: { type: "boolean" },
-    clearDocs: { type: "boolean" },
-    clearReminders: { type: "boolean" },
-    clearEvents: { type: "boolean" },
-    clearTypeOptions: { type: "boolean" },
-    criterion: { type: "array", items: { type: "string" } },
-    clearCriteria: { type: "boolean" },
-    groupBy: { type: "string" },
-    threshold: { anyOf: [{ type: "string" }, { type: "number" }] },
-    format: { type: "string" },
-    depth: { type: "string", enum: ["brief", "standard", "deep"] },
-    section: { type: "array", items: { type: "string", enum: ["hierarchy", "activity", "progress", "blockers", "files", "workload", "staleness", "tests"] } },
-    activityLimit: { anyOf: [{ type: "string" }, { type: "number" }] },
-    staleThreshold: { type: "string" },
-    policy: { type: "string" },
-};
 const PM_TOOL_GLOBAL_PARAMETER_KEYS = ["json", "quiet", "profile", "noExtensions", "noPager", "path", "pmExecutable", "timeoutMs"];
 function toSchemaKeyList(values) {
     return normalizeUniqueStringList(values);
@@ -1779,7 +1127,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     init: { optional: ["prefix", "preset", "defaults", "author", "agentGuidance", "withPackages"] },
     config: {
         required: ["scope", "configAction"],
-        optional: ["key", "criterion", "clearCriteria", "format", "policy"],
+        optional: ["key", "value", "criterion", "clearCriteria", "format", "policy"],
     },
     "extension-init": { required: ["target"], optional: ["scope"] },
     "extension-install": {
@@ -1889,18 +1237,27 @@ 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"], optional: ["depth", "fields"] },
+    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: [
@@ -1939,10 +1296,13 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "test",
             "doc",
             "decisionText",
+            "decision",
             "decisionRationale",
             "decisionEvidence",
             "discoveryText",
+            "discovery",
             "validationText",
+            "validation",
             "validationCommand",
             "validationExpected",
             "depth",
@@ -1960,7 +1320,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     "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"],
@@ -2085,6 +1445,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "noRefresh",
             "refreshVectors",
             "verboseStaleItems",
+            "summary",
             "skipVectors",
             "skipIntegrity",
             "skipDrift",
@@ -2103,6 +1464,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "scanMode",
             "includePmInternals",
             "verboseFileLists",
+            "verboseDiagnostics",
             "strictExit",
             "failOnWarn",
             "checkHistoryDrift",
@@ -2119,531 +1481,6 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     "close-task": { required: ["id", "text"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
 };
 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.",
-    },
-    path: {
-        description: "Optional PM data root override for this invocation.",
-        examples: [".agents/pm"],
-    },
-    scope: {
-        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: {
-        description: "Detail mode for commands that support concise and deep diagnostics.",
-        examples: ["summary", "deep"],
-    },
-    trace: {
-        description: "When true for extension-doctor, include actionable registration traces in deep diagnostics.",
-    },
-    reload: {
-        description: "When true for extension action payloads, trigger cache-busted extension module reload.",
-    },
-    watch: {
-        description: "When true for extension-reload/extension action payloads, enable watch mode semantics.",
-    },
-    runtimeProbe: {
-        description: "When true for extension-manage, run a doctor-like runtime activation probe for parity fields.",
-    },
-    fixManagedState: {
-        description: "When true for extension-manage/extension-doctor, adopt unmanaged extensions before diagnostics/update checks.",
-    },
-    target: {
-        description: "Positional target argument for the selected action (ID, source, package source, or extension name).",
-        examples: ["pm-a1b2", ".agents/pm/extensions/sample", "sample-extension"],
-    },
-    github: {
-        description: "GitHub shorthand owner/repo[/path] source for package/extension install actions.",
-        examples: ["org/repo/extensions/sample"],
-    },
-    ref: {
-        description: "Git ref/branch/tag used when installing from GitHub shorthand/URL sources.",
-        examples: ["main", "v1.0.0"],
-    },
-    cliOnly: {
-        description: "Restrict upgrade to the pm CLI/SDK npm package.",
-    },
-    packagesOnly: {
-        description: "Restrict upgrade to managed installable pm packages.",
-    },
-    repair: {
-        description: "Force npm global reinstall semantics when upgrading the pm CLI/SDK.",
-    },
-    tag: {
-        description: "npm version or dist-tag used for CLI and registry package upgrades.",
-        examples: ["latest", "next", "2026.5.11"],
-    },
-    packageName: {
-        description: "Override the pm CLI package name for self-upgrade automation and tests.",
-        examples: ["@unbrained/pm-cli"],
-    },
-    json: {
-        description: "Emit machine-readable JSON output.",
-    },
-    quiet: {
-        description: "Suppress stdout payload output.",
-    },
-    noExtensions: {
-        description: "Disable extension loading for this invocation.",
-    },
-    noPager: {
-        description: "Disable pager integration for help and long output.",
-    },
-    profile: {
-        description: "Emit deterministic timing diagnostics to stderr.",
-    },
-    timeoutMs: {
-        description: "Tool execution timeout in milliseconds.",
-        examples: [120000],
-    },
-    id: {
-        description: "Item identifier for read or mutation actions.",
-        examples: ["pm-a1b2"],
-    },
-    runId: {
-        description: "Background test run identifier.",
-        examples: ["tr-kq9x3f-93acde"],
-    },
-    title: {
-        description: "Item title text.",
-    },
-    description: {
-        description: "Item description text.",
-    },
-    type: {
-        description: "Item type name from the active runtime type registry.",
-        examples: ["Task", "Feature"],
-    },
-    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"],
-    },
-    schedulePreset: {
-        description: "Schedule-centric create preset for Reminder, Meeting, and Event types.",
-        examples: ["lightweight"],
-    },
-    status: {
-        description: "Item status value.",
-        examples: ["open", "in_progress"],
-    },
-    priority: {
-        description: "Priority value in range 0..4.",
-        examples: [0, 1, "2"],
-    },
-    order: {
-        description: "Planning order/rank value for create/update, or sort direction (asc|desc) for list-family sorting.",
-        examples: [0, 1, "2", "asc", "desc"],
-    },
-    sort: {
-        description: "List-family sort field selector.",
-        examples: ["priority", "deadline", "updated_at", "created_at", "title", "parent"],
-    },
-    tags: {
-        description: "Comma-delimited tag list.",
-        examples: ["pm-cli,agent-ux"],
-    },
-    deadline: {
-        description: "ISO/date timestamp or relative offset (+6h/+1d/+2w/+6m).",
-        examples: ["2026-04-01T00:00:00.000Z", "+1d"],
-    },
-    estimate: {
-        description: "Estimated effort in minutes.",
-        examples: [60, "120"],
-    },
-    acceptanceCriteria: {
-        description: "Acceptance criteria text.",
-    },
-    author: {
-        description: "Mutation author identity.",
-        examples: ["codex-agent"],
-    },
-    message: {
-        description: "History message for mutation audit trail.",
-    },
-    assignee: {
-        description: "Assignee identity.",
-        examples: ["codex-agent"],
-    },
-    assigneeFilter: {
-        description: "Assignee presence selector for list/calendar/context/comments-audit filters.",
-        examples: ["assigned", "unassigned"],
-    },
-    parent: {
-        description: "Parent item ID filter for hierarchical list queries.",
-        examples: ["pm-epic01"],
-    },
-    unset: {
-        description: "Repeatable list of front-matter fields to clear explicitly during create/update mutations.",
-        examples: [["deadline", "assignee"], ["close-reason"]],
-    },
-    clearDeps: {
-        description: "When true, clear linked dependencies.",
-    },
-    replaceDeps: {
-        description: "When true for update, atomically replace dependencies with the supplied --dep values.",
-    },
-    replaceTests: {
-        description: "When true for update, atomically replace linked tests with the supplied --test values.",
-    },
-    clearComments: {
-        description: "When true, clear item comments.",
-    },
-    clearNotes: {
-        description: "When true, clear item notes.",
-    },
-    clearLearnings: {
-        description: "When true, clear item learnings.",
-    },
-    clearFiles: {
-        description: "When true, clear linked files.",
-    },
-    clearTests: {
-        description: "When true, clear linked tests.",
-    },
-    clearDocs: {
-        description: "When true, clear linked docs.",
-    },
-    clearReminders: {
-        description: "When true, clear reminders.",
-    },
-    clearEvents: {
-        description: "When true, clear events.",
-    },
-    clearTypeOptions: {
-        description: "When true, clear type option metadata.",
-    },
-    clearCriteria: {
-        description: "When true for config set criteria-list keys (definition-of-done, metadata-required-fields, lifecycle pattern lists), clear the criteria list.",
-    },
-    mode: {
-        description: "Mode selector for search/reindex (keyword|semantic|hybrid) and dedupe-audit (title_exact|title_fuzzy|parent_scope).",
-        examples: ["keyword", "hybrid", "title_exact"],
-    },
-    op: {
-        description: "History operation filter for activity output.",
-        examples: ["create", "update", "close", "update_audit"],
-    },
-    fullPeriod: {
-        description: "For day/week/month calendar views, include the full anchored period instead of clipping the start to now.",
-    },
-    progress: {
-        description: "Emit progress diagnostics to stderr for long-running operations.",
-    },
-    background: {
-        description: "Run linked tests in managed background mode.",
-    },
-    envSet: {
-        description: "Repeatable runtime environment KEY=VALUE overrides for linked-test execution.",
-        examples: [["PORT=0", "PLAYWRIGHT_HTML_OPEN=never"]],
-    },
-    envClear: {
-        description: "Repeatable runtime environment variable names to clear before linked-test execution.",
-        examples: [["PLAYWRIGHT_BASE_URL"]],
-    },
-    sharedHostSafe: {
-        description: "Apply additive shared-host-safe runtime defaults during linked-test execution.",
-    },
-    pmContext: {
-        description: "PM linked-test context mode (schema keeps isolated tracker data; tracker seeds source tracker data; auto uses tracker for PM tracker-read linked commands).",
-        examples: ["schema", "tracker", "auto"],
-    },
-    overrideLinkedPmContext: {
-        description: "Force run-level --pm-context to override per-linked-test pm_context_mode metadata for all linked-test entries.",
-    },
-    failOnContextMismatch: {
-        description: "Fail linked PM command runs when source and sandbox tracker item counts differ.",
-    },
-    failOnSkipped: {
-        description: "Treat skipped linked tests as dependency-failed policy violations.",
-    },
-    failOnEmptyTestRun: {
-        description: "Treat successful linked-test commands that report zero executed tests as failures.",
-    },
-    requireAssertionsForPm: {
-        description: "Require assertion metadata for linked PM command test entries during run execution.",
-    },
-    checkContext: {
-        description: "Run linked PM command context preflight diagnostics before command execution.",
-    },
-    autoPmContext: {
-        description: "Auto-remediate PM tracker-read linked commands by routing those entries through tracker context regardless of linked-test pm_context_mode overrides.",
-    },
-    dryRun: {
-        description: "Preview command effects without mutating storage artifacts.",
-    },
-    gcScope: {
-        description: "Repeatable gc scope selector values (index, embeddings, runtime).",
-        examples: [["index", "embeddings"], ["runtime"]],
-    },
-    offset: {
-        description: "Number of matching rows to skip before limit is applied.",
-        examples: [0, 50, "100"],
-    },
-    limitItems: {
-        description: "Maximum number of filtered items to include in comments-audit output (alias: --limit).",
-        examples: [10, "25"],
-    },
-    fullHistory: {
-        description: "When true for comments-audit, export full per-item comment history rows; cannot be combined with latest.",
-    },
-    latest: {
-        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"],
-    },
-    checkMetadata: {
-        description: "Run metadata completeness checks.",
-    },
-    metadataProfile: {
-        description: "Select metadata validation profile for --check-metadata.",
-        examples: ["core", "strict", "custom"],
-    },
-    checkResolution: {
-        description: "Run closed-item resolution metadata checks.",
-    },
-    checkLifecycle: {
-        description: "Run active-item lifecycle governance drift checks.",
-    },
-    checkStaleBlockers: {
-        description: "Include stale blocker-pattern diagnostics in lifecycle checks.",
-    },
-    dependencyCycleSeverity: {
-        description: "Set dependency-cycle warning policy for lifecycle checks.",
-        examples: ["off", "warn", "error"],
-    },
-    checkFiles: {
-        description: "Run linked-file and orphaned-file checks.",
-    },
-    strictDirectories: {
-        description: "Treat optional item-type directories as required health failures.",
-    },
-    checkOnly: {
-        description: "For health action, run read-only diagnostics without refreshing vectors.",
-    },
-    checkTelemetry: {
-        description: "For health action, probe telemetry endpoint health and include network diagnostics.",
-    },
-    noRefresh: {
-        description: "For health action, skip vector refresh while still running checks.",
-    },
-    refreshVectors: {
-        description: "For health action, explicitly refresh stale vectors.",
-    },
-    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"],
-    },
-    includePmInternals: {
-        description: "Include PM storage internals in tracked-all candidate scans.",
-    },
-    verboseFileLists: {
-        description: "For validate action, include full file-path lists for --check-files details.",
-    },
-    strictExit: {
-        description: "Return non-zero exit when health/validate/extension-doctor warnings are present (ok=false).",
-    },
-    failOnWarn: {
-        description: "Alias for strictExit in health/validate/extension-doctor action payloads.",
-    },
-    checkHistoryDrift: {
-        description: "Run item/history hash drift checks.",
-    },
-    checkCommandReferences: {
-        description: "Run linked-command PM-ID reference checks.",
-    },
-    allowAuditNote: {
-        description: "For notes action, allow non-owner append-only note audits without requiring --force.",
-    },
-    allowAuditLearning: {
-        description: "For learnings action, allow non-owner append-only learning audits without requiring --force.",
-    },
-    allowAuditComment: {
-        description: "For comments action, allow non-owner append-only comment audits without requiring --force.",
-    },
-    stdin: {
-        description: "When true for comments action, read comment text from piped stdin (supports multiline markdown).",
-    },
-    file: {
-        description: "Path to input file for actions that read payload text, such as comments --file.",
-        examples: ["notes/comment.md"],
-    },
-    allowAuditUpdate: {
-        description: "Allow non-owner metadata-only update audits without requiring --force.",
-    },
-    allowAuditDepUpdate: {
-        description: "Allow non-owner append-only dependency update audits without requiring --force.",
-    },
-    allowAuditRelease: {
-        description: "Allow non-owner release handoffs that clear assignee metadata without requiring --force.",
-    },
-    preserveSourceIds: {
-        description: "Preserve explicit source IDs during Beads imports instead of normalizing to tracker prefix.",
-        examples: [true],
-    },
-    appendStable: {
-        description: "When true for files action, preserve existing linked-file order and append new links without full-array resorting.",
-    },
-    discover: {
-        description: "When true for files action, use `pm files discover <id>` to scan item text for referenced file paths.",
-    },
-    apply: {
-        description: "When true for files discovery, add missing discovered file links instead of returning a dry-run preview.",
-    },
-    discoveryNote: {
-        description: "Note attached to file links added by files discovery.",
-        examples: ["discovered from item text"],
-    },
-    stream: {
-        description: "Stream selector: test-runs logs accepts stdout|stderr|both; activity accepts boolean/rows|ndjson|jsonl for line-delimited output.",
-        examples: ["stderr", "stdout", "both", "rows", "ndjson", "jsonl", true],
-    },
-    tail: {
-        description: "Number of lines to tail for background run logs.",
-        examples: [100],
-    },
-    query: {
-        description: "Search query text for search action.",
-    },
-    keywords: {
-        description: "Alias for query in search action payloads.",
-    },
-    includeLinked: {
-        description: "Include readable linked docs/files/tests content in keyword and hybrid lexical scoring.",
-    },
-    titleExact: {
-        description: "For search action, require exact normalized title match for the full query string.",
-    },
-    phraseExact: {
-        description: "For search action, require exact normalized query phrase match in item text fields.",
-    },
-    includeBody: {
-        description: "When true for list-family actions, include item body text in projected rows.",
-    },
-    compact: {
-        description: "Render compact projection output for search and list-family actions.",
-    },
-    full: {
-        description: "Render full nested search hit payload output.",
-    },
-    fields: {
-        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).",
-        examples: ["parent,type", "type,status", "priority,assignee", "tags", "sprint,release"],
-    },
-    count: {
-        description: "Enable grouped count output for aggregate action.",
-    },
-    includeUnparented: {
-        description: "Include unparented rows when aggregate grouping includes parent.",
-    },
-    maxDepth: {
-        description: "Maximum dependency traversal depth for deps action (0 keeps only the root node).",
-        examples: [0, 1, "2"],
-    },
-    collapse: {
-        description: 'Dependency tree collapse mode for deps action ("none" or "repeated").',
-        examples: ["none", "repeated"],
-    },
-    summary: {
-        description: "When true for deps action, return counts only without full tree/graph payloads.",
-    },
-    threshold: {
-        description: "Dedupe-audit fuzzy title similarity threshold between 0 and 1.",
-        examples: [0.5, "0.75"],
-    },
-    shell: {
-        description: "Shell target for completion generation.",
-        examples: ["bash"],
-    },
-    eagerTags: {
-        description: "When true for completion, eagerly embed current tracker tags into generated scripts (legacy mode).",
-    },
-    contractAction: {
-        description: "Filter contracts schema to one tool action.",
-        examples: ["create", "update"],
-    },
-    command: {
-        description: "Scope contracts output to one CLI command name; action/schema surfaces narrow by default.",
-        examples: ["create", "search", "list"],
-    },
-    schemaOnly: {
-        description: "When true, contracts action returns schema-focused payloads (mutually exclusive with flagsOnly/availabilityOnly).",
-    },
-    flagsOnly: {
-        description: "When true, contracts action returns only command flag surface payloads (mutually exclusive projection mode).",
-    },
-    availabilityOnly: {
-        description: "When true, contracts action returns only action availability payloads (mutually exclusive projection mode).",
-    },
-    runtimeOnly: {
-        description: "When true, contracts action only includes actions invocable in the current runtime.",
-    },
-    activeOnly: {
-        description: "Alias for runtimeOnly in contracts action payloads.",
-    },
-    depth: {
-        description: "Context depth level controlling how many sections are included (brief=focus+agenda, standard=+hierarchy/activity/progress/workload, deep=all sections).",
-        examples: ["brief", "standard", "deep"],
-    },
-    section: {
-        description: "Repeatable section selector for context; overrides --depth when provided.",
-        examples: [["hierarchy", "activity"], ["blockers", "files", "staleness"]],
-    },
-    activityLimit: {
-        description: "Maximum number of recent activity entries to include in context output.",
-        examples: [5, 10, "20"],
-    },
-    staleThreshold: {
-        description: "Staleness cutoff in days for context staleness section (e.g. 7 or 7d).",
-        examples: ["7", "14d", "30"],
-    },
-};
 function fallbackToolParameterDescription(key) {
     return key
         .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
@@ -2661,6 +1498,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 ?? []);
@@ -2676,9 +1534,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 = {
@@ -2749,4 +1607,4 @@ function buildProviderCompatibleToolSchema() {
 }
 export const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = buildProviderCompatibleToolSchema();
 //# sourceMappingURL=cli-contracts.js.map
-//# debugId=4e7e9e79-ece5-54e2-883e-5ef16db5152b
+//# debugId=b61aadc4-20d4-50e8-83f0-095c541132f2