@unbrained/pm-cli 2026.8.12 → 2026.8.14

package/packages/pm-digital-twin/extensions/digital-twin/index.ts

@@ -697,6 +697,7 @@ export function buildTwinCommands(): CommandDefinition[] {
       action: "twin-entity-create",
       description:
         "Create a stable facility or asset identity and its first immutable state event.",
+      intent: "Create one digital-twin entity with an attributable initial state.",
       arguments: ENTITY_ARGUMENT,
       flags: [
         { long: "--title", value_name: "text", value_type: "string" },
@@ -728,6 +729,7 @@ export function buildTwinCommands(): CommandDefinition[] {
       action: "twin-observe",
       description:
         "Append an attributable observation or correction with optimistic concurrency.",
+      intent: "Append a versioned observation to one digital-twin entity.",
       arguments: ENTITY_ARGUMENT,
       flags: [
         {
@@ -756,6 +758,7 @@ export function buildTwinCommands(): CommandDefinition[] {
       action: "twin-relate",
       description:
         "Append or supersede one typed containment, flow, or utility relationship.",
+      intent: "Record one typed relationship in the digital-twin topology.",
       arguments: ENTITY_ARGUMENT,
       flags: [
         {
@@ -789,6 +792,7 @@ export function buildTwinCommands(): CommandDefinition[] {
       action: "twin-query",
       description:
         "Query point-in-time state, topology, provenance, conflicts, invariants, and impact.",
+      intent: "Inspect one entity's point-in-time state and topology impact.",
       arguments: ENTITY_ARGUMENT,
       flags: [
         { long: "--at", value_name: "iso", value_type: "string" },
@@ -802,6 +806,7 @@ export function buildTwinCommands(): CommandDefinition[] {
       action: "twin-export",
       description:
         "Export a bounded shell-friendly event bundle with a tamper-evident checkpoint.",
+      intent: "Export a bounded portable digital-twin event bundle.",
       flags: [
         { long: "--at", value_name: "iso", value_type: "string" },
         { long: "--limit", value_name: "n", value_type: "number" },
@@ -813,6 +818,7 @@ export function buildTwinCommands(): CommandDefinition[] {
       action: "twin-import",
       description:
         "Validate and idempotently merge a portable offline replica bundle.",
+      intent: "Validate and merge an offline digital-twin replica bundle.",
       flags: [
         {
           long: "--payload",
@@ -828,6 +834,7 @@ export function buildTwinCommands(): CommandDefinition[] {
       action: "twin-verify",
       description:
         "Verify checkpoint integrity, deterministic replay, topology, and invariants.",
+      intent: "Verify digital-twin replay, checkpoint, topology, and invariants.",
       flags: [{ long: "--at", value_name: "iso", value_type: "string" }],
       run: runVerify,
     },

package/packages/pm-digital-twin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-digital-twin",
-  "version": "2026.8.12",
+  "version": "2026.8.14",
   "private": true,
   "type": "module",
   "description": "Beyond-PM exemplar: a temporal production-facility digital twin built entirely on public pm SDK and extension primitives.",

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

@@ -327,6 +327,7 @@ function dedupeAuditCommand(): CommandDefinition {
     action: "dedupe-audit",
     description:
       "Audit likely duplicate items by title and parent scope heuristics.",
+    intent: "Find likely duplicate work without mutating the tracker.",
     flags: [...dedupeAuditFlags],
     run: async (context) =>
       runDedupeAuditPackage(context.options, context.global),
@@ -339,6 +340,7 @@ function dedupeMergeCommand(): CommandDefinition {
     action: "dedupe-merge",
     description:
       "Consolidate duplicates into a canonical item: re-parent active children and close duplicates with duplicate_of.",
+    intent: "Preview or apply an evidence-preserving duplicate consolidation.",
     flags: [...dedupeMergeFlags],
     run: async (context) =>
       runDedupeMergePackage(context.options, context.global),
@@ -350,6 +352,7 @@ function commentsAuditCommand(): CommandDefinition {
     name: "comments-audit",
     action: "comments-audit",
     description: "Audit item comment coverage and export comment history rows.",
+    intent: "Audit comment coverage and read bounded comment-history evidence.",
     flags: [...commentsAuditFlags],
     run: async (context) =>
       runCommentsAuditPackage(context.options, context.global),
@@ -361,6 +364,7 @@ function normalizeCommand(): CommandDefinition {
     name: "normalize",
     action: "normalize",
     description: "Plan/apply lifecycle metadata normalization sweeps.",
+    intent: "Preview or apply deterministic lifecycle metadata normalization.",
     flags: [...normalizeFlags],
     run: async (context) =>
       runNormalizePackage(context.options, context.global),

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

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

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

@@ -94,6 +94,7 @@ function guideCommand(): CommandDefinition {
     name: "guide",
     action: "guide",
     description: "Show migration and usage guidance for pm command families.",
+    intent: "Read focused local guidance for one pm workflow.",
     arguments: [
       { name: "topic", required: false, description: "Optional guide topic." },
     ],
@@ -108,6 +109,7 @@ function completionCommand(): CommandDefinition {
     name: "completion",
     action: "completion",
     description: "Generate shell completion scripts for bash, zsh, and fish.",
+    intent: "Generate a completion script for the selected shell.",
     arguments: [
       {
         name: "shell",
@@ -126,6 +128,7 @@ function completionTagsCommand(): CommandDefinition {
     name: "completion-tags",
     action: "completion-tags",
     description: "Print known tags for completion filters.",
+    intent: "List tag values for lazy shell completion.",
     run: async (context) => runCompletionTagsPackage(context.global),
   };
 }
@@ -135,6 +138,7 @@ function completionStatusesCommand(): CommandDefinition {
     name: "completion-statuses",
     action: "completion-statuses",
     description: "Print runtime status IDs for completion filters.",
+    intent: "List runtime status values for shell completion.",
     run: async (context) => runCompletionStatusesPackage(context.global),
   };
 }
@@ -144,6 +148,7 @@ function completionTypesCommand(): CommandDefinition {
     name: "completion-types",
     action: "completion-types",
     description: "Print runtime item type IDs for completion filters.",
+    intent: "List runtime item types for shell completion.",
     run: async (context) => runCompletionTypesPackage(context.global),
   };
 }

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

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-guide-shell",
-  "version": "2026.8.12",
+  "version": "2026.8.14",
   "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.8.12",
+  "version": "2026.8.14",
   "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.8.12",
+  "version": "2026.8.14",
   "private": true,
   "type": "module",
   "description": "First-party pm package demonstrating safe lifecycle hook registration.",

package/packages/pm-linked-test-adapters/extensions/linked-test-adapters/index.ts

@@ -43,6 +43,7 @@ function testRunsCommand(): CommandDefinition {
     name: "test-runs",
     action: "test-runs-list",
     description: "List background linked-test runs.",
+    intent: "List recent background linked-test executions.",
     flags: [
       {
         long: "--status",
@@ -69,6 +70,7 @@ function testRunsListCommand(): CommandDefinition {
     name: "test-runs list",
     action: "test-runs-list",
     description: "List background linked-test runs.",
+    intent: "List recent background linked-test executions.",
     flags: [
       {
         long: "--status",
@@ -96,6 +98,7 @@ function testRunsStatusCommand(): CommandDefinition {
     action: "test-runs-status",
     description:
       "Show status and health snapshot for a background linked-test run.",
+    intent: "Inspect one background linked-test run's status and health.",
     arguments: [
       { name: "runId", required: true, description: "Background run id." },
     ],
@@ -112,6 +115,7 @@ function testRunsLogsCommand(): CommandDefinition {
     name: "test-runs logs",
     action: "test-runs-logs",
     description: "Show tailed logs for a background linked-test run.",
+    intent: "Read bounded stdout or stderr from one background test run.",
     arguments: [
       { name: "runId", required: true, description: "Background run id." },
     ],
@@ -143,6 +147,7 @@ function testRunsStopCommand(): CommandDefinition {
     name: "test-runs stop",
     action: "test-runs-stop",
     description: "Stop a running background linked-test run.",
+    intent: "Stop one active background linked-test run.",
     arguments: [
       { name: "runId", required: true, description: "Background run id." },
     ],
@@ -168,6 +173,7 @@ function testRunsResumeCommand(): CommandDefinition {
     action: "test-runs-resume",
     description:
       "Resume a terminal background linked-test run by starting a new attempt.",
+    intent: "Start a new attempt from one terminal background test run.",
     arguments: [
       { name: "runId", required: true, description: "Background run id." },
     ],

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

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

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

@@ -161,6 +161,7 @@ function searchAdvancedCommand(): CommandDefinition {
     action: "search-advanced",
     description:
       "Enable optional semantic and hybrid search modes via package runtime.",
+    intent: "Search work with package-provided semantic or hybrid retrieval.",
     arguments: [
       {
         name: "keywords",
@@ -180,6 +181,7 @@ function reindexCommand(): CommandDefinition {
     action: "reindex",
     description:
       "Rebuild search artifacts for keyword, semantic, and hybrid modes.",
+    intent: "Refresh search indexes and optionally evaluate retrieval quality.",
     flags: [...reindexFlags],
     run: async (context) =>
       runAdvancedReindexPackage(context.options, context.global),

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

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

package/packages/pm-templates/extensions/templates/index.ts

@@ -293,6 +293,7 @@ export function activate(api: ExtensionApi): void {
     name: "templates",
     action: "templates-list",
     description: "List saved create templates.",
+    intent: "List reusable item-creation templates.",
     run: async (context) => {
       assertListInvocation(context.args, context.options, "templates");
       return runTemplatesListFromRuntime(context.global);
@@ -302,6 +303,7 @@ export function activate(api: ExtensionApi): void {
     name: "templates list",
     action: "templates-list",
     description: "List saved create templates.",
+    intent: "List reusable item-creation templates.",
     run: async (context) => {
       assertListInvocation(context.args, context.options, "templates list");
       return runTemplatesListFromRuntime(context.global);
@@ -311,6 +313,7 @@ export function activate(api: ExtensionApi): void {
     name: "templates save",
     action: "templates-save",
     description: "Save reusable create template defaults.",
+    intent: "Persist reusable defaults for later item creation.",
     arguments: [
       { name: "name", required: true, description: "Template name." },
     ],
@@ -326,6 +329,7 @@ export function activate(api: ExtensionApi): void {
     name: "templates show",
     action: "templates-show",
     description: "Show a saved create template.",
+    intent: "Inspect the defaults stored in one creation template.",
     arguments: [
       { name: "name", required: true, description: "Template name." },
     ],

package/packages/pm-templates/package.json

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

package/packages/pm-todos/extensions/todos/index.ts

@@ -61,6 +61,7 @@ export function activate(api: ExtensionApi): void {
     {
       action: "todos-import",
       description: "Import Todo markdown files into pm items.",
+      intent: "Import Todo markdown into audited pm items.",
       failure_hints: [
         "This command reads a directory, not a file. Use --folder <path> to point at the Todo markdown directory.",
         "Use the host-global --author <id> flag when an explicit mutation identity override is required.",
@@ -91,6 +92,7 @@ export function activate(api: ExtensionApi): void {
     {
       action: "todos-export",
       description: "Export pm items into Todo markdown files.",
+      intent: "Export pm items as portable Todo markdown files.",
       failure_hints: [
         "This command writes a directory of markdown files. Use --folder <path> to choose the destination directory.",
       ],

package/packages/pm-todos/package.json

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

package/packages/pm-vcs/extensions/vcs/index.ts

@@ -647,6 +647,7 @@ export function buildVcsCommands(): CommandDefinition[] {
       name: `${VCS_COMMAND_NAMESPACE} ref-create`,
       action: "vcs-ref-create",
       description: "Create a VCS ref through the public pm lifecycle SDK.",
+      intent: "Create a version-control ref through SDK lifecycle primitives.",
       arguments: [{ name: "name", required: true, description: "Ref name." }],
       run: runRefCreate,
     },
@@ -654,6 +655,7 @@ export function buildVcsCommands(): CommandDefinition[] {
       name: `${VCS_COMMAND_NAMESPACE} create`,
       action: "vcs-create",
       description: "Create a draft changeset.",
+      intent: "Create a draft changeset against a version-control ref.",
       arguments: [
         { name: "title", required: true, description: "Changeset title." },
       ],
@@ -678,6 +680,7 @@ export function buildVcsCommands(): CommandDefinition[] {
       name: `${VCS_COMMAND_NAMESPACE} propose`,
       action: "vcs-propose",
       description: "Move a draft changeset into review.",
+      intent: "Move a draft changeset into the review lifecycle.",
       arguments: ID_ARGUMENT,
       run: (context) => transitionChangeset(context, "proposed"),
     },
@@ -685,6 +688,7 @@ export function buildVcsCommands(): CommandDefinition[] {
       name: `${VCS_COMMAND_NAMESPACE} merge`,
       action: "vcs-merge",
       description: "Merge a reviewed changeset into a ref.",
+      intent: "Merge one reviewed changeset into its target ref.",
       arguments: ID_ARGUMENT,
       flags: [
         {
@@ -706,6 +710,7 @@ export function buildVcsCommands(): CommandDefinition[] {
       name: `${VCS_COMMAND_NAMESPACE} abandon`,
       action: "vcs-abandon",
       description: "Retire a draft or proposed changeset.",
+      intent: "Retire one unmerged changeset with an audited transition.",
       arguments: ID_ARGUMENT,
       run: (context) => transitionChangeset(context, "abandoned"),
     },
@@ -713,6 +718,7 @@ export function buildVcsCommands(): CommandDefinition[] {
       name: `${VCS_COMMAND_NAMESPACE} show`,
       action: "vcs-show",
       description: "Read current or point-in-time changeset state.",
+      intent: "Inspect current or historical state for one changeset.",
       arguments: ID_ARGUMENT,
       flags: [
         { long: "--at", value_name: "version-or-time", value_type: "string" },
@@ -723,6 +729,7 @@ export function buildVcsCommands(): CommandDefinition[] {
       name: `${VCS_COMMAND_NAMESPACE} log`,
       action: "vcs-log",
       description: "Project the immutable merge relationship stream.",
+      intent: "Read the immutable changeset-to-ref merge projection.",
       run: runVcsLog,
     },
   ];

package/packages/pm-vcs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-vcs-sdk-exemplar",
-  "version": "2026.8.12",
+  "version": "2026.8.14",
   "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.8.12",
+  "version": "2026.8.14",
   "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.8.12",
+  "version": "2026.8.14",
   "description": "Native Codex integration for pm-cli with bundled MCP tools, skills, commands, and agent workflows.",
   "author": {
     "name": "unbrained",

package/scripts/bundle-cli.mjs

@@ -36,9 +36,14 @@ const focusedEntryPoints = {
   "sdk-core": path.join(repoRoot, "dist", "sdk", "core.js"),
   "sdk-governance": path.join(repoRoot, "dist", "sdk", "governance.js"),
   "sdk-graph": path.join(repoRoot, "dist", "sdk", "graph.js"),
-  "sdk-merge": path.join(repoRoot, "dist", "sdk", "merge.js"),
   "sdk-query": path.join(repoRoot, "dist", "sdk", "query.js"),
 };
+// The merge surface is intentionally standalone. Its dependencies overlap with
+// several broader focused entrypoints, so sharing their chunk graph makes a
+// merge-only consumer traverse unrelated focused chunks during module loading.
+const isolatedEntryPoints = {
+  "sdk-merge": path.join(repoRoot, "dist", "sdk", "merge.js"),
+};
 const outputDir = path.join(repoRoot, "dist", "cli-bundle");
 const lockDir = path.join(repoRoot, "dist", ".cli-bundle-build.lock");
 const binPath = path.join(repoRoot, "dist", "cli.js");
@@ -188,12 +193,12 @@ export async function writeBundleManifest(outputs) {
 }
 
 /** Build the shared esbuild settings for one isolated entrypoint graph. */
-function bundleOptions(selectedEntryPoints, chunkNames) {
+function bundleOptions(selectedEntryPoints, chunkNames, splitting = true) {
   return {
     entryPoints: selectedEntryPoints,
     outdir: outputDir,
     bundle: true,
-    splitting: true,
+    splitting,
     format: "esm",
     platform: "node",
     target: ["node22"],
@@ -212,7 +217,7 @@ function bundleOptions(selectedEntryPoints, chunkNames) {
 export async function main() {
   // Do not delete the live bundle before rebuilding. Agents often run docs,
   // dogfood, and build gates concurrently in one checkout; removing this folder
-  // creates a transient broken `dist/cli.js` runtime. Once both new graphs are
+  // creates a transient broken `dist/cli.js` runtime. Once all new graphs are
   // complete under the build lock, obsolete hashed chunks are safe to prune and
   // must not leak into repeated-build package artifacts.
   const releaseBundleBuildLock = await acquireBundleBuildLock();
@@ -223,9 +228,17 @@ export async function main() {
     const focusedBuildResult = await build(
       bundleOptions(focusedEntryPoints, "focused-chunks/[name]-[hash]"),
     );
+    const isolatedBuildResult = await build(
+      bundleOptions(
+        isolatedEntryPoints,
+        "isolated-chunks/[name]-[hash]",
+        false,
+      ),
+    );
     const outputs = {
       ...primaryBuildResult.metafile.outputs,
       ...focusedBuildResult.metafile.outputs,
+      ...isolatedBuildResult.metafile.outputs,
     };
     await removeStaleBundleFiles(outputs);
     await writeBundleManifest(outputs);