@unbrained/pm-cli 2026.7.15 → 2026.7.17

package/dist/cli/commands/test.d.ts

@@ -1,244 +1,6 @@
-import type { GlobalOptions } from "../../core/shared/command-types.js";
-import { type LinkedTestPmContextMode } from "./linked-test-parsers.js";
-import { type LinkedTestRunSelection } from "../../core/test/run-selectors.js";
-import type { LinkedTest, LinkScope } from "../../types/index.js";
-type ResolvedLinkedTestPmContextMode = Exclude<LinkedTestPmContextMode, "auto">;
-interface LinkedTestExecutionResult {
-    stdout: string;
-    stderr: string;
-    exitCode: number | null;
-    signal?: NodeJS.Signals | null;
-    timedOut: boolean;
-    maxBufferExceeded: boolean;
-    spawnError?: string;
-}
-interface LinkedTestProgressContext {
-    index: number;
-    total: number;
-    timeoutMs: number;
-    command: string;
-}
-type LinkedTestProgressMode = "auto" | "always" | "off";
-interface LinkedTestSandboxSourceRoots {
-    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[];
-    /** 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;
-    /** 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;
-}
-/** Restricts linked test failure category values accepted by command, SDK, and storage contracts. */
-export type LinkedTestFailureCategory = "infra_collision" | "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;
-    /** 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;
-    };
-    /** 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;
-    /** Value that configures or reports count for this contract. */
-    count: number;
-}
-declare function resolveAuthor(candidate: string | undefined, fallback: string): string;
-declare function resolveTrackedRunId(kind: "test" | "test-all"): string;
-declare function summarizeRunResultStatuses(results: TestRunResult[]): {
-    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;
-};
-declare function ensureScope(raw: string | undefined): LinkScope;
-declare function parsePmContextMode(raw: string | undefined): LinkedTestPmContextMode;
-declare function resolveLinkedTestRequestedContextMode(linkedTest: LinkedTest, runLevelMode: LinkedTestPmContextMode, overrideLinkedPmContext: boolean): LinkedTestPmContextMode;
-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;
-}): string;
-import { extractPmInvocationArgsFromSegment } from "../../sdk/test/linked-command-detection.js";
-export { extractReferencedPmItemIdsFromCommand } from "../../sdk/test/linked-command-detection.js";
-declare function commandInvokesPmCli(command: string): boolean;
-declare function commandInvokesPmTrackerReadCommand(command: string): boolean;
-declare function resolveDirectRunnerSubcommand(parsed: {
-    subcommand: string;
-    args: string[];
-} | null): string | undefined;
-declare function firstDirectTestRunnerSubcommand(executable: string, args: string[]): string | undefined;
-declare function parseAddJsonEntries(raw: string[] | undefined): LinkedTest[];
-interface LinkedTestOutputBufferState {
-    stdout: string;
-    stderr: string;
-    stdoutBytes: number;
-    stderrBytes: number;
-    maxBufferExceeded: boolean;
-}
-declare function appendLinkedTestOutputChunk(state: LinkedTestOutputBufferState, chunk: Buffer | string, target: "stdout" | "stderr"): boolean;
-declare function runLinkedTestCommand(command: string, timeoutMs: number, env: NodeJS.ProcessEnv, progressContext: LinkedTestProgressContext, progressMode: LinkedTestProgressMode): Promise<LinkedTestExecutionResult>;
-/** Implements classify linked test failure for the public runtime surface of this module. */
-export declare function classifyLinkedTestFailure(result: Pick<LinkedTestExecutionResult, "stdout" | "stderr" | "spawnError" | "signal" | "timedOut" | "maxBufferExceeded">): LinkedTestFailureCategory;
-/** 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): Promise<void>;
-declare function seedLinkedTestSandbox(sandboxPmPath: string, sandboxGlobalPath: string, sourceRoots: LinkedTestSandboxSourceRoots): Promise<void>;
-declare function seedLinkedTestTrackerData(sourceRoot: string, sandboxRoot: string): Promise<void>;
-declare function countLinkedTestItemFiles(pmRoot: string): Promise<number>;
-/** Implements resolve linked test failure exit code for the public runtime surface of this module. */
-export declare function resolveLinkedTestFailureExitCode(execution: Pick<LinkedTestExecutionResult, "exitCode" | "timedOut" | "maxBufferExceeded">): number;
-declare function splitJsonPathSegments(fieldPath: string): Array<string | number>;
-declare function readJsonPathValue(root: unknown, fieldPath: string): {
-    found: boolean;
-    value: unknown;
-};
-declare function evaluateLinkedTestAssertions(linkedTest: LinkedTest, stdout: string, stderr: string): string[];
-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;
-}
-/** 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[]>;
-/** 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: {
-    buildPmContextMismatchHint: typeof buildPmContextMismatchHint;
-    commandInvokesPmCli: typeof commandInvokesPmCli;
-    commandInvokesPmTrackerReadCommand: typeof commandInvokesPmTrackerReadCommand;
-    copyIntoSandboxIfPresent: typeof copyIntoSandboxIfPresent;
-    countLinkedTestItemFiles: typeof countLinkedTestItemFiles;
-    ensureScope: typeof ensureScope;
-    evaluateLinkedTestAssertions: typeof evaluateLinkedTestAssertions;
-    extractPmInvocationArgsFromSegment: typeof extractPmInvocationArgsFromSegment;
-    firstDirectTestRunnerSubcommand: typeof firstDirectTestRunnerSubcommand;
-    hasLinkedTestAssertions: typeof hasLinkedTestAssertions;
-    parseAddJsonEntries: typeof parseAddJsonEntries;
-    parsePmContextMode: typeof parsePmContextMode;
-    readJsonPathValue: typeof readJsonPathValue;
-    resolveAuthor: typeof resolveAuthor;
-    resolveDirectRunnerSubcommand: typeof resolveDirectRunnerSubcommand;
-    resolveLinkedTestEffectiveContextMode: typeof resolveLinkedTestEffectiveContextMode;
-    resolveLinkedTestFailureExitCode: typeof resolveLinkedTestFailureExitCode;
-    resolveLinkedTestRequestedContextMode: typeof resolveLinkedTestRequestedContextMode;
-    resolveTrackedRunId: typeof resolveTrackedRunId;
-    runLinkedTestCommand: typeof runLinkedTestCommand;
-    appendLinkedTestOutputChunk: typeof appendLinkedTestOutputChunk;
-    seedLinkedTestSandbox: typeof seedLinkedTestSandbox;
-    seedLinkedTestTrackerData: typeof seedLinkedTestTrackerData;
-    splitJsonPathSegments: typeof splitJsonPathSegments;
-    summarizeRunResultStatuses: typeof summarizeRunResultStatuses;
-};
+/**
+ * @module cli/commands/test
+ *
+ * Compatibility export for SDK-owned linked-test execution primitives.
+ */
+export * from "../../sdk/test/execution.js";