@unbrained/pm-cli 2026.8.22 → 2026.8.24

package/dist/sdk/index.js

@@ -4,7 +4,7 @@
  * Defines public SDK APIs and package-author helpers for Index.
  */
 
-!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]="483445af-d102-5b49-9b45-8452f8e48ea8")}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]="805c081a-a781-50c3-8919-81492208913b")}catch(e){}}();
 export { PM_COMMAND_CAPABILITY_CONTRACTS, PM_COMMAND_VISIBILITY_CONTRACTS, PM_MCP_PROMPT_CONTRACTS, PM_MCP_RESOURCE_CONTRACTS, PM_MCP_TOOL_COMMAND_CONTRACTS, listPmCommandsForFamily, listPmCommandsForTier, listPmMcpToolsForProfile, renderPmCommandVisibilityMarkdown, resolvePmCommandCapabilityFamily, resolvePmCommandVisibilityTier, } from "./agent-capability-contracts.js";
 export * from "./cli-contracts/grammar-contracts.js";
 export * from "./agent-session-context.js";
@@ -14,6 +14,7 @@ export { BUILTIN_CORPUS_SHAPES, PM_CORPUS_SHAPE_SCHEMA, buildCorpusShapeItemPlan
 export * from "./core-governance.js";
 export { createPmCliProgram } from "./cli-program.js";
 export { runSearchRefreshWorkerEntrypoint } from "./search-refresh-worker.js";
+export { PM_REPRODUCIBLE_PROCESS_ENV, createReproducibleProcessRunner, resolveReproducibleProcessEnvironment, runWithReproducibleProcessEnvironment, } from "./reproducibility/process.js";
 export { PM_WORKSPACE_RECIPE_SCHEMA, defineWorkspaceRecipe, executeWorkspaceRecipe, runWithWorkspaceRecipe, } from "./workspace-recipe.js";
 export { SNAPSHOT_SCHEMA, WORKSPACE_SNAPSHOT_ACTIONS, createWorkspaceSnapshot, deleteWorkspaceSnapshot, inspectWorkspaceSnapshot, listWorkspaceSnapshots, planWorkspaceSnapshotRestore, restoreWorkspaceSnapshot, restoreWorkspaceSnapshotWithRecovery, } from "./workspace-snapshot.js";
 export { flushTelemetryQueue } from "./telemetry-flush.js";
@@ -48,6 +49,7 @@ export { discoverNearbyPmRoot } from "./tracker-root-discovery.js";
 export { assertInitializedTracker, assertReadableTrackerRoot, buildTrackerInitializationRecovery, } from "./environment/tracker-preflight.js";
 export { _testOnly as _testOnlyTemplates, } from "./templates.js";
 export { runConfig, _testOnlyConfigCommand, } from "./config.js";
+export * from "./agent/identity-config.js";
 export { INIT_AGENT_GUIDANCE_MODE_VALUES, runInitAgentGuidance, _testOnly as _testOnlyInitAgentGuidance, } from "./init-agent-guidance.js";
 export { runInit, summarizeInitResult, _testOnly as _testOnlyInit, } from "./init.js";
 export { PROFILE_SUBCOMMANDS, formatProfileApplyHuman, formatProfileLintHuman, formatProfileListHuman, formatProfileShowHuman, runProfileApply, runProfileLint, runProfileList, runProfileShow, } from "./profile.js";
@@ -119,8 +121,11 @@ export * from "./error-runtime.js";
 export * from "./error-code-catalog.js";
 export * from "./generated-error-code-catalog.js";
 export * from "./agent/refusal-reachability.js";
+export * from "./agent/refusal-closure-census.js";
 export * from "./agent/refusal-closure.js";
 export * from "./agent/closed-domain-contracts.js";
+export * from "./agent/refusal-corpus-contracts.js";
+export { MERGE_SUBCOMMAND_VALUES } from "./cli-contracts.js";
 export * from "./agent/tracker-preflight-contracts.js";
 export * from "./agent/subcommand-recovery.js";
 export * from "./flag-invocation-contracts.js";
@@ -150,7 +155,8 @@ export { runTelemetry, TELEMETRY_SUBCOMMANDS, } from "./telemetry.js";
 export { classifyLinkedTestFailure, countFailureCategories, extractReferencedPmItemIdsFromCommand, resolveLinkedTestFailureExitCode, runLinkedTests, runTest, summarizeContextPreflight, } from "./test/execution.js";
 export { TEST_RUN_MEASUREMENT_LIMIT, diffTestRunMeasurements, parseTestRunMeasurements, queryTestRunMeasurementsBelow, } from "./test/measurements.js";
 export { runTestAll, } from "./test/batch.js";
-export { LINKED_TEST_ENV_NAME_PATTERN, LINKED_TEST_PM_CONTEXT_MODE_VALUES, LINKED_TEST_PROTECTED_ENV_KEYS, parseLinkedTestAssertionEqualsMap, parseLinkedTestAssertionGteMap, parseLinkedTestBoolean, parseLinkedTestContextMode, parseLinkedTestEnvClear, parseLinkedTestEnvSet, parseLinkedTestJsonEntries, parseLinkedTestMinLines, parseLinkedTestRegexList, parseLinkedTestStringList, } from "./test/parsers.js";
+export { LINKED_TEST_ENV_NAME_PATTERN, LINKED_TEST_PM_CONTEXT_MODE_VALUES, LINKED_TEST_WORKSPACE_CONTEXT_MODE_VALUES, LINKED_TEST_PROTECTED_ENV_KEYS, parseLinkedTestAssertionEqualsMap, parseLinkedTestAssertionGteMap, parseLinkedTestBoolean, parseLinkedTestContextMode, parseLinkedTestEnvClear, parseLinkedTestEnvSet, parseLinkedTestJsonEntries, parseLinkedTestMinLines, parseLinkedTestRegexList, parseLinkedTestStringList, parseLinkedTestWorkspaceContextMode, } from "./test/parsers.js";
+export { acknowledgeLinkedTests, attachLinkedTestMutationProvenance, attachLinkedTestProvenance, linkedTestTrustFingerprint, resolveLinkedTestSourceRef, resolveLinkedTestSourceWorkspaceRoot, resolveLinkedTestTrust, resolveLinkedTestTrustBatch, } from "./test/trust.js";
 export { runStartBackgroundRun, runTestRunsWorker, } from "./test/runs.js";
 export { BUILTIN_PROFILES, listProfiles, normalizeProfileName, PROFILE_NAMES, resolveProfile, } from "../core/profile/profile-presets.js";
 export { planProfileApplication, } from "../core/profile/profile-plan.js";
@@ -161,4 +167,4 @@ export * from "./governance.js";
 export * from "./query.js";
 export * from "./testing.js";
 //# sourceMappingURL=index.js.map
-//# debugId=483445af-d102-5b49-9b45-8452f8e48ea8
+//# debugId=805c081a-a781-50c3-8919-81492208913b

package/dist/sdk/item-transaction.js

@@ -6,15 +6,22 @@
  * with correct-by-construction inspection and compensation wiring.
  */
 
-!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]="ed638747-7a72-5332-87fc-c82088457b91")}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]="ea10685a-3187-533c-9699-73c23d377705")}catch(e){}}();
 import crypto from "node:crypto";
 import path from "node:path";
+import { transferMutationStdinTokenPolicy, } from "../core/item/parse.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { stableStringify } from "../core/shared/serialization.js";
 import { readHistoryEntries } from "./history-read.js";
 import { close, create, deleteItem, get, release, restore, update, } from "./runtime.js";
 import { commitWorkspaceTransaction, } from "./workspace-transaction.js";
+function mergeTransactionMutationOptions(source, additions) {
+    const merged = { ...source, ...additions };
+    return source === undefined
+        ? merged
+        : transferMutationStdinTokenPolicy(source, merged);
+}
 /** Read one item's transaction-relevant fields, mapping not-found to undefined. */
 async function readItemSnapshot(pmRoot, id) {
     try {
@@ -112,7 +119,10 @@ function buildCreateStep(config, mutation, stepId) {
             return { state: "applied", result: { id: snapshot.id, op: "create" } };
         },
         async apply() {
-            const created = await create({ ...mutation.options, author: config.author, id: mutation.id }, { pmRoot: config.pmRoot });
+            const created = await create(mergeTransactionMutationOptions(mutation.options, {
+                author: config.author,
+                id: mutation.id,
+            }), { pmRoot: config.pmRoot });
             const createdItem = created.item;
             return { id: String(createdItem.id), op: "create" };
         },
@@ -155,11 +165,10 @@ function buildUpdateStep(config, mutation, stepId) {
             return prepareRestoreCompensation(config.pmRoot, mutation);
         },
         async apply() {
-            const updated = await update(mutation.id, {
-                ...mutation.options,
+            const updated = await update(mutation.id, mergeTransactionMutationOptions(mutation.options, {
                 author: config.author,
                 message: bulkHistoryMarker(config.transactionId, stepId, "apply"),
-            }, { pmRoot: config.pmRoot });
+            }), { pmRoot: config.pmRoot });
             const updatedItem = updated.item;
             return { id: String(updatedItem.id), op: "update" };
         },
@@ -191,11 +200,10 @@ function buildCloseStep(config, mutation, stepId) {
             return prepareRestoreCompensation(config.pmRoot, mutation);
         },
         async apply() {
-            const closed = await close(mutation.id, mutation.reason, {
-                ...mutation.options,
+            const closed = await close(mutation.id, mutation.reason, mergeTransactionMutationOptions(mutation.options, {
                 author: config.author,
                 message: bulkHistoryMarker(config.transactionId, stepId, "apply"),
-            }, { pmRoot: config.pmRoot });
+            }), { pmRoot: config.pmRoot });
             const closedItem = closed.item;
             return { id: String(closedItem.id), op: "close" };
         },
@@ -226,11 +234,10 @@ function buildReleaseStep(config, mutation, stepId) {
             return prepareRestoreCompensation(config.pmRoot, mutation);
         },
         async apply() {
-            const released = await release(mutation.id, {
-                ...mutation.options,
+            const released = await release(mutation.id, mergeTransactionMutationOptions(mutation.options, {
                 author: config.author,
                 message: bulkHistoryMarker(config.transactionId, stepId, "apply"),
-            }, { pmRoot: config.pmRoot });
+            }), { pmRoot: config.pmRoot });
             const releasedItem = released.item;
             return { id: String(releasedItem.id), op: "release" };
         },
@@ -387,4 +394,4 @@ export const _testOnlyItemTransaction = {
     readItemSnapshot,
 };
 //# sourceMappingURL=item-transaction.js.map
-//# debugId=ed638747-7a72-5332-87fc-c82088457b91
+//# debugId=ea10685a-3187-533c-9699-73c23d377705

package/dist/sdk/lifecycle/append.js

@@ -4,9 +4,9 @@
  * Implements the pm append 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]="73184370-6517-533e-90db-536893402616")}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]="b4b1f63b-12f9-574c-8e92-a5cc9c6178c1")}catch(e){}}();
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { EXIT_CODE, PmCliError, resolveAuthor, toItemRecord, createStdinTokenResolver, mutateItem, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
+import { EXIT_CODE, PmCliError, resolveAuthor, toItemRecord, createStdinTokenResolver, shouldResolveMutationStdinTokenField, mutateItem, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
 /** Implements run append for the public runtime surface of this module. */
 export async function runAppend(id, options, global) {
     if (options.body === undefined) {
@@ -18,7 +18,7 @@ export async function runAppend(id, options, global) {
     const settings = await readSettings(pmRoot);
     const author = resolveAuthor(options.author, settings.author_default);
     // options.body is guaranteed defined by the guard above, so resolveValue returns a defined string.
-    const bodyInput = await stdinResolver.resolveValue(options.body, "--body");
+    const bodyInput = await stdinResolver.resolveValue(options.body, "--body", shouldResolveMutationStdinTokenField(options, "body"));
     const appended = bodyInput.trim();
     if (appended.length === 0) {
         throw new PmCliError("--body text cannot be empty; append requires non-blank content and empty appends would only rewrite updated_at.", EXIT_CODE.USAGE, {
@@ -51,4 +51,4 @@ export async function runAppend(id, options, global) {
     };
 }
 //# sourceMappingURL=append.js.map
-//# debugId=73184370-6517-533e-90db-536893402616
+//# debugId=b4b1f63b-12f9-574c-8e92-a5cc9c6178c1

package/dist/sdk/lifecycle/close-many.js

@@ -4,7 +4,7 @@
  * Implements the pm close many 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]="a7113374-b169-5f92-9c20-075a47520440")}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]="a97a3cf0-beef-5967-8f5b-2372a6c9f2f7")}catch(e){}}();
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
 import { createCheckpointId, loadMutationCheckpoint, restoreCheckpointItems, writeMutationCheckpoint, getActiveExtensionRegistrations, isTerminalStatus, resolveItemTypeRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, PmCliError, toErrorMessage, resolveAuthor, nowIso, listAllItemMetadataLight, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
 import { runClose } from "./close.js";
@@ -280,7 +280,14 @@ async function buildCloseManyPlanContext(params) {
             .map((entry) => entry.trim())
             .filter((entry) => entry.length > 0)),
     ];
-    const matchedIds = new Set(matched.map((item) => item.id));
+    const existenceItems = requestedIds.length === 0
+        ? []
+        : (await runList(undefined, {
+            ids: requestedIds.join(","),
+            noTruncate: true,
+            full: true,
+        }, params.global)).items;
+    const existingIds = new Set(existenceItems.map((item) => item.id));
     const closePlannedIds = resolveCloseManyPlannedIds(matched, statusRegistry, force);
     return {
         pmRoot: params.pmRoot,
@@ -291,7 +298,9 @@ async function buildCloseManyPlanContext(params) {
         force,
         listed,
         matched,
-        unmatchedIds: requestedIds.filter((id) => !matchedIds.has(id)),
+        unmatchedIds: requestedIds.length === 0
+            ? undefined
+            : requestedIds.filter((id) => !existingIds.has(id)),
         planRows: planCloseManyRows(matched, childrenByParent, closePlannedIds, statusRegistry, force),
     };
 }
@@ -309,7 +318,7 @@ function buildCloseManyDryRunResult(context) {
             : {}),
         item_plans: context.planRows,
         ids: [],
-        ...(context.unmatchedIds.length > 0
+        ...(context.unmatchedIds !== undefined
             ? {
                 unmatched_ids: context.unmatchedIds,
                 unmatched_count: context.unmatchedIds.length,
@@ -392,7 +401,7 @@ export async function runCloseMany(options, global) {
             applied: closedCount,
             skipped: skippedCount,
             failed: failedCount,
-            unmatched: context.unmatchedIds.length,
+            unmatched: context.unmatchedIds?.length ?? 0,
         }),
         mode: "apply",
         matched_count: context.matched.length,
@@ -408,7 +417,7 @@ export async function runCloseMany(options, global) {
         failed_count: failedCount,
         rows,
         ids: closedIds,
-        ...(context.unmatchedIds.length > 0
+        ...(context.unmatchedIds !== undefined
             ? {
                 unmatched_ids: context.unmatchedIds,
                 unmatched_count: context.unmatchedIds.length,
@@ -427,4 +436,4 @@ export const _testOnly = {
     resolveReason,
 };
 //# sourceMappingURL=close-many.js.map
-//# debugId=a7113374-b169-5f92-9c20-075a47520440
+//# debugId=a97a3cf0-beef-5967-8f5b-2372a6c9f2f7

package/dist/sdk/lifecycle/create.js

@@ -4,9 +4,10 @@
  * Implements the pm create 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]="4dff80ab-acfc-5f81-a546-3f19629d97be")}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]="02c41ea1-8d4e-5239-b95a-a07210b63d7f")}catch(e){}}();
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { removeFileIfExists, writeFileAtomic, appendHistoryEntry, createHistoryEntry, generateItemId, normalizeItemId, canonicalDocument, normalizeItemMetadata, serializeItemDocument, assertParentReferenceIsNotSelf, isPlaceholderReferenceToken, normalizeParentReferenceValue, validateMissingParentReference, validateSprintOrReleaseValue, assertNoUnknownCsvKeys, createStdinTokenResolver, looksLikeGenericKeyValueEntry, mergeAdditiveTags, parseCsvKv, parseOptionalNonNegativeInteger, parseOptionalNumber, parseTags, resolvePriority, getFocusedItem, normalizeStatusInput, isTerminalStatus, canonicalizeCommandOptionKey, commandOptionFlagLabel, resolveItemTypeRegistry, resolveCommandOptionPolicyState, resolveTypeDefinition, resolveTypeName, validateTypeOptions, acquireLock, printError, buildInvalidTypeError, resolveTypeSynonym, collectRuntimeCreateFieldValues, resolveItemTypesFilePath, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, ITEM_METADATA_KEY_ORDER, PmCliError, nowIso, resolveIsoOrRelative, getActiveExtensionRegistrations, projectAfterCommandItemSnapshot, recordAfterCommandAffectedItem, runActiveCommandHandler, runActiveBeforeMutationHooks, runActiveOnWriteHooks, collectRegisteredItemFieldNames, applyRegisteredItemFieldDefaultsAndValidation, parseRegisteredItemFieldAssignments, listAllItemMetadataLight, locateItem, createMutationGuardSdk, getHistoryPath, getItemPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
+import { resolveMutationStdinTokenFields } from "../../core/item/parse.js";
+import { removeFileIfExists, writeFileAtomic, appendHistoryEntry, createHistoryEntry, generateItemId, normalizeItemId, canonicalDocument, normalizeItemMetadata, serializeItemDocument, assertParentReferenceIsNotSelf, isPlaceholderReferenceToken, normalizeParentReferenceValue, validateMissingParentReference, validateSprintOrReleaseValue, assertNoUnknownCsvKeys, looksLikeGenericKeyValueEntry, mergeAdditiveTags, parseCsvKv, parseOptionalNonNegativeInteger, parseOptionalNumber, parseTags, shouldResolveMutationStdinTokens, transferMutationStdinTokenPolicy, resolvePriority, getFocusedItem, normalizeStatusInput, isTerminalStatus, canonicalizeCommandOptionKey, commandOptionFlagLabel, resolveItemTypeRegistry, resolveCommandOptionPolicyState, resolveTypeDefinition, resolveTypeName, validateTypeOptions, acquireLock, printError, buildInvalidTypeError, resolveTypeSynonym, collectRuntimeCreateFieldValues, resolveItemTypesFilePath, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, ITEM_METADATA_KEY_ORDER, PmCliError, nowIso, resolveIsoOrRelative, getActiveExtensionRegistrations, projectAfterCommandItemSnapshot, recordAfterCommandAffectedItem, runActiveCommandHandler, runActiveBeforeMutationHooks, runActiveOnWriteHooks, collectRegisteredItemFieldNames, applyRegisteredItemFieldDefaultsAndValidation, parseRegisteredItemFieldAssignments, listAllItemMetadataLight, locateItem, createMutationGuardSdk, getHistoryPath, getItemPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
 import { requireTerminalReasonWithRecovery } from "../lifecycle-policy.js";
 import { evaluateSimilarityGovernance, similarityAdvisoryWarnings, } from "../similarity.js";
 import { acquireItemMetadataDerivedIndexLock, refreshItemMetadataDerivedIndex, } from "../item-metadata-index.js";
@@ -17,8 +18,9 @@ import { acquireHierarchyMutationLock } from "./hierarchy-mutation-lock.js";
 import { normalizeRiskInput, normalizeSeverityInput, parseConfidenceInput, parseRegressionInput, } from "./metadata-normalizers.js";
 import { applyLegacyNoneCollectionNormalizers, createLegacyNoneCollectionNormalizers, assertNoLegacyNoneToken, assertNoLegacyNoneTokens, isLegacyNoneToken, } from "./legacy-none-tokens.js";
 import { suggestNextLifecycleTransition, } from "./lifecycle-transitions.js";
-import { parseLinkedTestAssertionEqualsMap, parseLinkedTestAssertionGteMap, parseLinkedTestBoolean, parseLinkedTestContextMode, parseLinkedTestEnvClear, parseLinkedTestEnvSet, parseLinkedTestMinLines, parseLinkedTestRegexList, parseLinkedTestStringList, } from "../test/parsers.js";
+import { parseLinkedTestAssertionEqualsMap, parseLinkedTestAssertionGteMap, parseLinkedTestBoolean, parseLinkedTestContextMode, parseLinkedTestEnvClear, parseLinkedTestEnvSet, parseLinkedTestMinLines, parseLinkedTestRegexList, parseLinkedTestStringList, parseLinkedTestWorkspaceContextMode, } from "../test/parsers.js";
 import { looksLikeStructuredLinkedTestEntry, normalizeStructuredLinkedTestEntry, } from "../test/entry.js";
+import { attachLinkedTestMutationProvenance } from "../test/trust.js";
 import { COMMON_UNSET_FIELD_DEFINITIONS_AFTER_AUTHOR, COMMON_UNSET_FIELD_DEFINITIONS_BEFORE_AUTHOR, parseCommandUnsetTargets, resolveRuntimeUnsetFieldDefinition, } from "./shared-unset-fields.js";
 import { ensureEnumValue } from "./recurrence-parsers.js";
 import { assertDependencyEdgesAllowed, assertDependencyTargetsResolvable, assertValidBareDependencyFlagValue, } from "../dependency-flag-validation.js";
@@ -133,7 +135,7 @@ function normalizeLegacyNoneCreateOptions(options) {
         normalized[optionKey] = undefined;
         /* c8 ignore stop */
     }
-    return applyLegacyNoneCollectionNormalizers(normalized, CREATE_LEGACY_NONE_COLLECTION_NORMALIZERS);
+    return transferMutationStdinTokenPolicy(options, applyLegacyNoneCollectionNormalizers(normalized, CREATE_LEGACY_NONE_COLLECTION_NORMALIZERS));
 }
 function parseOptionalString(value) {
     if (value === undefined)
@@ -327,6 +329,7 @@ export function parseTests(raw) {
                 ? parseOptionalNumber(timeoutRaw, "timeout_seconds")
                 : undefined,
             pm_context_mode: parseLinkedTestContextMode(kv.pm_context_mode, "--test"),
+            workspace_context_mode: parseLinkedTestWorkspaceContextMode(kv.workspace_context_mode, "--test"),
             env_set: parseLinkedTestEnvSet(kv.env_set, "--test"),
             env_clear: parseLinkedTestEnvClear(kv.env_clear, "--test"),
             shared_host_safe: parseLinkedTestBoolean(kv.shared_host_safe, "--test", "shared_host_safe"),
@@ -542,22 +545,29 @@ function parseTypeOptions(raw) {
     };
 }
 async function resolveCreateStdinInputs(options) {
-    const stdinResolver = createStdinTokenResolver();
-    return {
-        ...options,
-        body: await stdinResolver.resolveValue(options.body, "--body"),
-        dep: await stdinResolver.resolveList(options.dep, "--dep"),
-        comment: await stdinResolver.resolveList(options.comment, "--comment"),
-        note: await stdinResolver.resolveList(options.note, "--note"),
-        learning: await stdinResolver.resolveList(options.learning, "--learning"),
-        file: await stdinResolver.resolveList(options.file, "--file"),
-        test: await stdinResolver.resolveList(options.test, "--test"),
-        doc: await stdinResolver.resolveList(options.doc, "--doc"),
-        reminder: await stdinResolver.resolveList(options.reminder, "--reminder"),
-        event: await stdinResolver.resolveList(options.event, "--event"),
-        typeOption: await stdinResolver.resolveList(options.typeOption, "--type-option"),
-        field: await stdinResolver.resolveList(options.field, "--field"),
-    };
+    const scalarFields = [
+        ["body", "--body"],
+        ["description", "--description"],
+    ];
+    const listFields = [
+        ["dep", "--dep"],
+        ["comment", "--comment"],
+        ["note", "--note"],
+        ["learning", "--learning"],
+        ["file", "--file"],
+        ["test", "--test"],
+        ["doc", "--doc"],
+        ["reminder", "--reminder"],
+        ["event", "--event"],
+        ["typeOption", "--type-option"],
+        ["field", "--field"],
+    ];
+    return await resolveMutationStdinTokenFields(options, scalarFields, listFields);
+}
+async function resolveCreateTransportInputs(options) {
+    return shouldResolveMutationStdinTokens(options)
+        ? await resolveCreateStdinInputs(options)
+        : options;
 }
 function resolveCreateMode(createMode, defaultMode) {
     if (createMode === undefined) {
@@ -1582,7 +1592,7 @@ async function writeCreatedItem(params) {
 }
 /** Implements run create for the public runtime surface of this module. */
 export async function runCreate(options, global) {
-    let resolvedOptions = normalizeLegacyNoneCreateOptions(await resolveCreateStdinInputs(options));
+    let resolvedOptions = normalizeLegacyNoneCreateOptions(await resolveCreateTransportInputs(options));
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     await ensureInitHasRun(pmRoot);
     const settings = await readSettings(pmRoot);
@@ -1605,6 +1615,7 @@ export async function runCreate(options, global) {
     const learnings = parseLogSeed("--learning", resolvedOptions.learning, nowValue, author);
     const files = parseFiles(resolvedOptions.file);
     const tests = parseTests(resolvedOptions.test);
+    tests.values = await attachLinkedTestMutationProvenance(tests.values, author, nowValue);
     const docs = parseDocs(resolvedOptions.doc);
     const reminders = parseReminders(resolvedOptions.reminder, nowValue);
     const events = parseEvents(resolvedOptions.event, nowValue);
@@ -1915,4 +1926,4 @@ export const _testOnlyCreateCommand = {
     typeOptionExampleValue,
 };
 //# sourceMappingURL=create.js.map
-//# debugId=4dff80ab-acfc-5f81-a546-3f19629d97be
+//# debugId=02c41ea1-8d4e-5239-b95a-a07210b63d7f

package/dist/sdk/lifecycle/plan.js

@@ -4,9 +4,9 @@
  * Implements the pm plan 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]="49fd5730-99c2-5a93-a80e-83c806a124bf")}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]="f7e870b6-fd80-5742-bc81-826d8f102d30")}catch(e){}}();
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { getActiveExtensionRegistrations, isTerminalStatus, resolveItemTypeRegistry, resolveRuntimeStatusRegistry, resolveTypeName, EXIT_CODE, PmCliError, splitCommaList, nowIso, locateItem, mutateItem, readLocatedItem, resolvePmRoot, readSettings, resolveAuthor, isTerminalPlanMode, } from "../runtime-primitives.js";
+import { getActiveExtensionRegistrations, isTerminalStatus, resolveItemTypeRegistry, resolveRuntimeStatusRegistry, resolveTypeName, EXIT_CODE, PmCliError, splitCommaList, nowIso, locateItem, mutateItem, readLocatedItem, resolvePmRoot, readSettings, resolveAuthor, isTerminalPlanMode, preserveMutationStdinTokenFields, transferMutationStdinTokenPolicy, } from "../runtime-primitives.js";
 import { PLAN_HARNESS_VALUES, PLAN_MODE_VALUES, PLAN_STEP_LINK_KIND_VALUES, PLAN_STEP_STATUS_VALUES, } from "../../types/index.js";
 import { runCreate, } from "./create.js";
 import { createUnknownSubcommandError } from "../agent/subcommand-recovery.js";
@@ -692,6 +692,12 @@ function buildInitialSteps(options) {
         hasPerStepDetailOptions: hasDetailOptions,
     };
 }
+function preservePlanCreateStdinPolicy(source, createOptions, derivedLiteralFields = []) {
+    transferMutationStdinTokenPolicy(source, createOptions);
+    if (derivedLiteralFields.length > 0) {
+        preserveMutationStdinTokenFields(createOptions, derivedLiteralFields);
+    }
+}
 async function planCreate(options, global, ctx) {
     const title = options.title?.trim();
     if (!title) {
@@ -738,6 +744,7 @@ async function planCreate(options, global, ctx) {
         message: options.message ??
             (fromSearch ? `plan create (search: ${fromSearch})` : `plan create`),
     };
+    preservePlanCreateStdinPolicy(options, createOptions);
     const createResult = await runCreate(createOptions, global);
     // Seed every Plan-specific field before assigning the requested owner so
     // cross-owner creation cannot reject a follow-up enrichment and leave a
@@ -1380,7 +1387,7 @@ async function createMaterializedStepItems(params) {
         materializeFields[fieldKey] = value;
     }
     for (const step of params.targets) {
-        const created = await runCreate({
+        const createOptions = {
             ...materializeFields,
             title: step.title,
             description: step.body?.trim() || step.title,
@@ -1391,7 +1398,15 @@ async function createMaterializedStepItems(params) {
             message: params.options.message ??
                 `materialized from plan ${params.planItemId} step ${step.id}`,
             dep: buildMaterializeDependencies(params.parent, params.planItemId, step),
-        }, { ...{}, path: params.pmRoot });
+        };
+        preservePlanCreateStdinPolicy(params.options, createOptions, [
+            "description",
+            ...Object.keys(materializeFields),
+        ]);
+        const created = await runCreate(createOptions, {
+            ...{},
+            path: params.pmRoot,
+        });
         materialized.push({
             id: created.item.id,
             title: created.item.title,
@@ -1489,7 +1504,10 @@ function normalizePlanStepAliasInput(input) {
     if (stepValues.length === 1 && !input.options.stepTitle?.trim()) {
         return {
             ...input,
-            options: { ...input.options, stepTitle: stepValues[0] },
+            options: transferMutationStdinTokenPolicy(input.options, {
+                ...input.options,
+                stepTitle: stepValues[0],
+            }),
         };
     }
     return input;
@@ -1586,4 +1604,4 @@ export const _testOnlyPlanCommand = {
     changedPlanMetadataFields,
 };
 //# sourceMappingURL=plan.js.map
-//# debugId=49fd5730-99c2-5a93-a80e-83c806a124bf
+//# debugId=f7e870b6-fd80-5742-bc81-826d8f102d30

package/dist/sdk/lifecycle/update-many.js

@@ -4,15 +4,15 @@
  * Implements the pm update many 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]="7a157c2e-e9e6-5bce-b124-0a7d34e3c7dc")}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]="fada7a33-ad1d-54f1-ae03-c5f8e4568d75")}catch(e){}}();
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { createCheckpointId, loadMutationCheckpoint, restoreCheckpointItems, writeMutationCheckpoint, toItemRecord, applyAcceptanceCriteriaMutations, applyTagRemovals, mergeAdditiveTags, parseOptionalNonNegativeInteger, parseTags, splitAcceptanceCriteria, resolvePriority, normalizeStatusInput, resolveItemTypeRegistry, resolveTypeName, collectRuntimeUpdateFieldValues, buildInvalidTypeError, resolveItemTypesFilePath, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, PmCliError, toErrorMessage, stableValueEquals, nowIso, resolveIsoOrRelative, getActiveExtensionRegistrations, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
+import { createCheckpointId, loadMutationCheckpoint, restoreCheckpointItems, writeMutationCheckpoint, toItemRecord, applyAcceptanceCriteriaMutations, applyTagRemovals, mergeAdditiveTags, parseOptionalNonNegativeInteger, parseTags, splitAcceptanceCriteria, resolvePriority, normalizeStatusInput, resolveItemTypeRegistry, resolveTypeName, collectRuntimeUpdateFieldValues, buildInvalidTypeError, resolveItemTypesFilePath, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, PmCliError, toErrorMessage, stableValueEquals, nowIso, preserveMutationStdinTokenLiterals, resolveIsoOrRelative, getActiveExtensionRegistrations, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
 import { assertDependencyTargetsResolvable } from "../dependency-flag-validation.js";
 import { parseStatusFilterCsv } from "../../core/item/status-filter.js";
 import { hasListFilters } from "../query/list-filter-shared.js";
 import { runList, } from "../query/list.js";
 import { runRestore } from "./restore.js";
-import { assertUpdateMutationOptionCombinations, parseDependencyAdditions, runUpdate, } from "./update.js";
+import { assertUpdateMutationOptionCombinations, parseDependencyAdditions, resolveUpdateTransportOptions, runUpdate, } from "./update.js";
 import { derivePmBulkMutationEffect, } from "../cli-contracts/command-exit-contracts.js";
 const UPDATE_MANY_CHECKPOINT_SCHEMA_VERSION = 1;
 const UPDATE_MANY_CHECKPOINT_SUBDIR = "update-many";
@@ -703,11 +703,12 @@ const applyUpdateManyRows = async (params) => {
             continue;
         }
         try {
-            const result = await runUpdate(item.id, {
+            const rowUpdateOptions = preserveMutationStdinTokenLiterals({
                 ...params.options.update,
                 message: updateMessage,
                 runtimeFieldCommands: ["update_many"],
-            }, params.global);
+            });
+            const result = await runUpdate(item.id, rowUpdateOptions, params.global);
             rows.push({
                 id: item.id,
                 status: "updated",
@@ -786,6 +787,12 @@ const applyUpdateManyPlan = async (params) => {
 export const runUpdateMany = async (options, global) => {
     const runtime = await loadUpdateManyRuntimeContext(global);
     const rollbackId = typeof options.rollback === "string" ? options.rollback : undefined;
+    if (rollbackId === undefined) {
+        options = {
+            ...options,
+            update: preserveMutationStdinTokenLiterals(await resolveUpdateTransportOptions(options.update)),
+        };
+    }
     const updateSummary = sanitizeUpdateOptionsForSummary(options.update);
     rejectBlankIdsFilter(options.list);
     if (rollbackId !== undefined) {
@@ -797,8 +804,8 @@ export const runUpdateMany = async (options, global) => {
             updateSummary,
         });
     }
-    if (!hasAnyUpdateMutationInput(options.update)) {
-        throw new PmCliError(`No update-many mutation flags provided. Add at least one mutation flag (for example: ${UPDATE_MANY_MUTATION_FLAG_GUIDANCE}).`, EXIT_CODE.USAGE);
+    if (!hasAnyUpdateMutationInput(options.update) && options.dryRun !== true) {
+        throw new PmCliError(`No update-many mutation flags provided. Add at least one mutation flag (for example: ${UPDATE_MANY_MUTATION_FLAG_GUIDANCE}), or pass --dry-run for a filter-only preview.`, EXIT_CODE.USAGE);
     }
     assertPlannedUpdateValuesValid(options.update, runtime.settings, runtime.statusRegistry, runtime.pmRoot);
     assertUpdateMutationOptionCombinations(options.update);
@@ -852,4 +859,4 @@ export const _testOnlyUpdateManyCommand = {
     toComparablePreviewValue,
 };
 //# sourceMappingURL=update-many.js.map
-//# debugId=7a157c2e-e9e6-5bce-b124-0a7d34e3c7dc
+//# debugId=fada7a33-ad1d-54f1-ae03-c5f8e4568d75

package/dist/sdk/lifecycle/update.d.ts

@@ -159,6 +159,8 @@ interface UpdateMutationContext {
     author: string;
     pmRoot: string;
 }
+/** Resolve update stdin tokens once while preserving transport-marked literals. */
+export declare function resolveUpdateTransportOptions(options: UpdateCommandOptions): Promise<UpdateCommandOptions>;
 /** Validate mutually exclusive and required update mutation option combinations. */
 export declare function assertUpdateMutationOptionCombinations(options: UpdateCommandOptions): void;
 type UpdateStatusMutationContext = Pick<UpdateMutationContext, "options" | "statusRegistry" | "clearItemMetadataKeys" | "nowIso">;