@unbrained/pm-cli 2026.10.11 → 2026.10.13

package/dist/sdk/test/execution.d.ts

@@ -14,199 +14,210 @@ import { type TestRunMeasurementDiff } from "./measurements.js";
 import { type LinkedTestTrustDecision } from "./trust.js";
 type ResolvedLinkedTestPmContextMode = Exclude<LinkedTestPmContextMode, "auto">;
 interface LinkedTestExecutionResult {
-    stdout: string;
-    stderr: string;
-    exitCode: number | null;
-    signal?: NodeJS.Signals | null;
-    timedOut: boolean;
-    maxBufferExceeded: boolean;
-    outputTruncated: boolean;
-    spawnError?: string;
+stdout: string;
+stderr: string;
+exitCode: number | null;
+signal?: NodeJS.Signals | null;
+timedOut: boolean;
+maxBufferExceeded: boolean;
+outputTruncated: boolean;
+spawnError?: string;
 }
 interface LinkedTestProgressContext {
-    index: number;
-    total: number;
-    timeoutMs: number;
-    command: string;
+index: number;
+total: number;
+timeoutMs: number;
+command: string;
 }
 type LinkedTestProgressMode = "auto" | "always" | "off";
 interface LinkedTestSandboxSourceRoots {
-    projectPmRoot: string;
-    globalPmRoot: string;
+projectPmRoot: string;
+globalPmRoot: string;
 }
 /** Documents the test command options payload exchanged by command, SDK, and package integrations. */
 export interface TestCommandOptions {
-    /** Value that configures or reports add for this contract. */
-    add?: string[];
-    /** Value that configures or reports add json for this contract. */
-    addJson?: string[];
-    /** Value that configures or reports remove for this contract. */
-    remove?: string[];
-    /** Remove linked tests by their stable 1-based list position. */
-    removeIndex?: Array<string | number>;
-    /** Value that configures or reports list for this contract. */
-    list?: boolean;
-    /** Value that configures or reports run for this contract. */
-    run?: boolean;
-    /** Value that configures or reports match for this contract. */
-    match?: string;
-    /** Value that configures or reports only index for this contract. */
-    onlyIndex?: string | number;
-    /** Value that configures or reports only last for this contract. */
-    onlyLast?: boolean;
-    /** Value that configures or reports timeout for this contract. */
-    timeout?: string;
-    /** Value that configures or reports progress for this contract. */
-    progress?: boolean;
-    /** Value that configures or reports env set for this contract. */
-    envSet?: string[];
-    /** Value that configures or reports env clear for this contract. */
-    envClear?: string[];
-    /** Value that configures or reports shared host safe for this contract. */
-    sharedHostSafe?: boolean;
-    /** Value that configures or reports pm context for this contract. */
-    pmContext?: string;
-    /** Value that configures or reports override linked pm context for this contract. */
-    overrideLinkedPmContext?: boolean;
-    /** Source-workspace visibility and working-directory mode. */
-    workspaceContext?: string;
-    /** Force the run-level workspace mode over per-test metadata. */
-    overrideLinkedWorkspaceContext?: boolean;
-    /** Explicitly permit an untrusted linked command when project policy also permits it. */
-    allowUntrustedLinkedTests?: boolean;
-    /** Record clone-local acknowledgement for the item's current linked tests. */
-    acknowledgeLinkedTests?: boolean;
-    /** Value that configures or reports fail on context mismatch for this contract. */
-    failOnContextMismatch?: boolean;
-    /** Value that configures or reports fail on skipped for this contract. */
-    failOnSkipped?: boolean;
-    /** Value that configures or reports fail on empty test run for this contract. */
-    failOnEmptyTestRun?: boolean;
-    /** Value that configures or reports require assertions for pm for this contract. */
-    requireAssertionsForPm?: boolean;
-    /** Value that configures or reports check context for this contract. */
-    checkContext?: boolean;
-    /** Value that configures or reports auto pm context for this contract. */
-    autoPmContext?: boolean;
-    /** Value that configures or reports author for this contract. */
-    author?: string;
-    /** Human-readable explanation suitable for logs and agent-facing output. */
-    message?: string;
-    /** Value that configures or reports force for this contract. */
-    force?: boolean;
-    /** Repeatable `name=value[,unit=...][,threshold=...]` numeric evidence. */
-    measure?: string[];
-    /** Filter recorded evidence below `name=value`. */
-    metricBelow?: string;
-    /** Compare the latest and previous values for one metric name. */
-    metricDiff?: string;
+/** Value that configures or reports add for this contract. */
+add?: string[];
+/** Value that configures or reports add json for this contract. */
+addJson?: string[];
+/** Value that configures or reports remove for this contract. */
+remove?: string[];
+/** Remove linked tests by their stable 1-based list position. */
+removeIndex?: Array<string | number>;
+/** Exact command=<value> or path=<value> selector for a metadata edit. */
+update?: string;
+/** One-based linked-test position for a metadata edit. */
+updateIndex?: string | number;
+/** JSON object containing explicit metadata changes; null clears optional fields. */
+setJson?: string;
+/** Value that configures or reports list for this contract. */
+list?: boolean;
+/** Value that configures or reports run for this contract. */
+run?: boolean;
+/** Value that configures or reports match for this contract. */
+match?: string;
+/** Value that configures or reports only index for this contract. */
+onlyIndex?: string | number;
+/** Value that configures or reports only last for this contract. */
+onlyLast?: boolean;
+/** Value that configures or reports timeout for this contract. */
+timeout?: string;
+/** Value that configures or reports progress for this contract. */
+progress?: boolean;
+/** Value that configures or reports env set for this contract. */
+envSet?: string[];
+/** Value that configures or reports env clear for this contract. */
+envClear?: string[];
+/** Value that configures or reports shared host safe for this contract. */
+sharedHostSafe?: boolean;
+/** Value that configures or reports pm context for this contract. */
+pmContext?: string;
+/** Value that configures or reports override linked pm context for this contract. */
+overrideLinkedPmContext?: boolean;
+/** Source-workspace visibility and working-directory mode. */
+workspaceContext?: string;
+/** Force the run-level workspace mode over per-test metadata. */
+overrideLinkedWorkspaceContext?: boolean;
+/** Explicitly permit an untrusted linked command when project policy also permits it. */
+allowUntrustedLinkedTests?: boolean;
+/** Record clone-local acknowledgement for the item's current linked tests. */
+acknowledgeLinkedTests?: boolean;
+/** Value that configures or reports fail on context mismatch for this contract. */
+failOnContextMismatch?: boolean;
+/** Value that configures or reports fail on skipped for this contract. */
+failOnSkipped?: boolean;
+/** Value that configures or reports fail on empty test run for this contract. */
+failOnEmptyTestRun?: boolean;
+/** Value that configures or reports require assertions for pm for this contract. */
+requireAssertionsForPm?: boolean;
+/** Value that configures or reports check context for this contract. */
+checkContext?: boolean;
+/** Value that configures or reports auto pm context for this contract. */
+autoPmContext?: boolean;
+/** Value that configures or reports author for this contract. */
+author?: string;
+/** Human-readable explanation suitable for logs and agent-facing output. */
+message?: string;
+/** Value that configures or reports force for this contract. */
+force?: boolean;
+/** Repeatable `name=value[,unit=...][,threshold=...]` numeric evidence; requires run=true. */
+measure?: string[];
+/** Filter recorded evidence below `name=value`. */
+metricBelow?: string;
+/** Compare the latest and previous values for one metric name. */
+metricDiff?: string;
 }
 /** Restricts linked test failure category values accepted by command, SDK, and storage contracts. */
-export type LinkedTestFailureCategory = "infra_collision" | "trust_refusal" | "assertion_failure" | "empty_run" | "timeout" | "max_buffer" | "spawn_error" | "signal";
+export type LinkedTestFailureCategory = "infra_collision" | "trust_refusal" | "config_refusal" | "assertion_failure" | "empty_run" | "timeout" | "max_buffer" | "spawn_error" | "signal";
 /** Documents the test run result payload exchanged by command, SDK, and package integrations. */
 export interface TestRunResult {
-    /** Value that configures or reports command for this contract. */
-    command?: string;
-    /** Filesystem path used for path resolution. */
-    path?: string;
-    /** Lifecycle state reported for status. */
-    status: "passed" | "failed" | "skipped";
-    /** Value that configures or reports exit code for this contract. */
-    exit_code?: number;
-    /** Value that configures or reports failure category for this contract. */
-    failure_category?: LinkedTestFailureCategory;
-    /** Recognized runner summary proving execution, including the stream that supplied it. */
-    execution_receipt?: {
-        code: string;
-        stream: "stdout" | "stderr";
-    };
-    /** Value that configures or reports execution context for this contract. */
-    execution_context?: {
-        requested_pm_context_mode: LinkedTestPmContextMode;
-        pm_context_mode: LinkedTestPmContextMode;
-        auto_pm_context_applied: boolean;
-        is_pm_command: boolean;
-        is_pm_tracker_read_command: boolean;
-        source_project_pm_path: string;
-        sandbox_project_pm_path: string;
-        source_global_pm_path: string;
-        sandbox_global_pm_path: string;
-        source_project_item_count: number;
-        sandbox_project_item_count: number;
-        source_global_item_count: number;
-        sandbox_global_item_count: number;
-        mismatch_detected: boolean;
-        project_extensions_seeded: boolean;
-        global_extensions_seeded: boolean;
-        requested_workspace_context_mode: LinkedTestWorkspaceContextMode;
-        workspace_context_mode: LinkedTestWorkspaceContextMode;
-        working_directory: string;
-        source_workspace_root: string;
-        trust: LinkedTestTrustDecision;
-    };
-    /** 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 error for this contract. */
-    error?: string;
+/** Value that configures or reports command for this contract. */
+command?: string;
+/** Filesystem path used for path resolution. */
+path?: string;
+/** Lifecycle state reported for status. */
+status: "passed" | "failed" | "skipped" | "refused";
+/** Value that configures or reports exit code for this contract. */
+exit_code?: number | null;
+/** Value that configures or reports failure category for this contract. */
+failure_category?: LinkedTestFailureCategory;
+/** Recognized runner summary proving execution, including the stream that supplied it. */
+execution_receipt?: {
+code: string;
+stream: "stdout" | "stderr";
+};
+/** Value that configures or reports execution context for this contract. */
+execution_context?: {
+requested_pm_context_mode: LinkedTestPmContextMode;
+pm_context_mode: LinkedTestPmContextMode;
+auto_pm_context_applied: boolean;
+is_pm_command: boolean;
+is_pm_tracker_read_command: boolean;
+source_project_pm_path: string;
+sandbox_project_pm_path: string;
+source_global_pm_path: string;
+sandbox_global_pm_path: string;
+source_project_item_count: number;
+sandbox_project_item_count: number;
+source_global_item_count: number;
+sandbox_global_item_count: number;
+mismatch_detected: boolean;
+project_extensions_seeded: boolean;
+global_extensions_seeded: boolean;
+requested_workspace_context_mode: LinkedTestWorkspaceContextMode;
+workspace_context_mode: LinkedTestWorkspaceContextMode;
+working_directory: string;
+source_workspace_root: string;
+trust: LinkedTestTrustDecision;
+};
+/** 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 error for this contract. */
+error?: string;
 }
 /** Documents the test result payload exchanged by command, SDK, and package integrations. */
 export interface TestResult {
-    /** Whether the operation completed without a blocking failure. */
-    ok: boolean;
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Value that configures or reports tests for this contract. */
-    tests: LinkedTest[];
-    /** Executes the results operation through the package runtime. */
-    run_results: TestRunResult[];
-    /** Value that configures or reports failure categories for this contract. */
-    failure_categories: Record<LinkedTestFailureCategory, number>;
-    /** Value that configures or reports selection for this contract. */
-    selection?: Omit<LinkedTestRunSelection, "selected">;
-    /** Value that configures or reports fail on skipped triggered for this contract. */
-    fail_on_skipped_triggered?: boolean;
-    /** Value that configures or reports warnings for this contract. */
-    warnings?: string[];
-    /** Value that configures or reports changed for this contract. */
-    changed: boolean;
-    /** Whether this execution appended evidence to the item's immutable history. */
-    evidence_recording?: {
-        /** True only after the item history mutation succeeds. */
-        recorded: boolean;
-        /** Why the current execution did or did not reach item history. */
-        reason: "recorded" | "tracking_disabled" | "write_failed";
-        /** Identifier of the execution summary, even when item tracking is disabled. */
-        run_id: string;
-        /** Executable next step when recording was disabled. */
-        recovery_command?: string;
-    };
-    /** Value that configures or reports count for this contract. */
-    count: number;
-    /** Number of linked-test entries removed by this mutation. */
-    removed?: number;
-    /** Measurements supplied for the current producing run. */
-    measurements?: TestRunMeasurement[];
-    /** Existing and current measurements below the selected threshold. */
-    metric_below?: Array<TestRunMeasurement & {
-        run_id: string;
-    }>;
-    /** Latest-versus-previous comparison for the selected metric. */
-    metric_diff?: TestRunMeasurementDiff;
+/** Whether the operation completed without a blocking failure. */
+ok: boolean;
+/** Stable identifier used to reference this record across commands and storage. */
+id: string;
+/** Value that configures or reports tests for this contract. */
+tests: LinkedTest[];
+/** Executes the results operation through the package runtime. */
+run_results: TestRunResult[];
+/** Value that configures or reports failure categories for this contract. */
+failure_categories: Record<LinkedTestFailureCategory, number>;
+/** Value that configures or reports selection for this contract. */
+selection?: Omit<LinkedTestRunSelection, "selected">;
+/** Value that configures or reports fail on skipped triggered for this contract. */
+fail_on_skipped_triggered?: boolean;
+/** Value that configures or reports warnings for this contract. */
+warnings?: string[];
+/** Value that configures or reports changed for this contract. */
+changed: boolean;
+/** Whether this execution appended evidence to the item's immutable history. */
+evidence_recording?: {
+/** True only after the item history mutation succeeds. */
+recorded: boolean;
+/** Why the current execution did or did not reach item history. */
+reason: "recorded" | "tracking_disabled" | "write_failed";
+/** Identifier of the execution summary, even when item tracking is disabled. */
+run_id: string;
+/** Executable next step when recording was disabled. */
+recovery_command?: string;
+};
+/** Value that configures or reports count for this contract. */
+count: number;
+/** Number of linked-test entries removed by this mutation. */
+removed?: number;
+/** One-based position selected by an explicit linked-test metadata edit. */
+updated_index?: number;
+/** Normalized metadata fields changed by an explicit edit. */
+updated_fields?: string[];
+/** Measurements supplied for the current producing run. */
+measurements?: TestRunMeasurement[];
+/** Existing and current measurements below the selected threshold. */
+metric_below?: Array<TestRunMeasurement & {
+run_id: string;
+}>;
+/** Latest-versus-previous comparison for the selected metric. */
+metric_diff?: TestRunMeasurementDiff;
 }
 declare function resolveTrackedRunId(kind: "test" | "test-all"): string;
+/** Count execution refusals alongside failures while keeping skipped runs separate. */
 declare function summarizeRunResultStatuses(results: TestRunResult[]): {
-    passed: number;
-    failed: number;
-    skipped: number;
+passed: number;
+failed: number;
+skipped: number;
 };
 /** Implements summarize context preflight for the public runtime surface of this module. */
 export declare function summarizeContextPreflight(runResults: TestRunResult[]): {
-    checked_pm_commands: number;
-    tracker_read_commands: number;
-    mismatches: number;
-    auto_remediated: number;
+checked_pm_commands: number;
+tracker_read_commands: number;
+mismatches: number;
+auto_remediated: number;
 };
 declare function ensureScope(raw: string | undefined): LinkScope;
 declare function parsePmContextMode(raw: string | undefined): LinkedTestPmContextMode;
@@ -214,32 +225,32 @@ declare function resolveLinkedTestRequestedContextMode(linkedTest: LinkedTest, r
 declare function resolveLinkedTestEffectiveContextMode(requestedMode: LinkedTestPmContextMode, isPmTrackerReadCommand: boolean): ResolvedLinkedTestPmContextMode;
 declare function hasLinkedTestAssertions(linkedTest: LinkedTest): boolean;
 declare function buildPmContextMismatchHint(params: {
-    executionContext: NonNullable<TestRunResult["execution_context"]>;
-    runLevelPmContextMode: LinkedTestPmContextMode;
-    linkedOverridePmContextMode: LinkedTestPmContextMode | undefined;
+executionContext: NonNullable<TestRunResult["execution_context"]>;
+runLevelPmContextMode: LinkedTestPmContextMode;
+linkedOverridePmContextMode: LinkedTestPmContextMode | undefined;
 }): string;
 import { extractPmInvocationArgsFromSegment } from "./linked-command-detection.js";
 export { extractReferencedPmItemIdsFromCommand } from "./linked-command-detection.js";
 declare function commandInvokesPmCli(command: string): boolean;
 declare function commandInvokesPmTrackerReadCommand(command: string): boolean;
 declare function resolveDirectRunnerSubcommand(parsed: {
-    subcommand: string;
-    args: string[];
+subcommand: string;
+args: string[];
 } | null): string | undefined;
 declare function firstDirectTestRunnerSubcommand(executable: string, args: string[]): string | undefined;
 declare function segmentInvokesRecursiveTestAll(segment: string): boolean;
 /** Describes the SDK-owned safety policy applied when a linked command is recorded. */
 export interface LinkedTestCommandSafetyClassification {
-    /** Whether intake accepts the command before provenance checks at execution time. */
-    accepted: true;
-    /** Capability-oriented command family, independent of shell wrapping. */
-    command_kind: "direct_runner" | "sandbox_runner" | "other";
-    /** Tracker isolation is injected by the linked-test runtime for every command. */
-    tracker_isolation: "runtime_injected";
-    /** Stored-command provenance and explicit acknowledgment form the execution trust boundary. */
-    trust_boundary: "provenance";
-    /** Human guidance for reproducible execution without presenting string shape as enforcement. */
-    advisory: string;
+/** Whether intake accepts the command before provenance checks at execution time. */
+accepted: true;
+/** Capability-oriented command family, independent of shell wrapping. */
+command_kind: "direct_runner" | "sandbox_runner" | "other";
+/** Tracker isolation is injected by the linked-test runtime for every command. */
+tracker_isolation: "runtime_injected";
+/** Stored-command provenance and explicit acknowledgment form the execution trust boundary. */
+trust_boundary: "provenance";
+/** Human guidance for reproducible execution without presenting string shape as enforcement. */
+advisory: string;
 }
 /** Classify linked-test commands without pretending string shape is a security boundary. */
 export declare function classifyLinkedTestCommandSafety(command: string): LinkedTestCommandSafetyClassification;
@@ -253,7 +264,7 @@ export declare function classifyLinkedTestFailure(result: Pick<LinkedTestExecuti
 /** Implements count failure categories for the public runtime surface of this module. */
 export declare function countFailureCategories(runResults: TestRunResult[]): Record<LinkedTestFailureCategory, number>;
 declare function copyIntoSandboxIfPresent(sourcePath: string, targetPath: string, recursive?: boolean, makeDirectory?: (targetPath: string, options: {
-    recursive: true;
+recursive: true;
 }) => Promise<unknown>): Promise<void>;
 /** Seed settings and extension configuration, auditing schema-only copies against their own initialized history. */
 declare function seedLinkedTestSandbox(sandboxPmPath: string, sandboxGlobalPath: string, sourceRoots: LinkedTestSandboxSourceRoots, auditSettings?: boolean): Promise<void>;
@@ -270,102 +281,102 @@ declare function evaluateLinkedTestAssertions(linkedTest: LinkedTest, stdout: st
 /** Return whether a linked command applies a runner-level test-name filter that must match at least one test. */
 declare function commandUsesTestNameFilter(command: string): boolean;
 interface RunLinkedTestsOptions {
-    progress?: boolean;
-    sourceRoots?: LinkedTestSandboxSourceRoots;
-    envSet?: string[];
-    envClear?: string[];
-    sharedHostSafe?: boolean;
-    pmContext?: string;
-    overrideLinkedPmContext?: boolean;
-    failOnContextMismatch?: boolean;
-    failOnEmptyTestRun?: boolean;
-    requireAssertionsForPm?: boolean;
-    checkContext?: boolean;
-    autoPmContext?: boolean;
-    workspaceContext?: string;
-    overrideLinkedWorkspaceContext?: boolean;
-    pmRoot?: string;
-    allowUntrustedLinkedTests?: boolean;
-    untrustedLinkedTestsPolicyEnabled?: boolean;
+progress?: boolean;
+sourceRoots?: LinkedTestSandboxSourceRoots;
+envSet?: string[];
+envClear?: string[];
+sharedHostSafe?: boolean;
+pmContext?: string;
+overrideLinkedPmContext?: boolean;
+failOnContextMismatch?: boolean;
+failOnEmptyTestRun?: boolean;
+requireAssertionsForPm?: boolean;
+checkContext?: boolean;
+autoPmContext?: boolean;
+workspaceContext?: string;
+overrideLinkedWorkspaceContext?: boolean;
+pmRoot?: string;
+allowUntrustedLinkedTests?: boolean;
+untrustedLinkedTestsPolicyEnabled?: boolean;
 }
 interface LinkedTestSandboxLayout {
-    root: string;
-    schemaProjectPmPath: string;
-    schemaGlobalPmPath: string;
-    trackerProjectPmPath: string;
-    trackerGlobalPmPath: string;
-    workspaceSnapshotRoot: string;
-    workspaceIsolatedRoot: string;
+root: string;
+schemaProjectPmPath: string;
+schemaGlobalPmPath: string;
+trackerProjectPmPath: string;
+trackerGlobalPmPath: string;
+workspaceSnapshotRoot: string;
+workspaceIsolatedRoot: string;
 }
 interface LinkedTestSandboxCounts {
-    sourceProjectItemCount: number;
-    sourceGlobalItemCount: number;
-    schemaProjectItemCount: number;
-    schemaGlobalItemCount: number;
-    trackerProjectItemCount: number;
-    trackerGlobalItemCount: number;
+sourceProjectItemCount: number;
+sourceGlobalItemCount: number;
+schemaProjectItemCount: number;
+schemaGlobalItemCount: number;
+trackerProjectItemCount: number;
+trackerGlobalItemCount: number;
 }
 declare function initializeLinkedTestSandboxes(layout: LinkedTestSandboxLayout, initialize?: (...args: Parameters<typeof runInit>) => Promise<unknown>, includeTrackerData?: boolean): Promise<void>;
 declare function linkedTestsRequireTrackerData(tests: LinkedTest[], runLevelPmContextMode: LinkedTestPmContextMode, options: RunLinkedTestsOptions | undefined): boolean;
 declare function buildLinkedTestExecutionContext(params: {
-    layout: LinkedTestSandboxLayout;
-    counts: LinkedTestSandboxCounts;
-    sourceRoots: LinkedTestSandboxSourceRoots | undefined;
-    isPmCommand: boolean;
-    isPmTrackerReadCommand: boolean;
-    requestedPmContextMode: LinkedTestPmContextMode;
-    effectivePmContextMode: ResolvedLinkedTestPmContextMode;
-    autoPmContextApplied: boolean;
-    requestedWorkspaceContextMode: LinkedTestWorkspaceContextMode;
-    workspaceContextMode: LinkedTestWorkspaceContextMode;
-    sourceWorkspaceRoot: string;
-    trust: LinkedTestTrustDecision;
+layout: LinkedTestSandboxLayout;
+counts: LinkedTestSandboxCounts;
+sourceRoots: LinkedTestSandboxSourceRoots | undefined;
+isPmCommand: boolean;
+isPmTrackerReadCommand: boolean;
+requestedPmContextMode: LinkedTestPmContextMode;
+effectivePmContextMode: ResolvedLinkedTestPmContextMode;
+autoPmContextApplied: boolean;
+requestedWorkspaceContextMode: LinkedTestWorkspaceContextMode;
+workspaceContextMode: LinkedTestWorkspaceContextMode;
+sourceWorkspaceRoot: string;
+trust: LinkedTestTrustDecision;
 }): NonNullable<TestRunResult["execution_context"]>;
 /** Implements run linked tests for the public runtime surface of this module. */
 export declare function runLinkedTests(tests: LinkedTest[], defaultTimeoutSeconds: number | undefined, options?: RunLinkedTestsOptions): Promise<TestRunResult[]>;
 interface ResolvedTestRunOptions {
-    defaultTimeoutSeconds: number | undefined;
-    pmContextMode: LinkedTestPmContextMode;
-    runSelection: LinkedTestRunSelection | undefined;
-    testsToRun: LinkedTest[];
+defaultTimeoutSeconds: number | undefined;
+pmContextMode: LinkedTestPmContextMode;
+runSelection: LinkedTestRunSelection | undefined;
+testsToRun: LinkedTest[];
 }
 declare function resolveTestRunOptions(options: TestCommandOptions, tests: LinkedTest[]): ResolvedTestRunOptions;
 /** Implements run test for the public runtime surface of this module. */
 export declare function runTest(id: string, options: TestCommandOptions, global: GlobalOptions): Promise<TestResult>;
 /** Public contract for test only test command, shared by SDK and presentation-layer consumers. */
 export declare const _testOnlyTestCommand: {
-    buildLinkedTestExecutionContext: typeof buildLinkedTestExecutionContext;
-    buildPmContextMismatchHint: typeof buildPmContextMismatchHint;
-    commandInvokesPmCli: typeof commandInvokesPmCli;
-    commandInvokesPmTrackerReadCommand: typeof commandInvokesPmTrackerReadCommand;
-    commandUsesTestNameFilter: typeof commandUsesTestNameFilter;
-    copyIntoSandboxIfPresent: typeof copyIntoSandboxIfPresent;
-    countLinkedTestItemFiles: typeof countLinkedTestItemFiles;
-    ensureScope: typeof ensureScope;
-    evaluateLinkedTestAssertions: typeof evaluateLinkedTestAssertions;
-    endLinkedTestProgress: typeof endLinkedTestProgress;
-    extractPmInvocationArgsFromSegment: typeof extractPmInvocationArgsFromSegment;
-    firstDirectTestRunnerSubcommand: typeof firstDirectTestRunnerSubcommand;
-    formatLinkedTestExecutionError: typeof formatLinkedTestExecutionError;
-    hasLinkedTestAssertions: typeof hasLinkedTestAssertions;
-    initializeLinkedTestSandboxes: typeof initializeLinkedTestSandboxes;
-    linkedTestsRequireTrackerData: typeof linkedTestsRequireTrackerData;
-    parseAddJsonEntries: typeof parseAddJsonEntries;
-    parseLinkedTestTimeoutSeconds: typeof parseLinkedTestTimeoutSeconds;
-    parsePmContextMode: typeof parsePmContextMode;
-    readJsonPathValue: typeof readJsonPathValue;
-    resolveAuthor: typeof resolveAuthor;
-    resolveDirectRunnerSubcommand: typeof resolveDirectRunnerSubcommand;
-    resolveLinkedTestEffectiveContextMode: typeof resolveLinkedTestEffectiveContextMode;
-    resolveLinkedTestFailureExitCode: typeof resolveLinkedTestFailureExitCode;
-    resolveLinkedTestRequestedContextMode: typeof resolveLinkedTestRequestedContextMode;
-    resolveTestRunOptions: typeof resolveTestRunOptions;
-    resolveTrackedRunId: typeof resolveTrackedRunId;
-    runLinkedTestCommand: typeof runLinkedTestCommand;
-    seedMissingLinkedTestSettingsHistory: typeof seedMissingLinkedTestSettingsHistory;
-    seedLinkedTestSandbox: typeof seedLinkedTestSandbox;
-    seedLinkedTestTrackerData: typeof seedLinkedTestTrackerData;
-    segmentInvokesRecursiveTestAll: typeof segmentInvokesRecursiveTestAll;
-    splitJsonPathSegments: typeof splitJsonPathSegments;
-    summarizeRunResultStatuses: typeof summarizeRunResultStatuses;
+buildLinkedTestExecutionContext: typeof buildLinkedTestExecutionContext;
+buildPmContextMismatchHint: typeof buildPmContextMismatchHint;
+commandInvokesPmCli: typeof commandInvokesPmCli;
+commandInvokesPmTrackerReadCommand: typeof commandInvokesPmTrackerReadCommand;
+commandUsesTestNameFilter: typeof commandUsesTestNameFilter;
+copyIntoSandboxIfPresent: typeof copyIntoSandboxIfPresent;
+countLinkedTestItemFiles: typeof countLinkedTestItemFiles;
+ensureScope: typeof ensureScope;
+evaluateLinkedTestAssertions: typeof evaluateLinkedTestAssertions;
+endLinkedTestProgress: typeof endLinkedTestProgress;
+extractPmInvocationArgsFromSegment: typeof extractPmInvocationArgsFromSegment;
+firstDirectTestRunnerSubcommand: typeof firstDirectTestRunnerSubcommand;
+formatLinkedTestExecutionError: typeof formatLinkedTestExecutionError;
+hasLinkedTestAssertions: typeof hasLinkedTestAssertions;
+initializeLinkedTestSandboxes: typeof initializeLinkedTestSandboxes;
+linkedTestsRequireTrackerData: typeof linkedTestsRequireTrackerData;
+parseAddJsonEntries: typeof parseAddJsonEntries;
+parseLinkedTestTimeoutSeconds: typeof parseLinkedTestTimeoutSeconds;
+parsePmContextMode: typeof parsePmContextMode;
+readJsonPathValue: typeof readJsonPathValue;
+resolveAuthor: typeof resolveAuthor;
+resolveDirectRunnerSubcommand: typeof resolveDirectRunnerSubcommand;
+resolveLinkedTestEffectiveContextMode: typeof resolveLinkedTestEffectiveContextMode;
+resolveLinkedTestFailureExitCode: typeof resolveLinkedTestFailureExitCode;
+resolveLinkedTestRequestedContextMode: typeof resolveLinkedTestRequestedContextMode;
+resolveTestRunOptions: typeof resolveTestRunOptions;
+resolveTrackedRunId: typeof resolveTrackedRunId;
+runLinkedTestCommand: typeof runLinkedTestCommand;
+seedMissingLinkedTestSettingsHistory: typeof seedMissingLinkedTestSettingsHistory;
+seedLinkedTestSandbox: typeof seedLinkedTestSandbox;
+seedLinkedTestTrackerData: typeof seedLinkedTestTrackerData;
+segmentInvokesRecursiveTestAll: typeof segmentInvokesRecursiveTestAll;
+splitJsonPathSegments: typeof splitJsonPathSegments;
+summarizeRunResultStatuses: typeof summarizeRunResultStatuses;
 };