@unbrained/pm-cli 2026.7.14 → 2026.7.16

package/dist/cli-bundle/chunks/{chunk-5URI7TPJ.js → chunk-4XQ3BDV4.js}

@@ -2,7 +2,7 @@ import {
   assertHistoryRepairTarget,
   runHistoryRepair,
   runHistoryRepairAll
-} from "./chunk-RGXD5JJR.js";
+} from "./chunk-LSG2U345.js";
 import {
   resolveStartTaskInProgressStatus,
   runClaim,
@@ -16,77 +16,73 @@ import {
   runTest,
   runTestAll,
   runValidate
-} from "./chunk-IGED7NH2.js";
-import {
-  runFiles,
-  runFilesDiscover
-} from "./chunk-FS6UM5WH.js";
+} from "./chunk-ILX33QXL.js";
 import {
   runDocs
-} from "./chunk-JAF4TUQ7.js";
+} from "./chunk-ODALILG3.js";
 import {
   runDeps
-} from "./chunk-B5DZYTT3.js";
-import {
-  runComments
-} from "./chunk-KADLSPIU.js";
+} from "./chunk-BKVG6XOA.js";
 import {
   runCopy
-} from "./chunk-ERL2YFJ2.js";
+} from "./chunk-6S3YSUYG.js";
 import {
   runFocus
-} from "./chunk-KB726FMH.js";
+} from "./chunk-H2Z3FYXQ.js";
 import {
   runDelete
-} from "./chunk-TH7U4KLY.js";
+} from "./chunk-3AUGG2DP.js";
 import {
   runAppend
-} from "./chunk-IFZA4VB5.js";
+} from "./chunk-AHVTB5I5.js";
 import {
   runProfileApply,
   runProfileLint,
   runProfileList,
   runProfileShow
-} from "./chunk-PHKP3AGR.js";
+} from "./chunk-UWQHLMEB.js";
 import {
   runNotes
-} from "./chunk-655STMGA.js";
+} from "./chunk-FMBNM2EN.js";
 import {
   runLearnings
-} from "./chunk-FDSBDNYE.js";
+} from "./chunk-34L5OT3Y.js";
+import {
+  runFiles,
+  runFilesDiscover
+} from "./chunk-ZI6VQWQ7.js";
 import {
   runCloseMany
-} from "./chunk-RMF3IOYQ.js";
+} from "./chunk-FNSPG7MU.js";
 import {
   runUpdateMany
-} from "./chunk-E2WC6S4P.js";
+} from "./chunk-YBLZ2VE7.js";
 import {
   runRestore
-} from "./chunk-Q37E63AM.js";
+} from "./chunk-6CFNAVTF.js";
 import {
   runUpdate
-} from "./chunk-OBDLEQG5.js";
-import {
-  runClose
-} from "./chunk-DRNJPEPQ.js";
+} from "./chunk-CRVF2JDM.js";
 import {
   runPlan
-} from "./chunk-HLHSQ5CA.js";
+} from "./chunk-K2X6U4UA.js";
 import {
-  runHistoryCompact
-} from "./chunk-6OTZMORS.js";
+  assertHistoryCompactTarget,
+  runHistoryCompact,
+  runHistoryCompactBulk
+} from "./chunk-K3WII2ME.js";
 import {
-  runHistoryRedact
-} from "./chunk-DYEX6NFH.js";
+  runComments
+} from "./chunk-BEP7WJA2.js";
 import {
   runConfig,
   runUpgrade
-} from "./chunk-7TQMR6LK.js";
+} from "./chunk-WT3ZEOGH.js";
 import {
   SCAFFOLD_CAPABILITIES,
   runExtension,
   runInit
-} from "./chunk-4DY4KPQI.js";
+} from "./chunk-J6364LFM.js";
 import {
   runSchemaAddField,
   runSchemaAddStatus,
@@ -101,23 +97,24 @@ import {
   runSchemaShow,
   runSchemaShowField,
   runSchemaShowStatus
-} from "./chunk-5CT5BW6E.js";
+} from "./chunk-GM5QHQU6.js";
 import {
   runAggregate,
   runGet,
   runSearch
-} from "./chunk-ILLUE5DI.js";
+} from "./chunk-HYB5AZ63.js";
 import {
   runActivity,
   runContext,
+  runHistory,
   runNext
-} from "./chunk-LWTIRS3Y.js";
+} from "./chunk-E2OJMKML.js";
 import {
   runList
-} from "./chunk-6MHSBDGD.js";
+} from "./chunk-XXXF6PAQ.js";
 import {
-  runHistory
-} from "./chunk-4WREH7RT.js";
+  runHistoryRedact
+} from "./chunk-TD3LVC7D.js";
 import {
   resolveRegisteredSearchProvider,
   resolveRegisteredVectorStoreAdapter
@@ -144,7 +141,7 @@ import {
   resolveSettingsWithSemanticRuntimeDefaults,
   resolveVectorStores,
   writeVectorizationStatusLedger
-} from "./chunk-ZUKSZVBW.js";
+} from "./chunk-7B67ZL4N.js";
 import {
   ACTIVITY_FLAG_CONTRACTS,
   AGGREGATE_FLAG_CONTRACTS,
@@ -176,16 +173,19 @@ import {
   UPDATE_FLAG_CONTRACTS,
   UPDATE_MANY_FLAG_CONTRACTS,
   toCompletionFlagString
-} from "./chunk-2QIQGYPW.js";
+} from "./chunk-H5APFTHZ.js";
 import {
   runCreate
-} from "./chunk-OI4S4KCI.js";
+} from "./chunk-UMOPHQSU.js";
 import {
   parseTags
-} from "./chunk-WD6MSYMP.js";
+} from "./chunk-TKOVBP6C.js";
 import {
   projectMutationResult
-} from "./chunk-JL7WZ4O2.js";
+} from "./chunk-IG3SWA4A.js";
+import {
+  runClose
+} from "./chunk-2WSE6PO2.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -208,7 +208,7 @@ import {
   setActiveExtensionRegistrations,
   setActiveExtensionRenderers,
   setActiveExtensionServices
-} from "./chunk-T4BRCB6Z.js";
+} from "./chunk-XSJUSQAE.js";
 import {
   BUILTIN_ITEM_TYPE_VALUES,
   EXIT_CODE,
@@ -236,7 +236,7 @@ import {
   resolveRuntimeStatusRegistry,
   toNonEmptyStringOrUndefined,
   writeFileAtomic
-} from "./chunk-AFWZRL7M.js";
+} from "./chunk-BSEQUTQP.js";
 
 // dist/sdk/runtime.js
 import path3 from "node:path";
@@ -311,15 +311,126 @@ function memoizeWorkspaceExtensionRegistrations(cacheKey, loadRegistrations) {
   return registrations;
 }
 
+// dist/cli/commands/init-agent-guidance.js
+!(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] = "97c08949-302b-52cc-a5a3-9f274864c1d9");
+  } catch (e2) {
+  }
+})();
+
 // dist/cli/commands/index.js
 !(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] = "6d1b0e84-6deb-50ac-88dc-86cdeccf724f");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "a2c3675b-3c03-501f-8d2f-2405db17fabb");
   } catch (e2) {
   }
 })();
 
+// dist/sdk/runtime-input.js
+!(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] = "246cb97d-1f47-52a8-bf9a-012d5ab982c4");
+  } catch (e2) {
+  }
+})();
+function readRuntimeString(args, key) {
+  const value = args[key];
+  return typeof value === "string" && value.trim().length > 0 ? value : void 0;
+}
+function readRuntimeScalarString(args, key) {
+  const value = args[key];
+  if (typeof value === "string") {
+    return value.trim().length > 0 ? value : void 0;
+  }
+  return typeof value === "number" && Number.isFinite(value) ? String(value) : void 0;
+}
+function readRuntimeScalarStringAllowBlank(args, key) {
+  const value = args[key];
+  if (typeof value === "string") {
+    return value;
+  }
+  return typeof value === "number" && Number.isFinite(value) ? String(value) : void 0;
+}
+function isRuntimeRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function parseRuntimeInteger(value, label) {
+  if (typeof value === "number") {
+    if (!Number.isInteger(value)) {
+      throw new PmCliError(`${label} must be a finite integer.`, EXIT_CODE.USAGE);
+    }
+    return value;
+  }
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed)) {
+      throw new PmCliError(`${label} must be a finite integer.`, EXIT_CODE.USAGE);
+    }
+    return parsed;
+  }
+  return void 0;
+}
+
+// dist/sdk/history-mcp.js
+!(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] = "00e24636-c03a-5c14-a9cd-bb67ef4caf6d");
+  } catch (e2) {
+  }
+})();
+function runMcpHistoryRepairAction(context2) {
+  const repairAll = context2.options.all === true;
+  const repairId = context2.id ?? readRuntimeString(context2.options, "id");
+  assertHistoryRepairTarget(repairId, repairAll);
+  return repairAll ? runHistoryRepairAll(context2.options, context2.global) : runHistoryRepair(repairId, context2.options, context2.global);
+}
+function runMcpHistoryCompactAction(context2) {
+  const idsSource = context2.options.ids;
+  const ids = Array.isArray(idsSource) ? idsSource.map(String).filter((value) => value.trim().length > 0) : typeof idsSource === "string" ? idsSource.split(",").map((value) => value.trim()).filter(Boolean) : void 0;
+  const allOver = parseRuntimeInteger(context2.options.allOver ?? context2.options.all_over, "history-compact allOver");
+  const minEntries = parseRuntimeInteger(context2.options.minEntries ?? context2.options.min_entries, "history-compact minEntries");
+  const explicitScope = readRuntimeString(context2.options, "scope");
+  const requestedScopes = [];
+  if (context2.options.closed === true)
+    requestedScopes.push("closed");
+  if (context2.options.allStreams === true || context2.options.all_streams === true) {
+    requestedScopes.push("all-streams");
+  }
+  if (explicitScope === "closed" || explicitScope === "all-streams") {
+    requestedScopes.push(explicitScope);
+  }
+  const distinctScopes = [...new Set(requestedScopes)];
+  if (distinctScopes.length > 1) {
+    throw new PmCliError("history-compact: closed and all-streams scopes are mutually exclusive.", EXIT_CODE.USAGE);
+  }
+  const scope = distinctScopes[0];
+  assertHistoryCompactTarget(context2.id, { ids, allOver, scope });
+  if (context2.id !== void 0) {
+    return runHistoryCompact(context2.id, {
+      before: readRuntimeString(context2.options, "before"),
+      dryRun: context2.options.dryRun === true || context2.options.dry_run === true,
+      author: readRuntimeString(context2.options, "author"),
+      message: readRuntimeString(context2.options, "message"),
+      force: context2.force
+    }, context2.global);
+  }
+  return runHistoryCompactBulk({
+    ids,
+    scope,
+    allOver,
+    minEntries,
+    dryRun: context2.options.dryRun === true || context2.options.dry_run === true,
+    author: readRuntimeString(context2.options, "author"),
+    message: readRuntimeString(context2.options, "message"),
+    force: context2.force
+  }, context2.global);
+}
+
 // dist/sdk/package-runtime-options.js
 !(function() {
   try {
@@ -1423,7 +1534,7 @@ function renderGuideMarkdown(result) {
 !(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] = "74d572ce-ab89-5323-b812-91f1b4f2c398");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "c129d790-a418-5226-8a6e-eea642855314");
   } catch (e2) {
   }
 })();
@@ -2770,6 +2881,9 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           ;;
         init)
           _arguments \\
+            '(1)--id-prefix[Set the item ID prefix]:prefix' \\
+            '(1)--prefix[Alias for --id-prefix]:prefix' \\
+            '1:optional id prefix or tracker path' \\
             '--preset[Governance preset for new setups]:preset:(minimal default strict)' \\
             '--defaults[Use non-interactive setup defaults]' \\
             '-y[Alias for --defaults]' \\
@@ -3765,6 +3879,8 @@ complete -c pm -n '__fish_seen_subcommand_from validate' -l prune-missing -d 'Re
 complete -c pm -n '__fish_seen_subcommand_from validate' -l check-history-drift -d 'Run item/history hash drift checks'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l check-command-references -d 'Run linked-command PM-ID reference checks'
 complete -c pm -n '__fish_seen_subcommand_from init' -l preset -d 'Governance preset for new setups' -r -a 'minimal default strict'
+complete -c pm -n '__fish_seen_subcommand_from init' -l id-prefix -d 'Set the item ID prefix' -r
+complete -c pm -n '__fish_seen_subcommand_from init' -l prefix -d 'Alias for --id-prefix' -r
 complete -c pm -n '__fish_seen_subcommand_from init' -l defaults -d 'Use non-interactive setup defaults'
 complete -c pm -n '__fish_seen_subcommand_from init' -s y -l yes -d 'Alias for --defaults'
 complete -c pm -n '__fish_seen_subcommand_from init' -l author -d 'Set the default mutation author for this project' -r
@@ -4589,7 +4705,7 @@ async function runReindex(options, global2) {
 !(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] = "9c1f10e3-4133-54a5-a291-2da372570428");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "40c78d4e-1d6c-5910-a925-95fb87ebad82");
   } catch (e2) {
   }
 })();
@@ -4814,6 +4930,28 @@ var PmClient = class {
   gc(options = {}) {
     return this.runTyped("gc", { options });
   }
+  /** Redact sensitive values while preserving an audited, verified history chain. */
+  historyRedact(id, options) {
+    return this.runTyped("history-redact", { id, options });
+  }
+  /** Repair and re-anchor one drifted history stream. */
+  historyRepair(id, options = {}) {
+    return this.runTyped("history-repair", { id, options });
+  }
+  /** Scan and repair every drifted history stream in one resilient pass. */
+  historyRepairAll(options = {}) {
+    return this.runTyped("history-repair", {
+      options: { ...options, all: true }
+    });
+  }
+  /** Compact one history stream into a verified checkpoint and retained tail. */
+  historyCompact(id, options = {}) {
+    return this.runTyped("history-compact", { id, options });
+  }
+  /** Compact an explicit or policy-selected set of history streams. */
+  historyCompactBulk(options) {
+    return this.runTyped("history-compact", { options });
+  }
   /** Run any typed plan workflow primitive through the shared CLI/MCP engine. */
   plan(subcommand, id, options = {}, stepRef, reorderTo) {
     return this.runTyped("plan", {
@@ -5175,6 +5313,21 @@ function health(options = {}, clientOptions = {}) {
 function gc(options = {}, clientOptions = {}) {
   return new PmClient(clientOptions).gc(options);
 }
+function historyRedact(id, options, clientOptions = {}) {
+  return new PmClient(clientOptions).historyRedact(id, options);
+}
+function historyRepair(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).historyRepair(id, options);
+}
+function historyRepairAll(options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).historyRepairAll(options);
+}
+function historyCompact(id, options = {}, clientOptions = {}) {
+  return new PmClient(clientOptions).historyCompact(id, options);
+}
+function historyCompactBulk(options, clientOptions = {}) {
+  return new PmClient(clientOptions).historyCompactBulk(options);
+}
 function create(options = {}, clientOptions = {}) {
   return new PmClient(clientOptions).create(options);
 }
@@ -5300,29 +5453,8 @@ async function getContracts(pmRootOrOptions, options = {}) {
   };
   return runContracts(resolvedOptions, global2);
 }
-function readString(args, key) {
-  const value = args[key];
-  return typeof value === "string" && value.trim().length > 0 ? value : void 0;
-}
-function readScalarString(args, key) {
-  const value = args[key];
-  if (typeof value === "string") {
-    return value.trim().length > 0 ? value : void 0;
-  }
-  return typeof value === "number" && Number.isFinite(value) ? String(value) : void 0;
-}
-function readScalarStringAllowBlank(args, key) {
-  const value = args[key];
-  if (typeof value === "string") {
-    return value;
-  }
-  return typeof value === "number" && Number.isFinite(value) ? String(value) : void 0;
-}
-function isRecord2(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
 function readRequiredString(args, key) {
-  const value = readString(args, key);
+  const value = readRuntimeString(args, key);
   if (!value) {
     throw new PmCliError(`Missing required argument: ${key}`, 64);
   }
@@ -5332,7 +5464,7 @@ function globalOptions(args) {
   return {
     json: true,
     quiet: true,
-    path: readString(args, "path"),
+    path: readRuntimeString(args, "path"),
     noExtensions: args.noExtensions === true || args.no_extensions === true,
     noPager: true
   };
@@ -5445,8 +5577,8 @@ function optionsWithAuthor(args, action) {
     hoistKey("body");
   }
   const options = normalizeMcpOptionsArrays({ ...hoistedTopLevel, ...baseOptions }, action);
-  const author = readString(args, "author");
-  const authorFromAssignee = action !== void 0 && LIFECYCLE_AUTHOR_ALIAS_ACTIONS.has(action) ? readString(args, "assignee") ?? readString(options, "assignee") : void 0;
+  const author = readRuntimeString(args, "author");
+  const authorFromAssignee = action !== void 0 && LIFECYCLE_AUTHOR_ALIAS_ACTIONS.has(action) ? readRuntimeString(args, "assignee") ?? readRuntimeString(options, "assignee") : void 0;
   if (author && options.author === void 0) {
     return { ...options, author };
   }
@@ -5632,39 +5764,39 @@ function withMutationCompaction(args, options) {
 }
 function mutationListOptions(options) {
   return {
-    type: readScalarString(options, "filterType"),
-    tag: readScalarString(options, "filterTag"),
-    priority: readScalarString(options, "filterPriority"),
-    deadlineBefore: readScalarString(options, "filterDeadlineBefore"),
-    deadlineAfter: readScalarString(options, "filterDeadlineAfter"),
-    updatedAfter: readScalarString(options, "filterUpdatedAfter"),
-    updatedBefore: readScalarString(options, "filterUpdatedBefore"),
-    createdAfter: readScalarString(options, "filterCreatedAfter"),
-    createdBefore: readScalarString(options, "filterCreatedBefore"),
-    ids: readScalarStringAllowBlank(options, "ids"),
-    assignee: readScalarString(options, "filterAssignee"),
-    assigneeFilter: readScalarString(options, "filterAssigneeFilter") ?? readScalarString(options, "filterAssignee_filter"),
-    parent: readScalarString(options, "filterParent"),
-    sprint: readScalarString(options, "filterSprint"),
-    release: readScalarString(options, "filterRelease"),
-    limit: readScalarString(options, "limit"),
-    offset: readScalarString(options, "offset")
+    type: readRuntimeScalarString(options, "filterType"),
+    tag: readRuntimeScalarString(options, "filterTag"),
+    priority: readRuntimeScalarString(options, "filterPriority"),
+    deadlineBefore: readRuntimeScalarString(options, "filterDeadlineBefore"),
+    deadlineAfter: readRuntimeScalarString(options, "filterDeadlineAfter"),
+    updatedAfter: readRuntimeScalarString(options, "filterUpdatedAfter"),
+    updatedBefore: readRuntimeScalarString(options, "filterUpdatedBefore"),
+    createdAfter: readRuntimeScalarString(options, "filterCreatedAfter"),
+    createdBefore: readRuntimeScalarString(options, "filterCreatedBefore"),
+    ids: readRuntimeScalarStringAllowBlank(options, "ids"),
+    assignee: readRuntimeScalarString(options, "filterAssignee"),
+    assigneeFilter: readRuntimeScalarString(options, "filterAssigneeFilter") ?? readRuntimeScalarString(options, "filterAssignee_filter"),
+    parent: readRuntimeScalarString(options, "filterParent"),
+    sprint: readRuntimeScalarString(options, "filterSprint"),
+    release: readRuntimeScalarString(options, "filterRelease"),
+    limit: readRuntimeScalarString(options, "limit"),
+    offset: readRuntimeScalarString(options, "offset")
   };
 }
 function closeManyOptionsFromFlat(options) {
   return {
-    status: readString(options, "filterStatus"),
-    list: isRecord2(options.list) ? normalizeListOptions(options.list) : mutationListOptions(options),
-    reason: readString(options, "reason"),
-    resolution: readString(options, "resolution"),
-    expectedResult: readString(options, "expectedResult") ?? readString(options, "expected_result") ?? readString(options, "expected"),
-    actualResult: readString(options, "actualResult") ?? readString(options, "actual_result") ?? readString(options, "actual"),
-    validateClose: readString(options, "validateClose") ?? readString(options, "validate_close"),
-    author: readString(options, "author"),
-    message: readString(options, "message"),
+    status: readRuntimeString(options, "filterStatus"),
+    list: isRuntimeRecord(options.list) ? normalizeListOptions(options.list) : mutationListOptions(options),
+    reason: readRuntimeString(options, "reason"),
+    resolution: readRuntimeString(options, "resolution"),
+    expectedResult: readRuntimeString(options, "expectedResult") ?? readRuntimeString(options, "expected_result") ?? readRuntimeString(options, "expected"),
+    actualResult: readRuntimeString(options, "actualResult") ?? readRuntimeString(options, "actual_result") ?? readRuntimeString(options, "actual"),
+    validateClose: readRuntimeString(options, "validateClose") ?? readRuntimeString(options, "validate_close"),
+    author: readRuntimeString(options, "author"),
+    message: readRuntimeString(options, "message"),
     force: options.force === true ? true : void 0,
     dryRun: options.dryRun === true || options.dry_run === true ? true : void 0,
-    rollback: readString(options, "rollback"),
+    rollback: readRuntimeString(options, "rollback"),
     checkpoint: options.checkpoint === false || options.noCheckpoint === true || options.no_checkpoint === true ? false : void 0
   };
 }
@@ -5720,23 +5852,23 @@ function normalizeMcpUpdateOptions(options) {
   return normalizeUpdateOptions(normalizedInput);
 }
 function updateManyOptionsFromFlat(options) {
-  if (isRecord2(options.list) || isRecord2(options.update)) {
-    const updateSource = isRecord2(options.update) ? options.update : updateManyUpdateOptionsFromFlat(options);
+  if (isRuntimeRecord(options.list) || isRuntimeRecord(options.update)) {
+    const updateSource = isRuntimeRecord(options.update) ? options.update : updateManyUpdateOptionsFromFlat(options);
     return {
-      status: readScalarString(options, "filterStatus"),
-      list: isRecord2(options.list) ? normalizeListOptions(options.list) : mutationListOptions(options),
+      status: readRuntimeScalarString(options, "filterStatus"),
+      list: isRuntimeRecord(options.list) ? normalizeListOptions(options.list) : mutationListOptions(options),
       update: normalizeMcpUpdateOptions(updateSource),
       dryRun: options.dryRun === true || options.dry_run === true ? true : void 0,
-      rollback: readString(options, "rollback"),
+      rollback: readRuntimeString(options, "rollback"),
       checkpoint: options.checkpoint === false || options.noCheckpoint === true || options.no_checkpoint === true ? false : void 0
     };
   }
   return {
-    status: readScalarString(options, "filterStatus"),
+    status: readRuntimeScalarString(options, "filterStatus"),
     list: mutationListOptions(options),
     update: updateManyUpdateOptionsFromFlat(options),
     dryRun: options.dryRun === true || options.dry_run === true ? true : void 0,
-    rollback: readString(options, "rollback"),
+    rollback: readRuntimeString(options, "rollback"),
     checkpoint: options.checkpoint === false || options.noCheckpoint === true || options.no_checkpoint === true ? false : void 0
   };
 }
@@ -5886,7 +6018,7 @@ async function runAction(args) {
   const resolved = resolveSdkActionInput(args);
   const global2 = globalOptions(resolved.args);
   const invalidateWorkspaceContractsCache = shouldInvalidateWorkspaceContractsCacheAfterAction(resolved.action);
-  const explicitCwd = readString(resolved.args, "cwd");
+  const explicitCwd = readRuntimeString(resolved.args, "cwd");
   const resolutionCwd = explicitCwd ?? process.cwd();
   try {
     return await withActiveExtensions(global2, explicitCwd, resolutionCwd, (activeExtensions) => dispatchAction(resolved.action, resolved.args, global2, activeExtensions));
@@ -5900,7 +6032,7 @@ function getOwnHandler(handlers, key) {
   return Object.prototype.hasOwnProperty.call(handlers, key) ? handlers[key] : void 0;
 }
 function readMcpTarget(ctx) {
-  return readString(ctx.args, "target") ?? readString(ctx.options, "target");
+  return readRuntimeString(ctx.args, "target") ?? readRuntimeString(ctx.options, "target");
 }
 function requireMcpItemId(ctx, source = ctx.options) {
   return ctx.id ?? readRequiredString(source, "id");
@@ -5910,7 +6042,7 @@ async function runMcpListAction(ctx) {
   if (listOptions.compact === void 0 && listOptions.brief === void 0 && listOptions.fields === void 0 && listOptions.includeBody === void 0) {
     listOptions.compact = true;
   }
-  return withQuerySummary(await runList(readString(ctx.args, "status") ?? readString(listOptions, "status"), listOptions, ctx.global), listOptions);
+  return withQuerySummary(await runList(readRuntimeString(ctx.args, "status") ?? readRuntimeString(listOptions, "status"), listOptions, ctx.global), listOptions);
 }
 async function runMcpSearchAction(ctx) {
   const searchOptions = { ...ctx.options };
@@ -5944,7 +6076,7 @@ async function runMcpUpdateAction(ctx) {
 }
 async function runMcpCloseAction(ctx) {
   const { changedFields, idOnly, runnerOptions } = withMutationCompaction(ctx.args, ctx.options);
-  const closeReason = readString(ctx.args, "reason") ?? readString(ctx.args, "text") ?? readString(runnerOptions, "reason") ?? readString(runnerOptions, "text");
+  const closeReason = readRuntimeString(ctx.args, "reason") ?? readRuntimeString(ctx.args, "text") ?? readRuntimeString(runnerOptions, "reason") ?? readRuntimeString(runnerOptions, "text");
   return projectMutationResult(await runClose(requireMcpItemId(ctx, runnerOptions), closeReason, runnerOptions, ctx.global), { changedFields, idOnly });
 }
 function runMcpCommentsAction(ctx) {
@@ -5965,7 +6097,7 @@ function runMcpFilesAction(ctx) {
 }
 function runMcpTelemetryAction(ctx) {
   return runTelemetry({
-    subcommand: readString(ctx.args, "subcommand") ?? readString(ctx.options, "subcommand"),
+    subcommand: readRuntimeString(ctx.args, "subcommand") ?? readRuntimeString(ctx.options, "subcommand"),
     limit: resolveMcpTelemetryLimit(ctx.args, ctx.options)
   }, ctx.global);
 }
@@ -5976,7 +6108,7 @@ function resolveMcpTelemetryLimit(args, options) {
   if (typeof options.limit === "number" && Number.isFinite(options.limit)) {
     return options.limit;
   }
-  return readString(args, "limit") ?? readString(options, "limit");
+  return readRuntimeString(args, "limit") ?? readRuntimeString(options, "limit");
 }
 function runMcpHealthAction(ctx) {
   const healthOptions = { ...ctx.options };
@@ -5986,11 +6118,11 @@ function runMcpHealthAction(ctx) {
   return runHealth(ctx.global, healthOptions);
 }
 function runMcpConfigAction(ctx) {
-  const configAction = readString(ctx.args, "configAction") ?? readString(ctx.options, "configAction") ?? readString(ctx.options, "action");
+  const configAction = readRuntimeString(ctx.args, "configAction") ?? readRuntimeString(ctx.options, "configAction") ?? readRuntimeString(ctx.options, "action");
   if (configAction === void 0) {
     throw new PmCliError("Missing required argument: configAction", 64);
   }
-  return runConfig(readString(ctx.args, "scope") ?? readString(ctx.options, "scope") ?? "project", configAction, readString(ctx.args, "key") ?? readString(ctx.options, "key"), ctx.options, ctx.global, readString(ctx.args, "value") ?? readString(ctx.options, "value"));
+  return runConfig(readRuntimeString(ctx.args, "scope") ?? readRuntimeString(ctx.options, "scope") ?? "project", configAction, readRuntimeString(ctx.args, "key") ?? readRuntimeString(ctx.options, "key"), ctx.options, ctx.global, readRuntimeString(ctx.args, "value") ?? readRuntimeString(ctx.options, "value"));
 }
 function runMcpActivityAction(ctx) {
   const activityOptions = { ...ctx.options };
@@ -6000,28 +6132,6 @@ function runMcpActivityAction(ctx) {
   delete activityOptions.full;
   return runActivity(activityOptions, ctx.global);
 }
-function runMcpHistoryRepairAction(ctx) {
-  const repairAll = ctx.options.all === true;
-  const repairId = ctx.id ?? readString(ctx.options, "id");
-  assertHistoryRepairTarget(repairId, repairAll);
-  return repairAll ? runHistoryRepairAll(ctx.options, ctx.global) : runHistoryRepair(repairId, ctx.options, ctx.global);
-}
-function parseMcpInteger(value, label) {
-  if (typeof value === "number") {
-    if (!Number.isInteger(value)) {
-      throw new PmCliError(`${label} must be a finite integer.`, 64);
-    }
-    return value;
-  }
-  if (typeof value === "string" && value.trim().length > 0) {
-    const parsed = Number(value);
-    if (!Number.isInteger(parsed)) {
-      throw new PmCliError(`${label} must be a finite integer.`, 64);
-    }
-    return parsed;
-  }
-  return void 0;
-}
 function parseMcpIntegerPrefix(value, label) {
   if (typeof value === "number") {
     if (!Number.isFinite(value) || !Number.isInteger(value)) {
@@ -6043,7 +6153,7 @@ function parseMcpIntegerPrefix(value, label) {
   return void 0;
 }
 function runMcpPlanAction(ctx) {
-  const subcommand = readString(ctx.args, "subcommand") ?? readRequiredString(ctx.options, "subcommand");
+  const subcommand = readRuntimeString(ctx.args, "subcommand") ?? readRequiredString(ctx.options, "subcommand");
   const planRecord = ctx.options;
   return runPlan({
     subcommand,
@@ -6058,13 +6168,13 @@ function readMcpPlanStepRef(ctx) {
   return typeof ctx.options.stepRef === "string" ? ctx.options.stepRef : typeof ctx.args.stepRef === "string" ? ctx.args.stepRef : void 0;
 }
 function createMcpSchemaContext(ctx) {
-  const subcommand = readString(ctx.args, "subcommand") ?? readRequiredString(ctx.options, "subcommand");
+  const subcommand = readRuntimeString(ctx.args, "subcommand") ?? readRequiredString(ctx.options, "subcommand");
   const aliasSource = ctx.args.alias ?? ctx.options.alias;
   return {
     ctx,
     subcommand: subcommand.trim().toLowerCase(),
-    name: readString(ctx.args, "name") ?? readString(ctx.options, "name"),
-    author: readString(ctx.args, "author") ?? readString(ctx.options, "author"),
+    name: readRuntimeString(ctx.args, "name") ?? readRuntimeString(ctx.options, "name"),
+    author: readRuntimeString(ctx.args, "author") ?? readRuntimeString(ctx.options, "author"),
     force: ctx.args.force === true || ctx.options.force === true,
     aliases: aliasSource === void 0 ? void 0 : readStringArray(aliasSource)
   };
@@ -6080,7 +6190,7 @@ function runMcpSchemaReadOrRemoveAction(schema2) {
     "remove-type": () => runSchemaRemoveType(name, { author, force }, ctx.global),
     "remove-field": () => runSchemaRemoveField(name, { author, force }, ctx.global),
     "remove-status": () => runSchemaRemoveStatus(name, { author, force }, ctx.global),
-    "apply-preset": () => runSchemaApplyPreset(readString(ctx.args, "typePreset") ?? readString(ctx.options, "typePreset"), { author, force }, ctx.global)
+    "apply-preset": () => runSchemaApplyPreset(readRuntimeString(ctx.args, "typePreset") ?? readRuntimeString(ctx.options, "typePreset"), { author, force }, ctx.global)
   };
   const handler = getOwnHandler(simpleHandlers, subcommand);
   return handler ? handler() : null;
@@ -6090,10 +6200,10 @@ function runMcpSchemaAddFieldAction(schema2) {
   const commandsSource = ctx.args.commands ?? ctx.options.commands;
   const requiredTypesSource = ctx.args.requiredTypes ?? ctx.options.requiredTypes;
   return runSchemaAddField(name, {
-    type: readString(ctx.args, "fieldType") ?? readString(ctx.options, "fieldType"),
+    type: readRuntimeString(ctx.args, "fieldType") ?? readRuntimeString(ctx.options, "fieldType"),
     commands: commandsSource === void 0 ? void 0 : readStringArray(commandsSource),
-    description: readString(ctx.args, "description") ?? readString(ctx.options, "description"),
-    cliFlag: readString(ctx.args, "cliFlag") ?? readString(ctx.options, "cliFlag"),
+    description: readRuntimeString(ctx.args, "description") ?? readRuntimeString(ctx.options, "description"),
+    cliFlag: readRuntimeString(ctx.args, "cliFlag") ?? readRuntimeString(ctx.options, "cliFlag"),
     alias: aliases,
     required: ctx.args.required === true || ctx.options.required === true,
     requiredOnCreate: ctx.args.requiredOnCreate === true || ctx.options.requiredOnCreate === true,
@@ -6109,8 +6219,8 @@ function runMcpSchemaAddStatusAction(schema2) {
   return runSchemaAddStatus(name, {
     role: roleSource === void 0 ? void 0 : readStringArray(roleSource),
     alias: aliases,
-    description: readString(ctx.args, "description") ?? readString(ctx.options, "description"),
-    order: parseMcpInteger(ctx.args.order ?? ctx.options.order, "schema add-status order"),
+    description: readRuntimeString(ctx.args, "description") ?? readRuntimeString(ctx.options, "description"),
+    order: parseRuntimeInteger(ctx.args.order ?? ctx.options.order, "schema add-status order"),
     author,
     force
   }, ctx.global);
@@ -6118,9 +6228,9 @@ function runMcpSchemaAddStatusAction(schema2) {
 function runMcpSchemaAddTypeAction(schema2) {
   const { ctx, name, author, force, aliases } = schema2;
   return runSchemaAddType(name, {
-    description: readString(ctx.args, "description") ?? readString(ctx.options, "description"),
-    defaultStatus: readString(ctx.args, "defaultStatus") ?? readString(ctx.args, "default_status") ?? readString(ctx.options, "defaultStatus") ?? readString(ctx.options, "default_status"),
-    folder: readString(ctx.args, "folder") ?? readString(ctx.options, "folder"),
+    description: readRuntimeString(ctx.args, "description") ?? readRuntimeString(ctx.options, "description"),
+    defaultStatus: readRuntimeString(ctx.args, "defaultStatus") ?? readRuntimeString(ctx.args, "default_status") ?? readRuntimeString(ctx.options, "defaultStatus") ?? readRuntimeString(ctx.options, "default_status"),
+    folder: readRuntimeString(ctx.args, "folder") ?? readRuntimeString(ctx.options, "folder"),
     alias: aliases,
     author,
     force
@@ -6141,7 +6251,7 @@ function runMcpSchemaAction(ctx) {
   if (schema2.subcommand === "add-type") {
     if (ctx.args.infer === true || ctx.options.infer === true) {
       return runSchemaInferTypes({
-        minCount: parseMcpInteger(ctx.args.minCount ?? ctx.options.minCount, "schema infer minCount"),
+        minCount: parseRuntimeInteger(ctx.args.minCount ?? ctx.options.minCount, "schema infer minCount"),
         apply: ctx.args.apply === true || ctx.options.apply === true,
         author: schema2.author,
         force: schema2.force
@@ -6152,16 +6262,16 @@ function runMcpSchemaAction(ctx) {
   throw new PmCliError(`Unknown pm schema subcommand "${schema2.subcommand}". Allowed: add-type, remove-type, add-status, remove-status, add-field, remove-field, list-fields, show-field, apply-preset, list, show, show-status`, 64);
 }
 function runMcpProfileAction(ctx) {
-  const subcommand = readString(ctx.args, "subcommand") ?? readRequiredString(ctx.options, "subcommand");
+  const subcommand = readRuntimeString(ctx.args, "subcommand") ?? readRequiredString(ctx.options, "subcommand");
   const normalizedSubcommand = subcommand.trim().toLowerCase();
-  const profileName = readString(ctx.args, "name") ?? readString(ctx.options, "name");
+  const profileName = readRuntimeString(ctx.args, "name") ?? readRuntimeString(ctx.options, "name");
   const handlers = {
     list: () => runProfileList(),
     show: () => runProfileShow(profileName),
     lint: () => runProfileLint(profileName),
     apply: () => runProfileApply(profileName, {
       dryRun: ctx.args.dryRun === true || ctx.options.dryRun === true,
-      author: readString(ctx.args, "author") ?? readString(ctx.options, "author"),
+      author: readRuntimeString(ctx.args, "author") ?? readRuntimeString(ctx.options, "author"),
       force: ctx.args.force === true || ctx.options.force === true
     }, ctx.global)
   };
@@ -6194,7 +6304,7 @@ async function runMcpUpdateManyAction(ctx) {
 }
 async function runMcpCloseManyAction(ctx) {
   const { changedFields, runnerOptions } = withMutationCompaction(ctx.args, ctx.options);
-  const topLevelReason = readString(ctx.args, "reason");
+  const topLevelReason = readRuntimeString(ctx.args, "reason");
   const closeManyRunnerOptions = topLevelReason !== void 0 && runnerOptions.reason === void 0 ? { ...runnerOptions, reason: topLevelReason } : { ...runnerOptions };
   if (ctx.force && closeManyRunnerOptions.force === void 0) {
     closeManyRunnerOptions.force = true;
@@ -6203,7 +6313,7 @@ async function runMcpCloseManyAction(ctx) {
 }
 async function runMcpRestoreAction(ctx) {
   const { changedFields, idOnly, runnerOptions } = withMutationCompaction(ctx.args, ctx.options);
-  const target = readString(runnerOptions, "target") ?? readRequiredString(ctx.args, "target");
+  const target = readRuntimeString(runnerOptions, "target") ?? readRequiredString(ctx.args, "target");
   return projectMutationResult(await runRestore(requireMcpItemId(ctx, runnerOptions), target, runnerOptions, ctx.global), {
     changedFields,
     idOnly
@@ -6247,7 +6357,7 @@ async function runMcpPauseTaskAction(ctx) {
 }
 async function runMcpCloseTaskAction(ctx) {
   const id = requireMcpItemId(ctx);
-  const closeReason = readString(ctx.args, "reason") ?? readString(ctx.args, "text") ?? readString(ctx.options, "reason") ?? readString(ctx.options, "text");
+  const closeReason = readRuntimeString(ctx.args, "reason") ?? readRuntimeString(ctx.args, "text") ?? readRuntimeString(ctx.options, "reason") ?? readRuntimeString(ctx.options, "text");
   const closeResult = await runClose(id, closeReason, { ...ctx.options, force: ctx.force }, ctx.global);
   const releaseResult = await runRelease(id, ctx.force, ctx.global, ctx.options);
   return {
@@ -6258,7 +6368,7 @@ async function runMcpCloseTaskAction(ctx) {
   };
 }
 var SDK_ACTION_HANDLERS = {
-  init: (ctx) => runInit(readString(ctx.args, "prefix"), ctx.global, ctx.options),
+  init: (ctx) => runInit(readRuntimeString(ctx.args, "prefix"), ctx.global, ctx.options),
   context: (ctx) => runContext(ctx.options, ctx.global),
   next: (ctx) => runNext(ctx.options, ctx.global),
   list: runMcpListAction,
@@ -6283,7 +6393,9 @@ var SDK_ACTION_HANDLERS = {
   test: (ctx) => runTest(requireMcpItemId(ctx), ctx.options, ctx.global),
   "test-all": (ctx) => runTestAll(ctx.options, ctx.global),
   telemetry: runMcpTelemetryAction,
-  validate: (ctx) => runValidate(ctx.options, ctx.global),
+  validate: (ctx) => runValidate(ctx.options, ctx.global, {
+    runUpdate: (id, options, global2) => runUpdate(id, options, global2)
+  }),
   health: runMcpHealthAction,
   contracts: (ctx) => runContracts(ctx.options, ctx.global),
   config: runMcpConfigAction,
@@ -6299,7 +6411,7 @@ var SDK_ACTION_HANDLERS = {
   history: (ctx) => runHistory(requireMcpItemId(ctx), ctx.options, ctx.global),
   "history-redact": (ctx) => runHistoryRedact(requireMcpItemId(ctx), ctx.options, ctx.global),
   "history-repair": runMcpHistoryRepairAction,
-  "history-compact": (ctx) => runHistoryCompact(requireMcpItemId(ctx), ctx.options, ctx.global),
+  "history-compact": runMcpHistoryCompactAction,
   plan: runMcpPlanAction,
   schema: runMcpSchemaAction,
   profile: runMcpProfileAction,
@@ -6315,7 +6427,7 @@ async function dispatchAction(action, args, global2, activeExtensions) {
     action,
     args,
     options,
-    id: readString(args, "id"),
+    id: readRuntimeString(args, "id"),
     force: args.force === true || options.force === true,
     global: global2,
     activeExtensions
@@ -6334,8 +6446,8 @@ var actionRunnerTestHooks = {
   normalizeMcpOptionsArrays,
   optionsWithAuthor,
   readRequiredString,
-  readScalarString,
-  readScalarStringAllowBlank,
+  readScalarString: readRuntimeScalarString,
+  readScalarStringAllowBlank: readRuntimeScalarStringAllowBlank,
   readStringArray,
   updateManyOptionsFromFlat,
   withAddNoteOption,
@@ -6436,6 +6548,11 @@ export {
   validate,
   health,
   gc,
+  historyRedact,
+  historyRepair,
+  historyRepairAll,
+  historyCompact,
+  historyCompactBulk,
   create,
   update,
   close,
@@ -6470,4 +6587,4 @@ export {
   readRequiredString,
   runAction
 };
-//# sourceMappingURL=chunk-5URI7TPJ.js.map
+//# sourceMappingURL=chunk-4XQ3BDV4.js.map