@unbrained/pm-cli 2026.8.23 → 2026.8.24

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]="f8c8e154-737b-58db-9a8b-7f4399342e83")}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";
@@ -134,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)
@@ -544,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) {
@@ -1584,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);
@@ -1918,4 +1926,4 @@ export const _testOnlyCreateCommand = {
     typeOptionExampleValue,
 };
 //# sourceMappingURL=create.js.map
-//# debugId=f8c8e154-737b-58db-9a8b-7f4399342e83
+//# 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">;

package/dist/sdk/lifecycle/update.js

@@ -4,9 +4,10 @@
  * Implements the pm update 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]="c88f01be-6abe-5fa2-9792-3f54e61bb282")}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]="6865ca88-7ca1-52fd-86fb-2a3439abeafa")}catch(e){}}();
 import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { COMMON_MUTATION_COMMAND_OPTION_KEYS, canonicalizeCommandOptionKey, commandOptionFlagLabel, resolveItemTypeRegistry, resolveCommandOptionPolicyState, resolveTypeDefinition, resolveTypeName, validateTypeOptions, normalizeItemId, toItemRecord, buildInvalidTypeError, assertParentReferenceIsNotSelf, normalizeParentReferenceValue, validateMissingParentReference, validateSprintOrReleaseValue, applyAcceptanceCriteriaMutations, applyTagRemovals, assertNoUnknownCsvKeys, createStdinTokenResolver, looksLikeGenericKeyValueEntry, mergeAdditiveTags, parseCsvKv, parseOptionalNonNegativeInteger, parseOptionalNumber, parseTags, splitAcceptanceCriteria, resolvePriority, normalizeStatusInput, isTerminalStatus, collectRuntimeUpdateFieldValues, resolveItemTypesFilePath, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, describeAllowedTransitions, evaluateTransition, resolveTypeWorkflows, EXIT_CODE, PmCliError, stableValueEquals, resolveIsoOrRelative, getActiveExtensionRegistrations, collectRegisteredItemFieldNames, applyRegisteredItemFieldDefaultsAndValidation, parseRegisteredItemFieldAssignments, buildItemNotFoundError, listAllItemMetadataLight, locateItem, readLocatedItem, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
+import { resolveMutationStdinTokenFields } from "../../core/item/parse.js";
+import { COMMON_MUTATION_COMMAND_OPTION_KEYS, canonicalizeCommandOptionKey, commandOptionFlagLabel, resolveItemTypeRegistry, resolveCommandOptionPolicyState, resolveTypeDefinition, resolveTypeName, validateTypeOptions, normalizeItemId, toItemRecord, buildInvalidTypeError, assertParentReferenceIsNotSelf, normalizeParentReferenceValue, validateMissingParentReference, validateSprintOrReleaseValue, applyAcceptanceCriteriaMutations, applyTagRemovals, assertNoUnknownCsvKeys, looksLikeGenericKeyValueEntry, mergeAdditiveTags, parseCsvKv, parseOptionalNonNegativeInteger, parseOptionalNumber, parseTags, shouldResolveMutationStdinTokens, transferMutationStdinTokenPolicy, splitAcceptanceCriteria, resolvePriority, normalizeStatusInput, isTerminalStatus, collectRuntimeUpdateFieldValues, resolveItemTypesFilePath, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, describeAllowedTransitions, evaluateTransition, resolveTypeWorkflows, EXIT_CODE, PmCliError, stableValueEquals, resolveIsoOrRelative, getActiveExtensionRegistrations, collectRegisteredItemFieldNames, applyRegisteredItemFieldDefaultsAndValidation, parseRegisteredItemFieldAssignments, buildItemNotFoundError, listAllItemMetadataLight, locateItem, readLocatedItem, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
 import { mutateItemWithHistoryContextResolver } from "../../core/store/item-store.js";
 import { runClose } from "./close.js";
 import { normalizeRiskInput, normalizeSeverityInput, parseConfidenceInput, parseRegressionInput, } from "./metadata-normalizers.js";
@@ -108,7 +109,7 @@ function normalizeLegacyNoneUpdateOptions(options) {
         normalized[optionKey] = undefined;
         /* c8 ignore stop */
     }
-    return applyLegacyNoneCollectionNormalizers(normalized, UPDATE_LEGACY_NONE_COLLECTION_NORMALIZERS);
+    return transferMutationStdinTokenPolicy(options, applyLegacyNoneCollectionNormalizers(normalized, UPDATE_LEGACY_NONE_COLLECTION_NORMALIZERS));
 }
 function parseUpdateUnsetTargets(raw, runtimeFieldRegistry, extensionFieldNames = []) {
     return parseCommandUnsetTargets({
@@ -858,23 +859,31 @@ function applyUpdateScalarMutations(definitions, options, context) {
     }
 }
 async function resolveStdinUpdateOptions(options) {
-    const stdinResolver = createStdinTokenResolver();
-    return normalizeLegacyNoneUpdateOptions({
-        ...options,
-        body: await stdinResolver.resolveValue(options.body, "--body"),
-        dep: await stdinResolver.resolveList(options.dep, "--dep"),
-        depRemove: await stdinResolver.resolveList(options.depRemove, "--dep-remove"),
-        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"],
+        ["depRemove", "--dep-remove"],
+        ["comment", "--comment"],
+        ["note", "--note"],
+        ["learning", "--learning"],
+        ["file", "--file"],
+        ["test", "--test"],
+        ["doc", "--doc"],
+        ["reminder", "--reminder"],
+        ["event", "--event"],
+        ["typeOption", "--type-option"],
+        ["field", "--field"],
+    ];
+    return normalizeLegacyNoneUpdateOptions(await resolveMutationStdinTokenFields(options, scalarFields, listFields));
+}
+/** Resolve update stdin tokens once while preserving transport-marked literals. */
+export async function resolveUpdateTransportOptions(options) {
+    return shouldResolveMutationStdinTokens(options)
+        ? await resolveStdinUpdateOptions(options)
+        : normalizeLegacyNoneUpdateOptions(options);
 }
 function buildClearCollectionDefinitions(options) {
     return [
@@ -1220,12 +1229,13 @@ async function routeCloseStatusUpdate(context) {
     const routeWarnings = [];
     let preChangedFields = [];
     if (otherFieldKeys.length > 0) {
-        const preUpdate = await runUpdate(context.id, {
+        const preUpdateOptions = transferMutationStdinTokenPolicy(context.options, {
             ...context.options,
             status: undefined,
             closeReason: undefined,
             message: undefined,
-        }, context.global);
+        });
+        const preUpdate = await runUpdate(context.id, preUpdateOptions, context.global);
         preChangedFields = preUpdate.changed_fields;
         routeWarnings.push(...preUpdate.warnings);
     }
@@ -1804,7 +1814,7 @@ function mutateUpdateDocument(document, context) {
 }
 /** Implements run update for the public runtime surface of this module. */
 async function runUpdateWithContext(id, options, global, execution = {}) {
-    options = await resolveStdinUpdateOptions(options);
+    options = await resolveUpdateTransportOptions(options);
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     await assertUpdateTrackerInitialized(pmRoot);
     const settings = await readSettings(pmRoot);
@@ -2111,4 +2121,4 @@ export const _testOnlyUpdateCommand = {
     resolveRuntimeUnsetDefinition: (token, registry) => resolveRuntimeUnsetFieldDefinition(token, "update", registry),
 };
 //# sourceMappingURL=update.js.map
-//# debugId=c88f01be-6abe-5fa2-9792-3f54e61bb282
+//# debugId=6865ca88-7ca1-52fd-86fb-2a3439abeafa

package/dist/sdk/runtime-extended-actions.js

@@ -1,7 +1,8 @@
 
-!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]="0492d773-2af2-5072-8164-9f8aab536191")}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]="8a3a82a1-9e3d-555f-9111-3c3e19887f75")}catch(e){}}();
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
+import { transferMutationStdinTokenPolicy, } from "./runtime-primitives.js";
 import { createUnknownSubcommandError } from "./agent/subcommand-recovery.js";
 import { resolvePmRoot } from "../core/store/paths.js";
 import { runEval } from "./eval.js";
@@ -14,7 +15,8 @@ import { parseRuntimeInteger, readRuntimeString, readRuntimeStringArray, } from
 import { runEvent, runMeet, runRemind, } from "./scheduling-shortcuts.js";
 import { createWorkspaceSnapshot, deleteWorkspaceSnapshot, inspectWorkspaceSnapshot, listWorkspaceSnapshots, planWorkspaceSnapshotRestore, restoreWorkspaceSnapshotWithRecovery, } from "./workspace-snapshot.js";
 function mergedInput(context) {
-    return { ...context.args, ...context.options };
+    const input = { ...context.args, ...context.options };
+    return transferMutationStdinTokenPolicy(context.options, input);
 }
 function requiredString(input, key) {
     const value = readRuntimeString(input, key);
@@ -169,4 +171,4 @@ export function runRuntimeSchedulingAction(context) {
     return runRemind(title, input, context.global);
 }
 //# sourceMappingURL=runtime-extended-actions.js.map
-//# debugId=0492d773-2af2-5072-8164-9f8aab536191
+//# debugId=8a3a82a1-9e3d-555f-9111-3c3e19887f75

package/dist/sdk/runtime-input.d.ts

@@ -3,6 +3,10 @@ import type { CloseManyCommandOptions } from "./lifecycle/close-many.js";
 import type { UpdateManyCommandOptions } from "./lifecycle/update-many.js";
 import type { GraphCommandOptions } from "./graph/run.js";
 import type { ListOptions } from "./query/list.js";
+/** Mark an action object decoded from the MCP JSON-RPC transport. */
+export declare function markMcpMutationTransportInput<T extends object>(input: T): T;
+/** Clone mutation options with overrides while retaining stdin provenance. */
+export declare function mutationOptionsWithOverrides<Source extends object, Overrides extends object>(source: Source, overrides: Overrides, omittedKeys?: readonly PropertyKey[]): Source & Overrides;
 /** Read a non-empty string without altering its caller-provided whitespace. */
 export declare function readRuntimeString(args: Record<string, unknown>, key: string): string | undefined;
 /** Normalize a non-empty string or finite number into a scalar string. */