@unbrained/pm-cli 2026.8.18 → 2026.8.20

package/dist/cli/register-mutation.js

@@ -1,5 +1,5 @@
 
-!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]="7feb0fe0-386c-56dc-afe1-e7b4ce1bc95a")}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]="07f3212f-c6d3-534e-8273-fae43a8fca18")}catch(e){}}();
 import { resolveBodyFileContent, EXIT_CODE, splitCommaList, PmCliError, createUnknownSubcommandError, } from "../sdk/runtime-primitives.js";
 import { CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS, 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";
@@ -1233,7 +1233,7 @@ async function runDepsAction(id, options, command) {
 export function registerMutationCommands(program, registrationOptions = {}) {
     const createCommand = program
         .command("create")
-        .argument("[typeOrTitle]", 'Item title, or item type when a title follows (e.g. `pm create task "Fix bug"`)')
+        .argument("[type-or-title]", 'Item title, or item type when a title follows (e.g. `pm create task "Fix bug"`)')
         .argument("[title]", "Item title when the first argument is an item type")
         .description("Create a new project management item.");
     registerCommanderOptionContracts(createCommand, CREATE_COMMANDER_OPTION_REGISTRATION_CONTRACTS);
@@ -1530,10 +1530,10 @@ export function registerMutationCommands(program, registrationOptions = {}) {
     const planCommand = program
         .command("plan")
         .description("Agent-optimized Plan item workflow: create, manage steps, link dependencies, approve, and materialize.")
-        .argument("[subcommand]", "Plan subcommand: create|show|add-step|update-step|complete-step|block-step|reorder-step|remove-step|link|unlink|decision|discovery|validation|resume|approve|materialize")
+        .argument("[subcommand]", "Required; Plan subcommand: create|show|add-step|update-step|complete-step|block-step|reorder-step|remove-step|link|unlink|decision|discovery|validation|resume|approve|materialize")
         .argument("[id]", "Plan id (required for non-create subcommands); for create this may be the positional title")
-        .argument("[stepRef]", "Step reference: stable id (plan-step-001) or order integer")
-        .argument("[reorderTo]", "New order integer for reorder-step")
+        .argument("[step]", "Step reference: stable id (plan-step-001) or order integer")
+        .argument("[new-order]", "New order integer for reorder-step")
         .option("--title <value>", "Plan title")
         .option("--description <value>", "Plan description")
         .option("--scope <value>", "Short scope statement of the target change or investigation")
@@ -1740,7 +1740,7 @@ export function registerMutationCommands(program, registrationOptions = {}) {
         .action(runMergeAction);
     const schemaCommand = program
         .command("schema")
-        .argument("[subcommand]", "Schema subcommand: list, show, show-status, add/remove type/status/field, rename-type, rename-field, remap-status, or a custom item type name shorthand")
+        .argument("[subcommand]", "Required; Schema subcommand: list, show, show-status, add/remove type/status/field, rename-type, rename-field, remap-status, or a custom item type name shorthand")
         .argument("[name]", "Definition name, or source name for rename/remap migrations")
         .option("--description <text>", "Human description for the custom item type, status, or field")
         .option("--default-status <status>", "Default status hint recorded for the custom item type")
@@ -1770,7 +1770,7 @@ export function registerMutationCommands(program, registrationOptions = {}) {
     schemaCommand.action(runSchemaAction);
     const profileCommand = program
         .command("profile")
-        .argument("[subcommand]", "Profile subcommand: list, show, apply, or lint")
+        .argument("[subcommand]", "Required; Profile subcommand: list, show, apply, or lint")
         .argument("[name]", "Profile name for show/apply/lint: agile, ops, or research")
         .option("--dry-run", "Preview the apply diff without writing any files (apply)")
         .option("--author <value>", "Mutation author")
@@ -1840,4 +1840,4 @@ export function registerMutationCommands(program, registrationOptions = {}) {
         .action(runDepsAction);
 }
 //# sourceMappingURL=register-mutation.js.map
-//# debugId=7feb0fe0-386c-56dc-afe1-e7b4ce1bc95a
+//# debugId=07f3212f-c6d3-534e-8273-fae43a8fca18

package/dist/cli/register-operations.js

@@ -1,9 +1,9 @@
 
-!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]="dec5fb7d-416f-5da6-bd97-c05c25dbf769")}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]="975321a1-0375-5829-a012-f23e32e9c6bf")}catch(e){}}();
 import { resolveRuntimeStatusRegistry, setActiveCommandResult, EXIT_CODE, PmCliError, createUnknownSubcommandError, resolveAuthor, resolvePmRoot, readSettings, } from "../sdk/runtime-primitives.js";
 import { resolveStartTaskInProgressStatus } from "../sdk/start-task-status.js";
 import { parseStatsAnalyticsJson } from "./stats-analytics-json.js";
-import { createWorkspaceSnapshot, deleteWorkspaceSnapshot, inspectWorkspaceSnapshot, listWorkspaceSnapshots, planWorkspaceSnapshotRestore, restoreWorkspaceSnapshotWithRecovery, } from "../sdk/workspace-snapshot.js";
+import { createWorkspaceSnapshot, deleteWorkspaceSnapshot, inspectWorkspaceSnapshot, listWorkspaceSnapshots, planWorkspaceSnapshotRestore, restoreWorkspaceSnapshotWithRecovery, WORKSPACE_SNAPSHOT_ACTIONS, } from "../sdk/workspace-snapshot.js";
 import { runClaim, runClaimNext, runRelease } from "./commands/claim.js";
 import { runClose } from "./commands/close.js";
 import { runContracts } from "./commands/contracts.js";
@@ -380,11 +380,11 @@ async function runWorkspaceSnapshotAction(action, target, options, command) {
     const globalOptions = getGlobalOptions(command);
     const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);
     const normalizedAction = action.trim().toLowerCase();
-    if (!["create", "list", "inspect", "restore", "delete"].includes(normalizedAction)) {
+    if (!WORKSPACE_SNAPSHOT_ACTIONS.some((entry) => entry === normalizedAction)) {
         throw createUnknownSubcommandError({
             command_path: "workspace snapshot",
             token: action,
-            allowed: ["create", "list", "inspect", "restore", "delete"],
+            allowed: WORKSPACE_SNAPSHOT_ACTIONS,
             display_name: "workspace snapshot",
             token_kind: "action",
             examples: [
@@ -606,7 +606,7 @@ export function registerOperationCommands(program) {
     });
     program
         .command("telemetry")
-        .argument("[namespaceOrSubcommand]", "Telemetry subcommand: status, flush, stats, clear (default: status)")
+        .argument("[namespace-or-subcommand]", "Telemetry subcommand: status, flush, stats, clear (default: status)")
         .argument("[subcommand]", "Compatibility alias target for local-analytics: status, flush, stats, clear")
         .option("--limit <n>", "Maximum command groups returned by telemetry stats")
         .description("Inspect and manage local telemetry queue/runtime state.")
@@ -873,4 +873,4 @@ function registerSchedulingShortcutCommands(program) {
     });
 }
 //# sourceMappingURL=register-operations.js.map
-//# debugId=dec5fb7d-416f-5da6-bd97-c05c25dbf769
+//# debugId=975321a1-0375-5829-a012-f23e32e9c6bf

package/dist/cli/register-structured-mutation.d.ts

@@ -4,6 +4,7 @@
  * Registers the noun-first CLI adapter for public SDK atomic item mutations.
  */
 import type { Command } from "commander";
+declare function runItemReopenAction(id: string, reason: string, options: Record<string, unknown>, command: Command): Promise<void>;
 declare function runItemMutateAction(options: Record<string, unknown>, command: Command): Promise<void>;
 declare function runItemCompleteAction(id: string, positionalReason: string | undefined, options: Record<string, unknown>, command: Command): Promise<void>;
 /** Register `pm item mutate`, the stable noun-first atomic batch surface. */
@@ -12,5 +13,6 @@ export declare function registerStructuredMutationCommands(program: Command): vo
 export declare const structuredMutationTestOnly: {
     runItemCompleteAction: typeof runItemCompleteAction;
     runItemMutateAction: typeof runItemMutateAction;
+    runItemReopenAction: typeof runItemReopenAction;
 };
 export {};

package/dist/cli/register-structured-mutation.js

@@ -1,9 +1,23 @@
 
-!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]="94fe3b7b-3aeb-5a31-a3a5-d85ae7e1ac83")}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]="3b23ded4-a821-5ff0-8783-927875d0457b")}catch(e){}}();
 import { createStdinTokenResolver, EXIT_CODE, PmCliError, readSettings, resolveAuthor, resolvePmRoot, } from "../sdk/runtime-primitives.js";
 import { buildItemCompletionMutations, commitItemCompletion, commitItemMutations, } from "../sdk/item-transaction.js";
+import { runReopen } from "../sdk/lifecycle/reopen.js";
 import { parseAtomicMutationControls, resolveItemMutationDocument, } from "../sdk/structured-mutations.js";
-import { collect, getGlobalOptions, printResult, } from "./registration-helpers.js";
+import { collect, getGlobalOptions, invalidateSearchCachesForMutation, printResult, } from "./registration-helpers.js";
+async function runItemReopenAction(id, reason, options, command) {
+    const globalOptions = getGlobalOptions(command);
+    const result = await runReopen(id, reason, {
+        status: typeof options.status === "string" ? options.status : undefined,
+        author: typeof options.author === "string"
+            ? options.author
+            : globalOptions.author,
+        message: typeof options.message === "string" ? options.message : undefined,
+        force: options.force === true,
+    }, globalOptions);
+    await invalidateSearchCachesForMutation(globalOptions, result);
+    printResult(result, globalOptions);
+}
 async function runItemMutateAction(options, command) {
     const globalOptions = getGlobalOptions(command);
     const input = await createStdinTokenResolver().resolveValue("-", "--stdin-json");
@@ -130,7 +144,15 @@ export function registerStructuredMutationCommands(program) {
     const itemCommand = program.commands.find((command) => command.name() === "item") ??
         program
             .command("item")
-            .description("Run item lifecycle and mutation operations.");
+            .description("Run item lifecycle operations.");
+    itemCommand
+        .command("reopen <id> <reason>")
+        .option("--status <value>", "Active target status: open or in_progress")
+        .option("--message <value>", "Human-readable recurrence history message")
+        .option("--force", "Override ownership or stale-lock conflicts")
+        .option("--author <value>", "Mutation author")
+        .description("Reopen terminal work with recurrence evidence.")
+        .action(runItemReopenAction);
     itemCommand
         .command("mutate")
         .requiredOption("--transaction-id <value>", "Stable idempotency key used to resume an interrupted batch")
@@ -140,7 +162,7 @@ export function registerStructuredMutationCommands(program) {
         .option("--lock-ttl-seconds <n>", "Workspace transaction lock lifetime in seconds")
         .option("--lock-wait-ms <n>", "Maximum time to wait for the workspace transaction lock")
         .option("--author <value>", "Mutation author")
-        .description("Apply create/update/close/release mutations atomically through the public pm SDK.")
+        .description("Apply SDK-backed mutations atomically.")
         .action(runItemMutateAction);
     itemCommand
         .command("complete <id> [reason]")
@@ -162,13 +184,14 @@ export function registerStructuredMutationCommands(program) {
         .option("--dry-run", "Validate and preview completion without writing")
         .option("--force", "Override lifecycle and ownership conflicts")
         .option("--author <value>", "Completion author")
-        .description("Record evidence, close the item, and release its claim atomically.")
+        .description("Close with evidence and release the claim.")
         .action(runItemCompleteAction);
 }
 /** Internal action hooks used by exhaustive source-level registration tests. */
 export const structuredMutationTestOnly = {
     runItemCompleteAction,
     runItemMutateAction,
+    runItemReopenAction,
 };
 //# sourceMappingURL=register-structured-mutation.js.map
-//# debugId=94fe3b7b-3aeb-5a31-a3a5-d85ae7e1ac83
+//# debugId=3b23ded4-a821-5ff0-8783-927875d0457b