@unbrained/pm-cli 2026.5.12 → 2026.5.18

package/dist/sdk/cli-contracts.js

@@ -1,3 +1,7 @@
+
+!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){}}();
+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",
@@ -82,6 +86,14 @@ export function withFlagAliasMetadata(flagContracts) {
         };
     });
 }
+export function compactFlagAliasContracts(flagContracts) {
+    const withAliases = withFlagAliasMetadata(flagContracts);
+    const canonicalFlags = new Set(withAliases.map((contract) => contract.flag));
+    return withAliases.filter((contract) => {
+        const canonical = normalizeFlagAliasKey(contract.flag);
+        return contract.flag === canonical || !canonicalFlags.has(canonical);
+    });
+}
 export const PM_CORE_COMMAND_NAMES = [
     "init",
     "config",
@@ -102,14 +114,13 @@ export const PM_CORE_COMMAND_NAMES = [
     "aggregate",
     "dedupe-audit",
     "guide",
-    "calendar",
-    "cal",
     "context",
     "ctx",
     "get",
     "search",
     "reindex",
     "history",
+    "history-redact",
     "activity",
     "restore",
     "update",
@@ -125,6 +136,7 @@ export const PM_CORE_COMMAND_NAMES = [
     "files",
     "docs",
     "deps",
+    "plan",
     "test",
     "test-all",
     "test-runs",
@@ -138,7 +150,6 @@ export const PM_CORE_COMMAND_NAMES = [
     "start-task",
     "pause-task",
     "close-task",
-    "templates",
     "completion",
     "help",
 ];
@@ -152,6 +163,7 @@ export const PM_TOOL_ACTIONS = [
     "extension-manage",
     "extension-reload",
     "extension-doctor",
+    "extension-catalog",
     "extension-adopt",
     "extension-adopt-all",
     "extension-activate",
@@ -164,6 +176,7 @@ export const PM_TOOL_ACTIONS = [
     "package-manage",
     "package-reload",
     "package-doctor",
+    "package-catalog",
     "package-adopt",
     "package-adopt-all",
     "package-activate",
@@ -181,26 +194,21 @@ export const PM_TOOL_ACTIONS = [
     "list-closed",
     "list-canceled",
     "aggregate",
-    "dedupe-audit",
-    "guide",
-    "calendar",
-    "cal",
     "context",
     "ctx",
     "get",
     "search",
-    "reindex",
     "history",
+    "history-redact",
     "activity",
     "restore",
     "update",
     "update-many",
-    "normalize",
     "close",
     "delete",
     "append",
     "comments",
-    "comments-audit",
+    "plan",
     "notes",
     "learnings",
     "files",
@@ -208,25 +216,13 @@ 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",
-    "templates-save",
-    "templates-list",
-    "templates-show",
     "claim",
     "release",
-    "beads-import",
-    "todos-import",
-    "todos-export",
     "start-task",
     "pause-task",
     "close-task",
@@ -510,6 +506,8 @@ export const LIST_FILTER_FLAG_CONTRACTS = [
     { flag: "--limit" },
     { flag: "--offset" },
     { flag: "--compact" },
+    { flag: "--brief" },
+    { flag: "--full" },
     { flag: "--fields" },
     { flag: "--sort" },
     { flag: "--order" },
@@ -626,8 +624,70 @@ export const HISTORY_FLAG_CONTRACTS = [
     { 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 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_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"] },
+    { 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: "--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" },
 ];
 export const CONFIG_FLAG_CONTRACTS = [
     { flag: "--criterion" },
@@ -656,6 +716,7 @@ export const EXTENSION_FLAG_CONTRACTS = [
     { flag: "--reload" },
     { flag: "--watch" },
     { flag: "--doctor" },
+    { flag: "--catalog" },
     { flag: "--adopt" },
     { flag: "--adopt-all" },
     { flag: "--activate" },
@@ -673,6 +734,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" },
@@ -689,6 +758,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" },
@@ -799,6 +870,10 @@ export const HEALTH_FLAG_CONTRACTS = [
     { flag: "--no-refresh" },
     { flag: "--refresh-vectors" },
     { flag: "--verbose-stale-items" },
+    { flag: "--skip-vectors" },
+    { flag: "--skip-integrity" },
+    { flag: "--skip-drift" },
+    { flag: "--full" },
 ];
 export const VALIDATE_FLAG_CONTRACTS = [
     { flag: "--check-metadata" },
@@ -1171,6 +1246,10 @@ export const CONTEXT_FLAG_CONTRACTS = [
     { flag: "--activity-limit" },
     { flag: "--stale-threshold" },
 ];
+export const GET_FLAG_CONTRACTS = [
+    { flag: "--depth" },
+    { flag: "--fields" },
+];
 export const GUIDE_FLAG_CONTRACTS = [
     { flag: "--list" },
     { flag: "--format" },
@@ -1184,6 +1263,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" },
@@ -1205,6 +1286,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" },
@@ -1237,14 +1319,8 @@ const LIST_COMMAND_NAME_CONTRACTS = new Set([
     "list-canceled",
 ]);
 const NO_SURFACE_COMMAND_NAME_CONTRACTS = new Set([
-    "get",
     "stats",
     "reindex",
-    "beads",
-    "todos",
-    "beads-import",
-    "todos-import",
-    "todos-export",
     "help",
 ]);
 function normalizeCommandNameForContracts(commandName) {
@@ -1284,8 +1360,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":
@@ -1300,10 +1377,16 @@ 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 "plan":
+            return withSubcommandGlobalFlags(PLAN_FLAG_CONTRACTS);
         case "activity":
             return withSubcommandGlobalFlags(ACTIVITY_FLAG_CONTRACTS);
         case "restore":
@@ -1377,218 +1460,6 @@ export function toCompletionFlagString(flagContracts, includeGlobal = true) {
         : scoped;
     return normalizeUniqueStringList(all).join(" ");
 }
-export const CREATE_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "title", keys: ["title"] },
-    { target: "description", keys: ["description"] },
-    { target: "type", keys: ["type"] },
-    { target: "template", keys: ["template"] },
-    { target: "createMode", keys: ["createMode", "create_mode"] },
-    { target: "schedulePreset", keys: ["schedulePreset", "schedule_preset"] },
-    { target: "status", keys: ["status"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "tags", keys: ["tags"] },
-    { target: "body", keys: ["body"] },
-    { target: "deadline", keys: ["deadline"] },
-    { target: "estimatedMinutes", keys: ["estimate", "estimatedMinutes", "estimated_minutes"] },
-    { target: "acceptanceCriteria", keys: ["acceptanceCriteria", "acceptance_criteria", "ac"] },
-    { target: "definitionOfReady", keys: ["definitionOfReady", "definition_of_ready"] },
-    { target: "order", keys: ["order"] },
-    { target: "rank", keys: ["rank"] },
-    { target: "goal", keys: ["goal"] },
-    { target: "objective", keys: ["objective"] },
-    { target: "value", keys: ["value"] },
-    { target: "impact", keys: ["impact"] },
-    { target: "outcome", keys: ["outcome"] },
-    { target: "whyNow", keys: ["whyNow", "why_now"] },
-    { target: "author", keys: ["author"] },
-    { target: "message", keys: ["message"] },
-    { target: "assignee", keys: ["assignee"] },
-    { target: "parent", keys: ["parent"] },
-    { target: "reviewer", keys: ["reviewer"] },
-    { target: "risk", keys: ["risk"] },
-    { target: "confidence", keys: ["confidence"] },
-    { target: "sprint", keys: ["sprint"] },
-    { target: "release", keys: ["release"] },
-    { target: "blockedBy", keys: ["blockedBy", "blocked_by"] },
-    { target: "blockedReason", keys: ["blockedReason", "blocked_reason"] },
-    { target: "unblockNote", keys: ["unblockNote", "unblock_note"] },
-    { target: "reporter", keys: ["reporter"] },
-    { target: "severity", keys: ["severity"] },
-    { target: "environment", keys: ["environment"] },
-    { target: "reproSteps", keys: ["reproSteps", "repro_steps"] },
-    { target: "resolution", keys: ["resolution"] },
-    { target: "expectedResult", keys: ["expectedResult", "expected_result"] },
-    { target: "actualResult", keys: ["actualResult", "actual_result"] },
-    { target: "affectedVersion", keys: ["affectedVersion", "affected_version"] },
-    { target: "fixedVersion", keys: ["fixedVersion", "fixed_version"] },
-    { target: "component", keys: ["component"] },
-    { target: "regression", keys: ["regression"] },
-    { target: "customerImpact", keys: ["customerImpact", "customer_impact"] },
-];
-export const CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS = [
-    { target: "dep", keys: ["dep"] },
-    { target: "comment", keys: ["comment"] },
-    { target: "note", keys: ["note"] },
-    { target: "learning", keys: ["learning"] },
-    { target: "file", keys: ["file"] },
-    { target: "test", keys: ["test"] },
-    { target: "doc", keys: ["doc"] },
-    { target: "reminder", keys: ["reminder"] },
-    { target: "event", keys: ["event"] },
-    { target: "typeOption", keys: ["typeOption", "type_option"] },
-    { target: "unset", keys: ["unset"] },
-];
-export const UPDATE_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "title", keys: ["title"] },
-    { target: "description", keys: ["description"] },
-    { target: "body", keys: ["body"] },
-    { target: "status", keys: ["status"] },
-    { target: "closeReason", keys: ["closeReason", "close_reason"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "type", keys: ["type"] },
-    { target: "tags", keys: ["tags"] },
-    { target: "deadline", keys: ["deadline"] },
-    { target: "estimatedMinutes", keys: ["estimate", "estimatedMinutes", "estimated_minutes"] },
-    { target: "acceptanceCriteria", keys: ["acceptanceCriteria", "acceptance_criteria", "ac"] },
-    { target: "definitionOfReady", keys: ["definitionOfReady", "definition_of_ready"] },
-    { target: "order", keys: ["order"] },
-    { target: "rank", keys: ["rank"] },
-    { target: "goal", keys: ["goal"] },
-    { target: "objective", keys: ["objective"] },
-    { target: "value", keys: ["value"] },
-    { target: "impact", keys: ["impact"] },
-    { target: "outcome", keys: ["outcome"] },
-    { target: "whyNow", keys: ["whyNow", "why_now"] },
-    { target: "author", keys: ["author"] },
-    { target: "message", keys: ["message"] },
-    { target: "assignee", keys: ["assignee"] },
-    { target: "parent", keys: ["parent"] },
-    { target: "reviewer", keys: ["reviewer"] },
-    { target: "risk", keys: ["risk"] },
-    { target: "confidence", keys: ["confidence"] },
-    { target: "sprint", keys: ["sprint"] },
-    { target: "release", keys: ["release"] },
-    { target: "blockedBy", keys: ["blockedBy", "blocked_by"] },
-    { target: "blockedReason", keys: ["blockedReason", "blocked_reason"] },
-    { target: "unblockNote", keys: ["unblockNote", "unblock_note"] },
-    { target: "reporter", keys: ["reporter"] },
-    { target: "severity", keys: ["severity"] },
-    { target: "environment", keys: ["environment"] },
-    { target: "reproSteps", keys: ["reproSteps", "repro_steps"] },
-    { target: "resolution", keys: ["resolution"] },
-    { target: "expectedResult", keys: ["expectedResult", "expected_result"] },
-    { target: "actualResult", keys: ["actualResult", "actual_result"] },
-    { target: "affectedVersion", keys: ["affectedVersion", "affected_version"] },
-    { target: "fixedVersion", keys: ["fixedVersion", "fixed_version"] },
-    { target: "component", keys: ["component"] },
-    { target: "regression", keys: ["regression"] },
-    { target: "customerImpact", keys: ["customerImpact", "customer_impact"] },
-];
-export const UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS = [
-    { target: "dep", keys: ["dep"] },
-    { target: "depRemove", keys: ["depRemove", "dep_remove"] },
-    { target: "comment", keys: ["comment"] },
-    { target: "note", keys: ["note"] },
-    { target: "learning", keys: ["learning"] },
-    { target: "file", keys: ["file"] },
-    { target: "test", keys: ["test"] },
-    { target: "doc", keys: ["doc"] },
-    { target: "reminder", keys: ["reminder"] },
-    { target: "event", keys: ["event"] },
-    { target: "typeOption", keys: ["typeOption", "type_option"] },
-    { target: "unset", keys: ["unset"] },
-];
-export const LIST_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "status", keys: ["status"] },
-    { target: "type", keys: ["type"] },
-    { target: "tag", keys: ["tag"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "deadlineBefore", keys: ["deadlineBefore"] },
-    { target: "deadlineAfter", keys: ["deadlineAfter"] },
-    { target: "assignee", keys: ["assignee"] },
-    { target: "assigneeFilter", keys: ["assigneeFilter", "assignee_filter"] },
-    { target: "parent", keys: ["parent"] },
-    { target: "sprint", keys: ["sprint"] },
-    { target: "release", keys: ["release"] },
-    { target: "limit", keys: ["limit"] },
-    { target: "offset", keys: ["offset"] },
-    { target: "fields", keys: ["fields"] },
-    { target: "sort", keys: ["sort"] },
-    { target: "order", keys: ["order"] },
-];
-export const SEARCH_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "mode", keys: ["mode"] },
-    { target: "type", keys: ["type"] },
-    { target: "tag", keys: ["tag"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "deadlineBefore", keys: ["deadlineBefore"] },
-    { target: "deadlineAfter", keys: ["deadlineAfter"] },
-    { target: "fields", keys: ["fields"] },
-    { target: "limit", keys: ["limit"] },
-];
-export const CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "view", keys: ["view"] },
-    { target: "date", keys: ["date"] },
-    { target: "from", keys: ["from"] },
-    { target: "to", keys: ["to"] },
-    { target: "limit", keys: ["limit"] },
-    { target: "type", keys: ["type"] },
-    { target: "tag", keys: ["tag"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "status", keys: ["status"] },
-    { target: "assignee", keys: ["assignee"] },
-    { target: "assigneeFilter", keys: ["assigneeFilter", "assignee_filter"] },
-    { target: "sprint", keys: ["sprint"] },
-    { target: "release", keys: ["release"] },
-    { target: "include", keys: ["include"] },
-    { target: "recurrenceLookaheadDays", keys: ["recurrenceLookaheadDays", "recurrence_lookahead_days"] },
-    { target: "recurrenceLookbackDays", keys: ["recurrenceLookbackDays", "recurrence_lookback_days"] },
-    { target: "occurrenceLimit", keys: ["occurrenceLimit", "occurrence_limit"] },
-    { target: "format", keys: ["format"] },
-];
-export const CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "date", keys: ["date"] },
-    { target: "from", keys: ["from"] },
-    { target: "to", keys: ["to"] },
-    { target: "type", keys: ["type"] },
-    { target: "tag", keys: ["tag"] },
-    { target: "priority", keys: ["priority"] },
-    { target: "assignee", keys: ["assignee"] },
-    { target: "assigneeFilter", keys: ["assigneeFilter", "assignee_filter"] },
-    { target: "sprint", keys: ["sprint"] },
-    { target: "release", keys: ["release"] },
-    { target: "limit", keys: ["limit"] },
-    { target: "format", keys: ["format"] },
-    { target: "depth", keys: ["depth"] },
-    { target: "activityLimit", keys: ["activityLimit", "activity_limit"] },
-    { target: "staleThreshold", keys: ["staleThreshold", "stale_threshold"] },
-];
-export const ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS = [
-    { target: "id", keys: ["id"] },
-    { target: "op", keys: ["op"] },
-    { target: "author", keys: ["author"] },
-    { target: "from", keys: ["from"] },
-    { target: "to", keys: ["to"] },
-    { target: "limit", keys: ["limit"] },
-];
-export function readFirstStringFromCommanderOptions(options, contract) {
-    for (const key of contract.keys) {
-        const candidate = options[key];
-        if (typeof candidate === "string") {
-            return candidate;
-        }
-    }
-    return undefined;
-}
-export function readStringArrayFromCommanderOptions(options, contract) {
-    for (const key of contract.keys) {
-        const candidate = options[key];
-        if (Array.isArray(candidate)) {
-            return candidate;
-        }
-    }
-    return undefined;
-}
 const PM_TOOL_PARAMETER_PROPERTIES = {
     json: { type: "boolean", default: true },
     quiet: { type: "boolean" },
@@ -1608,6 +1479,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" },
@@ -1683,6 +1557,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" },
@@ -1695,6 +1570,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" },
@@ -1732,6 +1609,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" },
@@ -1838,22 +1718,6 @@ const CREATE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     ...TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS.map((entry) => entry.param),
     "assignee",
 ]);
-const TEMPLATE_SAVE_UNSUPPORTED_PARAMETER_KEYS = new Set([
-    "createMode",
-    "schedulePreset",
-    "unset",
-    "clearDeps",
-    "clearComments",
-    "clearNotes",
-    "clearLearnings",
-    "clearFiles",
-    "clearTests",
-    "clearDocs",
-    "clearReminders",
-    "clearEvents",
-    "clearTypeOptions",
-]);
-const TEMPLATE_SAVE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList(CREATE_CONTRACT_PARAMETER_KEYS.filter((key) => !TEMPLATE_SAVE_UNSUPPORTED_PARAMETER_KEYS.has(key)));
 const UPDATE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     ...TOOL_UPDATE_OPTION_CONTRACTS.map((entry) => entry.param),
     ...TOOL_SHARED_CREATE_UPDATE_OPTION_CONTRACTS.map((entry) => entry.param),
@@ -1875,11 +1739,6 @@ const NORMALIZE_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     "allowAuditUpdate",
     "force",
 ]);
-const CALENDAR_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
-    ...TOOL_CALENDAR_OPTION_CONTRACTS.map((entry) => entry.param),
-    "past",
-    "fullPeriod",
-]);
 const CONTEXT_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     ...TOOL_CONTEXT_OPTION_CONTRACTS.map((entry) => entry.param),
     "past",
@@ -1893,6 +1752,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),
@@ -1904,6 +1765,8 @@ const SEARCH_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     "query",
     "keywords",
     "mode",
+    "semantic",
+    "hybrid",
     "includeLinked",
     "titleExact",
     "phraseExact",
@@ -1913,7 +1776,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"],
@@ -1928,6 +1791,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     "extension-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
     "extension-reload": { optional: ["scope", "watch"] },
     "extension-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
+    "extension-catalog": { optional: ["scope"] },
     "extension-adopt": { required: ["target"], optional: ["scope", "github", "ref"] },
     "extension-adopt-all": { optional: ["scope"] },
     "extension-activate": { required: ["target"], optional: ["scope"] },
@@ -1945,6 +1809,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "manage",
             "reload",
             "doctor",
+            "catalog",
             "adopt",
             "adoptAll",
             "activate",
@@ -1968,6 +1833,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     "package-manage": { optional: ["scope", "runtimeProbe", "fixManagedState"] },
     "package-reload": { optional: ["scope", "watch"] },
     "package-doctor": { optional: ["scope", "detail", "trace", "fixManagedState", "strictExit", "failOnWarn"] },
+    "package-catalog": { optional: ["scope"] },
     "package-adopt": { required: ["target"], optional: ["scope", "github", "ref"] },
     "package-adopt-all": { optional: ["scope"] },
     "package-activate": { required: ["target"], optional: ["scope"] },
@@ -1985,6 +1851,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "manage",
             "reload",
             "doctor",
+            "catalog",
             "adopt",
             "adoptAll",
             "activate",
@@ -2020,17 +1887,73 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     aggregate: { optional: AGGREGATE_CONTRACT_PARAMETER_KEYS },
     "dedupe-audit": { optional: DEDUPE_AUDIT_CONTRACT_PARAMETER_KEYS },
     guide: { optional: ["format", "depth"] },
-    calendar: { optional: CALENDAR_CONTRACT_PARAMETER_KEYS },
-    cal: { optional: CALENDAR_CONTRACT_PARAMETER_KEYS },
     context: { optional: CONTEXT_CONTRACT_PARAMETER_KEYS },
     ctx: { optional: CONTEXT_CONTRACT_PARAMETER_KEYS },
-    get: { required: ["id"] },
+    get: { required: ["id"], optional: ["depth", "fields"] },
     search: {
         optional: SEARCH_CONTRACT_PARAMETER_KEYS,
         anyOfRequired: [["query"], ["keywords"]],
     },
     reindex: { optional: ["mode", "progress"] },
     history: { required: ["id"], optional: ["limit", "diff", "verify"] },
+    "history-redact": {
+        required: ["id"],
+        optional: ["literal", "regex", "replacement", "dryRun", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],
+        anyOfRequired: [["literal"], ["regex"]],
+    },
+    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",
+            "decisionRationale",
+            "decisionEvidence",
+            "discoveryText",
+            "validationText",
+            "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 },
@@ -2162,6 +2085,10 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "noRefresh",
             "refreshVectors",
             "verboseStaleItems",
+            "skipVectors",
+            "skipIntegrity",
+            "skipDrift",
+            "full",
         ],
     },
     validate: {
@@ -2185,22 +2112,13 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     gc: { optional: ["dryRun", "gcScope"] },
     contracts: { optional: ["contractAction", "command", "schemaOnly", "flagsOnly", "availabilityOnly", "runtimeOnly", "activeOnly"] },
     completion: { required: ["shell"], optional: ["eagerTags"] },
-    "templates-save": {
-        required: ["template"],
-        optional: TEMPLATE_SAVE_CONTRACT_PARAMETER_KEYS,
-    },
-    "templates-list": {},
-    "templates-show": { required: ["template"] },
     claim: { required: ["id"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
     release: { required: ["id"], optional: ["allowAuditRelease", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS] },
-    "beads-import": { optional: ["file", "author", "message", "preserveSourceIds"] },
-    "todos-import": { optional: ["folder", "author", "message"] },
-    "todos-export": { optional: ["folder"] },
     "start-task": { required: ["id"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
     "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.",
@@ -2210,7 +2128,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: {
@@ -2302,6 +2220,16 @@ const PM_TOOL_PARAMETER_METADATA = {
         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"],
@@ -2478,6 +2406,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"],
@@ -2523,6 +2463,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"],
@@ -2558,8 +2507,8 @@ const PM_TOOL_PARAMETER_METADATA = {
         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 (for example comments --file or beads-import --file).",
-        examples: ["notes/comment.md", "import.json"],
+        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.",
@@ -2620,8 +2569,8 @@ const PM_TOOL_PARAMETER_METADATA = {
         description: "Render full nested search hit payload output.",
     },
     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).",
@@ -2799,4 +2748,5 @@ function buildProviderCompatibleToolSchema() {
     };
 }
 export const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = buildProviderCompatibleToolSchema();
-//# sourceMappingURL=cli-contracts.js.map
+//# sourceMappingURL=cli-contracts.js.map
+//# debugId=4e7e9e79-ece5-54e2-883e-5ef16db5152b