@unbrained/pm-cli 2026.5.18 → 2026.5.27

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

@@ -1,7 +1,11 @@
+import { type ExtensionRegistrationRegistry } from "../core/extensions/index.js";
+import { type ContractsCommandOptions, type ContractsResult } from "../cli/commands/contracts.js";
 export { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks, } from "../core/extensions/index.js";
 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";
@@ -24,6 +28,28 @@ export { runReindex, type ReindexOptions, type ReindexResult } from "../cli/comm
 export { runSearch, type SearchOptions, type SearchResult } from "../cli/commands/search.js";
 export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, type CreateTemplateOptions, type TemplatesListResult, type TemplatesSaveResult, type TemplatesShowResult, } from "../cli/commands/templates.js";
 export { runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, type TestRunsListCommandOptions, type TestRunsLogsCommandOptions, type TestRunsResumeCommandOptions, type TestRunsStopCommandOptions, } from "../cli/commands/test-runs.js";
-export { CONFIDENCE_TEXT_VALUES, DEPENDENCY_KIND_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES, } from "../types/index.js";
+export { CONFIDENCE_TEXT_VALUES, DEPENDENCY_KIND_VALUES, BUILTIN_ITEM_TYPE_VALUES, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, RISK_VALUES, STATUS_VALUES, } from "../types/index.js";
 export type { GlobalOptions } from "../core/shared/command-types.js";
 export type { Dependency, ItemDocument, ItemMetadata, ItemStatus, ItemType, LinkedDoc, LinkedFile, LinkedTest, LogNote, PmSettings, } from "../types/index.js";
+export interface GetContractsOptions extends ContractsCommandOptions {
+    pmRoot?: string;
+    cwd?: string;
+    noExtensions?: boolean;
+    quiet?: boolean;
+    profile?: boolean;
+}
+export interface WorkspaceContractsOptions {
+    extensionRegistrations?: ExtensionRegistrationRegistry | null;
+    noExtensions?: boolean;
+    cwd?: string;
+}
+export interface WorkspaceContracts {
+    types: string[];
+    statuses: string[];
+    openStatus: string;
+    closeStatus: string;
+    canceledStatus: string;
+}
+export declare function getWorkspaceContracts(pmRoot: string, options?: WorkspaceContractsOptions): Promise<WorkspaceContracts>;
+export declare function getContracts(pmRootOrOptions?: string | GetContractsOptions, options?: GetContractsOptions): Promise<ContractsResult>;
+export type { ContractsCommandOptions, ContractsResult };

package/dist/sdk/runtime.js

@@ -1,9 +1,16 @@
 
-!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]="6b365b7c-339a-5b75-b897-27352e2f3495")}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";
+import { readSettings } from "../core/store/settings.js";
+import { runContracts, } from "../cli/commands/contracts.js";
 export { getActiveExtensionRegistrations, runActiveOnReadHooks, runActiveOnWriteHooks, } from "../core/extensions/index.js";
 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";
@@ -26,6 +33,44 @@ export { runReindex } from "../cli/commands/reindex.js";
 export { runSearch } from "../cli/commands/search.js";
 export { loadCreateTemplateOptions, runTemplatesList, runTemplatesSave, runTemplatesShow, } from "../cli/commands/templates.js";
 export { runTestRunsList, runTestRunsLogs, runTestRunsResume, runTestRunsStatus, runTestRunsStop, } from "../cli/commands/test-runs.js";
-export { CONFIDENCE_TEXT_VALUES, DEPENDENCY_KIND_VALUES, ISSUE_SEVERITY_VALUES, RISK_VALUES, } from "../types/index.js";
+export { CONFIDENCE_TEXT_VALUES, DEPENDENCY_KIND_VALUES, BUILTIN_ITEM_TYPE_VALUES, ISSUE_SEVERITY_VALUES, ITEM_TYPE_VALUES, RISK_VALUES, STATUS_VALUES, } from "../types/index.js";
+export async function getWorkspaceContracts(pmRoot, options = {}) {
+    const settings = await readSettings(pmRoot);
+    const extensionRegistrations = options.extensionRegistrations ??
+        (options.noExtensions === true ? null : await loadWorkspaceExtensionRegistrations(pmRoot, settings, options.cwd));
+    const typeRegistry = resolveItemTypeRegistry(settings, extensionRegistrations);
+    const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+    return {
+        types: [...typeRegistry.types],
+        statuses: statusRegistry.definitions.map((definition) => definition.id),
+        openStatus: statusRegistry.open_status,
+        closeStatus: statusRegistry.close_status,
+        canceledStatus: statusRegistry.canceled_status,
+    };
+}
+export async function getContracts(pmRootOrOptions, options = {}) {
+    const resolvedOptions = typeof pmRootOrOptions === "string"
+        ? { ...options, pmRoot: pmRootOrOptions }
+        : (pmRootOrOptions ?? options);
+    const global = {
+        json: true,
+        quiet: resolvedOptions.quiet ?? true,
+        noExtensions: resolvedOptions.noExtensions ?? false,
+        noPager: true,
+        profile: resolvedOptions.profile ?? false,
+        path: resolvedOptions.pmRoot,
+    };
+    return runContracts(resolvedOptions, global);
+}
+async function loadWorkspaceExtensionRegistrations(pmRoot, settings, cwd) {
+    const loadResult = await loadExtensions({
+        pmRoot,
+        settings,
+        cwd: cwd ?? process.cwd(),
+        noExtensions: false,
+    });
+    const activationResult = await activateExtensions(loadResult);
+    return activationResult.registrations;
+}
 //# sourceMappingURL=runtime.js.map
-//# debugId=6b365b7c-339a-5b75-b897-27352e2f3495
+//# 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":["export {\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  ISSUE_SEVERITY_VALUES,\n  RISK_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"],"names":[],"mappings":";;AAAA,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC3G,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,kCAAkC,CAAC;AAC7G,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9F,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,WAAW,GAGZ,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,QAAQ,GAKT,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,aAAa,EAA+C,MAAM,+BAA+B,CAAC;AAC3G,OAAO,EACL,gBAAgB,GAOjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,cAAc,GAKf,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,YAAY,EAAsD,MAAM,8BAA8B,CAAC;AAChH,OAAO,EAAE,UAAU,EAA2C,MAAM,4BAA4B,CAAC;AACjG,OAAO,EAAE,SAAS,EAAyC,MAAM,2BAA2B,CAAC;AAC7F,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GAKjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,GAKhB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,WAAW,GACZ,MAAM,mBAAmB,CAAC","debugId":"6b365b7c-339a-5b75-b897-27352e2f3495"}
+{"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/dist/types.d.ts

@@ -45,6 +45,12 @@ export declare const RECURRENCE_FREQUENCY_VALUES: readonly ["daily", "weekly", "
 export type RecurrenceFrequency = (typeof RECURRENCE_FREQUENCY_VALUES)[number];
 export declare const RECURRENCE_WEEKDAY_VALUES: readonly ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
 export type RecurrenceWeekday = (typeof RECURRENCE_WEEKDAY_VALUES)[number];
+/**
+ * Canonical week-order index for a recurrence weekday (mon=0 .. sun=6).
+ * Shared by item serialization, create/update parsing, and calendar expansion
+ * so weekday ordering cannot drift between those modules.
+ */
+export declare function weekdayOrderIndex(value: RecurrenceWeekday): number;
 export interface Dependency {
     id: string;
     kind: DependencyKind;

package/dist/types.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]="3da6c0f0-969e-547b-aaa2-03164276c0d7")}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]="68c1fa65-9fc4-5566-9c23-bdb17c35cb53")}catch(e){}}();
 export const BUILTIN_ITEM_TYPE_VALUES = [
     "Epic",
     "Feature",
@@ -76,6 +76,14 @@ export const VALIDATE_METADATA_REQUIRED_FIELD_VALUES = [
 ];
 export const RECURRENCE_FREQUENCY_VALUES = ["daily", "weekly", "monthly", "yearly"];
 export const RECURRENCE_WEEKDAY_VALUES = ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
+/**
+ * Canonical week-order index for a recurrence weekday (mon=0 .. sun=6).
+ * Shared by item serialization, create/update parsing, and calendar expansion
+ * so weekday ordering cannot drift between those modules.
+ */
+export function weekdayOrderIndex(value) {
+    return RECURRENCE_WEEKDAY_VALUES.indexOf(value);
+}
 export const PLAN_MODE_VALUES = [
     "draft",
     "research",
@@ -117,4 +125,4 @@ export const CONTEXT_SECTION_VALUES = [
     "tests",
 ];
 //# sourceMappingURL=types.js.map
-//# debugId=3da6c0f0-969e-547b-aaa2-03164276c0d7
+//# debugId=68c1fa65-9fc4-5566-9c23-bdb17c35cb53