@unbrained/pm-cli 2026.8.19 → 2026.8.20

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Official marketplace for pm CLI — native git-based project management for Claude Code and AI coding agents.",
-    "version": "2026.8.19"
+    "version": "2026.8.20"
   },
   "plugins": [
     {
       "name": "pm-claude",
       "source": "./plugins/pm-claude",
       "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents, hybrid TUI task tracking, session context injection, and coordination subagents for git-based project management without leaving Claude Code.",
-      "version": "2026.8.19",
+      "version": "2026.8.20",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 2026.8.20 - 2026-08-20
+
+### Added
+
+- GH-796: no reopen transition for terminal items, so recurrence is recorded as a duplicate instead of a reopening ([pm-83cz0o](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/features/pm-83cz0o.toon))
+
+### Fixed
+
+- GH-529: init --agent-guidance emits run-tests.mjs linked-test example that may not exist in the target repo ([pm-surv](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-surv.toon))
+- GH-527: semantic staleness warning recommends 'pm reindex' which is absent from the base install ([pm-qljv](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-qljv.toon))
+- CodSpeed instrument cache can stall simulation setup until the hosted benchmark gate is canceled ([pm-w16muu](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-w16muu.toon))
+- Make context intents and low-token projection fields fully discoverable ([pm-gy885b](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/issues/pm-gy885b.toon))
+
+### Other
+
+- Refresh compatible Vitest 4.1.11 and jscpd 5.0.16 patches ([pm-n5ysuk](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-n5ysuk.toon))
+- Consistent flag spellings across commands with preserved aliases and enforced budgets ([pm-fs8q9x](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/tasks/pm-fs8q9x.toon))
+- Refresh compatible Greptile 3.4.1 review tooling ([pm-obmgi3](https://github.com/unbraind/pm-cli/blob/main/.agents/pm/chores/pm-obmgi3.toon))
+
 ## 2026.8.19 - 2026-08-19
 
 ### Fixed

package/dist/cli/register-list-query.js

@@ -1,9 +1,10 @@
 
-!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]="d3206ea9-3bf7-5e23-8b95-2a9078942b6f")}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]="102d4534-fb3a-57a3-91d1-db344492b812")}catch(e){}}();
 import { EXIT_CODE, PmCliError, readSettings, renderRowsAsCsv, renderRowsAsTable, resolvePmRoot, } from "../sdk/runtime-primitives.js";
 import { renderPmCommandAliasMigrationHint, resolvePmCommandAlias, } from "../sdk/cli-contracts.js";
 import { EVAL_QUERY_SET_SCHEMA_ID } from "../sdk/eval.js";
 import { applyContextIntentProjection } from "../sdk/context-intent-contracts.js";
+import { renderPmClosedDomainHelp } from "../sdk/agent/closed-domain-contracts.js";
 import { serializeNdjsonRows, serializeNdjsonStream, } from "../sdk/output.js";
 import { listMutationEvents, subscribeMutationEventBatches, subscribeMutationEvents, } from "../sdk/mutation-events.js";
 import { runActivity } from "./commands/activity.js";
@@ -191,6 +192,7 @@ async function runRegisteredListCommand(params) {
         }
     }
     applyDefaultListProjection(listOptions, effectiveName);
+    Object.assign(listOptions, { projectionCommand: effectiveName });
     if (effectiveExcludeTerminal)
         listOptions.excludeTerminal = true;
     listOptions.dependencyBlocked = effectiveDependencyBlocked;
@@ -213,7 +215,7 @@ function registerListCommand(program, descriptor) {
         command.option("--all", "Include every lifecycle status");
     }
     command
-        .option("--for <intent>", "Apply a declared context intent projection")
+        .option("--for <intent>", `Apply a declared context intent projection. ${renderPmClosedDomainHelp("list", "--for")}`)
         .option("--token-budget <n>", "Override the selected intent's maximum estimated output tokens")
         .option("--type <value>", "Filter by item type (repeatable or comma-separated; matches any)", collect)
         .option("--tag <value>", "Filter by tag (repeatable or comma-separated; matches any)", collect)
@@ -245,7 +247,7 @@ function registerListCommand(program, descriptor) {
         .option("--compact", "Render compact list projection fields (mutually exclusive with --brief/--full/--fields)")
         .option("--brief", "Ultra-compact output: id, status, type, title only (agent-optimized, mutually exclusive with --compact/--full/--fields)")
         .option("--full", "Render full list projection fields (mutually exclusive with --compact/--brief/--fields)")
-        .option("--fields <value>", "Render custom comma-separated list fields (mutually exclusive with --compact/--brief/--full; valid: --fields id,title)")
+        .option("--fields <value>", `Render custom comma-separated list fields (mutually exclusive with --compact/--brief/--full). ${renderPmClosedDomainHelp(name, "--fields")}`)
         .option("--sort <value>", "Sort field: priority|deadline|updated_at|created_at|title|parent (aliases: updated, created)")
         .option("--order <value>", "Sort order: asc|desc (requires --sort)")
         .option("--tree", "Render rows in parent/child tree order")
@@ -696,7 +698,7 @@ export function registerListQueryCommands(program, options) {
             .command("context")
             .alias("ctx")
             .description("Show a token-efficient project context snapshot for next-work decisions.")
-            .option("--for <intent>", "Apply a declared context intent projection")
+            .option("--for <intent>", `Apply a declared context intent projection. ${renderPmClosedDomainHelp("context", "--for")}`)
             .option("--date <value>", "Anchor date/time for agenda window calculations (ISO/date string or relative)")
             .option("--from <value>", "Agenda lower bound (ISO/date string or relative)")
             .option("--to <value>", "Agenda upper bound (ISO/date string or relative)")
@@ -732,7 +734,7 @@ export function registerListQueryCommands(program, options) {
         const nextCommand = program
             .command("next")
             .description("Recommend the next actionable (unblocked, ready) work item with rationale + blocked companion.")
-            .option("--for <intent>", "Apply a declared context intent projection")
+            .option("--for <intent>", `Apply a declared context intent projection. ${renderPmClosedDomainHelp("next", "--for")}`)
             .option("--type <value>", "Filter candidate items by type")
             .option("--tag <value>", "Filter candidate items by tag")
             .option("--priority <value>", "Filter candidate items by priority")
@@ -761,7 +763,7 @@ export function registerListQueryCommands(program, options) {
             .argument("<keywords...>", "Keyword query tokens")
             .description("Search items with keyword, semantic, or hybrid retrieval. Inline field:value tokens " +
             "(tag:/status:/type:/priority:) in the query are parsed as filters, e.g. 'auth tag:area:search status:open'.")
-            .option("--for <intent>", "Apply a declared context intent projection")
+            .option("--for <intent>", `Apply a declared context intent projection. ${renderPmClosedDomainHelp("search", "--for")}`)
             .option("--token-budget <n>", "Override the selected intent's maximum estimated output tokens")
             .option("--mode <value>", "Search mode: keyword|semantic|hybrid (default: keyword)")
             .option("--semantic", "Shorthand for --mode semantic")
@@ -790,7 +792,7 @@ export function registerListQueryCommands(program, options) {
             .option("--parent <value>", "Filter by parent item ID")
             .option("--compact", "Render compact search hits (default; mutually exclusive with --full/--fields)")
             .option("--full", "Render full search hits with nested item payloads (mutually exclusive with --compact/--fields)")
-            .option("--fields <value>", "Render custom comma-separated search hit fields (mutually exclusive with --compact/--full; valid: --fields id,title,score; invalid: --full --fields id,title)")
+            .option("--fields <value>", `Render custom comma-separated search hit fields (mutually exclusive with --compact/--full). ${renderPmClosedDomainHelp("search", "--fields")}`)
             .option("--format <value>", "Search output format override: json|ndjson|toon")
             .option("--limit <n>", "Limit returned item count")
             .option("--after <cursor>", "Continue after an opaque next_cursor from a previous search response");
@@ -815,11 +817,11 @@ export function registerListQueryCommands(program, options) {
         const getCommand = program
             .command("get")
             .argument("<id>", "Item id")
-            .option("--for <intent>", "Apply a declared context intent projection")
+            .option("--for <intent>", `Apply a declared context intent projection. ${renderPmClosedDomainHelp("get", "--for")}`)
             .option("--token-budget <n>", "Override the selected intent's maximum estimated output tokens")
             .option("--depth <value>", "Detail depth: brief|standard|deep|full (full aliases deep; default: standard)")
             .option("--full", "Explicit full item read; equivalent to --depth deep (mutually exclusive with --depth/--fields)")
-            .option("--fields <value>", "Render custom comma-separated item metadata fields (for example: --fields id,title,status,parent,type)")
+            .option("--fields <value>", `Render custom comma-separated item metadata fields. ${renderPmClosedDomainHelp("get", "--fields")}`)
             .option("--tree", "Include descendants rooted at the requested item")
             .option("--tree-depth <n>", "Maximum subtree depth for --tree descendants")
             .option("--at <version-or-timestamp>", "Reconstruct a verified historical item state without mutating it")
@@ -922,4 +924,4 @@ export const _testOnlyRegisterListQuery = {
     parseListFormat,
 };
 //# sourceMappingURL=register-list-query.js.map
-//# debugId=d3206ea9-3bf7-5e23-8b95-2a9078942b6f
+//# debugId=102d4534-fb3a-57a3-91d1-db344492b812

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