@unbrained/pm-cli 2026.6.13 → 2026.6.17

package/dist/cli-bundle/chunks/{chunk-NN6RKGFW.js → chunk-KCAGIH6K.js}

@@ -2,11 +2,11 @@
 !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]="5290e29c-a147-56df-94c4-59907951e37f")}catch(e){}}();
 import {
   resolveTypeName
-} from "./chunk-32XSW44C.js";
+} from "./chunk-V2GYOMEX.js";
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-S2CDTRJ6.js";
+} from "./chunk-SJCMTOEU.js";
 
 // dist/cli/shared-parsers.js
 function parseLimit(raw, label = "--limit") {
@@ -52,6 +52,6 @@ export {
   parsePriority,
   parseType
 };
-//# sourceMappingURL=chunk-NN6RKGFW.js.map
+//# sourceMappingURL=chunk-KCAGIH6K.js.map
 
 //# debugId=5290e29c-a147-56df-94c4-59907951e37f

package/dist/cli-bundle/chunks/{chunk-BVL5KGVA.js → chunk-KO3VM5GS.js}

@@ -1,17 +1,17 @@
 
-!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]="da2f3582-6928-5ecb-a08e-764043714391")}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]="b983245f-0499-5725-9073-d2ebb98d9533")}catch(e){}}();
 import {
   resolveAuthor
 } from "./chunk-J27KIHTG.js";
 import {
   readHistoryEntries
-} from "./chunk-XWDZVCBJ.js";
+} from "./chunk-SO2ES46D.js";
 import {
   EMPTY_REPLAY_DOCUMENT,
   normalizeReplayPatchOps,
   replayHash,
   toReplayDocument
-} from "./chunk-JE5IZXDS.js";
+} from "./chunk-CGQTFWYI.js";
 import {
   acquireLock,
   appendHistoryEntry,
@@ -19,21 +19,21 @@ import {
   enforceHistoryStreamPolicyForItem,
   locateItem,
   readLocatedItem
-} from "./chunk-L6YQONLM.js";
+} from "./chunk-FPDK5BZQ.js";
 import {
   normalizeItemId,
   normalizeRawItemId
-} from "./chunk-6ZFTM65G.js";
+} from "./chunk-F5MSD5HE.js";
 import {
   canonicalDocument,
   serializeItemDocument
-} from "./chunk-QQG4HEX7.js";
+} from "./chunk-IROHIK2T.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-32XSW44C.js";
+} from "./chunk-V2GYOMEX.js";
 import {
   nowIso
-} from "./chunk-IZHCCG4S.js";
+} from "./chunk-VXRFAE7W.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -49,7 +49,7 @@ import {
   resolvePmRoot,
   runActiveOnWriteHooks,
   writeFileAtomic
-} from "./chunk-S2CDTRJ6.js";
+} from "./chunk-SJCMTOEU.js";
 
 // dist/cli/commands/restore.js
 import jsonPatch from "fast-json-patch";
@@ -144,9 +144,13 @@ function applyHistoryPatch(current, patch, entryNumber, entryOp) {
     const failureContext = extractPatchFailureContext(patch, error);
     const contextTokens = [
       `history_op=${entryOp}`,
+      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */
       failureContext.patchIndex !== void 0 ? `patch_index=${failureContext.patchIndex}` : null,
+      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */
       failureContext.op ? `op=${failureContext.op}` : null,
+      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */
       failureContext.path ? `path=${failureContext.path}` : null,
+      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */
       failureContext.from ? `from=${failureContext.from}` : null
     ].filter((token) => token !== null);
     const reasonSuffix = failureContext.reason ? ` ${failureContext.reason}` : "";
@@ -371,10 +375,21 @@ async function runRestore(id, target, options, global) {
     await releaseLock();
   }
 }
+var _testOnlyRestoreCommand = {
+  applyHistoryPatch,
+  changedFields,
+  ensureMaterializedRestoreTarget,
+  ensureReplayTarget,
+  extractPatchFailureContext,
+  replayCurrentDocument,
+  replayToTarget,
+  resolveRestoreSubject
+};
 
 export {
-  runRestore
+  runRestore,
+  _testOnlyRestoreCommand
 };
-//# sourceMappingURL=chunk-BVL5KGVA.js.map
+//# sourceMappingURL=chunk-KO3VM5GS.js.map
 
-//# debugId=da2f3582-6928-5ecb-a08e-764043714391
+//# debugId=b983245f-0499-5725-9073-d2ebb98d9533

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/restore.ts"],"sourcesContent":["import jsonPatch from \"fast-json-patch\";\nimport fs from \"node:fs/promises\";\nimport { pathExists, readFileIfExists, writeFileAtomic } from \"../../core/fs/fs-utils.js\";\nimport { appendHistoryEntry, createHistoryEntry } from \"../../core/history/history.js\";\nimport {\n  EMPTY_REPLAY_DOCUMENT,\n  normalizeReplayPatchOps,\n  replayHash,\n  toReplayDocument,\n  type ReplayDocument as CanonicalReplayDocument,\n} from \"../../core/history/replay.js\";\nimport { enforceHistoryStreamPolicyForItem } from \"../../core/history/history-stream-policy.js\";\nimport { normalizeItemId, normalizeRawItemId } from \"../../core/item/id.js\";\nimport { canonicalDocument, serializeItemDocument } from \"../../core/item/item-format.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { acquireLock } from \"../../core/lock/lock.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 { nowIso } from \"../../core/shared/time.js\";\nimport {\n  getActiveExtensionRegistrations,\n  projectAfterCommandItemSnapshot,\n  recordAfterCommandAffectedItem,\n  runActiveOnWriteHooks,\n} from \"../../core/extensions/index.js\";\nimport { locateItem, readLocatedItem } from \"../../core/store/item-store.js\";\nimport { getHistoryPath, getItemPath, getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport { resolveAuthor } from \"../../core/shared/author.js\";\nimport type { HistoryEntry, HistoryPatchOp, ItemDocument, ItemMetadata } from \"../../types/index.js\";\nimport { readHistoryEntries } from \"./history.js\";\n\ninterface ResolvedRestoreTarget {\n  kind: \"version\" | \"timestamp\";\n  raw: string;\n  historyIndex: number;\n}\n\ninterface ResolvedRestoreSubject {\n  id: string;\n  historyPath: string;\n  located: Awaited<ReturnType<typeof locateItem>>;\n  historyPolicyWarnings: string[];\n}\n\nexport interface RestoreCommandOptions {\n  author?: string;\n  message?: string;\n  force?: boolean;\n}\n\nexport interface RestoreResult {\n  item: ItemMetadata;\n  restored_from: {\n    kind: \"version\" | \"timestamp\";\n    target: string;\n    history_index: number;\n    entry_ts: string;\n    entry_op: string;\n  };\n  changed_fields: string[];\n  warnings: string[];\n}\n\nfunction ensureReplayTarget(target: string, history: HistoryEntry[]): ResolvedRestoreTarget {\n  const trimmed = target.trim();\n  if (!trimmed) {\n    throw new PmCliError(\"Missing restore target. Use a timestamp or version number.\", EXIT_CODE.USAGE);\n  }\n\n  if (/^\\d+$/.test(trimmed)) {\n    const version = Number(trimmed);\n    if (!Number.isSafeInteger(version) || version < 1 || version > history.length) {\n      throw new PmCliError(\n        `Restore version must be between 1 and ${history.length} for this item.`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return {\n      kind: \"version\",\n      raw: trimmed,\n      historyIndex: version - 1,\n    };\n  }\n\n  const parsedTarget = Date.parse(trimmed);\n  if (!Number.isFinite(parsedTarget)) {\n    throw new PmCliError(\n      `Invalid restore target \"${target}\". Use a positive version number or ISO timestamp.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  let index = -1;\n  for (let i = 0; i < history.length; i += 1) {\n    const entryTimestamp = Date.parse(history[i].ts);\n    if (!Number.isFinite(entryTimestamp)) {\n      throw new PmCliError(\n        `History for this item contains invalid timestamp at entry ${i + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    if (entryTimestamp <= parsedTarget) {\n      index = i;\n    }\n  }\n\n  if (index < 0) {\n    throw new PmCliError(`No history entries exist at or before timestamp ${trimmed}.`, EXIT_CODE.USAGE);\n  }\n\n  return {\n    kind: \"timestamp\",\n    raw: trimmed,\n    historyIndex: index,\n  };\n}\n\nfunction extractPatchFailureContext(\n  patch: HistoryPatchOp[],\n  error: unknown,\n): { patchIndex?: number; op?: string; path?: string; from?: string; reason?: string } {\n  const context: { patchIndex?: number; op?: string; path?: string; from?: string; reason?: string } = {};\n  if (error instanceof Error && error.message.trim().length > 0) {\n    context.reason = error.message.trim();\n  }\n  if (typeof error !== \"object\" || error === null) {\n    return context;\n  }\n  const candidate = error as {\n    index?: unknown;\n    operation?: unknown;\n  };\n  /* c8 ignore start -- parser-generated patch errors may omit index metadata in current fixtures. */\n  if (typeof candidate.index === \"number\" && Number.isInteger(candidate.index) && candidate.index >= 0) {\n    context.patchIndex = candidate.index;\n  }\n  /* c8 ignore stop */\n  /* c8 ignore start -- operation payload metadata is optional in upstream json-patch failures. */\n  const operationRecord =\n    typeof candidate.operation === \"object\" && candidate.operation !== null\n      ? (candidate.operation as { op?: unknown; path?: unknown; from?: unknown })\n      : null;\n  /* c8 ignore stop */\n  if (operationRecord && typeof operationRecord.op === \"string\") {\n    context.op = operationRecord.op;\n  }\n  if (operationRecord && typeof operationRecord.path === \"string\") {\n    context.path = operationRecord.path;\n  }\n  if (operationRecord && typeof operationRecord.from === \"string\") {\n    context.from = operationRecord.from;\n  }\n  if ((context.op === undefined || context.path === undefined) && context.patchIndex !== undefined) {\n    const fallback = patch[context.patchIndex];\n    /* c8 ignore start -- fallback enrichment paths are only exercised by malformed patch telemetry payloads. */\n    if (fallback) {\n      context.op = context.op ?? fallback.op;\n      context.path = context.path ?? fallback.path;\n      context.from = context.from ?? fallback.from;\n    }\n    /* c8 ignore stop */\n  }\n  return context;\n}\n\nfunction applyHistoryPatch(\n  current: CanonicalReplayDocument,\n  patch: HistoryPatchOp[],\n  entryNumber: number,\n  entryOp: string,\n): CanonicalReplayDocument {\n  try {\n    const normalizedPatch = normalizeReplayPatchOps(patch);\n    const applied = jsonPatch.applyPatch(\n      structuredClone(current),\n      normalizedPatch as jsonPatch.Operation[],\n      true,\n      false,\n    ).newDocument as unknown;\n    if (\n      typeof applied !== \"object\" ||\n      applied === null ||\n      !(\"metadata\" in applied) ||\n      !(\"body\" in applied) ||\n      typeof (applied as { body: unknown }).body !== \"string\" ||\n      typeof (applied as { metadata: unknown }).metadata !== \"object\" ||\n      (applied as { metadata: unknown }).metadata === null\n    ) {\n      throw new PmCliError(\n        `History replay produced an invalid document shape at entry ${entryNumber}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    const replay = applied as { metadata: Record<string, unknown>; body: string };\n    return {\n      metadata: replay.metadata,\n      body: replay.body,\n    };\n  } catch (error: unknown) {\n    if (error instanceof PmCliError) {\n      throw error;\n    }\n    const failureContext = extractPatchFailureContext(patch, error);\n    const contextTokens = [\n      `history_op=${entryOp}`,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.patchIndex !== undefined ? `patch_index=${failureContext.patchIndex}` : null,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.op ? `op=${failureContext.op}` : null,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.path ? `path=${failureContext.path}` : null,\n      /* c8 ignore next -- contextual fields are best-effort and may be absent depending on patch failure shape. */\n      failureContext.from ? `from=${failureContext.from}` : null,\n    ].filter((token): token is string => token !== null);\n    /* c8 ignore start -- jsonPatch/structuredClone/normalizeReplayPatchOps always throw Error instances with non-empty messages here, so extractPatchFailureContext always sets reason; the empty-suffix fallback is unreachable through applyHistoryPatch. */\n    const reasonSuffix = failureContext.reason ? ` ${failureContext.reason}` : \"\";\n    /* c8 ignore stop */\n    throw new PmCliError(\n      `Failed to apply history patch at entry ${entryNumber} (${contextTokens.join(\", \")}).${reasonSuffix}`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n}\n\nfunction replayToTarget(history: HistoryEntry[], targetIndex: number): CanonicalReplayDocument {\n  let document: CanonicalReplayDocument = structuredClone(EMPTY_REPLAY_DOCUMENT);\n\n  for (let i = 0; i <= targetIndex; i += 1) {\n    const entry = history[i];\n    const beforeHash = replayHash(document);\n    if (beforeHash !== entry.before_hash) {\n      throw new PmCliError(\n        `History hash mismatch before replay at entry ${i + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n\n    document = applyHistoryPatch(document, entry.patch, i + 1, entry.op);\n\n    const afterHash = replayHash(document);\n    if (afterHash !== entry.after_hash) {\n      throw new PmCliError(\n        `History hash mismatch after replay at entry ${i + 1}.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n  }\n\n  return document;\n}\n\nfunction ensureMaterializedRestoreTarget(\n  replayDocument: CanonicalReplayDocument,\n  target: ResolvedRestoreTarget,\n): CanonicalReplayDocument {\n  if (Object.keys(replayDocument.metadata).length > 0) {\n    return replayDocument;\n  }\n  throw new PmCliError(\n    `Restore target ${target.raw} resolves to a deleted state; choose a version or timestamp where the item exists.`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nfunction replayCurrentDocument(history: HistoryEntry[]): ItemDocument {\n  const currentReplay = replayToTarget(history, history.length - 1);\n  if (Object.keys(currentReplay.metadata).length === 0) {\n    return {\n      metadata: {} as ItemMetadata,\n      body: currentReplay.body,\n    };\n  }\n  return canonicalDocument({\n    metadata: currentReplay.metadata as unknown as ItemMetadata,\n    body: currentReplay.body,\n  });\n}\n\nasync function resolveRestoreSubject(\n  pmRoot: string,\n  id: string,\n  settings: Awaited<ReturnType<typeof readSettings>>,\n  typeToFolder: Record<string, string>,\n): Promise<ResolvedRestoreSubject> {\n  const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeToFolder);\n  if (located) {\n    const historyPath = getHistoryPath(pmRoot, located.id);\n    const historyPolicy = await enforceHistoryStreamPolicyForItem({\n      pmRoot,\n      settings,\n      itemId: located.id,\n      commandLabel: \"restore\",\n    });\n    return {\n      id: located.id,\n      historyPath,\n      located,\n      historyPolicyWarnings: historyPolicy.warnings,\n    };\n  }\n\n  const normalizedId = normalizeItemId(id, settings.id_prefix);\n  const rawNormalizedId = normalizeRawItemId(id);\n  /* c8 ignore start -- raw-id fallback is covered by normalize-item-id utility tests. */\n  const candidateIds = normalizedId === rawNormalizedId ? [normalizedId] : [normalizedId, rawNormalizedId];\n  /* c8 ignore stop */\n  for (const candidateId of candidateIds) {\n    const historyPath = getHistoryPath(pmRoot, candidateId);\n    if (await pathExists(historyPath)) {\n      return {\n        id: candidateId,\n        historyPath,\n        located: null,\n        historyPolicyWarnings: [],\n      };\n    }\n  }\n\n  throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n}\n\nfunction changedFields(beforeDocument: ItemDocument, afterDocument: ItemDocument): string[] {\n  const beforeReplay = toReplayDocument(beforeDocument);\n  const afterReplay = toReplayDocument(afterDocument);\n  const patch = jsonPatch.compare(beforeReplay, afterReplay) as HistoryPatchOp[];\n  const fields = new Set<string>();\n\n  for (const op of patch) {\n    if (op.path === \"/body\" || op.path.startsWith(\"/body/\")) {\n      fields.add(\"body\");\n      continue;\n    }\n    const segment = op.path.replace(/^\\/(?:metadata|front_matter)\\/?/, \"\").split(\"/\")[0];\n    fields.add(segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\"));\n  }\n\n  return Array.from(fields).sort((a, b) => a.localeCompare(b));\n}\n\nexport async function runRestore(\n  id: string,\n  target: string,\n  options: RestoreCommandOptions,\n  global: GlobalOptions,\n): Promise<RestoreResult> {\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\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const subject = await resolveRestoreSubject(pmRoot, id, settings, typeRegistry.type_to_folder);\n  const resolvedId = subject.id;\n  const historyRawBeforeLock = await readFileIfExists(subject.historyPath);\n  const history = await readHistoryEntries(subject.historyPath, resolvedId);\n  if (history.length === 0) {\n    throw new PmCliError(`No history exists for ${resolvedId}; restore is unavailable.`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const resolvedTarget = ensureReplayTarget(target, history);\n  const replayDocument = ensureMaterializedRestoreTarget(replayToTarget(history, resolvedTarget.historyIndex), resolvedTarget);\n  const restoredDocument = canonicalDocument(\n    {\n      metadata: replayDocument.metadata as unknown as ItemMetadata,\n      body: replayDocument.body,\n    },\n    { schema: settings.schema },\n  );\n\n  if (restoredDocument.metadata.id !== resolvedId) {\n    throw new PmCliError(\n      `Restore target resolved to item ${restoredDocument.metadata.id}, expected ${resolvedId}.`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  const loadedItemBeforeLock = subject.located ? await readLocatedItem(subject.located, { schema: settings.schema }) : null;\n  const currentItemRawBeforeLock = loadedItemBeforeLock?.raw ?? null;\n\n  const author = resolveAuthor(options.author, settings.author_default);\n  const releaseLock = await acquireLock(\n    pmRoot,\n    resolvedId,\n    settings.locks.ttl_seconds,\n    author,\n    Boolean(options.force),\n    settings.governance.force_required_for_stale_lock,\n  );\n\n  try {\n    const historyRawUnderLock = await readFileIfExists(subject.historyPath);\n    if (historyRawUnderLock !== historyRawBeforeLock) {\n      throw new PmCliError(\n        `History for ${resolvedId} changed while waiting for lock; retry restore.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n    const locatedUnderLock = await locateItem(\n      pmRoot,\n      resolvedId,\n      settings.id_prefix,\n      settings.item_format,\n      typeRegistry.type_to_folder,\n    );\n    const loadedItemUnderLock = locatedUnderLock ? await readLocatedItem(locatedUnderLock, { schema: settings.schema }) : null;\n    if ((loadedItemUnderLock?.raw ?? null) !== currentItemRawBeforeLock) {\n      throw new PmCliError(`Item ${resolvedId} changed while waiting for lock; retry restore.`, EXIT_CODE.CONFLICT);\n    }\n\n    const existingItemPath = locatedUnderLock?.itemPath ?? null;\n    const itemFormat = \"toon\";\n    let resolvedCurrentDocument: ItemDocument;\n    let resolvedOriginalRaw: string | null = null;\n    if (loadedItemUnderLock) {\n      resolvedCurrentDocument = loadedItemUnderLock.document;\n      resolvedOriginalRaw = loadedItemUnderLock.raw;\n    } else {\n      resolvedCurrentDocument = replayCurrentDocument(history);\n    }\n    const assigned = resolvedCurrentDocument.metadata.assignee?.trim();\n    const ownershipWarnings: string[] = [];\n    const hasOwnershipConflict = assigned && assigned !== author && !options.force;\n    if (hasOwnershipConflict) {\n      if (settings.governance.ownership_enforcement === \"strict\") {\n        throw new PmCliError(\n          `Item ${resolvedId} is assigned to ${assigned}. Use --force to override.`,\n          EXIT_CODE.CONFLICT,\n        );\n      }\n      if (settings.governance.ownership_enforcement === \"warn\") {\n        ownershipWarnings.push(`ownership_warning:assignee_conflict:${resolvedId}:${assigned}`);\n      }\n    }\n\n    const serializedRestore = serializeItemDocument(restoredDocument, { format: itemFormat, schema: settings.schema });\n    /* c8 ignore next -- restored item path typing is exercised in restore integration workflows. */\n    const restoredItemPath = getItemPath(\n      pmRoot,\n      restoredDocument.metadata.type,\n      resolvedId,\n      itemFormat,\n      typeRegistry.type_to_folder,\n    );\n    await writeFileAtomic(restoredItemPath, serializedRestore);\n    if (existingItemPath && restoredItemPath !== existingItemPath) {\n      await fs.rm(existingItemPath);\n    }\n\n    const historyEntry = createHistoryEntry({\n      nowIso: nowIso(),\n      author,\n      op: \"restore\",\n      before: resolvedCurrentDocument,\n      after: restoredDocument,\n      message: options.message,\n    });\n\n    try {\n      await appendHistoryEntry(subject.historyPath, historyEntry);\n    } catch (error: unknown) {\n      if (existingItemPath && resolvedOriginalRaw !== null && restoredItemPath !== existingItemPath) {\n        await writeFileAtomic(existingItemPath, resolvedOriginalRaw);\n        await fs.rm(restoredItemPath, { force: true });\n      } else if (existingItemPath && resolvedOriginalRaw !== null) {\n        await writeFileAtomic(existingItemPath, resolvedOriginalRaw);\n      } else {\n        await fs.rm(restoredItemPath, { force: true });\n      }\n      throw error;\n    }\n    const restoreChangedFields = changedFields(resolvedCurrentDocument, restoredDocument);\n    const hookWarnings = [\n      ...(await runActiveOnWriteHooks({\n        path: restoredItemPath,\n        scope: \"project\",\n        op: \"restore\",\n        item_id: restoredDocument.metadata.id,\n        item_type: restoredDocument.metadata.type,\n        before: resolvedCurrentDocument,\n        after: restoredDocument,\n        changed_fields: [\"restored\"],\n      })),\n      ...(await runActiveOnWriteHooks({\n        path: subject.historyPath,\n        scope: \"project\",\n        op: \"restore:history\",\n        item_id: restoredDocument.metadata.id,\n        item_type: restoredDocument.metadata.type,\n        before: resolvedCurrentDocument,\n        after: restoredDocument,\n        changed_fields: [\"restored\"],\n      })),\n    ];\n    recordAfterCommandAffectedItem({\n      id: restoredDocument.metadata.id,\n      op: \"restore\",\n      item_type: restoredDocument.metadata.type,\n      previous_status: resolvedCurrentDocument.metadata.status,\n      status: restoredDocument.metadata.status,\n      previous: projectAfterCommandItemSnapshot(resolvedCurrentDocument.metadata, restoreChangedFields),\n      current: projectAfterCommandItemSnapshot(restoredDocument.metadata, restoreChangedFields),\n      changed_fields: restoreChangedFields,\n    });\n\n    const targetEntry = history[resolvedTarget.historyIndex];\n    return {\n      item: restoredDocument.metadata,\n      restored_from: {\n        kind: resolvedTarget.kind,\n        target: resolvedTarget.raw,\n        history_index: resolvedTarget.historyIndex + 1,\n        entry_ts: targetEntry.ts,\n        entry_op: targetEntry.op,\n      },\n      changed_fields: restoreChangedFields,\n      warnings: [...subject.historyPolicyWarnings, ...ownershipWarnings, ...hookWarnings],\n    };\n  } finally {\n    await releaseLock();\n  }\n}\n\nexport const _testOnlyRestoreCommand = {\n  applyHistoryPatch,\n  changedFields,\n  ensureMaterializedRestoreTarget,\n  ensureReplayTarget,\n  extractPatchFailureContext,\n  replayCurrentDocument,\n  replayToTarget,\n  resolveRestoreSubject,\n};\n"],"names":[],"mappings":"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","debugId":"b983245f-0499-5725-9073-d2ebb98d9533"}

package/dist/cli-bundle/chunks/{chunk-IXVSSHGV.js → chunk-LNH5Q32E.js}

@@ -1,13 +1,13 @@
 import {
   EXIT_CODE,
   PmCliError
-} from "./chunk-LFW5NQUP.js";
+} from "./chunk-CHM2VFVL.js";
 
 // dist/core/shared/time.js
 !(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] = "41114541-33aa-5c69-adea-0e0895c2a782");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "cf06ca54-b89b-5f9c-a8bd-4bad095a7dc7");
   } catch (e2) {
   }
 })();
@@ -47,13 +47,18 @@ function normalizeOffset(raw) {
     return `${compact[1]}:${compact[2]}`;
   return raw;
 }
+function pushTimestampCandidate(candidates, input, value) {
+  if (!value)
+    return;
+  if (value === input)
+    return;
+  if (candidates.includes(value))
+    return;
+  candidates.push(value);
+}
 function normalizeTimestampCandidates(input) {
   const candidates = [];
-  const push = (value) => {
-    if (!value || value === input || candidates.includes(value))
-      return;
-    candidates.push(value);
-  };
+  const push = (value) => pushTimestampCandidate(candidates, input, value);
   const compactDate = COMPACT_DATE.exec(input);
   if (compactDate) {
     const [, year, month, day] = compactDate;
@@ -204,4 +209,4 @@ export {
   compareTimestampStrings,
   resolveIsoOrRelative
 };
-//# sourceMappingURL=chunk-IXVSSHGV.js.map
+//# sourceMappingURL=chunk-LNH5Q32E.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../../core/shared/time.ts"],
+  "sourcesContent": ["import { PmCliError } from \"./errors.js\";\nimport { EXIT_CODE } from \"./constants.js\";\n\nconst RELATIVE_DEADLINE = /^([+-]?)(\\d+)([hdwm])$/i;\nconst COMPOUND_RELATIVE_DEADLINE = /^[+-]?\\d+[hdwm](?:[+-]\\d+[hdwm])+$/i;\nconst COMPACT_DATE = /^(\\d{4})(\\d{2})(\\d{2})$/;\nconst COMPACT_DATETIME = /^(\\d{4})(\\d{2})(\\d{2})(?:[T\\s]?)(\\d{2})(\\d{2})(\\d{2})?([.,]\\d{1,3})?(Z|[+-]\\d{2}:?\\d{2})?$/i;\nconst HYPHEN_TIME = /^(\\d{4}-\\d{2}-\\d{2})[T\\s](\\d{2})-(\\d{2})(?:-(\\d{2}))?([.,]\\d{1,3})?(Z|[+-]\\d{2}:?\\d{2})?$/i;\nconst COMPACT_TIME = /^(\\d{4}-\\d{2}-\\d{2})[T\\s](\\d{2})(\\d{2})(\\d{2})?([.,]\\d{1,3})?(Z|[+-]\\d{2}:?\\d{2})?$/i;\n\nexport function nowIso(): string {\n  return new Date().toISOString();\n}\n\nexport function isTimestampLiteral(input: string): boolean {\n  return Number.isFinite(Date.parse(input));\n}\n\nexport function compareTimestampStrings(left: string, right: string): number {\n  const leftMs = Date.parse(left);\n  const rightMs = Date.parse(right);\n  if (Number.isFinite(leftMs) && Number.isFinite(rightMs) && leftMs !== rightMs) {\n    return leftMs - rightMs;\n  }\n  return left.localeCompare(right);\n}\n\nfunction normalizeFraction(raw: string | undefined): string {\n  if (!raw) return \"\";\n  const digits = raw.slice(1);\n  return `.${digits.padEnd(3, \"0\").slice(0, 3)}`;\n}\n\nfunction normalizeOffset(raw: string | undefined): string {\n  if (!raw) return \"\";\n  if (raw.toUpperCase() === \"Z\") return \"Z\";\n  const compact = /^([+-]\\d{2})(\\d{2})$/.exec(raw);\n  if (compact) return `${compact[1]}:${compact[2]}`;\n  return raw;\n}\n\nfunction pushTimestampCandidate(candidates: string[], input: string, value: string | undefined): void {\n  if (!value) return;\n  if (value === input) return;\n  if (candidates.includes(value)) return;\n  candidates.push(value);\n}\n\nfunction normalizeTimestampCandidates(input: string): string[] {\n  const candidates: string[] = [];\n  const push = (value: string | undefined): void => pushTimestampCandidate(candidates, input, value);\n\n  const compactDate = COMPACT_DATE.exec(input);\n  if (compactDate) {\n    const [, year, month, day] = compactDate;\n    push(`${year}-${month}-${day}`);\n  }\n\n  const compactDateTime = COMPACT_DATETIME.exec(input);\n  if (compactDateTime) {\n    const [, year, month, day, hour, minute, secondRaw, fractionRaw, offsetRaw] = compactDateTime;\n    const second = secondRaw ? `:${secondRaw}` : \"\";\n    push(\n      `${year}-${month}-${day}T${hour}:${minute}${second}${normalizeFraction(fractionRaw)}${normalizeOffset(offsetRaw)}`,\n    );\n  }\n\n  const hyphenTime = HYPHEN_TIME.exec(input);\n  if (hyphenTime) {\n    const [, datePart, hour, minute, secondRaw, fractionRaw, offsetRaw] = hyphenTime;\n    const second = secondRaw ? `:${secondRaw}` : \"\";\n    push(`${datePart}T${hour}:${minute}${second}${normalizeFraction(fractionRaw)}${normalizeOffset(offsetRaw)}`);\n  }\n\n  const compactTime = COMPACT_TIME.exec(input);\n  if (compactTime) {\n    const [, datePart, hour, minute, secondRaw, fractionRaw, offsetRaw] = compactTime;\n    const second = secondRaw ? `:${secondRaw}` : \"\";\n    push(`${datePart}T${hour}:${minute}${second}${normalizeFraction(fractionRaw)}${normalizeOffset(offsetRaw)}`);\n  }\n\n  const datePrefixLength = 10;\n  const datePrefix = input.slice(0, datePrefixLength);\n  if (isHyphenDatePrefix(datePrefix)) {\n    let index = datePrefixLength;\n    while (index < input.length && isWhitespaceCharacter(input[index])) {\n      index += 1;\n    }\n    if (index < input.length) {\n      push(`${datePrefix}T${input.slice(index)}`);\n    }\n  }\n\n  return candidates;\n}\n\nfunction parseTimestampWithFallbacks(input: string): number {\n  const direct = Date.parse(input);\n  if (Number.isFinite(direct)) return direct;\n  for (const candidate of normalizeTimestampCandidates(input)) {\n    const parsed = Date.parse(candidate);\n    if (Number.isFinite(parsed)) return parsed;\n  }\n  return Number.NaN;\n}\n\nfunction isHyphenDatePrefix(value: string): boolean {\n  if (value.length !== 10) {\n    return false;\n  }\n  for (let index = 0; index < value.length; index += 1) {\n    const character = value[index];\n    if (index === 4 || index === 7) {\n      if (character !== \"-\") {\n        return false;\n      }\n      continue;\n    }\n    const code = character.charCodeAt(0);\n    if (code < 48 || code > 57) {\n      return false;\n    }\n  }\n  return true;\n}\n\nfunction isWhitespaceCharacter(character: string | undefined): boolean {\n  if (!character) {\n    return false;\n  }\n  return (\n    character === \" \" ||\n    character === \"\\t\" ||\n    character === \"\\n\" ||\n    character === \"\\r\" ||\n    character === \"\\f\" ||\n    character === \"\\v\"\n  );\n}\n\nfunction daysInUtcMonth(year: number, monthIndex: number): number {\n  return new Date(Date.UTC(year, monthIndex + 1, 0)).getUTCDate();\n}\n\nconst MONTH_NAMES = [\n  \"January\",\n  \"February\",\n  \"March\",\n  \"April\",\n  \"May\",\n  \"June\",\n  \"July\",\n  \"August\",\n  \"September\",\n  \"October\",\n  \"November\",\n  \"December\",\n] as const;\n\n// Leading literal calendar date in either hyphenated (`2026-02-30`) or compact\n// (`20260230`) form, optionally followed by any time/zone component. We validate\n// the digits the caller actually typed — not the parsed instant — so timezone\n// offsets never produce a false \"impossible date\" rejection. The hyphenated form\n// is unambiguous, so anything may follow (`T`/space time, `Z`, `+/-` offset). The\n// compact form must be followed by end-of-string or a time digit (with an optional\n// `T`/space separator) so a no-separator compact datetime like `20260230135900Z`\n// is still guarded and a 7-digit non-date is not misread as a date.\nconst LEADING_HYPHEN_DATE = /^(\\d{4})-(\\d{2})-(\\d{2})/;\nconst LEADING_COMPACT_DATE = /^(\\d{4})(\\d{2})(\\d{2})(?:[T ]?\\d{2}|$)/;\n\n/**\n * Reject literal calendar dates whose day cannot exist (e.g. `2026-02-30`, which JS\n * `Date` silently rolls forward to March 2). Without this, agents that pass an\n * impossible deadline get a silently-wrong stored date instead of an actionable\n * error. Only triggers on a leading literal date; relative tokens, \"now\", and pure\n * times are untouched. Month 00 / >12 is also rejected with a clear message rather\n * than falling through to the generic \"invalid value\" path.\n */\nfunction assertRealCalendarDate(originalInput: string, trimmed: string, fieldLabel: string): void {\n  const match = LEADING_HYPHEN_DATE.exec(trimmed) ?? LEADING_COMPACT_DATE.exec(trimmed);\n  if (!match) {\n    return;\n  }\n  const year = Number.parseInt(match[1], 10);\n  const month = Number.parseInt(match[2], 10);\n  const day = Number.parseInt(match[3], 10);\n  const label = fieldLabel?.trim() || \"deadline\";\n  if (month < 1 || month > 12) {\n    throw new PmCliError(\n      `Invalid ${label} value \"${originalInput}\". Month \"${match[2]}\" is out of range — use a month between 01 and 12.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  const maxDay = daysInUtcMonth(year, month - 1);\n  if (day < 1 || day > maxDay) {\n    throw new PmCliError(\n      `Invalid ${label} value \"${originalInput}\". ${MONTH_NAMES[month - 1]} ${year} has ${maxDay} days, so day \"${match[3]}\" does not exist. Use a real YYYY-MM-DD calendar date.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n}\n\nfunction addUtcMonths(now: Date, amount: number): Date {\n  const result = new Date(now.getTime());\n  const startDay = result.getUTCDate();\n  const targetMonthIndex = result.getUTCMonth() + amount;\n  const targetYear = result.getUTCFullYear() + Math.floor(targetMonthIndex / 12);\n  const targetMonth = ((targetMonthIndex % 12) + 12) % 12;\n  const day = Math.min(startDay, daysInUtcMonth(targetYear, targetMonth));\n  result.setUTCFullYear(targetYear, targetMonth, day);\n  return result;\n}\n\nexport function resolveIsoOrRelative(\n  input: string,\n  now: Date = new Date(),\n  fieldLabel = \"deadline\",\n): string {\n  const trimmed = input.trim();\n  if (trimmed.toLowerCase() === \"now\") {\n    return now.toISOString();\n  }\n  const relative = RELATIVE_DEADLINE.exec(trimmed);\n  if (relative) {\n    const sign = relative[1] === \"-\" ? -1 : 1;\n    const amount = Number.parseInt(relative[2], 10) * sign;\n    const unit = relative[3].toLowerCase();\n    if (unit === \"m\") {\n      return addUtcMonths(now, amount).toISOString();\n    }\n    const msPerUnit = unit === \"h\" ? 60 * 60 * 1000 : unit === \"d\" ? 24 * 60 * 60 * 1000 : 7 * 24 * 60 * 60 * 1000;\n    return new Date(now.getTime() + amount * msPerUnit).toISOString();\n  }\n\n  assertRealCalendarDate(input, trimmed, fieldLabel);\n\n  const timestamp = parseTimestampWithFallbacks(trimmed);\n  if (!Number.isFinite(timestamp)) {\n    const normalizedLabel = fieldLabel.trim().length > 0 ? fieldLabel.trim() : \"deadline\";\n    const guidance = COMPOUND_RELATIVE_DEADLINE.test(trimmed)\n      ? \"Compound relative expressions like +3d+1h are not supported; use a single relative token (for example +3d) or an ISO/date string.\"\n      : 'Use ISO/date string input, \"now\", or relative +6h/-6h/+1d/-1d/+2w/-2w/+6m/-6m.';\n    throw new PmCliError(\n      `Invalid ${normalizedLabel} value \"${input}\". ${guidance}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  return new Date(timestamp).toISOString();\n}\n\nexport const _testOnly = {\n  normalizeOffset,\n  pushTimestampCandidate,\n  normalizeTimestampCandidates,\n  parseTimestampWithFallbacks,\n  isWhitespaceCharacter,\n};\n"],
+  "mappings": ";;;;;;;;;;;;;AAGA,IAAM,oBAAoB;AAC1B,IAAM,6BAA6B;AACnC,IAAM,eAAe;AACrB,IAAM,mBAAmB;AACzB,IAAM,cAAc;AACpB,IAAM,eAAe;AAEf,SAAU,SAAM;AACpB,UAAO,oBAAI,KAAI,GAAG,YAAW;AAC/B;AAEM,SAAU,mBAAmB,OAAa;AAC9C,SAAO,OAAO,SAAS,KAAK,MAAM,KAAK,CAAC;AAC1C;AAEM,SAAU,wBAAwB,MAAc,OAAa;AACjE,QAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,QAAM,UAAU,KAAK,MAAM,KAAK;AAChC,MAAI,OAAO,SAAS,MAAM,KAAK,OAAO,SAAS,OAAO,KAAK,WAAW,SAAS;AAC7E,WAAO,SAAS;EAClB;AACA,SAAO,KAAK,cAAc,KAAK;AACjC;AAEA,SAAS,kBAAkB,KAAuB;AAChD,MAAI,CAAC;AAAK,WAAO;AACjB,QAAM,SAAS,IAAI,MAAM,CAAC;AAC1B,SAAO,IAAI,OAAO,OAAO,GAAG,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC;AAC9C;AAEA,SAAS,gBAAgB,KAAuB;AAC9C,MAAI,CAAC;AAAK,WAAO;AACjB,MAAI,IAAI,YAAW,MAAO;AAAK,WAAO;AACtC,QAAM,UAAU,uBAAuB,KAAK,GAAG;AAC/C,MAAI;AAAS,WAAO,GAAG,QAAQ,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC;AAC/C,SAAO;AACT;AAEA,SAAS,uBAAuB,YAAsB,OAAe,OAAyB;AAC5F,MAAI,CAAC;AAAO;AACZ,MAAI,UAAU;AAAO;AACrB,MAAI,WAAW,SAAS,KAAK;AAAG;AAChC,aAAW,KAAK,KAAK;AACvB;AAEA,SAAS,6BAA6B,OAAa;AACjD,QAAM,aAAuB,CAAA;AAC7B,QAAM,OAAO,CAAC,UAAoC,uBAAuB,YAAY,OAAO,KAAK;AAEjG,QAAM,cAAc,aAAa,KAAK,KAAK;AAC3C,MAAI,aAAa;AACf,UAAM,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI;AAC7B,SAAK,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,EAAE;EAChC;AAEA,QAAM,kBAAkB,iBAAiB,KAAK,KAAK;AACnD,MAAI,iBAAiB;AACnB,UAAM,CAAC,EAAE,MAAM,OAAO,KAAK,MAAM,QAAQ,WAAW,aAAa,SAAS,IAAI;AAC9E,UAAM,SAAS,YAAY,IAAI,SAAS,KAAK;AAC7C,SACE,GAAG,IAAI,IAAI,KAAK,IAAI,GAAG,IAAI,IAAI,IAAI,MAAM,GAAG,MAAM,GAAG,kBAAkB,WAAW,CAAC,GAAG,gBAAgB,SAAS,CAAC,EAAE;EAEtH;AAEA,QAAM,aAAa,YAAY,KAAK,KAAK;AACzC,MAAI,YAAY;AACd,UAAM,CAAC,EAAE,UAAU,MAAM,QAAQ,WAAW,aAAa,SAAS,IAAI;AACtE,UAAM,SAAS,YAAY,IAAI,SAAS,KAAK;AAC7C,SAAK,GAAG,QAAQ,IAAI,IAAI,IAAI,MAAM,GAAG,MAAM,GAAG,kBAAkB,WAAW,CAAC,GAAG,gBAAgB,SAAS,CAAC,EAAE;EAC7G;AAEA,QAAM,cAAc,aAAa,KAAK,KAAK;AAC3C,MAAI,aAAa;AACf,UAAM,CAAC,EAAE,UAAU,MAAM,QAAQ,WAAW,aAAa,SAAS,IAAI;AACtE,UAAM,SAAS,YAAY,IAAI,SAAS,KAAK;AAC7C,SAAK,GAAG,QAAQ,IAAI,IAAI,IAAI,MAAM,GAAG,MAAM,GAAG,kBAAkB,WAAW,CAAC,GAAG,gBAAgB,SAAS,CAAC,EAAE;EAC7G;AAEA,QAAM,mBAAmB;AACzB,QAAM,aAAa,MAAM,MAAM,GAAG,gBAAgB;AAClD,MAAI,mBAAmB,UAAU,GAAG;AAClC,QAAI,QAAQ;AACZ,WAAO,QAAQ,MAAM,UAAU,sBAAsB,MAAM,KAAK,CAAC,GAAG;AAClE,eAAS;IACX;AACA,QAAI,QAAQ,MAAM,QAAQ;AACxB,WAAK,GAAG,UAAU,IAAI,MAAM,MAAM,KAAK,CAAC,EAAE;IAC5C;EACF;AAEA,SAAO;AACT;AAEA,SAAS,4BAA4B,OAAa;AAChD,QAAM,SAAS,KAAK,MAAM,KAAK;AAC/B,MAAI,OAAO,SAAS,MAAM;AAAG,WAAO;AACpC,aAAW,aAAa,6BAA6B,KAAK,GAAG;AAC3D,UAAM,SAAS,KAAK,MAAM,SAAS;AACnC,QAAI,OAAO,SAAS,MAAM;AAAG,aAAO;EACtC;AACA,SAAO,OAAO;AAChB;AAEA,SAAS,mBAAmB,OAAa;AACvC,MAAI,MAAM,WAAW,IAAI;AACvB,WAAO;EACT;AACA,WAAS,QAAQ,GAAG,QAAQ,MAAM,QAAQ,SAAS,GAAG;AACpD,UAAM,YAAY,MAAM,KAAK;AAC7B,QAAI,UAAU,KAAK,UAAU,GAAG;AAC9B,UAAI,cAAc,KAAK;AACrB,eAAO;MACT;AACA;IACF;AACA,UAAM,OAAO,UAAU,WAAW,CAAC;AACnC,QAAI,OAAO,MAAM,OAAO,IAAI;AAC1B,aAAO;IACT;EACF;AACA,SAAO;AACT;AAEA,SAAS,sBAAsB,WAA6B;AAC1D,MAAI,CAAC,WAAW;AACd,WAAO;EACT;AACA,SACE,cAAc,OACd,cAAc,OACd,cAAc,QACd,cAAc,QACd,cAAc,QACd,cAAc;AAElB;AAEA,SAAS,eAAe,MAAc,YAAkB;AACtD,SAAO,IAAI,KAAK,KAAK,IAAI,MAAM,aAAa,GAAG,CAAC,CAAC,EAAE,WAAU;AAC/D;AAEA,IAAM,cAAc;EAClB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;AAWF,IAAM,sBAAsB;AAC5B,IAAM,uBAAuB;AAU7B,SAAS,uBAAuB,eAAuB,SAAiB,YAAkB;AACxF,QAAM,QAAQ,oBAAoB,KAAK,OAAO,KAAK,qBAAqB,KAAK,OAAO;AACpF,MAAI,CAAC,OAAO;AACV;EACF;AACA,QAAM,OAAO,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE;AACzC,QAAM,QAAQ,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE;AAC1C,QAAM,MAAM,OAAO,SAAS,MAAM,CAAC,GAAG,EAAE;AACxC,QAAM,QAAQ,YAAY,KAAI,KAAM;AACpC,MAAI,QAAQ,KAAK,QAAQ,IAAI;AAC3B,UAAM,IAAI,WACR,WAAW,KAAK,WAAW,aAAa,aAAa,MAAM,CAAC,CAAC,2DAC7D,UAAU,KAAK;EAEnB;AACA,QAAM,SAAS,eAAe,MAAM,QAAQ,CAAC;AAC7C,MAAI,MAAM,KAAK,MAAM,QAAQ;AAC3B,UAAM,IAAI,WACR,WAAW,KAAK,WAAW,aAAa,MAAM,YAAY,QAAQ,CAAC,CAAC,IAAI,IAAI,QAAQ,MAAM,kBAAkB,MAAM,CAAC,CAAC,0DACpH,UAAU,KAAK;EAEnB;AACF;AAEA,SAAS,aAAa,KAAW,QAAc;AAC7C,QAAM,SAAS,IAAI,KAAK,IAAI,QAAO,CAAE;AACrC,QAAM,WAAW,OAAO,WAAU;AAClC,QAAM,mBAAmB,OAAO,YAAW,IAAK;AAChD,QAAM,aAAa,OAAO,eAAc,IAAK,KAAK,MAAM,mBAAmB,EAAE;AAC7E,QAAM,eAAgB,mBAAmB,KAAM,MAAM;AACrD,QAAM,MAAM,KAAK,IAAI,UAAU,eAAe,YAAY,WAAW,CAAC;AACtE,SAAO,eAAe,YAAY,aAAa,GAAG;AAClD,SAAO;AACT;AAEM,SAAU,qBACd,OACA,MAAY,oBAAI,KAAI,GACpB,aAAa,YAAU;AAEvB,QAAM,UAAU,MAAM,KAAI;AAC1B,MAAI,QAAQ,YAAW,MAAO,OAAO;AACnC,WAAO,IAAI,YAAW;EACxB;AACA,QAAM,WAAW,kBAAkB,KAAK,OAAO;AAC/C,MAAI,UAAU;AACZ,UAAM,OAAO,SAAS,CAAC,MAAM,MAAM,KAAK;AACxC,UAAM,SAAS,OAAO,SAAS,SAAS,CAAC,GAAG,EAAE,IAAI;AAClD,UAAM,OAAO,SAAS,CAAC,EAAE,YAAW;AACpC,QAAI,SAAS,KAAK;AAChB,aAAO,aAAa,KAAK,MAAM,EAAE,YAAW;IAC9C;AACA,UAAM,YAAY,SAAS,MAAM,KAAK,KAAK,MAAO,SAAS,MAAM,KAAK,KAAK,KAAK,MAAO,IAAI,KAAK,KAAK,KAAK;AAC1G,WAAO,IAAI,KAAK,IAAI,QAAO,IAAK,SAAS,SAAS,EAAE,YAAW;EACjE;AAEA,yBAAuB,OAAO,SAAS,UAAU;AAEjD,QAAM,YAAY,4BAA4B,OAAO;AACrD,MAAI,CAAC,OAAO,SAAS,SAAS,GAAG;AAC/B,UAAM,kBAAkB,WAAW,KAAI,EAAG,SAAS,IAAI,WAAW,KAAI,IAAK;AAC3E,UAAM,WAAW,2BAA2B,KAAK,OAAO,IACpD,sIACA;AACJ,UAAM,IAAI,WACR,WAAW,eAAe,WAAW,KAAK,MAAM,QAAQ,IACxD,UAAU,KAAK;EAEnB;AACA,SAAO,IAAI,KAAK,SAAS,EAAE,YAAW;AACxC;",
+  "names": []
+}

package/dist/cli-bundle/chunks/{chunk-3FMQMHAG.js → chunk-LORM3M2I.js}

@@ -1,6 +1,6 @@
 import {
   parseOptionalNumber
-} from "./chunk-HZOX5BYD.js";
+} from "./chunk-OGXEBTX3.js";
 import {
   splitCommaList
 } from "./chunk-3HUE7XOF.js";
@@ -8,7 +8,7 @@ import {
   EXIT_CODE,
   PmCliError,
   SCOPE_VALUES
-} from "./chunk-LFW5NQUP.js";
+} from "./chunk-CHM2VFVL.js";
 
 // dist/cli/commands/linked-test-entry.js
 !(function() {
@@ -75,7 +75,7 @@ function normalizeStructuredLinkedTestEntry(kv, optionName) {
 !(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] = "99dadcea-f21b-5246-8416-e20875abc6d5");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "227d62a5-2f44-56bb-b323-b2b0c62333d6");
   } catch (e2) {
   }
 })();
@@ -525,4 +525,4 @@ export {
   parseLinkedTestAssertionGteMap,
   parseLinkedTestJsonEntries
 };
-//# sourceMappingURL=chunk-3FMQMHAG.js.map
+//# sourceMappingURL=chunk-LORM3M2I.js.map

package/dist/cli-bundle/chunks/{chunk-3FMQMHAG.js.map → chunk-LORM3M2I.js.map}

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../../../../cli/commands/linked-test-entry.ts", "../../../../../../../../cli/commands/linked-test-parsers.ts"],
-  "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", "import { parseOptionalNumber } from \"../../core/item/parse.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { splitCommaList } from \"../../core/shared/split-comma-list.js\";\nimport { STRUCTURED_LINKED_TEST_KEYS } from \"./linked-test-entry.js\";\nimport { SCOPE_VALUES } from \"../../types/index.js\";\nimport type { LinkedTest, LinkScope } 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 = splitCommaList(raw, { separators: /[;,\\n]/ });\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 = splitCommaList(raw, { separators: /[;\\n]/ });\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\n/**\n * Strict JSON linked-test entry parsing for `pm test --add-json` (pm-vcr2).\n *\n * Accepts a JSON object or array of objects whose keys match the structured\n * linked-test fields. Unlike `--add` CSV parsing, command strings are stored\n * verbatim: commas, nested quotes, `--` separators, and shell variables like\n * `$tmp` survive byte-identically.\n */\n\nconst LINKED_TEST_JSON_KEY_SET = new Set<string>(STRUCTURED_LINKED_TEST_KEYS);\n\ntype JsonRecord = Record<string, unknown>;\n\nfunction isPlainObject(value: unknown): value is JsonRecord {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction normalizeJsonEntryKeys(entry: JsonRecord, fail: (message: string) => PmCliError): JsonRecord {\n  const normalized: JsonRecord = {};\n  const unknownKeys: string[] = [];\n  for (const [key, value] of Object.entries(entry)) {\n    const normalizedKey = key.toLowerCase();\n    if (!LINKED_TEST_JSON_KEY_SET.has(normalizedKey)) {\n      unknownKeys.push(key);\n      continue;\n    }\n    if (Object.hasOwn(normalized, normalizedKey)) {\n      throw fail(`provides key \"${key}\" more than once after case normalization`);\n    }\n    normalized[normalizedKey] = value;\n  }\n  if (unknownKeys.length > 0) {\n    throw fail(\n      `does not recognize key${unknownKeys.length > 1 ? \"s\" : \"\"} ${unknownKeys.map((key) => `\"${key}\"`).join(\", \")}. Allowed keys: ${STRUCTURED_LINKED_TEST_KEYS.join(\", \")}.`,\n    );\n  }\n  return normalized;\n}\n\nfunction readJsonEntryString(entry: JsonRecord, key: string, fail: (message: string) => PmCliError): string | undefined {\n  if (!Object.hasOwn(entry, key)) {\n    return undefined;\n  }\n  const value = entry[key];\n  if (value === undefined) {\n    return undefined;\n  }\n  if (typeof value !== \"string\") {\n    throw fail(`field \"${key}\" must be a JSON string`);\n  }\n  return value;\n}\n\nfunction readJsonEntryStringList(entry: JsonRecord, key: string, fail: (message: string) => PmCliError): string[] | undefined {\n  if (!Object.hasOwn(entry, key)) {\n    return undefined;\n  }\n  const value = entry[key];\n  if (value === undefined) {\n    return undefined;\n  }\n  const list = typeof value === \"string\" ? [value] : value;\n  if (!Array.isArray(list) || list.some((item) => typeof item !== \"string\")) {\n    throw fail(`field \"${key}\" must be a string or an array of strings`);\n  }\n  const values = (list as string[]).filter((item) => item.length > 0);\n  return values.length > 0 ? values : undefined;\n}\n\nfunction readJsonEntryRegexList(entry: JsonRecord, key: string, fail: (message: string) => PmCliError): string[] | undefined {\n  const values = readJsonEntryStringList(entry, key, fail);\n  if (!values) {\n    return undefined;\n  }\n  for (const pattern of values) {\n    try {\n      new RegExp(pattern, \"m\");\n    } catch (error: unknown) {\n      throw fail(\n        /* c8 ignore next -- RegExp only throws SyntaxError (an Error); String(error) fallback is defensive. */\n        `field \"${key}\" includes invalid regex \"${pattern}\": ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  }\n  return values;\n}\n\nfunction readJsonEntryNumber(value: unknown, key: string, fail: (message: string) => PmCliError): number {\n  const parsed =\n    typeof value === \"number\"\n      ? value\n      : typeof value === \"string\" && value.trim().length > 0\n        ? Number(value.trim())\n        : Number.NaN;\n  if (typeof value === \"boolean\" || !Number.isFinite(parsed)) {\n    throw fail(`field \"${key}\" must be a finite number (or numeric string)`);\n  }\n  return parsed;\n}\n\nfunction readJsonEntryTimeoutSeconds(entry: JsonRecord, fail: (message: string) => PmCliError): number | undefined {\n  const timeoutSecondsRaw = entry.timeout_seconds;\n  const timeoutAliasRaw = entry.timeout;\n  if (timeoutSecondsRaw === undefined && timeoutAliasRaw === undefined) {\n    return undefined;\n  }\n  const timeoutSeconds = timeoutSecondsRaw === undefined ? undefined : readJsonEntryNumber(timeoutSecondsRaw, \"timeout_seconds\", fail);\n  const timeoutAlias = timeoutAliasRaw === undefined ? undefined : readJsonEntryNumber(timeoutAliasRaw, \"timeout\", fail);\n  if (timeoutSeconds !== undefined && timeoutAlias !== undefined && timeoutSeconds !== timeoutAlias) {\n    throw fail(\"timeout and timeout_seconds must match when both are provided\");\n  }\n  const timeout = timeoutSeconds ?? (timeoutAlias as number);\n  if (!Number.isInteger(timeout) || timeout <= 0) {\n    throw fail(\"timeout_seconds must be a positive integer\");\n  }\n  return timeout;\n}\n\nfunction readJsonEntryScope(entry: JsonRecord, fail: (message: string) => PmCliError): LinkScope {\n  const value = readJsonEntryString(entry, \"scope\", fail);\n  if (value === undefined) {\n    return \"project\";\n  }\n  if (!(SCOPE_VALUES as readonly string[]).includes(value)) {\n    throw fail(`field \"scope\" must be one of: ${SCOPE_VALUES.join(\", \")}`);\n  }\n  return value as LinkScope;\n}\n\nfunction readJsonEntryEnvSet(entry: JsonRecord, fail: (message: string) => PmCliError): Record<string, string> | undefined {\n  if (!Object.hasOwn(entry, \"env_set\")) {\n    return undefined;\n  }\n  const value = entry.env_set;\n  if (value === undefined) {\n    return undefined;\n  }\n  if (!isPlainObject(value)) {\n    throw fail('field \"env_set\" must be a JSON object mapping environment names to string values');\n  }\n  const envSet: Record<string, string> = {};\n  for (const [key, entryValue] of Object.entries(value)) {\n    if (typeof entryValue !== \"string\") {\n      throw fail(`field \"env_set\" value for \"${key}\" must be a string`);\n    }\n    if (!LINKED_TEST_ENV_NAME_PATTERN.test(key)) {\n      throw fail(`field \"env_set\" key \"${key}\" is invalid`);\n    }\n    if (LINKED_TEST_PROTECTED_ENV_KEYS.has(key.toUpperCase())) {\n      throw fail(`field \"env_set\" key \"${key}\" is reserved for sandbox safety`);\n    }\n    envSet[key] = entryValue;\n  }\n  return Object.keys(envSet).length > 0 ? envSet : undefined;\n}\n\nfunction readJsonEntryEnvClear(entry: JsonRecord, fail: (message: string) => PmCliError): string[] | undefined {\n  const keys = readJsonEntryStringList(entry, \"env_clear\", fail);\n  if (!keys) {\n    return undefined;\n  }\n  for (const key of keys) {\n    if (!LINKED_TEST_ENV_NAME_PATTERN.test(key)) {\n      throw fail(`field \"env_clear\" key \"${key}\" is invalid`);\n    }\n    if (LINKED_TEST_PROTECTED_ENV_KEYS.has(key.toUpperCase())) {\n      throw fail(`field \"env_clear\" key \"${key}\" is reserved for sandbox safety`);\n    }\n  }\n  return keys;\n}\n\nfunction readJsonEntryBoolean(entry: JsonRecord, key: string, fail: (message: string) => PmCliError): boolean | undefined {\n  if (!Object.hasOwn(entry, key)) {\n    return undefined;\n  }\n  const value = entry[key];\n  if (value === undefined) {\n    return undefined;\n  }\n  if (typeof value !== \"boolean\") {\n    throw fail(`field \"${key}\" must be a JSON boolean (true or false)`);\n  }\n  return value;\n}\n\nfunction readJsonEntryMinLines(entry: JsonRecord, fail: (message: string) => PmCliError): number | undefined {\n  if (!Object.hasOwn(entry, \"assert_stdout_min_lines\")) {\n    return undefined;\n  }\n  const value = entry.assert_stdout_min_lines;\n  if (value === undefined) {\n    return undefined;\n  }\n  const parsed = readJsonEntryNumber(value, \"assert_stdout_min_lines\", fail);\n  if (!Number.isInteger(parsed) || parsed < 0) {\n    throw fail('field \"assert_stdout_min_lines\" must be an integer >= 0');\n  }\n  return parsed;\n}\n\nfunction readJsonEntryEqualsMap(entry: JsonRecord, fail: (message: string) => PmCliError): Record<string, string> | undefined {\n  if (!Object.hasOwn(entry, \"assert_json_field_equals\")) {\n    return undefined;\n  }\n  const value = entry.assert_json_field_equals;\n  if (value === undefined) {\n    return undefined;\n  }\n  if (!isPlainObject(value)) {\n    throw fail('field \"assert_json_field_equals\" must be a JSON object mapping field paths to expected values');\n  }\n  const values: Record<string, string> = {};\n  for (const [key, entryValue] of Object.entries(value)) {\n    if (key.trim().length === 0) {\n      throw fail('field \"assert_json_field_equals\" keys must be non-empty field paths');\n    }\n    if (typeof entryValue !== \"string\" && typeof entryValue !== \"number\" && typeof entryValue !== \"boolean\") {\n      throw fail(`field \"assert_json_field_equals\" value for \"${key}\" must be a string, number, or boolean`);\n    }\n    values[key] = String(entryValue);\n  }\n  return Object.keys(values).length > 0 ? values : undefined;\n}\n\nfunction readJsonEntryGteMap(entry: JsonRecord, fail: (message: string) => PmCliError): Record<string, number> | undefined {\n  if (!Object.hasOwn(entry, \"assert_json_field_gte\")) {\n    return undefined;\n  }\n  const value = entry.assert_json_field_gte;\n  if (value === undefined) {\n    return undefined;\n  }\n  if (!isPlainObject(value)) {\n    throw fail('field \"assert_json_field_gte\" must be a JSON object mapping field paths to numeric minimums');\n  }\n  const values: Record<string, number> = {};\n  for (const [key, entryValue] of Object.entries(value)) {\n    if (key.trim().length === 0) {\n      throw fail('field \"assert_json_field_gte\" keys must be non-empty field paths');\n    }\n    values[key] = readJsonEntryNumber(entryValue, `assert_json_field_gte.${key}`, fail);\n  }\n  return Object.keys(values).length > 0 ? values : undefined;\n}\n\nfunction parseLinkedTestJsonEntry(rawEntry: unknown, label: string, optionName: string): LinkedTest {\n  const fail = (message: string): PmCliError => new PmCliError(`${optionName} ${label} ${message}`, EXIT_CODE.USAGE);\n  if (!isPlainObject(rawEntry)) {\n    throw fail(`must be a JSON object with linked-test fields. Allowed keys: ${STRUCTURED_LINKED_TEST_KEYS.join(\", \")}.`);\n  }\n  const entry = normalizeJsonEntryKeys(rawEntry, fail);\n  const commandValue = readJsonEntryString(entry, \"command\", fail);\n  const cmdAlias = readJsonEntryString(entry, \"cmd\", fail);\n  if (commandValue !== undefined && cmdAlias !== undefined && commandValue !== cmdAlias) {\n    throw fail(\"command and cmd must match when both are provided\");\n  }\n  const command = commandValue ?? cmdAlias;\n  if (command === undefined || command.trim().length === 0) {\n    throw fail('requires a non-empty \"command\" string');\n  }\n  const pathValue = readJsonEntryString(entry, \"path\", fail);\n  const pmContextModeValue = readJsonEntryString(entry, \"pm_context_mode\", fail);\n  if (pmContextModeValue !== undefined && !(LINKED_TEST_PM_CONTEXT_MODE_VALUES as readonly string[]).includes(pmContextModeValue)) {\n    throw fail(`field \"pm_context_mode\" must be one of: ${LINKED_TEST_PM_CONTEXT_MODE_VALUES.join(\", \")}`);\n  }\n  const noteValue = readJsonEntryString(entry, \"note\", fail);\n  return {\n    command,\n    path: pathValue !== undefined && pathValue.length > 0 ? pathValue : undefined,\n    scope: readJsonEntryScope(entry, fail),\n    timeout_seconds: readJsonEntryTimeoutSeconds(entry, fail),\n    pm_context_mode: pmContextModeValue as LinkedTest[\"pm_context_mode\"],\n    env_set: readJsonEntryEnvSet(entry, fail),\n    env_clear: readJsonEntryEnvClear(entry, fail),\n    shared_host_safe: readJsonEntryBoolean(entry, \"shared_host_safe\", fail),\n    assert_stdout_contains: readJsonEntryStringList(entry, \"assert_stdout_contains\", fail),\n    assert_stdout_regex: readJsonEntryRegexList(entry, \"assert_stdout_regex\", fail),\n    assert_stderr_contains: readJsonEntryStringList(entry, \"assert_stderr_contains\", fail),\n    assert_stderr_regex: readJsonEntryRegexList(entry, \"assert_stderr_regex\", fail),\n    assert_stdout_min_lines: readJsonEntryMinLines(entry, fail),\n    assert_json_field_equals: readJsonEntryEqualsMap(entry, fail),\n    assert_json_field_gte: readJsonEntryGteMap(entry, fail),\n    note: noteValue !== undefined && noteValue.trim().length > 0 ? noteValue.trim() : undefined,\n  };\n}\n\nexport function parseLinkedTestJsonEntries(raw: string, optionName: string): LinkedTest[] {\n  const trimmed = raw.trim();\n  if (trimmed.length === 0) {\n    throw new PmCliError(\n      `${optionName} requires a JSON object or array of objects describing linked-test entries`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(trimmed) as unknown;\n  } catch (error: unknown) {\n    throw new PmCliError(\n      /* c8 ignore next -- JSON.parse only throws SyntaxError (an Error); String(error) fallback is defensive. */\n      `${optionName} value is not valid JSON: ${error instanceof Error ? error.message : String(error)}. Provide a JSON object or array of objects, e.g. '{\"command\":\"node scripts/check.js --flag value, with commas\",\"timeout_seconds\":120}'.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  const entries = Array.isArray(parsed) ? parsed : [parsed];\n  if (entries.length === 0) {\n    throw new PmCliError(`${optionName} array must include at least one linked-test entry object`, EXIT_CODE.USAGE);\n  }\n  return entries.map((entry, index) =>\n    parseLinkedTestJsonEntry(entry, entries.length > 1 ? `entry ${index + 1}` : \"entry\", optionName),\n  );\n}\n"],
+  "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", "import { parseOptionalNumber } from \"../../core/item/parse.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { splitCommaList } from \"../../core/shared/split-comma-list.js\";\nimport { STRUCTURED_LINKED_TEST_KEYS } from \"./linked-test-entry.js\";\nimport { SCOPE_VALUES } from \"../../types/index.js\";\nimport type { LinkedTest, LinkScope } 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 = splitCommaList(raw, { separators: /[;,\\n]/ });\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 = splitCommaList(raw, { separators: /[;\\n]/ });\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\n/**\n * Strict JSON linked-test entry parsing for `pm test --add-json` (pm-vcr2).\n *\n * Accepts a JSON object or array of objects whose keys match the structured\n * linked-test fields. Unlike `--add` CSV parsing, command strings are stored\n * verbatim: commas, nested quotes, `--` separators, and shell variables like\n * `$tmp` survive byte-identically.\n */\n\nconst LINKED_TEST_JSON_KEY_SET = new Set<string>(STRUCTURED_LINKED_TEST_KEYS);\n\ntype JsonRecord = Record<string, unknown>;\n\nfunction isPlainObject(value: unknown): value is JsonRecord {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction normalizeJsonEntryKeys(entry: JsonRecord, fail: (message: string) => PmCliError): JsonRecord {\n  const normalized: JsonRecord = {};\n  const unknownKeys: string[] = [];\n  for (const [key, value] of Object.entries(entry)) {\n    const normalizedKey = key.toLowerCase();\n    if (!LINKED_TEST_JSON_KEY_SET.has(normalizedKey)) {\n      unknownKeys.push(key);\n      continue;\n    }\n    if (Object.hasOwn(normalized, normalizedKey)) {\n      throw fail(`provides key \"${key}\" more than once after case normalization`);\n    }\n    normalized[normalizedKey] = value;\n  }\n  if (unknownKeys.length > 0) {\n    throw fail(\n      `does not recognize key${unknownKeys.length > 1 ? \"s\" : \"\"} ${unknownKeys.map((key) => `\"${key}\"`).join(\", \")}. Allowed keys: ${STRUCTURED_LINKED_TEST_KEYS.join(\", \")}.`,\n    );\n  }\n  return normalized;\n}\n\nfunction readJsonEntryString(entry: JsonRecord, key: string, fail: (message: string) => PmCliError): string | undefined {\n  if (!Object.hasOwn(entry, key)) {\n    return undefined;\n  }\n  const value = entry[key];\n  if (value === undefined) {\n    return undefined;\n  }\n  if (typeof value !== \"string\") {\n    throw fail(`field \"${key}\" must be a JSON string`);\n  }\n  return value;\n}\n\nfunction readJsonEntryStringList(entry: JsonRecord, key: string, fail: (message: string) => PmCliError): string[] | undefined {\n  if (!Object.hasOwn(entry, key)) {\n    return undefined;\n  }\n  const value = entry[key];\n  if (value === undefined) {\n    return undefined;\n  }\n  const list = typeof value === \"string\" ? [value] : value;\n  if (!Array.isArray(list) || list.some((item) => typeof item !== \"string\")) {\n    throw fail(`field \"${key}\" must be a string or an array of strings`);\n  }\n  const values = (list as string[]).filter((item) => item.length > 0);\n  return values.length > 0 ? values : undefined;\n}\n\nfunction readJsonEntryRegexList(entry: JsonRecord, key: string, fail: (message: string) => PmCliError): string[] | undefined {\n  const values = readJsonEntryStringList(entry, key, fail);\n  if (!values) {\n    return undefined;\n  }\n  for (const pattern of values) {\n    try {\n      new RegExp(pattern, \"m\");\n    } catch (error: unknown) {\n      throw fail(\n        /* c8 ignore next -- RegExp only throws SyntaxError (an Error); String(error) fallback is defensive. */\n        `field \"${key}\" includes invalid regex \"${pattern}\": ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  }\n  return values;\n}\n\nfunction readJsonEntryNumber(value: unknown, key: string, fail: (message: string) => PmCliError): number {\n  const parsed =\n    typeof value === \"number\"\n      ? value\n      : typeof value === \"string\" && value.trim().length > 0\n        ? Number(value.trim())\n        : Number.NaN;\n  if (typeof value === \"boolean\" || !Number.isFinite(parsed)) {\n    throw fail(`field \"${key}\" must be a finite number (or numeric string)`);\n  }\n  return parsed;\n}\n\nfunction readJsonEntryTimeoutSeconds(entry: JsonRecord, fail: (message: string) => PmCliError): number | undefined {\n  const timeoutSecondsRaw = entry.timeout_seconds;\n  const timeoutAliasRaw = entry.timeout;\n  if (timeoutSecondsRaw === undefined && timeoutAliasRaw === undefined) {\n    return undefined;\n  }\n  const timeoutSeconds = timeoutSecondsRaw === undefined ? undefined : readJsonEntryNumber(timeoutSecondsRaw, \"timeout_seconds\", fail);\n  const timeoutAlias = timeoutAliasRaw === undefined ? undefined : readJsonEntryNumber(timeoutAliasRaw, \"timeout\", fail);\n  if (timeoutSeconds !== undefined && timeoutAlias !== undefined && timeoutSeconds !== timeoutAlias) {\n    throw fail(\"timeout and timeout_seconds must match when both are provided\");\n  }\n  const timeout = timeoutSeconds ?? (timeoutAlias as number);\n  if (!Number.isInteger(timeout) || timeout <= 0) {\n    throw fail(\"timeout_seconds must be a positive integer\");\n  }\n  return timeout;\n}\n\nfunction readJsonEntryScope(entry: JsonRecord, fail: (message: string) => PmCliError): LinkScope {\n  const value = readJsonEntryString(entry, \"scope\", fail);\n  if (value === undefined) {\n    return \"project\";\n  }\n  if (!(SCOPE_VALUES as readonly string[]).includes(value)) {\n    throw fail(`field \"scope\" must be one of: ${SCOPE_VALUES.join(\", \")}`);\n  }\n  return value as LinkScope;\n}\n\nfunction readJsonEntryEnvSet(entry: JsonRecord, fail: (message: string) => PmCliError): Record<string, string> | undefined {\n  if (!Object.hasOwn(entry, \"env_set\")) {\n    return undefined;\n  }\n  const value = entry.env_set;\n  if (value === undefined) {\n    return undefined;\n  }\n  if (!isPlainObject(value)) {\n    throw fail('field \"env_set\" must be a JSON object mapping environment names to string values');\n  }\n  const envSet: Record<string, string> = {};\n  for (const [key, entryValue] of Object.entries(value)) {\n    if (typeof entryValue !== \"string\") {\n      throw fail(`field \"env_set\" value for \"${key}\" must be a string`);\n    }\n    if (!LINKED_TEST_ENV_NAME_PATTERN.test(key)) {\n      throw fail(`field \"env_set\" key \"${key}\" is invalid`);\n    }\n    if (LINKED_TEST_PROTECTED_ENV_KEYS.has(key.toUpperCase())) {\n      throw fail(`field \"env_set\" key \"${key}\" is reserved for sandbox safety`);\n    }\n    envSet[key] = entryValue;\n  }\n  return Object.keys(envSet).length > 0 ? envSet : undefined;\n}\n\nfunction readJsonEntryEnvClear(entry: JsonRecord, fail: (message: string) => PmCliError): string[] | undefined {\n  const keys = readJsonEntryStringList(entry, \"env_clear\", fail);\n  if (!keys) {\n    return undefined;\n  }\n  for (const key of keys) {\n    if (!LINKED_TEST_ENV_NAME_PATTERN.test(key)) {\n      throw fail(`field \"env_clear\" key \"${key}\" is invalid`);\n    }\n    if (LINKED_TEST_PROTECTED_ENV_KEYS.has(key.toUpperCase())) {\n      throw fail(`field \"env_clear\" key \"${key}\" is reserved for sandbox safety`);\n    }\n  }\n  return keys;\n}\n\nfunction readJsonEntryBoolean(entry: JsonRecord, key: string, fail: (message: string) => PmCliError): boolean | undefined {\n  if (!Object.hasOwn(entry, key)) {\n    return undefined;\n  }\n  const value = entry[key];\n  if (value === undefined) {\n    return undefined;\n  }\n  if (typeof value !== \"boolean\") {\n    throw fail(`field \"${key}\" must be a JSON boolean (true or false)`);\n  }\n  return value;\n}\n\nfunction readJsonEntryMinLines(entry: JsonRecord, fail: (message: string) => PmCliError): number | undefined {\n  if (!Object.hasOwn(entry, \"assert_stdout_min_lines\")) {\n    return undefined;\n  }\n  const value = entry.assert_stdout_min_lines;\n  if (value === undefined) {\n    return undefined;\n  }\n  const parsed = readJsonEntryNumber(value, \"assert_stdout_min_lines\", fail);\n  if (!Number.isInteger(parsed) || parsed < 0) {\n    throw fail('field \"assert_stdout_min_lines\" must be an integer >= 0');\n  }\n  return parsed;\n}\n\nfunction readJsonEntryEqualsMap(entry: JsonRecord, fail: (message: string) => PmCliError): Record<string, string> | undefined {\n  if (!Object.hasOwn(entry, \"assert_json_field_equals\")) {\n    return undefined;\n  }\n  const value = entry.assert_json_field_equals;\n  if (value === undefined) {\n    return undefined;\n  }\n  if (!isPlainObject(value)) {\n    throw fail('field \"assert_json_field_equals\" must be a JSON object mapping field paths to expected values');\n  }\n  const values: Record<string, string> = {};\n  for (const [key, entryValue] of Object.entries(value)) {\n    if (key.trim().length === 0) {\n      throw fail('field \"assert_json_field_equals\" keys must be non-empty field paths');\n    }\n    if (typeof entryValue !== \"string\" && typeof entryValue !== \"number\" && typeof entryValue !== \"boolean\") {\n      throw fail(`field \"assert_json_field_equals\" value for \"${key}\" must be a string, number, or boolean`);\n    }\n    values[key] = String(entryValue);\n  }\n  return Object.keys(values).length > 0 ? values : undefined;\n}\n\nfunction readJsonEntryGteMap(entry: JsonRecord, fail: (message: string) => PmCliError): Record<string, number> | undefined {\n  if (!Object.hasOwn(entry, \"assert_json_field_gte\")) {\n    return undefined;\n  }\n  const value = entry.assert_json_field_gte;\n  if (value === undefined) {\n    return undefined;\n  }\n  if (!isPlainObject(value)) {\n    throw fail('field \"assert_json_field_gte\" must be a JSON object mapping field paths to numeric minimums');\n  }\n  const values: Record<string, number> = {};\n  for (const [key, entryValue] of Object.entries(value)) {\n    if (key.trim().length === 0) {\n      throw fail('field \"assert_json_field_gte\" keys must be non-empty field paths');\n    }\n    values[key] = readJsonEntryNumber(entryValue, `assert_json_field_gte.${key}`, fail);\n  }\n  return Object.keys(values).length > 0 ? values : undefined;\n}\n\nfunction parseLinkedTestJsonEntry(rawEntry: unknown, label: string, optionName: string): LinkedTest {\n  const fail = (message: string): PmCliError => new PmCliError(`${optionName} ${label} ${message}`, EXIT_CODE.USAGE);\n  if (!isPlainObject(rawEntry)) {\n    throw fail(`must be a JSON object with linked-test fields. Allowed keys: ${STRUCTURED_LINKED_TEST_KEYS.join(\", \")}.`);\n  }\n  const entry = normalizeJsonEntryKeys(rawEntry, fail);\n  const commandValue = readJsonEntryString(entry, \"command\", fail);\n  const cmdAlias = readJsonEntryString(entry, \"cmd\", fail);\n  if (commandValue !== undefined && cmdAlias !== undefined && commandValue !== cmdAlias) {\n    throw fail(\"command and cmd must match when both are provided\");\n  }\n  const command = commandValue ?? cmdAlias;\n  if (command === undefined || command.trim().length === 0) {\n    throw fail('requires a non-empty \"command\" string');\n  }\n  const pathValue = readJsonEntryString(entry, \"path\", fail);\n  const pmContextModeValue = readJsonEntryString(entry, \"pm_context_mode\", fail);\n  if (pmContextModeValue !== undefined && !(LINKED_TEST_PM_CONTEXT_MODE_VALUES as readonly string[]).includes(pmContextModeValue)) {\n    throw fail(`field \"pm_context_mode\" must be one of: ${LINKED_TEST_PM_CONTEXT_MODE_VALUES.join(\", \")}`);\n  }\n  const noteValue = readJsonEntryString(entry, \"note\", fail);\n  return {\n    command,\n    path: pathValue !== undefined && pathValue.length > 0 ? pathValue : undefined,\n    scope: readJsonEntryScope(entry, fail),\n    timeout_seconds: readJsonEntryTimeoutSeconds(entry, fail),\n    pm_context_mode: pmContextModeValue as LinkedTest[\"pm_context_mode\"],\n    env_set: readJsonEntryEnvSet(entry, fail),\n    env_clear: readJsonEntryEnvClear(entry, fail),\n    shared_host_safe: readJsonEntryBoolean(entry, \"shared_host_safe\", fail),\n    assert_stdout_contains: readJsonEntryStringList(entry, \"assert_stdout_contains\", fail),\n    assert_stdout_regex: readJsonEntryRegexList(entry, \"assert_stdout_regex\", fail),\n    assert_stderr_contains: readJsonEntryStringList(entry, \"assert_stderr_contains\", fail),\n    assert_stderr_regex: readJsonEntryRegexList(entry, \"assert_stderr_regex\", fail),\n    assert_stdout_min_lines: readJsonEntryMinLines(entry, fail),\n    assert_json_field_equals: readJsonEntryEqualsMap(entry, fail),\n    assert_json_field_gte: readJsonEntryGteMap(entry, fail),\n    note: noteValue !== undefined && noteValue.trim().length > 0 ? noteValue.trim() : undefined,\n  };\n}\n\nexport function parseLinkedTestJsonEntries(raw: string, optionName: string): LinkedTest[] {\n  const trimmed = raw.trim();\n  if (trimmed.length === 0) {\n    throw new PmCliError(\n      `${optionName} requires a JSON object or array of objects describing linked-test entries`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(trimmed) as unknown;\n  } catch (error: unknown) {\n    throw new PmCliError(\n      /* c8 ignore next -- JSON.parse only throws SyntaxError (an Error); String(error) fallback is defensive. */\n      `${optionName} value is not valid JSON: ${error instanceof Error ? error.message : String(error)}. Provide a JSON object or array of objects, e.g. '{\"command\":\"node scripts/check.js --flag value, with commas\",\"timeout_seconds\":120}'.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  const entries = Array.isArray(parsed) ? parsed : [parsed];\n  if (entries.length === 0) {\n    throw new PmCliError(`${optionName} array must include at least one linked-test entry object`, EXIT_CODE.USAGE);\n  }\n  return entries.map((entry, index) =>\n    parseLinkedTestJsonEntry(entry, entries.length > 1 ? `entry ${index + 1}` : \"entry\", optionName),\n  );\n}\n\nexport const _testOnlyLinkedTestParsers = {\n  parseLinkedTestJsonEntry,\n};\n"],
   "mappings": "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",
   "names": []
 }

package/dist/cli-bundle/chunks/{chunk-PNYAAB4S.js → chunk-LWGMDLQ6.js}

@@ -1,6 +1,6 @@
 // dist/core/diagnostics/remediation.js
 
-!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]="2348b67c-04ba-55f5-9eed-37c06b56f4cb")}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]="55a3cd28-1420-5309-a9e8-f430fa2ada66")}catch(e){}}();
 var REMEDIATION_REGISTRY = Object.freeze([
   // --- pm health: directories ---
   {
@@ -71,6 +71,11 @@ var REMEDIATION_REGISTRY = Object.freeze([
     command: "pm health --check-telemetry",
     summary: "Client schema is behind server; upgrade pm-cli to emit the latest event shape."
   },
+  {
+    code: "telemetry_otel_export_failing",
+    command: "pm health --check-telemetry",
+    summary: "OTLP trace spans are queued but the traces endpoint export is failing; spans retry automatically on the next reachable command, or set PM_TELEMETRY_OTEL_DISABLED=1 to skip OTLP export. Advisory only."
+  },
   // --- pm health: integrity ---
   {
     code: "integrity_item_unreadable",
@@ -304,6 +309,6 @@ export {
   buildRemediationMap,
   buildRemediationCommands
 };
-//# sourceMappingURL=chunk-PNYAAB4S.js.map
+//# sourceMappingURL=chunk-LWGMDLQ6.js.map
 
-//# debugId=2348b67c-04ba-55f5-9eed-37c06b56f4cb
+//# debugId=55a3cd28-1420-5309-a9e8-f430fa2ada66

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../core/diagnostics/remediation.ts"],"sourcesContent":["/**\n * Shared machine-executable remediation registry.\n *\n * `pm health` and `pm validate` both emit stable, colon-delimited warning tokens\n * (for example `history_drift_missing_stream:pm-abcd` or\n * `validate_resolution_missing_fields:3`). Agents that gate on these commands\n * previously had to hardcode the mapping from a warning code to the `pm` command\n * that fixes it. This module is the single source of truth for that mapping so\n * `pm health --json` (per-check `remediation_map`) and `pm validate --fix-hints`\n * (per-check `fix_hints`) can both surface executable remediation without any\n * duplicated, drift-prone lookup tables.\n *\n * Semantics of {@link RemediationEntry.command}: the suggested next `pm` command\n * an operator/agent should run to resolve findings with that code. Per-item\n * findings use an `<id>` placeholder (callers that have the concrete id may\n * substitute it); findings whose only fix is a manual file edit point at the\n * most useful diagnostic/repair command and describe the manual step in\n * {@link RemediationEntry.summary}.\n */\n\nexport interface RemediationEntry {\n  /**\n   * Stable warning-code prefix this entry resolves. A warning matches when it\n   * equals this code or begins with `<code>:`. Registry codes are mutually\n   * exclusive under that colon-boundary rule (no code is a `:`-delimited prefix\n   * of another — e.g. `settings:id_prefix_empty` is distinct from a bare\n   * `settings`, which is intentionally not registered), so `resolveRemediation`\n   * uses first-match with no ordering dependency.\n   */\n  readonly code: string;\n  /** Executable `pm` command (or imperative) that resolves the finding. May contain an `<id>` placeholder. */\n  readonly command: string;\n  /** One-line description of what the command does / which manual step it covers. */\n  readonly summary: string;\n}\n\n/**\n * Registry of every non-extension `pm health` / `pm validate` warning code and\n * its remediation. Extension findings keep their richer, contextual\n * `details.triage.remediation` produced by the extension health triage and are\n * intentionally excluded here (see pm-0hnu: \"all non-extension checks\").\n */\nexport const REMEDIATION_REGISTRY: readonly RemediationEntry[] = Object.freeze([\n  // --- pm health: directories ---\n  {\n    code: \"missing_directory\",\n    command: \"pm init\",\n    summary: \"Recreate missing tracker directories (pm init is idempotent and restores the scaffold).\",\n  },\n  // --- pm health: settings (read/parse) ---\n  {\n    code: \"settings_read_invalid_json\",\n    command: \"pm config list --json\",\n    summary:\n      \"settings.json is not valid JSON and pm fell back to defaults; fix the syntax error in the reported path, then re-run.\",\n  },\n  {\n    code: \"settings_read_invalid_schema\",\n    command: \"pm config list --json\",\n    summary:\n      \"settings.json failed schema validation and pm fell back to defaults; correct the reported key in the file, then re-run.\",\n  },\n  {\n    code: \"settings_read_merge_failed\",\n    command: \"pm config list --json\",\n    summary: \"Global/project settings could not be merged; reconcile the conflicting keys in the reported settings files.\",\n  },\n  // --- pm health: settings_values ---\n  {\n    code: \"settings:id_prefix_empty\",\n    command: \"pm config list --json\",\n    summary: 'id_prefix is empty; set a non-empty \"id_prefix\" in settings.json so generated item ids are well-formed.',\n  },\n  {\n    code: \"settings:locks_ttl_non_positive\",\n    command: \"pm config list --json\",\n    summary: 'locks.ttl_seconds must be positive; set a positive \"locks.ttl_seconds\" in settings.json.',\n  },\n  // --- pm health: telemetry (advisory) ---\n  {\n    code: \"telemetry_state_invalid_json\",\n    command: \"pm health --check-telemetry\",\n    summary: \"Local telemetry state file is corrupt; pm recreates it on the next flush. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_invalid_rows\",\n    command: \"pm health --check-telemetry\",\n    summary: \"The telemetry queue has unparseable rows; they are skipped on the next flush. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_pending\",\n    command: \"pm health --check-telemetry\",\n    summary: \"Telemetry events are queued; they flush automatically on the next reachable command. Advisory only.\",\n  },\n  {\n    code: \"telemetry_queue_high_retries\",\n    command: \"pm telemetry flush\",\n    summary:\n      \"Some queued telemetry events are near retry exhaustion; flush now and verify endpoint reachability before entries are dropped.\",\n  },\n  {\n    code: \"telemetry_endpoint_probe_failed\",\n    command: \"pm health --check-telemetry\",\n    summary: \"The telemetry endpoint is unreachable; events stay queued until it recovers. Advisory only.\",\n  },\n  {\n    code: \"telemetry_endpoint_probe_http_status\",\n    command: \"pm health --check-telemetry\",\n    summary: \"The telemetry endpoint returned a non-success status; events stay queued until it recovers. Advisory only.\",\n  },\n  {\n    code: \"telemetry_schema_version_behind\",\n    command: \"pm health --check-telemetry\",\n    summary: \"Client schema is behind server; upgrade pm-cli to emit the latest event shape.\",\n  },\n  {\n    code: \"telemetry_otel_export_failing\",\n    command: \"pm health --check-telemetry\",\n    summary:\n      \"OTLP trace spans are queued but the traces endpoint export is failing; spans retry automatically on the next reachable command, or set PM_TELEMETRY_OTEL_DISABLED=1 to skip OTLP export. Advisory only.\",\n  },\n  // --- pm health: integrity ---\n  {\n    code: \"integrity_item_unreadable\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary: \"An item file could not be read; restore or repair the file at the reported path.\",\n  },\n  {\n    code: \"integrity_item_parse_failed\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary: \"An item file failed to parse; fix the malformed front matter at the reported path.\",\n  },\n  {\n    code: \"integrity_item_conflict_marker\",\n    command: \"pm validate --check-files --verbose-diagnostics\",\n    summary: \"An item file contains Git conflict markers; resolve the <<<<<<< / >>>>>>> markers at the reported line.\",\n  },\n  {\n    code: \"integrity_history_unreadable\",\n    command: \"pm history-repair <id>\",\n    summary: \"A history stream could not be read; re-anchor the affected item's history chain.\",\n  },\n  {\n    code: \"integrity_history_invalid_json\",\n    command: \"pm history-repair <id>\",\n    summary: \"A history stream contains invalid JSON; re-anchor the affected item's history chain.\",\n  },\n  {\n    code: \"integrity_history_conflict_marker\",\n    command: \"pm history-repair <id>\",\n    summary: \"A history stream contains Git conflict markers; resolve the markers, then re-anchor the chain.\",\n  },\n  // --- pm health: history_drift ---\n  // `pm health` rewrites these commands to `pm history-repair --all` in the\n  // per-check remediation_map when more than one stream is drifted.\n  {\n    code: \"history_drift_missing_stream\",\n    command: \"pm history-repair <id>\",\n    summary: \"The item has no history stream; re-anchor the chain to rebuild it (pm history-repair --all repairs every drifted stream in one pass).\",\n  },\n  {\n    code: \"history_drift_unreadable_stream\",\n    command: \"pm history-repair <id>\",\n    summary: \"The item's history stream is unreadable; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass).\",\n  },\n  {\n    code: \"history_drift_hash_mismatch\",\n    command: \"pm history-repair <id>\",\n    summary: \"The item's content hash no longer matches its history; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass).\",\n  },\n  {\n    code: \"history_drift_chain_mismatch\",\n    command: \"pm history-repair <id>\",\n    summary: \"The item's history chain is broken; re-anchor the chain (pm history-repair --all repairs every drifted stream in one pass).\",\n  },\n  // --- pm health: locks ---\n  {\n    code: \"locks_stale_count\",\n    command: \"pm gc --scope locks\",\n    summary:\n      \"Stale item-claim locks (embedded ttl elapsed) can block mutations; sweep them — gc retains active and unparseable locks.\",\n  },\n  {\n    code: \"locks_unreadable\",\n    command: \"pm gc --scope locks --dry-run\",\n    summary:\n      \"Some lock files could not be read; preview the sweep and inspect the unreadable files manually — gc never deletes what it cannot read.\",\n  },\n  // --- pm health: vectorization ---\n  {\n    code: \"vectorization_stale_items_remaining\",\n    command: \"pm health --refresh-vectors\",\n    summary: \"Some items have stale embeddings; refresh vectors so semantic search results stay current.\",\n  },\n  {\n    code: \"vectorization_embedding_identity_changed\",\n    command: \"pm reindex --mode semantic\",\n    summary: \"Embedding provider/model changed since the last index; run a semantic reindex to rebuild vectors.\",\n  },\n  // --- pm validate: metadata ---\n  // Note: validate_metadata_missing_author has no entry on purpose. `pm update\n  // --author` sets the mutation/audit author (history), not the item's\n  // `metadata.author` front-matter field, and there is no CLI flag that writes\n  // that field — so emitting a command here would record an audit entry without\n  // clearing the finding. A missing item author must be restored at the source.\n  {\n    code: \"validate_metadata_missing_acceptance_criteria\",\n    command: 'pm update <id> --acceptance-criteria \"<criteria>\"',\n    summary: \"Backfill the missing acceptance criteria on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_estimate\",\n    command: 'pm update <id> --estimate \"<estimate>\"',\n    summary: \"Backfill the missing estimate on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_close_reason\",\n    command: 'pm update <id> --close-reason \"<reason>\"',\n    summary: \"Backfill the missing close reason on the reported closed item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_reviewer\",\n    command: 'pm update <id> --reviewer \"<name>\"',\n    summary: \"Backfill the missing reviewer on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_risk\",\n    command: 'pm update <id> --risk \"<level>\"',\n    summary: \"Backfill the missing risk on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_confidence\",\n    command: 'pm update <id> --confidence \"<level>\"',\n    summary: \"Backfill the missing confidence on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_sprint\",\n    command: 'pm update <id> --sprint \"<sprint>\"',\n    summary: \"Backfill the missing sprint on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_missing_release\",\n    command: 'pm update <id> --release \"<release>\"',\n    summary: \"Backfill the missing release on the reported item(s).\",\n  },\n  {\n    code: \"validate_metadata_custom_profile_missing_required_fields\",\n    command: 'pm config set metadata-required-fields --criterion \"<field>\"',\n    summary:\n      \"Config-driven finding: the custom metadata profile has no required fields configured and falls back to core, so configure the fields rather than mutating items.\",\n  },\n  // --- pm validate: resolution ---\n  {\n    code: \"validate_resolution_missing_fields\",\n    command: 'pm update <id> --resolution \"<how resolved>\"',\n    summary: \"Backfill resolution / expected_result / actual_result on the reported closed item(s).\",\n  },\n  // --- pm validate: lifecycle ---\n  {\n    code: \"validate_lifecycle_active_closure_like_metadata\",\n    command: \"pm update <id> --unset <closure-like-field>\",\n    summary:\n      \"Clear the closure-like field the validator flags on this active item — the detail row names it (resolution / actual-result / blocked-reason) — or close the item if it is actually done.\",\n  },\n  {\n    code: \"validate_lifecycle_active_terminal_parent\",\n    command: \"pm update <id> --parent <active-parent-id>\",\n    summary: \"Reopen the terminal parent or move the active child under a non-terminal parent.\",\n  },\n  {\n    code: \"validate_lifecycle_stale_blockers\",\n    command: \"pm update <id> --unset blocked-by --unset blocked-reason\",\n    summary:\n      \"Resolve the stale blocker the validator flags: clear blocked-by/blocked-reason when they linger on a non-blocked item or report a resolved blocker; if instead a blocked item is missing blocker context, add the context or move it out of a blocked status.\",\n  },\n  {\n    code: \"validate_lifecycle_dependency_cycles_error\",\n    command: \"pm update <id> --dep-remove <dep-id>\",\n    summary: \"Break the dependency cycle by removing one edge from the reported cycle.\",\n  },\n  {\n    code: \"validate_lifecycle_dependency_cycles\",\n    command: \"pm update <id> --dep-remove <dep-id>\",\n    summary: \"Break the dependency cycle by removing one edge from the reported cycle.\",\n  },\n  // --- pm validate: files ---\n  {\n    code: \"validate_files_missing_linked_paths\",\n    command: \"pm <files|docs> <id> --remove <path>\",\n    summary:\n      \"The check spans both item.files and item.docs under one code: restore the missing linked artifact, or unlink it with pm files (linked file) or pm docs (linked doc).\",\n  },\n  {\n    code: \"validate_files_orphaned_paths\",\n    command: \"pm <files|docs> <id> --add <path>\",\n    summary:\n      \"Link the orphaned artifact with pm files (file) or pm docs (doc), or remove it from the workspace.\",\n  },\n  {\n    code: \"validate_files_tracked_all_strict_forces_pm_internals\",\n    command: \"pm validate --check-files --include-pm-internals\",\n    summary: \"tracked-all-strict scan flagged pm internals; re-run with --include-pm-internals or a softer --scan-mode.\",\n  },\n  // --- pm validate: history_drift ---\n  {\n    code: \"validate_history_drift_missing_streams\",\n    command: \"pm history-repair <id>\",\n    summary: \"Re-anchor the history chains of the items missing a history stream.\",\n  },\n  {\n    code: \"validate_history_drift_unreadable_streams\",\n    command: \"pm history-repair <id>\",\n    summary: \"Re-anchor the history chains of the items with an unreadable history stream.\",\n  },\n  {\n    code: \"validate_history_drift_hash_mismatches\",\n    command: \"pm history-repair <id>\",\n    summary: \"Re-anchor the history chains of the items whose content hash drifted.\",\n  },\n  {\n    code: \"validate_history_drift_chain_mismatches\",\n    command: \"pm history-repair <id>\",\n    summary: \"Re-anchor the history chains of the items with a broken history chain.\",\n  },\n  // --- pm validate: command_references ---\n  {\n    code: \"validate_command_references_stale_pm_ids\",\n    command: 'pm update <id> --replace-tests --test \"command=<corrected-command>\" [--test ...]',\n    summary:\n      \"Correct the stale pm-ID inside the item's linked test command (the check scans tests[].command, not the body). --replace-tests overwrites the entire tests list, so re-include the item's other linked tests in the same call.\",\n  },\n]);\n\n/**\n * Resolve the remediation entry for a warning token, or `undefined` when no\n * entry is registered. A warning matches an entry when it equals the entry code\n * or begins with `<code>:` (the colon boundary keeps sibling codes such as\n * `validate_lifecycle_dependency_cycles` and\n * `validate_lifecycle_dependency_cycles_error` disjoint).\n *\n * First match is intentional and correct: registry codes are mutually exclusive\n * under the colon-boundary rule, so at most one entry can ever match a warning\n * and order is irrelevant. That invariant is enforced by a test (see\n * remediation-registry.spec.ts \"keeps every registry code mutually exclusive\"),\n * which is why this stays a simple linear scan rather than a longest-prefix\n * search — a longest-prefix tie-break is unreachable with disjoint codes.\n *\n * Accepts unknown input defensively (this is an exported helper SDK consumers\n * may call from untyped JS): a non-string `warning` resolves to `undefined`.\n */\nexport function resolveRemediation(warning: string): RemediationEntry | undefined {\n  if (typeof warning !== \"string\") {\n    return undefined;\n  }\n  const normalized = warning.trim();\n  for (const entry of REMEDIATION_REGISTRY) {\n    if (normalized === entry.code || normalized.startsWith(`${entry.code}:`)) {\n      return entry;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Build a compact `remediation_map` (code -> command) for a set of warning\n * tokens. First match wins per code; unknown codes are skipped. Used by\n * `pm health --json` per-check details and as the source of deduped executable\n * commands for `pm validate --fix-hints`.\n */\nexport function buildRemediationMap(warnings: Iterable<string>): Record<string, string> {\n  const map: Record<string, string> = {};\n  for (const warning of warnings) {\n    const entry = resolveRemediation(warning);\n    if (entry !== undefined && !Object.prototype.hasOwnProperty.call(map, entry.code)) {\n      map[entry.code] = entry.command;\n    }\n  }\n  return map;\n}\n\n/**\n * Build a deduped, ordered list of executable remediation commands for a set of\n * warning tokens (one command per distinct matched code). Used by\n * `pm validate --fix-hints` for checks that do not already emit per-row\n * remediation commands.\n */\nexport function buildRemediationCommands(warnings: Iterable<string>): string[] {\n  return Object.values(buildRemediationMap(warnings));\n}\n"],"names":[],"mappings":"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","debugId":"55a3cd28-1420-5309-a9e8-f430fa2ada66"}

package/dist/cli-bundle/chunks/{chunk-GFBEXDCQ.js → chunk-M4AVU7VC.js}

@@ -1,21 +1,21 @@
 import {
   readHistoryEntries
-} from "./chunk-GRZGHGRG.js";
+} from "./chunk-SCS5PVAA.js";
 import {
   parseLimit
-} from "./chunk-VYZNX4C5.js";
+} from "./chunk-COVLE33A.js";
 import {
   enforceHistoryStreamPolicyForItems,
   listAllFrontMatterLight
-} from "./chunk-XXLMJDUB.js";
+} from "./chunk-KA22USXD.js";
 import {
   resolveItemTypeRegistry
-} from "./chunk-W6KNFAMZ.js";
+} from "./chunk-QXMXRPX5.js";
 import {
   compareTimestampStrings,
   nowIso,
   resolveIsoOrRelative
-} from "./chunk-IXVSSHGV.js";
+} from "./chunk-LNH5Q32E.js";
 import {
   EXIT_CODE,
   PmCliError,
@@ -25,7 +25,7 @@ import {
   readSettings,
   resolvePmRoot,
   runActiveOnReadHooks
-} from "./chunk-LFW5NQUP.js";
+} from "./chunk-CHM2VFVL.js";
 
 // dist/cli/commands/activity.js
 import fs from "node:fs/promises";
@@ -33,7 +33,7 @@ import path from "node:path";
 !(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] = "c3059057-e003-51f8-b095-e97cd640e5bc");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "1b517af5-9a40-5cd2-a231-82685e2acffb");
   } catch (e2) {
   }
 })();
@@ -108,6 +108,16 @@ async function listHistoryFiles(historyDir) {
     throw error;
   }
 }
+var _testOnly = {
+  parseNonEmptyFilter,
+  parseRangeBound,
+  includeByTimeWindow,
+  limitEntries,
+  readActivityString,
+  normalizeActivityEntry,
+  sortActivity,
+  listHistoryFiles
+};
 async function runActivity(options, global2) {
   const pmRoot = resolvePmRoot(process.cwd(), global2.path);
   if (!await pathExists(getSettingsPath(pmRoot))) {
@@ -180,6 +190,7 @@ async function runActivity(options, global2) {
 }
 
 export {
+  _testOnly,
   runActivity
 };
-//# sourceMappingURL=chunk-GFBEXDCQ.js.map
+//# sourceMappingURL=chunk-M4AVU7VC.js.map