@unbrained/pm-cli 2026.7.2 → 2026.7.4

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

@@ -13,7 +13,7 @@
  * 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]="181a7b79-ce2a-5874-96db-7beb948a9859")}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]="75dc8e31-81cb-5c87-93a6-b4fa03327a18")}catch(e){}}();
 import { appendHistoryEntry, createHistoryEntry } from "../core/history/history.js";
 import { acquireLock } from "../core/lock/lock.js";
 import { parseTags } from "../core/item/parse.js";
@@ -94,6 +94,143 @@ export function toImportStatus(value) {
     }
     return "open";
 }
+/**
+ * Coerces a finite integer from a number or non-empty numeric string.
+ */
+export function toImportInteger(value) {
+    if (typeof value === "number" && Number.isInteger(value)) {
+        return value;
+    }
+    if (typeof value !== "string" || value.trim().length === 0) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isInteger(parsed) ? parsed : undefined;
+}
+/**
+ * Coerces common boolean representations used by external package formats.
+ */
+export function toImportBoolean(value) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        return value === 1 ? true : value === 0 ? false : undefined;
+    }
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true" || normalized === "1") {
+        return true;
+    }
+    return normalized === "false" || normalized === "0" ? false : undefined;
+}
+/**
+ * Coerces an array of non-empty strings.
+ */
+export function toImportStringList(value) {
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    const entries = value
+        .map((entry) => toNonEmptyImportString(entry))
+        .filter((entry) => entry !== undefined);
+    return entries.length > 0 ? entries : undefined;
+}
+/**
+ * Coerces a record of non-empty string values.
+ */
+export function toImportStringMap(value) {
+    return toImportValueMap(value, toNonEmptyImportString);
+}
+/**
+ * Coerces a record of finite numeric values.
+ */
+export function toImportNumberMap(value) {
+    return toImportValueMap(value, toImportFiniteNumber);
+}
+/**
+ * Maps a loose source confidence value onto pm's confidence field.
+ */
+export function toImportConfidence(value, allowedTextValues) {
+    if (typeof value === "number" && Number.isInteger(value) && value >= 0 && value <= 100) {
+        return value;
+    }
+    const normalized = toNonEmptyImportString(value)?.toLowerCase();
+    if (!normalized) {
+        return undefined;
+    }
+    const candidate = normalized === "med" ? "medium" : normalized;
+    if (allowedTextValues.some((entry) => entry === candidate)) {
+        return candidate;
+    }
+    const parsed = Number(candidate);
+    return Number.isInteger(parsed) && parsed >= 0 && parsed <= 100 ? parsed : undefined;
+}
+/**
+ * Maps a string onto an allowed enum value, including the common "med" alias.
+ */
+export function toImportNormalizedEnum(value, allowed) {
+    const normalized = toNonEmptyImportString(value)?.toLowerCase();
+    if (!normalized) {
+        return undefined;
+    }
+    const candidate = normalized === "med" ? "medium" : normalized;
+    return allowed.includes(candidate) ? candidate : undefined;
+}
+/**
+ * Resolves pm linked-artifact scope values, defaulting to project scope.
+ */
+export function toImportLinkScope(value) {
+    return toNonEmptyImportString(value)?.toLowerCase() === "global" ? "global" : "project";
+}
+/**
+ * Converts source comments, notes, or learnings into pm log notes.
+ */
+export function toImportLogEntries(value, options) {
+    const values = normalizeImportCollection(value, options.allowScalar === true);
+    if (!values) {
+        return undefined;
+    }
+    const entries = values
+        .map((entry) => toImportLogEntry(entry, options))
+        .filter((entry) => entry !== undefined);
+    return entries.length > 0 ? entries : undefined;
+}
+/**
+ * Converts source file artifacts into pm linked files.
+ */
+export function toImportLinkedFiles(value, options = {}) {
+    return toImportLinkedArtifacts(value, options, (pathValue, record) => ({
+        path: pathValue,
+        scope: toImportLinkScope(record?.scope),
+        note: toNonEmptyImportString(record?.note),
+    }));
+}
+/**
+ * Converts source doc artifacts into pm linked docs.
+ */
+export function toImportLinkedDocs(value, options = {}) {
+    return toImportLinkedArtifacts(value, options, (pathValue, record) => ({
+        path: pathValue,
+        scope: toImportLinkScope(record?.scope),
+        note: toNonEmptyImportString(record?.note),
+    }));
+}
+/**
+ * Converts source test artifacts into pm linked tests.
+ */
+export function toImportLinkedTests(value, options = {}) {
+    const values = normalizeImportCollection(value, options.allowScalar === true);
+    if (!values) {
+        return undefined;
+    }
+    const entries = values
+        .map((entry) => toImportLinkedTest(entry, options))
+        .filter((entry) => entry !== undefined);
+    return entries.length > 0 ? entries : undefined;
+}
 /**
  * Resolves the effective import author: explicit flag, PM_AUTHOR, then settings,
  * falling back to "unknown".
@@ -110,6 +247,141 @@ export function selectImportAuthor(explicitAuthor, settingsAuthor) {
     const settings = settingsAuthor.trim();
     return settings.length > 0 ? settings : "unknown";
 }
+function isImportRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeImportCollection(value, allowScalar) {
+    if (Array.isArray(value)) {
+        return value;
+    }
+    return allowScalar ? [value] : undefined;
+}
+function firstNonEmptyImportString(record, keys) {
+    for (const key of keys) {
+        const value = toNonEmptyImportString(record[key]);
+        if (value) {
+            return value;
+        }
+    }
+    return undefined;
+}
+function toImportValueMap(value, coerce) {
+    if (!isImportRecord(value)) {
+        return undefined;
+    }
+    const entries = Object.entries(value)
+        .map(([key, entryValue]) => [key.trim(), coerce(entryValue)])
+        .filter((entry) => entry[0].length > 0 && entry[1] !== undefined);
+    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
+}
+function toImportLogEntry(entry, options) {
+    if (typeof entry === "string") {
+        return toImportLogEntryFromText(entry, options);
+    }
+    if (!isImportRecord(entry)) {
+        return undefined;
+    }
+    const text = firstNonEmptyImportString(entry, options.textKeys ?? ["text"]);
+    if (!text) {
+        return undefined;
+    }
+    const createdAtKey = options.createdAtKey ?? "created_at";
+    const authorKey = options.authorKey ?? "author";
+    const createdAt = (options.toIsoString ? options.toIsoString(entry[createdAtKey]) : toNonEmptyImportString(entry[createdAtKey])) ??
+        options.fallbackCreatedAt;
+    return {
+        created_at: createdAt,
+        author: toNonEmptyImportString(entry[authorKey]) ?? options.fallbackAuthor,
+        text,
+    };
+}
+function toImportLogEntryFromText(entry, options) {
+    const text = toNonEmptyImportString(entry);
+    return text
+        ? {
+            created_at: options.fallbackCreatedAt,
+            author: options.fallbackAuthor,
+            text,
+        }
+        : undefined;
+}
+function toImportLinkedArtifacts(value, options, build) {
+    const values = normalizeImportCollection(value, options.allowScalar === true);
+    if (!values) {
+        return undefined;
+    }
+    const pathKeys = options.pathKeys ?? ["path"];
+    const entries = values
+        .map((entry) => toImportLinkedArtifact(entry, pathKeys, build))
+        .filter((entry) => entry !== undefined);
+    return entries.length > 0 ? entries : undefined;
+}
+function toImportLinkedArtifact(entry, pathKeys, build) {
+    if (typeof entry === "string") {
+        const pathValue = toNonEmptyImportString(entry);
+        return pathValue ? build(pathValue) : undefined;
+    }
+    if (!isImportRecord(entry)) {
+        return undefined;
+    }
+    const pathValue = firstNonEmptyImportString(entry, pathKeys);
+    return pathValue ? build(pathValue, entry) : undefined;
+}
+function toImportLinkedTest(entry, options) {
+    if (typeof entry === "string") {
+        const command = toNonEmptyImportString(entry);
+        return command ? { command, scope: "project" } : undefined;
+    }
+    if (!isImportRecord(entry)) {
+        return undefined;
+    }
+    const command = firstNonEmptyImportString(entry, options.commandKeys ?? ["command"]);
+    const testPath = firstNonEmptyImportString(entry, options.pathKeys ?? ["path"]);
+    if (!command && (options.requireCommand === true || !testPath)) {
+        return undefined;
+    }
+    return {
+        ...(command ? { command } : {}),
+        ...(testPath ? { path: testPath } : {}),
+        scope: toImportLinkScope(entry.scope),
+        timeout_seconds: toImportLinkedTestTimeout(entry.timeout_seconds, options),
+        note: toNonEmptyImportString(entry.note),
+        ...(options.includeExtendedAssertions === true ? toImportLinkedTestAssertions(entry) : {}),
+    };
+}
+function toImportLinkedTestTimeout(value, options) {
+    const parsed = options.integerTimeout === true ? toImportInteger(value) : toImportFiniteNumber(value);
+    if (parsed === undefined) {
+        return undefined;
+    }
+    const minimum = options.timeoutMinimum ?? 0;
+    return options.timeoutExclusiveMinimum === true ? (parsed > minimum ? parsed : undefined) : parsed >= minimum ? parsed : undefined;
+}
+function toImportFiniteNumber(value) {
+    if (typeof value === "number" && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value !== "string" || value.trim().length === 0) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function toImportLinkedTestAssertions(entry) {
+    return {
+        pm_context_mode: toImportNormalizedEnum(entry.pm_context_mode, ["schema", "tracker", "auto"]),
+        env_set: toImportStringMap(entry.env_set),
+        env_clear: toImportStringList(entry.env_clear),
+        shared_host_safe: toImportBoolean(entry.shared_host_safe),
+        assert_stdout_contains: toImportStringList(entry.assert_stdout_contains),
+        assert_stdout_regex: toImportStringList(entry.assert_stdout_regex),
+        assert_stderr_contains: toImportStringList(entry.assert_stderr_contains),
+        assert_stderr_regex: toImportStringList(entry.assert_stderr_regex),
+        assert_stdout_min_lines: toImportInteger(entry.assert_stdout_min_lines),
+        assert_json_field_equals: toImportStringMap(entry.assert_json_field_equals),
+        assert_json_field_gte: toImportNumberMap(entry.assert_json_field_gte),
+    };
+}
 /**
  * Throws a NOT_FOUND PmCliError when the tracker has not been initialized.
  */
@@ -194,4 +466,4 @@ export async function commitImportedItem(params) {
     }
 }
 //# sourceMappingURL=package-import-adapters.js.map
-//# debugId=181a7b79-ce2a-5874-96db-7beb948a9859
+//# debugId=75dc8e31-81cb-5c87-93a6-b4fa03327a18

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

@@ -1 +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\n/**\n * Documents the commit imported item params payload exchanged by command, SDK, and package integrations.\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\n/**\n * Restricts commit imported item result values accepted by command, SDK, and storage contracts.\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  const beforeDocument = emptyImportedDocument();\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: beforeDocument,\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            item_id: document.metadata.id,\n            item_type: document.metadata.type,\n            before: beforeDocument,\n            after: document,\n            changed_fields: [\"imported\"],\n          })),\n          ...(await runActiveOnWriteHooks({\n            path: historyPath,\n            scope: \"project\",\n            op: \"import:history\",\n            item_id: document.metadata.id,\n            item_type: document.metadata.type,\n            before: beforeDocument,\n            after: document,\n            changed_fields: [\"imported\"],\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":"181a7b79-ce2a-5874-96db-7beb948a9859"}
+{"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 {\n  Dependency,\n  ConfidenceTextLevel,\n  ItemDocument,\n  ItemMetadata,\n  ItemStatus,\n  LinkedDoc,\n  LinkedFile,\n  LinkedTest,\n  LogNote,\n  PmSettings,\n} from \"../types/index.js\";\n\n/**\n * Restricts shared import priority values accepted by import adapters.\n */\nexport type ImportPriorityValue = 0 | 1 | 2 | 3 | 4;\n\n/**\n * Restricts import linked-artifact scopes accepted by bundled package adapters.\n */\nexport type ImportLinkedScope = \"project\" | \"global\";\n\n/**\n * Configures conversion of loosely shaped source comments into pm log entries.\n */\nexport interface ToImportLogEntriesOptions {\n  fallbackCreatedAt: string;\n  fallbackAuthor: string;\n  allowScalar?: boolean;\n  textKeys?: readonly string[];\n  createdAtKey?: string;\n  authorKey?: string;\n  toIsoString?: (value: unknown) => string | undefined;\n}\n\n/**\n * Configures conversion of loosely shaped source file/doc arrays into pm linked artifacts.\n */\nexport interface ToImportLinkedArtifactsOptions {\n  allowScalar?: boolean;\n  pathKeys?: readonly string[];\n}\n\n/**\n * Configures conversion of loosely shaped source test arrays into pm linked tests.\n */\nexport interface ToImportLinkedTestsOptions {\n  allowScalar?: boolean;\n  commandKeys?: readonly string[];\n  pathKeys?: readonly string[];\n  requireCommand?: boolean;\n  includeExtendedAssertions?: boolean;\n  integerTimeout?: boolean;\n  timeoutMinimum?: number;\n  timeoutExclusiveMinimum?: boolean;\n}\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): ImportPriorityValue {\n  if (typeof value === \"number\" && Number.isInteger(value) && value >= 0 && value <= 4) {\n    return value as ImportPriorityValue;\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 ImportPriorityValue;\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 * Coerces a finite integer from a number or non-empty numeric string.\n */\nexport function toImportInteger(value: unknown): number | undefined {\n  if (typeof value === \"number\" && Number.isInteger(value)) {\n    return value;\n  }\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    return undefined;\n  }\n  const parsed = Number(value);\n  return Number.isInteger(parsed) ? parsed : undefined;\n}\n\n/**\n * Coerces common boolean representations used by external package formats.\n */\nexport function toImportBoolean(value: unknown): boolean | undefined {\n  if (typeof value === \"boolean\") {\n    return value;\n  }\n  if (typeof value === \"number\") {\n    return value === 1 ? true : value === 0 ? false : undefined;\n  }\n  if (typeof value !== \"string\") {\n    return undefined;\n  }\n  const normalized = value.trim().toLowerCase();\n  if (normalized === \"true\" || normalized === \"1\") {\n    return true;\n  }\n  return normalized === \"false\" || normalized === \"0\" ? false : undefined;\n}\n\n/**\n * Coerces an array of non-empty strings.\n */\nexport function toImportStringList(value: unknown): string[] | undefined {\n  if (!Array.isArray(value)) {\n    return undefined;\n  }\n  const entries = value\n    .map((entry) => toNonEmptyImportString(entry))\n    .filter((entry): entry is string => entry !== undefined);\n  return entries.length > 0 ? entries : undefined;\n}\n\n/**\n * Coerces a record of non-empty string values.\n */\nexport function toImportStringMap(value: unknown): Record<string, string> | undefined {\n  return toImportValueMap(value, toNonEmptyImportString);\n}\n\n/**\n * Coerces a record of finite numeric values.\n */\nexport function toImportNumberMap(value: unknown): Record<string, number> | undefined {\n  return toImportValueMap(value, toImportFiniteNumber);\n}\n\n/**\n * Maps a loose source confidence value onto pm's confidence field.\n */\nexport function toImportConfidence(\n  value: unknown,\n  allowedTextValues: readonly ConfidenceTextLevel[],\n): ItemMetadata[\"confidence\"] | undefined {\n  if (typeof value === \"number\" && Number.isInteger(value) && value >= 0 && value <= 100) {\n    return value;\n  }\n  const normalized = toNonEmptyImportString(value)?.toLowerCase();\n  if (!normalized) {\n    return undefined;\n  }\n  const candidate = normalized === \"med\" ? \"medium\" : normalized;\n  if (allowedTextValues.some((entry) => entry === candidate)) {\n    return candidate as ConfidenceTextLevel;\n  }\n  const parsed = Number(candidate);\n  return Number.isInteger(parsed) && parsed >= 0 && parsed <= 100 ? parsed : undefined;\n}\n\n/**\n * Maps a string onto an allowed enum value, including the common \"med\" alias.\n */\nexport function toImportNormalizedEnum<T extends readonly string[]>(\n  value: unknown,\n  allowed: T,\n): T[number] | undefined {\n  const normalized = toNonEmptyImportString(value)?.toLowerCase();\n  if (!normalized) {\n    return undefined;\n  }\n  const candidate = normalized === \"med\" ? \"medium\" : normalized;\n  return allowed.includes(candidate as T[number]) ? (candidate as T[number]) : undefined;\n}\n\n/**\n * Resolves pm linked-artifact scope values, defaulting to project scope.\n */\nexport function toImportLinkScope(value: unknown): ImportLinkedScope {\n  return toNonEmptyImportString(value)?.toLowerCase() === \"global\" ? \"global\" : \"project\";\n}\n\n/**\n * Converts source comments, notes, or learnings into pm log notes.\n */\nexport function toImportLogEntries(value: unknown, options: ToImportLogEntriesOptions): LogNote[] | undefined {\n  const values = normalizeImportCollection(value, options.allowScalar === true);\n  if (!values) {\n    return undefined;\n  }\n  const entries = values\n    .map((entry) => toImportLogEntry(entry, options))\n    .filter((entry): entry is LogNote => entry !== undefined);\n  return entries.length > 0 ? entries : undefined;\n}\n\n/**\n * Converts source file artifacts into pm linked files.\n */\nexport function toImportLinkedFiles(value: unknown, options: ToImportLinkedArtifactsOptions = {}): LinkedFile[] | undefined {\n  return toImportLinkedArtifacts(value, options, (pathValue, record) => ({\n    path: pathValue,\n    scope: toImportLinkScope(record?.scope),\n    note: toNonEmptyImportString(record?.note),\n  }));\n}\n\n/**\n * Converts source doc artifacts into pm linked docs.\n */\nexport function toImportLinkedDocs(value: unknown, options: ToImportLinkedArtifactsOptions = {}): LinkedDoc[] | undefined {\n  return toImportLinkedArtifacts(value, options, (pathValue, record) => ({\n    path: pathValue,\n    scope: toImportLinkScope(record?.scope),\n    note: toNonEmptyImportString(record?.note),\n  }));\n}\n\n/**\n * Converts source test artifacts into pm linked tests.\n */\nexport function toImportLinkedTests(value: unknown, options: ToImportLinkedTestsOptions = {}): LinkedTest[] | undefined {\n  const values = normalizeImportCollection(value, options.allowScalar === true);\n  if (!values) {\n    return undefined;\n  }\n  const entries = values\n    .map((entry) => toImportLinkedTest(entry, options))\n    .filter((entry): entry is LinkedTest => entry !== undefined);\n  return entries.length > 0 ? entries : undefined;\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\nfunction isImportRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction normalizeImportCollection(value: unknown, allowScalar: boolean): unknown[] | undefined {\n  if (Array.isArray(value)) {\n    return value;\n  }\n  return allowScalar ? [value] : undefined;\n}\n\nfunction firstNonEmptyImportString(record: Record<string, unknown>, keys: readonly string[]): string | undefined {\n  for (const key of keys) {\n    const value = toNonEmptyImportString(record[key]);\n    if (value) {\n      return value;\n    }\n  }\n  return undefined;\n}\n\nfunction toImportValueMap<T>(\n  value: unknown,\n  coerce: (entryValue: unknown) => T | undefined,\n): Record<string, T> | undefined {\n  if (!isImportRecord(value)) {\n    return undefined;\n  }\n  const entries = Object.entries(value)\n    .map(([key, entryValue]) => [key.trim(), coerce(entryValue)] as const)\n    .filter((entry): entry is readonly [string, T] => entry[0].length > 0 && entry[1] !== undefined);\n  return entries.length > 0 ? Object.fromEntries(entries) : undefined;\n}\n\nfunction toImportLogEntry(entry: unknown, options: ToImportLogEntriesOptions): LogNote | undefined {\n  if (typeof entry === \"string\") {\n    return toImportLogEntryFromText(entry, options);\n  }\n  if (!isImportRecord(entry)) {\n    return undefined;\n  }\n  const text = firstNonEmptyImportString(entry, options.textKeys ?? [\"text\"]);\n  if (!text) {\n    return undefined;\n  }\n  const createdAtKey = options.createdAtKey ?? \"created_at\";\n  const authorKey = options.authorKey ?? \"author\";\n  const createdAt =\n    (options.toIsoString ? options.toIsoString(entry[createdAtKey]) : toNonEmptyImportString(entry[createdAtKey])) ??\n    options.fallbackCreatedAt;\n  return {\n    created_at: createdAt,\n    author: toNonEmptyImportString(entry[authorKey]) ?? options.fallbackAuthor,\n    text,\n  };\n}\n\nfunction toImportLogEntryFromText(entry: string, options: ToImportLogEntriesOptions): LogNote | undefined {\n  const text = toNonEmptyImportString(entry);\n  return text\n    ? {\n        created_at: options.fallbackCreatedAt,\n        author: options.fallbackAuthor,\n        text,\n      }\n    : undefined;\n}\n\nfunction toImportLinkedArtifacts<T>(\n  value: unknown,\n  options: ToImportLinkedArtifactsOptions,\n  build: (pathValue: string, record?: Record<string, unknown>) => T,\n): T[] | undefined {\n  const values = normalizeImportCollection(value, options.allowScalar === true);\n  if (!values) {\n    return undefined;\n  }\n  const pathKeys = options.pathKeys ?? [\"path\"];\n  const entries = values\n    .map((entry) => toImportLinkedArtifact(entry, pathKeys, build))\n    .filter((entry): entry is T => entry !== undefined);\n  return entries.length > 0 ? entries : undefined;\n}\n\nfunction toImportLinkedArtifact<T>(\n  entry: unknown,\n  pathKeys: readonly string[],\n  build: (pathValue: string, record?: Record<string, unknown>) => T,\n): T | undefined {\n  if (typeof entry === \"string\") {\n    const pathValue = toNonEmptyImportString(entry);\n    return pathValue ? build(pathValue) : undefined;\n  }\n  if (!isImportRecord(entry)) {\n    return undefined;\n  }\n  const pathValue = firstNonEmptyImportString(entry, pathKeys);\n  return pathValue ? build(pathValue, entry) : undefined;\n}\n\nfunction toImportLinkedTest(entry: unknown, options: ToImportLinkedTestsOptions): LinkedTest | undefined {\n  if (typeof entry === \"string\") {\n    const command = toNonEmptyImportString(entry);\n    return command ? { command, scope: \"project\" } : undefined;\n  }\n  if (!isImportRecord(entry)) {\n    return undefined;\n  }\n  const command = firstNonEmptyImportString(entry, options.commandKeys ?? [\"command\"]);\n  const testPath = firstNonEmptyImportString(entry, options.pathKeys ?? [\"path\"]);\n  if (!command && (options.requireCommand === true || !testPath)) {\n    return undefined;\n  }\n  return {\n    ...(command ? { command } : {}),\n    ...(testPath ? { path: testPath } : {}),\n    scope: toImportLinkScope(entry.scope),\n    timeout_seconds: toImportLinkedTestTimeout(entry.timeout_seconds, options),\n    note: toNonEmptyImportString(entry.note),\n    ...(options.includeExtendedAssertions === true ? toImportLinkedTestAssertions(entry) : {}),\n  };\n}\n\nfunction toImportLinkedTestTimeout(value: unknown, options: ToImportLinkedTestsOptions): number | undefined {\n  const parsed = options.integerTimeout === true ? toImportInteger(value) : toImportFiniteNumber(value);\n  if (parsed === undefined) {\n    return undefined;\n  }\n  const minimum = options.timeoutMinimum ?? 0;\n  return options.timeoutExclusiveMinimum === true ? (parsed > minimum ? parsed : undefined) : parsed >= minimum ? parsed : undefined;\n}\n\nfunction toImportFiniteNumber(value: unknown): number | undefined {\n  if (typeof value === \"number\" && Number.isFinite(value)) {\n    return value;\n  }\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    return undefined;\n  }\n  const parsed = Number(value);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction toImportLinkedTestAssertions(entry: Record<string, unknown>): Partial<LinkedTest> {\n  return {\n    pm_context_mode: toImportNormalizedEnum(entry.pm_context_mode, [\"schema\", \"tracker\", \"auto\"] as const),\n    env_set: toImportStringMap(entry.env_set),\n    env_clear: toImportStringList(entry.env_clear),\n    shared_host_safe: toImportBoolean(entry.shared_host_safe),\n    assert_stdout_contains: toImportStringList(entry.assert_stdout_contains),\n    assert_stdout_regex: toImportStringList(entry.assert_stdout_regex),\n    assert_stderr_contains: toImportStringList(entry.assert_stderr_contains),\n    assert_stderr_regex: toImportStringList(entry.assert_stderr_regex),\n    assert_stdout_min_lines: toImportInteger(entry.assert_stdout_min_lines),\n    assert_json_field_equals: toImportStringMap(entry.assert_json_field_equals),\n    assert_json_field_gte: toImportNumberMap(entry.assert_json_field_gte),\n  };\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\n/**\n * Documents the commit imported item params payload exchanged by command, SDK, and package integrations.\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\n/**\n * Restricts commit imported item result values accepted by command, SDK, and storage contracts.\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  const beforeDocument = emptyImportedDocument();\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: beforeDocument,\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            item_id: document.metadata.id,\n            item_type: document.metadata.type,\n            before: beforeDocument,\n            after: document,\n            changed_fields: [\"imported\"],\n          })),\n          ...(await runActiveOnWriteHooks({\n            path: historyPath,\n            scope: \"project\",\n            op: \"import:history\",\n            item_id: document.metadata.id,\n            item_type: document.metadata.type,\n            before: beforeDocument,\n            after: document,\n            changed_fields: [\"imported\"],\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":"75dc8e31-81cb-5c87-93a6-b4fa03327a18"}

package/dist/sdk/runtime.d.ts

@@ -6,7 +6,7 @@ export { appendHistoryEntry, createHistoryEntry } from "../core/history/history.
 export { generateItemId, normalizeItemId, normalizeRawItemId } from "../core/item/id.js";
 export { readBooleanOption, readCsvListOption, readStringOption } from "./package-runtime-options.js";
 export { PM_CLI_EXPECTED_ERROR_NAME, createPmCliExpectedError, isPmCliExpectedError, type CreatePmCliExpectedErrorOptions, type PmCliExpectedError, } from "./errors.js";
-export { commitImportedItem, emptyImportedDocument, ensureTrackerInitialized, selectImportAuthor, toEstimatedMinutesValue, toImportPriority, toImportStatus, toImportTags, toNonEmptyImportString, type CommitImportedItemParams, type CommitImportedItemResult, } from "./package-import-adapters.js";
+export { commitImportedItem, emptyImportedDocument, ensureTrackerInitialized, selectImportAuthor, toEstimatedMinutesValue, toImportBoolean, toImportConfidence, toImportInteger, toImportLinkedDocs, toImportLinkedFiles, toImportLinkedTests, toImportLogEntries, toImportNormalizedEnum, toImportNumberMap, toImportPriority, toImportStatus, toImportStringList, toImportStringMap, toImportTags, toNonEmptyImportString, type CommitImportedItemParams, type CommitImportedItemResult, type ImportLinkedScope, type ImportPriorityValue, type ToImportLinkedArtifactsOptions, type ToImportLinkedTestsOptions, type ToImportLogEntriesOptions, } from "./package-import-adapters.js";
 export { canonicalDocument, normalizeFrontMatter, serializeItemDocument, splitFrontMatter, } from "../core/item/item-format.js";
 export { BASELINE_ITEM_FORMAT_VERSION, CURRENT_ITEM_FORMAT_VERSION, classifyItemFormatVersion, effectiveItemFormatVersion, normalizeItemFormatVersion, scanItemFormatVersions, type ItemFormatVersionScanEntry, type ItemFormatVersionScanResult, type ItemFormatVersionStatus, } from "../core/item/item-format-version.js";
 export { parseTags } from "../core/item/parse.js";

package/dist/sdk/runtime.js

@@ -4,7 +4,7 @@
  * Defines public SDK APIs and package-author helpers for Runtime.
  */
 
-!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]="71dfb59e-b26e-5bac-b1ad-498489f858ec")}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]="9ed0f12b-4f84-58a2-86c7-aff1a8b86f0a")}catch(e){}}();
 import path from "node:path";
 import { activateExtensions, loadExtensions, } from "../core/extensions/index.js";
 import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
@@ -17,7 +17,7 @@ export { appendHistoryEntry, createHistoryEntry } from "../core/history/history.
 export { generateItemId, normalizeItemId, normalizeRawItemId } from "../core/item/id.js";
 export { readBooleanOption, readCsvListOption, readStringOption } from "./package-runtime-options.js";
 export { PM_CLI_EXPECTED_ERROR_NAME, createPmCliExpectedError, isPmCliExpectedError, } from "./errors.js";
-export { commitImportedItem, emptyImportedDocument, ensureTrackerInitialized, selectImportAuthor, toEstimatedMinutesValue, toImportPriority, toImportStatus, toImportTags, toNonEmptyImportString, } from "./package-import-adapters.js";
+export { commitImportedItem, emptyImportedDocument, ensureTrackerInitialized, selectImportAuthor, toEstimatedMinutesValue, toImportBoolean, toImportConfidence, toImportInteger, toImportLinkedDocs, toImportLinkedFiles, toImportLinkedTests, toImportLogEntries, toImportNormalizedEnum, toImportNumberMap, toImportPriority, toImportStatus, toImportStringList, toImportStringMap, toImportTags, toNonEmptyImportString, } from "./package-import-adapters.js";
 export { canonicalDocument, normalizeFrontMatter, serializeItemDocument, splitFrontMatter, } from "../core/item/item-format.js";
 export { BASELINE_ITEM_FORMAT_VERSION, CURRENT_ITEM_FORMAT_VERSION, classifyItemFormatVersion, effectiveItemFormatVersion, normalizeItemFormatVersion, scanItemFormatVersions, } from "../core/item/item-format-version.js";
 export { parseTags } from "../core/item/parse.js";
@@ -135,4 +135,4 @@ async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
     return activationResult.registrations;
 }
 //# sourceMappingURL=runtime.js.map
-//# debugId=71dfb59e-b26e-5bac-b1ad-498489f858ec
+//# debugId=9ed0f12b-4f84-58a2-86c7-aff1a8b86f0a

package/dist/sdk/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sources":["sdk/runtime.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/runtime\n *\n * Defines public SDK APIs and package-author helpers for Runtime.\n */\nimport path from \"node:path\";\nimport {\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  PM_CLI_EXPECTED_ERROR_NAME,\n  createPmCliExpectedError,\n  isPmCliExpectedError,\n  type CreatePmCliExpectedErrorOptions,\n  type PmCliExpectedError,\n} from \"./errors.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 {\n  BASELINE_ITEM_FORMAT_VERSION,\n  CURRENT_ITEM_FORMAT_VERSION,\n  classifyItemFormatVersion,\n  effectiveItemFormatVersion,\n  normalizeItemFormatVersion,\n  scanItemFormatVersions,\n  type ItemFormatVersionScanEntry,\n  type ItemFormatVersionScanResult,\n  type ItemFormatVersionStatus,\n} from \"../core/item/item-format-version.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  renderCalendarToon,\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 {\n  runDedupeMerge,\n  type DedupeMergeChildReparent,\n  type DedupeMergeCloseAction,\n  type DedupeMergeDuplicateOutcome,\n  type DedupeMergeOptions,\n  type DedupeMergeResult,\n} from \"../cli/commands/dedupe-merge.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\n/**\n * Documents the get contracts options payload exchanged by command, SDK, and package integrations.\n */\nexport interface GetContractsOptions extends ContractsCommandOptions {\n  pmRoot?: string;\n  cwd?: string;\n  noExtensions?: boolean;\n  quiet?: boolean;\n  profile?: boolean;\n}\n\n/**\n * Documents the workspace contracts options payload exchanged by command, SDK, and package integrations.\n */\nexport interface WorkspaceContractsOptions {\n  extensionRegistrations?: ExtensionRegistrationRegistry | null;\n  noExtensions?: boolean;\n  cwd?: string;\n}\n\n/**\n * Documents the workspace contracts payload exchanged by command, SDK, and package integrations.\n */\nexport interface WorkspaceContracts {\n  types: string[];\n  statuses: string[];\n  openStatus: string;\n  closeStatus: string;\n  canceledStatus: string;\n}\n\n/**\n * Process-lifetime memo of activated extension registrations, keyed by resolved\n * pm root + cwd + extension settings. `getWorkspaceContracts` is frequently\n * called by importers and package runtimes that cannot thread a registry\n * through; without the memo each call re-discovers, re-imports, and re-activates\n * every extension.\n *\n * Invalidation story: entries are size-bounded and otherwise live until cleared.\n * One-shot CLI processes are trivially correct. Long-lived hosts (e.g. the MCP\n * server) must either pass `options.extensionRegistrations` (which bypasses the\n * memo) or call {@link clearWorkspaceContractsCache} after installing/removing/\n * toggling extensions or editing settings. Settings themselves are re-read on\n * every call — only the extension load+activate step is memoized.\n */\nconst WORKSPACE_CONTRACTS_CACHE_LIMIT = 50;\nconst workspaceExtensionRegistrationsCache = new Map<string, Promise<ExtensionRegistrationRegistry | null>>();\n\nfunction buildWorkspaceExtensionRegistrationsCacheKey(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  cwd?: string,\n): string {\n  return JSON.stringify([\n    path.resolve(pmRoot),\n    path.resolve(cwd ?? process.cwd()),\n    settings.extensions.enabled,\n    settings.extensions.disabled,\n    settings.extensions.policy,\n  ]);\n}\n\n/**\n * Drop all memoized workspace extension registrations so the next\n * `getWorkspaceContracts` call re-loads and re-activates extensions from disk.\n * Long-lived hosts should call this after any extension or settings mutation.\n */\nexport function clearWorkspaceContractsCache(): void {\n  workspaceExtensionRegistrationsCache.clear();\n}\n\nasync function resolveWorkspaceExtensionRegistrations(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  cwd?: string,\n): Promise<ExtensionRegistrationRegistry | null> {\n  const cacheKey = buildWorkspaceExtensionRegistrationsCacheKey(pmRoot, settings, cwd);\n  const cached = workspaceExtensionRegistrationsCache.get(cacheKey);\n  if (cached !== undefined) {\n    return cached;\n  }\n  if (workspaceExtensionRegistrationsCache.size >= WORKSPACE_CONTRACTS_CACHE_LIMIT) {\n    const oldestKey = workspaceExtensionRegistrationsCache.keys().next().value!;\n    workspaceExtensionRegistrationsCache.delete(oldestKey);\n  }\n  const registrations = loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd);\n  workspaceExtensionRegistrationsCache.set(cacheKey, registrations);\n  return registrations;\n}\n\n/**\n * Implements get workspace contracts for the public runtime surface of this module.\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 resolveWorkspaceExtensionRegistrations(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\n/**\n * Implements get contracts for the public runtime surface of this module.\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":"71dfb59e-b26e-5bac-b1ad-498489f858ec"}
+{"version":3,"file":"runtime.js","sources":["sdk/runtime.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/runtime\n *\n * Defines public SDK APIs and package-author helpers for Runtime.\n */\nimport path from \"node:path\";\nimport {\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  PM_CLI_EXPECTED_ERROR_NAME,\n  createPmCliExpectedError,\n  isPmCliExpectedError,\n  type CreatePmCliExpectedErrorOptions,\n  type PmCliExpectedError,\n} from \"./errors.js\";\nexport {\n  commitImportedItem,\n  emptyImportedDocument,\n  ensureTrackerInitialized,\n  selectImportAuthor,\n  toEstimatedMinutesValue,\n  toImportBoolean,\n  toImportConfidence,\n  toImportInteger,\n  toImportLinkedDocs,\n  toImportLinkedFiles,\n  toImportLinkedTests,\n  toImportLogEntries,\n  toImportNormalizedEnum,\n  toImportNumberMap,\n  toImportPriority,\n  toImportStatus,\n  toImportStringList,\n  toImportStringMap,\n  toImportTags,\n  toNonEmptyImportString,\n  type CommitImportedItemParams,\n  type CommitImportedItemResult,\n  type ImportLinkedScope,\n  type ImportPriorityValue,\n  type ToImportLinkedArtifactsOptions,\n  type ToImportLinkedTestsOptions,\n  type ToImportLogEntriesOptions,\n} from \"./package-import-adapters.js\";\nexport {\n  canonicalDocument,\n  normalizeFrontMatter,\n  serializeItemDocument,\n  splitFrontMatter,\n} from \"../core/item/item-format.js\";\nexport {\n  BASELINE_ITEM_FORMAT_VERSION,\n  CURRENT_ITEM_FORMAT_VERSION,\n  classifyItemFormatVersion,\n  effectiveItemFormatVersion,\n  normalizeItemFormatVersion,\n  scanItemFormatVersions,\n  type ItemFormatVersionScanEntry,\n  type ItemFormatVersionScanResult,\n  type ItemFormatVersionStatus,\n} from \"../core/item/item-format-version.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  renderCalendarToon,\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 {\n  runDedupeMerge,\n  type DedupeMergeChildReparent,\n  type DedupeMergeCloseAction,\n  type DedupeMergeDuplicateOutcome,\n  type DedupeMergeOptions,\n  type DedupeMergeResult,\n} from \"../cli/commands/dedupe-merge.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\n/**\n * Documents the get contracts options payload exchanged by command, SDK, and package integrations.\n */\nexport interface GetContractsOptions extends ContractsCommandOptions {\n  pmRoot?: string;\n  cwd?: string;\n  noExtensions?: boolean;\n  quiet?: boolean;\n  profile?: boolean;\n}\n\n/**\n * Documents the workspace contracts options payload exchanged by command, SDK, and package integrations.\n */\nexport interface WorkspaceContractsOptions {\n  extensionRegistrations?: ExtensionRegistrationRegistry | null;\n  noExtensions?: boolean;\n  cwd?: string;\n}\n\n/**\n * Documents the workspace contracts payload exchanged by command, SDK, and package integrations.\n */\nexport interface WorkspaceContracts {\n  types: string[];\n  statuses: string[];\n  openStatus: string;\n  closeStatus: string;\n  canceledStatus: string;\n}\n\n/**\n * Process-lifetime memo of activated extension registrations, keyed by resolved\n * pm root + cwd + extension settings. `getWorkspaceContracts` is frequently\n * called by importers and package runtimes that cannot thread a registry\n * through; without the memo each call re-discovers, re-imports, and re-activates\n * every extension.\n *\n * Invalidation story: entries are size-bounded and otherwise live until cleared.\n * One-shot CLI processes are trivially correct. Long-lived hosts (e.g. the MCP\n * server) must either pass `options.extensionRegistrations` (which bypasses the\n * memo) or call {@link clearWorkspaceContractsCache} after installing/removing/\n * toggling extensions or editing settings. Settings themselves are re-read on\n * every call — only the extension load+activate step is memoized.\n */\nconst WORKSPACE_CONTRACTS_CACHE_LIMIT = 50;\nconst workspaceExtensionRegistrationsCache = new Map<string, Promise<ExtensionRegistrationRegistry | null>>();\n\nfunction buildWorkspaceExtensionRegistrationsCacheKey(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  cwd?: string,\n): string {\n  return JSON.stringify([\n    path.resolve(pmRoot),\n    path.resolve(cwd ?? process.cwd()),\n    settings.extensions.enabled,\n    settings.extensions.disabled,\n    settings.extensions.policy,\n  ]);\n}\n\n/**\n * Drop all memoized workspace extension registrations so the next\n * `getWorkspaceContracts` call re-loads and re-activates extensions from disk.\n * Long-lived hosts should call this after any extension or settings mutation.\n */\nexport function clearWorkspaceContractsCache(): void {\n  workspaceExtensionRegistrationsCache.clear();\n}\n\nasync function resolveWorkspaceExtensionRegistrations(\n  pmRoot: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  cwd?: string,\n): Promise<ExtensionRegistrationRegistry | null> {\n  const cacheKey = buildWorkspaceExtensionRegistrationsCacheKey(pmRoot, settings, cwd);\n  const cached = workspaceExtensionRegistrationsCache.get(cacheKey);\n  if (cached !== undefined) {\n    return cached;\n  }\n  if (workspaceExtensionRegistrationsCache.size >= WORKSPACE_CONTRACTS_CACHE_LIMIT) {\n    const oldestKey = workspaceExtensionRegistrationsCache.keys().next().value!;\n    workspaceExtensionRegistrationsCache.delete(oldestKey);\n  }\n  const registrations = loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd);\n  workspaceExtensionRegistrationsCache.set(cacheKey, registrations);\n  return registrations;\n}\n\n/**\n * Implements get workspace contracts for the public runtime surface of this module.\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 resolveWorkspaceExtensionRegistrations(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\n/**\n * Implements get contracts for the public runtime surface of this module.\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":"9ed0f12b-4f84-58a2-86c7-aff1a8b86f0a"}

package/docs/AGENT_GUIDE.md

@@ -120,7 +120,7 @@ pm release <item-id>
 | Full machine payload | `pm get <id> --full --json` |
 | Command flags | `pm <command> --help --json` |
 | Low-noise machine contracts | `pm contracts --command <command> --flags-only --json` |
-| Semantic index refresh | `pm reindex --mode semantic --progress` (stale-first by default; add `--full` to force full rebuild) |
+| Semantic index refresh | `pm reindex --mode semantic --progress` (stale-first by default; add `--full` to force full rebuild; requires the `search-advanced` package) |
 | Timeline | `pm activity --id <id> --limit 20` |
 | Audited history redaction | `pm history-redact <id> --literal "<secret>" --replacement "[redacted]" --dry-run` |
 | Audited history re-anchor | `pm history-repair <id> --dry-run` (clears drift flagged by `pm health`/`pm validate`) |
@@ -189,7 +189,7 @@ Use these defaults unless the task requires otherwise:
 - `pm schema add-status <id> --role <role>` / `pm schema remove-status <id>` manage custom lifecycle statuses in `.agents/pm/schema/statuses.json`; roles come from the runtime status-role vocabulary, the upsert is idempotent, and built-in default statuses cannot be removed. `pm schema list` now reports statuses (builtin vs custom) alongside types.
 - `pm init --type-preset agile|ops|research` for new projects that should start with domain item types instead of generic tasks only.
 - After switching embedding provider/model, run `pm reindex --mode semantic --full` or `pm reindex --mode hybrid --full` to rebuild vectors completely; `pm reindex --mode keyword` ignores `--full` and now warns when ledger identity drift is detected.
-- `pm normalize --dry-run --json` before lifecycle metadata cleanups.
+- `pm normalize --dry-run --json` before lifecycle metadata cleanups (requires the `governance-audit` package).
 - `pm health --check-only` when inspecting repository health without refresh side effects.
 - Mistyped command names get a `Did you mean: <command>?` hint, including typos of the executable shortcut aliases — `pm shwo <id>` suggests `get` (the canonical of `show`/`view`), and `pm comemnt` suggests `comments`.
 

package/docs/ARCHITECTURE.md

@@ -14,7 +14,7 @@ Tracked documentation work: [pm-u9d0](../.agents/pm/epics/pm-u9d0.toon).
 
 ## System Overview
 
-`pm-cli` is a TypeScript ESM CLI for Node.js 20+. It is file-backed, git-native, deterministic, and designed for concurrent human plus agent workflows.
+`pm-cli` is a TypeScript ESM CLI for Node.js 22.18+. It is file-backed, git-native, deterministic, and designed for concurrent human plus agent workflows.
 
 High-level flow:
 
@@ -304,7 +304,7 @@ Useful commands:
 
 ```bash
 pm search "restore history" --mode keyword --limit 10
-pm reindex --mode hybrid --progress
+pm reindex --mode hybrid --progress   # requires the search-advanced package
 pm health --check-only
 ```
 

package/docs/COMMANDS.md

@@ -30,9 +30,9 @@ Tracked documentation work: [pm-u9d0](../.agents/pm/epics/pm-u9d0.toon).
 | Bulk | `update-many`, `close-many` | apply one change across a matched, dry-run-previewed set with a rollback checkpoint |
 | Scheduling | `meet`, `event`, `remind` | low-friction Meeting/Event/Reminder creation |
 | Planning | `plan create`, `plan add-step`, `plan update-step`, `plan complete-step`, `plan link`, `plan approve`, `plan materialize` | agent-optimized living plans with ordered steps, evidence, decisions, validation, and materialization |
-| Logs | `comments`, `notes`, `learnings`, `comments-audit` | record progress and durable context |
+| Logs | `comments`, `notes`, `learnings`, `comments-audit`* | record progress and durable context |
 | Links | `files`, `docs`, `test`, `deps` | connect items to artifacts, tests, and relationships |
-| Verification | `test`, `test-all`, `test-runs`, `validate`, `gc` | run linked tests and repository checks |
+| Verification | `test`, `test-all`, `test-runs`†, `validate`, `gc` | run linked tests and repository checks |
 | History | `history`, `history-compact`, `history-redact`, `history-repair`, `activity`, `restore`, `stats` | inspect, compact, redact, re-anchor, and recover item state |
 | Schema | `schema add-type` / `remove-type` / `add-status` / `remove-status` / `add-field` / `remove-field` / `apply-preset` | manage config-driven custom item types (`.agents/pm/schema/types.json`), statuses (`.agents/pm/schema/statuses.json`), and custom metadata fields (`.agents/pm/schema/fields.json`); `apply-preset` adopts a domain type preset; `add-type --infer` derives types from title-prefix conventions |
 | Profiles | `profile list` / `show` / `apply` / `lint` | compose item types, statuses, fields, workflows, config, templates, and recommended packages into archetype bundles (agile/ops/research); `apply` stages every dimension idempotently; `lint` reports author-time consistency findings without writing |
@@ -40,7 +40,9 @@ Tracked documentation work: [pm-u9d0](../.agents/pm/epics/pm-u9d0.toon).
 | Packages | `install`, `upgrade`, `package`, `packages`, `extension`, package/extension command groups | install, upgrade, manage, and run package-backed extension commands |
 | Machines | `contracts`, `help`, optional `guide`/`completion` | command contracts plus optional guide-shell docs routing and shell helpers |
 
-`*` `dedupe-audit` and `dedupe-merge` are provided by the optional `governance-audit` package (`pm install governance-audit --project`).
+`*` `dedupe-audit`, `dedupe-merge`, `comments-audit`, and `normalize` are provided by the optional `governance-audit` package (`pm install governance-audit --project`).
+
+`†` `test-runs` subcommands are provided by the optional `linked-test-adapters` package (`pm install linked-test-adapters --project`).
 
 ## Bootstrap
 
@@ -746,7 +748,7 @@ pm create Spike "Investigate retry backoff"
 - `add-type` is an idempotent UPSERT keyed on the type name (case-insensitive); re-running it merges aliases and overrides supplied fields while preserving everything else.
 - `remove-type <Name>` removes a custom type definition (case-insensitive). Built-in types are refused. It WARNS (non-blocking) with `items_using_type:<N>` when items of that type still exist, then removes the definition.
 - `add-status <id>` writes a custom lifecycle status (idempotent UPSERT keyed on the normalized id; re-adding sets `replaced: true`). Roles are validated against the runtime status roles: `draft`, `active`, `blocked`, `terminal`, `terminal_done`, `terminal_canceled`, `default_open`, `default_close`, `default_cancel`.
-- `remove-status <id>` removes a custom status. The five built-in default statuses (`open`, `in_progress`, `blocked`, `closed`, `canceled`, plus `draft`) are refused. It WARNS (non-blocking) with `items_using_status:<N>` when items currently use that status.
+- `remove-status <id>` removes a custom status. The six built-in statuses (`open`, `in_progress`, `blocked`, `closed`, `canceled`, `draft`) are refused. It WARNS (non-blocking) with `items_using_status:<N>` when items currently use that status.
 - Built-in types (Chore, Decision, Epic, Event, Feature, Issue, Meeting, Milestone, Plan, Reminder, Task) are reserved and cannot be redefined or removed.
 - `add-field <key>` registers a custom metadata field in `.agents/pm/schema/fields.json` (shape: `{ "fields": [RuntimeFieldDefinition...] }`). Each custom field dynamically registers a CLI flag on create/update (and any other commands you list) so projects can capture typed project-specific metadata without hand-editing JSON. It is an idempotent UPSERT keyed on the normalized key, and refuses keys that shadow a built-in field. `list-fields` / `show-field <key>` inspect registered fields; `remove-field <key>` drops one and WARNS (non-blocking) with `items_using_field:<N>` when items still carry a value. See [CONFIGURATION.md](CONFIGURATION.md) for the full `schema/fields.json` format.
 - `apply-preset <agile|ops|research>` batch-registers a domain type preset into an already-initialized project (the same vocabulary `pm init --type-preset` seeds); it is idempotent (re-running reports `replaced` entries) and shares its definitions with init.
@@ -856,6 +858,8 @@ Agents should use runtime contracts instead of hard-coding flag lists. Contract
 
 ## Completion
 
+`pm completion` is provided by the optional `guide-shell` package (`pm install guide-shell --project`).
+
 ```bash
 pm completion bash
 pm completion zsh

package/docs/CONFIGURATION.md

@@ -168,7 +168,7 @@ pm get <id> --full --json
 pm contracts --json
 ```
 
-`pm calendar` defaults to markdown because date-centric summaries are easier to scan in that format.
+`pm calendar` (provided by the optional `calendar` package — `pm install calendar --project`) defaults to markdown because date-centric summaries are easier to scan in that format.
 
 ## Validation Policies