@unbrained/pm-cli 2026.10.14 → 2026.10.17

package/dist/core/test/background-runs.d.ts

@@ -7,261 +7,261 @@ export type BackgroundLogStream = "stdout" | "stderr" | "both";
 /** Documents the background run progress payload exchanged by command, SDK, and package integrations. */
 export interface BackgroundRunProgress {
 /** Value that configures or reports phase for this contract. */
-phase: "queued" | "running" | "stopping" | "finished";
+phase:"queued" | "running" | "stopping" | "finished";
 /** Human-readable explanation suitable for logs and agent-facing output. */
-message?: string;
+message?:string;
 /** Value that configures or reports item index for this contract. */
-item_index?: number;
+item_index?:number;
 /** Value that configures or reports item total for this contract. */
-item_total?: number;
+item_total?:number;
 /** Value that configures or reports item id for this contract. */
-item_id?: string;
+item_id?:string;
 /** Value that configures or reports linked test index for this contract. */
-linked_test_index?: number;
+linked_test_index?:number;
 /** Value that configures or reports linked test total for this contract. */
-linked_test_total?: number;
+linked_test_total?:number;
 /** Value that configures or reports current command for this contract. */
-current_command?: string;
+current_command?:string;
 /** Elapsed time in milliseconds for elapsed. */
-elapsed_ms?: number;
+elapsed_ms?:number;
 /** ISO 8601 timestamp recording when heartbeat occurred. */
-heartbeat_at?: string;
+heartbeat_at?:string;
 }
 /** Documents the background run resource snapshot payload exchanged by command, SDK, and package integrations. */
 export interface BackgroundRunResourceSnapshot {
 /** ISO 8601 timestamp recording when recorded occurred. */
-recorded_at: string;
+recorded_at:string;
 /** Value that configures or reports rss bytes for this contract. */
-rss_bytes?: number;
+rss_bytes?:number;
 /** Value that configures or reports cpu user seconds for this contract. */
-cpu_user_seconds?: number;
+cpu_user_seconds?:number;
 /** Value that configures or reports cpu system seconds for this contract. */
-cpu_system_seconds?: number;
+cpu_system_seconds?:number;
 /** Value that configures or reports uptime seconds for this contract. */
-uptime_seconds?: number;
+uptime_seconds?:number;
 }
 /** Documents the background run summary payload exchanged by command, SDK, and package integrations. */
 export interface BackgroundRunSummary {
 /** Value that configures or reports items for this contract. */
-items?: number;
+items?:number;
 /** Value that configures or reports linked tests for this contract. */
-linked_tests?: number;
+linked_tests?:number;
 /** Value that configures or reports passed for this contract. */
-passed: number;
+passed:number;
 /** Value that configures or reports failed for this contract. */
-failed: number;
+failed:number;
 /** Value that configures or reports skipped for this contract. */
-skipped: number;
+skipped:number;
 /** Value that configures or reports fail on skipped triggered for this contract. */
-fail_on_skipped_triggered?: boolean;
+fail_on_skipped_triggered?:boolean;
 }
 /** Documents the background test run record payload exchanged by command, SDK, and package integrations. */
 export interface BackgroundTestRunRecord {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports kind for this contract. */
-kind: BackgroundTestRunKind;
+kind:BackgroundTestRunKind;
 /** Lifecycle state reported for status. */
-status: BackgroundTestRunStatus;
+status:BackgroundTestRunStatus;
 /** ISO 8601 timestamp recording when created occurred. */
-created_at: string;
+created_at:string;
 /** ISO 8601 timestamp recording when started occurred. */
-started_at?: string;
+started_at?:string;
 /** ISO 8601 timestamp recording when finished occurred. */
-finished_at?: string;
+finished_at?:string;
 /** ISO 8601 timestamp recording when updated occurred. */
-updated_at: string;
+updated_at:string;
 /** Value that configures or reports requested by for this contract. */
-requested_by: string;
+requested_by:string;
 /** Value that configures or reports fingerprint for this contract. */
-fingerprint: string;
+fingerprint:string;
 /** Value that configures or reports command args for this contract. */
-command_args: string[];
+command_args:string[];
 /** Value that configures or reports command label for this contract. */
-command_label: string;
+command_label:string;
 /** Value that configures or reports pm root for this contract. */
-pm_root: string;
+pm_root:string;
 /** Value that configures or reports global pm root for this contract. */
-global_pm_root: string;
+global_pm_root:string;
 /** Value that configures or reports target id for this contract. */
-target_id?: string;
+target_id?:string;
 /** Value that configures or reports status filter for this contract. */
-status_filter?: string;
+status_filter?:string;
 /** Value that configures or reports attempt for this contract. */
-attempt: number;
+attempt:number;
 /** Value that configures or reports resumed from for this contract. */
-resumed_from?: string;
+resumed_from?:string;
 /** Value that configures or reports resumed by for this contract. */
-resumed_by?: string;
+resumed_by?:string;
 /** Value that configures or reports worker pid for this contract. */
-worker_pid?: number;
+worker_pid?:number;
 /** Value that configures or reports child pid for this contract. */
-child_pid?: number;
+child_pid?:number;
 /** Value that configures or reports exit code for this contract. */
-exit_code?: number;
+exit_code?:number;
 /** Value that configures or reports signal for this contract. */
-signal?: string;
+signal?:string;
 /** Filesystem path used for stdout resolution. */
-stdout_path: string;
+stdout_path:string;
 /** Filesystem path used for stderr resolution. */
-stderr_path: string;
+stderr_path:string;
 /** Filesystem path used for result resolution. */
-result_path: string;
+result_path:string;
 /** Value that configures or reports progress for this contract. */
-progress?: BackgroundRunProgress;
+progress?:BackgroundRunProgress;
 /** Value that configures or reports resource for this contract. */
-resource?: BackgroundRunResourceSnapshot;
+resource?:BackgroundRunResourceSnapshot;
 /** Value that configures or reports summary for this contract. */
-summary?: BackgroundRunSummary;
+summary?:BackgroundRunSummary;
 /** ISO 8601 timestamp recording when stop requested occurred. */
-stop_requested_at?: string;
+stop_requested_at?:string;
 /** Value that configures or reports duplicate of for this contract. */
-duplicate_of?: string;
+duplicate_of?:string;
 /** Value that configures or reports error for this contract. */
-error?: string;
+error?:string;
 }
 /** Documents the start background test run options payload exchanged by command, SDK, and package integrations. */
 export interface StartBackgroundTestRunOptions {
 /** Value that configures or reports pm root for this contract. */
-pmRoot: string;
+pmRoot:string;
 /** Value that configures or reports global pm root for this contract. */
-globalPmRoot: string;
+globalPmRoot:string;
 /** Value that configures or reports kind for this contract. */
-kind: BackgroundTestRunKind;
+kind:BackgroundTestRunKind;
 /** Value that configures or reports command args for this contract. */
-commandArgs: string[];
+commandArgs:string[];
 /** Value that configures or reports requested by for this contract. */
-requestedBy: string;
+requestedBy:string;
 /** Value that configures or reports target id for this contract. */
-targetId?: string;
+targetId?:string;
 /** Value that configures or reports status filter for this contract. */
-statusFilter?: string;
+statusFilter?:string;
 /** Value that configures or reports resumed from for this contract. */
-resumedFrom?: string;
+resumedFrom?:string;
 /** Value that configures or reports resumed by for this contract. */
-resumedBy?: string;
+resumedBy?:string;
 /** Value that configures or reports attempt for this contract. */
-attempt?: number;
+attempt?:number;
 }
 /** Documents the start background test run result payload exchanged by command, SDK, and package integrations. */
 export interface StartBackgroundTestRunResult {
 /** Value that configures or reports started for this contract. */
-started: boolean;
+started:boolean;
 /** Value that configures or reports run for this contract. */
-run: BackgroundTestRunRecord;
+run:BackgroundTestRunRecord;
 /** Value that configures or reports duplicate of for this contract. */
-duplicate_of?: string;
+duplicate_of?:string;
 }
 /** Documents the spawn background test run worker options payload exchanged by command, SDK, and package integrations. */
 export interface SpawnBackgroundTestRunWorkerOptions {
 /** Value that configures or reports pm root for this contract. */
-pmRoot: string;
+pmRoot:string;
 /** Executes the id operation through the package runtime. */
-runId: string;
+runId:string;
 /** Value that configures or reports no extensions for this contract. */
-noExtensions?: boolean;
+noExtensions?:boolean;
 }
 /** Documents the stop background test run result payload exchanged by command, SDK, and package integrations. */
 export interface StopBackgroundTestRunResult {
 /** Value that configures or reports run for this contract. */
-run: BackgroundTestRunRecord;
+run:BackgroundTestRunRecord;
 /** Value that configures or reports signal sent for this contract. */
-signal_sent: "SIGTERM" | "SIGKILL" | "none";
+signal_sent:"SIGTERM" | "SIGKILL" | "none";
 }
 /** Documents the list background test run options payload exchanged by command, SDK, and package integrations. */
 export interface ListBackgroundTestRunOptions {
 /** Lifecycle state reported for status. */
-status?: BackgroundTestRunStatus;
+status?:BackgroundTestRunStatus;
 /** Value that configures or reports limit for this contract. */
-limit?: number;
+limit?:number;
 }
 /** Documents the background run health payload exchanged by command, SDK, and package integrations. */
 export interface BackgroundRunHealth {
 /** Value that configures or reports state for this contract. */
-state: "healthy" | "stale" | "inactive";
+state:"healthy" | "stale" | "inactive";
 /** ISO 8601 timestamp recording when last heartbeat occurred. */
-last_heartbeat_at?: string;
+last_heartbeat_at?:string;
 /** Elapsed time in milliseconds for heartbeat lag. */
-heartbeat_lag_ms?: number;
+heartbeat_lag_ms?:number;
 /** Value that configures or reports worker alive for this contract. */
-worker_alive: boolean;
+worker_alive:boolean;
 /** Value that configures or reports child alive for this contract. */
-child_alive: boolean;
+child_alive:boolean;
 }
 /** Documents the background run status view payload exchanged by command, SDK, and package integrations. */
 export interface BackgroundRunStatusView {
 /** Value that configures or reports run for this contract. */
-run: BackgroundTestRunRecord;
+run:BackgroundTestRunRecord;
 /** Value that configures or reports health for this contract. */
-health: BackgroundRunHealth;
+health:BackgroundRunHealth;
 }
 /** Documents the background run logs result payload exchanged by command, SDK, and package integrations. */
 export interface BackgroundRunLogsResult {
 /** Value that configures or reports run for this contract. */
-run: BackgroundTestRunRecord;
+run:BackgroundTestRunRecord;
 /** Value that configures or reports stream for this contract. */
-stream: BackgroundLogStream;
+stream:BackgroundLogStream;
 /** Value that configures or reports tail for this contract. */
-tail: number;
+tail:number;
 /** Value that configures or reports stdout for this contract. */
-stdout: string[];
+stdout:string[];
 /** Value that configures or reports stderr for this contract. */
-stderr: string[];
+stderr:string[];
 }
 interface WorkerEvaluationResult {
-summary: BackgroundRunSummary;
-parsedResult: unknown | null;
+summary:BackgroundRunSummary;
+parsedResult:unknown | null;
 }
 /** Implements build background test run fingerprint for the public runtime surface of this module. */
-export declare function buildBackgroundTestRunFingerprint(kind: BackgroundTestRunKind, commandArgs: string[], pmRoot: string): string;
-declare function isPidRunning(pid: number | undefined): boolean;
+export declare function buildBackgroundTestRunFingerprint(kind:BackgroundTestRunKind,commandArgs:string[],pmRoot:string):string;
+declare function isPidRunning(pid:number | undefined):boolean;
 /** Implements read background test run record for the public runtime surface of this module. */
-export declare function readBackgroundTestRunRecord(pmRoot: string, runId: string): Promise<BackgroundTestRunRecord | null>;
-declare function parseLinuxRssStatus(raw: string): number | undefined;
-declare function readLinuxRssBytes(pid: number): Promise<number | undefined>;
-declare function parseLinuxCpuStat(raw: string): {
-cpu_user_seconds?: number;
-cpu_system_seconds?: number;
+export declare function readBackgroundTestRunRecord(pmRoot:string,runId:string):Promise<BackgroundTestRunRecord | null>;
+declare function parseLinuxRssStatus(raw:string):number | undefined;
+declare function readLinuxRssBytes(pid:number):Promise<number | undefined>;
+declare function parseLinuxCpuStat(raw:string):{
+cpu_user_seconds?:number;
+cpu_system_seconds?:number;
 };
-declare function readLinuxCpuSeconds(pid: number): Promise<{
-cpu_user_seconds?: number;
-cpu_system_seconds?: number;
+declare function readLinuxCpuSeconds(pid:number):Promise<{
+cpu_user_seconds?:number;
+cpu_system_seconds?:number;
 }>;
-declare function buildResourceSnapshot(record: BackgroundTestRunRecord): Promise<BackgroundRunResourceSnapshot | undefined>;
+declare function buildResourceSnapshot(record:BackgroundTestRunRecord):Promise<BackgroundRunResourceSnapshot | undefined>;
 /** Derive worker totals from aggregate or per-test receipts, counting refusals as unsuccessful runs. */
-declare function evaluateWorkerResult(kind: BackgroundTestRunKind, payload: unknown): WorkerEvaluationResult;
-declare function parseProgressLine(stderrLine: string): Partial<BackgroundRunProgress> | null;
-declare function splitLines(value: string): string[];
-declare function tailLines(value: string, limit: number): string[];
-declare function refreshRunIfStale(pmRoot: string, record: BackgroundTestRunRecord): Promise<BackgroundTestRunRecord>;
+declare function evaluateWorkerResult(kind:BackgroundTestRunKind,payload:unknown):WorkerEvaluationResult;
+declare function parseProgressLine(stderrLine:string):Partial<BackgroundRunProgress> | null;
+declare function splitLines(value:string):string[];
+declare function tailLines(value:string,limit:number):string[];
+declare function refreshRunIfStale(pmRoot:string,record:BackgroundTestRunRecord):Promise<BackgroundTestRunRecord>;
 /** Implements start background test run for the public runtime surface of this module. */
-export declare function startBackgroundTestRun(options: StartBackgroundTestRunOptions): Promise<StartBackgroundTestRunResult>;
+export declare function startBackgroundTestRun(options:StartBackgroundTestRunOptions):Promise<StartBackgroundTestRunResult>;
 /** Implements spawn background test run worker for the public runtime surface of this module. */
-export declare function spawnBackgroundTestRunWorker(options: SpawnBackgroundTestRunWorkerOptions): Promise<BackgroundTestRunRecord>;
+export declare function spawnBackgroundTestRunWorker(options:SpawnBackgroundTestRunWorkerOptions):Promise<BackgroundTestRunRecord>;
 /** Implements run background test run worker for the public runtime surface of this module. */
-export declare function runBackgroundTestRunWorker(pmRoot: string, runId: string, noExtensions?: boolean): Promise<BackgroundTestRunRecord>;
+export declare function runBackgroundTestRunWorker(pmRoot:string,runId:string,noExtensions?:boolean):Promise<BackgroundTestRunRecord>;
 /** Implements list background test runs for the public runtime surface of this module. */
-export declare function listBackgroundTestRuns(pmRoot: string, options: ListBackgroundTestRunOptions): Promise<BackgroundTestRunRecord[]>;
+export declare function listBackgroundTestRuns(pmRoot:string,options:ListBackgroundTestRunOptions):Promise<BackgroundTestRunRecord[]>;
 /** Implements get background test run status for the public runtime surface of this module. */
-export declare function getBackgroundTestRunStatus(pmRoot: string, runId: string): Promise<BackgroundRunStatusView>;
+export declare function getBackgroundTestRunStatus(pmRoot:string,runId:string):Promise<BackgroundRunStatusView>;
 /** Implements stop background test run for the public runtime surface of this module. */
-export declare function stopBackgroundTestRun(pmRoot: string, runId: string, force?: boolean): Promise<StopBackgroundTestRunResult>;
+export declare function stopBackgroundTestRun(pmRoot:string,runId:string,force?:boolean):Promise<StopBackgroundTestRunResult>;
 /** Implements resume background test run for the public runtime surface of this module. */
-export declare function resumeBackgroundTestRun(pmRoot: string, runId: string, requestedBy: string, noExtensions?: boolean): Promise<BackgroundTestRunRecord>;
+export declare function resumeBackgroundTestRun(pmRoot:string,runId:string,requestedBy:string,noExtensions?:boolean):Promise<BackgroundTestRunRecord>;
 /** Implements read background test run logs for the public runtime surface of this module. */
-export declare function readBackgroundTestRunLogs(pmRoot: string, runId: string, stream: BackgroundLogStream, tail: number | undefined): Promise<BackgroundRunLogsResult>;
+export declare function readBackgroundTestRunLogs(pmRoot:string,runId:string,stream:BackgroundLogStream,tail:number | undefined):Promise<BackgroundRunLogsResult>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export declare const _testOnly: {
-buildResourceSnapshot: typeof buildResourceSnapshot;
-evaluateWorkerResult: typeof evaluateWorkerResult;
-isPidRunning: typeof isPidRunning;
-parseLinuxCpuStat: typeof parseLinuxCpuStat;
-parseLinuxRssStatus: typeof parseLinuxRssStatus;
-parseProgressLine: typeof parseProgressLine;
-readLinuxCpuSeconds: typeof readLinuxCpuSeconds;
-readLinuxRssBytes: typeof readLinuxRssBytes;
-refreshRunIfStale: typeof refreshRunIfStale;
-splitLines: typeof splitLines;
-tailLines: typeof tailLines;
+export declare const _testOnly:{
+buildResourceSnapshot:typeof buildResourceSnapshot;
+evaluateWorkerResult:typeof evaluateWorkerResult;
+isPidRunning:typeof isPidRunning;
+parseLinuxCpuStat:typeof parseLinuxCpuStat;
+parseLinuxRssStatus:typeof parseLinuxRssStatus;
+parseProgressLine:typeof parseProgressLine;
+readLinuxCpuSeconds:typeof readLinuxCpuSeconds;
+readLinuxRssBytes:typeof readLinuxRssBytes;
+refreshRunIfStale:typeof refreshRunIfStale;
+splitLines:typeof splitLines;
+tailLines:typeof tailLines;
 };
 export {};

package/dist/core/test/item-test-run-tracking.d.ts

@@ -1,12 +1,12 @@
-import type { ItemTestRunSummary, PmSettings } from "../../types/index.js";
+import type { ItemTestRunSummary,PmSettings } from "../../types/index.js";
 /** Normalize, order, and bound test-run history using the configured retention policy. */
-export declare function buildTrackedTestRunHistory(entries: ItemTestRunSummary[]): ItemTestRunSummary[];
+export declare function buildTrackedTestRunHistory(entries:ItemTestRunSummary[]):ItemTestRunSummary[];
 /** Implements append tracked test run summary for the public runtime surface of this module. */
-export declare function appendTrackedTestRunSummary(options: {
-pmRoot: string;
-settings: PmSettings;
-itemId: string;
-author: string;
-entry: ItemTestRunSummary;
-message?: string;
-}): Promise<void>;
+export declare function appendTrackedTestRunSummary(options:{
+pmRoot:string;
+settings:PmSettings;
+itemId:string;
+author:string;
+entry:ItemTestRunSummary;
+message?:string;
+}):Promise<void>;

package/dist/core/test/run-selectors.d.ts

@@ -11,30 +11,30 @@ export type LinkedTestSelectorKind = "match" | "only-index" | "only-last";
 /** Documents the linked test run selector payload exchanged by command, SDK, and package integrations. */
 export interface LinkedTestRunSelector {
 /** Value that configures or reports match for this contract. */
-match?: string;
+match?:string;
 /** Value that configures or reports only index for this contract. */
-onlyIndex?: number;
+onlyIndex?:number;
 /** Value that configures or reports only last for this contract. */
-onlyLast?: boolean;
+onlyLast?:boolean;
 }
 /** Documents the linked test run selection payload exchanged by command, SDK, and package integrations. */
 export interface LinkedTestRunSelection {
 /** Value that configures or reports selector for this contract. */
-selector: LinkedTestSelectorKind | null;
+selector:LinkedTestSelectorKind | null;
 /** Value that configures or reports requested for this contract. */
-requested: string | null;
+requested:string | null;
 /** Value that configures or reports selected for this contract. */
-selected: LinkedTest[];
+selected:LinkedTest[];
 /** 1-based positions of selected entries in the original `--list` order. */
-selected_indexes: number[];
+selected_indexes:number[];
 /** Number of selected entries represented by this result. */
-selected_count: number;
+selected_count:number;
 /** Number of skipped entries represented by this result. */
-skipped_count: number;
+skipped_count:number;
 }
 /** Implements parse only index value for the public runtime surface of this module. */
-export declare function parseOnlyIndexValue(raw: string | number, optionName?: string): number;
+export declare function parseOnlyIndexValue(raw:string | number,optionName?:string):number;
 /** Implements describe linked test entries for the public runtime surface of this module. */
-export declare function describeLinkedTestEntries(tests: LinkedTest[]): string;
+export declare function describeLinkedTestEntries(tests:LinkedTest[]):string;
 /** Implements resolve linked test run selection for the public runtime surface of this module. */
-export declare function resolveLinkedTestRunSelection(tests: LinkedTest[], selector: LinkedTestRunSelector): LinkedTestRunSelection;
+export declare function resolveLinkedTestRunSelection(tests:LinkedTest[],selector:LinkedTestRunSelector):LinkedTestRunSelection;

package/dist/core/validate/estimate-defaults.d.ts

@@ -12,10 +12,10 @@
  * deterministic, non-throwing style of stale-file-classification.ts).
  */
 /** Built-in per-type default estimates in MINUTES used by `pm validate --auto-fix` (GH-212) to backfill missing `estimated_minutes`. Keys are canonical built-in type names. Lookups are case-insensitive (see resolveEstimateDefaultMinutes). */
-export declare const DEFAULT_ESTIMATE_MINUTES_BY_TYPE: Readonly<Record<string, number>>;
+export declare const DEFAULT_ESTIMATE_MINUTES_BY_TYPE:Readonly<Record<string,number>>;
 /** Fallback when neither overrides nor the built-in map have the type. */
 export declare const FALLBACK_ESTIMATE_MINUTES = 120;
 /** Resolve the default estimated-minutes for an item type. Precedence: overrides (case-insensitive key match) > DEFAULT_ESTIMATE_MINUTES_BY_TYPE (case-insensitive) > FALLBACK_ESTIMATE_MINUTES. - `type` undefined/empty -> FALLBACK. - Only finite values > 0 are honored from overrides/defaults; a non-positive or non-finite override value is ignored and resolution continues to the next tier. - Returned value is a positive integer (floor of the resolved value). */
-export declare function resolveEstimateDefaultMinutes(type: string | undefined, overrides?: Readonly<Record<string, number>>): number;
+export declare function resolveEstimateDefaultMinutes(type:string | undefined,overrides?:Readonly<Record<string,number>>):number;
 /** Validate + normalize a raw `validation.estimate_defaults_by_type` settings object into a clean Record<string, number> of positive integers, dropping invalid entries. Used so the pure resolver always receives a sane override map. Returns {} for undefined/null/non-object input. Trims keys; ignores empty keys and non-positive / non-finite / non-number values. Floors values to integers. */
-export declare function normalizeEstimateDefaultOverrides(raw: unknown): Record<string, number>;
+export declare function normalizeEstimateDefaultOverrides(raw:unknown):Record<string,number>;

package/dist/core/validate/fix-planning.d.ts

@@ -22,91 +22,91 @@ export type ValidateFixKind = "set_resolution" | "set_close_reason" | "set_estim
 /** Restricts validate fix scope values accepted by command, SDK, and storage contracts. */
 export type ValidateFixScope = "metadata" | "resolution" | "estimates" | "timestamps" | "lifecycle";
 /** Scopes auto-applied without an explicit `--fix-scope` (safe field backfills). */
-export declare const DEFAULT_GRANTED_FIX_SCOPES: readonly ValidateFixScope[];
+export declare const DEFAULT_GRANTED_FIX_SCOPES:readonly ValidateFixScope[];
 /** Scopes accepted by `--fix-scope`. Estimates are heuristic, timestamps require verified historical replay, and lifecycle changes are structural; all three require explicit opt-in. */
-export declare const SUPPORTED_FIX_SCOPES: readonly ValidateFixScope[];
+export declare const SUPPORTED_FIX_SCOPES:readonly ValidateFixScope[];
 /** Documents the validate fix record payload exchanged by command, SDK, and package integrations. */
 export interface ValidateFixRecord {
 /** Item the fix targets. */
-item_id: string;
+item_id:string;
 /** Validate check the finding came from. */
-check: ValidateFixCheck;
+check:ValidateFixCheck;
 /** Item-metadata field (or link list) the fix changes. */
-field: string;
+field:string;
 /** Declarative fix kind the applier dispatches on. */
-kind: ValidateFixKind;
+kind:ValidateFixKind;
 /** Equivalent standalone `pm` command for the fix. */
-command: string;
+command:string;
 /** New value for set-field fixes. */
-value?: string;
+value?:string;
 /** Stale link path for prune fixes. */
-path?: string;
+path?:string;
 /** Target parent id for reparent fixes. */
-parent_id?: string;
+parent_id?:string;
 /** Fix scope the `--fix-scope` allowlist must grant for the fix to be applied. Every `--auto-fix` record carries one (the granted default is metadata+resolution; lifecycle must be named explicitly). Absent only on `--prune-missing` records, which are governed by their own flag. */
-gate?: ValidateFixScope;
+gate?:ValidateFixScope;
 }
 /** Documents the resolution backfill row payload exchanged by command, SDK, and package integrations. */
 export interface ResolutionBackfillRow {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Resolution-check missing field keys for this closed item. */
-missing_fields: readonly string[];
+missing_fields:readonly string[];
 /** The item's close_reason, when present (preferred derivation source). */
-close_reason?: string;
+close_reason?:string;
 }
 /** Plan resolution backfills for closed items flagged by the resolution check. Only the `resolution` field is mechanical enough to auto-fix: it derives from the item's own `close_reason` when present and falls back to the `"completed"` default. `expected_result` / `actual_result` stay hint-only — no deterministic source text exists for them. */
-export declare function planResolutionBackfillFixes(rows: readonly ResolutionBackfillRow[]): ValidateFixRecord[];
+export declare function planResolutionBackfillFixes(rows:readonly ResolutionBackfillRow[]):ValidateFixRecord[];
 /** Documents the close reason backfill row payload exchanged by command, SDK, and package integrations. */
 export interface CloseReasonBackfillRow {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** The item's resolution, when present (the only derivation source). */
-resolution?: string;
+resolution?:string;
 }
 /** Plan close_reason backfills for closed items flagged by the metadata check. Only derivable when the item already carries a resolution; items missing both stay hint-only (any synthesized reason would be fabricated, not derived). */
-export declare function planCloseReasonBackfillFixes(rows: readonly CloseReasonBackfillRow[]): ValidateFixRecord[];
+export declare function planCloseReasonBackfillFixes(rows:readonly CloseReasonBackfillRow[]):ValidateFixRecord[];
 /** Documents the estimate backfill row payload exchanged by command, SDK, and package integrations. */
 export interface EstimateBackfillRow {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Item type, used to resolve the per-type default estimate. */
-type?: string;
+type?:string;
 }
 /** Plan estimate backfills for items flagged by the metadata check as missing `estimated_minutes` (GH-212). The value is a config-driven per-type default (overrides > built-in map > fallback), never a derived fact — so these fixes carry `gate: "estimates"`, an opt-in scope that is NOT granted by default. `overrides` is the already-normalized `validation.estimate_defaults_by_type` map; pass `undefined`/`{}` to use the built-in defaults. */
-export declare function planEstimateBackfillFixes(rows: readonly EstimateBackfillRow[], overrides?: Readonly<Record<string, number>>): ValidateFixRecord[];
+export declare function planEstimateBackfillFixes(rows:readonly EstimateBackfillRow[],overrides?:Readonly<Record<string,number>>):ValidateFixRecord[];
 /** Documents the terminal parent fix row payload exchanged by command, SDK, and package integrations. */
 export interface TerminalParentFixRow {
 /** Stable identifier used to reference this record across commands and storage. */
-id: string;
+id:string;
 /** Value that configures or reports parent id for this contract. */
-parent_id: string;
+parent_id:string;
 /** The terminal parent's own parent, when one exists. */
-grandparent_id?: string;
+grandparent_id?:string;
 /** True when the grandparent exists and is NOT terminal (safe reparent target). */
-grandparent_active?: boolean;
+grandparent_active?:boolean;
 }
 /** Plan lifecycle fixes for active items whose parent is terminal (pm-8jss / GH-168). When the terminal parent has an active grandparent, the child is reparented one level up (it stays inside the same hierarchy); otherwise the parent link is cleared so the item surfaces as unparented active work. Either way the item itself is never closed or mutated beyond `parent` — and every fix carries `gate: "lifecycle"` so it is only applied under an explicit `--fix-scope lifecycle`. */
-export declare function planTerminalParentFixes(rows: readonly TerminalParentFixRow[]): ValidateFixRecord[];
+export declare function planTerminalParentFixes(rows:readonly TerminalParentFixRow[]):ValidateFixRecord[];
 /** Documents the stale link prune row payload exchanged by command, SDK, and package integrations. */
 export interface StaleLinkPruneRow {
 /** Value that configures or reports item id for this contract. */
-item_id: string;
+item_id:string;
 /** Filesystem path used for path resolution. */
-path: string;
+path:string;
 /** Value that configures or reports link kind for this contract. */
-link_kind: "files" | "docs";
+link_kind:"files" | "docs";
 /** Value that configures or reports classification for this contract. */
-classification: "moved" | "deleted" | "malformed";
+classification:"moved" | "deleted" | "malformed";
 }
 /** Plan link prunes for `--prune-missing` (pm-0v2m / GH-184). Only links whose stale path classified as `deleted` are pruned; `moved` links keep their relink candidates in the files-check details instead of being dropped, so recoverable link information is never destroyed. Link removal only — real files are never touched. */
-export declare function planStaleLinkPruneFixes(rows: readonly StaleLinkPruneRow[]): ValidateFixRecord[];
+export declare function planStaleLinkPruneFixes(rows:readonly StaleLinkPruneRow[]):ValidateFixRecord[];
 /** Resolve the granted `--fix-scope` set (repeatable and/or comma-separated). With no explicit scopes the safe field-backfill scopes (metadata, resolution) are granted; lifecycle must always be named explicitly. Unknown values fail fast with the supported list. */
-export declare function resolveGrantedFixScopes(rawScopes: readonly string[] | undefined): Set<ValidateFixScope>;
+export declare function resolveGrantedFixScopes(rawScopes:readonly string[] | undefined):Set<ValidateFixScope>;
 /** Split a fix plan into the records that may be applied under the granted scopes and the gated records that were withheld. `--fix-scope` is an exact allowlist: every `--auto-fix` record requires its gate scope in `granted`. Ungated records (`--prune-missing` link prunes, governed by their own flag) are always applicable. */
-export declare function partitionFixesByGrant(fixes: readonly ValidateFixRecord[], granted: ReadonlySet<ValidateFixScope>): {
-applicable: ValidateFixRecord[];
-gated: ValidateFixRecord[];
+export declare function partitionFixesByGrant(fixes:readonly ValidateFixRecord[],granted:ReadonlySet<ValidateFixScope>):{
+applicable:ValidateFixRecord[];
+gated:ValidateFixRecord[];
 };
 /** Compact serialization of a fix for planned/applied output rows. */
-export declare function toFixOutputRow(fix: ValidateFixRecord): Record<string, unknown>;
+export declare function toFixOutputRow(fix:ValidateFixRecord):Record<string,unknown>;

package/dist/core/validate/linked-artifact-reference.d.ts

@@ -17,4 +17,4 @@
  * string and branch on the boolean result.
  */
 /** Return `true` when a linked-artifact path is a remote reference (a URL with a `scheme://` authority) rather than a local filesystem path. Whitespace is trimmed before matching so a stored `" https://…"` is still recognized. */
-export declare function isRemoteLinkedArtifactReference(path: string): boolean;
+export declare function isRemoteLinkedArtifactReference(path:string):boolean;

package/dist/core/validate/missing-by-type.d.ts

@@ -10,9 +10,9 @@
 /** One missing required metadata field observed on an item of a specific type. */
 export interface MissingFieldOccurrence {
 /** Item type name as stored in item metadata (e.g. "Task"). */
-item_type: string;
+item_type:string;
 /** Required metadata field that is missing on the item. */
-field: string;
+field:string;
 }
 /** Aggregate missing-field occurrences into `{ type: { field: count } }` with both levels sorted lexicographically for stable, diff-friendly output. Zero counts never appear (only observed occurrences are aggregated). */
-export declare function buildMissingByTypeCounts(occurrences: Iterable<MissingFieldOccurrence>): Record<string, Record<string, number>>;
+export declare function buildMissingByTypeCounts(occurrences:Iterable<MissingFieldOccurrence>):Record<string,Record<string,number>>;