@unbrained/pm-cli 2026.5.24 → 2026.5.28

package/dist/sdk/package-import-adapters.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Shared external-source import adapter primitives for bundled pm packages.
+ *
+ * The Beads (pm-beads) and Todos (pm-todos) importers map records from an
+ * external format into pm items. The field-by-field mapping is intentionally
+ * package-specific (different source schemas, type vocabularies, and timestamp
+ * rules), but a number of value-coercion helpers and the item write/commit
+ * sequence are behavior-identical across both adapters.
+ *
+ * These primitives are re-exported from the SDK runtime surface (`src/sdk/runtime.ts`),
+ * which is the only module bundled packages are permitted to import (they load it
+ * at runtime via `PM_CLI_PACKAGE_ROOT`). Centralizing them here removes copy-pasted
+ * helper bodies while keeping each package's explicit field mapping in the package.
+ */
+import type { ItemDocument, ItemStatus, PmSettings } from "../types/index.js";
+/**
+ * Returns the trimmed string when `value` is a non-empty string, else undefined.
+ */
+export declare function toNonEmptyImportString(value: unknown): string | undefined;
+/**
+ * Coerces a non-negative finite numeric estimate (number or numeric string).
+ */
+export declare function toEstimatedMinutesValue(value: unknown): number | undefined;
+/**
+ * Coerces a priority into the 0..4 range, defaulting to 2.
+ */
+export declare function toImportPriority(value: unknown): 0 | 1 | 2 | 3 | 4;
+/**
+ * Normalizes tags from an array of strings or a comma-separated string.
+ */
+export declare function toImportTags(value: unknown): string[];
+/**
+ * Maps a raw status value to a canonical pm status, defaulting to "open".
+ */
+export declare function toImportStatus(value: unknown): ItemStatus;
+/**
+ * Resolves the effective import author: explicit flag, PM_AUTHOR, then settings,
+ * falling back to "unknown".
+ */
+export declare function selectImportAuthor(explicitAuthor: string | undefined, settingsAuthor: string): string;
+/**
+ * Throws a NOT_FOUND PmCliError when the tracker has not been initialized.
+ */
+export declare function ensureTrackerInitialized(pmRoot: string): Promise<void>;
+/**
+ * Returns an empty item document used as the `before` state on import.
+ */
+export declare function emptyImportedDocument(): ItemDocument;
+export interface CommitImportedItemParams {
+    pmRoot: string;
+    id: string;
+    itemPath: string;
+    document: ItemDocument;
+    author: string;
+    message: string;
+    settings: PmSettings;
+    /** Warning prefix emitted on a lock conflict, e.g. "beads_import_lock_conflict". */
+    conflictWarningPrefix: string;
+}
+export type CommitImportedItemResult = {
+    committed: true;
+    writeWarnings: string[];
+} | {
+    committed: false;
+    conflictWarning: string;
+};
+/**
+ * Performs the shared item write/commit sequence: acquire the per-item lock,
+ * atomically write the TOON document, append the import history entry, and run
+ * on-write hooks. On a lock CONFLICT it returns a `conflictWarning` (using the
+ * caller-supplied prefix) instead of throwing; any other error removes the
+ * partially written file and rethrows.
+ */
+export declare function commitImportedItem(params: CommitImportedItemParams): Promise<CommitImportedItemResult>;

package/dist/sdk/package-import-adapters.js

@@ -0,0 +1,186 @@
+/**
+ * Shared external-source import adapter primitives for bundled pm packages.
+ *
+ * The Beads (pm-beads) and Todos (pm-todos) importers map records from an
+ * external format into pm items. The field-by-field mapping is intentionally
+ * package-specific (different source schemas, type vocabularies, and timestamp
+ * rules), but a number of value-coercion helpers and the item write/commit
+ * sequence are behavior-identical across both adapters.
+ *
+ * These primitives are re-exported from the SDK runtime surface (`src/sdk/runtime.ts`),
+ * which is the only module bundled packages are permitted to import (they load it
+ * at runtime via `PM_CLI_PACKAGE_ROOT`). Centralizing them here removes copy-pasted
+ * helper bodies while keeping each package's explicit field mapping in the package.
+ */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="35a75913-7781-5119-9497-42f4316b14c6")}catch(e){}}();
+import { appendHistoryEntry, createHistoryEntry } from "../core/history/history.js";
+import { acquireLock } from "../core/lock/lock.js";
+import { parseTags } from "../core/item/parse.js";
+import { normalizeStatusInput } from "../core/item/status.js";
+import { serializeItemDocument } from "../core/item/item-format.js";
+import { getHistoryPath, getSettingsPath } from "../core/store/paths.js";
+import { pathExists, removeFileIfExists, writeFileAtomic } from "../core/fs/fs-utils.js";
+import { runActiveOnWriteHooks } from "../core/extensions/index.js";
+import { EXIT_CODE } from "../core/shared/constants.js";
+import { PmCliError } from "../core/shared/errors.js";
+import { nowIso } from "../core/shared/time.js";
+/**
+ * Returns the trimmed string when `value` is a non-empty string, else undefined.
+ */
+export function toNonEmptyImportString(value) {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+/**
+ * Coerces a non-negative finite numeric estimate (number or numeric string).
+ */
+export function toEstimatedMinutesValue(value) {
+    if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+        const parsed = Number(value);
+        if (Number.isFinite(parsed) && parsed >= 0) {
+            return parsed;
+        }
+    }
+    return undefined;
+}
+/**
+ * Coerces a priority into the 0..4 range, defaulting to 2.
+ */
+export function toImportPriority(value) {
+    if (typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= 4) {
+        return value;
+    }
+    if (typeof value === "string" && value.trim().length > 0) {
+        const parsed = Number(value);
+        if (Number.isInteger(parsed) && parsed >= 0 && parsed <= 4) {
+            return parsed;
+        }
+    }
+    return 2;
+}
+/**
+ * Normalizes tags from an array of strings or a comma-separated string.
+ */
+export function toImportTags(value) {
+    if (Array.isArray(value)) {
+        const tags = value
+            .filter((entry) => typeof entry === "string")
+            .map((entry) => entry.trim().toLowerCase())
+            .filter((entry) => entry.length > 0);
+        return Array.from(new Set(tags)).sort((left, right) => left.localeCompare(right));
+    }
+    if (typeof value === "string") {
+        return parseTags(value);
+    }
+    return [];
+}
+/**
+ * Maps a raw status value to a canonical pm status, defaulting to "open".
+ */
+export function toImportStatus(value) {
+    const normalized = toNonEmptyImportString(value);
+    if (normalized) {
+        const canonical = normalizeStatusInput(normalized);
+        if (canonical) {
+            return canonical;
+        }
+    }
+    return "open";
+}
+/**
+ * Resolves the effective import author: explicit flag, PM_AUTHOR, then settings,
+ * falling back to "unknown".
+ */
+export function selectImportAuthor(explicitAuthor, settingsAuthor) {
+    const explicit = explicitAuthor?.trim();
+    if (explicit && explicit.length > 0) {
+        return explicit;
+    }
+    const envAuthor = process.env.PM_AUTHOR?.trim();
+    if (envAuthor && envAuthor.length > 0) {
+        return envAuthor;
+    }
+    const settings = settingsAuthor.trim();
+    return settings.length > 0 ? settings : "unknown";
+}
+/**
+ * Throws a NOT_FOUND PmCliError when the tracker has not been initialized.
+ */
+export async function ensureTrackerInitialized(pmRoot) {
+    const exists = await pathExists(getSettingsPath(pmRoot));
+    if (!exists) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+}
+/**
+ * Returns an empty item document used as the `before` state on import.
+ */
+export function emptyImportedDocument() {
+    return {
+        metadata: {},
+        body: "",
+    };
+}
+/**
+ * Performs the shared item write/commit sequence: acquire the per-item lock,
+ * atomically write the TOON document, append the import history entry, and run
+ * on-write hooks. On a lock CONFLICT it returns a `conflictWarning` (using the
+ * caller-supplied prefix) instead of throwing; any other error removes the
+ * partially written file and rethrows.
+ */
+export async function commitImportedItem(params) {
+    const { pmRoot, id, itemPath, document, author, message, settings, conflictWarningPrefix } = params;
+    const historyPath = getHistoryPath(pmRoot, id);
+    try {
+        const releaseLock = await acquireLock(pmRoot, id, settings.locks.ttl_seconds, author);
+        try {
+            await writeFileAtomic(itemPath, serializeItemDocument(document, { format: "toon" }));
+            try {
+                const entry = createHistoryEntry({
+                    nowIso: nowIso(),
+                    author,
+                    op: "import",
+                    before: emptyImportedDocument(),
+                    after: document,
+                    message,
+                });
+                await appendHistoryEntry(historyPath, entry);
+                const writeWarnings = [
+                    ...(await runActiveOnWriteHooks({
+                        path: itemPath,
+                        scope: "project",
+                        op: "import",
+                    })),
+                    ...(await runActiveOnWriteHooks({
+                        path: historyPath,
+                        scope: "project",
+                        op: "import:history",
+                    })),
+                ];
+                return { committed: true, writeWarnings };
+            }
+            catch (error) {
+                await removeFileIfExists(itemPath);
+                throw error;
+            }
+        }
+        finally {
+            await releaseLock();
+        }
+    }
+    catch (error) {
+        if (error instanceof PmCliError && error.exitCode === EXIT_CODE.CONFLICT) {
+            return { committed: false, conflictWarning: `${conflictWarningPrefix}:${id}` };
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=package-import-adapters.js.map
+//# debugId=35a75913-7781-5119-9497-42f4316b14c6

package/dist/sdk/package-import-adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-import-adapters.js","sources":["sdk/package-import-adapters.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Shared external-source import adapter primitives for bundled pm packages.\n *\n * The Beads (pm-beads) and Todos (pm-todos) importers map records from an\n * external format into pm items. The field-by-field mapping is intentionally\n * package-specific (different source schemas, type vocabularies, and timestamp\n * rules), but a number of value-coercion helpers and the item write/commit\n * sequence are behavior-identical across both adapters.\n *\n * These primitives are re-exported from the SDK runtime surface (`src/sdk/runtime.ts`),\n * which is the only module bundled packages are permitted to import (they load it\n * at runtime via `PM_CLI_PACKAGE_ROOT`). Centralizing them here removes copy-pasted\n * helper bodies while keeping each package's explicit field mapping in the package.\n */\n\nimport { appendHistoryEntry, createHistoryEntry } from \"../core/history/history.js\";\nimport { acquireLock } from \"../core/lock/lock.js\";\nimport { parseTags } from \"../core/item/parse.js\";\nimport { normalizeStatusInput } from \"../core/item/status.js\";\nimport { serializeItemDocument } from \"../core/item/item-format.js\";\nimport { getHistoryPath, getSettingsPath } from \"../core/store/paths.js\";\nimport { pathExists, removeFileIfExists, writeFileAtomic } from \"../core/fs/fs-utils.js\";\nimport { runActiveOnWriteHooks } from \"../core/extensions/index.js\";\nimport { EXIT_CODE } from \"../core/shared/constants.js\";\nimport { PmCliError } from \"../core/shared/errors.js\";\nimport { nowIso } from \"../core/shared/time.js\";\nimport type { ItemDocument, ItemMetadata, ItemStatus, PmSettings } from \"../types/index.js\";\n\n/**\n * Returns the trimmed string when `value` is a non-empty string, else undefined.\n */\nexport function toNonEmptyImportString(value: unknown): string | undefined {\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n  const trimmed = value.trim();\n  return trimmed.length > 0 ? trimmed : undefined;\n}\n\n/**\n * Coerces a non-negative finite numeric estimate (number or numeric string).\n */\nexport function toEstimatedMinutesValue(value: unknown): number | undefined {\n  if (typeof value === \"number\" && Number.isFinite(value) && value >= 0) {\n    return value;\n  }\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    const parsed = Number(value);\n    if (Number.isFinite(parsed) && parsed >= 0) {\n      return parsed;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Coerces a priority into the 0..4 range, defaulting to 2.\n */\nexport function toImportPriority(value: unknown): 0 | 1 | 2 | 3 | 4 {\n  if (typeof value === \"number\" && Number.isInteger(value) && value >= 0 && value <= 4) {\n    return value as 0 | 1 | 2 | 3 | 4;\n  }\n  if (typeof value === \"string\" && value.trim().length > 0) {\n    const parsed = Number(value);\n    if (Number.isInteger(parsed) && parsed >= 0 && parsed <= 4) {\n      return parsed as 0 | 1 | 2 | 3 | 4;\n    }\n  }\n  return 2;\n}\n\n/**\n * Normalizes tags from an array of strings or a comma-separated string.\n */\nexport function toImportTags(value: unknown): string[] {\n  if (Array.isArray(value)) {\n    const tags = value\n      .filter((entry): entry is string => typeof entry === \"string\")\n      .map((entry) => entry.trim().toLowerCase())\n      .filter((entry) => entry.length > 0);\n    return Array.from(new Set(tags)).sort((left, right) => left.localeCompare(right));\n  }\n  if (typeof value === \"string\") {\n    return parseTags(value);\n  }\n  return [];\n}\n\n/**\n * Maps a raw status value to a canonical pm status, defaulting to \"open\".\n */\nexport function toImportStatus(value: unknown): ItemStatus {\n  const normalized = toNonEmptyImportString(value);\n  if (normalized) {\n    const canonical = normalizeStatusInput(normalized);\n    if (canonical) {\n      return canonical;\n    }\n  }\n  return \"open\";\n}\n\n/**\n * Resolves the effective import author: explicit flag, PM_AUTHOR, then settings,\n * falling back to \"unknown\".\n */\nexport function selectImportAuthor(explicitAuthor: string | undefined, settingsAuthor: string): string {\n  const explicit = explicitAuthor?.trim();\n  if (explicit && explicit.length > 0) {\n    return explicit;\n  }\n  const envAuthor = process.env.PM_AUTHOR?.trim();\n  if (envAuthor && envAuthor.length > 0) {\n    return envAuthor;\n  }\n  const settings = settingsAuthor.trim();\n  return settings.length > 0 ? settings : \"unknown\";\n}\n\n/**\n * Throws a NOT_FOUND PmCliError when the tracker has not been initialized.\n */\nexport async function ensureTrackerInitialized(pmRoot: string): Promise<void> {\n  const exists = await pathExists(getSettingsPath(pmRoot));\n  if (!exists) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n}\n\n/**\n * Returns an empty item document used as the `before` state on import.\n */\nexport function emptyImportedDocument(): ItemDocument {\n  return {\n    metadata: {} as ItemMetadata,\n    body: \"\",\n  };\n}\n\nexport interface CommitImportedItemParams {\n  pmRoot: string;\n  id: string;\n  itemPath: string;\n  document: ItemDocument;\n  author: string;\n  message: string;\n  settings: PmSettings;\n  /** Warning prefix emitted on a lock conflict, e.g. \"beads_import_lock_conflict\". */\n  conflictWarningPrefix: string;\n}\n\nexport type CommitImportedItemResult =\n  | { committed: true; writeWarnings: string[] }\n  | { committed: false; conflictWarning: string };\n\n/**\n * Performs the shared item write/commit sequence: acquire the per-item lock,\n * atomically write the TOON document, append the import history entry, and run\n * on-write hooks. On a lock CONFLICT it returns a `conflictWarning` (using the\n * caller-supplied prefix) instead of throwing; any other error removes the\n * partially written file and rethrows.\n */\nexport async function commitImportedItem(\n  params: CommitImportedItemParams,\n): Promise<CommitImportedItemResult> {\n  const { pmRoot, id, itemPath, document, author, message, settings, conflictWarningPrefix } = params;\n  const historyPath = getHistoryPath(pmRoot, id);\n  try {\n    const releaseLock = await acquireLock(pmRoot, id, settings.locks.ttl_seconds, author);\n    try {\n      await writeFileAtomic(itemPath, serializeItemDocument(document, { format: \"toon\" }));\n      try {\n        const entry = createHistoryEntry({\n          nowIso: nowIso(),\n          author,\n          op: \"import\",\n          before: emptyImportedDocument(),\n          after: document,\n          message,\n        });\n        await appendHistoryEntry(historyPath, entry);\n        const writeWarnings = [\n          ...(await runActiveOnWriteHooks({\n            path: itemPath,\n            scope: \"project\",\n            op: \"import\",\n          })),\n          ...(await runActiveOnWriteHooks({\n            path: historyPath,\n            scope: \"project\",\n            op: \"import:history\",\n          })),\n        ];\n        return { committed: true, writeWarnings };\n      } catch (error: unknown) {\n        await removeFileIfExists(itemPath);\n        throw error;\n      }\n    } finally {\n      await releaseLock();\n    }\n  } catch (error: unknown) {\n    if (error instanceof PmCliError && error.exitCode === EXIT_CODE.CONFLICT) {\n      return { committed: false, conflictWarning: `${conflictWarningPrefix}:${id}` };\n    }\n    throw error;\n  }\n}\n"],"names":[],"mappings":"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","debugId":"35a75913-7781-5119-9497-42f4316b14c6"}

package/dist/sdk/package-runtime-options.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Pure option-parsing helpers shared by bundled pm package runtimes.
+ *
+ * Bundled packages (pm-beads, pm-todos, pm-guide-shell, pm-governance-audit,
+ * pm-linked-test-adapters, pm-search-advanced, ...) are standalone-installable
+ * and may only depend on the public SDK runtime surface that they already load
+ * via `PM_CLI_PACKAGE_ROOT`. These helpers are dependency-free string/boolean
+ * coercion utilities; centralizing them here removes copy-pasted helper bodies
+ * from each package runtime while staying on the SDK surface those packages are
+ * permitted to import.
+ */
+/**
+ * Returns the first non-empty string value found for `key` or any alias.
+ */
+export declare function readStringOption(options: Record<string, unknown>, key: string, aliases?: string[]): string | undefined;
+/**
+ * Coerces the first defined value found for `key` or any alias into a boolean.
+ *
+ * Accepts native booleans and the canonical truthy/falsy string literals; any
+ * other value is ignored so a later alias can still match.
+ */
+export declare function readBooleanOption(options: Record<string, unknown>, key: string, aliases?: string[]): boolean | undefined;
+/**
+ * Splits a comma-separated string option into trimmed, non-empty entries.
+ */
+export declare function readCsvListOption(options: Record<string, unknown>, key: string, aliases?: string[]): string[];

package/dist/sdk/package-runtime-options.js

@@ -0,0 +1,71 @@
+/**
+ * Pure option-parsing helpers shared by bundled pm package runtimes.
+ *
+ * Bundled packages (pm-beads, pm-todos, pm-guide-shell, pm-governance-audit,
+ * pm-linked-test-adapters, pm-search-advanced, ...) are standalone-installable
+ * and may only depend on the public SDK runtime surface that they already load
+ * via `PM_CLI_PACKAGE_ROOT`. These helpers are dependency-free string/boolean
+ * coercion utilities; centralizing them here removes copy-pasted helper bodies
+ * from each package runtime while staying on the SDK surface those packages are
+ * permitted to import.
+ */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="73038184-28df-5df7-ad1e-0be2af421b92")}catch(e){}}();
+const BOOLEAN_TRUE_VALUES = new Set(["true", "1", "yes", "on"]);
+const BOOLEAN_FALSE_VALUES = new Set(["false", "0", "no", "off"]);
+/**
+ * Returns the first non-empty string value found for `key` or any alias.
+ */
+export function readStringOption(options, key, aliases = []) {
+    const keys = [key, ...aliases];
+    for (const candidate of keys) {
+        const value = options[candidate];
+        if (typeof value === "string" && value.trim().length > 0) {
+            return value.trim();
+        }
+    }
+    return undefined;
+}
+/**
+ * Coerces the first defined value found for `key` or any alias into a boolean.
+ *
+ * Accepts native booleans and the canonical truthy/falsy string literals; any
+ * other value is ignored so a later alias can still match.
+ */
+export function readBooleanOption(options, key, aliases = []) {
+    const keys = [key, ...aliases];
+    for (const candidate of keys) {
+        const value = options[candidate];
+        if (value === undefined) {
+            continue;
+        }
+        if (typeof value === "boolean") {
+            return value;
+        }
+        if (typeof value === "string") {
+            const normalized = value.trim().toLowerCase();
+            if (BOOLEAN_TRUE_VALUES.has(normalized)) {
+                return true;
+            }
+            if (BOOLEAN_FALSE_VALUES.has(normalized)) {
+                return false;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Splits a comma-separated string option into trimmed, non-empty entries.
+ */
+export function readCsvListOption(options, key, aliases = []) {
+    const value = readStringOption(options, key, aliases);
+    if (!value) {
+        return [];
+    }
+    return value
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+}
+//# sourceMappingURL=package-runtime-options.js.map
+//# debugId=73038184-28df-5df7-ad1e-0be2af421b92

package/dist/sdk/package-runtime-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-runtime-options.js","sources":["sdk/package-runtime-options.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Pure option-parsing helpers shared by bundled pm package runtimes.\n *\n * Bundled packages (pm-beads, pm-todos, pm-guide-shell, pm-governance-audit,\n * pm-linked-test-adapters, pm-search-advanced, ...) are standalone-installable\n * and may only depend on the public SDK runtime surface that they already load\n * via `PM_CLI_PACKAGE_ROOT`. These helpers are dependency-free string/boolean\n * coercion utilities; centralizing them here removes copy-pasted helper bodies\n * from each package runtime while staying on the SDK surface those packages are\n * permitted to import.\n */\n\nconst BOOLEAN_TRUE_VALUES = new Set([\"true\", \"1\", \"yes\", \"on\"]);\nconst BOOLEAN_FALSE_VALUES = new Set([\"false\", \"0\", \"no\", \"off\"]);\n\n/**\n * Returns the first non-empty string value found for `key` or any alias.\n */\nexport function readStringOption(\n  options: Record<string, unknown>,\n  key: string,\n  aliases: string[] = [],\n): string | undefined {\n  const keys = [key, ...aliases];\n  for (const candidate of keys) {\n    const value = options[candidate];\n    if (typeof value === \"string\" && value.trim().length > 0) {\n      return value.trim();\n    }\n  }\n  return undefined;\n}\n\n/**\n * Coerces the first defined value found for `key` or any alias into a boolean.\n *\n * Accepts native booleans and the canonical truthy/falsy string literals; any\n * other value is ignored so a later alias can still match.\n */\nexport function readBooleanOption(\n  options: Record<string, unknown>,\n  key: string,\n  aliases: string[] = [],\n): boolean | undefined {\n  const keys = [key, ...aliases];\n  for (const candidate of keys) {\n    const value = options[candidate];\n    if (value === undefined) {\n      continue;\n    }\n    if (typeof value === \"boolean\") {\n      return value;\n    }\n    if (typeof value === \"string\") {\n      const normalized = value.trim().toLowerCase();\n      if (BOOLEAN_TRUE_VALUES.has(normalized)) {\n        return true;\n      }\n      if (BOOLEAN_FALSE_VALUES.has(normalized)) {\n        return false;\n      }\n    }\n  }\n  return undefined;\n}\n\n/**\n * Splits a comma-separated string option into trimmed, non-empty entries.\n */\nexport function readCsvListOption(\n  options: Record<string, unknown>,\n  key: string,\n  aliases: string[] = [],\n): string[] {\n  const value = readStringOption(options, key, aliases);\n  if (!value) {\n    return [];\n  }\n  return value\n    .split(\",\")\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0);\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;;;AAEH,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AAChE,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAElE;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAgC,EAChC,GAAW,EACX,UAAoB,EAAE;IAEtB,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;IAC/B,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAgC,EAChC,GAAW,EACX,UAAoB,EAAE;IAEtB,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;IAC/B,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,SAAS;QACX,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC9C,IAAI,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACxC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,IAAI,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBACzC,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAgC,EAChC,GAAW,EACX,UAAoB,EAAE;IAEtB,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC","debugId":"73038184-28df-5df7-ad1e-0be2af421b92"}

package/dist/sdk/runtime.d.ts

@@ -4,6 +4,8 @@ export { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWrite
 export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from "../core/fs/fs-utils.js";
 export { appendHistoryEntry, createHistoryEntry } from "../core/history/history.js";
 export { generateItemId, normalizeItemId, normalizeRawItemId } from "../core/item/id.js";
+export { readBooleanOption, readCsvListOption, readStringOption } from "./package-runtime-options.js";
+export { commitImportedItem, emptyImportedDocument, ensureTrackerInitialized, selectImportAuthor, toEstimatedMinutesValue, toImportPriority, toImportStatus, toImportTags, toNonEmptyImportString, type CommitImportedItemParams, type CommitImportedItemResult, } from "./package-import-adapters.js";
 export { canonicalDocument, normalizeFrontMatter, serializeItemDocument, splitFrontMatter, } from "../core/item/item-format.js";
 export { parseTags } from "../core/item/parse.js";
 export { normalizeStatusInput } from "../core/item/status.js";

package/dist/sdk/runtime.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="052ef5fb-9ab2-5bb7-96b0-f07bab9251b6")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9dfba929-1fc6-569e-8311-91fc06f420bc")}catch(e){}}();
 import { activateExtensions, loadExtensions, } from "../core/extensions/index.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
 import { resolveRuntimeStatusRegistry } from "../core/schema/runtime-schema.js";
@@ -9,6 +9,8 @@ export { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWrite
 export { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from "../core/fs/fs-utils.js";
 export { appendHistoryEntry, createHistoryEntry } from "../core/history/history.js";
 export { generateItemId, normalizeItemId, normalizeRawItemId } from "../core/item/id.js";
+export { readBooleanOption, readCsvListOption, readStringOption } from "./package-runtime-options.js";
+export { commitImportedItem, emptyImportedDocument, ensureTrackerInitialized, selectImportAuthor, toEstimatedMinutesValue, toImportPriority, toImportStatus, toImportTags, toNonEmptyImportString, } from "./package-import-adapters.js";
 export { canonicalDocument, normalizeFrontMatter, serializeItemDocument, splitFrontMatter, } from "../core/item/item-format.js";
 export { parseTags } from "../core/item/parse.js";
 export { normalizeStatusInput } from "../core/item/status.js";
@@ -71,4 +73,4 @@ async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
     return activationResult.registrations;
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=052ef5fb-9ab2-5bb7-96b0-f07bab9251b6
+//# debugId=9dfba929-1fc6-569e-8311-91fc06f420bc

package/dist/sdk/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sources":["sdk/runtime.ts"],"sourceRoot":"/","sourcesContent":["import {\n  activateExtensions,\n  loadExtensions,\n  type ExtensionRegistrationRegistry,\n} from \"../core/extensions/index.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry } from \"../core/schema/runtime-schema.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport {\n  runContracts,\n  type ContractsCommandOptions,\n  type ContractsResult,\n} from \"../cli/commands/contracts.js\";\n\nexport {\n  getActiveExtensionRegistrations,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n} from \"../core/extensions/index.js\";\nexport { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from \"../core/fs/fs-utils.js\";\nexport { appendHistoryEntry, createHistoryEntry } from \"../core/history/history.js\";\nexport { generateItemId, normalizeItemId, normalizeRawItemId } from \"../core/item/id.js\";\nexport {\n  canonicalDocument,\n  normalizeFrontMatter,\n  serializeItemDocument,\n  splitFrontMatter,\n} from \"../core/item/item-format.js\";\nexport { parseTags } from \"../core/item/parse.js\";\nexport { normalizeStatusInput } from \"../core/item/status.js\";\nexport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nexport { acquireLock } from \"../core/lock/lock.js\";\nexport { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry } from \"../core/schema/runtime-schema.js\";\nexport { EXIT_CODE } from \"../core/shared/constants.js\";\nexport { PmCliError } from \"../core/shared/errors.js\";\nexport { isTimestampLiteral, nowIso } from \"../core/shared/time.js\";\nexport { listAllFrontMatter, locateItem, readLocatedItem } from \"../core/store/item-store.js\";\nexport { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nexport { readSettings } from \"../core/store/settings.js\";\nexport {\n  renderCalendarMarkdown,\n  resolveCalendarOutputFormat,\n  runCalendar,\n  type CalendarOptions,\n  type CalendarResult,\n} from \"../cli/commands/calendar.js\";\nexport {\n  renderGuideMarkdown,\n  resolveGuideOutputFormat,\n  runGuide,\n  type GuideDepth,\n  type GuideOptions,\n  type GuideOutputFormat,\n  type GuideResult,\n} from \"../cli/commands/guide.js\";\nexport { runCompletion, type CompletionResult, type CompletionShell } from \"../cli/commands/completion.js\";\nexport {\n  runCommentsAudit,\n  type CommentsAuditEntry,\n  type CommentsAuditHistoryRow,\n  type CommentsAuditOptions,\n  type CommentsAuditResult,\n  type CommentsAuditSummary,\n  type CommentsAuditTypeSummary,\n} from \"../cli/commands/comments-audit.js\";\nexport {\n  runDedupeAudit,\n  type DedupeAuditCandidate,\n  type DedupeAuditCluster,\n  type DedupeAuditOptions,\n  type DedupeAuditResult,\n} from \"../cli/commands/dedupe-audit.js\";\nexport { runNormalize, type NormalizeCommandOptions, type NormalizeResult } from \"../cli/commands/normalize.js\";\nexport { runReindex, type ReindexOptions, type ReindexResult } from \"../cli/commands/reindex.js\";\nexport { runSearch, type SearchOptions, type SearchResult } from \"../cli/commands/search.js\";\nexport {\n  loadCreateTemplateOptions,\n  runTemplatesList,\n  runTemplatesSave,\n  runTemplatesShow,\n  type CreateTemplateOptions,\n  type TemplatesListResult,\n  type TemplatesSaveResult,\n  type TemplatesShowResult,\n} from \"../cli/commands/templates.js\";\nexport {\n  runTestRunsList,\n  runTestRunsLogs,\n  runTestRunsResume,\n  runTestRunsStatus,\n  runTestRunsStop,\n  type TestRunsListCommandOptions,\n  type TestRunsLogsCommandOptions,\n  type TestRunsResumeCommandOptions,\n  type TestRunsStopCommandOptions,\n} from \"../cli/commands/test-runs.js\";\nexport {\n  CONFIDENCE_TEXT_VALUES,\n  DEPENDENCY_KIND_VALUES,\n  BUILTIN_ITEM_TYPE_VALUES,\n  ISSUE_SEVERITY_VALUES,\n  ITEM_TYPE_VALUES,\n  RISK_VALUES,\n  STATUS_VALUES,\n} from \"../types/index.js\";\nexport type { GlobalOptions } from \"../core/shared/command-types.js\";\nexport type {\n  Dependency,\n  ItemDocument,\n  ItemMetadata,\n  ItemStatus,\n  ItemType,\n  LinkedDoc,\n  LinkedFile,\n  LinkedTest,\n  LogNote,\n  PmSettings,\n} from \"../types/index.js\";\n\nexport interface GetContractsOptions extends ContractsCommandOptions {\n  pmRoot?: string;\n  cwd?: string;\n  noExtensions?: boolean;\n  quiet?: boolean;\n  profile?: boolean;\n}\n\nexport interface WorkspaceContractsOptions {\n  extensionRegistrations?: ExtensionRegistrationRegistry | null;\n  noExtensions?: boolean;\n  cwd?: string;\n}\n\nexport interface WorkspaceContracts {\n  types: string[];\n  statuses: string[];\n  openStatus: string;\n  closeStatus: string;\n  canceledStatus: string;\n}\n\nexport async function getWorkspaceContracts(\n  pmRoot: string,\n  options: WorkspaceContractsOptions = {},\n): Promise<WorkspaceContracts> {\n  const settings = await readSettings(pmRoot);\n  const extensionRegistrations =\n    options.extensionRegistrations ??\n    (options.noExtensions === true ? null : await loadWorkspaceExtensionRegistrations(pmRoot, settings, options.cwd));\n  const typeRegistry = resolveItemTypeRegistry(settings, extensionRegistrations);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n\n  return {\n    types: [...typeRegistry.types],\n    statuses: statusRegistry.definitions.map((definition) => definition.id),\n    openStatus: statusRegistry.open_status,\n    closeStatus: statusRegistry.close_status,\n    canceledStatus: statusRegistry.canceled_status,\n  };\n}\n\nexport async function getContracts(\n  pmRootOrOptions?: string | GetContractsOptions,\n  options: GetContractsOptions = {},\n): Promise<ContractsResult> {\n  const resolvedOptions =\n    typeof pmRootOrOptions === \"string\"\n      ? { ...options, pmRoot: pmRootOrOptions }\n      : (pmRootOrOptions ?? options);\n  const global: GlobalOptions = {\n    json: true,\n    quiet: resolvedOptions.quiet ?? true,\n    noExtensions: resolvedOptions.noExtensions ?? false,\n    noPager: true,\n    profile: resolvedOptions.profile ?? false,\n    path: resolvedOptions.pmRoot,\n  };\n\n  return runContracts(resolvedOptions, global);\n}\n\nasync function loadWorkspaceExtensionRegistrations(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  cwd?: string,\n): Promise<ExtensionRegistrationRegistry | null> {\n  const loadResult = await loadExtensions({\n    pmRoot,\n    settings,\n    cwd: cwd ?? process.cwd(),\n    noExtensions: false,\n  });\n  const activationResult = await activateExtensions(loadResult);\n  return activationResult.registrations;\n}\n\nexport type { ContractsCommandOptions, ContractsResult };\n"],"names":[],"mappings":"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","debugId":"052ef5fb-9ab2-5bb7-96b0-f07bab9251b6"}
+{"version":3,"file":"runtime.js","sources":["sdk/runtime.ts"],"sourceRoot":"/","sourcesContent":["import {\n  activateExtensions,\n  loadExtensions,\n  type ExtensionRegistrationRegistry,\n} from \"../core/extensions/index.js\";\nimport type { GlobalOptions } from \"../core/shared/command-types.js\";\nimport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry } from \"../core/schema/runtime-schema.js\";\nimport { readSettings } from \"../core/store/settings.js\";\nimport {\n  runContracts,\n  type ContractsCommandOptions,\n  type ContractsResult,\n} from \"../cli/commands/contracts.js\";\n\nexport {\n  getActiveExtensionRegistrations,\n  runActiveOnReadHooks,\n  runActiveOnWriteHooks,\n} from \"../core/extensions/index.js\";\nexport { pathExists, readFileIfExists, removeFileIfExists, writeFileAtomic } from \"../core/fs/fs-utils.js\";\nexport { appendHistoryEntry, createHistoryEntry } from \"../core/history/history.js\";\nexport { generateItemId, normalizeItemId, normalizeRawItemId } from \"../core/item/id.js\";\nexport { readBooleanOption, readCsvListOption, readStringOption } from \"./package-runtime-options.js\";\nexport {\n  commitImportedItem,\n  emptyImportedDocument,\n  ensureTrackerInitialized,\n  selectImportAuthor,\n  toEstimatedMinutesValue,\n  toImportPriority,\n  toImportStatus,\n  toImportTags,\n  toNonEmptyImportString,\n  type CommitImportedItemParams,\n  type CommitImportedItemResult,\n} from \"./package-import-adapters.js\";\nexport {\n  canonicalDocument,\n  normalizeFrontMatter,\n  serializeItemDocument,\n  splitFrontMatter,\n} from \"../core/item/item-format.js\";\nexport { parseTags } from \"../core/item/parse.js\";\nexport { normalizeStatusInput } from \"../core/item/status.js\";\nexport { resolveItemTypeRegistry } from \"../core/item/type-registry.js\";\nexport { acquireLock } from \"../core/lock/lock.js\";\nexport { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry } from \"../core/schema/runtime-schema.js\";\nexport { EXIT_CODE } from \"../core/shared/constants.js\";\nexport { PmCliError } from \"../core/shared/errors.js\";\nexport { isTimestampLiteral, nowIso } from \"../core/shared/time.js\";\nexport { listAllFrontMatter, locateItem, readLocatedItem } from \"../core/store/item-store.js\";\nexport { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from \"../core/store/paths.js\";\nexport { readSettings } from \"../core/store/settings.js\";\nexport {\n  renderCalendarMarkdown,\n  resolveCalendarOutputFormat,\n  runCalendar,\n  type CalendarOptions,\n  type CalendarResult,\n} from \"../cli/commands/calendar.js\";\nexport {\n  renderGuideMarkdown,\n  resolveGuideOutputFormat,\n  runGuide,\n  type GuideDepth,\n  type GuideOptions,\n  type GuideOutputFormat,\n  type GuideResult,\n} from \"../cli/commands/guide.js\";\nexport { runCompletion, type CompletionResult, type CompletionShell } from \"../cli/commands/completion.js\";\nexport {\n  runCommentsAudit,\n  type CommentsAuditEntry,\n  type CommentsAuditHistoryRow,\n  type CommentsAuditOptions,\n  type CommentsAuditResult,\n  type CommentsAuditSummary,\n  type CommentsAuditTypeSummary,\n} from \"../cli/commands/comments-audit.js\";\nexport {\n  runDedupeAudit,\n  type DedupeAuditCandidate,\n  type DedupeAuditCluster,\n  type DedupeAuditOptions,\n  type DedupeAuditResult,\n} from \"../cli/commands/dedupe-audit.js\";\nexport { runNormalize, type NormalizeCommandOptions, type NormalizeResult } from \"../cli/commands/normalize.js\";\nexport { runReindex, type ReindexOptions, type ReindexResult } from \"../cli/commands/reindex.js\";\nexport { runSearch, type SearchOptions, type SearchResult } from \"../cli/commands/search.js\";\nexport {\n  loadCreateTemplateOptions,\n  runTemplatesList,\n  runTemplatesSave,\n  runTemplatesShow,\n  type CreateTemplateOptions,\n  type TemplatesListResult,\n  type TemplatesSaveResult,\n  type TemplatesShowResult,\n} from \"../cli/commands/templates.js\";\nexport {\n  runTestRunsList,\n  runTestRunsLogs,\n  runTestRunsResume,\n  runTestRunsStatus,\n  runTestRunsStop,\n  type TestRunsListCommandOptions,\n  type TestRunsLogsCommandOptions,\n  type TestRunsResumeCommandOptions,\n  type TestRunsStopCommandOptions,\n} from \"../cli/commands/test-runs.js\";\nexport {\n  CONFIDENCE_TEXT_VALUES,\n  DEPENDENCY_KIND_VALUES,\n  BUILTIN_ITEM_TYPE_VALUES,\n  ISSUE_SEVERITY_VALUES,\n  ITEM_TYPE_VALUES,\n  RISK_VALUES,\n  STATUS_VALUES,\n} from \"../types/index.js\";\nexport type { GlobalOptions } from \"../core/shared/command-types.js\";\nexport type {\n  Dependency,\n  ItemDocument,\n  ItemMetadata,\n  ItemStatus,\n  ItemType,\n  LinkedDoc,\n  LinkedFile,\n  LinkedTest,\n  LogNote,\n  PmSettings,\n} from \"../types/index.js\";\n\nexport interface GetContractsOptions extends ContractsCommandOptions {\n  pmRoot?: string;\n  cwd?: string;\n  noExtensions?: boolean;\n  quiet?: boolean;\n  profile?: boolean;\n}\n\nexport interface WorkspaceContractsOptions {\n  extensionRegistrations?: ExtensionRegistrationRegistry | null;\n  noExtensions?: boolean;\n  cwd?: string;\n}\n\nexport interface WorkspaceContracts {\n  types: string[];\n  statuses: string[];\n  openStatus: string;\n  closeStatus: string;\n  canceledStatus: string;\n}\n\nexport async function getWorkspaceContracts(\n  pmRoot: string,\n  options: WorkspaceContractsOptions = {},\n): Promise<WorkspaceContracts> {\n  const settings = await readSettings(pmRoot);\n  const extensionRegistrations =\n    options.extensionRegistrations ??\n    (options.noExtensions === true ? null : await loadWorkspaceExtensionRegistrations(pmRoot, settings, options.cwd));\n  const typeRegistry = resolveItemTypeRegistry(settings, extensionRegistrations);\n  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n\n  return {\n    types: [...typeRegistry.types],\n    statuses: statusRegistry.definitions.map((definition) => definition.id),\n    openStatus: statusRegistry.open_status,\n    closeStatus: statusRegistry.close_status,\n    canceledStatus: statusRegistry.canceled_status,\n  };\n}\n\nexport async function getContracts(\n  pmRootOrOptions?: string | GetContractsOptions,\n  options: GetContractsOptions = {},\n): Promise<ContractsResult> {\n  const resolvedOptions =\n    typeof pmRootOrOptions === \"string\"\n      ? { ...options, pmRoot: pmRootOrOptions }\n      : (pmRootOrOptions ?? options);\n  const global: GlobalOptions = {\n    json: true,\n    quiet: resolvedOptions.quiet ?? true,\n    noExtensions: resolvedOptions.noExtensions ?? false,\n    noPager: true,\n    profile: resolvedOptions.profile ?? false,\n    path: resolvedOptions.pmRoot,\n  };\n\n  return runContracts(resolvedOptions, global);\n}\n\nasync function loadWorkspaceExtensionRegistrations(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  cwd?: string,\n): Promise<ExtensionRegistrationRegistry | null> {\n  const loadResult = await loadExtensions({\n    pmRoot,\n    settings,\n    cwd: cwd ?? process.cwd(),\n    noExtensions: false,\n  });\n  const activationResult = await activateExtensions(loadResult);\n  return activationResult.registrations;\n}\n\nexport type { ContractsCommandOptions, ContractsResult };\n"],"names":[],"mappings":"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","debugId":"9dfba929-1fc6-569e-8311-91fc06f420bc"}

package/docs/AGENT_GUIDE.md

@@ -46,6 +46,8 @@ pm create --create-mode progressive \
 
 Priority accepts either numeric `0..4` or named aliases `critical`, `high`, `medium`, `low`, and `minimal`.
 
+Repeated singular/plural list flags accumulate, so `--tag a --tag b` is equivalent to `--tags a,b` (same for `--status` and `--fields` on read commands). You no longer have to pre-join values into one comma list.
+
 Create hierarchy from broad to narrow: `Epic` -> `Feature` -> `Task` or `Issue`. Use `--parent <id>` for child items.
 
 3. **Claim**
@@ -108,21 +110,15 @@ pm release <item-id>
 | Materialize plan steps | `pm plan materialize <plan-id> --steps plan-step-002 --materialize-type Task` |
 | Dependencies | `pm deps <id> --format tree` |
 | Local docs routing | `pm install guide-shell --project`, then `pm guide <topic>` |
+| Compact mutation echo | `pm --no-changed-fields create "..."` (drops the redundant `changed_fields` array, keeps `changed_field_count`) |
 
 Default TOON output is preferred for model-readable loops. Use `--json` only when strict parsing is needed.
 
-## Guide Routing for Agents
+Over MCP the mutation tools (`pm_create`/`pm_update`/`pm_close`, and `pm_run` for `append`/`update-many`) are already compact by default: they return `changed_field_count` instead of the full `changed_fields` array. Pass `options.full=true` only when you need the explicit field-level delta.
 
-Use `pm guide` as the local progressive-disclosure router after installing the optional `guide-shell` package:
+## Guide Routing for Agents
 
-```bash
-pm install guide-shell --project
-pm guide
-pm guide quickstart
-pm guide commands --depth standard
-pm guide skills --depth deep --format markdown
-pm guide release --json
-```
+Use the canonical [guide topic map](README.md#guide-topic-map) when local in-CLI documentation routing is useful.
 
 ## Ownership Rules
 

package/docs/CLAUDE_CODE_PLUGIN.md

@@ -42,32 +42,9 @@ pm-cli/ (repo root)
 
 The MCP server itself lives at `src/mcp/server.ts` (compiled to `dist/mcp/server.js`) and is bundled with the npm package as the `pm-mcp` binary.
 
-## MCP Server Tools
-
-The server exposes 18 native tools that call pm library functions directly:
-
-| Tool | pm Operation | Key Args |
-|------|-------------|----------|
-| `pm_context` | `pm context` | `options.limit`, `options.depth` |
-| `pm_search` | `pm search` | `query` (required), `options.limit` |
-| `pm_list` | `pm list` | `options.status`, `options.type`, `options.limit` |
-| `pm_get` | `pm get` | `id` (required) |
-| `pm_create` | `pm create` | `options.title`, `options.description`, `options.type` |
-| `pm_update` | `pm update` | `id` (required), `options.*` |
-| `pm_claim` | `pm claim` | `id` (required), `force` |
-| `pm_release` | `pm release` | `id` (required), `force` |
-| `pm_close` | `pm close` | `id` (required), `reason` (required) |
-| `pm_comments` | `pm comments` | `id` (required), `options.add` |
-| `pm_files` | `pm files` | `id` (required), `options.add`, `options.remove` |
-| `pm_docs` | `pm docs` | `id` (required), `options.add`, `options.remove` |
-| `pm_test` | `pm test` | `id` (required), `options.add`, `options.run` |
-| `pm_validate` | `pm validate` | `options.checkResolution`, `options.checkFiles` |
-| `pm_health` | `pm health` | `options.checkOnly` |
-| `pm_contracts` | `pm contracts` | `options.command`, `options.json` |
-| `pm_plan` | `pm plan` | `options.subcommand`, `id`, `stepRef` |
-| `pm_run` | any pm action | `action` (required), `id`, `query`, `reason`, `options.*` |
-
-All tools accept `cwd` (workspace directory), `path` (pm data root override), and `author` (mutation author).
+## Capability Inventory
+
+The canonical user-facing inventory for MCP tools, slash commands, skills, subagents, and `pm_run` actions lives in [`plugins/pm-claude/README.md`](../plugins/pm-claude/README.md). This page focuses on architecture, launcher behavior, and smoke-test expectations so capability counts do not drift between docs.
 
 ## Installation Methods
 
@@ -80,7 +57,7 @@ Add the pm-cli GitHub repo as a marketplace source, then install:
 /plugin install pm-claude@pm
 ```
 
-This clones the repo, reads `.claude-plugin/marketplace.json` at the root, installs the plugin from `./plugins/pm-claude/`, and configures the MCP server, 5 skills, 9 slash commands, and the session hook automatically.
+This clones the repo, reads `.claude-plugin/marketplace.json` at the root, installs the plugin from `./plugins/pm-claude/`, and configures the MCP server, skills, slash commands, subagents, and the session hook automatically.
 
 ### 2. Global MCP via Claude Code CLI (MCP tools only)
 
@@ -146,7 +123,7 @@ node scripts/smoke-claude-plugin.mjs
 pnpm smoke:claude-plugin
 ```
 
-Verifies: file structure (23 files), manifest name consistency, MCP initialize, 18 tools present, full workflow (init → create → claim → update → link files/docs/tests → get → context → search → validate → health), and session-start hook.
+Verifies: plugin file structure, manifest name consistency, MCP initialize, 18 tools present, full workflow (init → create → claim → update → link files/docs/tests → get → context → search → validate → health), and session-start hook.
 
 ### MCP server smoke test
 

package/docs/CODEX_PLUGIN.md

@@ -12,11 +12,11 @@ Restart Codex and install **pm CLI** from the `pm CLI Local` marketplace.
 
 ## What It Provides
 
-- `pm-mcp` MCP server for structured pm operations without invoking the `pm` shell command
-- narrow tools for common loops: context, search, list, get, create, update, claim, release, close, comments, files, docs, tests, validate, health, contracts, and guide
-- `pm_run` for the rest of the pm surface, including calendar, activity, aggregate, dedupe-audit, normalize, reindex, extensions, templates, history, stats, gc, and test-runs controls
-- skills for native tracking, audits, and release workflows
-- command prompts for start, close, and audit flows
+The canonical tool, skill, command, and safety inventory lives in the plugin README:
+
+- [pm CLI Codex Plugin](../plugins/pm-codex/README.md)
+
+Keep this page as the public docs router so the MCP tool/action list has one maintained source.
 
 ## Native MCP Notes