@unbrained/pm-cli 2026.7.5 → 2026.7.6

package/dist/cli-bundle/chunks/chunk-4CJFCTLM.js

@@ -0,0 +1,222 @@
+
+!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]="52da0313-fc3b-54f5-85c9-1b1de7406518")}catch(e){}}();
+import {
+  listAllFrontMatterLight
+} from "./chunk-ENGQOEUY.js";
+import {
+  PmCliError,
+  getActiveExtensionRegistrations,
+  readSettings
+} from "./chunk-E3SZTQ4K.js";
+import {
+  EXIT_CODE,
+  getSettingsPath,
+  pathExists,
+  resolveItemTypeRegistry,
+  resolvePmRoot
+} from "./chunk-57NWPFF2.js";
+
+// dist/cli/commands/deps.js
+var DEPS_FORMAT_VALUES = ["tree", "graph"];
+var DEPS_COLLAPSE_VALUES = ["none", "repeated"];
+function parseFormat(raw) {
+  const candidate = raw?.trim().toLowerCase() ?? "tree";
+  if (DEPS_FORMAT_VALUES.includes(candidate)) {
+    return candidate;
+  }
+  throw new PmCliError(`Invalid --format value "${raw}". Use "tree" or "graph".`, EXIT_CODE.USAGE);
+}
+function parseMaxDepth(raw) {
+  if (raw === void 0) {
+    return void 0;
+  }
+  const normalized = typeof raw === "number" ? raw : Number(raw.trim());
+  if (!Number.isInteger(normalized) || normalized < 0) {
+    throw new PmCliError(`Invalid --max-depth value "${raw}". Use a non-negative integer.`, EXIT_CODE.USAGE);
+  }
+  return normalized;
+}
+function parseCollapse(raw) {
+  const candidate = raw?.trim().toLowerCase() ?? "none";
+  if (DEPS_COLLAPSE_VALUES.includes(candidate)) {
+    return candidate;
+  }
+  throw new PmCliError(`Invalid --collapse value "${raw}". Use "none" or "repeated".`, EXIT_CODE.USAGE);
+}
+function normalizeDependencies(dependencies) {
+  if (!dependencies || dependencies.length === 0) {
+    return [];
+  }
+  const sorted = [...dependencies].sort((left, right) => {
+    const byKind = left.kind.localeCompare(right.kind);
+    if (byKind !== 0)
+      return byKind;
+    const byId = left.id.localeCompare(right.id);
+    if (byId !== 0)
+      return byId;
+    return left.created_at.localeCompare(right.created_at);
+  });
+  const deduped = /* @__PURE__ */ new Map();
+  for (const dependency of sorted) {
+    const key = `${dependency.kind}::${dependency.id}`;
+    if (!deduped.has(key)) {
+      deduped.set(key, dependency);
+    }
+  }
+  return [...deduped.values()];
+}
+function toIndexedItem(item) {
+  return {
+    id: item.id,
+    title: item.title,
+    type: item.type,
+    status: item.status,
+    dependencies: normalizeDependencies(item.dependencies)
+  };
+}
+function toTreeNode(id, index, lineage, maxDepth, collapse, expanded, depth = 0, via) {
+  const item = index.get(id);
+  const baseNode = {
+    id,
+    title: item?.title,
+    type: item?.type,
+    status: item?.status,
+    via,
+    missing: !item,
+    cycle: lineage.has(id),
+    dependencies: []
+  };
+  if (!item || baseNode.cycle) {
+    return baseNode;
+  }
+  if (maxDepth !== void 0 && depth >= maxDepth) {
+    if (item.dependencies.length > 0) {
+      baseNode.truncated = true;
+    }
+    return baseNode;
+  }
+  if (collapse === "repeated" && expanded.has(id)) {
+    baseNode.collapsed = true;
+    return baseNode;
+  }
+  if (collapse === "repeated") {
+    expanded.add(id);
+  }
+  const nextLineage = new Set(lineage);
+  nextLineage.add(id);
+  baseNode.dependencies = item.dependencies.map((dependency) => toTreeNode(dependency.id, index, nextLineage, maxDepth, collapse, expanded, depth + 1, dependency.kind));
+  return baseNode;
+}
+function mergeGraphNode(existing, candidate) {
+  if (!existing) {
+    return candidate;
+  }
+  if (existing.missing && !candidate.missing)
+    return candidate;
+  return {
+    ...existing,
+    title: existing.title ?? candidate.title,
+    type: existing.type ?? candidate.type,
+    status: existing.status ?? candidate.status
+  };
+}
+function toGraph(root) {
+  const nodesById = /* @__PURE__ */ new Map();
+  const edgesByKey = /* @__PURE__ */ new Map();
+  const visit = (node) => {
+    nodesById.set(node.id, mergeGraphNode(nodesById.get(node.id), {
+      id: node.id,
+      title: node.title,
+      type: node.type,
+      status: node.status,
+      missing: node.missing
+    }));
+    for (const child of node.dependencies) {
+      nodesById.set(child.id, mergeGraphNode(nodesById.get(child.id), {
+        id: child.id,
+        title: child.title,
+        type: child.type,
+        status: child.status,
+        missing: child.missing
+      }));
+      const relationKind = child.via ?? "related";
+      const edgeKey = `${node.id}::${child.id}::${relationKind}`;
+      if (!edgesByKey.has(edgeKey)) {
+        edgesByKey.set(edgeKey, {
+          from: node.id,
+          to: child.id,
+          kind: relationKind
+        });
+      }
+      if (!child.cycle) {
+        visit(child);
+      }
+    }
+  };
+  visit(root);
+  const nodes = [...nodesById.values()].sort((left, right) => left.id.localeCompare(right.id));
+  const edges = [...edgesByKey.values()].sort((left, right) => {
+    const byFrom = left.from.localeCompare(right.from);
+    if (byFrom !== 0)
+      return byFrom;
+    const byTo = left.to.localeCompare(right.to);
+    if (byTo !== 0)
+      return byTo;
+    return left.kind.localeCompare(right.kind);
+  });
+  const missingIds = nodes.filter((node) => node.missing).map((node) => node.id);
+  return {
+    root_id: root.id,
+    nodes,
+    edges,
+    missing_ids: missingIds
+  };
+}
+async function runDeps(id, options, global) {
+  const pmRoot = resolvePmRoot(process.cwd(), global.path);
+  if (!await pathExists(getSettingsPath(pmRoot))) {
+    throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+  }
+  const format = parseFormat(options.format);
+  const maxDepth = parseMaxDepth(options.maxDepth);
+  const collapse = parseCollapse(options.collapse);
+  const summaryOnly = options.summary === true;
+  const settings = await readSettings(pmRoot);
+  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
+  const items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, void 0, settings.schema);
+  const index = new Map(items.map((item) => [item.id, toIndexedItem(item)]));
+  if (!index.has(id)) {
+    throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);
+  }
+  const tree = toTreeNode(id, index, /* @__PURE__ */ new Set(), maxDepth, collapse, /* @__PURE__ */ new Set());
+  const graph = toGraph(tree);
+  const baseResult = {
+    id,
+    format,
+    node_count: graph.nodes.length,
+    edge_count: graph.edges.length,
+    missing_count: graph.missing_ids.length
+  };
+  if (summaryOnly) {
+    return baseResult;
+  }
+  if (format === "tree") {
+    return {
+      ...baseResult,
+      tree
+    };
+  }
+  return {
+    ...baseResult,
+    graph
+  };
+}
+
+export {
+  DEPS_FORMAT_VALUES,
+  DEPS_COLLAPSE_VALUES,
+  runDeps
+};
+//# sourceMappingURL=chunk-4CJFCTLM.js.map
+
+//# debugId=52da0313-fc3b-54f5-85c9-1b1de7406518

package/dist/cli-bundle/chunks/chunk-4CJFCTLM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../../cli/commands/deps.ts"],"sourcesContent":["/**\n * @module cli/commands/deps\n *\n * Implements the pm deps command surface and its agent-facing runtime behavior.\n */\nimport { getActiveExtensionRegistrations } from \"../../core/extensions/index.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { resolveItemTypeRegistry } from \"../../core/item/type-registry.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { listAllFrontMatterLight } from \"../../core/store/item-store.js\";\nimport { getSettingsPath, resolvePmRoot } from \"../../core/store/paths.js\";\nimport { readSettings } from \"../../core/store/settings.js\";\nimport type { Dependency, ItemFrontMatter, ItemStatus, ItemType } from \"../../types/index.js\";\n\nexport const DEPS_FORMAT_VALUES = [\"tree\", \"graph\"] as const;\n/**\n * Restricts deps format values accepted by command, SDK, and storage contracts.\n */\nexport type DepsFormat = (typeof DEPS_FORMAT_VALUES)[number];\nexport const DEPS_COLLAPSE_VALUES = [\"none\", \"repeated\"] as const;\n/**\n * Restricts deps collapse mode values accepted by command, SDK, and storage contracts.\n */\nexport type DepsCollapseMode = (typeof DEPS_COLLAPSE_VALUES)[number];\n\n/**\n * Documents the deps command options payload exchanged by command, SDK, and package integrations.\n */\nexport interface DepsCommandOptions {\n  format?: string;\n  maxDepth?: string | number;\n  collapse?: string;\n  summary?: boolean;\n}\n\ninterface IndexedItem {\n  id: string;\n  title: string;\n  type: ItemType;\n  status: ItemStatus;\n  dependencies: Dependency[];\n}\n\n/**\n * Documents the deps tree node payload exchanged by command, SDK, and package integrations.\n */\nexport interface DepsTreeNode {\n  id: string;\n  title?: string;\n  type?: ItemType;\n  status?: ItemStatus;\n  via?: string;\n  missing: boolean;\n  cycle: boolean;\n  truncated?: boolean;\n  collapsed?: boolean;\n  dependencies: DepsTreeNode[];\n}\n\n/**\n * Documents the deps graph node payload exchanged by command, SDK, and package integrations.\n */\nexport interface DepsGraphNode {\n  id: string;\n  title?: string;\n  type?: ItemType;\n  status?: ItemStatus;\n  missing: boolean;\n}\n\n/**\n * Documents the deps graph edge payload exchanged by command, SDK, and package integrations.\n */\nexport interface DepsGraphEdge {\n  from: string;\n  to: string;\n  kind: string;\n}\n\n/**\n * Documents the deps graph result payload exchanged by command, SDK, and package integrations.\n */\nexport interface DepsGraphResult {\n  root_id: string;\n  nodes: DepsGraphNode[];\n  edges: DepsGraphEdge[];\n  missing_ids: string[];\n}\n\n/**\n * Documents the deps result payload exchanged by command, SDK, and package integrations.\n */\nexport interface DepsResult {\n  id: string;\n  format: DepsFormat;\n  node_count: number;\n  edge_count: number;\n  missing_count: number;\n  tree?: DepsTreeNode;\n  graph?: DepsGraphResult;\n}\n\nfunction parseFormat(raw: string | undefined): DepsFormat {\n  const candidate = raw?.trim().toLowerCase() ?? \"tree\";\n  if ((DEPS_FORMAT_VALUES as readonly string[]).includes(candidate)) {\n    return candidate as DepsFormat;\n  }\n  throw new PmCliError(`Invalid --format value \"${raw}\". Use \"tree\" or \"graph\".`, EXIT_CODE.USAGE);\n}\n\nfunction parseMaxDepth(raw: string | number | undefined): number | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const normalized = typeof raw === \"number\" ? raw : Number(raw.trim());\n  if (!Number.isInteger(normalized) || normalized < 0) {\n    throw new PmCliError(`Invalid --max-depth value \"${raw}\". Use a non-negative integer.`, EXIT_CODE.USAGE);\n  }\n  return normalized;\n}\n\nfunction parseCollapse(raw: string | undefined): DepsCollapseMode {\n  const candidate = raw?.trim().toLowerCase() ?? \"none\";\n  if ((DEPS_COLLAPSE_VALUES as readonly string[]).includes(candidate)) {\n    return candidate as DepsCollapseMode;\n  }\n  throw new PmCliError(`Invalid --collapse value \"${raw}\". Use \"none\" or \"repeated\".`, EXIT_CODE.USAGE);\n}\n\nfunction normalizeDependencies(dependencies: Dependency[] | undefined): Dependency[] {\n  if (!dependencies || dependencies.length === 0) {\n    return [];\n  }\n  const sorted = [...dependencies].sort((left, right) => {\n    const byKind = left.kind.localeCompare(right.kind);\n    if (byKind !== 0) return byKind;\n    const byId = left.id.localeCompare(right.id);\n    if (byId !== 0) return byId;\n    return left.created_at.localeCompare(right.created_at);\n  });\n  const deduped = new Map<string, Dependency>();\n  for (const dependency of sorted) {\n    const key = `${dependency.kind}::${dependency.id}`;\n    if (!deduped.has(key)) {\n      deduped.set(key, dependency);\n    }\n  }\n  return [...deduped.values()];\n}\n\nfunction toIndexedItem(item: ItemFrontMatter): IndexedItem {\n  return {\n    id: item.id,\n    title: item.title,\n    type: item.type,\n    status: item.status,\n    dependencies: normalizeDependencies(item.dependencies),\n  };\n}\n\nfunction toTreeNode(\n  id: string,\n  index: Map<string, IndexedItem>,\n  lineage: Set<string>,\n  maxDepth: number | undefined,\n  collapse: DepsCollapseMode,\n  expanded: Set<string>,\n  depth = 0,\n  via?: string,\n): DepsTreeNode {\n  const item = index.get(id);\n  const baseNode: DepsTreeNode = {\n    id,\n    title: item?.title,\n    type: item?.type,\n    status: item?.status,\n    via,\n    missing: !item,\n    cycle: lineage.has(id),\n    dependencies: [],\n  };\n  if (!item || baseNode.cycle) {\n    return baseNode;\n  }\n  if (maxDepth !== undefined && depth >= maxDepth) {\n    if (item.dependencies.length > 0) {\n      baseNode.truncated = true;\n    }\n    return baseNode;\n  }\n  if (collapse === \"repeated\" && expanded.has(id)) {\n    baseNode.collapsed = true;\n    return baseNode;\n  }\n  if (collapse === \"repeated\") {\n    expanded.add(id);\n  }\n  const nextLineage = new Set(lineage);\n  nextLineage.add(id);\n  baseNode.dependencies = item.dependencies.map((dependency) =>\n    toTreeNode(dependency.id, index, nextLineage, maxDepth, collapse, expanded, depth + 1, dependency.kind),\n  );\n  return baseNode;\n}\n\nfunction mergeGraphNode(existing: DepsGraphNode | undefined, candidate: DepsGraphNode): DepsGraphNode {\n  if (!existing) {\n    return candidate;\n  }\n  /* c8 ignore start -- defensive: mixed missing/non-missing duplicates only occur in malformed synthetic trees. */\n  if (existing.missing && !candidate.missing) return candidate;\n  /* c8 ignore stop */\n  return {\n    ...existing,\n    title: existing.title ?? candidate.title,\n    type: existing.type ?? candidate.type,\n    status: existing.status ?? candidate.status,\n  };\n}\n\nfunction toGraph(root: DepsTreeNode): DepsGraphResult {\n  const nodesById = new Map<string, DepsGraphNode>();\n  const edgesByKey = new Map<string, DepsGraphEdge>();\n\n  const visit = (node: DepsTreeNode): void => {\n    nodesById.set(\n      node.id,\n      mergeGraphNode(nodesById.get(node.id), {\n        id: node.id,\n        title: node.title,\n        type: node.type,\n        status: node.status,\n        missing: node.missing,\n      }),\n    );\n    for (const child of node.dependencies) {\n      nodesById.set(\n        child.id,\n        mergeGraphNode(nodesById.get(child.id), {\n          id: child.id,\n          title: child.title,\n          type: child.type,\n          status: child.status,\n          missing: child.missing,\n        }),\n      );\n      /* c8 ignore start -- legacy malformed dependency payloads may omit kind/via. */\n      const relationKind = child.via ?? \"related\";\n      const edgeKey = `${node.id}::${child.id}::${relationKind}`;\n      if (!edgesByKey.has(edgeKey)) {\n        edgesByKey.set(edgeKey, {\n          from: node.id,\n          to: child.id,\n          kind: relationKind,\n        });\n      }\n      /* c8 ignore stop */\n      if (!child.cycle) {\n        visit(child);\n      }\n    }\n  };\n\n  visit(root);\n\n  const nodes = [...nodesById.values()].sort((left, right) => left.id.localeCompare(right.id));\n  const edges = [...edgesByKey.values()].sort((left, right) => {\n    const byFrom = left.from.localeCompare(right.from);\n    if (byFrom !== 0) return byFrom;\n    const byTo = left.to.localeCompare(right.to);\n    if (byTo !== 0) return byTo;\n    return left.kind.localeCompare(right.kind);\n  });\n  const missingIds = nodes.filter((node) => node.missing).map((node) => node.id);\n  return {\n    root_id: root.id,\n    nodes,\n    edges,\n    missing_ids: missingIds,\n  };\n}\n\n/**\n * Implements run deps for the public runtime surface of this module.\n */\nexport async function runDeps(id: string, options: DepsCommandOptions, global: GlobalOptions): Promise<DepsResult> {\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 format = parseFormat(options.format);\n  const maxDepth = parseMaxDepth(options.maxDepth);\n  const collapse = parseCollapse(options.collapse);\n  const summaryOnly = options.summary === true;\n  const settings = await readSettings(pmRoot);\n  const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());\n  const items = await listAllFrontMatterLight(pmRoot, settings.item_format, typeRegistry.type_to_folder, undefined, settings.schema);\n  const index = new Map(items.map((item) => [item.id, toIndexedItem(item)]));\n  if (!index.has(id)) {\n    throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);\n  }\n\n  const tree = toTreeNode(id, index, new Set<string>(), maxDepth, collapse, new Set<string>());\n  const graph = toGraph(tree);\n  const baseResult = {\n    id,\n    format,\n    node_count: graph.nodes.length,\n    edge_count: graph.edges.length,\n    missing_count: graph.missing_ids.length,\n  };\n  if (summaryOnly) {\n    return baseResult;\n  }\n  if (format === \"tree\") {\n    return {\n      ...baseResult,\n      tree,\n    };\n  }\n  return {\n    ...baseResult,\n    graph,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"52da0313-fc3b-54f5-85c9-1b1de7406518"}

package/dist/cli-bundle/chunks/chunk-4HIFVN7N.js

@@ -0,0 +1,249 @@
+import {
+  computeContentFieldUtilization
+} from "./chunk-R23CSHGI.js";
+import {
+  computeMetadataCoverage,
+  groupItemsByDimension,
+  lifecycleClassifierFromStatusRegistry
+} from "./chunk-JDDLOQAE.js";
+import {
+  enforceHistoryStreamPolicyForItems,
+  listAllFrontMatterLight,
+  listAllFrontMatterWithBody
+} from "./chunk-5VAA4YHR.js";
+import {
+  nowIso
+} from "./chunk-FLZSGSQR.js";
+import {
+  PmCliError,
+  getActiveExtensionRegistrations,
+  readSettings,
+  runActiveOnReadHooks
+} from "./chunk-SHQY2IDC.js";
+import {
+  EXIT_CODE,
+  getSettingsPath,
+  pathExists,
+  resolveItemTypeRegistry,
+  resolvePmRoot,
+  resolveRuntimeStatusRegistry
+} from "./chunk-LK6XLOGP.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=chunk-4HIFVN7N.js.map

package/dist/cli-bundle/chunks/chunk-4HIFVN7N.js.map

@@ -0,0 +1,7 @@
+{
+  "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": "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",
+  "names": ["global"]
+}