@unbrained/pm-cli 2026.10.12 → 2026.10.13

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

@@ -6,211 +6,211 @@ export type BackgroundTestRunStatus = "queued" | "running" | "passed" | "failed"
 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";
-    /** Human-readable explanation suitable for logs and agent-facing output. */
-    message?: string;
-    /** Value that configures or reports item index for this contract. */
-    item_index?: number;
-    /** Value that configures or reports item total for this contract. */
-    item_total?: number;
-    /** Value that configures or reports item id for this contract. */
-    item_id?: string;
-    /** Value that configures or reports linked test index for this contract. */
-    linked_test_index?: number;
-    /** Value that configures or reports linked test total for this contract. */
-    linked_test_total?: number;
-    /** Value that configures or reports current command for this contract. */
-    current_command?: string;
-    /** Elapsed time in milliseconds for elapsed. */
-    elapsed_ms?: number;
-    /** ISO 8601 timestamp recording when heartbeat occurred. */
-    heartbeat_at?: string;
+/** Value that configures or reports phase for this contract. */
+phase: "queued" | "running" | "stopping" | "finished";
+/** Human-readable explanation suitable for logs and agent-facing output. */
+message?: string;
+/** Value that configures or reports item index for this contract. */
+item_index?: number;
+/** Value that configures or reports item total for this contract. */
+item_total?: number;
+/** Value that configures or reports item id for this contract. */
+item_id?: string;
+/** Value that configures or reports linked test index for this contract. */
+linked_test_index?: number;
+/** Value that configures or reports linked test total for this contract. */
+linked_test_total?: number;
+/** Value that configures or reports current command for this contract. */
+current_command?: string;
+/** Elapsed time in milliseconds for elapsed. */
+elapsed_ms?: number;
+/** ISO 8601 timestamp recording when heartbeat occurred. */
+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;
-    /** Value that configures or reports rss bytes for this contract. */
-    rss_bytes?: number;
-    /** Value that configures or reports cpu user seconds for this contract. */
-    cpu_user_seconds?: number;
-    /** Value that configures or reports cpu system seconds for this contract. */
-    cpu_system_seconds?: number;
-    /** Value that configures or reports uptime seconds for this contract. */
-    uptime_seconds?: number;
+/** ISO 8601 timestamp recording when recorded occurred. */
+recorded_at: string;
+/** Value that configures or reports rss bytes for this contract. */
+rss_bytes?: number;
+/** Value that configures or reports cpu user seconds for this contract. */
+cpu_user_seconds?: number;
+/** Value that configures or reports cpu system seconds for this contract. */
+cpu_system_seconds?: number;
+/** Value that configures or reports uptime seconds for this contract. */
+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;
-    /** Value that configures or reports linked tests for this contract. */
-    linked_tests?: number;
-    /** Value that configures or reports passed for this contract. */
-    passed: number;
-    /** Value that configures or reports failed for this contract. */
-    failed: number;
-    /** Value that configures or reports skipped for this contract. */
-    skipped: number;
-    /** Value that configures or reports fail on skipped triggered for this contract. */
-    fail_on_skipped_triggered?: boolean;
+/** Value that configures or reports items for this contract. */
+items?: number;
+/** Value that configures or reports linked tests for this contract. */
+linked_tests?: number;
+/** Value that configures or reports passed for this contract. */
+passed: number;
+/** Value that configures or reports failed for this contract. */
+failed: number;
+/** Value that configures or reports skipped for this contract. */
+skipped: number;
+/** Value that configures or reports fail on skipped triggered for this contract. */
+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;
-    /** Value that configures or reports kind for this contract. */
-    kind: BackgroundTestRunKind;
-    /** Lifecycle state reported for status. */
-    status: BackgroundTestRunStatus;
-    /** ISO 8601 timestamp recording when created occurred. */
-    created_at: string;
-    /** ISO 8601 timestamp recording when started occurred. */
-    started_at?: string;
-    /** ISO 8601 timestamp recording when finished occurred. */
-    finished_at?: string;
-    /** ISO 8601 timestamp recording when updated occurred. */
-    updated_at: string;
-    /** Value that configures or reports requested by for this contract. */
-    requested_by: string;
-    /** Value that configures or reports fingerprint for this contract. */
-    fingerprint: string;
-    /** Value that configures or reports command args for this contract. */
-    command_args: string[];
-    /** Value that configures or reports command label for this contract. */
-    command_label: string;
-    /** Value that configures or reports pm root for this contract. */
-    pm_root: string;
-    /** Value that configures or reports global pm root for this contract. */
-    global_pm_root: string;
-    /** Value that configures or reports target id for this contract. */
-    target_id?: string;
-    /** Value that configures or reports status filter for this contract. */
-    status_filter?: string;
-    /** Value that configures or reports attempt for this contract. */
-    attempt: number;
-    /** Value that configures or reports resumed from for this contract. */
-    resumed_from?: string;
-    /** Value that configures or reports resumed by for this contract. */
-    resumed_by?: string;
-    /** Value that configures or reports worker pid for this contract. */
-    worker_pid?: number;
-    /** Value that configures or reports child pid for this contract. */
-    child_pid?: number;
-    /** Value that configures or reports exit code for this contract. */
-    exit_code?: number;
-    /** Value that configures or reports signal for this contract. */
-    signal?: string;
-    /** Filesystem path used for stdout resolution. */
-    stdout_path: string;
-    /** Filesystem path used for stderr resolution. */
-    stderr_path: string;
-    /** Filesystem path used for result resolution. */
-    result_path: string;
-    /** Value that configures or reports progress for this contract. */
-    progress?: BackgroundRunProgress;
-    /** Value that configures or reports resource for this contract. */
-    resource?: BackgroundRunResourceSnapshot;
-    /** Value that configures or reports summary for this contract. */
-    summary?: BackgroundRunSummary;
-    /** ISO 8601 timestamp recording when stop requested occurred. */
-    stop_requested_at?: string;
-    /** Value that configures or reports duplicate of for this contract. */
-    duplicate_of?: string;
-    /** Value that configures or reports error for this contract. */
-    error?: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports kind for this contract. */
+kind: BackgroundTestRunKind;
+/** Lifecycle state reported for status. */
+status: BackgroundTestRunStatus;
+/** ISO 8601 timestamp recording when created occurred. */
+created_at: string;
+/** ISO 8601 timestamp recording when started occurred. */
+started_at?: string;
+/** ISO 8601 timestamp recording when finished occurred. */
+finished_at?: string;
+/** ISO 8601 timestamp recording when updated occurred. */
+updated_at: string;
+/** Value that configures or reports requested by for this contract. */
+requested_by: string;
+/** Value that configures or reports fingerprint for this contract. */
+fingerprint: string;
+/** Value that configures or reports command args for this contract. */
+command_args: string[];
+/** Value that configures or reports command label for this contract. */
+command_label: string;
+/** Value that configures or reports pm root for this contract. */
+pm_root: string;
+/** Value that configures or reports global pm root for this contract. */
+global_pm_root: string;
+/** Value that configures or reports target id for this contract. */
+target_id?: string;
+/** Value that configures or reports status filter for this contract. */
+status_filter?: string;
+/** Value that configures or reports attempt for this contract. */
+attempt: number;
+/** Value that configures or reports resumed from for this contract. */
+resumed_from?: string;
+/** Value that configures or reports resumed by for this contract. */
+resumed_by?: string;
+/** Value that configures or reports worker pid for this contract. */
+worker_pid?: number;
+/** Value that configures or reports child pid for this contract. */
+child_pid?: number;
+/** Value that configures or reports exit code for this contract. */
+exit_code?: number;
+/** Value that configures or reports signal for this contract. */
+signal?: string;
+/** Filesystem path used for stdout resolution. */
+stdout_path: string;
+/** Filesystem path used for stderr resolution. */
+stderr_path: string;
+/** Filesystem path used for result resolution. */
+result_path: string;
+/** Value that configures or reports progress for this contract. */
+progress?: BackgroundRunProgress;
+/** Value that configures or reports resource for this contract. */
+resource?: BackgroundRunResourceSnapshot;
+/** Value that configures or reports summary for this contract. */
+summary?: BackgroundRunSummary;
+/** ISO 8601 timestamp recording when stop requested occurred. */
+stop_requested_at?: string;
+/** Value that configures or reports duplicate of for this contract. */
+duplicate_of?: string;
+/** Value that configures or reports error for this contract. */
+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;
-    /** Value that configures or reports global pm root for this contract. */
-    globalPmRoot: string;
-    /** Value that configures or reports kind for this contract. */
-    kind: BackgroundTestRunKind;
-    /** Value that configures or reports command args for this contract. */
-    commandArgs: string[];
-    /** Value that configures or reports requested by for this contract. */
-    requestedBy: string;
-    /** Value that configures or reports target id for this contract. */
-    targetId?: string;
-    /** Value that configures or reports status filter for this contract. */
-    statusFilter?: string;
-    /** Value that configures or reports resumed from for this contract. */
-    resumedFrom?: string;
-    /** Value that configures or reports resumed by for this contract. */
-    resumedBy?: string;
-    /** Value that configures or reports attempt for this contract. */
-    attempt?: number;
+/** Value that configures or reports pm root for this contract. */
+pmRoot: string;
+/** Value that configures or reports global pm root for this contract. */
+globalPmRoot: string;
+/** Value that configures or reports kind for this contract. */
+kind: BackgroundTestRunKind;
+/** Value that configures or reports command args for this contract. */
+commandArgs: string[];
+/** Value that configures or reports requested by for this contract. */
+requestedBy: string;
+/** Value that configures or reports target id for this contract. */
+targetId?: string;
+/** Value that configures or reports status filter for this contract. */
+statusFilter?: string;
+/** Value that configures or reports resumed from for this contract. */
+resumedFrom?: string;
+/** Value that configures or reports resumed by for this contract. */
+resumedBy?: string;
+/** Value that configures or reports attempt for this contract. */
+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;
-    /** Value that configures or reports run for this contract. */
-    run: BackgroundTestRunRecord;
-    /** Value that configures or reports duplicate of for this contract. */
-    duplicate_of?: string;
+/** Value that configures or reports started for this contract. */
+started: boolean;
+/** Value that configures or reports run for this contract. */
+run: BackgroundTestRunRecord;
+/** Value that configures or reports duplicate of for this contract. */
+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;
-    /** Executes the id operation through the package runtime. */
-    runId: string;
-    /** Value that configures or reports no extensions for this contract. */
-    noExtensions?: boolean;
+/** Value that configures or reports pm root for this contract. */
+pmRoot: string;
+/** Executes the id operation through the package runtime. */
+runId: string;
+/** Value that configures or reports no extensions for this contract. */
+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;
-    /** Value that configures or reports signal sent for this contract. */
-    signal_sent: "SIGTERM" | "SIGKILL" | "none";
+/** Value that configures or reports run for this contract. */
+run: BackgroundTestRunRecord;
+/** Value that configures or reports signal sent for this contract. */
+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;
-    /** Value that configures or reports limit for this contract. */
-    limit?: number;
+/** Lifecycle state reported for status. */
+status?: BackgroundTestRunStatus;
+/** Value that configures or reports limit for this contract. */
+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";
-    /** ISO 8601 timestamp recording when last heartbeat occurred. */
-    last_heartbeat_at?: string;
-    /** Elapsed time in milliseconds for heartbeat lag. */
-    heartbeat_lag_ms?: number;
-    /** Value that configures or reports worker alive for this contract. */
-    worker_alive: boolean;
-    /** Value that configures or reports child alive for this contract. */
-    child_alive: boolean;
+/** Value that configures or reports state for this contract. */
+state: "healthy" | "stale" | "inactive";
+/** ISO 8601 timestamp recording when last heartbeat occurred. */
+last_heartbeat_at?: string;
+/** Elapsed time in milliseconds for heartbeat lag. */
+heartbeat_lag_ms?: number;
+/** Value that configures or reports worker alive for this contract. */
+worker_alive: boolean;
+/** Value that configures or reports child alive for this contract. */
+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;
-    /** Value that configures or reports health for this contract. */
-    health: BackgroundRunHealth;
+/** Value that configures or reports run for this contract. */
+run: BackgroundTestRunRecord;
+/** Value that configures or reports health for this contract. */
+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;
-    /** Value that configures or reports stream for this contract. */
-    stream: BackgroundLogStream;
-    /** Value that configures or reports tail for this contract. */
-    tail: number;
-    /** Value that configures or reports stdout for this contract. */
-    stdout: string[];
-    /** Value that configures or reports stderr for this contract. */
-    stderr: string[];
+/** Value that configures or reports run for this contract. */
+run: BackgroundTestRunRecord;
+/** Value that configures or reports stream for this contract. */
+stream: BackgroundLogStream;
+/** Value that configures or reports tail for this contract. */
+tail: number;
+/** Value that configures or reports stdout for this contract. */
+stdout: string[];
+/** Value that configures or reports stderr for this contract. */
+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;
@@ -220,12 +220,12 @@ export declare function readBackgroundTestRunRecord(pmRoot: string, runId: strin
 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;
+cpu_user_seconds?: number;
+cpu_system_seconds?: number;
 };
 declare function readLinuxCpuSeconds(pid: number): Promise<{
-    cpu_user_seconds?: number;
-    cpu_system_seconds?: number;
+cpu_user_seconds?: number;
+cpu_system_seconds?: number;
 }>;
 declare function buildResourceSnapshot(record: BackgroundTestRunRecord): Promise<BackgroundRunResourceSnapshot | undefined>;
 /** Derive worker totals from aggregate or per-test receipts, counting refusals as unsuccessful runs. */
@@ -252,16 +252,16 @@ export declare function resumeBackgroundTestRun(pmRoot: string, runId: string, r
 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;
+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

@@ -3,10 +3,10 @@ import type { ItemTestRunSummary, PmSettings } from "../../types/index.js";
 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;
+pmRoot: string;
+settings: PmSettings;
+itemId: string;
+author: string;
+entry: ItemTestRunSummary;
+message?: string;
 }): Promise<void>;

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

@@ -10,27 +10,27 @@ import type { LinkedTest } from "../../types.js";
 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;
-    /** Value that configures or reports only index for this contract. */
-    onlyIndex?: number;
-    /** Value that configures or reports only last for this contract. */
-    onlyLast?: boolean;
+/** Value that configures or reports match for this contract. */
+match?: string;
+/** Value that configures or reports only index for this contract. */
+onlyIndex?: number;
+/** Value that configures or reports only last for this contract. */
+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;
-    /** Value that configures or reports requested for this contract. */
-    requested: string | null;
-    /** Value that configures or reports selected for this contract. */
-    selected: LinkedTest[];
-    /** 1-based positions of selected entries in the original `--list` order. */
-    selected_indexes: number[];
-    /** Number of selected entries represented by this result. */
-    selected_count: number;
-    /** Number of skipped entries represented by this result. */
-    skipped_count: number;
+/** Value that configures or reports selector for this contract. */
+selector: LinkedTestSelectorKind | null;
+/** Value that configures or reports requested for this contract. */
+requested: string | null;
+/** Value that configures or reports selected for this contract. */
+selected: LinkedTest[];
+/** 1-based positions of selected entries in the original `--list` order. */
+selected_indexes: number[];
+/** Number of selected entries represented by this result. */
+selected_count: number;
+/** Number of skipped entries represented by this result. */
+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;

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

@@ -27,77 +27,77 @@ export declare const DEFAULT_GRANTED_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;
-    /** Validate check the finding came from. */
-    check: ValidateFixCheck;
-    /** Item-metadata field (or link list) the fix changes. */
-    field: string;
-    /** Declarative fix kind the applier dispatches on. */
-    kind: ValidateFixKind;
-    /** Equivalent standalone `pm` command for the fix. */
-    command: string;
-    /** New value for set-field fixes. */
-    value?: string;
-    /** Stale link path for prune fixes. */
-    path?: string;
-    /** Target parent id for reparent fixes. */
-    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;
+/** Item the fix targets. */
+item_id: string;
+/** Validate check the finding came from. */
+check: ValidateFixCheck;
+/** Item-metadata field (or link list) the fix changes. */
+field: string;
+/** Declarative fix kind the applier dispatches on. */
+kind: ValidateFixKind;
+/** Equivalent standalone `pm` command for the fix. */
+command: string;
+/** New value for set-field fixes. */
+value?: string;
+/** Stale link path for prune fixes. */
+path?: string;
+/** Target parent id for reparent fixes. */
+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;
 }
 /** 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;
-    /** Resolution-check missing field keys for this closed item. */
-    missing_fields: readonly string[];
-    /** The item's close_reason, when present (preferred derivation source). */
-    close_reason?: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Resolution-check missing field keys for this closed item. */
+missing_fields: readonly string[];
+/** The item's close_reason, when present (preferred derivation source). */
+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[];
 /** 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;
-    /** The item's resolution, when present (the only derivation source). */
-    resolution?: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** The item's resolution, when present (the only derivation source). */
+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[];
 /** 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;
-    /** Item type, used to resolve the per-type default estimate. */
-    type?: string;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Item type, used to resolve the per-type default estimate. */
+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[];
 /** 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;
-    /** Value that configures or reports parent id for this contract. */
-    parent_id: string;
-    /** The terminal parent's own parent, when one exists. */
-    grandparent_id?: string;
-    /** True when the grandparent exists and is NOT terminal (safe reparent target). */
-    grandparent_active?: boolean;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports parent id for this contract. */
+parent_id: string;
+/** The terminal parent's own parent, when one exists. */
+grandparent_id?: string;
+/** True when the grandparent exists and is NOT terminal (safe reparent target). */
+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[];
 /** 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;
-    /** Filesystem path used for path resolution. */
-    path: string;
-    /** Value that configures or reports link kind for this contract. */
-    link_kind: "files" | "docs";
-    /** Value that configures or reports classification for this contract. */
-    classification: "moved" | "deleted" | "malformed";
+/** Value that configures or reports item id for this contract. */
+item_id: string;
+/** Filesystem path used for path resolution. */
+path: string;
+/** Value that configures or reports link kind for this contract. */
+link_kind: "files" | "docs";
+/** Value that configures or reports classification for this contract. */
+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[];
@@ -105,8 +105,8 @@ export declare function planStaleLinkPruneFixes(rows: readonly StaleLinkPruneRow
 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[];
+applicable: ValidateFixRecord[];
+gated: ValidateFixRecord[];
 };
 /** Compact serialization of a fix for planned/applied output rows. */
 export declare function toFixOutputRow(fix: ValidateFixRecord): Record<string, unknown>;