@unbrained/pm-cli 2026.7.14 → 2026.7.16

package/dist/sdk/runtime-input.js

@@ -0,0 +1,60 @@
+/**
+ * @module sdk/runtime-input
+ *
+ * Normalizes untyped action payload values at the SDK runtime boundary. These
+ * primitives are shared by native action dispatchers and MCP-specific adapters.
+ */
+
+!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(e){}}();
+import { EXIT_CODE } from "../core/shared/constants.js";
+import { PmCliError } from "../core/shared/errors.js";
+/** Read a non-empty string without altering its caller-provided whitespace. */
+export function readRuntimeString(args, key) {
+    const value = args[key];
+    return typeof value === "string" && value.trim().length > 0
+        ? value
+        : undefined;
+}
+/** Normalize a non-empty string or finite number into a scalar string. */
+export function readRuntimeScalarString(args, key) {
+    const value = args[key];
+    if (typeof value === "string") {
+        return value.trim().length > 0 ? value : undefined;
+    }
+    return typeof value === "number" && Number.isFinite(value)
+        ? String(value)
+        : undefined;
+}
+/** Normalize a string, including blank text, or a finite number into text. */
+export function readRuntimeScalarStringAllowBlank(args, key) {
+    const value = args[key];
+    if (typeof value === "string") {
+        return value;
+    }
+    return typeof value === "number" && Number.isFinite(value)
+        ? String(value)
+        : undefined;
+}
+/** Narrow unknown values to plain record-shaped action payloads. */
+export function isRuntimeRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** Parse an integer-valued MCP option while retaining a caller-specific label. */
+export 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 undefined;
+}
+//# sourceMappingURL=runtime-input.js.map
+//# debugId=246cb97d-1f47-52a8-bf9a-012d5ab982c4

package/dist/sdk/runtime-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-input.js","sources":["sdk/runtime-input.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/runtime-input\n *\n * Normalizes untyped action payload values at the SDK runtime boundary. These\n * primitives are shared by native action dispatchers and MCP-specific adapters.\n */\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\n\n/** Read a non-empty string without altering its caller-provided whitespace. */\nexport function readRuntimeString(\n  args: Record<string, unknown>,\n  key: string,\n): string | undefined {\n  const value = args[key];\n  return typeof value === \"string\" && value.trim().length > 0\n    ? value\n    : undefined;\n}\n\n/** Normalize a non-empty string or finite number into a scalar string. */\nexport function readRuntimeScalarString(\n  args: Record<string, unknown>,\n  key: string,\n): string | undefined {\n  const value = args[key];\n  if (typeof value === \"string\") {\n    return value.trim().length > 0 ? value : undefined;\n  }\n  return typeof value === \"number\" && Number.isFinite(value)\n    ? String(value)\n    : undefined;\n}\n\n/** Normalize a string, including blank text, or a finite number into text. */\nexport function readRuntimeScalarStringAllowBlank(\n  args: Record<string, unknown>,\n  key: string,\n): string | undefined {\n  const value = args[key];\n  if (typeof value === \"string\") {\n    return value;\n  }\n  return typeof value === \"number\" && Number.isFinite(value)\n    ? String(value)\n    : undefined;\n}\n\n/** Narrow unknown values to plain record-shaped action payloads. */\nexport function isRuntimeRecord(\n  value: unknown,\n): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\n/** Parse an integer-valued MCP option while retaining a caller-specific label. */\nexport function parseRuntimeInteger(\n  value: unknown,\n  label: string,\n): number | undefined {\n  if (typeof value === \"number\") {\n    if (!Number.isInteger(value)) {\n      throw new PmCliError(\n        `${label} must be a finite integer.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return value;\n  }\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    const parsed = Number(value);\n    if (!Number.isInteger(parsed)) {\n      throw new PmCliError(\n        `${label} must be a finite integer.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return parsed;\n  }\n  return undefined;\n}\n"],"names":[],"mappings":"AAAA;;;;;GAKG;;;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB,CAC/B,IAA6B,EAC7B,GAAW;IAEX,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QACzD,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,uBAAuB,CACrC,IAA6B,EAC7B,GAAW;IAEX,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACrD,CAAC;IACD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACxD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QACf,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iCAAiC,CAC/C,IAA6B,EAC7B,GAAW;IAEX,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACxD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QACf,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAC7B,KAAc;IAEd,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CACjC,KAAc,EACd,KAAa;IAEb,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,UAAU,CAClB,GAAG,KAAK,4BAA4B,EACpC,SAAS,CAAC,KAAK,CAChB,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,UAAU,CAClB,GAAG,KAAK,4BAA4B,EACpC,SAAS,CAAC,KAAK,CAChB,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","debugId":"246cb97d-1f47-52a8-bf9a-012d5ab982c4"}

package/dist/sdk/runtime.d.ts

@@ -8,7 +8,15 @@ import { type ExtensionRegistrationRegistry } from "../core/extensions/index.js"
 import type { GlobalOptions } from "../core/shared/command-types.js";
 import type { PmToolAction } from "./cli-contracts/enum-contracts.js";
 export { clearWorkspaceContractsCache } from "./workspace-contracts-cache.js";
-import { type AggregateOptions, type AggregateResult, type ExtensionCommandOptions, type ExtensionCommandResult, type UpgradeCommandOptions, type UpgradeResult } from "../cli/commands/index.js";
+import { type AggregateOptions, type AggregateResult, type UpgradeCommandOptions, type UpgradeResult } from "../cli/commands/index.js";
+import { type GcCommandOptions, type GcResult } from "./governance/gc.js";
+import { type HealthResult, type RunHealthOptions } from "./governance/health.js";
+import { type ValidateCommandOptions, type ValidateResult } from "./governance/validate.js";
+import { type ExtensionCommandOptions, type ExtensionCommandResult } from "./extension.js";
+import { type HistoryCompactBulkCommandOptions, type HistoryCompactBulkResult, type HistoryCompactCommandOptions, type HistoryCompactResult } from "./history-compact.js";
+import { type HistoryRedactCommandOptions, type HistoryRedactResult } from "./history-redact.js";
+import { type HistoryRepairAllResult, type HistoryRepairCommandOptions, type HistoryRepairResult } from "./history-repair.js";
+import { readRuntimeScalarString as readScalarString, readRuntimeScalarStringAllowBlank as readScalarStringAllowBlank } from "./runtime-input.js";
 import type { ContextOptions, ContextResult } from "../cli/commands/context.js";
 import type { GetOptions, GetResult } from "../cli/commands/get.js";
 import type { CloseManyCommandOptions } from "../cli/commands/close-many.js";
@@ -33,14 +41,11 @@ import type { ConfigCommandOptions, ConfigResult } from "../cli/commands/config.
 import type { DepsCommandOptions, DepsResult } from "./dependencies.js";
 import type { DocsCommandOptions, DocsResult } from "./docs.js";
 import type { FilesCommandOptions, FilesDiscoverOptions, FilesDiscoverResult, FilesResult } from "./files.js";
-import type { GcCommandOptions, GcResult } from "../cli/commands/gc.js";
-import type { HealthResult, RunHealthOptions } from "../cli/commands/health.js";
 import type { InitCommandOptions, InitResult } from "../cli/commands/init.js";
 import type { LearningsCommandOptions, LearningsResult } from "../cli/commands/learnings.js";
 import type { NotesCommandOptions, NotesResult } from "../cli/commands/notes.js";
 import type { ProfileApplyCommandOptions, ProfileApplyResult, ProfileLintResult, ProfileListResult, ProfileResult, ProfileShowResult, ProfileSubcommand } from "../cli/commands/profile.js";
-import type { SchemaAddFieldCommandOptions, SchemaAddFieldResult, SchemaAddStatusCommandOptions, SchemaAddStatusResult, SchemaAddTypeCommandOptions, SchemaAddTypeInferCommandOptions, SchemaAddTypeInferResult, SchemaAddTypeResult, SchemaApplyPresetCommandOptions, SchemaApplyPresetResult, SchemaInspectResult, SchemaListFieldsResult, SchemaListResult, SchemaRemoveFieldCommandOptions, SchemaRemoveFieldResult, SchemaRemoveStatusCommandOptions, SchemaRemoveStatusResult, SchemaRemoveTypeCommandOptions, SchemaRemoveTypeResult, SchemaShowFieldResult, SchemaShowResult, SchemaShowStatusResult, SchemaSubcommand } from "../cli/commands/schema.js";
-import type { ValidateCommandOptions, ValidateResult } from "../cli/commands/validate.js";
+import { type SchemaAddFieldCommandOptions, type SchemaAddFieldResult, type SchemaAddStatusCommandOptions, type SchemaAddStatusResult, type SchemaAddTypeCommandOptions, type SchemaAddTypeInferCommandOptions, type SchemaAddTypeInferResult, type SchemaAddTypeResult, type SchemaApplyPresetCommandOptions, type SchemaApplyPresetResult, type SchemaInspectResult, type SchemaListFieldsResult, type SchemaListResult, type SchemaRemoveFieldCommandOptions, type SchemaRemoveFieldResult, type SchemaRemoveStatusCommandOptions, type SchemaRemoveStatusResult, type SchemaRemoveTypeCommandOptions, type SchemaRemoveTypeResult, type SchemaShowFieldResult, type SchemaShowResult, type SchemaShowStatusResult, type SchemaSubcommand } from "./schema.js";
 export type { ClaimResult, CloseResult, CopyResult, CreateResult, DeleteResult, FocusResult, ReleaseResult, RestoreResult, UpdateResult, };
 export { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks, } from "../core/extensions/index.js";
 export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic, } from "../core/fs/fs-utils.js";
@@ -75,7 +80,7 @@ export { renderCalendarMarkdown, renderCalendarToon, resolveCalendarOutputFormat
 export { renderGuideMarkdown, resolveGuideOutputFormat, runGuide, type GuideDepth, type GuideOptions, type GuideOutputFormat, type GuideResult, } from "../cli/commands/guide.js";
 export { runCompletion, type CompletionResult, type CompletionShell, } from "../cli/commands/completion.js";
 export { runReindex, type ReindexOptions, type ReindexResult, } from "../cli/commands/reindex.js";
-export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, type CreateTemplateOptions, type TemplatesListResult, type TemplatesSaveResult, type TemplatesShowResult, } from "../cli/commands/templates.js";
+export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, type CreateTemplateOptions, type TemplatesListResult, type TemplatesSaveResult, type TemplatesShowResult, } from "./templates.js";
 export { runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, type TestRunsListCommandOptions, type TestRunsLogsCommandOptions, type TestRunsResumeCommandOptions, type TestRunsStopCommandOptions, } from "../cli/commands/test-runs.js";
 export { CONFIDENCE_TEXT_VALUES, DEPENDENCY_KIND_VALUES, BUILTIN_ITEM_TYPE_VALUES, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, RISK_VALUES, STATUS_VALUES, } from "../types/index.js";
 export type { GlobalOptions } from "../core/shared/command-types.js";
@@ -304,6 +309,16 @@ export declare class PmClient {
     health(options?: RunHealthOptions): Promise<HealthResult>;
     /** Run tracker cache/runtime garbage collection. */
     gc(options?: GcCommandOptions): Promise<GcResult>;
+    /** Redact sensitive values while preserving an audited, verified history chain. */
+    historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>;
+    /** Repair and re-anchor one drifted history stream. */
+    historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>;
+    /** Scan and repair every drifted history stream in one resilient pass. */
+    historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>;
+    /** Compact one history stream into a verified checkpoint and retained tail. */
+    historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>;
+    /** Compact an explicit or policy-selected set of history streams. */
+    historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>;
     /** Run any typed plan workflow primitive through the shared CLI/MCP engine. */
     plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>;
     /** Create a durable plan with optional ordered seed steps. */
@@ -475,6 +490,16 @@ export declare function validate(options?: ValidateCommandOptions, clientOptions
 export declare function health(options?: RunHealthOptions, clientOptions?: PmClientOptions): Promise<HealthResult>;
 /** Run cache/runtime garbage collection without constructing a reusable client. */
 export declare function gc(options?: GcCommandOptions, clientOptions?: PmClientOptions): Promise<GcResult>;
+/** Redact one history stream without constructing a reusable client. */
+export declare function historyRedact(id: string, options: HistoryRedactCommandOptions, clientOptions?: PmClientOptions): Promise<HistoryRedactResult>;
+/** Repair one history stream without constructing a reusable client. */
+export declare function historyRepair(id: string, options?: HistoryRepairCommandOptions, clientOptions?: PmClientOptions): Promise<HistoryRepairResult>;
+/** Repair all drifted history streams without constructing a reusable client. */
+export declare function historyRepairAll(options?: HistoryRepairCommandOptions, clientOptions?: PmClientOptions): Promise<HistoryRepairAllResult>;
+/** Compact one history stream without constructing a reusable client. */
+export declare function historyCompact(id: string, options?: HistoryCompactCommandOptions, clientOptions?: PmClientOptions): Promise<HistoryCompactResult>;
+/** Compact selected history streams without constructing a reusable client. */
+export declare function historyCompactBulk(options: HistoryCompactBulkCommandOptions, clientOptions?: PmClientOptions): Promise<HistoryCompactBulkResult>;
 /** Create an item without constructing a reusable client. */
 export declare function create(options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<CreateResult>;
 /** Update an item without constructing a reusable client. */
@@ -537,8 +562,6 @@ export declare function upgrade(target?: string, options?: UpgradeCommandOptions
 export declare function getWorkspaceContracts(pmRoot: string, options?: WorkspaceContractsOptions): Promise<WorkspaceContracts>;
 /** Implements get contracts for the public runtime surface of this module. */
 export declare function getContracts(pmRootOrOptions?: string | GetContractsOptions, options?: GetContractsOptions): Promise<ContractsResult>;
-declare function readScalarString(args: Record<string, unknown>, key: string): string | undefined;
-declare function readScalarStringAllowBlank(args: Record<string, unknown>, key: string): string | undefined;
 /** Read a required non-empty string from an action argument bag. */
 export declare function readRequiredString(args: Record<string, unknown>, key: string): string;
 declare function globalOptions(args: Record<string, unknown>): GlobalOptions;

package/dist/sdk/runtime.js

@@ -4,7 +4,7 @@
  * Defines public SDK APIs and package-author helpers for Runtime.
  */
 
-!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")}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]="40c78d4e-1d6c-5910-a925-95fb87ebad82")}catch(e){}}();
 export { PM_GITIGNORE_END, PM_GITIGNORE_START, ensurePmGitignore, getPmGitignoreBlock, } from "./workspace.js";
 import path from "node:path";
 import { createEmptyExtensionCommandRegistry, createEmptyExtensionHookRegistry, createEmptyExtensionParserRegistry, createEmptyExtensionPreflightRegistry, createEmptyExtensionRegistrationRegistry, createEmptyExtensionRendererRegistry, createEmptyExtensionServiceRegistry, } from "../core/extensions/extension-registries.js";
@@ -23,12 +23,23 @@ import { normalizeListOptions, normalizeUpdateOptions, } from "../cli/registrati
 import { UPDATE_COMMANDER_STRING_OPTION_CONTRACTS } from "./cli-contracts/commander-mutation-options.js";
 import { clearWorkspaceContractsCache, memoizeWorkspaceExtensionRegistrations, } from "./workspace-contracts-cache.js";
 export { clearWorkspaceContractsCache } from "./workspace-contracts-cache.js";
-import { assertHistoryRepairTarget, runActivity, runAggregate, runAppend, runClaim, runClaimNext, runClose, runCloseMany, runComments, runConfig, runContext, runCopy, runCreate, runDelete, runExtension, runFocus, runGc, runGet, runHealth, runHistory, runHistoryCompact, runHistoryRedact, runHistoryRepair, runHistoryRepairAll, runInit, runLearnings, runList, runNext, runNotes, runPlan, runProfileApply, runProfileLint, runProfileList, runProfileShow, runRestore, runRelease, runSchemaAddField, runSchemaAddStatus, runSchemaAddType, runSchemaApplyPreset, runSchemaInferTypes, runSchemaList, runSchemaListFields, runSchemaRemoveField, runSchemaRemoveStatus, runSchemaRemoveType, runSchemaShow, runSchemaShowField, runSchemaShowStatus, runSearch, runStats, runTelemetry, runTest, runTestAll, runUpdate, runUpdateMany, runUpgrade, runValidate, } from "../cli/commands/index.js";
+import { runActivity, runAggregate, runAppend, runClaim, runClaimNext, runClose, runCloseMany, runComments, runContext, runCopy, runCreate, runDelete, runFocus, runGet, runHistory, runLearnings, runList, runNext, runNotes, runPlan, runRestore, runRelease, runSearch, runStats, runTelemetry, runTest, runTestAll, runUpdate, runUpdateMany, runUpgrade, } from "../cli/commands/index.js";
+import { runGc, } from "./governance/gc.js";
+import { runHealth, } from "./governance/health.js";
+import { runValidate, } from "./governance/validate.js";
+import { runExtension, } from "./extension.js";
+import { runConfig } from "./config.js";
+import { runInit } from "./init.js";
+import { runProfileApply, runProfileLint, runProfileList, runProfileShow, } from "./profile.js";
+import { runHistoryRedact, } from "./history-redact.js";
+import { runMcpHistoryCompactAction, runMcpHistoryRepairAction, } from "./history-mcp.js";
+import { isRuntimeRecord as isRecord, parseRuntimeInteger as parseMcpInteger, readRuntimeScalarString as readScalarString, readRuntimeScalarStringAllowBlank as readScalarStringAllowBlank, readRuntimeString as readString, } from "./runtime-input.js";
 import { runDeps } from "./dependencies.js";
 import { runDocs } from "./docs.js";
 import { runFiles, runFilesDiscover } from "./files.js";
 import { runContracts, } from "../cli/commands/contracts.js";
 import { resolveStartTaskInProgressStatus } from "./start-task-status.js";
+import { runSchemaAddField, runSchemaAddStatus, runSchemaAddType, runSchemaApplyPreset, runSchemaInferTypes, runSchemaList, runSchemaListFields, runSchemaRemoveField, runSchemaRemoveStatus, runSchemaRemoveType, runSchemaShow, runSchemaShowField, runSchemaShowStatus, } from "./schema.js";
 export { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks, } from "../core/extensions/index.js";
 export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic, } from "../core/fs/fs-utils.js";
 export { appendHistoryEntry, createHistoryEntry, } from "../core/history/history.js";
@@ -62,7 +73,7 @@ export { renderCalendarMarkdown, renderCalendarToon, resolveCalendarOutputFormat
 export { renderGuideMarkdown, resolveGuideOutputFormat, runGuide, } from "../cli/commands/guide.js";
 export { runCompletion, } from "../cli/commands/completion.js";
 export { runReindex, } from "../cli/commands/reindex.js";
-export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, } from "../cli/commands/templates.js";
+export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, } from "./templates.js";
 export { runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, } from "../cli/commands/test-runs.js";
 export { CONFIDENCE_TEXT_VALUES, DEPENDENCY_KIND_VALUES, BUILTIN_ITEM_TYPE_VALUES, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, RISK_VALUES, STATUS_VALUES, } from "../types/index.js";
 function splitFullClientMutationOptions(options) {
@@ -299,6 +310,28 @@ export class PmClient {
     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", {
@@ -699,6 +732,26 @@ export function health(options = {}, clientOptions = {}) {
 export function gc(options = {}, clientOptions = {}) {
     return new PmClient(clientOptions).gc(options);
 }
+/** Redact one history stream without constructing a reusable client. */
+export function historyRedact(id, options, clientOptions = {}) {
+    return new PmClient(clientOptions).historyRedact(id, options);
+}
+/** Repair one history stream without constructing a reusable client. */
+export function historyRepair(id, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).historyRepair(id, options);
+}
+/** Repair all drifted history streams without constructing a reusable client. */
+export function historyRepairAll(options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).historyRepairAll(options);
+}
+/** Compact one history stream without constructing a reusable client. */
+export function historyCompact(id, options = {}, clientOptions = {}) {
+    return new PmClient(clientOptions).historyCompact(id, options);
+}
+/** Compact selected history streams without constructing a reusable client. */
+export function historyCompactBulk(options, clientOptions = {}) {
+    return new PmClient(clientOptions).historyCompactBulk(options);
+}
 /** Create an item without constructing a reusable client. */
 export function create(options = {}, clientOptions = {}) {
     return new PmClient(clientOptions).create(options);
@@ -874,33 +927,6 @@ export async function getContracts(pmRootOrOptions, options = {}) {
     };
     return runContracts(resolvedOptions, global);
 }
-function readString(args, key) {
-    const value = args[key];
-    return typeof value === "string" && value.trim().length > 0
-        ? value
-        : undefined;
-}
-function readScalarString(args, key) {
-    const value = args[key];
-    if (typeof value === "string") {
-        return value.trim().length > 0 ? value : undefined;
-    }
-    return typeof value === "number" && Number.isFinite(value)
-        ? String(value)
-        : undefined;
-}
-function readScalarStringAllowBlank(args, key) {
-    const value = args[key];
-    if (typeof value === "string") {
-        return value;
-    }
-    return typeof value === "number" && Number.isFinite(value)
-        ? String(value)
-        : undefined;
-}
-function isRecord(value) {
-    return value !== null && typeof value === "object" && !Array.isArray(value);
-}
 /** Read a required non-empty string from an action argument bag. */
 export function readRequiredString(args, key) {
     const value = readString(args, key);
@@ -1745,30 +1771,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 undefined;
-}
 function parseMcpIntegerPrefix(value, label) {
     if (typeof value === "number") {
         if (!Number.isFinite(value) || !Number.isInteger(value)) {
@@ -2064,7 +2066,9 @@ const 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, global) => runUpdate(id, options, global),
+    }),
     health: runMcpHealthAction,
     contracts: (ctx) => runContracts(ctx.options, ctx.global),
     config: runMcpConfigAction,
@@ -2080,7 +2084,7 @@ const 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,
@@ -2151,4 +2155,4 @@ async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
     }
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=9c1f10e3-4133-54a5-a291-2da372570428
+//# debugId=40c78d4e-1d6c-5910-a925-95fb87ebad82