@unbrained/pm-cli 2026.7.15 → 2026.7.17

package/dist/sdk/test/entry.js

@@ -0,0 +1,74 @@
+/**
+ * @module sdk/test/entry
+ *
+ * Implements the pm linked test entry command surface and its agent-facing runtime behavior.
+ */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8d0ef3ea-da0f-5a01-9867-e870faaec0c7")}catch(e){}}();
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+// Keys accepted inside a structured linked-test entry. `cmd` is an alias for
+// `command`; everything else maps 1:1 to a LinkedTest field.
+/** Public contract for structured linked test keys, shared by SDK and presentation-layer consumers. */
+export const STRUCTURED_LINKED_TEST_KEYS = [
+    "command",
+    "cmd",
+    "path",
+    "scope",
+    "timeout",
+    "timeout_seconds",
+    "pm_context_mode",
+    "env_set",
+    "env_clear",
+    "shared_host_safe",
+    "assert_stdout_contains",
+    "assert_stdout_regex",
+    "assert_stderr_contains",
+    "assert_stderr_regex",
+    "assert_stdout_min_lines",
+    "assert_json_field_equals",
+    "assert_json_field_gte",
+    "note",
+];
+const STRUCTURED_LINKED_TEST_KEY_SET = new Set(STRUCTURED_LINKED_TEST_KEYS);
+const STRUCTURED_LINKED_TEST_KEY_PATTERN = STRUCTURED_LINKED_TEST_KEYS.map((key) => key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
+const STRUCTURED_LINKED_TEST_ENTRY_PATTERN = new RegExp(`^(?:[-*+]\\s+)?(?:${STRUCTURED_LINKED_TEST_KEY_PATTERN})\\s*[:=]`, "i");
+/** Implements looks like structured linked test entry for the public runtime surface of this module. */
+export function looksLikeStructuredLinkedTestEntry(raw) {
+    if (raw.startsWith("```") || raw.includes("\n")) {
+        return true;
+    }
+    return STRUCTURED_LINKED_TEST_ENTRY_PATTERN.test(raw);
+}
+/** Implements normalize structured linked test entry for the public runtime surface of this module. */
+export function normalizeStructuredLinkedTestEntry(kv, optionName) {
+    const normalizedKv = {};
+    const unknownKeys = [];
+    for (const [key, value] of Object.entries(kv)) {
+        const normalizedKey = key.toLowerCase();
+        if (!STRUCTURED_LINKED_TEST_KEY_SET.has(normalizedKey)) {
+            unknownKeys.push(key);
+            continue;
+        }
+        if (Object.hasOwn(normalizedKv, normalizedKey)) {
+            throw new PmCliError(`${optionName} provides key "${key}" more than once after case normalization`, EXIT_CODE.USAGE);
+        }
+        normalizedKv[normalizedKey] = value;
+    }
+    if (unknownKeys.length > 0) {
+        throw new PmCliError(`${optionName} does not recognize key${unknownKeys.length > 1 ? "s" : ""} ${unknownKeys
+            .map((key) => `"${key}"`)
+            .join(", ")}. Allowed keys: ${STRUCTURED_LINKED_TEST_KEYS.join(", ")}.`, EXIT_CODE.USAGE);
+    }
+    if (normalizedKv.cmd !== undefined) {
+        if (normalizedKv.command !== undefined &&
+            normalizedKv.command.trim() !== normalizedKv.cmd.trim()) {
+            throw new PmCliError(`${optionName} command and cmd must match when both are provided`, EXIT_CODE.USAGE);
+        }
+        const { cmd, ...rest } = normalizedKv;
+        return { ...rest, command: rest.command ?? cmd };
+    }
+    return normalizedKv;
+}
+//# sourceMappingURL=entry.js.map
+//# debugId=8d0ef3ea-da0f-5a01-9867-e870faaec0c7

package/dist/sdk/test/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sources":["sdk/test/entry.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/test/entry\n *\n * Implements the pm linked test entry command surface and its agent-facing runtime behavior.\n */\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\n\n// Keys accepted inside a structured linked-test entry. `cmd` is an alias for\n// `command`; everything else maps 1:1 to a LinkedTest field.\n/** Public contract for structured linked test keys, shared by SDK and presentation-layer consumers. */\nexport const STRUCTURED_LINKED_TEST_KEYS = [\n  \"command\",\n  \"cmd\",\n  \"path\",\n  \"scope\",\n  \"timeout\",\n  \"timeout_seconds\",\n  \"pm_context_mode\",\n  \"env_set\",\n  \"env_clear\",\n  \"shared_host_safe\",\n  \"assert_stdout_contains\",\n  \"assert_stdout_regex\",\n  \"assert_stderr_contains\",\n  \"assert_stderr_regex\",\n  \"assert_stdout_min_lines\",\n  \"assert_json_field_equals\",\n  \"assert_json_field_gte\",\n  \"note\",\n] as const;\n\nconst STRUCTURED_LINKED_TEST_KEY_SET = new Set<string>(\n  STRUCTURED_LINKED_TEST_KEYS,\n);\nconst STRUCTURED_LINKED_TEST_KEY_PATTERN = STRUCTURED_LINKED_TEST_KEYS.map(\n  (key) => key.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\"),\n).join(\"|\");\nconst STRUCTURED_LINKED_TEST_ENTRY_PATTERN = new RegExp(\n  `^(?:[-*+]\\\\s+)?(?:${STRUCTURED_LINKED_TEST_KEY_PATTERN})\\\\s*[:=]`,\n  \"i\",\n);\n\n/** Implements looks like structured linked test entry for the public runtime surface of this module. */\nexport function looksLikeStructuredLinkedTestEntry(raw: string): boolean {\n  if (raw.startsWith(\"```\") || raw.includes(\"\\n\")) {\n    return true;\n  }\n  return STRUCTURED_LINKED_TEST_ENTRY_PATTERN.test(raw);\n}\n\n/** Implements normalize structured linked test entry for the public runtime surface of this module. */\nexport function normalizeStructuredLinkedTestEntry(\n  kv: Record<string, string>,\n  optionName: \"--add\" | \"--test\",\n): Record<string, string> {\n  const normalizedKv: Record<string, string> = {};\n  const unknownKeys: string[] = [];\n  for (const [key, value] of Object.entries(kv)) {\n    const normalizedKey = key.toLowerCase();\n    if (!STRUCTURED_LINKED_TEST_KEY_SET.has(normalizedKey)) {\n      unknownKeys.push(key);\n      continue;\n    }\n    if (Object.hasOwn(normalizedKv, normalizedKey)) {\n      throw new PmCliError(\n        `${optionName} provides key \"${key}\" more than once after case normalization`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    normalizedKv[normalizedKey] = value;\n  }\n  if (unknownKeys.length > 0) {\n    throw new PmCliError(\n      `${optionName} does not recognize key${unknownKeys.length > 1 ? \"s\" : \"\"} ${unknownKeys\n        .map((key) => `\"${key}\"`)\n        .join(\", \")}. Allowed keys: ${STRUCTURED_LINKED_TEST_KEYS.join(\", \")}.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (normalizedKv.cmd !== undefined) {\n    if (\n      normalizedKv.command !== undefined &&\n      normalizedKv.command.trim() !== normalizedKv.cmd.trim()\n    ) {\n      throw new PmCliError(\n        `${optionName} command and cmd must match when both are provided`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const { cmd, ...rest } = normalizedKv;\n    return { ...rest, command: rest.command ?? cmd };\n  }\n  return normalizedKv;\n}\n"],"names":[],"mappings":"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","debugId":"8d0ef3ea-da0f-5a01-9867-e870faaec0c7"}

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

@@ -0,0 +1,282 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+import { type LinkedTestPmContextMode } from "./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 "./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[];
+} | null): string | undefined;
+declare function firstDirectTestRunnerSubcommand(executable: string, args: string[]): string | undefined;
+declare function segmentInvokesRecursiveTestAll(segment: string): boolean;
+declare function parseLinkedTestTimeoutSeconds(timeoutSecondsRaw: string | undefined, timeoutAliasRaw: string | undefined): number | 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;
+}
+interface LinkedTestSandboxLayout {
+    root: string;
+    schemaProjectPmPath: string;
+    schemaGlobalPmPath: string;
+    trackerProjectPmPath: string;
+    trackerGlobalPmPath: string;
+}
+interface LinkedTestSandboxCounts {
+    sourceProjectItemCount: number;
+    sourceGlobalItemCount: number;
+    schemaProjectItemCount: number;
+    schemaGlobalItemCount: number;
+    trackerProjectItemCount: number;
+    trackerGlobalItemCount: number;
+}
+declare function buildLinkedTestExecutionContext(params: {
+    layout: LinkedTestSandboxLayout;
+    counts: LinkedTestSandboxCounts;
+    sourceRoots: LinkedTestSandboxSourceRoots | undefined;
+    isPmCommand: boolean;
+    isPmTrackerReadCommand: boolean;
+    requestedPmContextMode: LinkedTestPmContextMode;
+    effectivePmContextMode: ResolvedLinkedTestPmContextMode;
+    autoPmContextApplied: boolean;
+}): 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[];
+}
+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;
+    copyIntoSandboxIfPresent: typeof copyIntoSandboxIfPresent;
+    countLinkedTestItemFiles: typeof countLinkedTestItemFiles;
+    ensureScope: typeof ensureScope;
+    evaluateLinkedTestAssertions: typeof evaluateLinkedTestAssertions;
+    extractPmInvocationArgsFromSegment: typeof extractPmInvocationArgsFromSegment;
+    firstDirectTestRunnerSubcommand: typeof firstDirectTestRunnerSubcommand;
+    hasLinkedTestAssertions: typeof hasLinkedTestAssertions;
+    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;
+    appendLinkedTestOutputChunk: typeof appendLinkedTestOutputChunk;
+    seedLinkedTestSandbox: typeof seedLinkedTestSandbox;
+    seedLinkedTestTrackerData: typeof seedLinkedTestTrackerData;
+    segmentInvokesRecursiveTestAll: typeof segmentInvokesRecursiveTestAll;
+    splitJsonPathSegments: typeof splitJsonPathSegments;
+    summarizeRunResultStatuses: typeof summarizeRunResultStatuses;
+};