@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/core/item/item-format.d.ts

@@ -3,24 +3,24 @@ import type { ItemFormat } from "../../types/index.js";
 import { type RuntimeFieldRegistry, type RuntimeStatusRegistry } from "../schema/runtime-schema.js";
 declare function firstNonZeroComparison(comparisons: readonly number[]): number;
 interface RuntimeSchemaValidationContext {
-    statusRegistry?: RuntimeStatusRegistry;
-    fieldRegistry?: RuntimeFieldRegistry;
-    unknownFieldPolicy: "allow" | "warn" | "reject";
-    extensionFieldNames: ReadonlySet<string>;
-    onWarning?: (warning: string) => void;
+statusRegistry?: RuntimeStatusRegistry;
+fieldRegistry?: RuntimeFieldRegistry;
+unknownFieldPolicy: "allow" | "warn" | "reject";
+extensionFieldNames: ReadonlySet<string>;
+onWarning?: (warning: string) => void;
 }
 /** Documents the item document format options payload exchanged by command, SDK, and package integrations. */
 export interface ItemDocumentFormatOptions {
-    /** Value that configures or reports format for this contract. */
-    format?: ItemFormat;
-    /** Value that configures or reports schema for this contract. */
-    schema?: RuntimeSchemaSettings;
-    /** Value that configures or reports extension field names for this contract. */
-    extensionFieldNames?: readonly string[];
-    /** Value that configures or reports on warning for this contract. */
-    onWarning?: (warning: string) => void;
-    /** Refuse ahead-of-runtime markers before metadata validation; raw inspection defaults to preserving them. */
-    requireSupportedFormat?: boolean;
+/** Value that configures or reports format for this contract. */
+format?: ItemFormat;
+/** Value that configures or reports schema for this contract. */
+schema?: RuntimeSchemaSettings;
+/** Value that configures or reports extension field names for this contract. */
+extensionFieldNames?: readonly string[];
+/** Value that configures or reports on warning for this contract. */
+onWarning?: (warning: string) => void;
+/** Refuse ahead-of-runtime markers before metadata validation; raw inspection defaults to preserving them. */
+requireSupportedFormat?: boolean;
 }
 declare function runtimeFieldRequiredForType(definition: RuntimeFieldRegistry["definitions"][number], typeName: string): boolean;
 declare function buildKnownItemMetadataKeys(runtimeContext: RuntimeSchemaValidationContext): Set<string>;
@@ -31,9 +31,9 @@ export declare function normalizeLinkedTest(value: LinkedTest): LinkedTest;
 declare function normalizePlanStepLinks(value: unknown): PlanStepLink[] | undefined;
 declare function normalizePlanStepFiles(value: unknown): PlanStepFile[] | undefined;
 declare function normalizePlanStepTests(value: unknown): {
-    command?: string;
-    path?: string;
-    note?: string;
+command?: string;
+path?: string;
+note?: string;
 }[] | undefined;
 declare function normalizePlanStepDocs(value: unknown): PlanStepDoc[] | undefined;
 declare function normalizePlanSteps(value: unknown): PlanStep[] | undefined;
@@ -46,8 +46,8 @@ declare function normalizeBody(body: string): string;
 export declare function normalizeItemMetadata(itemMetadata: ItemMetadata, options?: Pick<ItemDocumentFormatOptions, "schema" | "extensionFieldNames" | "onWarning">): ItemMetadata;
 /** Implements split front matter for the public runtime surface of this module. */
 export declare function splitFrontMatter(content: string): {
-    frontMatter: string;
-    body: string;
+frontMatter: string;
+body: string;
 };
 /** Implements parse item document for the public runtime surface of this module. */
 export declare function parseItemDocument(content: string, options?: ItemDocumentFormatOptions): ItemDocument;
@@ -57,20 +57,20 @@ export declare function serializeItemDocument(document: ItemDocument, options?:
 export declare function canonicalDocument(document: ItemDocument, options?: Pick<ItemDocumentFormatOptions, "schema" | "extensionFieldNames" | "onWarning">): ItemDocument;
 /** Public contract for test only item format, shared by SDK and presentation-layer consumers. */
 export declare const _testOnlyItemFormat: {
-    buildKnownItemMetadataKeys: typeof buildKnownItemMetadataKeys;
-    firstNonZeroComparison: typeof firstNonZeroComparison;
-    normalizeBody: typeof normalizeBody;
-    normalizePlanDecisions: typeof normalizePlanDecisions;
-    normalizePlanDiscoveries: typeof normalizePlanDiscoveries;
-    normalizePlanStepDocs: typeof normalizePlanStepDocs;
-    normalizePlanStepFiles: typeof normalizePlanStepFiles;
-    normalizePlanStepLinks: typeof normalizePlanStepLinks;
-    normalizePlanSteps: typeof normalizePlanSteps;
-    normalizePlanStepTests: typeof normalizePlanStepTests;
-    normalizePlanValidation: typeof normalizePlanValidation;
-    normalizeTestRunSummaries: typeof normalizeTestRunSummaries;
-    normalizeTypeOptions: typeof normalizeTypeOptions;
-    runtimeFieldRequiredForType: typeof runtimeFieldRequiredForType;
-    sortTests: typeof sortTests;
+buildKnownItemMetadataKeys: typeof buildKnownItemMetadataKeys;
+firstNonZeroComparison: typeof firstNonZeroComparison;
+normalizeBody: typeof normalizeBody;
+normalizePlanDecisions: typeof normalizePlanDecisions;
+normalizePlanDiscoveries: typeof normalizePlanDiscoveries;
+normalizePlanStepDocs: typeof normalizePlanStepDocs;
+normalizePlanStepFiles: typeof normalizePlanStepFiles;
+normalizePlanStepLinks: typeof normalizePlanStepLinks;
+normalizePlanSteps: typeof normalizePlanSteps;
+normalizePlanStepTests: typeof normalizePlanStepTests;
+normalizePlanValidation: typeof normalizePlanValidation;
+normalizeTestRunSummaries: typeof normalizeTestRunSummaries;
+normalizeTypeOptions: typeof normalizeTypeOptions;
+runtimeFieldRequiredForType: typeof runtimeFieldRequiredForType;
+sortTests: typeof sortTests;
 };
 export {};

package/dist/core/item/item-type-definition.d.ts

@@ -35,8 +35,8 @@ export declare function normalizeItemTypeCommandOptionPolicy(policy: ItemTypeCom
 export declare function normalizeItemTypeCommandOptionPolicies(policies: ItemTypeCommandOptionPolicy[] | undefined, resolvePolicyCommand: ResolvePolicyCommand): ItemTypeCommandOptionPolicy[];
 /** Documents the normalize item type definition options payload exchanged by command, SDK, and package integrations. */
 export interface NormalizeItemTypeDefinitionOptions {
-    /** How to resolve a raw policy `command` value (defaults to {@link keepPolicyCommand}). */
-    resolvePolicyCommand?: ResolvePolicyCommand;
+/** How to resolve a raw policy `command` value (defaults to {@link keepPolicyCommand}). */
+resolvePolicyCommand?: ResolvePolicyCommand;
 }
 /** Validate an execution role before a settings or extension definition enters scheduling. Unknown values fail instead of silently enabling dispatch. */
 export declare function parseItemExecutionRole(value: unknown): ItemTypeDefinition["execution_role"];

package/dist/core/item/parent-reference-policy.d.ts

@@ -12,7 +12,7 @@ export declare function normalizeParentReferenceValue(rawValue: unknown): string
 export declare function isPlaceholderReferenceToken(value: string): boolean;
 /** Implements validate missing parent reference for the public runtime surface of this module. */
 export declare function validateMissingParentReference(parentId: string, policy: ParentReferencePolicy): {
-    warnings: string[];
+warnings: string[];
 };
 /** Rejects the one-node hierarchy cycle where an item points at itself. */
 export declare function assertParentReferenceIsNotSelf(itemId: string, parentId: string, prefix: string): void;

package/dist/core/item/parse.d.ts

@@ -8,8 +8,8 @@ export declare function collectTagFlagValues(values: readonly string[] | undefin
 export declare function splitAcceptanceCriteria(value: unknown): string[];
 /** Apply additive/subtractive acceptance-criteria mutations to a base criteria list. Used by `pm update --add-ac/--remove-ac` so individual semicolon-free criteria can be edited without replacing the whole `acceptance_criteria` value (tag-API parity; disjoint additions merge cleanly across branches). Additions append in argv order and dedupe on exact trimmed text; removals match exact trimmed text and report unmatched selectors so a typo never becomes a silent no-op. */
 export declare function applyAcceptanceCriteriaMutations(baseCriteria: readonly string[], add: readonly string[] | undefined, remove: readonly string[] | undefined): {
-    criteria: string[];
-    unmatchedRemovals: string[];
+criteria: string[];
+unmatchedRemovals: string[];
 };
 /** Apply an additive tag mutation to a base tag list. Used by `pm create` and `pm update` so `--add-tags` extends `--tags` (or the existing tags) without replacing them. Output is sorted + deduped lowercase, matching `parseTags`. */
 export declare function mergeAdditiveTags(baseTags: readonly string[], add: readonly string[] | undefined): string[];
@@ -56,10 +56,10 @@ export declare function assertNoAmbiguousBareCommaEntry(raw: string, optionName:
 export declare function assertNoUnknownCsvKeys(kv: Record<string, string>, optionName: string, allowedKeys: readonly string[]): void;
 /** Documents the stdin token resolver payload exchanged by command, SDK, and package integrations. */
 export interface StdinTokenResolver {
-    /** Value that configures or reports resolve value for this contract. */
-    resolveValue(value: string | undefined, optionName: string, resolveToken?: boolean): Promise<string | undefined>;
-    /** Value that configures or reports resolve list for this contract. */
-    resolveList(values: string[] | undefined, optionName: string, resolveToken?: boolean): Promise<string[] | undefined>;
+/** Value that configures or reports resolve value for this contract. */
+resolveValue(value: string | undefined, optionName: string, resolveToken?: boolean): Promise<string | undefined>;
+/** Value that configures or reports resolve list for this contract. */
+resolveList(values: string[] | undefined, optionName: string, resolveToken?: boolean): Promise<string[] | undefined>;
 }
 /** Mark transport-decoded options whose dash values are data, not stdin tokens. */
 export declare function preserveMutationStdinTokenLiterals<T extends object>(options: T): T;
@@ -75,9 +75,9 @@ export declare function shouldResolveMutationStdinTokens(options: object): boole
 export declare function shouldResolveMutationStdinTokenField(options: object, field: PropertyKey): boolean;
 /** Refuse competing stdin-token fields before any resolver starts reading. */
 export declare function assertSingleStdinTokenConsumer(candidates: readonly {
-    value: string | readonly string[] | undefined;
-    optionName: string;
-    resolveToken?: boolean;
+value: string | readonly string[] | undefined;
+optionName: string;
+resolveToken?: boolean;
 }[]): void;
 /** Resolve a typed mutation option bag only after its complete stdin plan is conflict-free. */
 export declare function resolveMutationStdinTokenFields<T extends object>(options: T, scalarFields: readonly (readonly [keyof T & string, string])[], listFields: readonly (readonly [keyof T & string, string])[]): Promise<T>;
@@ -89,8 +89,8 @@ export declare function parseOptionalNumber(raw: string, optionName: string): nu
 export declare function parseOptionalNonNegativeInteger(raw: string, optionName: string): number;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    coerceJsonTagArray: typeof coerceJsonTagArray;
-    stripCodeFenceEnvelope: typeof stripCodeFenceEnvelope;
-    parseMarkdownKeyValueLines: typeof parseMarkdownKeyValueLines;
+coerceJsonTagArray: typeof coerceJsonTagArray;
+stripCodeFenceEnvelope: typeof stripCodeFenceEnvelope;
+parseMarkdownKeyValueLines: typeof parseMarkdownKeyValueLines;
 };
 export {};

package/dist/core/item/sprint-release-format.d.ts

@@ -8,6 +8,6 @@ import type { SprintReleaseFormatPolicy } from "../../types/index.js";
 export declare function normalizeSprintReleaseFormatPolicy(value: string | undefined): SprintReleaseFormatPolicy;
 /** Implements validate sprint or release value for the public runtime surface of this module. */
 export declare function validateSprintOrReleaseValue(field: "sprint" | "release", rawValue: string, policy: SprintReleaseFormatPolicy): {
-    value: string;
-    warnings: string[];
+value: string;
+warnings: string[];
 };

package/dist/core/item/status-filter.d.ts

@@ -13,10 +13,10 @@ export declare function isStatusAllFilterInput(raw: unknown): boolean;
 export declare function resolveStatusFilterToken(token: string, registry: RuntimeStatusRegistry): ItemStatus | undefined;
 /** Documents the parse status filter options payload exchanged by command, SDK, and package integrations. */
 export interface ParseStatusFilterOptions {
-    /** When true, an unrecognized token throws a USAGE error with a did-you-mean hint. When false (default), an unrecognized token is passed through verbatim so custom/unknown statuses still compare against item values by their raw string — preserving the long-standing lenient `pm list` behavior. */
-    strict?: boolean;
-    /** Flag label used in error messages (default: "--status"). */
-    flagLabel?: string;
+/** When true, an unrecognized token throws a USAGE error with a did-you-mean hint. When false (default), an unrecognized token is passed through verbatim so custom/unknown statuses still compare against item values by their raw string — preserving the long-standing lenient `pm list` behavior. */
+strict?: boolean;
+/** Flag label used in error messages (default: "--status"). */
+flagLabel?: string;
 }
 /** Parse a comma-separated status filter into a de-duplicated list of concrete status ids. A standalone `all` sentinel intentionally resolves to no filter so duplicate-discovery loops can search every lifecycle bucket with the same `--status` flag shape. Shared by `pm list` (lenient) and `pm search` (strict, with a did-you-mean hint on typos) so both surfaces resolve the open/closed/canceled workflow-group aliases identically. */
 export declare function parseStatusFilterCsv(raw: unknown, registry: RuntimeStatusRegistry, options?: ParseStatusFilterOptions): ItemStatus[] | undefined;

package/dist/core/item/toon-decode.d.ts

@@ -2,18 +2,18 @@
 export declare const TOON_SCALAR_BRACKET_ESCAPE_UPSTREAM_PR: "https://github.com/toon-format/toon/pull/314";
 /** Historical tracking for the scalar-bracket decoder defect fixed upstream in TOON 2.3.1. */
 export declare const TOON_SCALAR_BRACKET_ESCAPE_TRACKING: {
-    readonly dependency: "@toon-format/toon";
-    readonly affected_versions: "<=2.3.0";
-    readonly resolved_version: "2.3.1";
-    readonly upstream_pr: "https://github.com/toon-format/toon/pull/314";
-    readonly workaround_status: "removed";
+readonly dependency: "@toon-format/toon";
+readonly affected_versions: "<=2.3.0";
+readonly resolved_version: "2.3.1";
+readonly upstream_pr: "https://github.com/toon-format/toon/pull/314";
+readonly workaround_status: "removed";
 };
 /** Documents the toon decode result payload exchanged by command, SDK, and package integrations. */
 export interface ToonDecodeResult {
-    /** The decoded TOON document. */
-    value: unknown;
-    /** Always false since TOON 2.3.1 fixed strict scalar-bracket decoding upstream. */
-    usedScalarBracketEscape: boolean;
+/** The decoded TOON document. */
+value: unknown;
+/** Always false since TOON 2.3.1 fixed strict scalar-bracket decoding upstream. */
+usedScalarBracketEscape: boolean;
 }
 /**
  * Decode a TOON item document with the dependency's strict parser.

package/dist/core/item/type-registry.d.ts

@@ -12,50 +12,50 @@ export type CommandOptionPolicyCommand = "create" | "update";
 export declare const COMMON_MUTATION_COMMAND_OPTION_KEYS: readonly ["deadline", "estimatedMinutes", "acceptanceCriteria", "definitionOfReady", "order", "goal", "objective", "value", "impact", "outcome", "whyNow", "assignee", "parent", "reviewer", "risk", "confidence", "sprint", "release", "blockedBy", "blockedReason", "unblockNote", "reporter", "severity", "environment", "reproSteps", "resolution", "expectedResult", "actualResult", "affectedVersion", "fixedVersion", "component", "regression", "customerImpact"];
 /** Documents the command option policy state payload exchanged by command, SDK, and package integrations. */
 export interface CommandOptionPolicyState {
-    /** Value that configures or reports required for this contract. */
-    required: string[];
-    /** Value that configures or reports hidden for this contract. */
-    hidden: string[];
-    /** Whether disabled applies to this operation. */
-    disabled: string[];
-    /** Value that configures or reports errors for this contract. */
-    errors: string[];
+/** Value that configures or reports required for this contract. */
+required: string[];
+/** Value that configures or reports hidden for this contract. */
+hidden: string[];
+/** Whether disabled applies to this operation. */
+disabled: string[];
+/** Value that configures or reports errors for this contract. */
+errors: string[];
 }
 /** Documents the resolved item type definition payload exchanged by command, SDK, and package integrations. */
 export interface ResolvedItemTypeDefinition {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Optional human description carried from the type definition. */
-    description?: string;
-    /** Value that configures or reports folder for this contract. */
-    folder: string;
-    /** Value that configures or reports aliases for this contract. */
-    aliases: string[];
-    /** Optional per-type status applied at create time when `--status` is omitted. */
-    default_status?: string;
-    /** Effective dispatch role; absent legacy definitions are resolved through the built-in defaults. */
-    execution_role?: ItemTypeDefinition["execution_role"];
-    /** Value that configures or reports required create fields for this contract. */
-    required_create_fields: string[];
-    /** Value that configures or reports required create repeatables for this contract. */
-    required_create_repeatables: string[];
-    /** Value that configures or reports options for this contract. */
-    options: ItemTypeOptionDefinition[];
-    /** Value that configures or reports command option policies for this contract. */
-    command_option_policies: ItemTypeCommandOptionPolicy[];
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Optional human description carried from the type definition. */
+description?: string;
+/** Value that configures or reports folder for this contract. */
+folder: string;
+/** Value that configures or reports aliases for this contract. */
+aliases: string[];
+/** Optional per-type status applied at create time when `--status` is omitted. */
+default_status?: string;
+/** Effective dispatch role; absent legacy definitions are resolved through the built-in defaults. */
+execution_role?: ItemTypeDefinition["execution_role"];
+/** Value that configures or reports required create fields for this contract. */
+required_create_fields: string[];
+/** Value that configures or reports required create repeatables for this contract. */
+required_create_repeatables: string[];
+/** Value that configures or reports options for this contract. */
+options: ItemTypeOptionDefinition[];
+/** Value that configures or reports command option policies for this contract. */
+command_option_policies: ItemTypeCommandOptionPolicy[];
 }
 /** Documents the item type registry payload exchanged by command, SDK, and package integrations. */
 export interface ItemTypeRegistry {
-    /** Value that configures or reports types for this contract. */
-    types: string[];
-    /** Value that configures or reports folders for this contract. */
-    folders: string[];
-    /** Value that configures or reports type to folder for this contract. */
-    type_to_folder: Record<string, string>;
-    /** Schema type that determines the shape and validation rules for this value. */
-    by_type: Record<string, ResolvedItemTypeDefinition>;
-    /** Schema type that determines the shape and validation rules for this value. */
-    alias_to_type: Record<string, string>;
+/** Value that configures or reports types for this contract. */
+types: string[];
+/** Value that configures or reports folders for this contract. */
+folders: string[];
+/** Value that configures or reports type to folder for this contract. */
+type_to_folder: Record<string, string>;
+/** Schema type that determines the shape and validation rules for this value. */
+by_type: Record<string, ResolvedItemTypeDefinition>;
+/** Schema type that determines the shape and validation rules for this value. */
+alias_to_type: Record<string, string>;
 }
 /** Implements canonicalize command option key for the public runtime surface of this module. */
 export declare function canonicalizeCommandOptionKey(command: CommandOptionPolicyCommand, rawOption: string): string | undefined;
@@ -82,6 +82,6 @@ export declare function resolveTypeDefinition(typeName: string | undefined, regi
 export declare function resolveCommandOptionPolicyState(typeDefinition: ResolvedItemTypeDefinition, command: CommandOptionPolicyCommand, baseRequiredOptions: Iterable<string>): CommandOptionPolicyState;
 /** Implements validate type options for the public runtime surface of this module. */
 export declare function validateTypeOptions(typeName: string, rawTypeOptions: Record<string, string> | undefined, registry: ItemTypeRegistry): {
-    normalized: Record<string, string> | undefined;
-    errors: string[];
+normalized: Record<string, string> | undefined;
+errors: string[];
 };

package/dist/core/lock/lock-gc.d.ts

@@ -10,75 +10,75 @@
  */
 /** Documents the stale lock scan entry payload exchanged by command, SDK, and package integrations. */
 export interface StaleLockScanEntry {
-    /** e.g. "pm-abc1.lock" */
-    file: string;
-    /** parsed id, or null if unparseable */
-    id: string | null;
-    /** Value that configures or reports owner for this contract. */
-    owner: string | null;
-    /** ISO 8601 timestamp recording when created occurred. */
-    created_at: string | null;
-    /** Value that configures or reports ttl seconds for this contract. */
-    ttl_seconds: number | null;
-    /** floor((now - created_at)/1000), null if unparseable */
-    age_seconds: number | null;
-    /** true only when classified expired */
-    stale: boolean;
-    /** Value that configures or reports reason for this contract. */
-    reason: "expired" | "active" | "unparseable";
+/** e.g. "pm-abc1.lock" */
+file: string;
+/** parsed id, or null if unparseable */
+id: string | null;
+/** Value that configures or reports owner for this contract. */
+owner: string | null;
+/** ISO 8601 timestamp recording when created occurred. */
+created_at: string | null;
+/** Value that configures or reports ttl seconds for this contract. */
+ttl_seconds: number | null;
+/** floor((now - created_at)/1000), null if unparseable */
+age_seconds: number | null;
+/** true only when classified expired */
+stale: boolean;
+/** Value that configures or reports reason for this contract. */
+reason: "expired" | "active" | "unparseable";
 }
 /** Documents the lock gc hooks payload exchanged by command, SDK, and package integrations. */
 export interface LockGcHooks {
-    /** Value that configures or reports on read for this contract. */
-    onRead?: (lockPath: string) => Promise<string[]> | string[];
-    /** Value that configures or reports on write for this contract. */
-    onWrite?: (lockPath: string) => Promise<string[]> | string[];
+/** Value that configures or reports on read for this contract. */
+onRead?: (lockPath: string) => Promise<string[]> | string[];
+/** Value that configures or reports on write for this contract. */
+onWrite?: (lockPath: string) => Promise<string[]> | string[];
 }
 /** Documents the lock gc options payload exchanged by command, SDK, and package integrations. */
 export interface LockGcOptions {
-    /** Value that configures or reports dry run for this contract. */
-    dryRun: boolean;
-    /** epoch ms; defaults to Date.now() — injectable for deterministic tests */
-    now?: number;
-    /** Value that configures or reports hooks for this contract. */
-    hooks?: LockGcHooks;
+/** Value that configures or reports dry run for this contract. */
+dryRun: boolean;
+/** epoch ms; defaults to Date.now() — injectable for deterministic tests */
+now?: number;
+/** Value that configures or reports hooks for this contract. */
+hooks?: LockGcHooks;
 }
 /** Documents the lock gc result payload exchanged by command, SDK, and package integrations. */
 export interface LockGcResult {
-    /** number of *.lock files examined */
-    scanned: number;
-    /** relative paths like "locks/pm-abc1.lock" (removed, or would-remove under dryRun) */
-    removed: string[];
-    /** relative paths retained (active OR unparseable — never delete what we can't reason about) */
-    retained: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** one per scanned *.lock file, sorted by file name asc */
-    entries: StaleLockScanEntry[];
+/** number of *.lock files examined */
+scanned: number;
+/** relative paths like "locks/pm-abc1.lock" (removed, or would-remove under dryRun) */
+removed: string[];
+/** relative paths retained (active OR unparseable — never delete what we can't reason about) */
+retained: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** one per scanned *.lock file, sorted by file name asc */
+entries: StaleLockScanEntry[];
 }
 /** Fine-grained classification outcome for one readable lock file's content. `unparseable_json` and `invalid_timestamp` both surface as the coarse `reason: "unparseable"` on the scan entry (gc retains both), but stay distinct here so callers can emit precise warnings. */
 export type LockClassificationDetail = "active" | "expired" | "unparseable_json" | "invalid_timestamp";
 /** Documents the lock content classification payload exchanged by command, SDK, and package integrations. */
 export interface LockContentClassification {
-    /** Value that configures or reports detail for this contract. */
-    detail: LockClassificationDetail;
-    /** Value that configures or reports entry for this contract. */
-    entry: StaleLockScanEntry;
+/** Value that configures or reports detail for this contract. */
+detail: LockClassificationDetail;
+/** Value that configures or reports entry for this contract. */
+entry: StaleLockScanEntry;
 }
 /** Pure classification of one lock file's raw content against `nowMs`. This is the single staleness/parse policy shared by `pm gc --scope locks` (which acts on it) and the `pm health` locks check (which only reports it). */
 export declare function classifyLockContent(file: string, raw: string, nowMs: number): LockContentClassification;
 /** Documents the lock health scan payload exchanged by command, SDK, and package integrations. */
 export interface LockHealthScan {
-    /** number of *.lock files examined (ghost files that vanish mid-scan are skipped) */
-    scanned: number;
-    /** Number of active lock entries represented by this result. */
-    active_lock_count: number;
-    /** Number of stale lock entries represented by this result. */
-    stale_lock_count: number;
-    /** Number of unreadable lock entries represented by this result. */
-    unreadable_lock_count: number;
-    /** invalid JSON, wrong shape, or an unparseable created_at timestamp */
-    unparseable_lock_count: number;
+/** number of *.lock files examined (ghost files that vanish mid-scan are skipped) */
+scanned: number;
+/** Number of active lock entries represented by this result. */
+active_lock_count: number;
+/** Number of stale lock entries represented by this result. */
+stale_lock_count: number;
+/** Number of unreadable lock entries represented by this result. */
+unreadable_lock_count: number;
+/** invalid JSON, wrong shape, or an unparseable created_at timestamp */
+unparseable_lock_count: number;
 }
 /** Read-only locks scan for `pm health`: classifies every lock file with the same policy `pm gc --scope locks` uses but never removes anything. */
 export declare function scanLockHealth(pmRoot: string, now?: number): Promise<LockHealthScan>;

package/dist/core/lock/lock.d.ts

@@ -1,26 +1,26 @@
 interface LockInfo {
-    id: string;
-    pid: number;
-    owner: string;
-    token?: string;
-    created_at: string;
-    ttl_seconds: number;
+id: string;
+pid: number;
+owner: string;
+token?: string;
+created_at: string;
+ttl_seconds: number;
 }
 interface LockReadResult {
-    info: LockInfo | null;
-    warnings: string[];
+info: LockInfo | null;
+warnings: string[];
 }
 interface StaleLockRemovalResult {
-    lockInfo: LockReadResult;
-    shouldRetryCreate: boolean;
-    staleRemovalCounted: boolean;
+lockInfo: LockReadResult;
+shouldRetryCreate: boolean;
+staleRemovalCounted: boolean;
 }
 /** Stable operating-system identity for a process when the host exposes one. */
 export interface ProcessIdentity {
-    /** Operating-system process identifier captured with the owner record. */
-    pid: number;
-    /** Host process-start coordinate that distinguishes reuse of the same PID. */
-    process_start_identity?: string;
+/** Operating-system process identifier captured with the owner record. */
+pid: number;
+/** Host process-start coordinate that distinguishes reuse of the same PID. */
+process_start_identity?: string;
 }
 declare function parseLockInfo(raw: string): LockReadResult;
 declare function readLockInfo(lockPath: string, emitReadHook?: boolean): Promise<LockReadResult>;
@@ -51,30 +51,30 @@ export declare function captureProcessIdentity(pid?: number): Promise<ProcessIde
 export declare function isProcessIdentityAlive(identity: ProcessIdentity, unverifiedAgeMs: number, maxUnverifiedAgeMs: number): Promise<boolean>;
 declare function acquireStaleCleanupGate(lockPath: string, _id: string): Promise<(() => Promise<void>) | null>;
 declare function removeConfirmedStaleLock(params: {
-    lockPath: string;
-    id: string;
-    ttlSeconds: number;
-    force: boolean;
-    forceRequiredForStaleLock: boolean;
-    staleRemovals: number;
-    waitBudgetMs: number;
-    startedAtMs: number;
-    fallbackLockInfo: LockReadResult;
+lockPath: string;
+id: string;
+ttlSeconds: number;
+force: boolean;
+forceRequiredForStaleLock: boolean;
+staleRemovals: number;
+waitBudgetMs: number;
+startedAtMs: number;
+fallbackLockInfo: LockReadResult;
 }): Promise<StaleLockRemovalResult>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    parseLockInfo: typeof parseLockInfo;
-    readLockInfo: typeof readLockInfo;
-    isErrno: typeof isErrno;
-    isLockCreateContention: typeof isLockCreateContention;
-    buildLockPayload: typeof buildLockPayload;
-    isStaleLock: typeof isStaleLock;
-    lockOwnerSuffix: typeof lockOwnerSuffix;
-    resolveLockWaitMs: typeof resolveLockWaitMs;
-    parseLinuxProcessStartIdentity: typeof parseLinuxProcessStartIdentity;
-    readProcessStartIdentity: typeof readProcessStartIdentity;
-    acquireStaleCleanupGate: typeof acquireStaleCleanupGate;
-    removeConfirmedStaleLock: typeof removeConfirmedStaleLock;
+parseLockInfo: typeof parseLockInfo;
+readLockInfo: typeof readLockInfo;
+isErrno: typeof isErrno;
+isLockCreateContention: typeof isLockCreateContention;
+buildLockPayload: typeof buildLockPayload;
+isStaleLock: typeof isStaleLock;
+lockOwnerSuffix: typeof lockOwnerSuffix;
+resolveLockWaitMs: typeof resolveLockWaitMs;
+parseLinuxProcessStartIdentity: typeof parseLinuxProcessStartIdentity;
+readProcessStartIdentity: typeof readProcessStartIdentity;
+acquireStaleCleanupGate: typeof acquireStaleCleanupGate;
+removeConfirmedStaleLock: typeof removeConfirmedStaleLock;
 };
 /**
  * Acquire a token-owned tracker lock with bounded contention waiting and
@@ -83,6 +83,6 @@ export declare const _testOnly: {
  * storage. Extension overrides retain responsibility for their own lifecycle.
  */
 export declare function acquireLock(pmRoot: string, id: string, ttlSeconds: number, owner: string, force?: boolean, forceRequiredForStaleLock?: boolean, waitMs?: number, options?: {
-    createParentDirectories?: boolean;
+createParentDirectories?: boolean;
 }): Promise<() => Promise<void>>;
 export {};

package/dist/core/output/mutation-projection.d.ts

@@ -23,12 +23,12 @@
 export type ChangedFieldsMode = "full" | "compact";
 /** Documents the mutation projection options payload exchanged by command, SDK, and package integrations. */
 export interface MutationProjectionOptions {
-    /** Defaults to "full" (unchanged output). "compact" drops the array, keeping a count. */
-    changedFields?: ChangedFieldsMode;
-    /** Return the default agent envelope: id, status, changed-field count, and close reason. */
-    compactEnvelope?: boolean;
-    /** Return only id/status for single-item mutation envelopes. */
-    idOnly?: boolean;
+/** Defaults to "full" (unchanged output). "compact" drops the array, keeping a count. */
+changedFields?: ChangedFieldsMode;
+/** Return the default agent envelope: id, status, changed-field count, and close reason. */
+compactEnvelope?: boolean;
+/** Return only id/status for single-item mutation envelopes. */
+idOnly?: boolean;
 }
 /** Returns a copy of a mutation result with the envelope `changed_fields` arrays replaced by `changed_field_count` when compact mode is requested. Inputs that are not a mutation envelope (or full mode) are returned unchanged (same reference). */
 export declare function projectMutationResult(result: unknown, options?: MutationProjectionOptions): unknown;

package/dist/core/output/output-control.d.ts

@@ -7,10 +7,10 @@
 export declare const SUPPRESS_HOST_OUTPUT_MARKER = "@unbrained/pm-cli:suppress-host-output:v1";
 /** A handled result that tells a pm host not to render or write another payload. */
 export interface SuppressedHostOutput<TResult = unknown> {
-    /** Explicit protocol marker consumed by CLI and SDK-built presentation hosts. */
-    readonly __pm_suppress_host_output: typeof SUPPRESS_HOST_OUTPUT_MARKER;
-    /** Optional structured result retained for hooks, telemetry, and embedding hosts. */
-    readonly result?: TResult;
+/** Explicit protocol marker consumed by CLI and SDK-built presentation hosts. */
+readonly __pm_suppress_host_output: typeof SUPPRESS_HOST_OUTPUT_MARKER;
+/** Optional structured result retained for hooks, telemetry, and embedding hosts. */
+readonly result?: TResult;
 }
 /** Return from a command/exporter after it has written its own streaming, binary, or pre-rendered output. */
 export declare function suppressHostOutput<TResult = undefined>(result?: TResult): SuppressedHostOutput<TResult>;