@unbrained/pm-cli 2026.10.11 → 2026.10.13

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

@@ -1,165 +1,164 @@
 import { resolveItemTypeRegistry, type RuntimeFieldRegistry, type RuntimeStatusRegistry, type NormalizedTypeWorkflow, type GlobalOptions, PmCliError, getActiveExtensionRegistrations, readSettings } from "../runtime-primitives.js";
 import type { Dependency, GovernanceWorkflowEnforcement, ItemDocument } from "../../types/index.js";
-import { DEPENDENCY_KIND_VALUES } from "../../types/index.js";
 import { parseDocs, parseFiles, parseLogSeed, parseTests } from "./create.js";
 import type { MutationMetadataCommandOptions, SharedLinkedResourceClearOptions, SharedLinkedResourceOptions } from "./mutation-command-options.js";
 /** Documents the update command options payload exchanged by command, SDK, and package integrations. */
 export interface UpdateCommandOptions extends MutationMetadataCommandOptions, SharedLinkedResourceOptions, SharedLinkedResourceClearOptions {
-    /** Value that configures or reports title for this contract. */
-    title?: string;
-    /** Value that configures or reports description for this contract. */
-    description?: string;
-    /** Value that configures or reports body for this contract. */
-    body?: string;
-    /** Persisted annotations in a full-item JSON round trip, checked under the item lock. */
-    documentAnnotationSnapshot?: Partial<Record<"comments" | "notes" | "learnings", unknown[]>>;
-    /** Lifecycle state reported for status. */
-    status?: string;
-    /** Value that configures or reports close reason for this contract. */
-    closeReason?: string;
-    /** Correct the actual completion time on a terminal item. */
-    completedAt?: string;
-    /** Value that configures or reports priority for this contract. */
-    priority?: string | number;
-    /** Schema type that determines the shape and validation rules for this value. */
-    type?: string;
-    /** Value that configures or reports tags for this contract. */
-    tags?: string;
-    /** Value that configures or reports add tags for this contract. */
-    addTags?: string[];
-    /** Value that configures or reports remove tags for this contract. */
-    removeTags?: string[];
-    /** Acceptance criteria appended individually without replacing the existing list. */
-    addAc?: string[];
-    /** Acceptance criteria removed individually by exact text match. */
-    removeAc?: string[];
-    /** Value that configures or reports force for this contract. */
-    force?: boolean;
-    /** Permit an intentional unresolved parent reference under strict validation. */
-    allowMissingParent?: boolean;
-    /** Explicitly permit unresolved local dependency targets with warning receipts. */
-    allowUnresolvedDeps?: boolean;
-    /** Value that configures or reports dep remove for this contract. */
-    depRemove?: string[];
-    /** Value that configures or reports replace deps for this contract. */
-    replaceDeps?: boolean;
-    /** Value that configures or reports replace tests for this contract. */
-    replaceTests?: boolean;
-    /** Atomically replace linked files with the supplied file entries. */
-    replaceFiles?: boolean;
-    /** Atomically replace linked docs with the supplied doc entries. */
-    replaceDocs?: boolean;
-    /** Value that configures or reports runtime field commands for this contract. */
-    runtimeFieldCommands?: Array<"update" | "update_many">;
-    [key: string]: unknown;
+/** Value that configures or reports title for this contract. */
+title?: string;
+/** Value that configures or reports description for this contract. */
+description?: string;
+/** Value that configures or reports body for this contract. */
+body?: string;
+/** Persisted annotations in a full-item JSON round trip, checked under the item lock. */
+documentAnnotationSnapshot?: Partial<Record<"comments" | "notes" | "learnings", unknown[]>>;
+/** Lifecycle state reported for status. */
+status?: string;
+/** Value that configures or reports close reason for this contract. */
+closeReason?: string;
+/** Correct the actual completion time on a terminal item. */
+completedAt?: string;
+/** Value that configures or reports priority for this contract. */
+priority?: string | number;
+/** Schema type that determines the shape and validation rules for this value. */
+type?: string;
+/** Value that configures or reports tags for this contract. */
+tags?: string;
+/** Value that configures or reports add tags for this contract. */
+addTags?: string[];
+/** Value that configures or reports remove tags for this contract. */
+removeTags?: string[];
+/** Acceptance criteria appended individually without replacing the existing list. */
+addAc?: string[];
+/** Acceptance criteria removed individually by exact text match. */
+removeAc?: string[];
+/** Value that configures or reports force for this contract. */
+force?: boolean;
+/** Permit an intentional unresolved parent reference under strict validation. */
+allowMissingParent?: boolean;
+/** Explicitly permit unresolved local dependency targets with warning receipts. */
+allowUnresolvedDeps?: boolean;
+/** Value that configures or reports dep remove for this contract. */
+depRemove?: string[];
+/** Value that configures or reports replace deps for this contract. */
+replaceDeps?: boolean;
+/** Value that configures or reports replace tests for this contract. */
+replaceTests?: boolean;
+/** Atomically replace linked files with the supplied file entries. */
+replaceFiles?: boolean;
+/** Atomically replace linked docs with the supplied doc entries. */
+replaceDocs?: boolean;
+/** Value that configures or reports runtime field commands for this contract. */
+runtimeFieldCommands?: Array<"update" | "update_many">;
+[key: string]: unknown;
 }
 /** Presentation-neutral input accepted by the SDK-owned update operation. */
 export type UpdateOperationOptions = UpdateCommandOptions;
 /** Documents the update result payload exchanged by command, SDK, and package integrations. */
 export interface UpdateResult {
-    /** Value that configures or reports item for this contract. */
-    item: Record<string, unknown>;
-    /** 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: Record<string, unknown>;
+/** Value that configures or reports changed fields for this contract. */
+changed_fields: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
 }
 /** Terminal evidence captured atomically before a recurrence transition. */
 export interface PreviousTerminalEvidence {
-    /** Prior close reason, when recorded. */
-    close_reason?: string;
-    /** Prior structured resolution, when recorded. */
-    resolution?: string;
-    /** Prior expected result, when recorded. */
-    expected_result?: string;
-    /** Prior actual result, when recorded. */
-    actual_result?: string;
-    /** Prior fixed version, when recorded. */
-    fixed_version?: string;
+/** Prior close reason, when recorded. */
+close_reason?: string;
+/** Prior structured resolution, when recorded. */
+resolution?: string;
+/** Prior expected result, when recorded. */
+expected_result?: string;
+/** Prior actual result, when recorded. */
+actual_result?: string;
+/** Prior fixed version, when recorded. */
+fixed_version?: string;
 }
 /** Internal update-path receipt consumed by the public recurrence primitive. */
 export interface ReopenUpdateReceipt {
-    /** Recurrence reason stored in immutable history context. */
-    reason: string;
-    /** Terminal status observed while holding the item lock. */
-    from_status: string;
-    /** Active status written by the update path. */
-    to_status: string;
-    /** Terminal evidence removed from active metadata but retained in history. */
-    previous_terminal: PreviousTerminalEvidence;
+/** Recurrence reason stored in immutable history context. */
+reason: string;
+/** Terminal status observed while holding the item lock. */
+from_status: string;
+/** Active status written by the update path. */
+to_status: string;
+/** Terminal evidence removed from active metadata but retained in history. */
+previous_terminal: PreviousTerminalEvidence;
 }
 /** Update result carrying the recurrence receipt produced by the locked transition. */
 export interface ReopenUpdateResult extends UpdateResult {
-    /** Lifecycle-specific receipt populated by the recurrence primitive. */
-    lifecycle_transition: ReopenUpdateReceipt;
+/** Lifecycle-specific receipt populated by the recurrence primitive. */
+lifecycle_transition: ReopenUpdateReceipt;
 }
 declare function normalizeLegacyNoneUpdateOptions(options: UpdateCommandOptions): UpdateCommandOptions;
 declare function parseUpdateUnsetTargets(raw: string[] | undefined, runtimeFieldRegistry?: RuntimeFieldRegistry, extensionFieldNames?: readonly string[]): {
-    metadataKeys: Set<string>;
-    optionKeys: Set<string>;
+metadataKeys: Set<string>;
+optionKeys: Set<string>;
 };
 declare function buildOwnershipBypassRestrictedOptionsError(params: {
-    id: string;
-    code: string;
-    message: string;
-    required: string;
-    why: string;
-    disallowedFlags: string[];
+id: string;
+code: string;
+message: string;
+required: string;
+why: string;
+disallowedFlags: string[];
 }): PmCliError;
 declare function enforceOwnershipBypassScope(id: string, options: UpdateCommandOptions, clearItemMetadataKeys: Set<string>): void;
 /** Enforce per-type allowed-transition rules (governance.workflow_enforcement). `off` (default) or an unrestricted type is a no-op. `strict` throws on a disallowed transition; `warn` returns a warning string surfaced on the update result. The target status is the raw `--status` value (resolved case-insensitively through the registry inside evaluateTransition). */
 declare function enforceTypeWorkflowTransition(params: {
-    enforcement: GovernanceWorkflowEnforcement;
-    typeWorkflows: NormalizedTypeWorkflow[];
-    statusRegistry: RuntimeStatusRegistry;
-    typeName: string;
-    fromStatus: string;
-    toStatus: string;
+enforcement: GovernanceWorkflowEnforcement;
+typeWorkflows: NormalizedTypeWorkflow[];
+statusRegistry: RuntimeStatusRegistry;
+typeName: string;
+fromStatus: string;
+toStatus: string;
 }): string | undefined;
 interface ParsedDependencyUpdates {
-    additions: Dependency[];
+additions: Dependency[];
 }
 interface DependencyRemovalSelector {
-    id: string;
-    kind?: (typeof DEPENDENCY_KIND_VALUES)[number];
-    source_kind?: string;
-    author?: string;
-    created_at?: string;
+id: string;
+kind?: string;
+source_kind?: string;
+author?: string;
+created_at?: string;
 }
 /** Parse dependency additions into their canonical storage representation. */
 export declare function parseDependencyAdditions(raw: string[] | undefined, prefix: string, nowIso: string, fallbackAuthor: string): ParsedDependencyUpdates;
 declare function parseDependencyRemovals(raw: string[] | undefined, prefix: string): DependencyRemovalSelector[];
 declare function reconcileBlockedByDependency(current: Dependency[] | undefined, nextBlockedById: string | undefined, nowIsoValue: string, author: string): {
-    dependencies: Dependency[] | undefined;
-    changed: boolean;
+dependencies: Dependency[] | undefined;
+changed: boolean;
 };
 declare function matchesDependencySelector(value: Dependency, selector: DependencyRemovalSelector): boolean;
 declare function normalizeUpdatePolicyOptionKey(raw: string, typeName: string): string;
 declare function collectProvidedUpdatePolicyOptions(options: UpdateCommandOptions, runtimeFieldRegistry: RuntimeFieldRegistry, extensionFieldNames: readonly string[]): Set<string>;
 interface UpdateMutationContext {
-    options: UpdateCommandOptions;
-    settings: Awaited<ReturnType<typeof readSettings>>;
-    typeRegistry: ReturnType<typeof resolveItemTypeRegistry>;
-    statusRegistry: RuntimeStatusRegistry;
-    runtimeFieldRegistry: RuntimeFieldRegistry;
-    extensionRegistrations: ReturnType<typeof getActiveExtensionRegistrations>;
-    extensionFieldNames: readonly string[];
-    clearItemMetadataKeys: ReadonlySet<string>;
-    dependencyUpdates: ParsedDependencyUpdates;
-    dependencyRemovals: DependencyRemovalSelector[];
-    commentUpdates: ReturnType<typeof parseLogSeed>;
-    noteUpdates: ReturnType<typeof parseLogSeed>;
-    learningUpdates: ReturnType<typeof parseLogSeed>;
-    fileUpdates: ReturnType<typeof parseFiles>;
-    testUpdates: ReturnType<typeof parseTests>;
-    docUpdates: ReturnType<typeof parseDocs>;
-    resolvedParentValue: string | undefined;
-    resolvedBlockedByDependencyId: string | undefined;
-    runtimeFieldUpdates: Record<string, unknown>;
-    nowValue: Date;
-    nowIso: string;
-    author: string;
-    pmRoot: string;
+options: UpdateCommandOptions;
+settings: Awaited<ReturnType<typeof readSettings>>;
+typeRegistry: ReturnType<typeof resolveItemTypeRegistry>;
+statusRegistry: RuntimeStatusRegistry;
+runtimeFieldRegistry: RuntimeFieldRegistry;
+extensionRegistrations: ReturnType<typeof getActiveExtensionRegistrations>;
+extensionFieldNames: readonly string[];
+clearItemMetadataKeys: ReadonlySet<string>;
+dependencyUpdates: ParsedDependencyUpdates;
+dependencyRemovals: DependencyRemovalSelector[];
+commentUpdates: ReturnType<typeof parseLogSeed>;
+noteUpdates: ReturnType<typeof parseLogSeed>;
+learningUpdates: ReturnType<typeof parseLogSeed>;
+fileUpdates: ReturnType<typeof parseFiles>;
+testUpdates: ReturnType<typeof parseTests>;
+docUpdates: ReturnType<typeof parseDocs>;
+resolvedParentValue: string | undefined;
+resolvedBlockedByDependencyId: string | undefined;
+runtimeFieldUpdates: Record<string, unknown>;
+nowValue: Date;
+nowIso: string;
+author: string;
+pmRoot: string;
 }
 /** Resolve update stdin tokens once while preserving transport-marked literals. */
 export declare function resolveUpdateTransportOptions(options: UpdateCommandOptions): Promise<UpdateCommandOptions>;
@@ -173,18 +172,18 @@ export declare function runUpdate(id: string, options: UpdateCommandOptions, glo
 export declare function runReopenUpdate(id: string, options: UpdateCommandOptions, global: GlobalOptions, recurrenceReason: string): Promise<ReopenUpdateResult>;
 /** Public contract for test only update command, shared by SDK and presentation-layer consumers. */
 export declare const _testOnlyUpdateCommand: {
-    applyStatusAndCloseReasonMutations: typeof applyStatusAndCloseReasonMutations;
-    collectProvidedUpdatePolicyOptions: typeof collectProvidedUpdatePolicyOptions;
-    buildOwnershipBypassRestrictedOptionsError: typeof buildOwnershipBypassRestrictedOptionsError;
-    enforceOwnershipBypassScope: typeof enforceOwnershipBypassScope;
-    enforceTypeWorkflowTransition: typeof enforceTypeWorkflowTransition;
-    matchesDependencySelector: typeof matchesDependencySelector;
-    normalizeLegacyNoneUpdateOptions: typeof normalizeLegacyNoneUpdateOptions;
-    normalizeUpdatePolicyOptionKey: typeof normalizeUpdatePolicyOptionKey;
-    parseDependencyAdditions: typeof parseDependencyAdditions;
-    parseDependencyRemovals: typeof parseDependencyRemovals;
-    parseUpdateUnsetTargets: typeof parseUpdateUnsetTargets;
-    reconcileBlockedByDependency: typeof reconcileBlockedByDependency;
-    resolveRuntimeUnsetDefinition: (token: string, registry: RuntimeFieldRegistry | undefined) => import("./shared-unset-fields.js").RuntimeUnsetFieldDefinition | undefined;
+applyStatusAndCloseReasonMutations: typeof applyStatusAndCloseReasonMutations;
+collectProvidedUpdatePolicyOptions: typeof collectProvidedUpdatePolicyOptions;
+buildOwnershipBypassRestrictedOptionsError: typeof buildOwnershipBypassRestrictedOptionsError;
+enforceOwnershipBypassScope: typeof enforceOwnershipBypassScope;
+enforceTypeWorkflowTransition: typeof enforceTypeWorkflowTransition;
+matchesDependencySelector: typeof matchesDependencySelector;
+normalizeLegacyNoneUpdateOptions: typeof normalizeLegacyNoneUpdateOptions;
+normalizeUpdatePolicyOptionKey: typeof normalizeUpdatePolicyOptionKey;
+parseDependencyAdditions: typeof parseDependencyAdditions;
+parseDependencyRemovals: typeof parseDependencyRemovals;
+parseUpdateUnsetTargets: typeof parseUpdateUnsetTargets;
+reconcileBlockedByDependency: typeof reconcileBlockedByDependency;
+resolveRuntimeUnsetDefinition: (token: string, registry: RuntimeFieldRegistry | undefined) => import("./shared-unset-fields.js").RuntimeUnsetFieldDefinition | undefined;
 };
 export {};