@unbrained/pm-cli 2026.8.23 → 2026.8.25

package/dist/sdk/history-repair.js

@@ -4,8 +4,10 @@
  * Implements the pm history repair 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]="d201aa9f-1ed3-5655-8c06-e5729557b86a")}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]="7a21ee76-ed53-57a0-9776-c787297ed7b6")}catch(e){}}();
 import { assertInitializedTracker } from "./environment/tracker-preflight.js";
+import { realpath } from "node:fs/promises";
+import path from "node:path";
 import jsonPatch from "fast-json-patch";
 import { patchPathToChangedField } from "../core/history/history-diff.js";
 import { pathExists, readFileIfExists } from "../core/fs/fs-utils.js";
@@ -19,11 +21,13 @@ import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { resolveAuthor } from "../core/shared/author.js";
 import { nowIso } from "../core/shared/time.js";
+import { sha256Hex, stableStringify } from "../core/shared/serialization.js";
 import { getActiveExtensionRegistrations, runActiveOnWriteHooks, } from "../core/extensions/index.js";
 import { listAllItemMetadataWithBody, readLocatedItem, } from "../core/store/item-store.js";
 import { resolvePmRoot } from "../core/store/paths.js";
 import { readSettings } from "../core/store/settings.js";
 import { resolveHistorySubject } from "./history-redact.js";
+import { summarizeMergeReceipt, } from "./merge/receipts.js";
 import { listInvalidProvenanceHistoryStreamIds, normalizeInvalidHistoryProvenance, } from "./governance/provenance-health.js";
 function replayFieldValue(document, field) {
     return field === "body"
@@ -135,6 +139,130 @@ export function analyzeReconciliationDiscard(entries, finalReplay, currentItemRe
             : null,
     };
 }
+async function canonicalRealPath(value) {
+    try {
+        return await realpath(value);
+    }
+    catch {
+        return null;
+    }
+}
+async function verifyReceiptAgainstSnapshot(params) {
+    if (params.receipt.evidence_source !== "clone_local")
+        return null;
+    const receiptPath = await canonicalRealPath(path.resolve(params.gitWorkspaceRoot, params.receipt.item_path));
+    if (receiptPath !== params.currentPath)
+        return null;
+    const declaredFields = [
+        ...new Set([
+            ...params.receipt.fields_from_theirs,
+            ...params.receipt.union_fields,
+            ...params.receipt.decisions.map((decision) => decision.field),
+        ]),
+    ].sort((left, right) => left.localeCompare(right));
+    const hashes = params.receipt.merged_field_hashes;
+    if (!hashes || declaredFields.length === 0)
+        return null;
+    const hashFields = Object.keys(hashes).sort((left, right) => left.localeCompare(right));
+    if (declaredFields.length !== hashFields.length ||
+        declaredFields.some((field, index) => field !== hashFields[index])) {
+        return null;
+    }
+    const currentMetadata = params.currentItemReplay.metadata;
+    const valuesMatch = declaredFields.every((field) => {
+        const value = field === "body" ? params.currentItemReplay.body : currentMetadata[field];
+        return hashes[field] === sha256Hex(stableStringify(value));
+    });
+    return valuesMatch ? { receipt: params.receipt, declaredFields } : null;
+}
+async function verifyMergeReceiptProof(params) {
+    if (params.proof.gitWorkspaceRoot === null) {
+        return {
+            trusted: false,
+            reason: "git_workspace_unavailable",
+            receipt_ids: [],
+        };
+    }
+    if (params.itemPath === null || params.currentItemReplay === null) {
+        return {
+            trusted: false,
+            reason: "item_path_unavailable",
+            receipt_ids: [],
+        };
+    }
+    const itemReceipts = params.proof.receipts.filter((receipt) => receipt.item_id === params.id);
+    if (itemReceipts.length === 0) {
+        return { trusted: false, reason: "no_item_receipts", receipt_ids: [] };
+    }
+    const currentPath = await realpath(params.itemPath);
+    const trustedReceipts = [];
+    for (const receipt of itemReceipts) {
+        const trusted = await verifyReceiptAgainstSnapshot({
+            receipt,
+            gitWorkspaceRoot: params.proof.gitWorkspaceRoot,
+            currentPath,
+            currentItemReplay: params.currentItemReplay,
+        });
+        if (trusted)
+            trustedReceipts.push(trusted);
+    }
+    const trustedFields = new Set(trustedReceipts.flatMap(({ declaredFields }) => declaredFields));
+    const reconciliationFields = params.reconciliation?.reconciled_fields;
+    if (trustedReceipts.length > 0 &&
+        (reconciliationFields === undefined ||
+            (reconciliationFields.length > 0 &&
+                reconciliationFields.every((field) => trustedFields.has(field))))) {
+        return {
+            trusted: true,
+            reason: "trusted_clone_local_driver_evidence",
+            receipt_ids: trustedReceipts.map(({ receipt }) => receipt.id),
+        };
+    }
+    return {
+        trusted: false,
+        reason: "no_receipt_set_proves_snapshot",
+        receipt_ids: [],
+    };
+}
+async function resolveHistoryRepairMergeEvidence(params) {
+    const subjectMergeReceipts = params.options.mergeReceiptProof?.receipts.filter((receipt) => receipt.item_id === params.subjectId) ?? [];
+    const mergeReceiptProof = params.options.mergeReceiptProof
+        ? await verifyMergeReceiptProof({
+            proof: {
+                ...params.options.mergeReceiptProof,
+                receipts: subjectMergeReceipts,
+            },
+            id: params.subjectId,
+            itemPath: params.itemReplayContext.currentItemPath,
+            currentItemReplay: params.itemReplayContext.currentItemReplay,
+            reconciliation: params.reconciliation,
+        })
+        : undefined;
+    if (mergeReceiptProof &&
+        !mergeReceiptProof.trusted &&
+        params.options.dryRun !== true &&
+        params.options.force !== true) {
+        throw new PmCliError(`Merge receipt evidence for ${params.subjectId} does not prove the exact item snapshot (${mergeReceiptProof.reason}).`, EXIT_CODE.CONFLICT, {
+            code: "merge_reconcile_receipt_evidence_untrusted",
+            required: "Use clone-local driver evidence whose canonical path, declared fields, and merged-value hashes match the current item, or review the mismatch and rerun with --force.",
+            recovery: { suggested_retry: "pm merge reconcile --dry-run" },
+        });
+    }
+    const provenMergeReceipts = mergeReceiptProof?.trusted
+        ? subjectMergeReceipts.filter((receipt) => mergeReceiptProof.receipt_ids.includes(receipt.id))
+        : [];
+    return {
+        mergeReceiptProof,
+        effectiveAuditContext: provenMergeReceipts.length > 0 && params.options.force !== true
+            ? {
+                ...params.options.auditContext,
+                merge: {
+                    receipts: provenMergeReceipts.map(summarizeMergeReceipt),
+                },
+            }
+            : params.options.auditContext,
+    };
+}
 async function loadHistoryRepairItemReplay(subject, settings, historyEntries, itemHashVersion) {
     const currentItemPath = subject.located?.itemPath ?? null;
     const loadedItem = subject.located
@@ -275,6 +403,12 @@ export async function runHistoryRepair(id, options, global) {
     const reconciliation = reconcileNeeded && itemReplayContext.currentItemReplay
         ? analyzeReconciliationDiscard(reanchor.entries, finalReplay, itemReplayContext.currentItemReplay)
         : undefined;
+    const { mergeReceiptProof, effectiveAuditContext } = await resolveHistoryRepairMergeEvidence({
+        options,
+        subjectId: subject.id,
+        itemReplayContext,
+        reconciliation,
+    });
     const changed = [
         reanchor.entriesRehashed > 0,
         reanchor.entriesPatchRepaired > 0,
@@ -301,10 +435,10 @@ export async function runHistoryRepair(id, options, global) {
         auditOperation: options.auditOperation ?? "history_repair",
         auditContext: provenanceNormalization.receipt.changed
             ? {
-                ...options.auditContext,
+                ...effectiveAuditContext,
                 provenance_normalization: provenanceNormalization.receipt,
             }
-            : options.auditContext,
+            : effectiveAuditContext,
         itemHashVersion,
         explicitItemHashVersion: reanchor.explicitItemHashVersion,
     });
@@ -360,6 +494,7 @@ export async function runHistoryRepair(id, options, global) {
             ...provenanceNormalization.receipt,
         },
         ...(reconciliation ? { reconciliation } : {}),
+        ...(mergeReceiptProof ? { merge_receipt_proof: mergeReceiptProof } : {}),
         warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),
         generated_at: nowIso(),
     };
@@ -397,6 +532,9 @@ export async function runHistoryRepairAll(options, global) {
                 ...options,
                 auditContext: options.auditContextById?.[driftedId],
                 auditContextById: undefined,
+                mergeReceiptProof: options.mergeReceiptProofById?.[driftedId] ??
+                    options.mergeReceiptProof,
+                mergeReceiptProofById: undefined,
             }, global);
             /* c8 ignore next -- mixed repaired/clean outcomes depend on live drift composition. */
             const outcome = result.changed ? "repaired" : "skipped_clean";
@@ -411,6 +549,9 @@ export async function runHistoryRepairAll(options, global) {
                 ...(result.reconciliation
                     ? { reconciliation: result.reconciliation }
                     : {}),
+                ...(result.merge_receipt_proof
+                    ? { merge_receipt_proof: result.merge_receipt_proof }
+                    : {}),
                 warnings: result.warnings,
             });
         }
@@ -440,4 +581,4 @@ export async function runHistoryRepairAll(options, global) {
     };
 }
 //# sourceMappingURL=history-repair.js.map
-//# debugId=d201aa9f-1ed3-5655-8c06-e5729557b86a
+//# debugId=7a21ee76-ed53-57a0-9776-c787297ed7b6

package/dist/sdk/index.d.ts

@@ -124,6 +124,7 @@ 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";

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]="714cb108-a51f-5f77-b628-dc994e659f45")}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";
@@ -121,6 +121,7 @@ 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";
@@ -166,4 +167,4 @@ export * from "./governance.js";
 export * from "./query.js";
 export * from "./testing.js";
 //# sourceMappingURL=index.js.map
-//# debugId=714cb108-a51f-5f77-b628-dc994e659f45
+//# 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]="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