@unbrained/pm-cli 2026.9.4 → 2026.9.5

package/docs/generated/FLAG_LEXICON_BUDGETS.md

@@ -5,7 +5,7 @@ This file is generated by `listPmFlagLexicon()`. Compatibility aliases do not co
 | Command | Capability family | Canonical flags | Maximum |
 | --- | --- | ---: | ---: |
 | `init` | workspace | 30 | 30 |
-| `config` | workspace | 35 | 35 |
+| `config` | workspace | 36 | 36 |
 | `extension` | extensions | 53 | 53 |
 | `package` | extensions | 54 | 54 |
 | `packages` | extensions | 54 | 54 |
@@ -15,7 +15,7 @@ This file is generated by `listPmFlagLexicon()`. Compatibility aliases do not co
 | `copy` | intake | 24 | 24 |
 | `focus` | intake | 22 | 22 |
 | `list` | context | 86 | 86 |
-| `list-all` | context | 85 | 85 |
+| `list-all` | context | 86 | 86 |
 | `list-draft` | context | 84 | 84 |
 | `list-open` | context | 84 | 84 |
 | `list-in-progress` | context | 84 | 84 |
@@ -30,32 +30,32 @@ This file is generated by `listPmFlagLexicon()`. Compatibility aliases do not co
 | `search` | context | 78 | 78 |
 | `duplicates` | context | 24 | 24 |
 | `eval` | context | 25 | 25 |
-| `next` | context | 35 | 35 |
+| `next` | context | 38 | 38 |
 | `history` | evidence | 35 | 35 |
 | `events` | evidence | 33 | 33 |
 | `history-redact` | evidence | 27 | 27 |
-| `history-repair` | evidence | 26 | 26 |
+| `history-repair` | evidence | 27 | 27 |
 | `history-compact` | evidence | 30 | 30 |
 | `history-author-acknowledge` | evidence | 28 | 28 |
-| `merge` | workspace | 24 | 24 |
+| `merge` | workspace | 27 | 27 |
 | `schema` | workspace | 40 | 40 |
 | `profile` | workspace | 22 | 22 |
 | `activity` | context | 35 | 35 |
 | `restore` | intake | 23 | 23 |
 | `update` | lifecycle | 105 | 105 |
-| `update-many` | lifecycle | 140 | 140 |
+| `update-many` | lifecycle | 146 | 146 |
 | `close` | lifecycle | 31 | 31 |
 | `close-many` | lifecycle | 72 | 72 |
 | `delete` | lifecycle | 24 | 24 |
-| `append` | evidence | 24 | 24 |
+| `append` | evidence | 25 | 25 |
 | `comments` | evidence | 31 | 31 |
 | `notes` | evidence | 35 | 35 |
-| `learnings` | evidence | 27 | 27 |
+| `learnings` | evidence | 31 | 31 |
 | `files` | evidence | 39 | 39 |
 | `docs` | evidence | 30 | 30 |
 | `deps` | graph | 32 | 32 |
 | `plan` | graph | 109 | 109 |
-| `test` | quality | 52 | 52 |
+| `test` | quality | 53 | 53 |
 | `test-all` | quality | 40 | 40 |
 | `telemetry` | workspace | 21 | 21 |
 | `stats` | context | 29 | 29 |
@@ -65,7 +65,7 @@ This file is generated by `listPmFlagLexicon()`. Compatibility aliases do not co
 | `gc` | workspace | 22 | 22 |
 | `workspace` | workspace | 23 | 23 |
 | `contracts` | quality | 29 | 29 |
-| `claim` | lifecycle | 36 | 36 |
+| `claim` | lifecycle | 38 | 38 |
 | `release` | lifecycle | 23 | 23 |
 | `start-task` | lifecycle | 23 | 23 |
 | `pause-task` | lifecycle | 23 | 23 |

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: 357
+- Catalog error codes: 365
 - 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: 338
-- Coverage fraction: 0.053221
+- Uncovered error codes: 346
+- Coverage fraction: 0.052055
 - Closed-domain probes: 19
 - Grammar probes: 94
 
@@ -111,17 +111,23 @@ Every catalog code is listed. An `uncovered` row is an explicit closure obligati
 | `history_author_acknowledge_selector_required` | `history_author_acknowledge_selector_required` | uncovered | none | 0 |
 | `history_author_acknowledge_target_not_actionable` | `history_author_acknowledge_target_not_actionable` | uncovered | none | 0 |
 | `history_author_acknowledge_target_unreadable` | `history_author_acknowledge_target_unreadable` | uncovered | none | 0 |
+| `history_baseline_unavailable` | `history_baseline_unavailable` | uncovered | none | 0 |
 | `history_drift_chain_mismatch` | `history_drift_chain_mismatch` | uncovered | none | 0 |
 | `history_drift_hash_mismatch` | `history_drift_hash_mismatch` | uncovered | none | 0 |
 | `history_drift_merge_receipt` | `history_drift_merge_receipt` | uncovered | none | 0 |
 | `history_drift_missing_stream` | `history_drift_missing_stream` | uncovered | none | 0 |
 | `history_drift_unreadable_stream` | `history_drift_unreadable_stream` | uncovered | none | 0 |
 | `history_drift_version_skew` | `history_drift_version_skew` | uncovered | none | 0 |
+| `history_json_invalid` | `history_json_invalid` | uncovered | none | 0 |
 | `history_merge_conflict_markers_detected` | `merge_conflict_markers_detected` | uncovered | none | 0 |
+| `history_replay_invalid` | `history_replay_invalid` | uncovered | none | 0 |
+| `history_salvage_refused` | `history_salvage_refused` | uncovered | none | 0 |
 | `history_stream_over_compact_threshold` | `history_stream_over_compact_threshold` | uncovered | none | 0 |
 | `history_target_out_of_range` | `history_target_out_of_range` | uncovered | none | 0 |
 | `history_timestamp_invalid` | `history_timestamp_invalid` | uncovered | none | 0 |
 | `history_unknown_author_events` | `history_unknown_author_events` | uncovered | none | 0 |
+| `history_version_mapping_unavailable` | `history_version_mapping_unavailable` | uncovered | none | 0 |
+| `history_version_pruned` | `history_version_pruned` | uncovered | none | 0 |
 | `host_environment_capacity_fault` | `host_environment_capacity_fault` | uncovered | none | 0 |
 | `host_environment_operation_invalid` | `host_environment_operation_invalid` | uncovered | none | 0 |
 | `host_environment_permission_fault` | `host_environment_permission_fault` | uncovered | none | 0 |
@@ -163,9 +169,11 @@ Every catalog code is listed. An `uncovered` row is an explicit closure obligati
 | `invalid_reproducible_process_environment` | `invalid_reproducible_process_environment` | uncovered | none | 0 |
 | `invalid_workspace_snapshot_target` | `invalid_workspace_snapshot_target` | uncovered | none | 0 |
 | `item_already_active` | `item_already_active` | uncovered | none | 0 |
+| `item_document_encoding_invalid` | `item_document_encoding_invalid` | uncovered | none | 0 |
 | `item_document_invalid` | `item_document_invalid` | uncovered | none | 0 |
 | `item_document_roundtrip_failed` | `item_document_roundtrip_failed` | uncovered | none | 0 |
 | `item_id_collision` | `item_id_collision` | uncovered | none | 0 |
+| `item_identity_reserved` | `item_identity_reserved` | uncovered | none | 0 |
 | `item_not_found` | `item_not_found` | uncovered | none | 0 |
 | `likely_duplicate` | `likely_duplicate` | uncovered | none | 0 |
 | `linked_artifact_mutation_conflict` | `linked_artifact_mutation_conflict` | uncovered | none | 0 |

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-cli",
-  "version": "2026.9.4",
+  "version": "2026.9.5",
   "description": "Git-native project management CLI for humans and agents.",
   "type": "module",
   "packageManager": "pnpm@11.10.0",
@@ -76,7 +76,7 @@
       "import": "./dist/cli-bundle/sdk-testing.js",
       "default": "./dist/cli-bundle/sdk-testing.js"
     },
-    "./sdk/public-surface.json": "./sdk/public-surface.json",
+    "./sdk/public-surface.json": "./dist/sdk/public-surface.json",
     "./cli": {
       "types": "./dist/cli/public.d.ts",
       "import": "./dist/cli/public.js",
@@ -95,7 +95,6 @@
     "LICENSE",
     "AGENTS.md",
     "docs/**",
-    "sdk/public-surface.json",
     ".claude-plugin/**",
     "plugins/**",
     "packages/pm-*/**",
@@ -229,8 +228,8 @@
     "eslint-plugin-sonarjs": "^4.2.0",
     "eslint-plugin-unicorn": "74.0.0",
     "fast-check": "^4.9.0",
-    "greptile": "^3.4.2",
-    "jscpd": "^5.1.1",
+    "greptile": "^3.5.0",
+    "jscpd": "^5.1.2",
     "tsx": "^4.23.13",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.69.0",

package/packages/pm-beads/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-beads",
-  "version": "2026.9.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "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.4",
+  "version": "2026.9.5",
   "author": {
     "name": "unbrained",
     "url": "https://github.com/unbraind/pm-cli"

package/plugins/pm-claude/skills/pm-audit/SKILL.md

@@ -94,8 +94,8 @@ Load the smallest thing that answers the question. Costs are measured.
 | The whole command surface with per-command ceilings | `pm_contracts` with `summary: true` | ~2.6k tok |
 | An unfamiliar capability family | `pm_run` with `action: "guide", topic: "<topic>", depth: "brief"` | ~0.6-1k tok |
 
-Guide topics: `quickstart`, `commands`, `workflows`, `sdk`, `extensions`,
-`skills`, `harnesses`, `release`, `tokens`, `graph`, `assurance`, `merge`.
+Guide topics are declared at runtime: `pm guide` prints the current index and
+`pm guide <topic> --depth brief` expands one topic. Do not copy the list.
 
 Never load `docs/COMMANDS.md` (~29k tok) or `docs/SDK.md` (~45k tok) whole.
 

package/plugins/pm-claude/skills/pm-developer/SKILL.md

@@ -133,8 +133,8 @@ Load the smallest thing that answers the question. Costs are measured.
 | The whole command surface with per-command ceilings | `pm_contracts` with `summary: true` | ~2.6k tok |
 | An unfamiliar capability family | `pm_run` with `action: "guide", topic: "<topic>", depth: "brief"` | ~0.6-1k tok |
 
-Guide topics: `quickstart`, `commands`, `workflows`, `sdk`, `extensions`,
-`skills`, `harnesses`, `release`, `tokens`, `graph`, `assurance`, `merge`.
+Guide topics are declared at runtime: `pm guide` prints the current index and
+`pm guide <topic> --depth brief` expands one topic. Do not copy the list.
 
 Never load `docs/COMMANDS.md` (~29k tok) or `docs/SDK.md` (~45k tok) whole.
 

package/plugins/pm-claude/skills/pm-planner/SKILL.md

@@ -157,8 +157,8 @@ Load the smallest thing that answers the question. Costs are measured.
 | The whole command surface with per-command ceilings | `pm_contracts` with `summary: true` | ~2.6k tok |
 | An unfamiliar capability family | `pm_run` with `action: "guide", topic: "<topic>", depth: "brief"` | ~0.6-1k tok |
 
-Guide topics: `quickstart`, `commands`, `workflows`, `sdk`, `extensions`,
-`skills`, `harnesses`, `release`, `tokens`, `graph`, `assurance`, `merge`.
+Guide topics are declared at runtime: `pm guide` prints the current index and
+`pm guide <topic> --depth brief` expands one topic. Do not copy the list.
 
 Never load `docs/COMMANDS.md` (~29k tok) or `docs/SDK.md` (~45k tok) whole.
 

package/plugins/pm-claude/skills/pm-release/SKILL.md

@@ -92,8 +92,8 @@ Load the smallest thing that answers the question. Costs are measured.
 | The whole command surface with per-command ceilings | `pm_contracts` with `summary: true` | ~2.6k tok |
 | An unfamiliar capability family | `pm_run` with `action: "guide", topic: "<topic>", depth: "brief"` | ~0.6-1k tok |
 
-Guide topics: `quickstart`, `commands`, `workflows`, `sdk`, `extensions`,
-`skills`, `harnesses`, `release`, `tokens`, `graph`, `assurance`, `merge`.
+Guide topics are declared at runtime: `pm guide` prints the current index and
+`pm guide <topic> --depth brief` expands one topic. Do not copy the list.
 
 Never load `docs/COMMANDS.md` (~29k tok) or `docs/SDK.md` (~45k tok) whole.
 

package/plugins/pm-claude/skills/pm-workflow/SKILL.md

@@ -15,7 +15,7 @@ Use this skill for all pm-tracked work. Prefer native MCP tools over shell `pm`
 |---------|------|
 | Orient / read state | `pm_context`, `pm_search`, `pm_list`, `pm_get` |
 | Create / update | `pm_create`, `pm_update`, `pm_claim`, `pm_release`, `pm_close` |
-| Evidence | `pm_comments`, `pm_files`, `pm_docs`, `pm_test` |
+| Evidence | `pm_comments`, `pm_notes`, `pm_learnings`, `pm_files`, `pm_docs`, `pm_test` |
 | Verify | `pm_validate`, `pm_health`, `pm_contracts` |
 | Everything else | `pm_run` with an explicit `action` |
 
@@ -154,8 +154,8 @@ Load the smallest thing that answers the question. Costs are measured.
 | The whole command surface with per-command ceilings | `pm_contracts` with `summary: true` | ~2.6k tok |
 | An unfamiliar capability family | `pm_run` with `action: "guide", topic: "<topic>", depth: "brief"` | ~0.6-1k tok |
 
-Guide topics: `quickstart`, `commands`, `workflows`, `sdk`, `extensions`,
-`skills`, `harnesses`, `release`, `tokens`, `graph`, `assurance`, `merge`.
+Guide topics are declared at runtime: `pm guide` prints the current index and
+`pm guide <topic> --depth brief` expands one topic. Do not copy the list.
 
 Never load `docs/COMMANDS.md` (~29k tok) or `docs/SDK.md` (~45k tok) whole.
 

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

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

package/plugins/pm-codex/skills/pm-auditor/SKILL.md

@@ -30,8 +30,8 @@ Load the smallest thing that answers the question. Costs are measured.
 | The whole command surface with per-command ceilings | `pm_contracts` with `summary: true` | ~2.6k tok |
 | An unfamiliar capability family | `pm_run` with `action: "guide", topic: "<topic>", depth: "brief"` | ~0.6-1k tok |
 
-Guide topics: `quickstart`, `commands`, `workflows`, `sdk`, `extensions`,
-`skills`, `harnesses`, `release`, `tokens`, `graph`, `assurance`, `merge`.
+Guide topics are declared at runtime: `pm guide` prints the current index and
+`pm guide <topic> --depth brief` expands one topic. Do not copy the list.
 
 Never load `docs/COMMANDS.md` (~29k tok) or `docs/SDK.md` (~45k tok) whole.
 

package/plugins/pm-codex/skills/pm-native/SKILL.md

@@ -14,7 +14,7 @@ Use MCP tools before shell commands:
 
 - Orient: `pm_context`, `pm_search`, `pm_list`, `pm_get`
 - Mutate: `pm_create`, `pm_update`, `pm_claim`, `pm_release`, `pm_close`
-- Evidence: `pm_comments`, `pm_files`, `pm_docs`, `pm_test`
+- Evidence: `pm_comments`, `pm_notes`, `pm_learnings`, `pm_files`, `pm_docs`, `pm_test`
 - Verify: `pm_validate`, `pm_health`, `pm_contracts`
 - Everything else: `pm_run` with an explicit `action`
 
@@ -37,7 +37,6 @@ Most tools accept:
 ```json
 {
   "cwd": "/repo/root",
-  "author": "codex-agent",
   "options": {
     "limit": "10"
   }
@@ -79,8 +78,8 @@ Load the smallest thing that answers the question. Costs are measured.
 | The whole command surface with per-command ceilings | `pm_contracts` with `summary: true` | ~2.6k tok |
 | An unfamiliar capability family | `pm_run` with `action: "guide", topic: "<topic>", depth: "brief"` | ~0.6-1k tok |
 
-Guide topics: `quickstart`, `commands`, `workflows`, `sdk`, `extensions`,
-`skills`, `harnesses`, `release`, `tokens`, `graph`, `assurance`, `merge`.
+Guide topics are declared at runtime: `pm guide` prints the current index and
+`pm guide <topic> --depth brief` expands one topic. Do not copy the list.
 
 Never load `docs/COMMANDS.md` (~29k tok) or `docs/SDK.md` (~45k tok) whole.
 

package/plugins/pm-codex/skills/pm-release/SKILL.md

@@ -29,8 +29,8 @@ Load the smallest thing that answers the question. Costs are measured.
 | The whole command surface with per-command ceilings | `pm_contracts` with `summary: true` | ~2.6k tok |
 | An unfamiliar capability family | `pm_run` with `action: "guide", topic: "<topic>", depth: "brief"` | ~0.6-1k tok |
 
-Guide topics: `quickstart`, `commands`, `workflows`, `sdk`, `extensions`,
-`skills`, `harnesses`, `release`, `tokens`, `graph`, `assurance`, `merge`.
+Guide topics are declared at runtime: `pm guide` prints the current index and
+`pm guide <topic> --depth brief` expands one topic. Do not copy the list.
 
 Never load `docs/COMMANDS.md` (~29k tok) or `docs/SDK.md` (~45k tok) whole.
 

package/scripts/finalize-build.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-import { chmod, stat } from "node:fs/promises";
+import { chmod, readFile, stat, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 
@@ -16,6 +16,7 @@ async function outputExists(filePath) {
   }
 }
 
+/** Finalize executable modes and the semantically identical compact public SDK manifest. */
 export async function main(repoRoot = process.cwd()) {
   const executableOutputs = [
     path.join(repoRoot, "dist", "cli.js"),
@@ -28,6 +29,17 @@ export async function main(repoRoot = process.cwd()) {
       await chmod(outputPath, 0o755);
     }
   }
+
+  // Keep the checked-in compatibility manifest readable, while distributing
+  // identical JSON data without indentation through its stable public export.
+  const manifest = JSON.parse(
+    await readFile(path.join(repoRoot, "sdk", "public-surface.json"), "utf8"),
+  );
+  await writeFile(
+    path.join(repoRoot, "dist", "sdk", "public-surface.json"),
+    `${JSON.stringify(manifest)}\n`,
+    "utf8",
+  );
 }
 
 /* c8 ignore start -- CLI auto-run guard; logic covered via exported main() */