@unbrained/pm-cli 2026.5.6 → 2026.5.10

package/dist/pi/native.js

@@ -0,0 +1,183 @@
+import { PmCliError } from "../core/shared/errors.js";
+import { readSettings } from "../core/store/settings.js";
+import { resolvePmRoot } from "../core/store/paths.js";
+import { normalizeStatusInput } from "../core/item/status.js";
+import { resolveRuntimeStatusRegistry } from "../core/schema/runtime-schema.js";
+import { runActivity, runAggregate, runAppend, runCalendar, runClaim, runClose, runComments, runCommentsAudit, runCompletion, runConfig, runContext, runContracts, runCreate, runDedupeAudit, runDelete, runDeps, runDocs, runExtension, runFiles, runFilesDiscover, runGc, runGet, runGuide, runHealth, runHistory, runInit, runLearnings, runList, runNormalize, runNotes, runReindex, runRelease, runRestore, runSearch, runStats, runTemplatesList, runTemplatesSave, runTemplatesShow, runTest, runTestAll, runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, runUpdate, runUpdateMany, runValidate, } from "../cli/commands/index.js";
+const GLOBAL_KEYS = new Set([
+    "action",
+    "cwd",
+    "path",
+    "json",
+    "quiet",
+    "profile",
+    "noExtensions",
+    "noPager",
+    "pmExecutable",
+    "timeoutMs",
+    "options",
+]);
+function asRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? { ...value } : {};
+}
+function readString(args, key) {
+    const value = args[key];
+    return typeof value === "string" && value.trim().length > 0 ? value : undefined;
+}
+function mutationOptions(options) {
+    return {
+        author: readString(options, "author"),
+        message: typeof options.message === "string" ? options.message : undefined,
+    };
+}
+function requiredString(args, key, action) {
+    const value = readString(args, key);
+    if (!value) {
+        throw new PmCliError(`Action "${action}" requires "${key}".`, 64);
+    }
+    return value;
+}
+export function nativeGlobalOptions(args) {
+    return {
+        json: args.json !== false,
+        quiet: args.quiet === true,
+        profile: args.profile === true,
+        noExtensions: args.noExtensions === true,
+        noPager: args.noPager !== false,
+        path: readString(args, "path"),
+    };
+}
+export function nativeCommandOptions(args) {
+    const options = asRecord(args.options);
+    for (const [key, value] of Object.entries(args)) {
+        if (GLOBAL_KEYS.has(key) || value === undefined)
+            continue;
+        if (options[key] === undefined)
+            options[key] = value;
+    }
+    const author = readString(args, "author");
+    if (author && options.author === undefined)
+        options.author = author;
+    return options;
+}
+async function withCwd(cwd, run) {
+    if (typeof cwd !== "string" || cwd.trim().length === 0)
+        return run();
+    const previous = process.cwd();
+    process.chdir(cwd);
+    try {
+        return await run();
+    }
+    finally {
+        process.chdir(previous);
+    }
+}
+async function runStartTask(id, options, global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    const settings = await readSettings(pmRoot);
+    const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+    const status = normalizeStatusInput("in_progress", statusRegistry) ?? statusRegistry.open_status;
+    const force = options.force === true;
+    const baseOptions = mutationOptions(options);
+    const claim = await runClaim(id, force, global, baseOptions);
+    const update = await runUpdate(id, { ...baseOptions, status, force }, global);
+    return { id, action: "start_task", claim, update };
+}
+async function runPauseTask(id, options, global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    const settings = await readSettings(pmRoot);
+    const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+    const force = options.force === true;
+    const baseOptions = mutationOptions(options);
+    const update = await runUpdate(id, { ...baseOptions, status: statusRegistry.open_status, force }, global);
+    const release = await runRelease(id, force, global, baseOptions);
+    return { id, action: "pause_task", update, release };
+}
+async function runCloseTask(id, reason, options, global) {
+    const force = options.force === true;
+    const baseOptions = mutationOptions(options);
+    const close = await runClose(id, reason, { ...baseOptions, validateClose: readString(options, "validateClose"), force }, global);
+    const release = await runRelease(id, force, global, baseOptions);
+    return { id, action: "close_task", close, release };
+}
+export async function runNativePmAction(args) {
+    return withCwd(args.cwd, async () => {
+        const action = requiredString(args, "action", "pm").trim().toLowerCase();
+        const global = nativeGlobalOptions(args);
+        const options = nativeCommandOptions(args);
+        const id = readString(args, "id") ?? readString(options, "id");
+        const force = args.force === true || options.force === true;
+        switch (action) {
+            case "init": return runInit(readString(args, "prefix") ?? readString(options, "prefix"), global, options);
+            case "config": return runConfig(readString(args, "scope") ?? readString(options, "scope") ?? "project", readString(args, "configAction") ?? readString(options, "configAction") ?? requiredString(options, "action", action), readString(args, "key") ?? readString(options, "key"), options, global);
+            case "extension-init": return runExtension(requiredString(args, "target", action), { ...options, init: true }, global);
+            case "extension-install": return runExtension(readString(args, "target") ?? readString(options, "target"), { ...options, install: true }, global);
+            case "extension-uninstall": return runExtension(requiredString(args, "target", action), { ...options, uninstall: true }, global);
+            case "extension-explore": return runExtension(undefined, { ...options, explore: true }, global);
+            case "extension-manage": return runExtension(undefined, { ...options, manage: true }, global);
+            case "extension-doctor": return runExtension(undefined, { ...options, doctor: true }, global);
+            case "extension-adopt": return runExtension(requiredString(args, "target", action), { ...options, adopt: true }, global);
+            case "extension-adopt-all": return runExtension(undefined, { ...options, adoptAll: true }, global);
+            case "extension-activate": return runExtension(requiredString(args, "target", action), { ...options, activate: true }, global);
+            case "extension-deactivate": return runExtension(requiredString(args, "target", action), { ...options, deactivate: true }, global);
+            case "extension": return runExtension(readString(args, "target") ?? readString(options, "target"), options, global);
+            case "create": return runCreate(options, global);
+            case "list":
+            case "list-all":
+            case "list-draft":
+            case "list-open":
+            case "list-in-progress":
+            case "list-blocked":
+            case "list-closed":
+            case "list-canceled": return runList(action === "list" ? readString(args, "status") : action === "list-all" ? undefined : action.replace("list-", "").replaceAll("-", "_"), options, global);
+            case "aggregate": return runAggregate(options, global);
+            case "dedupe-audit": return runDedupeAudit(options, global);
+            case "calendar": return runCalendar(options, global);
+            case "context": return runContext(options, global);
+            case "get": return runGet(id ?? requiredString(options, "id", action), global);
+            case "search": return runSearch(readString(args, "query") ?? readString(args, "keywords") ?? requiredString(options, "query", action), options, global);
+            case "reindex": return runReindex(options, global);
+            case "history": return runHistory(id ?? requiredString(options, "id", action), options, global);
+            case "activity": return runActivity(options, global);
+            case "restore": return runRestore(id ?? requiredString(options, "id", action), readString(args, "target") ?? requiredString(options, "target", action), options, global);
+            case "update": return runUpdate(id ?? requiredString(options, "id", action), options, global);
+            case "update-many": return runUpdateMany(options, global);
+            case "normalize": return runNormalize(options, global);
+            case "close": return runClose(id ?? requiredString(options, "id", action), readString(args, "text") ?? readString(args, "reason") ?? requiredString(options, "text", action), options, global);
+            case "delete": return runDelete(id ?? requiredString(options, "id", action), options, global);
+            case "append": return runAppend(id ?? requiredString(options, "id", action), options, global);
+            case "comments": return runComments(id ?? requiredString(options, "id", action), options, global);
+            case "comments-audit": return runCommentsAudit(options, global);
+            case "notes": return runNotes(id ?? requiredString(options, "id", action), options, global);
+            case "learnings": return runLearnings(id ?? requiredString(options, "id", action), options, global);
+            case "files": return runFiles(id ?? requiredString(options, "id", action), options, global);
+            case "files-discover": return runFilesDiscover(id ?? requiredString(options, "id", action), options, global);
+            case "docs": return runDocs(id ?? requiredString(options, "id", action), options, global);
+            case "deps": return runDeps(id ?? requiredString(options, "id", action), options, global);
+            case "test": return runTest(id ?? requiredString(options, "id", action), options, global);
+            case "test-all": return runTestAll(options, global);
+            case "test-runs-list": return runTestRunsList(options, global);
+            case "test-runs-status": return runTestRunsStatus(requiredString(args, "runId", action), global);
+            case "test-runs-logs": return runTestRunsLogs(requiredString(args, "runId", action), options, global);
+            case "test-runs-stop": return runTestRunsStop(requiredString(args, "runId", action), options, global);
+            case "test-runs-resume": return runTestRunsResume(requiredString(args, "runId", action), options, global);
+            case "stats": return runStats(global);
+            case "health": return runHealth(global, options);
+            case "validate": return runValidate(options, global);
+            case "gc": return runGc(global, options);
+            case "contracts": return runContracts(options, global);
+            case "completion": return runCompletion(requiredString(args, "shell", action), undefined, undefined, options.eagerTags === true, options.runtime);
+            case "templates-save": return runTemplatesSave(readString(args, "template") ?? requiredString(options, "name", action), options, global);
+            case "templates-list": return runTemplatesList(global);
+            case "templates-show": return runTemplatesShow(readString(args, "template") ?? requiredString(options, "name", action), global);
+            case "claim": return runClaim(id ?? requiredString(options, "id", action), force, global, options);
+            case "release": return runRelease(id ?? requiredString(options, "id", action), force, global, options);
+            case "start-task": return runStartTask(id ?? requiredString(options, "id", action), options, global);
+            case "pause-task": return runPauseTask(id ?? requiredString(options, "id", action), options, global);
+            case "close-task": return runCloseTask(id ?? requiredString(options, "id", action), readString(args, "text") ?? readString(args, "reason") ?? requiredString(options, "text", action), options, global);
+            case "guide": return runGuide(options, global);
+            default: throw new PmCliError(`Unsupported native pm action: ${action}`, 64);
+        }
+    });
+}
+//# sourceMappingURL=native.js.map

package/dist/pi/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"/","sources":["pi/native.ts"],"names":[],"mappings":"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","sourcesContent":["import type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport { resolvePmRoot } from \"../core/store/paths.js\";\nimport { normalizeStatusInput } from \"../core/item/status.js\";\nimport { resolveRuntimeStatusRegistry } from \"../core/schema/runtime-schema.js\";\nimport {\n  runActivity,\n  runAggregate,\n  runAppend,\n  runCalendar,\n  runClaim,\n  runClose,\n  runComments,\n  runCommentsAudit,\n  runCompletion,\n  runConfig,\n  runContext,\n  runContracts,\n  runCreate,\n  runDedupeAudit,\n  runDelete,\n  runDeps,\n  runDocs,\n  runExtension,\n  runFiles,\n  runFilesDiscover,\n  runGc,\n  runGet,\n  runGuide,\n  runHealth,\n  runHistory,\n  runInit,\n  runLearnings,\n  runList,\n  runNormalize,\n  runNotes,\n  runReindex,\n  runRelease,\n  runRestore,\n  runSearch,\n  runStats,\n  runTemplatesList,\n  runTemplatesSave,\n  runTemplatesShow,\n  runTest,\n  runTestAll,\n  runTestRunsList,\n  runTestRunsLogs,\n  runTestRunsResume,\n  runTestRunsStatus,\n  runTestRunsStop,\n  runUpdate,\n  runUpdateMany,\n  runValidate,\n} from \"../cli/commands/index.js\";\n\nexport type NativePmArgs = Record<string, unknown>;\n\nconst GLOBAL_KEYS = new Set([\n  \"action\",\n  \"cwd\",\n  \"path\",\n  \"json\",\n  \"quiet\",\n  \"profile\",\n  \"noExtensions\",\n  \"noPager\",\n  \"pmExecutable\",\n  \"timeoutMs\",\n  \"options\",\n]);\n\nfunction asRecord(value: unknown): Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value) ? { ...(value as Record<string, unknown>) } : {};\n}\n\nfunction readString(args: Record<string, unknown>, key: string): string | undefined {\n  const value = args[key];\n  return typeof value === \"string\" && value.trim().length > 0 ? value : undefined;\n}\n\nfunction mutationOptions(options: Record<string, unknown>): { author?: string; message?: string } {\n  return {\n    author: readString(options, \"author\"),\n    message: typeof options.message === \"string\" ? options.message : undefined,\n  };\n}\n\nfunction requiredString(args: Record<string, unknown>, key: string, action: string): string {\n  const value = readString(args, key);\n  if (!value) {\n    throw new PmCliError(`Action \"${action}\" requires \"${key}\".`, 64);\n  }\n  return value;\n}\n\nexport function nativeGlobalOptions(args: NativePmArgs): GlobalOptions {\n  return {\n    json: args.json !== false,\n    quiet: args.quiet === true,\n    profile: args.profile === true,\n    noExtensions: args.noExtensions === true,\n    noPager: args.noPager !== false,\n    path: readString(args, \"path\"),\n  };\n}\n\nexport function nativeCommandOptions(args: NativePmArgs): Record<string, unknown> {\n  const options = asRecord(args.options);\n  for (const [key, value] of Object.entries(args)) {\n    if (GLOBAL_KEYS.has(key) || value === undefined) continue;\n    if (options[key] === undefined) options[key] = value;\n  }\n  const author = readString(args, \"author\");\n  if (author && options.author === undefined) options.author = author;\n  return options;\n}\n\nasync function withCwd<T>(cwd: unknown, run: () => Promise<T>): Promise<T> {\n  if (typeof cwd !== \"string\" || cwd.trim().length === 0) return run();\n  const previous = process.cwd();\n  process.chdir(cwd);\n  try {\n    return await run();\n  } finally {\n    process.chdir(previous);\n  }\n}\n\nasync function runStartTask(id: string, options: Record<string, unknown>, global: GlobalOptions): Promise<unknown> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const status = normalizeStatusInput(\"in_progress\", statusRegistry) ?? statusRegistry.open_status;\n  const force = options.force === true;\n  const baseOptions = mutationOptions(options);\n  const claim = await runClaim(id, force, global, baseOptions);\n  const update = await runUpdate(id, { ...baseOptions, status, force }, global);\n  return { id, action: \"start_task\", claim, update };\n}\n\nasync function runPauseTask(id: string, options: Record<string, unknown>, global: GlobalOptions): Promise<unknown> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  const settings = await readSettings(pmRoot);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  const force = options.force === true;\n  const baseOptions = mutationOptions(options);\n  const update = await runUpdate(id, { ...baseOptions, status: statusRegistry.open_status, force }, global);\n  const release = await runRelease(id, force, global, baseOptions);\n  return { id, action: \"pause_task\", update, release };\n}\n\nasync function runCloseTask(id: string, reason: string, options: Record<string, unknown>, global: GlobalOptions): Promise<unknown> {\n  const force = options.force === true;\n  const baseOptions = mutationOptions(options);\n  const close = await runClose(id, reason, { ...baseOptions, validateClose: readString(options, \"validateClose\"), force }, global);\n  const release = await runRelease(id, force, global, baseOptions);\n  return { id, action: \"close_task\", close, release };\n}\n\nexport async function runNativePmAction(args: NativePmArgs): Promise<unknown> {\n  return withCwd(args.cwd, async () => {\n    const action = requiredString(args, \"action\", \"pm\").trim().toLowerCase();\n    const global = nativeGlobalOptions(args);\n    const options = nativeCommandOptions(args);\n    const id = readString(args, \"id\") ?? readString(options, \"id\");\n    const force = args.force === true || options.force === true;\n\n    switch (action) {\n      case \"init\": return runInit(readString(args, \"prefix\") ?? readString(options, \"prefix\"), global, options);\n      case \"config\": return runConfig(readString(args, \"scope\") ?? readString(options, \"scope\") ?? \"project\", readString(args, \"configAction\") ?? readString(options, \"configAction\") ?? requiredString(options, \"action\", action), readString(args, \"key\") ?? readString(options, \"key\"), options, global);\n      case \"extension-init\": return runExtension(requiredString(args, \"target\", action), { ...options, init: true }, global);\n      case \"extension-install\": return runExtension(readString(args, \"target\") ?? readString(options, \"target\"), { ...options, install: true }, global);\n      case \"extension-uninstall\": return runExtension(requiredString(args, \"target\", action), { ...options, uninstall: true }, global);\n      case \"extension-explore\": return runExtension(undefined, { ...options, explore: true }, global);\n      case \"extension-manage\": return runExtension(undefined, { ...options, manage: true }, global);\n      case \"extension-doctor\": return runExtension(undefined, { ...options, doctor: true }, global);\n      case \"extension-adopt\": return runExtension(requiredString(args, \"target\", action), { ...options, adopt: true }, global);\n      case \"extension-adopt-all\": return runExtension(undefined, { ...options, adoptAll: true }, global);\n      case \"extension-activate\": return runExtension(requiredString(args, \"target\", action), { ...options, activate: true }, global);\n      case \"extension-deactivate\": return runExtension(requiredString(args, \"target\", action), { ...options, deactivate: true }, global);\n      case \"extension\": return runExtension(readString(args, \"target\") ?? readString(options, \"target\"), options, global);\n      case \"create\": return runCreate(options, global);\n      case \"list\": case \"list-all\": case \"list-draft\": case \"list-open\": case \"list-in-progress\": case \"list-blocked\": case \"list-closed\": case \"list-canceled\": return runList(action === \"list\" ? readString(args, \"status\") : action === \"list-all\" ? undefined : action.replace(\"list-\", \"\").replaceAll(\"-\", \"_\"), options, global);\n      case \"aggregate\": return runAggregate(options, global);\n      case \"dedupe-audit\": return runDedupeAudit(options, global);\n      case \"calendar\": return runCalendar(options, global);\n      case \"context\": return runContext(options, global);\n      case \"get\": return runGet(id ?? requiredString(options, \"id\", action), global);\n      case \"search\": return runSearch(readString(args, \"query\") ?? readString(args, \"keywords\") ?? requiredString(options, \"query\", action), options, global);\n      case \"reindex\": return runReindex(options, global);\n      case \"history\": return runHistory(id ?? requiredString(options, \"id\", action), options, global);\n      case \"activity\": return runActivity(options, global);\n      case \"restore\": return runRestore(id ?? requiredString(options, \"id\", action), readString(args, \"target\") ?? requiredString(options, \"target\", action), options, global);\n      case \"update\": return runUpdate(id ?? requiredString(options, \"id\", action), options, global);\n      case \"update-many\": return runUpdateMany(options as never, global);\n      case \"normalize\": return runNormalize(options as never, global);\n      case \"close\": return runClose(id ?? requiredString(options, \"id\", action), readString(args, \"text\") ?? readString(args, \"reason\") ?? requiredString(options, \"text\", action), options, global);\n      case \"delete\": return runDelete(id ?? requiredString(options, \"id\", action), options, global);\n      case \"append\": return runAppend(id ?? requiredString(options, \"id\", action), options as never, global);\n      case \"comments\": return runComments(id ?? requiredString(options, \"id\", action), options, global);\n      case \"comments-audit\": return runCommentsAudit(options, global);\n      case \"notes\": return runNotes(id ?? requiredString(options, \"id\", action), options, global);\n      case \"learnings\": return runLearnings(id ?? requiredString(options, \"id\", action), options, global);\n      case \"files\": return runFiles(id ?? requiredString(options, \"id\", action), options, global);\n      case \"files-discover\": return runFilesDiscover(id ?? requiredString(options, \"id\", action), options, global);\n      case \"docs\": return runDocs(id ?? requiredString(options, \"id\", action), options, global);\n      case \"deps\": return runDeps(id ?? requiredString(options, \"id\", action), options, global);\n      case \"test\": return runTest(id ?? requiredString(options, \"id\", action), options, global);\n      case \"test-all\": return runTestAll(options, global);\n      case \"test-runs-list\": return runTestRunsList(options, global);\n      case \"test-runs-status\": return runTestRunsStatus(requiredString(args, \"runId\", action), global);\n      case \"test-runs-logs\": return runTestRunsLogs(requiredString(args, \"runId\", action), options, global);\n      case \"test-runs-stop\": return runTestRunsStop(requiredString(args, \"runId\", action), options, global);\n      case \"test-runs-resume\": return runTestRunsResume(requiredString(args, \"runId\", action), options, global);\n      case \"stats\": return runStats(global);\n      case \"health\": return runHealth(global, options);\n      case \"validate\": return runValidate(options, global);\n      case \"gc\": return runGc(global, options);\n      case \"contracts\": return runContracts(options, global);\n      case \"completion\": return runCompletion(requiredString(args, \"shell\", action), undefined, undefined, options.eagerTags === true, options.runtime as never);\n      case \"templates-save\": return runTemplatesSave(readString(args, \"template\") ?? requiredString(options, \"name\", action), options, global);\n      case \"templates-list\": return runTemplatesList(global);\n      case \"templates-show\": return runTemplatesShow(readString(args, \"template\") ?? requiredString(options, \"name\", action), global);\n      case \"claim\": return runClaim(id ?? requiredString(options, \"id\", action), force, global, options);\n      case \"release\": return runRelease(id ?? requiredString(options, \"id\", action), force, global, options);\n      case \"start-task\": return runStartTask(id ?? requiredString(options, \"id\", action), options, global);\n      case \"pause-task\": return runPauseTask(id ?? requiredString(options, \"id\", action), options, global);\n      case \"close-task\": return runCloseTask(id ?? requiredString(options, \"id\", action), readString(args, \"text\") ?? readString(args, \"reason\") ?? requiredString(options, \"text\", action), options, global);\n      case \"guide\": return runGuide(options, global);\n      default: throw new PmCliError(`Unsupported native pm action: ${action}`, 64);\n    }\n  });\n}\n"]}

package/dist/sdk/cli-contracts.d.ts

@@ -19,7 +19,7 @@ export type PmExtensionCapabilityContract = (typeof PM_EXTENSION_CAPABILITY_CONT
 export declare const PM_EXTENSION_SERVICE_NAME_CONTRACTS: readonly ["output_format", "error_format", "help_format", "lock_acquire", "lock_release", "history_append", "item_store_write", "item_store_delete"];
 export type PmExtensionServiceNameContract = (typeof PM_EXTENSION_SERVICE_NAME_CONTRACTS)[number];
 export declare function withFlagAliasMetadata(flagContracts: CliFlagContract[]): CliFlagContract[];
-export declare const PM_CORE_COMMAND_NAMES: readonly ["init", "config", "extension", "create", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "dedupe-audit", "calendar", "cal", "context", "ctx", "get", "search", "reindex", "history", "activity", "restore", "update", "update-many", "normalize", "close", "delete", "append", "comments", "comments-audit", "notes", "learnings", "files", "docs", "deps", "test", "test-all", "test-runs", "stats", "health", "validate", "gc", "contracts", "claim", "release", "start-task", "pause-task", "close-task", "templates", "completion", "help"];
+export declare const PM_CORE_COMMAND_NAMES: readonly ["init", "config", "extension", "create", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "dedupe-audit", "guide", "calendar", "cal", "context", "ctx", "get", "search", "reindex", "history", "activity", "restore", "update", "update-many", "normalize", "close", "delete", "append", "comments", "comments-audit", "notes", "learnings", "files", "docs", "deps", "test", "test-all", "test-runs", "stats", "health", "validate", "gc", "contracts", "claim", "release", "start-task", "pause-task", "close-task", "templates", "completion", "help"];
 export declare const PM_TOOL_ACTIONS: readonly ["init", "config", "extension-init", "extension-install", "extension-uninstall", "extension-explore", "extension-manage", "extension-doctor", "extension-adopt", "extension-adopt-all", "extension-activate", "extension-deactivate", "create", "list", "list-all", "list-draft", "list-open", "list-in-progress", "list-blocked", "list-closed", "list-canceled", "aggregate", "dedupe-audit", "calendar", "context", "get", "search", "reindex", "history", "activity", "restore", "update", "update-many", "normalize", "close", "delete", "append", "comments", "comments-audit", "notes", "learnings", "files", "docs", "deps", "test", "test-all", "test-runs-list", "test-runs-status", "test-runs-logs", "test-runs-stop", "test-runs-resume", "stats", "health", "validate", "gc", "contracts", "completion", "templates-save", "templates-list", "templates-show", "claim", "release", "beads-import", "todos-import", "todos-export", "start-task", "pause-task", "close-task"];
 export type PmToolAction = (typeof PM_TOOL_ACTIONS)[number];
 export declare const PI_LIST_FILTER_OPTION_CONTRACTS: PiOptionFlagContract[];
@@ -73,6 +73,7 @@ export declare const NORMALIZE_FLAG_CONTRACTS: CliFlagContract[];
 export declare const CALENDAR_FLAG_CONTRACTS: CliFlagContract[];
 export declare const ACTIVITY_FLAG_CONTRACTS: CliFlagContract[];
 export declare const CONTEXT_FLAG_CONTRACTS: CliFlagContract[];
+export declare const GUIDE_FLAG_CONTRACTS: CliFlagContract[];
 export declare const DEPS_FLAG_CONTRACTS: CliFlagContract[];
 export declare const SEARCH_FLAG_CONTRACTS: CliFlagContract[];
 export declare const CONTRACTS_FLAG_CONTRACTS: CliFlagContract[];
@@ -90,3 +91,4 @@ export declare const ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS: CommanderOption
 export declare function readFirstStringFromCommanderOptions(options: Record<string, unknown>, contract: CommanderOptionAliasContract): string | undefined;
 export declare function readStringArrayFromCommanderOptions(options: Record<string, unknown>, contract: CommanderOptionAliasContract): string[] | undefined;
 export declare const PM_TOOL_PARAMETERS_SCHEMA: Record<string, unknown>;
+export declare const PM_PI_TOOL_PARAMETERS_SCHEMA: Record<string, unknown>;

package/dist/sdk/cli-contracts.js

@@ -73,6 +73,7 @@ export const PM_CORE_COMMAND_NAMES = [
     "list-canceled",
     "aggregate",
     "dedupe-audit",
+    "guide",
     "calendar",
     "cal",
     "context",
@@ -506,6 +507,8 @@ export const COMMENTS_AUDIT_FLAG_CONTRACTS = [
 ];
 export const COMMENTS_FLAG_CONTRACTS = [
     { flag: "--add" },
+    { flag: "--stdin" },
+    { flag: "--file" },
     { flag: "--limit" },
     { flag: "--author" },
     { flag: "--message" },
@@ -1078,6 +1081,11 @@ export const CONTEXT_FLAG_CONTRACTS = [
     { flag: "--limit" },
     { flag: "--format" },
 ];
+export const GUIDE_FLAG_CONTRACTS = [
+    { flag: "--list" },
+    { flag: "--format" },
+    { flag: "--depth" },
+];
 export const DEPS_FLAG_CONTRACTS = [
     { flag: "--format" },
     { flag: "--max-depth" },
@@ -1520,6 +1528,7 @@ const PM_TOOL_PARAMETER_PROPERTIES = {
     collapse: { type: "string", enum: ["none", "repeated"] },
     summary: { type: "boolean" },
     shell: { type: "string", enum: ["bash", "zsh", "fish"] },
+    stdin: { type: "boolean" },
     file: { type: "string" },
     preserveSourceIds: { type: "boolean" },
     folder: { type: "string" },
@@ -1702,7 +1711,10 @@ const PM_TOOL_ACTION_SCHEMA_CONTRACTS = {
     close: { required: ["id", "text"], optional: ["validateClose", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS] },
     delete: { required: ["id"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
     append: { required: ["id", "body"], optional: AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS },
-    comments: { required: ["id"], optional: ["text", "add", "limit", "allowAuditComment", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS] },
+    comments: {
+        required: ["id"],
+        optional: ["text", "add", "stdin", "file", "limit", "allowAuditComment", ...AUTHOR_MESSAGE_FORCE_PARAMETER_KEYS],
+    },
     "comments-audit": {
         optional: [
             "status",
@@ -2190,6 +2202,13 @@ const PM_TOOL_PARAMETER_METADATA = {
     allowAuditComment: {
         description: "For comments action, allow non-owner append-only comment audits without requiring --force.",
     },
+    stdin: {
+        description: "When true for comments action, read comment text from piped stdin (supports multiline markdown).",
+    },
+    file: {
+        description: "Path to input file for actions that read payload text (for example comments --file or beads-import --file).",
+        examples: ["notes/comment.md", "import.json"],
+    },
     allowAuditUpdate: {
         description: "Allow non-owner metadata-only update audits without requiring --force.",
     },
@@ -2379,7 +2398,53 @@ export const PM_TOOL_PARAMETERS_SCHEMA = {
     $schema: "https://json-schema.org/draft/2020-12/schema",
     $id: "https://unbrained.dev/schemas/pm-cli/tool-parameters-v4.schema.json",
     title: "pm-cli Pi wrapper parameters (action-scoped strict schema)",
-    "x-schema-version": "4.0.0",
+    "x-schema-version": "4.0.1",
+    type: "object",
     oneOf: PM_TOOL_ACTIONS.map((action) => buildActionScopedToolSchema(action)),
 };
+function toProviderCompatibleParameterDefinition(key, definition) {
+    const decorated = decorateToolParameterDefinition(key, definition);
+    if (typeof decorated.type === "string") {
+        return decorated;
+    }
+    const anyOf = Array.isArray(decorated.anyOf) ? decorated.anyOf : [];
+    const firstTypedVariant = anyOf.find((variant) => typeof variant.type === "string");
+    if (firstTypedVariant) {
+        const { anyOf: _anyOf, ...rest } = decorated;
+        return {
+            ...rest,
+            type: firstTypedVariant.type,
+        };
+    }
+    const { anyOf: _anyOf, ...rest } = decorated;
+    return {
+        ...rest,
+        type: "string",
+    };
+}
+function buildProviderCompatiblePiToolSchema() {
+    const properties = {
+        action: {
+            type: "string",
+            description: PM_TOOL_PARAMETER_METADATA.action?.description ?? "Tool action to execute.",
+        },
+        options: {
+            type: "object",
+            additionalProperties: true,
+            description: "Advanced command options object forwarded to the selected pm action.",
+        },
+    };
+    for (const key of Object.keys(PM_TOOL_PARAMETER_PROPERTIES).sort()) {
+        properties[key] = toProviderCompatibleParameterDefinition(key, PM_TOOL_PARAMETER_PROPERTIES[key]);
+    }
+    return {
+        title: "pm-cli Pi tool parameters (provider-compatible flat schema)",
+        "x-schema-version": "1.0.0",
+        type: "object",
+        additionalProperties: false,
+        required: ["action"],
+        properties,
+    };
+}
+export const PM_PI_TOOL_PARAMETERS_SCHEMA = buildProviderCompatiblePiToolSchema();
 //# sourceMappingURL=cli-contracts.js.map