@unbrained/pm-cli 2026.5.18 → 2026.5.27

package/dist/cli/commands/linked-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-artifacts.js","sources":["cli/commands/linked-artifacts.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport fg from \"fast-glob\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { createStdinTokenResolver, parseCsvKv } from \"../../core/item/parse.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { listAllFrontMatter, locateItem, mutateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { SCOPE_VALUES } from \"../../types/index.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type { LinkScope } from \"../../types/index.js\";\n\nexport type LinkedArtifact = {\n  path: string;\n  scope: LinkScope;\n  note?: string;\n};\n\nexport interface LinkedArtifactCommandOptions {\n  add?: string[];\n  addGlob?: string[];\n  remove?: string[];\n  migrate?: string[];\n  list?: boolean;\n  appendStable?: boolean;\n  validatePaths?: boolean;\n  audit?: boolean;\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\nexport interface PathMigration {\n  from: string;\n  to: string;\n}\n\nexport interface AddGlobEntry {\n  pattern: string;\n  scope: LinkScope;\n  note?: string;\n}\n\nexport interface LinkedPathValidation {\n  checked: number;\n  existing_files: string[];\n  missing_paths: string[];\n  non_file_paths: string[];\n}\n\nexport interface LinkedPathAuditEntry {\n  path: string;\n  linked_by_count: number;\n  linked_item_ids: string[];\n}\n\nexport interface LinkedArtifactResult {\n  id: string;\n  changed: boolean;\n  count: number;\n  migrations_applied?: number;\n  validation?: LinkedPathValidation;\n  audit?: LinkedPathAuditEntry[];\n  artifacts: LinkedArtifact[];\n}\n\n/**\n * Configuration that adapts the shared linked-artifact command core to a\n * specific resource kind (files or docs) while preserving every behavioral\n * detail of the original twin implementations.\n */\nexport interface LinkedArtifactKindConfig {\n  /** Metadata key under which the artifacts are stored (e.g. \"files\" | \"docs\"). */\n  metadataKey: \"files\" | \"docs\";\n  /** Mutation op recorded in history (e.g. \"files_add\" | \"docs_add\"). */\n  op: \"files_add\" | \"docs_add\";\n  /** Noun used in the \"bare <noun> path\" --add usage error (e.g. \"file\" | \"doc\"). */\n  bareNoun: \"file\" | \"doc\";\n  /**\n   * Whether this kind honors the append-stable option. files supports it;\n   * docs always sorts and must never expose append-stable behavior.\n   */\n  supportsAppendStable: boolean;\n}\n\nexport function ensureScope(raw: string | undefined): LinkScope {\n  const value = (raw ?? \"project\") as LinkScope;\n  if (!SCOPE_VALUES.includes(value)) {\n    throw new PmCliError(\n      `Invalid scope \"${raw}\". Valid scopes: ${SCOPE_VALUES.join(\", \")} (default: project).`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return value;\n}\n\nexport function looksLikeStructuredPathEntry(raw: string): boolean {\n  if (raw.startsWith(\"```\") || raw.includes(\"\\n\")) {\n    return true;\n  }\n  return /^(?:[-*+]\\s+)?(?:path|scope|note)\\s*[:=]/i.test(raw);\n}\n\nexport function parseAddEntries(raw: string[] | undefined, bareNoun: \"file\" | \"doc\"): LinkedArtifact[] {\n  if (!raw) return [];\n  return raw.map((entry) => {\n    const trimmed = entry.trim();\n    const kv = looksLikeStructuredPathEntry(trimmed) ? parseCsvKv(entry, \"--add\") : { path: trimmed };\n    if (!kv.path) {\n      throw new PmCliError(`--add requires path=<value> or a bare ${bareNoun} path`, EXIT_CODE.USAGE);\n    }\n    return {\n      path: kv.path,\n      scope: ensureScope(kv.scope),\n      note: kv.note?.trim() || undefined,\n    };\n  });\n}\n\nexport function parseAddGlobEntries(raw: string[] | undefined): AddGlobEntry[] {\n  if (!raw) return [];\n  return raw.map((entry) => {\n    const trimmed = entry.trim();\n    if (!trimmed) {\n      throw new PmCliError(\"--add-glob requires a glob pattern value\", EXIT_CODE.USAGE);\n    }\n    if (trimmed.includes(\"=\") || /^(?:[-*+]\\s+)?(?:pattern|glob|path)\\s*[:=]/i.test(trimmed) || trimmed.startsWith(\"```\")) {\n      const kv = parseCsvKv(trimmed, \"--add-glob\");\n      const pattern = kv.pattern?.trim() || kv.glob?.trim() || kv.path?.trim();\n      if (!pattern) {\n        throw new PmCliError(\"--add-glob key/value form requires pattern=<glob>\", EXIT_CODE.USAGE);\n      }\n      return {\n        pattern,\n        scope: ensureScope(kv.scope),\n        note: kv.note?.trim() || undefined,\n      };\n    }\n    return {\n      pattern: trimmed,\n      scope: \"project\",\n    };\n  });\n}\n\nexport function parseRemoveEntries(raw: string[] | undefined): string[] {\n  if (!raw) return [];\n  return raw.map((entry) => {\n    const trimmed = entry.trim();\n    if (!trimmed) {\n      throw new PmCliError(\"--remove requires a path value\", EXIT_CODE.USAGE);\n    }\n    if (trimmed.includes(\"=\") || /^(?:[-*+]\\s+)?path\\s*[:=]/i.test(trimmed) || trimmed.startsWith(\"```\")) {\n      const kv = parseCsvKv(trimmed, \"--remove\");\n      if (!kv.path) {\n        throw new PmCliError(\"--remove key/value form requires path=<value>\", EXIT_CODE.USAGE);\n      }\n      return kv.path;\n    }\n    return trimmed;\n  });\n}\n\nexport function parseMigrateEntries(raw: string[] | undefined): PathMigration[] {\n  if (!raw) return [];\n  return raw.map((entry) => {\n    const kv = parseCsvKv(entry, \"--migrate\");\n    const from = kv.from?.trim();\n    const to = kv.to?.trim();\n    if (!from || !to) {\n      throw new PmCliError(\"--migrate requires from=<value> and to=<value>\", EXIT_CODE.USAGE);\n    }\n    return { from, to };\n  });\n}\n\nexport function applyPathMigrations(artifactPath: string, migrations: PathMigration[]): string {\n  let next = artifactPath;\n  for (const migration of migrations) {\n    if (next.startsWith(migration.from)) {\n      next = `${migration.to}${next.slice(migration.from.length)}`;\n    }\n  }\n  return next;\n}\n\nexport function normalizeLinkedPath(value: string): string {\n  return value.split(path.sep).join(\"/\");\n}\n\nexport async function expandAddGlobEntries(entries: AddGlobEntry[]): Promise<LinkedArtifact[]> {\n  const expanded: LinkedArtifact[] = [];\n  for (const entry of entries) {\n    const absolutePattern = path.isAbsolute(entry.pattern);\n    const matches = await fg(entry.pattern, {\n      cwd: process.cwd(),\n      absolute: absolutePattern,\n      onlyFiles: true,\n      dot: true,\n      unique: true,\n      followSymbolicLinks: true,\n    });\n    const sortedMatches = [...new Set(matches.map((match) => normalizeLinkedPath(path.normalize(match))))].sort((left, right) =>\n      left.localeCompare(right),\n    );\n    for (const matchedPath of sortedMatches) {\n      expanded.push({\n        path: matchedPath,\n        scope: entry.scope,\n        note: entry.note,\n      });\n    }\n  }\n  return expanded;\n}\n\nexport function artifactKey(value: Pick<LinkedArtifact, \"path\" | \"scope\">): string {\n  return `${value.path}::${value.scope}`;\n}\n\nexport function sortLinkedArtifacts(artifacts: LinkedArtifact[]): LinkedArtifact[] {\n  return [...artifacts].sort((left, right) => {\n    const byPath = left.path.localeCompare(right.path);\n    if (byPath !== 0) return byPath;\n    return left.scope.localeCompare(right.scope);\n  });\n}\n\nexport function dedupeLinkedArtifacts(artifacts: LinkedArtifact[]): LinkedArtifact[] {\n  return [...new Map(artifacts.map((entry) => [artifactKey(entry), entry])).values()].map((entry) => ({\n    ...entry,\n    note: entry.note?.trim() || undefined,\n  }));\n}\n\nexport async function validateLinkedPaths(paths: string[]): Promise<LinkedPathValidation> {\n  const uniquePaths = [...new Set(paths)].sort((left, right) => left.localeCompare(right));\n  const existingFiles: string[] = [];\n  const missingPaths: string[] = [];\n  const nonFilePaths: string[] = [];\n  for (const relativePath of uniquePaths) {\n    const resolvedPath = path.isAbsolute(relativePath) ? relativePath : path.resolve(process.cwd(), relativePath);\n    try {\n      const stats = await fs.stat(resolvedPath);\n      if (stats.isFile()) {\n        existingFiles.push(relativePath);\n      } else {\n        nonFilePaths.push(relativePath);\n      }\n    } catch (error: unknown) {\n      if (typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === \"ENOENT\") {\n        missingPaths.push(relativePath);\n        continue;\n      }\n      nonFilePaths.push(relativePath);\n    }\n  }\n  return {\n    checked: uniquePaths.length,\n    existing_files: existingFiles,\n    missing_paths: missingPaths,\n    non_file_paths: nonFilePaths,\n  };\n}\n\nexport function buildLinkedPathAudit(\n  paths: string[],\n  allItems: Array<{ id: string; artifacts?: LinkedArtifact[] }>,\n): LinkedPathAuditEntry[] {\n  const index = new Map<string, Set<string>>();\n  for (const item of allItems) {\n    for (const linkedArtifact of item.artifacts ?? []) {\n      const seen = index.get(linkedArtifact.path) ?? new Set<string>();\n      seen.add(item.id);\n      index.set(linkedArtifact.path, seen);\n    }\n  }\n  return [...new Set(paths)]\n    .sort((left, right) => left.localeCompare(right))\n    .map((linkedPath) => {\n      const linkedIds = [...(index.get(linkedPath) ?? new Set<string>())].sort((left, right) => left.localeCompare(right));\n      return {\n        path: linkedPath,\n        linked_by_count: linkedIds.length,\n        linked_item_ids: linkedIds,\n      };\n    });\n}\n\n/**\n * Shared linked-artifact list/mutate command core used by runFiles and runDocs.\n * The kind config selects metadata key, op, bare-path noun, and whether\n * append-stable ordering is honored, preserving each twin's exact semantics.\n */\nexport async function runLinkedArtifacts(\n  id: string,\n  options: LinkedArtifactCommandOptions,\n  global: GlobalOptions,\n  config: LinkedArtifactKindConfig,\n): Promise<LinkedArtifactResult> {\n  const { metadataKey } = config;\n  const stdinResolver = createStdinTokenResolver();\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const resolvedAdds = await stdinResolver.resolveList(options.add, \"--add\");\n  const resolvedAddGlobs = await stdinResolver.resolveList(options.addGlob, \"--add-glob\");\n  const resolvedRemoves = await stdinResolver.resolveList(options.remove, \"--remove\");\n  const resolvedMigrations = await stdinResolver.resolveList(options.migrate, \"--migrate\");\n  const parsedAdds = parseAddEntries(resolvedAdds, config.bareNoun);\n  const addGlobs = parseAddGlobEntries(resolvedAddGlobs);\n  const expandedGlobAdds = await expandAddGlobEntries(addGlobs);\n  const adds = [...parsedAdds, ...expandedGlobAdds];\n  const removes = parseRemoveEntries(resolvedRemoves);\n  const migrations = parseMigrateEntries(resolvedMigrations);\n  const shouldMutate = adds.length > 0 || removes.length > 0 || migrations.length > 0;\n\n  const collectAuditItems = async (): Promise<Array<{ id: string; artifacts?: LinkedArtifact[] }>> =>\n    (await listAllFrontMatter(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema)).map((entry) => ({\n      id: entry.id,\n      artifacts: (entry as Record<string, unknown>)[metadataKey] as LinkedArtifact[] | undefined,\n    }));\n\n  if (!shouldMutate) {\n    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);\n    if (!located) {\n      throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n    }\n    const loaded = await readLocatedItem(located, { schema: settings.schema });\n    const artifacts = ((loaded.document.metadata as Record<string, unknown>)[metadataKey] as LinkedArtifact[] | undefined) ?? [];\n    return {\n      id: located.id,\n      artifacts,\n      changed: false,\n      count: artifacts.length,\n      validation: options.validatePaths ? await validateLinkedPaths(artifacts.map((entry) => entry.path)) : undefined,\n      audit: options.audit ? buildLinkedPathAudit(artifacts.map((entry) => entry.path), await collectAuditItems()) : undefined,\n    };\n  }\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const result = await mutateItem({\n    pmRoot,\n    settings,\n    id,\n    op: config.op,\n    author,\n    message: options.message,\n    force: options.force,\n    mutate(document) {\n      const metadata = document.metadata as Record<string, unknown>;\n      const next = [...((metadata[metadataKey] as LinkedArtifact[] | undefined) ?? [])];\n      let migrationCount = 0;\n      if (migrations.length > 0) {\n        for (let index = 0; index < next.length; index += 1) {\n          const migratedPath = applyPathMigrations(next[index].path, migrations);\n          if (migratedPath !== next[index].path) {\n            next[index] = { ...next[index], path: migratedPath };\n            migrationCount += 1;\n          }\n        }\n      }\n      const migratedAdds = adds.map((entry) => {\n        const migratedPath = applyPathMigrations(entry.path, migrations);\n        if (migratedPath !== entry.path) {\n          migrationCount += 1;\n        }\n        return {\n          ...entry,\n          path: migratedPath,\n        };\n      });\n      const migratedRemoves = removes.map((entry) => applyPathMigrations(entry, migrations));\n      for (const add of migratedAdds) {\n        const exists = next.some((entry) => entry.path === add.path && entry.scope === add.scope);\n        if (!exists) {\n          next.push(add);\n        }\n      }\n      if (migratedRemoves.length > 0) {\n        for (let i = next.length - 1; i >= 0; i -= 1) {\n          if (migratedRemoves.includes(next[i].path)) {\n            next.splice(i, 1);\n          }\n        }\n      }\n      const deduped = dedupeLinkedArtifacts(next);\n      const normalized = config.supportsAppendStable && options.appendStable ? deduped : sortLinkedArtifacts(deduped);\n      if (normalized.length > 0) {\n        metadata[metadataKey] = normalized;\n      } else {\n        delete metadata[metadataKey];\n      }\n      return { changedFields: [metadataKey], warnings: migrationCount > 0 ? [`path_migrations_applied:${migrationCount}`] : [] };\n    },\n  });\n\n  const artifacts = ((result.item as Record<string, unknown>)[metadataKey] as LinkedArtifact[] | undefined) ?? [];\n  const migrationWarning = result.warnings.find((warning) => warning.startsWith(\"path_migrations_applied:\"));\n  const migrationCount = migrationWarning ? Number(migrationWarning.slice(\"path_migrations_applied:\".length)) : 0;\n  const allItems = options.audit ? await collectAuditItems() : [];\n  return {\n    id: result.item.id,\n    artifacts,\n    changed: true,\n    count: artifacts.length,\n    migrations_applied: migrationCount > 0 ? migrationCount : undefined,\n    validation: options.validatePaths ? await validateLinkedPaths(artifacts.map((entry) => entry.path)) : undefined,\n    audit: options.audit ? buildLinkedPathAudit(artifacts.map((entry) => entry.path), allItems) : undefined,\n  };\n}\n\n/**\n * Re-key the generic `artifacts` field to the resource-specific name (files/docs)\n * while preserving the original key order and presence so kind-specific result\n * shapes (and their deterministic JSON key ordering) stay byte-identical.\n */\nexport function renameArtifactsResultKey(result: LinkedArtifactResult, key: \"files\" | \"docs\"): Record<string, unknown> {\n  const out: Record<string, unknown> = {};\n  for (const [field, value] of Object.entries(result)) {\n    out[field === \"artifacts\" ? key : field] = value;\n  }\n  return out;\n}\n"],"names":[],"mappings":"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","debugId":"352e67e3-0c41-5c04-8d2d-3395c6216303"}

package/dist/cli/commands/linked-test-entry.d.ts

@@ -0,0 +1,3 @@
+export declare const STRUCTURED_LINKED_TEST_KEYS: readonly ["command", "cmd", "path", "scope", "timeout", "timeout_seconds", "pm_context_mode", "env_set", "env_clear", "shared_host_safe", "assert_stdout_contains", "assert_stdout_regex", "assert_stderr_contains", "assert_stderr_regex", "assert_stdout_min_lines", "assert_json_field_equals", "assert_json_field_gte", "note"];
+export declare function looksLikeStructuredLinkedTestEntry(raw: string): boolean;
+export declare function normalizeStructuredLinkedTestEntry(kv: Record<string, string>, optionName: "--add" | "--test"): Record<string, string>;

package/dist/cli/commands/linked-test-entry.js

@@ -0,0 +1,62 @@
+
+!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]="7baeda8a-886b-5069-b350-940c224dbf94")}catch(e){}}();
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+// Keys accepted inside a structured linked-test entry. `cmd` is an alias for
+// `command`; everything else maps 1:1 to a LinkedTest field.
+export const STRUCTURED_LINKED_TEST_KEYS = [
+    "command",
+    "cmd",
+    "path",
+    "scope",
+    "timeout",
+    "timeout_seconds",
+    "pm_context_mode",
+    "env_set",
+    "env_clear",
+    "shared_host_safe",
+    "assert_stdout_contains",
+    "assert_stdout_regex",
+    "assert_stderr_contains",
+    "assert_stderr_regex",
+    "assert_stdout_min_lines",
+    "assert_json_field_equals",
+    "assert_json_field_gte",
+    "note",
+];
+const STRUCTURED_LINKED_TEST_KEY_SET = new Set(STRUCTURED_LINKED_TEST_KEYS);
+const STRUCTURED_LINKED_TEST_KEY_PATTERN = STRUCTURED_LINKED_TEST_KEYS.map((key) => key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|");
+const STRUCTURED_LINKED_TEST_ENTRY_PATTERN = new RegExp(`^(?:[-*+]\\s+)?(?:${STRUCTURED_LINKED_TEST_KEY_PATTERN})\\s*[:=]`, "i");
+export function looksLikeStructuredLinkedTestEntry(raw) {
+    if (raw.startsWith("```") || raw.includes("\n")) {
+        return true;
+    }
+    return STRUCTURED_LINKED_TEST_ENTRY_PATTERN.test(raw);
+}
+export function normalizeStructuredLinkedTestEntry(kv, optionName) {
+    const normalizedKv = {};
+    const unknownKeys = [];
+    for (const [key, value] of Object.entries(kv)) {
+        const normalizedKey = key.toLowerCase();
+        if (!STRUCTURED_LINKED_TEST_KEY_SET.has(normalizedKey)) {
+            unknownKeys.push(key);
+            continue;
+        }
+        normalizedKv[normalizedKey] = value;
+    }
+    if (unknownKeys.length > 0) {
+        throw new PmCliError(`${optionName} does not recognize key${unknownKeys.length > 1 ? "s" : ""} ${unknownKeys
+            .map((key) => `"${key}"`)
+            .join(", ")}. Allowed keys: ${STRUCTURED_LINKED_TEST_KEYS.join(", ")}.`, EXIT_CODE.USAGE);
+    }
+    if (normalizedKv.cmd !== undefined) {
+        if (normalizedKv.command !== undefined && normalizedKv.command.trim() !== normalizedKv.cmd.trim()) {
+            throw new PmCliError(`${optionName} command and cmd must match when both are provided`, EXIT_CODE.USAGE);
+        }
+        const { cmd, ...rest } = normalizedKv;
+        return { ...rest, command: rest.command ?? cmd };
+    }
+    return normalizedKv;
+}
+//# sourceMappingURL=linked-test-entry.js.map
+//# debugId=7baeda8a-886b-5069-b350-940c224dbf94

package/dist/cli/commands/linked-test-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-test-entry.js","sources":["cli/commands/linked-test-entry.ts"],"sourceRoot":"/","sourcesContent":["import { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\n\n// Keys accepted inside a structured linked-test entry. `cmd` is an alias for\n// `command`; everything else maps 1:1 to a LinkedTest field.\nexport const STRUCTURED_LINKED_TEST_KEYS = [\n  \"command\",\n  \"cmd\",\n  \"path\",\n  \"scope\",\n  \"timeout\",\n  \"timeout_seconds\",\n  \"pm_context_mode\",\n  \"env_set\",\n  \"env_clear\",\n  \"shared_host_safe\",\n  \"assert_stdout_contains\",\n  \"assert_stdout_regex\",\n  \"assert_stderr_contains\",\n  \"assert_stderr_regex\",\n  \"assert_stdout_min_lines\",\n  \"assert_json_field_equals\",\n  \"assert_json_field_gte\",\n  \"note\",\n] as const;\n\nconst STRUCTURED_LINKED_TEST_KEY_SET = new Set<string>(STRUCTURED_LINKED_TEST_KEYS);\nconst STRUCTURED_LINKED_TEST_KEY_PATTERN = STRUCTURED_LINKED_TEST_KEYS.map((key) =>\n  key.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\"),\n).join(\"|\");\nconst STRUCTURED_LINKED_TEST_ENTRY_PATTERN = new RegExp(\n  `^(?:[-*+]\\\\s+)?(?:${STRUCTURED_LINKED_TEST_KEY_PATTERN})\\\\s*[:=]`,\n  \"i\",\n);\n\nexport function looksLikeStructuredLinkedTestEntry(raw: string): boolean {\n  if (raw.startsWith(\"```\") || raw.includes(\"\\n\")) {\n    return true;\n  }\n  return STRUCTURED_LINKED_TEST_ENTRY_PATTERN.test(raw);\n}\n\nexport function normalizeStructuredLinkedTestEntry(\n  kv: Record<string, string>,\n  optionName: \"--add\" | \"--test\",\n): Record<string, string> {\n  const normalizedKv: Record<string, string> = {};\n  const unknownKeys: string[] = [];\n  for (const [key, value] of Object.entries(kv)) {\n    const normalizedKey = key.toLowerCase();\n    if (!STRUCTURED_LINKED_TEST_KEY_SET.has(normalizedKey)) {\n      unknownKeys.push(key);\n      continue;\n    }\n    normalizedKv[normalizedKey] = value;\n  }\n  if (unknownKeys.length > 0) {\n    throw new PmCliError(\n      `${optionName} does not recognize key${unknownKeys.length > 1 ? \"s\" : \"\"} ${unknownKeys\n        .map((key) => `\"${key}\"`)\n        .join(\", \")}. Allowed keys: ${STRUCTURED_LINKED_TEST_KEYS.join(\", \")}.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (normalizedKv.cmd !== undefined) {\n    if (normalizedKv.command !== undefined && normalizedKv.command.trim() !== normalizedKv.cmd.trim()) {\n      throw new PmCliError(`${optionName} command and cmd must match when both are provided`, EXIT_CODE.USAGE);\n    }\n    const { cmd, ...rest } = normalizedKv;\n    return { ...rest, command: rest.command ?? cmd };\n  }\n  return normalizedKv;\n}\n"],"names":[],"mappings":"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","debugId":"7baeda8a-886b-5069-b350-940c224dbf94"}

package/dist/cli/commands/linked-test-parsers.d.ts

@@ -0,0 +1,28 @@
+import type { LinkedTest } from "../../types/index.js";
+/**
+ * Shared linked-test field parsers used by the `create` and `test` commands.
+ *
+ * Extracted verbatim from create.ts and test.ts (pm-why9). The two copies were
+ * byte-identical apart from their empty-input guard: create called these with
+ * raw (untrimmed) values and used `if (!normalized)`; test called them with
+ * pre-`.trim()`-ed values and used `if (!raw || raw.trim().length === 0)`.
+ *
+ * Both reduce to the same observable behaviour when the guard is the plain
+ * falsy check used here: create's call sites still pass untrimmed values
+ * (behaviour preserved exactly), and test's call sites pre-trim so a
+ * whitespace-only value collapses to "" and is rejected by `!raw` exactly as
+ * before. Error strings and parsing semantics are identical to both originals.
+ */
+export declare const LINKED_TEST_PROTECTED_ENV_KEYS: Set<string>;
+export declare const LINKED_TEST_ENV_NAME_PATTERN: RegExp;
+export declare const LINKED_TEST_PM_CONTEXT_MODE_VALUES: readonly ["schema", "tracker", "auto"];
+export type LinkedTestPmContextMode = (typeof LINKED_TEST_PM_CONTEXT_MODE_VALUES)[number];
+export declare function parseLinkedTestEnvSet(raw: string | undefined, optionName: string): Record<string, string> | undefined;
+export declare function parseLinkedTestEnvClear(raw: string | undefined, optionName: string): string[] | undefined;
+export declare function parseLinkedTestBoolean(raw: string | undefined, optionName: string, fieldLabel: string): boolean | undefined;
+export declare function parseLinkedTestContextMode(raw: string | undefined, optionName: string): LinkedTest["pm_context_mode"] | undefined;
+export declare function parseLinkedTestStringList(raw: string | undefined): string[] | undefined;
+export declare function parseLinkedTestRegexList(raw: string | undefined, optionName: string, fieldLabel: string): string[] | undefined;
+export declare function parseLinkedTestMinLines(raw: string | undefined, optionName: string): number | undefined;
+export declare function parseLinkedTestAssertionEqualsMap(raw: string | undefined, optionName: string): Record<string, string> | undefined;
+export declare function parseLinkedTestAssertionGteMap(raw: string | undefined, optionName: string): Record<string, number> | undefined;

package/dist/cli/commands/linked-test-parsers.js

@@ -0,0 +1,192 @@
+
+!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]="8dda4564-25c9-55a3-a141-656338bf70bd")}catch(e){}}();
+import { parseOptionalNumber } from "../../core/item/parse.js";
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+/**
+ * Shared linked-test field parsers used by the `create` and `test` commands.
+ *
+ * Extracted verbatim from create.ts and test.ts (pm-why9). The two copies were
+ * byte-identical apart from their empty-input guard: create called these with
+ * raw (untrimmed) values and used `if (!normalized)`; test called them with
+ * pre-`.trim()`-ed values and used `if (!raw || raw.trim().length === 0)`.
+ *
+ * Both reduce to the same observable behaviour when the guard is the plain
+ * falsy check used here: create's call sites still pass untrimmed values
+ * (behaviour preserved exactly), and test's call sites pre-trim so a
+ * whitespace-only value collapses to "" and is rejected by `!raw` exactly as
+ * before. Error strings and parsing semantics are identical to both originals.
+ */
+export const LINKED_TEST_PROTECTED_ENV_KEYS = new Set(["PM_PATH", "PM_GLOBAL_PATH", "FORCE_COLOR"]);
+export const LINKED_TEST_ENV_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+export const LINKED_TEST_PM_CONTEXT_MODE_VALUES = ["schema", "tracker", "auto"];
+export function parseLinkedTestEnvSet(raw, optionName) {
+    if (!raw) {
+        return undefined;
+    }
+    const assignments = raw
+        .split(/[;\n]/)
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+    if (assignments.length === 0) {
+        throw new PmCliError(`${optionName} env_set must include at least one KEY=VALUE assignment`, EXIT_CODE.USAGE);
+    }
+    const envSet = {};
+    for (const assignment of assignments) {
+        const separatorIndex = assignment.indexOf("=");
+        if (separatorIndex <= 0) {
+            throw new PmCliError(`${optionName} env_set entries must use KEY=VALUE and be separated by semicolons. Example: env_set=PORT=0;PLAYWRIGHT_BASE_URL=http://127.0.0.1:4173`, EXIT_CODE.USAGE);
+        }
+        const key = assignment.slice(0, separatorIndex).trim();
+        const value = assignment.slice(separatorIndex + 1);
+        if (!LINKED_TEST_ENV_NAME_PATTERN.test(key)) {
+            throw new PmCliError(`${optionName} env_set key "${key}" is invalid`, EXIT_CODE.USAGE);
+        }
+        if (LINKED_TEST_PROTECTED_ENV_KEYS.has(key.toUpperCase())) {
+            throw new PmCliError(`${optionName} env_set key "${key}" is reserved for sandbox safety`, EXIT_CODE.USAGE);
+        }
+        envSet[key] = value;
+    }
+    /* c8 ignore start -- envSet always has >=1 key here (assignments is non-empty and each adds one); the undefined branch is defensive. */
+    return Object.keys(envSet).length > 0 ? envSet : undefined;
+    /* c8 ignore stop */
+}
+export function parseLinkedTestEnvClear(raw, optionName) {
+    if (!raw) {
+        return undefined;
+    }
+    const keys = [...new Set(raw.split(/[;,\n]/).map((entry) => entry.trim()).filter((entry) => entry.length > 0))];
+    if (keys.length === 0) {
+        throw new PmCliError(`${optionName} env_clear must include at least one environment variable name`, EXIT_CODE.USAGE);
+    }
+    for (const key of keys) {
+        if (!LINKED_TEST_ENV_NAME_PATTERN.test(key)) {
+            throw new PmCliError(`${optionName} env_clear key "${key}" is invalid`, EXIT_CODE.USAGE);
+        }
+        if (LINKED_TEST_PROTECTED_ENV_KEYS.has(key.toUpperCase())) {
+            throw new PmCliError(`${optionName} env_clear key "${key}" is reserved for sandbox safety`, EXIT_CODE.USAGE);
+        }
+    }
+    return keys;
+}
+export function parseLinkedTestBoolean(raw, optionName, fieldLabel) {
+    if (!raw) {
+        return undefined;
+    }
+    const value = raw.trim().toLowerCase();
+    if (value === "true" || value === "1" || value === "yes") {
+        return true;
+    }
+    if (value === "false" || value === "0" || value === "no") {
+        return false;
+    }
+    throw new PmCliError(`${optionName} ${fieldLabel} must be one of true|false|1|0|yes|no`, EXIT_CODE.USAGE);
+}
+export function parseLinkedTestContextMode(raw, optionName) {
+    if (!raw) {
+        return undefined;
+    }
+    const value = raw.trim().toLowerCase();
+    if (LINKED_TEST_PM_CONTEXT_MODE_VALUES.includes(value)) {
+        return value;
+    }
+    throw new PmCliError(`${optionName} pm_context_mode must be one of: ${LINKED_TEST_PM_CONTEXT_MODE_VALUES.join(", ")}`, EXIT_CODE.USAGE);
+}
+export function parseLinkedTestStringList(raw) {
+    if (!raw) {
+        return undefined;
+    }
+    const values = [...new Set(raw.split(/[;\n]/).map((entry) => entry.trim()).filter((entry) => entry.length > 0))];
+    return values.length > 0 ? values : undefined;
+}
+export function parseLinkedTestRegexList(raw, optionName, fieldLabel) {
+    const values = parseLinkedTestStringList(raw);
+    if (!values || values.length === 0) {
+        return undefined;
+    }
+    for (const pattern of values) {
+        try {
+            // Validate regex syntax early so malformed assertions fail at parse time.
+            // User-provided, per-item patterns only run during local CLI validation.
+            new RegExp(pattern, "m");
+        }
+        catch (error) {
+            throw new PmCliError(
+            /* c8 ignore next -- RegExp only throws SyntaxError (an Error); String(error) fallback is defensive. */
+            `${optionName} ${fieldLabel} includes invalid regex "${pattern}": ${error instanceof Error ? error.message : String(error)}`, EXIT_CODE.USAGE);
+        }
+    }
+    return values;
+}
+export function parseLinkedTestMinLines(raw, optionName) {
+    if (!raw) {
+        return undefined;
+    }
+    const parsed = parseOptionalNumber(raw, "assert_stdout_min_lines");
+    if (!Number.isInteger(parsed) || parsed < 0) {
+        throw new PmCliError(`${optionName} assert_stdout_min_lines must be an integer >= 0`, EXIT_CODE.USAGE);
+    }
+    return parsed;
+}
+export function parseLinkedTestAssertionEqualsMap(raw, optionName) {
+    if (!raw) {
+        return undefined;
+    }
+    const assignments = raw
+        .split(/[;\n]/)
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+    if (assignments.length === 0) {
+        throw new PmCliError(`${optionName} assert_json_field_equals must include at least one path=value assignment`, EXIT_CODE.USAGE);
+    }
+    const values = {};
+    for (const assignment of assignments) {
+        const separatorIndex = assignment.indexOf("=");
+        if (separatorIndex <= 0) {
+            throw new PmCliError(`${optionName} assert_json_field_equals entries must use path=value and be separated by semicolons`, EXIT_CODE.USAGE);
+        }
+        const key = assignment.slice(0, separatorIndex).trim();
+        const value = assignment.slice(separatorIndex + 1).trim();
+        if (key.length === 0 || value.length === 0) {
+            throw new PmCliError(`${optionName} assert_json_field_equals entries must include non-empty path and value`, EXIT_CODE.USAGE);
+        }
+        values[key] = value;
+    }
+    /* c8 ignore start -- values always has >=1 key here (assignments is non-empty and each adds one); the undefined branch is defensive. */
+    return Object.keys(values).length > 0 ? values : undefined;
+    /* c8 ignore stop */
+}
+export function parseLinkedTestAssertionGteMap(raw, optionName) {
+    if (!raw) {
+        return undefined;
+    }
+    const assignments = raw
+        .split(/[;\n]/)
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+    if (assignments.length === 0) {
+        throw new PmCliError(`${optionName} assert_json_field_gte must include at least one path=value assignment`, EXIT_CODE.USAGE);
+    }
+    const values = {};
+    for (const assignment of assignments) {
+        const separatorIndex = assignment.indexOf("=");
+        if (separatorIndex <= 0) {
+            throw new PmCliError(`${optionName} assert_json_field_gte entries must use path=value and be separated by semicolons`, EXIT_CODE.USAGE);
+        }
+        const key = assignment.slice(0, separatorIndex).trim();
+        const valueRaw = assignment.slice(separatorIndex + 1).trim();
+        if (key.length === 0 || valueRaw.length === 0) {
+            throw new PmCliError(`${optionName} assert_json_field_gte entries must include non-empty path and value`, EXIT_CODE.USAGE);
+        }
+        const value = Number.parseFloat(valueRaw);
+        if (!Number.isFinite(value)) {
+            throw new PmCliError(`${optionName} assert_json_field_gte value for "${key}" must be numeric`, EXIT_CODE.USAGE);
+        }
+        values[key] = value;
+    }
+    /* c8 ignore start -- values always has >=1 key here (assignments is non-empty and each adds one); the undefined branch is defensive. */
+    return Object.keys(values).length > 0 ? values : undefined;
+    /* c8 ignore stop */
+}
+//# sourceMappingURL=linked-test-parsers.js.map
+//# debugId=8dda4564-25c9-55a3-a141-656338bf70bd

package/dist/cli/commands/linked-test-parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"linked-test-parsers.js","sources":["cli/commands/linked-test-parsers.ts"],"sourceRoot":"/","sourcesContent":["import { parseOptionalNumber } from \"../../core/item/parse.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport type { LinkedTest } from \"../../types/index.js\";\n\n/**\n * Shared linked-test field parsers used by the `create` and `test` commands.\n *\n * Extracted verbatim from create.ts and test.ts (pm-why9). The two copies were\n * byte-identical apart from their empty-input guard: create called these with\n * raw (untrimmed) values and used `if (!normalized)`; test called them with\n * pre-`.trim()`-ed values and used `if (!raw || raw.trim().length === 0)`.\n *\n * Both reduce to the same observable behaviour when the guard is the plain\n * falsy check used here: create's call sites still pass untrimmed values\n * (behaviour preserved exactly), and test's call sites pre-trim so a\n * whitespace-only value collapses to \"\" and is rejected by `!raw` exactly as\n * before. Error strings and parsing semantics are identical to both originals.\n */\n\nexport const LINKED_TEST_PROTECTED_ENV_KEYS = new Set([\"PM_PATH\", \"PM_GLOBAL_PATH\", \"FORCE_COLOR\"]);\nexport const LINKED_TEST_ENV_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;\nexport const LINKED_TEST_PM_CONTEXT_MODE_VALUES = [\"schema\", \"tracker\", \"auto\"] as const;\nexport type LinkedTestPmContextMode = (typeof LINKED_TEST_PM_CONTEXT_MODE_VALUES)[number];\n\nexport function parseLinkedTestEnvSet(raw: string | undefined, optionName: string): Record<string, string> | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  const assignments = raw\n    .split(/[;\\n]/)\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0);\n  if (assignments.length === 0) {\n    throw new PmCliError(`${optionName} env_set must include at least one KEY=VALUE assignment`, EXIT_CODE.USAGE);\n  }\n  const envSet: Record<string, string> = {};\n  for (const assignment of assignments) {\n    const separatorIndex = assignment.indexOf(\"=\");\n    if (separatorIndex <= 0) {\n      throw new PmCliError(\n        `${optionName} env_set entries must use KEY=VALUE and be separated by semicolons. Example: env_set=PORT=0;PLAYWRIGHT_BASE_URL=http://127.0.0.1:4173`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const key = assignment.slice(0, separatorIndex).trim();\n    const value = assignment.slice(separatorIndex + 1);\n    if (!LINKED_TEST_ENV_NAME_PATTERN.test(key)) {\n      throw new PmCliError(`${optionName} env_set key \"${key}\" is invalid`, EXIT_CODE.USAGE);\n    }\n    if (LINKED_TEST_PROTECTED_ENV_KEYS.has(key.toUpperCase())) {\n      throw new PmCliError(`${optionName} env_set key \"${key}\" is reserved for sandbox safety`, EXIT_CODE.USAGE);\n    }\n    envSet[key] = value;\n  }\n  /* c8 ignore start -- envSet always has >=1 key here (assignments is non-empty and each adds one); the undefined branch is defensive. */\n  return Object.keys(envSet).length > 0 ? envSet : undefined;\n  /* c8 ignore stop */\n}\n\nexport function parseLinkedTestEnvClear(raw: string | undefined, optionName: string): string[] | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  const keys = [...new Set(raw.split(/[;,\\n]/).map((entry) => entry.trim()).filter((entry) => entry.length > 0))];\n  if (keys.length === 0) {\n    throw new PmCliError(`${optionName} env_clear must include at least one environment variable name`, EXIT_CODE.USAGE);\n  }\n  for (const key of keys) {\n    if (!LINKED_TEST_ENV_NAME_PATTERN.test(key)) {\n      throw new PmCliError(`${optionName} env_clear key \"${key}\" is invalid`, EXIT_CODE.USAGE);\n    }\n    if (LINKED_TEST_PROTECTED_ENV_KEYS.has(key.toUpperCase())) {\n      throw new PmCliError(`${optionName} env_clear key \"${key}\" is reserved for sandbox safety`, EXIT_CODE.USAGE);\n    }\n  }\n  return keys;\n}\n\nexport function parseLinkedTestBoolean(raw: string | undefined, optionName: string, fieldLabel: string): boolean | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  const value = raw.trim().toLowerCase();\n  if (value === \"true\" || value === \"1\" || value === \"yes\") {\n    return true;\n  }\n  if (value === \"false\" || value === \"0\" || value === \"no\") {\n    return false;\n  }\n  throw new PmCliError(`${optionName} ${fieldLabel} must be one of true|false|1|0|yes|no`, EXIT_CODE.USAGE);\n}\n\nexport function parseLinkedTestContextMode(\n  raw: string | undefined,\n  optionName: string,\n): LinkedTest[\"pm_context_mode\"] | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  const value = raw.trim().toLowerCase();\n  if ((LINKED_TEST_PM_CONTEXT_MODE_VALUES as readonly string[]).includes(value)) {\n    return value as LinkedTest[\"pm_context_mode\"];\n  }\n  throw new PmCliError(\n    `${optionName} pm_context_mode must be one of: ${LINKED_TEST_PM_CONTEXT_MODE_VALUES.join(\", \")}`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nexport function parseLinkedTestStringList(raw: string | undefined): string[] | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  const values = [...new Set(raw.split(/[;\\n]/).map((entry) => entry.trim()).filter((entry) => entry.length > 0))];\n  return values.length > 0 ? values : undefined;\n}\n\nexport function parseLinkedTestRegexList(raw: string | undefined, optionName: string, fieldLabel: string): string[] | undefined {\n  const values = parseLinkedTestStringList(raw);\n  if (!values || values.length === 0) {\n    return undefined;\n  }\n  for (const pattern of values) {\n    try {\n      // Validate regex syntax early so malformed assertions fail at parse time.\n      // User-provided, per-item patterns only run during local CLI validation.\n      new RegExp(pattern, \"m\");\n    } catch (error: unknown) {\n      throw new PmCliError(\n        /* c8 ignore next -- RegExp only throws SyntaxError (an Error); String(error) fallback is defensive. */\n        `${optionName} ${fieldLabel} includes invalid regex \"${pattern}\": ${error instanceof Error ? error.message : String(error)}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n  }\n  return values;\n}\n\nexport function parseLinkedTestMinLines(raw: string | undefined, optionName: string): number | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  const parsed = parseOptionalNumber(raw, \"assert_stdout_min_lines\");\n  if (!Number.isInteger(parsed) || parsed < 0) {\n    throw new PmCliError(`${optionName} assert_stdout_min_lines must be an integer >= 0`, EXIT_CODE.USAGE);\n  }\n  return parsed;\n}\n\nexport function parseLinkedTestAssertionEqualsMap(raw: string | undefined, optionName: string): Record<string, string> | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  const assignments = raw\n    .split(/[;\\n]/)\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0);\n  if (assignments.length === 0) {\n    throw new PmCliError(`${optionName} assert_json_field_equals must include at least one path=value assignment`, EXIT_CODE.USAGE);\n  }\n  const values: Record<string, string> = {};\n  for (const assignment of assignments) {\n    const separatorIndex = assignment.indexOf(\"=\");\n    if (separatorIndex <= 0) {\n      throw new PmCliError(\n        `${optionName} assert_json_field_equals entries must use path=value and be separated by semicolons`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const key = assignment.slice(0, separatorIndex).trim();\n    const value = assignment.slice(separatorIndex + 1).trim();\n    if (key.length === 0 || value.length === 0) {\n      throw new PmCliError(`${optionName} assert_json_field_equals entries must include non-empty path and value`, EXIT_CODE.USAGE);\n    }\n    values[key] = value;\n  }\n  /* c8 ignore start -- values always has >=1 key here (assignments is non-empty and each adds one); the undefined branch is defensive. */\n  return Object.keys(values).length > 0 ? values : undefined;\n  /* c8 ignore stop */\n}\n\nexport function parseLinkedTestAssertionGteMap(raw: string | undefined, optionName: string): Record<string, number> | undefined {\n  if (!raw) {\n    return undefined;\n  }\n  const assignments = raw\n    .split(/[;\\n]/)\n    .map((entry) => entry.trim())\n    .filter((entry) => entry.length > 0);\n  if (assignments.length === 0) {\n    throw new PmCliError(`${optionName} assert_json_field_gte must include at least one path=value assignment`, EXIT_CODE.USAGE);\n  }\n  const values: Record<string, number> = {};\n  for (const assignment of assignments) {\n    const separatorIndex = assignment.indexOf(\"=\");\n    if (separatorIndex <= 0) {\n      throw new PmCliError(\n        `${optionName} assert_json_field_gte entries must use path=value and be separated by semicolons`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const key = assignment.slice(0, separatorIndex).trim();\n    const valueRaw = assignment.slice(separatorIndex + 1).trim();\n    if (key.length === 0 || valueRaw.length === 0) {\n      throw new PmCliError(`${optionName} assert_json_field_gte entries must include non-empty path and value`, EXIT_CODE.USAGE);\n    }\n    const value = Number.parseFloat(valueRaw);\n    if (!Number.isFinite(value)) {\n      throw new PmCliError(`${optionName} assert_json_field_gte value for \"${key}\" must be numeric`, EXIT_CODE.USAGE);\n    }\n    values[key] = value;\n  }\n  /* c8 ignore start -- values always has >=1 key here (assignments is non-empty and each adds one); the undefined branch is defensive. */\n  return Object.keys(values).length > 0 ? values : undefined;\n  /* c8 ignore stop */\n}\n"],"names":[],"mappings":"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","debugId":"8dda4564-25c9-55a3-a141-656338bf70bd"}

package/dist/cli/commands/list.js

@@ -1,13 +1,14 @@
 
-!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]="5a5182ef-314f-551d-adbf-df52067ef6b3")}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]="780dfabe-641b-59e4-8137-84eaa248543d")}catch(e){}}();
 import { pathExists } from "../../core/fs/fs-utils.js";
 import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
-import { normalizeStatusInput } from "../../core/item/status.js";
+import { toItemRecord } from "../../core/item/item-record.js";
+import { isTerminalStatus, normalizeStatusInput } from "../../core/item/status.js";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
 import { parseIntegerLimit, parsePriority, parseType } from "../shared-parsers.js";
 import { collectRuntimeFilterValues, matchesRuntimeFilters } from "../../core/schema/runtime-field-filters.js";
 import { resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, } from "../../core/schema/runtime-schema.js";
-import { EXIT_CODE } from "../../core/shared/constants.js";
+import { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
 import { compareTimestampStrings, nowIso, resolveIsoOrRelative } from "../../core/shared/time.js";
 import { listAllFrontMatter, listAllFrontMatterWithBody } from "../../core/store/item-store.js";
@@ -17,13 +18,9 @@ export const LIST_SORT_FIELDS = ["priority", "deadline", "updated_at", "created_
 export const LIST_SORT_ORDER_VALUES = ["asc", "desc"];
 const DEFAULT_COMPACT_LIST_FIELDS = ["id", "title", "status", "type", "priority", "parent", "updated_at"];
 const BRIEF_LIST_FIELDS = ["id", "status", "type", "title"];
-function isTerminal(status, statusRegistry) {
-    const normalized = normalizeStatusInput(status, statusRegistry) ?? status;
-    return statusRegistry.terminal_statuses.has(normalized);
-}
 function compareDefaultSort(left, right, statusRegistry) {
-    const leftTerminal = isTerminal(left.status, statusRegistry);
-    const rightTerminal = isTerminal(right.status, statusRegistry);
+    const leftTerminal = isTerminalStatus(left.status, statusRegistry);
+    const rightTerminal = isTerminalStatus(right.status, statusRegistry);
     if (leftTerminal !== rightTerminal) {
         return leftTerminal ? 1 : -1;
     }
@@ -105,13 +102,47 @@ function parseProjectionConfig(options) {
         fields: [],
     };
 }
+function normalizeProjectionField(field) {
+    return field.startsWith("item.") ? field.slice("item.".length) : field;
+}
+function validateListProjectionFields(projection, runtimeMetadataKeys) {
+    if (projection.mode !== "fields") {
+        return;
+    }
+    const allowed = 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",
+            ],
+        });
+    }
+}
+// Convenience aliases so agents/humans who reach for the bare verb form
+// (e.g. `--sort updated`) land on the canonical timestamp fields instead of an error.
+// A Map (not a plain object) avoids prototype-chain lookups for keys like "__proto__".
+const LIST_SORT_FIELD_ALIASES = new Map([
+    ["updated", "updated_at"],
+    ["update", "updated_at"],
+    ["modified", "updated_at"],
+    ["created", "created_at"],
+    ["create", "created_at"],
+]);
 function parseSortField(raw) {
     if (raw === undefined) {
         return undefined;
     }
     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("|")}`, EXIT_CODE.USAGE);
+        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;
 }
@@ -184,7 +215,7 @@ function applyFilters(items, status, options, typeRegistry, statusRegistry, runt
     return items.filter((item) => {
         if (statusSet && !statusSet.has(item.status))
             return false;
-        if (options.excludeTerminal && isTerminal(item.status, statusRegistry))
+        if (options.excludeTerminal && isTerminalStatus(item.status, statusRegistry))
             return false;
         if (typeFilter && item.type !== typeFilter)
             return false;
@@ -271,19 +302,11 @@ function sortItems(items, sortField, sortOrder, statusRegistry) {
     });
 }
 function readListFieldValue(item, field) {
-    const normalized = field.trim();
+    const normalized = normalizeProjectionField(field.trim());
     if (normalized.length === 0) {
         return null;
     }
-    if (normalized.startsWith("item.")) {
-        const nestedKey = normalized.slice("item.".length);
-        if (nestedKey.length === 0) {
-            return null;
-        }
-        const itemRecord = item;
-        return itemRecord[nestedKey] ?? null;
-    }
-    const itemRecord = item;
+    const itemRecord = toItemRecord(item);
     if (Object.prototype.hasOwnProperty.call(itemRecord, normalized)) {
         return itemRecord[normalized] ?? null;
     }
@@ -311,11 +334,13 @@ export async function runList(status, options, global) {
     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 items = options.includeBody
+    const projectionNeedsBody = projection.fields.some((field) => normalizeProjectionField(field) === "body");
+    const items = options.includeBody || projectionNeedsBody
         ? await listAllFrontMatterWithBody(pmRoot, settings.item_format, typeRegistry.type_to_folder, listWarnings, settings.schema)
         : await listAllFrontMatter(pmRoot, settings.item_format, typeRegistry.type_to_folder, listWarnings, settings.schema);
-    const projection = parseProjectionConfig(options);
     const sortField = parseSortField(options.sort);
     const sortOrder = parseSortOrder(options.order) ?? "asc";
     if (!sortField && options.order !== undefined) {
@@ -376,4 +401,4 @@ export async function runList(status, options, global) {
     };
 }
 //# sourceMappingURL=list.js.map
-//# debugId=5a5182ef-314f-551d-adbf-df52067ef6b3
+//# debugId=780dfabe-641b-59e4-8137-84eaa248543d