@unbrained/pm-cli 2026.9.3 → 2026.9.5

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.3",
+  "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() */