@unbrained/pm-cli 2026.9.3 → 2026.9.4

package/docs/examples/sdk-agent-environment/run-agent-environment.mjs

@@ -0,0 +1,154 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import {
+  PM_EPISODE_SCHEMA,
+  PM_OBSERVATION_SCHEMA,
+  PM_VERDICT_SCHEMA,
+  PM_WORKSPACE_RECIPE_SCHEMA,
+  PmClient,
+  defineEpisodeSpecification,
+  openPmEpisode,
+  runWithWorkspaceRecipe,
+} from "@unbrained/pm-cli/sdk";
+
+class PublicSdkAdapter {
+  constructor(workspace) {
+    this.client = new PmClient({ cwd: workspace, noExtensions: true });
+    this.itemId = "";
+    this.revision = 0;
+  }
+
+  async reset(recipe) {
+    const created = await runWithWorkspaceRecipe(recipe, async () => {
+      await this.client.init("environment");
+      return this.client.create({
+        id: "pm-created-by-adapter",
+        title: "Complete the SDK environment task",
+        type: "Task",
+        status: "open",
+        description: "Created inside a deterministic public-SDK episode.",
+      });
+    });
+    this.itemId = created.item.id;
+    this.revision = 0;
+    return { workspace_id: "temporary-pm-workspace", state_id: "revision:0" };
+  }
+
+  async execute(_action) {
+    const result = await this.client.close(
+      this.itemId,
+      "Public SDK episode completed",
+      {
+        resolution: "The ordinary PmClient close action recorded completion.",
+        expected: "The task is closed through the public SDK.",
+        actual: "The task is closed through the public SDK.",
+        validateClose: "warn",
+      },
+    );
+    this.revision += 1;
+    return { state_id: `revision:${this.revision}`, output: result };
+  }
+
+  async readRecordedState() {
+    const result = await this.client.get(this.itemId);
+    return {
+      snapshot_id: `revision:${this.revision}`,
+      state: {
+        item: {
+          id: result.item.id,
+          title: result.item.title,
+          status: result.item.status,
+          resolution: result.item.resolution,
+        },
+      },
+    };
+  }
+}
+
+const observation = {
+  schema: PM_OBSERVATION_SCHEMA,
+  id: "sdk-task-state",
+  version: 1,
+  reads: [{ command: "get", budget_tokens: 256 }],
+  calibration: {
+    basis: "emitted_bytes",
+    samples: [96, 128, 160],
+    expected_emitted_bytes: 128,
+    tolerance_bytes: 32,
+  },
+  corpus_dependence: { kind: "independent" },
+  tiers: [
+    {
+      id: "standard",
+      max_tokens: 256,
+      fields: ["item.id", "item.title", "item.status", "item.resolution"],
+    },
+    { id: "identity", max_tokens: 48, fields: ["item.id", "item.status"] },
+  ],
+};
+
+const verdict = {
+  schema: PM_VERDICT_SCHEMA,
+  id: "sdk-task-closed",
+  version: 1,
+  predicates: [
+    {
+      id: "closed",
+      kind: "field_equals",
+      path: "item.status",
+      expected: "closed",
+    },
+    { id: "explained", kind: "field_present", path: "item.resolution" },
+  ],
+  composition: { operator: "all", predicate_ids: ["closed", "explained"] },
+};
+
+const workspace = await mkdtemp(join(tmpdir(), "pm-sdk-environment-"));
+try {
+  const session = await openPmEpisode(
+    defineEpisodeSpecification({
+      schema: PM_EPISODE_SCHEMA,
+      id: "public-sdk-environment",
+      version: 1,
+      mode: "evaluation",
+      recipe: {
+        schema: PM_WORKSPACE_RECIPE_SCHEMA,
+        seed: "public-sdk-environment",
+        clock: "2026-09-03T00:00:00.000Z",
+        tickMs: 1,
+        operations: [],
+      },
+      task_item_ids: ["pm-created-by-adapter"],
+      observable_fields: [
+        "item.id",
+        "item.title",
+        "item.status",
+        "item.resolution",
+      ],
+      withheld_fields: ["grading.expected_status"],
+      observation,
+      verdict,
+      limits: {
+        max_actions: 1,
+        max_observations: 2,
+        max_tokens_per_observation: 256,
+      },
+    }),
+    new PublicSdkAdapter(workspace),
+  );
+  const initial = await session.observe();
+  await session.step({ kind: "close" });
+  const completed = await session.close();
+  process.stdout.write(
+    `${JSON.stringify({
+      initial_status: initial.status,
+      initial_tier: initial.receipt.served_tier,
+      verdict: completed.verdict.outcome,
+      policy: completed.verdict.policy,
+      trajectory: completed.trajectory.map((entry) => entry.kind),
+    })}\n`,
+  );
+} finally {
+  await rm(workspace, { recursive: true, force: true });
+}

package/docs/generated/REFUSAL_CLOSURE_CENSUS.md

@@ -4,12 +4,12 @@ Tracker: `pm-f05lsg`.
 
 Every catalog code is listed. An `uncovered` row is an explicit closure obligation, never an omission or implied approval.
 
-- Catalog error codes: 356
+- Catalog error codes: 357
 - Executable error codes: 19
 - Executable-code ratchet floor: 18
 - Required executable canonical codes: `bulk_ids_input_empty`, `bulk_ids_input_missing_path`, `bulk_ids_input_unreadable`, `invalid_argument_value`, `manifest_unknown_key`, `missing_lifecycle_target`, `missing_required_argument`, `no_version_bounds_declared`, `projection_options_mutually_exclusive`, `tracker_not_initialized`, `tracker_root_missing`, `tracker_root_not_directory`, `tracker_root_unreadable`, `unknown_context_intent`, `unknown_field_projection`, `unknown_option`, `unknown_subcommand`
-- Uncovered error codes: 337
-- Coverage fraction: 0.053371
+- Uncovered error codes: 338
+- Coverage fraction: 0.053221
 - Closed-domain probes: 19
 - Grammar probes: 94
 
@@ -233,6 +233,7 @@ Every catalog code is listed. An `uncovered` row is an explicit closure obligati
 | `profile_name_not_normalized` | `profile_name_not_normalized` | uncovered | none | 0 |
 | `profile_summary_empty` | `profile_summary_empty` | uncovered | none | 0 |
 | `profile_title_empty` | `profile_title_empty` | uncovered | none | 0 |
+| `project_runtime_history_epoch_incompatible` | `project_runtime_history_epoch_incompatible` | uncovered | none | 0 |
 | `project_runtime_stale_mutation` | `project_runtime_stale_mutation` | uncovered | none | 0 |
 | `project_runtime_stale_read` | `project_runtime_stale_read` | uncovered | none | 0 |
 | `projection_options_mutually_exclusive` | `projection_options_mutually_exclusive` | executable | closed_domain | 3 |

package/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.9.3"
+    "version": "2026.9.4"
   },
   "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.9.3",
+      "version": "2026.9.4",
       "author": {
         "name": "unbrained",
         "url": "https://github.com/unbraind/pm-cli"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.9.3",
+  "version": "2026.9.4",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "packageManager": "pnpm@11.10.0",
@@ -221,7 +221,7 @@
     "@eslint/js": "^10.0.1",
     "@modelcontextprotocol/ext-apps": "1.7.5",
     "@sentry/cli": "^3.7.0",
-    "@types/node": "^26.4.0",
+    "@types/node": "^26.4.1",
     "@types/npm-package-arg": "^6.1.4",
     "@vitest/coverage-v8": "^4.1.11",
     "esbuild": "0.28.2",

package/packages/pm-beads/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-beads",
-  "version": "2026.9.3",
+  "version": "2026.9.4",
   "private": true,
   "type": "module",
   "description": "First-party pm package for importing Beads JSONL records.",

package/packages/pm-calendar/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-calendar",
-  "version": "2026.9.3",
+  "version": "2026.9.4",
   "private": true,
   "type": "module",
   "description": "First-party pm package for calendar and agenda views.",

package/packages/pm-command-kit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-command-kit",
-  "version": "2026.9.3",
+  "version": "2026.9.4",
   "private": true,
   "type": "module",
   "description": "First-party pm exemplar package for the commands capability: registerCommand, registerFlags, and registerParser.",

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

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-digital-twin",
-  "version": "2026.9.3",
+  "version": "2026.9.4",
   "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/package.json

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

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

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-guide-shell",
-  "version": "2026.9.3",
+  "version": "2026.9.4",
   "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.3",
+  "version": "2026.9.4",
   "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.3",
+  "version": "2026.9.4",
   "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.3",
+  "version": "2026.9.4",
   "private": true,
   "type": "module",
   "description": "First-party pm package for optional linked-test run management adapters and reporters.",

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

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-search-advanced",
-  "version": "2026.9.3",
+  "version": "2026.9.4",
   "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.3",
+  "version": "2026.9.4",
   "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.3",
+  "version": "2026.9.4",
   "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.3",
+  "version": "2026.9.4",
   "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.3",
+  "version": "2026.9.4",
   "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.3",
+  "version": "2026.9.4",
   "description": "Native Codex integration for pm-cli with bundled MCP tools, skills, commands, and agent workflows.",
   "author": {
     "name": "unbrained",