@unbrained/pm-cli 2026.5.11 → 2026.5.14

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

@@ -0,0 +1,130 @@
+import path from "node:path";
+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",
+    version: "0.1.0",
+    entry: "./index.js",
+    priority: 0,
+    capabilities: ["commands", "schema"],
+};
+function asOptionalString(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function toImportOptions(options) {
+    return {
+        folder: asOptionalString(options.folder),
+        author: asOptionalString(options.author),
+        message: asOptionalString(options.message),
+    };
+}
+function toExportOptions(options) {
+    return {
+        folder: asOptionalString(options.folder),
+    };
+}
+function resolvePackageRootCandidates() {
+    const candidates = [];
+    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() {
+    const attempted = [];
+    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);
+            }
+            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 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, global) {
+    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, global) {
+    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) {
+    api.registerCommand({
+        name: "todos import",
+        action: "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),
+    });
+    api.registerCommand({
+        name: "todos export",
+        action: "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),
+    });
+}
+export default {
+    manifest,
+    activate,
+};

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

@@ -1,7 +1,10 @@
 import path from "node:path";
-import { pathToFileURL } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import type { CommandDefinition, ExtensionApi, GlobalOptions } from "../../../../src/sdk/index.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",
@@ -11,11 +14,16 @@ export const manifest = {
   capabilities: ["commands", "schema"],
 };
 
-function asOptionalString(value) {
+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) {
+function toImportOptions(options: Record<string, unknown>): TodosImportOptions {
   return {
     folder: asOptionalString(options.folder),
     author: asOptionalString(options.author),
@@ -23,14 +31,14 @@ function toImportOptions(options) {
   };
 }
 
-function toExportOptions(options) {
+function toExportOptions(options: Record<string, unknown>): TodosExportOptions {
   return {
     folder: asOptionalString(options.folder),
   };
 }
 
-function resolvePackageRootCandidates() {
-  const candidates = [];
+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()));
@@ -46,42 +54,57 @@ function resolvePackageRootCandidates() {
   return [...new Set(candidates)];
 }
 
-async function loadRuntimeModule() {
-  const attempted = [];
+async function loadRuntimeModule(): Promise<RuntimeModule> {
+  const attempted: string[] = [];
   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) 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 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.`,
   );
 }
 
-async function runTodosImportFromRuntime(options, global) {
+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().');
+    throw new Error("Bundled todos runtime module is missing runTodosImport().");
   }
   return runtime.runTodosImport(options, global);
 }
 
-async function runTodosExportFromRuntime(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().');
+    throw new Error("Bundled todos runtime module is missing runTodosExport().");
   }
   return runtime.runTodosExport(options, global);
 }
 
-export function activate(api) {
+export function activate(api: ExtensionApi): void {
   api.registerCommand({
     name: "todos import",
+    action: "todos-import",
     description: "Import Todo markdown files into pm items.",
     flags: [
       {
@@ -104,9 +127,10 @@ export function activate(api) {
       },
     ],
     run: async (context) => runTodosImportFromRuntime(toImportOptions(context.options), context.global),
-  });
+  } satisfies CommandDefinition);
   api.registerCommand({
     name: "todos export",
+    action: "todos-export",
     description: "Export pm items into Todo markdown files.",
     flags: [
       {
@@ -117,7 +141,7 @@ export function activate(api) {
       },
     ],
     run: async (context) => runTodosExportFromRuntime(toExportOptions(context.options), context.global),
-  });
+  } satisfies CommandDefinition);
 }
 
 export default {

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

@@ -1,22 +1,7 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks } from "../../../../dist/core/extensions/index.js";
-import { pathExists, removeFileIfExists, writeFileAtomic } from "../../../../dist/core/fs/fs-utils.js";
-import { appendHistoryEntry, createHistoryEntry } from "../../../../dist/core/history/history.js";
-import { generateItemId, normalizeItemId } from "../../../../dist/core/item/id.js";
-import { canonicalDocument, normalizeFrontMatter, serializeItemDocument, splitFrontMatter } from "../../../../dist/core/item/item-format.js";
-import { normalizeStatusInput } from "../../../../dist/core/item/status.js";
-import { resolveItemTypeRegistry } from "../../../../dist/core/item/type-registry.js";
-import { parseTags } from "../../../../dist/core/item/parse.js";
-import { acquireLock } from "../../../../dist/core/lock/lock.js";
-import { EXIT_CODE } from "../../../../dist/core/shared/constants.js";
-import { PmCliError } from "../../../../dist/core/shared/errors.js";
-import { nowIso } from "../../../../dist/core/shared/time.js";
-import { listAllFrontMatter, locateItem, readLocatedItem } from "../../../../dist/core/store/item-store.js";
-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";
+import { CONFIDENCE_TEXT_VALUES, EXIT_CODE, ISSUE_SEVERITY_VALUES, PmCliError, RISK_VALUES, acquireLock, appendHistoryEntry, canonicalDocument, createHistoryEntry, generateItemId, getActiveExtensionRegistrations, getHistoryPath, getItemPath, getSettingsPath, listAllFrontMatter, locateItem, normalizeFrontMatter, normalizeItemId, normalizeStatusInput, nowIso, parseTags, pathExists, readLocatedItem, readSettings, removeFileIfExists, resolveItemTypeRegistry, resolvePmRoot, runActiveOnReadHooks, runActiveOnWriteHooks, serializeItemDocument, splitFrontMatter, writeFileAtomic, } from "../../../../dist/sdk/index.js";
+const DEFAULT_TODOS_FOLDER = ".pm/todos";
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -467,4 +452,4 @@ export async function runTodosExport(options, global) {
         ids,
         warnings,
     };
-}
+}

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

@@ -1,26 +1,48 @@
 import fs from "node:fs/promises";
 import type { Dirent } from "node:fs";
 import path from "node:path";
-import { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks } from "../../../../src/core/extensions/index.js";
-import { pathExists, removeFileIfExists, writeFileAtomic } from "../../../../src/core/fs/fs-utils.js";
-import { appendHistoryEntry, createHistoryEntry } from "../../../../src/core/history/history.js";
-import { generateItemId, normalizeItemId } from "../../../../src/core/item/id.js";
-import { canonicalDocument, normalizeFrontMatter, serializeItemDocument, splitFrontMatter } from "../../../../src/core/item/item-format.js";
-import { normalizeStatusInput } from "../../../../src/core/item/status.js";
-import { resolveItemTypeRegistry } from "../../../../src/core/item/type-registry.js";
-import { parseTags } from "../../../../src/core/item/parse.js";
-import { acquireLock } from "../../../../src/core/lock/lock.js";
-import { EXIT_CODE } from "../../../../src/core/shared/constants.js";
-import type { GlobalOptions } from "../../../../src/core/shared/command-types.js";
-import { PmCliError } from "../../../../src/core/shared/errors.js";
-import { nowIso } from "../../../../src/core/shared/time.js";
-import { listAllFrontMatter, locateItem, readLocatedItem } from "../../../../src/core/store/item-store.js";
-import { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from "../../../../src/core/store/paths.js";
-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";
+import {
+  CONFIDENCE_TEXT_VALUES,
+  EXIT_CODE,
+  ISSUE_SEVERITY_VALUES,
+  PmCliError,
+  RISK_VALUES,
+  acquireLock,
+  appendHistoryEntry,
+  canonicalDocument,
+  createHistoryEntry,
+  generateItemId,
+  getActiveExtensionRegistrations,
+  getHistoryPath,
+  getItemPath,
+  getSettingsPath,
+  listAllFrontMatter,
+  locateItem,
+  normalizeFrontMatter,
+  normalizeItemId,
+  normalizeStatusInput,
+  nowIso,
+  parseTags,
+  pathExists,
+  readLocatedItem,
+  readSettings,
+  removeFileIfExists,
+  resolveItemTypeRegistry,
+  resolvePmRoot,
+  runActiveOnReadHooks,
+  runActiveOnWriteHooks,
+  serializeItemDocument,
+  splitFrontMatter,
+  writeFileAtomic,
+  type GlobalOptions,
+  type ItemDocument,
+  type ItemMetadata,
+  type ItemStatus,
+  type ItemType,
+  type PmSettings,
+} from "../../../../src/sdk/index.js";
+
+const DEFAULT_TODOS_FOLDER = ".pm/todos";
 
 export interface TodosImportOptions {
   folder?: string;

package/packages/pm-todos/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@unbrained/pm-package-todos",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "description": "First-party pm package for Todo markdown import and export.",
+  "homepage": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unbraind/pm-cli.git",
+    "directory": "packages/pm-todos"
+  },
+  "bugs": {
+    "url": "https://github.com/unbraind/pm-cli/issues"
+  },
+  "keywords": [
+    "pm-package",
+    "project-management",
+    "todos"
+  ],
+  "pm": {
+    "aliases": [
+      "todos"
+    ],
+    "extensions": [
+      "extensions/todos"
+    ],
+    "catalog": {
+      "display_name": "Todos Import/Export",
+      "category": "migration",
+      "summary": "Import and export Todo markdown tasks through pm package commands.",
+      "tags": [
+        "migration",
+        "todos",
+        "import",
+        "export"
+      ],
+      "links": {
+        "docs": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos#readme",
+        "repository": "https://github.com/unbraind/pm-cli/tree/main/packages/pm-todos",
+        "report": "https://github.com/unbraind/pm-cli/issues"
+      }
+    },
+    "docs": [
+      "README.md"
+    ],
+    "examples": [
+      "README.md"
+    ]
+  }
+}

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/plugins/pm-cli-claude/scripts/pm-mcp-server.mjs

@@ -39,11 +39,13 @@ async function findRepoServer() {
 
 const explicitServer = process.env.PM_CLI_MCP_SERVER;
 if (explicitServer && (await exists(explicitServer))) {
-  await import(pathToFileURL(explicitServer).href);
+  const server = await import(pathToFileURL(explicitServer).href);
+  server.startMcpServer();
 } else {
   const repoServer = await findRepoServer();
   if (repoServer) {
-    await import(pathToFileURL(repoServer).href);
+    const server = await import(pathToFileURL(repoServer).href);
+    server.startMcpServer();
   } else {
     const child = spawn("npx", ["-y", "--package=@unbrained/pm-cli@latest", "pm-mcp"], {
       stdio: "inherit",

package/plugins/pm-cli-codex/scripts/pm-mcp-server.mjs

@@ -33,11 +33,13 @@ async function findRepoServer() {
 
 const explicitServer = process.env.PM_CLI_MCP_SERVER;
 if (explicitServer && await exists(explicitServer)) {
-  await import(pathToFileURL(explicitServer).href);
+  const server = await import(pathToFileURL(explicitServer).href);
+  server.startMcpServer();
 } else {
   const repoServer = await findRepoServer();
   if (repoServer) {
-    await import(pathToFileURL(repoServer).href);
+    const server = await import(pathToFileURL(repoServer).href);
+    server.startMcpServer();
   } else {
     const child = spawn("npx", ["-y", "@unbrained/pm-cli@latest", "pm-mcp"], {
       stdio: "inherit",

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)