@unbrained/pm-cli 2026.5.18 → 2026.5.24

package/dist/sdk/cli-contracts.js

@@ -1,7 +1,8 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="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]="b7c80b7e-7951-5ab0-ab77-8e309cf59f0d")}catch(e){}}();
 export { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "./cli-contracts/commander-types.js";
 export { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, } from "./cli-contracts/commander-mutation-options.js";
+import { PLAN_HARNESS_VALUES, PLAN_MODE_VALUES, PLAN_STEP_LINK_KIND_VALUES, PLAN_STEP_STATUS_VALUES, } from "../types/index.js";
 export const PM_EXTENSION_CAPABILITY_CONTRACTS = [
     "commands",
     "renderers",
@@ -121,6 +122,8 @@ export const PM_CORE_COMMAND_NAMES = [
     "reindex",
     "history",
     "history-redact",
+    "history-repair",
+    "schema",
     "activity",
     "restore",
     "update",
@@ -200,6 +203,8 @@ export const PM_TOOL_ACTIONS = [
     "search",
     "history",
     "history-redact",
+    "history-repair",
+    "schema",
     "activity",
     "restore",
     "update",
@@ -243,6 +248,7 @@ export function isPmExtensionPolicySurfaceContract(value) {
     return PM_EXTENSION_POLICY_SURFACE_CONTRACTS.includes(value);
 }
 export const TOOL_LIST_FILTER_OPTION_CONTRACTS = [
+    { param: "status", flag: "--status" },
     { param: "type", flag: "--type" },
     { param: "tag", flag: "--tag" },
     { param: "priority", flag: "--priority" },
@@ -453,6 +459,8 @@ export const TOOL_ACTIVITY_OPTION_CONTRACTS = [
     { param: "from", flag: "--from" },
     { param: "to", flag: "--to" },
     { param: "limit", flag: "--limit" },
+    { param: "compact", flag: "--compact" },
+    { param: "full", flag: "--full" },
 ];
 export const TOOL_CONTEXT_OPTION_CONTRACTS = [
     { param: "date", flag: "--date" },
@@ -492,6 +500,7 @@ export const GLOBAL_FLAG_CONTRACTS = [
     { flag: "--version" },
 ];
 export const LIST_FILTER_FLAG_CONTRACTS = [
+    { flag: "--status" },
     { flag: "--type" },
     { flag: "--tag" },
     { flag: "--priority" },
@@ -621,6 +630,8 @@ export const DOCS_FLAG_CONTRACTS = [
 ];
 export const HISTORY_FLAG_CONTRACTS = [
     { flag: "--limit" },
+    { flag: "--compact" },
+    { flag: "--full" },
     { flag: "--diff" },
     { flag: "--verify" },
 ];
@@ -633,6 +644,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" },
@@ -649,7 +674,7 @@ export const PLAN_FLAG_CONTRACTS = [
     { 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,11 +690,11 @@ 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" },
@@ -688,6 +713,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 +738,7 @@ export const EXTENSION_FLAG_CONTRACTS = [
     { flag: "--install" },
     { flag: "--uninstall" },
     { flag: "--explore" },
+    { flag: "--list" },
     { flag: "--manage" },
     { flag: "--reload" },
     { flag: "--watch" },
@@ -782,6 +809,7 @@ export const RESTORE_FLAG_CONTRACTS = [
     { flag: "--force" },
 ];
 export const DELETE_FLAG_CONTRACTS = [
+    { flag: "--dry-run" },
     { flag: "--author" },
     { flag: "--message" },
     { flag: "--force" },
@@ -870,6 +898,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 +916,7 @@ export const VALIDATE_FLAG_CONTRACTS = [
     { flag: "--scan-mode" },
     { flag: "--include-pm-internals" },
     { flag: "--verbose-file-lists" },
+    { flag: "--verbose-diagnostics" },
     { flag: "--strict-exit" },
     { flag: "--fail-on-warn" },
     { flag: "--check-history-drift" },
@@ -1224,6 +1255,8 @@ export const ACTIVITY_FLAG_CONTRACTS = [
     { flag: "--from" },
     { flag: "--to" },
     { flag: "--limit" },
+    { flag: "--compact" },
+    { flag: "--full" },
     { flag: "--stream" },
 ];
 export const CONTEXT_FLAG_CONTRACTS = [
@@ -1248,6 +1281,7 @@ export const CONTEXT_FLAG_CONTRACTS = [
 ];
 export const GET_FLAG_CONTRACTS = [
     { flag: "--depth" },
+    { flag: "--full" },
     { flag: "--fields" },
 ];
 export const GUIDE_FLAG_CONTRACTS = [
@@ -1385,6 +1419,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":
@@ -1663,6 +1701,10 @@ const PM_TOOL_PARAMETER_PROPERTIES = {
     file: { type: "string" },
     preserveSourceIds: { type: "boolean" },
     folder: { type: "string" },
+    subcommand: { type: "string" },
+    name: { type: "string" },
+    defaultStatus: { type: "string" },
+    alias: { type: "array", items: { type: "string" } },
     text: { type: "string" },
     add: { type: "array", items: { type: "string" } },
     addGlob: { type: "array", items: { type: "string" } },
@@ -1709,6 +1751,101 @@ const PM_TOOL_PARAMETER_PROPERTIES = {
     staleThreshold: { type: "string" },
     policy: { type: "string" },
 };
+const PLAN_SUBCOMMAND_VALUES = [
+    "create",
+    "show",
+    "add-step",
+    "update-step",
+    "complete-step",
+    "block-step",
+    "reorder-step",
+    "remove-step",
+    "link",
+    "unlink",
+    "decision",
+    "discovery",
+    "validation",
+    "resume",
+    "approve",
+    "materialize",
+];
+const PLAN_ACTION_PARAMETER_PROPERTIES = {
+    subcommand: { type: "string", enum: [...PLAN_SUBCOMMAND_VALUES] },
+    stepRef: { type: "string" },
+    reorderTo: { anyOf: [{ type: "string" }, { type: "number" }] },
+    scope: { type: "string" },
+    harness: { type: "string", enum: [...PLAN_HARNESS_VALUES] },
+    mode: { type: "string", enum: [...PLAN_MODE_VALUES] },
+    resumeContext: { type: "string" },
+    related: { type: "string" },
+    blocks: { type: "string" },
+    claim: { type: "boolean" },
+    fromSearch: { type: "string" },
+    stepTitle: { type: "string" },
+    stepBody: { type: "string" },
+    stepOwner: { type: "string" },
+    stepStatus: { type: "string", enum: [...PLAN_STEP_STATUS_VALUES] },
+    stepEvidence: { type: "string" },
+    stepBlockedReason: { type: "string" },
+    stepReplacement: { type: "string" },
+    dependsOn: { type: "string" },
+    link: { type: "string" },
+    linkKind: { type: "string", enum: [...PLAN_STEP_LINK_KIND_VALUES] },
+    linkNote: { type: "string" },
+    promoteToItemDep: { type: "boolean" },
+    allowMultipleActive: { type: "boolean" },
+    file: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }] },
+    test: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }] },
+    doc: { anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }] },
+    decisionText: { type: "string" },
+    decision: { type: "string" },
+    decisionRationale: { type: "string" },
+    decisionEvidence: { type: "string" },
+    discoveryText: { type: "string" },
+    discovery: { type: "string" },
+    validationText: { type: "string" },
+    validation: { type: "string" },
+    validationCommand: { type: "string" },
+    validationExpected: { type: "string" },
+    steps: { type: "array", items: { type: "string" } },
+    materializeType: { type: "string" },
+    materializeParent: { type: "string" },
+    materializeTags: { type: "string" },
+};
+const PLAN_ACTION_PARAMETER_METADATA = {
+    subcommand: {
+        description: "Plan workflow operation to run.",
+        examples: ["create", "show", "add-step", "approve"],
+    },
+    stepRef: {
+        description: "Plan step id or order for step lifecycle subcommands.",
+        examples: ["plan-step-001", "1"],
+    },
+    reorderTo: {
+        description: "New integer order for reorder-step.",
+        examples: [1, "2"],
+    },
+    scope: {
+        description: "Short free-text scope statement describing what the Plan covers.",
+        examples: ["Release readiness audit", "Search package migration"],
+    },
+    mode: {
+        description: "Plan lifecycle mode.",
+        examples: ["draft", "research", "approved"],
+    },
+    file: {
+        description: "File link to attach while creating or materializing a Plan.",
+        examples: ["path=src/cli.ts,note=implementation surface"],
+    },
+    test: {
+        description: "Test command link to attach while creating or materializing a Plan.",
+        examples: ["command=pnpm build,timeout_seconds=300"],
+    },
+    doc: {
+        description: "Documentation link to attach while creating or materializing a Plan.",
+        examples: ["path=docs/SDK.md,note=public API reference"],
+    },
+};
 const PM_TOOL_GLOBAL_PARAMETER_KEYS = ["json", "quiet", "profile", "noExtensions", "noPager", "path", "pmExecutable", "timeoutMs"];
 function toSchemaKeyList(values) {
     return normalizeUniqueStringList(values);
@@ -1889,18 +2026,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 +2085,13 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "test",
             "doc",
             "decisionText",
+            "decision",
             "decisionRationale",
             "decisionEvidence",
             "discoveryText",
+            "discovery",
             "validationText",
+            "validation",
             "validationCommand",
             "validationExpected",
             "depth",
@@ -1960,7 +2109,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 +2234,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "noRefresh",
             "refreshVectors",
             "verboseStaleItems",
+            "summary",
             "skipVectors",
             "skipIntegrity",
             "skipDrift",
@@ -2103,6 +2253,7 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
             "scanMode",
             "includePmInternals",
             "verboseFileLists",
+            "verboseDiagnostics",
             "strictExit",
             "failOnWarn",
             "checkHistoryDrift",
@@ -2216,6 +2367,22 @@ const PM_TOOL_PARAMETER_METADATA = {
         description: "Item type name from the active runtime type registry.",
         examples: ["Task", "Feature"],
     },
+    subcommand: {
+        description: "Subcommand for the schema action.",
+        examples: ["add-type"],
+    },
+    name: {
+        description: "Custom item type name to register (for schema add-type).",
+        examples: ["Spike"],
+    },
+    defaultStatus: {
+        description: "Default status hint recorded for a custom item type.",
+        examples: ["open"],
+    },
+    alias: {
+        description: "Aliases for the custom item type (repeatable).",
+        examples: [["spike", "research"]],
+    },
     preset: {
         description: "Governance preset for initialization flows.",
         examples: ["minimal", "default", "strict"],
@@ -2482,8 +2649,11 @@ const PM_TOOL_PARAMETER_METADATA = {
     verboseFileLists: {
         description: "For validate action, include full file-path lists for --check-files details.",
     },
+    verboseDiagnostics: {
+        description: "For validate action, include full diagnostic ID lists instead of compact summaries.",
+    },
     strictExit: {
-        description: "Return non-zero exit when health/validate/extension-doctor warnings are present (ok=false).",
+        description: "Return non-zero exit when health/validate/extension-doctor warnings are present.",
     },
     failOnWarn: {
         description: "Alias for strictExit in health/validate/extension-doctor action payloads.",
@@ -2566,7 +2736,7 @@ const PM_TOOL_PARAMETER_METADATA = {
         description: "Render compact projection output for search and list-family actions.",
     },
     full: {
-        description: "Render full nested search hit payload output.",
+        description: "Enable command-specific full/detail output mode when supported, such as deep item reads for get or full payload mode for search/history.",
     },
     fields: {
         description: "Comma-separated projection fields for get, search, or list-family outputs.",
@@ -2661,6 +2831,27 @@ function decorateToolParameterDefinition(key, definition) {
         ...(metadata?.examples ? { examples: metadata.examples } : {}),
     };
 }
+function actionScopedToolParameterMetadata(action, key) {
+    if (action === "plan" && Object.prototype.hasOwnProperty.call(PLAN_ACTION_PARAMETER_METADATA, key)) {
+        return PLAN_ACTION_PARAMETER_METADATA[key];
+    }
+    return PM_TOOL_PARAMETER_METADATA[key];
+}
+function decorateActionScopedToolParameterDefinition(action, key, definition) {
+    const baseDefinition = typeof definition === "object" && definition !== null ? { ...definition } : {};
+    const metadata = actionScopedToolParameterMetadata(action, key);
+    return {
+        ...baseDefinition,
+        description: metadata?.description ?? fallbackToolParameterDescription(key),
+        ...(metadata?.examples ? { examples: metadata.examples } : {}),
+    };
+}
+function actionScopedToolParameterDefinition(action, key) {
+    if (action === "plan" && Object.prototype.hasOwnProperty.call(PLAN_ACTION_PARAMETER_PROPERTIES, key)) {
+        return PLAN_ACTION_PARAMETER_PROPERTIES[key];
+    }
+    return PM_TOOL_PARAMETER_PROPERTIES[key];
+}
 function buildActionScopedToolSchema(action) {
     const contract = PM_TOOL_ACTION_SCHEMA_CONTRACTS[action];
     const required = toSchemaKeyList(contract.required ?? []);
@@ -2676,9 +2867,9 @@ function buildActionScopedToolSchema(action) {
         if (key === "action") {
             continue;
         }
-        const definition = PM_TOOL_PARAMETER_PROPERTIES[key];
+        const definition = actionScopedToolParameterDefinition(action, key);
         if (definition) {
-            properties[key] = decorateToolParameterDefinition(key, definition);
+            properties[key] = decorateActionScopedToolParameterDefinition(action, key, definition);
         }
     }
     const schema = {
@@ -2749,4 +2940,4 @@ function buildProviderCompatibleToolSchema() {
 }
 export const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA = buildProviderCompatibleToolSchema();
 //# sourceMappingURL=cli-contracts.js.map
-//# debugId=4e7e9e79-ece5-54e2-883e-5ef16db5152b
+//# debugId=b7c80b7e-7951-5ab0-ab77-8e309cf59f0d