@unbrained/pm-cli 2026.8.23 → 2026.8.25

package/dist/cli/register-mutation.js

@@ -1,6 +1,6 @@
 
-!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]="49cddeba-127e-5d6c-a62d-4a63088ce8c6")}catch(e){}}();
-import { resolveBodyFileContent, EXIT_CODE, splitCommaList, PmCliError, createUnknownSubcommandError, } from "../sdk/runtime-primitives.js";
+!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]="28a59fb9-80bc-5e2a-b926-1bb227c103c6")}catch(e){}}();
+import { resolveBodyFileContent, resolveCliBulkIdsInput, EXIT_CODE, splitCommaList, PmCliError, createUnknownSubcommandError, } from "../sdk/runtime-primitives.js";
 import { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, MERGE_SUBCOMMAND_VALUES, PLAN_CREATE_METADATA_PARAMETER_KEYS, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, } from "../sdk/cli-contracts.js";
 import { BUILTIN_ITEM_TYPE_VALUES, PLAN_STEP_LINK_KIND_VALUES, } from "../types/index.js";
 import { MERGE_DRIVER_ARTIFACT_VALUES, runMergeDriver, runMergeInstall, runMergeReconcile, runMergeReceiptReport, } from "./commands/merge.js";
@@ -22,7 +22,7 @@ import { runRestore } from "./commands/restore.js";
 import * as schemaModule from "./commands/schema.js";
 import { runUpdate } from "./commands/update.js";
 import { runUpdateMany } from "./commands/update-many.js";
-import { createStdinTokenResolver } from "../sdk/runtime-primitives.js";
+import { createStdinTokenResolver, preserveMutationStdinTokenFields, preserveMutationStdinTokenLiterals, } from "../sdk/runtime-primitives.js";
 import { resolveDescriptionStdin } from "./description-stdin.js";
 import { itemDocumentToMutationOptions } from "../sdk/structured-mutations.js";
 import { registerStructuredMutationCommands } from "./register-structured-mutation.js";
@@ -484,6 +484,7 @@ function assertCreatePositionalTypeHasTitle(positionalType, positionalTitle, opt
 }
 const STRUCTURED_STDIN_CONFLICT_KEYS = [
     "body",
+    "bodyFile",
     "description",
     "dep",
     "depRemove",
@@ -497,21 +498,45 @@ const STRUCTURED_STDIN_CONFLICT_KEYS = [
     "event",
     "typeOption",
     "field",
+    "ids",
 ];
-function assertExclusiveStructuredStdin(options) {
-    const conflictingFlags = STRUCTURED_STDIN_CONFLICT_KEYS.filter((key) => {
+function assertSingleMutationStdinConsumer(options) {
+    const stdinFlags = STRUCTURED_STDIN_CONFLICT_KEYS.flatMap((key) => {
         const value = options[key];
-        return value === "-" || (Array.isArray(value) && value.includes("-"));
-    }).map((key) => `--${key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`);
-    if (conflictingFlags.length > 0) {
-        throw new PmCliError(`--stdin-json cannot be combined with other stdin consumers: ${conflictingFlags.join(", ")}`, EXIT_CODE.USAGE);
+        const count = typeof value === "string" && value.trim() === "-"
+            ? 1
+            : Array.isArray(value)
+                ? value.filter((entry) => typeof entry === "string" && entry.trim() === "-").length
+                : 0;
+        const flag = `--${key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`;
+        return Array.from({ length: count }, () => flag);
+    });
+    if (options.stdinJson === true) {
+        stdinFlags.unshift("--stdin-json");
+    }
+    if (stdinFlags.length > 1) {
+        throw new PmCliError(`Only one option may consume stdin per command invocation. Found: ${stdinFlags.join(", ")}.`, EXIT_CODE.USAGE);
     }
 }
+function preserveResolvedMutationStdinFields(options, bodyFileResolved, descriptionStdinResolved) {
+    const fields = [];
+    if (bodyFileResolved)
+        fields.push("body");
+    if (descriptionStdinResolved)
+        fields.push("description");
+    preserveMutationStdinTokenFields(options, fields);
+}
+function isDescriptionStdinConsumer(options, stdinJsonConsumed) {
+    return (!stdinJsonConsumed &&
+        typeof options.description === "string" &&
+        options.description.trim() === "-");
+}
 async function runCreateAction(typeOrTitle, secondTitle, options, command) {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    if (options.stdinJson === true) {
-        assertExclusiveStructuredStdin(options);
+    assertSingleMutationStdinConsumer(options);
+    const stdinJsonConsumed = options.stdinJson === true;
+    if (stdinJsonConsumed) {
         const input = await createStdinTokenResolver().resolveValue("-", "--stdin-json");
         options = itemDocumentToMutationOptions(input ?? "", "create", options);
     }
@@ -526,12 +551,19 @@ async function runCreateAction(typeOrTitle, secondTitle, options, command) {
         positionals.positionalTitle.length > 0 &&
         options.title === undefined)
         options.title = positionals.positionalTitle;
-    await resolveDescriptionStdin(options);
-    if (typeof options.bodyFile === "string") {
-        options.body = await resolveBodyFileContent(options.bodyFile, options.body !== undefined ? String(options.body) : undefined);
+    const descriptionStdinResolved = isDescriptionStdinConsumer(options, stdinJsonConsumed);
+    if (!stdinJsonConsumed) {
+        await resolveDescriptionStdin(options);
+    }
+    const bodyFileResolved = typeof options.bodyFile === "string";
+    if (bodyFileResolved) {
+        options.body = await resolveBodyFileContent(String(options.bodyFile), options.body !== undefined ? String(options.body) : undefined);
         delete options.bodyFile;
     }
     const normalized = normalizeCreateOptions(options, { requireType: false });
+    preserveResolvedMutationStdinFields(normalized, bodyFileResolved, descriptionStdinResolved);
+    if (stdinJsonConsumed)
+        preserveMutationStdinTokenLiterals(normalized);
     const result = await runCreate(normalized, globalOptions);
     await invalidateSearchCachesForMutation(globalOptions, result);
     printResult(result, globalOptions);
@@ -564,6 +596,8 @@ function buildCloseManyListOptions(options) {
 async function runCloseManyAction(options, command) {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
+    assertSingleMutationStdinConsumer(options);
+    options.ids = await resolveCliBulkIdsInput(readOptionString(options, "ids"));
     const result = await runCloseMany({
         status: readOptionString(options, "filterStatus"),
         list: buildCloseManyListOptions(options),
@@ -591,6 +625,8 @@ async function runCloseManyAction(options, command) {
 async function runUpdateManyAction(options, command) {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
+    assertSingleMutationStdinConsumer(options);
+    options.ids = await resolveCliBulkIdsInput(readOptionString(options, "ids"));
     const result = await runUpdateMany({
         status: readOptionString(options, "filterStatus"),
         list: buildUpdateManyListOptions(options),
@@ -834,7 +870,8 @@ async function runMergeAction(subcommand, artifact, base, ours, theirs, options,
 async function runHistoryCompactAction(id, options, command) {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    const ids = typeof options.ids === "string" ? splitCommaList(options.ids) : undefined;
+    const idsValue = await resolveCliBulkIdsInput(readOptionString(options, "ids"));
+    const ids = idsValue === undefined ? undefined : splitCommaList(idsValue);
     const allOver = parseNonNegativeIntFlag(options.allOver, "--all-over");
     const minEntries = parseNonNegativeIntFlag(options.minEntries, "--min-entries");
     if (options.closed === true && options.allStreams === true) {
@@ -987,19 +1024,28 @@ async function runFocusAction(id, options, command) {
 async function runUpdateAction(id, options, command) {
     const globalOptions = getGlobalOptions(command);
     const startedAt = Date.now();
-    if (options.stdinJson === true) {
-        assertExclusiveStructuredStdin(options);
+    assertSingleMutationStdinConsumer(options);
+    const stdinJsonConsumed = options.stdinJson === true;
+    if (stdinJsonConsumed) {
         const input = await createStdinTokenResolver().resolveValue("-", "--stdin-json");
         options = itemDocumentToMutationOptions(input ?? "", "update", options);
     }
-    await resolveDescriptionStdin(options);
+    const descriptionStdinResolved = isDescriptionStdinConsumer(options, stdinJsonConsumed);
+    if (!stdinJsonConsumed) {
+        await resolveDescriptionStdin(options);
+    }
     // GH-214: resolve --body-file into the existing body field before
     // normalization so the rest of update is unchanged. CLI-only input alias.
-    if (typeof options.bodyFile === "string") {
-        options.body = await resolveBodyFileContent(options.bodyFile, options.body !== undefined ? String(options.body) : undefined);
+    const bodyFileResolved = typeof options.bodyFile === "string";
+    if (bodyFileResolved) {
+        options.body = await resolveBodyFileContent(String(options.bodyFile), options.body !== undefined ? String(options.body) : undefined);
         delete options.bodyFile;
     }
-    const result = await runUpdate(id, normalizeUpdateOptions(options), globalOptions);
+    const normalized = normalizeUpdateOptions(options);
+    preserveResolvedMutationStdinFields(normalized, bodyFileResolved, descriptionStdinResolved);
+    if (stdinJsonConsumed)
+        preserveMutationStdinTokenLiterals(normalized);
+    const result = await runUpdate(id, normalized, globalOptions);
     await invalidateSearchCachesForMutation(globalOptions, result);
     printResult(await applyActiveCommandResultService("update", [id], options, globalOptions, result), globalOptions);
     if (globalOptions.profile) {
@@ -1239,7 +1285,7 @@ export function registerMutationCommands(program, registrationOptions = {}) {
     registerCommanderOptionContracts(createCommand, CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS);
     createCommand
         .option("--stdin-json", "Read a full item JSON document from stdin; explicit flags override document values")
-        .option("--body-file <path>", "Load the item markdown body from a file (mutually exclusive with --body)")
+        .option("--body-file <path>", "Load body from a file or stdin (-); conflicts with --body")
         .option("--clear-deps", "Clear dependency entries")
         .option("--clear-comments", "Clear comments")
         .option("--clear-notes", "Clear notes")
@@ -1277,7 +1323,7 @@ export function registerMutationCommands(program, registrationOptions = {}) {
     registerCommanderOptionContracts(updateCommand, UPDATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS);
     updateCommand
         .option("--stdin-json", "Read a full item JSON document from stdin; explicit flags override document values")
-        .option("--body-file <path>", "Load the item markdown body from a file (mutually exclusive with --body)")
+        .option("--body-file <path>", "Load body from a file or stdin (-); conflicts with --body")
         .option("--replace-deps", "Atomically replace dependency entries with the provided --dep values")
         .option("--replace-tests", "Atomically replace linked test entries with the provided --test values")
         .option("--replace-files", "Atomically replace linked file entries with the provided --file values")
@@ -1319,7 +1365,7 @@ export function registerMutationCommands(program, registrationOptions = {}) {
         .option("--filter-metadata-missing", "Select only items missing any tracked metadata (AC, estimate, or resolution)");
     registerBulkContentAndGovernanceFilters(updateManyCommand, "applying updates");
     updateManyCommand
-        .option("--ids <value>", "Restrict to an explicit comma-separated ID allowlist (intersected with other filters)")
+        .option("--ids <value>", "Explicit ID allowlist: comma/newline text, - stdin, or @path file")
         .option("--limit <n>", "Limit matched item count before apply/preview")
         .option("--offset <n>", "Skip first n matched rows before apply/preview")
         .option("--dry-run", "Preview per-item diffs and checkpoint intent without mutating")
@@ -1477,7 +1523,7 @@ export function registerMutationCommands(program, registrationOptions = {}) {
         .option("--filter-release <value>", "Filter by release before closing");
     registerBulkContentAndGovernanceFilters(closeManyCommand, "closing");
     closeManyCommand
-        .option("--ids <value>", "Restrict to an explicit comma-separated ID allowlist (intersected with other filters)")
+        .option("--ids <value>", "Explicit ID allowlist: comma/newline text, - stdin, or @path file")
         .option("--limit <n>", "Limit matched item count before apply/preview")
         .option("--offset <n>", "Skip first n matched rows before apply/preview")
         .option("--reason <value>", "Shared close reason applied to matched items (required when governance.require_close_reason is enabled)")
@@ -1711,7 +1757,7 @@ export function registerMutationCommands(program, registrationOptions = {}) {
         .command("history-compact")
         .argument("[id]", "Item id (omit when using a bulk selector)")
         .option("--before <value>", "Compact entries strictly before this version number or ISO timestamp (single-id mode only)")
-        .option("--ids <value>", "Bulk: compact an explicit comma-separated list of item ids")
+        .option("--ids <value>", "Bulk IDs: comma/newline text, - stdin, or @path file")
         .option("--all-over <n>", "Bulk: compact every stream with more than N entries")
         .option("--closed", "Bulk: compact only closed (terminal) items' streams")
         .option("--all-streams", "Bulk: compact every history stream regardless of lifecycle state")
@@ -1840,4 +1886,4 @@ export function registerMutationCommands(program, registrationOptions = {}) {
         .action(runDepsAction);
 }
 //# sourceMappingURL=register-mutation.js.map
-//# debugId=49cddeba-127e-5d6c-a62d-4a63088ce8c6
+//# debugId=28a59fb9-80bc-5e2a-b926-1bb227c103c6