@unbrained/pm-cli 2026.7.5 → 2026.7.7

package/dist/cli-bundle/chunks/eval-PHOTWYHI.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/eval.ts","../../../../../../../../core/search/eval.ts"],"sourcesContent":["/**\n * @module cli/commands/eval\n *\n * Implements the `pm eval` command surface (pm-u8n5): a search-relevance\n * evaluation runner that scores a human-curated golden-query set against the\n * live retrieval path and reports nDCG@k, MRR@k, precision@k, and recall@k per\n * query plus the macro average. With `--fail-under` it doubles as a CI gate so\n * relevance regressions — from corpus changes, hybrid-weight changes, or\n * provider swaps (including the offline BM25 provider, pm-75k9) — fail the build\n * instead of silently degrading retrieval quality.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport {\n  aggregateEvalMetrics,\n  DEFAULT_EVAL_K,\n  evaluateRanking,\n  parseEvalQuerySet,\n  type EvalSearchMode,\n  type QueryEvalMetrics,\n} from \"../../core/search/eval.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 { coercePositiveInteger } from \"../../core/shared/primitives.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { runSearch } from \"./search.js\";\n\n/**\n * Relative location (under the pm root) of the default golden-query set. A\n * git-tracked, human-curated file so relevance ground truth lives alongside the\n * tracker it evaluates.\n */\nexport const DEFAULT_EVAL_QUERIES_RELATIVE_PATH = path.join(\"search\", \"eval-queries.json\");\n\n/**\n * Documents the eval command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface EvalOptions {\n  /** Default retrieval mode for queries that do not set their own (keyword|semantic|hybrid). */\n  mode?: string;\n  /** Metric cutoff (`@k`); positive integer, defaults to {@link DEFAULT_EVAL_K}. */\n  k?: string | number;\n  /** Gate threshold: exit non-zero when the aggregate nDCG@k falls below this `[0,1]` value. */\n  failUnder?: string | number;\n  /** Override path to the golden-query JSON file (defaults to `<pmRoot>/search/eval-queries.json`). */\n  queries?: string;\n  /** Output format override: json|toon. */\n  format?: string;\n}\n\n/** Per-query relevance report row emitted by {@link runEval}. */\nexport interface EvalQueryReport {\n  query: string;\n  mode: EvalSearchMode;\n  relevant_total: number;\n  retrieved_relevant: number;\n  ndcg: number;\n  mrr: number;\n  precision: number;\n  recall: number;\n}\n\n/**\n * Documents the eval result payload exchanged by command, SDK, and package integrations.\n */\nexport interface EvalResult {\n  k: number;\n  query_count: number;\n  aggregate: {\n    ndcg: number;\n    mrr: number;\n    precision: number;\n    recall: number;\n  };\n  queries: EvalQueryReport[];\n  /** Present only when `--fail-under` was supplied. */\n  fail_under?: number;\n  /** Whether the aggregate nDCG met the gate (always true when no gate is set). */\n  passed: boolean;\n}\n\nconst VALID_EVAL_MODES: ReadonlySet<string> = new Set<EvalSearchMode>([\"keyword\", \"semantic\", \"hybrid\"]);\n\nfunction parseEvalMode(raw: string | undefined): EvalSearchMode {\n  if (raw === undefined) {\n    return \"keyword\";\n  }\n  const normalized = raw.trim().toLowerCase();\n  if (!VALID_EVAL_MODES.has(normalized)) {\n    throw new PmCliError(\"Eval --mode must be one of keyword|semantic|hybrid\", EXIT_CODE.USAGE);\n  }\n  return normalized as EvalSearchMode;\n}\n\nfunction parseEvalK(raw: string | number | undefined): number {\n  if (raw === undefined || raw === \"\") {\n    return DEFAULT_EVAL_K;\n  }\n  const parsed = coercePositiveInteger(raw);\n  if (parsed === null) {\n    throw new PmCliError(\"Eval --k must be a positive integer\", EXIT_CODE.USAGE);\n  }\n  return parsed;\n}\n\nfunction parseFailUnder(raw: string | number | undefined): number | undefined {\n  if (raw === undefined || raw === \"\") {\n    return undefined;\n  }\n  const parsed = typeof raw === \"number\" ? raw : Number(String(raw).trim());\n  if (!Number.isFinite(parsed) || parsed < 0 || parsed > 1) {\n    throw new PmCliError(\"Eval --fail-under must be a number in the range [0, 1]\", EXIT_CODE.USAGE);\n  }\n  return parsed;\n}\n\n/** Round a metric to four decimals to keep the JSON output compact and stable. */\nfunction roundMetric(value: number): number {\n  return Math.round(value * 10_000) / 10_000;\n}\n\nasync function loadEvalQuerySet(queriesPath: string): Promise<ReturnType<typeof parseEvalQuerySet>> {\n  let raw: string;\n  try {\n    raw = await fs.readFile(queriesPath, \"utf8\");\n  } catch {\n    throw new PmCliError(`Eval query set not found at ${queriesPath}`, EXIT_CODE.NOT_FOUND, {\n      examples: [\n        'echo \\'[{\"query\":\"offline search\",\"relevant_ids\":[\"pm-75k9\"]}]\\' > ' + queriesPath,\n        \"pm eval --queries ./my-eval.json\",\n      ],\n      nextSteps: [\n        \"Create a git-tracked golden-query JSON file (an array of {query, relevant_ids, mode?} objects), then re-run pm eval.\",\n      ],\n    });\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw);\n  } catch (error: unknown) {\n    // JSON.parse only ever throws a SyntaxError (an Error subclass).\n    throw new PmCliError(\n      `Eval query set at ${queriesPath} is not valid JSON: ${(error as Error).message}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  try {\n    return parseEvalQuerySet(parsed);\n  } catch (error: unknown) {\n    // parseEvalQuerySet only ever throws EvalQuerySetError (an Error subclass\n    // with a precise, author-actionable message) — surface it as a usage error.\n    throw new PmCliError((error as Error).message, EXIT_CODE.USAGE);\n  }\n}\n\n/**\n * Run the search-relevance evaluation (pm-u8n5). Loads the golden-query set\n * (default `<pmRoot>/search/eval-queries.json`, overridable via `--queries`),\n * runs each query through {@link runSearch} at the resolved mode, scores the\n * returned ranking with the nDCG/MRR/precision/recall metrics, and macro-averages\n * across queries. When `--fail-under` is supplied, `passed` reflects whether the\n * aggregate nDCG@k cleared the threshold; the CLI layer maps a failed gate to a\n * non-zero exit code.\n */\nexport async function runEval(options: EvalOptions, global: GlobalOptions): Promise<EvalResult> {\n  const pmRoot = resolvePmRoot(process.cwd(), global.path);\n  if (!(await pathExists(getSettingsPath(pmRoot)))) {\n    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);\n  }\n  const k = parseEvalK(options.k);\n  const defaultMode = parseEvalMode(options.mode);\n  const failUnder = parseFailUnder(options.failUnder);\n  const queriesPath = options.queries\n    ? path.resolve(process.cwd(), options.queries)\n    : path.join(pmRoot, DEFAULT_EVAL_QUERIES_RELATIVE_PATH);\n  const querySet = await loadEvalQuerySet(queriesPath);\n\n  const reports: EvalQueryReport[] = [];\n  // Aggregate and gate on the UNROUNDED metrics; rounding is applied only to the\n  // emitted report values so display precision never flips a --fail-under decision.\n  const rawMetrics: QueryEvalMetrics[] = [];\n  for (const evalQuery of querySet.queries) {\n    const mode = evalQuery.mode ?? defaultMode;\n    const searchResult = await runSearch(\n      evalQuery.query,\n      { mode, limit: String(k), fields: \"id\" },\n      global,\n    );\n    const rankedIds = searchResult.items\n      .map((item) => (item as { id?: unknown }).id)\n      .filter((id): id is string => typeof id === \"string\");\n    const metrics = evaluateRanking(rankedIds, new Set(evalQuery.relevant_ids), k);\n    rawMetrics.push(metrics);\n    reports.push({\n      query: evalQuery.query,\n      mode,\n      relevant_total: metrics.relevant_total,\n      retrieved_relevant: metrics.retrieved_relevant,\n      ndcg: roundMetric(metrics.ndcg),\n      mrr: roundMetric(metrics.mrr),\n      precision: roundMetric(metrics.precision),\n      recall: roundMetric(metrics.recall),\n    });\n  }\n\n  const aggregate = aggregateEvalMetrics(rawMetrics);\n  const passed = failUnder === undefined || aggregate.ndcg >= failUnder;\n  return {\n    k,\n    query_count: querySet.queries.length,\n    aggregate: {\n      ndcg: roundMetric(aggregate.ndcg),\n      mrr: roundMetric(aggregate.mrr),\n      precision: roundMetric(aggregate.precision),\n      recall: roundMetric(aggregate.recall),\n    },\n    queries: reports,\n    ...(failUnder !== undefined ? { fail_under: failUnder } : {}),\n    passed,\n  };\n}\n","/**\n * @module core/search/eval\n *\n * Search relevance evaluation primitives (pm-u8n5). Implements the standard\n * offline ranking metrics — nDCG@k, MRR@k, precision@k, recall@k — over a\n * human-curated golden-query set, plus the loader/validator for that set. The\n * `pm eval` command (src/cli/commands/eval.ts) runs each golden query through\n * the live retrieval path and feeds the ranked ids here, so relevance\n * regressions from corpus changes, hybrid-weight changes, or provider swaps are\n * measurable and gateable in CI.\n *\n * Relevance is binary: an id is either in a query's `relevant_ids` set or it is\n * not. This keeps the golden set cheap to curate while still supporting the\n * graded-discount behavior of DCG (earlier hits are worth more).\n */\n\n/**\n * Retrieval mode a golden query is evaluated under. Mirrors the `pm search`\n * mode surface; omitting it on a query defers to the eval run's default mode.\n */\nexport type EvalSearchMode = \"keyword\" | \"semantic\" | \"hybrid\";\n\n/** Default cutoff (`@k`) used for every metric when the caller does not override it. */\nexport const DEFAULT_EVAL_K = 10;\n\n/**\n * One curated golden query: the query text, the set of item ids considered\n * relevant, an optional per-query retrieval mode override, and an optional\n * human-readable description of the relevance intent.\n */\nexport interface EvalQuery {\n  query: string;\n  relevant_ids: string[];\n  mode?: EvalSearchMode;\n  description?: string;\n}\n\n/** A parsed, validated golden-query set. */\nexport interface EvalQuerySet {\n  queries: EvalQuery[];\n}\n\n/**\n * Thrown by {@link parseEvalQuerySet} when the raw golden-query payload is\n * structurally invalid. Carries a precise, human-actionable message naming the\n * offending query index/field so an author can fix the JSON directly.\n */\nexport class EvalQuerySetError extends Error {\n  /** Construct an error describing why a golden-query set failed validation. */\n  constructor(message: string) {\n    super(message);\n    this.name = \"EvalQuerySetError\";\n  }\n}\n\nconst VALID_EVAL_MODES: ReadonlySet<string> = new Set<EvalSearchMode>([\"keyword\", \"semantic\", \"hybrid\"]);\n\n/**\n * Compute Discounted Cumulative Gain at cutoff `k` for an ordered list of binary\n * relevance gains (`1` relevant, `0` not). Position `i` (1-based) contributes\n * `gain / log2(i + 1)`, so a relevant hit ranked first is worth `1` and later\n * hits are progressively discounted. Gains beyond `k` are ignored.\n */\nexport function dcgAtK(relevanceGains: number[], k: number): number {\n  let dcg = 0;\n  const limit = Math.min(k, relevanceGains.length);\n  for (let index = 0; index < limit; index += 1) {\n    dcg += relevanceGains[index] / Math.log2(index + 2);\n  }\n  return dcg;\n}\n\n/**\n * Normalized DCG at cutoff `k`: the ranking's DCG divided by the DCG of the\n * ideal ranking (all relevant ids first). Returns `0` when the query has no\n * relevant ids (the ideal DCG is `0` and the score is undefined), giving a\n * stable lower bound for aggregation. Result is in `[0, 1]`.\n */\nexport function ndcgAtK(rankedIds: string[], relevantIds: ReadonlySet<string>, k: number): number {\n  if (relevantIds.size === 0) {\n    return 0;\n  }\n  const gains = rankedIds.map((id) => (relevantIds.has(id) ? 1 : 0));\n  const dcg = dcgAtK(gains, k);\n  const idealGains = Array.from({ length: relevantIds.size }, () => 1);\n  const idealDcg = dcgAtK(idealGains, k);\n  return idealDcg === 0 ? 0 : dcg / idealDcg;\n}\n\n/**\n * Reciprocal rank of the first relevant id within the top `k` results: `1/rank`\n * (rank is 1-based), or `0` when no relevant id appears in the cutoff. Averaged\n * across queries this is Mean Reciprocal Rank (MRR@k).\n */\nexport function reciprocalRankAtK(rankedIds: string[], relevantIds: ReadonlySet<string>, k: number): number {\n  const limit = Math.min(k, rankedIds.length);\n  for (let index = 0; index < limit; index += 1) {\n    if (relevantIds.has(rankedIds[index])) {\n      return 1 / (index + 1);\n    }\n  }\n  return 0;\n}\n\n/**\n * Count relevant ids within the top `k` results (shared by precision and\n * recall).\n */\nfunction countRelevantInTopK(rankedIds: string[], relevantIds: ReadonlySet<string>, k: number): number {\n  const limit = Math.min(k, rankedIds.length);\n  let hits = 0;\n  for (let index = 0; index < limit; index += 1) {\n    if (relevantIds.has(rankedIds[index])) {\n      hits += 1;\n    }\n  }\n  return hits;\n}\n\n/**\n * Precision at cutoff `k`: relevant ids retrieved in the top `k` divided by `k`.\n * Returns `0` for a non-positive `k`.\n */\nexport function precisionAtK(rankedIds: string[], relevantIds: ReadonlySet<string>, k: number): number {\n  if (k <= 0) {\n    return 0;\n  }\n  return countRelevantInTopK(rankedIds, relevantIds, k) / k;\n}\n\n/**\n * Recall at cutoff `k`: relevant ids retrieved in the top `k` divided by the\n * total number of relevant ids. Returns `0` when the query has no relevant ids.\n */\nexport function recallAtK(rankedIds: string[], relevantIds: ReadonlySet<string>, k: number): number {\n  if (relevantIds.size === 0) {\n    return 0;\n  }\n  return countRelevantInTopK(rankedIds, relevantIds, k) / relevantIds.size;\n}\n\n/** The four ranking metrics computed for a single query, plus match counts. */\nexport interface QueryEvalMetrics {\n  ndcg: number;\n  mrr: number;\n  precision: number;\n  recall: number;\n  relevant_total: number;\n  retrieved_relevant: number;\n}\n\n/**\n * Evaluate one ranking against its relevant-id set at cutoff `k`, returning all\n * four metrics together so callers compute the document ranking once and read\n * every score off the result.\n */\nexport function evaluateRanking(rankedIds: string[], relevantIds: ReadonlySet<string>, k: number): QueryEvalMetrics {\n  return {\n    ndcg: ndcgAtK(rankedIds, relevantIds, k),\n    mrr: reciprocalRankAtK(rankedIds, relevantIds, k),\n    precision: precisionAtK(rankedIds, relevantIds, k),\n    recall: recallAtK(rankedIds, relevantIds, k),\n    relevant_total: relevantIds.size,\n    retrieved_relevant: countRelevantInTopK(rankedIds, relevantIds, k),\n  };\n}\n\n/** Macro-averaged metrics across all evaluated queries. */\nexport interface AggregateEvalMetrics {\n  ndcg: number;\n  mrr: number;\n  precision: number;\n  recall: number;\n  query_count: number;\n}\n\n/**\n * Macro-average per-query metrics (each query weighted equally). Returns all\n * zeros with `query_count: 0` for an empty input so the gate path has a stable\n * shape to compare against.\n */\nexport function aggregateEvalMetrics(perQuery: QueryEvalMetrics[]): AggregateEvalMetrics {\n  const queryCount = perQuery.length;\n  if (queryCount === 0) {\n    return { ndcg: 0, mrr: 0, precision: 0, recall: 0, query_count: 0 };\n  }\n  const sum = perQuery.reduce(\n    (accumulator, metrics) => ({\n      ndcg: accumulator.ndcg + metrics.ndcg,\n      mrr: accumulator.mrr + metrics.mrr,\n      precision: accumulator.precision + metrics.precision,\n      recall: accumulator.recall + metrics.recall,\n    }),\n    { ndcg: 0, mrr: 0, precision: 0, recall: 0 },\n  );\n  return {\n    ndcg: sum.ndcg / queryCount,\n    mrr: sum.mrr / queryCount,\n    precision: sum.precision / queryCount,\n    recall: sum.recall / queryCount,\n    query_count: queryCount,\n  };\n}\n\n/**\n * Validate one raw golden-query entry, returning a typed {@link EvalQuery}.\n * Throws {@link EvalQuerySetError} (with the entry index) for a missing/empty\n * `query`, a `relevant_ids` that is not a non-empty string array, or an invalid\n * `mode`. `relevant_ids` are trimmed and de-duplicated; `description` is kept\n * only when it is a non-empty string.\n */\nfunction parseEvalQueryEntry(raw: unknown, index: number): EvalQuery {\n  if (typeof raw !== \"object\" || raw === null) {\n    throw new EvalQuerySetError(`Eval query at index ${index} must be an object`);\n  }\n  const entry = raw as { query?: unknown; relevant_ids?: unknown; mode?: unknown; description?: unknown };\n  const query = typeof entry.query === \"string\" ? entry.query.trim() : \"\";\n  if (query.length === 0) {\n    throw new EvalQuerySetError(`Eval query at index ${index} must have a non-empty \"query\" string`);\n  }\n  if (!Array.isArray(entry.relevant_ids)) {\n    throw new EvalQuerySetError(`Eval query at index ${index} must have a \"relevant_ids\" array`);\n  }\n  if (entry.relevant_ids.some((value) => typeof value !== \"string\")) {\n    // Reject (rather than silently drop) non-string members: malformed golden\n    // data must fail loudly so it can never quietly change relevance judgments.\n    throw new EvalQuerySetError(`Eval query at index ${index} must have a \"relevant_ids\" array of strings`);\n  }\n  const relevantIds = [\n    ...new Set((entry.relevant_ids as string[]).map((value) => value.trim()).filter((value) => value.length > 0)),\n  ];\n  if (relevantIds.length === 0) {\n    throw new EvalQuerySetError(`Eval query at index ${index} must list at least one relevant id`);\n  }\n  if (entry.mode !== undefined && (typeof entry.mode !== \"string\" || !VALID_EVAL_MODES.has(entry.mode))) {\n    throw new EvalQuerySetError(`Eval query at index ${index} has an invalid mode (expected keyword|semantic|hybrid)`);\n  }\n  return {\n    query,\n    relevant_ids: relevantIds,\n    ...(entry.mode !== undefined ? { mode: entry.mode as EvalSearchMode } : {}),\n    ...(typeof entry.description === \"string\" && entry.description.trim().length > 0\n      ? { description: entry.description.trim() }\n      : {}),\n  };\n}\n\n/**\n * Parse and validate a raw golden-query payload (typically `JSON.parse` of\n * `.agents/pm/search/eval-queries.json`). Accepts either a bare array of query\n * entries or an object with a `queries` array. Throws {@link EvalQuerySetError}\n * with a precise message when the payload is not an array/object, when\n * `queries` is missing/not an array, when the set is empty, or when any entry\n * fails {@link parseEvalQueryEntry}.\n */\nexport function parseEvalQuerySet(raw: unknown): EvalQuerySet {\n  const rawQueries = Array.isArray(raw)\n    ? raw\n    : typeof raw === \"object\" && raw !== null\n      ? (raw as { queries?: unknown }).queries\n      : undefined;\n  if (!Array.isArray(rawQueries)) {\n    throw new EvalQuerySetError('Eval query set must be an array of queries or an object with a \"queries\" array');\n  }\n  if (rawQueries.length === 0) {\n    throw new EvalQuerySetError(\"Eval query set must contain at least one query\");\n  }\n  return {\n    queries: rawQueries.map((entry, index) => parseEvalQueryEntry(entry, index)),\n  };\n}\n"],"names":["VALID_EVAL_MODES"],"mappings":"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","debugId":"2c8d5c7c-cb86-5093-b2d7-5ea51af4a122"}

package/dist/cli-bundle/chunks/extension-NBAH62ML.js

@@ -1,40 +0,0 @@
-import {
-  _testOnly,
-  copyExtensionDirectoryForInstall,
-  parseExtensionInstallSource,
-  readManagedExtensionState,
-  resolveManagedExtensionStatePath,
-  runExtension,
-  writeManagedExtensionState
-} from "./chunk-GIWXVMZ3.js";
-import "./chunk-KDZ6K25I.js";
-import "./chunk-ZVDL32GJ.js";
-import "./chunk-E2FUG6GD.js";
-import "./chunk-5HIZDR5A.js";
-import {
-  parseExtensionManifest,
-  validateExtensionDirectory
-} from "./chunk-R3ZBLGTC.js";
-import "./chunk-UI5BJ6DO.js";
-import "./chunk-C3PMDWGX.js";
-import "./chunk-4QQ6PM7M.js";
-import "./chunk-3U3VEWK6.js";
-import "./chunk-Y76TWC45.js";
-import "./chunk-EZFKWSC7.js";
-import "./chunk-DRBV5UC2.js";
-import "./chunk-P5YORJRH.js";
-import "./chunk-T35XLYZF.js";
-import "./chunk-7C2O74AE.js";
-import "./chunk-5VVUKE3U.js";
-export {
-  _testOnly,
-  copyExtensionDirectoryForInstall,
-  parseExtensionInstallSource,
-  parseExtensionManifest,
-  readManagedExtensionState,
-  resolveManagedExtensionStatePath,
-  runExtension,
-  validateExtensionDirectory,
-  writeManagedExtensionState
-};
-//# sourceMappingURL=extension-NBAH62ML.js.map

package/dist/cli-bundle/chunks/extension-ZF6ZZPOU.js

@@ -1,44 +0,0 @@
-
-!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]="45eac7fa-f181-5cca-93b7-cfb58909dbb3")}catch(e){}}();
-import {
-  _testOnly,
-  copyExtensionDirectoryForInstall,
-  parseExtensionInstallSource,
-  readManagedExtensionState,
-  resolveManagedExtensionStatePath,
-  runExtension,
-  writeManagedExtensionState
-} from "./chunk-JFCVQXZX.js";
-import "./chunk-K32L7HZO.js";
-import "./chunk-OK5NXCZB.js";
-import "./chunk-53BTLLAF.js";
-import "./chunk-P4SESZGT.js";
-import {
-  parseExtensionManifest,
-  validateExtensionDirectory
-} from "./chunk-FUM6UMY4.js";
-import "./chunk-PPE4YUQM.js";
-import "./chunk-AAEQMOC6.js";
-import "./chunk-PJ3A56YF.js";
-import "./chunk-57C2RLW5.js";
-import "./chunk-ZAHXPXVY.js";
-import "./chunk-HK72NWAD.js";
-import "./chunk-FJRKQREY.js";
-import "./chunk-US3T3W5J.js";
-import "./chunk-NER3KUUS.js";
-import "./chunk-NNHHXJB2.js";
-import "./chunk-YD5FML7K.js";
-export {
-  _testOnly,
-  copyExtensionDirectoryForInstall,
-  parseExtensionInstallSource,
-  parseExtensionManifest,
-  readManagedExtensionState,
-  resolveManagedExtensionStatePath,
-  runExtension,
-  validateExtensionDirectory,
-  writeManagedExtensionState
-};
-//# sourceMappingURL=extension-ZF6ZZPOU.js.map
-
-//# debugId=45eac7fa-f181-5cca-93b7-cfb58909dbb3

package/dist/cli-bundle/chunks/gc-AETFKZ44.js

@@ -1,398 +0,0 @@
-import {
-  runLockGc
-} from "./chunk-QZ342C63.js";
-import {
-  nowIso
-} from "./chunk-DRBV5UC2.js";
-import {
-  PmCliError,
-  readSettings,
-  runActiveOnIndexHooks,
-  runActiveOnReadHooks,
-  runActiveOnWriteHooks
-} from "./chunk-P5YORJRH.js";
-import "./chunk-7C2O74AE.js";
-import {
-  EXIT_CODE,
-  getSettingsPath,
-  pathExists,
-  resolvePmRoot
-} from "./chunk-5VVUKE3U.js";
-
-// dist/cli/commands/gc.js
-import fs2 from "node:fs/promises";
-import path2 from "node:path";
-
-// dist/core/checkpoint/checkpoint-gc.js
-import fs from "node:fs/promises";
-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] = "83dc8421-d6b4-5ef6-ac77-bfca9e10ffb1");
-  } catch (e2) {
-  }
-})();
-var MILLISECONDS_PER_DAY = 864e5;
-function isErrno(error, code) {
-  return typeof error === "object" && error !== null && "code" in error && error.code === code;
-}
-function readCheckpointCreatedAt(raw) {
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    return null;
-  }
-  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
-    return null;
-  }
-  const createdAt = parsed.created_at;
-  return typeof createdAt === "string" ? createdAt : null;
-}
-async function collectCheckpointFiles(checkpointsDir, warnings) {
-  let dirEntries;
-  try {
-    dirEntries = await fs.readdir(checkpointsDir, { withFileTypes: true });
-  } catch (error) {
-    if (isErrno(error, "ENOENT")) {
-      return [];
-    }
-    throw error;
-  }
-  const files = [];
-  for (const entry of dirEntries) {
-    if (entry.isDirectory()) {
-      const subdir = path.join(checkpointsDir, entry.name);
-      let nested;
-      try {
-        nested = await fs.readdir(subdir);
-      } catch (error) {
-        if (!isErrno(error, "ENOENT")) {
-          warnings.push(`checkpoint_subdir_unreadable:${entry.name}`);
-        }
-        continue;
-      }
-      for (const file of nested) {
-        if (file.endsWith(".json")) {
-          files.push(`${entry.name}/${file}`);
-        }
-      }
-    } else if (entry.name.endsWith(".json")) {
-      files.push(entry.name);
-    }
-  }
-  return files.sort();
-}
-async function runCheckpointGc(pmRoot, options) {
-  const { dryRun, hooks } = options;
-  const nowMs = options.now ?? Date.now();
-  const retentionMs = Math.max(0, options.retentionDays) * MILLISECONDS_PER_DAY;
-  const checkpointsDir = path.join(pmRoot, "checkpoints");
-  const result = {
-    scanned: 0,
-    removed: [],
-    retained: [],
-    warnings: [],
-    entries: []
-  };
-  const files = await collectCheckpointFiles(checkpointsDir, result.warnings);
-  for (const relName of files) {
-    const absPath = path.join(checkpointsDir, relName);
-    const relPath = `checkpoints/${relName}`;
-    result.scanned += 1;
-    if (hooks?.onRead) {
-      result.warnings.push(...await hooks.onRead(absPath));
-    }
-    let raw;
-    try {
-      raw = await fs.readFile(absPath, "utf8");
-    } catch (readError) {
-      if (isErrno(readError, "ENOENT")) {
-        result.scanned -= 1;
-        continue;
-      }
-      result.warnings.push(`checkpoint_unreadable:${relName}`);
-      result.retained.push(relPath);
-      result.entries.push({ file: relPath, created_at: null, age_seconds: null, stale: false, reason: "unparseable" });
-      continue;
-    }
-    const createdAt = readCheckpointCreatedAt(raw);
-    const createdAtMs = createdAt === null ? Number.NaN : Date.parse(createdAt);
-    if (!Number.isFinite(createdAtMs)) {
-      result.warnings.push(`checkpoint_unparseable:${relName}`);
-      result.retained.push(relPath);
-      result.entries.push({
-        file: relPath,
-        created_at: createdAt,
-        age_seconds: null,
-        stale: false,
-        reason: "unparseable"
-      });
-      continue;
-    }
-    const ageMs = nowMs - createdAtMs;
-    const entry = {
-      file: relPath,
-      created_at: createdAt,
-      age_seconds: Math.floor(ageMs / 1e3),
-      stale: ageMs > retentionMs,
-      reason: ageMs > retentionMs ? "expired" : "active"
-    };
-    if (!entry.stale) {
-      result.retained.push(relPath);
-      result.entries.push(entry);
-      continue;
-    }
-    if (!dryRun) {
-      try {
-        await fs.unlink(absPath);
-      } catch (unlinkError) {
-        if (!isErrno(unlinkError, "ENOENT")) {
-          result.warnings.push(`checkpoint_remove_failed:${relName}`);
-          result.retained.push(relPath);
-          result.entries.push(entry);
-          continue;
-        }
-      }
-      if (hooks?.onWrite) {
-        result.warnings.push(...await hooks.onWrite(absPath));
-      }
-    }
-    result.removed.push(relPath);
-    result.entries.push(entry);
-  }
-  return result;
-}
-
-// dist/cli/commands/gc.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] = "15ee0289-1af7-5b11-b023-f19cfc3363fc");
-  } catch (e2) {
-  }
-})();
-var GC_SCOPE_VALUES = ["index", "embeddings", "runtime", "locks", "checkpoints"];
-var GC_TARGETS = [
-  {
-    scope: "index",
-    relativePath: "index/manifest.json",
-    kind: "file"
-  },
-  {
-    scope: "embeddings",
-    relativePath: "search/embeddings.jsonl",
-    kind: "file"
-  },
-  {
-    scope: "embeddings",
-    relativePath: "search/vectorization-status.json",
-    kind: "file"
-  },
-  {
-    scope: "embeddings",
-    relativePath: "search/lancedb",
-    kind: "directory"
-  },
-  {
-    // Removing embeddings invalidates the whole semantic index, so the queued
-    // background-refresh work is also meaningless: a worker draining a stale
-    // queue against an empty ledger would rebuild a partial, inconsistent index
-    // (only the queued items vectorized). Clear the queue and its gate so the
-    // next mutation re-seeds from a clean slate. See core/search/background-refresh.ts.
-    scope: "embeddings",
-    relativePath: "search/pending-refresh.json",
-    kind: "file"
-  },
-  {
-    scope: "embeddings",
-    relativePath: "search/pending-refresh.gate.lock",
-    kind: "directory"
-  },
-  {
-    scope: "runtime",
-    relativePath: "runtime/test-runs",
-    kind: "directory"
-  },
-  {
-    scope: "runtime",
-    relativePath: "runtime/history-drift-cache.json",
-    kind: "file"
-  }
-];
-function isErrno2(error, code) {
-  return typeof error === "object" && error !== null && "code" in error && error.code === code;
-}
-async function removeCacheFile(pmRoot, target, dryRun) {
-  const relativePath = target.relativePath;
-  const absolutePath = path2.join(pmRoot, relativePath);
-  const warnings = await runActiveOnReadHooks({
-    path: absolutePath,
-    scope: "project"
-  });
-  try {
-    const stats = await fs2.stat(absolutePath);
-    if (target.kind === "file" && !stats.isFile()) {
-      return {
-        removed: false,
-        warnings: [...warnings, `not_a_file:${relativePath}`]
-      };
-    }
-    if (target.kind === "directory" && !stats.isDirectory()) {
-      return {
-        removed: false,
-        warnings: [...warnings, `not_a_directory:${relativePath}`]
-      };
-    }
-    if (dryRun) {
-      return {
-        removed: true,
-        warnings
-      };
-    }
-    if (target.kind === "file") {
-      await fs2.unlink(absolutePath);
-    } else {
-      await fs2.rm(absolutePath, { recursive: true, force: true });
-    }
-    const writeWarnings = await runActiveOnWriteHooks({
-      path: absolutePath,
-      scope: "project",
-      op: "gc:remove"
-    });
-    return {
-      removed: true,
-      warnings: [...warnings, ...writeWarnings]
-    };
-  } catch (error) {
-    if (isErrno2(error, "ENOENT")) {
-      return {
-        removed: false,
-        warnings
-      };
-    }
-    throw error;
-  }
-}
-function parseScopes(raw) {
-  if (!raw || raw.length === 0) {
-    return [...GC_SCOPE_VALUES];
-  }
-  const tokens = raw.flatMap((entry) => entry.split(",")).map((entry) => entry.trim().toLowerCase()).filter((entry) => entry.length > 0);
-  if (tokens.length === 0) {
-    throw new PmCliError(`--scope requires at least one value (${GC_SCOPE_VALUES.join(",")})`, EXIT_CODE.USAGE);
-  }
-  const resolved = /* @__PURE__ */ new Set();
-  for (const token of tokens) {
-    if (!GC_SCOPE_VALUES.includes(token)) {
-      throw new PmCliError(`Invalid --scope value "${token}". Expected one or more of: ${GC_SCOPE_VALUES.join(", ")}`, EXIT_CODE.USAGE);
-    }
-    resolved.add(token);
-  }
-  return GC_SCOPE_VALUES.filter((scope) => resolved.has(scope));
-}
-function buildGcGuidance(params) {
-  const guidance = [];
-  if (params.dryRun) {
-    guidance.push("Dry-run preview only: no cache artifacts were deleted.");
-  }
-  const searchScopeSelected = params.scopes.includes("index") || params.scopes.includes("embeddings");
-  const searchArtifactsAffected = params.removed.some((entry) => entry === "index/manifest.json" || entry === "search/embeddings.jsonl" || entry === "search/vectorization-status.json" || entry === "search/lancedb" || entry === "search/pending-refresh.json" || entry === "search/pending-refresh.gate.lock");
-  if (searchScopeSelected && searchArtifactsAffected) {
-    guidance.push('Search artifacts were removed; the semantic index (including any queued background refresh) is invalidated. Run "pm install search-advanced --project" if reindex is unavailable, then "pm reindex --mode keyword" (and "--mode semantic" when semantic search is enabled) before search-heavy workflows.');
-  }
-  if (params.removed.includes("runtime/history-drift-cache.json")) {
-    guidance.push('History drift cache was removed; the next "pm health" run performs a full history-drift re-scan.');
-  }
-  if (!params.dryRun && params.removed.some((entry) => entry.startsWith("checkpoints/"))) {
-    guidance.push('Aged rollback checkpoints were removed; their "pm update-many"/"pm close-many --rollback" windows are no longer recoverable.');
-  }
-  return guidance;
-}
-async function runGc(global2, options = {}) {
-  const pmRoot = resolvePmRoot(process.cwd(), global2.path);
-  if (!await pathExists(getSettingsPath(pmRoot))) {
-    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-  }
-  const settings = await readSettings(pmRoot);
-  const dryRun = options.dryRun === true;
-  const scopes = parseScopes(options.scope);
-  const selectedTargets = GC_TARGETS.filter((target) => scopes.includes(target.scope));
-  const removed = [];
-  const retained = [];
-  const warnings = [];
-  for (const target of selectedTargets) {
-    const result = await removeCacheFile(pmRoot, target, dryRun);
-    if (result.removed) {
-      removed.push(target.relativePath);
-    } else {
-      retained.push(target.relativePath);
-    }
-    warnings.push(...result.warnings);
-  }
-  let locksSummary;
-  if (scopes.includes("locks")) {
-    const lockResult = await runLockGc(pmRoot, {
-      dryRun,
-      hooks: {
-        onRead: (lockPath) => runActiveOnReadHooks({ path: lockPath, scope: "project" }),
-        onWrite: (lockPath) => runActiveOnWriteHooks({ path: lockPath, scope: "project", op: "gc:lock_remove" })
-      }
-    });
-    removed.push(...lockResult.removed);
-    retained.push(...lockResult.retained);
-    warnings.push(...lockResult.warnings);
-    locksSummary = {
-      scanned: lockResult.scanned,
-      removed: lockResult.removed.length,
-      retained: lockResult.retained.length
-    };
-  }
-  let checkpointsSummary;
-  if (scopes.includes("checkpoints")) {
-    const retentionDays = settings.checkpoints.retention_days;
-    const checkpointResult = await runCheckpointGc(pmRoot, {
-      dryRun,
-      retentionDays,
-      hooks: {
-        onRead: (checkpointPath) => runActiveOnReadHooks({ path: checkpointPath, scope: "project" }),
-        onWrite: (checkpointPath) => runActiveOnWriteHooks({ path: checkpointPath, scope: "project", op: "gc:checkpoint_remove" })
-      }
-    });
-    removed.push(...checkpointResult.removed);
-    retained.push(...checkpointResult.retained);
-    warnings.push(...checkpointResult.warnings);
-    checkpointsSummary = {
-      scanned: checkpointResult.scanned,
-      removed: checkpointResult.removed.length,
-      retained: checkpointResult.retained.length,
-      retention_days: retentionDays
-    };
-  }
-  warnings.push(...await runActiveOnIndexHooks({
-    mode: dryRun ? "gc:dry-run" : "gc",
-    total_items: selectedTargets.length
-  }));
-  const guidance = buildGcGuidance({
-    dryRun,
-    scopes,
-    removed
-  });
-  return {
-    ok: warnings.length === 0,
-    dry_run: dryRun,
-    scope: scopes,
-    removed,
-    retained,
-    warnings,
-    ...locksSummary ? { locks: locksSummary } : {},
-    ...checkpointsSummary ? { checkpoints: checkpointsSummary } : {},
-    guidance,
-    generated_at: nowIso()
-  };
-}
-export {
-  runGc
-};
-//# sourceMappingURL=gc-AETFKZ44.js.map

package/dist/cli-bundle/chunks/gc-AETFKZ44.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../../../../cli/commands/gc.ts", "../../../../../../../../core/checkpoint/checkpoint-gc.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/gc\n *\n * Implements the pm gc command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { runCheckpointGc } from \"../../core/checkpoint/checkpoint-gc.js\";\nimport { runActiveOnIndexHooks, runActiveOnReadHooks, runActiveOnWriteHooks } from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { runLockGc } from \"../../core/lock/lock-gc.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 { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\n\nconst GC_SCOPE_VALUES = [\"index\", \"embeddings\", \"runtime\", \"locks\", \"checkpoints\"] as const;\ntype GcScope = (typeof GC_SCOPE_VALUES)[number];\n\ninterface GcTarget {\n  scope: GcScope;\n  relativePath: string;\n  kind: \"file\" | \"directory\";\n}\n\nconst GC_TARGETS: readonly GcTarget[] = [\n  {\n    scope: \"index\",\n    relativePath: \"index/manifest.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/embeddings.jsonl\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/vectorization-status.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/lancedb\",\n    kind: \"directory\",\n  },\n  {\n    // Removing embeddings invalidates the whole semantic index, so the queued\n    // background-refresh work is also meaningless: a worker draining a stale\n    // queue against an empty ledger would rebuild a partial, inconsistent index\n    // (only the queued items vectorized). Clear the queue and its gate so the\n    // next mutation re-seeds from a clean slate. See core/search/background-refresh.ts.\n    scope: \"embeddings\",\n    relativePath: \"search/pending-refresh.json\",\n    kind: \"file\",\n  },\n  {\n    scope: \"embeddings\",\n    relativePath: \"search/pending-refresh.gate.lock\",\n    kind: \"directory\",\n  },\n  {\n    scope: \"runtime\",\n    relativePath: \"runtime/test-runs\",\n    kind: \"directory\",\n  },\n  {\n    scope: \"runtime\",\n    relativePath: \"runtime/history-drift-cache.json\",\n    kind: \"file\",\n  },\n] as const;\n\n/**\n * Documents the gc command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface GcCommandOptions {\n  dryRun?: boolean;\n  scope?: string[];\n}\n\n/**\n * Documents the gc locks summary payload exchanged by command, SDK, and package integrations.\n */\nexport interface GcLocksSummary {\n  scanned: number;\n  removed: number;\n  retained: number;\n}\n\n/**\n * Documents the gc checkpoints summary payload exchanged by command, SDK, and package integrations.\n */\nexport interface GcCheckpointsSummary {\n  scanned: number;\n  removed: number;\n  retained: number;\n  retention_days: number;\n}\n\n/**\n * Documents the gc result payload exchanged by command, SDK, and package integrations.\n */\nexport interface GcResult {\n  ok: boolean;\n  dry_run: boolean;\n  scope: GcScope[];\n  removed: string[];\n  retained: string[];\n  warnings: string[];\n  guidance: string[];\n  /** Present only when the locks scope was selected. Summarizes the stale-lock sweep. */\n  locks?: GcLocksSummary;\n  /** Present only when the checkpoints scope was selected. Summarizes the rollback-checkpoint sweep. */\n  checkpoints?: GcCheckpointsSummary;\n  generated_at: string;\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === code;\n}\n\nasync function removeCacheFile(\n  pmRoot: string,\n  target: GcTarget,\n  dryRun: boolean,\n): Promise<{ removed: boolean; warnings: string[] }> {\n  const relativePath = target.relativePath;\n  const absolutePath = path.join(pmRoot, relativePath);\n  const warnings = await runActiveOnReadHooks({\n    path: absolutePath,\n    scope: \"project\",\n  });\n  try {\n    const stats = await fs.stat(absolutePath);\n    if (target.kind === \"file\" && !stats.isFile()) {\n      return {\n        removed: false,\n        warnings: [...warnings, `not_a_file:${relativePath}`],\n      };\n    }\n    if (target.kind === \"directory\" && !stats.isDirectory()) {\n      return {\n        removed: false,\n        warnings: [...warnings, `not_a_directory:${relativePath}`],\n      };\n    }\n    if (dryRun) {\n      return {\n        removed: true,\n        warnings,\n      };\n    }\n    if (target.kind === \"file\") {\n      await fs.unlink(absolutePath);\n    } else {\n      await fs.rm(absolutePath, { recursive: true, force: true });\n    }\n    const writeWarnings = await runActiveOnWriteHooks({\n      path: absolutePath,\n      scope: \"project\",\n      op: \"gc:remove\",\n    });\n    return {\n      removed: true,\n      warnings: [...warnings, ...writeWarnings],\n    };\n  } catch (error: unknown) {\n    if (isErrno(error, \"ENOENT\")) {\n      return {\n        removed: false,\n        warnings,\n      };\n    }\n    throw error;\n  }\n}\n\nfunction parseScopes(raw: string[] | undefined): GcScope[] {\n  if (!raw || raw.length === 0) {\n    return [...GC_SCOPE_VALUES];\n  }\n  const tokens = raw\n    .flatMap((entry) => entry.split(\",\"))\n    .map((entry) => entry.trim().toLowerCase())\n    .filter((entry) => entry.length > 0);\n  if (tokens.length === 0) {\n    throw new PmCliError(`--scope requires at least one value (${GC_SCOPE_VALUES.join(\",\")})`, EXIT_CODE.USAGE);\n  }\n  const resolved = new Set<GcScope>();\n  for (const token of tokens) {\n    if (!(GC_SCOPE_VALUES as readonly string[]).includes(token)) {\n      throw new PmCliError(\n        `Invalid --scope value \"${token}\". Expected one or more of: ${GC_SCOPE_VALUES.join(\", \")}`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    resolved.add(token as GcScope);\n  }\n  return GC_SCOPE_VALUES.filter((scope) => resolved.has(scope));\n}\n\nfunction buildGcGuidance(params: {\n  dryRun: boolean;\n  scopes: GcScope[];\n  removed: string[];\n}): string[] {\n  const guidance: string[] = [];\n  if (params.dryRun) {\n    guidance.push(\"Dry-run preview only: no cache artifacts were deleted.\");\n  }\n  const searchScopeSelected = params.scopes.includes(\"index\") || params.scopes.includes(\"embeddings\");\n  const searchArtifactsAffected = params.removed.some(\n    (entry) =>\n      entry === \"index/manifest.json\" ||\n      entry === \"search/embeddings.jsonl\" ||\n      entry === \"search/vectorization-status.json\" ||\n      entry === \"search/lancedb\" ||\n      entry === \"search/pending-refresh.json\" ||\n      entry === \"search/pending-refresh.gate.lock\",\n  );\n  if (searchScopeSelected && searchArtifactsAffected) {\n    guidance.push(\n      'Search artifacts were removed; the semantic index (including any queued background refresh) is invalidated. Run \"pm install search-advanced --project\" if reindex is unavailable, then \"pm reindex --mode keyword\" (and \"--mode semantic\" when semantic search is enabled) before search-heavy workflows.',\n    );\n  }\n  if (params.removed.includes(\"runtime/history-drift-cache.json\")) {\n    guidance.push('History drift cache was removed; the next \"pm health\" run performs a full history-drift re-scan.');\n  }\n  if (!params.dryRun && params.removed.some((entry) => entry.startsWith(\"checkpoints/\"))) {\n    guidance.push(\n      'Aged rollback checkpoints were removed; their \"pm update-many\"/\"pm close-many --rollback\" windows are no longer recoverable.',\n    );\n  }\n  return guidance;\n}\n\n/**\n * Implements run gc for the public runtime surface of this module.\n */\nexport async function runGc(global: GlobalOptions, options: GcCommandOptions = {}): Promise<GcResult> {\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 dryRun = options.dryRun === true;\n  const scopes = parseScopes(options.scope);\n  const selectedTargets = GC_TARGETS.filter((target) => scopes.includes(target.scope));\n\n  const removed: string[] = [];\n  const retained: string[] = [];\n  const warnings: string[] = [];\n\n  for (const target of selectedTargets) {\n    const result = await removeCacheFile(pmRoot, target, dryRun);\n    if (result.removed) {\n      removed.push(target.relativePath);\n    } else {\n      retained.push(target.relativePath);\n    }\n    warnings.push(...result.warnings);\n  }\n\n  // The locks scope is not a path-based GC_TARGET: it sweeps the locks/ directory\n  // and removes only locks whose own embedded ttl has expired (crashed-process\n  // debris), retaining active and unparseable locks. See core/lock/lock-gc.ts.\n  let locksSummary: GcLocksSummary | undefined;\n  if (scopes.includes(\"locks\")) {\n    const lockResult = await runLockGc(pmRoot, {\n      dryRun,\n      hooks: {\n        onRead: (lockPath) => runActiveOnReadHooks({ path: lockPath, scope: \"project\" }),\n        onWrite: (lockPath) => runActiveOnWriteHooks({ path: lockPath, scope: \"project\", op: \"gc:lock_remove\" }),\n      },\n    });\n    removed.push(...lockResult.removed);\n    retained.push(...lockResult.retained);\n    warnings.push(...lockResult.warnings);\n    locksSummary = {\n      scanned: lockResult.scanned,\n      removed: lockResult.removed.length,\n      retained: lockResult.retained.length,\n    };\n  }\n\n  // The checkpoints scope is also not a path-based GC_TARGET: it sweeps\n  // checkpoints/ and removes only rollback checkpoints older than the configured\n  // checkpoints.retention_days, retaining active and unparseable files. See\n  // core/checkpoint/checkpoint-gc.ts.\n  let checkpointsSummary: GcCheckpointsSummary | undefined;\n  if (scopes.includes(\"checkpoints\")) {\n    const retentionDays = settings.checkpoints.retention_days;\n    const checkpointResult = await runCheckpointGc(pmRoot, {\n      dryRun,\n      retentionDays,\n      hooks: {\n        onRead: (checkpointPath) => runActiveOnReadHooks({ path: checkpointPath, scope: \"project\" }),\n        onWrite: (checkpointPath) =>\n          runActiveOnWriteHooks({ path: checkpointPath, scope: \"project\", op: \"gc:checkpoint_remove\" }),\n      },\n    });\n    removed.push(...checkpointResult.removed);\n    retained.push(...checkpointResult.retained);\n    warnings.push(...checkpointResult.warnings);\n    checkpointsSummary = {\n      scanned: checkpointResult.scanned,\n      removed: checkpointResult.removed.length,\n      retained: checkpointResult.retained.length,\n      retention_days: retentionDays,\n    };\n  }\n\n  warnings.push(\n    ...(await runActiveOnIndexHooks({\n      mode: dryRun ? \"gc:dry-run\" : \"gc\",\n      total_items: selectedTargets.length,\n    })),\n  );\n  const guidance = buildGcGuidance({\n    dryRun,\n    scopes,\n    removed,\n  });\n\n  return {\n    ok: warnings.length === 0,\n    dry_run: dryRun,\n    scope: scopes,\n    removed,\n    retained,\n    warnings,\n    ...(locksSummary ? { locks: locksSummary } : {}),\n    ...(checkpointsSummary ? { checkpoints: checkpointsSummary } : {}),\n    guidance,\n    generated_at: nowIso(),\n  };\n}\n", "/**\n * @module core/checkpoint/checkpoint-gc\n *\n * Age-based garbage collector for bulk-mutation rollback checkpoints written by\n * `update-many`/`close-many` under `checkpoints/<subdir>/<id>.json`.\n *\n * Safety-first policy (mirroring the stale-lock sweep in `lock/lock-gc.ts`): a\n * checkpoint whose JSON cannot be read or whose `created_at` cannot be parsed is\n * RETAINED rather than deleted. We only prune checkpoints whose age can be\n * conclusively determined from their own `created_at` field and that exceed the\n * configured `checkpoints.retention_days` policy.\n *\n * Staleness formula: (now_ms - Date.parse(created_at)) > retention_days * 86_400_000.\n * A zero/negative age (a future `created_at`) is always treated as active.\n */\n\nimport type { Dirent } from \"node:fs\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\n\nconst MILLISECONDS_PER_DAY = 86_400_000;\n\n/**\n * Documents the checkpoint gc scan entry payload exchanged by command, SDK, and package integrations.\n */\nexport interface CheckpointGcEntry {\n  /** Relative path like \"checkpoints/update-many/update-many-20260619-abc123.json\". */\n  file: string;\n  /** Parsed `created_at`, or null when missing/unparseable. */\n  created_at: string | null;\n  /** floor((now - created_at)/1000), null when unparseable. */\n  age_seconds: number | null;\n  /** True only when classified as expired (older than the retention window). */\n  stale: boolean;\n  reason: \"expired\" | \"active\" | \"unparseable\";\n}\n\n/**\n * Documents the checkpoint gc hooks payload exchanged by command, SDK, and package integrations.\n */\nexport interface CheckpointGcHooks {\n  onRead?: (checkpointPath: string) => Promise<string[]> | string[];\n  onWrite?: (checkpointPath: string) => Promise<string[]> | string[];\n}\n\n/**\n * Documents the checkpoint gc options payload exchanged by command, SDK, and package integrations.\n */\nexport interface CheckpointGcOptions {\n  dryRun: boolean;\n  /**\n   * Prune checkpoints older than this many days. Negative values are clamped to\n   * zero (prune everything aged); a non-finite value (NaN/Infinity) disables\n   * pruning entirely so bad input never deletes recoverable checkpoints.\n   */\n  retentionDays: number;\n  /** Epoch ms; defaults to Date.now() — injectable for deterministic tests. */\n  now?: number;\n  hooks?: CheckpointGcHooks;\n}\n\n/**\n * Documents the checkpoint gc result payload exchanged by command, SDK, and package integrations.\n */\nexport interface CheckpointGcResult {\n  /** Number of *.json checkpoint files examined. */\n  scanned: number;\n  /** Relative paths removed (or would-remove under dryRun), sorted by file name asc. */\n  removed: string[];\n  /** Relative paths retained (active OR unparseable — never delete what we can't reason about). */\n  retained: string[];\n  warnings: string[];\n  /** One per scanned checkpoint file, sorted by file name asc. */\n  entries: CheckpointGcEntry[];\n}\n\nfunction isErrno(error: unknown, code: string): boolean {\n  return (\n    typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: string }).code === code\n  );\n}\n\n/** Extract a parseable `created_at` from a checkpoint's raw JSON, or null. */\nfunction readCheckpointCreatedAt(raw: string): string | null {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(raw) as unknown;\n  } catch {\n    return null;\n  }\n  if (typeof parsed !== \"object\" || parsed === null || Array.isArray(parsed)) {\n    return null;\n  }\n  const createdAt = (parsed as Record<string, unknown>).created_at;\n  return typeof createdAt === \"string\" ? createdAt : null;\n}\n\n/**\n * Collect relative `checkpoints/<subdir>/<file>.json` (and top-level `<file>.json`)\n * paths under the checkpoints root. Subdirectory reads are resilient to\n * concurrent races: a subdir that vanishes between the parent `readdir` and its\n * own `readdir` (ENOENT) is skipped quietly, and any other read failure (e.g. a\n * permission error) is surfaced as a `checkpoint_subdir_unreadable:<name>`\n * warning rather than aborting the whole sweep.\n */\nasync function collectCheckpointFiles(checkpointsDir: string, warnings: string[]): Promise<string[]> {\n  let dirEntries: Dirent[];\n  try {\n    dirEntries = await fs.readdir(checkpointsDir, { withFileTypes: true });\n  } catch (error: unknown) {\n    if (isErrno(error, \"ENOENT\")) {\n      return [];\n    }\n    throw error;\n  }\n  const files: string[] = [];\n  for (const entry of dirEntries) {\n    if (entry.isDirectory()) {\n      const subdir = path.join(checkpointsDir, entry.name);\n      let nested: string[];\n      try {\n        nested = await fs.readdir(subdir);\n      } catch (error: unknown) {\n        if (!isErrno(error, \"ENOENT\")) {\n          warnings.push(`checkpoint_subdir_unreadable:${entry.name}`);\n        }\n        continue;\n      }\n      for (const file of nested) {\n        if (file.endsWith(\".json\")) {\n          files.push(`${entry.name}/${file}`);\n        }\n      }\n    } else if (entry.name.endsWith(\".json\")) {\n      files.push(entry.name);\n    }\n  }\n  return files.sort();\n}\n\n/**\n * Implements run checkpoint gc for the public runtime surface of this module.\n */\nexport async function runCheckpointGc(pmRoot: string, options: CheckpointGcOptions): Promise<CheckpointGcResult> {\n  const { dryRun, hooks } = options;\n  const nowMs = options.now ?? Date.now();\n  const retentionMs = Math.max(0, options.retentionDays) * MILLISECONDS_PER_DAY;\n  const checkpointsDir = path.join(pmRoot, \"checkpoints\");\n  // A non-finite retentionMs (NaN/Infinity from a non-finite retentionDays)\n  // makes every `ageMs > retentionMs` comparison false, so nothing is pruned —\n  // pruning is disabled rather than risking deletion under bad input.\n\n  const result: CheckpointGcResult = {\n    scanned: 0,\n    removed: [],\n    retained: [],\n    warnings: [],\n    entries: [],\n  };\n\n  const files = await collectCheckpointFiles(checkpointsDir, result.warnings);\n  for (const relName of files) {\n    const absPath = path.join(checkpointsDir, relName);\n    const relPath = `checkpoints/${relName}`;\n    result.scanned += 1;\n\n    if (hooks?.onRead) {\n      result.warnings.push(...(await hooks.onRead(absPath)));\n    }\n\n    let raw: string;\n    try {\n      raw = await fs.readFile(absPath, \"utf8\");\n    } catch (readError: unknown) {\n      if (isErrno(readError, \"ENOENT\")) {\n        // Disappeared between readdir and readFile — treat as a ghost; skip quietly.\n        result.scanned -= 1;\n        continue;\n      }\n      result.warnings.push(`checkpoint_unreadable:${relName}`);\n      result.retained.push(relPath);\n      result.entries.push({ file: relPath, created_at: null, age_seconds: null, stale: false, reason: \"unparseable\" });\n      continue;\n    }\n\n    const createdAt = readCheckpointCreatedAt(raw);\n    const createdAtMs = createdAt === null ? Number.NaN : Date.parse(createdAt);\n    if (!Number.isFinite(createdAtMs)) {\n      result.warnings.push(`checkpoint_unparseable:${relName}`);\n      result.retained.push(relPath);\n      result.entries.push({\n        file: relPath,\n        created_at: createdAt,\n        age_seconds: null,\n        stale: false,\n        reason: \"unparseable\",\n      });\n      continue;\n    }\n\n    const ageMs = nowMs - createdAtMs;\n    const entry: CheckpointGcEntry = {\n      file: relPath,\n      created_at: createdAt,\n      age_seconds: Math.floor(ageMs / 1000),\n      stale: ageMs > retentionMs,\n      reason: ageMs > retentionMs ? \"expired\" : \"active\",\n    };\n    if (!entry.stale) {\n      result.retained.push(relPath);\n      result.entries.push(entry);\n      continue;\n    }\n\n    if (!dryRun) {\n      try {\n        await fs.unlink(absPath);\n      } catch (unlinkError: unknown) {\n        if (!isErrno(unlinkError, \"ENOENT\")) {\n          result.warnings.push(`checkpoint_remove_failed:${relName}`);\n          result.retained.push(relPath);\n          result.entries.push(entry);\n          continue;\n        }\n        // ENOENT on unlink = already gone (race); treat as removed.\n      }\n      if (hooks?.onWrite) {\n        result.warnings.push(...(await hooks.onWrite(absPath)));\n      }\n    }\n    result.removed.push(relPath);\n    result.entries.push(entry);\n  }\n\n  return result;\n}\n"],
-  "mappings": "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",
-  "names": ["fs", "path", "isErrno", "path", "fs", "global"]
-}