@unbrained/pm-cli 2026.7.5 → 2026.7.7

package/dist/cli-bundle/chunks/stats-IJYTRQGV.js

@@ -1,250 +0,0 @@
-import {
-  computeContentFieldUtilization
-} from "./chunk-R23CSHGI.js";
-import {
-  computeMetadataCoverage,
-  groupItemsByDimension,
-  lifecycleClassifierFromStatusRegistry
-} from "./chunk-RX3HQSYG.js";
-import {
-  enforceHistoryStreamPolicyForItems,
-  listAllFrontMatterLight,
-  listAllFrontMatterWithBody
-} from "./chunk-3U3VEWK6.js";
-import "./chunk-EZFKWSC7.js";
-import {
-  nowIso
-} from "./chunk-DRBV5UC2.js";
-import {
-  PmCliError,
-  getActiveExtensionRegistrations,
-  readSettings,
-  runActiveOnReadHooks
-} from "./chunk-P5YORJRH.js";
-import "./chunk-7C2O74AE.js";
-import {
-  EXIT_CODE,
-  getSettingsPath,
-  pathExists,
-  resolveItemTypeRegistry,
-  resolvePmRoot,
-  resolveRuntimeStatusRegistry
-} from "./chunk-5VVUKE3U.js";
-
-// dist/cli/commands/stats.js
-import fs from "node:fs/promises";
-import path from "node:path";
-
-// dist/core/history/history-storage-stats.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] = "7c6dc357-0d9e-5ea3-add4-1c441f70d41c");
-  } catch (e2) {
-  }
-})();
-function parseStreamStat(id, raw) {
-  const bytes = Buffer.byteLength(raw, "utf8");
-  let lines = 0;
-  let oldestTs = null;
-  let newestTs = null;
-  let oldestMs = Number.POSITIVE_INFINITY;
-  let newestMs = Number.NEGATIVE_INFINITY;
-  for (const rawLine of raw.split(/\r?\n/)) {
-    const trimmed = rawLine.trim();
-    if (trimmed === "") {
-      continue;
-    }
-    lines += 1;
-    let parsed;
-    try {
-      parsed = JSON.parse(trimmed);
-    } catch {
-      continue;
-    }
-    if (parsed === null || typeof parsed !== "object" || !("ts" in parsed) || typeof parsed["ts"] !== "string") {
-      continue;
-    }
-    const ts = parsed["ts"];
-    const ms = Date.parse(ts);
-    if (Number.isNaN(ms)) {
-      continue;
-    }
-    if (ms < oldestMs || ms === oldestMs && oldestTs !== null && ts < oldestTs) {
-      oldestMs = ms;
-      oldestTs = ts;
-    }
-    if (ms > newestMs || ms === newestMs && newestTs !== null && ts > newestTs) {
-      newestMs = ms;
-      newestTs = ts;
-    }
-  }
-  return { id, bytes, lines, oldest_ts: oldestTs, newest_ts: newestTs };
-}
-function computeHistoryStorageStats(streams, options) {
-  const rawTopN = options?.topN ?? 5;
-  const topN = Math.max(0, Math.floor(rawTopN));
-  const stats = streams.map(({ id, raw }) => parseStreamStat(id, raw));
-  let totalLines = 0;
-  let totalBytes = 0;
-  let oldestEntry = null;
-  let newestEntry = null;
-  let globalOldestMs = Number.POSITIVE_INFINITY;
-  let globalNewestMs = Number.NEGATIVE_INFINITY;
-  for (const stat of stats) {
-    totalLines += stat.lines;
-    totalBytes += stat.bytes;
-    if (stat.oldest_ts !== null) {
-      const ms = Date.parse(stat.oldest_ts);
-      if (ms < globalOldestMs || ms === globalOldestMs && oldestEntry !== null && stat.id < oldestEntry.id) {
-        globalOldestMs = ms;
-        oldestEntry = { id: stat.id, ts: stat.oldest_ts };
-      }
-    }
-    if (stat.newest_ts !== null) {
-      const ms = Date.parse(stat.newest_ts);
-      if (ms > globalNewestMs || ms === globalNewestMs && newestEntry !== null && stat.id < newestEntry.id) {
-        globalNewestMs = ms;
-        newestEntry = { id: stat.id, ts: stat.newest_ts };
-      }
-    }
-  }
-  const largestByBytes = topN === 0 ? [] : [...stats].sort((a, b) => b.bytes - a.bytes || a.id.localeCompare(b.id)).slice(0, topN);
-  const deepestByLines = topN === 0 ? [] : [...stats].sort((a, b) => b.lines - a.lines || a.id.localeCompare(b.id)).slice(0, topN);
-  return {
-    total_streams: streams.length,
-    total_lines: totalLines,
-    total_bytes: totalBytes,
-    largest_by_bytes: largestByBytes,
-    deepest_by_lines: deepestByLines,
-    oldest_entry: oldestEntry,
-    newest_entry: newestEntry
-  };
-}
-
-// dist/cli/commands/stats.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] = "ecc1d6fc-2fa3-5989-8649-e86649220299");
-  } catch (e2) {
-  }
-})();
-function zeroByType(itemTypes) {
-  return itemTypes.reduce((acc, value) => {
-    acc[value] = 0;
-    return acc;
-  }, {});
-}
-function zeroByStatus(statuses) {
-  return statuses.reduce((acc, value) => {
-    acc[value] = 0;
-    return acc;
-  }, {});
-}
-function countNonEmptyLines(raw) {
-  if (raw.trim().length === 0) {
-    return 0;
-  }
-  return raw.split(/\r?\n/u).filter((line) => line.trim().length > 0).length;
-}
-function isNotFoundError(error) {
-  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
-}
-async function readHistoryStreamContents(pmRoot) {
-  const historyDir = path.join(pmRoot, "history");
-  if (!await pathExists(historyDir)) {
-    return [];
-  }
-  await runActiveOnReadHooks({
-    path: historyDir,
-    scope: "project"
-  });
-  const historyFiles = (await fs.readdir(historyDir)).filter((entry) => entry.endsWith(".jsonl")).sort((a, b) => a.localeCompare(b));
-  const streams = [];
-  for (const file of historyFiles) {
-    const historyPath = path.join(historyDir, file);
-    let raw;
-    try {
-      raw = await fs.readFile(historyPath, "utf8");
-    } catch (error) {
-      if (isNotFoundError(error)) {
-        continue;
-      }
-      throw error;
-    }
-    await runActiveOnReadHooks({
-      path: historyPath,
-      scope: "project"
-    });
-    streams.push({ id: file.slice(0, -".jsonl".length), raw });
-  }
-  return streams;
-}
-var _testOnly = {
-  zeroByType,
-  zeroByStatus,
-  countNonEmptyLines,
-  readHistoryStreamContents
-};
-async function runStats(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 typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
-  const items = options.fieldUtilization ? await listAllFrontMatterWithBody(pmRoot, settings.item_format, typeRegistry.type_to_folder, void 0, settings.schema) : await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, void 0, settings.schema);
-  await enforceHistoryStreamPolicyForItems({
-    pmRoot,
-    settings,
-    itemIds: items.map((item) => item.id),
-    commandLabel: "stats"
-  });
-  const byType = zeroByType(typeRegistry.types);
-  const byStatus = zeroByStatus(statusRegistry.definitions.map((definition) => definition.id));
-  for (const item of items) {
-    byType[item.type] += 1;
-    byStatus[item.status] += 1;
-  }
-  const streams = await readHistoryStreamContents(pmRoot);
-  let historyEntries = 0;
-  for (const stream of streams) {
-    historyEntries += countNonEmptyLines(stream.raw);
-  }
-  const storage = options.storage ? computeHistoryStorageStats(streams) : void 0;
-  const classifier = lifecycleClassifierFromStatusRegistry(statusRegistry);
-  const metadataCoverage = options.metadataCoverage ? computeMetadataCoverage(items, classifier) : void 0;
-  const breakdowns = {};
-  if (options.byAssignee) {
-    breakdowns.assignee = groupItemsByDimension(items, "assignee", classifier);
-  }
-  if (options.byTag) {
-    breakdowns.tag = groupItemsByDimension(items, "tag", classifier, { tagPrefix: options.tagPrefix });
-  }
-  if (options.byPriority) {
-    breakdowns.priority = groupItemsByDimension(items, "priority", classifier);
-  }
-  const hasBreakdowns = Object.keys(breakdowns).length > 0;
-  const fieldUtilization = options.fieldUtilization ? computeContentFieldUtilization(items) : void 0;
-  return {
-    totals: {
-      items: items.length,
-      history_streams: streams.length,
-      history_entries: historyEntries
-    },
-    by_type: byType,
-    by_status: byStatus,
-    ...metadataCoverage ? { metadata_coverage: metadataCoverage } : {},
-    ...hasBreakdowns ? { breakdowns } : {},
-    ...storage ? { storage } : {},
-    ...fieldUtilization ? { field_utilization: fieldUtilization } : {},
-    generated_at: nowIso()
-  };
-}
-export {
-  _testOnly,
-  runStats
-};
-//# sourceMappingURL=stats-IJYTRQGV.js.map

package/dist/cli-bundle/chunks/stats-IJYTRQGV.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../../../../../../cli/commands/stats.ts", "../../../../../../../../core/history/history-storage-stats.ts"],
-  "sourcesContent": ["/**\n * @module cli/commands/stats\n *\n * Implements the pm stats command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getActiveExtensionRegistrations, runActiveOnReadHooks } from \"../../core/extensions/index.js\";\nimport {\n  computeContentFieldUtilization,\n  type ContentFieldUtilizationReport,\n} from \"../../core/governance/content-fields.js\";\nimport {\n  computeMetadataCoverage,\n  groupItemsByDimension,\n  lifecycleClassifierFromStatusRegistry,\n  type GroupedBreakdown,\n  type MetadataCoverageReport,\n} from \"../../core/governance/metadata-coverage.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { enforceHistoryStreamPolicyForItems } from \"../../core/history/history-stream-policy.js\";\nimport { computeHistoryStorageStats, type HistoryStorageStats } from \"../../core/history/history-storage-stats.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry } from \"../../core/schema/runtime-schema.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 { listAllFrontMatterLight, listAllFrontMatterWithBody } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemStatus, ItemType } from \"../../types/index.js\";\n\n/**\n * Documents the stats command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface StatsCommandOptions {\n  /** Include aggregate per-stream history storage metrics (sizes, depth, oldest/newest). */\n  storage?: boolean;\n  /** Include metadata coverage percentages (AC, estimates, resolution, tags, parent) overall and by type. */\n  metadataCoverage?: boolean;\n  /** Include a lifecycle-bucketed breakdown grouped by assignee. */\n  byAssignee?: boolean;\n  /** Include a lifecycle-bucketed breakdown grouped by tag (optionally filtered by --tag-prefix). */\n  byTag?: boolean;\n  /** Include a lifecycle-bucketed breakdown grouped by priority. */\n  byPriority?: boolean;\n  /** With --by-tag: only consider tags starting with this prefix (e.g. \"domain:\"). */\n  tagPrefix?: string;\n  /** Include a content-field utilization breakdown (notes/learnings/files/docs/tests/comments/deps/body usage rates). */\n  fieldUtilization?: boolean;\n}\n\n/**\n * Documents the stats result payload exchanged by command, SDK, and package integrations.\n */\nexport interface StatsResult {\n  totals: {\n    items: number;\n    history_streams: number;\n    history_entries: number;\n  };\n  by_type: Record<ItemType, number>;\n  by_status: Record<ItemStatus, number>;\n  /** Present only with --metadata-coverage: per-field coverage overall and by type. */\n  metadata_coverage?: MetadataCoverageReport;\n  /** Present only with --by-assignee/--by-tag/--by-priority: lifecycle-bucketed group breakdowns. */\n  breakdowns?: {\n    assignee?: GroupedBreakdown;\n    tag?: GroupedBreakdown;\n    priority?: GroupedBreakdown;\n  };\n  /** Present only with --storage: aggregate history-stream metrics for compaction/planning. */\n  storage?: HistoryStorageStats;\n  /** Present only with --field-utilization: content-field utilization rates across all items. */\n  field_utilization?: ContentFieldUtilizationReport;\n  generated_at: string;\n}\n\nfunction zeroByType(itemTypes: string[]): Record<ItemType, number> {\n  return itemTypes.reduce(\n    (acc, value) => {\n      acc[value] = 0;\n      return acc;\n    },\n    {} as Record<ItemType, number>,\n  );\n}\n\nfunction zeroByStatus(statuses: string[]): Record<ItemStatus, number> {\n  return statuses.reduce(\n    (acc, value) => {\n      acc[value] = 0;\n      return acc;\n    },\n    {} as Record<ItemStatus, number>,\n  );\n}\n\nfunction countNonEmptyLines(raw: string): number {\n  if (raw.trim().length === 0) {\n    return 0;\n  }\n  return raw\n    .split(/\\r?\\n/u)\n    .filter((line) => line.trim().length > 0)\n    .length;\n}\n\nfunction isNotFoundError(error: unknown): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: unknown }).code === \"ENOENT\";\n}\n\nasync function readHistoryStreamContents(pmRoot: string): Promise<Array<{ id: string; raw: string }>> {\n  const historyDir = path.join(pmRoot, \"history\");\n  if (!(await pathExists(historyDir))) {\n    return [];\n  }\n\n  await runActiveOnReadHooks({\n    path: historyDir,\n    scope: \"project\",\n  });\n  const historyFiles = (await fs.readdir(historyDir))\n    .filter((entry) => entry.endsWith(\".jsonl\"))\n    .sort((a, b) => a.localeCompare(b));\n\n  const streams: Array<{ id: string; raw: string }> = [];\n  for (const file of historyFiles) {\n    const historyPath = path.join(historyDir, file);\n    let raw: string;\n    try {\n      raw = await fs.readFile(historyPath, \"utf8\");\n    } catch (error) {\n      if (isNotFoundError(error)) {\n        continue;\n      }\n      throw error;\n    }\n    await runActiveOnReadHooks({\n      path: historyPath,\n      scope: \"project\",\n    });\n    streams.push({ id: file.slice(0, -\".jsonl\".length), raw });\n  }\n\n  return streams;\n}\n\nexport const _testOnly = {\n  zeroByType,\n  zeroByStatus,\n  countNonEmptyLines,\n  readHistoryStreamContents,\n};\n\n/**\n * Implements run stats for the public runtime surface of this module.\n */\nexport async function runStats(global: GlobalOptions, options: StatsCommandOptions = {}): Promise<StatsResult> {\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 statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  // Field utilization needs the heavy collections (notes/learnings/files/docs/\n  // tests/comments/deps) AND the body, which the light reader drops — so when it\n  // is requested we read the WithBody rows and use them for every section.\n  const items = options.fieldUtilization\n    ? await listAllFrontMatterWithBody(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema)\n    : await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);\n  await enforceHistoryStreamPolicyForItems({\n    pmRoot,\n    settings,\n    itemIds: items.map((item) => item.id),\n    commandLabel: \"stats\",\n  });\n\n  const byType = zeroByType(typeRegistry.types);\n  const byStatus = zeroByStatus(statusRegistry.definitions.map((definition) => definition.id));\n  // zeroByType/zeroByStatus pre-seed a bucket for every registry type/status, and\n  // the light front-matter reader drops any item whose type/status falls outside\n  // the active registry (parse rejects them) — so every item's bucket is already\n  // present here and no on-the-fly initialization is reachable.\n  for (const item of items) {\n    byType[item.type] += 1;\n    byStatus[item.status] += 1;\n  }\n\n  const streams = await readHistoryStreamContents(pmRoot);\n  let historyEntries = 0;\n  for (const stream of streams) {\n    historyEntries += countNonEmptyLines(stream.raw);\n  }\n  const storage = options.storage ? computeHistoryStorageStats(streams) : undefined;\n\n  const classifier = lifecycleClassifierFromStatusRegistry(statusRegistry);\n  const metadataCoverage = options.metadataCoverage ? computeMetadataCoverage(items, classifier) : undefined;\n  const breakdowns: NonNullable<StatsResult[\"breakdowns\"]> = {};\n  if (options.byAssignee) {\n    breakdowns.assignee = groupItemsByDimension(items, \"assignee\", classifier);\n  }\n  if (options.byTag) {\n    breakdowns.tag = groupItemsByDimension(items, \"tag\", classifier, { tagPrefix: options.tagPrefix });\n  }\n  if (options.byPriority) {\n    breakdowns.priority = groupItemsByDimension(items, \"priority\", classifier);\n  }\n  const hasBreakdowns = Object.keys(breakdowns).length > 0;\n  const fieldUtilization = options.fieldUtilization ? computeContentFieldUtilization(items) : undefined;\n\n  return {\n    totals: {\n      items: items.length,\n      history_streams: streams.length,\n      history_entries: historyEntries,\n    },\n    by_type: byType,\n    by_status: byStatus,\n    ...(metadataCoverage ? { metadata_coverage: metadataCoverage } : {}),\n    ...(hasBreakdowns ? { breakdowns } : {}),\n    ...(storage ? { storage } : {}),\n    ...(fieldUtilization ? { field_utilization: fieldUtilization } : {}),\n    generated_at: nowIso(),\n  };\n}\n", "/**\n * Pure aggregate metrics for history streams (JSONL files).\n * No filesystem access — callers read raw stream contents and pass them in.\n * This module has no Node imports; Buffer is available as a global.\n */\n\n/** Per-history-stream size and timestamp summary used by storage diagnostics. */\nexport interface HistoryStreamStat {\n  id: string;\n  bytes: number;\n  lines: number; // non-empty JSONL entry count\n  oldest_ts: string | null; // min parseable ts in this stream, else null\n  newest_ts: string | null; // max parseable ts in this stream, else null\n}\n\n/**\n * Documents the history storage entry ref payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryStorageEntryRef {\n  id: string;\n  ts: string;\n}\n\n/**\n * Documents the history storage stats payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryStorageStats {\n  total_streams: number;\n  total_lines: number;\n  total_bytes: number;\n  largest_by_bytes: HistoryStreamStat[]; // top-N desc by bytes, tie-break id asc\n  deepest_by_lines: HistoryStreamStat[]; // top-N desc by lines, tie-break id asc\n  oldest_entry: HistoryStorageEntryRef | null; // global min ts across all streams\n  newest_entry: HistoryStorageEntryRef | null; // global max ts across all streams\n}\n\nfunction parseStreamStat(id: string, raw: string): HistoryStreamStat {\n  const bytes = Buffer.byteLength(raw, \"utf8\");\n\n  let lines = 0;\n  let oldestTs: string | null = null;\n  let newestTs: string | null = null;\n  let oldestMs = Number.POSITIVE_INFINITY;\n  let newestMs = Number.NEGATIVE_INFINITY;\n\n  for (const rawLine of raw.split(/\\r?\\n/)) {\n    const trimmed = rawLine.trim();\n    if (trimmed === \"\") {\n      continue;\n    }\n    lines += 1;\n\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(trimmed);\n    } catch {\n      continue;\n    }\n\n    if (\n      parsed === null ||\n      typeof parsed !== \"object\" ||\n      !(\"ts\" in (parsed as object)) ||\n      typeof (parsed as Record<string, unknown>)[\"ts\"] !== \"string\"\n    ) {\n      continue;\n    }\n\n    const ts = (parsed as Record<string, unknown>)[\"ts\"] as string;\n    const ms = Date.parse(ts);\n    if (Number.isNaN(ms)) {\n      continue;\n    }\n\n    if (ms < oldestMs || (ms === oldestMs && oldestTs !== null && ts < oldestTs)) {\n      oldestMs = ms;\n      oldestTs = ts;\n    }\n    if (ms > newestMs || (ms === newestMs && newestTs !== null && ts > newestTs)) {\n      newestMs = ms;\n      newestTs = ts;\n    }\n  }\n\n  return { id, bytes, lines, oldest_ts: oldestTs, newest_ts: newestTs };\n}\n\n/**\n * Implements compute history storage stats for the public runtime surface of this module.\n */\nexport function computeHistoryStorageStats(\n  streams: Array<{ id: string; raw: string }>,\n  options?: { topN?: number },\n): HistoryStorageStats {\n  const rawTopN = options?.topN ?? 5;\n  const topN = Math.max(0, Math.floor(rawTopN));\n\n  const stats: HistoryStreamStat[] = streams.map(({ id, raw }) => parseStreamStat(id, raw));\n\n  let totalLines = 0;\n  let totalBytes = 0;\n  let oldestEntry: HistoryStorageEntryRef | null = null;\n  let newestEntry: HistoryStorageEntryRef | null = null;\n  let globalOldestMs = Number.POSITIVE_INFINITY;\n  let globalNewestMs = Number.NEGATIVE_INFINITY;\n\n  for (const stat of stats) {\n    totalLines += stat.lines;\n    totalBytes += stat.bytes;\n\n    if (stat.oldest_ts !== null) {\n      const ms = Date.parse(stat.oldest_ts);\n      if (\n        ms < globalOldestMs ||\n        (ms === globalOldestMs && oldestEntry !== null && stat.id < oldestEntry.id)\n      ) {\n        globalOldestMs = ms;\n        oldestEntry = { id: stat.id, ts: stat.oldest_ts };\n      }\n    }\n\n    if (stat.newest_ts !== null) {\n      const ms = Date.parse(stat.newest_ts);\n      if (\n        ms > globalNewestMs ||\n        (ms === globalNewestMs && newestEntry !== null && stat.id < newestEntry.id)\n      ) {\n        globalNewestMs = ms;\n        newestEntry = { id: stat.id, ts: stat.newest_ts };\n      }\n    }\n  }\n\n  const largestByBytes =\n    topN === 0\n      ? []\n      : [...stats]\n          .sort((a, b) => b.bytes - a.bytes || a.id.localeCompare(b.id))\n          .slice(0, topN);\n\n  const deepestByLines =\n    topN === 0\n      ? []\n      : [...stats]\n          .sort((a, b) => b.lines - a.lines || a.id.localeCompare(b.id))\n          .slice(0, topN);\n\n  return {\n    total_streams: streams.length,\n    total_lines: totalLines,\n    total_bytes: totalBytes,\n    largest_by_bytes: largestByBytes,\n    deepest_by_lines: deepestByLines,\n    oldest_entry: oldestEntry,\n    newest_entry: newestEntry,\n  };\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKA,OAAO,QAAQ;AACf,OAAO,UAAU;;;;;;;;;;AC8BjB,SAAS,gBAAgB,IAAY,KAAW;AAC9C,QAAM,QAAQ,OAAO,WAAW,KAAK,MAAM;AAE3C,MAAI,QAAQ;AACZ,MAAI,WAA0B;AAC9B,MAAI,WAA0B;AAC9B,MAAI,WAAW,OAAO;AACtB,MAAI,WAAW,OAAO;AAEtB,aAAW,WAAW,IAAI,MAAM,OAAO,GAAG;AACxC,UAAM,UAAU,QAAQ,KAAI;AAC5B,QAAI,YAAY,IAAI;AAClB;IACF;AACA,aAAS;AAET,QAAI;AACJ,QAAI;AACF,eAAS,KAAK,MAAM,OAAO;IAC7B,QAAQ;AACN;IACF;AAEA,QACE,WAAW,QACX,OAAO,WAAW,YAClB,EAAE,QAAS,WACX,OAAQ,OAAmC,IAAI,MAAM,UACrD;AACA;IACF;AAEA,UAAM,KAAM,OAAmC,IAAI;AACnD,UAAM,KAAK,KAAK,MAAM,EAAE;AACxB,QAAI,OAAO,MAAM,EAAE,GAAG;AACpB;IACF;AAEA,QAAI,KAAK,YAAa,OAAO,YAAY,aAAa,QAAQ,KAAK,UAAW;AAC5E,iBAAW;AACX,iBAAW;IACb;AACA,QAAI,KAAK,YAAa,OAAO,YAAY,aAAa,QAAQ,KAAK,UAAW;AAC5E,iBAAW;AACX,iBAAW;IACb;EACF;AAEA,SAAO,EAAE,IAAI,OAAO,OAAO,WAAW,UAAU,WAAW,SAAQ;AACrE;AAKM,SAAU,2BACd,SACA,SAA2B;AAE3B,QAAM,UAAU,SAAS,QAAQ;AACjC,QAAM,OAAO,KAAK,IAAI,GAAG,KAAK,MAAM,OAAO,CAAC;AAE5C,QAAM,QAA6B,QAAQ,IAAI,CAAC,EAAE,IAAI,IAAG,MAAO,gBAAgB,IAAI,GAAG,CAAC;AAExF,MAAI,aAAa;AACjB,MAAI,aAAa;AACjB,MAAI,cAA6C;AACjD,MAAI,cAA6C;AACjD,MAAI,iBAAiB,OAAO;AAC5B,MAAI,iBAAiB,OAAO;AAE5B,aAAW,QAAQ,OAAO;AACxB,kBAAc,KAAK;AACnB,kBAAc,KAAK;AAEnB,QAAI,KAAK,cAAc,MAAM;AAC3B,YAAM,KAAK,KAAK,MAAM,KAAK,SAAS;AACpC,UACE,KAAK,kBACJ,OAAO,kBAAkB,gBAAgB,QAAQ,KAAK,KAAK,YAAY,IACxE;AACA,yBAAiB;AACjB,sBAAc,EAAE,IAAI,KAAK,IAAI,IAAI,KAAK,UAAS;MACjD;IACF;AAEA,QAAI,KAAK,cAAc,MAAM;AAC3B,YAAM,KAAK,KAAK,MAAM,KAAK,SAAS;AACpC,UACE,KAAK,kBACJ,OAAO,kBAAkB,gBAAgB,QAAQ,KAAK,KAAK,YAAY,IACxE;AACA,yBAAiB;AACjB,sBAAc,EAAE,IAAI,KAAK,IAAI,IAAI,KAAK,UAAS;MACjD;IACF;EACF;AAEA,QAAM,iBACJ,SAAS,IACL,CAAA,IACA,CAAC,GAAG,KAAK,EACN,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC,EAC5D,MAAM,GAAG,IAAI;AAEtB,QAAM,iBACJ,SAAS,IACL,CAAA,IACA,CAAC,GAAG,KAAK,EACN,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC,EAC5D,MAAM,GAAG,IAAI;AAEtB,SAAO;IACL,eAAe,QAAQ;IACvB,aAAa;IACb,aAAa;IACb,kBAAkB;IAClB,kBAAkB;IAClB,cAAc;IACd,cAAc;;AAElB;;;;;;;;;;AD7EA,SAAS,WAAW,WAAmB;AACrC,SAAO,UAAU,OACf,CAAC,KAAK,UAAS;AACb,QAAI,KAAK,IAAI;AACb,WAAO;EACT,GACA,CAAA,CAA8B;AAElC;AAEA,SAAS,aAAa,UAAkB;AACtC,SAAO,SAAS,OACd,CAAC,KAAK,UAAS;AACb,QAAI,KAAK,IAAI;AACb,WAAO;EACT,GACA,CAAA,CAAgC;AAEpC;AAEA,SAAS,mBAAmB,KAAW;AACrC,MAAI,IAAI,KAAI,EAAG,WAAW,GAAG;AAC3B,WAAO;EACT;AACA,SAAO,IACJ,MAAM,QAAQ,EACd,OAAO,CAAC,SAAS,KAAK,KAAI,EAAG,SAAS,CAAC,EACvC;AACL;AAEA,SAAS,gBAAgB,OAAc;AACrC,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,UAAU,SAAU,MAA6B,SAAS;AAClH;AAEA,eAAe,0BAA0B,QAAc;AACrD,QAAM,aAAa,KAAK,KAAK,QAAQ,SAAS;AAC9C,MAAI,CAAE,MAAM,WAAW,UAAU,GAAI;AACnC,WAAO,CAAA;EACT;AAEA,QAAM,qBAAqB;IACzB,MAAM;IACN,OAAO;GACR;AACD,QAAM,gBAAgB,MAAM,GAAG,QAAQ,UAAU,GAC9C,OAAO,CAAC,UAAU,MAAM,SAAS,QAAQ,CAAC,EAC1C,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAEpC,QAAM,UAA8C,CAAA;AACpD,aAAW,QAAQ,cAAc;AAC/B,UAAM,cAAc,KAAK,KAAK,YAAY,IAAI;AAC9C,QAAI;AACJ,QAAI;AACF,YAAM,MAAM,GAAG,SAAS,aAAa,MAAM;IAC7C,SAAS,OAAO;AACd,UAAI,gBAAgB,KAAK,GAAG;AAC1B;MACF;AACA,YAAM;IACR;AACA,UAAM,qBAAqB;MACzB,MAAM;MACN,OAAO;KACR;AACD,YAAQ,KAAK,EAAE,IAAI,KAAK,MAAM,GAAG,CAAC,SAAS,MAAM,GAAG,IAAG,CAAE;EAC3D;AAEA,SAAO;AACT;AAEO,IAAM,YAAY;EACvB;EACA;EACA;EACA;;AAMF,eAAsB,SAASA,SAAuB,UAA+B,CAAA,GAAE;AACrF,QAAM,SAAS,cAAc,QAAQ,IAAG,GAAIA,QAAO,IAAI;AACvD,MAAI,CAAE,MAAM,WAAW,gBAAgB,MAAM,CAAC,GAAI;AAChD,UAAM,IAAI,WAAW,iCAAiC,MAAM,wBAAwB,UAAU,SAAS;EACzG;AAEA,QAAM,WAAW,MAAM,aAAa,MAAM;AAC1C,QAAM,eAAe,wBAAwB,UAAU,gCAA+B,CAAE;AACxF,QAAM,iBAAiB,6BAA6B,SAAS,MAAM;AAInE,QAAM,QAAQ,QAAQ,mBAClB,MAAM,2BAA2B,QAAQ,SAAS,aAAa,aAAa,gBAAgB,QAAW,SAAS,MAAM,IACtH,MAAM,wBAAwB,QAAQ,SAAS,aAAa,aAAa,gBAAgB,QAAW,SAAS,MAAM;AACvH,QAAM,mCAAmC;IACvC;IACA;IACA,SAAS,MAAM,IAAI,CAAC,SAAS,KAAK,EAAE;IACpC,cAAc;GACf;AAED,QAAM,SAAS,WAAW,aAAa,KAAK;AAC5C,QAAM,WAAW,aAAa,eAAe,YAAY,IAAI,CAAC,eAAe,WAAW,EAAE,CAAC;AAK3F,aAAW,QAAQ,OAAO;AACxB,WAAO,KAAK,IAAI,KAAK;AACrB,aAAS,KAAK,MAAM,KAAK;EAC3B;AAEA,QAAM,UAAU,MAAM,0BAA0B,MAAM;AACtD,MAAI,iBAAiB;AACrB,aAAW,UAAU,SAAS;AAC5B,sBAAkB,mBAAmB,OAAO,GAAG;EACjD;AACA,QAAM,UAAU,QAAQ,UAAU,2BAA2B,OAAO,IAAI;AAExE,QAAM,aAAa,sCAAsC,cAAc;AACvE,QAAM,mBAAmB,QAAQ,mBAAmB,wBAAwB,OAAO,UAAU,IAAI;AACjG,QAAM,aAAqD,CAAA;AAC3D,MAAI,QAAQ,YAAY;AACtB,eAAW,WAAW,sBAAsB,OAAO,YAAY,UAAU;EAC3E;AACA,MAAI,QAAQ,OAAO;AACjB,eAAW,MAAM,sBAAsB,OAAO,OAAO,YAAY,EAAE,WAAW,QAAQ,UAAS,CAAE;EACnG;AACA,MAAI,QAAQ,YAAY;AACtB,eAAW,WAAW,sBAAsB,OAAO,YAAY,UAAU;EAC3E;AACA,QAAM,gBAAgB,OAAO,KAAK,UAAU,EAAE,SAAS;AACvD,QAAM,mBAAmB,QAAQ,mBAAmB,+BAA+B,KAAK,IAAI;AAE5F,SAAO;IACL,QAAQ;MACN,OAAO,MAAM;MACb,iBAAiB,QAAQ;MACzB,iBAAiB;;IAEnB,SAAS;IACT,WAAW;IACX,GAAI,mBAAmB,EAAE,mBAAmB,iBAAgB,IAAK,CAAA;IACjE,GAAI,gBAAgB,EAAE,WAAU,IAAK,CAAA;IACrC,GAAI,UAAU,EAAE,QAAO,IAAK,CAAA;IAC5B,GAAI,mBAAmB,EAAE,mBAAmB,iBAAgB,IAAK,CAAA;IACjE,cAAc,OAAM;;AAExB;",
-  "names": ["global"]
-}

package/dist/cli-bundle/chunks/stats-L2D5Y2O5.js

@@ -1,240 +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]="fb69c821-7bb6-5b15-8cd2-319f496f077e")}catch(e){}}();
-import {
-  computeContentFieldUtilization
-} from "./chunk-QB7XMHJW.js";
-import {
-  computeMetadataCoverage,
-  groupItemsByDimension,
-  lifecycleClassifierFromStatusRegistry
-} from "./chunk-5JE6SMYS.js";
-import {
-  enforceHistoryStreamPolicyForItems,
-  listAllFrontMatterLight,
-  listAllFrontMatterWithBody
-} from "./chunk-57C2RLW5.js";
-import "./chunk-HK72NWAD.js";
-import {
-  nowIso
-} from "./chunk-FJRKQREY.js";
-import {
-  PmCliError,
-  getActiveExtensionRegistrations,
-  readSettings,
-  runActiveOnReadHooks
-} from "./chunk-US3T3W5J.js";
-import "./chunk-NNHHXJB2.js";
-import {
-  EXIT_CODE,
-  getSettingsPath,
-  pathExists,
-  resolveItemTypeRegistry,
-  resolvePmRoot,
-  resolveRuntimeStatusRegistry
-} from "./chunk-YD5FML7K.js";
-
-// dist/cli/commands/stats.js
-import fs from "node:fs/promises";
-import path from "node:path";
-
-// dist/core/history/history-storage-stats.js
-function parseStreamStat(id, raw) {
-  const bytes = Buffer.byteLength(raw, "utf8");
-  let lines = 0;
-  let oldestTs = null;
-  let newestTs = null;
-  let oldestMs = Number.POSITIVE_INFINITY;
-  let newestMs = Number.NEGATIVE_INFINITY;
-  for (const rawLine of raw.split(/\r?\n/)) {
-    const trimmed = rawLine.trim();
-    if (trimmed === "") {
-      continue;
-    }
-    lines += 1;
-    let parsed;
-    try {
-      parsed = JSON.parse(trimmed);
-    } catch {
-      continue;
-    }
-    if (parsed === null || typeof parsed !== "object" || !("ts" in parsed) || typeof parsed["ts"] !== "string") {
-      continue;
-    }
-    const ts = parsed["ts"];
-    const ms = Date.parse(ts);
-    if (Number.isNaN(ms)) {
-      continue;
-    }
-    if (ms < oldestMs || ms === oldestMs && oldestTs !== null && ts < oldestTs) {
-      oldestMs = ms;
-      oldestTs = ts;
-    }
-    if (ms > newestMs || ms === newestMs && newestTs !== null && ts > newestTs) {
-      newestMs = ms;
-      newestTs = ts;
-    }
-  }
-  return { id, bytes, lines, oldest_ts: oldestTs, newest_ts: newestTs };
-}
-function computeHistoryStorageStats(streams, options) {
-  const rawTopN = options?.topN ?? 5;
-  const topN = Math.max(0, Math.floor(rawTopN));
-  const stats = streams.map(({ id, raw }) => parseStreamStat(id, raw));
-  let totalLines = 0;
-  let totalBytes = 0;
-  let oldestEntry = null;
-  let newestEntry = null;
-  let globalOldestMs = Number.POSITIVE_INFINITY;
-  let globalNewestMs = Number.NEGATIVE_INFINITY;
-  for (const stat of stats) {
-    totalLines += stat.lines;
-    totalBytes += stat.bytes;
-    if (stat.oldest_ts !== null) {
-      const ms = Date.parse(stat.oldest_ts);
-      if (ms < globalOldestMs || ms === globalOldestMs && oldestEntry !== null && stat.id < oldestEntry.id) {
-        globalOldestMs = ms;
-        oldestEntry = { id: stat.id, ts: stat.oldest_ts };
-      }
-    }
-    if (stat.newest_ts !== null) {
-      const ms = Date.parse(stat.newest_ts);
-      if (ms > globalNewestMs || ms === globalNewestMs && newestEntry !== null && stat.id < newestEntry.id) {
-        globalNewestMs = ms;
-        newestEntry = { id: stat.id, ts: stat.newest_ts };
-      }
-    }
-  }
-  const largestByBytes = topN === 0 ? [] : [...stats].sort((a, b) => b.bytes - a.bytes || a.id.localeCompare(b.id)).slice(0, topN);
-  const deepestByLines = topN === 0 ? [] : [...stats].sort((a, b) => b.lines - a.lines || a.id.localeCompare(b.id)).slice(0, topN);
-  return {
-    total_streams: streams.length,
-    total_lines: totalLines,
-    total_bytes: totalBytes,
-    largest_by_bytes: largestByBytes,
-    deepest_by_lines: deepestByLines,
-    oldest_entry: oldestEntry,
-    newest_entry: newestEntry
-  };
-}
-
-// dist/cli/commands/stats.js
-function zeroByType(itemTypes) {
-  return itemTypes.reduce((acc, value) => {
-    acc[value] = 0;
-    return acc;
-  }, {});
-}
-function zeroByStatus(statuses) {
-  return statuses.reduce((acc, value) => {
-    acc[value] = 0;
-    return acc;
-  }, {});
-}
-function countNonEmptyLines(raw) {
-  if (raw.trim().length === 0) {
-    return 0;
-  }
-  return raw.split(/\r?\n/u).filter((line) => line.trim().length > 0).length;
-}
-function isNotFoundError(error) {
-  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
-}
-async function readHistoryStreamContents(pmRoot) {
-  const historyDir = path.join(pmRoot, "history");
-  if (!await pathExists(historyDir)) {
-    return [];
-  }
-  await runActiveOnReadHooks({
-    path: historyDir,
-    scope: "project"
-  });
-  const historyFiles = (await fs.readdir(historyDir)).filter((entry) => entry.endsWith(".jsonl")).sort((a, b) => a.localeCompare(b));
-  const streams = [];
-  for (const file of historyFiles) {
-    const historyPath = path.join(historyDir, file);
-    let raw;
-    try {
-      raw = await fs.readFile(historyPath, "utf8");
-    } catch (error) {
-      if (isNotFoundError(error)) {
-        continue;
-      }
-      throw error;
-    }
-    await runActiveOnReadHooks({
-      path: historyPath,
-      scope: "project"
-    });
-    streams.push({ id: file.slice(0, -".jsonl".length), raw });
-  }
-  return streams;
-}
-var _testOnly = {
-  zeroByType,
-  zeroByStatus,
-  countNonEmptyLines,
-  readHistoryStreamContents
-};
-async function runStats(global, options = {}) {
-  const pmRoot = resolvePmRoot(process.cwd(), global.path);
-  if (!await pathExists(getSettingsPath(pmRoot))) {
-    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
-  }
-  const settings = await readSettings(pmRoot);
-  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
-  const items = options.fieldUtilization ? await listAllFrontMatterWithBody(pmRoot, settings.item_format, typeRegistry.type_to_folder, void 0, settings.schema) : await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, void 0, settings.schema);
-  await enforceHistoryStreamPolicyForItems({
-    pmRoot,
-    settings,
-    itemIds: items.map((item) => item.id),
-    commandLabel: "stats"
-  });
-  const byType = zeroByType(typeRegistry.types);
-  const byStatus = zeroByStatus(statusRegistry.definitions.map((definition) => definition.id));
-  for (const item of items) {
-    byType[item.type] += 1;
-    byStatus[item.status] += 1;
-  }
-  const streams = await readHistoryStreamContents(pmRoot);
-  let historyEntries = 0;
-  for (const stream of streams) {
-    historyEntries += countNonEmptyLines(stream.raw);
-  }
-  const storage = options.storage ? computeHistoryStorageStats(streams) : void 0;
-  const classifier = lifecycleClassifierFromStatusRegistry(statusRegistry);
-  const metadataCoverage = options.metadataCoverage ? computeMetadataCoverage(items, classifier) : void 0;
-  const breakdowns = {};
-  if (options.byAssignee) {
-    breakdowns.assignee = groupItemsByDimension(items, "assignee", classifier);
-  }
-  if (options.byTag) {
-    breakdowns.tag = groupItemsByDimension(items, "tag", classifier, { tagPrefix: options.tagPrefix });
-  }
-  if (options.byPriority) {
-    breakdowns.priority = groupItemsByDimension(items, "priority", classifier);
-  }
-  const hasBreakdowns = Object.keys(breakdowns).length > 0;
-  const fieldUtilization = options.fieldUtilization ? computeContentFieldUtilization(items) : void 0;
-  return {
-    totals: {
-      items: items.length,
-      history_streams: streams.length,
-      history_entries: historyEntries
-    },
-    by_type: byType,
-    by_status: byStatus,
-    ...metadataCoverage ? { metadata_coverage: metadataCoverage } : {},
-    ...hasBreakdowns ? { breakdowns } : {},
-    ...storage ? { storage } : {},
-    ...fieldUtilization ? { field_utilization: fieldUtilization } : {},
-    generated_at: nowIso()
-  };
-}
-export {
-  _testOnly,
-  runStats
-};
-//# sourceMappingURL=stats-L2D5Y2O5.js.map
-
-//# debugId=fb69c821-7bb6-5b15-8cd2-319f496f077e

package/dist/cli-bundle/chunks/stats-L2D5Y2O5.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../cli/commands/stats.ts","../../../../../../../../core/history/history-storage-stats.ts"],"sourcesContent":["/**\n * @module cli/commands/stats\n *\n * Implements the pm stats command surface and its agent-facing runtime behavior.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { getActiveExtensionRegistrations, runActiveOnReadHooks } from \"../../core/extensions/index.js\";\nimport {\n  computeContentFieldUtilization,\n  type ContentFieldUtilizationReport,\n} from \"../../core/governance/content-fields.js\";\nimport {\n  computeMetadataCoverage,\n  groupItemsByDimension,\n  lifecycleClassifierFromStatusRegistry,\n  type GroupedBreakdown,\n  type MetadataCoverageReport,\n} from \"../../core/governance/metadata-coverage.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { enforceHistoryStreamPolicyForItems } from \"../../core/history/history-stream-policy.js\";\nimport { computeHistoryStorageStats, type HistoryStorageStats } from \"../../core/history/history-storage-stats.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { resolveRuntimeStatusRegistry } from \"../../core/schema/runtime-schema.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 { listAllFrontMatterLight, listAllFrontMatterWithBody } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { ItemStatus, ItemType } from \"../../types/index.js\";\n\n/**\n * Documents the stats command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface StatsCommandOptions {\n  /** Include aggregate per-stream history storage metrics (sizes, depth, oldest/newest). */\n  storage?: boolean;\n  /** Include metadata coverage percentages (AC, estimates, resolution, tags, parent) overall and by type. */\n  metadataCoverage?: boolean;\n  /** Include a lifecycle-bucketed breakdown grouped by assignee. */\n  byAssignee?: boolean;\n  /** Include a lifecycle-bucketed breakdown grouped by tag (optionally filtered by --tag-prefix). */\n  byTag?: boolean;\n  /** Include a lifecycle-bucketed breakdown grouped by priority. */\n  byPriority?: boolean;\n  /** With --by-tag: only consider tags starting with this prefix (e.g. \"domain:\"). */\n  tagPrefix?: string;\n  /** Include a content-field utilization breakdown (notes/learnings/files/docs/tests/comments/deps/body usage rates). */\n  fieldUtilization?: boolean;\n}\n\n/**\n * Documents the stats result payload exchanged by command, SDK, and package integrations.\n */\nexport interface StatsResult {\n  totals: {\n    items: number;\n    history_streams: number;\n    history_entries: number;\n  };\n  by_type: Record<ItemType, number>;\n  by_status: Record<ItemStatus, number>;\n  /** Present only with --metadata-coverage: per-field coverage overall and by type. */\n  metadata_coverage?: MetadataCoverageReport;\n  /** Present only with --by-assignee/--by-tag/--by-priority: lifecycle-bucketed group breakdowns. */\n  breakdowns?: {\n    assignee?: GroupedBreakdown;\n    tag?: GroupedBreakdown;\n    priority?: GroupedBreakdown;\n  };\n  /** Present only with --storage: aggregate history-stream metrics for compaction/planning. */\n  storage?: HistoryStorageStats;\n  /** Present only with --field-utilization: content-field utilization rates across all items. */\n  field_utilization?: ContentFieldUtilizationReport;\n  generated_at: string;\n}\n\nfunction zeroByType(itemTypes: string[]): Record<ItemType, number> {\n  return itemTypes.reduce(\n    (acc, value) => {\n      acc[value] = 0;\n      return acc;\n    },\n    {} as Record<ItemType, number>,\n  );\n}\n\nfunction zeroByStatus(statuses: string[]): Record<ItemStatus, number> {\n  return statuses.reduce(\n    (acc, value) => {\n      acc[value] = 0;\n      return acc;\n    },\n    {} as Record<ItemStatus, number>,\n  );\n}\n\nfunction countNonEmptyLines(raw: string): number {\n  if (raw.trim().length === 0) {\n    return 0;\n  }\n  return raw\n    .split(/\\r?\\n/u)\n    .filter((line) => line.trim().length > 0)\n    .length;\n}\n\nfunction isNotFoundError(error: unknown): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && (error as { code?: unknown }).code === \"ENOENT\";\n}\n\nasync function readHistoryStreamContents(pmRoot: string): Promise<Array<{ id: string; raw: string }>> {\n  const historyDir = path.join(pmRoot, \"history\");\n  if (!(await pathExists(historyDir))) {\n    return [];\n  }\n\n  await runActiveOnReadHooks({\n    path: historyDir,\n    scope: \"project\",\n  });\n  const historyFiles = (await fs.readdir(historyDir))\n    .filter((entry) => entry.endsWith(\".jsonl\"))\n    .sort((a, b) => a.localeCompare(b));\n\n  const streams: Array<{ id: string; raw: string }> = [];\n  for (const file of historyFiles) {\n    const historyPath = path.join(historyDir, file);\n    let raw: string;\n    try {\n      raw = await fs.readFile(historyPath, \"utf8\");\n    } catch (error) {\n      if (isNotFoundError(error)) {\n        continue;\n      }\n      throw error;\n    }\n    await runActiveOnReadHooks({\n      path: historyPath,\n      scope: \"project\",\n    });\n    streams.push({ id: file.slice(0, -\".jsonl\".length), raw });\n  }\n\n  return streams;\n}\n\nexport const _testOnly = {\n  zeroByType,\n  zeroByStatus,\n  countNonEmptyLines,\n  readHistoryStreamContents,\n};\n\n/**\n * Implements run stats for the public runtime surface of this module.\n */\nexport async function runStats(global: GlobalOptions, options: StatsCommandOptions = {}): Promise<StatsResult> {\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 statusRegistry = resolveRuntimeStatusRegistry(settings.schema);\n  // Field utilization needs the heavy collections (notes/learnings/files/docs/\n  // tests/comments/deps) AND the body, which the light reader drops — so when it\n  // is requested we read the WithBody rows and use them for every section.\n  const items = options.fieldUtilization\n    ? await listAllFrontMatterWithBody(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema)\n    : await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);\n  await enforceHistoryStreamPolicyForItems({\n    pmRoot,\n    settings,\n    itemIds: items.map((item) => item.id),\n    commandLabel: \"stats\",\n  });\n\n  const byType = zeroByType(typeRegistry.types);\n  const byStatus = zeroByStatus(statusRegistry.definitions.map((definition) => definition.id));\n  // zeroByType/zeroByStatus pre-seed a bucket for every registry type/status, and\n  // the light front-matter reader drops any item whose type/status falls outside\n  // the active registry (parse rejects them) — so every item's bucket is already\n  // present here and no on-the-fly initialization is reachable.\n  for (const item of items) {\n    byType[item.type] += 1;\n    byStatus[item.status] += 1;\n  }\n\n  const streams = await readHistoryStreamContents(pmRoot);\n  let historyEntries = 0;\n  for (const stream of streams) {\n    historyEntries += countNonEmptyLines(stream.raw);\n  }\n  const storage = options.storage ? computeHistoryStorageStats(streams) : undefined;\n\n  const classifier = lifecycleClassifierFromStatusRegistry(statusRegistry);\n  const metadataCoverage = options.metadataCoverage ? computeMetadataCoverage(items, classifier) : undefined;\n  const breakdowns: NonNullable<StatsResult[\"breakdowns\"]> = {};\n  if (options.byAssignee) {\n    breakdowns.assignee = groupItemsByDimension(items, \"assignee\", classifier);\n  }\n  if (options.byTag) {\n    breakdowns.tag = groupItemsByDimension(items, \"tag\", classifier, { tagPrefix: options.tagPrefix });\n  }\n  if (options.byPriority) {\n    breakdowns.priority = groupItemsByDimension(items, \"priority\", classifier);\n  }\n  const hasBreakdowns = Object.keys(breakdowns).length > 0;\n  const fieldUtilization = options.fieldUtilization ? computeContentFieldUtilization(items) : undefined;\n\n  return {\n    totals: {\n      items: items.length,\n      history_streams: streams.length,\n      history_entries: historyEntries,\n    },\n    by_type: byType,\n    by_status: byStatus,\n    ...(metadataCoverage ? { metadata_coverage: metadataCoverage } : {}),\n    ...(hasBreakdowns ? { breakdowns } : {}),\n    ...(storage ? { storage } : {}),\n    ...(fieldUtilization ? { field_utilization: fieldUtilization } : {}),\n    generated_at: nowIso(),\n  };\n}\n","/**\n * Pure aggregate metrics for history streams (JSONL files).\n * No filesystem access — callers read raw stream contents and pass them in.\n * This module has no Node imports; Buffer is available as a global.\n */\n\n/** Per-history-stream size and timestamp summary used by storage diagnostics. */\nexport interface HistoryStreamStat {\n  id: string;\n  bytes: number;\n  lines: number; // non-empty JSONL entry count\n  oldest_ts: string | null; // min parseable ts in this stream, else null\n  newest_ts: string | null; // max parseable ts in this stream, else null\n}\n\n/**\n * Documents the history storage entry ref payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryStorageEntryRef {\n  id: string;\n  ts: string;\n}\n\n/**\n * Documents the history storage stats payload exchanged by command, SDK, and package integrations.\n */\nexport interface HistoryStorageStats {\n  total_streams: number;\n  total_lines: number;\n  total_bytes: number;\n  largest_by_bytes: HistoryStreamStat[]; // top-N desc by bytes, tie-break id asc\n  deepest_by_lines: HistoryStreamStat[]; // top-N desc by lines, tie-break id asc\n  oldest_entry: HistoryStorageEntryRef | null; // global min ts across all streams\n  newest_entry: HistoryStorageEntryRef | null; // global max ts across all streams\n}\n\nfunction parseStreamStat(id: string, raw: string): HistoryStreamStat {\n  const bytes = Buffer.byteLength(raw, \"utf8\");\n\n  let lines = 0;\n  let oldestTs: string | null = null;\n  let newestTs: string | null = null;\n  let oldestMs = Number.POSITIVE_INFINITY;\n  let newestMs = Number.NEGATIVE_INFINITY;\n\n  for (const rawLine of raw.split(/\\r?\\n/)) {\n    const trimmed = rawLine.trim();\n    if (trimmed === \"\") {\n      continue;\n    }\n    lines += 1;\n\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(trimmed);\n    } catch {\n      continue;\n    }\n\n    if (\n      parsed === null ||\n      typeof parsed !== \"object\" ||\n      !(\"ts\" in (parsed as object)) ||\n      typeof (parsed as Record<string, unknown>)[\"ts\"] !== \"string\"\n    ) {\n      continue;\n    }\n\n    const ts = (parsed as Record<string, unknown>)[\"ts\"] as string;\n    const ms = Date.parse(ts);\n    if (Number.isNaN(ms)) {\n      continue;\n    }\n\n    if (ms < oldestMs || (ms === oldestMs && oldestTs !== null && ts < oldestTs)) {\n      oldestMs = ms;\n      oldestTs = ts;\n    }\n    if (ms > newestMs || (ms === newestMs && newestTs !== null && ts > newestTs)) {\n      newestMs = ms;\n      newestTs = ts;\n    }\n  }\n\n  return { id, bytes, lines, oldest_ts: oldestTs, newest_ts: newestTs };\n}\n\n/**\n * Implements compute history storage stats for the public runtime surface of this module.\n */\nexport function computeHistoryStorageStats(\n  streams: Array<{ id: string; raw: string }>,\n  options?: { topN?: number },\n): HistoryStorageStats {\n  const rawTopN = options?.topN ?? 5;\n  const topN = Math.max(0, Math.floor(rawTopN));\n\n  const stats: HistoryStreamStat[] = streams.map(({ id, raw }) => parseStreamStat(id, raw));\n\n  let totalLines = 0;\n  let totalBytes = 0;\n  let oldestEntry: HistoryStorageEntryRef | null = null;\n  let newestEntry: HistoryStorageEntryRef | null = null;\n  let globalOldestMs = Number.POSITIVE_INFINITY;\n  let globalNewestMs = Number.NEGATIVE_INFINITY;\n\n  for (const stat of stats) {\n    totalLines += stat.lines;\n    totalBytes += stat.bytes;\n\n    if (stat.oldest_ts !== null) {\n      const ms = Date.parse(stat.oldest_ts);\n      if (\n        ms < globalOldestMs ||\n        (ms === globalOldestMs && oldestEntry !== null && stat.id < oldestEntry.id)\n      ) {\n        globalOldestMs = ms;\n        oldestEntry = { id: stat.id, ts: stat.oldest_ts };\n      }\n    }\n\n    if (stat.newest_ts !== null) {\n      const ms = Date.parse(stat.newest_ts);\n      if (\n        ms > globalNewestMs ||\n        (ms === globalNewestMs && newestEntry !== null && stat.id < newestEntry.id)\n      ) {\n        globalNewestMs = ms;\n        newestEntry = { id: stat.id, ts: stat.newest_ts };\n      }\n    }\n  }\n\n  const largestByBytes =\n    topN === 0\n      ? []\n      : [...stats]\n          .sort((a, b) => b.bytes - a.bytes || a.id.localeCompare(b.id))\n          .slice(0, topN);\n\n  const deepestByLines =\n    topN === 0\n      ? []\n      : [...stats]\n          .sort((a, b) => b.lines - a.lines || a.id.localeCompare(b.id))\n          .slice(0, topN);\n\n  return {\n    total_streams: streams.length,\n    total_lines: totalLines,\n    total_bytes: totalBytes,\n    largest_by_bytes: largestByBytes,\n    deepest_by_lines: deepestByLines,\n    oldest_entry: oldestEntry,\n    newest_entry: newestEntry,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"fb69c821-7bb6-5b15-8cd2-319f496f077e"}