@unbrained/pm-cli 2026.8.23 → 2026.8.24

package/dist/sdk/comments.js

@@ -4,11 +4,11 @@
  * Implements the pm comments 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]="a7687052-a04e-536e-ace5-a665ebd477e3")}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]="5167b367-26cf-52d5-8040-bb001ce3592a")}catch(e){}}();
 import { isFileAbsentError } from "../core/fs/fs-utils.js";
 import { readFile } from "node:fs/promises";
-import { EXIT_CODE, PmCliError, createStdinTokenResolver, } from "./runtime-primitives.js";
-import { isErrnoError, parseAnnotationTextInput, runAnnotationCommand, } from "./annotations.js";
+import { EXIT_CODE, PmCliError, createStdinTokenResolver, shouldResolveMutationStdinTokens, } from "./runtime-primitives.js";
+import { assertAnnotationStdinTransportAvailable, isErrnoError, parseAnnotationTextInput, runAnnotationCommand, } from "./annotations.js";
 async function resolveCommentTextSource(options, stdinResolver) {
     const hasAdd = options.add !== undefined;
     const hasStdin = options.stdin === true;
@@ -21,10 +21,11 @@ async function resolveCommentTextSource(options, stdinResolver) {
         throw new PmCliError("Specify comment text using only one input source: --add, --stdin, or --file", EXIT_CODE.USAGE);
     }
     if (hasAdd) {
-        const addInput = await stdinResolver.resolveValue(options.add, "--add");
+        const addInput = await stdinResolver.resolveValue(options.add, "--add", shouldResolveMutationStdinTokens(options));
         return { value: addInput ?? "", emptyFlag: "--add" };
     }
     if (hasStdin) {
+        assertAnnotationStdinTransportAvailable(options, "--stdin");
         const stdinInput = await stdinResolver.resolveValue("-", "--stdin");
         return { value: stdinInput ?? "", emptyFlag: "--stdin" };
     }
@@ -32,16 +33,23 @@ async function resolveCommentTextSource(options, stdinResolver) {
     if (!filePath) {
         throw new PmCliError("--file path cannot be empty", EXIT_CODE.USAGE);
     }
+    if (filePath === "-") {
+        assertAnnotationStdinTransportAvailable(options, "--file -");
+        return {
+            value: (await stdinResolver.resolveValue("-", "--file")) ?? "",
+            emptyFlag: "--file",
+        };
+    }
     try {
         const fileInput = await readFile(filePath, "utf8");
         return { value: fileInput, emptyFlag: "--file" };
     }
     catch (error) {
         if (isErrnoError(error) && isFileAbsentError(error)) {
-            throw new PmCliError(`--file path not found: ${filePath}`, EXIT_CODE.USAGE);
+            throw new PmCliError(`--file path not found: ${filePath}. Use --file - to read stdin.`, EXIT_CODE.USAGE);
         }
         const detail = error instanceof Error ? error.message : String(error);
-        throw new PmCliError(`Failed to read --file path "${filePath}": ${detail}`, EXIT_CODE.USAGE);
+        throw new PmCliError(`Failed to read --file path "${filePath}": ${detail}. Use --file - to read stdin.`, EXIT_CODE.USAGE);
     }
 }
 async function resolveCommentInput(options, stdinResolver) {
@@ -123,4 +131,4 @@ export async function runComments(id, options, global) {
     });
 }
 //# sourceMappingURL=comments.js.map
-//# debugId=a7687052-a04e-536e-ace5-a665ebd477e3
+//# debugId=5167b367-26cf-52d5-8040-bb001ce3592a

package/dist/sdk/flag-invocation-contracts.d.ts

@@ -24,6 +24,8 @@ export interface CliFlagInvocationContract extends CliFlagContract {
     input_sources: CliFlagInputSource[];
     /** Sentinel that redirects the argv value to stdin. */
     stdin_token?: "-";
+    /** Prefix that redirects the argv value to a file path. */
+    file_token_prefix?: "@";
 }
 /** Executable option arity observed from the registered Commander program. */
 export interface CliFlagArityObservation {

package/dist/sdk/flag-invocation-contracts.js

@@ -1,8 +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]="32dca84c-9a21-570c-a0e0-0f0356c84c0d")}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]="7ef5cc14-ad6b-5cce-a1a1-e5cfac85fbc2")}catch(e){}}();
 const FLAG_DESCRIPTIONS = Object.freeze({
     "--body": "Set the item body.",
-    "--body-file": "Read the item body from a file.",
+    "--body-file": "Read the item body from a file, or from stdin when set to -.",
     "--description": "Set the item description.",
     "--stdin": "Read the value from stdin.",
     "--stdin-json": "Read a complete JSON document from stdin.",
@@ -12,13 +12,16 @@ const STDIN_TOKEN_FLAGS = new Set([
     "--body",
     "--comment",
     "--dep",
+    "--dep-remove",
     "--description",
     "--doc",
+    "--event",
     "--field",
     "--file",
     "--learning",
     "--note",
     "--remove",
+    "--reminder",
     "--test",
     "--type-option",
 ]);
@@ -32,6 +35,22 @@ const STDIN_VALUE_COMMANDS = new Set([
     "notes",
     "test",
     "update",
+    "update-many",
+]);
+const FILE_OR_STDIN_COMMAND_FLAGS = new Set([
+    "close-many:--ids",
+    "comments:--file",
+    "create:--body-file",
+    "history-compact:--ids",
+    "learnings:--file",
+    "notes:--file",
+    "update:--body-file",
+    "update-many:--ids",
+]);
+const AT_PATH_FILE_COMMAND_FLAGS = new Set([
+    "close-many:--ids",
+    "history-compact:--ids",
+    "update-many:--ids",
 ]);
 const BOOLEAN_FLAG_PREFIXES = [
     "--allow-",
@@ -193,6 +212,9 @@ const OPTIONAL_VALUE_FLAGS = new Set(["--regression"]);
 function resolveFlagInputSources(command, flag) {
     if (flag === "--stdin" || flag === "--stdin-json")
         return ["stdin"];
+    if (FILE_OR_STDIN_COMMAND_FLAGS.has(`${command}:${flag}`)) {
+        return ["argv", "file", "stdin"];
+    }
     if (flag.endsWith("-file"))
         return ["argv", "file"];
     if (STDIN_TOKEN_FLAGS.has(flag) && STDIN_VALUE_COMMANDS.has(command)) {
@@ -243,6 +265,9 @@ export function enrichCliFlagInvocationContract(command, contract) {
             contract.flag !== "--stdin-json"
             ? { stdin_token: "-" }
             : {}),
+        ...(AT_PATH_FILE_COMMAND_FLAGS.has(`${command}:${contract.flag}`)
+            ? { file_token_prefix: "@" }
+            : {}),
     };
 }
 /** Enrich a complete command flag table without mutating package-owned rows. */
@@ -317,4 +342,4 @@ export function verifyCliFlagInvocationParity(command, declarations, observation
     };
 }
 //# sourceMappingURL=flag-invocation-contracts.js.map
-//# debugId=32dca84c-9a21-570c-a0e0-0f0356c84c0d
+//# debugId=7ef5cc14-ad6b-5cce-a1a1-e5cfac85fbc2

package/dist/sdk/generated/generated-error-code-catalog-part-1.js

@@ -1,6 +1,6 @@
 /** Generated partition 1 of the exhaustive error-code catalog. */
 
-!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]="30cf6de5-af9b-54a1-b376-1c9e5d543ae1")}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]="030027d7-2703-56ea-9235-64bc602a25c3")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_1 = [
     {
         code: "acceptance_criteria_mutation_conflict",
@@ -218,6 +218,51 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "budget_exceeded",
         aliases: [],
     },
+    {
+        code: "bulk_ids_input_empty",
+        meaning: "Bulk ids input empty condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/io/bulk-ids-input.ts", "sdk/history-compact.ts", "sdk/history-mcp.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "bulk_ids_input_empty",
+        aliases: [],
+        owned_states: [
+            { state: "bulk_ids_stdin_contains_no_nonempty_ids", probe_id: "bulk-ids-stdin-empty", entrypoints: ["update-many"], expected_exit_class: "usage" },
+        ],
+    },
+    {
+        code: "bulk_ids_input_missing_path",
+        meaning: "Bulk ids input missing path condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/io/bulk-ids-input.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "bulk_ids_input_missing_path",
+        aliases: [],
+        owned_states: [
+            { state: "bulk_ids_file_token_omits_its_path", probe_id: "bulk-ids-file-path-missing", entrypoints: ["update-many"], expected_exit_class: "usage" },
+        ],
+    },
+    {
+        code: "bulk_ids_input_unreadable",
+        meaning: "Bulk ids input unreadable condition.",
+        stability: "provisional",
+        exit_code: 3,
+        class: "not_found",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/io/bulk-ids-input.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "bulk_ids_input_unreadable",
+        aliases: [],
+        owned_states: [
+            { state: "bulk_ids_file_path_cannot_be_read", probe_id: "bulk-ids-file-unreadable", entrypoints: ["update-many"], expected_exit_class: "not_found" },
+        ],
+    },
     {
         code: "bundle_integrity_torn_install",
         meaning: "Bundle integrity torn install condition.",
@@ -1896,6 +1941,30 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "manifest_unknown_key",
         aliases: [],
     },
+    {
+        code: "mcp_annotation_file_unavailable",
+        meaning: "Mcp annotation file unavailable condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/runtime-input.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "mcp_annotation_file_unavailable",
+        aliases: [],
+    },
+    {
+        code: "mcp_stdin_unavailable",
+        meaning: "Mcp stdin unavailable condition.",
+        stability: "provisional",
+        exit_code: 2,
+        class: "usage",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/annotations.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "mcp_stdin_unavailable",
+        aliases: [],
+    },
     {
         code: "merge_conflict_markers_detected",
         meaning: "Merge conflict markers detected condition.",
@@ -1980,42 +2049,6 @@ export const PM_ERROR_CODE_CATALOG_PART_1 = [
         canonical_code: "missing_budget",
         aliases: [],
     },
-    {
-        code: "missing_cli_flag",
-        meaning: "Missing cli flag condition.",
-        stability: "provisional",
-        exit_code: 1,
-        class: "generic_failure",
-        recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["sdk/cli-contracts/tool-option-contracts.ts"],
-        emitting_commands: ["*"],
-        canonical_code: "missing_cli_flag",
-        aliases: [],
-    },
-    {
-        code: "missing_destination",
-        meaning: "Missing destination condition.",
-        stability: "provisional",
-        exit_code: 1,
-        class: "generic_failure",
-        recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["sdk/cli-contracts/grammar-contracts.ts"],
-        emitting_commands: ["*"],
-        canonical_code: "missing_destination",
-        aliases: [],
-    },
-    {
-        code: "missing_directory",
-        meaning: "Missing directory condition.",
-        stability: "stable",
-        exit_code: 1,
-        class: "generic_failure",
-        recovery: "Inspect the structured error guidance and retry the suggested command.",
-        sources: ["core/diagnostics/remediation.ts"],
-        emitting_commands: ["*"],
-        canonical_code: "missing_directory",
-        aliases: [],
-    },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-1.js.map
-//# debugId=30cf6de5-af9b-54a1-b376-1c9e5d543ae1
+//# debugId=030027d7-2703-56ea-9235-64bc602a25c3

package/dist/sdk/generated/generated-error-code-catalog-part-2.js

@@ -1,7 +1,43 @@
 /** Generated partition 2 of the exhaustive error-code catalog. */
 
-!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]="9b6149b0-ca3e-5093-aba5-43385d3368f7")}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]="8724f8ed-1236-5779-9e97-dc4b35866839")}catch(e){}}();
 export const PM_ERROR_CODE_CATALOG_PART_2 = [
+    {
+        code: "missing_cli_flag",
+        meaning: "Missing cli flag condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/cli-contracts/tool-option-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "missing_cli_flag",
+        aliases: [],
+    },
+    {
+        code: "missing_destination",
+        meaning: "Missing destination condition.",
+        stability: "provisional",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["sdk/cli-contracts/grammar-contracts.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "missing_destination",
+        aliases: [],
+    },
+    {
+        code: "missing_directory",
+        meaning: "Missing directory condition.",
+        stability: "stable",
+        exit_code: 1,
+        class: "generic_failure",
+        recovery: "Inspect the structured error guidance and retry the suggested command.",
+        sources: ["core/diagnostics/remediation.ts"],
+        emitting_commands: ["*"],
+        canonical_code: "missing_directory",
+        aliases: [],
+    },
     {
         code: "missing_init_recovery",
         meaning: "Missing init recovery condition.",
@@ -2039,4 +2075,4 @@ export const PM_ERROR_CODE_CATALOG_PART_2 = [
     },
 ];
 //# sourceMappingURL=generated-error-code-catalog-part-2.js.map
-//# debugId=9b6149b0-ca3e-5093-aba5-43385d3368f7
+//# debugId=8724f8ed-1236-5779-9e97-dc4b35866839

package/dist/sdk/guide-topics.d.ts

@@ -1,8 +1,3 @@
-/**
- * @module cli/guide-topics
- *
- * Provides CLI runtime support for Guide Topics.
- */
 /** Describes one documentation file surfaced by a progressive-disclosure guide topic. */
 export interface GuideDocReference {
     /** Filesystem path used for path resolution. */

package/dist/sdk/guide-topics.js

@@ -1,9 +1,35 @@
+/**
+ * @module cli/guide-topics
+ *
+ * Provides CLI runtime support for Guide Topics.
+ */
 
-!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]="7be35c3f-df6f-5ed6-b887-a7d8d53910a7")}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]="3e5f92c9-c299-592d-a7ab-a6f9998159f0")}catch(e){}}();
+import { listPmCommandCapabilityGroups } from "./agent-capability-contracts.js";
 function normalizeTopicToken(value) {
     return value.trim().toLowerCase().replaceAll("_", "-");
 }
 const GUIDE_TOPICS = [
+    {
+        id: "capabilities",
+        aliases: ["capability-map", "families", "routing"],
+        title: "Generated Capability Routing",
+        summary: "Route work through command families generated from the canonical agent capability contract.",
+        intent: "Use this as the drift-free entrypoint when selecting a CLI, MCP, completion, documentation, or extension command surface.",
+        commands: listPmCommandCapabilityGroups().flatMap(({ commands }) => commands.map((command) => `pm ${command}`)),
+        workflows: [],
+        docs: [
+            {
+                path: "docs/generated/AGENT_CAPABILITY_ROUTING.md",
+                purpose: "Generated command-to-family routing table.",
+            },
+            {
+                path: "docs/generated/AGENT_COMMAND_SURFACE.md",
+                purpose: "Generated visibility-tier and family table.",
+            },
+        ],
+        related: ["commands", "workflows", "extensions"],
+    },
     {
         id: "quickstart",
         aliases: ["start", "getting-started", "bootstrap"],
@@ -565,4 +591,4 @@ export function resolveGuideTopic(rawTopic) {
     return TOPIC_BY_TOKEN.get(normalized) ?? null;
 }
 //# sourceMappingURL=guide-topics.js.map
-//# debugId=7be35c3f-df6f-5ed6-b887-a7d8d53910a7
+//# debugId=3e5f92c9-c299-592d-a7ab-a6f9998159f0

package/dist/sdk/history-compact.d.ts

@@ -1,4 +1,5 @@
 import { type HistoryCompactBulkSkipReason, type HistoryCompactScope } from "../core/history/history-compact-bulk.js";
+import { type BulkIdsValue } from "../core/io/bulk-ids-input.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";
 /** Documents the history compact command options payload exchanged by command, SDK, and package integrations. */
 export interface HistoryCompactCommandOptions {
@@ -58,7 +59,7 @@ export declare const HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES = 3;
 /** Documents the bulk history compact command options payload exchanged by command, SDK, and package integrations. */
 export interface HistoryCompactBulkCommandOptions {
     /** Value that configures or reports ids for this contract. */
-    ids?: string[];
+    ids?: BulkIdsValue;
     /** Value that configures or reports scope for this contract. */
     scope?: HistoryCompactScope;
     /** Value that configures or reports all over for this contract. */

package/dist/sdk/history-compact.js

@@ -4,7 +4,7 @@
  * Implements the pm history compact 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]="adcf4d1b-689d-52cb-903b-5fba857707f3")}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]="31152621-df59-54a5-a28d-63119e734e6e")}catch(e){}}();
 import { assertInitializedTracker } from "./environment/tracker-preflight.js";
 import fs from "node:fs/promises";
 import path from "node:path";
@@ -19,6 +19,7 @@ import { lifecycleClassifierFromStatusRegistry } from "../core/governance/metada
 import { resolveRuntimeStatusRegistry } from "../core/schema/runtime-schema.js";
 import { listAllItemMetadataLight } from "../core/store/item-store.js";
 import { pathExists, readFileIfExists } from "../core/fs/fs-utils.js";
+import { normalizeBulkIdsValue, parseBulkIdsText, } from "../core/io/bulk-ids-input.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { nowIso } from "../core/shared/time.js";
@@ -301,6 +302,21 @@ export async function runHistoryCompact(id, options, global) {
 }
 /** Default entry floor below which a stream is treated as already compact. */
 export const HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES = 3;
+function normalizeHistoryCompactBulkOptions(options) {
+    const normalizedIdsText = normalizeBulkIdsValue(options.ids);
+    if (options.ids !== undefined && normalizedIdsText === "") {
+        throw new PmCliError("history-compact ids requires at least one valid item ID.", EXIT_CODE.USAGE, {
+            code: "bulk_ids_input_empty",
+            required: "Provide one or more string or finite numeric IDs; non-finite and unsupported selector values are rejected.",
+        });
+    }
+    return {
+        ...options,
+        ids: normalizedIdsText === undefined
+            ? undefined
+            : parseBulkIdsText(normalizedIdsText),
+    };
+}
 /** Enforce the `pm history-compact` target contract shared by the CLI and MCP surfaces: exactly one selection mode — a single item `<id>`, an explicit `--ids` list, or a scan selector (`--all-over` / `--closed` / `--all-streams`). */
 export function assertHistoryCompactTarget(id, bulk) {
     const hasIds = bulk.ids !== undefined && bulk.ids.length > 0;
@@ -436,6 +452,7 @@ async function runHistoryCompactBulkRow(params) {
  * configured policy drives the sweep.
  */
 export async function runHistoryCompactBulk(options, global) {
+    const normalizedOptions = normalizeHistoryCompactBulkOptions(options);
     const pmRoot = resolvePmRoot(process.cwd(), global.path);
     await assertInitializedTracker(pmRoot);
     const settings = await readSettings(pmRoot);
@@ -445,14 +462,16 @@ export async function runHistoryCompactBulk(options, global) {
         settings,
         typeToFolder: typeRegistry.type_to_folder,
     });
-    const mode = options.ids !== undefined && options.ids.length > 0 ? "ids" : "scan";
+    const mode = normalizedOptions.ids !== undefined && normalizedOptions.ids.length > 0
+        ? "ids"
+        : "scan";
     const minEntries = options.minEntries ?? HISTORY_COMPACT_BULK_DEFAULT_MIN_ENTRIES;
     const policy = settings.history.compact_policy;
     const policyThresholdApplied = mode === "scan" && options.allOver === undefined && policy.enabled;
     const allOver = options.allOver ??
         (policyThresholdApplied ? policy.max_entries : undefined);
     const selection = selectHistoryCompactBulkTargets(candidates, {
-        ids: options.ids,
+        ids: normalizedOptions.ids,
         scope: options.scope,
         minEntries,
         allOver,
@@ -469,7 +488,7 @@ export async function runHistoryCompactBulk(options, global) {
     for (const row of selection) {
         const outcome = await runHistoryCompactBulkRow({
             row,
-            options,
+            options: normalizedOptions,
             dryRun,
             global,
         });
@@ -502,4 +521,4 @@ export async function runHistoryCompactBulk(options, global) {
     };
 }
 //# sourceMappingURL=history-compact.js.map
-//# debugId=adcf4d1b-689d-52cb-903b-5fba857707f3
+//# debugId=31152621-df59-54a5-a28d-63119e734e6e

package/dist/sdk/history-mcp.js

@@ -1,5 +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]="f762b5e6-8224-531f-9dd1-f71dc18c3ddf")}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]="4888a558-7f50-5c28-8e29-fcd19180cbd4")}catch(e){}}();
+import { normalizeBulkIdsValue, parseBulkIdsText, } from "../core/io/bulk-ids-input.js";
 import { EXIT_CODE } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { assertHistoryCompactTarget, runHistoryCompact, runHistoryCompactBulk, } from "./history-compact.js";
@@ -17,14 +18,14 @@ export function runMcpHistoryRepairAction(context) {
 /** Dispatch single or bounded bulk history compaction from an MCP payload. */
 export function runMcpHistoryCompactAction(context) {
     const idsSource = context.options.ids;
-    const ids = Array.isArray(idsSource)
-        ? idsSource.map(String).filter((value) => value.trim().length > 0)
-        : typeof idsSource === "string"
-            ? idsSource
-                .split(",")
-                .map((value) => value.trim())
-                .filter(Boolean)
-            : undefined;
+    const normalizedIds = normalizeBulkIdsValue(idsSource);
+    if (idsSource !== undefined && normalizedIds === "") {
+        throw new PmCliError("history-compact ids requires at least one valid item ID.", EXIT_CODE.USAGE, {
+            code: "bulk_ids_input_empty",
+            required: "Provide one or more string or finite numeric IDs; non-finite and unsupported selector values are rejected.",
+        });
+    }
+    const ids = normalizedIds === undefined ? undefined : parseBulkIdsText(normalizedIds);
     const allOver = parseRuntimeInteger(context.options.allOver ?? context.options.all_over, "history-compact allOver");
     const minEntries = parseRuntimeInteger(context.options.minEntries ?? context.options.min_entries, "history-compact minEntries");
     const explicitScope = readRuntimeString(context.options, "scope");
@@ -65,4 +66,4 @@ export function runMcpHistoryCompactAction(context) {
     }, context.global);
 }
 //# sourceMappingURL=history-mcp.js.map
-//# debugId=f762b5e6-8224-531f-9dd1-f71dc18c3ddf
+//# debugId=4888a558-7f50-5c28-8e29-fcd19180cbd4

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