@unbrained/pm-cli 2026.9.9 → 2026.9.11

package/packages/pm-governance-audit/README.md

@@ -1,6 +1,6 @@
 # pm-governance-audit
 
-Trackers: [pm-vjk3](../../.agents/pm/features/pm-vjk3.toon), [pm-mp49](../../.agents/pm/issues/pm-mp49.toon), [pm-v657](../../.agents/pm/issues/pm-v657.toon)
+Trackers: [pm-fmy9ih](../../.agents/pm/tasks/pm-fmy9ih.toon), [pm-vjk3](../../.agents/pm/features/pm-vjk3.toon), [pm-mp49](../../.agents/pm/issues/pm-mp49.toon), [pm-v657](../../.agents/pm/issues/pm-v657.toon)
 
 First-party package that restores optional governance audit surfaces in bare-core `pm`.
 
@@ -20,10 +20,10 @@ bodies and full before/after snapshots.
 
 ## Commands
 
-- `pm dedupe-audit`
-- `pm dedupe-merge`
-- `pm comments-audit`
-- `pm normalize`
+- `pm item duplicates audit`
+- `pm item duplicates merge`
+- `pm item audit-comments`
+- `pm ops normalize`
 
 The package also augments existing commands with audit-only flags:
 
@@ -60,10 +60,10 @@ pm install audit --project
 ## Verify
 
 ```bash
-pm dedupe-audit --mode parent_scope --status all --limit 20 --json
-pm dedupe-merge --keep pm-canonical --close pm-duplicate --dry-run --json
-pm comments-audit --latest 3 --limit-items 20 --limit-rows 50 --json
-pm normalize --dry-run --json
+pm item duplicates audit --mode parent_scope --status all --limit 20 --json
+pm item duplicates merge --keep pm-canonical --close pm-duplicate --dry-run --json
+pm item audit-comments --latest 3 --limit-items 20 --limit-rows 50 --json
+pm ops normalize --dry-run --json
 ```
 
 `dedupe-audit --status all` explicitly selects every status and is equivalent
@@ -80,3 +80,7 @@ For `comments-audit`, `--limit-items` caps item
 scanning while `--limit-rows` caps emitted comment rows across the whole
 result. The older `--limit` spelling remains a deprecated alias for
 `--limit-rows`; do not combine the two row-limit spellings.
+
+`pm normalize` remains a compatibility alias for `pm ops normalize`.
+
+`dedupe-audit`, `dedupe-merge`, and `comments-audit` remain hidden compatibility aliases. Core `pm item duplicates` discovers bounded candidate clusters; this package adds detailed audit and explicit reconciliation. Comment coverage is an independent item audit, not a duplicate detector. SDK action names remain unchanged.

package/packages/pm-governance-audit/extensions/governance-audit/index.ts

@@ -321,9 +321,10 @@ const allowAuditCommentFlags = [
   },
 ];
 
+/** Expose duplicate discovery under the item namespace while retaining its stable action and read-only handler. */
 function dedupeAuditCommand(): CommandDefinition {
   return {
-    name: "dedupe-audit",
+    name: "item duplicates audit",
     action: "dedupe-audit",
     description:
       "Audit likely duplicate items by title and parent scope heuristics.",
@@ -334,9 +335,10 @@ function dedupeAuditCommand(): CommandDefinition {
   };
 }
 
+/** Declare duplicate consolidation flags and route preview or apply requests to the existing package handler. */
 function dedupeMergeCommand(): CommandDefinition {
   return {
-    name: "dedupe-merge",
+    name: "item duplicates merge",
     action: "dedupe-merge",
     description:
       "Consolidate duplicates into a canonical item: re-parent active children and close duplicates with duplicate_of.",
@@ -347,9 +349,10 @@ function dedupeMergeCommand(): CommandDefinition {
   };
 }
 
+/** Register bounded comment-coverage inspection under the item namespace with the existing action identity. */
 function commentsAuditCommand(): CommandDefinition {
   return {
-    name: "comments-audit",
+    name: "item audit-comments",
     action: "comments-audit",
     description: "Audit item comment coverage and export comment history rows.",
     intent: "Audit comment coverage and read bounded comment-history evidence.",

package/packages/pm-governance-audit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-governance-audit",
-  "version": "2026.9.9",
+  "version": "2026.9.11",
   "private": true,
   "type": "module",
   "description": "First-party pm package for governance audit and normalization workflows.",

package/packages/pm-guide-shell/extensions/guide-shell/runtime.ts

@@ -20,6 +20,7 @@ import {
   resolveRuntimeStatusRegistry,
   runCompletion,
   runGuide,
+  type CompletionRuntimeConfig,
   type GlobalOptions,
   type GuideResult,
   type ItemMetadata,
@@ -93,29 +94,15 @@ function collectStatusNames(
     .sort((left, right) => left.localeCompare(right));
 }
 
-async function buildCompletionRuntimeConfig(global: GlobalOptions): Promise<{
-  item_types?: string[];
-  statuses?: string[];
-  command_flags?: Partial<
-    Record<
-      | "list"
-      | "create"
-      | "update"
-      | "update-many"
-      | "close-many"
-      | "search"
-      | "calendar"
-      | "context",
-      string[]
-    >
-  >;
-}> {
+/** Resolve configured workflow values and active package paths for completion discovery. */
+async function buildCompletionRuntimeConfig(global: GlobalOptions): Promise<CompletionRuntimeConfig> {
   const pmRoot = resolvePmRoot(process.cwd(), global.path);
+  const registrations = getActiveExtensionRegistrations();
+  const namespaceCommands = registrations?.commands.map((entry) => entry.command) ?? [];
   if (!(await pathExists(getSettingsPath(pmRoot)))) {
-    return {};
+    return { namespace_commands: namespaceCommands };
   }
   const settings = await readSettings(pmRoot);
-  const registrations = getActiveExtensionRegistrations();
   const typeRegistry = resolveItemTypeRegistry(settings, registrations);
   const itemTypes = collectTypeNames(typeRegistry);
   const statuses = collectStatusNames(
@@ -161,6 +148,7 @@ async function buildCompletionRuntimeConfig(global: GlobalOptions): Promise<{
     }
   }
   return {
+    namespace_commands: namespaceCommands,
     item_types: itemTypes.length > 0 ? itemTypes : undefined,
     statuses: statuses.length > 0 ? statuses : undefined,
     command_flags:

package/packages/pm-guide-shell/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-guide-shell",
-  "version": "2026.9.9",
+  "version": "2026.9.11",
   "private": true,
   "type": "module",
   "description": "First-party pm package for guide and shell completion workflows.",

package/packages/pm-kanban/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-kanban",
-  "version": "2026.9.9",
+  "version": "2026.9.11",
   "private": true,
   "type": "module",
   "description": "First-party pm archetype package: a complete Kanban continuous-flow profile built on public SDK primitives.",

package/packages/pm-lifecycle-hooks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-lifecycle-hooks",
-  "version": "2026.9.9",
+  "version": "2026.9.11",
   "private": true,
   "type": "module",
   "description": "First-party pm package demonstrating safe lifecycle hook registration.",

package/packages/pm-linked-test-adapters/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-linked-test-adapters",
-  "version": "2026.9.9",
+  "version": "2026.9.11",
   "private": true,
   "type": "module",
   "description": "First-party pm package for optional linked-test run management adapters and reporters.",

package/packages/pm-search-advanced/README.md

@@ -1,10 +1,12 @@
 # pm-search-advanced
 
+Tracker: [pm-wfskfn](../../.agents/pm/tasks/pm-wfskfn.toon).
+
 First-party package that restores optional advanced search surfaces in bare-core `pm`.
 
 ## Commands and behavior
 
-- Adds `pm search-advanced` with:
+- Adds `pm search advanced` with:
   - `--mode keyword|semantic|hybrid`
   - `--semantic`, `--hybrid`
   - `--include-linked`
@@ -13,7 +15,7 @@ First-party package that restores optional advanced search surfaces in bare-core
   - `--type`, `--tag`, `--priority`
   - `--deadline-before`, `--deadline-after`
   - `--limit`, `--fields`, `--compact`, `--full`
-- Adds `pm reindex` with:
+- Adds `pm ops reindex` with:
   - `--mode keyword|semantic|hybrid`
   - `--progress`
   - `--eval`
@@ -28,14 +30,14 @@ pm install search-advanced --project
 ## Verify
 
 ```bash
-pm search-advanced "vector cache" --mode hybrid --limit 5 --json
-pm search-advanced --hybrid "vector cache" --limit 5 --json
-pm search-advanced "calendar package" --mode keyword --fields id,title,score --compact --json
-pm reindex --mode hybrid --progress --json
-pm reindex --mode keyword --eval --eval-fixtures tests/search-eval/golden-queries.json --json
+pm search advanced "vector cache" --mode hybrid --limit 5 --json
+pm search advanced --hybrid "vector cache" --limit 5 --json
+pm search advanced "calendar package" --mode keyword --fields id,title,score --compact --json
+pm ops reindex --mode hybrid --progress --json
+pm ops reindex --mode keyword --eval --eval-fixtures tests/search-eval/golden-queries.json --json
 ```
 
-Without `--mode`, `--semantic`, or `--hybrid`, `search-advanced` stays keyword-first for fast agent reads.
+Without `--mode`, `--semantic`, or `--hybrid`, `search advanced` stays keyword-first for fast agent reads.
 
 The command registers its shared search options from
 `SEARCH_EXTENSION_FLAG_DEFINITIONS`, the public SDK authoring adapter over pm's
@@ -44,7 +46,7 @@ lockstep with the core CLI without a copied flag table.
 
 ## Reindex eval harness
 
-`pm reindex --eval` runs a golden-query relevance harness after the reindex pass and appends a deterministic `eval` object to JSON output:
+`pm ops reindex --eval` runs a golden-query relevance harness after the reindex pass and appends a deterministic `eval` object to JSON output:
 
 - per-fixture pass/fail verdicts
 - `ndcg_at_5` score for each fixture
@@ -76,3 +78,7 @@ Rules:
 - `mode` is optional (`keyword`, `semantic`, `hybrid`), default `keyword`.
 - `expected_top_ids` is required and defines the ideal ranking for nDCG@5.
 - `min_ndcg_at_5` is optional (`0..1`), default `0.7`.
+
+`pm reindex` remains a compatibility alias for `pm ops reindex`.
+
+`pm search-advanced` remains a hidden compatibility alias with the stable `search-advanced` SDK action. Use `pm search -- advanced` to search for the literal word `advanced`; place query options before `--`. The search provider remains configurable independently of the command facet.

package/packages/pm-search-advanced/extensions/search-advanced/index.ts

@@ -155,9 +155,10 @@ const reindexFlags = [
   },
 ] as const;
 
+/** Declare the required query tokens for the search facet while preserving the package's stable dispatch action. */
 function searchAdvancedCommand(): CommandDefinition {
   return {
-    name: "search-advanced",
+    name: "search advanced",
     action: "search-advanced",
     description:
       "Enable optional semantic and hybrid search modes via package runtime.",
@@ -190,7 +191,7 @@ function reindexCommand(): CommandDefinition {
 
 /** Registers this package's commands, actions, and runtime hooks with the host. */
 export function activate(api: ExtensionApi): void {
-  api.registerFlags("search-advanced", [
+  api.registerFlags("search advanced", [
     ...SEARCH_EXTENSION_FLAG_DEFINITIONS,
   ]);
   api.registerCommand(searchAdvancedCommand());

package/packages/pm-search-advanced/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-search-advanced",
-  "version": "2026.9.9",
+  "version": "2026.9.11",
   "private": true,
   "type": "module",
   "description": "First-party pm package for semantic, hybrid, and reindex search workflows.",

package/packages/pm-templates/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-templates",
-  "version": "2026.9.9",
+  "version": "2026.9.11",
   "private": true,
   "type": "module",
   "description": "First-party pm package for reusable create templates.",

package/packages/pm-todos/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-todos",
-  "version": "2026.9.9",
+  "version": "2026.9.11",
   "private": true,
   "type": "module",
   "description": "First-party pm package for Todo markdown import and export.",

package/packages/pm-vcs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-vcs-sdk-exemplar",
-  "version": "2026.9.9",
+  "version": "2026.9.11",
   "private": true,
   "type": "module",
   "description": "Beyond-PM exemplar: a VCS-style changeset workflow built entirely on public pm SDK and extension primitives.",

package/plugins/pm-claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pm-claude",
   "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents (coordinator, delivery-chain, triage, verification), hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and full git-based project management without leaving Claude Code.",
-  "version": "2026.9.9",
+  "version": "2026.9.11",
   "author": {
     "name": "unbrained",
     "url": "https://github.com/unbraind/pm-cli"

package/plugins/pm-codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-codex",
-  "version": "2026.9.9",
+  "version": "2026.9.11",
   "description": "Native Codex integration for pm-cli with bundled MCP tools, skills, commands, and agent workflows.",
   "author": {
     "name": "unbrained",

package/dist/cli-bundle/chunks/chunk-4VL5P22L.js

@@ -1,2 +0,0 @@
-import{H as I,J as _,L as D,M as A,d as k}from"./chunk-WQKMSFBV.js";import{hb as b,ib as v,jb as R}from"./chunk-D3YVILJJ.js";import{Ah as p,Fd as C,I as m,K as f,Mk as E,co as y,fo as h,go as i,zh as u,zo as w}from"./chunk-J6ERHBV2.js";(function(){try{var t=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},e=new t.Error().stack;e&&(t._sentryDebugIds=t._sentryDebugIds||{},t._sentryDebugIds[e]="42878185-8f30-5d0e-bddc-de26b64e3615")}catch{}})();(function(){try{var t=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},e=new t.Error().stack;e&&(t._sentryDebugIds=t._sentryDebugIds||{},t._sentryDebugIds[e]="c713a4ec-b6a5-5a77-8c53-610dde8a386d")}catch{}})();(function(){try{var t=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},e=new t.Error().stack;e&&(t._sentryDebugIds=t._sentryDebugIds||{},t._sentryDebugIds[e]="72fad412-7931-5198-a862-d7df2c431945")}catch{}})();(function(){try{var t=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},e=new t.Error().stack;e&&(t._sentryDebugIds=t._sentryDebugIds||{},t._sentryDebugIds[e]="c44b53b6-4c4d-5830-a4b5-347f509e427f")}catch{}})();(function(){try{var t=typeof window<"u"?window:typeof global<"u"?global:typeof globalThis<"u"?globalThis:typeof self<"u"?self:{},e=new t.Error().stack;e&&(t._sentryDebugIds=t._sentryDebugIds||{},t._sentryDebugIds[e]="2bc71c6c-38c9-56e6-87c6-6b4933b4cd07")}catch{}})();function H(t,e){if(typeof t!="string")return;let o=Number.parseInt(t,10);if(!/^\d+$/.test(t.trim())||!Number.isSafeInteger(o))throw new f(`history-compact ${e} must be a non-negative integer.`,m.USAGE);return o}async function T(t,e,o){let r=y(o),n=Date.now(),a=await C(i(e,"ids")),l=a===void 0?void 0:E(a),c=H(e.allOver,"--all-over"),d=H(e.minEntries,"--min-entries");if(e.closed===!0&&e.allStreams===!0)throw new f("history-compact: --closed and --all-streams are mutually exclusive; pick one lifecycle scope.",m.USAGE);let s=e.closed===!0?"closed":e.allStreams===!0?"all-streams":void 0;if((l!==void 0||c!==void 0||s!==void 0)&&typeof e.before=="string")throw new f("history-compact: --before applies only in single-id mode (bulk mode always compacts full streams).",m.USAGE);if(D(t,{ids:l,allOver:c,scope:s}),t!==void 0&&d!==void 0)throw new f("history-compact: --min-entries applies only in bulk mode (single-id mode compacts the named stream).",m.USAGE);if(t===void 0){let g=await A({ids:l,scope:s,allOver:c,minEntries:d,dryRun:e.dryRun===!0,author:i(e,"author"),message:i(e,"message"),force:!!e.force},r);u(g,r),g.totals.items_errored>0&&(process.exitCode=m.GENERIC_FAILURE)}else{let g=await _(t,{before:i(e,"before"),dryRun:e.dryRun===!0,author:i(e,"author"),message:i(e,"message"),force:!!e.force},r);u(g,r)}r.profile&&p(`profile:command=history-compact took_ms=${Date.now()-n}`)}async function x(t,e,o,r){let n=y(r),a=Date.now(),l=await k(t,e,{author:i(o,"author"),message:i(o,"message"),force:!!o.force},n);await w(n,l),u(l,n),n.profile&&p(`profile:command=restore took_ms=${Date.now()-a}`)}function Q(t,e){t.command("restore",{hidden:!e}).summary("Restore a version.").argument("<id>","Item id").argument("<target>","Restore target timestamp or version number").option("--author <value>","Mutation author").option("--message <value>","History message").option("--force","Force ownership/lock override").description("Restore an item to an earlier timestamp or version.").action(x),t.command(e?"redact":"history-redact",{hidden:!e}).summary("Redact sensitive values.").argument("<id>","Item id").option("--literal <value>","Literal string to redact (repeatable)",h).option("--regex <value>","Regex pattern to redact (repeatable; accepts /pattern/flags or raw pattern)",h).option("--replacement <value>",'Replacement string (default: "[redacted]")').option("--dry-run","Preview redaction impact without writing item/history files").option("--author <value>","Mutation author").option("--message <value>","Audit history message for the redaction marker entry").option("--force","Force ownership/lock override").description("Redact sensitive literals/patterns from an item history stream and recompute hashes.").action(async(o,r,n)=>{let a=y(n),l=Date.now(),c=Array.isArray(r.literal)?r.literal:void 0,d=Array.isArray(r.regex)?r.regex:void 0,s=await I(o,{literal:c,regex:d,replacement:i(r,"replacement"),dryRun:r.dryRun===!0,author:i(r,"author"),message:i(r,"message"),force:!!r.force},a);s.changed&&!s.dry_run&&await w(a,s),u(s,a),a.profile&&p(`profile:command=history-redact took_ms=${Date.now()-l}`)}),t.command(e?"repair":"history-repair",{hidden:!e}).summary("Repair drift.").argument("[id]","Item id (omit with --all)").option("--salvage-tail","Recover invalid tail; requires verified prefix").option("--all","Scan every stream for drift and repair each drifted stream in one audited pass").option("--dry-run","Preview the re-anchor impact without writing the history file").option("--normalize-provenance","Remove invalid provenance; return aggregate-only evidence").option("--author <value>","Mutation author").option("--message <value>","Audit history message for the repair marker entry").option("--force","Force ownership/lock override").description("Re-anchor a drifted item history chain (recompute hashes, reconcile with the on-disk item) and record an audit marker. Use --all to repair every drifted stream.").action(async(o,r,n)=>{let a=y(n),l=Date.now(),c=r.all===!0;v(o,c);let d={dryRun:r.dryRun===!0,author:i(r,"author"),message:i(r,"message"),force:!!r.force,normalizeProvenance:r.normalizeProvenance===!0,salvageTail:r.salvageTail===!0};if(c){let s=await R(d,a);u(s,a),s.totals.failed>0&&(process.exitCode=m.GENERIC_FAILURE)}else{let s=await b(o,d,a);u(s,a)}a.profile&&p(`profile:command=history-repair took_ms=${Date.now()-l}`)}),t.command(e?"compact":"history-compact",{hidden:!e}).summary("Compact streams.").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 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").option("--min-entries <n>","Bulk: skip streams with at most N entries (already compact; default 3)").option("--dry-run","Preview compaction impact without writing the history file").option("--author <value>","Mutation author").option("--message <value>","Audit history message for the compaction marker entry").option("--force","Force ownership/lock override").description("Compact item history streams into a synthetic baseline plus retained tail entries. Pass an item id for one stream, or a bulk selector (--ids/--all-over/--closed/--all-streams) to compact many.").action(T)}export{Q as a};
-//# sourceMappingURL=chunk-4VL5P22L.js.map