@unbrained/pm-cli 2026.5.30 → 2026.6.5

package/dist/cli-bundle/chunks/chunk-FVXM3GKS.js

@@ -0,0 +1,128 @@
+
+!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]="57f95f52-98be-5c1f-b45f-c58fefd14928")}catch(e){}}();
+import {
+  nowIso
+} from "./chunk-NQP3ECKF.js";
+import {
+  EXIT_CODE,
+  PmCliError,
+  pathExists,
+  toErrorMessage,
+  writeFileAtomic
+} from "./chunk-4LTBNUYT.js";
+
+// dist/core/checkpoint/mutation-checkpoint.js
+import { mkdir, readFile } from "node:fs/promises";
+import path from "node:path";
+function normalizeCheckpointId(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed) {
+    throw new PmCliError("--rollback requires a non-empty checkpoint ID", EXIT_CODE.USAGE);
+  }
+  if (!/^[a-zA-Z0-9._-]+$/.test(trimmed)) {
+    throw new PmCliError("--rollback checkpoint ID must match [a-zA-Z0-9._-]+", EXIT_CODE.USAGE);
+  }
+  return trimmed;
+}
+function createCheckpointId(prefix, nowValue) {
+  const compactTimestamp = nowValue.replace(/[-:.TZ]/g, "").slice(0, 14);
+  const randomSuffix = Math.random().toString(36).slice(2, 8);
+  return `${prefix}-${compactTimestamp}-${randomSuffix}`;
+}
+function checkpointDirectoryPath(pmRoot, subdir) {
+  return path.join(pmRoot, "checkpoints", subdir);
+}
+function checkpointFilePath(pmRoot, subdir, checkpointId) {
+  return path.join(checkpointDirectoryPath(pmRoot, subdir), `${checkpointId}.json`);
+}
+async function writeMutationCheckpoint(pmRoot, subdir, checkpointId, payload) {
+  const checkpointDir = checkpointDirectoryPath(pmRoot, subdir);
+  await mkdir(checkpointDir, { recursive: true });
+  const filePath = checkpointFilePath(pmRoot, subdir, checkpointId);
+  await writeFileAtomic(filePath, `${JSON.stringify(payload, null, 2)}
+`);
+  return filePath;
+}
+function parseCheckpointItems(record, checkpointId) {
+  if (!Array.isArray(record.items)) {
+    throw new PmCliError(`Checkpoint ${checkpointId} is missing items`, EXIT_CODE.GENERIC_FAILURE);
+  }
+  return record.items.map((entry) => {
+    if (!entry || typeof entry !== "object") {
+      throw new PmCliError(`Checkpoint ${checkpointId} contains an invalid item entry`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    const row = entry;
+    if (typeof row.id !== "string" || row.id.trim().length === 0) {
+      throw new PmCliError(`Checkpoint ${checkpointId} contains an item entry without ID`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    if (typeof row.target_updated_at !== "string" || row.target_updated_at.trim().length === 0) {
+      throw new PmCliError(`Checkpoint ${checkpointId} contains an item entry without target_updated_at`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    return { id: row.id.trim(), target_updated_at: row.target_updated_at.trim() };
+  });
+}
+async function loadMutationCheckpoint(pmRoot, subdir, rawCheckpointId, schemaVersion) {
+  const normalizedId = normalizeCheckpointId(rawCheckpointId);
+  const filePath = checkpointFilePath(pmRoot, subdir, normalizedId);
+  if (!await pathExists(filePath)) {
+    throw new PmCliError(`Checkpoint ${normalizedId} not found`, EXIT_CODE.NOT_FOUND);
+  }
+  const raw = await readFile(filePath, "utf8");
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (error) {
+    throw new PmCliError(`Checkpoint ${normalizedId} contains invalid JSON: ${toErrorMessage(error)}`, EXIT_CODE.GENERIC_FAILURE);
+  }
+  if (!parsed || typeof parsed !== "object") {
+    throw new PmCliError(`Checkpoint ${normalizedId} is invalid`, EXIT_CODE.GENERIC_FAILURE);
+  }
+  const record = parsed;
+  if (record.schema_version !== schemaVersion) {
+    throw new PmCliError(`Checkpoint ${normalizedId} has unsupported schema version`, EXIT_CODE.GENERIC_FAILURE);
+  }
+  const items = parseCheckpointItems(record, normalizedId);
+  return {
+    record,
+    items,
+    path: filePath,
+    id: typeof record.id === "string" ? record.id : normalizedId,
+    // Defensive recovery for malformed checkpoint metadata; normal writes
+    // always include these fields, so fallbacks keep rollback inspectable.
+    created_at: typeof record.created_at === "string" ? record.created_at : nowIso(),
+    author: typeof record.author === "string" ? record.author : "unknown"
+  };
+}
+async function restoreCheckpointItems(items, restore) {
+  const rows = [];
+  const restoredIds = [];
+  for (const entry of items) {
+    try {
+      const restored = await restore(entry.id, entry.target_updated_at);
+      rows.push({
+        id: entry.id,
+        status: "restored",
+        changed_fields: restored.changed_fields,
+        warnings: restored.warnings
+      });
+      restoredIds.push(entry.id);
+    } catch (error) {
+      rows.push({ id: entry.id, status: "failed", error: toErrorMessage(error) });
+    }
+  }
+  return {
+    rows,
+    restored_ids: restoredIds,
+    failed_count: rows.filter((row) => row.status === "failed").length
+  };
+}
+
+export {
+  createCheckpointId,
+  writeMutationCheckpoint,
+  loadMutationCheckpoint,
+  restoreCheckpointItems
+};
+//# sourceMappingURL=chunk-FVXM3GKS.js.map
+
+//# debugId=57f95f52-98be-5c1f-b45f-c58fefd14928

package/dist/cli-bundle/chunks/chunk-FVXM3GKS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/checkpoint/mutation-checkpoint.ts"],"sourcesContent":["import { mkdir, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists, writeFileAtomic } from \"../fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\nimport { toErrorMessage } from \"../shared/primitives.js\";\nimport { nowIso } from \"../shared/time.js\";\n\n// Shared checkpoint + rollback machinery for bulk-mutation commands\n// (`update-many`, `close-many`). Each command owns its own checkpoint payload\n// shape (the extra fields it records) but reuses the common id/path/validation\n// helpers and the restore loop so the durable rollback contract — capture each\n// matched item's pre-mutation updated_at, then restore-to-timestamp on\n// rollback — stays identical across commands and is not duplicated.\n\nexport interface MutationCheckpointItem {\n  id: string;\n  target_updated_at: string;\n}\n\nexport interface LoadedMutationCheckpoint {\n  /** The full on-disk record so callers can read their command-specific fields. */\n  record: Record<string, unknown>;\n  /** Validated item list (id + target_updated_at). */\n  items: MutationCheckpointItem[];\n  /** Absolute path the checkpoint was read from. */\n  path: string;\n  id: string;\n  created_at: string;\n  author: string;\n}\n\nexport interface CheckpointRollbackRow {\n  id: string;\n  status: \"restored\" | \"failed\";\n  changed_fields?: string[];\n  warnings?: string[];\n  error?: string;\n}\n\nexport interface CheckpointRollbackResult {\n  rows: CheckpointRollbackRow[];\n  restored_ids: string[];\n  failed_count: number;\n}\n\n/** Restore a single item to its captured pre-mutation timestamp. */\nexport type CheckpointRestoreFn = (\n  id: string,\n  targetUpdatedAt: string,\n) => Promise<{ changed_fields?: string[]; warnings?: string[] }>;\n\nexport function normalizeCheckpointId(raw: string): string {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    throw new PmCliError(\"--rollback requires a non-empty checkpoint ID\", EXIT_CODE.USAGE);\n  }\n  if (!/^[a-zA-Z0-9._-]+$/.test(trimmed)) {\n    throw new PmCliError(\"--rollback checkpoint ID must match [a-zA-Z0-9._-]+\", EXIT_CODE.USAGE);\n  }\n  return trimmed;\n}\n\nexport function createCheckpointId(prefix: string, nowValue: string): string {\n  const compactTimestamp = nowValue.replace(/[-:.TZ]/g, \"\").slice(0, 14);\n  const randomSuffix = Math.random().toString(36).slice(2, 8);\n  return `${prefix}-${compactTimestamp}-${randomSuffix}`;\n}\n\nexport function checkpointDirectoryPath(pmRoot: string, subdir: string): string {\n  return path.join(pmRoot, \"checkpoints\", subdir);\n}\n\nexport function checkpointFilePath(pmRoot: string, subdir: string, checkpointId: string): string {\n  return path.join(checkpointDirectoryPath(pmRoot, subdir), `${checkpointId}.json`);\n}\n\nexport async function writeMutationCheckpoint(\n  pmRoot: string,\n  subdir: string,\n  checkpointId: string,\n  payload: unknown,\n): Promise<string> {\n  const checkpointDir = checkpointDirectoryPath(pmRoot, subdir);\n  await mkdir(checkpointDir, { recursive: true });\n  const filePath = checkpointFilePath(pmRoot, subdir, checkpointId);\n  await writeFileAtomic(filePath, `${JSON.stringify(payload, null, 2)}\\n`);\n  return filePath;\n}\n\nfunction parseCheckpointItems(record: Record<string, unknown>, checkpointId: string): MutationCheckpointItem[] {\n  if (!Array.isArray(record.items)) {\n    throw new PmCliError(`Checkpoint ${checkpointId} is missing items`, EXIT_CODE.GENERIC_FAILURE);\n  }\n  return record.items.map((entry) => {\n    if (!entry || typeof entry !== \"object\") {\n      throw new PmCliError(`Checkpoint ${checkpointId} contains an invalid item entry`, EXIT_CODE.GENERIC_FAILURE);\n    }\n    const row = entry as Record<string, unknown>;\n    if (typeof row.id !== \"string\" || row.id.trim().length === 0) {\n      throw new PmCliError(`Checkpoint ${checkpointId} contains an item entry without ID`, EXIT_CODE.GENERIC_FAILURE);\n    }\n    if (typeof row.target_updated_at !== \"string\" || row.target_updated_at.trim().length === 0) {\n      throw new PmCliError(\n        `Checkpoint ${checkpointId} contains an item entry without target_updated_at`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    return { id: row.id.trim(), target_updated_at: row.target_updated_at.trim() };\n  });\n}\n\nexport async function loadMutationCheckpoint(\n  pmRoot: string,\n  subdir: string,\n  rawCheckpointId: string,\n  schemaVersion: number,\n): Promise<LoadedMutationCheckpoint> {\n  const normalizedId = normalizeCheckpointId(rawCheckpointId);\n  const filePath = checkpointFilePath(pmRoot, subdir, normalizedId);\n  if (!(await pathExists(filePath))) {\n    throw new PmCliError(`Checkpoint ${normalizedId} not found`, EXIT_CODE.NOT_FOUND);\n  }\n  const raw = await readFile(filePath, \"utf8\");\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch (error: unknown) {\n    throw new PmCliError(\n      `Checkpoint ${normalizedId} contains invalid JSON: ${toErrorMessage(error)}`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  if (!parsed || typeof parsed !== \"object\") {\n    throw new PmCliError(`Checkpoint ${normalizedId} is invalid`, EXIT_CODE.GENERIC_FAILURE);\n  }\n  const record = parsed as Record<string, unknown>;\n  if (record.schema_version !== schemaVersion) {\n    throw new PmCliError(`Checkpoint ${normalizedId} has unsupported schema version`, EXIT_CODE.GENERIC_FAILURE);\n  }\n  const items = parseCheckpointItems(record, normalizedId);\n  return {\n    record,\n    items,\n    path: filePath,\n    id: typeof record.id === \"string\" ? record.id : normalizedId,\n    // Defensive recovery for malformed checkpoint metadata; normal writes\n    // always include these fields, so fallbacks keep rollback inspectable.\n    created_at: typeof record.created_at === \"string\" ? record.created_at : nowIso(),\n    author: typeof record.author === \"string\" ? record.author : \"unknown\",\n  };\n}\n\n/**\n * Restore every checkpointed item to its captured pre-mutation timestamp,\n * collecting per-item rows. A single item's failure is recorded and does not\n * abort the remaining restores.\n */\nexport async function restoreCheckpointItems(\n  items: MutationCheckpointItem[],\n  restore: CheckpointRestoreFn,\n): Promise<CheckpointRollbackResult> {\n  const rows: CheckpointRollbackRow[] = [];\n  const restoredIds: string[] = [];\n  for (const entry of items) {\n    try {\n      const restored = await restore(entry.id, entry.target_updated_at);\n      rows.push({\n        id: entry.id,\n        status: \"restored\",\n        changed_fields: restored.changed_fields,\n        warnings: restored.warnings,\n      });\n      restoredIds.push(entry.id);\n    } catch (error: unknown) {\n      rows.push({ id: entry.id, status: \"failed\", error: toErrorMessage(error) });\n    }\n  }\n  return {\n    rows,\n    restored_ids: restoredIds,\n    failed_count: rows.filter((row) => row.status === \"failed\").length,\n  };\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,SAAS,OAAO,gBAAgB;AAChC,OAAO,UAAU;AAmDX,SAAU,sBAAsB,KAAW;AAC/C,QAAM,UAAU,IAAI,KAAI;AACxB,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,WAAW,iDAAiD,UAAU,KAAK;EACvF;AACA,MAAI,CAAC,oBAAoB,KAAK,OAAO,GAAG;AACtC,UAAM,IAAI,WAAW,uDAAuD,UAAU,KAAK;EAC7F;AACA,SAAO;AACT;AAEM,SAAU,mBAAmB,QAAgB,UAAgB;AACjE,QAAM,mBAAmB,SAAS,QAAQ,YAAY,EAAE,EAAE,MAAM,GAAG,EAAE;AACrE,QAAM,eAAe,KAAK,OAAM,EAAG,SAAS,EAAE,EAAE,MAAM,GAAG,CAAC;AAC1D,SAAO,GAAG,MAAM,IAAI,gBAAgB,IAAI,YAAY;AACtD;AAEM,SAAU,wBAAwB,QAAgB,QAAc;AACpE,SAAO,KAAK,KAAK,QAAQ,eAAe,MAAM;AAChD;AAEM,SAAU,mBAAmB,QAAgB,QAAgB,cAAoB;AACrF,SAAO,KAAK,KAAK,wBAAwB,QAAQ,MAAM,GAAG,GAAG,YAAY,OAAO;AAClF;AAEA,eAAsB,wBACpB,QACA,QACA,cACA,SAAgB;AAEhB,QAAM,gBAAgB,wBAAwB,QAAQ,MAAM;AAC5D,QAAM,MAAM,eAAe,EAAE,WAAW,KAAI,CAAE;AAC9C,QAAM,WAAW,mBAAmB,QAAQ,QAAQ,YAAY;AAChE,QAAM,gBAAgB,UAAU,GAAG,KAAK,UAAU,SAAS,MAAM,CAAC,CAAC;CAAI;AACvE,SAAO;AACT;AAEA,SAAS,qBAAqB,QAAiC,cAAoB;AACjF,MAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,GAAG;AAChC,UAAM,IAAI,WAAW,cAAc,YAAY,qBAAqB,UAAU,eAAe;EAC/F;AACA,SAAO,OAAO,MAAM,IAAI,CAAC,UAAS;AAChC,QAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACvC,YAAM,IAAI,WAAW,cAAc,YAAY,mCAAmC,UAAU,eAAe;IAC7G;AACA,UAAM,MAAM;AACZ,QAAI,OAAO,IAAI,OAAO,YAAY,IAAI,GAAG,KAAI,EAAG,WAAW,GAAG;AAC5D,YAAM,IAAI,WAAW,cAAc,YAAY,sCAAsC,UAAU,eAAe;IAChH;AACA,QAAI,OAAO,IAAI,sBAAsB,YAAY,IAAI,kBAAkB,KAAI,EAAG,WAAW,GAAG;AAC1F,YAAM,IAAI,WACR,cAAc,YAAY,qDAC1B,UAAU,eAAe;IAE7B;AACA,WAAO,EAAE,IAAI,IAAI,GAAG,KAAI,GAAI,mBAAmB,IAAI,kBAAkB,KAAI,EAAE;EAC7E,CAAC;AACH;AAEA,eAAsB,uBACpB,QACA,QACA,iBACA,eAAqB;AAErB,QAAM,eAAe,sBAAsB,eAAe;AAC1D,QAAM,WAAW,mBAAmB,QAAQ,QAAQ,YAAY;AAChE,MAAI,CAAE,MAAM,WAAW,QAAQ,GAAI;AACjC,UAAM,IAAI,WAAW,cAAc,YAAY,cAAc,UAAU,SAAS;EAClF;AACA,QAAM,MAAM,MAAM,SAAS,UAAU,MAAM;AAC3C,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,GAAG;EACzB,SAAS,OAAgB;AACvB,UAAM,IAAI,WACR,cAAc,YAAY,2BAA2B,eAAe,KAAK,CAAC,IAC1E,UAAU,eAAe;EAE7B;AACA,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,UAAM,IAAI,WAAW,cAAc,YAAY,eAAe,UAAU,eAAe;EACzF;AACA,QAAM,SAAS;AACf,MAAI,OAAO,mBAAmB,eAAe;AAC3C,UAAM,IAAI,WAAW,cAAc,YAAY,mCAAmC,UAAU,eAAe;EAC7G;AACA,QAAM,QAAQ,qBAAqB,QAAQ,YAAY;AACvD,SAAO;IACL;IACA;IACA,MAAM;IACN,IAAI,OAAO,OAAO,OAAO,WAAW,OAAO,KAAK;;;IAGhD,YAAY,OAAO,OAAO,eAAe,WAAW,OAAO,aAAa,OAAM;IAC9E,QAAQ,OAAO,OAAO,WAAW,WAAW,OAAO,SAAS;;AAEhE;AAOA,eAAsB,uBACpB,OACA,SAA4B;AAE5B,QAAM,OAAgC,CAAA;AACtC,QAAM,cAAwB,CAAA;AAC9B,aAAW,SAAS,OAAO;AACzB,QAAI;AACF,YAAM,WAAW,MAAM,QAAQ,MAAM,IAAI,MAAM,iBAAiB;AAChE,WAAK,KAAK;QACR,IAAI,MAAM;QACV,QAAQ;QACR,gBAAgB,SAAS;QACzB,UAAU,SAAS;OACpB;AACD,kBAAY,KAAK,MAAM,EAAE;IAC3B,SAAS,OAAgB;AACvB,WAAK,KAAK,EAAE,IAAI,MAAM,IAAI,QAAQ,UAAU,OAAO,eAAe,KAAK,EAAC,CAAE;IAC5E;EACF;AACA,SAAO;IACL;IACA,cAAc;IACd,cAAc,KAAK,OAAO,CAAC,QAAQ,IAAI,WAAW,QAAQ,EAAE;;AAEhE","debugId":"57f95f52-98be-5c1f-b45f-c58fefd14928"}

package/dist/cli-bundle/chunks/chunk-G5BACLYH.js

@@ -0,0 +1,454 @@
+
+!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]="18624348-c10e-5bbb-b8ae-fe5c7dfe1527")}catch(e){}}();
+import {
+  collectRuntimeFilterValues,
+  matchesRuntimeFilters,
+  parseStatusFilterCsv
+} from "./chunk-JQI2HE55.js";
+import {
+  parseIntegerLimit,
+  parsePriority,
+  parseType
+} from "./chunk-GFWHHMVV.js";
+import {
+  HEAVY_METADATA_KEYS,
+  listAllFrontMatter,
+  listAllFrontMatterLight,
+  listAllFrontMatterWithBody,
+  toItemRecord
+} from "./chunk-CWT53EYT.js";
+import {
+  isTerminalStatus
+} from "./chunk-KBG47ZOY.js";
+import {
+  resolveItemTypeRegistry
+} from "./chunk-SZQCER6S.js";
+import {
+  compareTimestampStrings,
+  nowIso,
+  resolveIsoOrRelative
+} from "./chunk-NQP3ECKF.js";
+import {
+  EXIT_CODE,
+  FRONT_MATTER_KEY_ORDER,
+  PmCliError,
+  getActiveExtensionRegistrations,
+  getSettingsPath,
+  pathExists,
+  readSettings,
+  resolvePmRoot,
+  resolveRuntimeFieldRegistry,
+  resolveRuntimeStatusRegistry
+} from "./chunk-4LTBNUYT.js";
+
+// dist/cli/commands/list.js
+var LIST_SORT_FIELDS = ["priority", "deadline", "updated_at", "created_at", "title", "parent"];
+var LIST_SORT_ORDER_VALUES = ["asc", "desc"];
+var DEFAULT_COMPACT_LIST_FIELDS = ["id", "title", "status", "type", "priority", "parent", "updated_at"];
+var BRIEF_LIST_FIELDS = ["id", "status", "type", "title"];
+var HEAVY_PROJECTION_FIELDS = new Set(HEAVY_METADATA_KEYS);
+function compareDefaultSort(left, right, statusRegistry) {
+  const leftTerminal = isTerminalStatus(left.status, statusRegistry);
+  const rightTerminal = isTerminalStatus(right.status, statusRegistry);
+  if (leftTerminal !== rightTerminal) {
+    return leftTerminal ? 1 : -1;
+  }
+  const byPriority = left.priority - right.priority;
+  if (byPriority !== 0) {
+    return byPriority;
+  }
+  const byUpdated = compareTimestampStrings(right.updated_at, left.updated_at);
+  if (byUpdated !== 0) {
+    return byUpdated;
+  }
+  return (left.id ?? "").localeCompare(right.id ?? "");
+}
+function sortItemsDefault(items, statusRegistry) {
+  return [...items].sort((left, right) => compareDefaultSort(left, right, statusRegistry));
+}
+function parseDeadline(raw, fieldLabel) {
+  if (raw === void 0)
+    return void 0;
+  return resolveIsoOrRelative(raw, /* @__PURE__ */ new Date(), fieldLabel);
+}
+function parseTimestampWindow(raw, fieldLabel) {
+  if (raw == null)
+    return void 0;
+  const value = String(raw).trim();
+  if (value.length === 0)
+    return void 0;
+  return resolveIsoOrRelative(value, /* @__PURE__ */ new Date(), fieldLabel);
+}
+function parseIdsFilter(raw) {
+  if (raw == null)
+    return void 0;
+  const value = String(raw).trim();
+  if (value.length === 0) {
+    throw new PmCliError("--ids requires at least one non-empty item ID", EXIT_CODE.USAGE);
+  }
+  const ids = value.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+  if (ids.length === 0) {
+    throw new PmCliError("--ids requires at least one non-empty item ID", EXIT_CODE.USAGE);
+  }
+  return new Set(ids);
+}
+function parseOffset(raw) {
+  if (raw === void 0)
+    return void 0;
+  const parsed = Number(raw);
+  if (!Number.isInteger(parsed) || parsed < 0) {
+    throw new PmCliError("Offset filter must be a non-negative integer", EXIT_CODE.USAGE);
+  }
+  return parsed;
+}
+function parseFieldSelectors(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  const selectors = raw.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0);
+  if (selectors.length === 0) {
+    throw new PmCliError("List --fields requires a comma-separated list of field names", EXIT_CODE.USAGE);
+  }
+  return [...new Set(selectors)];
+}
+function parseProjectionConfig(options) {
+  const compactRequested = options.compact === true;
+  const briefRequested = options.brief === true;
+  const fullRequested = options.full === true;
+  const fieldSelectors = parseFieldSelectors(options.fields);
+  const enabledModes = Number(compactRequested) + Number(briefRequested) + Number(fullRequested) + Number(fieldSelectors !== void 0);
+  if (enabledModes > 1) {
+    throw new PmCliError("List projection options are mutually exclusive. Use one of --compact, --brief, --full, or --fields.", EXIT_CODE.USAGE);
+  }
+  if (fullRequested) {
+    return {
+      mode: "full",
+      fields: []
+    };
+  }
+  if (briefRequested) {
+    return {
+      mode: "compact",
+      fields: [...BRIEF_LIST_FIELDS]
+    };
+  }
+  if (compactRequested) {
+    return {
+      mode: "compact",
+      fields: [...DEFAULT_COMPACT_LIST_FIELDS]
+    };
+  }
+  if (fieldSelectors) {
+    return {
+      mode: "fields",
+      fields: fieldSelectors
+    };
+  }
+  return {
+    mode: "full",
+    fields: []
+  };
+}
+function normalizeProjectionField(field) {
+  return field.startsWith("item.") ? field.slice("item.".length) : field;
+}
+function validateListProjectionFields(projection, runtimeMetadataKeys) {
+  if (projection.mode !== "fields") {
+    return;
+  }
+  const allowed = /* @__PURE__ */ new Set([...FRONT_MATTER_KEY_ORDER, "body", ...runtimeMetadataKeys]);
+  const unknown = projection.fields.filter((field) => !allowed.has(normalizeProjectionField(field)));
+  if (unknown.length > 0) {
+    throw new PmCliError(`Unknown list --fields value(s): ${unknown.join(", ")}`, EXIT_CODE.USAGE, {
+      code: "unknown_field_projection",
+      examples: [
+        "pm list-open --fields id,title,status,type,updated_at",
+        "pm list --fields id,title,parent,priority --limit 10",
+        "pm list-all --fields id,title,body --limit 5"
+      ]
+    });
+  }
+}
+var LIST_SORT_FIELD_ALIASES = /* @__PURE__ */ new Map([
+  ["updated", "updated_at"],
+  ["update", "updated_at"],
+  ["modified", "updated_at"],
+  ["created", "created_at"],
+  ["create", "created_at"]
+]);
+function parseSortField(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  const normalized = raw.trim().toLowerCase();
+  const aliased = LIST_SORT_FIELD_ALIASES.get(normalized);
+  if (aliased) {
+    return aliased;
+  }
+  if (!LIST_SORT_FIELDS.includes(normalized)) {
+    throw new PmCliError(`Sort field must be one of ${LIST_SORT_FIELDS.join("|")} (aliases: updated->updated_at, created->created_at)`, EXIT_CODE.USAGE);
+  }
+  return normalized;
+}
+function parseSortOrder(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  const normalized = raw.trim().toLowerCase();
+  if (!LIST_SORT_ORDER_VALUES.includes(normalized)) {
+    throw new PmCliError(`Sort order must be one of ${LIST_SORT_ORDER_VALUES.join("|")}`, EXIT_CODE.USAGE);
+  }
+  return normalized;
+}
+function parseAssigneeFilter(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  const normalized = raw.trim().toLowerCase();
+  if (!normalized) {
+    throw new PmCliError("Assignee filter must be one of assigned|unassigned", EXIT_CODE.USAGE);
+  }
+  if (normalized !== "assigned" && normalized !== "unassigned") {
+    throw new PmCliError(`Invalid assignee filter "${raw}". Allowed: assigned|unassigned`, EXIT_CODE.USAGE);
+  }
+  return normalized;
+}
+function resolveStatusFilter(status, statusRegistry) {
+  return parseStatusFilterCsv(status, statusRegistry, { strict: false });
+}
+function applyFilters(items, status, options, typeRegistry, statusRegistry, runtimeFieldFilters) {
+  const statusSet = status && status.length > 0 ? new Set(status) : void 0;
+  const typeFilter = parseType(options.type, typeRegistry);
+  const tagFilter = options.tag?.trim().toLowerCase();
+  const priorityFilter = parsePriority(options.priority);
+  const deadlineBefore = parseDeadline(options.deadlineBefore, "deadline-before");
+  const deadlineAfter = parseDeadline(options.deadlineAfter, "deadline-after");
+  const updatedAfter = parseTimestampWindow(options.updatedAfter, "updated-after");
+  const updatedBefore = parseTimestampWindow(options.updatedBefore, "updated-before");
+  const createdAfter = parseTimestampWindow(options.createdAfter, "created-after");
+  const createdBefore = parseTimestampWindow(options.createdBefore, "created-before");
+  const idsFilter = parseIdsFilter(options.ids);
+  const assigneeFilter = options.assignee?.trim();
+  const assigneeModeFilter = parseAssigneeFilter(options.assigneeFilter);
+  const parentFilter = options.parent?.trim();
+  const sprintFilter = options.sprint?.trim();
+  const releaseFilter = options.release?.trim();
+  if (assigneeFilter && (assigneeFilter.toLowerCase() === "none" || assigneeFilter.toLowerCase() === "null")) {
+    throw new PmCliError('--assignee no longer accepts "none" or "null". Use --assignee-filter unassigned.', EXIT_CODE.USAGE);
+  }
+  if (assigneeFilter !== void 0 && assigneeModeFilter === "unassigned") {
+    throw new PmCliError("Cannot combine --assignee with --assignee-filter unassigned", EXIT_CODE.USAGE);
+  }
+  return items.filter((item) => {
+    if (idsFilter && !idsFilter.has(item.id))
+      return false;
+    if (statusSet && !statusSet.has(item.status))
+      return false;
+    if (options.excludeTerminal && isTerminalStatus(item.status, statusRegistry))
+      return false;
+    if (typeFilter && item.type !== typeFilter)
+      return false;
+    if (tagFilter && !item.tags.includes(tagFilter))
+      return false;
+    if (priorityFilter !== void 0 && item.priority !== priorityFilter)
+      return false;
+    if (deadlineBefore && (!item.deadline || compareTimestampStrings(item.deadline, deadlineBefore) > 0))
+      return false;
+    if (deadlineAfter && (!item.deadline || compareTimestampStrings(item.deadline, deadlineAfter) < 0))
+      return false;
+    if (updatedAfter && compareTimestampStrings(item.updated_at, updatedAfter) < 0)
+      return false;
+    if (updatedBefore && compareTimestampStrings(item.updated_at, updatedBefore) > 0)
+      return false;
+    if (createdAfter && compareTimestampStrings(item.created_at, createdAfter) < 0)
+      return false;
+    if (createdBefore && compareTimestampStrings(item.created_at, createdBefore) > 0)
+      return false;
+    if (assigneeModeFilter === "assigned" && !item.assignee)
+      return false;
+    if (assigneeModeFilter === "unassigned" && item.assignee)
+      return false;
+    if (assigneeFilter !== void 0 && item.assignee !== assigneeFilter) {
+      return false;
+    }
+    if (parentFilter !== void 0 && item.parent !== parentFilter)
+      return false;
+    if (sprintFilter !== void 0 && item.sprint !== sprintFilter)
+      return false;
+    if (releaseFilter !== void 0 && item.release !== releaseFilter)
+      return false;
+    if (!matchesRuntimeFilters(item, runtimeFieldFilters)) {
+      return false;
+    }
+    return true;
+  });
+}
+function compareNullableString(left, right) {
+  if (left === right) {
+    return 0;
+  }
+  if (left === null) {
+    return 1;
+  }
+  if (right === null) {
+    return -1;
+  }
+  return left.localeCompare(right);
+}
+function compareNullableTimestamp(left, right) {
+  if (left === right) {
+    return 0;
+  }
+  if (left === null) {
+    return 1;
+  }
+  if (right === null) {
+    return -1;
+  }
+  return compareTimestampStrings(left, right);
+}
+function compareBySortField(left, right, field) {
+  switch (field) {
+    case "priority":
+      return left.priority - right.priority;
+    case "deadline":
+      return compareNullableTimestamp(left.deadline ?? null, right.deadline ?? null);
+    case "updated_at":
+      return compareTimestampStrings(left.updated_at, right.updated_at);
+    case "created_at":
+      return compareTimestampStrings(left.created_at, right.created_at);
+    case "title":
+      return (left.title ?? "").localeCompare(right.title ?? "");
+    case "parent":
+      return compareNullableString(left.parent ?? null, right.parent ?? null);
+    default:
+      return 0;
+  }
+}
+function sortItems(items, sortField, sortOrder, statusRegistry) {
+  if (!sortField) {
+    return sortItemsDefault(items, statusRegistry);
+  }
+  return [...items].sort((left, right) => {
+    const byField = compareBySortField(left, right, sortField);
+    if (byField !== 0) {
+      return sortOrder === "desc" ? -byField : byField;
+    }
+    const fallback = compareDefaultSort(left, right, statusRegistry);
+    return sortOrder === "desc" ? -fallback : fallback;
+  });
+}
+function readListFieldValue(item, field) {
+  const normalized = normalizeProjectionField(field.trim());
+  if (normalized.length === 0) {
+    return null;
+  }
+  const itemRecord = toItemRecord(item);
+  if (Object.prototype.hasOwnProperty.call(itemRecord, normalized)) {
+    return itemRecord[normalized] ?? null;
+  }
+  return null;
+}
+function projectListItems(items, projection) {
+  if (projection.mode === "full") {
+    return items;
+  }
+  return items.map((item) => {
+    const projected = {};
+    for (const field of projection.fields) {
+      projected[field] = readListFieldValue(item, field);
+    }
+    return projected;
+  });
+}
+async function runList(status, options, global) {
+  const pmRoot = resolvePmRoot(process.cwd(), global.path);
+  if (!await pathExists(getSettingsPath(pmRoot))) {
+    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+  }
+  const settings = await readSettings(pmRoot);
+  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
+  const runtimeFieldRegistry = resolveRuntimeFieldRegistry(settings.schema);
+  const runtimeFieldFilters = collectRuntimeFilterValues(options, runtimeFieldRegistry, "list");
+  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+  const projection = parseProjectionConfig(options);
+  validateListProjectionFields(projection, runtimeFieldRegistry.definitions.map((field) => field.metadata_key));
+  const listWarnings = [];
+  const projectionNeedsBody = projection.fields.some((field) => normalizeProjectionField(field) === "body");
+  const projectionNeedsCollections = projection.mode === "full" || projection.fields.some((field) => HEAVY_PROJECTION_FIELDS.has(normalizeProjectionField(field)));
+  let items;
+  if (options.includeBody || projectionNeedsBody) {
+    items = await listAllFrontMatterWithBody(pmRoot, settings.item_format, typeRegistry.type_to_folder, listWarnings, settings.schema);
+  } else if (projectionNeedsCollections) {
+    items = await listAllFrontMatter(pmRoot, settings.item_format, typeRegistry.type_to_folder, listWarnings, settings.schema);
+  } else {
+    items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, listWarnings, settings.schema);
+  }
+  const sortField = parseSortField(options.sort);
+  const sortOrder = parseSortOrder(options.order) ?? "asc";
+  if (!sortField && options.order !== void 0) {
+    throw new PmCliError("List --order requires --sort", EXIT_CODE.USAGE);
+  }
+  const explicitStatus = resolveStatusFilter(options.status, statusRegistry);
+  const resolvedStatus = explicitStatus ?? resolveStatusFilter(status, statusRegistry);
+  const effectiveOptions = explicitStatus ? { ...options, excludeTerminal: false } : options;
+  const filtered = applyFilters(items, resolvedStatus, effectiveOptions, typeRegistry, statusRegistry, runtimeFieldFilters);
+  const filtersStatus = resolvedStatus === void 0 ? null : resolvedStatus.length === 1 ? resolvedStatus[0] : resolvedStatus;
+  const sorted = sortItems(filtered, sortField, sortOrder, statusRegistry);
+  const limit = parseIntegerLimit(options.limit);
+  const offset = parseOffset(options.offset) ?? 0;
+  const limited = limit === void 0 ? sorted.slice(offset) : sorted.slice(offset, offset + limit);
+  const projected = projectListItems(limited, projection);
+  const now = nowIso();
+  const warnings = [...new Set(listWarnings)].sort((left, right) => left.localeCompare(right));
+  const projectionFields = projection.mode === "full" ? null : [...projection.fields];
+  return {
+    items: projected,
+    count: projected.length,
+    filters: {
+      status: filtersStatus,
+      type: options.type ?? null,
+      tag: options.tag ?? null,
+      priority: options.priority ?? null,
+      deadline_before: options.deadlineBefore ?? null,
+      deadline_after: options.deadlineAfter ?? null,
+      updated_after: options.updatedAfter ?? null,
+      updated_before: options.updatedBefore ?? null,
+      created_after: options.createdAfter ?? null,
+      created_before: options.createdBefore ?? null,
+      ids: options.ids ?? null,
+      assignee: options.assignee ?? null,
+      assignee_filter: options.assigneeFilter ?? null,
+      parent: options.parent ?? null,
+      sprint: options.sprint ?? null,
+      release: options.release ?? null,
+      limit: options.limit ?? null,
+      offset: options.offset ?? null,
+      include_body: options.includeBody ?? null,
+      compact: options.compact ?? null,
+      fields: options.fields ?? null,
+      sort: sortField ?? null,
+      order: sortField ? sortOrder : null,
+      runtime_filters: runtimeFieldFilters
+    },
+    projection: {
+      mode: projection.mode,
+      fields: projectionFields
+    },
+    sorting: {
+      sort: sortField ?? "default",
+      order: sortField ? sortOrder : "asc"
+    },
+    now,
+    ...warnings.length > 0 ? { warnings } : {}
+  };
+}
+
+export {
+  LIST_SORT_FIELDS,
+  LIST_SORT_ORDER_VALUES,
+  runList
+};
+//# sourceMappingURL=chunk-G5BACLYH.js.map
+
+//# debugId=18624348-c10e-5bbb-b8ae-fe5c7dfe1527