@unbrained/pm-cli 2026.10.12 → 2026.10.14

package/dist/sdk/lifecycle/restore.d.ts

@@ -2,37 +2,37 @@ import { type GlobalOptions, locateItem, readSettings } from "../runtime-primiti
 import { applyHistoryPatch, ensureMaterializedHistoryTarget as ensureMaterializedRestoreTarget, extractPatchFailureContext, replayHistoryToTarget as replayToTarget } from "../history-read.js";
 import type { HistoryEntry, ItemDocument, ItemMetadata } from "../../types/index.js";
 interface ResolvedRestoreSubject {
-    id: string;
-    historyPath: string;
-    located: Awaited<ReturnType<typeof locateItem>>;
-    historyPolicyWarnings: string[];
+id: string;
+historyPath: string;
+located: Awaited<ReturnType<typeof locateItem>>;
+historyPolicyWarnings: string[];
 }
 /** Documents the restore command options payload exchanged by command, SDK, and package integrations. */
 export interface RestoreCommandOptions {
-    /** Value that configures or reports author for this contract. */
-    author?: string;
-    /** Human-readable explanation suitable for logs and agent-facing output. */
-    message?: string;
-    /** Value that configures or reports force for this contract. */
-    force?: boolean;
+/** Value that configures or reports author for this contract. */
+author?: string;
+/** Human-readable explanation suitable for logs and agent-facing output. */
+message?: string;
+/** Value that configures or reports force for this contract. */
+force?: boolean;
 }
 /** Documents the restore result payload exchanged by command, SDK, and package integrations. */
 export interface RestoreResult {
-    /** Value that configures or reports item for this contract. */
-    item: ItemMetadata;
-    /** Value that configures or reports restored from for this contract. */
-    restored_from: {
-        kind: "version" | "timestamp";
-        target: string;
-        history_index: number;
-        version: number | null;
-        entry_ts: string;
-        entry_op: string;
-    };
-    /** Value that configures or reports changed fields for this contract. */
-    changed_fields: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
+/** Value that configures or reports item for this contract. */
+item: ItemMetadata;
+/** Value that configures or reports restored from for this contract. */
+restored_from: {
+kind: "version" | "timestamp";
+target: string;
+history_index: number;
+version: number | null;
+entry_ts: string;
+entry_op: string;
+};
+/** Value that configures or reports changed fields for this contract. */
+changed_fields: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 /** Resolve restore targets with the command's established wording and at-or-before timestamp semantics. */
 declare function ensureReplayTarget(target: string, history: readonly HistoryEntry[]): import("../../core/history/projection.js").ResolvedHistoryTarget;
@@ -44,13 +44,13 @@ declare function changedFields(beforeDocument: ItemDocument, afterDocument: Item
 export declare function runRestore(id: string, target: string, options: RestoreCommandOptions, global: GlobalOptions): Promise<RestoreResult>;
 /** Public contract for test only restore command, shared by SDK and presentation-layer consumers. */
 export declare const _testOnlyRestoreCommand: {
-    applyHistoryPatch: typeof applyHistoryPatch;
-    changedFields: typeof changedFields;
-    ensureMaterializedRestoreTarget: typeof ensureMaterializedRestoreTarget;
-    ensureReplayTarget: typeof ensureReplayTarget;
-    extractPatchFailureContext: typeof extractPatchFailureContext;
-    replayCurrentDocument: typeof replayCurrentDocument;
-    replayToTarget: typeof replayToTarget;
-    resolveRestoreSubject: typeof resolveRestoreSubject;
+applyHistoryPatch: typeof applyHistoryPatch;
+changedFields: typeof changedFields;
+ensureMaterializedRestoreTarget: typeof ensureMaterializedRestoreTarget;
+ensureReplayTarget: typeof ensureReplayTarget;
+extractPatchFailureContext: typeof extractPatchFailureContext;
+replayCurrentDocument: typeof replayCurrentDocument;
+replayToTarget: typeof replayToTarget;
+resolveRestoreSubject: typeof resolveRestoreSubject;
 };
 export {};

package/dist/sdk/lifecycle/shared-unset-fields.d.ts

@@ -6,14 +6,14 @@
 import { type RuntimeFieldCommand, type RuntimeFieldRegistry } from "../runtime-primitives.js";
 /** Describes one command option that can be removed from item metadata through `--unset`. */
 export interface CommandUnsetFieldDefinition {
-    /** Value that configures or reports canonical for this contract. */
-    canonical: string;
-    /** Value that configures or reports aliases for this contract. */
-    aliases: readonly string[];
-    /** Value that configures or reports option key for this contract. */
-    optionKey: string;
-    /** Value that configures or reports item metadata key for this contract. */
-    metadataKey: string;
+/** Value that configures or reports canonical for this contract. */
+canonical: string;
+/** Value that configures or reports aliases for this contract. */
+aliases: readonly string[];
+/** Value that configures or reports option key for this contract. */
+optionKey: string;
+/** Value that configures or reports item metadata key for this contract. */
+metadataKey: string;
 }
 /** Public contract for common unset field definitions before close reason, shared by SDK and presentation-layer consumers. */
 export declare const COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_CLOSE_REASON: readonly CommandUnsetFieldDefinition[];
@@ -25,25 +25,25 @@ export declare const COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR: readonly Comm
 export declare const COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR: readonly CommandUnsetFieldDefinition[];
 /** Result of matching a runtime schema field against a command `--unset` token. */
 export interface RuntimeUnsetFieldDefinition {
-    /** Value that configures or reports option key for this contract. */
-    optionKey: string;
-    /** Value that configures or reports item metadata key for this contract. */
-    metadataKey: string;
+/** Value that configures or reports option key for this contract. */
+optionKey: string;
+/** Value that configures or reports item metadata key for this contract. */
+metadataKey: string;
 }
 /** Result of parsing command-level `--unset` tokens into metadata and option-key sets. */
 export interface ParsedCommandUnsetTargets {
-    /** Value that configures or reports item metadata keys for this contract. */
-    metadataKeys: Set<string>;
-    /** Value that configures or reports option keys for this contract. */
-    optionKeys: Set<string>;
+/** Value that configures or reports item metadata keys for this contract. */
+metadataKeys: Set<string>;
+/** Value that configures or reports option keys for this contract. */
+optionKeys: Set<string>;
 }
 /** Resolve one normalized `--unset` token to a item-metadata/option pair. */
 export type CommandUnsetTargetResolver = (trimmedToken: string) => RuntimeUnsetFieldDefinition | undefined;
 /** Parse and validate common command `--unset` tokens while preserving command-specific field resolution. */
 export declare function parseCommandUnsetTargets(options: {
-    readonly raw: readonly string[] | undefined;
-    readonly resolveDefinition: CommandUnsetTargetResolver;
-    readonly supportedFields: string;
+readonly raw: readonly string[] | undefined;
+readonly resolveDefinition: CommandUnsetTargetResolver;
+readonly supportedFields: string;
 }): ParsedCommandUnsetTargets;
 /** Resolve a runtime-schema field definition from a command `--unset` token. */
 export declare function resolveRuntimeUnsetFieldDefinition(token: string, command: RuntimeFieldCommand, runtimeFieldRegistry: RuntimeFieldRegistry | undefined): RuntimeUnsetFieldDefinition | undefined;

package/dist/sdk/lifecycle/task-composition.d.ts

@@ -4,10 +4,10 @@ import { type CloseCommandOptions } from "./close.js";
 import type { StartTaskResult, PauseTaskResult, CloseTaskResult } from "../runtime-public-contracts.js";
 /** Ownership inputs shared by the explicit-item start and pause compositions. */
 export interface TaskCompositionOptions extends ClaimMutationOptions {
-    /** Permit the same ownership and terminal overrides as constituent mutations. */
-    force?: boolean;
-    /** Ranked selection cannot be combined with an explicit-item composition. */
-    next?: boolean;
+/** Permit the same ownership and terminal overrides as constituent mutations. */
+force?: boolean;
+/** Ranked selection cannot be combined with an explicit-item composition. */
+next?: boolean;
 }
 /** Preserve a failed step's diagnostics while reporting the earlier durable mutation, without implying rollback. */
 export declare function finishComposition<T>(id: string, completed: "claim" | "update" | "close", operation: () => Promise<T>): Promise<T>;

package/dist/sdk/lifecycle/update-many.d.ts

@@ -6,102 +6,102 @@ import { type UpdateCommandOptions } from "./update.js";
 import { type PmCommandEffectReceipt } from "../cli-contracts/command-exit-contracts.js";
 /** Documents the update many command options payload exchanged by command, SDK, and package integrations. */
 export interface UpdateManyCommandOptions {
-    /** Lifecycle state reported for status. */
-    status?: string;
-    /** Value that configures or reports list for this contract. */
-    list: ListOptions;
-    /** Value that configures or reports update for this contract. */
-    update: UpdateCommandOptions;
-    /** Value that configures or reports dry run for this contract. */
-    dryRun?: boolean;
-    /** Value that configures or reports rollback for this contract. */
-    rollback?: string;
-    /** Value that configures or reports checkpoint for this contract. */
-    checkpoint?: boolean;
+/** Lifecycle state reported for status. */
+status?: string;
+/** Value that configures or reports list for this contract. */
+list: ListOptions;
+/** Value that configures or reports update for this contract. */
+update: UpdateCommandOptions;
+/** Value that configures or reports dry run for this contract. */
+dryRun?: boolean;
+/** Value that configures or reports rollback for this contract. */
+rollback?: string;
+/** Value that configures or reports checkpoint for this contract. */
+checkpoint?: boolean;
 }
 /** Presentation-neutral input accepted by the SDK-owned bulk update operation. */
 export type UpdateManyOperationOptions = UpdateManyCommandOptions;
 interface PlannedChange {
-    field: string;
-    before: unknown;
-    after: unknown;
+field: string;
+before: unknown;
+after: unknown;
 }
 interface PlannedItemDiff {
-    id: string;
-    changes: PlannedChange[];
-    warnings?: string[];
+id: string;
+changes: PlannedChange[];
+warnings?: string[];
 }
 interface UpdateManyApplyResultRow {
-    id: string;
-    status: "updated" | "failed" | "skipped";
-    changed_fields?: string[];
-    warnings?: string[];
-    error?: string;
+id: string;
+status: "updated" | "failed" | "skipped";
+changed_fields?: string[];
+warnings?: string[];
+error?: string;
 }
 interface UpdateManyRollbackResultRow {
-    id: string;
-    status: "restored" | "failed";
-    changed_fields?: string[];
-    warnings?: string[];
-    error?: string;
+id: string;
+status: "restored" | "failed";
+changed_fields?: string[];
+warnings?: string[];
+error?: string;
 }
 /** Documents the update many result payload exchanged by command, SDK, and package integrations. */
 export interface UpdateManyResult extends PmCommandEffectReceipt {
-    /** Value that configures or reports mode for this contract. */
-    mode: "dry_run" | "apply" | "rollback";
-    /** Number of matched entries represented by this result. */
-    matched_count: number;
-    /** Value that configures or reports dry run for this contract. */
-    dry_run: boolean;
-    /** Value that configures or reports filters for this contract. */
-    filters?: Record<string, unknown>;
-    /** Inputs that customize the planned update operation. */
-    planned_update_options?: Record<string, unknown>;
-    /** Value that configures or reports item plans for this contract. */
-    item_plans?: PlannedItemDiff[];
-    /** Value that configures or reports checkpoint for this contract. */
-    checkpoint?: {
-        id: string;
-        created_at: string;
-        path: string;
-        rollback_command: string;
-    };
-    /** Number of updated entries represented by this result. */
-    updated_count?: number;
-    /** Number of skipped entries represented by this result. */
-    skipped_count?: number;
-    /** Number of failed entries represented by this result. */
-    failed_count?: number;
-    /** Number of restored entries represented by this result. */
-    restored_count?: number;
-    /** Value that configures or reports rollback checkpoint id for this contract. */
-    rollback_checkpoint_id?: string;
-    /** Value that configures or reports rows for this contract. */
-    rows?: UpdateManyApplyResultRow[] | UpdateManyRollbackResultRow[];
-    /** Value that configures or reports ids for this contract. */
-    ids: string[];
-    /** Explicitly requested --ids values that matched no tracked item. */
-    unmatched_ids?: string[];
-    /** Number of explicitly requested --ids values that matched no tracked item. */
-    unmatched_count?: number;
+/** Value that configures or reports mode for this contract. */
+mode: "dry_run" | "apply" | "rollback";
+/** Number of matched entries represented by this result. */
+matched_count: number;
+/** Value that configures or reports dry run for this contract. */
+dry_run: boolean;
+/** Value that configures or reports filters for this contract. */
+filters?: Record<string, unknown>;
+/** Inputs that customize the planned update operation. */
+planned_update_options?: Record<string, unknown>;
+/** Value that configures or reports item plans for this contract. */
+item_plans?: PlannedItemDiff[];
+/** Value that configures or reports checkpoint for this contract. */
+checkpoint?: {
+id: string;
+created_at: string;
+path: string;
+rollback_command: string;
+};
+/** Number of updated entries represented by this result. */
+updated_count?: number;
+/** Number of skipped entries represented by this result. */
+skipped_count?: number;
+/** Number of failed entries represented by this result. */
+failed_count?: number;
+/** Number of restored entries represented by this result. */
+restored_count?: number;
+/** Value that configures or reports rollback checkpoint id for this contract. */
+rollback_checkpoint_id?: string;
+/** Value that configures or reports rows for this contract. */
+rows?: UpdateManyApplyResultRow[] | UpdateManyRollbackResultRow[];
+/** Value that configures or reports ids for this contract. */
+ids: string[];
+/** Explicitly requested --ids values that matched no tracked item. */
+unmatched_ids?: string[];
+/** Number of explicitly requested --ids values that matched no tracked item. */
+unmatched_count?: number;
 }
 /** Implements run update many for the public runtime surface of this module. */
 export declare const runUpdateMany: (options: UpdateManyCommandOptions, global: GlobalOptions) => Promise<UpdateManyResult>;
 /** Public contract for test only update many command, shared by SDK and presentation-layer consumers. */
 export declare const _testOnlyUpdateManyCommand: {
-    assertPlannedUpdateValuesValid: (update: UpdateCommandOptions, settings: PmSettings, statusRegistry: RuntimeStatusRegistry, pmRoot: string) => void;
-    buildCollectionMutationPlans: (row: Record<string, unknown>, update: UpdateCommandOptions) => PlannedChange[];
-    buildPlannedItemDiff: (item: ListedItem, runtimeFieldRegistry: RuntimeFieldRegistry, update?: UpdateCommandOptions) => PlannedItemDiff;
-    buildTagMutationPlan: (row: Record<string, unknown>, update: UpdateCommandOptions) => PlannedChange | undefined;
-    collectionValueCount: (field: string, value: unknown) => number;
-    hasAnyUpdateMutationInput: (options: UpdateCommandOptions) => boolean;
-    hasListFilters: typeof hasListFilters;
-    normalizeStatusFilter: (value: string | undefined, statusRegistry: RuntimeStatusRegistry) => ItemStatus[] | undefined;
-    normalizeCollectionBeforeValue: (field: string, value: unknown) => unknown;
-    normalizeExistingTags: (value: unknown) => string[];
-    normalizeUnsetField: (rawField: string) => string;
-    rejectBlankIdsFilter: (list: ListOptions | undefined) => void;
-    sanitizeUpdateOptionsForSummary: (options: UpdateCommandOptions) => Record<string, unknown>;
-    toComparablePreviewValue: (optionKey: keyof UpdateCommandOptions, value: unknown) => unknown;
+assertPlannedUpdateValuesValid: (update: UpdateCommandOptions, settings: PmSettings, statusRegistry: RuntimeStatusRegistry, pmRoot: string) => void;
+buildCollectionMutationPlans: (row: Record<string, unknown>, update: UpdateCommandOptions) => PlannedChange[];
+buildPlannedItemDiff: (item: ListedItem, runtimeFieldRegistry: RuntimeFieldRegistry, update?: UpdateCommandOptions) => PlannedItemDiff;
+buildTagMutationPlan: (row: Record<string, unknown>, update: UpdateCommandOptions) => PlannedChange | undefined;
+collectionValueCount: (field: string, value: unknown) => number;
+hasAnyUpdateMutationInput: (options: UpdateCommandOptions) => boolean;
+hasListFilters: typeof hasListFilters;
+normalizeStatusFilter: (value: string | undefined, statusRegistry: RuntimeStatusRegistry) => ItemStatus[] | undefined;
+normalizeCollectionBeforeValue: (field: string, value: unknown) => unknown;
+normalizeExistingTags: (value: unknown) => string[];
+normalizeUnsetField: (rawField: string) => string;
+rejectBlankIdsFilter: (list: ListOptions | undefined) => void;
+sanitizeUpdateOptionsForSummary: (options: UpdateCommandOptions) => Record<string, unknown>;
+toComparablePreviewValue: (optionKey: keyof UpdateCommandOptions, value: unknown) => unknown;
 };
 export {};