@unbrained/pm-cli 2026.5.11 → 2026.5.12

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

@@ -0,0 +1,131 @@
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import type { CommandDefinition, ExtensionApi } from "../../../../src/core/extensions/loader.js";
+import type { GlobalOptions } from "../../../../src/core/shared/command-types.js";
+import type { BeadsImportOptions, BeadsImportResult } from "./runtime.js";
+
+const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
+
+export const manifest = {
+  name: "builtin-beads-import",
+  version: "0.1.0",
+  entry: "./index.js",
+  priority: 0,
+  capabilities: ["commands", "schema"],
+};
+
+type RuntimeModule = {
+  runBeadsImport?: (options: BeadsImportOptions, global: GlobalOptions) => Promise<BeadsImportResult>;
+};
+
+function asOptionalString(value: unknown): string | undefined {
+  return typeof value === "string" ? value : undefined;
+}
+
+function asBoolean(value: unknown): boolean | undefined {
+  return typeof value === "boolean" ? value : undefined;
+}
+
+function toBeadsImportOptions(options: Record<string, unknown>): BeadsImportOptions {
+  return {
+    file: asOptionalString(options.file),
+    author: asOptionalString(options.author),
+    message: asOptionalString(options.message),
+    preserveSourceIds: asBoolean(options.preserveSourceIds),
+  };
+}
+
+function resolvePackageRootCandidates(): string[] {
+  const candidates: string[] = [];
+  const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
+  if (typeof envRoot === "string" && envRoot.trim().length > 0) {
+    candidates.push(path.resolve(envRoot.trim()));
+  }
+  const argvEntry = typeof process.argv[1] === "string" ? process.argv[1].trim() : "";
+  if (argvEntry.length > 0) {
+    const resolvedEntry = path.resolve(argvEntry);
+    const entryDir = path.dirname(resolvedEntry);
+    candidates.push(path.resolve(entryDir, ".."));
+    candidates.push(path.resolve(entryDir, "../.."));
+    candidates.push(path.resolve(entryDir, "../../.."));
+  }
+  return [...new Set(candidates)];
+}
+
+async function loadRuntimeModule(): Promise<RuntimeModule> {
+  const attempted: string[] = [];
+  for (const packageRoot of resolvePackageRootCandidates()) {
+    const modulePaths = [
+      path.join(packageRoot, ".agents", "pm", "extensions", "beads", "runtime.js"),
+      path.join(packageRoot, "packages", "pm-beads", "extensions", "beads", "runtime.js"),
+    ];
+    for (const modulePath of modulePaths) {
+      attempted.push(modulePath);
+      try {
+        return await import(pathToFileURL(modulePath).href) as RuntimeModule;
+      } catch {
+        // Try the next package-root candidate.
+      }
+    }
+  }
+
+  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+  attempted.push(localRuntimePath);
+  try {
+    return await import(pathToFileURL(localRuntimePath).href) as RuntimeModule;
+  } catch {
+    // Fall through to the diagnostic below.
+  }
+
+  throw new Error(
+    "Unable to resolve packaged beads extension runtime module. " +
+      `Tried: ${attempted.join(", ")}. Ensure the installed extension includes runtime.js or PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
+  );
+}
+
+async function runBeadsImportFromRuntime(options: BeadsImportOptions, global: GlobalOptions): Promise<BeadsImportResult> {
+  const runtime = await loadRuntimeModule();
+  if (typeof runtime.runBeadsImport !== "function") {
+    throw new Error("Bundled beads runtime module is missing runBeadsImport().");
+  }
+  return runtime.runBeadsImport(options, global);
+}
+
+export function activate(api: ExtensionApi): void {
+  api.registerCommand({
+    name: "beads import",
+    description: "Import Beads JSONL records into pm items.",
+    flags: [
+      {
+        long: "--file",
+        value_name: "path",
+        value_type: "string",
+        description: "Path to the Beads JSONL source file.",
+      },
+      {
+        long: "--author",
+        value_name: "author",
+        value_type: "string",
+        description: "Override import mutation author.",
+      },
+      {
+        long: "--message",
+        value_name: "text",
+        value_type: "string",
+        description: "Override import history message.",
+      },
+      {
+        long: "--preserve-source-ids",
+        value_type: "boolean",
+        description: "Preserve source IDs from Beads payload records when possible.",
+      },
+    ],
+    run: async (context) => runBeadsImportFromRuntime(toBeadsImportOptions(context.options), context.global),
+  } satisfies CommandDefinition);
+}
+
+export default {
+  manifest,
+  activate,
+};

package/packages/pm-beads/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@unbrained/pm-package-beads",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "First-party pm package for importing Beads JSONL records.",
+  "keywords": [
+    "pm-package",
+    "project-management",
+    "beads"
+  ],
+  "pm": {
+    "extensions": [
+      "extensions/beads"
+    ]
+  }
+}

package/packages/pm-todos/README.md

@@ -0,0 +1,11 @@
+# pm Todos Package
+
+First-party pm package for Todo markdown import and export.
+
+```bash
+pm install ./packages/pm-todos --project
+pm todos import --folder .pm/todos
+pm todos export --folder .pm/todos
+```
+
+The package exposes the `todos import` and `todos export` extension commands through the `pm.extensions` package manifest. Runtime sources are authored in TypeScript and shipped with JavaScript entry artifacts for Node extension loading.

package/{.agents/pm → packages/pm-todos}/extensions/todos/index.js

@@ -1,7 +1,8 @@
 import path from "node:path";
-import { pathToFileURL } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
 
 export const manifest = {
   name: "builtin-todos-import-export",
@@ -49,17 +50,31 @@ function resolvePackageRootCandidates() {
 async function loadRuntimeModule() {
   const attempted = [];
   for (const packageRoot of resolvePackageRootCandidates()) {
-    const modulePath = path.join(packageRoot, ".agents", "pm", "extensions", "todos", "runtime.js");
-    attempted.push(modulePath);
-    try {
-      return await import(pathToFileURL(modulePath).href);
-    } catch {
-      // Try the next package-root candidate.
+    const modulePaths = [
+      path.join(packageRoot, ".agents", "pm", "extensions", "todos", "runtime.js"),
+      path.join(packageRoot, "packages", "pm-todos", "extensions", "todos", "runtime.js"),
+    ];
+    for (const modulePath of modulePaths) {
+      attempted.push(modulePath);
+      try {
+        return await import(pathToFileURL(modulePath).href);
+      } catch {
+        // Try the next package-root candidate.
+      }
     }
   }
+
+  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+  attempted.push(localRuntimePath);
+  try {
+    return await import(pathToFileURL(localRuntimePath).href);
+  } catch {
+    // Fall through to the diagnostic below.
+  }
+
   throw new Error(
-    "Unable to resolve bundled todos extension runtime module. " +
-      `Tried: ${attempted.join(", ")}. Ensure PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
+    "Unable to resolve packaged todos extension runtime module. " +
+      `Tried: ${attempted.join(", ")}. Ensure the installed extension includes runtime.js or PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
   );
 }
 

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

@@ -0,0 +1,149 @@
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import type { CommandDefinition, ExtensionApi } from "../../../../src/core/extensions/loader.js";
+import type { GlobalOptions } from "../../../../src/core/shared/command-types.js";
+import type { TodosExportOptions, TodosExportResult, TodosImportOptions, TodosImportResult } from "./runtime.js";
+
+const PM_PACKAGE_ROOT_ENV = "PM_CLI_PACKAGE_ROOT";
+const CURRENT_EXTENSION_ROOT = path.dirname(fileURLToPath(import.meta.url));
+
+export const manifest = {
+  name: "builtin-todos-import-export",
+  version: "0.1.0",
+  entry: "./index.js",
+  priority: 0,
+  capabilities: ["commands", "schema"],
+};
+
+type RuntimeModule = {
+  runTodosImport?: (options: TodosImportOptions, global: GlobalOptions) => Promise<TodosImportResult>;
+  runTodosExport?: (options: TodosExportOptions, global: GlobalOptions) => Promise<TodosExportResult>;
+};
+
+function asOptionalString(value: unknown): string | undefined {
+  return typeof value === "string" ? value : undefined;
+}
+
+function toImportOptions(options: Record<string, unknown>): TodosImportOptions {
+  return {
+    folder: asOptionalString(options.folder),
+    author: asOptionalString(options.author),
+    message: asOptionalString(options.message),
+  };
+}
+
+function toExportOptions(options: Record<string, unknown>): TodosExportOptions {
+  return {
+    folder: asOptionalString(options.folder),
+  };
+}
+
+function resolvePackageRootCandidates(): string[] {
+  const candidates: string[] = [];
+  const envRoot = process.env[PM_PACKAGE_ROOT_ENV];
+  if (typeof envRoot === "string" && envRoot.trim().length > 0) {
+    candidates.push(path.resolve(envRoot.trim()));
+  }
+  const argvEntry = typeof process.argv[1] === "string" ? process.argv[1].trim() : "";
+  if (argvEntry.length > 0) {
+    const resolvedEntry = path.resolve(argvEntry);
+    const entryDir = path.dirname(resolvedEntry);
+    candidates.push(path.resolve(entryDir, ".."));
+    candidates.push(path.resolve(entryDir, "../.."));
+    candidates.push(path.resolve(entryDir, "../../.."));
+  }
+  return [...new Set(candidates)];
+}
+
+async function loadRuntimeModule(): Promise<RuntimeModule> {
+  const attempted: string[] = [];
+  for (const packageRoot of resolvePackageRootCandidates()) {
+    const modulePaths = [
+      path.join(packageRoot, ".agents", "pm", "extensions", "todos", "runtime.js"),
+      path.join(packageRoot, "packages", "pm-todos", "extensions", "todos", "runtime.js"),
+    ];
+    for (const modulePath of modulePaths) {
+      attempted.push(modulePath);
+      try {
+        return await import(pathToFileURL(modulePath).href) as RuntimeModule;
+      } catch {
+        // Try the next package-root candidate.
+      }
+    }
+  }
+
+  const localRuntimePath = path.join(CURRENT_EXTENSION_ROOT, "runtime.js");
+  attempted.push(localRuntimePath);
+  try {
+    return await import(pathToFileURL(localRuntimePath).href) as RuntimeModule;
+  } catch {
+    // Fall through to the diagnostic below.
+  }
+
+  throw new Error(
+    "Unable to resolve packaged todos extension runtime module. " +
+      `Tried: ${attempted.join(", ")}. Ensure the installed extension includes runtime.js or PM_CLI_PACKAGE_ROOT points to an installed pm package root.`,
+  );
+}
+
+async function runTodosImportFromRuntime(options: TodosImportOptions, global: GlobalOptions): Promise<TodosImportResult> {
+  const runtime = await loadRuntimeModule();
+  if (typeof runtime.runTodosImport !== "function") {
+    throw new Error("Bundled todos runtime module is missing runTodosImport().");
+  }
+  return runtime.runTodosImport(options, global);
+}
+
+async function runTodosExportFromRuntime(options: TodosExportOptions, global: GlobalOptions): Promise<TodosExportResult> {
+  const runtime = await loadRuntimeModule();
+  if (typeof runtime.runTodosExport !== "function") {
+    throw new Error("Bundled todos runtime module is missing runTodosExport().");
+  }
+  return runtime.runTodosExport(options, global);
+}
+
+export function activate(api: ExtensionApi): void {
+  api.registerCommand({
+    name: "todos import",
+    description: "Import Todo markdown files into pm items.",
+    flags: [
+      {
+        long: "--folder",
+        value_name: "path",
+        value_type: "string",
+        description: "Source folder containing Todo markdown files.",
+      },
+      {
+        long: "--author",
+        value_name: "author",
+        value_type: "string",
+        description: "Override import mutation author.",
+      },
+      {
+        long: "--message",
+        value_name: "text",
+        value_type: "string",
+        description: "Override import history message.",
+      },
+    ],
+    run: async (context) => runTodosImportFromRuntime(toImportOptions(context.options), context.global),
+  } satisfies CommandDefinition);
+  api.registerCommand({
+    name: "todos export",
+    description: "Export pm items into Todo markdown files.",
+    flags: [
+      {
+        long: "--folder",
+        value_name: "path",
+        value_type: "string",
+        description: "Destination folder for exported Todo markdown files.",
+      },
+    ],
+    run: async (context) => runTodosExportFromRuntime(toExportOptions(context.options), context.global),
+  } satisfies CommandDefinition);
+}
+
+export default {
+  manifest,
+  activate,
+};

package/{.agents/pm → packages/pm-todos}/extensions/todos/runtime.js

@@ -16,7 +16,7 @@ import { listAllFrontMatter, locateItem, readLocatedItem } from "../../../../dis
 import { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from "../../../../dist/core/store/paths.js";
 import { readSettings } from "../../../../dist/core/store/settings.js";
 import { CONFIDENCE_TEXT_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES } from "../../../../dist/types/index.js";
-const DEFAULT_TODOS_FOLDER = ".pi/todos";
+const DEFAULT_TODOS_FOLDER = ".pm/todos";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }

package/{.agents/pm → packages/pm-todos}/extensions/todos/runtime.ts

@@ -20,7 +20,7 @@ import { readSettings } from "../../../../src/core/store/settings.js";
 import { CONFIDENCE_TEXT_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES } from "../../../../src/types/index.js";
 import type { ItemDocument, ItemMetadata, ItemStatus, ItemType, PmSettings } from "../../../../src/types/index.js";
 
-const DEFAULT_TODOS_FOLDER = ".pi/todos";
+const DEFAULT_TODOS_FOLDER = ".pm/todos";
 
 export interface TodosImportOptions {
   folder?: string;

package/packages/pm-todos/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@unbrained/pm-package-todos",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "First-party pm package for Todo markdown import and export.",
+  "keywords": [
+    "pm-package",
+    "project-management",
+    "todos"
+  ],
+  "pm": {
+    "extensions": [
+      "extensions/todos"
+    ]
+  }
+}

package/plugins/pm-cli-claude/README.md

@@ -191,8 +191,7 @@ All skills and commands implement this pattern for every claimed item:
 ## Session Context Injection
 
 At session start, the hook runs natively (no `pm` CLI required):
-- Walks up directories to find `dist/pi/native.js` in the repo checkout
-- Falls back to `npx @unbrained/pm-cli` if no local dist is found
+- Uses `npx @unbrained/pm-cli` without requiring a global install
 - Injects a compact summary of in-progress/open/blocked items
 
 Example output:

package/plugins/pm-cli-claude/hooks/session-start.mjs

@@ -3,14 +3,11 @@
  * pm-cli Claude Code session-start hook.
  *
  * Injects a brief pm context summary into the session when pm is initialized
- * in the current workspace. Uses native pm modules when available (repo checkout
- * or dist/); falls back to npx @unbrained/pm-cli without requiring the CLI to
- * be installed globally. Exits silently if pm is not set up.
+ * in the current workspace. Uses the published pm CLI through npx without
+ * requiring a global install. Exits silently if pm is not set up.
  */
-import { access } from "node:fs/promises";
 import { existsSync } from "node:fs";
-import { join, resolve, dirname } from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
+import { join } from "node:path";
 import { execSync } from "node:child_process";
 
 const workspace = process.cwd();
@@ -20,31 +17,6 @@ if (!existsSync(pmSettingsPath)) {
   process.exit(0);
 }
 
-const here = dirname(fileURLToPath(import.meta.url));
-
-async function pathExists(target) {
-  try {
-    await access(target);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-async function findNativeModule() {
-  let cursor = here;
-  for (let depth = 0; depth < 10; depth += 1) {
-    const candidate = join(cursor, "dist", "pi", "native.js");
-    if (await pathExists(candidate)) {
-      return candidate;
-    }
-    const parent = dirname(cursor);
-    if (parent === cursor) break;
-    cursor = parent;
-  }
-  return null;
-}
-
 function formatSummary(ctx) {
   const { summary } = ctx;
   if (!summary) return null;
@@ -68,29 +40,6 @@ function formatSummary(ctx) {
   );
 }
 
-async function tryNativeContext() {
-  const nativePath = await findNativeModule();
-  if (!nativePath) return null;
-
-  try {
-    const { runNativePmAction } = await import(pathToFileURL(nativePath).href);
-    const result = await runNativePmAction({
-      action: "context",
-      cwd: workspace,
-      json: true,
-      options: { limit: "5" },
-    });
-    const text = Array.isArray(result?.content)
-      ? result.content.find((p) => p?.type === "text")?.text ?? ""
-      : typeof result === "string"
-        ? result
-        : JSON.stringify(result);
-    return JSON.parse(text);
-  } catch {
-    return null;
-  }
-}
-
 function tryNpxContext() {
   try {
     const raw = execSync(
@@ -109,7 +58,7 @@ function tryNpxContext() {
 }
 
 try {
-  const ctx = (await tryNativeContext()) ?? tryNpxContext();
+  const ctx = tryNpxContext();
   if (!ctx) process.exit(0);
 
   const message = formatSummary(ctx);

package/.agents/pm/extensions/.managed-extensions.json

@@ -1,42 +0,0 @@
-{
-  "version": 1,
-  "updated_at": "2026-04-25T17:01:49.273Z",
-  "entries": [
-    {
-      "name": "builtin-beads-import",
-      "directory": "beads",
-      "scope": "project",
-      "manifest_version": "0.1.0",
-      "manifest_entry": "./index.js",
-      "capabilities": [
-        "commands",
-        "schema"
-      ],
-      "installed_at": "2026-04-25T17:01:49.268Z",
-      "updated_at": "2026-04-25T17:01:49.268Z",
-      "source": {
-        "kind": "local",
-        "input": "builtin-beads-import",
-        "location": ".agents/pm/extensions/beads"
-      }
-    },
-    {
-      "name": "builtin-todos-import-export",
-      "directory": "todos",
-      "scope": "project",
-      "manifest_version": "0.1.0",
-      "manifest_entry": "./index.js",
-      "capabilities": [
-        "commands",
-        "schema"
-      ],
-      "installed_at": "2026-04-25T17:01:49.268Z",
-      "updated_at": "2026-04-25T17:01:49.268Z",
-      "source": {
-        "kind": "local",
-        "input": "builtin-todos-import-export",
-        "location": ".agents/pm/extensions/todos"
-      }
-    }
-  ]
-}

package/.agents/skills/HARNESS_COMPATIBILITY.md

@@ -1,45 +0,0 @@
-# Harness Compatibility
-
-This repository supports the following harnesses through shared docs and `.agents/skills` workflows only (no harness-specific runtime code):
-
-- Pi coding agent
-- OpenClaw
-- Claude Code
-- Codex CLI
-- OpenCode
-- Amp
-- Droid
-- Hermes
-- Gemini CLI
-
-## Progressive-Disclosure Route
-
-Use the same low-token route in every harness:
-
-1. `pm guide` (topic index)
-2. `pm guide <topic>` (focused route)
-3. `pm guide <topic> --depth standard|deep` (details only when needed)
-4. `pm contracts --command <command> --flags-only --json` (strict machine flags)
-
-## Harness Mapping
-
-| Harness | Preferred prompt/doc entrypoint | Skill route |
-|---------|----------------------------------|-------------|
-| Pi coding agent | `AGENTS.md` + `pm guide workflows` | `.agents/skills/pm-developer/SKILL.md` |
-| OpenClaw | repository docs + `pm guide` | `.agents/skills/pm-user/SKILL.md` |
-| Claude Code | repository docs + `pm guide skills` | `.agents/skills/pm-developer/SKILL.md` |
-| Codex CLI | repository docs + `pm guide commands` | `.agents/skills/pm-developer/SKILL.md` |
-| OpenCode | repository docs + `pm guide quickstart` | `.agents/skills/pm-user/SKILL.md` |
-| Amp | repository docs + `pm guide workflows` | `.agents/skills/pm-user/SKILL.md` |
-| Droid | repository docs + `pm guide extensions` | `.agents/skills/pm-extensions/SKILL.md` |
-| Hermes | repository docs + `pm guide sdk` | `.agents/skills/pm-sdk/SKILL.md` |
-| Gemini CLI | repository docs + `pm guide commands` | `.agents/skills/pm-user/SKILL.md` |
-
-## Verification
-
-Before release, run:
-
-```bash
-pm guide skills --depth standard
-node scripts/release/docs-skills-gate.mjs
-```

package/.agents/skills/README.md

@@ -1,21 +0,0 @@
-# pm Agent Skills
-
-This directory contains `agentskills.io`-style skills for `pm` workflows.
-
-Start with:
-
-```bash
-pm guide skills
-pm guide harnesses --depth standard
-```
-
-Skill bundles:
-
-- `pm-developer` - implementation loop for coding agents.
-- `pm-user` - operator workflow for planning and task routing.
-- `pm-extensions` - extension lifecycle, diagnostics, and release-safe updates.
-- `pm-sdk` - SDK and integration workflows.
-
-Compatibility routing:
-
-- [Harness compatibility matrix](HARNESS_COMPATIBILITY.md)

package/.agents/skills/pm-developer/SKILL.md

@@ -1,73 +0,0 @@
----
-name: pm-developer
-description: Runs the pm-cli developer execution loop (orient, claim, implement, verify, close) with linked files/tests/docs evidence. Use when coding, debugging, refactoring, or shipping repository changes tracked in pm items.
-license: MIT
-compatibility: Works in terminal-based coding agents with bash, Node.js, and pnpm.
-metadata:
-  owner: unbrained
-  domain: pm-cli
-  scope: developer-workflow
----
-
-# pm Developer Skill
-
-Use this skill for implementation work that changes code, docs, tests, or release gates.
-
-## Quick Start
-
-```bash
-pm context --limit 10
-pm search "<task keywords>" --limit 10
-pm list-open --limit 20
-pm claim <ID>
-pm update <ID> --status in_progress
-pm guide workflows
-```
-
-## Canonical Workflow
-
-1. **Orient**: pick an existing item when possible.
-2. **Claim**: claim before substantial edits.
-3. **Link context**: attach changed files/tests/docs while implementing.
-4. **Verify**: run linked tests plus local quality gates.
-5. **Close with evidence**: append what changed and what passed.
-6. **Release claim**: release when paused, handed off, or closed.
-
-## Workflow Prompts
-
-Use one prompt template, then execute only the minimum required commands.
-
-### Prompt: Implement Scoped Change
-
-`Implement the requested change on <ID>. Keep edits scoped, link files/tests/docs, run targeted verification, and record closure evidence before releasing claim.`
-
-### Prompt: Debug Regression
-
-`Investigate failing behavior for <ID>. Reproduce first, add or update regression tests, patch root cause, and append evidence with exact command outputs.`
-
-### Prompt: Documentation + Code Sync
-
-`Update implementation and docs together for <ID>. Ensure docs route through pm guide topics and verify command examples still match pm contracts output.`
-
-## Required Evidence Commands
-
-```bash
-pm files <ID> --add path=<path>,scope=project,note="<reason>"
-pm test <ID> --add command="node scripts/run-tests.mjs test -- <target>",scope=project,timeout_seconds=240
-pm docs <ID> --add path=<doc>,scope=project,note="<reason>"
-pm comments <ID> "Evidence: <what changed + tests run>"
-```
-
-## Verification Defaults
-
-```bash
-pnpm build
-node scripts/run-tests.mjs test -- <targets>
-node scripts/run-tests.mjs coverage
-pm validate --check-resolution --check-history-drift
-```
-
-## Progressive Disclosure References
-
-- [Developer command playbook](references/COMMAND_PLAYBOOK.md)
-- [Prompt templates and examples](references/PROMPTS.md)