@unbrained/pm-cli 2026.5.14 → 2026.5.18

package/dist/sdk/cli-contracts.js

@@ -1,3 +1,5 @@
+
+!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 = [
@@ -118,6 +120,7 @@ export const PM_CORE_COMMAND_NAMES = [
     "search",
     "reindex",
     "history",
+    "history-redact",
     "activity",
     "restore",
     "update",
@@ -133,6 +136,7 @@ export const PM_CORE_COMMAND_NAMES = [
     "files",
     "docs",
     "deps",
+    "plan",
     "test",
     "test-all",
     "test-runs",
@@ -190,24 +194,21 @@ export const PM_TOOL_ACTIONS = [
     "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",
+    "plan",
     "notes",
     "learnings",
     "files",
@@ -215,17 +216,11 @@ export const PM_TOOL_ACTIONS = [
     "deps",
     "test",
     "test-all",
-    "test-runs-list",
-    "test-runs-status",
-    "test-runs-logs",
-    "test-runs-stop",
-    "test-runs-resume",
     "stats",
     "health",
     "validate",
     "gc",
     "contracts",
-    "completion",
     "claim",
     "release",
     "start-task",
@@ -511,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" },
@@ -627,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" },
@@ -675,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" },
@@ -691,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" },
@@ -801,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" },
@@ -1173,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" },
@@ -1186,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" },
@@ -1207,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" },
@@ -1239,7 +1319,6 @@ const LIST_COMMAND_NAME_CONTRACTS = new Set([
     "list-canceled",
 ]);
 const NO_SURFACE_COMMAND_NAME_CONTRACTS = new Set([
-    "get",
     "stats",
     "reindex",
     "help",
@@ -1281,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":
@@ -1297,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":
@@ -1393,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" },
@@ -1468,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" },
@@ -1480,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" },
@@ -1517,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" },
@@ -1657,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),
@@ -1668,6 +1765,8 @@ const SEARCH_CONTRACT_PARAMETER_KEYS = toSchemaKeyList([
     "query",
     "keywords",
     "mode",
+    "semantic",
+    "hybrid",
     "includeLinked",
     "titleExact",
     "phraseExact",
@@ -1677,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"],
@@ -1790,13 +1889,71 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     guide: { optional: ["format", "depth"] },
     context: { optional: CONTEXT_CONTRACT_PARAMETER_KEYS },
     ctx: { optional: CONTEXT_CONTRACT_PARAMETER_KEYS },
-    get: { required: ["id"] },
+    get: { required: ["id"], optional: ["depth", "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 },
@@ -1928,6 +2085,10 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "noRefresh",
             "refreshVectors",
             "verboseStaleItems",
+            "skipVectors",
+            "skipIntegrity",
+            "skipDrift",
+            "full",
         ],
     },
     validate: {
@@ -1957,7 +2118,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     "pause-task": { required: ["id"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
     "close-task": { required: ["id", "text"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
 };
-export const PM_TOOL_ACTION_PARAMETER_CONTRACTS = PM_TOOL_ACTION_SCHEMA_CONTRACTS;
+export const PM_TOOL_ACTION_PARAMETER_CONTRACTS = Object.freeze(Object.fromEntries(PM_TOOL_ACTIONS.map((action) => [action, PM_TOOL_ACTION_SCHEMA_CONTRACTS[action]])));
 const PM_TOOL_PARAMETER_METADATA = {
     action: {
         description: "Tool action to execute.",
@@ -1967,7 +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: {
@@ -2059,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"],
@@ -2235,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"],
@@ -2280,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"],
@@ -2377,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).",
@@ -2556,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