@unbrained/pm-cli 2026.8.11 → 2026.8.13

package/dist/sdk/test/execution.js

@@ -4,13 +4,13 @@
  * Implements the pm test 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]="2c0646bf-44d7-521f-aea1-b0683d88a8fa")}catch(e){}}();
+!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]="76053150-cc55-57e0-80d6-369196284cd0")}catch(e){}}();
 import { spawn } from "node:child_process";
 import { cp, mkdir, mkdtemp, open, readdir, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
-import { pathExists } from "../../core/fs/fs-utils.js";
+import { isFileMissingError, pathExists } from "../../core/fs/fs-utils.js";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
 import { createStdinTokenResolver, parseCsvKv, parseOptionalNumber, } from "../../core/item/parse.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
@@ -507,7 +507,6 @@ function parseAddJsonEntries(raw) {
         return parsed;
     });
 }
-/* c8 ignore stop */
 function parseRemoveEntries(raw) {
     if (!raw)
         return [];
@@ -516,19 +515,48 @@ function parseRemoveEntries(raw) {
         if (!trimmed) {
             throw new PmCliError("--remove requires command or path value", EXIT_CODE.USAGE);
         }
-        if (trimmed.includes("=") ||
-            /^(?:[-*+]\s+)?(?:path|command)\s*[:=]/i.test(trimmed) ||
+        const identityPrefix = /^(command|path)\s*=/i.exec(trimmed);
+        if (identityPrefix) {
+            const value = trimmed.slice(identityPrefix[0].length).trim();
+            if (!value) {
+                throw new PmCliError("--remove requires a non-empty command=<value> or path=<value>", EXIT_CODE.USAGE);
+            }
+            return {
+                kind: identityPrefix[1].toLowerCase(),
+                value,
+            };
+        }
+        if (/^[A-Za-z_][\w-]*=\S+$/u.test(trimmed)) {
+            throw new PmCliError("--remove structured selectors require command=<value> or path=<value>", EXIT_CODE.USAGE);
+        }
+        if (/^(?:[-*+]\s+)?(?:path|command)\s*:/i.test(trimmed) ||
             trimmed.startsWith("```")) {
             const kv = parseCsvKv(trimmed, "--remove");
+            const kind = kv.path !== undefined ? "path" : "command";
             const value = kv.path ?? kv.command;
             if (!value?.trim()) {
                 throw new PmCliError("--remove requires command=<value> and/or path=<value>", EXIT_CODE.USAGE);
             }
-            return value.trim();
+            return { kind, value: value.trim() };
         }
-        return trimmed;
+        return { kind: "either", value: trimmed };
     });
 }
+function parseRemoveIndexes(raw) {
+    if (!raw)
+        return [];
+    return [
+        ...new Set(raw.map((value) => {
+            const parsed = typeof value === "number" ? value : Number.parseInt(value, 10);
+            if (!Number.isInteger(parsed) ||
+                parsed < 1 ||
+                String(parsed) !== String(value).trim()) {
+                throw new PmCliError("--remove-index must be a positive integer", EXIT_CODE.USAGE);
+            }
+            return parsed;
+        })),
+    ];
+}
 function closeLinkedTestStdin(child) {
     // Force EOF on child stdin so non-interactive runs do not wait on input.
     try {
@@ -961,7 +989,7 @@ async function copyIntoSandboxIfPresent(sourcePath, targetPath, recursive = fals
         if (typeof error === "object" &&
             error !== null &&
             "code" in error &&
-            error.code === "ENOENT") {
+            isFileMissingError(error)) {
             return;
         }
         throw error;
@@ -1383,7 +1411,10 @@ function resolveLinkedTestPreflightResult(params) {
 }
 function buildLinkedTestExecutionEnv(params) {
     const effectiveDirectives = resolveEffectiveLinkedTestDirectives(params.runtimeDirectives, params.linkedTest);
-    const executionEnv = { ...process.env };
+    const executionEnv = {
+        ...process.env,
+        SENTRY_ENVIRONMENT: "test",
+    };
     applyEnvDirectiveStage(executionEnv, params.runtimeDirectives);
     applyEnvDirectiveStage(executionEnv, {
         env_set: params.linkedTest.env_set ?? {},
@@ -1538,6 +1569,7 @@ async function readLinkedTestItem(params) {
         tests: loaded.document.metadata.tests ?? [],
         testRuns: loaded.document.metadata.test_runs ?? [],
         changed: false,
+        removed: 0,
     };
 }
 function linkedTestsHaveSameIdentity(left, right) {
@@ -1555,15 +1587,26 @@ function appendMissingLinkedTests(current, additions) {
     }
     return next;
 }
-function removeLinkedTestsBySelector(current, removals) {
-    if (removals.length === 0) {
-        return current;
+function removeLinkedTestsBySelector(current, removals, removeIndexes) {
+    if (removals.length === 0 && removeIndexes.length === 0) {
+        return { tests: current, removed: 0 };
     }
-    return current.filter((entry) => !removals.includes(entry.path ?? "") &&
-        !removals.includes(entry.command ?? ""));
+    const indexSet = new Set(removeIndexes);
+    const tests = current.filter((entry, index) => {
+        if (indexSet.has(index + 1))
+            return false;
+        return !removals.some((selector) => {
+            if (selector.kind === "command")
+                return entry.command === selector.value;
+            if (selector.kind === "path")
+                return entry.path === selector.value;
+            return entry.command === selector.value || entry.path === selector.value;
+        });
+    });
+    return { tests, removed: current.length - tests.length };
 }
-function applyLinkedTestMutations(previous, adds, removes) {
-    return removeLinkedTestsBySelector(appendMissingLinkedTests(previous, adds), removes);
+function applyLinkedTestMutations(previous, adds, removes, removeIndexes) {
+    return removeLinkedTestsBySelector(appendMissingLinkedTests(previous, adds), removes, removeIndexes);
 }
 function hasTestRuntimeDirectiveFlags(options) {
     return ((options.envSet?.length ?? 0) > 0 ||
@@ -1590,25 +1633,43 @@ function assertTestRunFlagUsage(options) {
     }
 }
 async function resolveLinkedTestItem(params) {
-    const { id, options, pmRoot, settings, typeToFolder, adds, removes } = params;
-    if (adds.length === 0 && removes.length === 0) {
+    const { id, options, pmRoot, settings, typeToFolder, adds, removes, removeIndexes, } = params;
+    if (adds.length === 0 && removes.length === 0 && removeIndexes.length === 0) {
         return readLinkedTestItem({ id, pmRoot, settings, typeToFolder });
     }
+    let removed = 0;
     const result = await mutateItem({
         pmRoot,
         settings,
         id,
-        op: "tests_add",
+        op: adds.length > 0 ? "tests_add" : "tests_remove",
         author: resolveAuthor(options.author, settings.author_default),
         message: options.message,
         force: options.force,
         skipNoop: true,
         mutate(document) {
             const previous = document.metadata.tests ?? [];
-            const next = applyLinkedTestMutations(previous, adds, removes);
-            document.metadata.tests = next;
+            const mutation = applyLinkedTestMutations(previous, adds, removes, removeIndexes);
+            removed = mutation.removed;
+            if ((removes.length > 0 || removeIndexes.length > 0) && removed === 0) {
+                throw new PmCliError("No linked tests matched the requested removal selector", EXIT_CODE.NOT_FOUND, {
+                    code: "linked_test_remove_no_match",
+                    unmatched: [
+                        ...removes.map((entry) => `${entry.kind}=${entry.value}`),
+                        ...removeIndexes.map((index) => `index=${index}`),
+                    ],
+                    required: "List linked tests and retry with an exact command/path or a current 1-based --remove-index.",
+                    examples: [
+                        `pm test ${id} --list`,
+                        `pm test ${id} --remove-index 1`,
+                    ],
+                });
+            }
+            document.metadata.tests = mutation.tests;
             return {
-                changedFields: stableValueEquals(previous, next) ? [] : ["tests"],
+                changedFields: stableValueEquals(previous, mutation.tests)
+                    ? []
+                    : ["tests"],
             };
         },
     });
@@ -1617,6 +1678,7 @@ async function resolveLinkedTestItem(params) {
         tests: result.item.tests ?? [],
         testRuns: result.item.test_runs ?? [],
         changed: result.changedFields.length > 0,
+        removed,
     };
 }
 function resolveTestRunOptions(options, tests) {
@@ -1780,6 +1842,7 @@ export async function runTest(id, options, global) {
         ...parseAddJsonEntries(resolvedAddJsons),
     ];
     const removes = parseRemoveEntries(resolvedRemoves);
+    const removeIndexes = parseRemoveIndexes(options.removeIndex);
     const item = await resolveLinkedTestItem({
         id,
         options,
@@ -1788,6 +1851,7 @@ export async function runTest(id, options, global) {
         typeToFolder: typeRegistry.type_to_folder,
         adds,
         removes,
+        removeIndexes,
     });
     const runOptions = resolveTestRunOptions(options, item.tests);
     const runStartedAt = options.run === true ? nowIso() : undefined;
@@ -1835,6 +1899,7 @@ export async function runTest(id, options, global) {
         warnings: warnings.length > 0 ? warnings : undefined,
         changed: item.changed,
         count: item.tests.length,
+        ...(item.removed > 0 ? { removed: item.removed } : {}),
         ...measurementProjection,
     };
 }
@@ -1874,4 +1939,4 @@ export const _testOnlyTestCommand = {
     summarizeRunResultStatuses,
 };
 //# sourceMappingURL=execution.js.map
-//# debugId=2c0646bf-44d7-521f-aea1-b0683d88a8fa
+//# debugId=76053150-cc55-57e0-80d6-369196284cd0

package/dist/sdk/workspace-memory.js

@@ -4,10 +4,10 @@
  * Builds compact, cursor-bound historical rollups for large workspaces.
  */
 
-!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]="2e225010-1b53-59e9-8188-dcbe4a4f7eb7")}catch(e){}}();
+!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]="ad77a79d-54da-55f1-8ac8-935366880d90")}catch(e){}}();
 import path from "node:path";
 import { createHash } from "node:crypto";
-import { writeFileAtomic } from "../core/fs/fs-utils.js";
+import { isFileAbsentError, writeFileAtomic } from "../core/fs/fs-utils.js";
 import { normalizeStatusForRegistry } from "../core/item/status.js";
 import { stableStringify } from "../core/shared/serialization.js";
 import { readItemMetadataDerivedIndexState } from "../core/store/item-metadata-cache.js";
@@ -194,7 +194,7 @@ async function readPersistedWorkspaceMemory(filePath) {
         const missing = typeof error === "object" &&
             error !== null &&
             "code" in error &&
-            error.code === "ENOENT";
+            isFileAbsentError(error);
         return { snapshot: null, invalid: !missing };
     }
 }
@@ -316,4 +316,4 @@ export function searchWorkspaceMemoryReadResult(memory, query, limit = 5) {
     };
 }
 //# sourceMappingURL=workspace-memory.js.map
-//# debugId=2e225010-1b53-59e9-8188-dcbe4a4f7eb7
+//# debugId=ad77a79d-54da-55f1-8ac8-935366880d90

package/dist/sdk/workspace-snapshot.js

@@ -5,11 +5,11 @@
  * state while excluding clone-local caches, locks, and recovery journals.
  */
 
-!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]="470bb466-4619-5c54-a154-186b7ef4a049")}catch(e){}}();
+!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]="36aacc71-c5f5-56f1-85f4-28b2be5b02e2")}catch(e){}}();
 import crypto from "node:crypto";
 import { cp, lstat, mkdir, readFile, readdir, rename, rm, writeFile, } from "node:fs/promises";
 import path from "node:path";
-import { writeFileAtomic } from "../core/fs/fs-utils.js";
+import { isFileMissingError, writeFileAtomic } from "../core/fs/fs-utils.js";
 import { appendWorkspaceAuditEvent } from "../core/history/workspace-history.js";
 import { acquireLock } from "../core/lock/lock.js";
 import { getLockPath } from "../core/store/paths.js";
@@ -205,12 +205,6 @@ function validateSnapshotTarget(target) {
         });
     }
 }
-function isErrno(error, code) {
-    return (typeof error === "object" &&
-        error !== null &&
-        "code" in error &&
-        error.code === code);
-}
 /**
  * Runs a bounded snapshot filesystem stage, converting host environment faults
  * into declared refusals.
@@ -250,7 +244,7 @@ async function readSnapshotJson(file, target) {
         return JSON.parse(await readFile(file, "utf8"));
     }
     catch (error) {
-        if (isErrno(error, "ENOENT")) {
+        if (isFileMissingError(error)) {
             throw workspaceSnapshotNotFound(target);
         }
         throw error;
@@ -261,7 +255,7 @@ async function removeSnapshotEntry(entry, target, recursive) {
         await rm(entry, { recursive });
     }
     catch (error) {
-        if (isErrno(error, "ENOENT")) {
+        if (isFileMissingError(error)) {
             throw workspaceSnapshotNotFound(target);
         }
         throw error;
@@ -335,7 +329,7 @@ export async function createWorkspaceSnapshot(pmRoot, options = {}) {
         deduplicated = objectStat.isDirectory();
     }
     catch (error) {
-        if (!(error instanceof Error && "code" in error && error.code === "ENOENT")) {
+        if (!(error instanceof Error && "code" in error && isFileMissingError(error))) {
             throw error;
         }
     }
@@ -392,7 +386,7 @@ export async function listWorkspaceSnapshots(pmRoot) {
     const objectNames = await readdir(path.join(store, "objects")).catch((error) => {
         if (error instanceof Error &&
             "code" in error &&
-            error.code === "ENOENT") {
+            isFileMissingError(error)) {
             return [];
         }
         throw error;
@@ -400,7 +394,7 @@ export async function listWorkspaceSnapshots(pmRoot) {
     const referenceNames = await readdir(path.join(store, "refs")).catch((error) => {
         if (error instanceof Error &&
             "code" in error &&
-            error.code === "ENOENT") {
+            isFileMissingError(error)) {
             return [];
         }
         throw error;
@@ -609,4 +603,4 @@ export async function deleteWorkspaceSnapshot(pmRoot, target) {
     return { deleted: "object", target };
 }
 //# sourceMappingURL=workspace-snapshot.js.map
-//# debugId=470bb466-4619-5c54-a154-186b7ef4a049
+//# debugId=36aacc71-c5f5-56f1-85f4-28b2be5b02e2

package/dist/sdk/workspace-transaction-gc.js

@@ -13,17 +13,12 @@
  * never breaks correctness.
  */
 
-!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]="a6c0aa24-501a-5e76-a669-91d125634cf1")}catch(e){}}();
+!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]="7df80849-51e1-5efa-b40a-b44088f941a9")}catch(e){}}();
+import { isFileMissingError } from "../core/fs/fs-utils.js";
 import fs from "node:fs/promises";
 import path from "node:path";
 const MILLISECONDS_PER_DAY = 24 * 60 * 60 * 1000;
 const TERMINAL_JOURNAL_STATUSES = new Set(["committed", "compensated"]);
-function isErrno(error, code) {
-    return (typeof error === "object" &&
-        error !== null &&
-        "code" in error &&
-        error.code === code);
-}
 function readJournalStatusAndTimestamp(raw) {
     let parsed;
     try {
@@ -129,7 +124,7 @@ export async function runWorkspaceTransactionGc(pmRoot, options) {
             .sort((left, right) => left.localeCompare(right));
     }
     catch (error) {
-        if (isErrno(error, "ENOENT")) {
+        if (isFileMissingError(error)) {
             return result;
         }
         throw error;
@@ -152,4 +147,4 @@ export async function runWorkspaceTransactionGc(pmRoot, options) {
     return result;
 }
 //# sourceMappingURL=workspace-transaction-gc.js.map
-//# debugId=a6c0aa24-501a-5e76-a669-91d125634cf1
+//# debugId=7df80849-51e1-5efa-b40a-b44088f941a9

package/dist/sdk/workspace-transaction.js

@@ -5,11 +5,11 @@
  * mutation primitives without rewriting immutable item or relationship history.
  */
 
-!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]="d49ec604-c10c-5706-9d87-510845e55e1a")}catch(e){}}();
+!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]="6ed4a26f-2ae2-556a-87db-56844108757f")}catch(e){}}();
 import { mkdir, readFile } from "node:fs/promises";
 import path from "node:path";
 import { acquireLock } from "../core/lock/lock.js";
-import { writeFileAtomic } from "../core/fs/fs-utils.js";
+import { isFileMissingError, writeFileAtomic } from "../core/fs/fs-utils.js";
 import { nowIso } from "../core/shared/time.js";
 /**
  * Deliberate process-boundary interruption used by deterministic crash tests.
@@ -244,7 +244,7 @@ async function loadJournal(pmRoot, transactionId, stepIds) {
         if (error !== null &&
             typeof error === "object" &&
             "code" in error &&
-            error.code === "ENOENT")
+            isFileMissingError(error))
             return undefined;
         throw error;
     }
@@ -361,4 +361,4 @@ export async function commitWorkspaceTransaction(options) {
     }
 }
 //# sourceMappingURL=workspace-transaction.js.map
-//# debugId=d49ec604-c10c-5706-9d87-510845e55e1a
+//# debugId=6ed4a26f-2ae2-556a-87db-56844108757f

package/dist/sdk/workspace.js

@@ -4,7 +4,8 @@
  * Maintains repository-scaffold contracts shared by the public SDK and CLI.
  */
 
-!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]="bbfa5b19-d801-582a-98e8-0c4925dd57c0")}catch(e){}}();
+!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]="89261a49-97e5-5ffc-a81c-2409f0b529cf")}catch(e){}}();
+import { isFileMissingError } from "../core/fs/fs-utils.js";
 import { readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { EXIT_CODE } from "../core/shared/constants.js";
@@ -107,7 +108,7 @@ export async function ensurePmGitignore(workspaceRoot, options = {}) {
         current = await withGitignorePermissionRecovery(() => readFile(gitignorePath, "utf8"));
     }
     catch (error) {
-        if (!(error instanceof Error && "code" in error && error.code === "ENOENT")) {
+        if (!(error instanceof Error && "code" in error && isFileMissingError(error))) {
             throw error;
         }
     }
@@ -125,4 +126,4 @@ export async function ensurePmGitignore(workspaceRoot, options = {}) {
     return { path: gitignorePath, changed: true };
 }
 //# sourceMappingURL=workspace.js.map
-//# debugId=bbfa5b19-d801-582a-98e8-0c4925dd57c0
+//# debugId=89261a49-97e5-5ffc-a81c-2409f0b529cf

package/dist/types.d.ts

@@ -776,6 +776,8 @@ export interface HistoryEntry {
     before_hash: string;
     /** Value that configures or reports after hash for this contract. */
     after_hash: string;
+    /** Version of the item canonicalization used by before_hash and after_hash. Absent on legacy streams. */
+    item_hash_version?: number;
     /** Human-readable explanation suitable for logs and agent-facing output. */
     message?: string;
     /** Structured audit metadata that does not alter replayed item state. */

package/dist/types.js

@@ -5,7 +5,7 @@
  */
 /** Supported values accepted by the builtin item type contract. */
 
-!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]="605cf12e-6106-563a-abc0-38d648d4aa43")}catch(e){}}();
+!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]="8b39bc01-0325-5dc6-8492-585c98608076")}catch(e){}}();
 export const BUILTIN_ITEM_TYPE_VALUES = [
     "Epic",
     "Feature",
@@ -241,4 +241,4 @@ export const CONTEXT_SECTION_VALUES = [
     "tests",
 ];
 //# sourceMappingURL=types.js.map
-//# debugId=605cf12e-6106-563a-abc0-38d648d4aa43
+//# debugId=8b39bc01-0325-5dc6-8492-585c98608076